@sema-agent/core 7.66.1 → 7.67.1
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 +3518 -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 +169 -0
- package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
- package/dist/core/roles.js +148 -21
- 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 +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -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 +19 -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 +126 -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 +64 -34
- package/dist/index.js +45 -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 +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -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,344 @@
|
|
|
1
|
+
import { types } from "node:util";
|
|
2
|
+
import { receive } from "./mods/kernel/receive.js";
|
|
3
|
+
import { commandSandboxPlanInForce } from "./command-sandbox-dispatch.js";
|
|
4
|
+
import { isShellFaceToolName } from "./tool-registry.js";
|
|
5
|
+
import { wireOf } from "./tool-name-readings.js";
|
|
6
|
+
import { providesCommandSandbox } from "./remote-env.js";
|
|
7
|
+
import { deliverEngineNotice } from "./engine-notice.js";
|
|
8
|
+
export const SANDBOX_SETTINGS_INVALID = "config.sandbox_settings_invalid";
|
|
9
|
+
export const COMMAND_SANDBOX_UNAVAILABLE = "config.command_sandbox_unavailable";
|
|
10
|
+
const BOOL = { t: "bool" };
|
|
11
|
+
const STR = { t: "str" };
|
|
12
|
+
const STRINGS = { t: "strings" };
|
|
13
|
+
const PATHS = { t: "strings", paths: true };
|
|
14
|
+
const NO_MATCH = { t: "enum", of: ["warn", "deny", "error"] };
|
|
15
|
+
const MODE = { t: "enum", of: ["deny", "mask"] };
|
|
16
|
+
const SIG = { t: "enum", of: ["deny", "passthrough"] };
|
|
17
|
+
const SETTINGS = {
|
|
18
|
+
t: "obj",
|
|
19
|
+
fields: {
|
|
20
|
+
enabled: BOOL,
|
|
21
|
+
failIfUnavailable: BOOL,
|
|
22
|
+
autoAllowBashIfSandboxed: BOOL,
|
|
23
|
+
allowUnsandboxedCommands: BOOL,
|
|
24
|
+
excludedCommands: STRINGS,
|
|
25
|
+
ignoreViolations: { t: "map", value: PATHS },
|
|
26
|
+
filesystem: { t: "obj", fields: { allowWrite: PATHS, denyWrite: PATHS, denyRead: PATHS, allowRead: PATHS, disabled: BOOL, allowManagedReadPathsOnly: { t: "merge" } } },
|
|
27
|
+
network: {
|
|
28
|
+
t: "obj",
|
|
29
|
+
fields: {
|
|
30
|
+
allowedDomains: STRINGS, deniedDomains: STRINGS, strictAllowlist: BOOL, allowManagedDomainsOnly: { t: "merge" }, allowUnixSockets: PATHS, allowAllUnixSockets: BOOL,
|
|
31
|
+
allowLocalBinding: BOOL, allowMachLookup: STRINGS, httpProxyPort: { t: "port" }, socksProxyPort: { t: "port" },
|
|
32
|
+
tlsTerminate: { t: "obj", fields: { caCertPath: { t: "abs" }, caKeyPath: { t: "abs" } } },
|
|
33
|
+
},
|
|
34
|
+
},
|
|
35
|
+
credentials: {
|
|
36
|
+
t: "obj",
|
|
37
|
+
fields: {
|
|
38
|
+
files: { t: "list", item: { t: "obj", required: ["path", "mode"], fields: { path: { t: "abs" }, mode: MODE, extract: STR, onExtractNoMatch: NO_MATCH, decode: { t: "enum", of: ["jwt"] }, maskClaims: STRINGS, maskDuplicates: BOOL, injectHosts: STRINGS } } },
|
|
39
|
+
envVars: { t: "list", item: { t: "obj", required: ["name", "mode"], fields: { name: STR, mode: MODE, extract: STR, onExtractNoMatch: NO_MATCH, decode: { t: "enum", of: ["jwt"] }, maskClaims: STRINGS, injectHosts: STRINGS } } },
|
|
40
|
+
allowPlaintextInject: BOOL,
|
|
41
|
+
awsPairs: { t: "list", item: { t: "obj", required: ["accessKeyIdVar", "secretAccessKeyVar"], fields: { accessKeyIdVar: STR, secretAccessKeyVar: STR, sessionTokenVar: STR } } },
|
|
42
|
+
sigv4: { t: "obj", fields: { streaming: SIG, presigned: SIG, sigv4a: SIG } },
|
|
43
|
+
},
|
|
44
|
+
},
|
|
45
|
+
enableWeakerNestedSandbox: BOOL,
|
|
46
|
+
allowNestedUserNamespaces: BOOL,
|
|
47
|
+
enableWeakerNetworkIsolation: BOOL,
|
|
48
|
+
allowAppleEvents: BOOL,
|
|
49
|
+
ripgrep: { t: "obj", required: ["command"], fields: { command: STR, args: STRINGS } },
|
|
50
|
+
bwrapPath: { t: "abs" },
|
|
51
|
+
socatPath: { t: "abs" },
|
|
52
|
+
},
|
|
53
|
+
};
|
|
54
|
+
function settingsInvalid(key, why) {
|
|
55
|
+
const e = new Error(`TaskSpec.sandbox${key === "" ? "" : `.${key}`} ${why} — a sandbox requirement that cannot be read is no requirement, so the run is refused rather than started without it.`);
|
|
56
|
+
e.code = SANDBOX_SETTINGS_INVALID;
|
|
57
|
+
e.detail = { key: key === "" ? "sandbox" : key, reason: why };
|
|
58
|
+
return e;
|
|
59
|
+
}
|
|
60
|
+
const shown = (v) => {
|
|
61
|
+
if (typeof v === "string")
|
|
62
|
+
return JSON.stringify(v.slice(0, 120));
|
|
63
|
+
if (v === null)
|
|
64
|
+
return "null";
|
|
65
|
+
if (Array.isArray(v))
|
|
66
|
+
return "an array";
|
|
67
|
+
return typeof v === "object" ? "an object" : `${typeof v} ${String(v).slice(0, 40)}`;
|
|
68
|
+
};
|
|
69
|
+
function pathProblem(p) {
|
|
70
|
+
if (p.includes("\0"))
|
|
71
|
+
return "holds a NUL character";
|
|
72
|
+
if (p.startsWith("/") || p.startsWith("~/"))
|
|
73
|
+
return undefined;
|
|
74
|
+
return "is not an absolute path or one under the home directory (`~/`): resolve it against the settings file it came from before sending it";
|
|
75
|
+
}
|
|
76
|
+
function judge(value, field, key) {
|
|
77
|
+
switch (field.t) {
|
|
78
|
+
case "merge":
|
|
79
|
+
throw settingsInvalid(key, "is applied by the host when it merges settings sources, and a task's requirement does not carry it");
|
|
80
|
+
case "bool":
|
|
81
|
+
if (typeof value !== "boolean")
|
|
82
|
+
throw settingsInvalid(key, `must be a boolean (got ${shown(value)})`);
|
|
83
|
+
return value;
|
|
84
|
+
case "str":
|
|
85
|
+
if (typeof value !== "string" || value.length === 0)
|
|
86
|
+
throw settingsInvalid(key, `must be a non-empty string (got ${shown(value)})`);
|
|
87
|
+
return value;
|
|
88
|
+
case "abs": {
|
|
89
|
+
if (typeof value !== "string" || value.length === 0)
|
|
90
|
+
throw settingsInvalid(key, `must be a non-empty path (got ${shown(value)})`);
|
|
91
|
+
const problem = pathProblem(value);
|
|
92
|
+
if (problem !== undefined)
|
|
93
|
+
throw settingsInvalid(key, `${shown(value)} ${problem}`);
|
|
94
|
+
return value;
|
|
95
|
+
}
|
|
96
|
+
case "port":
|
|
97
|
+
if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 65535)
|
|
98
|
+
throw settingsInvalid(key, `must be a TCP port, a whole number from 1 to 65535 (got ${shown(value)})`);
|
|
99
|
+
return value;
|
|
100
|
+
case "enum":
|
|
101
|
+
if (typeof value !== "string" || !field.of.includes(value))
|
|
102
|
+
throw settingsInvalid(key, `must be one of ${field.of.map((w) => JSON.stringify(w)).join(", ")} (got ${shown(value)})`);
|
|
103
|
+
return value;
|
|
104
|
+
case "strings": {
|
|
105
|
+
if (!Array.isArray(value))
|
|
106
|
+
throw settingsInvalid(key, `must be an array of strings (got ${shown(value)})`);
|
|
107
|
+
return Array.from(value, (v, i) => judge(v, field.paths === true ? { t: "abs" } : STR, `${key}[${i}]`));
|
|
108
|
+
}
|
|
109
|
+
case "list": {
|
|
110
|
+
if (!Array.isArray(value))
|
|
111
|
+
throw settingsInvalid(key, `must be an array (got ${shown(value)})`);
|
|
112
|
+
return Array.from(value, (v, i) => judge(v, field.item, `${key}[${i}]`));
|
|
113
|
+
}
|
|
114
|
+
case "map": {
|
|
115
|
+
if (typeof value !== "object" || value === null || Array.isArray(value))
|
|
116
|
+
throw settingsInvalid(key, `must be an object of lists (got ${shown(value)})`);
|
|
117
|
+
return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, judge(v, field.value, `${key}[${JSON.stringify(k)}]`)]));
|
|
118
|
+
}
|
|
119
|
+
case "obj": {
|
|
120
|
+
if (typeof value !== "object" || value === null || Array.isArray(value))
|
|
121
|
+
throw settingsInvalid(key, `must be an object (got ${shown(value)})`);
|
|
122
|
+
const out = {};
|
|
123
|
+
for (const [k, v] of Object.entries(value)) {
|
|
124
|
+
const member = Object.hasOwn(field.fields, k) ? field.fields[k] : undefined;
|
|
125
|
+
const at = key === "" ? k : `${key}.${k}`;
|
|
126
|
+
if (member === undefined)
|
|
127
|
+
throw settingsInvalid(at, "is not a member of the sandbox settings");
|
|
128
|
+
if (v === undefined)
|
|
129
|
+
continue;
|
|
130
|
+
out[k] = judge(v, member, at);
|
|
131
|
+
}
|
|
132
|
+
for (const k of field.required ?? [])
|
|
133
|
+
if (out[k] === undefined)
|
|
134
|
+
throw settingsInvalid(key === "" ? k : `${key}.${k}`, "is required");
|
|
135
|
+
return out;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
function resolvePaths(value, field, key, home) {
|
|
140
|
+
switch (field.t) {
|
|
141
|
+
case "abs":
|
|
142
|
+
return resolvedPath(String(value), key, home);
|
|
143
|
+
case "strings":
|
|
144
|
+
return field.paths === true && Array.isArray(value) ? value.map((p, i) => resolvedPath(String(p), `${key}[${i}]`, home)) : value;
|
|
145
|
+
case "list":
|
|
146
|
+
return Array.isArray(value) ? value.map((v, i) => resolvePaths(v, field.item, `${key}[${i}]`, home)) : value;
|
|
147
|
+
case "map":
|
|
148
|
+
return typeof value === "object" && value !== null ? Object.fromEntries(Object.entries(value).map(([k, v]) => [k, resolvePaths(v, field.value, `${key}[${JSON.stringify(k)}]`, home)])) : value;
|
|
149
|
+
case "obj":
|
|
150
|
+
return typeof value === "object" && value !== null
|
|
151
|
+
? Object.fromEntries(Object.entries(value).map(([k, v]) => [k, Object.hasOwn(field.fields, k) ? resolvePaths(v, field.fields[k], key === "" ? k : `${key}.${k}`, home) : v]))
|
|
152
|
+
: value;
|
|
153
|
+
default:
|
|
154
|
+
return value;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
export function receiveTaskSandbox(value) {
|
|
158
|
+
if (value === undefined)
|
|
159
|
+
return undefined;
|
|
160
|
+
const prior = typeof value === "object" && value !== null ? RECEIVED_REQUIREMENTS.get(value) : undefined;
|
|
161
|
+
if (prior !== undefined)
|
|
162
|
+
return prior;
|
|
163
|
+
const received = receive(value, { accessors: "call-once", depth: 6, others: "refuse", past: "refuse", isProxy: (v) => types.isProxy(v) });
|
|
164
|
+
if (!received.ok)
|
|
165
|
+
throw settingsInvalid(received.fault.path.join("."), `cannot be received as data (${received.fault.kind})`);
|
|
166
|
+
const judged = deepFreeze(judge(received.value, SETTINGS, ""));
|
|
167
|
+
if (typeof value === "object" && value !== null)
|
|
168
|
+
RECEIVED_REQUIREMENTS.set(value, judged);
|
|
169
|
+
return judged;
|
|
170
|
+
}
|
|
171
|
+
const RECEIVED_REQUIREMENTS = new WeakMap();
|
|
172
|
+
function deepFreeze(v) {
|
|
173
|
+
if (typeof v === "object" && v !== null && !Object.isFrozen(v)) {
|
|
174
|
+
for (const m of Object.values(v))
|
|
175
|
+
deepFreeze(m);
|
|
176
|
+
Object.freeze(v);
|
|
177
|
+
}
|
|
178
|
+
return v;
|
|
179
|
+
}
|
|
180
|
+
const OFF = Object.freeze({ state: "off" });
|
|
181
|
+
export function judgeCommandSandbox(j) {
|
|
182
|
+
const settings = receiveTaskSandbox(j.requirement);
|
|
183
|
+
if (settings === undefined || settings.enabled !== true)
|
|
184
|
+
return OFF;
|
|
185
|
+
const failIfUnavailable = settings.failIfUnavailable ?? true;
|
|
186
|
+
if (!providesCommandSandbox(j.env)) {
|
|
187
|
+
const reason = "the execution environment does not declare a command sandbox (capabilities.commandSandbox is not true)";
|
|
188
|
+
if (failIfUnavailable) {
|
|
189
|
+
const e = new Error(`sandbox required but unavailable: ${reason} — sandbox.failIfUnavailable is set, so the run is refused rather than started without a working sandbox. Run it on an environment that keeps a command sandbox, or set sandbox.failIfUnavailable to false to run without one.`);
|
|
190
|
+
e.code = COMMAND_SANDBOX_UNAVAILABLE;
|
|
191
|
+
throw e;
|
|
192
|
+
}
|
|
193
|
+
deliverEngineNotice(j.onNotice, {
|
|
194
|
+
code: COMMAND_SANDBOX_UNAVAILABLE,
|
|
195
|
+
message: `Sandbox disabled: ${reason}. Commands will run WITHOUT sandboxing: the network and filesystem restrictions of sandbox will NOT be enforced.`,
|
|
196
|
+
detail: { reason, ...(j.attribution?.sessionId !== undefined ? { sessionId: j.attribution.sessionId } : {}), ...(j.attribution?.runId !== undefined ? { runId: j.attribution.runId } : {}) },
|
|
197
|
+
});
|
|
198
|
+
return Object.freeze({ state: "unavailable", reason });
|
|
199
|
+
}
|
|
200
|
+
return Object.freeze({ state: "armed", requirement: instructionOf(settings, j.home) });
|
|
201
|
+
}
|
|
202
|
+
function resolvedPath(p, key, home) {
|
|
203
|
+
if (!p.startsWith("~/"))
|
|
204
|
+
return p;
|
|
205
|
+
if (home === undefined || !home.startsWith("/"))
|
|
206
|
+
throw settingsInvalid(key, `${shown(p)} is under the home directory, and the execution environment states no absolute home directory to read it against`);
|
|
207
|
+
return `${home.replace(/\/+$/, "")}/${p.slice(2)}`;
|
|
208
|
+
}
|
|
209
|
+
function instructionOf(judged, home) {
|
|
210
|
+
const s = resolvePaths(judged, SETTINGS, "", home);
|
|
211
|
+
const fsPaths = (k) => [...(s.filesystem?.[k] ?? [])];
|
|
212
|
+
const { allowedDomains: _a, deniedDomains: _d, strictAllowlist: _s, ...networkMechanism } = s.network ?? {};
|
|
213
|
+
const mechanism = {
|
|
214
|
+
...(s.filesystem?.disabled !== undefined ? { filesystem: { disabled: s.filesystem.disabled } } : {}),
|
|
215
|
+
...(Object.keys(networkMechanism).length > 0 ? { network: networkMechanism } : {}),
|
|
216
|
+
...(s.credentials !== undefined ? { credentials: s.credentials } : {}),
|
|
217
|
+
...(s.enableWeakerNestedSandbox !== undefined ? { enableWeakerNestedSandbox: s.enableWeakerNestedSandbox } : {}),
|
|
218
|
+
...(s.allowNestedUserNamespaces !== undefined ? { allowNestedUserNamespaces: s.allowNestedUserNamespaces } : {}),
|
|
219
|
+
...(s.enableWeakerNetworkIsolation !== undefined ? { enableWeakerNetworkIsolation: s.enableWeakerNetworkIsolation } : {}),
|
|
220
|
+
...(s.allowAppleEvents !== undefined ? { allowAppleEvents: s.allowAppleEvents } : {}),
|
|
221
|
+
...(s.ripgrep !== undefined ? { ripgrep: s.ripgrep } : {}),
|
|
222
|
+
...(s.bwrapPath !== undefined ? { bwrapPath: s.bwrapPath } : {}),
|
|
223
|
+
...(s.socatPath !== undefined ? { socatPath: s.socatPath } : {}),
|
|
224
|
+
};
|
|
225
|
+
return deepFreeze({
|
|
226
|
+
boundary: {
|
|
227
|
+
filesystem: { allowWrite: fsPaths("allowWrite"), denyWrite: fsPaths("denyWrite"), denyRead: fsPaths("denyRead"), allowRead: fsPaths("allowRead") },
|
|
228
|
+
network: { allowedDomains: [...(s.network?.allowedDomains ?? [])], deniedDomains: [...(s.network?.deniedDomains ?? [])] },
|
|
229
|
+
},
|
|
230
|
+
mechanism: structuredClone(mechanism),
|
|
231
|
+
});
|
|
232
|
+
}
|
|
233
|
+
const NO_PLAN = Object.freeze({ kind: "none" });
|
|
234
|
+
export function commandSandboxPlan(run, call, envHandToolNames, writeRoots) {
|
|
235
|
+
if (run.state !== "armed" || !envHandToolNames.has(wireOf("commandSandbox.plan.hand", call)) || !isShellFaceToolName(call.toolName))
|
|
236
|
+
return NO_PLAN;
|
|
237
|
+
const { boundary, mechanism } = run.requirement;
|
|
238
|
+
const allowWrite = Object.freeze([...new Set([...writeRoots(), ...boundary.filesystem.allowWrite])]);
|
|
239
|
+
const instruction = Object.freeze({ boundary: Object.freeze({ filesystem: Object.freeze({ ...boundary.filesystem, allowWrite }), network: boundary.network }), mechanism });
|
|
240
|
+
return Object.freeze({ kind: "command", instruction });
|
|
241
|
+
}
|
|
242
|
+
const REFUSED_START = Object.freeze({ ok: false });
|
|
243
|
+
export function commandSandboxSeat(run) {
|
|
244
|
+
if (run.state !== "armed")
|
|
245
|
+
return undefined;
|
|
246
|
+
return () => {
|
|
247
|
+
const plan = commandSandboxPlanInForce();
|
|
248
|
+
return plan?.kind === "command" ? { ok: true, sandbox: plan.instruction } : REFUSED_START;
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
export function sandboxRefusalText(toolName, refusal) {
|
|
252
|
+
const head = `Error (${toolName.slice(0, 64)}): the command was not run`;
|
|
253
|
+
if (refusal.by === "gate")
|
|
254
|
+
return `${head}: the run requires an OS sandbox for its commands and this call carries no sandbox plan (it was not let go by the run's gate).`;
|
|
255
|
+
const tail = refusal.refusedBy === "this_call"
|
|
256
|
+
? "The environment cannot keep an entry of this command's sandbox boundary; a command whose boundary it can keep still runs."
|
|
257
|
+
: "The environment's sandbox is not working, so no command can run sandboxed here; report it rather than retrying.";
|
|
258
|
+
return `${head}: the sandbox could not be enforced for it (${refusal.detail.slice(0, 600)}). ${tail}`;
|
|
259
|
+
}
|
|
260
|
+
const listOf = (v) => (Array.isArray(v) ? v : undefined);
|
|
261
|
+
const literalIntersection = (a, b) => b.filter((x) => (a ?? []).includes(x));
|
|
262
|
+
const union = (a, b) => [...new Set([...(a ?? []), ...(b ?? [])])];
|
|
263
|
+
const NO_MATCH_ORDER = ["warn", "deny", "error"];
|
|
264
|
+
const TIGHTEN_BOOLS = { enabled: false, "network.strictAllowlist": false };
|
|
265
|
+
const LOOSEN_BOOLS = {
|
|
266
|
+
autoAllowBashIfSandboxed: true, allowUnsandboxedCommands: true, "filesystem.disabled": false, enableWeakerNestedSandbox: false, allowNestedUserNamespaces: false,
|
|
267
|
+
enableWeakerNetworkIsolation: false, allowAppleEvents: false, "network.allowAllUnixSockets": false, "network.allowLocalBinding": false, "credentials.allowPlaintextInject": false,
|
|
268
|
+
};
|
|
269
|
+
const DENY_LISTS = ["filesystem.denyWrite", "filesystem.denyRead", "network.deniedDomains"];
|
|
270
|
+
const ALLOW_LISTS = ["filesystem.allowWrite", "filesystem.allowRead", "network.allowedDomains", "network.allowUnixSockets", "network.allowMachLookup", "excludedCommands"];
|
|
271
|
+
const at = (o, path) => path.split(".").reduce((v, k) => (typeof v === "object" && v !== null ? v[k] : undefined), o);
|
|
272
|
+
function put(o, path, value) {
|
|
273
|
+
const keys = path.split(".");
|
|
274
|
+
let cur = o;
|
|
275
|
+
for (const k of keys.slice(0, -1)) {
|
|
276
|
+
if (typeof cur[k] !== "object" || cur[k] === null)
|
|
277
|
+
cur[k] = {};
|
|
278
|
+
cur = cur[k];
|
|
279
|
+
}
|
|
280
|
+
if (value === undefined)
|
|
281
|
+
delete cur[keys[keys.length - 1]];
|
|
282
|
+
else
|
|
283
|
+
cur[keys[keys.length - 1]] = value;
|
|
284
|
+
}
|
|
285
|
+
export function mergeChildSandbox(parent, childValue) {
|
|
286
|
+
const child = receiveTaskSandbox(childValue);
|
|
287
|
+
if (parent === undefined)
|
|
288
|
+
return child;
|
|
289
|
+
if (child === undefined)
|
|
290
|
+
return parent;
|
|
291
|
+
const p = { ...parent };
|
|
292
|
+
const out = structuredClone({ ...parent });
|
|
293
|
+
const stated = (path) => at(child, path) !== undefined;
|
|
294
|
+
const parentBool = (path, absent) => {
|
|
295
|
+
if (path === "failIfUnavailable")
|
|
296
|
+
return typeof p["failIfUnavailable"] === "boolean" ? p["failIfUnavailable"] : p["enabled"] === true;
|
|
297
|
+
const v = at(p, path);
|
|
298
|
+
return typeof v === "boolean" ? v : absent;
|
|
299
|
+
};
|
|
300
|
+
for (const [path, absent] of Object.entries({ ...TIGHTEN_BOOLS, failIfUnavailable: false }))
|
|
301
|
+
if (stated(path))
|
|
302
|
+
put(out, path, parentBool(path, absent) || at(child, path) === true);
|
|
303
|
+
for (const [path, absent] of Object.entries(LOOSEN_BOOLS))
|
|
304
|
+
if (stated(path))
|
|
305
|
+
put(out, path, parentBool(path, absent) && at(child, path) === true);
|
|
306
|
+
for (const path of DENY_LISTS)
|
|
307
|
+
if (stated(path))
|
|
308
|
+
put(out, path, union(listOf(at(p, path)), listOf(at(child, path))));
|
|
309
|
+
for (const path of ALLOW_LISTS)
|
|
310
|
+
if (stated(path))
|
|
311
|
+
put(out, path, literalIntersection(listOf(at(p, path)), listOf(at(child, path)) ?? []));
|
|
312
|
+
if (stated("ignoreViolations")) {
|
|
313
|
+
const pv = (p["ignoreViolations"] ?? {});
|
|
314
|
+
const cv = at(child, "ignoreViolations");
|
|
315
|
+
const merged = {};
|
|
316
|
+
if (typeof cv === "object" && cv !== null)
|
|
317
|
+
for (const [pattern, paths] of Object.entries(cv))
|
|
318
|
+
if (pv[pattern] !== undefined)
|
|
319
|
+
merged[pattern] = literalIntersection(pv[pattern], listOf(paths) ?? []);
|
|
320
|
+
out["ignoreViolations"] = merged;
|
|
321
|
+
}
|
|
322
|
+
for (const [list, key] of [["credentials.files", "path"], ["credentials.envVars", "name"]]) {
|
|
323
|
+
if (!stated(list))
|
|
324
|
+
continue;
|
|
325
|
+
const entries = new Map();
|
|
326
|
+
for (const e of listOf(at(p, list)) ?? [])
|
|
327
|
+
if (typeof e === "object" && e !== null)
|
|
328
|
+
entries.set(e[key], { ...e });
|
|
329
|
+
for (const e of listOf(at(child, list)) ?? []) {
|
|
330
|
+
if (typeof e !== "object" || e === null)
|
|
331
|
+
continue;
|
|
332
|
+
const mine = e;
|
|
333
|
+
const theirs = entries.get(mine[key]);
|
|
334
|
+
if (theirs === undefined) {
|
|
335
|
+
entries.set(mine[key], { ...mine });
|
|
336
|
+
continue;
|
|
337
|
+
}
|
|
338
|
+
const strictest = (a, b) => (NO_MATCH_ORDER.indexOf(String(a ?? "warn")) >= NO_MATCH_ORDER.indexOf(String(b ?? "warn")) ? a : b);
|
|
339
|
+
entries.set(mine[key], { ...theirs, mode: theirs["mode"] === "deny" || mine["mode"] === "deny" ? "deny" : "mask", ...(theirs["onExtractNoMatch"] !== undefined || mine["onExtractNoMatch"] !== undefined ? { onExtractNoMatch: strictest(theirs["onExtractNoMatch"], mine["onExtractNoMatch"]) } : {}) });
|
|
340
|
+
}
|
|
341
|
+
put(out, list, [...entries.values()]);
|
|
342
|
+
}
|
|
343
|
+
return receiveTaskSandbox(out);
|
|
344
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/** Mint the completion identity of `target` ONCE, fill-once (first writer wins): every terminal-transition site calls
|
|
2
|
+
* this instead of writing `completionId` directly, so however many sites a lane has (settle / TaskStop circumvention /
|
|
3
|
+
* backfill / a store-side terminal write), the value is minted exactly once and every later caller — including an
|
|
4
|
+
* idempotent re-call from a path that already ran — gets back the SAME id. The parameter is any object with an
|
|
5
|
+
* optional `completionId`, so one helper serves a registry handle, a `WorkflowRun` and a durable
|
|
6
|
+
* `BackgroundAgentRecord` alike (no shared base type, same fill-once shape). */
|
|
7
|
+
export declare function mintCompletionId(target: {
|
|
8
|
+
completionId?: string;
|
|
9
|
+
}): string;
|
|
10
|
+
/** A completion identity chosen BEFORE it is safe to commit — for a caller whose terminal write is a CAS not yet known to
|
|
11
|
+
* win. The value goes into the durable payload at once (that write only takes effect if its own CAS wins) and onto the
|
|
12
|
+
* live object only through {@link commitCompletionIdIfEmpty}, from the call that already knows the CAS won. */
|
|
13
|
+
export declare function completionIdCandidate(): string;
|
|
14
|
+
/** Sibling of {@link mintCompletionId} for the CAS caller above: fill-once with an EXTERNALLY-chosen value (from
|
|
15
|
+
* {@link completionIdCandidate}) instead of generating a fresh one. Exists because committing a candidate onto a live
|
|
16
|
+
* handle before its durable CAS was confirmed left a losing attempt's id on a non-terminal ("parked") handle that nothing
|
|
17
|
+
* ever cleared, and a later legitimate parked→running flip then carried it into an unrelated real completion through
|
|
18
|
+
* {@link mintCompletionId}'s own fill-once guard. */
|
|
19
|
+
export declare function commitCompletionIdIfEmpty(target: {
|
|
20
|
+
completionId?: string;
|
|
21
|
+
}, value: string): string;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { uuidv7 } from "../internal/harness.js";
|
|
2
|
+
export function mintCompletionId(target) {
|
|
3
|
+
if (target.completionId === undefined)
|
|
4
|
+
target.completionId = uuidv7();
|
|
5
|
+
return target.completionId;
|
|
6
|
+
}
|
|
7
|
+
export function completionIdCandidate() {
|
|
8
|
+
return uuidv7();
|
|
9
|
+
}
|
|
10
|
+
export function commitCompletionIdIfEmpty(target, value) {
|
|
11
|
+
if (target.completionId === undefined)
|
|
12
|
+
target.completionId = value;
|
|
13
|
+
return target.completionId;
|
|
14
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The CONFIG REFUSAL WORDS — every word of the `config.*` / `resume_at.*` family the engine throws as the `code` of a refusal: the one closed
|
|
3
|
+
* set a host holds its status table over (`satisfies Record<ConfigRefusalCode, …>`), so a door that gains a word turns the host `tsc`-red until it
|
|
4
|
+
* places the word, instead of failing in production as a code nobody mapped.
|
|
5
|
+
*
|
|
6
|
+
* Where a word reaches a host: `TaskResult.errorCode` of a run refused at prepare's doors, `detail.code` of a resume's `checkpoint.config_refused`
|
|
7
|
+
* ({@link CHECKPOINT_CONFIG_REFUSAL_CODES} — the subset a resume's pre-claim screen can carry, typed against this set), the thrown error of a library
|
|
8
|
+
* entry that refuses at the same kind of door (the memory engine's requests and scope contract, the MCP probe, the web tool's knobs, the protocol
|
|
9
|
+
* auth head, the containment faces), and the tool-declaration door (`TOOL_DECLARATION_CODES`, also a subset of this set). The set is the NAMESPACE's
|
|
10
|
+
* registry, not the prepare path's: whether a given word is reachable from `runTask` is a fact about the door, which a syntax reader cannot decide,
|
|
11
|
+
* and a word a host never meets costs it one status row.
|
|
12
|
+
*
|
|
13
|
+
* NOT members: a notice word (`ENGINE_NOTICE_CODES`) that is only ever a notice's `code` — a disclosure, never a refusal; a family-shaped string that
|
|
14
|
+
* is no code at all (a trace frame's `kind`, a station name — `scripts/config-refusal-nonwords.json`, each with its reason). A notice word that is ALSO
|
|
15
|
+
* thrown (the retired-tool-name refusal, `config.read_deny_floor_unkept`, `config.tool_model_gate_env_invalid`, the sandbox's
|
|
16
|
+
* `config.command_sandbox_unavailable`) is a member.
|
|
17
|
+
*
|
|
18
|
+
* A CLOSED SET with one home, registered in `docs/CLOSED-SETS.md`; `gate:closed-sets` holds the whole family to it: every family literal under
|
|
19
|
+
* `src/` is a member, a notice word in a notice's `code`, or a ledgered non-word, and every member is still spelled somewhere.
|
|
20
|
+
*/
|
|
21
|
+
export declare const CONFIG_REFUSAL_CODES: readonly ["config.a2a_peer_name_collision", "config.advisor_model_invalid", "config.advisor_tool_invalid", "config.agent.duplicate", "config.agent.invalid", "config.agent.reserved_name", "config.agent.unknown_model", "config.agent.unknown_tool", "config.agent_config_dir_invalid", "config.agents.no_delegation_tool", "config.approval_reach_invalid", "config.attachment_invalid", "config.auto_consolidation", "config.auto_mode_classifier_fallback_invalid", "config.auto_mode_denial_limit_invalid", "config.auto_mode_rate_limit_break_invalid", "config.auto_mode_timeout_invalid", "config.brain_call_guardrail_invalid", "config.cascade_invalid", "config.circuit_breaker_invalid", "config.command_sandbox_unavailable", "config.compliance_denied", "config.compliance_posture", "config.compliance_required", "config.context_settings_unknown_word", "config.credential_in_declaration", "config.credential_ref_invalid", "config.cross_boundary_posture", "config.cwd_conflicts_restore", "config.cwd_not_honored", "config.cwd_outside_root", "config.cwd_unsupported", "config.defer_mode_invalid", "config.delegation_entry_caps", "config.deps_retired_key", "config.egress_requires_write_effect", "config.empty_objective", "config.env_lifetime_invalid", "config.execution_env_home_dir_invalid", "config.extra_body_output_cap", "config.extra_tool_names", "config.host_floor_invalid", "config.host_floor_refused", "config.image_invalid", "config.interaction_posture", "config.interaction_wiring", "config.invalid_argument", "config.invalid_checkpoint_store", "config.invalid_file_history_capture", "config.invalid_file_history_store", "config.invalid_governance_baseline", "config.invalid_on_track_failure", "config.invalid_output_schema", "config.invalid_permission_rules", "config.invalid_task_registry", "config.invalid_tool_name_set", "config.language_invalid", "config.legacy_tool_name", "config.limit_invalid", "config.limit_unknown_key", "config.locked_key", "config.locked_registry", "config.mcp_content_class", "config.mcp_dialable_failed", "config.mcp_fingerprint_invalid", "config.mcp_host_seat_missing", "config.mcp_host_seat_undeclared", "config.mcp_pool_foreign_connection", "config.mcp_probe_option", "config.mcp_server_name_collision", "config.mcp_startup_timeout_invalid", "config.memory_capture_policy", "config.memory_capture_spelling", "config.memory_capture_unsupported", "config.memory_challenge_request", "config.memory_consolidation", "config.memory_consolidation_driver", "config.memory_consolidation_lease_required", "config.memory_consolidation_provenance_off", "config.memory_consolidation_replica_local", "config.memory_consolidation_write_gate", "config.memory_delegation_evidence", "config.memory_dir_not_backend_root", "config.memory_distiller_purity_contract", "config.memory_dual_root_overlap", "config.memory_erasure_request", "config.memory_erasure_scope", "config.memory_export_request", "config.memory_hold_timeout", "config.memory_import_request", "config.memory_persistence_invalid", "config.memory_project_identity", "config.memory_project_key_spelling", "config.memory_project_marker", "config.memory_project_marker_nested", "config.memory_provenance", "config.memory_reanchor", "config.memory_rebuild_reason", "config.memory_scope_key", "config.memory_scope_placement", "config.memory_scope_spelling", "config.memory_sync_cursor_mismatch", "config.memory_sync_store", "config.memory_sync_target_mismatch", "config.memory_write_scope_mismatch", "config.microcompact_invalid", "config.missing_scope", "config.model_fallback_invalid", "config.mods_invalid", "config.nothing_to_wake", "config.output_style_invalid", "config.parent_spec_seat_missing", "config.peer_answer_invalid", "config.peer_presence_invalid", "config.peer_seat_missing", "config.permission_mode_invalid", "config.placement_not_honored", "config.placement_root_invalid", "config.plan_file_invalid", "config.principal_inbox_consumer_invalid", "config.project_id_invalid", "config.project_identity_mismatch", "config.prompt_selector_invalid", "config.prompt_trait_unknown", "config.protocol_endpoint_unbound", "config.protocol_header_collision", "config.protocol_plaintext_credentials", "config.read_deny_floor_unkept", "config.read_face_invalid", "config.read_face_org_task_escalation", "config.read_face_readonly_conflict", "config.read_face_seat", "config.registry_scope_mismatch", "config.reserved_tool_name", "config.retention_capability", "config.retention_policy", "config.retention_policy_invalid", "config.run_origin_invalid", "config.safe_vars_reserved_name", "config.sandbox_admission_unavailable", "config.sandbox_settings_invalid", "config.session_rules_unreadable", "config.session_workspace_changed", "config.session_workspace_invalid", "config.shell_gate_value_retired", "config.skill_base_dir_invalid", "config.skill_deny_unreadable", "config.skill_listing_budget_invalid", "config.spec_member_unreadable", "config.spec_retired_key", "config.spec_unknown_key", "config.stale_tool_result_offload_invalid", "config.stall_timeout_invalid", "config.stall_timeout_retired", "config.store_durability_invalid", "config.store_fidelity_invalid", "config.tool_contract_too_long", "config.tool_face_control", "config.tool_face_invalid", "config.tool_materialize_invalid", "config.tool_materialize_unreachable", "config.tool_model_gate_env_invalid", "config.tool_model_gate_invalid", "config.tool_mount_denied", "config.tool_name_invalid", "config.tool_name_too_long", "config.tool_roster_bound", "config.tool_roster_mount_tag", "config.tool_roster_origin", "config.tool_schema_bound", "config.tool_search_invalid", "config.toolpolicy.unmatched_names", "config.unknown_role", "config.usage_window_invalid", "config.usage_window_unpriced", "config.user_attachment_invalid", "config.user_invoked_skill_unknown", "config.verify_internals_invalid", "config.web_max_bytes_invalid", "config.web_search_max_results_invalid", "config.web_summary_max_content_invalid", "config.web_timeout_invalid", "config.write_exempt_dir_covers_root", "config.write_face_invalid", "config.write_face_org_task_escalation", "config.write_face_readonly_conflict", "resume_at.before_root_unsupported", "resume_at.before_target_not_user", "resume_at.conflicts_resume", "resume_at.invalid_mode", "resume_at.mode_without_target", "resume_at.no_session", "resume_at.not_a_message", "resume_at.not_found"];
|
|
22
|
+
export type ConfigRefusalCode = (typeof CONFIG_REFUSAL_CODES)[number];
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
export const CONFIG_REFUSAL_CODES = Object.freeze([
|
|
2
|
+
"config.a2a_peer_name_collision",
|
|
3
|
+
"config.advisor_model_invalid",
|
|
4
|
+
"config.advisor_tool_invalid",
|
|
5
|
+
"config.agent.duplicate",
|
|
6
|
+
"config.agent.invalid",
|
|
7
|
+
"config.agent.reserved_name",
|
|
8
|
+
"config.agent.unknown_model",
|
|
9
|
+
"config.agent.unknown_tool",
|
|
10
|
+
"config.agent_config_dir_invalid",
|
|
11
|
+
"config.agents.no_delegation_tool",
|
|
12
|
+
"config.approval_reach_invalid",
|
|
13
|
+
"config.attachment_invalid",
|
|
14
|
+
"config.auto_consolidation",
|
|
15
|
+
"config.auto_mode_classifier_fallback_invalid",
|
|
16
|
+
"config.auto_mode_denial_limit_invalid",
|
|
17
|
+
"config.auto_mode_rate_limit_break_invalid",
|
|
18
|
+
"config.auto_mode_timeout_invalid",
|
|
19
|
+
"config.brain_call_guardrail_invalid",
|
|
20
|
+
"config.cascade_invalid",
|
|
21
|
+
"config.circuit_breaker_invalid",
|
|
22
|
+
"config.command_sandbox_unavailable",
|
|
23
|
+
"config.compliance_denied",
|
|
24
|
+
"config.compliance_posture",
|
|
25
|
+
"config.compliance_required",
|
|
26
|
+
"config.context_settings_unknown_word",
|
|
27
|
+
"config.credential_in_declaration",
|
|
28
|
+
"config.credential_ref_invalid",
|
|
29
|
+
"config.cross_boundary_posture",
|
|
30
|
+
"config.cwd_conflicts_restore",
|
|
31
|
+
"config.cwd_not_honored",
|
|
32
|
+
"config.cwd_outside_root",
|
|
33
|
+
"config.cwd_unsupported",
|
|
34
|
+
"config.defer_mode_invalid",
|
|
35
|
+
"config.delegation_entry_caps",
|
|
36
|
+
"config.deps_retired_key",
|
|
37
|
+
"config.egress_requires_write_effect",
|
|
38
|
+
"config.empty_objective",
|
|
39
|
+
"config.env_lifetime_invalid",
|
|
40
|
+
"config.execution_env_home_dir_invalid",
|
|
41
|
+
"config.extra_body_output_cap",
|
|
42
|
+
"config.extra_tool_names",
|
|
43
|
+
"config.host_floor_invalid",
|
|
44
|
+
"config.host_floor_refused",
|
|
45
|
+
"config.image_invalid",
|
|
46
|
+
"config.interaction_posture",
|
|
47
|
+
"config.interaction_wiring",
|
|
48
|
+
"config.invalid_argument",
|
|
49
|
+
"config.invalid_checkpoint_store",
|
|
50
|
+
"config.invalid_file_history_capture",
|
|
51
|
+
"config.invalid_file_history_store",
|
|
52
|
+
"config.invalid_governance_baseline",
|
|
53
|
+
"config.invalid_on_track_failure",
|
|
54
|
+
"config.invalid_output_schema",
|
|
55
|
+
"config.invalid_permission_rules",
|
|
56
|
+
"config.invalid_task_registry",
|
|
57
|
+
"config.invalid_tool_name_set",
|
|
58
|
+
"config.language_invalid",
|
|
59
|
+
"config.legacy_tool_name",
|
|
60
|
+
"config.limit_invalid",
|
|
61
|
+
"config.limit_unknown_key",
|
|
62
|
+
"config.locked_key",
|
|
63
|
+
"config.locked_registry",
|
|
64
|
+
"config.mcp_content_class",
|
|
65
|
+
"config.mcp_dialable_failed",
|
|
66
|
+
"config.mcp_fingerprint_invalid",
|
|
67
|
+
"config.mcp_host_seat_missing",
|
|
68
|
+
"config.mcp_host_seat_undeclared",
|
|
69
|
+
"config.mcp_pool_foreign_connection",
|
|
70
|
+
"config.mcp_probe_option",
|
|
71
|
+
"config.mcp_server_name_collision",
|
|
72
|
+
"config.mcp_startup_timeout_invalid",
|
|
73
|
+
"config.memory_capture_policy",
|
|
74
|
+
"config.memory_capture_spelling",
|
|
75
|
+
"config.memory_capture_unsupported",
|
|
76
|
+
"config.memory_challenge_request",
|
|
77
|
+
"config.memory_consolidation",
|
|
78
|
+
"config.memory_consolidation_driver",
|
|
79
|
+
"config.memory_consolidation_lease_required",
|
|
80
|
+
"config.memory_consolidation_provenance_off",
|
|
81
|
+
"config.memory_consolidation_replica_local",
|
|
82
|
+
"config.memory_consolidation_write_gate",
|
|
83
|
+
"config.memory_delegation_evidence",
|
|
84
|
+
"config.memory_dir_not_backend_root",
|
|
85
|
+
"config.memory_distiller_purity_contract",
|
|
86
|
+
"config.memory_dual_root_overlap",
|
|
87
|
+
"config.memory_erasure_request",
|
|
88
|
+
"config.memory_erasure_scope",
|
|
89
|
+
"config.memory_export_request",
|
|
90
|
+
"config.memory_hold_timeout",
|
|
91
|
+
"config.memory_import_request",
|
|
92
|
+
"config.memory_persistence_invalid",
|
|
93
|
+
"config.memory_project_identity",
|
|
94
|
+
"config.memory_project_key_spelling",
|
|
95
|
+
"config.memory_project_marker",
|
|
96
|
+
"config.memory_project_marker_nested",
|
|
97
|
+
"config.memory_provenance",
|
|
98
|
+
"config.memory_reanchor",
|
|
99
|
+
"config.memory_rebuild_reason",
|
|
100
|
+
"config.memory_scope_key",
|
|
101
|
+
"config.memory_scope_placement",
|
|
102
|
+
"config.memory_scope_spelling",
|
|
103
|
+
"config.memory_sync_cursor_mismatch",
|
|
104
|
+
"config.memory_sync_store",
|
|
105
|
+
"config.memory_sync_target_mismatch",
|
|
106
|
+
"config.memory_write_scope_mismatch",
|
|
107
|
+
"config.microcompact_invalid",
|
|
108
|
+
"config.missing_scope",
|
|
109
|
+
"config.model_fallback_invalid",
|
|
110
|
+
"config.mods_invalid",
|
|
111
|
+
"config.nothing_to_wake",
|
|
112
|
+
"config.output_style_invalid",
|
|
113
|
+
"config.parent_spec_seat_missing",
|
|
114
|
+
"config.peer_answer_invalid",
|
|
115
|
+
"config.peer_presence_invalid",
|
|
116
|
+
"config.peer_seat_missing",
|
|
117
|
+
"config.permission_mode_invalid",
|
|
118
|
+
"config.placement_not_honored",
|
|
119
|
+
"config.placement_root_invalid",
|
|
120
|
+
"config.plan_file_invalid",
|
|
121
|
+
"config.principal_inbox_consumer_invalid",
|
|
122
|
+
"config.project_id_invalid",
|
|
123
|
+
"config.project_identity_mismatch",
|
|
124
|
+
"config.prompt_selector_invalid",
|
|
125
|
+
"config.prompt_trait_unknown",
|
|
126
|
+
"config.protocol_endpoint_unbound",
|
|
127
|
+
"config.protocol_header_collision",
|
|
128
|
+
"config.protocol_plaintext_credentials",
|
|
129
|
+
"config.read_deny_floor_unkept",
|
|
130
|
+
"config.read_face_invalid",
|
|
131
|
+
"config.read_face_org_task_escalation",
|
|
132
|
+
"config.read_face_readonly_conflict",
|
|
133
|
+
"config.read_face_seat",
|
|
134
|
+
"config.registry_scope_mismatch",
|
|
135
|
+
"config.reserved_tool_name",
|
|
136
|
+
"config.retention_capability",
|
|
137
|
+
"config.retention_policy",
|
|
138
|
+
"config.retention_policy_invalid",
|
|
139
|
+
"config.run_origin_invalid",
|
|
140
|
+
"config.safe_vars_reserved_name",
|
|
141
|
+
"config.sandbox_admission_unavailable",
|
|
142
|
+
"config.sandbox_settings_invalid",
|
|
143
|
+
"config.session_rules_unreadable",
|
|
144
|
+
"config.session_workspace_changed",
|
|
145
|
+
"config.session_workspace_invalid",
|
|
146
|
+
"config.shell_gate_value_retired",
|
|
147
|
+
"config.skill_base_dir_invalid",
|
|
148
|
+
"config.skill_deny_unreadable",
|
|
149
|
+
"config.skill_listing_budget_invalid",
|
|
150
|
+
"config.spec_member_unreadable",
|
|
151
|
+
"config.spec_retired_key",
|
|
152
|
+
"config.spec_unknown_key",
|
|
153
|
+
"config.stale_tool_result_offload_invalid",
|
|
154
|
+
"config.stall_timeout_invalid",
|
|
155
|
+
"config.stall_timeout_retired",
|
|
156
|
+
"config.store_durability_invalid",
|
|
157
|
+
"config.store_fidelity_invalid",
|
|
158
|
+
"config.tool_contract_too_long",
|
|
159
|
+
"config.tool_face_control",
|
|
160
|
+
"config.tool_face_invalid",
|
|
161
|
+
"config.tool_materialize_invalid",
|
|
162
|
+
"config.tool_materialize_unreachable",
|
|
163
|
+
"config.tool_model_gate_env_invalid",
|
|
164
|
+
"config.tool_model_gate_invalid",
|
|
165
|
+
"config.tool_mount_denied",
|
|
166
|
+
"config.tool_name_invalid",
|
|
167
|
+
"config.tool_name_too_long",
|
|
168
|
+
"config.tool_roster_bound",
|
|
169
|
+
"config.tool_roster_mount_tag",
|
|
170
|
+
"config.tool_roster_origin",
|
|
171
|
+
"config.tool_schema_bound",
|
|
172
|
+
"config.tool_search_invalid",
|
|
173
|
+
"config.toolpolicy.unmatched_names",
|
|
174
|
+
"config.unknown_role",
|
|
175
|
+
"config.usage_window_invalid",
|
|
176
|
+
"config.usage_window_unpriced",
|
|
177
|
+
"config.user_attachment_invalid",
|
|
178
|
+
"config.user_invoked_skill_unknown",
|
|
179
|
+
"config.verify_internals_invalid",
|
|
180
|
+
"config.web_max_bytes_invalid",
|
|
181
|
+
"config.web_search_max_results_invalid",
|
|
182
|
+
"config.web_summary_max_content_invalid",
|
|
183
|
+
"config.web_timeout_invalid",
|
|
184
|
+
"config.write_exempt_dir_covers_root",
|
|
185
|
+
"config.write_face_invalid",
|
|
186
|
+
"config.write_face_org_task_escalation",
|
|
187
|
+
"config.write_face_readonly_conflict",
|
|
188
|
+
"resume_at.before_root_unsupported",
|
|
189
|
+
"resume_at.before_target_not_user",
|
|
190
|
+
"resume_at.conflicts_resume",
|
|
191
|
+
"resume_at.invalid_mode",
|
|
192
|
+
"resume_at.mode_without_target",
|
|
193
|
+
"resume_at.no_session",
|
|
194
|
+
"resume_at.not_a_message",
|
|
195
|
+
"resume_at.not_found",
|
|
196
|
+
]);
|
|
@@ -159,6 +159,14 @@ export interface ContextEditOptions {
|
|
|
159
159
|
* sum triggers.
|
|
160
160
|
*/
|
|
161
161
|
anchoredTotalTokens?: number;
|
|
162
|
+
/**
|
|
163
|
+
* What a clear of these results (indices into `messages`) saves on the request as it is sent, given their structural
|
|
164
|
+
* savings — the minimum-savings gate reads it when set. The request carries a repeated copy of a file as one sentence
|
|
165
|
+
* (`request-copy-projection.ts`), so clearing a result that was itself a repeat saves nearly nothing, and clearing the
|
|
166
|
+
* earliest copy of a chain makes the next copy carry the contents instead: the gate's premise (every break of the
|
|
167
|
+
* prefix buys at least {@link MIN_CLEAR_SAVINGS_TOKENS}) is a statement about the request. Absent ⇒ the structural sum.
|
|
168
|
+
*/
|
|
169
|
+
netSavings?: (cleared: readonly number[], structural: number) => number;
|
|
162
170
|
/** design/123 D2 — structural coefficient (`Model.charsPerToken`); default 3 (design/374 slice 4;
|
|
163
171
|
* it was 4 before). Note this does NOT reach the ≥20k gate, which is CC-exactly
|
|
164
172
|
* hard-coded to 4 — see {@link structuralClearSavings}. */
|
|
@@ -185,6 +193,24 @@ export interface ContextEditOptions {
|
|
|
185
193
|
*/
|
|
186
194
|
clearSource?: ReadonlyArray<AgentMessage>;
|
|
187
195
|
}
|
|
196
|
+
/**
|
|
197
|
+
* The already-cleared predicate — the THREE-form family (design/374 §3.1, r2-Md⑪). CC's own `vby`
|
|
198
|
+
* predicate is not complete on this tree, so each sema-reachable cleared/persisted shape is
|
|
199
|
+
* enumerated:
|
|
200
|
+
* ① plain marker (CC bytes, exact) ② extended prefix (ref/media disclosures survive — re-clearing
|
|
201
|
+
* an extended marker would destroy them) ③ aggregate-offload preview
|
|
202
|
+
* ({@link PERSISTED_OUTPUT_PREFIX}, single-source import — a persisted result's inline text is
|
|
203
|
+
* already a stub; re-clearing it would destroy the pageback envelope). ③ checks the FIRST block
|
|
204
|
+
* only: a preview may legitimately carry trailing media blocks (`tool-result-store` keeps images
|
|
205
|
+
* beside the preview), unlike the marker forms.
|
|
206
|
+
* Every form is excluded from BOTH the savings estimate and the application set, while its
|
|
207
|
+
* occurrence still holds a keep-window slot (CC window-base semantics, `EUs` :397708). Tool output
|
|
208
|
+
* is untrusted bytes and can legitimately spell the marker — that dodge is accepted (the marker is
|
|
209
|
+
* the machine's own vocabulary; a result that quotes it is treated as already cleared).
|
|
210
|
+
* The request's copy projection reads the same predicate: a cleared result keeps its card (`details`)
|
|
211
|
+
* but carries none of its contents, so it stands for no copy.
|
|
212
|
+
*/
|
|
213
|
+
export declare function isCleared(m: object): boolean;
|
|
188
214
|
/**
|
|
189
215
|
* audit A-1 (view-level heal for HISTORICAL pollution): drop synthetic EMPTY failure assistants —
|
|
190
216
|
* stopReason aborted/error with no tool calls and no non-whitespace text/thinking. Sessions persisted
|