@zhixuan92/multi-model-agent 3.12.7 → 4.0.0

package/dist/telemetry/recorder.js

@@ -6,8 +6,8 @@ import { deleteInstallId } from './install-id.js';
 import { buildInstallMeta } from './install-meta.js';
 import { Queue } from './queue.js';
 import { readGeneration, bumpGeneration } from './generation.js';
-import { SCHEMA_VERSION, TaskCompletedEventSchema, ValidatedTaskCompletedEventSchema } from '@zhixuan92/multi-model-agent-core/telemetry/types';
-import { buildTaskCompletedEvent, } from '@zhixuan92/multi-model-agent-core/telemetry/event-builder';
+import { SCHEMA_VERSION, TaskCompletedEventSchema, ValidatedTaskCompletedEventSchema } from '@zhixuan92/multi-model-agent-core/events/telemetry-types';
+import { buildTaskCompletedEvent, } from '@zhixuan92/multi-model-agent-core/events/event-builder';
 /**
  * Run both base-schema and cross-field validation on a built event
  * without dropping it. Returns deduplicated warnings and separate
@@ -52,7 +52,7 @@ function checkR6b(event) {
     for (let i = 0; i < event.stages.length; i++) {
         const s = event.stages[i];
         if (s.inputTokens > 0) {
-            const cachedSum = (s.cachedReadTokens ?? 0) + (s.cachedCreationTokens ?? 0);
+            const cachedSum = (s.cachedReadTokens ?? 0) + (s.cachedNonReadTokens ?? 0);
             if (cachedSum > 100 * s.inputTokens) {
                 warnings.push({ rule: 'R6b', path: `stages[${i}]` });
             }
@@ -119,26 +119,27 @@ function _buildRecorder(opts) {
                 if (!d.enabled)
                     return;
                 const event = buildTaskCompletedEvent(ctx);
-                const { warnings, baseIssues, refinedIssues } = collectValidationWarnings(event);
+                const ev = event;
+                const { warnings, baseIssues, refinedIssues } = collectValidationWarnings(ev);
                 if (baseIssues.length > 0) {
                     console.warn('mma-telemetry: schema warning (event still emitted)', {
-                        eventId: event.eventId,
+                        eventId: ev.eventId,
                         issues: baseIssues,
                     });
                 }
                 if (refinedIssues.length > 0) {
-                    const stageModelsByName = (event.stages ?? []).reduce((acc, s) => {
+                    const stageModelsByName = (ev.stages ?? []).reduce((acc, s) => {
                         if (s.name && s.model)
                             acc[s.name] = s.model;
                         return acc;
                     }, {});
                     console.warn('mma-telemetry: cross-field warning (event still emitted)', {
-                        eventId: event.eventId,
-                        implementerModel: event.implementerModel,
+                        eventId: ev.eventId,
+                        implementerModel: ev.implementerModel,
                         stageModels: stageModelsByName,
-                        totalDurationMs: event.totalDurationMs,
-                        inputTokens: event.inputTokens,
-                        outputTokens: event.outputTokens,
+                        totalDurationMs: ev.totalDurationMs,
+                        inputTokens: ev.inputTokens,
+                        outputTokens: ev.outputTokens,
                         issues: refinedIssues.map((e) => ({
                             rule: e.message,
                             path: e.path,

package/dist/telemetry/recorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/telemetry/recorder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/telemetry/recorder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhixuan92/multi-model-agent",
-  "version": "3.12.7",
+  "version": "4.0.0",
   "type": "module",
   "license": "MIT",
   "description": "Standalone HTTP server for multi-model-agent. Routes tool-invocation work to Claude, Codex, or OpenAI-compatible sub-agents with async-polling REST dispatch and installable skills for Claude Code, Gemini CLI, Codex CLI, and Cursor.",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@asteasolutions/zod-to-openapi": "^8.5.0",
-    "@zhixuan92/multi-model-agent-core": "^3.12.7",
+    "@zhixuan92/multi-model-agent-core": "^4.0.0",
     "gray-matter": "^4.0.3",
     "minimist": "^1.2.8",
     "proper-lockfile": "^4.1.2",

package/dist/http/cross-tier-guard.d.ts

@@ -1,15 +0,0 @@
-import type { ServerResponse } from 'node:http';
-import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
-/**
- * Guards read-only routes against misconfigured cross-tier review topology.
- *
- * Read-only routes (audit, review, verify, investigate, debug) require both
- * 'standard' and 'complex' agent slots to be configured so the quality_only
- * review pipeline can run cross-tier comparison.
- *
- * Callers MUST check the read-only-review kill switch before calling this
- * function — if quality review is disabled for the route, the cross-tier
- * check is skipped entirely.
- */
-export declare function assertCrossTierConfigured(config: MultiModelConfig, res: ServerResponse): boolean;
-//# sourceMappingURL=cross-tier-guard.d.ts.map

