@dmsdc-ai/aigentry-telepty 0.6.3 → 0.6.4

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@dmsdc-ai/aigentry-telepty` are documented here.
 
+## [0.6.4] - 2026-06-13
+
+### Added — inject consumption-evidence: consumed | queued | unknown (#53)
+
+- **`telepty inject` now distinguishes "delivered" from "consumed".** After the CR
+  (`pty_cr`), the daemon captures an output-ring watermark and `classifyInjectConsumption()`
+  / `verifyBodyConsumed()` (reusing the #52 echo-watermark technique) classify the result:
+  **consumed** (composer cleared + new turn rendered), **queued** (injected text persists
+  in a busy TUI composer), or **unknown** (conservative). The `/submit` response and CLI
+  output now carry this status; a `queued` result on a busy orchestrator TUI prints a
+  pull-fallback hint. Closes the "`Submitted` reads as success but the busy recipient never
+  consumed it" gap (observed 3+ times in a single orchestration wave). Backward-compatible
+  (accepted/retryable semantics and exit codes unchanged; response is a superset).
+
 ## [0.6.3] - 2026-06-13
 
 ### ⚠️ BREAKING — daemon binds 127.0.0.1 by default (#50)

package/cli.js

@@ -2423,7 +2423,21 @@ async function main() {
             : '';
           const attemptsNote = submitData.attempts > 1 ? ` (${submitData.attempts} attempts)` : '';
           const forcedNote = submitData.forced ? ' [forced]' : '';
-          console.log(`✅ Submitted via ${submitData.strategy}${attemptsNote}${gateNote}${lateNote}${forcedNote}.`);
+          const tail = `${attemptsNote}${gateNote}${lateNote}${forcedNote}`;
+          // #53: distinguish CONSUMED-as-a-turn from QUEUED-in-a-busy-composer. A bare
+          // "Submitted via pty_cr" only proves bytes reached the PTY; a busy recipient TUI
+          // parks the text without firing a turn, so report that instead of a false success.
+          const consumption = submitData.consumption
+            || (submitData.verify && submitData.verify.consumption) || null;
+          if (consumption === 'queued') {
+            console.log(`⚠️  Submitted via ${submitData.strategy}${tail}, but recipient is BUSY — text QUEUED, NOT consumed as a new turn. It will be processed after the current turn ends; if a reply is expected, fall back to pulling the recipient's state.`);
+          } else if (consumption === 'consumed') {
+            console.log(`✅ Submitted via ${submitData.strategy}${tail} — consumed as a new turn.`);
+          } else if (consumption === 'unknown') {
+            console.log(`✅ Submitted via ${submitData.strategy}${tail} (consumption=unknown — delivered to PTY; turn-consumption not observable).`);
+          } else {
+            console.log(`✅ Submitted via ${submitData.strategy}${tail}.`);
+          }
         } else if (submitRes && submitRes.status === 504) {
           // Soft failure: REPL never readied. Orchestrator scripts depend on
           // exit 0 here — surface a clear remediation hint but do not exit

package/daemon.js

@@ -2815,6 +2815,9 @@ app.post('/api/sessions/:id/submit', async (req, res) => {
   const settleEnabled = req.body?.input_settle_gate !== false;
   let strategy = await gatedTerminalSubmit(id, session, injectedBody, settleEnabled);
   let submittedAtMs = Date.now();
+  // #53: outputRing watermark at the CR — scopes consumption-evidence matching to frames
+  // appended AFTER this submit (composer redraw / new-turn render), surviving ring trimming.
+  let ringBytesAtSubmit = session.outputRingTotalBytes || 0;
   let attempts = strategy ? 1 : 0;
   if (!strategy) {
     if (injectedBody) {
@@ -2836,12 +2839,15 @@ app.post('/api/sessions/:id/submit', async (req, res) => {
   // shot is enough. A retry is idempotent only when the body is still visible.
   let verify = null;
   let confirm = null;
+  let consumption = null;        // #53: 'consumed' | 'queued' | 'unknown'
+  let consumptionReason = null;
   if (injectedBody && injectedBody.length > 0) {
     confirm = await confirmSubmitAfterDispatch(id, session, injectedBody, submittedAtMs, verifyTimeoutMs);
     while (confirm && !confirm.accepted && confirm.retryable && attempts <= retries) {
       await new Promise(resolve => setTimeout(resolve, retryDelayMs));
       const retryStrategy = await gatedTerminalSubmit(id, session, injectedBody, settleEnabled);
       submittedAtMs = Date.now();
+      ringBytesAtSubmit = session.outputRingTotalBytes || 0;
       if (!retryStrategy) break;
       strategy = retryStrategy;
       attempts++;
@@ -2849,6 +2855,25 @@ app.post('/api/sessions/:id/submit', async (req, res) => {
     }
     verify = buildSubmitVerify(confirm);
 
+    // #53: consumption-evidence on the DELIVERY path. `confirm.accepted` can read a BUSY
+    // recipient's mid-turn output as success (the isAcceptedSubmitState last_output_at leak),
+    // so additionally classify whether the body was CONSUMED as a fresh turn vs QUEUED in a
+    // busy composer vs UNKNOWN — and surface it to the caller. Advisory + additive: it does
+    // NOT change accepted/retryable (back-compat); it only tells the sender what telepty can
+    // actually observe past the PTY layer. Conservative (never-false-consumed).
+    const consumptionResult = await submitGate.classifyInjectConsumption(session, injectedBody, {
+      submittedAtMs,
+      sinceBytes: ringBytesAtSubmit,
+      getState: () => sessionStateManager.getState(id),
+      stripAnsi: stripAnsiState,
+    });
+    consumption = consumptionResult.status;
+    consumptionReason = consumptionResult.reason;
+    if (verify) {
+      verify.consumption = consumptionResult.status;
+      verify.consumption_reason = consumptionResult.reason;
+    }
+
     if (confirm && !confirm.accepted) {
       const reason = gatedDispatchAfterTimeout ? 'gated_dispatch_unconsumed' : 'submit_unconfirmed';
       const failBody = {
@@ -2863,6 +2888,7 @@ app.post('/api/sessions/:id/submit', async (req, res) => {
         gate_wait_ms: gateResult.waited_ms,
         verify,
         confirm,
+        ...(consumption ? { consumption, consumption_reason: consumptionReason } : {}),
         gated_dispatch_after_timeout: true,
         ...(promptSymbol ? { prompt_symbol: promptSymbol } : {}),
       };
@@ -2885,6 +2911,7 @@ app.post('/api/sessions/:id/submit', async (req, res) => {
     gate_wait_ms: gateResult.waited_ms,
     verify,
     confirm,
+    ...(consumption ? { consumption, consumption_reason: consumptionReason } : {}),
     ...(gatedDispatchAfterTimeout ? { gated_dispatch_after_timeout: true } : {}),
     ...(promptSymbol ? { prompt_symbol: promptSymbol } : {}),
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dmsdc-ai/aigentry-telepty",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "main": "daemon.js",
   "bin": {
     "aigentry-telepty": "install.js",
@@ -37,9 +37,9 @@
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
     "preuninstall": "node scripts/preuninstall.js",
-    "test": "node --require ./test-support/setup-env.js --test test/auth.test.js test/http-auth.test.js test/broker-protocol.test.js test/broker-auth.test.js test/broker-server.test.js test/broker-client.test.js test/daemon-broker-wiring.test.js test/broker-cli.test.js test/broker-integration.test.js test/daemon.test.js test/daemon-singleton.test.js test/daemon-harness-port.test.js test/daemon-bind-default.test.js test/integration/daemon-launch.test.js test/cli.test.js test/subcommand-help.test.js test/telepty-kill.test.js test/idle-ttl.test.js test/telepty-clean-older-than.test.js test/lifecycle-transport-agnostic.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js test/session-routing.test.js test/session-state.test.js test/session-store-persistence.test.js test/mailbox-lock.test.js test/report-enforcement.test.js test/enforce-report.test.js test/peer-inject-validator.test.js test/enforce-submit-gate.test.js test/submit-gate.test.js test/submit-via-pty.test.js test/submit-render-gate.test.js test/prompt-symbol-registry.test.js test/inject-submit-flags.test.js test/inject-submit-force-env.test.js test/host-spec.test.js test/cross-host-inject.test.js test/cross-machine-ssh-routing.test.js test/init.test.js test/install-service-generation.test.js test/install-broker-service.test.js test/uninstall.test.js test/win-resolve-executable.test.js test/version-handshake.test.js test/ensure-daemon-running.test.js test/daemon-restart-fallback-15.test.js test/win-kill-process.test.js test/daemon-control-port-owner.test.js test/banner-stderr-jq-safety.test.js test/bridge-supervisor-ipc.test.js test/bridge-j3-shim.test.js test/bridge-e2e.test.js test/release-0.4.5-bugfixes.test.js test/idle-unconfirmed-settle.test.js test/idle-unconfirmed-consumption.test.js test/provenance.test.js test/inject-audit-broker-seam.test.js test/inject-provenance-daemon.test.js test/inject-audit-log.test.js test/inject-audit-daemon.test.js test/inject-audit-cli.test.js && git diff --exit-code tests/snippet-protocol/v1/",
-    "test:watch": "node --require ./test-support/setup-env.js --test --watch test/auth.test.js test/http-auth.test.js test/broker-protocol.test.js test/broker-auth.test.js test/broker-server.test.js test/broker-client.test.js test/daemon-broker-wiring.test.js test/broker-cli.test.js test/broker-integration.test.js test/daemon.test.js test/daemon-singleton.test.js test/daemon-harness-port.test.js test/daemon-bind-default.test.js test/integration/daemon-launch.test.js test/cli.test.js test/subcommand-help.test.js test/telepty-kill.test.js test/idle-ttl.test.js test/telepty-clean-older-than.test.js test/lifecycle-transport-agnostic.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js test/session-routing.test.js test/session-state.test.js test/session-store-persistence.test.js test/mailbox-lock.test.js test/report-enforcement.test.js test/enforce-report.test.js test/peer-inject-validator.test.js test/enforce-submit-gate.test.js test/submit-gate.test.js test/submit-via-pty.test.js test/submit-render-gate.test.js test/prompt-symbol-registry.test.js test/inject-submit-flags.test.js test/inject-submit-force-env.test.js test/host-spec.test.js test/cross-host-inject.test.js test/cross-machine-ssh-routing.test.js test/init.test.js test/install-service-generation.test.js test/install-broker-service.test.js test/uninstall.test.js test/win-resolve-executable.test.js test/version-handshake.test.js test/ensure-daemon-running.test.js test/daemon-restart-fallback-15.test.js test/win-kill-process.test.js test/daemon-control-port-owner.test.js test/banner-stderr-jq-safety.test.js test/bridge-supervisor-ipc.test.js test/bridge-j3-shim.test.js test/bridge-e2e.test.js test/release-0.4.5-bugfixes.test.js test/idle-unconfirmed-settle.test.js test/idle-unconfirmed-consumption.test.js test/provenance.test.js test/inject-audit-broker-seam.test.js test/inject-provenance-daemon.test.js test/inject-audit-log.test.js test/inject-audit-daemon.test.js test/inject-audit-cli.test.js",
-    "test:ci": "node --require ./test-support/setup-env.js --test --test-reporter=spec test/auth.test.js test/http-auth.test.js test/broker-protocol.test.js test/broker-auth.test.js test/broker-server.test.js test/broker-client.test.js test/daemon-broker-wiring.test.js test/broker-cli.test.js test/broker-integration.test.js test/daemon.test.js test/daemon-singleton.test.js test/daemon-harness-port.test.js test/daemon-bind-default.test.js test/integration/daemon-launch.test.js test/cli.test.js test/subcommand-help.test.js test/telepty-kill.test.js test/idle-ttl.test.js test/telepty-clean-older-than.test.js test/lifecycle-transport-agnostic.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js test/session-routing.test.js test/session-state.test.js test/session-store-persistence.test.js test/mailbox-lock.test.js test/report-enforcement.test.js test/enforce-report.test.js test/peer-inject-validator.test.js test/enforce-submit-gate.test.js test/submit-gate.test.js test/submit-via-pty.test.js test/submit-render-gate.test.js test/prompt-symbol-registry.test.js test/inject-submit-flags.test.js test/inject-submit-force-env.test.js test/host-spec.test.js test/cross-host-inject.test.js test/cross-machine-ssh-routing.test.js test/init.test.js test/install-service-generation.test.js test/install-broker-service.test.js test/uninstall.test.js test/win-resolve-executable.test.js test/version-handshake.test.js test/ensure-daemon-running.test.js test/daemon-restart-fallback-15.test.js test/win-kill-process.test.js test/daemon-control-port-owner.test.js test/banner-stderr-jq-safety.test.js test/bridge-supervisor-ipc.test.js test/bridge-j3-shim.test.js test/bridge-e2e.test.js test/release-0.4.5-bugfixes.test.js test/idle-unconfirmed-settle.test.js test/idle-unconfirmed-consumption.test.js test/provenance.test.js test/inject-audit-broker-seam.test.js test/inject-provenance-daemon.test.js test/inject-audit-log.test.js test/inject-audit-daemon.test.js test/inject-audit-cli.test.js && git diff --exit-code tests/snippet-protocol/v1/",
+    "test": "node --require ./test-support/setup-env.js --test test/auth.test.js test/http-auth.test.js test/broker-protocol.test.js test/broker-auth.test.js test/broker-server.test.js test/broker-client.test.js test/daemon-broker-wiring.test.js test/broker-cli.test.js test/broker-integration.test.js test/daemon.test.js test/daemon-singleton.test.js test/daemon-harness-port.test.js test/daemon-bind-default.test.js test/integration/daemon-launch.test.js test/cli.test.js test/subcommand-help.test.js test/telepty-kill.test.js test/idle-ttl.test.js test/telepty-clean-older-than.test.js test/lifecycle-transport-agnostic.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js test/session-routing.test.js test/session-state.test.js test/session-store-persistence.test.js test/mailbox-lock.test.js test/report-enforcement.test.js test/enforce-report.test.js test/peer-inject-validator.test.js test/enforce-submit-gate.test.js test/submit-gate.test.js test/submit-via-pty.test.js test/submit-render-gate.test.js test/prompt-symbol-registry.test.js test/inject-submit-flags.test.js test/inject-submit-force-env.test.js test/inject-consumption-evidence.test.js test/host-spec.test.js test/cross-host-inject.test.js test/cross-machine-ssh-routing.test.js test/init.test.js test/install-service-generation.test.js test/install-broker-service.test.js test/uninstall.test.js test/win-resolve-executable.test.js test/version-handshake.test.js test/ensure-daemon-running.test.js test/daemon-restart-fallback-15.test.js test/win-kill-process.test.js test/daemon-control-port-owner.test.js test/banner-stderr-jq-safety.test.js test/bridge-supervisor-ipc.test.js test/bridge-j3-shim.test.js test/bridge-e2e.test.js test/release-0.4.5-bugfixes.test.js test/idle-unconfirmed-settle.test.js test/idle-unconfirmed-consumption.test.js test/provenance.test.js test/inject-audit-broker-seam.test.js test/inject-provenance-daemon.test.js test/inject-audit-log.test.js test/inject-audit-daemon.test.js test/inject-audit-cli.test.js && git diff --exit-code tests/snippet-protocol/v1/",
+    "test:watch": "node --require ./test-support/setup-env.js --test --watch test/auth.test.js test/http-auth.test.js test/broker-protocol.test.js test/broker-auth.test.js test/broker-server.test.js test/broker-client.test.js test/daemon-broker-wiring.test.js test/broker-cli.test.js test/broker-integration.test.js test/daemon.test.js test/daemon-singleton.test.js test/daemon-harness-port.test.js test/daemon-bind-default.test.js test/integration/daemon-launch.test.js test/cli.test.js test/subcommand-help.test.js test/telepty-kill.test.js test/idle-ttl.test.js test/telepty-clean-older-than.test.js test/lifecycle-transport-agnostic.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js test/session-routing.test.js test/session-state.test.js test/session-store-persistence.test.js test/mailbox-lock.test.js test/report-enforcement.test.js test/enforce-report.test.js test/peer-inject-validator.test.js test/enforce-submit-gate.test.js test/submit-gate.test.js test/submit-via-pty.test.js test/submit-render-gate.test.js test/prompt-symbol-registry.test.js test/inject-submit-flags.test.js test/inject-submit-force-env.test.js test/inject-consumption-evidence.test.js test/host-spec.test.js test/cross-host-inject.test.js test/cross-machine-ssh-routing.test.js test/init.test.js test/install-service-generation.test.js test/install-broker-service.test.js test/uninstall.test.js test/win-resolve-executable.test.js test/version-handshake.test.js test/ensure-daemon-running.test.js test/daemon-restart-fallback-15.test.js test/win-kill-process.test.js test/daemon-control-port-owner.test.js test/banner-stderr-jq-safety.test.js test/bridge-supervisor-ipc.test.js test/bridge-j3-shim.test.js test/bridge-e2e.test.js test/release-0.4.5-bugfixes.test.js test/idle-unconfirmed-settle.test.js test/idle-unconfirmed-consumption.test.js test/provenance.test.js test/inject-audit-broker-seam.test.js test/inject-provenance-daemon.test.js test/inject-audit-log.test.js test/inject-audit-daemon.test.js test/inject-audit-cli.test.js",
+    "test:ci": "node --require ./test-support/setup-env.js --test --test-reporter=spec test/auth.test.js test/http-auth.test.js test/broker-protocol.test.js test/broker-auth.test.js test/broker-server.test.js test/broker-client.test.js test/daemon-broker-wiring.test.js test/broker-cli.test.js test/broker-integration.test.js test/daemon.test.js test/daemon-singleton.test.js test/daemon-harness-port.test.js test/daemon-bind-default.test.js test/integration/daemon-launch.test.js test/cli.test.js test/subcommand-help.test.js test/telepty-kill.test.js test/idle-ttl.test.js test/telepty-clean-older-than.test.js test/lifecycle-transport-agnostic.test.js test/skill-installer.test.js test/interactive-terminal.test.js test/runtime-info.test.js test/session-routing.test.js test/session-state.test.js test/session-store-persistence.test.js test/mailbox-lock.test.js test/report-enforcement.test.js test/enforce-report.test.js test/peer-inject-validator.test.js test/enforce-submit-gate.test.js test/submit-gate.test.js test/submit-via-pty.test.js test/submit-render-gate.test.js test/prompt-symbol-registry.test.js test/inject-submit-flags.test.js test/inject-submit-force-env.test.js test/inject-consumption-evidence.test.js test/host-spec.test.js test/cross-host-inject.test.js test/cross-machine-ssh-routing.test.js test/init.test.js test/install-service-generation.test.js test/install-broker-service.test.js test/uninstall.test.js test/win-resolve-executable.test.js test/version-handshake.test.js test/ensure-daemon-running.test.js test/daemon-restart-fallback-15.test.js test/win-kill-process.test.js test/daemon-control-port-owner.test.js test/banner-stderr-jq-safety.test.js test/bridge-supervisor-ipc.test.js test/bridge-j3-shim.test.js test/bridge-e2e.test.js test/release-0.4.5-bugfixes.test.js test/idle-unconfirmed-settle.test.js test/idle-unconfirmed-consumption.test.js test/provenance.test.js test/inject-audit-broker-seam.test.js test/inject-provenance-daemon.test.js test/inject-audit-log.test.js test/inject-audit-daemon.test.js test/inject-audit-cli.test.js && git diff --exit-code tests/snippet-protocol/v1/",
     "typecheck": "tsc --noEmit",
     "regen-fixtures": "node scripts/regen-snippet-fixtures.js"
   },
@@ -61,7 +61,7 @@
   ],
   "author": "dmsdc-ai",
   "license": "ISC",
-  "description": "Universal terminal session bridge \u2014 connect any terminal to any terminal, any machine",
+  "description": "Universal terminal session bridge — connect any terminal to any terminal, any machine",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dmsdc-ai/aigentry-telepty.git"

package/src/submit-gate.js

@@ -438,6 +438,85 @@ function observeInjectEcho(session, bodyText, opts = {}) {
   return { observed: false, reason: 'no_echo', windows_matched: hits };
 }
 
+// #53: classify whether an injected+submitted body was CONSUMED as a new turn by the
+// recipient TUI, vs QUEUED in a busy composer, vs UNKNOWN. This is the DELIVERY-side dual
+// of #52 (which gates the IDLE signal on consumption evidence). A bare `Submitted via
+// pty_cr` only proves bytes reached the PTY master; a BUSY Claude Code TUI parks the CR'd
+// text in its composer ("Press up to edit queued messages") and never starts a turn, so the
+// sender must be able to tell `queued` from `consumed`.
+//
+// Hard boundary (#53): telepty cannot see inside the TUI's turn loop, so `consumed` is only
+// claimable from OBSERVABLE evidence, and never-false-consumed is conservative:
+//
+//   consumed — the recipient was NOT already busy at the CR and then began a FRESH turn:
+//              an idle→working/thinking transition whose since_ms ≥ submittedAtMs (a genuine
+//              new turn, NOT mere continued output from a turn already running — the leak
+//              that made `last_output_at ≥ submittedAtMs` read a busy queue as success).
+//   queued   — the injected body is still observably PARKED on screen after a short settle
+//              (windowed echo match — #52 technique — tolerates composer line-wrap/borders).
+//              A recipient already busy at the CR can only ever land here (fact 1: busy CR
+//              queues, never fires), never in `consumed`.
+//   unknown  — neither positive signal within the window (conservative default).
+//
+// Pure: DI getState + outputRing-only, DI now/sleep/stripAnsi — no I/O, no daemon coupling.
+async function classifyInjectConsumption(session, bodyText, opts = {}) {
+  const timeoutMs   = Number.isFinite(opts.timeoutMs)   ? opts.timeoutMs   : 1200;
+  const settleMs    = Number.isFinite(opts.settleMs)    ? opts.settleMs    : 250;
+  const intervalMs  = Number.isFinite(opts.intervalMs)  ? opts.intervalMs  : 80;
+  const minChars    = Number.isFinite(opts.minChars)    ? opts.minChars    : 24;
+  const stripAnsi   = typeof opts.stripAnsi === 'function' ? opts.stripAnsi : (s) => s;
+  const now         = typeof opts.now   === 'function' ? opts.now   : () => Date.now();
+  const sleep       = typeof opts.sleep === 'function' ? opts.sleep : (ms) => new Promise((r) => setTimeout(r, ms));
+  const getState    = typeof opts.getState === 'function' ? opts.getState : null;
+  const submittedAtMs = Number.isFinite(opts.submittedAtMs) ? opts.submittedAtMs : now();
+  const sinceBytes  = Number.isFinite(opts.sinceBytes) ? opts.sinceBytes : null;
+
+  const body = normalize(bodyText);
+  if (body.length === 0)        return { status: 'unknown', reason: 'empty_body', waited_ms: 0 };
+  if (body.length < minChars)   return { status: 'unknown', reason: 'body_too_short', waited_ms: 0 };
+  if (!session || !Array.isArray(session.outputRing)) {
+    return { status: 'unknown', reason: 'no_ring', waited_ms: 0 };
+  }
+
+  // Was the recipient ALREADY busy when the CR was written? A busy claude-code TUI parks the
+  // CR'd text and never starts a turn (#53 fact 1), so we may observe `queued` there but must
+  // NEVER claim `consumed` — that is the hard boundary that produced the false success.
+  const initial = getState ? getState() : null;
+  const startedBusy = !!(initial && ACCEPTED_AFTER_SUBMIT_STATES.has(initial.state)
+    && Number.isFinite(initial.since_ms) && initial.since_ms < submittedAtMs);
+
+  const observeParked = () => observeInjectEcho(session, bodyText, { stripAnsi, sinceBytes, minChars });
+
+  const start = now();
+  while (true) {
+    // consumed — only from a non-busy start that produced a fresh idle→working/thinking turn.
+    if (!startedBusy && getState) {
+      const st = getState();
+      if (st && ACCEPTED_AFTER_SUBMIT_STATES.has(st.state)
+          && Number.isFinite(st.since_ms) && st.since_ms >= submittedAtMs) {
+        return { status: 'consumed', reason: `turn_started_${st.state}`, waited_ms: now() - start };
+      }
+    }
+
+    const elapsed = now() - start;
+    // Busy recipient cannot consume — short-circuit to `queued` as soon as the parked body
+    // settles, instead of waiting out the full window for a turn that will never come.
+    if (startedBusy && elapsed >= settleMs) {
+      const echo = observeParked();
+      if (echo.observed) return { status: 'queued', reason: 'busy_parked', waited_ms: elapsed };
+    }
+
+    if (elapsed >= timeoutMs) {
+      const echo = observeParked();
+      if (echo.observed) {
+        return { status: 'queued', reason: startedBusy ? 'busy_parked' : 'body_parked', waited_ms: elapsed };
+      }
+      return { status: 'unknown', reason: startedBusy ? 'busy_no_evidence' : 'no_turn', waited_ms: elapsed };
+    }
+    await sleep(intervalMs);
+  }
+}
+
 function isAcceptedSubmitState(state, submittedAtMs) {
   if (!state || !ACCEPTED_AFTER_SUBMIT_STATES.has(state.state)) return false;
   if (!Number.isFinite(submittedAtMs)) {
@@ -613,6 +692,7 @@ module.exports = {
   confirmSubmitAccepted,
   observeBodyVisibility,
   observeInjectEcho,
+  classifyInjectConsumption,
   awaitPromptSymbol,
   defaultReadScreen,
   isReady,