@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
|
@@ -41,14 +41,15 @@ export declare function uncachedInputTokensOf(family: CacheFamily, u: {
|
|
|
41
41
|
* Normalize one turn's reported usage into its `{ totalInputTokens, uncachedInputTokens, costMicroUsd }`
|
|
42
42
|
* — the authoritative cost re-priced in core from injected pricing (so cached tokens aren't charged at
|
|
43
43
|
* full price). Shared by the run loop's per-turn accounting and post-task memory consolidation
|
|
44
|
-
* so a pricing change lives in ONE place.
|
|
45
|
-
*
|
|
44
|
+
* so a pricing change lives in ONE place. `cacheWriteLong` is the one-hour part of `cacheWrite`; the exclusive price buckets are split
|
|
45
|
+
* from them HERE, once (a table with no one-hour price leaves that part in the five-minute bucket, never as plain input).
|
|
46
46
|
*/
|
|
47
47
|
export declare function usageCostMicroUsd(family: CacheFamily, u: {
|
|
48
48
|
input?: number;
|
|
49
49
|
output?: number;
|
|
50
50
|
cacheRead?: number;
|
|
51
51
|
cacheWrite?: number;
|
|
52
|
+
cacheWriteLong?: number;
|
|
52
53
|
}, pricing: ModelPricing): {
|
|
53
54
|
totalInputTokens: number;
|
|
54
55
|
uncachedInputTokens: number;
|
|
@@ -19,11 +19,12 @@ export function usageCostMicroUsd(family, u, pricing) {
|
|
|
19
19
|
const normalized = { input: u.input || 0, cacheRead: u.cacheRead || 0, cacheWrite: u.cacheWrite || 0 };
|
|
20
20
|
const totalInputTokens = promptTokensOf(family, normalized);
|
|
21
21
|
const uncachedInputTokens = uncachedInputTokensOf(family, normalized);
|
|
22
|
+
const longWrites = pricing.cacheWriteLongPer1M !== undefined ? Math.max(0, Math.min(u.cacheWriteLong || 0, normalized.cacheWrite)) : 0;
|
|
22
23
|
const costMicroUsd = computeCostMicroUsd({
|
|
23
24
|
totalInputTokens,
|
|
24
25
|
cacheReadTokens: normalized.cacheRead,
|
|
25
|
-
cacheWriteTokens: normalized.cacheWrite,
|
|
26
|
-
cacheWriteTokensLong:
|
|
26
|
+
cacheWriteTokens: normalized.cacheWrite - longWrites,
|
|
27
|
+
cacheWriteTokensLong: longWrites,
|
|
27
28
|
outputTokens: u.output || 0,
|
|
28
29
|
}, pricing);
|
|
29
30
|
return { totalInputTokens, uncachedInputTokens, costMicroUsd };
|
|
@@ -13,7 +13,7 @@ export async function voidVerifierPause(input) {
|
|
|
13
13
|
const leg = compositionLegRecord(cp.state.compositionLeg);
|
|
14
14
|
if (leg?.entry !== "verify") {
|
|
15
15
|
throw new CheckpointError("resume.composition_mismatch", `this card was not parked by a verification gate's verifier leg (it records ${leg === undefined ? "no composition leg" : `a ${leg.entry} leg`}) — ` +
|
|
16
|
-
"voidVerifierPause voids only a verifier's own card; nothing was settled and the row is as it was");
|
|
16
|
+
"voidVerifierPause voids only a verifier's own card; nothing was settled and the row is as it was", { reason: "not_a_verifier_card" });
|
|
17
17
|
}
|
|
18
18
|
const report = (err, sessionId) => {
|
|
19
19
|
try {
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The HOST wiring seat: `RunnerDeps` — every store, sink, hook and policy provider a deployment hands
|
|
3
|
-
* the engine — plus the
|
|
4
|
-
* `
|
|
5
|
-
*
|
|
3
|
+
* the engine — plus the two structured shapes only its own callbacks produce (`ResumePreflightInfo`,
|
|
4
|
+
* `ResumePreflightVerdict`). Layer 0 vocabulary; `types.ts` re-exports all three, so no consumer's
|
|
5
|
+
* import changes.
|
|
6
6
|
*/
|
|
7
7
|
import type { Model } from "../internal/llm.js";
|
|
8
8
|
import type { AgentDefinition } from "./agent-definition.js";
|
|
@@ -13,50 +13,6 @@ import type { HandsBandOptions } from "./hands-band.js";
|
|
|
13
13
|
import type { OnElicit } from "./mcp-server-spec.js";
|
|
14
14
|
import type { Brain, ModelRef, ModelRoles } from "./model-seat.js";
|
|
15
15
|
import type { RuntimeCaps, WorkflowGovernanceBaseline } from "./runtime-caps.js";
|
|
16
|
-
/**
|
|
17
|
-
* parity-204 — the `RunnerDeps.loadProjectMemory` return: the one form a loader answers in (a loader with nothing to
|
|
18
|
-
* inject answers `{ content: null }`; a bare `string | null` is not read). Carries the `seededFromContext`
|
|
19
|
-
* seam (cc204-bundle @17917159: CC preloads readFileState for CLAUDE.md/nested-memory files it
|
|
20
|
-
* placed in context, and a DEFAULT whole-file Read of an unchanged seeded file answers with the
|
|
21
|
-
* already-in-context reminder instead of re-transmitting the body — token economy, GA in 204).
|
|
22
|
-
*/
|
|
23
|
-
export interface ProjectMemoryLoad {
|
|
24
|
-
/** The project-context text to inject (null/blank ⇒ no injection). */
|
|
25
|
-
content: string | null;
|
|
26
|
-
/**
|
|
27
|
-
* Files whose FULL, disk-verbatim text the deployment has placed in the model's context (e.g. the
|
|
28
|
-
* CLAUDE.md that `content` embeds). The Runner pre-seeds the hands' read state (through the same
|
|
29
|
-
* resolveKey containment as a real Read — an out-of-root path is silently skipped), so a default
|
|
30
|
-
* whole-file Read of an UNCHANGED seeded file returns the reminder
|
|
31
|
-
* (`This file is already in your context (see "Contents of <path>" above) and has not changed on
|
|
32
|
-
* disk…`) instead of the body. `content` here MUST be the file's exact disk text at load time —
|
|
33
|
-
* the unchanged check hashes it; never declare a truncated/annotated variant (CC's `isPartialView`
|
|
34
|
-
* exemption). A file that later changes on disk always reads normally (hash mismatch bypasses the
|
|
35
|
-
* dedup and disarms it). Requires hands (an executionEnv); ignored on a hands-less task.
|
|
36
|
-
*/
|
|
37
|
-
seededFiles?: ReadonlyArray<{
|
|
38
|
-
path: string;
|
|
39
|
-
content: string;
|
|
40
|
-
}>;
|
|
41
|
-
/**
|
|
42
|
-
* design-A C-3 (AGENTS.md×ingest, [A1]) — the deployment DECLARES which instruction files this
|
|
43
|
-
* snapshot was built from and their fingerprints (e.g. `AGENTS.md` / `CLAUDE.md`, hash over the
|
|
44
|
-
* raw pre-cap file bytes). Core does NOT interpret the hash algorithm or re-derive it — the pair
|
|
45
|
-
* is an OPAQUE comparison baseline (`path` + verbatim `contentHash` equality only), kept so the
|
|
46
|
-
* mid-session change probe can answer "did the file behind my snapshot move?" without core
|
|
47
|
-
* ever learning a file-name policy (types.ts seam rule: core never hardcodes instruction file
|
|
48
|
-
* names). [A2]: this list now FEEDS the C-4 `instructions_change` lane — when the deployment also
|
|
49
|
-
* wires {@link RunnerDeps.probeInstructionSources}, the run loop probes these paths at eligible
|
|
50
|
-
* turn boundaries and a moved hash is announced via a fixed tail attachment. Optional and inert
|
|
51
|
-
* when absent (today's loaders keep their exact behavior; no sources ⇒ the lane never runs).
|
|
52
|
-
*/
|
|
53
|
-
instructionSources?: ReadonlyArray<{
|
|
54
|
-
path: string;
|
|
55
|
-
/** `null` = the source is DECLARED but currently ABSENT from disk — the change probe then watches for
|
|
56
|
-
* its APPEARANCE (renders "absent → hash"). */
|
|
57
|
-
contentHash: string | null;
|
|
58
|
-
}>;
|
|
59
|
-
}
|
|
60
16
|
/**
|
|
61
17
|
* design/380 O2 — the facts handed to a deployment's {@link RunnerDeps.resumePreflight}: the row's
|
|
62
18
|
* own recorded identity + placement record, read off the persisted checkpoint (never off the resume
|
|
@@ -109,12 +65,20 @@ export type ResumePreflightVerdict = {
|
|
|
109
65
|
};
|
|
110
66
|
/** Runtime dependencies shared across tasks. */
|
|
111
67
|
export interface RunnerDeps {
|
|
68
|
+
/** The deployment's Brain; every engine read of it goes through the model lane (`brain/model-lane.ts`), which walks a catalog
|
|
69
|
+
* entry's `Model.fallbacks` chain on this same Brain and passes any other request straight through. */
|
|
112
70
|
brain: Brain;
|
|
113
|
-
/** Catalog used to resolve string ModelRefs to Model objects
|
|
71
|
+
/** Catalog used to resolve string ModelRefs to Model objects; its door (`new Runner` / `swapDeps`) also resolves each entry's
|
|
72
|
+
* `fallbacks` words over it (`config.model_fallback_invalid` on a bad chain). */
|
|
114
73
|
models?: Record<string, Model>;
|
|
74
|
+
/** The deployment's model-fallback policy ({@link ModelFallbackPolicy}: the gate words, the per-hop first-token deadline),
|
|
75
|
+
* received once at `new Runner`; a bad value ⇒ `config.model_fallback_invalid`; absent ⇒ the default gate, no deadline. */
|
|
76
|
+
modelFallback?: import("./model-fallbacks.js").ModelFallbackPolicy;
|
|
77
|
+
/** The deployment's prompt-cache retention word: ONE word, written on every call of the Brain seat in every lane (main loop, compaction, classifier, side query, mod call, advisor, consolidation) over the call's own value — what each brain does with it, and the price of `"long"` on one-off calls too, is `StreamOptions.cacheRetention`; absent ⇒ today's bytes; a non-word ⇒ `config.invalid_argument` at `new Runner`. */
|
|
78
|
+
cacheRetention?: import("../internal/llm.js").CacheRetention;
|
|
115
79
|
/**
|
|
116
80
|
* The deployment's per-model CONTEXT-WINDOW overlay, keyed by CATALOG WORD ({@link ContextSettings}):
|
|
117
|
-
* `contextTokens` / `autoCompactTokens` over what the model card declares, `autoCompact` / `manualCompact` the task seats' twins.
|
|
81
|
+
* `contextTokens` / `autoCompactTokens` over what the model card declares, `reserveTokens` (twin of the task's, which outranks it), `autoCompact` / `manualCompact` the task seats' twins.
|
|
118
82
|
*
|
|
119
83
|
* It is the ONE hot-swappable seat an IN-FLIGHT leg re-reads. Every other seat follows the snapshot law
|
|
120
84
|
* (a running task keeps the deps object it prepared under) because those seats are the routing card —
|
|
@@ -129,20 +93,18 @@ export interface RunnerDeps {
|
|
|
129
93
|
*/
|
|
130
94
|
contextSettings?: ContextSettings;
|
|
131
95
|
/**
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
136
|
-
* `mcp.server_revoked`
|
|
137
|
-
*
|
|
138
|
-
*
|
|
139
|
-
*
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
*/
|
|
145
|
-
mcpRevocations?: import("./mcp-server-spec.js").McpRevocationLedger;
|
|
96
|
+
* The HOST's revocation ledger over the protocol peers a run declares — its MCP servers and A2A peers — as one seat
|
|
97
|
+
* (protocol-revocation.ts). `revoked({ protocol, server | peer, fingerprint? })` is asked SYNCHRONOUSLY, never cached, as each request
|
|
98
|
+
* leaves the engine: an MCP server's dial (a 401 re-dial included), each listing page, each call, resource request and 401 re-send; an
|
|
99
|
+
* A2A peer's card, each message and status poll, every redirect hop. A request answered revoked is not sent (a call answers
|
|
100
|
+
* `mcp.server_revoked` / `a2a.peer_revoked`; a dial or a card fetch leaves the status row `failed` / `errorCode: "revoked"`; a refresh
|
|
101
|
+
* answers `revoked`); one already sent is not chased. `fingerprint` rides exactly when the MCP declaration carries one. Absent ⇒ never
|
|
102
|
+
* asked. A ledger that throws, or answers anything but a boolean (a Promise included — the seat is synchronous), fails OPEN and is told
|
|
103
|
+
* ONCE PER LEG, whichever protocol asked first: `protocol.revocation_probe_failed` (`detail: { message, runId }`, operator audience).
|
|
104
|
+
* Read once at `new Runner`: a value that is not an object with a `revoked` function — a Proxy, a function, the retired MCP-only
|
|
105
|
+
* `{ isRevoked }` form — is refused there (`config.invalid_argument`).
|
|
106
|
+
*/
|
|
107
|
+
protocolRevocations?: import("./protocol-revocation.js").ProtocolRevocationLedger;
|
|
146
108
|
peerSeat?: import("./peer-seat.js").PeerSeat;
|
|
147
109
|
/**
|
|
148
110
|
* design/147 S1c (ruled 2026-07-18) — the DURABLE name→agent roster behind explicit-name
|
|
@@ -991,15 +953,13 @@ export interface RunnerDeps {
|
|
|
991
953
|
* WHO consumes this deployment's principal inbox (`principal.inbox`, where the
|
|
992
954
|
* organization's delivery gate appends cross-principal letters; the mailbox contract's fourth chain).
|
|
993
955
|
* Absent = no consumer, no lane (byte for byte as before); a deployment that mounts a gate DECLARES
|
|
994
|
-
* `
|
|
995
|
-
*
|
|
956
|
+
* `"assistant"` (the only consumer: the leg the host hands `RunInternals.principalInboxAssistant` reads the box, through `ReadInbox`
|
|
957
|
+
* alone; no terminal leg touches it) or `"terminals"` (each terminal drains the box as a second lane; a held letter's
|
|
996
958
|
* decision is the letter's own field in the box, so every terminal reads the same one). Letters are judged on the principal's
|
|
997
|
-
* `crossSessionInbound` layers (managed, user), held when unset. ANY other value
|
|
998
|
-
*
|
|
959
|
+
* `crossSessionInbound` layers (managed, user), held when unset. ANY other value (the retired `{ assistant: "<handle>" }` among them,
|
|
960
|
+
* refused with the way to the current form) fails a session-box leg's prepare with `config.principal_inbox_consumer_invalid` (`detail.reason: "malformed"`).
|
|
999
961
|
*/
|
|
1000
|
-
principalInboxConsumer?: "terminals" |
|
|
1001
|
-
assistant: string;
|
|
1002
|
-
};
|
|
962
|
+
principalInboxConsumer?: "terminals" | "assistant";
|
|
1003
963
|
/**
|
|
1004
964
|
* design/385 §4.4 (slice 4) — this deployment's `dialogExpiry` (settings key, vocabulary
|
|
1005
965
|
* `"60s" | "5m" | "10m" | "never"`, default `"5m"`): how long a HELD cross-session message whose cause
|
|
@@ -1149,85 +1109,6 @@ export interface RunnerDeps {
|
|
|
1149
1109
|
sessionId: string;
|
|
1150
1110
|
phase: "checkpoint" | "terminal";
|
|
1151
1111
|
}) => void;
|
|
1152
|
-
/**
|
|
1153
|
-
* design/113 C4 — proactive project startup. The Runner calls this once during `prepareTask` (every prepare,
|
|
1154
|
-
* incl. durable resume — design/113 §4 H8) and injects the returned text as a READ-ONLY, FENCED, virtual
|
|
1155
|
-
* `"project"` memory layer at the TAIL (so the agent "sees" what project it is in from turn 1, like CC's
|
|
1156
|
-
* CLAUDE.md/git injection — the cure for "say hi → only greets"). The deployment/profile owns the CONTENT
|
|
1157
|
-
* (read CLAUDE.md / `.claude/` + fold in `git log -5`/status + a byte budget); core owns the seam + fence +
|
|
1158
|
-
* cache placement and NEVER hardcodes a filename (same trust posture as {@link executionEnvFactory}/
|
|
1159
|
-
* {@link mods}/{@link modelKnowledgeCutoffs}). A RunnerDeps FUNCTION, not a `TaskSpec` field: it is
|
|
1160
|
-
* unserializable (durable resume) and reading files for an UNTRUSTED caller would be a confused-deputy hole
|
|
1161
|
-
* (design/44 §7 Q4). DECOUPLED from `memoryStore` — injects even with NO long-term memory configured (H5).
|
|
1162
|
-
*
|
|
1163
|
-
* `undefined` (default) ⇒ the whole path is skipped = byte-identical to today (full parity, H3). The loader answers a
|
|
1164
|
-
* {@link ProjectMemoryLoad}; `{ content: null }` (or blank content) ⇒ no injection (also byte-identical). Any other
|
|
1165
|
-
* answer (a bare string, `null`, a non-object) is not read: it is disclosed on `onError` (phase `config`) and the leg runs
|
|
1166
|
-
* with no project layer, as when the loader throws. The content is fenced/sanitized like every other memory
|
|
1167
|
-
* layer (repo-controlled CLAUDE.md is UNTRUSTED data, not an instruction — H2). The ctx lets a profile tailor
|
|
1168
|
-
* or suppress: `handsEnabled:false` = a hands-less chat with no real project (answer `{ content: null }`); `isSubagent` =
|
|
1169
|
-
* a delegated child (a profile may trim CLAUDE.md for a cheap "grep this" subagent — H7).
|
|
1170
|
-
*/
|
|
1171
|
-
loadProjectMemory?: (ctx: {
|
|
1172
|
-
/** The task's working directory (= the execution env's cwd; a worktree task = its worktree root). */
|
|
1173
|
-
cwd: string;
|
|
1174
|
-
/** False ⇒ a hands-less chat (no real filesystem/project) — a profile typically answers `{ content: null }`. */
|
|
1175
|
-
handsEnabled: boolean;
|
|
1176
|
-
/** True ⇒ a delegated subagent run (a profile may trim/suppress project content to control cost). */
|
|
1177
|
-
isSubagent: boolean;
|
|
1178
|
-
/** The subagent's type name, when `isSubagent` — lets a profile tailor content per agent type. */
|
|
1179
|
-
agentName?: string;
|
|
1180
|
-
/**
|
|
1181
|
-
* design-A C-1 ([A2]) — the acquired session's id (uuid domain; equals the run's `sessionId`).
|
|
1182
|
-
* A deployment keys its SESSION-LEVEL snapshot cache on this (design-A §4.1 freeze unit: read
|
|
1183
|
-
* once per session, reuse across the session's prepares) — core itself caches nothing across
|
|
1184
|
-
* prepares. Always filled by the Runner; optional so hand-built ctx objects stay valid.
|
|
1185
|
-
*/
|
|
1186
|
-
sessionId?: string;
|
|
1187
|
-
/** The run this prepare belongs to — the id the `task.start` trace frame, `noteTaskRun` and `TaskResult.runId` carry. Always filled by the Runner. */
|
|
1188
|
-
runId?: string;
|
|
1189
|
-
/**
|
|
1190
|
-
* design-A C-1/C-2 ([A2]) — where this prepare sits in the snapshot lifecycle; the deployment's
|
|
1191
|
-
* cache-invalidation signal (core only derives and forwards it, and ignores the answer):
|
|
1192
|
-
* - `"fresh"` — no prior context: a brand-new session (no `spec.sessionId`, or an empty one).
|
|
1193
|
-
* - `"resume"` — an existing session's context continues (a durable-resume leg, a same-session
|
|
1194
|
-
* follow-up run, or a `resumeAt` rewind): a cached snapshot is still the one
|
|
1195
|
-
* the model has been seeing.
|
|
1196
|
-
* - `"post-compact"`— a compaction landed since the model's last full turn on this branch (branch
|
|
1197
|
-
* tail shows a `compaction` entry with no *user* message after it): the context
|
|
1198
|
-
* was rebuilt — the design-A §4.1 re-read boundary; a deployment should drop
|
|
1199
|
-
* its snapshot cache and read fresh. HONEST APPROXIMATION (recorded, see
|
|
1200
|
-
* docs/REVIEW-BACKLOG.md): a compaction followed by a mid-run user-role
|
|
1201
|
-
* injection (steer) before the next prepare reads as `"resume"` — the freshness
|
|
1202
|
-
* gap is covered by the C-4 `instructions_change` lane, not by this signal.
|
|
1203
|
-
* A session clear starts a NEW session, which reads `"fresh"` (rewinding past the root is rejected).
|
|
1204
|
-
*/
|
|
1205
|
-
phase?: "fresh" | "resume" | "post-compact";
|
|
1206
|
-
}) => Promise<ProjectMemoryLoad> | ProjectMemoryLoad;
|
|
1207
|
-
/**
|
|
1208
|
-
* design-A C-4 ([A2]) — the mid-session instruction-file change PROBE (the server half of the
|
|
1209
|
-
* `instructions_change` attachment lane). At eligible turn boundaries (continuation-gated like
|
|
1210
|
-
* `date_change`) the run loop calls this with the snapshot's declared
|
|
1211
|
-
* {@link ProjectMemoryLoad.instructionSources} and compares the answer against the lane's
|
|
1212
|
-
* per-path last-announced hash; a moved hash appends a fixed ≤512-byte tail notice (the model is
|
|
1213
|
-
* told the file changed and can Read the truth — the snapshot itself stays frozen, §4.1).
|
|
1214
|
-
* Contract:
|
|
1215
|
-
* - return `null` ⇒ this boundary is SKIPPED silently (nothing announced, nothing committed; the
|
|
1216
|
-
* next boundary retries) — the fail-soft path for a remote cwd / EACCES / transient IO.
|
|
1217
|
-
* - a per-entry `contentHash: null` ⇒ the file is GONE from disk (announced once as removed).
|
|
1218
|
-
* - paths not in `sources` are ignored; the probe should never throw (core guards anyway and
|
|
1219
|
-
* treats a throw exactly like `null`).
|
|
1220
|
-
* - core never reads files here and never interprets the hash (opaque equality only — the same
|
|
1221
|
-
* posture as `instructionSources`); the lstat/read/hash economics live in the deployment.
|
|
1222
|
-
* Unset ⇒ the lane does not exist: zero calls, zero state, byte-identical output.
|
|
1223
|
-
*/
|
|
1224
|
-
probeInstructionSources?: (sources: ReadonlyArray<{
|
|
1225
|
-
path: string;
|
|
1226
|
-
contentHash: string | null;
|
|
1227
|
-
}>) => Promise<ReadonlyArray<{
|
|
1228
|
-
path: string;
|
|
1229
|
-
contentHash: string | null;
|
|
1230
|
-
}> | null>;
|
|
1231
1112
|
/**
|
|
1232
1113
|
* design/99 §E23 — the LIVE-ONLY inbound-elicitation seam (an MCP server asking the END USER for input
|
|
1233
1114
|
* mid-tool-call). Wired ONLY for servers that opted in via {@link McpServerSpec.elicitation}; absent ⇒ core
|
|
@@ -1362,14 +1243,17 @@ export interface RunnerDeps {
|
|
|
1362
1243
|
sessionId: string;
|
|
1363
1244
|
/**
|
|
1364
1245
|
* Machine-readable sub-classification when the site has one (a kebab-case word naming the arm) —
|
|
1365
|
-
* e.g. the design/31 cache-break detector
|
|
1366
|
-
*
|
|
1367
|
-
*
|
|
1368
|
-
*
|
|
1369
|
-
*
|
|
1370
|
-
* warrant attention.
|
|
1246
|
+
* e.g. where the design/31 cache-break detector located the change ({@link import("./cache-break-detector.js").CacheBreakFinding}
|
|
1247
|
+
* `cause`), or the file-history liveness arms (`"file-history-no-store"` / `"file-history-no-env"`). Lets the host
|
|
1248
|
+
* pick its own log level: `"server-or-ttl"` is usually benign (slow tools ⇒ 5min+ request gaps expire provider
|
|
1249
|
+
* caches — service[64] flag②); a located change with `expected` was declared (a lawful opening); one without it is an
|
|
1250
|
+
* undeclared prefix change, reported whether or not the cache dropped, and warrants attention.
|
|
1371
1251
|
*/
|
|
1372
1252
|
classification?: string;
|
|
1253
|
+
/** `"prompt-cache"` findings only: `expected` = declared before the request went out; `firstChangedIndex` = the first
|
|
1254
|
+
* changed position (a tool index, a rewritten message index). */
|
|
1255
|
+
expected?: true;
|
|
1256
|
+
firstChangedIndex?: number;
|
|
1373
1257
|
}) => void;
|
|
1374
1258
|
/**
|
|
1375
1259
|
* Structured sink for operator-facing NOTICES ({@link EngineNotice}) — announcements that are not
|
|
@@ -1469,9 +1353,9 @@ export interface RunnerDeps {
|
|
|
1469
1353
|
clearOnRejection?: boolean;
|
|
1470
1354
|
};
|
|
1471
1355
|
/**
|
|
1472
|
-
* Two-phase prefix-cache-break detection (design/31): per turn, fingerprint the prefix and
|
|
1473
|
-
* confirmed `cacheRead` drop
|
|
1474
|
-
*
|
|
1356
|
+
* Two-phase prefix-cache-break detection (design/31): per turn, fingerprint the prefix and emit a finding via
|
|
1357
|
+
* `onError(phase:"prompt-cache")` on a confirmed `cacheRead` drop (`expected` when the located change was declared)
|
|
1358
|
+
* and on any prefix change no seat declared. Cheap (hashes only). Default **on**; set `false` to disable.
|
|
1475
1359
|
*/
|
|
1476
1360
|
cacheBreakDetection?: boolean;
|
|
1477
1361
|
/**
|
|
@@ -66,9 +66,14 @@ export interface WorkflowGovernanceBaseline {
|
|
|
66
66
|
* catalog does not hold — so the legal set is the INTERSECTION of this list and the catalog keys
|
|
67
67
|
* (note the catalog is the Runner's TIER-EXPANDED one, so on a deployment with `RunnerDeps.tiers`
|
|
68
68
|
* the tier words and CC aliases are catalog keys here too, still gated by this list).
|
|
69
|
-
* NEVER fail-open to the whole `models` catalog for an LLM-authored workflow
|
|
69
|
+
* NEVER fail-open to the whole `models` catalog for an LLM-authored workflow unless the deployment
|
|
70
|
+
* writes so: the one word `"catalog"` instead of a list declares that every entry of the catalog the
|
|
71
|
+
* leg runs under is pickable. Which names a value answers, and when a change to them takes effect, is
|
|
72
|
+
* `workflowModelNamesOf`'s contract (orchestration/workflow-governance.ts). Any other value (a string
|
|
73
|
+
* other than `"catalog"`, a list holding a non-string or an empty name) refuses the mount
|
|
74
|
+
* (`config.invalid_governance_baseline`); `null` reads as absent.
|
|
70
75
|
*/
|
|
71
|
-
workflowModelAllowlist?: string[];
|
|
76
|
+
workflowModelAllowlist?: string[] | "catalog";
|
|
72
77
|
}
|
|
73
78
|
/**
|
|
74
79
|
* design/99 §K — the per-principal runtime ENTITLEMENTS the engine enforces server-side, resolved by a
|
|
@@ -121,7 +126,7 @@ export interface RuntimeCaps {
|
|
|
121
126
|
* gate, not a config mistake).
|
|
122
127
|
*/
|
|
123
128
|
allowObservers?: boolean;
|
|
124
|
-
/** `true` FORCES this principal's run onto the durable-approval path: the engine synthesizes a
|
|
129
|
+
/** `true` FORCES this principal's run onto the durable-approval path: on a ROOT leg the engine synthesizes a
|
|
125
130
|
* `durableApproval{scope: principal}` so a policy `ask` suspends to the wire (a per-tool CC-faithful gate)
|
|
126
131
|
* even when the caller did not opt in — center's fleet-wide "interactive runs gate" mandate. A
|
|
127
132
|
* caller-supplied `TaskSpec.durableApproval` always wins (it may carry a tighter scope/ttl).
|
|
@@ -130,7 +135,14 @@ export interface RuntimeCaps {
|
|
|
130
135
|
* `config.durable_gate_unavailable` once (before its first ask), every ask resolves on the live chain
|
|
131
136
|
* (a live approver / question face in-stream, or the fail-closed deny with none), no durable record
|
|
132
137
|
* is written, and a live question face is consulted rather than vetoed (a mandate that cannot park
|
|
133
|
-
* must not demote a reachable person into the model answering for them).
|
|
138
|
+
* must not demote a reachable person into the model answering for them).
|
|
139
|
+
* On a DELEGATED leg it synthesizes nothing: such a leg can be resumed only under the opt-in its parent forwarded
|
|
140
|
+
* (a background child on a park-capable lane, a workflow agent — the parent's effective opt-in, a forced root's
|
|
141
|
+
* synthesized one included). Where the entitlement reaches a delegated leg with a store and no forwarded opt-in
|
|
142
|
+
* (a synchronous or fork child), the leg announces `config.durable_gate_unavailable` (cause `leg_not_resumable`)
|
|
143
|
+
* and parks no ask, and nothing answers in the mandate's place: every permission ask is refused without
|
|
144
|
+
* consulting the approver and a question is refused (not shown) — a delegated leg does not answer what its
|
|
145
|
+
* principal is forced to park. */
|
|
134
146
|
forceDurableGate?: boolean;
|
|
135
147
|
/**
|
|
136
148
|
* The per-principal auto-mode DENY bit (the mirror of the settings-plane
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
import { type RedactionConfidence, type RedactionSource } from "@sema-agent/primitives";
|
|
23
23
|
import { type EngineNotice } from "./engine-notice.js";
|
|
24
24
|
/** Does a value carry a credential? A URL userinfo (after every `scheme://`, and a leading `//`) with a password or a
|
|
25
|
-
* token-like user; a
|
|
25
|
+
* token-like user; a userinfo with no `//` in front of it the vocabulary reads; a credential assignment; a webhook URL; a Sonar login; a
|
|
26
26
|
* private-key header; an `Authorization` header, `token …`, `Bearer …` or `Basic …` with credential-shaped content (the
|
|
27
27
|
* value forms are the vocabulary's rows, {@link ENV_VALUES}). Reads the first {@link VALUE_SCAN_LIMIT} code units. The value half of the judgment, exported apart from the env
|
|
28
28
|
* entry's exemptions ({@link isExemptEnvName}): a caller holding a value that is no environment variable asks this. */
|
|
@@ -61,6 +61,12 @@ export interface WithheldEnvDeclaration {
|
|
|
61
61
|
* a flag or placeholder word, one character repeated, or fewer than eight characters. */
|
|
62
62
|
readonly values: readonly string[];
|
|
63
63
|
}
|
|
64
|
+
/** One character, three times or more, and nothing else: `xxxxxxxx`, `00000000` (a known vendor token prefix is set aside
|
|
65
|
+
* first, the env value view's `tokenHead`: `sk-xxxxxxxx`). The language of `/^(\S)\1{2,}$/u` — one code point that is
|
|
66
|
+
* no white space, repeated — read by comparing the text with that code point repeated, not by a back-reference loop: a
|
|
67
|
+
* regex engine keeps backtrack state per repetition, so a value of a few million characters would exhaust it. Exported
|
|
68
|
+
* for the checks that hold it to that language; not part of the package entry. */
|
|
69
|
+
export declare function isOneCharacterRepeated(text: string): boolean;
|
|
64
70
|
/**
|
|
65
71
|
* THE one reading of an empty credential: a string with nothing but white space in it, the empty string included, is no
|
|
66
72
|
* credential, whoever hands it and wherever it is handed. Every face that asks "was a credential handed at all" reads
|
|
@@ -188,8 +194,9 @@ export declare function hostChildEnvProblem(policy: unknown, ...grants: readonly
|
|
|
188
194
|
/**
|
|
189
195
|
* THE environment a child spawned ON THIS HOST starts with: {@link inheritedHostEnv}'s reading of `policy`, then each
|
|
190
196
|
* grant in order (a later grant's value wins, names compared as the platform compares them; an `undefined` value
|
|
191
|
-
* unsets). The tool shell's children
|
|
192
|
-
* run's shell policy and settings-env grant, with the hook's own variables as the last grant
|
|
197
|
+
* unsets). The tool shell's children, a command hook's children and a local language server are composed here alike: a
|
|
198
|
+
* hook starts from the run's shell policy and settings-env grant, with the hook's own variables as the last grant; a
|
|
199
|
+
* language server reads `"scrub"` with the host's `NodeLspManagerOptions.env` as its grant. An own credential is never
|
|
193
200
|
* inherited; a grant is the host's explicit act and is not read against the declaration. A grant that is not an object
|
|
194
201
|
* or throws while read, a name that is empty or holds `=`, NUL or an unpaired surrogate, and a value that is not a
|
|
195
202
|
* string or holds NUL or an unpaired surrogate throw, as a refused policy does ({@link hostChildEnvProblem}).
|
|
@@ -199,6 +206,14 @@ export declare function hostChildEnv(policy: InheritEnvPolicy | undefined, ...gr
|
|
|
199
206
|
* `undefined` when it is: a malformed policy, or an allow list naming one of the declared own credentials
|
|
200
207
|
* ({@link declareWithheldEnv}, compared as it says). */
|
|
201
208
|
export declare function inheritEnvPolicyProblem(value: unknown): string | undefined;
|
|
209
|
+
/** The declaration half of {@link inheritEnvPolicyProblem}, for a value whose shape is a policy: the first entry of an allow
|
|
210
|
+
* list that names one of the declared own credentials, and the sentence refusing it; `undefined` for a word, or a list
|
|
211
|
+
* naming none. A judged list can only turn up here after a declaration made since it was judged. */
|
|
212
|
+
export declare function declaredInheritEntry(value: unknown): {
|
|
213
|
+
index: number;
|
|
214
|
+
name: string;
|
|
215
|
+
refusal: string;
|
|
216
|
+
} | undefined;
|
|
202
217
|
/** Test seam: never called by production code. */
|
|
203
218
|
export declare function __resetSecretEnvScrubNoticeAnnouncement(): void;
|
|
204
219
|
/** What both disclosures say about one set of findings: every withheld name, and those that are the engine's own
|
|
@@ -229,4 +244,6 @@ export declare function announceSecretEnvScrub(onNotice: ((notice: EngineNotice)
|
|
|
229
244
|
export declare function withheldEnvUserNotice(withheld: readonly SecretEnvFinding[] | "unknown", at: {
|
|
230
245
|
sessionId: string;
|
|
231
246
|
runId?: string | undefined;
|
|
247
|
+
sourceSessionId?: string | undefined;
|
|
248
|
+
agentId?: string | undefined;
|
|
232
249
|
}): EngineNotice | undefined;
|
package/dist/core/secret-env.js
CHANGED
|
@@ -4,6 +4,8 @@ import { CREDENTIAL_MIN_CHARS, envNameView, envValueView, isSensitiveHeaderName,
|
|
|
4
4
|
import { DEFAULT_INHERITED_ENV_VARS } from "@modelcontextprotocol/client/stdio";
|
|
5
5
|
import { deliverEngineNotice } from "./engine-notice.js";
|
|
6
6
|
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
7
|
+
import { callerText } from "./caller-text.js";
|
|
8
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
7
9
|
const GIT_CONFIG_ENV_RE = /^GIT_CONFIG_(?:COUNT|PARAMETERS|(?:KEY|VALUE)_[0-9]+)$/;
|
|
8
10
|
const PROXY_ENV_RE = /^(?:(?:https?|ftp|all|no)_proxy|npm_config_(?:https?_)?proxy|npm_config_noproxy|yarn_proxy|(?:yarn|global_agent|docker|claude_code)_(?:https?|no)_proxy|cloudsdk_proxy_[a-z]+|electron_get_use_proxy)$/i;
|
|
9
11
|
function isExemptEnvName(name) {
|
|
@@ -14,7 +16,7 @@ const ENV_VALUES = envValueView();
|
|
|
14
16
|
const OTEL_ENV_RE = /^(?:INPUT_)?OTEL_/i;
|
|
15
17
|
const SEMA_NAMESPACE_SECRET_RE = ENV_NAMES.anySegmentUnder("SEMA_");
|
|
16
18
|
const BUNDLER_SETTINGS = ["BUILD", "LOCAL", "MIRROR", "PATH", "WITH", "WITHOUT", "CACHE", "DISABLE", "IGNORE", "ONLY"];
|
|
17
|
-
const BUNDLER_HOST = "(?:[A-Za-z0-9]+(?:___[A-Za-z0-9]+)*__)+[A-Za-z]{2
|
|
19
|
+
const BUNDLER_HOST = "(?:[A-Za-z0-9]+(?:___[A-Za-z0-9]+)*__)+[A-Za-z]{2}[A-Za-z]*";
|
|
18
20
|
const BUNDLER_CREDENTIAL_RE = new RegExp(`^(?:INPUT_)?BUNDLE_(?!(?:${BUNDLER_SETTINGS.join("|")})__(?!${BUNDLER_HOST}$))\\w*__`, "i");
|
|
19
21
|
const PUBLISHER_PREFIX_RE = /^(?:INPUT_|ORG_GRADLE_PROJECT_|POETRY_PYPI_TOKEN_|POETRY_HTTP_BASIC_|CARGO_REGISTRIES_|CONAN_LOGIN_USERNAME_|CONAN_PASSWORD_)/i;
|
|
20
22
|
const PUBLISHER_LOGIN_PREFIX_RE = /^(?:INPUT_)?(?:POETRY_HTTP_BASIC_|CONAN_LOGIN_USERNAME_)/i;
|
|
@@ -36,8 +38,8 @@ const VALUE_SCAN_LIMIT = 8192;
|
|
|
36
38
|
function looksLikeToken(user) {
|
|
37
39
|
return ENV_VALUES.tokenHead.test(user) || (user.length >= 20 && /[0-9]/.test(user) && /[a-z]/i.test(user));
|
|
38
40
|
}
|
|
39
|
-
const HOST_RE = /^(?:localhost|[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.(?=[a-z0-9-]*[a-z])[a-z0-9-]+|[a-z0-9_.-]+(?=:\d+(?:[/?#]|$))|\d{1,3}
|
|
40
|
-
const HOSTLIKE_RE = /^(?:(?=[a-z0-9._-]*[a-z])[a-z0-9._-]+|\d{1,3}
|
|
41
|
+
const HOST_RE = /^(?:localhost|[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.(?=[a-z0-9-]*[a-z])[a-z0-9-]+|[a-z0-9_.-]+(?=:\d+(?:[/?#]|$))|\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}|\[[0-9a-f:.]+\])(?::\d+)?(?:[/?#]|$)/i;
|
|
42
|
+
const HOSTLIKE_RE = /^(?:(?=[a-z0-9._-]*[a-z])[a-z0-9._-]+|\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}|\[[0-9a-f:.]+\])(?::\d+)?(?:[/?#]|$)/i;
|
|
41
43
|
function isHostPortPathBeforeAt(before, after) {
|
|
42
44
|
const hostPort = /^([a-z0-9_-]+(?:\.[a-z0-9_-]+)*):\d+([/?#].*)$/is.exec(before);
|
|
43
45
|
if (!hostPort)
|
|
@@ -63,12 +65,16 @@ function authorityCarriesCredential(rest) {
|
|
|
63
65
|
return false;
|
|
64
66
|
return userinfo.includes(":") || (!/[/?#]/.test(userinfo) && looksLikeToken(userinfo));
|
|
65
67
|
}
|
|
66
|
-
const
|
|
67
|
-
function
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
68
|
+
const URL_USERINFO = ENV_VALUES.urlUserinfo;
|
|
69
|
+
function carriesFrontlessUserinfo(text) {
|
|
70
|
+
for (const m of text.matchAll(URL_USERINFO)) {
|
|
71
|
+
if ((m[1] ?? "").endsWith("//"))
|
|
72
|
+
continue;
|
|
73
|
+
const userinfo = (m[2] ?? "").slice(0, -1);
|
|
74
|
+
if (userinfo.includes(":") || (!/[?#]/.test(userinfo) && looksLikeToken(userinfo)))
|
|
75
|
+
return true;
|
|
76
|
+
}
|
|
77
|
+
return false;
|
|
72
78
|
}
|
|
73
79
|
export function looksLikeCredentialValue(value) {
|
|
74
80
|
const text = value.length > VALUE_SCAN_LIMIT ? value.slice(0, VALUE_SCAN_LIMIT) : value;
|
|
@@ -78,7 +84,7 @@ export function looksLikeCredentialValue(value) {
|
|
|
78
84
|
}
|
|
79
85
|
if (text.startsWith("//") && authorityCarriesCredential(text.slice(2)))
|
|
80
86
|
return true;
|
|
81
|
-
return
|
|
87
|
+
return carriesFrontlessUserinfo(text) || ENV_VALUES.forms.some((form) => form.re.test(text));
|
|
82
88
|
}
|
|
83
89
|
const OWN_CREDENTIAL = "the engine's own service credential";
|
|
84
90
|
const SECRET_ENV_KIND_CONFIDENCE = {
|
|
@@ -183,8 +189,16 @@ function runtimeSuppliedHolderOf(value) {
|
|
|
183
189
|
const supplied = policyArm([...runtimeSuppliedEnv()]);
|
|
184
190
|
return Object.keys(supplied).find((k) => supplied[k] === value);
|
|
185
191
|
}
|
|
186
|
-
const PLACEHOLDER_KEY_WORDS = new Set([...ENV_VALUES.flagWords,
|
|
187
|
-
|
|
192
|
+
const PLACEHOLDER_KEY_WORDS = new Set([...ENV_VALUES.flagWords, ...ENV_VALUES.placeholderWords]);
|
|
193
|
+
export function isOneCharacterRepeated(text) {
|
|
194
|
+
const first = text.codePointAt(0);
|
|
195
|
+
if (first === undefined)
|
|
196
|
+
return false;
|
|
197
|
+
const unit = String.fromCodePoint(first);
|
|
198
|
+
if (!/^\S$/u.test(unit) || text.length < 3 * unit.length || text.length % unit.length !== 0)
|
|
199
|
+
return false;
|
|
200
|
+
return text === unit.repeat(text.length / unit.length);
|
|
201
|
+
}
|
|
188
202
|
export function isBlankCredential(value) {
|
|
189
203
|
return value.trim() === "";
|
|
190
204
|
}
|
|
@@ -196,7 +210,7 @@ function notACredentialReason(value) {
|
|
|
196
210
|
return `a string of fewer than ${CREDENTIAL_MIN_CHARS} characters, which names no secret`;
|
|
197
211
|
if (PLACEHOLDER_KEY_WORDS.has(text.toLowerCase()))
|
|
198
212
|
return "a flag or placeholder word, which names no secret";
|
|
199
|
-
if (
|
|
213
|
+
if (isOneCharacterRepeated(text.replace(ENV_VALUES.tokenHead, "")))
|
|
200
214
|
return "one character repeated, which names no secret";
|
|
201
215
|
return undefined;
|
|
202
216
|
}
|
|
@@ -228,7 +242,7 @@ export function declareWithheldEnv(table) {
|
|
|
228
242
|
if (given === null || typeof given !== "object" || Array.isArray(given)) {
|
|
229
243
|
throw new Error(`declareWithheldEnv: the declaration must be a table { names, values } (got ${Array.isArray(given) ? "an array — a names-only list is no longer a declaration: pass { names, values }" : kindOf(given)})`);
|
|
230
244
|
}
|
|
231
|
-
const received = receiveMembers(given, { subject: "declareWithheldEnv's table", unit: "member", moment: "at the declaration" }, WITHHELD_ENV_TABLE_KEYS, (_, [stray]) => new Error(`declareWithheldEnv: the table has a member ${
|
|
245
|
+
const received = receiveMembers(given, { subject: "declareWithheldEnv's table", unit: "member", moment: "at the declaration" }, WITHHELD_ENV_TABLE_KEYS, (_, [stray]) => new Error(`declareWithheldEnv: the table has a member ${callerText(stray)} — it holds names and values only`));
|
|
232
246
|
const givenNames = received.names;
|
|
233
247
|
if (!Array.isArray(givenNames))
|
|
234
248
|
throw new Error(`declareWithheldEnv: names must be an array of variable names (got ${kindOf(givenNames)})`);
|
|
@@ -363,7 +377,7 @@ function policyShapeProblem(value) {
|
|
|
363
377
|
return undefined;
|
|
364
378
|
if (Array.isArray(value))
|
|
365
379
|
return variableNameListProblem("inheritEnv", value);
|
|
366
|
-
return `inheritEnv must be "scrub", "all" or a list of variable names (got ${
|
|
380
|
+
return `inheritEnv must be "scrub", "all" or a list of variable names (got ${describeRejectedValue(value)})`;
|
|
367
381
|
}
|
|
368
382
|
export function inheritedHostEnv(policy, findings) {
|
|
369
383
|
const problem = inheritEnvPolicyProblem(policy);
|
|
@@ -442,13 +456,19 @@ function policyArm(policy, findings) {
|
|
|
442
456
|
return arm;
|
|
443
457
|
}
|
|
444
458
|
export function inheritEnvPolicyProblem(value) {
|
|
445
|
-
|
|
459
|
+
return policyShapeProblem(value) ?? declaredInheritEntry(value)?.refusal;
|
|
460
|
+
}
|
|
461
|
+
export function declaredInheritEntry(value) {
|
|
446
462
|
const { names } = withheldEnvOf();
|
|
447
|
-
if (
|
|
448
|
-
return
|
|
463
|
+
if (!Array.isArray(value) || names.length === 0)
|
|
464
|
+
return undefined;
|
|
465
|
+
const list = value;
|
|
449
466
|
const own = new Set(names.map(envNameKey));
|
|
450
|
-
const
|
|
451
|
-
|
|
467
|
+
const index = list.findIndex((k) => own.has(envNameKey(k)));
|
|
468
|
+
const name = list[index];
|
|
469
|
+
if (name === undefined)
|
|
470
|
+
return undefined;
|
|
471
|
+
return { index, name, refusal: `inheritEnv[${index}] names ${name}, which this process has declared (declareWithheldEnv) to be ${OWN_CREDENTIAL}, so a child cannot inherit it (a configuration error: no retry succeeds until the policy or the declaration changes)` };
|
|
452
472
|
}
|
|
453
473
|
let secretEnvScrubNoticeAnnounced = false;
|
|
454
474
|
export function __resetSecretEnvScrubNoticeAnnouncement() {
|
|
@@ -473,11 +493,14 @@ export function announceSecretEnvScrub(onNotice, findings) {
|
|
|
473
493
|
});
|
|
474
494
|
}
|
|
475
495
|
export function withheldEnvUserNotice(withheld, at) {
|
|
476
|
-
const route = { sessionId: at.sessionId, ...(at.runId !== undefined ? { runId: at.runId } : {}) };
|
|
496
|
+
const route = { sessionId: at.sessionId, ...(at.sourceSessionId !== undefined ? { sourceSessionId: at.sourceSessionId } : {}), ...(at.agentId !== undefined ? { agentId: at.agentId } : {}), ...(at.runId !== undefined ? { runId: at.runId } : {}) };
|
|
497
|
+
const delegated = at.sourceSessionId !== undefined;
|
|
498
|
+
const shell = delegated ? "the tool shell of a delegated agent in this session" : "the tool shell in this session";
|
|
499
|
+
const subject = delegated ? "A delegated agent's tool shell in this session" : "The tool shell in this session";
|
|
477
500
|
if (withheld === "unknown") {
|
|
478
501
|
return {
|
|
479
502
|
code: "inherit_env.names_withheld",
|
|
480
|
-
message:
|
|
503
|
+
message: `The engine could not determine which variables of its environment ${shell} does not receive: the execution environment does not say. Variables you set may read as unset there.`,
|
|
481
504
|
detail: { state: "unknown", ...route },
|
|
482
505
|
};
|
|
483
506
|
}
|
|
@@ -491,7 +514,7 @@ export function withheldEnvUserNotice(withheld, at) {
|
|
|
491
514
|
];
|
|
492
515
|
return {
|
|
493
516
|
code: "inherit_env.names_withheld",
|
|
494
|
-
message:
|
|
517
|
+
message: `${subject} does not receive ${names.length} variable(s) of the engine's environment: ${halves.join("; ")}. Values are never shown.`,
|
|
495
518
|
detail: { state: "withheld", names, ...(ownCredentials.length > 0 ? { ownCredentials } : {}), ...route },
|
|
496
519
|
};
|
|
497
520
|
}
|
|
@@ -119,6 +119,14 @@ export declare function canonicalDataRootKeys(env: ExecutionEnv, spellings: read
|
|
|
119
119
|
* containment test would be a second place for the two judges to disagree about what "inside" means.
|
|
120
120
|
*/
|
|
121
121
|
export declare function relativeUnderRoot(targetKey: string, rootKey: string): string | null;
|
|
122
|
+
/**
|
|
123
|
+
* The row of the recommended sensitive-path table (`RECOMMENDED_SENSITIVE_PATTERNS`: the `.ssh` / `.aws` / `.git/hooks` / key-file rows the
|
|
124
|
+
* write guard reads) that any of `spellings` lands on — its pattern as written — or `undefined` when none does. The same rows, the same
|
|
125
|
+
* segment judgment and the same host case fold as the write guard's, read over bare spellings: pure and synchronous (no environment, no
|
|
126
|
+
* data-root exemption — a directory the host points a store at is judged whole, the way the guard judges a target outside the data root).
|
|
127
|
+
* For a reader that asks "is this directory one the guard protects" rather than "may this call write here".
|
|
128
|
+
*/
|
|
129
|
+
export declare function sensitiveRowOf(spellings: readonly string[]): string | undefined;
|
|
122
130
|
/**
|
|
123
131
|
* Build a composable policy that DENIES writes (via the guarded fs tools) whose target lands on a guarded pattern — by any
|
|
124
132
|
* view its reading holds: the spelling anchored at the tool's declared base, the canonical target, a hop of the leaf's
|