@sema-agent/core 7.60.0 → 7.61.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 +605 -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 +61 -10
- package/dist/agents/cascade.js +60 -20
- 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-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 +36 -7
- 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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- 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-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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 +49 -18
- 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 +2 -1
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- 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 +2 -1
- 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 +220 -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.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/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- 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 +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -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 +141 -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 +38 -16
- package/dist/core/mods/stations.js +25 -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 +61 -2
- package/dist/core/own-property-receipt.js +42 -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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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 +14 -2
- 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 +98 -26
- 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/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/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 +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- 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 +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- 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 +56 -28
- 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 +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- 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.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- 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 +40 -29
- 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 +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/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 +8 -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-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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- 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 +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- 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 +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -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/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 +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- 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 +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- 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 +30 -0
- 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 +2 -3
- 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 +108 -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-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- 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 +41 -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/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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 +16 -3
- package/dist/stores/file/session-store.js +21 -20
- 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/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/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- 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/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 +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -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,6 +73,12 @@ 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
|
+
* 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).
|
|
76
82
|
* A NESTED orchestrator that met a durable pause it cannot drive stamps `"unexpected.suspended"` /
|
|
77
83
|
* `"unexpected.needs_review"` and carries the pause on {@link nestedPause}.
|
|
78
84
|
*/
|
|
@@ -100,6 +106,14 @@ export type TerminalCause = {
|
|
|
100
106
|
* (`nestedPause.token` → `runner.resume`). 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" },
|
|
@@ -51,7 +51,9 @@ export declare function formatToolError(error: unknown): string;
|
|
|
51
51
|
*
|
|
52
52
|
* - `budget` — the cost/token budget gate fired (`limits.max_tokens_exceeded` / `limits.max_cost_exceeded`).
|
|
53
53
|
* - `limit` — a hard run limit fired (`limits.max_turns_exceeded` / `limits.max_walltime_exceeded`).
|
|
54
|
-
* - `output` — the structured/answer output was rejected (`output.invalid` / `output.degenerate`)
|
|
54
|
+
* - `output` — the structured/answer output was rejected (`output.invalid` / `output.degenerate`), or the
|
|
55
|
+
* model's output could not be used after the loop's bounded retries (`model.malformed_tool_use_exhausted`
|
|
56
|
+
* / `model.truncated_output_exhausted`).
|
|
55
57
|
* - `suspend` — the suspend-loop cap fired (`suspend.loop`); a TERMINAL failure, distinct from a
|
|
56
58
|
* resumable `suspended` status (which carries no errorCode).
|
|
57
59
|
* - `review` — a review-pause terminal (`review.pending`).
|
|
@@ -118,8 +120,9 @@ export type WorkerErrorClass = "budget" | "limit" | "output" | "suspend" | "revi
|
|
|
118
120
|
* SCOPE: this folds a TERMINAL `TaskResult.errorCode` only — i.e. every OUR dotted prefix that the runner can
|
|
119
121
|
* assemble into a failed task outcome (`limits.`/`output.`/`suspend.`/`review.`/`unexpected.`/
|
|
120
122
|
* `oracle.`/`resume.`/`config.`/`usage.`) as a broad PREFIX, plus `memory.admission_required` /
|
|
121
|
-
* `memory.admission_denied` / `env.lifetime_expired` as EXACT codes (their
|
|
122
|
-
* are NOT all terminal-errorCode-shaped — see {@link EXACT_CODE_CLASS}'s
|
|
123
|
+
* `memory.admission_denied` / `env.lifetime_expired` / the two `model.*_exhausted` loop terminals as EXACT codes (their
|
|
124
|
+
* sibling `memory.*`/`env.*`/`model.*` strings are NOT all terminal-errorCode-shaped — see {@link EXACT_CODE_CLASS}'s
|
|
125
|
+
* comment), plus the flat 1.36 codes.
|
|
123
126
|
* The `limits.` namespace splits into the `budget` and `limit` classes by exact code — see
|
|
124
127
|
* {@link EXACT_CODE_CLASS}. Operation-level dotted codes that are surfaced to a *caller* and never become a
|
|
125
128
|
* task outcome are deliberately OUT of scope: `steering.*` (`steering.not_running`/`steering.invalid_content`/
|
package/dist/core/tool-errors.js
CHANGED
|
@@ -89,6 +89,8 @@ const EXACT_CODE_CLASS = new Map([
|
|
|
89
89
|
["memory.admission_denied", "config"],
|
|
90
90
|
["memory.capture_optout_denied", "config"],
|
|
91
91
|
["env.lifetime_expired", "config"],
|
|
92
|
+
["model.malformed_tool_use_exhausted", "output"],
|
|
93
|
+
["model.truncated_output_exhausted", "output"],
|
|
92
94
|
]);
|
|
93
95
|
const DOTTED_PREFIX_CLASS = [
|
|
94
96
|
["limits.", "limit"],
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { callerText, dataKind, perToolEmptyName, perToolEntryRefusal, receivePerToolDeclaration } from "./mcp-server-spec.js";
|
|
2
2
|
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
3
|
+
import { strayMembersOf } from "./own-property-receipt.js";
|
|
3
4
|
import { faceProblem } from "./runner/tool-face-overlay.js";
|
|
4
5
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
5
6
|
const TOOL_FACE_MEMBERS = { family: true, pathTarget: true, hostTarget: true, renderHints: true, ruleFace: true };
|
|
@@ -20,8 +21,8 @@ function kindProblem(label, value, kind) {
|
|
|
20
21
|
function membersOf(raw, label, names) {
|
|
21
22
|
if (!isPlainRecord(raw))
|
|
22
23
|
return `${label} is ${dataKind(raw)}, not an object`;
|
|
23
|
-
const
|
|
24
|
-
return
|
|
24
|
+
const stray = strayMembersOf(raw, { subject: label, unit: "member", moment: "when the face is read" }, names);
|
|
25
|
+
return stray === undefined ? raw : `${label} has an unknown member ${callerText(String(stray.names[0]))} (the members are ${names.join(", ")})`;
|
|
25
26
|
}
|
|
26
27
|
function ownMember(record, name) {
|
|
27
28
|
return Object.hasOwn(record, name) ? record[name] : undefined;
|
package/dist/core/tool-face.d.ts
CHANGED
|
@@ -16,13 +16,12 @@ export declare const TOOL_FAMILIES: readonly ["shell", "file-read", "file-write"
|
|
|
16
16
|
export type ToolFamily = (typeof TOOL_FAMILIES)[number];
|
|
17
17
|
/**
|
|
18
18
|
* The closed set of MOUNT-CONDITION tags a static catalog entry is listed under. The static half of the
|
|
19
|
-
* catalog carries an ARRAY (a tool can be mounted by more than one condition
|
|
20
|
-
* hand band and the delegation surface); the effect roster records the ONE tag that actually fired.
|
|
19
|
+
* catalog carries an ARRAY (a tool can be mounted by more than one condition); the effect roster records the ONE tag that actually fired.
|
|
21
20
|
*
|
|
22
21
|
* - `hands` — the hand band (an execution env is wired: `deps.executionEnv` / `executionEnvFactory`);
|
|
23
22
|
* - `backgroundTasks` — the background-task surface (`Monitor`);
|
|
24
23
|
* - `workflow` — the workflow tool surface (`Workflow`);
|
|
25
|
-
* - `delegation` — the union of the background-task and workflow surfaces (
|
|
24
|
+
* - `delegation` — the union of the background-task and workflow surfaces (TaskStop/
|
|
26
25
|
* AgentTranscript, SendMessage's first condition);
|
|
27
26
|
* - `hostInternals` — a host-internal seat is present (`RunInternals.parentNotify`);
|
|
28
27
|
* - `peerLane` — the peer-session lane is mounted;
|
|
@@ -1,33 +1,5 @@
|
|
|
1
1
|
import { type ProtocolNamespace } from "./protocol-table.js";
|
|
2
2
|
import type { RuleBehavior } from "./permission-rule-model.js";
|
|
3
|
-
/**
|
|
4
|
-
* RB-476-A stage 2 (ruling 2026-08-02, RB-476 "no compatibility surface survives", replay
|
|
5
|
-
* resolution included) — the durable-name machinery this module used to hold is RETIRED:
|
|
6
|
-
*
|
|
7
|
-
* - `OLD_TO_NEW` (the Q6/design-108/design-115 persisted-name normalization) and the MCP `mcp__`
|
|
8
|
-
* prefix arm are gone: a persisted checkpoint/orphan/policy entry carrying a pre-rename name no
|
|
9
|
-
* longer resolves to the live roster. Old durable state misses LOUDLY (`resume.tool_unavailable`
|
|
10
|
-
* on a resumed checkpoint, a roster miss on replay) — by ruling, old sessions are sacrificed
|
|
11
|
-
* rather than carried.
|
|
12
|
-
* - `canonicalToolName` is gone with it: with the mapping cleared it was the identity function, and
|
|
13
|
-
* keeping an identity shim invites the next mapping to grow back silently.
|
|
14
|
-
* - `TOMBSTONED_TOOLS` (a second table of per-name re-education prose) is gone. A CALL to a retired name is
|
|
15
|
-
* told what the one table here says about it ({@link judgeToolNameMiss}): the miss is `expected-absent`
|
|
16
|
-
* with the successor, where any other unknown name stays the generic roster miss.
|
|
17
|
-
*
|
|
18
|
-
* What REMAINS is validation data: {@link RETIRED_TOOL_NAMES} maps every name the engine ever
|
|
19
|
-
* retired to a one-line guidance string, and {@link judgeRuleToolName} is the ONE judgment of it a rule's
|
|
20
|
-
* tool name gets ({@link toolNameFaultOf} adds the near-miss step: the one reading). They exist because deleting the mapping flips stale POLICY entries from "silently
|
|
21
|
-
* matched" to "silently matches nothing" — and for a deny/requireApproval entry that direction WIDENS
|
|
22
|
-
* the surface. `validatePermissionRules` (permission-rules.ts) does NOT classify retired names itself:
|
|
23
|
-
* which names a deployment mounts its OWN tool under is a roster fact, and the judgment takes the roster.
|
|
24
|
-
* A deployment that mounts its OWN tool under one of these names is unaffected: the name is then in the
|
|
25
|
-
* roster and the judgment answers `current`.
|
|
26
|
-
*
|
|
27
|
-
* GRAMMAR of a guidance string, read by {@link judgeRuleToolName} and held by a pin: it opens with
|
|
28
|
-
* `renamed "<name>"` (a 1:1 successor — the judgment's `currentName`), `folded into "<name>"` (merged into a
|
|
29
|
-
* wider tool: writing it would deny more than the entry did, so it is no current name), or `removed — `.
|
|
30
|
-
*/
|
|
31
3
|
export declare const RETIRED_TOOL_NAMES: ReadonlyMap<string, string>;
|
|
32
4
|
/** The four answers {@link judgeRuleToolName} gives — a closed set. */
|
|
33
5
|
export declare const RULE_TOOL_NAME_VERDICTS: readonly ["current", "retired", "unprefixed_namespace", "unmintable_segment"];
|
|
@@ -95,7 +67,11 @@ export interface PeerReading {
|
|
|
95
67
|
* segment is read through the mint — the peer a reading names is the one the mint would spell it as. `[]` for a name with no
|
|
96
68
|
* second reading: no separator in the body (the one reading is {@link splitNamespacedName}'s), a glob, an empty segment on either
|
|
97
69
|
* side of a cut, or a namespace the reference has no spelling for (only MCP's server names reach a rule from another product).
|
|
98
|
-
* The first reading is the first separator's — the one `splitNamespacedName` gives.
|
|
70
|
+
* The first reading is the first separator's — the one `splitNamespacedName` gives. The readings run one way only: from the
|
|
71
|
+
* reference's spelling to the minted peers. The fold is lossy (`a__b` and `a_b` mint one prefix) and only a peer segment is folded —
|
|
72
|
+
* the separator between a peer and its tool never is — so a name already in the minted spelling (`mcp__a_b__t`) is the name the
|
|
73
|
+
* engine mounts and is read as that, never as the unfolded spellings that fold to it (server `a`'s tool `b__t` is another tool);
|
|
74
|
+
* a name no mint produces (`b3126_echo`) reads as no tool, and the policy-name audit announces it.
|
|
99
75
|
*/
|
|
100
76
|
export declare function peerReadingsOf(name: string): readonly PeerReading[];
|
|
101
77
|
/**
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { carriesNamespaceSeparator, MCP_NAMESPACE, protocolOf } from "./protocol-table.js";
|
|
2
2
|
import { mintNamespacePrefix } from "./protocol-naming.js";
|
|
3
3
|
import { catalogToolNames } from "./tool-registry.js";
|
|
4
|
+
const BACKGROUND_OUTPUT_READING = "removed — read a background command's output file with Read (its launch receipt and completion notification name the path); a background agent's or workflow's result arrives in its completion notification (read the full text with ReadToolResult and the ref it names when the notification clips it)";
|
|
4
5
|
export const RETIRED_TOOL_NAMES = new Map([
|
|
5
6
|
["read_file", 'renamed "Read"'],
|
|
6
7
|
["edit_file", 'renamed "Edit"'],
|
|
@@ -25,11 +26,14 @@ export const RETIRED_TOOL_NAMES = new Map([
|
|
|
25
26
|
["run_workflow", 'renamed "Workflow"'],
|
|
26
27
|
["RunWorkflow", 'renamed "Workflow"'],
|
|
27
28
|
["Task", 'renamed "Agent" (a deployment-defined tool named "Task" is fine — this fires only when the name matches nothing in the roster)'],
|
|
28
|
-
["
|
|
29
|
-
["
|
|
30
|
-
["
|
|
31
|
-
["
|
|
32
|
-
["
|
|
29
|
+
["TaskOutput", BACKGROUND_OUTPUT_READING],
|
|
30
|
+
["BashOutput", BACKGROUND_OUTPUT_READING],
|
|
31
|
+
["AgentOutputTool", BACKGROUND_OUTPUT_READING],
|
|
32
|
+
["BashOutputTool", BACKGROUND_OUTPUT_READING],
|
|
33
|
+
["AgentOutput", BACKGROUND_OUTPUT_READING],
|
|
34
|
+
["WorkflowStatus", BACKGROUND_OUTPUT_READING],
|
|
35
|
+
["TeamCreate", "removed — the session has one implicit team: start a teammate with Agent (a name makes it addressable via SendMessage)"],
|
|
36
|
+
["TeamDelete", "removed — the session has one implicit team: stop a teammate with TaskStop"],
|
|
33
37
|
["KillShell", 'renamed "TaskStop"'],
|
|
34
38
|
["KillBash", 'renamed "TaskStop"'],
|
|
35
39
|
["ListMcpResources", 'renamed "ListMcpResourcesTool"'],
|
|
@@ -4,13 +4,16 @@
|
|
|
4
4
|
* the wire name the gate resolves it to, the other aliases that resolve to the same row); which of them a site reads
|
|
5
5
|
* is a property of the SITE, declared here once:
|
|
6
6
|
*
|
|
7
|
-
* · `any` — a TIGHTEN keyed on an engine name set
|
|
8
|
-
*
|
|
7
|
+
* · `any` — a TIGHTEN keyed on an engine name set (a deny / ask rule's content included), or a rule naming a WHOLE tool
|
|
8
|
+
* (no content: the name a person or a skill wrote reaches every call that answers to it): the call is held
|
|
9
|
+
* under EVERY name it answers to ({@link heldBy}); a set-valued table is read as the union of its entries
|
|
10
|
+
* ({@link heldValues}).
|
|
9
11
|
* · `seat` — a multi-key seat keyed on engine names: ONE name is chosen ({@link seatOf}) and every key of the seat is
|
|
10
12
|
* read under it. `tier` = the name whose irreversibility tier is strictest (`never < maybe < always`, an
|
|
11
13
|
* absent tier lowest; a tie goes to the call's wire name — the tool that runs judges its own call with its
|
|
12
14
|
* own probe — then to the earlier name of the call); `member` = the first name the table holds.
|
|
13
|
-
* · `wire` — a GRANT or a ROUTING keyed on an engine name
|
|
15
|
+
* · `wire` — a GRANT or a ROUTING keyed on an engine name — an allow rule's content (read in the grammar of the tool that
|
|
16
|
+
* runs), and every entry of an allow list handed in at launch: the call's wire name only ({@link wireOf}).
|
|
14
17
|
* · `spelling` — a record of what the model said (stream frames, transcripts, counters): the harness event's own name;
|
|
15
18
|
* no port — listed so the table is complete.
|
|
16
19
|
*
|
|
@@ -111,6 +114,10 @@ export declare const NAME_READINGS: {
|
|
|
111
114
|
readonly kind: "any";
|
|
112
115
|
readonly file: string;
|
|
113
116
|
};
|
|
117
|
+
readonly "allowEntry.launchListNames": {
|
|
118
|
+
readonly kind: "wire";
|
|
119
|
+
readonly file: string;
|
|
120
|
+
};
|
|
114
121
|
readonly "skillGrant.binding": {
|
|
115
122
|
readonly kind: "wire";
|
|
116
123
|
readonly file: string;
|
|
@@ -127,6 +134,10 @@ export declare const NAME_READINGS: {
|
|
|
127
134
|
readonly kind: "any";
|
|
128
135
|
readonly file: string;
|
|
129
136
|
};
|
|
137
|
+
readonly "policy.persistedGrammar.grant": {
|
|
138
|
+
readonly kind: "wire";
|
|
139
|
+
readonly file: string;
|
|
140
|
+
};
|
|
130
141
|
readonly "policy.persistedToolRule": {
|
|
131
142
|
readonly kind: "any";
|
|
132
143
|
readonly file: string;
|
|
@@ -29,10 +29,12 @@ export const NAME_READINGS = {
|
|
|
29
29
|
"policy.projectionReplay": any(POLICY),
|
|
30
30
|
"policy.sessionRules.effect": wire("src/core/runner/session-rule-policy.ts"),
|
|
31
31
|
"allowEntry.names": any("src/core/allow-entry.ts"),
|
|
32
|
+
"allowEntry.launchListNames": wire("src/core/allow-entry.ts"),
|
|
32
33
|
"skillGrant.binding": wire("src/core/skill-grant.ts"),
|
|
33
34
|
"gate.skillActivationSeat": wire(GATE),
|
|
34
35
|
"policy.permissionRules": any("src/core/permission-rules.ts"),
|
|
35
36
|
"policy.persistedGrammar": any("src/core/permission-rule-model.ts"),
|
|
37
|
+
"policy.persistedGrammar.grant": wire("src/core/permission-rule-model.ts"),
|
|
36
38
|
"policy.persistedToolRule": any("src/core/permission-rule-model.ts"),
|
|
37
39
|
"policy.sensitivePathGuardedByName": any("src/core/sensitive-path-policy.ts"),
|
|
38
40
|
"floor.protectivePathTarget": seat("member", "src/core/tool-registry.ts"),
|