Skip to main content

Squillify development is paused indefinitely. Read why, and discover what this experiment achieved. Read the story

MicroSkills Reference

Roll Forward Contract Term

legal.contract_term_rollforward

ProductionBounded custom (Class B)Deterministicstrictfastv1.0.0
No network

Overview

You send commencement, initial term, renewal type and an as-of date. We walk those durations on the Gregorian calendar and report the current window, remaining days and a mechanical notice date when you also send a notice period. We do not read contract prose or decide enforceability. A successful call costs 1 execution credit.

Renewal windows are calendar arithmetic once the durations are explicit; hidden conventions would look like advice.

Reliability

TERM_LIMIT_EXCEEDED — trigger: a duration count above 10000 or maxRenewals above 1000; retryable: no; next: lower the count.

Context footprint

Calendar dates and durations only. A successful call costs 1 execution credit.

When to use it

When commencement, term length and renewal count are already extracted as structured values.

When the renewal rule still lives only in prose or you need a view on termination rights.

Powered by java.time duration shifts on the commencement, term and renewal values you supply.

Scope

Note
Walks explicit commencement, initial term and renewal durations to the as-of date.

Non-goals

  • Does not interpret contract prose
  • Does not decide termination or enforceability
  • Does not apply business-day rules

Properties

IdempotentRetry safeStreaming supportedFile input supportedRequires external service

Capabilities

data-transformationmath

Cost & billing

Flat rate per invocation

MetercallsBillable onsuccessCost per call1 credit

File handling

Accepts file_refProduces file_refMax input8 KB

How we handle your data

Sensitive input, safe output
What this means

This skill may receive sensitive content, but it does not target sensitive data and returns only a structured non-sensitive result.

Squillify guarantees
  • Runs inside Squillify
  • This skill runs inside Squillify.
  • Payloads are not sent to an external service by this skill.
  • Squillify does not permanently store submitted payloads.
  • Telemetry records metadata only, not submitted content.
  • Submitted payloads are not used for training.
  • Submitted payloads are not reviewed by humans.
  • This skill does not target sensitive data.
  • The response does not contain submitted content.
Your responsibility

Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.

Read the Microskill Data Handling Policy

Input schema

FieldTypeRequiredDescription
commencementDatestringYesISO date the initial term begins.
initialTermobjectYesClosed initial duration with count and unit DAYS, MONTHS or YEARS.
renewalobjectYesClosed renewal rule with type NONE or FIXED and, for FIXED, count, unit and maxRenewals.
asOfDatestringYesISO date the current window is evaluated at.
endConventionstringNoEXCLUSIVE or INCLUSIVE; omit it for EXCLUSIVE.
noticePeriodobjectNoClosed notice duration used only to compute noticeDate; omit it and noticeDate is omitted.

Output schema

FieldTypeRequiredDescription
statusstringYesBEFORE_COMMENCEMENT, IN_TERM or EXHAUSTED.
currentTermIndexintegerNoZero-based term index; omit it when status is BEFORE_COMMENCEMENT.
currentTermStartstringNoISO start of the current or last term; omit it before commencement.
currentTermEndstringNoISO end according to endConvention; omit it before commencement.
nextRenewalDatestringNoISO start of the next term; omit it when renewals are exhausted.
noticeDatestringNoISO notice date; omit it when noticePeriod is absent or there is no next term.
remainingDaysintegerYesWhole days remaining in the current window, or until commencement.
renewalExhaustedbooleanYesTrue when no further FIXED renewal remains.
endOfMonthClampedbooleanYesTrue when a MONTHS or YEARS shift changed the day-of-month.
assumptionsarrayYesCaller-visible mechanical assumptions for this answer, such as default weekend days or a grammar version, never a legal conclusion.
limitationsstringYesFixed notice that only supplied parameters are applied and that validity, compliance and enforceability are not determined.

API contract

POST /v1/execute
curl
curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"legal.contract_term_rollforward","input":{"commencementDate":"2024-01-01","initialTerm":{"count":12,"unit":"MONTHS"},"renewal":{"type":"NONE"},"asOfDate":"2024-06-15"}}'
Integrations
TypeScript SDK
import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("legal.contract_term_rollforward", {"asOfDate":"2024-06-15","initialTerm":{"count":12,"unit":"MONTHS"},"renewal":{"unit":"MONTHS","count":12,"maxRenewals":2,"type":"FIXED"},"commencementDate":"2024-01-01"});

