Service reference
Every key of a Service product file, the Verbs and Events of a Service Order, and the publish check, for lookup.
A Service is a product file with $type:. These tables list what each key holds and every Verb a Service Order moves by.
Definition
| Key | Type | Holds | Required | Status |
|---|---|---|---|---|
$type | list | One or more of App, API, Agent, Dataset, Service | required | live |
nouns | Noun names | The Nouns it exposes; a Dataset holds Things of exactly one | live | |
verbs | Verb ids | The Verbs a Customer may call | live | |
interfaces | list | The Interfaces it ships on; every kind by default | live | |
work | Noun name | The work Noun it holds from intake until the Customer accepts | required | planned |
intake | list of { name, | What the buyer sends before work starts | required | beta |
coverage | list of sentences | What it delivers, for which inputs, stated before any charge | required | beta |
cadence | once, recurring or standing | Once per Order, on a period, or continuous and judged by rate terms | required | beta |
steps | list of steps | Each a Verb with its Function, doer, checker, assurance and legal floor | required | beta |
supply | list of { role, | Who does the work, each owned, wrapped or recruited | beta | |
contract | Outcome Contract terms | The default promise; an Offer may tighten it, never loosen it | required | beta |
ofRecord | string | The partner of record when a step needs a licensed practice | beta |
The product file convention shows the keys in a working file.
The contract key takes the Outcome Contract's terms: done, statement, accept, window, silence, revisions, deadline, atRisk, clockExcludes, rateTerms, creditCap, remedy, warranty, earns and liabilityMultiple. Each step takes id, verb, function, doer, checker, provides, floor, reason, credential, timeout, escalatesTo, after and rechecksAll.
Verbs
| Verb | What it does | Event |
|---|---|---|
Quote.request | Asks for terms with a brief | Quote.requested |
Quote.accept | Turns a sent Quote into an Order, payment authorized | Quote.accepted |
Order.place | Buys a fixed-scope Offer at its list Price | Order.placed |
Order.start | Checks the inputs against the brief and starts the deadline | Order.started |
Order.deliver | Runs every checker, then hands over the lines | Order.delivered |
Order.confirm | Accepts lines; runs on its own when a window closes in silence | Order.confirmed |
Order.revise | Sends lines back for one counted revision | Order.revised |
Order.dispute | Contests lines and starts the remedy | Order.disputed |
Order.refund | Returns all or part of the payment | Order.refunded |
Offer.publish refuses a Service Offer whose remedy or basis needs stronger checks than the Service's steps provide, with contract-unsupported.
Capabilities without a Verb
| Capability | What it adds | Proposed Verbs |
|---|---|---|
| Service capacity | Open, pause, set capacity and close a Service | Service.open, Service.pause, Service.setCapacity, Service.close |
| A work Thing | The item a Service holds from intake to accepted, apart from the Order | Start, deliver, accept, revise, dispute and close on the work Thing |
A capability with status planned has no Verb, so no guide offers it and no agent promises it.