agent-conveyor 0.1.10 → 0.1.11

package/README.md

@@ -372,9 +372,13 @@ tmux attach -t codex-live-test
   `heartbeat_recommendations` with role-specific poll prompts; Dispatch can
   deliver into those inboxes, but a heartbeat or operator wake-up is still
   required to make an idle app thread poll autonomously. Those recommendations
-  include a `teardown_policy`: an idle poll is only a quiet interval, not a
-  reason to delete or pause heartbeat automation; heartbeat teardown belongs to
-  the manager/operator after terminal closeout or explicit operator instruction.
+  also include `wakeup_dispatch_command` and `delivery_receipt_commands` for
+  app-thread wake recovery. Use them to record sent, skipped, and blocked wake
+  outcomes after `app-wakeup-dispatch`; an app-thread send is not task
+  completion. The recommendations include a `teardown_policy`: an idle poll is
+  only a quiet interval, not a reason to delete or pause heartbeat automation;
+  heartbeat teardown belongs to the manager/operator after terminal closeout or
+  explicit operator instruction.
   The optional
   Codex app thread metadata is normally supplied after a Codex app manager has
   used `create_thread` and `set_thread_title`; terminal-only users can omit it
@@ -1045,10 +1049,12 @@ Current dispatch state:
   reaches `max_iterations`. For no-tmux Codex app sessions, treat
   `communication.requires_polling=true` as requiring a heartbeat/wake layer:
   a delivered pull inbox item does not by itself wake an idle app thread. Do
-  not delete or pause heartbeats because an inbox poll is idle. A terminal
-  manager decision should be followed by `finish-task --require-criteria-audit`
-  or by an explicit blocker explaining why the task/binding still appears
-  active.
+  not delete or pause heartbeats because an inbox poll is idle. Use generated
+  `heartbeat_recommendations.wakeup_dispatch_command` and
+  `heartbeat_recommendations.delivery_receipt_commands` for stale-thread wake
+  recovery receipts. A terminal manager decision should be followed by
+  `finish-task --require-criteria-audit` or by an explicit blocker explaining
+  why the task/binding still appears active.
 - `register-worker`, `register-manager`, `sessions`, `discover`, and
   `create-disposable-binding --json` expose a `communication` block per
   session. Treat `session_kind='tmux'` plus `receive_style='push'` as direct

package/dist/cli/typescript-runtime.js

@@ -17114,6 +17114,8 @@ function renderDisposableBindingText(result) {
         lines.push(`  worker: ${result.heartbeat_recommendations.worker.poll_command}`);
         lines.push(`  status: ${result.heartbeat_recommendations.status_command}`);
         lines.push(`  wakeup plan: ${result.heartbeat_recommendations.wakeup_plan_command}`);
+        lines.push(`  wakeup dispatch: ${result.heartbeat_recommendations.wakeup_dispatch_command}`);
+        lines.push(`  delivery sent: ${result.heartbeat_recommendations.delivery_receipt_commands.sent}`);
         lines.push(`  teardown: ${result.heartbeat_recommendations.teardown_policy.idle_poll}`);
         lines.push(`  closeout: ${result.heartbeat_recommendations.teardown_policy.terminal_closeout_command}`);
     }
