Build with your coding agent

# Agent instructions

Each file in services/ is one Service you sell, and its .md file is the AI's brief.

- After every change, run `npx services.dev check --json` and fix each failure from its `doc_url`.
- One Service imports another with its .ts extension: `import translation from './translation.ts'`.
- Try a job: `npx services.dev dev` has an agent order one. Order more with `npx services.dev <service> field=value … --max <price>`.
- As the buyer: `npx services.dev accept <job>`, or `npx services.dev send-back <job> "<note>"` and the AI redoes it.
- Only if a Service has a `human` line: `npx services.dev approve <job>` approves, signs or does a job waiting on a person.
- An MCP client launches the brand with `npx services.dev mcp` (stdio), or connects to `http://localhost:8787/mcp` while dev runs.
- Drive the CLI with `--json`: every failure prints `{ type, code, reason, next, doc_url }`, and the exit code is its type's (`npx services.dev help`).

$ npx services.dev check --json

{
  "services": [
    {
      "path": "services/translation.ts",
      "ok": false,
      "failures": [
        {
          "code": "step_unreachable",
          "reason": "A step no edge reaches never runs.",
          "next": "Fix its after, or route there with next. file names corect, which isn't a step; correct is routed, and no step has a next, a rejection or a fallback that can send the job there.",
          "doc_url": "https://services.dev/docs/reference/check/step_unreachable"
        },
        {
          "code": "release_unproven",
          "reason": "price.release names no step that runs.",
          "next": "Name a step that runs. price.release is 'file', and file never runs.",
          "doc_url": "https://services.dev/docs/reference/check/release_unproven"
        }
      ]
    }

{
  "ai": {
    "cents_per_call": 42,
    "simulated": true
  },
  "mcp": {

diff --git a/services/translation.ts b/services/translation.ts
index 3ef4330..36584f8 100644
--- a/services/translation.ts
+++ b/services/translation.ts
@@ -16,7 +16,7 @@ export default Service({
       submit: 'https://registry.example.test/filings',
       to: 'the registry',
       receipt: 'filing',
-      rejected: { missing_certificate: 'corect', '*': 'translate' },
+      rejected: { missing_certificate: 'correct', '*': 'translate' },
       perfect: '2d',
       fallback: 'hand_off',
     },

$ npx services.dev check
services/translation.ts · 21 lines · $89 per job, within 48 hours, charged on file's receipt.
  who     A sworn translator signs before the file step. The buyer answers at glossary.
  steps   glossary · buyer · answer → translate · ai → harden · ai · adversarial · 2 lenses · then a person signs → file · the registry → correct · buyer · upload · routed → hand_off · buyer · answer · routed
  agent   order_translation · 29 of 30 words · job_7Hq2 waits on party
  ledger  +$89.00 · AI $1.26 (example) · sworn translator $30.00 · you $57.74
  margin  at least $41.20 a job (46%) · a job that stops costs you at most $47.80
  apps    customer portal · delivery portal · owner console

mcp     13 buyer tools · 4,508 of 8,000 tokens · 9 more with ?toolset=sandbox
✓ ready to sell · 1 Service · it keeps at least 46% of every job

{
  "type": "BLOCKED",
  "category": "invalid_request",
  "code": "input_invalid",
  "reason": "Missing to.",
  "param": "to",
  "next": {
    "do": "order",
    "service": "translation",
    "arguments": {
      "document": {
        "url": "https://example.com/lease.pdf",
        "name": "lease.pdf"
      },
      "max_usd": 49,
      "key": "lease",
      "to": null,
      "service": "translation"
    },
    "fill": [

Exit codes
  0 ok · 1 check failed · 2 usage · 3 invalid request · 4 authentication · 5 blocked: a person must act · 6 conflict or guard · 10 retry: api error, rate limited, nothing running