@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
|
@@ -10,9 +10,9 @@ import type { NestedUsage } from "./tool-spec.js";
|
|
|
10
10
|
/**
|
|
11
11
|
* `"suspended"` (design/45) is a **non-terminal** outcome: the task hit a durable tool-policy gate
|
|
12
12
|
* (`ask` with a `CheckpointStore` wired) and persisted a checkpoint instead of finishing — resume it
|
|
13
|
-
* with `runner.resume(checkpointToken, outcome)`.
|
|
14
|
-
* `
|
|
15
|
-
*
|
|
13
|
+
* with `runner.resume(checkpointToken, outcome)`. A nested orchestrator's boundary turns the pause into a
|
|
14
|
+
* `failed` terminal that carries it (`mapNestedSuspend` in `src/agents/suspend-guard.ts` states which
|
|
15
|
+
* orchestrators do, and the entry that continues the pause).
|
|
16
16
|
*
|
|
17
17
|
* `"needs_review"` (design/76 §2.5, dry-run / shadow; design/80 D-B, plan-gate) is also a **non-terminal,
|
|
18
18
|
* resumable** outcome, but a DISTINCT one: it is the REVIEW-PAUSE terminal a human/judge must clear. Two
|
|
@@ -22,8 +22,8 @@ import type { NestedUsage } from "./tool-spec.js";
|
|
|
22
22
|
* profile's plan-gate produced a proposed PLAN a human must approve/edit/reject BEFORE any step runs, resumed
|
|
23
23
|
* with a `plan_review` outcome. Both are DISJOINT from `"suspended"`: that is a PRE-ACTION approval of a TOOL
|
|
24
24
|
* CALL (resumed with `policy_ask`); these are human REVIEWS (the distinct gate.kind picks the resume outcome).
|
|
25
|
-
*
|
|
26
|
-
*
|
|
25
|
+
* A `needs_review` pause meets the same nested boundary as a `suspended` one (`mapNestedSuspend`: code
|
|
26
|
+
* `unexpected.needs_review`).
|
|
27
27
|
*/
|
|
28
28
|
/**
|
|
29
29
|
* Terminal vs waiting. Three words are TERMINAL — the leg is over and nobody is expected to act: `completed`,
|
|
@@ -164,8 +164,9 @@ export interface TaskResult {
|
|
|
164
164
|
/**
|
|
165
165
|
* The ENGINE-minted identity of THIS run (uuidv7), minted once at the top of prepare and
|
|
166
166
|
* never rewritten. The third id of the trio, and the only one the engine owns:
|
|
167
|
-
* - {@link taskId} — the
|
|
168
|
-
*
|
|
167
|
+
* - {@link taskId} — the leg's task identity: a background sub-agent's registry task id, else the
|
|
168
|
+
* HOST's task identity, else (when the host named none) the session id — so it answers the SAME
|
|
169
|
+
* value for every run of one session (or of one background row);
|
|
169
170
|
* - {@link sessionId} — the conversation, shared by every run that continues it;
|
|
170
171
|
* - `runId` — this call. Two runs of one session ALWAYS differ here; a host-supplied `taskId` does
|
|
171
172
|
* not change it (the host's handle and the engine's run are different questions).
|
|
@@ -185,8 +186,22 @@ export interface TaskResult {
|
|
|
185
186
|
* never the `"unknown"` sentinel `taskId`/`sessionId` fall back to on that path.
|
|
186
187
|
*/
|
|
187
188
|
runId?: string;
|
|
188
|
-
/**
|
|
189
|
+
/**
|
|
190
|
+
* Use this to continue the same conversation on the next call. On a parked result — a `paused` terminal, or a `failed` one
|
|
191
|
+
* carrying `nestedPause` — it is the session of the leg that parked, which is the parked row's own `Checkpoint.sessionId`.
|
|
192
|
+
* A composition entry's legs (a cascade's rungs, a verification gate's verifier) do not run in the caller's session, so a
|
|
193
|
+
* host links such a row to its run by the row's `CheckpointState.compositionLeg.hostSessionId`, never by assuming the row
|
|
194
|
+
* sits in the session it submitted.
|
|
195
|
+
*/
|
|
189
196
|
sessionId: string;
|
|
197
|
+
/**
|
|
198
|
+
* The leg's placement fixed point: the one value its prepare resolved for the tree's placement root (the caller's explicit
|
|
199
|
+
* `RunInternals.placementRoot`, else the delegation root, else the leg's own session — on a resume, the parked row's recorded
|
|
200
|
+
* root), the same value its env factory was minted with and its parks record. A composition entry places every later leg at
|
|
201
|
+
* its first leg's `placementRoot`. **In-presence condition**: present on every terminal of a run whose prepare resolved it;
|
|
202
|
+
* absent on a result a run did not assemble (a host's own stub, a composition's synthetic terminal).
|
|
203
|
+
*/
|
|
204
|
+
placementRoot?: string;
|
|
190
205
|
/**
|
|
191
206
|
* WHY the run ended — the ONE tagged cause ({@link TerminalCause}), and the ONLY terminal record on this
|
|
192
207
|
* result: there is no `status` word and no `errorCode`/`errorMessage`/`blockedReason`/`checkpointToken`/
|
|
@@ -495,10 +510,12 @@ export interface TaskResult {
|
|
|
495
510
|
editedFiles?: import("../agents/subagent-steps.js").SubagentEditedFile[];
|
|
496
511
|
/**
|
|
497
512
|
* Present (`true`) exactly when the run's FINAL turn was halted by a person's BARE rejection of a
|
|
498
|
-
* tool call — the parent-thread control-flow boundary: the rejected
|
|
499
|
-
* that had not started were settled un-executed (each an error result
|
|
500
|
-
* and the engine deliberately did NOT re-invoke the model, so the run ends
|
|
501
|
-
* direction.
|
|
513
|
+
* tool call, or of the plan a plan pause held — the parent-thread control-flow boundary: the rejected
|
|
514
|
+
* call's same-message siblings that had not started were settled un-executed (each an error result
|
|
515
|
+
* coded `gate.batch_halted`), and the engine deliberately did NOT re-invoke the model, so the run ends
|
|
516
|
+
* awaiting the user's direction. A resumed leg that redeems such a rejection records the decision and
|
|
517
|
+
* makes no model request at all (its `result` is the transcript's last assistant message — the plan
|
|
518
|
+
* request, or the parked call's message; empty when the transcript has no answer yet). On this path `status` is still `"completed"` (nothing failed, nothing is suspended,
|
|
502
519
|
* the session is continuable as ever) — this field is what tells such an end apart from a natural
|
|
503
520
|
* finish: `result` text is whatever the model had produced BEFORE the rejection (often empty), and
|
|
504
521
|
* a consumer surface should read the state as "stopped by the user, awaiting their direction",
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The one reading of a caller's {@link TaskSpec}. A spec is the caller's own object: a literal, a class instance, a bag with
|
|
3
|
+
* accessors, a Proxy. The run takes it through here once, at its entrance, and every reader after that — the session lock, the
|
|
4
|
+
* config doors, prepare, the leg, the backstop terminal — reads the snapshot this returns, never the caller's object again.
|
|
5
|
+
*
|
|
6
|
+
* Each member is read once, by name, through an ordinary property lookup (an inherited, non-enumerable, accessor-backed or
|
|
7
|
+
* Proxy-answered member included — the presence law the retired-key door states, `retired-keys.ts`), and a defined value lands
|
|
8
|
+
* as an own enumerable data member of a new plain frozen object: the snapshot reads exactly like an object literal spec, so any
|
|
9
|
+
* later copy (a spread included) keeps every member, and a getter's value is the one value the whole run sees. Values are taken
|
|
10
|
+
* by reference (a member's own contents — the tool roster's entries, a policy, a signal — are their own readers' to snapshot).
|
|
11
|
+
*
|
|
12
|
+
* Three refusals, each by name and recorded on the read (thrown where the run's prepare refuses, so a failed read ends the run
|
|
13
|
+
* as any prepare refusal does): a member whose lookup throws (`config.spec_member_unreadable`); a retired key the lookup answers
|
|
14
|
+
* (`config.spec_retired_key`, the retired-key door judged over the values just read); an own key (enumerable or not, string or
|
|
15
|
+
* symbol) that is neither a member nor a retired name — the engine's one name judgment, on the spec as given; an inherited key is
|
|
16
|
+
* no own key, so it is neither read as a stray nor refused — (`config.spec_unknown_key` — a key the engine never reads is refused,
|
|
17
|
+
* not carried silently).
|
|
18
|
+
*
|
|
19
|
+
* The one re-read the engine keeps is the tool roster's identity check (`refuseLateRosterChanges`, against the caller's own
|
|
20
|
+
* object): it compares objects, it does not take a value.
|
|
21
|
+
*/
|
|
22
|
+
import type { TaskSpec } from "./task-spec.js";
|
|
23
|
+
/** Every {@link TaskSpec} member, by name — the type's own key set, fenced both ways (a member added to `TaskSpec` and not
|
|
24
|
+
* listed here, or a name here that `TaskSpec` does not declare, is a compile error; the value is a placeholder). */
|
|
25
|
+
export declare const TASK_SPEC_MEMBERS: readonly string[];
|
|
26
|
+
/** What one read of a caller's spec answered: the snapshot every reader reads, the caller's own object (for the roster's identity
|
|
27
|
+
* check only), and the refusal the read met (thrown at prepare's door), if any. */
|
|
28
|
+
export interface CallerSpecRead<S extends Partial<TaskSpec> = TaskSpec> {
|
|
29
|
+
readonly spec: S;
|
|
30
|
+
readonly caller: S;
|
|
31
|
+
readonly refusal: (Error & {
|
|
32
|
+
code: string;
|
|
33
|
+
}) | undefined;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Read the caller's spec once (see the module note). Never throws for a spec that is an object: a refusal is recorded on the read
|
|
37
|
+
* and thrown at prepare's door; a spec that is no object at all is a `TypeError`, as any member read of it would be.
|
|
38
|
+
*/
|
|
39
|
+
export declare function readCallerSpec<S extends Partial<TaskSpec>>(spec: S): CallerSpecRead<S>;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { RETIRED_TASK_SPEC_KEYS, retiredKeyOf, retiredKeyRefusal } from "./retired-keys.js";
|
|
2
|
+
import { thrownText } from "./thrown-value.js";
|
|
3
|
+
import { strayMembersOf } from "./own-property-receipt.js";
|
|
4
|
+
export const TASK_SPEC_MEMBERS = Object.keys({
|
|
5
|
+
taskId: 0, objective: 0, principal: 0, actor: 0, runOrigin: 0, interactionPosture: 0, approvalReach: 0, interactiveQuestionFallback: 0,
|
|
6
|
+
images: 0, userAttachments: 0, sessionId: 0, projectId: 0, requireExistingSession: 0, oneShot: 0, clientContext: 0, resumeAt: 0,
|
|
7
|
+
resumeAtMode: 0, model: 0, modelRole: 0, roles: 0, compactionModel: 0, advisorModel: 0, thinking: 0, systemPrompt: 0,
|
|
8
|
+
promptRole: 0, promptForm: 0, promptBinding: 0, appendSystemPrompt: 0, outputStyle: 0, memory: 0, suggestNextPrompts: 0, fileHistory: 0,
|
|
9
|
+
projectMemory: 0, restoreFiles: 0, acceptPartialRestore: 0, rewindFilesTo: 0, tools: 0, allowTools: 0, excludeTools: 0, excludeAllTools: 0,
|
|
10
|
+
deferTools: 0, toolMaterializeStrategy: 0, alwaysLoadTools: 0, restoreGatedTools: 0, deferSelfResolve: 0, promptLean: 0, agents: 0, toolPolicy: 0,
|
|
11
|
+
basePolicyForResumeEdit: 0, onAsk: 0, onQuestion: 0, lspManager: 0, lspDiagnostics: 0, mods: 0, peerPresence: 0, durableApproval: 0,
|
|
12
|
+
resourceSuspend: 0, preemptSignal: 0, resilience: 0, finalVerification: 0, maxSuspends: 0, checkpointStore: 0, handsReadOnly: 0, memoryPersistenceCapable: 0,
|
|
13
|
+
additionalDirectories: 0, additionalReadDirectories: 0, readDenyPatterns: 0, writeProtectedAdditions: 0, complianceAdditionalDenies: 0, readFace: 0, writeFace: 0, enablePlanMode: 0,
|
|
14
|
+
planFile: 0, interactiveTools: 0, enableFork: 0, shellGate: 0, permissionMode: 0, classifyAllShell: 0, mcp: 0, a2a: 0,
|
|
15
|
+
skills: 0, userInvokedSkills: 0, allowedTools: 0, skillListingBudgetFraction: 0, skillListingMaxDescChars: 0, backgroundScope: 0, envFacts: 0, limits: 0,
|
|
16
|
+
configOverrides: 0, forwardSubagentEvents: 0, retainSubagentSessions: 0, retainBackgroundProcesses: 0, streamingToolExecution: 0, outputSchema: 0, outputRetries: 0, tracer: 0,
|
|
17
|
+
toolResultThresholdChars: 0, compaction: 0, attachments: 0, enableBlockedReport: 0, selfOrchestration: 0, getApiKeyAndHeaders: 0, signal: 0,
|
|
18
|
+
});
|
|
19
|
+
const MEMBERS = new Set(TASK_SPEC_MEMBERS);
|
|
20
|
+
const RETIRED_NAMES = [...new Set(Object.keys(RETIRED_TASK_SPEC_KEYS).map((key) => key.split(".")[0].replace(/\[\]$/, "")))];
|
|
21
|
+
const READ_NAMES = [...TASK_SPEC_MEMBERS, ...RETIRED_NAMES.filter((name) => !MEMBERS.has(name))];
|
|
22
|
+
const READS = new WeakMap();
|
|
23
|
+
function specRefusal(code, message, detail) {
|
|
24
|
+
const e = new Error(message);
|
|
25
|
+
e.code = code;
|
|
26
|
+
e.detail = detail;
|
|
27
|
+
return e;
|
|
28
|
+
}
|
|
29
|
+
function unreadable(member, cause) {
|
|
30
|
+
const why = thrownText(cause);
|
|
31
|
+
return specRefusal("config.spec_member_unreadable", `TaskSpec.${member} could not be read (${why}) — a run reads each member of its spec once, at its start; a member whose read throws is refused rather than read as absent. Pass the value as a plain data member.`, { member });
|
|
32
|
+
}
|
|
33
|
+
function unknownKeys(keys) {
|
|
34
|
+
return specRefusal("config.spec_unknown_key", `TaskSpec carries ${keys.length === 1 ? "a key" : "keys"} this engine does not read: ${keys.map((k) => JSON.stringify(k)).join(", ")}. Refused rather than ignored: a key that is silently dropped reads to the caller as configured. Drop ${keys.length === 1 ? "it" : "them"}, or spell the member the engine declares.`, { keys: [...keys] });
|
|
35
|
+
}
|
|
36
|
+
export function readCallerSpec(spec) {
|
|
37
|
+
const known = READS.get(spec);
|
|
38
|
+
if (known !== undefined)
|
|
39
|
+
return known;
|
|
40
|
+
if (spec === null || (typeof spec !== "object" && typeof spec !== "function")) {
|
|
41
|
+
throw new TypeError(`TaskSpec must be an object (got ${spec === null ? "null" : typeof spec})`);
|
|
42
|
+
}
|
|
43
|
+
let own;
|
|
44
|
+
try {
|
|
45
|
+
own = { stray: strayMembersOf(spec, { subject: "TaskSpec", unit: "member", moment: "when the run reads its spec" }, READ_NAMES) };
|
|
46
|
+
}
|
|
47
|
+
catch (cause) {
|
|
48
|
+
own = { cause };
|
|
49
|
+
}
|
|
50
|
+
const values = Object.create(null);
|
|
51
|
+
let refusal;
|
|
52
|
+
for (const name of READ_NAMES) {
|
|
53
|
+
let value;
|
|
54
|
+
try {
|
|
55
|
+
value = Reflect.get(spec, name);
|
|
56
|
+
}
|
|
57
|
+
catch (cause) {
|
|
58
|
+
refusal ??= unreadable(name, cause);
|
|
59
|
+
continue;
|
|
60
|
+
}
|
|
61
|
+
if (value !== undefined)
|
|
62
|
+
values[name] = value;
|
|
63
|
+
}
|
|
64
|
+
for (const [key, replacement] of refusal === undefined ? Object.entries(RETIRED_TASK_SPEC_KEYS) : []) {
|
|
65
|
+
let hit;
|
|
66
|
+
try {
|
|
67
|
+
hit = retiredKeyOf(values, { [key]: replacement });
|
|
68
|
+
}
|
|
69
|
+
catch (cause) {
|
|
70
|
+
refusal = unreadable(key, cause);
|
|
71
|
+
break;
|
|
72
|
+
}
|
|
73
|
+
if (hit !== undefined) {
|
|
74
|
+
refusal = retiredKeyRefusal(hit, "TaskSpec");
|
|
75
|
+
break;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
if (refusal === undefined) {
|
|
79
|
+
if ("cause" in own)
|
|
80
|
+
refusal = unreadable("[own keys]", own.cause);
|
|
81
|
+
else if (own.stray !== undefined)
|
|
82
|
+
refusal = unknownKeys(own.stray.names.map((name) => String(name)));
|
|
83
|
+
}
|
|
84
|
+
const members = {};
|
|
85
|
+
for (const name of TASK_SPEC_MEMBERS)
|
|
86
|
+
if (name in values)
|
|
87
|
+
members[name] = values[name];
|
|
88
|
+
const snapshot = Object.freeze(members);
|
|
89
|
+
const read = Object.freeze({ spec: snapshot, caller: spec, refusal });
|
|
90
|
+
READS.set(snapshot, read);
|
|
91
|
+
return read;
|
|
92
|
+
}
|
package/dist/core/task-spec.d.ts
CHANGED
|
@@ -219,14 +219,11 @@ export interface TaskSpec {
|
|
|
219
219
|
* is a property of the submission, not of the channel it arrived on — a persistent connection can still
|
|
220
220
|
* mix interactive and one-shot submissions, which a connection-level flag could not express.
|
|
221
221
|
*
|
|
222
|
-
*
|
|
223
|
-
*
|
|
224
|
-
*
|
|
225
|
-
*
|
|
226
|
-
*
|
|
227
|
-
* results because the one-shot process had nothing left alive to receive the notification). Default
|
|
228
|
-
* `false`/absent = today's behavior (unchanged for interactive sessions). A deployment MAY thread it
|
|
229
|
-
* into other one-shot-sensitive decisions of its own.
|
|
222
|
+
* What the engine does with it: the run's ending waits for the loop-type background tasks it launched (agents,
|
|
223
|
+
* continued agents, workflows) — their terminal frames are owed to the run's lane and arrive as later turns,
|
|
224
|
+
* bounded by the walltime and a 600 s ceiling — and does not wait for process-type ones (a background command,
|
|
225
|
+
* a Monitor watch), whose receipts carry one sentence saying so. Default `false`/absent = interactive (unchanged).
|
|
226
|
+
* A deployment MAY thread it into other one-shot-sensitive decisions of its own.
|
|
230
227
|
*
|
|
231
228
|
* INHERITED down the delegation tree (only the `true` value, off the trusted
|
|
232
229
|
* {@link ToolExecuteContext.oneShot} seat): the property being described — "the process this
|
|
@@ -703,7 +700,7 @@ export interface TaskSpec {
|
|
|
703
700
|
* (same turn, no checkpoint) — this option is the durable FALLBACK for when no live approver can answer,
|
|
704
701
|
* not an "always park" mandate. It is the cross-process / long / headless version of the `onAsk` gate.
|
|
705
702
|
* **opt-in, default-off**: unset → the synchronous `onAsk`-only path (a headless ask then auto-denies).
|
|
706
|
-
*
|
|
703
|
+
* A nested orchestrator stops at such a pause and hands it back (`mapNestedSuspend` in `src/agents/suspend-guard.ts` states how it continues).
|
|
707
704
|
*
|
|
708
705
|
* **Precedence vs a live `onAsk`:** "live approver" means a FUNCTION-valued `spec.onAsk ?? deps.onAsk`.
|
|
709
706
|
* With one wired, BOTH plain and SAFETY asks (egress/irreversibility tightens) resolve through it
|
|
@@ -1130,8 +1127,11 @@ export interface TaskSpec {
|
|
|
1130
1127
|
* reads as nothing (`*`, `mcp__*` / `mcp__*__*`, a write-path or domain pattern) grants nothing and is announced at the start of the
|
|
1131
1128
|
* run (`permission.allowed_tool_not_granted`); a list holding `*` grants nothing at all. A value that is not a list of
|
|
1132
1129
|
* strings refuses the run before it starts (`config.invalid_permission_rules`, with its issues).
|
|
1130
|
+
*
|
|
1131
|
+
* A member may carry its rule SET's anchors, `{ rule, pathBases }` ({@link AllowListEntry} — the seat and the reading of a deny /
|
|
1132
|
+
* ask set's `pathBases`: a user layer's `/x` allow reaches `<config>/x`); one that is not exactly that refuses the run.
|
|
1133
1133
|
*/
|
|
1134
|
-
allowedTools?: readonly
|
|
1134
|
+
allowedTools?: readonly import("./allow-entry.js").AllowListEntry[];
|
|
1135
1135
|
/**
|
|
1136
1136
|
* Fraction of the model's context window the `<skills>` listing may spend. Absent ⇒ `0.01` (1%).
|
|
1137
1137
|
* Domain `(0, 1]`; anything else — including `0`, a string, `NaN` — REFUSES at the door with
|
|
@@ -1163,7 +1163,7 @@ export interface TaskSpec {
|
|
|
1163
1163
|
* design/129 — lifetime scope for BACKGROUND children (Agent/Fork `run_in_background`). Default `"task"`:
|
|
1164
1164
|
* the parent runTask's terminal reaps them (design/115 — no orphans burning tokens; turn-end killed
|
|
1165
1165
|
* frame). `"session"`: children OUTLIVE the turn (CC Backgrounded semantics) — registered under the
|
|
1166
|
-
* SESSION owner (
|
|
1166
|
+
* SESSION owner (a later turn's TaskStop and the host poll reach it), skipped by the parent-teardown reap, force-capped by
|
|
1167
1167
|
* a default child timeout when none is given, and finally reapable via
|
|
1168
1168
|
* `TaskRegistry.reapSessionBackground(sessionId, scope)` (call it from your session release/sweep).
|
|
1169
1169
|
* CALLER-trusted (systemPrompt tier): never a model-facing parameter, never on the governed workflow
|
|
@@ -1,15 +1,9 @@
|
|
|
1
1
|
import { Type } from "typebox";
|
|
2
|
-
export declare const TASK_OUTPUT_TOOL_NAME = "TaskOutput";
|
|
3
2
|
export declare const TASK_STOP_TOOL_NAME = "TaskStop";
|
|
4
|
-
export declare const TASK_OUTPUT_CONTRACT: {
|
|
5
|
-
readonly contractId: "core.task_output@1";
|
|
6
|
-
readonly implementationRevision: "1";
|
|
7
|
-
};
|
|
8
3
|
export declare const TASK_STOP_CONTRACT: {
|
|
9
4
|
readonly contractId: "core.task_stop@1";
|
|
10
5
|
readonly implementationRevision: "1";
|
|
11
6
|
};
|
|
12
|
-
export declare const TASK_OUTPUT_MISSING_ID_MESSAGE = "Error (TaskOutput): Missing required parameter: task_id";
|
|
13
7
|
export declare const TASK_STOP_MISSING_ID_MESSAGE = "Missing required parameter: task_id";
|
|
14
8
|
export declare const TASK_STOP_PARAMS: Type.TObject<{
|
|
15
9
|
task_id: Type.TOptional<Type.TString>;
|
|
@@ -17,58 +11,14 @@ export declare const TASK_STOP_PARAMS: Type.TObject<{
|
|
|
17
11
|
}>;
|
|
18
12
|
/**
|
|
19
13
|
* Trims and skips blank/whitespace-only candidates, returning the first non-blank string among `values`.
|
|
20
|
-
* RB-479-A①: callers pass ONLY the tool's declared id parameters (
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
14
|
+
* RB-479-A①: callers pass ONLY the tool's declared id parameters (TaskStop: task_id, shell_id) — an id smuggled under
|
|
15
|
+
* any other key falls to the loud missing-parameter refusal. The trim/skip-blank behavior stays (a whitespace-only id
|
|
16
|
+
* reports the same missing-parameter text as an absent one, instead of falling through to a not-found lookup on the
|
|
17
|
+
* literal " ").
|
|
24
18
|
*/
|
|
25
19
|
export declare function resolveTaskIdArg(...values: unknown[]): string | undefined;
|
|
26
20
|
/**
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
* deployment really delivers that behavior; every composed sentence below is gated on the flag it
|
|
30
|
-
* describes, so no mount ever advertises a file path that is never written, a notification that never
|
|
31
|
-
* fires, a wait that never blocks, or name addressing that never resolves.
|
|
32
|
-
*/
|
|
33
|
-
export interface TaskToolCapabilities {
|
|
34
|
-
/** The unified registry face: workflow-task support + own-scope fencing (registry mounts only). */
|
|
35
|
-
lanes: boolean;
|
|
36
|
-
/** Bash(run_in_background)'s launch receipt carries the output file path (registry mounts only). */
|
|
37
|
-
outputFile: boolean;
|
|
38
|
-
/** A terminal <task-notification> fires when the task completes — true only when the deployment
|
|
39
|
-
* actually wired `taskNotification` (B17 方案查出的既有假广告: the registry mount used to advertise
|
|
40
|
-
* this unconditionally; prepare-task now passes the real wiring state). */
|
|
41
|
-
notification: boolean;
|
|
42
|
-
/** TaskOutput block/timeout wait semantics (registry pollTask; the env-direct poll is instantaneous). */
|
|
43
|
-
blockWait: boolean;
|
|
44
|
-
/** TaskStop accepts a background agent's spawn NAME as task_id (registry name resolution only). */
|
|
45
|
-
nameAddressing: boolean;
|
|
46
|
-
}
|
|
47
|
-
/** Full-capability profile = the registry-backed mount with notifications wired. */
|
|
48
|
-
export declare const REGISTRY_TASK_TOOL_CAPS: TaskToolCapabilities;
|
|
49
|
-
/** The env-direct thin-shell profile: cursor polling over a background shell, nothing else. */
|
|
50
|
-
export declare const ENV_DIRECT_TASK_TOOL_CAPS: TaskToolCapabilities;
|
|
51
|
-
/**
|
|
52
|
-
* TaskOutput description, composed per capability. With every flag true this reproduces the registry's
|
|
53
|
-
* pre-S2 literal byte-for-byte — the first two sentences are the A5 deprecated form
|
|
54
|
-
* (209-verbatim except the task-type names, mapped to sema's lanes; divergence-logged; the anchor
|
|
55
|
-
* commentary lives at the registry factory). With `notification` false the <task-notification> half is
|
|
56
|
-
* honestly omitted and the cursor-polling guidance (the env side's long-standing wording) is composed in
|
|
57
|
-
* instead — completion must then be detected by status, and SAYING so is the capability-honest guidance.
|
|
58
|
-
*/
|
|
59
|
-
export declare function composeTaskOutputDescription(caps: TaskToolCapabilities): string;
|
|
60
|
-
/**
|
|
61
|
-
* TaskStop description, composed per capability. All-true reproduces the registry literal (
|
|
62
|
-
* the named-agent bullet is the reference's; its teammate bullet stays honestly omitted — sema's team face is
|
|
63
|
-
* in-process, not registry-addressable); `nameAddressing:false` drops exactly that bullet (the env shell
|
|
64
|
-
* has no agent-name resolution), which reproduces the env-direct literal.
|
|
65
|
-
*/
|
|
66
|
-
export declare function composeTaskStopDescription(caps: TaskToolCapabilities): string;
|
|
67
|
-
/**
|
|
68
|
-
* TaskOutput params, composed per capability (fable 终判 D3 — an advertised parameter the execute body
|
|
69
|
-
* ignores is a lie): block/timeout enter the schema only where the poll can actually wait
|
|
70
|
-
* (design/116 W3 — CC TaskOutput block/timeout; sema block default documented as true, CC-parity).
|
|
71
|
-
* Canonical surface stays design/115 review S-3: task_id + sema-delta filter — and (RB-479-A①) the
|
|
72
|
-
* declared surface is also the RESOLVED surface; no undeclared id key is read.
|
|
21
|
+
* TaskStop's description. The named-agent bullet is the reference's; its teammate bullet stays honestly omitted —
|
|
22
|
+
* sema's team face is in-process, not registry-addressable.
|
|
73
23
|
*/
|
|
74
|
-
export declare
|
|
24
|
+
export declare const TASK_STOP_DESCRIPTION: string;
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
import { Type } from "typebox";
|
|
2
|
-
export const TASK_OUTPUT_TOOL_NAME = "TaskOutput";
|
|
3
2
|
export const TASK_STOP_TOOL_NAME = "TaskStop";
|
|
4
|
-
export const TASK_OUTPUT_CONTRACT = { contractId: "core.task_output@1", implementationRevision: "1" };
|
|
5
3
|
export const TASK_STOP_CONTRACT = { contractId: "core.task_stop@1", implementationRevision: "1" };
|
|
6
|
-
export const TASK_OUTPUT_MISSING_ID_MESSAGE = "Error (TaskOutput): Missing required parameter: task_id";
|
|
7
4
|
export const TASK_STOP_MISSING_ID_MESSAGE = "Missing required parameter: task_id";
|
|
8
5
|
export const TASK_STOP_PARAMS = Type.Object({
|
|
9
6
|
task_id: Type.Optional(Type.String({ description: "The ID of the background task to stop" })),
|
|
@@ -16,66 +13,10 @@ export function resolveTaskIdArg(...values) {
|
|
|
16
13
|
}
|
|
17
14
|
return undefined;
|
|
18
15
|
}
|
|
19
|
-
export const
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
export const ENV_DIRECT_TASK_TOOL_CAPS = {
|
|
27
|
-
lanes: false,
|
|
28
|
-
outputFile: false,
|
|
29
|
-
notification: false,
|
|
30
|
-
blockWait: false,
|
|
31
|
-
nameAddressing: false,
|
|
32
|
-
};
|
|
33
|
-
export function composeTaskOutputDescription(caps) {
|
|
34
|
-
const parts = [];
|
|
35
|
-
if (caps.outputFile) {
|
|
36
|
-
parts.push("[Deprecated] — for background Bash tasks, prefer Read on the output file path; for agent tasks, use the Agent tool result directly. " +
|
|
37
|
-
"DEPRECATED: Background tasks return their output file path in the tool result" +
|
|
38
|
-
(caps.notification ? ", and you receive a <task-notification> with the same path when the task completes. " : ". "));
|
|
39
|
-
}
|
|
40
|
-
parts.push("Retrieve output or status for a background task by task_id. ");
|
|
41
|
-
parts.push(caps.lanes
|
|
42
|
-
?
|
|
43
|
-
"Supports background Bash tasks and workflow tasks returned by Workflow. Returns only the caller's own task scope; unknown and out-of-scope ids are " +
|
|
44
|
-
"reported the same way. "
|
|
45
|
-
: "Reads a background shell started with Bash(run_in_background): returns the run status (running / exited(code) / killed / failed) plus NEW stdout/stderr since your last call. ");
|
|
46
|
-
if (!caps.notification) {
|
|
47
|
-
parts.push('When using a background command as a wait condition, call this repeatedly until status is no longer "running" — completion ' +
|
|
48
|
-
"is signalled by status/exitCode, not by any automatic notification; after you see a terminal status, one more " +
|
|
49
|
-
"poll captures any final output. ");
|
|
50
|
-
}
|
|
51
|
-
if (!caps.lanes)
|
|
52
|
-
parts.push("Optional `filter` is a regex keeping only matching lines.");
|
|
53
|
-
return parts.join("").trimEnd();
|
|
54
|
-
}
|
|
55
|
-
export function composeTaskStopDescription(caps) {
|
|
56
|
-
return [
|
|
57
|
-
"- Stops a running background task by its ID",
|
|
58
|
-
"- Takes a task_id parameter identifying the task to stop",
|
|
59
|
-
...(caps.nameAddressing ? ["- To stop a background agent spawned with a name, pass that name as task_id"] : []),
|
|
60
|
-
"- Returns a success or failure status",
|
|
61
|
-
"- Use this tool when you need to terminate a long-running task",
|
|
62
|
-
].join("\n");
|
|
63
|
-
}
|
|
64
|
-
export function composeTaskOutputParams(caps) {
|
|
65
|
-
return Type.Object({
|
|
66
|
-
task_id: Type.Optional(Type.String({
|
|
67
|
-
description: caps.lanes
|
|
68
|
-
? "The task_id returned by Bash(run_in_background) or Workflow."
|
|
69
|
-
: "The task_id returned by Bash(run_in_background).",
|
|
70
|
-
})),
|
|
71
|
-
...(caps.blockWait
|
|
72
|
-
? {
|
|
73
|
-
block: Type.Optional(Type.Boolean({
|
|
74
|
-
description: "Whether to wait for completion (default true — the call waits until the task finishes or `timeout`, saving re-poll turns). Pass false for an instantaneous snapshot.",
|
|
75
|
-
})),
|
|
76
|
-
timeout: Type.Optional(Type.Number({ description: "Optional timeout in milliseconds when block is true (default 30000, max 600000)." })),
|
|
77
|
-
}
|
|
78
|
-
: {}),
|
|
79
|
-
filter: Type.Optional(Type.String({ description: "Optional regex filter for background Bash output (sema extension)." })),
|
|
80
|
-
});
|
|
81
|
-
}
|
|
16
|
+
export const TASK_STOP_DESCRIPTION = [
|
|
17
|
+
"- Stops a running background task by its ID",
|
|
18
|
+
"- Takes a task_id parameter identifying the task to stop",
|
|
19
|
+
"- To stop a background agent spawned with a name, pass that name as task_id",
|
|
20
|
+
"- Returns a success or failure status",
|
|
21
|
+
"- Use this tool when you need to terminate a long-running task",
|
|
22
|
+
].join("\n");
|
|
@@ -73,8 +73,14 @@ export type TerminalCause = {
|
|
|
73
73
|
* - `"config.usage_window_unpriced"` — a `UsageWindow.maxCostUsd` over a run with no cost figure
|
|
74
74
|
* (no `RunnerDeps.pricing` entry and no `Model.cost`).
|
|
75
75
|
* - `"usage_window.store_cost_unanswered"` — the wired ledger does not carry the money arm.
|
|
76
|
-
*
|
|
77
|
-
*
|
|
76
|
+
* Two codes name a model whose output the loop could not use after its bounded retries — the run did not
|
|
77
|
+
* finish its work, though its last turn reads like an ordinary one:
|
|
78
|
+
* - `"model.malformed_tool_use_exhausted"` — every tool call of the model's turns kept arriving unparseable
|
|
79
|
+
* and the retry budget is spent (nothing ran for them).
|
|
80
|
+
* - `"model.truncated_output_exhausted"` — the model's answer kept ending on the output cap and the
|
|
81
|
+
* continue budget is spent (`result` holds the text it reached).
|
|
82
|
+
* `"unexpected.suspended"` / `"unexpected.needs_review"` — a nested orchestrator stopped at a durable pause and
|
|
83
|
+
* carries it on {@link nestedPause} (`mapNestedSuspend` states which orchestrators, and how the pause continues).
|
|
78
84
|
*/
|
|
79
85
|
code?: string;
|
|
80
86
|
/** Human-readable failure text. */
|
|
@@ -94,12 +100,20 @@ export type TerminalCause = {
|
|
|
94
100
|
detail?: TerminalFailureDetail;
|
|
95
101
|
/**
|
|
96
102
|
* The durable pause this failure STANDS IN FOR — set only by the nested hard boundary
|
|
97
|
-
* (`mapNestedSuspend
|
|
98
|
-
*
|
|
99
|
-
* cause travels here verbatim so the
|
|
100
|
-
*
|
|
103
|
+
* (`mapNestedSuspend`, which states which orchestrators map and the entry that continues the pause): an
|
|
104
|
+
* orchestrator's nested leg paused on a durable gate, so at ITS boundary the pause is a failure — but the
|
|
105
|
+
* pause's own cause travels here verbatim so the host keeps the recovery capability (`nestedPause.token`).
|
|
106
|
+
* Absent on every failure the engine itself assembles.
|
|
101
107
|
*/
|
|
102
108
|
nestedPause?: PausedCause;
|
|
109
|
+
/**
|
|
110
|
+
* What a RESUMED leg that ended before its approved action started did to its checkpoint row — the store's own
|
|
111
|
+
* outcome, stated by the exit that compensated it: `reopened` (pending again: the same token resumes it),
|
|
112
|
+
* `declined` (the store refused to reopen it — read the row), `unknown` (the reopen threw: its state is unprovable).
|
|
113
|
+
* Beside `code`, never folded into it: the code still names what ended the leg. PRESENCE: only on such a leg; a
|
|
114
|
+
* fresh run, a leg that started its approved action and a delivered negative decision carry none.
|
|
115
|
+
*/
|
|
116
|
+
unstartedRow?: "reopened" | "declined" | "unknown";
|
|
103
117
|
} | {
|
|
104
118
|
kind: "blocked";
|
|
105
119
|
/**
|
|
@@ -214,6 +228,18 @@ export type TerminalFailureDetail = {
|
|
|
214
228
|
* states none leaves it absent.
|
|
215
229
|
*/
|
|
216
230
|
route?: RequestRoute;
|
|
231
|
+
/**
|
|
232
|
+
* Which part of the request the refusal named, when the engine classified it off the provider's envelope at the brain
|
|
233
|
+
* boundary — the terminal message's own `errorKind`, carried when it is one of {@link REFUSED_REQUEST_PARTS}:
|
|
234
|
+
* `input_too_long` (the input alone exceeds the context limit), `image_unprocessable` (an image could not be
|
|
235
|
+
* processed), `tool_schema_refused` (one tool's input schema; {@link tool} names it). Absent when the refusal named
|
|
236
|
+
* no part this engine classifies — the account says nothing about it, and nothing is read from the provider's words.
|
|
237
|
+
*/
|
|
238
|
+
errorKind?: RefusedRequestPart;
|
|
239
|
+
/** With `errorKind: "tool_schema_refused"`: the tool whose input schema the provider refused (the message's
|
|
240
|
+
* `refusedTool`). A tool the engine could not send without its schema (not an MCP / A2A tool, or the transcript's bound
|
|
241
|
+
* of 8 reached) ends the run here; one it could is re-sent and never names a terminal. */
|
|
242
|
+
tool?: string;
|
|
217
243
|
} | {
|
|
218
244
|
kind: "coded";
|
|
219
245
|
/**
|
|
@@ -237,6 +263,10 @@ export type TerminalFailureDetail = {
|
|
|
237
263
|
* cap) — what the brain's sentence words as its cap clause. */
|
|
238
264
|
outputLimit?: OutputLimit;
|
|
239
265
|
};
|
|
266
|
+
/** The parts of a request a provider's refusal can name that the brain boundary classifies — the closed set of
|
|
267
|
+
* `provider_rejected.errorKind` ({@link TerminalFailureDetail}). New members join with a minor. */
|
|
268
|
+
export declare const REFUSED_REQUEST_PARTS: readonly ["input_too_long", "image_unprocessable", "tool_schema_refused"];
|
|
269
|
+
export type RefusedRequestPart = (typeof REFUSED_REQUEST_PARTS)[number];
|
|
240
270
|
/** A JSON-plain value as a `coded` account carries it. */
|
|
241
271
|
export type CodedFailureDetailValue = string | number | boolean | null | readonly CodedFailureDetailValue[] | {
|
|
242
272
|
readonly [key: string]: CodedFailureDetailValue;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
export const REFUSED_REQUEST_PARTS = Object.freeze(["input_too_long", "image_unprocessable", "tool_schema_refused"]);
|
|
1
2
|
export const PROMPT_BLOCK_CAUSES = Object.freeze(["block", "crashed", "timeout", "cancelled"]);
|
|
2
3
|
const PROMPT_BLOCK_CAUSE_SET = new Set(PROMPT_BLOCK_CAUSES);
|
|
3
4
|
export function isPromptBlockCause(v) {
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { TASK_STOP_CONTRACT } from "./task-tool-shape.js";
|
|
2
2
|
export const FULL_SHELL_CONTRACT_ID = "core.bash@1";
|
|
3
3
|
export const READONLY_SHELL_CONTRACT_ID = "core.bash_readonly@1";
|
|
4
4
|
export const TASK_CREATE_TOOL_NAME = "TaskCreate";
|
|
@@ -120,10 +120,7 @@ export const TOOL_CATALOG_ENTRIES = [
|
|
|
120
120
|
},
|
|
121
121
|
{ id: "enter-worktree", name: "EnterWorktree", source: "builtin", definedIn: "src/tools/worktree.ts", mountedBy: ["hands"], cards: ["worktree"], face: { family: "other", boundaryLegs: ["env"], effect: "write", contract: c("core.enter_worktree@1"), ruleFace: { params: ["name", "path", "baseRef"] } } },
|
|
122
122
|
{ id: "exit-worktree", name: "ExitWorktree", source: "builtin", definedIn: "src/tools/worktree.ts", mountedBy: ["hands"], cards: ["worktree"], face: { family: "other", boundaryLegs: ["env"], effect: "write", contract: c("core.exit_worktree@1"), ruleFace: { params: ["keep", "discardChanges", "action", "discard_changes"] } } },
|
|
123
|
-
{ id: "task-
|
|
124
|
-
{ id: "task-stop-hands", name: "TaskStop", source: "builtin", definedIn: "src/tools/fs/fs-bash.ts", mountedBy: ["hands"], cards: [], face: { family: "delegate", boundaryLegs: ["env"], effect: "write", contract: TASK_STOP_CONTRACT, ruleFace: { params: ["task_id", "shell_id"] } } },
|
|
125
|
-
{ id: "task-output", name: "TaskOutput", source: "builtin", definedIn: "src/core/task-registry.ts", mountedBy: ["delegation"], cards: ["task-output"], face: { family: "delegate", boundaryLegs: "per_call", effect: "read", contract: TASK_OUTPUT_CONTRACT, ruleFace: { params: ["task_id", "block", "timeout", "filter"] } } },
|
|
126
|
-
{ id: "task-stop", name: "TaskStop", source: "builtin", definedIn: "src/core/task-registry.ts", mountedBy: ["delegation"], cards: ["task-stop"], face: { family: "delegate", boundaryLegs: "per_call", effect: "write", contract: TASK_STOP_CONTRACT, ruleFace: { params: ["task_id", "shell_id"] } } },
|
|
123
|
+
{ id: "task-stop", name: "TaskStop", source: "builtin", definedIn: "src/core/task-registry.ts", mountedBy: ["hands", "delegation"], cards: ["task-stop"], face: { family: "delegate", boundaryLegs: "per_call", effect: "write", contract: TASK_STOP_CONTRACT, ruleFace: { params: ["task_id", "shell_id"] } } },
|
|
127
124
|
{ id: "monitor", name: "Monitor", source: "builtin", definedIn: "src/tools/monitor.ts", mountedBy: ["backgroundTasks"], cards: ["monitor-start", "readonly_out_of_root", "read_unestablished"], face: { family: "other", boundaryLegs: ["env"], effect: "write", contract: c("core.monitor@1"), ruleFace: shellRuleFace(["command", "description", "timeout_ms", "persistent"]), offloadThresholdChars: 10_000 } },
|
|
128
125
|
{ id: "send-message", name: "SendMessage", protocol: ["teammate"], source: "builtin", definedIn: "src/agents/send-message-tool.ts", mountedBy: ["delegation", "hostInternals", "peerLane"], cards: ["send-message"], face: { family: "protocol", boundaryLegs: ["outside_write"], effect: "write", contract: c("core.send_message@1"), ruleFace: { params: ["to", "message", "summary", "notify_when_idle", "urgent"] } } },
|
|
129
126
|
{ id: "agent-transcript", name: "AgentTranscript", source: "builtin", definedIn: "src/agents/agent-transcript-tool.ts", mountedBy: ["delegation"], cards: ["agent-transcript"], face: { family: "delegate", boundaryLegs: [], effect: "read", contract: c("core.agent_transcript@1"), ruleFace: { params: ["id", "lastN"] } } },
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { refusalOf } from "./tool-policy.js";
|
|
1
|
+
import { extensionNamed, extensionQuestionText, extensionSpeaker, refusalOf } from "./tool-policy.js";
|
|
2
|
+
import { hookAskReasonOf, joinAskReasons } from "./ask-origin.js";
|
|
2
3
|
import { allowRuleShadowOf, withAllowRuleShadow } from "./allow-entry.js";
|
|
3
|
-
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
4
|
import { failedHandlerClause } from "./mods/stations.js";
|
|
5
5
|
const STANDS = Object.freeze({ kind: "stands" });
|
|
6
6
|
function readToolCheck(heard, standing, call, mayClear) {
|
|
@@ -17,9 +17,11 @@ function readToolCheck(heard, standing, call, mayClear) {
|
|
|
17
17
|
if (heard.decision === "deny")
|
|
18
18
|
return refused(`tool "${toolName}" denied by ${who}${why}`, heard.by);
|
|
19
19
|
if (heard.decision === "ask") {
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
20
|
+
if (standing.action === "ask") {
|
|
21
|
+
const askReasons = joinAskReasons(standing.askReasons, [entryOf(heard)]);
|
|
22
|
+
return { kind: "asked", ask: { ...standing, decisionReason: "hook", ...(heard.reason !== undefined ? { message: heard.reason } : {}), ...(askReasons !== undefined ? { askReasons } : {}) }, minted: false };
|
|
23
|
+
}
|
|
24
|
+
return { kind: "asked", ask: { ...questionOf(heard, toolName), ...rewritten }, minted: true };
|
|
23
25
|
}
|
|
24
26
|
if (standing.action === "allow")
|
|
25
27
|
return STANDS;
|
|
@@ -29,15 +31,18 @@ function readToolCheck(heard, standing, call, mayClear) {
|
|
|
29
31
|
return { kind: "shadowed", shadows: [allowRuleShadowOf("hook", entries)] };
|
|
30
32
|
}
|
|
31
33
|
export function extensionAllowOf(speakers, rewrite) {
|
|
32
|
-
const who = speakers.length > 0 ? speakers.map(
|
|
34
|
+
const who = speakers.length > 0 ? speakers.map(extensionNamed).join(", ") : "an extension";
|
|
33
35
|
return { action: "allow", message: `${who} allowed this call`, decisionReason: "hook", ...(rewrite !== undefined ? { updatedInput: rewrite } : {}) };
|
|
34
36
|
}
|
|
35
37
|
function speakerOf(heard) {
|
|
36
|
-
return
|
|
38
|
+
return extensionSpeaker(heard.by, heard.reason);
|
|
39
|
+
}
|
|
40
|
+
function entryOf(heard) {
|
|
41
|
+
return hookAskReasonOf(heard.by, "asked", heard.reason);
|
|
37
42
|
}
|
|
38
43
|
function questionOf(heard, toolName) {
|
|
39
|
-
const
|
|
40
|
-
return { action: "ask", message:
|
|
44
|
+
const entry = entryOf(heard);
|
|
45
|
+
return { action: "ask", message: extensionQuestionText(toolName, entry), decisionReason: "hook", askReasons: Object.freeze([entry]) };
|
|
41
46
|
}
|
|
42
47
|
export async function readToolChecks(chains, standing, call, project) {
|
|
43
48
|
let raised = false;
|
|
@@ -61,7 +66,8 @@ export async function readToolChecks(chains, standing, call, project) {
|
|
|
61
66
|
return { kind: "approved", allow: { ...settled, updatedInput: settled.updatedInput }, ...(moved?.kind === "asked" ? { outstanding: moved.ask } : {}) };
|
|
62
67
|
continue;
|
|
63
68
|
}
|
|
64
|
-
const
|
|
69
|
+
const joined = current.action === "ask" ? joinAskReasons(current.askReasons, settled.askReasons) : undefined;
|
|
70
|
+
const ask = current.action === "ask" ? (joined !== undefined ? { ...current, askReasons: joined } : current) : settled;
|
|
65
71
|
moved = { kind: "asked", ask, minted: current.action !== "ask" || (moved?.kind === "asked" && moved.minted), marked: true };
|
|
66
72
|
current = ask;
|
|
67
73
|
continue;
|
|
@@ -20,8 +20,7 @@ export const TOOL_CONFORMANCE_VECTORS = [
|
|
|
20
20
|
{ name: "Edit", why: "the read-only band mounts the read half only" },
|
|
21
21
|
{ name: "Write", why: "the read-only band mounts the read half only" },
|
|
22
22
|
{ name: "NotebookEdit", why: "the read-only band mounts the read half only" },
|
|
23
|
-
{ name: "
|
|
24
|
-
{ name: "TaskStop", why: "the background-shell pair mounts on the full shell only" },
|
|
23
|
+
{ name: "TaskStop", why: "the background-command stop mounts on the full shell only" },
|
|
25
24
|
{ name: "EnterWorktree", why: "the worktree pair needs the tracked cwd the full shell owns" },
|
|
26
25
|
{ name: "ExitWorktree", why: "the worktree pair needs the tracked cwd the full shell owns" },
|
|
27
26
|
{ name: "LSP", why: "needs a wired LSP manager" },
|