@sema-agent/core 7.60.0 → 7.62.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -54,7 +54,7 @@ export interface MailboxCrossProcessContractHooks {
|
|
|
54
54
|
/**
|
|
55
55
|
* T2 可选能力层(cross-process 分册,design/385 §1.2⑥ / G11)—— 声明 `crossProcessSafe: true` 的后端必须
|
|
56
56
|
* 过的全套判据。钉的是**整套**(跨进程 seq 单铸 + lease/ack 不交叉 + 一方的 housekeeping 不丢另一方的
|
|
57
|
-
* 已落盘 append + reap/drop 的 seq 语义跨进程成立),不是「有锁」:一把锁配一份陈旧缓存照样在锁内铸
|
|
57
|
+
* 已落盘 append + reap/drop 的 seq 语义跨进程成立 + 已收窗跨进程共享),不是「有锁」:一把锁配一份陈旧缓存照样在锁内铸
|
|
58
58
|
* 重号、照样把别人的消息压缩掉——所以每一条都从**对方进程的视角**回读。
|
|
59
59
|
*
|
|
60
60
|
* 受众:文件后端(本仓捆绑)、SQL 后端(事务天然过)。进程内 Map 的参照实现与 CC inbox 适配器不声明,
|
|
@@ -63,11 +63,18 @@ export interface MailboxCrossProcessContractHooks {
|
|
|
63
63
|
*/
|
|
64
64
|
export declare function mailboxCrossProcessContract(hooks: MailboxCrossProcessContractHooks): Promise<void>;
|
|
65
65
|
export interface MailboxTombstonedRecipientContractHooks {
|
|
66
|
-
/** Put `(scope, handle)` into the deployment's PRE-DELETE state
|
|
67
|
-
*
|
|
68
|
-
*
|
|
69
|
-
|
|
66
|
+
/** Put `(scope, handle)` into the deployment's PRE-DELETE state, for a backend that keeps the state
|
|
67
|
+
* outside the store face (a cascade marking the session row, a `deleting` column). A store that
|
|
68
|
+
* carries the recipient-lifecycle pair (`retireRecipient` / `listRetiredRecipients`) is retired
|
|
69
|
+
* through its own `retireRecipient` instead, and then this hook is refused: two ways to write one
|
|
70
|
+
* state are two readings of it. */
|
|
71
|
+
tombstone?: (store: MailboxStore, scope: string, handle: string) => Promise<void>;
|
|
70
72
|
runAssertion?: ContractAssertionRunner;
|
|
73
|
+
/** The observable channel for the optional pair: a case name cannot carry "verified" vs "absent". */
|
|
74
|
+
onOptionalMember?: (report: {
|
|
75
|
+
member: "recipientLifecycle";
|
|
76
|
+
status: "verified" | "absent";
|
|
77
|
+
}) => void;
|
|
71
78
|
}
|
|
72
79
|
/**
|
|
73
80
|
* T2 可选能力层(pre-delete 分册)—— 只挂**看得见收件人生命周期**的后端:它的 mailbox 行与某个
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { strict as assert } from "node:assert";
|
|
2
|
-
import { MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_INVALID_DECISION_MOVE_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE } from "../mailbox-store.js";
|
|
2
|
+
import { MAILBOX_CONSUMED_ID_WINDOW, MAILBOX_DUPLICATE_RECORD_ID_CODE, MAILBOX_INVALID_PEER_META_CODE, MAILBOX_INVALID_DECISION_MOVE_CODE, MAILBOX_INVALID_RECORD_ID_CODE, MAILBOX_TOMBSTONED_RECIPIENT_CODE, mailboxRecipientLifecycleOf } from "../mailbox-store.js";
|
|
3
3
|
import { beginContract } from "./contract-harness.js";
|
|
4
|
+
import { thrownText } from "../thrown-value.js";
|
|
4
5
|
import { PRINCIPAL_INBOX_HANDLE } from "../../agents/cross-session-ref.js";
|
|
5
6
|
import { mintCrossPrincipalRecord } from "../../agents/org-delivery-gate.js";
|
|
6
7
|
export const MAILBOX_CONTRACT_SCOPE = "default";
|
|
@@ -50,7 +51,7 @@ export async function mailboxStoreContract(mk, runAssertion) {
|
|
|
50
51
|
await s.ack(S, "a1", "w3", 1);
|
|
51
52
|
assert.equal(await s.append(S, "a1", msg("m2")), 2);
|
|
52
53
|
});
|
|
53
|
-
run("记录身份:箱持有同 id 时 append = 同记录回原 seq 零写 / 异记录点名拒;坏 id 零副作用拒;id 往返;ack
|
|
54
|
+
run("记录身份:箱持有同 id 时 append = 同记录回原 seq 零写 / 异记录点名拒;坏 id 零副作用拒;id 往返;ack 后进已收窗", async (make) => {
|
|
54
55
|
const s = make();
|
|
55
56
|
const codeOf = async (p) => {
|
|
56
57
|
try {
|
|
@@ -78,7 +79,89 @@ export async function mailboxStoreContract(mk, runAssertion) {
|
|
|
78
79
|
const lease = await s.claimLease(S, "a1", "w1", 60_000, 10_000);
|
|
79
80
|
assert.deepEqual(lease.messages.map((m) => m.id), ["frame-1", undefined], "id 往返,缺席仍缺席");
|
|
80
81
|
await s.ack(S, "a1", "w1", lease.maxSeq);
|
|
81
|
-
assert.equal(await s.append(S, "a1", rec),
|
|
82
|
+
assert.equal(await s.append(S, "a1", rec), 1, "箱为它收过的记录作答:ack 后同记录在已收窗内,回原 seq");
|
|
83
|
+
assert.equal(await s.peekCount(S, "a1"), 0, "窗内重放零写");
|
|
84
|
+
});
|
|
85
|
+
const K = MAILBOX_CONSUMED_ID_WINDOW;
|
|
86
|
+
const rec = (id, content = `body-${id}`) => ({ id, from: "w", content, sentAt: 1_000, hopChain: ["h"], peerMeta: { kind: "peer_message", fromRoot: "root" } });
|
|
87
|
+
const consume = async (s, handle, owner) => {
|
|
88
|
+
const l = await s.claimLease(S, handle, owner, 60_000, 10_000);
|
|
89
|
+
assert.notEqual(l, null);
|
|
90
|
+
assert.deepEqual(await s.ack(S, handle, owner, l.maxSeq), { acked: true });
|
|
91
|
+
};
|
|
92
|
+
const codeAndMessage = async (p) => {
|
|
93
|
+
try {
|
|
94
|
+
await p;
|
|
95
|
+
return {};
|
|
96
|
+
}
|
|
97
|
+
catch (e) {
|
|
98
|
+
return { code: e.code, message: thrownText(e) };
|
|
99
|
+
}
|
|
100
|
+
};
|
|
101
|
+
run("W1 窗内同记录:append(X) → claim → ack → 同面 append(X) ⇒ 首个 seq,零写,再 claim = null", async (make) => {
|
|
102
|
+
const s = make();
|
|
103
|
+
assert.equal(await s.append(S, "a1", rec("X")), 1);
|
|
104
|
+
await consume(s, "a1", "w1");
|
|
105
|
+
assert.equal(await s.append(S, "a1", { ...rec("X"), sentAt: 9_000 }), 1, "写入时刻不同仍是同一条(sentAt 不是面)");
|
|
106
|
+
assert.equal(await s.peekCount(S, "a1"), 0);
|
|
107
|
+
assert.equal(await s.claimLease(S, "a1", "w2", 60_000, 20_000), null);
|
|
108
|
+
});
|
|
109
|
+
run("W2 窗内异记录:同 id 换内容 ⇒ mailbox.duplicate_record_id,拒句点名 content,零写", async (make) => {
|
|
110
|
+
const s = make();
|
|
111
|
+
await s.append(S, "a1", rec("X"));
|
|
112
|
+
await consume(s, "a1", "w1");
|
|
113
|
+
const refused = await codeAndMessage(s.append(S, "a1", rec("X", "another body")));
|
|
114
|
+
assert.equal(refused.code, MAILBOX_DUPLICATE_RECORD_ID_CODE);
|
|
115
|
+
assert.match(refused.message ?? "", /content/);
|
|
116
|
+
assert.equal(await s.peekCount(S, "a1"), 0);
|
|
117
|
+
});
|
|
118
|
+
run("W3 窗外:X 收后再收 K 条带 id 记录 ⇒ append(X) = 高水位 + 1,箱里一条", async (make) => {
|
|
119
|
+
const s = make();
|
|
120
|
+
await s.append(S, "a1", rec("X"));
|
|
121
|
+
await consume(s, "a1", "w1");
|
|
122
|
+
for (let i = 0; i < K; i++)
|
|
123
|
+
await s.append(S, "a1", rec(`Y${i}`));
|
|
124
|
+
await consume(s, "a1", "w2");
|
|
125
|
+
assert.equal(await s.append(S, "a1", rec("X")), K + 2, "出窗的 id 是新记录");
|
|
126
|
+
assert.equal(await s.peekCount(S, "a1"), 1);
|
|
127
|
+
});
|
|
128
|
+
run("W4 窗只算带 id:X 收后再收 K 条无 id 记录 ⇒ append(X) 仍回首个 seq", async (make) => {
|
|
129
|
+
const s = make();
|
|
130
|
+
await s.append(S, "a1", rec("X"));
|
|
131
|
+
await consume(s, "a1", "w1");
|
|
132
|
+
for (let i = 0; i < K; i++)
|
|
133
|
+
await s.append(S, "a1", msg(`plain-${i}`));
|
|
134
|
+
await consume(s, "a1", "w2");
|
|
135
|
+
assert.equal(await s.append(S, "a1", rec("X")), 1);
|
|
136
|
+
assert.equal(await s.peekCount(S, "a1"), 0);
|
|
137
|
+
});
|
|
138
|
+
run("W5 寿命:drop 清窗(seq 从 1 重来);reap 留窗,且 reap 清掉的未投记录不进窗", async (make) => {
|
|
139
|
+
const s = make();
|
|
140
|
+
await s.append(S, "a1", rec("X"));
|
|
141
|
+
await consume(s, "a1", "w1");
|
|
142
|
+
await s.drop(S, "a1");
|
|
143
|
+
assert.equal(await s.append(S, "a1", rec("X")), 1, "drop 结束箱的一生:窗随之清,X 是新记录(seq 1)");
|
|
144
|
+
assert.equal(await s.peekCount(S, "a1"), 1);
|
|
145
|
+
const r = make();
|
|
146
|
+
await r.append(S, "b1", rec("X"));
|
|
147
|
+
await consume(r, "b1", "w1");
|
|
148
|
+
await r.append(S, "b1", rec("Z"));
|
|
149
|
+
assert.equal(await r.reap(S, 100_000, { maxAgeMs: 50_000 }), 1);
|
|
150
|
+
assert.equal(await r.append(S, "b1", rec("X")), 1, "reap 留窗:X 仍在窗内");
|
|
151
|
+
assert.equal(await r.append(S, "b1", rec("Z")), 3, "reap 清掉的 Z 从没被收过:新记录,高水位之后");
|
|
152
|
+
});
|
|
153
|
+
run("W8 窗序:第 K + 1 条更新的带 id 记录被收的那一刻最旧那条出窗(分两批 ack)", async (make) => {
|
|
154
|
+
const s = make();
|
|
155
|
+
await s.append(S, "a1", rec("X"));
|
|
156
|
+
await consume(s, "a1", "w1");
|
|
157
|
+
for (let i = 0; i < K - 1; i++)
|
|
158
|
+
await s.append(S, "a1", rec(`Y${i}`));
|
|
159
|
+
await consume(s, "a1", "w2");
|
|
160
|
+
assert.equal(await s.append(S, "a1", rec("X")), 1, "窗里恰 K 条,X 是最旧的一条,仍在");
|
|
161
|
+
await s.append(S, "a1", rec("Y-last"));
|
|
162
|
+
await consume(s, "a1", "w3");
|
|
163
|
+
assert.equal(await s.append(S, "a1", rec("Y0")), 2, "次旧的那条仍在窗内");
|
|
164
|
+
assert.equal(await s.append(S, "a1", rec("X")), K + 2, "第 K + 1 条进窗,X 出窗:新记录");
|
|
82
165
|
});
|
|
83
166
|
run("lease 窗内 append:后到消息在下次 claim 时可见(lease 只覆盖 claim 时刻快照)", async (make) => {
|
|
84
167
|
const s = make();
|
|
@@ -427,6 +510,22 @@ export async function mailboxCrossProcessContract(hooks) {
|
|
|
427
510
|
assert.equal(await peer.peekCount(S, H), 0);
|
|
428
511
|
assert.equal(await peer.append(S, H, msg("after", 200_000)), 3, "高水位跨 reap 存活(对方视角)");
|
|
429
512
|
});
|
|
513
|
+
run("W7 已收窗跨进程:一方 append + ack 带 id 的 X,另一方同记录 append(X) ⇒ 首个 seq 零写;异记录 ⇒ 带码拒", async (local, peer) => {
|
|
514
|
+
const x = { id: "frame-x", from: "w", content: "status", sentAt: 1_000, hopChain: ["h"], peerMeta: { kind: "peer_message", fromRoot: "root" } };
|
|
515
|
+
assert.equal(await local.append(S, H, x), 1);
|
|
516
|
+
const held = await local.claimLease(S, H, "cycle-local", 60_000, 10_000);
|
|
517
|
+
assert.deepEqual(await local.ack(S, H, "cycle-local", held.maxSeq), { acked: true });
|
|
518
|
+
assert.equal(await peer.append(S, H, { ...x, sentAt: 5_000 }), 1, "对方进程看得见本方收进窗的记录:同记录回首个 seq");
|
|
519
|
+
assert.equal(await peer.peekCount(S, H), 0, "零写");
|
|
520
|
+
let code;
|
|
521
|
+
try {
|
|
522
|
+
await peer.append(S, H, { ...x, content: "another" });
|
|
523
|
+
}
|
|
524
|
+
catch (e) {
|
|
525
|
+
code = e.code;
|
|
526
|
+
}
|
|
527
|
+
assert.equal(code, MAILBOX_DUPLICATE_RECORD_ID_CODE);
|
|
528
|
+
});
|
|
430
529
|
run("reap 与 drop 的 seq 语义跨进程:一方 reap 后另一方继续高水位;一方 drop 后另一方从 1 重铸", async (local, peer) => {
|
|
431
530
|
await peer.append(S, H, msg("old", 1_000));
|
|
432
531
|
assert.equal(await local.reap(S, 100_000, { maxAgeMs: 50_000 }), 1, "本方 reap 必须看见对方写的旧消息");
|
|
@@ -444,9 +543,57 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
|
|
|
444
543
|
const run = (name, fn) => runRaw(name, () => withStores(mk, fn));
|
|
445
544
|
const S = MAILBOX_CONTRACT_SCOPE;
|
|
446
545
|
const codeOf = (e) => e?.code;
|
|
546
|
+
const tombstone = async (s, scope, handle) => {
|
|
547
|
+
const pair = mailboxRecipientLifecycleOf(s);
|
|
548
|
+
if (pair === undefined) {
|
|
549
|
+
assert.notEqual(hooks.tombstone, undefined, "nothing puts a recipient into the pre-delete state: the store carries no retireRecipient and no tombstone hook was given");
|
|
550
|
+
return hooks.tombstone(s, scope, handle);
|
|
551
|
+
}
|
|
552
|
+
assert.equal(await pair.retireRecipient(scope, handle, 1_000_000, "label"), true, "retireRecipient answers true when it wrote the tombstone");
|
|
553
|
+
};
|
|
554
|
+
run("收件人生命周期一对成员是一项能力:要么都在、要么都缺;都在时不再另收 tombstone 钩子(同一个态不许两种写法)", async (make) => {
|
|
555
|
+
let carriesPair = false;
|
|
556
|
+
try {
|
|
557
|
+
carriesPair = mailboxRecipientLifecycleOf(make()) !== undefined;
|
|
558
|
+
}
|
|
559
|
+
catch (e) {
|
|
560
|
+
assert.fail(`the store's recipient-lifecycle pair cannot be read: ${thrownText(e)}`);
|
|
561
|
+
}
|
|
562
|
+
assert.equal(carriesPair && hooks.tombstone !== undefined, false, "the store writes its own pre-delete state (retireRecipient), so a tombstone hook is a second way to write it");
|
|
563
|
+
assert.equal(carriesPair || hooks.tombstone !== undefined, true, "nothing puts a recipient into the pre-delete state: no retireRecipient on the store and no tombstone hook");
|
|
564
|
+
});
|
|
565
|
+
run("收件人生命周期一对(可选成员):在则逐条验 —— 只打标、列表、重写、随箱亡;缺席如实上报,不算失败", async (make) => {
|
|
566
|
+
const pair = mailboxRecipientLifecycleOf(make());
|
|
567
|
+
if (pair === undefined) {
|
|
568
|
+
hooks.onOptionalMember?.({ member: "recipientLifecycle", status: "absent" });
|
|
569
|
+
return;
|
|
570
|
+
}
|
|
571
|
+
const listed = make();
|
|
572
|
+
const lp = mailboxRecipientLifecycleOf(listed);
|
|
573
|
+
assert.equal(await lp.retireRecipient(S, "session.a1", 5_000, "Plan"), true, "retireRecipient answers true when it wrote the tombstone");
|
|
574
|
+
await lp.retireRecipient(S, "agent.b1", 6_000);
|
|
575
|
+
await lp.retireRecipient("tenant-b", "session.c1", 7_000);
|
|
576
|
+
assert.deepEqual(await lp.listRetiredRecipients(S, "session."), [{ handle: "session.a1", retiredAt: 5_000, label: "Plan" }], "清单按 (scope, 前缀) 列出 handle / retiredAt / label");
|
|
577
|
+
assert.deepEqual(await lp.listRetiredRecipients(S, "agent."), [{ handle: "agent.b1", retiredAt: 6_000 }], "清单按 (scope, 前缀):no label ⇒ no label member");
|
|
578
|
+
assert.deepEqual(await lp.listRetiredRecipients("tenant-b", "agent."), [], "清单按 (scope, 前缀):a prefix lists only its own handles, in its own scope");
|
|
579
|
+
const again = make();
|
|
580
|
+
const ap = mailboxRecipientLifecycleOf(again);
|
|
581
|
+
await ap.retireRecipient(S, "session.a1", 5_000, "old");
|
|
582
|
+
await ap.retireRecipient(S, "session.a1", 9_000, "new");
|
|
583
|
+
assert.deepEqual(await ap.listRetiredRecipients(S, "session."), [{ handle: "session.a1", retiredAt: 9_000, label: "new" }], "重复 retire 更新时刻与名字,清单里仍是一行");
|
|
584
|
+
const dropped = make();
|
|
585
|
+
const dp = mailboxRecipientLifecycleOf(dropped);
|
|
586
|
+
await dropped.append(S, "session.a1", msg("before"));
|
|
587
|
+
await dp.retireRecipient(S, "session.a1", 5_000);
|
|
588
|
+
await assert.rejects(dropped.append(S, "session.a1", msg("refused")), (e) => codeOf(e) === MAILBOX_TOMBSTONED_RECIPIENT_CODE);
|
|
589
|
+
await dropped.drop(S, "session.a1");
|
|
590
|
+
assert.deepEqual(await dp.listRetiredRecipients(S, "session."), [], "墓碑随箱亡:drop removes the tombstone with the box");
|
|
591
|
+
assert.equal(await dropped.append(S, "session.a1", msg("registered again")), 1, "墓碑随箱亡:an id registered again is a new recipient (seq 1)");
|
|
592
|
+
hooks.onOptionalMember?.({ member: "recipientLifecycle", status: "verified" });
|
|
593
|
+
});
|
|
447
594
|
run("预删除态的收件人:append 响亮拒且带码(既不静默收下级联即将删掉的消息,也不裸抛)", async (make) => {
|
|
448
595
|
const s = make();
|
|
449
|
-
await
|
|
596
|
+
await tombstone(s, S, "a1");
|
|
450
597
|
let thrown;
|
|
451
598
|
try {
|
|
452
599
|
await s.append(S, "a1", msg("m1"));
|
|
@@ -467,19 +614,19 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
|
|
|
467
614
|
});
|
|
468
615
|
run("拒的粒度是收件人,不是开关:同 scope 下另一个活收件人照常收信", async (make) => {
|
|
469
616
|
const s = make();
|
|
470
|
-
await
|
|
617
|
+
await tombstone(s, S, "a1");
|
|
471
618
|
assert.equal(await s.append(S, "a2", msg("still-live")), 1, "活收件人不受邻居的删除级联牵连");
|
|
472
619
|
assert.equal(await s.peekCount(S, "a2"), 1);
|
|
473
620
|
});
|
|
474
621
|
run("收件人身份是 (scope, handle) 整体:A 租户的删除级联不得拒掉 B 租户的同名收件人", async (make) => {
|
|
475
622
|
const s = make();
|
|
476
|
-
await
|
|
623
|
+
await tombstone(s, "tenant-a", "a1");
|
|
477
624
|
assert.equal(await s.append("tenant-b", "a1", msg("other-tenant")), 1, "同名 handle 在另一个租户下是另一个收件人");
|
|
478
625
|
assert.equal(await s.peekCount("tenant-b", "a1"), 1);
|
|
479
626
|
});
|
|
480
627
|
run("两件套还得是单射的:把 (scope, handle) 拼成一个字符串记态,不得让两个不同收件人撞成一个", async (make) => {
|
|
481
628
|
const s = make();
|
|
482
|
-
await
|
|
629
|
+
await tombstone(s, "tenant a", "b");
|
|
483
630
|
assert.equal(await s.append("tenant", "a b", msg("distinct-recipient")), 1, "拼键歧义不得把另一个收件人一起拒掉");
|
|
484
631
|
assert.equal(await s.peekCount("tenant", "a b"), 1);
|
|
485
632
|
});
|
|
@@ -488,7 +635,7 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
|
|
|
488
635
|
await s.append(S, "a1", msg("in-flight"));
|
|
489
636
|
const held = await s.claimLease(S, "a1", "consumer-A", 60_000, 10_000);
|
|
490
637
|
assert.equal(held?.messages.length, 1);
|
|
491
|
-
await
|
|
638
|
+
await tombstone(s, S, "a1");
|
|
492
639
|
await assert.rejects(s.append(S, "a1", msg("after-tombstone", 2_000)), "预删除态下的 append 必须拒");
|
|
493
640
|
assert.equal(await s.claimLease(S, "a1", "rival", 60_000, 11_000), null, "A 的活租约必须仍然 fence 住别人");
|
|
494
641
|
await s.ack(S, "a1", "consumer-A", held.maxSeq);
|
|
@@ -497,7 +644,7 @@ export async function mailboxTombstonedRecipientContract(mk, hooks) {
|
|
|
497
644
|
run("拒的是入口,不是清仓:被拒的 append 零副作用,已入箱的消息按原 seq/内容原封不动", async (make) => {
|
|
498
645
|
const s = make();
|
|
499
646
|
const seq = await s.append(S, "a1", msg("parked-before"));
|
|
500
|
-
await
|
|
647
|
+
await tombstone(s, S, "a1");
|
|
501
648
|
let thrown;
|
|
502
649
|
let refused = false;
|
|
503
650
|
try {
|
|
@@ -22,8 +22,8 @@ function compactionEntry(id, parentId, firstKeptEntryId) {
|
|
|
22
22
|
return { id, parentId, type: "compaction", timestamp: AT, summary: "summary of the turns above the floor", firstKeptEntryId, tokensBefore: 1000 };
|
|
23
23
|
}
|
|
24
24
|
const freshId = () => uuidv7();
|
|
25
|
-
function placementFor(scope, handle = `a${uuidv7().slice(-12)}
|
|
26
|
-
return { kind: "subagent", scope: scope ?? `kit-${uuidv7().slice(-12)}`, ...(handle !== null ? { handle } : {}) };
|
|
25
|
+
function placementFor(scope, handle = `a${uuidv7().slice(-12)}`, owner = null) {
|
|
26
|
+
return { kind: "subagent", scope: scope ?? `kit-${uuidv7().slice(-12)}`, ...(handle !== null ? { handle } : {}), owner };
|
|
27
27
|
}
|
|
28
28
|
const tick = () => new Promise((resolve) => setTimeout(resolve, 20));
|
|
29
29
|
async function append(session, entry, opts) {
|
|
@@ -73,7 +73,7 @@ async function refusedAsLoop(storage, leafId, loopMembers, what) {
|
|
|
73
73
|
const outcome = await Promise.race([settled, expiry]).finally(() => clearTimeout(timer));
|
|
74
74
|
if ("path" in outcome)
|
|
75
75
|
assert.fail(`${what}: a parent chain that loops back on itself answered a path of ${outcome.path.length} entries instead of refusing`);
|
|
76
|
-
assert.equal(readMember(outcome.err, "code"), "
|
|
76
|
+
assert.equal(readMember(outcome.err, "code"), "corrupt_session", `${what}: the refusal must carry code corrupt_session`);
|
|
77
77
|
const sentence = String(readMember(outcome.err, "message"));
|
|
78
78
|
assert.ok(loopMembers.some((id) => sentence.includes(id)), `${what}: the refusal must name an entry of the loop (${loopMembers.join(" / ")}), got "${sentence}"`);
|
|
79
79
|
}
|
|
@@ -290,7 +290,7 @@ async function runSessionStoreContract(make, hooks) {
|
|
|
290
290
|
assert.equal(await storage.getLeafId(), "e1", "a refused setLeafId leaves the leaf where it was");
|
|
291
291
|
await rejectsWithCode(() => storage.getPathToRoot("kit-never-written"), "not_found", "getPathToRoot from an id the session never held");
|
|
292
292
|
});
|
|
293
|
-
run("[tree] a path stops at a root or at the storage's declared floor; a parent missing above the floor reads
|
|
293
|
+
run("[tree] a path stops at a root or at the storage's declared floor; a parent missing above the floor reads corrupt_session, never a truncated path", async (store) => {
|
|
294
294
|
const { session } = await store.acquire(freshId());
|
|
295
295
|
await append(session, userEntry("e1", null));
|
|
296
296
|
let accepted = true;
|
|
@@ -301,12 +301,12 @@ async function runSessionStoreContract(make, hooks) {
|
|
|
301
301
|
accepted = false;
|
|
302
302
|
}
|
|
303
303
|
if (accepted) {
|
|
304
|
-
await rejectsWithCode(() => session.getStorage().getPathToRoot("orphan"), "
|
|
304
|
+
await rejectsWithCode(() => session.getStorage().getPathToRoot("orphan"), "corrupt_session", "the path through an entry whose parent was never written");
|
|
305
305
|
}
|
|
306
306
|
const head = (await session.getStorage().getPathToRoot("e1"))[0];
|
|
307
307
|
assert.ok(head.parentId === null || head.id === session.getStorage().getFloorId?.(), "a path's head is a root or the declared floor");
|
|
308
308
|
});
|
|
309
|
-
run("[tree] a parent chain that loops back on itself — an entry that is its own parent, two entries that parent each other, a leaf that walks into such a pair — reads
|
|
309
|
+
run("[tree] a parent chain that loops back on itself — an entry that is its own parent, two entries that parent each other, a leaf that walks into such a pair — reads corrupt_session naming an entry of the loop, and the walk ends (also for a ring of three)", async (store) => {
|
|
310
310
|
const { session } = await store.acquire(freshId());
|
|
311
311
|
await append(session, userEntry("e1", null));
|
|
312
312
|
const accepted = async (...entries) => {
|
|
@@ -743,6 +743,20 @@ async function runSessionStoreContract(make, hooks) {
|
|
|
743
743
|
await append(acquired.session, userEntry("e1", null));
|
|
744
744
|
assert.deepEqual(await entryIds((await readBack(store, id))), ["e1"]);
|
|
745
745
|
});
|
|
746
|
+
faceRun("[placements] the placing write records exactly placement.owner as the row's owner, and headOf answers the placed row with the occupant the acquired session carries — before and after a restart", ["placements"], async (store, open) => {
|
|
747
|
+
assert.ok(hasHead(store), "a store that declares placements answers headOf (obligation 7): a revived child reads its tree's owner off its own row through it");
|
|
748
|
+
const named = freshId();
|
|
749
|
+
const anonymous = freshId();
|
|
750
|
+
const owner = `kit-tree-${freshId()}`;
|
|
751
|
+
const acquired = await store.acquire(named, { placement: placementFor(undefined, undefined, owner) });
|
|
752
|
+
await store.acquire(anonymous, { placement: placementFor() });
|
|
753
|
+
const token = await tokenOf(store, named, "a placed row this store created");
|
|
754
|
+
assert.equal((await acquired.session.getMetadata()).incarnation, token, "the placed session handed out is the occupant the head names");
|
|
755
|
+
assert.equal(await ownerOf(store, named, "a placed row"), owner, "the placing write recorded the placement's owner");
|
|
756
|
+
assert.equal(await ownerOf(store, anonymous, "a placed row of an anonymous tree"), null, "a null placement owner is an anonymous row");
|
|
757
|
+
const second = await open(hooks.reopen(store));
|
|
758
|
+
assert.deepEqual(await headOf(second, named), await headOf(store, named), "the owner lives in the row, not in an instance");
|
|
759
|
+
});
|
|
746
760
|
faceRun("[placements] listPlaced returns each placed session with its full (scope, handle) tuple or the honest tupleIncomplete, filters by scope and age, and never lists an ordinary session", ["listPlaced"], async (store) => {
|
|
747
761
|
const scope = `kit-${uuidv7().slice(-12)}`;
|
|
748
762
|
const full = placementFor(scope);
|
|
@@ -843,13 +857,13 @@ async function runSessionStoreContract(make, hooks) {
|
|
|
843
857
|
if (declaresPlacements(store)) {
|
|
844
858
|
for (const owner of [`kit-claimant-${freshId()}`, null]) {
|
|
845
859
|
const placed = freshId();
|
|
846
|
-
await store.acquire(placed, { placement: placementFor() });
|
|
860
|
+
await store.acquire(placed, { placement: placementFor(undefined, undefined, `kit-tree-${freshId()}`) });
|
|
847
861
|
const recorded = await ownerOf(store, placed, "a placed row");
|
|
848
862
|
await store.register(placed, owner);
|
|
849
863
|
assert.equal(await ownerOf(store, placed, "a placed row after a register"), recorded, `a register carrying ${owner === null ? "null" : "an owner"} left the placed row's owner as its placing write recorded it`);
|
|
850
864
|
}
|
|
851
865
|
const sequenced = freshId();
|
|
852
|
-
await store.acquire(sequenced, { placement: placementFor() });
|
|
866
|
+
await store.acquire(sequenced, { placement: placementFor(undefined, undefined, `kit-tree-${freshId()}`) });
|
|
853
867
|
const recordedSeq = await ownerOf(store, sequenced, "a placed row (sequence)");
|
|
854
868
|
await store.register(sequenced, null);
|
|
855
869
|
await store.register(sequenced, `kit-claimant-${freshId()}`);
|
|
@@ -20,6 +20,6 @@ import { type ContractAssertionRunner } from "./contract-harness.js";
|
|
|
20
20
|
* exactly the divergence the two legs above exist to prevent.
|
|
21
21
|
*/
|
|
22
22
|
export declare function toolResultStoreContract(make: () => ToolResultStore, runAssertion?: ContractAssertionRunner, onOptionalMember?: (report: {
|
|
23
|
-
member: "deleteBySession" | "listBySession";
|
|
23
|
+
member: "deleteBySession" | "listBySession" | "reap";
|
|
24
24
|
status: "verified" | "absent";
|
|
25
25
|
}) => void): Promise<void>;
|
|
@@ -117,5 +117,35 @@ export async function toolResultStoreContract(make, runAssertion, onOptionalMemb
|
|
|
117
117
|
}
|
|
118
118
|
onOptionalMember?.({ member: "listBySession", status: "verified" });
|
|
119
119
|
});
|
|
120
|
+
run("reap (optional): no bound removes nothing, a bad bound is refused, age alone decides; absence is REPORTED, not silently green", async () => {
|
|
121
|
+
const probe = make();
|
|
122
|
+
if (probe.reap === undefined) {
|
|
123
|
+
onOptionalMember?.({ member: "reap", status: "absent" });
|
|
124
|
+
return;
|
|
125
|
+
}
|
|
126
|
+
assert.equal(typeof probe.reap, "function", `reap is present but not callable (got ${typeof probe.reap}) — a garbage member is a DEFECT, not an optional-member absence`);
|
|
127
|
+
const store = make();
|
|
128
|
+
const reap = async (now, opts) => Promise.resolve(Reflect.apply(store.reap, store, [now, opts]));
|
|
129
|
+
await store.put("tr_age~owned", "OWNED-bytes", { sessionId: "sess-A" });
|
|
130
|
+
await store.put("tr_age~unowned", "UNOWNED-bytes");
|
|
131
|
+
const later = Date.now() + 3_600_000;
|
|
132
|
+
assert.equal(await reap(later), 0, "no opts ⇒ nothing is aged out");
|
|
133
|
+
assert.equal(await reap(later, {}), 0, "no maxAgeMs ⇒ nothing is aged out");
|
|
134
|
+
for (const bad of [Number.NaN, -1, Number.POSITIVE_INFINITY, "60000"]) {
|
|
135
|
+
await assert.rejects(reap(later, { maxAgeMs: bad }), (e) => e.code === "config.retention_policy_invalid", `maxAgeMs ${String(bad)} is refused, coded`);
|
|
136
|
+
}
|
|
137
|
+
await assert.rejects(reap(Number.NaN, { maxAgeMs: 1 }), (e) => e.code === "config.retention_policy_invalid", "a now that is not a number is refused, coded");
|
|
138
|
+
assert.equal((await store.get("tr_age~owned")).content, "OWNED-bytes", "a refused sweep removed nothing");
|
|
139
|
+
assert.equal(await reap(later, { maxAgeMs: 2 * 3_600_000 }), 0, "an entry younger than the bound is kept");
|
|
140
|
+
assert.equal((await store.get("tr_age~unowned")).content, "UNOWNED-bytes");
|
|
141
|
+
assert.equal(await reap(later, { maxAgeMs: 60_000 }), 2, "every entry older than the bound is removed, owned or not");
|
|
142
|
+
assert.equal(await store.get("tr_age~owned"), undefined);
|
|
143
|
+
assert.equal(await store.get("tr_age~unowned"), undefined);
|
|
144
|
+
assert.equal(await store.ownerOf("tr_age~owned"), undefined, "the owner record goes with the content");
|
|
145
|
+
assert.equal(await reap(later, { maxAgeMs: 60_000 }), 0, "idempotent");
|
|
146
|
+
await store.put("tr_age~owned", "NEW-bytes", { sessionId: "sess-B" });
|
|
147
|
+
assert.deepEqual(await store.ownerOf("tr_age~owned"), { sessionId: "sess-B" }, "a reaped ref is free for a new owner");
|
|
148
|
+
onOptionalMember?.({ member: "reap", status: "verified" });
|
|
149
|
+
});
|
|
120
150
|
await settle();
|
|
121
151
|
}
|
|
@@ -31,7 +31,8 @@ export interface TaskEventIdentity {
|
|
|
31
31
|
/**
|
|
32
32
|
* design/122 S2 (the `WorkflowRun.sourceTaskId` family, NOT a second `taskId` — that
|
|
33
33
|
* field already exists on `task_progress` and a duplicate would bite consumers) — the ORIGINATING task's
|
|
34
|
-
* canonical id (
|
|
34
|
+
* canonical id (the leg's single task id mint: a background sub-agent's registry task id, else the
|
|
35
|
+
* declared task id, else the session id), stamped ONLY on the content events of a task running AS A
|
|
35
36
|
* SUB-AGENT (same condition as {@link parentToolCallId}). A consumer of the C1 forward channel
|
|
36
37
|
* (`forwardSubagentEvents`) can key a child's content events by the child task directly, without an
|
|
37
38
|
* alias table. A TOP-LEVEL task's own events carry NO `sourceTaskId` (absent = the consumer's current
|
|
@@ -457,8 +458,8 @@ export type TaskEvent = ({
|
|
|
457
458
|
* text plus whatever else it carries) — with any block that is neither text nor an admitted image/document, at its
|
|
458
459
|
* serialization — are one character stream under the text cap, cut IN
|
|
459
460
|
* PLACE where the cap runs out (that block ends with the marker, the stream's later blocks leave); MEDIA blocks are not
|
|
460
|
-
* measured against the text cap and ride AS-IS while the leg's media budget lasts (`RunnerDeps.
|
|
461
|
-
* default `
|
|
461
|
+
* measured against the text cap and ride AS-IS while the leg's media budget lasts (`RunnerDeps.mediaBudgetBase64Chars`,
|
|
462
|
+
* default `IMAGE_ADMISSION.request.budgetBase64Chars`: base64 characters, spent as wire bytes after the text's
|
|
462
463
|
* serialized size), past which a block becomes `{ type, mimeType?, bytes, truncated: true }` in its slot (never a
|
|
463
464
|
* string; a media type over 255 characters is not echoed), and when not even a descriptor fits, it and every later
|
|
464
465
|
* media block fold into ONE `{ type: "omitted", blocks, bytes, truncated: true }` in its slot, so the media in an event
|
|
@@ -478,7 +479,7 @@ export type TaskEvent = ({
|
|
|
478
479
|
/**
|
|
479
480
|
* design/116 (b) — the tool's CC-shaped `toolUseResult` facts (`details.type` ∈ the known card
|
|
480
481
|
* set: edit/create/update/bash/text/grep/glob/notebook-edit/notebook/file_unchanged/mcp/image/
|
|
481
|
-
* document/worktree/todo/task/task-list/task-
|
|
482
|
+
* document/worktree/todo/task/task-list/task-stop/agent/fork/workflow-run/web-fetch/
|
|
482
483
|
* web-search/cron-create/cron-delete/cron-list/tool-search/repo-map/monitor-start/
|
|
483
484
|
* enter-plan-mode/exit-plan-mode/report-findings/schedule-wakeup/send-message/agent-transcript/
|
|
484
485
|
* a2a/path_not_in_root/readonly_out_of_root/read_unestablished/advisor), surfaced on the live wire so a CC-faithful shell
|
|
@@ -850,6 +851,10 @@ export type TaskEvent = ({
|
|
|
850
851
|
* (summaryMs ?? 0) + persistMs === {@link durationMs} (exact tiling; `summaryMs` absent on a
|
|
851
852
|
* provider-reuse pass — no summary LLM call happened). Absent on legacy emitters. */
|
|
852
853
|
phaseDurations?: import("./auto-compaction.js").CompactionPhaseDurations;
|
|
854
|
+
/** Who asked for this pass when an extension did: present when the pass served a manual request an extension made
|
|
855
|
+
* (`$.session.compact`, by its registration name — the last such caller when several requests coalesced onto the
|
|
856
|
+
* pass); absent on every other pass, a `compact()` request of the host's included. A display and audit fact only. */
|
|
857
|
+
requestedBy?: ExtensionRequester;
|
|
853
858
|
} & TaskEventIdentity) | ({
|
|
854
859
|
/**
|
|
855
860
|
* RB-398-b④: a compaction pass concluded WITHOUT landing — the non-landing outcomes
|
|
@@ -889,6 +894,9 @@ export type TaskEvent = ({
|
|
|
889
894
|
* started — `blocked`, `suppressed`, `disabled`, `noop`, a `mooted` request no boundary served — and on the
|
|
890
895
|
* rapid-refill `disabled` frame, which reports a state the landing before it caused, not that pass's end. */
|
|
891
896
|
pass?: string;
|
|
897
|
+
/** Who asked for this pass when an extension did — the `compacted` frame's member of the same name, on the same
|
|
898
|
+
* condition: present when the outcome is a manual request's an extension made (`$.session.compact`). */
|
|
899
|
+
requestedBy?: ExtensionRequester;
|
|
892
900
|
} & TaskEventIdentity) | ({
|
|
893
901
|
/**
|
|
894
902
|
* A compaction pass is under way: the engine has committed to it and is about to produce its summary.
|
|
@@ -920,7 +928,8 @@ export type TaskEvent = ({
|
|
|
920
928
|
* or the design/130 P2 graceful-finalize instruction) into the model's next turn. Previously these
|
|
921
929
|
* went through `harness.steer()` with no stream echo — a consumer literally could not tell whether
|
|
922
930
|
* the finalize fired (the refute-130 attribution blind spot). Echo only; the model-facing message
|
|
923
|
-
* is unchanged. `preview` is the injected text clipped to a display bound
|
|
931
|
+
* is unchanged. `preview` is the injected text clipped to a display bound (220 characters; the post-compaction
|
|
932
|
+
* `background_tasks` table, a list its renderer already bounds, is echoed whole up to the per-boundary attachment cap).
|
|
924
933
|
*
|
|
925
934
|
* design/133 (LOW-11/F11): the turn-boundary attachment producers ride the same echo — sources
|
|
926
935
|
* `todo_reminder` / `task_reminder` / `changed_files` and the G1/续批 members
|
|
@@ -1045,6 +1054,11 @@ export type TaskEvent = ({
|
|
|
1045
1054
|
* render it as the scheduler's, not as someone typing): the objective's `TaskSpec.runOrigin`, a parked or waking
|
|
1046
1055
|
* message's `runOrigin`. Absent ⇒ the host said nothing (never "a person sent it"). Attribution only. */
|
|
1047
1056
|
runOrigin?: import("./run-origin.js").RunOrigin;
|
|
1057
|
+
/** Present when the leg's prompt screen (`prompt.submit`) rewrote THIS input's text before it was delivered: the extensions
|
|
1058
|
+
* that changed it, in the order they did. The model saw the rewritten text (the caller's own words are not delivered);
|
|
1059
|
+
* rides the account the screening entrance mints — the `"applied"` frame of an objective, a parked steer or a wake's
|
|
1060
|
+
* message, the `"queued"` frame of a live steer. Absent ⇒ the text went as it came. */
|
|
1061
|
+
rewrittenBy?: readonly string[];
|
|
1048
1062
|
} & TaskEventIdentity) | ({
|
|
1049
1063
|
/**
|
|
1050
1064
|
* design/99 §E3/§E10 — a live BRAIN-LAYER status the brain would otherwise absorb
|
|
@@ -1104,7 +1118,8 @@ export type TaskEvent = ({
|
|
|
1104
1118
|
* `spawn_depth` (the nesting is the `parentTaskId` chain), and the shell/monitor-only members.
|
|
1105
1119
|
*/
|
|
1106
1120
|
type: "task_started";
|
|
1107
|
-
/** The child
|
|
1121
|
+
/** The child leg's task id (a background sub-agent's registry task id, else its session id) — the
|
|
1122
|
+
* key its `task_progress` frames carry. */
|
|
1108
1123
|
taskId: string;
|
|
1109
1124
|
/** The child run's session id — the handle its transcript is read by. */
|
|
1110
1125
|
sessionId: string;
|
|
@@ -1145,9 +1160,9 @@ export type TaskEvent = ({
|
|
|
1145
1160
|
* Live/ephemeral — NOT persisted (a resumable trace re-derives usage from the result), like `status`.
|
|
1146
1161
|
* Maps to CC `SDKTaskProgress` (camelCase here → snake_case `task_id`/`total_tokens`/`tool_uses`/`duration_ms`
|
|
1147
1162
|
* at the SDK/service projection, the same convention as `toolCallId`→`tool_use_id`).
|
|
1148
|
-
* `taskId` is the child
|
|
1149
|
-
*
|
|
1150
|
-
*
|
|
1163
|
+
* `taskId` is the child leg's task id, minted once by the child's prepare: a background
|
|
1164
|
+
* sub-agent's is its registry task id (the `a…` handle TaskStop / TaskOutput / SendMessage take),
|
|
1165
|
+
* a foreground child's is its session id. One child, one id — `docs/INTEGRATION-CORE.md` §1.6a.
|
|
1151
1166
|
*/
|
|
1152
1167
|
type: "task_progress";
|
|
1153
1168
|
taskId: string;
|
|
@@ -23,6 +23,11 @@ import type { ModelRef } from "./model-seat.js";
|
|
|
23
23
|
*
|
|
24
24
|
* **Priority.** Several axes may be armed at once; the first to trip stops the run. When more than one
|
|
25
25
|
* trips at the same turn boundary the attribution order is tokens > cost > turns > walltime.
|
|
26
|
+
*
|
|
27
|
+
* **One task, several legs.** The verification gate and the repair loop run one task as several `runTask` legs; they read
|
|
28
|
+
* the task's whole-task ceilings (these windows on a task that cannot suspend, the `resourceSuspend` totals on one that can)
|
|
29
|
+
* as the TASK's, and dispatch each later leg on what the legs before it left (`src/agents/composition-allowance.ts`).
|
|
30
|
+
* `runGoal` and the cascade keep a per-iteration / per-rung allowance.
|
|
26
31
|
*/
|
|
27
32
|
export interface TaskLimits {
|
|
28
33
|
/**
|