package/dist/http/cross-tier-guard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cross-tier-guard.d.ts","sourceRoot":"","sources":["../../src/http/cross-tier-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAG1E;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,cAAc,GAClB,OAAO,CA6BT"}

package/dist/http/cross-tier-guard.js

@@ -1,30 +0,0 @@
-import { sendError } from './errors.js';
-/**
- * Guards read-only routes against misconfigured cross-tier review topology.
- *
- * Read-only routes (audit, review, verify, investigate, debug) require both
- * 'standard' and 'complex' agent slots to be configured so the quality_only
- * review pipeline can run cross-tier comparison.
- *
- * Callers MUST check the read-only-review kill switch before calling this
- * function — if quality review is disabled for the route, the cross-tier
- * check is skipped entirely.
- */
-export function assertCrossTierConfigured(config, res) {
-    // Cast to unknown — this is a runtime defense-in-depth guard; the Zod schema
-    // already requires both slots, but a config constructed outside parseConfig
-    // (e.g. in tests) may be missing one.
-    const agents = config.agents;
-    if (!agents?.standard) {
-        sendError(res, 400, 'invalid_configuration', "Read-only routes require both 'standard' and 'complex' slots configured for cross-tier review. " +
-            "Configure the missing 'standard' slot or set MMAGENT_READ_ONLY_REVIEW=disabled to skip the review topology.");
-        return false;
-    }
-    if (!agents?.complex) {
-        sendError(res, 400, 'invalid_configuration', "Read-only routes require both 'standard' and 'complex' slots configured for cross-tier review. " +
-            "Configure the missing 'complex' slot or set MMAGENT_READ_ONLY_REVIEW=disabled to skip the review topology.");
-        return false;
-    }
-    return true;
-}
-//# sourceMappingURL=cross-tier-guard.js.map

package/dist/http/cross-tier-guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cross-tier-guard.js","sourceRoot":"","sources":["../../src/http/cross-tier-guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAwB,EACxB,GAAmB;IAEnB,6EAA6E;IAC7E,4EAA4E;IAC5E,sCAAsC;IACtC,MAAM,MAAM,GAAI,MAA0D,CAAC,MAAM,CAAC;IAElF,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;QACtB,SAAS,CACP,GAAG,EACH,GAAG,EACH,uBAAuB,EACvB,iGAAiG;YAC/F,6GAA6G,CAChH,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,SAAS,CACP,GAAG,EACH,GAAG,EACH,uBAAuB,EACvB,iGAAiG;YAC/F,4GAA4G,CAC/G,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/http/handlers/control/clarifications.d.ts

@@ -1,19 +0,0 @@
-import type { RawHandler } from '../../router.js';
-import type { BatchRegistry } from '@zhixuan92/multi-model-agent-core';
-export interface ClarificationsHandlerDeps {
-    batchRegistry: BatchRegistry;
-}
-/**
- * POST /clarifications/confirm — confirms (or idempotently re-confirms) an
- * awaiting_clarification batch by providing the caller's chosen interpretation.
- *
- * Auth required; NOT cwd-gated (operates on a batchId, not a project cwd).
- *
- * Success → 200 { batchId, state: <current state after confirmation> }
- * Errors:
- *   invalid body   → 400 invalid_request
- *   unknown batchId → 404 not_found
- *   wrong state w/ different interpretation → 409 invalid_batch_state
- */
-export declare function buildClarificationsHandler(deps: ClarificationsHandlerDeps): RawHandler;
-//# sourceMappingURL=clarifications.d.ts.map

