@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
|
+
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
3
|
+
import { receivedToolData } from "./tool-data-door.js";
|
|
2
4
|
export function isErrorLike(value) {
|
|
3
5
|
try {
|
|
4
6
|
if (value instanceof Error)
|
|
@@ -21,6 +23,11 @@ export function thrownName(err) {
|
|
|
21
23
|
const name = isErrorLike(err) ? readMember(err, "name") : undefined;
|
|
22
24
|
return typeof name === "string" ? name : undefined;
|
|
23
25
|
}
|
|
26
|
+
const MAX_THROWN_NAME_CHARS = 64;
|
|
27
|
+
export function boundedThrownName(e) {
|
|
28
|
+
const name = thrownName(e);
|
|
29
|
+
return name === undefined || name === "" ? typeof e : name.slice(0, MAX_THROWN_NAME_CHARS);
|
|
30
|
+
}
|
|
24
31
|
export function thrownText(err) {
|
|
25
32
|
try {
|
|
26
33
|
if (typeof err === "string")
|
|
@@ -57,13 +64,18 @@ export function asThrownError(err) {
|
|
|
57
64
|
return new Error(thrownLabel(err));
|
|
58
65
|
}
|
|
59
66
|
export function readMember(value, key) {
|
|
67
|
+
const read = readMemberOrUnreadable(value, key);
|
|
68
|
+
return read === UNREADABLE ? undefined : read;
|
|
69
|
+
}
|
|
70
|
+
export const UNREADABLE = Symbol("unreadable member");
|
|
71
|
+
export function readMemberOrUnreadable(value, key) {
|
|
60
72
|
try {
|
|
61
73
|
if (value === null || value === undefined)
|
|
62
74
|
return undefined;
|
|
63
75
|
return value[key];
|
|
64
76
|
}
|
|
65
77
|
catch {
|
|
66
|
-
return
|
|
78
|
+
return UNREADABLE;
|
|
67
79
|
}
|
|
68
80
|
}
|
|
69
81
|
export function readOwnMembers(value) {
|
|
@@ -81,10 +93,34 @@ export function readOwnMembers(value) {
|
|
|
81
93
|
Object.defineProperty(out, key, { value: readMember(value, key), enumerable: true, writable: true, configurable: true });
|
|
82
94
|
return out;
|
|
83
95
|
}
|
|
96
|
+
function isArrayIndex(key) {
|
|
97
|
+
const n = Number(key);
|
|
98
|
+
return Number.isInteger(n) && n >= 0 && n < 4_294_967_295 && String(n) === key;
|
|
99
|
+
}
|
|
100
|
+
export function readElements(value) {
|
|
101
|
+
let keys;
|
|
102
|
+
try {
|
|
103
|
+
if (!Array.isArray(value))
|
|
104
|
+
return undefined;
|
|
105
|
+
keys = Object.getOwnPropertyNames(value);
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
return undefined;
|
|
109
|
+
}
|
|
110
|
+
return keys.filter(isArrayIndex).map((k) => readMember(value, k));
|
|
111
|
+
}
|
|
84
112
|
export function thrownMarksOf(err) {
|
|
85
|
-
const
|
|
113
|
+
const received = receivedToolData(readMember(err, "details"));
|
|
114
|
+
const details = isPlainRecord(received) ? received : undefined;
|
|
86
115
|
const errorKind = readMember(err, "errorKind");
|
|
87
116
|
if (typeof errorKind !== "string")
|
|
88
117
|
return details;
|
|
89
118
|
return { ...(details ?? {}), errorKind };
|
|
90
119
|
}
|
|
120
|
+
const ENGINE_CODE_SPELLING = /^[a-z][a-zA-Z0-9_]*(?:\.[a-zA-Z0-9_]+)*$/;
|
|
121
|
+
export function isEngineCodeShape(code) {
|
|
122
|
+
return typeof code === "string" && ENGINE_CODE_SPELLING.test(code);
|
|
123
|
+
}
|
|
124
|
+
export function codedRefusal(code, message) {
|
|
125
|
+
return Object.assign(new Error(message), { code, details: Object.freeze({ code }) });
|
|
126
|
+
}
|
|
@@ -15,11 +15,11 @@ const c = (contractId, implementationRevision = "1") => ({ contractId, implement
|
|
|
15
15
|
export const TOOL_CATALOG_ENTRIES = [
|
|
16
16
|
{
|
|
17
17
|
id: "read", name: "Read", source: "builtin", definedIn: "src/tools/fs/fs-read.ts", mountedBy: ["hands"],
|
|
18
|
-
cards: ["text", "notebook", "
|
|
18
|
+
cards: ["text", "notebook", "image", "document"],
|
|
19
19
|
face: {
|
|
20
|
-
family: "file-read", boundaryLegs: ["env"], effect: "read", contract: c("core.read@1"),
|
|
20
|
+
family: "file-read", boundaryLegs: ["env"], effect: "read", contract: c("core.read@1", "2"),
|
|
21
21
|
pathTarget: { param: "file_path", aliases: ["path"], access: "read", base: "cwd", absent: "none" },
|
|
22
|
-
ruleFace: { params: ["file_path", "path", "offset", "limit", "pages"] },
|
|
22
|
+
ruleFace: { params: ["file_path", "path", "offset", "limit", "pages", "allow_large"] },
|
|
23
23
|
renderHints: { summaryParams: ["file_path"] },
|
|
24
24
|
offload: false, compactable: true, budgetExempt: true,
|
|
25
25
|
},
|
|
@@ -56,6 +56,16 @@ export const TOOL_CATALOG_ENTRIES = [
|
|
|
56
56
|
renderHints: { userFacingName: "Edit Notebook", summaryParams: ["notebook_path"], approvalCard: "notebook-edit" },
|
|
57
57
|
},
|
|
58
58
|
},
|
|
59
|
+
{
|
|
60
|
+
id: "save-tool-result", name: "SaveToolResult", source: "builtin", definedIn: "src/tools/fs/fs-write.ts", mountedBy: ["hands"],
|
|
61
|
+
cards: [],
|
|
62
|
+
face: {
|
|
63
|
+
family: "file-write", boundaryLegs: ["env"], effect: "write", contract: c("core.save_tool_result@1"),
|
|
64
|
+
pathTarget: { param: "file_path", aliases: ["path"], access: "create", base: "cwd", absent: "none" },
|
|
65
|
+
ruleFace: { params: ["ref", "file_path", "path"] },
|
|
66
|
+
renderHints: { summaryParams: ["file_path"], approvalCard: "generic" },
|
|
67
|
+
},
|
|
68
|
+
},
|
|
59
69
|
{
|
|
60
70
|
id: "bash", name: "Bash", source: "builtin", definedIn: "src/tools/fs/fs-bash.ts", mountedBy: ["hands"],
|
|
61
71
|
cards: ["bash", "readonly_out_of_root", "read_unestablished", "bash_invalid_timeout", "bash_self_kill_refused"],
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* THE tool door: a value a tool body handed the engine — a member of what its `execute` returned, or the `details` mark of
|
|
3
|
+
* what it threw (read by `thrownMarksOf`) — as data the engine owns. Primitives are themselves; anything the receipt refuses
|
|
4
|
+
* (a Proxy, an object with its own `toJSON`, a bigint or a symbol at the top) is absent. The copy of an object the engine
|
|
5
|
+
* holds a receipt for holds it too — the receipt crosses with the object, never as a member.
|
|
6
|
+
*/
|
|
7
|
+
export declare function receivedToolData(v: unknown): unknown;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { types } from "node:util";
|
|
2
|
+
import { receive } from "./mods/kernel/receive.js";
|
|
3
|
+
import { carryNotStartedReceipt } from "./delegation-not-started.js";
|
|
4
|
+
const TOOL_DATA_MODE = Object.freeze({ accessors: "call-once", depth: Infinity, others: "copy", contain: true, wire: true, isProxy: (v) => types.isProxy(v) });
|
|
5
|
+
export function receivedToolData(v) {
|
|
6
|
+
if (v === null || v === undefined || typeof v === "string" || typeof v === "number" || typeof v === "boolean")
|
|
7
|
+
return v;
|
|
8
|
+
const r = receive(v, TOOL_DATA_MODE);
|
|
9
|
+
if (!r.ok)
|
|
10
|
+
return undefined;
|
|
11
|
+
carryNotStartedReceipt(v, r.value);
|
|
12
|
+
return r.value;
|
|
13
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The frozen task-start copies of the caller's tool-face control arrays: the selector's own layer (`allow` / `exclude`) and
|
|
3
|
+
* the disclosure lists. The driver compiles the selector from them once the leg's delegation facts are known.
|
|
4
|
+
*/
|
|
5
|
+
export interface ToolFaceLists {
|
|
6
|
+
allow: readonly string[] | undefined;
|
|
7
|
+
exclude: readonly string[] | undefined;
|
|
8
|
+
defer: readonly string[] | undefined;
|
|
9
|
+
alwaysLoad: readonly string[] | undefined;
|
|
10
|
+
restoreGated: readonly string[] | true | undefined;
|
|
11
|
+
}
|
|
12
|
+
/** The spec members the reader reads — each `unknown`, because the reader is the screen. */
|
|
13
|
+
export interface ToolFaceListsSpec {
|
|
14
|
+
readonly allowTools?: unknown;
|
|
15
|
+
readonly excludeTools?: unknown;
|
|
16
|
+
readonly deferTools?: unknown;
|
|
17
|
+
readonly alwaysLoadTools?: unknown;
|
|
18
|
+
readonly restoreGatedTools?: unknown;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Read the five tool-face lists: the restore selector first (its own refusal, `config.tool_model_gate_invalid`), then the four
|
|
22
|
+
* name lists in the order `allowTools`, `excludeTools`, `deferTools`, `alwaysLoadTools` (`config.tool_face_control`), and the
|
|
23
|
+
* snapshot. Every list is one frozen copy, shared by reference with every reader.
|
|
24
|
+
*/
|
|
25
|
+
export declare function readToolFaceLists(spec: ToolFaceListsSpec): ToolFaceLists;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { assertRestoreGatedToolsValue } from "./tool-model-gate.js";
|
|
2
|
+
function toolFaceListRefusal(message, reason) {
|
|
3
|
+
const e = new Error(message);
|
|
4
|
+
e.code = "config.tool_face_control";
|
|
5
|
+
e.detail = { reason };
|
|
6
|
+
return e;
|
|
7
|
+
}
|
|
8
|
+
function toolNameList(value, seat) {
|
|
9
|
+
if (value === undefined)
|
|
10
|
+
return undefined;
|
|
11
|
+
if (!Array.isArray(value)) {
|
|
12
|
+
throw toolFaceListRefusal(`TaskSpec.${seat} must be an array of tool names or absent (got ${value === null ? "null" : typeof value}) — a garbage list must refuse loudly, never be read as "no ${seat}".`, "not_a_list");
|
|
13
|
+
}
|
|
14
|
+
const entries = value;
|
|
15
|
+
const names = [];
|
|
16
|
+
for (const entry of entries) {
|
|
17
|
+
if (typeof entry !== "string") {
|
|
18
|
+
throw toolFaceListRefusal(`TaskSpec.${seat} entries must be strings (got ${entry === null ? "null" : typeof entry}).`, "not_a_string");
|
|
19
|
+
}
|
|
20
|
+
names.push(entry);
|
|
21
|
+
}
|
|
22
|
+
return Object.freeze(names);
|
|
23
|
+
}
|
|
24
|
+
export function readToolFaceLists(spec) {
|
|
25
|
+
const restore = spec.restoreGatedTools;
|
|
26
|
+
assertRestoreGatedToolsValue(restore);
|
|
27
|
+
const allow = toolNameList(spec.allowTools, "allowTools");
|
|
28
|
+
const exclude = toolNameList(spec.excludeTools, "excludeTools");
|
|
29
|
+
const defer = toolNameList(spec.deferTools, "deferTools");
|
|
30
|
+
const alwaysLoad = toolNameList(spec.alwaysLoadTools, "alwaysLoadTools");
|
|
31
|
+
return {
|
|
32
|
+
allow,
|
|
33
|
+
exclude,
|
|
34
|
+
defer,
|
|
35
|
+
alwaysLoad,
|
|
36
|
+
restoreGated: restore === true ? true : restore !== undefined ? Object.freeze([...restore]) : undefined,
|
|
37
|
+
};
|
|
38
|
+
}
|
|
@@ -1,13 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The READER of an MCP server's `toolFaces` declaration ({@link McpServerSpec.toolFaces}, the per-tool FACE overlay): `readToolFaces(declared)`,
|
|
3
|
-
* the face-side sibling of `readToolAxes` (`mcp-server-spec.ts`). The engine's preparation door and its MCP materialization entrance ask it
|
|
4
|
-
* (`locked-config.ts`), and a host that assembles the field from JSON (a console's write door, a deployment intake) asks it at its own door:
|
|
5
|
-
* one reading of the declaration, whoever asks and whenever. The mount ({@link applyMcpToolFaces}) then consumes the reader's copy and never
|
|
6
|
-
* the raw object, and judges each face against the materialized schema with the very judge this reader ends in.
|
|
7
|
-
*
|
|
8
|
-
* It sits beside `mcp-server-spec.ts` rather than in the runner directory the mount lives in: it is the declaration's door, not a station of
|
|
9
|
-
* the prepare path, and the public surface is tiered by where a symbol is declared (`readToolAxes` is `advanced` for the same reason).
|
|
10
|
-
*/
|
|
11
1
|
import { type McpServerSpec } from "./mcp-server-spec.js";
|
|
12
2
|
/** Every member name a face declaration has, at any depth — the words a `toolFaces` refusal's member path spells (derived from the tables above). */
|
|
13
3
|
export declare const TOOL_FACE_WORDS: ReadonlySet<string>;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { callerText, dataKind
|
|
1
|
+
import { callerText, dataKind } from "./caller-text.js";
|
|
2
|
+
import { perToolEmptyName, perToolEntryRefusal, receivePerToolDeclaration } from "./mcp-server-spec.js";
|
|
2
3
|
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
3
4
|
import { strayMembersOf } from "./own-property-receipt.js";
|
|
4
5
|
import { faceProblem } from "./runner/tool-face-overlay.js";
|
|
@@ -80,7 +81,8 @@ export function readToolFaces(declared) {
|
|
|
80
81
|
if (!received.ok)
|
|
81
82
|
return { ok: false, problem: received.problem };
|
|
82
83
|
const entries = [];
|
|
83
|
-
|
|
84
|
+
const declaredEntries = Object.entries(received.perTool);
|
|
85
|
+
for (const [index, [tool, raw]] of declaredEntries.entries()) {
|
|
84
86
|
if (tool.length === 0)
|
|
85
87
|
return { ok: false, problem: perToolEmptyName("toolFaces", "tool") };
|
|
86
88
|
let face;
|
|
@@ -91,7 +93,7 @@ export function readToolFaces(declared) {
|
|
|
91
93
|
face = "a member threw while it was read";
|
|
92
94
|
}
|
|
93
95
|
if (typeof face === "string")
|
|
94
|
-
return { ok: false, problem: perToolEntryRefusal("toolFaces", "tool", tool, inlineUntrusted(face, 240)) };
|
|
96
|
+
return { ok: false, problem: perToolEntryRefusal("toolFaces", "tool", tool, inlineUntrusted(face, 240), { index, of: declaredEntries.length }) };
|
|
95
97
|
entries.push([tool, face]);
|
|
96
98
|
}
|
|
97
99
|
return entries.length > 0 ? { ok: true, faces: Object.fromEntries(entries) } : { ok: true };
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { type ToolNameListSide } from "./tool-name-list.js";
|
|
2
|
+
/** YAML's white space — the space and the tab — THE one definition: every test that reads a blank reads it here (a
|
|
3
|
+
* no-break space, a line break, any other space character is text). */
|
|
4
|
+
export declare const isBlank: (ch: string) => boolean;
|
|
5
|
+
/** Why a list cannot be read — clauses a reader puts in its sentence; none quotes the list's own text. */
|
|
6
|
+
export declare const PARENS_NOT_ONE_ZONE = "an entry's parentheses are not one group that closes it (a `(` that does not close, a `)` with no `(`, or text after the closing `)` \u2014 `\\(` / `\\)` are a rule's own text)";
|
|
7
|
+
export declare const SEQUENCE_NOT_A_NAME = "an entry is not a plain or quoted name (nested, mapping, anchor, tag, flow and block-scalar entries, and number, boolean and null entries, are not read)";
|
|
8
|
+
/** An entry the rule syntax cannot read, by its place in the list (counted from 1; the entry itself is not quoted). */
|
|
9
|
+
export declare const notARule: (position: number) => string;
|
|
10
|
+
/**
|
|
11
|
+
* The cut, run over ONE scalar's text at a time (a reader of YAML's structure reads that first): entries end at every comma
|
|
12
|
+
* and every SPACE character outside parentheses. A `(` opens a zone a matching `)` closes, nested zones counted
|
|
13
|
+
* (`Bash(echo $(date) now)` is one entry); a parenthesis after an odd run of backslashes is the rule's escaped text
|
|
14
|
+
* (`\(` / `\)`, the rule syntax's own escape) and counts for nothing. An entry's parentheses are ONE zone that closes the
|
|
15
|
+
* entry: a `)` with no zone open, a zone the scalar leaves open, and anything but a separator after the `)` that closes the
|
|
16
|
+
* zone (`Bash(a)(b)`, two rules joined by a tab or a no-break space) are the one problem of parentheses, kept for the list
|
|
17
|
+
* ({@link problem}) and for the entry it is in ({@link brokenParens}). Each entry loses the blanks at its ends and an empty
|
|
18
|
+
* one is dropped (`Read,Grep,` is two). A tab is no separator. What else an entry must be is the rule syntax's to say, asked
|
|
19
|
+
* once the whole list is read.
|
|
20
|
+
*/
|
|
21
|
+
export declare class EntryCutter {
|
|
22
|
+
readonly entries: string[];
|
|
23
|
+
/** Per entry, at its index in {@link entries}: its parentheses are not one zone that closes it. */
|
|
24
|
+
readonly brokenParens: boolean[];
|
|
25
|
+
problem: string | undefined;
|
|
26
|
+
/** Parentheses open in the current scalar: inside one nothing cuts. */
|
|
27
|
+
private depth;
|
|
28
|
+
/** The current entry's zone opened and closed again: only a separator may follow. */
|
|
29
|
+
private closed;
|
|
30
|
+
private current;
|
|
31
|
+
/** The current entry's parentheses are not one zone. */
|
|
32
|
+
private currentBroken;
|
|
33
|
+
/** Blanks read after the entry's last other character, written only when another one follows: an entry's leading and
|
|
34
|
+
* trailing blanks, and the blanks a line break drops, never are (and no line break makes the cut look back). */
|
|
35
|
+
private blanks;
|
|
36
|
+
/** The character pushed last was a backslash that escapes the next one. */
|
|
37
|
+
private escaping;
|
|
38
|
+
push(ch: string): void;
|
|
39
|
+
/** `breaks` line breaks inside a scalar, as YAML folds them: the blanks before them go, one reads as a space (which
|
|
40
|
+
* separates entries outside parentheses), and more than one keeps all but one as line breaks of the text. */
|
|
41
|
+
fold(breaks: number): void;
|
|
42
|
+
/** The scalar is over: its last entry is cut, and a zone it left open is a problem. */
|
|
43
|
+
endScalar(): void;
|
|
44
|
+
fail(why: string): void;
|
|
45
|
+
/** The current entry's parentheses are not one zone that closes it — a problem of the list and of that entry. */
|
|
46
|
+
private breakParens;
|
|
47
|
+
private cut;
|
|
48
|
+
}
|
|
49
|
+
/** One entry of a tool-list field, read by the rule syntax. */
|
|
50
|
+
export interface ToolListFieldEntry {
|
|
51
|
+
/** The entry's place in the field, counted from 1 over every entry the field holds — read or refused — in written order. */
|
|
52
|
+
readonly position: number;
|
|
53
|
+
/** The entry as written, the blanks at its ends dropped: the spelling a definition's tool list or a rule list takes as it is. */
|
|
54
|
+
readonly spelling: string;
|
|
55
|
+
/** The tool name the rule syntax reads (`Bash` in `Bash(git log:*)`; `*` for the lone `*`). */
|
|
56
|
+
readonly name: string;
|
|
57
|
+
/** The rule the parentheses hold, unescaped (`git log:*`); absent for a bare name and for `Tool()` / `Tool(*)`, the whole tool. */
|
|
58
|
+
readonly arg?: string;
|
|
59
|
+
}
|
|
60
|
+
/** What a reader of the field is told. `level: "error"` — the field, or one entry of it, is not read: the value is no list
|
|
61
|
+
* (`not_a_list`), a list whose entries cannot be read (`unreadable`), a list item that is not a string or holds no entry
|
|
62
|
+
* (`not_a_name`), an entry whose parentheses are not one group closing it (`parens`), an entry that is no rule spelling
|
|
63
|
+
* (`not_a_rule`). `level: "info"` — the list is read as written and says something its author may not mean: a denied list
|
|
64
|
+
* holding the lone `*` denies every tool (`deny_all`, once, at the first such entry). */
|
|
65
|
+
export interface ToolListFieldProblem {
|
|
66
|
+
readonly level: "error" | "info";
|
|
67
|
+
readonly code: "not_a_list" | "unreadable" | "not_a_name" | "parens" | "not_a_rule" | "deny_all";
|
|
68
|
+
/** The entry's place ({@link ToolListFieldEntry.position}); absent when the problem is the whole value's. */
|
|
69
|
+
readonly position?: number;
|
|
70
|
+
/** The entry as the cut wrote it (`parens`, `not_a_rule`, `deny_all`): data for a host to show through its own escaping, never in `why`. */
|
|
71
|
+
readonly spelling?: string;
|
|
72
|
+
/** The words that say why, never quoting the field: for an `error`, the clause the skills-directory reader refuses the same
|
|
73
|
+
* list with; for `deny_all`, what the list as written does. */
|
|
74
|
+
readonly why: string;
|
|
75
|
+
}
|
|
76
|
+
/** A tool-list field, read: `entries` is `undefined` only for an absent field; `problems` holds every entry or value not read
|
|
77
|
+
* (`error`) and what the list as read says that its author may not mean (`info`). */
|
|
78
|
+
export interface ToolListField {
|
|
79
|
+
readonly entries: readonly ToolListFieldEntry[] | undefined;
|
|
80
|
+
readonly problems: readonly ToolListFieldProblem[];
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Read a tool-list FIELD — the value a host's YAML parser produced for an agent's `tools:` / `disallowedTools:` or a
|
|
84
|
+
* command's `allowed-tools` — by the one grammar of this module. Nothing is dropped without a problem saying so:
|
|
85
|
+
* - `undefined` (the field is absent): `entries` is `undefined` — no list; the consumer's default applies (an agent's
|
|
86
|
+
* `tools:` absent holds every tool, its `disallowedTools:` absent denies none);
|
|
87
|
+
* - `null` (the key written with nothing after it): an empty list — the field is written and names no tool;
|
|
88
|
+
* - a string: each of its lines is cut alone (a line break ends an entry, as each line of a skill's block scalar is cut
|
|
89
|
+
* alone), an empty or blank string an empty list;
|
|
90
|
+
* - a list (read once by index, as every host-written tool-name list is): each string item is cut as a string; an item that
|
|
91
|
+
* is not a string, or a string that holds no entry, is `not_a_name` and takes one position;
|
|
92
|
+
* - any other value: `not_a_list`, and an empty list.
|
|
93
|
+
* Every entry is then the rule syntax's to read: one it reads is an entry, one whose parentheses are not one zone is `parens`,
|
|
94
|
+
* one it cannot read `not_a_rule`. Case is kept, a repeated entry is kept, a name no tool answers to is kept (the list's
|
|
95
|
+
* consumer judges names), and the lone `*` is an entry like any other, the list never collapsed to it: the consumer reads it
|
|
96
|
+
* — an allowed list holding it allows every tool, a denied list holding it denies every tool. `side` is the side the field is
|
|
97
|
+
* on: a `denied` list holding a `*` entry is also told so, once (`deny_all`, `level: "info"`), its entries unchanged.
|
|
98
|
+
* A field with an `error` problem is not the list its author wrote: an allowed list that lost entries holds fewer tools, a
|
|
99
|
+
* denied list that lost entries denies fewer. A host refuses the definition, as the skills-directory reader refuses the skill,
|
|
100
|
+
* or says so naming each problem; installing `entries` without a word is the one thing it does not do. An `info` problem is
|
|
101
|
+
* the list as written: a host shows it, and installs the list.
|
|
102
|
+
*/
|
|
103
|
+
export declare function parseToolListField(value: unknown, side: ToolNameListSide): ToolListField;
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { ruleSpellingOf } from "./permission-rule-syntax.js";
|
|
2
|
+
import { readToolNameList } from "./tool-name-list.js";
|
|
3
|
+
export const isBlank = (ch) => ch === " " || ch === "\t";
|
|
4
|
+
export const PARENS_NOT_ONE_ZONE = "an entry's parentheses are not one group that closes it (a `(` that does not close, a `)` with no `(`, or text after the closing `)` — `\\(` / `\\)` are a rule's own text)";
|
|
5
|
+
export const SEQUENCE_NOT_A_NAME = "an entry is not a plain or quoted name (nested, mapping, anchor, tag, flow and block-scalar entries, and number, boolean and null entries, are not read)";
|
|
6
|
+
export const notARule = (position) => `entry ${position} is no rule spelling (a tool name of ASCII letters, digits and \`_ - . : *\`, starting with a letter, a digit, \`_\` or \`*\`, then at most one parenthesized rule)`;
|
|
7
|
+
export class EntryCutter {
|
|
8
|
+
entries = [];
|
|
9
|
+
brokenParens = [];
|
|
10
|
+
problem;
|
|
11
|
+
depth = 0;
|
|
12
|
+
closed = false;
|
|
13
|
+
current = "";
|
|
14
|
+
currentBroken = false;
|
|
15
|
+
blanks = "";
|
|
16
|
+
escaping = false;
|
|
17
|
+
push(ch) {
|
|
18
|
+
const escaped = this.escaping;
|
|
19
|
+
this.escaping = ch === "\\" && !escaped;
|
|
20
|
+
if (this.depth === 0 && (ch === "," || ch === " ")) {
|
|
21
|
+
this.cut();
|
|
22
|
+
return;
|
|
23
|
+
}
|
|
24
|
+
if (isBlank(ch)) {
|
|
25
|
+
if (this.current !== "")
|
|
26
|
+
this.blanks += ch;
|
|
27
|
+
return;
|
|
28
|
+
}
|
|
29
|
+
if (this.closed)
|
|
30
|
+
this.breakParens();
|
|
31
|
+
if (ch === "(" && !escaped)
|
|
32
|
+
this.depth++;
|
|
33
|
+
else if (ch === ")" && !escaped) {
|
|
34
|
+
if (this.depth === 0)
|
|
35
|
+
this.breakParens();
|
|
36
|
+
else
|
|
37
|
+
this.closed = --this.depth === 0;
|
|
38
|
+
}
|
|
39
|
+
this.current += this.blanks + ch;
|
|
40
|
+
this.blanks = "";
|
|
41
|
+
}
|
|
42
|
+
fold(breaks) {
|
|
43
|
+
this.blanks = "";
|
|
44
|
+
if (breaks === 1)
|
|
45
|
+
this.push(" ");
|
|
46
|
+
else
|
|
47
|
+
for (let n = 1; n < breaks; n++)
|
|
48
|
+
this.push("\n");
|
|
49
|
+
}
|
|
50
|
+
endScalar() {
|
|
51
|
+
if (this.depth > 0)
|
|
52
|
+
this.breakParens();
|
|
53
|
+
this.depth = 0;
|
|
54
|
+
this.escaping = false;
|
|
55
|
+
this.cut();
|
|
56
|
+
}
|
|
57
|
+
fail(why) {
|
|
58
|
+
this.problem ??= why;
|
|
59
|
+
}
|
|
60
|
+
breakParens() {
|
|
61
|
+
this.currentBroken = true;
|
|
62
|
+
this.fail(PARENS_NOT_ONE_ZONE);
|
|
63
|
+
}
|
|
64
|
+
cut() {
|
|
65
|
+
const entry = this.current;
|
|
66
|
+
const broken = this.currentBroken;
|
|
67
|
+
this.current = "";
|
|
68
|
+
this.blanks = "";
|
|
69
|
+
this.closed = false;
|
|
70
|
+
this.currentBroken = false;
|
|
71
|
+
if (entry !== "") {
|
|
72
|
+
this.entries.push(entry);
|
|
73
|
+
this.brokenParens.push(broken);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
const LIST_UNREADABLE = "its value is a list whose entries cannot be read (an accessor or a proxy trap threw), not a list of names";
|
|
78
|
+
const notAList = (type) => `its value is ${type}, not a list of names`;
|
|
79
|
+
const DENY_ALL = "`*` in a denied list denies every tool (a reader that collapses the list to `*` would deny nothing)";
|
|
80
|
+
export function parseToolListField(value, side) {
|
|
81
|
+
if (value === undefined)
|
|
82
|
+
return { entries: undefined, problems: [] };
|
|
83
|
+
const entries = [];
|
|
84
|
+
const problems = [];
|
|
85
|
+
const read = () => {
|
|
86
|
+
const star = side === "denied" ? entries.find((e) => e.name === "*") : undefined;
|
|
87
|
+
if (star !== undefined)
|
|
88
|
+
problems.push({ level: "info", code: "deny_all", position: star.position, spelling: star.spelling, why: DENY_ALL });
|
|
89
|
+
return { entries, problems };
|
|
90
|
+
};
|
|
91
|
+
if (value === null)
|
|
92
|
+
return read();
|
|
93
|
+
let position = 0;
|
|
94
|
+
const cutString = (text) => {
|
|
95
|
+
const cut = new EntryCutter();
|
|
96
|
+
for (const line of text.split("\n")) {
|
|
97
|
+
for (const ch of line)
|
|
98
|
+
cut.push(ch);
|
|
99
|
+
cut.endScalar();
|
|
100
|
+
}
|
|
101
|
+
cut.entries.forEach((spelling, index) => {
|
|
102
|
+
position++;
|
|
103
|
+
const rule = cut.brokenParens[index] === true ? undefined : ruleSpellingOf(spelling);
|
|
104
|
+
if (rule !== undefined) {
|
|
105
|
+
entries.push({ position, spelling, name: rule.toolName, ...(rule.ruleContent !== undefined ? { arg: rule.ruleContent } : {}) });
|
|
106
|
+
}
|
|
107
|
+
else if (cut.brokenParens[index] === true)
|
|
108
|
+
problems.push({ level: "error", code: "parens", position, spelling, why: PARENS_NOT_ONE_ZONE });
|
|
109
|
+
else
|
|
110
|
+
problems.push({ level: "error", code: "not_a_rule", position, spelling, why: notARule(position) });
|
|
111
|
+
});
|
|
112
|
+
return cut.entries.length;
|
|
113
|
+
};
|
|
114
|
+
if (typeof value === "string") {
|
|
115
|
+
cutString(value);
|
|
116
|
+
return read();
|
|
117
|
+
}
|
|
118
|
+
const list = readToolNameList(value);
|
|
119
|
+
if (list.kind === "not_a_list")
|
|
120
|
+
return { entries, problems: [{ level: "error", code: "not_a_list", why: notAList(list.type) }] };
|
|
121
|
+
if (list.kind === "unreadable")
|
|
122
|
+
return { entries, problems: [{ level: "error", code: "unreadable", why: LIST_UNREADABLE }] };
|
|
123
|
+
for (const item of list.entries) {
|
|
124
|
+
if (typeof item === "string" && cutString(item) > 0)
|
|
125
|
+
continue;
|
|
126
|
+
position++;
|
|
127
|
+
problems.push({ level: "error", code: "not_a_name", position, why: SEQUENCE_NOT_A_NAME });
|
|
128
|
+
}
|
|
129
|
+
return read();
|
|
130
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The NORMALIZATION a leg's mount facts pass through before the mount table reads them (tool-mount-plan.ts): the task's
|
|
3
|
+
* own word, the deployment's seats and the execution environment, each read ONCE into the closed fact set. Both halves
|
|
4
|
+
* read the table through these functions — prepare states their answers when its roster opens, and
|
|
5
|
+
* `describeStaticWiring` states the ones a deployment can read before any task — so a fact means the same thing to the
|
|
6
|
+
* leg that mounts and to the reader that predicts.
|
|
7
|
+
*
|
|
8
|
+
* Facts only known where a phase computes them (a listing, a verdict a phase reaches live, the name domain at a
|
|
9
|
+
* phase's point) are not here: the phase that computes one states it beside the judgment that reads it.
|
|
10
|
+
*/
|
|
11
|
+
import type { ExecutionEnv } from "../internal/harness-types.js";
|
|
12
|
+
import type { ToolMountFact } from "./tool-mount-plan.js";
|
|
13
|
+
import type { RunnerDeps, TaskSpec } from "./types.js";
|
|
14
|
+
/** Facts a reader of the mount table states; a fact absent from the record is one it cannot read. */
|
|
15
|
+
export type ToolMountFacts = Partial<Record<ToolMountFact, boolean>>;
|
|
16
|
+
/** The spec members the task's own word is read from. */
|
|
17
|
+
export type MountFactSpec = Pick<TaskSpec, "enableBlockedReport" | "enablePlanMode" | "interactiveTools" | "selfOrchestration" | "outputSchema" | "handsReadOnly" | "advisorModel" | "lspManager">;
|
|
18
|
+
/** The task's own word. */
|
|
19
|
+
export declare function specMountFacts(spec: MountFactSpec): ToolMountFacts;
|
|
20
|
+
/** The deps members the deployment's seats are read from. */
|
|
21
|
+
export type MountFactDeps = Pick<RunnerDeps, "workflowScriptRunner" | "workflowGovernanceBaseline" | "lspManager" | "artifactHost" | "sharedMemoryStores">;
|
|
22
|
+
/** The deployment's seats a task cannot move (a task's own LSP manager counts with the deployment's). */
|
|
23
|
+
export declare function seatMountFacts(deps: MountFactDeps, spec: Pick<TaskSpec, "lspManager">): ToolMountFacts;
|
|
24
|
+
/** The run's global offload thresholds: the explicit one (the task's, else the deployment's — the coarse knob that outranks
|
|
25
|
+
* the per-tool defaults) and the effective one (the explicit one, else the engine default). */
|
|
26
|
+
export declare function offloadThresholdsOf(spec: Pick<TaskSpec, "toolResultThresholdChars">, deps: Pick<RunnerDeps, "toolResultThresholdChars">): {
|
|
27
|
+
readonly explicit: number | undefined;
|
|
28
|
+
readonly effective: number;
|
|
29
|
+
};
|
|
30
|
+
/** `seat.offload`: a finite, positive effective threshold opens the offload seat (a store is always at hand once it is open —
|
|
31
|
+
* the deployment's, else a fresh in-memory one). */
|
|
32
|
+
export declare function offloadSeatFact(effectiveThreshold: number): boolean;
|
|
33
|
+
/** The question seat's inputs: a live question face; a park store the question can wait in; the per-principal durable
|
|
34
|
+
* entitlement (`undefined` where it cannot be read before a principal resolves); the task's own durable opt-in. */
|
|
35
|
+
export interface QuestionSeatInputs<F extends boolean | undefined = boolean | undefined> {
|
|
36
|
+
readonly face: boolean;
|
|
37
|
+
readonly parkStore: boolean;
|
|
38
|
+
readonly forceDurableGate: F;
|
|
39
|
+
readonly durableApprovalDeclared: boolean;
|
|
40
|
+
/** The leg's one fact `approvalParkNotResumable` (`approvalParkNotResumableOf`; a static reader reads a top-level leg: `false`). */
|
|
41
|
+
readonly approvalParkNotResumable: boolean;
|
|
42
|
+
}
|
|
43
|
+
/** `seat.question`: a seat that answers — a live face, or the durable park (a store to wait in AND a declared opt-in). */
|
|
44
|
+
export declare function questionSeatFact(input: QuestionSeatInputs<boolean>): boolean;
|
|
45
|
+
export declare function questionSeatFact(input: QuestionSeatInputs): boolean | undefined;
|
|
46
|
+
/** The execution environment's reach: hands at all, a target its shell faces reach, the two daemon capabilities. */
|
|
47
|
+
export declare function envMountFacts(handsEnabled: boolean, env: ExecutionEnv): ToolMountFacts;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { workflowsCapability } from "../orchestration/workflow-script-runner.js";
|
|
2
|
+
import { hasBackgroundShell } from "./background-shell.js";
|
|
3
|
+
import { performsIo } from "./remote-env.js";
|
|
4
|
+
import { hasScheduler } from "./scheduler.js";
|
|
5
|
+
import { durableParkOptInDeclared } from "./tool-policy.js";
|
|
6
|
+
import { DEFAULT_TOOL_RESULT_THRESHOLD_CHARS } from "./tool-result-store.js";
|
|
7
|
+
export function specMountFacts(spec) {
|
|
8
|
+
return {
|
|
9
|
+
"spec.enableBlockedReport": spec.enableBlockedReport !== false,
|
|
10
|
+
"spec.planMode": spec.enablePlanMode === true,
|
|
11
|
+
"spec.interactiveTools.on": spec.interactiveTools === true,
|
|
12
|
+
"spec.interactiveTools.off": spec.interactiveTools === false,
|
|
13
|
+
"spec.selfOrchestration": spec.selfOrchestration === true,
|
|
14
|
+
"spec.outputSchema": spec.outputSchema !== undefined,
|
|
15
|
+
"spec.handsReadOnly": spec.handsReadOnly === true,
|
|
16
|
+
"spec.advisorModel": spec.advisorModel !== undefined,
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
export function seatMountFacts(deps, spec) {
|
|
20
|
+
return {
|
|
21
|
+
"seat.workflows": workflowsCapability(deps),
|
|
22
|
+
"seat.lsp": (spec.lspManager ?? deps.lspManager) !== undefined,
|
|
23
|
+
"seat.artifact": deps.artifactHost !== undefined,
|
|
24
|
+
"seat.sharedMemory": deps.sharedMemoryStores !== undefined,
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
export function offloadThresholdsOf(spec, deps) {
|
|
28
|
+
const explicit = spec.toolResultThresholdChars ?? deps.toolResultThresholdChars;
|
|
29
|
+
return { explicit, effective: explicit ?? DEFAULT_TOOL_RESULT_THRESHOLD_CHARS };
|
|
30
|
+
}
|
|
31
|
+
export function offloadSeatFact(effectiveThreshold) {
|
|
32
|
+
return Number.isFinite(effectiveThreshold) && effectiveThreshold > 0;
|
|
33
|
+
}
|
|
34
|
+
export function questionSeatFact(input) {
|
|
35
|
+
if (input.face)
|
|
36
|
+
return true;
|
|
37
|
+
if (!input.parkStore)
|
|
38
|
+
return false;
|
|
39
|
+
if (input.forceDurableGate === undefined)
|
|
40
|
+
return input.durableApprovalDeclared ? true : undefined;
|
|
41
|
+
return durableParkOptInDeclared({ forceDurableGate: input.forceDurableGate, durableApprovalDeclared: input.durableApprovalDeclared, approvalParkNotResumable: input.approvalParkNotResumable });
|
|
42
|
+
}
|
|
43
|
+
export function envMountFacts(handsEnabled, env) {
|
|
44
|
+
return {
|
|
45
|
+
"env.hands": handsEnabled,
|
|
46
|
+
"env.performsIo": performsIo(env) === true,
|
|
47
|
+
"env.backgroundShell": hasBackgroundShell(env),
|
|
48
|
+
"env.scheduler": hasScheduler(env),
|
|
49
|
+
};
|
|
50
|
+
}
|