@sema-agent/core 7.66.1 → 7.67.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 +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
import { valveLeaves, valveLeavesPeer } from "../agents/tool-filter.js";
|
|
2
|
+
import { judgePeerLaneMount } from "../agents/peer-session-drain.js";
|
|
3
|
+
import { resolveCheckpointStore } from "./checkpoint-store.js";
|
|
4
|
+
import { preflightLockedConfig } from "./locked-config.js";
|
|
5
|
+
import { normalizeMemorySpec } from "./memory.js";
|
|
6
|
+
import { refusePermissionModeDoors, withModeSeats } from "./mode-policy.js";
|
|
7
|
+
import { MCP_RESOURCE_FACES } from "./mounted-mcp.js";
|
|
8
|
+
import { mintNamespacePrefix } from "./protocol-naming.js";
|
|
9
|
+
import { A2A_NAMESPACE, MCP_NAMESPACE } from "./protocol-table.js";
|
|
10
|
+
import { resolveTaskModel } from "./roles.js";
|
|
11
|
+
import { checkedPlanFileShape } from "./runner/advertised-writable-dirs.js";
|
|
12
|
+
import { normalizeSeatDeps } from "./runner/classifier-ladder.js";
|
|
13
|
+
import { rosterFaceOf } from "./runner/caller-roster.js";
|
|
14
|
+
import { readToolSelector } from "./runner/sub-agent-deny-lists.js";
|
|
15
|
+
import { StubExecutionEnv } from "./stub-env.js";
|
|
16
|
+
import { readToolFaceLists } from "./tool-face-lists.js";
|
|
17
|
+
import { applyToolModelGate } from "./tool-model-gate.js";
|
|
18
|
+
import { envMountFacts, offloadSeatFact, offloadThresholdsOf, questionSeatFact, seatMountFacts, specMountFacts, } from "./tool-mount-facts.js";
|
|
19
|
+
import { TOOL_MOUNT_FACTS, mountGroupNames, planToolMounts, } from "./tool-mount-plan.js";
|
|
20
|
+
import { OFFLOAD_TOOL_NAME } from "./tool-result-store.js";
|
|
21
|
+
import { callerMountSource, planIdentityOf } from "./tool-roster.js";
|
|
22
|
+
function anyOf(values) {
|
|
23
|
+
if (values.includes(true))
|
|
24
|
+
return true;
|
|
25
|
+
return values.includes(undefined) ? undefined : false;
|
|
26
|
+
}
|
|
27
|
+
function callerEntries(deps, spec, lists) {
|
|
28
|
+
const handed = Array.isArray(spec.tools) ? spec.tools : [];
|
|
29
|
+
const faces = [];
|
|
30
|
+
handed.forEach((t, i) => {
|
|
31
|
+
const face = rosterFaceOf(t, i);
|
|
32
|
+
if (((typeof face === "object" && face !== null) || typeof face === "function") && typeof face.name === "string")
|
|
33
|
+
faces.push(face);
|
|
34
|
+
});
|
|
35
|
+
const catalogDeps = normalizeSeatDeps(deps);
|
|
36
|
+
const modelId = (() => {
|
|
37
|
+
if (spec.model !== undefined || spec.modelRole !== undefined)
|
|
38
|
+
return resolveTaskModel(spec, catalogDeps).model.id;
|
|
39
|
+
try {
|
|
40
|
+
return resolveTaskModel(spec, catalogDeps).model.id;
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
return undefined;
|
|
44
|
+
}
|
|
45
|
+
})();
|
|
46
|
+
if (modelId === undefined)
|
|
47
|
+
return faces.map((face) => ({ face, kept: face.modelGate === undefined ? true : undefined }));
|
|
48
|
+
const decision = applyToolModelGate({ tools: faces, modelId, depsSeat: deps.toolModelGate, restoreGated: lists.restoreGated, envRaw: process.env.SEMA_TOOL_MODEL_GATE });
|
|
49
|
+
const survivors = decision.survivors === undefined ? undefined : new Set(decision.survivors);
|
|
50
|
+
return faces.map((face) => ({ face, kept: survivors === undefined || survivors.has(face) }));
|
|
51
|
+
}
|
|
52
|
+
const entryIdentity = (face) => (face.aliases === undefined ? { name: face.name } : { name: face.name, aliases: face.aliases });
|
|
53
|
+
function callerMembers(entries, leaves) {
|
|
54
|
+
const rank = (e) => (leaves(entryIdentity(e.face)) ? 3 : 0) + (e.kept === true ? 2 : e.kept === undefined ? 1 : 0);
|
|
55
|
+
const byName = new Map();
|
|
56
|
+
for (const e of entries) {
|
|
57
|
+
const had = byName.get(e.face.name);
|
|
58
|
+
if (had === undefined || rank(e) >= rank(had)) {
|
|
59
|
+
byName.delete(e.face.name);
|
|
60
|
+
byName.set(e.face.name, e);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
return [...byName.values()].map(({ face }) => ({
|
|
64
|
+
family: "caller",
|
|
65
|
+
identity: entryIdentity(face),
|
|
66
|
+
...planIdentityOf(face, callerMountSource(face)),
|
|
67
|
+
mountedBy: "scenario",
|
|
68
|
+
when: { kept: face.name },
|
|
69
|
+
}));
|
|
70
|
+
}
|
|
71
|
+
function legFacts(deps, spec) {
|
|
72
|
+
const facts = { "runner.self": true, "leg.parentNotify": false, "leg.session": true };
|
|
73
|
+
if (deps.peerDirectory === undefined || deps.mailboxStore === undefined)
|
|
74
|
+
facts["leg.peerLane"] = false;
|
|
75
|
+
else if (deps.sessionStore !== undefined) {
|
|
76
|
+
const verdict = judgePeerLaneMount(deps, spec.sessionId, deps.sessionStore);
|
|
77
|
+
if (verdict?.ok !== true)
|
|
78
|
+
facts["leg.peerLane"] = false;
|
|
79
|
+
else if (spec.sessionId !== undefined)
|
|
80
|
+
facts["leg.peerLane"] = true;
|
|
81
|
+
}
|
|
82
|
+
if (deps.mailboxStore === undefined)
|
|
83
|
+
facts["leg.taskNotification"] = false;
|
|
84
|
+
return facts;
|
|
85
|
+
}
|
|
86
|
+
function envFacts(deps) {
|
|
87
|
+
if (deps.executionEnvFactory !== undefined)
|
|
88
|
+
return deps.executionEnv !== undefined ? { "env.hands": true } : {};
|
|
89
|
+
return envMountFacts(deps.executionEnv !== undefined, deps.executionEnv ?? new StubExecutionEnv());
|
|
90
|
+
}
|
|
91
|
+
function seatFacts(deps, spec, leavesOffloadReader) {
|
|
92
|
+
const checkpoint = resolveCheckpointStore(spec, deps) !== undefined;
|
|
93
|
+
const facts = {
|
|
94
|
+
"seat.checkpoint": checkpoint,
|
|
95
|
+
"seat.offload": offloadSeatFact(offloadThresholdsOf(spec, deps).effective) && leavesOffloadReader,
|
|
96
|
+
"seat.offloadBytes": offloadSeatFact(offloadThresholdsOf(spec, deps).effective) && deps.toolResultStore?.bytesOf !== undefined,
|
|
97
|
+
};
|
|
98
|
+
const question = questionSeatFact({
|
|
99
|
+
face: (spec.onQuestion ?? deps.onQuestion) !== undefined,
|
|
100
|
+
parkStore: checkpoint,
|
|
101
|
+
forceDurableGate: deps.runtimeCapsResolver === undefined ? false : undefined,
|
|
102
|
+
durableApprovalDeclared: spec.durableApproval !== undefined,
|
|
103
|
+
approvalParkNotResumable: false,
|
|
104
|
+
});
|
|
105
|
+
if (question !== undefined)
|
|
106
|
+
facts["seat.question"] = question;
|
|
107
|
+
if (normalizeMemorySpec(spec.memory)?.enabled !== true || deps.memoryBackend === undefined)
|
|
108
|
+
facts["seat.memoryEngine"] = false;
|
|
109
|
+
if (deps.runtimeCapsResolver === undefined)
|
|
110
|
+
facts["caps.allowWorkflows"] = true;
|
|
111
|
+
return facts;
|
|
112
|
+
}
|
|
113
|
+
function protocolReading(preflight, leavesPeer) {
|
|
114
|
+
const families = [];
|
|
115
|
+
for (const s of preflight?.mcp ?? [])
|
|
116
|
+
if (leavesPeer(mintNamespacePrefix(MCP_NAMESPACE, s.name)))
|
|
117
|
+
families.push({ source: "mcp", peer: s.name, state: "conditional", when: ["listing.mcp"] });
|
|
118
|
+
for (const p of preflight?.a2a ?? [])
|
|
119
|
+
if (leavesPeer(mintNamespacePrefix(A2A_NAMESPACE, p.name)))
|
|
120
|
+
families.push({ source: "a2a", peer: p.name, state: "conditional", when: ["listing.a2a"] });
|
|
121
|
+
const members = (preflight?.mcp?.length ?? 0) > 0
|
|
122
|
+
? MCP_RESOURCE_FACES.map((name) => ({ family: "mcp-resources", identity: { name }, source: "mcp", mountedBy: "optional", when: { fact: "listing.mcp.resources" } }))
|
|
123
|
+
: [];
|
|
124
|
+
return { families, members };
|
|
125
|
+
}
|
|
126
|
+
export function planStaticToolMounts(deps, spec) {
|
|
127
|
+
const mode = refusePermissionModeDoors(spec) ?? "default";
|
|
128
|
+
const moded = withModeSeats(spec, mode);
|
|
129
|
+
checkedPlanFileShape(spec.planFile);
|
|
130
|
+
const lists = readToolFaceLists(spec);
|
|
131
|
+
const selector = readToolSelector({
|
|
132
|
+
layers: [{ ...(lists.allow !== undefined ? { allow: lists.allow } : {}), deny: lists.exclude ?? [] }],
|
|
133
|
+
where: undefined,
|
|
134
|
+
legs: spec.outputSchema !== undefined ? ["structured"] : [],
|
|
135
|
+
});
|
|
136
|
+
const leaves = valveLeaves(spec, selector);
|
|
137
|
+
const preflight = spec.mcp !== undefined || spec.a2a !== undefined ? preflightLockedConfig(spec, deps) : undefined;
|
|
138
|
+
const entries = callerEntries(deps, spec, lists);
|
|
139
|
+
const protocol = protocolReading(preflight, valveLeavesPeer(spec, selector));
|
|
140
|
+
const facts = new Map();
|
|
141
|
+
const state = (record) => {
|
|
142
|
+
for (const f of TOOL_MOUNT_FACTS) {
|
|
143
|
+
const v = record[f];
|
|
144
|
+
if (v !== undefined)
|
|
145
|
+
facts.set(f, v);
|
|
146
|
+
}
|
|
147
|
+
};
|
|
148
|
+
state(specMountFacts(moded));
|
|
149
|
+
state(seatMountFacts(deps, spec));
|
|
150
|
+
state(envFacts(deps));
|
|
151
|
+
state(legFacts(deps, spec));
|
|
152
|
+
state(seatFacts(deps, spec, leaves({ name: OFFLOAD_TOOL_NAME })));
|
|
153
|
+
state({ "spec.planFile": spec.planFile !== undefined, "spec.mcp": (preflight?.mcp?.length ?? 0) > 0 });
|
|
154
|
+
const declared = (name, viaAlias) => anyOf(entries.filter((e) => e.face.name === name || (viaAlias && e.face.aliases?.includes(name) === true)).map((e) => e.kept));
|
|
155
|
+
const occupied = (names) => anyOf(names.map((n) => declared(n, true)));
|
|
156
|
+
const sharedOccupied = occupied(mountGroupNames("sharedMemory"));
|
|
157
|
+
const engineOccupied = occupied(mountGroupNames("memoryEngine"));
|
|
158
|
+
if (sharedOccupied !== undefined)
|
|
159
|
+
facts.set("names.occupied.sharedMemory", sharedOccupied);
|
|
160
|
+
if (engineOccupied !== undefined)
|
|
161
|
+
facts.set("names.occupied.memoryEngine", engineOccupied);
|
|
162
|
+
const src = {
|
|
163
|
+
fact: (f) => facts.get(f),
|
|
164
|
+
valve: (identity) => leaves(identity),
|
|
165
|
+
declared,
|
|
166
|
+
kept: (name) => {
|
|
167
|
+
const named = entries.filter((e) => e.face.name === name);
|
|
168
|
+
const left = named.filter((e) => leaves(entryIdentity(e.face)));
|
|
169
|
+
return anyOf((left.length > 0 ? left : named).map((e) => e.kept));
|
|
170
|
+
},
|
|
171
|
+
retracted: () => undefined,
|
|
172
|
+
};
|
|
173
|
+
return planToolMounts(src, [...callerMembers(entries, leaves), ...protocol.members], protocol.families);
|
|
174
|
+
}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { type ProtocolNamespace } from "./protocol-table.js";
|
|
2
|
+
import type { PolicyNameLayer } from "./retired-tool-name-account.js";
|
|
2
3
|
import type { RuleBehavior } from "./permission-rule-model.js";
|
|
3
4
|
export declare const RETIRED_TOOL_NAMES: ReadonlyMap<string, string>;
|
|
4
5
|
/** The four answers {@link judgeRuleToolName} gives — a closed set. */
|
|
@@ -101,7 +102,7 @@ export declare function judgeRuleToolName(name: string, roster: ReadonlySet<stri
|
|
|
101
102
|
* after a list is read) and a protocol tool's (a refresh mounts and unmounts them while the run goes on) — in both the exact
|
|
102
103
|
* spelling can be the right one by the time it matters. Every station that asks "is this name a case twin of a carried tool" reads
|
|
103
104
|
* this answer: an entry list and the persisted grammar's whole-tool rule through {@link toolNameFaultOf}, and a tool policy's name
|
|
104
|
-
* lists (the prepare-time policy-name audit, which reads two rosters and skips an inherited layer)
|
|
105
|
+
* lists through {@link judgePolicyEntryName} (the prepare-time policy-name audit, which reads two rosters and skips an inherited layer).
|
|
105
106
|
*/
|
|
106
107
|
export declare function nearMissSpellingOf(name: string, roster: ReadonlySet<string>): string | undefined;
|
|
107
108
|
/** What {@link toolNameFaultOf} finds wrong with a rule's tool name: the judgment's stale words (`tool_name`, with the verdict and
|
|
@@ -122,9 +123,66 @@ export type ToolNameFault = {
|
|
|
122
123
|
* `undefined` = no fault: the name is carried, or nothing carried is another spelling of it. A name the roster simply does not
|
|
123
124
|
* carry is silent: a tool of that name may be mounted later, and a list shared across runs is not wrong because one run lacks a
|
|
124
125
|
* tool. A list entry (`readRuleEntry`) and a stored whole-tool rule (`parseRuleText`) read a name through this and nothing else;
|
|
125
|
-
*
|
|
126
|
+
* a tool policy's lists at prepare read the same two steps over two rosters through {@link judgePolicyEntryName}.
|
|
126
127
|
*/
|
|
127
128
|
export declare function toolNameFaultOf(name: string, roster: ReadonlySet<string>, behavior: RuleBehavior | undefined): ToolNameFault | undefined;
|
|
129
|
+
/**
|
|
130
|
+
* The names a tool policy's lists are read against at prepare: `known` the tools this run can CALL (the judgment's roster), `rootFacing`
|
|
131
|
+
* what another spelling of an entry is asked of — the run's own tools, the caller's, the pools its delegation tools hand their children
|
|
132
|
+
* and the engine's catalog — and `carrierOf` where a carried spelling is found (read back into the refusal's sentence).
|
|
133
|
+
*/
|
|
134
|
+
export interface PolicyNameUniverse {
|
|
135
|
+
readonly known: ReadonlySet<string>;
|
|
136
|
+
readonly rootFacing: ReadonlySet<string>;
|
|
137
|
+
readonly carrierOf: (spelling: string) => "run" | "pool" | "catalog";
|
|
138
|
+
}
|
|
139
|
+
/** What a policy-list entry's name is when it is not clear: a word of the name judgment, or another spelling of a carried tool. */
|
|
140
|
+
export type StaleEntryName = Exclude<RuleToolNameVerdict, {
|
|
141
|
+
readonly kind: "current";
|
|
142
|
+
}> | {
|
|
143
|
+
readonly kind: "case_twin";
|
|
144
|
+
readonly twin: string;
|
|
145
|
+
readonly carrier: "run" | "pool" | "catalog";
|
|
146
|
+
};
|
|
147
|
+
/**
|
|
148
|
+
* What the prepare-time audit does with one entry of a tool policy's `deny` / `ask` / `allow` list ({@link judgePolicyEntryName}):
|
|
149
|
+
* - `clear` — the name is none of the stale words; whether it matches a tool THIS run is the audit's separate advisory;
|
|
150
|
+
* - `refused` — a name that reaches no tool and whose being left alone would WIDEN the surface (a retired name with a successor, an
|
|
151
|
+
* unprefixed namespace, an unmintable segment, a case twin of a carried tool): the run is refused, `stale` says what to write;
|
|
152
|
+
* - `advised` — the same on an `allow` list, where matching nothing grants nothing and the policy is narrower than written: the entry stays
|
|
153
|
+
* and the person is told (a retired name with its retirement line, a name that reads as more than one server's);
|
|
154
|
+
* - `left_out` — a name the engine retired with no successor on a restricting list: it names no tool in any roster, now or later, so the entry
|
|
155
|
+
* is left out and told once as the retired-name notice (`field` is the list, `guidance` the retirement table's line).
|
|
156
|
+
*/
|
|
157
|
+
export type PolicyEntryNameReading = {
|
|
158
|
+
readonly kind: "clear";
|
|
159
|
+
} | {
|
|
160
|
+
readonly kind: "refused";
|
|
161
|
+
readonly stale: StaleEntryName;
|
|
162
|
+
} | {
|
|
163
|
+
readonly kind: "advised";
|
|
164
|
+
readonly stale: Extract<RuleToolNameVerdict, {
|
|
165
|
+
readonly kind: "retired" | "unmintable_segment";
|
|
166
|
+
}>;
|
|
167
|
+
} | {
|
|
168
|
+
readonly kind: "left_out";
|
|
169
|
+
readonly field: "deny" | "ask";
|
|
170
|
+
readonly guidance: string;
|
|
171
|
+
};
|
|
172
|
+
/**
|
|
173
|
+
* THE reading of one entry of a tool policy's name lists, the one question the prepare-time audit asks of every entry of the run's own
|
|
174
|
+
* policy, of the rules its session stored and of the rules an ancestor's session handed it: the name judgment ({@link judgeRuleToolName}) over
|
|
175
|
+
* `known`, then — for a name it calls current, or a retired one with no successor on a restricting list — whether the root-facing universe
|
|
176
|
+
* carries another spelling of it (a case twin, {@link nearMissSpellingOf}); an inherited layer (`ancestor_session_rules`) was asked of the
|
|
177
|
+
* roster of the ancestor that wrote it and is not asked of this leg's again. The answer is what the audit DOES with the entry, so no station
|
|
178
|
+
* keeps a second criterion for it.
|
|
179
|
+
*
|
|
180
|
+
* Which station reads which: an entry list (`readRuleEntry` / `compileAllowList` — a task's tool-name lists, a skill's table, a definition's
|
|
181
|
+
* denied tools) and a stored whole-tool rule (`parseRuleText`) read one roster through {@link toolNameFaultOf}; a tool policy's lists at
|
|
182
|
+
* prepare read this, over two rosters (an entry list's single roster cannot say whether a case twin is the run's own tool, a delegation pool's
|
|
183
|
+
* or the catalog's). All three answer from {@link judgeRuleToolName} and {@link nearMissSpellingOf}; only the disposition differs.
|
|
184
|
+
*/
|
|
185
|
+
export declare function judgePolicyEntryName(name: string, list: RuleBehavior, universe: PolicyNameUniverse, layer: PolicyNameLayer): PolicyEntryNameReading;
|
|
128
186
|
/** The two kinds of tool-name miss — a closed set. `unknown`: the name is none the engine ever mounted (a typo, a
|
|
129
187
|
* guess). `expected-absent`: the name is one the engine RETIRED ({@link RETIRED_TOOL_NAMES}), so its absence is no
|
|
130
188
|
* surprise and the table says what replaced it (the reference spells the same two words for its render-time miss). */
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { carriesNamespaceSeparator, MCP_NAMESPACE, protocolOf } from "./protocol-table.js";
|
|
2
|
-
import { mintNamespacePrefix } from "./protocol-naming.js";
|
|
2
|
+
import { mintKeepsPeerName, mintNamespacePrefix } from "./protocol-naming.js";
|
|
3
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
3
4
|
import { catalogToolNames } from "./tool-registry.js";
|
|
4
5
|
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)";
|
|
5
6
|
export const RETIRED_TOOL_NAMES = new Map([
|
|
@@ -106,12 +107,16 @@ function unmintableSegmentOf(split, behavior) {
|
|
|
106
107
|
const minted = mintNamespacePrefix(ns, peer).slice(ns.prefix.length, -NAMESPACE_SEPARATOR.length);
|
|
107
108
|
if (minted === peer)
|
|
108
109
|
return undefined;
|
|
110
|
+
const guidance = mintKeepsPeerName(ns, peer)
|
|
111
|
+
? `the ${ns.id} peer segment ${JSON.stringify(peer)} is not a spelling the engine mints — its tools are named ${ns.prefix}${minted}${NAMESPACE_SEPARATOR}<tool>, and a rule's peer segment must be spelled the way its tools are`
|
|
112
|
+
: `the ${ns.id} peer segment ${JSON.stringify(inlineUntrusted(peer, UNMINTABLE_PEER_SHOWN))} cannot stand in a tool name as written (it is longer than a tool name allows, or made of characters a tool name cannot carry), so the engine names this peer's tools with a shortened segment ending in a digest — and a rule's peer segment must be spelled the way its tools are`;
|
|
109
113
|
return {
|
|
110
114
|
kind: "unmintable_segment",
|
|
111
|
-
guidance
|
|
115
|
+
guidance,
|
|
112
116
|
currentName: `${ns.prefix}${minted}${tool !== undefined ? `${NAMESPACE_SEPARATOR}${tool}` : ""}`,
|
|
113
117
|
};
|
|
114
118
|
}
|
|
119
|
+
const UNMINTABLE_PEER_SHOWN = 48;
|
|
115
120
|
function ambiguousServerSpellingOf(name, roster) {
|
|
116
121
|
const readings = peerReadingsOf(name);
|
|
117
122
|
if (readings.length === 0)
|
|
@@ -177,6 +182,21 @@ export function toolNameFaultOf(name, roster, behavior) {
|
|
|
177
182
|
const mounted = nearMissSpellingOf(name, roster);
|
|
178
183
|
return mounted === undefined ? undefined : { reason: "near_miss", currentName: mounted };
|
|
179
184
|
}
|
|
185
|
+
const CLEAR_ENTRY = Object.freeze({ kind: "clear" });
|
|
186
|
+
export function judgePolicyEntryName(name, list, universe, layer) {
|
|
187
|
+
const verdict = judgeRuleToolName(name, universe.known, list);
|
|
188
|
+
const asksTwin = verdict.kind === "current" || (verdict.kind === "retired" && verdict.currentName === undefined && list !== "allow");
|
|
189
|
+
const twin = asksTwin && layer !== "ancestor_session_rules" ? nearMissSpellingOf(name, universe.rootFacing) : undefined;
|
|
190
|
+
if (twin !== undefined)
|
|
191
|
+
return { kind: "refused", stale: { kind: "case_twin", twin, carrier: universe.carrierOf(twin) } };
|
|
192
|
+
if (verdict.kind === "current")
|
|
193
|
+
return CLEAR_ENTRY;
|
|
194
|
+
if (list === "allow")
|
|
195
|
+
return verdict.kind === "retired" || (verdict.kind === "unmintable_segment" && verdict.ambiguous === true) ? { kind: "advised", stale: verdict } : { kind: "refused", stale: verdict };
|
|
196
|
+
if (verdict.kind === "retired" && verdict.currentName === undefined)
|
|
197
|
+
return { kind: "left_out", field: list, guidance: verdict.guidance };
|
|
198
|
+
return { kind: "refused", stale: verdict };
|
|
199
|
+
}
|
|
180
200
|
export const TOOL_MISS_KINDS = Object.freeze(["unknown", "expected-absent"]);
|
|
181
201
|
const [UNKNOWN_MISS, ABSENT_MISS] = TOOL_MISS_KINDS;
|
|
182
202
|
export function judgeToolNameMiss(name, roster) {
|
|
@@ -3,6 +3,9 @@
|
|
|
3
3
|
* a tool's alias list, a model-id list). The judge before the run, the spawn-time filter, the memory content-origin face and the
|
|
4
4
|
* roster snapshot all meet a list through here, so a hostile container is answered once and the same way everywhere.
|
|
5
5
|
*/
|
|
6
|
+
/** The two tool-name lists of a definition — the side a list is on decides what its entries do (an allowed one admits, a denied
|
|
7
|
+
* one removes). */
|
|
8
|
+
export type ToolNameListSide = "allowed" | "denied";
|
|
6
9
|
/** A fixed label of a host value's TYPE for a sentence that must not print or convert the value (`typeof` and the array test only). */
|
|
7
10
|
export declare function valueTypeLabel(value: unknown): string;
|
|
8
11
|
/**
|
|
@@ -69,6 +69,10 @@ export declare const NAME_READINGS: {
|
|
|
69
69
|
readonly kind: "wire";
|
|
70
70
|
readonly file: string;
|
|
71
71
|
};
|
|
72
|
+
readonly "commandSandbox.plan.hand": {
|
|
73
|
+
readonly kind: "wire";
|
|
74
|
+
readonly file: string;
|
|
75
|
+
};
|
|
72
76
|
readonly "gate.preToolUse": {
|
|
73
77
|
readonly kind: "wire";
|
|
74
78
|
readonly file: string;
|
|
@@ -18,6 +18,7 @@ export const NAME_READINGS = {
|
|
|
18
18
|
"gate.shellSeat": seat("tier", GATE),
|
|
19
19
|
"gate.sandboxBoundary.egress": any(CHAIN),
|
|
20
20
|
"gate.sandboxBoundary.hand": wire(CHAIN),
|
|
21
|
+
"commandSandbox.plan.hand": wire("src/core/command-sandbox.ts"),
|
|
21
22
|
"gate.preToolUse": wire("src/core/hooks.ts"),
|
|
22
23
|
"gate.askFace": wire("src/core/runner/gate-exit.ts"),
|
|
23
24
|
"fold.readStation": seat("member", "src/tools/fs/shell-read-check.ts"),
|