package/dist/http/handlers/control/clarifications.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clarifications.d.ts","sourceRoot":"","sources":["../../../../src/http/handlers/control/clarifications.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,aAAa,CAAC;CAC9B;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,yBAAyB,GAAG,UAAU,CA8CtF"}

package/dist/http/handlers/control/clarifications.js

@@ -1,58 +0,0 @@
-import { z } from 'zod';
-import { InvalidBatchStateError } from '@zhixuan92/multi-model-agent-core';
-import { sendError, sendJson } from '../../errors.js';
-const confirmBodySchema = z.object({
-    batchId: z.string().uuid(),
-    interpretation: z.string().min(1),
-});
-/**
- * POST /clarifications/confirm — confirms (or idempotently re-confirms) an
- * awaiting_clarification batch by providing the caller's chosen interpretation.
- *
- * Auth required; NOT cwd-gated (operates on a batchId, not a project cwd).
- *
- * Success → 200 { batchId, state: <current state after confirmation> }
- * Errors:
- *   invalid body   → 400 invalid_request
- *   unknown batchId → 404 not_found
- *   wrong state w/ different interpretation → 409 invalid_batch_state
- */
-export function buildClarificationsHandler(deps) {
-    return async (_req, res, _params, ctx) => {
-        // ── 1. Validate body ───────────────────────────────────────────────────
-        const parsed = confirmBodySchema.safeParse(ctx.body);
-        if (!parsed.success) {
-            sendError(res, 400, 'invalid_request', 'Request body validation failed', {
-                fieldErrors: parsed.error.flatten(),
-            });
-            return;
-        }
-        const { batchId, interpretation } = parsed.data;
-        // ── 2. Lookup ──────────────────────────────────────────────────────────
-        const entry = deps.batchRegistry.get(batchId);
-        if (!entry) {
-            sendError(res, 404, 'not_found', `Batch ${batchId} not found`);
-            return;
-        }
-        // ── 3. Resume (handles idempotency + state validation) ─────────────────
-        try {
-            deps.batchRegistry.resumeFromClarification(batchId, interpretation);
-        }
-        catch (err) {
-            if (err instanceof InvalidBatchStateError) {
-                sendError(res, 409, 'invalid_batch_state', `Cannot confirm clarification: batch is in state '${err.currentState}'`, {
-                    currentState: err.currentState,
-                });
-                return;
-            }
-            throw err;
-        }
-        // ── 4. Echo current state ──────────────────────────────────────────────
-        // Re-read the entry after resumeFromClarification — the batch may have
-        // already completed if the executor was waiting.
-        const updatedEntry = deps.batchRegistry.get(batchId);
-        const currentState = updatedEntry?.state ?? 'pending';
-        sendJson(res, 200, { batchId, state: currentState });
-    };
-}
-//# sourceMappingURL=clarifications.js.map

package/dist/http/handlers/control/clarifications.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"clarifications.js","sourceRoot":"","sources":["../../../../src/http/handlers/control/clarifications.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAQtD,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC1B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAA+B;IACxE,OAAO,KAAK,EACV,IAAqB,EACrB,GAAmB,EACnB,OAA+B,EAC/B,GAAG,EACH,EAAE;QACF,0EAA0E;QAC1E,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,iBAAiB,EAAE,gCAAgC,EAAE;gBACvE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;aACpC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAEhD,0EAA0E;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,OAAO,YAAY,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,0EAA0E;QAC1E,IAAI,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,sBAAsB,EAAE,CAAC;gBAC1C,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,qBAAqB,EAAE,oDAAoD,GAAG,CAAC,YAAY,GAAG,EAAE;oBAClH,YAAY,EAAE,GAAG,CAAC,YAAY;iBAC/B,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,0EAA0E;QAC1E,uEAAuE;QACvE,iDAAiD;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,YAAY,EAAE,KAAK,IAAI,SAAS,CAAC;QAEtD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC"}

