4.9 Human-in-the-loop

Generate a release notice → deliver a versioned human review → confirm or edit → continue from the approved version → publish and verify. Editing creates a new review; the Agent never grants its own approval.

mermaid

flowchart TD
  L[Main Loop: request and Memory] --> G[Generate draft]
  G --> R[Persist and deliver review snapshot]
  R --> W[Return awaiting-human]
  W -->|Human edits| E[New version / supersede old approval]
  E --> R
  W -->|Human rejects| X[Rejected]
  W -->|Human approves| C[Load approved version / Agent continues]
  C --> V[Check version and current approval]
  V -->|Changed while running| R
  V --> P[Publish exact approved bytes]
  P --> F[Verify publication / save result]
  G -->|Conflicting facts or invalid draft| H[Human handoff]

One main Loop composes public Worker Graphs. Context uses Redis, Memory uses SQLite, and an independent review database stores business approvals. The effect is an actual local publication, not a production website or financial transaction.

Run

Use Node 24, real Redis, configured ditto.yaml and model credentials. The first command returns a persistent review in .examples-human-loop-tasks/. Read its inbox files before supplying a decision. Keep the directory for later continuation.

export DITTO_WORKER_CONTEXT_REDIS_URL=redis://127.0.0.1:6379
npm run example:human-loop -- --provider deepseek
# Read the printed directory, review ID, token and inbox snapshot first.
npm run example:human-loop -- --provider deepseek --directory <task-directory>
npm run example:human-loop -- --provider deepseek --directory <task-directory> \
  --actor example-publisher --review-id <review-id> --token <token> --decision approve
npm run example:human-loop -- --provider deepseek --directory <task-directory> \
  --actor example-publisher --review-id <review-id> --token <token> \
  --edit-file <full-draft.json> --note "Adjust the release date"
npm run example:human-loop -- --provider deepseek --conflict
npm run check:examples:human-loop:package -- --provider deepseek

Reject with --decision reject. An edit file must contain the full {releaseId,date,title,body}; approve the resulting new review separately. --stop-after draft|continued|effect provides recovery checkpoints. Artifacts and databases are ignored by Git.

API, authenticated controller and recovery · Application adapters · 简体中文.

4.9 Human-in-the-loop ​

Run ​

4.9 Human-in-the-loop

Run