@@ -17127,6 +17129,8 @@ function disposableHeartbeatRecommendations(taskName, dbPath) {
     const workerHeartbeatCommand = disposableAppHeartbeatCommand("worker", taskName, dbPath);
     const managerInboxCommand = sessionPollCommand("manager", taskName, dbPath);
     const workerInboxCommand = sessionPollCommand("worker", taskName, dbPath);
+    const wakeupDispatchCommand = `${conveyorPollInvocation()} app-wakeup-dispatch ${shellQuote(taskName)} --path ${shellQuote(dbPath)} --json`;
+    const deliveryReceiptCommands = disposableDeliveryReceiptCommands(taskName, dbPath);
     return {
         applies_when: {
             can_receive_push: false,
@@ -17134,6 +17138,7 @@ function disposableHeartbeatRecommendations(taskName, dbPath) {
             receive_style: "pull",
             session_kind: "codex_app",
         },
+        delivery_receipt_commands: deliveryReceiptCommands,
         interval_minutes: 2,
         note: "Dispatch can deliver pull-required inbox items, but Codex app/no-tmux sessions still need a heartbeat or operator wake-up to poll while idle.",
         status_command: `${conveyorPollInvocation()} app-loop-status ${shellQuote(taskName)} --path ${shellQuote(dbPath)} --json`,
@@ -17144,6 +17149,7 @@ function disposableHeartbeatRecommendations(taskName, dbPath) {
             terminal_closeout_command: terminalCloseoutCommand,
             worker_rule: "The worker must not own loop teardown and must not remove heartbeat automation based on idle polling.",
         },
+        wakeup_dispatch_command: wakeupDispatchCommand,
         wakeup_plan_command: `${conveyorPollInvocation()} app-wakeup-plan ${shellQuote(taskName)} --path ${shellQuote(dbPath)} --json`,
         manager: {
             direct_inbox_command: managerInboxCommand,
@@ -17154,6 +17160,11 @@ function disposableHeartbeatRecommendations(taskName, dbPath) {
                 `Run the manager app heartbeat for task ${taskName}.`,
                 `Run: ${managerHeartbeatCommand}`,
                 `If the heartbeat output asks for direct inbox polling, run: ${managerInboxCommand}`,
+                `For stale app-thread recovery with an auditable receipt, run: ${wakeupDispatchCommand}`,
+                "Send app-thread wake prompts only for actions where `send_ready=true`; direct app-thread delivery is not task completion.",
+                `After a successful app-thread send, record it with: ${deliveryReceiptCommands.sent}`,
+                `For healthy skipped actions, record: ${deliveryReceiptCommands.skipped}`,
+                `For missing-thread blocked actions, record: ${deliveryReceiptCommands.blocked}`,
                 "If an item is consumed, execute only that manager instruction, verify worker claims before recording conclusions, update Conveyor state as appropriate, and produce exactly one next worker task.",
                 "If no item is consumed, stop after a one-line idle receipt.",
                 "Do not delete, pause, or disable manager or worker heartbeat automation after an idle poll; an idle poll is only a quiet interval.",
@@ -17170,13 +17181,23 @@ function disposableHeartbeatRecommendations(taskName, dbPath) {
                 `Run the worker app heartbeat for task ${taskName}.`,
                 `Run: ${workerHeartbeatCommand}`,
                 `If the heartbeat output asks for direct inbox polling, run: ${workerInboxCommand}`,
-                "If an item is consumed, execute only that single worker instruction and return exact commands, compact evidence, blockers/residual risk, and exactly one next recommended worker task.",
+                "If an item is consumed, execute only that single worker instruction and return exact commands, compact evidence for any completion claim, blockers/residual risk, and exactly one next recommended worker task.",
                 "If no item is consumed, stop after a one-line idle receipt.",
                 "Do not delete, pause, or disable worker heartbeat automation after an idle poll; the manager or operator owns terminal loop teardown.",
             ].join("\n"),
         },
     };
 }
+function disposableDeliveryReceiptCommands(taskName, dbPath) {
+    const base = `${conveyorPollInvocation()} app-wakeup-record-delivery ${shellQuote(taskName)} --role <role> --dispatch-receipt <receipt.event_id>`;
+    const pathAndJson = ` --path ${shellQuote(dbPath)} --json`;
+    return {
+        blocked: `${base} --delivery-status blocked${pathAndJson}`,
+        note: "Run these only after app-wakeup-dispatch. Replace <role>, <receipt.event_id>, and <action.thread.id> from the dispatch JSON; sent is valid only for send_ready=true actions.",
+        sent: `${base} --delivery-status sent --thread-id <action.thread.id>${pathAndJson}`,
+        skipped: `${base} --delivery-status skipped${pathAndJson}`,
+    };
+}
 function disposableAppHeartbeatCommand(role, taskName, dbPath) {
     return `${conveyorPollInvocation()} app-heartbeat ${shellQuote(taskName)} --role ${role} --path ${shellQuote(dbPath)} --json`;
 }