package/dist/http/test-provider-override.d.ts

@@ -1,4 +0,0 @@
-import type { Provider } from '@zhixuan92/multi-model-agent-core';
-export declare function __setTestProviderOverride(provider: Provider | null): void;
-export declare function __getTestProviderOverride(): Provider | null;
-//# sourceMappingURL=test-provider-override.d.ts.map

package/dist/http/test-provider-override.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-provider-override.d.ts","sourceRoot":"","sources":["../../src/http/test-provider-override.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAUlE,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAGzE;AAED,wBAAgB,yBAAyB,IAAI,QAAQ,GAAG,IAAI,CAK3D"}

package/dist/http/test-provider-override.js

@@ -1,17 +0,0 @@
-let testProviderOverride = null;
-function assertEnabled() {
-    if (process.env.MMAGENT_TEST_PROVIDER_OVERRIDE !== '1') {
-        throw new Error('MMAGENT_TEST_PROVIDER_OVERRIDE must be set to 1 to use the test provider override');
-    }
-}
-export function __setTestProviderOverride(provider) {
-    assertEnabled();
-    testProviderOverride = provider;
-}
-export function __getTestProviderOverride() {
-    if (process.env.MMAGENT_TEST_PROVIDER_OVERRIDE !== '1') {
-        return null;
-    }
-    return testProviderOverride;
-}
-//# sourceMappingURL=test-provider-override.js.map

package/dist/http/test-provider-override.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-provider-override.js","sourceRoot":"","sources":["../../src/http/test-provider-override.ts"],"names":[],"mappings":"AAEA,IAAI,oBAAoB,GAAoB,IAAI,CAAC;AAEjD,SAAS,aAAa;IACpB,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,GAAG,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAyB;IACjE,aAAa,EAAE,CAAC;IAChB,oBAAoB,GAAG,QAAQ,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,GAAG,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/skills/mma-clarifications/SKILL.md

