services.devDocs

Contract review

The running jobjob_7Hq2 · waiting · on claim · $149.00 held · sign · tsk_7Hq2

The client consents before any attorney reads a name, advice the AI drafts waits for the attorney to adopt it, the advice is ratified in three states, and the attorney's fee is the attorney's own, at the same checkout.

legal's wordsmatter is a jobasset is a subjectreview is a tasksigner is a membernetwork is a pooloutcome is a end

The client consents first, so no attorney reads a party's name before she agrees. The AI flags the contract and an adversarial review attacks the flags. Then an attorney admitted where the client is writes the advice, stamped. The rules ratify that advice in three states, and the attorney's fee is the attorney's own.

Run
cat services/contract-review.ts
magic values: none
  roles: { attorney: { pool: attorneys, pay: 50 } },
  talk: { adopt: 'attorney' },
    consent: { ask: 'client', to: 'consent', expires: '7d' },
    flag: 'ai',
    attack: { review: 'adversarial' },
    advise: { by: 'attorney', stamp: true, est: '45min', checklist: ['every flag is addressed', 'the memo answers the goals'] },
  price: { usd: 99, release: 'accept' },

The whole file, and check after it.

Three ratified states

The advise row lists the states it's ratified in. An order from Florida is refused before any work, and charges nothing:

Call
→ POST /matters {"service":"contract-review","contract":{"url":"data:text/plain,A%20lease.","name":"lease.pdf"},"client":{"name":"Ada Lovelace","email":"ada@example.com"},"client_region":"US-FL","max_usd":99,"key":"lease-fl"}
403 · magic values: none
  "code": "region_not_ratified",
  "reason": "advise is ratified in US-CA, US-NY, US-TX under rules 2026-10, and this order's region is US-FL.",
← GET /owner/events: no matter.ordered and no charge: $0

Its next is the Service's waitlist:

Call
→ POST /contract-review/waitlist {"email":"ada@example.com"}   # the next the refusal named
magic values: none
← 200 {"object":"waitlist","service":"contract-review","status":"live","position":1,"simulated":true}

The same order from California runs:

Call
→ POST /matters {"service":"contract-review","contract":{"url":"data:text/plain,A%20lease.","name":"lease.pdf"},"client":{"name":"Ada Lovelace","email":"ada@example.com"},"client_region":"US-CA","max_usd":99,"key":"lease-ca"}
202 · job_7Hq2 · working · $99.00 held · magic values: none
← 202 · job_7Hq2 · working · $99.00 held

Held advice

talk: { adopt: 'attorney' } lets the client ask in the matter's thread. The AI answers at once, unless the answer is in an advice class the rules reserve. Then it's held, and posted to the attorney on the matter, whose fee for advise covers up to three such answers:

Call
→ POST /matters/job_7Hq2/messages {"text":"Should I sign this lease?","metadata":{"sandbox":{"talk":"advice"}}}
magic values: client.email = signs@example.test, metadata.sandbox.talk = advice
← 200 msg_7Hq3 · AI · answer · held · advice: A professional is reviewing this answer.
  14:02 · task.posted · tsk_7Hq3 · $0.00 · dispatch direct · to mbr_7Hq2
  14:02 · task.offered · tsk_7Hq3 · mbr_7Hq2 · client

The client reads that a professional is reviewing it, and nothing of the draft:

Call
→ GET /matters/job_7Hq2/messages   # what the client reads
200 · magic values: client.email = signs@example.test, metadata.sandbox.talk = advice
  msg_7Hq2 · the client · message · sent: Should I sign this lease?
  msg_7Hq3 · AI · answer · held · advice: A professional is reviewing this answer.

The attorney reads the question and the draft in the review's packet, and adopts it as written. The record freezes who adopted it, their credential, where, the rules version and the hash:

Call
→ POST /reviews/tsk_7Hq3/attest {}   # as mbr_7Hq2: adopts it as written
magic values: client.email = signs@example.test, metadata.sandbox.talk = advice
← 200 tsk_7Hq3 · done · attorney · advise · US-CA · $0.00 · attested · no estimate · due 2026-10-27 14:02
  14:02 · message.adopted · msg_7Hq3 · tsk_7Hq3 · mbr_7Hq2 · bar admission · US-CA · rules 2026-10 · sha256:dbcc5338…
  14:02 · message.sent · msg_7Hq3 · advice advise · re msg_7Hq2 · mbr_7Hq2 · bar admission · US-CA · sha256:dbcc5338…

  attested {"member":"mbr_7Hq2","credential":"bar admission","region":"US-CA","rules":"2026-10","hash":"sha256:dbcc53388ecb26c6797659e769f83e8b6d54dad66659e9813588234320772a9a"}

Two sellers

The brand sells the review and the attorney sells the advice, on the attorney's own rail. The ledger never counts the attorney's fee as the brand's. Here the fill ladder had raised it to $55 before a member claimed it:

Call
→ POST /matters/job_7Hq2/accept
magic values: client.email = signs@example.test
← job_7Hq2 · accepted · flags.pdf · memo.pdf · $99.00 final
  ledger  +$99.00 · attorney's fee $55.00, sold by the attorney (rail member) · brand $44.00 · AI $1.26 · you $42.74

Talk covers threads and advice classes. The attorney's fee lands on their own account, at the same checkout, so the receipt names two sellers.