Errors

CodeHTTPRetryableDescription
VALIDATION_ERROR400NoThe request payload failed schema validation.
UNAUTHORIZED401NoMissing or invalid API key.
SKILL_NOT_ACCESSIBLE403NoThe API key is not granted access to this skill.
SKILL_NOT_AVAILABLE_FOR_PLAN403NoThis skill is not included in your current plan.
PLAN_ELIGIBILITY_UNAVAILABLE503YesPlan eligibility could not be decided. Retry after backoff.
SKILL_NOT_FOUND404NoThe requested skill or version does not exist.
TENANT_RATE_LIMITED429YesRequest rate limit exceeded. Retry after backoff.
QUOTA_EXCEEDED429YesPlan quota exhausted. Retryable once the quota period resets.
EXECUTION_TIMEOUT504YesExecution exceeded the allowed time budget.
TERM_LIMIT_EXCEEDED429NoA size, quota, rate, or time limit was exceeded.

Other limits

LimitValue
Recommended inline bytes32 KiB

Limitations

  • Does not interpret contract prose
  • Does not decide termination or enforceability
  • Does not apply business-day rules
  • Reading a renewal clause written in prose
  • Deciding whether a renewal is enforceable

How to call

POST /v1/execute (requires authentication)

Request bodyjson
{
  "skillKey": "legal.contract_term_rollforward",
  "input": {
    "asOfDate": "2024-06-15",
    "initialTerm": {
      "count": 12,
      "unit": "MONTHS"
    },
    "renewal": {
      "unit": "MONTHS",
      "count": 12,
      "maxRenewals": 2,
      "type": "FIXED"
    },
    "commencementDate": "2024-01-01"
  }
}

Examples

As-of date inside a one-year initial term

Inputjson
{
  "asOfDate": "2024-06-15",
  "initialTerm": {
    "count": 12,
    "unit": "MONTHS"
  },
  "renewal": {
    "unit": "MONTHS",
    "count": 12,
    "maxRenewals": 2,
    "type": "FIXED"
  },
  "commencementDate": "2024-01-01"
}
Expected outputjson
{
  "status": "IN_TERM",
  "endOfMonthClamped": false,
  "currentTermStart": "2024-01-01",
  "renewalExhausted": false,
  "currentTermEnd": "2025-01-01",
  "nextRenewalDate": "2025-01-01",
  "currentTermIndex": 0,
  "remainingDays": 200,
  "limitations": "Calculations use only the parameters supplied in this call. No implicit legal rule is applied, and the answer does not determine validity, compliance or enforceability.",
  "assumptions": [
    "Term boundaries use only commencementDate, initialTerm, renewal and endConvention from this call."
  ]
}
Tip
15 June 2024 sits in term 0 of a 12-month exclusive window.

As-of date before commencement

Inputjson
{
  "asOfDate": "2023-12-01",
  "initialTerm": {
    "count": 12,
    "unit": "MONTHS"
  },
  "renewal": {
    "unit": "MONTHS",
    "count": 12,
    "maxRenewals": 2,
    "type": "FIXED"
  },
  "commencementDate": "2024-01-01"
}
Expected outputjson
{
  "status": "BEFORE_COMMENCEMENT",
  "endOfMonthClamped": false,
  "remainingDays": 31,
  "assumptions": [
    "Term boundaries use only commencementDate, initialTerm, renewal and endConvention from this call."
  ],
  "renewalExhausted": false,
  "limitations": "Calculations use only the parameters supplied in this call. No implicit legal rule is applied, and the answer does not determine validity, compliance or enforceability."
}
Tip
Status is BEFORE_COMMENCEMENT and remainingDays counts to 1 January 2024.
  • Find which numbered term an as-of date falls in
  • Compute a mechanical notice date from a supplied period

Avoid for

  • Reading a renewal clause written in prose
  • Deciding whether a renewal is enforceable

Composable with

Safety & privacy

  • Runs without calling any external service.
  • Your payloads are never stored permanently.
  • Telemetry captures metadata only — never your payload contents.
  • We never train models on your payloads.
  • No human reviews your payloads.

Tags

date-timelegal