@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
package/dist/core/tool-policy.js
CHANGED
|
@@ -3,11 +3,14 @@ import { homedir } from "node:os";
|
|
|
3
3
|
import { argsReadFrom, carryArgsReadFrom, withArgsReading } from "./effective-path-target.js";
|
|
4
4
|
import { editRewrittenSentence, readRejudge, rewriteChasedSentence } from "./rewrite-rejudge.js";
|
|
5
5
|
import { brandPolicyAskClass } from "./ask-class.js";
|
|
6
|
-
import { decisionAskClassesOf, headlessDenialMessage, joinAskReasons, unresolvedAskDenialMessage } from "./ask-origin.js";
|
|
6
|
+
import { ASK_CLASSES, decisionAskClassesOf, headlessDenialMessage, joinAskReasons, MODE_ARBITRATION, unresolvedAskDenialMessage } from "./ask-origin.js";
|
|
7
7
|
import { attest, attestationOf, engineSentenceOf, isEngineAttestation, mergeAttestation, mintAttestation, withAttestation } from "./engine-attestation.js";
|
|
8
8
|
import { ownReadRootCandidate, readRootGrantSeat } from "./read-root-grant-screen.js";
|
|
9
|
+
import { liveWordsOf } from "./approval-words.js";
|
|
9
10
|
import { DECIDED_VIA, decidersNote, isDecidedVia, policyDeciderOf, settledByDecider } from "./gate-outcome.js";
|
|
10
11
|
import { unjudgedAllowRefused } from "./real-approval.js";
|
|
12
|
+
import { receiveMembers } from "./own-property-receipt.js";
|
|
13
|
+
import { isBlankInput } from "./input-author.js";
|
|
11
14
|
export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
|
|
12
15
|
import { sanitizeAutoModeArmingRecipe } from "./auto-mode-arming.js";
|
|
13
16
|
import { join, normalize as normalizePath, sep } from "node:path";
|
|
@@ -38,6 +41,16 @@ export function advertisedWritableRootsSeat(seat) {
|
|
|
38
41
|
export function exemptRootsSeat(exemptRoots) {
|
|
39
42
|
return { exemptRoots };
|
|
40
43
|
}
|
|
44
|
+
export function callFactsSeat(f) {
|
|
45
|
+
return {
|
|
46
|
+
...(f.cwd !== undefined ? { cwd: f.cwd } : {}),
|
|
47
|
+
...(f.root !== undefined ? { root: f.root } : {}),
|
|
48
|
+
...(f.face !== undefined ? { face: f.face } : {}),
|
|
49
|
+
...(f.budget !== undefined ? { budget: f.budget } : {}),
|
|
50
|
+
...advertisedWritableRootsSeat(f.advertisedWritableDirs),
|
|
51
|
+
...(f.exemptRoots !== undefined ? exemptRootsSeat(f.exemptRoots) : {}),
|
|
52
|
+
};
|
|
53
|
+
}
|
|
41
54
|
function settledByNobody(kind) {
|
|
42
55
|
return { kind, who: { party: "none" }, when: Date.now() };
|
|
43
56
|
}
|
|
@@ -79,6 +92,9 @@ export function screenApproverAttribution(v) {
|
|
|
79
92
|
if (APPROVER_REFUSED_CHARS_RE.test(v)) {
|
|
80
93
|
return { defect: "an approver attribution carries control characters, line separators or bidirectional overrides; an identifier whose bytes can forge a line — or reorder what a reader sees — in whatever renders it is refused" };
|
|
81
94
|
}
|
|
95
|
+
if (isBlankInput(v)) {
|
|
96
|
+
return { defect: "an approver attribution of only whitespace names nobody; give an identifier with a visible character, or none at all (an empty string reads as none)" };
|
|
97
|
+
}
|
|
82
98
|
return { approver: v };
|
|
83
99
|
}
|
|
84
100
|
export function screenDecidedVia(v, word) {
|
|
@@ -524,7 +540,7 @@ export function createApprovalPolicy(opts) {
|
|
|
524
540
|
if (signal?.aborted)
|
|
525
541
|
return abortedSeatDeny(req, `approval aborted for "${req.toolName}" (run or turn interrupted)`, "policy");
|
|
526
542
|
if (typeof ok === "object" && ok !== null) {
|
|
527
|
-
const reading = readApproverOutcomeObject(ok, req.toolName, "none");
|
|
543
|
+
const reading = readApproverOutcomeObject(ok, req.toolName, { editLane: "none", takesWords: false, isPolicy: false });
|
|
528
544
|
if (reading.kind === "refused")
|
|
529
545
|
return attest({ action: "deny", message: reading.message }, reading.settlement);
|
|
530
546
|
if (reading.kind === "deny") {
|
|
@@ -777,17 +793,12 @@ export function createUnverifiableDeletePolicy(opts) {
|
|
|
777
793
|
if (typeof command !== "string")
|
|
778
794
|
return ALLOW;
|
|
779
795
|
const removal = removalReadingOf(command, req, opts?.removalSeat, safeRoots);
|
|
780
|
-
return removal === undefined ? ALLOW : removal.judge(signal).then((found) => (found === undefined ? ALLOW : removalAsk(req, found
|
|
796
|
+
return removal === undefined ? ALLOW : removal.judge(signal).then((found) => (found === undefined ? ALLOW : removalAsk(req, found)));
|
|
781
797
|
},
|
|
782
798
|
}, "external_authority");
|
|
783
799
|
}
|
|
784
|
-
function removalAsk(req,
|
|
785
|
-
|
|
786
|
-
dangerous_delete: `Dangerous removal: ${text}. No permission mode, allow rule or classifier clears this — only a person confirming this call does.`,
|
|
787
|
-
unverifiable_delete: `Unverifiable recursive delete (fail-closed unless cleared): ${text}. Re-run the delete with the resolved literal path written into the command itself (or assign the variable a literal path in the same command, e.g. \`DIR=/exact/path; rm -rf "$DIR"\`) so the target can be verified.`,
|
|
788
|
-
unverifiable_shell_text: `Unverifiable shell text (fail-closed unless cleared): ${text}.`,
|
|
789
|
-
};
|
|
790
|
-
return attest({ action: "ask", decisionReason: "safety", requiresRealApproval: true, message: messages[guard] }, req, { guards: [guard] });
|
|
800
|
+
function removalAsk(req, verdict) {
|
|
801
|
+
return attest({ action: "ask", decisionReason: "safety", requiresRealApproval: true, message: verdict.text }, req, { guards: [verdict.guard], sentence: { text: verdict.text, guard: verdict.guard } });
|
|
791
802
|
}
|
|
792
803
|
function pathSegments(p) {
|
|
793
804
|
return p.split(/[\\/]/).filter(Boolean);
|
|
@@ -856,15 +867,13 @@ export function createTranscriptIntegrityPolicy(opts) {
|
|
|
856
867
|
}
|
|
857
868
|
return false;
|
|
858
869
|
};
|
|
859
|
-
const askReason = (req, what) =>
|
|
860
|
-
|
|
861
|
-
decisionReason: "safety",
|
|
862
|
-
requiresRealApproval: true,
|
|
863
|
-
message: `Session-transcript write (fail-closed unless cleared): ${what}. Session transcripts (the .jsonl files ` +
|
|
870
|
+
const askReason = (req, what) => {
|
|
871
|
+
const message = `Session-transcript write (fail-closed unless cleared): ${what}. Session transcripts (the .jsonl files ` +
|
|
864
872
|
`under the agent data dir's sessions/ directory) are harness-written session state, not agent working ` +
|
|
865
873
|
`files — modifying or deleting them tampers with the run's own audit trail. Reading them (ls/cat/grep ` +
|
|
866
|
-
`as a single simple command) is fine
|
|
867
|
-
|
|
874
|
+
`as a single simple command) is fine.`;
|
|
875
|
+
return attest({ action: "ask", decisionReason: "safety", requiresRealApproval: true, message }, req, { guards: ["transcript_write"], sentence: { text: message, guard: "transcript_write" } });
|
|
876
|
+
};
|
|
868
877
|
return brandPolicyAskClass({
|
|
869
878
|
check(req) {
|
|
870
879
|
if (shellToolsListHolds(shellTools, req)) {
|
|
@@ -892,17 +901,71 @@ export function createTranscriptIntegrityPolicy(opts) {
|
|
|
892
901
|
}, "external_authority");
|
|
893
902
|
}
|
|
894
903
|
const delegatedApproverRoot = new WeakMap();
|
|
895
|
-
export function
|
|
904
|
+
export function wrapApprover(onAsk, wrap) {
|
|
896
905
|
if (typeof onAsk !== "function")
|
|
897
906
|
return onAsk;
|
|
898
|
-
const wrapper = (
|
|
907
|
+
const wrapper = wrap(onAsk);
|
|
899
908
|
delegatedApproverRoot.set(wrapper, askApproverIdentity(onAsk));
|
|
900
909
|
return wrapper;
|
|
901
910
|
}
|
|
911
|
+
export function withDelegationProvenance(onAsk, delegation) {
|
|
912
|
+
return wrapApprover(onAsk, (approver) => (req, signal) => (req.delegation !== undefined ? approver(req, signal) : approver({ ...req, delegation }, signal)));
|
|
913
|
+
}
|
|
914
|
+
const policyApprovers = new WeakSet();
|
|
915
|
+
export function asPolicyApprover(fn) {
|
|
916
|
+
if (typeof fn !== "function")
|
|
917
|
+
throw new TypeError(`asPolicyApprover takes an approver function, not ${fn === null ? "null" : typeof fn}`);
|
|
918
|
+
policyApprovers.add(askApproverIdentity(fn));
|
|
919
|
+
return fn;
|
|
920
|
+
}
|
|
921
|
+
export function isPolicyApprover(v) {
|
|
922
|
+
return typeof v === "function" && policyApprovers.has(askApproverIdentity(v));
|
|
923
|
+
}
|
|
924
|
+
const classAnswerTables = new WeakMap();
|
|
925
|
+
const CLASS_ANSWER_KEYS = Object.freeze(["classes", "approver"]);
|
|
926
|
+
const CLASS_ANSWER_WORDS = Object.freeze({ subject: "declareClassAnswers's answers", unit: "member", moment: "at the declaration" });
|
|
927
|
+
export function declareClassAnswers(seat, answers) {
|
|
928
|
+
if (typeof seat !== "function")
|
|
929
|
+
throw new TypeError(`declareClassAnswers takes an approver function, not ${seat === null ? "null" : typeof seat}`);
|
|
930
|
+
if (typeof answers !== "object" || answers === null || Array.isArray(answers))
|
|
931
|
+
throw new TypeError(`declareClassAnswers takes { classes, approver }, not ${answers === null ? "null" : Array.isArray(answers) ? "an array" : typeof answers}`);
|
|
932
|
+
const { classes: declared, approver: named } = receiveMembers(answers, CLASS_ANSWER_WORDS, CLASS_ANSWER_KEYS, (message) => new TypeError(`declareClassAnswers: ${message}`));
|
|
933
|
+
if (!Array.isArray(declared) || declared.length === 0)
|
|
934
|
+
throw new TypeError("declareClassAnswers: `classes` must be a non-empty array of ask classes");
|
|
935
|
+
const listed = Array.from(declared);
|
|
936
|
+
for (const c of listed) {
|
|
937
|
+
if (typeof c !== "string" || !ASK_CLASSES.includes(c))
|
|
938
|
+
throw new TypeError(`declareClassAnswers: ${describeRejectedValue(c)} is not an ask class (ASK_CLASSES)`);
|
|
939
|
+
if (!MODE_ARBITRATION[c].ruleMayClear)
|
|
940
|
+
throw new TypeError(`declareClassAnswers: the ask class "${c}" is one no standing rule may clear (MODE_ARBITRATION.${c}.ruleMayClear is false); a class table may hold only the classes the allow layer itself may answer`);
|
|
941
|
+
}
|
|
942
|
+
const screened = screenApproverAttribution(named);
|
|
943
|
+
if (screened.defect !== undefined)
|
|
944
|
+
throw new TypeError(`declareClassAnswers: \`approver\` refused — ${screened.defect}`);
|
|
945
|
+
if (screened.approver === undefined)
|
|
946
|
+
throw new TypeError("declareClassAnswers: `approver` must name the seat that answers (a non-empty closed word the host owns)");
|
|
947
|
+
const table = Object.freeze({ classes: Object.freeze(ASK_CLASSES.filter((c) => listed.includes(c))), approver: screened.approver });
|
|
948
|
+
const minted = (req, signal) => declaredClassAnswer(minted, req.classes) ?? seat(req, signal);
|
|
949
|
+
classAnswerTables.set(minted, table);
|
|
950
|
+
return minted;
|
|
951
|
+
}
|
|
952
|
+
export function declaredClassAnswer(onAsk, classes) {
|
|
953
|
+
if (typeof onAsk !== "function")
|
|
954
|
+
return undefined;
|
|
955
|
+
const table = classAnswerTables.get(askApproverIdentity(onAsk));
|
|
956
|
+
if (table === undefined || !Array.isArray(classes) || classes.length === 0)
|
|
957
|
+
return undefined;
|
|
958
|
+
if (!classes.every((c) => table.classes.includes(c)))
|
|
959
|
+
return undefined;
|
|
960
|
+
return { allow: true, settledBy: "policy", approver: table.approver };
|
|
961
|
+
}
|
|
962
|
+
export function declaredAnswerClassesOf(onAsk) {
|
|
963
|
+
return typeof onAsk === "function" ? classAnswerTables.get(askApproverIdentity(onAsk))?.classes : undefined;
|
|
964
|
+
}
|
|
902
965
|
export function askApproverIdentity(onAsk) {
|
|
903
966
|
return typeof onAsk === "function" ? (delegatedApproverRoot.get(onAsk) ?? onAsk) : onAsk;
|
|
904
967
|
}
|
|
905
|
-
export function
|
|
968
|
+
export function isAnsweringSeat(onAsk) {
|
|
906
969
|
return typeof onAsk === "function";
|
|
907
970
|
}
|
|
908
971
|
export const DURABLE_MANDATE_SOURCES = Object.freeze(["force_durable_gate", "durable_approval"]);
|
|
@@ -910,12 +973,20 @@ Object.freeze(DURABLE_MANDATE_SOURCES);
|
|
|
910
973
|
export function durableMandateSourceOf(args) {
|
|
911
974
|
if (args.forceDurableGate)
|
|
912
975
|
return "force_durable_gate";
|
|
913
|
-
if (args.durableApprovalDeclared && !
|
|
976
|
+
if (args.durableApprovalDeclared && !isAnsweringSeat(args.onAsk))
|
|
914
977
|
return "durable_approval";
|
|
915
978
|
return undefined;
|
|
916
979
|
}
|
|
917
980
|
export function durableParkOptInDeclared(args) {
|
|
918
|
-
return args.
|
|
981
|
+
return !args.approvalParkNotResumable && (args.durableApprovalDeclared || args.forceDurableGate);
|
|
982
|
+
}
|
|
983
|
+
export function approvalParkNotResumableOf(leg) {
|
|
984
|
+
return leg.delegated && !leg.durableApprovalDeclared;
|
|
985
|
+
}
|
|
986
|
+
export function effectiveDurableApprovalOf(args) {
|
|
987
|
+
if (!durableParkOptInDeclared({ forceDurableGate: args.forceDurableGate, durableApprovalDeclared: args.declared !== undefined, approvalParkNotResumable: args.approvalParkNotResumable }))
|
|
988
|
+
return undefined;
|
|
989
|
+
return args.declared ?? { scope: args.scope };
|
|
919
990
|
}
|
|
920
991
|
export function tryCloneArgs(v) {
|
|
921
992
|
try {
|
|
@@ -1131,15 +1202,23 @@ export function carriesBidiControls(value, limits) {
|
|
|
1131
1202
|
return false;
|
|
1132
1203
|
}
|
|
1133
1204
|
}
|
|
1205
|
+
export function cardCarriesBidiControls(card) {
|
|
1206
|
+
return carriesBidiControls(card.args) || carriesBidiControls(card.preview) || carriesBidiControls(card.existingTarget);
|
|
1207
|
+
}
|
|
1134
1208
|
export async function resolveAsk(req, onAsk, signal, onLateSettlement) {
|
|
1135
1209
|
return resolveAskFor(req, onAsk, signal, onLateSettlement, undefined);
|
|
1136
1210
|
}
|
|
1137
|
-
export async function resolveAskFor(req, onAsk, signal, onLateSettlement, asked) {
|
|
1211
|
+
export async function resolveAskFor(req, onAsk, signal, onLateSettlement, asked, onApproverDefect, approvalWords) {
|
|
1138
1212
|
const askedDigest = exactBoundInputHashOf(req.toolName, req.args);
|
|
1139
1213
|
const question = asked !== undefined ? engineSentenceOf(asked, req) : undefined;
|
|
1140
|
-
const { settlement, bindingRefusal, quotesQuestion, ...r } = await resolveAskArms(req, onAsk, signal, onLateSettlement);
|
|
1214
|
+
const { settlement, bindingRefusal, quotesQuestion, feedback: words, ...r } = await resolveAskArms(req, onAsk, signal, onLateSettlement, approvalWords !== undefined);
|
|
1215
|
+
if (words !== undefined)
|
|
1216
|
+
await approvalWords?.(words);
|
|
1141
1217
|
if (settlement === undefined)
|
|
1142
1218
|
return r;
|
|
1219
|
+
if (onApproverDefect !== undefined && (settlement.kind === "approver_error" || settlement.kind === "approver_contract")) {
|
|
1220
|
+
onApproverDefect({ cause: settlement.kind === "approver_error" ? "threw" : "out_of_contract", seat: isPolicyApprover(onAsk) ? "policy" : "approver" });
|
|
1221
|
+
}
|
|
1143
1222
|
const echoed = quotesQuestion === true && question?.echoed !== undefined && req.message === question.text && r.message !== undefined ? question.echoed : undefined;
|
|
1144
1223
|
const licensedDigest = r.action === "allow" && r.updatedInput !== undefined ? exactBoundInputHashOf(req.toolName, r.updatedInput) : r.presentedInput !== undefined ? exactBoundInputHashOf(req.toolName, r.presentedInput) : askedDigest;
|
|
1145
1224
|
return attest(r, req, { settlement, ...(req.origin !== undefined ? { origin: req.origin } : {}), ...(req.classes !== undefined ? { classes: req.classes } : {}), ...(licensedDigest !== undefined ? { inputDigest: licensedDigest } : {}), ...(bindingRefusal !== undefined ? { bindingRefusal } : {}), ...(echoed !== undefined ? { sentence: { text: r.message, echoed } } : {}) });
|
|
@@ -1189,7 +1268,7 @@ function detachLateAskWait(wait, onLate) {
|
|
|
1189
1268
|
})
|
|
1190
1269
|
.catch(() => undefined);
|
|
1191
1270
|
}
|
|
1192
|
-
function readApproverOutcomeObject(ok, toolName,
|
|
1271
|
+
function readApproverOutcomeObject(ok, toolName, seat) {
|
|
1193
1272
|
const refused = (message, settlement) => ({ kind: "refused", message, settlement });
|
|
1194
1273
|
let supplied;
|
|
1195
1274
|
let allowed;
|
|
@@ -1197,6 +1276,7 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1197
1276
|
let suppliedApprover;
|
|
1198
1277
|
let suppliedVia;
|
|
1199
1278
|
let grant;
|
|
1279
|
+
let feedback;
|
|
1200
1280
|
try {
|
|
1201
1281
|
supplied = ok.settledBy;
|
|
1202
1282
|
allowed = ok.allow;
|
|
@@ -1204,6 +1284,7 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1204
1284
|
suppliedApprover = ok.approver;
|
|
1205
1285
|
suppliedVia = ok.decidedVia;
|
|
1206
1286
|
grant = ok.readRootGrant;
|
|
1287
|
+
feedback = ok.feedback;
|
|
1207
1288
|
}
|
|
1208
1289
|
catch (err) {
|
|
1209
1290
|
return refused(`the approver's outcome for "${toolName}" could not be read (${describeThrown(err)}) — denied fail-closed`, settledByNobody("approver_contract"));
|
|
@@ -1225,10 +1306,14 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1225
1306
|
if (via.defect !== undefined) {
|
|
1226
1307
|
return refused(`the approver for "${toolName}" reported a decidedVia this seam refuses: ${via.defect}; denied fail-closed`, settledByNobody("approver_contract"));
|
|
1227
1308
|
}
|
|
1228
|
-
if (editLane === "none" && grant !== undefined) {
|
|
1309
|
+
if (seat.editLane === "none" && grant !== undefined) {
|
|
1229
1310
|
return refused(`the approver for "${toolName}" attached a readRootGrant on a seat that offers no directory — denied fail-closed (a grant answers an approval card's readRootCandidate)`, settledByNobody("approver_contract"));
|
|
1230
1311
|
}
|
|
1231
1312
|
const decider = settledWord === "policy" ? "policy" : settledWord === "human" ? "person" : undefined;
|
|
1313
|
+
const live = liveWordsOf(feedback, { toolName, allowed, byPerson: decider === "person" && !seat.isPolicy, hasCarrier: seat.takesWords });
|
|
1314
|
+
if (live.kind === "refused")
|
|
1315
|
+
return refused(live.message, settledByNobody("approver_contract"));
|
|
1316
|
+
const words = live.words;
|
|
1232
1317
|
if (allowed !== true) {
|
|
1233
1318
|
let reasonText;
|
|
1234
1319
|
try {
|
|
@@ -1258,8 +1343,8 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1258
1343
|
`(report "${settledWord}" with allow:false; a person's allow is settledBy "human"/omitted, the deployment policy's is "policy")`, settledByNobody("approver_contract"));
|
|
1259
1344
|
}
|
|
1260
1345
|
if (suppliedEdit === undefined)
|
|
1261
|
-
return { kind: "allow", edit: undefined, settlement: settledByDecider(decider, "allowed", attribution.approver), grant };
|
|
1262
|
-
if (editLane === "none") {
|
|
1346
|
+
return { kind: "allow", edit: undefined, settlement: settledByDecider(decider, "allowed", attribution.approver), grant, words };
|
|
1347
|
+
if (seat.editLane === "none") {
|
|
1263
1348
|
return refused(`the approver for "${toolName}" attached an edit (updatedInput) on a seat that has no lane to adjudicate one — ` +
|
|
1264
1349
|
`this seat's answer is the deployment POLICY's verdict, and an edit arriving through it would execute without the ` +
|
|
1265
1350
|
`re-adjudication an approver's edit gets; denied fail-closed (approve or refuse what was shown, and route edits ` +
|
|
@@ -1268,9 +1353,9 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1268
1353
|
const edit = bindableArgsOf(toolName, suppliedEdit);
|
|
1269
1354
|
if (!edit.ok)
|
|
1270
1355
|
return { kind: "refused", message: edit.refusal, settlement: settledByNobody("presentation_failed"), binding: true };
|
|
1271
|
-
return { kind: "allow", edit: { value: edit.value }, settlement: settledByDecider(decider, "allowed", attribution.approver), grant };
|
|
1356
|
+
return { kind: "allow", edit: { value: edit.value }, settlement: settledByDecider(decider, "allowed", attribution.approver), grant, words };
|
|
1272
1357
|
}
|
|
1273
|
-
async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
|
|
1358
|
+
async function resolveAskArms(req, onAsk, signal, onLateSettlement, takesWords = false) {
|
|
1274
1359
|
if (onAsk === "allow") {
|
|
1275
1360
|
if (req.requiresRealApproval === true)
|
|
1276
1361
|
return { ...unjudgedAllowRefused(req, "blanket"), ...quotingQuestion };
|
|
@@ -1293,48 +1378,52 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
|
|
|
1293
1378
|
if (!presented.ok)
|
|
1294
1379
|
return { action: "deny", message: presented.refusal, decisionReason: "mode", settlement: settledByNobody("presentation_failed"), bindingRefusal: presented.refusal };
|
|
1295
1380
|
const offered = ownReadRootCandidate(req.readRootCandidate);
|
|
1381
|
+
const declared = declaredClassAnswer(onAsk, req.classes);
|
|
1296
1382
|
let ok;
|
|
1297
|
-
|
|
1298
|
-
|
|
1299
|
-
|
|
1300
|
-
|
|
1301
|
-
|
|
1302
|
-
|
|
1303
|
-
|
|
1304
|
-
|
|
1305
|
-
|
|
1306
|
-
|
|
1307
|
-
|
|
1308
|
-
|
|
1309
|
-
|
|
1310
|
-
|
|
1311
|
-
|
|
1312
|
-
|
|
1383
|
+
if (declared !== undefined)
|
|
1384
|
+
ok = declared;
|
|
1385
|
+
else
|
|
1386
|
+
try {
|
|
1387
|
+
const approverView = { value: structuredClone(presented.value) };
|
|
1388
|
+
const reconciliationHash = exactBoundInputHashOf(req.toolName, presented.value);
|
|
1389
|
+
const bidi = cardCarriesBidiControls({ args: presented.value, preview: req.preview, existingTarget: req.existingTarget });
|
|
1390
|
+
const { hasBidiControls: _carried, boundInputHash: _claimed, ...bare } = req;
|
|
1391
|
+
const wait = Promise.resolve(onAsk({
|
|
1392
|
+
...bare,
|
|
1393
|
+
...(reconciliationHash !== undefined ? { boundInputHash: reconciliationHash } : {}),
|
|
1394
|
+
args: approverView.value,
|
|
1395
|
+
...(bidi ? { hasBidiControls: true } : {}),
|
|
1396
|
+
...(offered !== undefined ? { readRootCandidate: { ...offered } } : {}),
|
|
1397
|
+
}, signal));
|
|
1398
|
+
const windowMs = req.denialLimitFallback !== undefined && req.denialLimitFallback.autoDenyAfterMs > 0 ? req.denialLimitFallback.autoDenyAfterMs : undefined;
|
|
1399
|
+
const raced = await withTimeout(raceAskWaitAgainstSignal(wait, signal), windowMs, () => DEADLINE_ELAPSED);
|
|
1400
|
+
if (raced === DEADLINE_ELAPSED) {
|
|
1401
|
+
detachLateAskWait(wait, onLateSettlement);
|
|
1402
|
+
return {
|
|
1403
|
+
action: "deny",
|
|
1404
|
+
message: `no one answered the classifier denial-limit approval for "${req.toolName}" — the ${String(windowMs)}ms window ` +
|
|
1405
|
+
`elapsed with no answer; auto-denied: ${req.message}`,
|
|
1406
|
+
decisionReason: "mode",
|
|
1407
|
+
settlement: { kind: "denial_limit_window_expired", who: { party: "engine", window: "denial_limit" }, when: Date.now() },
|
|
1408
|
+
...quotingQuestion,
|
|
1409
|
+
};
|
|
1410
|
+
}
|
|
1411
|
+
if (raced.tag === "aborted") {
|
|
1412
|
+
detachLateAskWait(wait, onLateSettlement);
|
|
1413
|
+
return { action: "deny", message: `approval aborted for "${req.toolName}" (run or turn interrupted)`, decisionReason: "mode", settlement: settledByNobody("task_aborted") };
|
|
1414
|
+
}
|
|
1415
|
+
if (raced.tag === "threw")
|
|
1416
|
+
throw raced.error;
|
|
1417
|
+
ok = raced.value;
|
|
1418
|
+
}
|
|
1419
|
+
catch (err) {
|
|
1313
1420
|
return {
|
|
1314
1421
|
action: "deny",
|
|
1315
|
-
message: `
|
|
1316
|
-
`elapsed with no answer; auto-denied: ${req.message}`,
|
|
1422
|
+
message: `approval errored for "${req.toolName}": ${describeThrown(err)}`,
|
|
1317
1423
|
decisionReason: "mode",
|
|
1318
|
-
settlement:
|
|
1319
|
-
...quotingQuestion,
|
|
1424
|
+
settlement: settledByNobody("approver_error"),
|
|
1320
1425
|
};
|
|
1321
1426
|
}
|
|
1322
|
-
if (raced.tag === "aborted") {
|
|
1323
|
-
detachLateAskWait(wait, onLateSettlement);
|
|
1324
|
-
return { action: "deny", message: `approval aborted for "${req.toolName}" (run or turn interrupted)`, decisionReason: "mode", settlement: settledByNobody("task_aborted") };
|
|
1325
|
-
}
|
|
1326
|
-
if (raced.tag === "threw")
|
|
1327
|
-
throw raced.error;
|
|
1328
|
-
ok = raced.value;
|
|
1329
|
-
}
|
|
1330
|
-
catch (err) {
|
|
1331
|
-
return {
|
|
1332
|
-
action: "deny",
|
|
1333
|
-
message: `approval errored for "${req.toolName}": ${describeThrown(err)}`,
|
|
1334
|
-
decisionReason: "mode",
|
|
1335
|
-
settlement: settledByNobody("approver_error"),
|
|
1336
|
-
};
|
|
1337
|
-
}
|
|
1338
1427
|
if (signal?.aborted) {
|
|
1339
1428
|
return { action: "deny", message: `approval aborted for "${req.toolName}" (run or turn interrupted)`, decisionReason: "mode", settlement: settledByNobody("task_aborted") };
|
|
1340
1429
|
}
|
|
@@ -1348,11 +1437,12 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
|
|
|
1348
1437
|
...quotingQuestion,
|
|
1349
1438
|
};
|
|
1350
1439
|
}
|
|
1440
|
+
const allowWithoutAPerson = (party) => req.requiresRealApproval === true && (party === "policy" || isPolicyApprover(onAsk));
|
|
1351
1441
|
if (typeof ok === "object" && ok !== null) {
|
|
1352
|
-
const reading = readApproverOutcomeObject(ok, req.toolName, "readjudicated");
|
|
1442
|
+
const reading = readApproverOutcomeObject(ok, req.toolName, { editLane: "readjudicated", takesWords, isPolicy: isPolicyApprover(onAsk) });
|
|
1353
1443
|
if (reading.kind === "refused")
|
|
1354
1444
|
return { action: "deny", message: reading.message, decisionReason: "mode", settlement: reading.settlement, ...(reading.binding === true ? { bindingRefusal: reading.message } : {}) };
|
|
1355
|
-
if (reading.kind === "allow" && reading.settlement.who.party
|
|
1445
|
+
if (reading.kind === "allow" && allowWithoutAPerson(reading.settlement.who.party)) {
|
|
1356
1446
|
return { ...unjudgedAllowRefused(req, "policy"), ...quotingQuestion, ...readRootGrantSeat(reading.grant, offered, false) };
|
|
1357
1447
|
}
|
|
1358
1448
|
const grantSeat = readRootGrantSeat(reading.grant, offered, reading.kind === "allow");
|
|
@@ -1370,13 +1460,17 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
|
|
|
1370
1460
|
...grantSeat,
|
|
1371
1461
|
};
|
|
1372
1462
|
}
|
|
1463
|
+
const words = reading.words !== undefined ? { feedback: reading.words } : {};
|
|
1373
1464
|
if (reading.edit === undefined)
|
|
1374
|
-
return { action: "allow", decisionReason: "mode", presentedInput: presented.value, settlement: reading.settlement, ...grantSeat };
|
|
1375
|
-
return { action: "allow", updatedInput: reading.edit.value, decisionReason: "mode", settlement: reading.settlement, ...grantSeat };
|
|
1465
|
+
return { action: "allow", decisionReason: "mode", presentedInput: presented.value, settlement: reading.settlement, ...grantSeat, ...words };
|
|
1466
|
+
return { action: "allow", updatedInput: reading.edit.value, decisionReason: "mode", settlement: reading.settlement, ...grantSeat, ...words };
|
|
1376
1467
|
}
|
|
1377
1468
|
const okRaw = ok;
|
|
1378
|
-
if (okRaw === true)
|
|
1469
|
+
if (okRaw === true) {
|
|
1470
|
+
if (allowWithoutAPerson("person"))
|
|
1471
|
+
return { ...unjudgedAllowRefused(req, "policy"), ...quotingQuestion };
|
|
1379
1472
|
return { action: "allow", decisionReason: "mode", presentedInput: presented.value, settlement: settledByDecider("person", "allowed", undefined) };
|
|
1473
|
+
}
|
|
1380
1474
|
if (okRaw !== false) {
|
|
1381
1475
|
return {
|
|
1382
1476
|
action: "deny",
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The static tool catalog's READ FACE (design/388 §2.1): `describeToolCatalog()` and the predicates
|
|
3
3
|
* every former name table is now DERIVED from. Readable without an env, a deps object or a tool
|
|
4
|
-
* instance — a
|
|
5
|
-
*
|
|
4
|
+
* instance — a policy module derives its covered set from it, a shell renders it. (Which definitions a leg MOUNTS is the
|
|
5
|
+
* mount table's answer, `describeStaticWiring(deps, spec).toolPlan`, not the catalog's.)
|
|
6
6
|
*
|
|
7
7
|
* Every predicate here answers over DEFINITIONS and folds to names with "any definition under this
|
|
8
8
|
* name matches" — the rule that pins the two fail-open shapes a per-name table had (one name, two
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*
|
|
11
11
|
* Layer-0 vocabulary: depends on the leaf catalog and the face vocabulary only.
|
|
12
12
|
*/
|
|
13
|
-
import { type ToolCallPathTarget, type ToolCatalogEntry, type ToolFamily, type ToolHostTarget, type
|
|
13
|
+
import { type ToolCallPathTarget, type ToolCatalogEntry, type ToolFamily, type ToolHostTarget, type ToolPathAccess } from "./tool-face.js";
|
|
14
14
|
/** The whole static catalog, one frozen row per definition (design/388 §2.1 `describeToolCatalog()`).
|
|
15
15
|
* Replaces the retired name-keyed exports `HAND_TOOL_EFFECTS` / `DEFAULT_BUDGET_EXEMPT_TOOLS` /
|
|
16
16
|
* `COMPACTABLE_TOOLS`: filter this instead (`e.mountedBy.includes("hands")`, `e.face.budgetExempt`,
|
|
@@ -21,7 +21,7 @@ export declare function catalogEntriesNamed(name: string): readonly ToolCatalogE
|
|
|
21
21
|
/** Every wire name the catalog knows, aliases included (a set — the two shells fold to one name). */
|
|
22
22
|
export declare function catalogToolNames(): ReadonlySet<string>;
|
|
23
23
|
/** A-11/12/13/14 — tools this engine can CONFINE BY PATH on a write: `pathTarget.access ≠ read`.
|
|
24
|
-
* Today {Write, Edit, NotebookEdit}. */
|
|
24
|
+
* Today {Write, Edit, NotebookEdit, SaveToolResult}. */
|
|
25
25
|
export declare function pathConfinableWriteToolNames(): ReadonlySet<string>;
|
|
26
26
|
/**
|
|
27
27
|
* What the persistence judge reads off ONE tool: its name and the three face members (all optional — a mounted
|
|
@@ -191,13 +191,6 @@ export declare function handBandEffects(): ReadonlyMap<string, NonNullable<ToolC
|
|
|
191
191
|
/** A-3 / L4 — every `details.type` card the engine owns: the catalog's per-definition cards plus the
|
|
192
192
|
* engine-minted ones (protocol channels, fs refusals). */
|
|
193
193
|
export declare function engineCardTypes(): ReadonlySet<string>;
|
|
194
|
-
/**
|
|
195
|
-
* L3 — the STATIC PREDICTION of a leg's core-mounted names for a set of active mount conditions:
|
|
196
|
-
* every definition listed under at least one active tag. `scenario` and `optional` definitions mount
|
|
197
|
-
* only when the vector names their tag (a host factory / a per-task opt-in decides them). Names are
|
|
198
|
-
* folded (the two shells predict one `Bash`).
|
|
199
|
-
*/
|
|
200
|
-
export declare function predictMountedToolNames(active: ReadonlySet<ToolMountTag>): ReadonlySet<string>;
|
|
201
194
|
/** The closed set as a Set, for callers that validate a tag read off the wire. */
|
|
202
195
|
export declare const TOOL_MOUNT_TAG_SET: ReadonlySet<string>;
|
|
203
196
|
export { HANDS_BAND_TAGS, MOUNT_TAG_IN_HANDS_BAND } from "./tool-face.js";
|
|
@@ -167,8 +167,5 @@ export function engineCardTypes() {
|
|
|
167
167
|
out.add(card);
|
|
168
168
|
return out;
|
|
169
169
|
}
|
|
170
|
-
export function predictMountedToolNames(active) {
|
|
171
|
-
return names((e) => e.mountedBy.some((t) => active.has(t)));
|
|
172
|
-
}
|
|
173
170
|
export const TOOL_MOUNT_TAG_SET = new Set(TOOL_MOUNT_TAGS);
|
|
174
171
|
export { HANDS_BAND_TAGS, MOUNT_TAG_IN_HANDS_BAND } from "./tool-face.js";
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bytes a tool result carried that the model cannot receive as content, kept as an entry of the run's offload store (its byte
|
|
3
|
+
* arm, `ToolResultStore.putBytes`) and named to the model by ref: the same holder, the same lifetime (the session's deletion, the
|
|
4
|
+
* store's age bound, its orphan leg) and the same reference form as an offloaded text result. Two suppliers reach the one keep:
|
|
5
|
+
* a media block the tool-result seat refused for its SIZE (`image-admission.ts`), and an MCP server's binary content that is not
|
|
6
|
+
* media the model reads (an audio block, a resource blob of another type; `mcp.ts`).
|
|
7
|
+
*
|
|
8
|
+
* A keep answers one of two things: kept (the ref), or not kept for one reason of a closed set. The line the model reads is made
|
|
9
|
+
* of those words only — never a store's error text, which names the store's own paths; that text goes to the operator's account.
|
|
10
|
+
* Nothing falls back to a directory of the engine's host: a second holder is a second lifetime nobody deletes.
|
|
11
|
+
*
|
|
12
|
+
* A leaf (no value import): the media admission reaches the keep through a {@link ToolResultBytesKeeper} it is handed, so its
|
|
13
|
+
* evaluation stays below the store, the tools and the prompt assembly the store's own tool face loads.
|
|
14
|
+
*/
|
|
15
|
+
import type { ToolResultStore } from "./tool-result-store.js";
|
|
16
|
+
/** The longest claimed media type a sentence repeats; a longer one is named by its length. Long enough for the registered names a
|
|
17
|
+
* binary result really carries (office document types run to 73 characters, their part types past 80), short enough that a
|
|
18
|
+
* "type" carries no paragraph. */
|
|
19
|
+
export declare const MEDIA_TYPE_ECHO_MAX = 100;
|
|
20
|
+
/**
|
|
21
|
+
* A claimed media type as a sentence may repeat it: only when it can be one (RFC 6838 restricted names: no space, at most
|
|
22
|
+
* 127 characters a side) and is at most {@link MEDIA_TYPE_ECHO_MAX} characters — a "type" is never a carrier for text.
|
|
23
|
+
* `undefined` otherwise.
|
|
24
|
+
*/
|
|
25
|
+
export declare function mediaTypeEcho(mime: unknown): string | undefined;
|
|
26
|
+
/** A claimed media type in a sentence: the type itself when {@link mediaTypeEcho} repeats it, else its length, else
|
|
27
|
+
* `unknown type` when none was claimed. */
|
|
28
|
+
export declare function mediaTypePhrase(mime: unknown): string;
|
|
29
|
+
/** The largest single piece of bytes a run keeps (100 MiB, the reference's per-blob persist bound); a larger one is not kept. */
|
|
30
|
+
export declare const TOOL_RESULT_BYTES_KEEP_LIMIT = 104857600;
|
|
31
|
+
/** The tool that writes kept bytes into a file of the run's environment (mounted beside the run's write tools). */
|
|
32
|
+
export declare const SAVE_TOOL_RESULT_NAME = "SaveToolResult";
|
|
33
|
+
/** Why bytes were not kept — the closed set every model-visible "not kept" line is made of:
|
|
34
|
+
* `no_byte_store` (the run has no offload store, or its store has no byte arm), `over_limit` (over
|
|
35
|
+
* {@link TOOL_RESULT_BYTES_KEEP_LIMIT}), `store_failed` (the store's write threw). */
|
|
36
|
+
export type BytesNotKeptReason = "no_byte_store" | "over_limit" | "store_failed";
|
|
37
|
+
/** What keeping one piece of bytes came to, as the operator's account carries it: its size, its claimed type when
|
|
38
|
+
* {@link mediaTypeEcho} repeats it, and either the ref it is kept under or why it is not (with the store's own error text when
|
|
39
|
+
* the store refused it — that text is the operator's, never the model's). */
|
|
40
|
+
export type KeptBytes = {
|
|
41
|
+
readonly bytes: number;
|
|
42
|
+
readonly mimeType?: string;
|
|
43
|
+
readonly ref: string;
|
|
44
|
+
} | {
|
|
45
|
+
readonly bytes: number;
|
|
46
|
+
readonly mimeType?: string;
|
|
47
|
+
readonly notKept: "no_byte_store" | "over_limit";
|
|
48
|
+
} | {
|
|
49
|
+
readonly bytes: number;
|
|
50
|
+
readonly mimeType?: string;
|
|
51
|
+
readonly notKept: "store_failed";
|
|
52
|
+
readonly saveError: string;
|
|
53
|
+
};
|
|
54
|
+
/** Whether the run's model can write kept bytes into a file: {@link SAVE_TOOL_RESULT_NAME} callable now, mounted but not active yet
|
|
55
|
+
* (behind the tool search), or not mounted at all (no offload store with a byte arm, no write hands, or the leg's valve). */
|
|
56
|
+
export type SaveToolResultReach = "callable" | "deferred" | "absent";
|
|
57
|
+
/** The reach of {@link SAVE_TOOL_RESULT_NAME} over a run's tools as its valve leaves them (`mounted`) and the set callable now
|
|
58
|
+
* (`callable`; `undefined` when the run defers nothing, so every mounted tool is callable). */
|
|
59
|
+
export declare function saveToolResultReach(mounted: readonly {
|
|
60
|
+
readonly name: string;
|
|
61
|
+
}[], callable: ReadonlySet<string> | undefined): SaveToolResultReach;
|
|
62
|
+
/**
|
|
63
|
+
* Where a run keeps bytes: the offload store and the session its refs are minted under (absent store ⇒ nothing is kept), and how
|
|
64
|
+
* the run's model can write kept bytes to a file (absent ⇒ it cannot). Plain data — a library caller wiring a tool surface itself
|
|
65
|
+
* hands its own store here; a seat it does not hand over keeps nothing.
|
|
66
|
+
*/
|
|
67
|
+
export interface ToolResultBytesSeat {
|
|
68
|
+
readonly store?: ToolResultStore;
|
|
69
|
+
readonly sessionId: string;
|
|
70
|
+
readonly saveReach?: () => SaveToolResultReach;
|
|
71
|
+
}
|
|
72
|
+
/** The facts every {@link KeptBytes} carries for one piece: its size, and its claimed type when {@link mediaTypeEcho} repeats it. */
|
|
73
|
+
export declare function keptBytesFacts(bytes: Uint8Array, mimeType: unknown): {
|
|
74
|
+
readonly bytes: number;
|
|
75
|
+
readonly mimeType?: string;
|
|
76
|
+
};
|
|
77
|
+
/** The clause a model-visible line ends with for bytes that were NOT kept — the reason's closed words and numbers only (the
|
|
78
|
+
* kept clause, which names the ref and how the run can write it to a file, is `keptBytesClause` in `tool-result-store.ts`). */
|
|
79
|
+
export declare function notKeptClause(kept: Exclude<KeptBytes, {
|
|
80
|
+
readonly ref: string;
|
|
81
|
+
}>): string;
|
|
82
|
+
/** What keeping one piece of bytes came to, and the clause the line naming it ends with. */
|
|
83
|
+
export interface KeptBytesAnswer {
|
|
84
|
+
readonly kept: KeptBytes;
|
|
85
|
+
readonly clause: string;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* One call's keep, as a supplier of bytes reaches it: keep a piece (claimed `mimeType`) and answer what came of it. The one
|
|
89
|
+
* keeper is `toolResultBytesKeeper(seat, toolCallId)` (`tool-result-store.ts`), which binds the one keep and the one wording to a
|
|
90
|
+
* run's seat and the call the bytes came back from; a supplier handed none keeps nothing ({@link keepBytesWith}).
|
|
91
|
+
*/
|
|
92
|
+
export type ToolResultBytesKeeper = (bytes: Uint8Array, mimeType: unknown) => Promise<KeptBytesAnswer>;
|
|
93
|
+
/** What `keeper` answers for `bytes` — or, with no keeper, that they were not kept for want of a byte store. */
|
|
94
|
+
export declare function keepBytesWith(keeper: ToolResultBytesKeeper | undefined, bytes: Uint8Array, mimeType: unknown): Promise<KeptBytesAnswer>;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export const MEDIA_TYPE_ECHO_MAX = 100;
|
|
2
|
+
export function mediaTypeEcho(mime) {
|
|
3
|
+
return typeof mime === "string" && mime.length <= MEDIA_TYPE_ECHO_MAX && /^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]{0,126}$/.test(mime) ? mime : undefined;
|
|
4
|
+
}
|
|
5
|
+
export function mediaTypePhrase(mime) {
|
|
6
|
+
const echo = mediaTypeEcho(mime);
|
|
7
|
+
if (echo !== undefined)
|
|
8
|
+
return echo;
|
|
9
|
+
return typeof mime === "string" && mime !== "" ? `a ${[...mime].length}-character type` : "unknown type";
|
|
10
|
+
}
|
|
11
|
+
export const TOOL_RESULT_BYTES_KEEP_LIMIT = 104_857_600;
|
|
12
|
+
export const SAVE_TOOL_RESULT_NAME = "SaveToolResult";
|
|
13
|
+
export function saveToolResultReach(mounted, callable) {
|
|
14
|
+
if (!mounted.some((t) => t.name === SAVE_TOOL_RESULT_NAME))
|
|
15
|
+
return "absent";
|
|
16
|
+
return callable === undefined || callable.has(SAVE_TOOL_RESULT_NAME) ? "callable" : "deferred";
|
|
17
|
+
}
|
|
18
|
+
export function keptBytesFacts(bytes, mimeType) {
|
|
19
|
+
const echo = mediaTypeEcho(mimeType);
|
|
20
|
+
return { bytes: bytes.byteLength, ...(echo !== undefined ? { mimeType: echo } : {}) };
|
|
21
|
+
}
|
|
22
|
+
export function notKeptClause(kept) {
|
|
23
|
+
if (kept.notKept === "no_byte_store")
|
|
24
|
+
return "its bytes were not kept: this run keeps no binary tool results";
|
|
25
|
+
if (kept.notKept === "over_limit")
|
|
26
|
+
return `its bytes were not kept: ${kept.bytes} bytes is over the ${TOOL_RESULT_BYTES_KEEP_LIMIT}-byte keep limit`;
|
|
27
|
+
return "its bytes were not kept: the tool-result store could not take them";
|
|
28
|
+
}
|
|
29
|
+
export function keepBytesWith(keeper, bytes, mimeType) {
|
|
30
|
+
if (keeper !== undefined)
|
|
31
|
+
return keeper(bytes, mimeType);
|
|
32
|
+
const kept = { ...keptBytesFacts(bytes, mimeType), notKept: "no_byte_store" };
|
|
33
|
+
return Promise.resolve({ kept, clause: notKeptClause(kept) });
|
|
34
|
+
}
|