@@ -1,129 +0,0 @@
----
-name: mma-clarifications
-description: >-
-  Use when a previous mma-* batch's terminal envelope has
-  `proposedInterpretation` as a string (not the `not_applicable` sentinel) — the
-  service paused waiting for you to confirm or correct its read of the task
-when_to_use: >-
-  A previous mma-delegate / mma-audit / mma-review / mma-execute-plan /
-  mma-debug / mma-investigate terminal envelope has `proposedInterpretation` as
-  a string. Read the proposal, decide whether to accept or correct it, then call
-  this skill. The batch resumes immediately after the POST returns. A string
-  `proposedInterpretation` is a hard gate — the batch is paused, not
-  informational. The batch will not complete until the caller responds. Treating
-  it as advisory is the clarification-as-info anti-pattern (AP5).
-version: 3.12.7
----
-
-# mma-clarifications
-
-## Overview
-
-When a batch pauses with `state: 'awaiting_clarification'`, the service has proposed an interpretation of an ambiguous task and is waiting for your decision. Read the proposal, then `POST /clarifications/confirm` with either the proposal verbatim (accept) or a corrected version (override). The batch resumes immediately.
-
-**Core principle:** Clarification is a quality gate, not an error. Ambiguous tasks would silently produce the wrong work — the pause forces a deliberate choice.
-
-## When to Use
-
-```dot
-digraph when_to_use {
-    "Polling a batch?" [shape=diamond];
-    "state == awaiting_clarification?" [shape=diamond];
-    "proposedInterpretation is a string?" [shape=diamond];
-    "Read proposal" [shape=box];
-    "Accept or correct" [shape=diamond];
-    "POST proposal verbatim" [shape=box];
-    "POST corrected text" [shape=box];
-
-    "Polling a batch?" -> "state == awaiting_clarification?";
-    "state == awaiting_clarification?" -> "proposedInterpretation is a string?" [label="yes"];
-    "state == awaiting_clarification?" -> "Continue polling" [label="no"];
-    "proposedInterpretation is a string?" -> "Read proposal" [label="yes"];
-    "Read proposal" -> "Accept or correct";
-    "Accept or correct" -> "POST proposal verbatim" [label="proposal is right"];
-    "Accept or correct" -> "POST corrected text" [label="proposal is wrong"];
-}
-```
-
-**Use when:**
-- Polling a batch and the terminal envelope has `proposedInterpretation` as a string
-- The mma-* skill that dispatched explicitly references this skill in its "if awaiting_clarification" line
-
-**Don't use when:**
-- `proposedInterpretation` is `{ kind: 'not_applicable', ... }` → batch isn't waiting; just read `results`
-- The batch failed (`error` is a real object) → don't confirm; debug or re-dispatch
-- You don't yet have a `batchId` → this skill resumes existing batches, not new ones
-
-## Endpoint
-
-`POST /clarifications/confirm`
-
-Auth required. NOT cwd-gated — operates on a `batchId`.
-
-@include _shared/auth.md
-
-## Request body
-
-```json
-{
-  "batchId": "550e8400-e29b-41d4-a716-446655440000",
-  "interpretation": "Refactor only the auth module, leaving the user module unchanged"
-}
-```
-
-| Field | Type | Required | Notes |
-|---|---|---|---|
-| `batchId` | string (UUID) | yes | Batch in `awaiting_clarification` state |
-| `interpretation` | string | yes | Accept proposal verbatim, OR provide corrected text the worker should follow instead |
-
-## Response (200)
-
-```json
-{ "batchId": "...", "state": "pending" }
-```
-
-`state` is usually `pending` (batch resumes). May be `complete` if the executor was already waiting and finishes immediately.
-
-## Full flow
-
-```bash
-# 1. Poll until terminal
-RESP=$(curl -f --show-error -s -H "Authorization: Bearer $TOKEN" \
-  "http://localhost:$PORT/batch/$BATCH_ID")
-
-# 2. Check for a string proposal (not the not_applicable sentinel)
-PROPOSAL=$(echo "$RESP" | jq -r 'select(.proposedInterpretation | type == "string") | .proposedInterpretation')
-
-# 3. Confirm — accept proposal verbatim, or supply corrected text
-curl -f --show-error -s -X POST \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d "{\"batchId\":\"$BATCH_ID\",\"interpretation\":\"$PROPOSAL\"}" \
-  "http://localhost:$PORT/clarifications/confirm"
-
-# 4. Resume polling for terminal
-```
-
-@include _shared/polling.md
-
-## Best practices
-
-This skill is described in `multi-model-agent` → "Best practices". Clarification resumption is a universal flow — it triggers whenever any batch enters `awaiting_clarification`, regardless of which recipe produced the batch. There is no per-recipe entry to call out.
-
-Anti-pattern alert: **`clarification-as-info`** (AP5). A string `proposedInterpretation` is a hard gate, not an FYI. The batch will not complete until the caller responds. Either accept the proposal verbatim or correct it.
-
-## Common pitfalls
-
-❌ **Confirming a wrong proposal verbatim because "the service knows best"**
-The service is GUESSING from limited context. If the proposal would do the wrong thing, supply corrected `interpretation` text. **Why:** post-confirmation work is hard to undo.
-
-❌ **Treating the pause as an error**
-`awaiting_clarification` is a SUCCESS path — it caught ambiguity before producing wrong work. Read, decide, confirm.
-
-❌ **Forgetting the `batchId` is the original, not a new one**
-This endpoint mutates the existing batch — it does not create a new one. **Fix:** poll the SAME `batchId` after confirming.
-
-❌ **Polling without checking `proposedInterpretation`'s shape**
-The field is either a `string` (paused) or `{ kind: 'not_applicable' }` (terminal). **Fix:** check the JSON type before treating it as text.
-
-@include _shared/error-handling.md