@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
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { AgentTool } from "../internal/harness-types.js";
|
|
2
2
|
import { type RetentionDeclaration } from "./retention.js";
|
|
3
|
+
import { type KeptBytes, type ToolResultBytesKeeper, type ToolResultBytesSeat } from "./tool-result-bytes.js";
|
|
3
4
|
/**
|
|
4
5
|
* Pluggable backing store for **offloaded large tool results** (design/30). When a tool returns more
|
|
5
6
|
* text than the threshold, the full content is moved here and the conversation keeps only a preview +
|
|
@@ -166,10 +167,12 @@ export interface ToolResultStore {
|
|
|
166
167
|
* `sessionId`, as the ref and the owner recorded at its winning write. Without it the offloaded results a session's transcript
|
|
167
168
|
* points at have no way out of a store, so a session moved to another store reads references it cannot dereference.
|
|
168
169
|
*
|
|
169
|
-
* The listing is the whole of the export:
|
|
170
|
-
*
|
|
171
|
-
*
|
|
172
|
-
*
|
|
170
|
+
* The listing is the whole of the export: each listed ref is read the one way every reader reads a ref ({@link bytesOf}'s
|
|
171
|
+
* dispatch rule: text through {@link get}, bounded slices with `totalChars` saying how much; failing that, bytes through
|
|
172
|
+
* {@link bytesOf}) and lands in the other store through the matching write (`put` / `putBytes`, with `entry.provenance`) — that
|
|
173
|
+
* store's write-once election makes a repeated move an idempotent no-op and a ref that already belongs to a different owner a
|
|
174
|
+
* typed refusal ({@link ToolResultRefConflictError}). A destination with no byte arm cannot take a byte entry: the mover counts it
|
|
175
|
+
* and says so, and the transcript's ref to it reads as absent in the new store.
|
|
173
176
|
*
|
|
174
177
|
* Rules every implementation follows, the same selection as {@link deleteBySession}:
|
|
175
178
|
* - **selection is by RECORDED PROVENANCE, never by parsing the ref**; `taskId` is ignored in the match (the entry's
|
|
@@ -187,7 +190,48 @@ export interface ToolResultStore {
|
|
|
187
190
|
* contract breach. Implementing it does NOT make a store `retention: "managed"`.
|
|
188
191
|
*/
|
|
189
192
|
listBySession?(sessionId: string): Promise<ToolResultSessionListing> | ToolResultSessionListing;
|
|
193
|
+
/**
|
|
194
|
+
* The BYTE ARM's write: store binary content a tool result carried (bytes the model cannot receive as content) under `ref`, as an
|
|
195
|
+
* entry of this store like any other — the same owner record, the same age, the same sweeps. Its rules:
|
|
196
|
+
* - **one ref, one entry, of one kind**: the write-once election {@link put} runs decides bytes too, across kinds — a
|
|
197
|
+
* `putBytes` on a ref that holds text, or a `put` on a ref that holds bytes, is the typed refusal
|
|
198
|
+
* ({@link ToolResultRefConflictError}, with its `kinds`), never a second entry under one key; a repeat on a ref that holds
|
|
199
|
+
* bytes is the idempotent no-op under the owner rules {@link put} states;
|
|
200
|
+
* - **`provenance` is required**: an engine write always has its session, and a byte entry with no owner is reachable only by
|
|
201
|
+
* an interrupted write or a foreign writer — the orphan leg's ({@link deleteUnattributable});
|
|
202
|
+
* - `mediaType` (the claimed type, in the form a sentence may repeat) is stored with the entry and answered by {@link bytesOf};
|
|
203
|
+
* - **a store with this member implements {@link deleteBySession}**: bytes a session's tools produced must leave with the
|
|
204
|
+
* session; the contract kit refuses the one without the other;
|
|
205
|
+
* - **every sweep reads a byte entry as an entry**: {@link deleteBySession}, {@link reap}, {@link deleteUnattributable} and
|
|
206
|
+
* {@link listBySession} select, age and count it exactly as they do a text entry — its lifetime is the store's, not a second
|
|
207
|
+
* one.
|
|
208
|
+
*
|
|
209
|
+
* Optional, and an OPTIONAL leg of the contract kit (`toolResultStoreContract`, reported through `onOptionalMember`): absent ⇒ the
|
|
210
|
+
* run keeps no binary tool results, and says so where the bytes would have been. The bundled in-memory store does not implement it.
|
|
211
|
+
*/
|
|
212
|
+
putBytes?(ref: string, bytes: Uint8Array, provenance: ToolResultProvenance, mediaType?: string): Promise<void> | void;
|
|
213
|
+
/**
|
|
214
|
+
* The BYTE ARM's read: the byte entry stored under `ref` — its length and stored media type, and its bytes on demand (a reader that
|
|
215
|
+
* describes an entry never has to load it) — or `undefined` when `ref` holds no bytes. Present exactly when {@link putBytes} is.
|
|
216
|
+
*
|
|
217
|
+
* **The one way a single ref is read**, by every reader (the reader tools, a host read face, a mover): at most one face answers,
|
|
218
|
+
* because the election above keeps one kind per ref — ask {@link get} first, and when it answers `undefined` ask `bytesOf`; both
|
|
219
|
+
* `undefined` = the ref is absent. A ref is never parsed for its kind (it stays opaque). The read face is lenient like `get`'s: a
|
|
220
|
+
* ref no write could store answers `undefined`, never a throw.
|
|
221
|
+
*/
|
|
222
|
+
bytesOf?(ref: string): Promise<ToolResultBytes | undefined> | ToolResultBytes | undefined;
|
|
223
|
+
}
|
|
224
|
+
/** What {@link ToolResultStore.bytesOf} answers for a byte entry. */
|
|
225
|
+
export interface ToolResultBytes {
|
|
226
|
+
/** The entry's length in bytes. */
|
|
227
|
+
readonly byteLength: number;
|
|
228
|
+
/** The media type stored with the entry, when its write stated one. */
|
|
229
|
+
readonly mediaType?: string;
|
|
230
|
+
/** The entry's bytes, read when asked. */
|
|
231
|
+
bytes(): Promise<Uint8Array> | Uint8Array;
|
|
190
232
|
}
|
|
233
|
+
/** The two kinds of content an entry holds: text ({@link ToolResultStore.put} / `get`) or bytes (`putBytes` / `bytesOf`). */
|
|
234
|
+
export type ToolResultEntryKind = "text" | "bytes";
|
|
191
235
|
/** One entry a {@link ToolResultStore.listBySession} listing names: the ref and the owner recorded at its winning write — the two
|
|
192
236
|
* arguments an importing store's `put` takes beside the content `get` returns. */
|
|
193
237
|
export interface ToolResultListedEntry {
|
|
@@ -249,16 +293,25 @@ export interface ToolResultProvenance {
|
|
|
249
293
|
/** Backlog #119 — the `code` on {@link ToolResultRefConflictError}, so callers branch on a constant. */
|
|
250
294
|
export declare const TOOL_RESULT_REF_CONFLICT_CODE = "tool_result.ref_conflict";
|
|
251
295
|
/**
|
|
252
|
-
* Backlog #119 — a
|
|
253
|
-
*
|
|
254
|
-
*
|
|
296
|
+
* Backlog #119 — a write the occupied ref cannot take: its provenance disagrees with the stored one, or (`kinds` present) it
|
|
297
|
+
* offers the other kind of content than the entry holds (one ref, one entry — {@link ToolResultStore.putBytes}). Typed (a `code`,
|
|
298
|
+
* like `CheckpointError`/`WorkflowRunStoreError`) rather than a silent no-op: these are the write-once outcomes where "keep what
|
|
299
|
+
* is there" would hand the second caller a reference to something other than what it stored. `stored` / `incoming` are the two
|
|
300
|
+
* owners — always both present for an owner conflict; for a kind conflict, whichever side recorded one.
|
|
255
301
|
*/
|
|
256
302
|
export declare class ToolResultRefConflictError extends Error {
|
|
257
303
|
readonly ref: string;
|
|
258
|
-
readonly stored: ToolResultProvenance;
|
|
259
|
-
readonly incoming: ToolResultProvenance;
|
|
304
|
+
readonly stored: ToolResultProvenance | undefined;
|
|
305
|
+
readonly incoming: ToolResultProvenance | undefined;
|
|
306
|
+
readonly kinds?: {
|
|
307
|
+
readonly stored: ToolResultEntryKind;
|
|
308
|
+
readonly incoming: ToolResultEntryKind;
|
|
309
|
+
} | undefined;
|
|
260
310
|
readonly code = "tool_result.ref_conflict";
|
|
261
|
-
constructor(ref: string, stored: ToolResultProvenance, incoming: ToolResultProvenance
|
|
311
|
+
constructor(ref: string, stored: ToolResultProvenance | undefined, incoming: ToolResultProvenance | undefined, kinds?: {
|
|
312
|
+
readonly stored: ToolResultEntryKind;
|
|
313
|
+
readonly incoming: ToolResultEntryKind;
|
|
314
|
+
} | undefined);
|
|
262
315
|
}
|
|
263
316
|
/**
|
|
264
317
|
* Backlog #119 — the ONE comparison every backend uses, so "same owner" cannot mean two things in two
|
|
@@ -398,6 +451,15 @@ export declare const MAX_MINTED_TOOL_RESULT_REF_CHARS: number;
|
|
|
398
451
|
* content is byte-identical and the preview stays prompt-cache stable.
|
|
399
452
|
*/
|
|
400
453
|
export declare function toolResultContentSegment(text: string): string;
|
|
454
|
+
/**
|
|
455
|
+
* The content coordinate of a BYTE entry's ref ({@link ToolResultStore.putBytes}): `b` + 128 bits of a sha256 over the claimed
|
|
456
|
+
* media type (the form a sentence may repeat, `""` when none) and the bytes — the same width and the same reason as
|
|
457
|
+
* {@link toolResultContentSegment}, whose `s` it never shares, so a byte ref and any text ref the engine mints differ in their last
|
|
458
|
+
* segment by construction. The type is inside the digest because the entry stores one type: the same bytes claimed as two types are
|
|
459
|
+
* two entries, each answering its own. Distinct (type, bytes) ⇒ distinct refs rests on the same collision-resistance assumption as
|
|
460
|
+
* every digest here; identical ones are one entry, which the write-once election makes idempotent.
|
|
461
|
+
*/
|
|
462
|
+
export declare function toolResultBytesSegment(mediaType: string, bytes: Uint8Array): string;
|
|
401
463
|
export interface ToolResultSlice {
|
|
402
464
|
content: string;
|
|
403
465
|
/** Byte/char offset this slice starts at. */
|
|
@@ -412,7 +474,11 @@ export interface ToolResultSlice {
|
|
|
412
474
|
* island), so a parent can deref a child's ref within the process. A shared long-lived instance
|
|
413
475
|
* needs a bound — `maxTotalChars` FIFO-evicts the oldest refs past the cap (an evicted deref lands
|
|
414
476
|
* on the existing honest "may have expired" text). Durability across restarts still requires a real
|
|
415
|
-
* store (e.g. FileToolResultStore) via `RunnerDeps.toolResultStore`.
|
|
477
|
+
* store (e.g. FileToolResultStore) via `RunnerDeps.toolResultStore`.
|
|
478
|
+
*
|
|
479
|
+
* No byte arm ({@link ToolResultStore.putBytes}): its bound counts characters, and one image is enough to evict a run's text
|
|
480
|
+
* results or, unbounded, to turn this store's emptiness — what a durable suspend is judged on — off for every task sharing it. A
|
|
481
|
+
* run over it keeps no binary tool results and says so. */
|
|
416
482
|
export declare class InMemoryToolResultStore implements ToolResultStore {
|
|
417
483
|
/** Managed-retention declaration (retention.ts): whether this store's rows are deleted on schedule by the deployment — given by
|
|
418
484
|
* the party that runs the sweep (the `retention` option), `"none"` when none is given; the store itself is put/get only. */
|
|
@@ -525,6 +591,22 @@ export declare function createOffloadPersist(store: ToolResultStore, sessionId:
|
|
|
525
591
|
* seat falls back to `console.warn` plus the once-per-process seat-defect announcement; absent ⇒
|
|
526
592
|
* `console.warn`. */
|
|
527
593
|
onNotice?: (notice: import("./types.js").EngineNotice) => void): (toolCallId: string, fullText: string) => string;
|
|
594
|
+
/**
|
|
595
|
+
* The byte sibling of {@link createOffloadPersist}: keep `bytes` (claimed `mimeType`) a tool result carried for the call
|
|
596
|
+
* `toolCallId` in the seat's store (its byte arm), under a content-addressed ref and the session's owner — or say why not, in
|
|
597
|
+
* the closed set (`tool-result-bytes.ts`). The one write every supplier of bytes reaches; the single-piece bound is judged here,
|
|
598
|
+
* once. Never throws, and never writes anywhere else: a store that cannot take the bytes is answered `store_failed` with its error
|
|
599
|
+
* text (the operator's), not routed around. No seat or no byte arm ⇒ `no_byte_store`.
|
|
600
|
+
*/
|
|
601
|
+
export declare function keepToolResultBytes(seat: ToolResultBytesSeat | undefined, toolCallId: string, bytes: Uint8Array, mimeType: unknown): Promise<KeptBytes>;
|
|
602
|
+
/**
|
|
603
|
+
* The clause a model-visible line ends with for one {@link KeptBytes}: the ref and how this run can write it to a file (or that it
|
|
604
|
+
* cannot) — the activation step worded as {@link offloadPagebackHint} words its own — or why the bytes were not kept.
|
|
605
|
+
*/
|
|
606
|
+
export declare function keptBytesClause(kept: KeptBytes, seat: ToolResultBytesSeat | undefined): string;
|
|
607
|
+
/** The one {@link ToolResultBytesKeeper}: {@link keepToolResultBytes} into `seat` for the call `toolCallId`, worded by
|
|
608
|
+
* {@link keptBytesClause}. Every supplier of bytes (the tool-result seat's admission, an MCP leg) is handed one of these. */
|
|
609
|
+
export declare function toolResultBytesKeeper(seat: ToolResultBytesSeat | undefined, toolCallId: string): ToolResultBytesKeeper;
|
|
528
610
|
/** Backlog #119 — build the provenance a write site records, from the two coordinates every write site
|
|
529
611
|
* already has in hand. `taskId` is omitted (not `undefined`-valued) when the run declares none, so the
|
|
530
612
|
* stored shape compares equal across a durable round-trip. */
|
|
@@ -621,5 +703,7 @@ export declare function isOffloadedDetailReplacement(s: string): boolean;
|
|
|
621
703
|
* `legsOfRef` = the legs a page-back of one ref travels: a ref holding a background task's result (`persistTaskArtifact`, its
|
|
622
704
|
* origin in the ref — {@link taskArtifactOriginOf}) travels the legs a poll of that task travels — content from another tree is
|
|
623
705
|
* an off-target read however it is read back — and the registry's reading answers it; absent, or for any other ref (offloaded
|
|
624
|
-
* tool output), none.
|
|
625
|
-
|
|
706
|
+
* tool output), none. A ref is read the one way the store contract states: text first; a ref holding bytes instead
|
|
707
|
+
* (`bytesOf`) is answered — not an error — with its size and type and how this run can write them to a file (`bytesSeat`'s
|
|
708
|
+
* reach of SaveToolResult); a ref holding neither is the honest miss. */
|
|
709
|
+
export declare function createReadToolResultTool(store: ToolResultStore, legsOfRef?: (ref: string, tree: import("./cross-boundary-taint.js").CrossBoundaryTreeToken) => import("./cross-boundary-taint.js").BoundaryLegsGiven, bytesSeat?: ToolResultBytesSeat): AgentTool;
|
|
@@ -10,22 +10,29 @@ import { readRetentionDeclaration } from "./retention.js";
|
|
|
10
10
|
import { carryNotStartedReceipt } from "./delegation-not-started.js";
|
|
11
11
|
import { optionKeys, receiveOptions } from "./own-property-receipt.js";
|
|
12
12
|
import { NON_NEGATIVE_SAFE_INTEGER, readIntegerOption } from "./integer-option.js";
|
|
13
|
+
import { SAVE_TOOL_RESULT_NAME, TOOL_RESULT_BYTES_KEEP_LIMIT, keptBytesFacts, notKeptClause } from "./tool-result-bytes.js";
|
|
13
14
|
export const TOOL_RESULT_REF_CONFLICT_CODE = "tool_result.ref_conflict";
|
|
14
15
|
export class ToolResultRefConflictError extends Error {
|
|
15
16
|
ref;
|
|
16
17
|
stored;
|
|
17
18
|
incoming;
|
|
19
|
+
kinds;
|
|
18
20
|
code = TOOL_RESULT_REF_CONFLICT_CODE;
|
|
19
|
-
constructor(ref, stored, incoming) {
|
|
20
|
-
super(
|
|
21
|
-
`
|
|
21
|
+
constructor(ref, stored, incoming, kinds) {
|
|
22
|
+
super(kinds !== undefined
|
|
23
|
+
? `tool-result store: ref ${JSON.stringify(ref)} already holds ${kinds.stored} content — refusing to store ${kinds.incoming} under it`
|
|
24
|
+
: `tool-result store: ref ${JSON.stringify(ref)} already belongs to a different origin ` +
|
|
25
|
+
`(stored ${describeProvenance(stored)}, offered ${describeProvenance(incoming)}) — refusing to store under it`);
|
|
22
26
|
this.ref = ref;
|
|
23
27
|
this.stored = stored;
|
|
24
28
|
this.incoming = incoming;
|
|
29
|
+
this.kinds = kinds;
|
|
25
30
|
this.name = "ToolResultRefConflictError";
|
|
26
31
|
}
|
|
27
32
|
}
|
|
28
33
|
function describeProvenance(p) {
|
|
34
|
+
if (p === undefined)
|
|
35
|
+
return "no owner";
|
|
29
36
|
return p.taskId === undefined ? `session=${p.sessionId}` : `session=${p.sessionId} task=${p.taskId}`;
|
|
30
37
|
}
|
|
31
38
|
export function assertToolResultProvenanceMatch(ref, stored, incoming) {
|
|
@@ -76,6 +83,9 @@ export const MAX_MINTED_TOOL_RESULT_REF_CHARS = 3 + 4 * MAX_REF_SEGMENT_CHARS +
|
|
|
76
83
|
export function toolResultContentSegment(text) {
|
|
77
84
|
return `s${digestOfString(text).slice(0, 32)}`;
|
|
78
85
|
}
|
|
86
|
+
export function toolResultBytesSegment(mediaType, bytes) {
|
|
87
|
+
return `b${createHash("sha256").update(Buffer.from(`${mediaType.length}:${mediaType}`, "utf16le")).update(bytes).digest("hex").slice(0, 32)}`;
|
|
88
|
+
}
|
|
79
89
|
function digestOfString(s) {
|
|
80
90
|
return createHash("sha256").update(Buffer.from(s, "utf16le")).digest("hex");
|
|
81
91
|
}
|
|
@@ -219,6 +229,40 @@ export function createOffloadPersist(store, sessionId, onNotice) {
|
|
|
219
229
|
return ref;
|
|
220
230
|
};
|
|
221
231
|
}
|
|
232
|
+
export async function keepToolResultBytes(seat, toolCallId, bytes, mimeType) {
|
|
233
|
+
const facts = keptBytesFacts(bytes, mimeType);
|
|
234
|
+
const store = seat?.store;
|
|
235
|
+
if (seat === undefined || store?.putBytes === undefined)
|
|
236
|
+
return { ...facts, notKept: "no_byte_store" };
|
|
237
|
+
if (bytes.byteLength > TOOL_RESULT_BYTES_KEEP_LIMIT)
|
|
238
|
+
return { ...facts, notKept: "over_limit" };
|
|
239
|
+
const ref = buildToolResultRef(seat.sessionId, toolCallId, toolResultBytesSegment(facts.mimeType ?? "", bytes));
|
|
240
|
+
try {
|
|
241
|
+
await store.putBytes(ref, bytes, toolResultProvenanceOf(seat.sessionId), facts.mimeType);
|
|
242
|
+
}
|
|
243
|
+
catch (err) {
|
|
244
|
+
return { ...facts, notKept: "store_failed", saveError: thrownText(err) };
|
|
245
|
+
}
|
|
246
|
+
return { ...facts, ref };
|
|
247
|
+
}
|
|
248
|
+
export function keptBytesClause(kept, seat) {
|
|
249
|
+
if (!("ref" in kept))
|
|
250
|
+
return notKeptClause(kept);
|
|
251
|
+
const reach = seat?.saveReach?.() ?? "absent";
|
|
252
|
+
const call = `call ${SAVE_TOOL_RESULT_NAME} with ref="${kept.ref}" and a new file_path to write them to a file`;
|
|
253
|
+
const how = reach === "callable"
|
|
254
|
+
? call
|
|
255
|
+
: reach === "deferred"
|
|
256
|
+
? `${SAVE_TOOL_RESULT_NAME} is not active yet — call ${TOOL_SEARCH_NAME} with {"query":"select:${SAVE_TOOL_RESULT_NAME}"} to activate it, then ${call}`
|
|
257
|
+
: "this run cannot write them to a file";
|
|
258
|
+
return `its bytes were kept as ref "${kept.ref}"; ${how}`;
|
|
259
|
+
}
|
|
260
|
+
export function toolResultBytesKeeper(seat, toolCallId) {
|
|
261
|
+
return async (bytes, mimeType) => {
|
|
262
|
+
const kept = await keepToolResultBytes(seat, toolCallId, bytes, mimeType);
|
|
263
|
+
return { kept, clause: keptBytesClause(kept, seat) };
|
|
264
|
+
};
|
|
265
|
+
}
|
|
222
266
|
export function toolResultProvenanceOf(sessionId, taskId) {
|
|
223
267
|
return taskId === undefined ? { sessionId } : { sessionId, taskId };
|
|
224
268
|
}
|
|
@@ -422,7 +466,7 @@ async function offloadOversizedDetailStrings(details, store, thresholdChars, ses
|
|
|
422
466
|
};
|
|
423
467
|
return { value: finalize(value) };
|
|
424
468
|
}
|
|
425
|
-
export function createReadToolResultTool(store, legsOfRef) {
|
|
469
|
+
export function createReadToolResultTool(store, legsOfRef, bytesSeat) {
|
|
426
470
|
return defineTool({
|
|
427
471
|
name: OFFLOAD_TOOL_NAME,
|
|
428
472
|
...toolFace("read-tool-result"),
|
|
@@ -443,6 +487,10 @@ export function createReadToolResultTool(store, legsOfRef) {
|
|
|
443
487
|
const off = Math.max(0, intOr(offset, 0));
|
|
444
488
|
const lim = Math.min(READ_MAX_LIMIT, Math.max(1, intOr(limit, READ_DEFAULT_LIMIT)));
|
|
445
489
|
const slice = await store.get(ref, { offset: off, limit: lim });
|
|
490
|
+
const kept = slice === undefined ? await store.bytesOf?.(ref) : undefined;
|
|
491
|
+
if (kept !== undefined) {
|
|
492
|
+
return `[ref=${ref} · binary content, ${kept.byteLength} bytes${kept.mediaType !== undefined ? `, claimed type ${kept.mediaType}` : ""} — not text, so it is not paged here] ${keptBytesClause({ bytes: kept.byteLength, ref }, bytesSeat)}.`;
|
|
493
|
+
}
|
|
446
494
|
if (!slice) {
|
|
447
495
|
return errorResult(`No persisted output for ref "${ref}" — it may have expired, or this process has no durable tool-result store (the preview above is all that remains).`);
|
|
448
496
|
}
|
|
@@ -1,7 +1,17 @@
|
|
|
1
1
|
import { Type, type Static, type TSchema } from "typebox";
|
|
2
2
|
import type { AgentTool } from "../internal/harness-types.js";
|
|
3
|
+
import { type ToolContractFace } from "../prompt-assembly/tool-catalog.js";
|
|
4
|
+
import { ToolMountLedger, type ToolMountPlan, type ToolMountSource } from "./tool-mount-plan.js";
|
|
3
5
|
import { type ReservedApprovalCard, type ToolApprovalCard, type ToolFamily, type ToolHostTarget, type ToolRosterPathTarget, type ToolMountTag, type ToolPathTarget, type ToolRenderHints, type ToolRuleFace } from "./tool-face.js";
|
|
4
6
|
import type { ToolContentOrigin, ToolEffect } from "./tool-spec.js";
|
|
7
|
+
/**
|
|
8
|
+
* The most rows one tool roster carries — the ONE bound on its size: the schema's `entries.maxItems` reads it, and the
|
|
9
|
+
* builder refuses a set that would mint more at both places a roster takes its shape (the prepare-time mint and the run-time
|
|
10
|
+
* domain swap, {@link rosterEntryCountProblem}). A row is one distinct tool NAME (two mounts under a name are one row; an
|
|
11
|
+
* alias is no row; a deferred tool is a row — it rides the frame as one). A set over it is refused where it forms, never cut:
|
|
12
|
+
* which source would lose its tools is a priority nothing declares. A host that wants to know before it asks reads this.
|
|
13
|
+
*/
|
|
14
|
+
export declare const TOOL_ROSTER_MAX_ENTRIES = 2048;
|
|
5
15
|
export declare const ROSTER_SOURCES: readonly ["builtin", "caller", "host", "mcp", "a2a", "external", "synthetic"];
|
|
6
16
|
export type RosterSource = (typeof ROSTER_SOURCES)[number];
|
|
7
17
|
export declare const ToolRosterRenderHints: Type.TObject<{
|
|
@@ -21,6 +31,10 @@ export declare const ToolRosterEntry: Type.TObject<{
|
|
|
21
31
|
peer: Type.TString;
|
|
22
32
|
declaredBy: Type.TOptional<Type.TUnion<[Type.TLiteral<"center">, Type.TLiteral<"file">, Type.TLiteral<"request">]>>;
|
|
23
33
|
}>>;
|
|
34
|
+
/** The name the MCP server lists the tool under and a call is sent under, byte-exact — present iff `name` does not spell it
|
|
35
|
+
* (its protocol segment is the provider-charset fold, or the clamp, of another spelling: `foo.bar` and `foo_bar` both mount
|
|
36
|
+
* as `mcp__<server>__foo_bar`). Absent, the server's name IS that segment. An identity member ({@link mintCapabilityId}). */
|
|
37
|
+
remoteName: Type.TOptional<Type.TString>;
|
|
24
38
|
/** Undeclared ⇒ `legacy:<shapeDigest>` / `unversioned`. */
|
|
25
39
|
contract: Type.TObject<{
|
|
26
40
|
contractId: Type.TString;
|
|
@@ -30,7 +44,8 @@ export declare const ToolRosterEntry: Type.TObject<{
|
|
|
30
44
|
wireSchemaDigest: Type.TString;
|
|
31
45
|
/** `builtin:<name>` | `caller:<contractId>` | `mcp:<peer>/<tool>` | `a2a:<peer>/<skill>` | `external:<contractId>`. */
|
|
32
46
|
cardId: Type.TString;
|
|
33
|
-
/** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId}
|
|
47
|
+
/** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId, remote?} (`remote` = `remoteName`,
|
|
48
|
+
* only when the row carries it); unique per leg. */
|
|
34
49
|
capabilityId: Type.TString;
|
|
35
50
|
/** The materialized schema's top-level properties (name + coarse type). */
|
|
36
51
|
inputKeys: Type.TArray<Type.TObject<{
|
|
@@ -95,7 +110,8 @@ export declare const ToolRoster: Type.TObject<{
|
|
|
95
110
|
schemaVersion: Type.TLiteral<1>;
|
|
96
111
|
/** Run-time asserted equal to `entries.length`. */
|
|
97
112
|
count: Type.TInteger;
|
|
98
|
-
/** Declaration order = the model's `tools[]` order; names unique (run-time asserted)
|
|
113
|
+
/** Declaration order = the model's `tools[]` order; names unique (run-time asserted); at most
|
|
114
|
+
* {@link TOOL_ROSTER_MAX_ENTRIES} rows (run-time asserted where the roster forms). */
|
|
99
115
|
entries: Type.TArray<Type.TObject<{
|
|
100
116
|
name: Type.TString;
|
|
101
117
|
/** Always present (empty when the tool answers to no other name). */
|
|
@@ -106,6 +122,10 @@ export declare const ToolRoster: Type.TObject<{
|
|
|
106
122
|
peer: Type.TString;
|
|
107
123
|
declaredBy: Type.TOptional<Type.TUnion<[Type.TLiteral<"center">, Type.TLiteral<"file">, Type.TLiteral<"request">]>>;
|
|
108
124
|
}>>;
|
|
125
|
+
/** The name the MCP server lists the tool under and a call is sent under, byte-exact — present iff `name` does not spell it
|
|
126
|
+
* (its protocol segment is the provider-charset fold, or the clamp, of another spelling: `foo.bar` and `foo_bar` both mount
|
|
127
|
+
* as `mcp__<server>__foo_bar`). Absent, the server's name IS that segment. An identity member ({@link mintCapabilityId}). */
|
|
128
|
+
remoteName: Type.TOptional<Type.TString>;
|
|
109
129
|
/** Undeclared ⇒ `legacy:<shapeDigest>` / `unversioned`. */
|
|
110
130
|
contract: Type.TObject<{
|
|
111
131
|
contractId: Type.TString;
|
|
@@ -115,7 +135,8 @@ export declare const ToolRoster: Type.TObject<{
|
|
|
115
135
|
wireSchemaDigest: Type.TString;
|
|
116
136
|
/** `builtin:<name>` | `caller:<contractId>` | `mcp:<peer>/<tool>` | `a2a:<peer>/<skill>` | `external:<contractId>`. */
|
|
117
137
|
cardId: Type.TString;
|
|
118
|
-
/** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId}
|
|
138
|
+
/** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId, remote?} (`remote` = `remoteName`,
|
|
139
|
+
* only when the row carries it); unique per leg. */
|
|
119
140
|
capabilityId: Type.TString;
|
|
120
141
|
/** The materialized schema's top-level properties (name + coarse type). */
|
|
121
142
|
inputKeys: Type.TArray<Type.TObject<{
|
|
@@ -175,7 +196,8 @@ export declare const ToolRoster: Type.TObject<{
|
|
|
175
196
|
/** The ONE mount condition that fired for this instance. */
|
|
176
197
|
mountedBy: Type.TUnion<[Type.TLiteral<"hands">, Type.TLiteral<"backgroundTasks">, Type.TLiteral<"workflow">, Type.TLiteral<"delegation">, Type.TLiteral<"hostInternals">, Type.TLiteral<"peerLane">, Type.TLiteral<"scheduler">, Type.TLiteral<"memory">, Type.TLiteral<"scenario">, Type.TLiteral<"always">, Type.TLiteral<"optional">]>;
|
|
177
198
|
}>>;
|
|
178
|
-
/** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it.
|
|
199
|
+
/** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it. The canonical form is the engine's one
|
|
200
|
+
* JSON (`canonicalJsonStringify`: keys sorted, a member holding `undefined` reads as absent). */
|
|
179
201
|
digest: Type.TString;
|
|
180
202
|
}>;
|
|
181
203
|
export type ToolRoster = Static<typeof ToolRoster>;
|
|
@@ -188,7 +210,8 @@ export declare const ToolRosterDelta: Type.TObject<{
|
|
|
188
210
|
schemaVersion: Type.TLiteral<1>;
|
|
189
211
|
/** Run-time asserted equal to `entries.length`. */
|
|
190
212
|
count: Type.TInteger;
|
|
191
|
-
/** Declaration order = the model's `tools[]` order; names unique (run-time asserted)
|
|
213
|
+
/** Declaration order = the model's `tools[]` order; names unique (run-time asserted); at most
|
|
214
|
+
* {@link TOOL_ROSTER_MAX_ENTRIES} rows (run-time asserted where the roster forms). */
|
|
192
215
|
entries: Type.TArray<Type.TObject<{
|
|
193
216
|
name: Type.TString;
|
|
194
217
|
/** Always present (empty when the tool answers to no other name). */
|
|
@@ -199,6 +222,10 @@ export declare const ToolRosterDelta: Type.TObject<{
|
|
|
199
222
|
peer: Type.TString;
|
|
200
223
|
declaredBy: Type.TOptional<Type.TUnion<[Type.TLiteral<"center">, Type.TLiteral<"file">, Type.TLiteral<"request">]>>;
|
|
201
224
|
}>>;
|
|
225
|
+
/** The name the MCP server lists the tool under and a call is sent under, byte-exact — present iff `name` does not spell it
|
|
226
|
+
* (its protocol segment is the provider-charset fold, or the clamp, of another spelling: `foo.bar` and `foo_bar` both mount
|
|
227
|
+
* as `mcp__<server>__foo_bar`). Absent, the server's name IS that segment. An identity member ({@link mintCapabilityId}). */
|
|
228
|
+
remoteName: Type.TOptional<Type.TString>;
|
|
202
229
|
/** Undeclared ⇒ `legacy:<shapeDigest>` / `unversioned`. */
|
|
203
230
|
contract: Type.TObject<{
|
|
204
231
|
contractId: Type.TString;
|
|
@@ -208,7 +235,8 @@ export declare const ToolRosterDelta: Type.TObject<{
|
|
|
208
235
|
wireSchemaDigest: Type.TString;
|
|
209
236
|
/** `builtin:<name>` | `caller:<contractId>` | `mcp:<peer>/<tool>` | `a2a:<peer>/<skill>` | `external:<contractId>`. */
|
|
210
237
|
cardId: Type.TString;
|
|
211
|
-
/** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId}
|
|
238
|
+
/** ENGINE-minted: sha256 prefix over the canonical tuple {source, peer, name, contractId, remote?} (`remote` = `remoteName`,
|
|
239
|
+
* only when the row carries it); unique per leg. */
|
|
212
240
|
capabilityId: Type.TString;
|
|
213
241
|
/** The materialized schema's top-level properties (name + coarse type). */
|
|
214
242
|
inputKeys: Type.TArray<Type.TObject<{
|
|
@@ -268,7 +296,8 @@ export declare const ToolRosterDelta: Type.TObject<{
|
|
|
268
296
|
/** The ONE mount condition that fired for this instance. */
|
|
269
297
|
mountedBy: Type.TUnion<[Type.TLiteral<"hands">, Type.TLiteral<"backgroundTasks">, Type.TLiteral<"workflow">, Type.TLiteral<"delegation">, Type.TLiteral<"hostInternals">, Type.TLiteral<"peerLane">, Type.TLiteral<"scheduler">, Type.TLiteral<"memory">, Type.TLiteral<"scenario">, Type.TLiteral<"always">, Type.TLiteral<"optional">]>;
|
|
270
298
|
}>>;
|
|
271
|
-
/** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it.
|
|
299
|
+
/** sha256 prefix over the canonical COMPLETE rows — any axis / hint / contract / alias change moves it. The canonical form is the engine's one
|
|
300
|
+
* JSON (`canonicalJsonStringify`: keys sorted, a member holding `undefined` reads as absent). */
|
|
272
301
|
digest: Type.TString;
|
|
273
302
|
}>;
|
|
274
303
|
/** Three pairwise-disjoint name lists; a `changed` name's new row is in `roster`. */
|
|
@@ -398,6 +427,9 @@ export declare const ROSTER_APPROVAL_BINDING: Readonly<{
|
|
|
398
427
|
readonly origin: {
|
|
399
428
|
readonly unbound: "the peer is the identity's (capabilityId); who declared the server is provenance no decision reads";
|
|
400
429
|
};
|
|
430
|
+
readonly remoteName: {
|
|
431
|
+
readonly identity: readonly ["capabilityId"];
|
|
432
|
+
};
|
|
401
433
|
readonly contract: {
|
|
402
434
|
readonly identity: readonly ["contractId", "implementationRevision"];
|
|
403
435
|
};
|
|
@@ -480,12 +512,16 @@ export type RosterIdentityCarrier = {
|
|
|
480
512
|
* the row carries it — one mint for the park row and for the live row it is compared with. */
|
|
481
513
|
export declare function toolDeclarationDigestOf(entry: ToolRosterEntry): string;
|
|
482
514
|
/** The engine-minted capability identity: a STRUCTURED tuple (never a joined string — `a:b`+`c` and `a`+`b:c`
|
|
483
|
-
* must not collide). Stable across legs for the same source/peer/name/contract
|
|
515
|
+
* must not collide). Stable across legs for the same source/peer/name/contract — and, for a tool whose server lists it under a
|
|
516
|
+
* name the wire name does not spell (`remote`, the row's `remoteName`), that server name: two server tools folded onto one wire
|
|
517
|
+
* name are two capabilities. `remote` is a key of the tuple only when given, so the identity of every tool whose wire name spells
|
|
518
|
+
* its server's name is the one minted from the four members alone. */
|
|
484
519
|
export declare function mintCapabilityId(t: {
|
|
485
520
|
source: RosterSource;
|
|
486
521
|
peer: string | null;
|
|
487
522
|
name: string;
|
|
488
523
|
contractId: string;
|
|
524
|
+
remote?: string | undefined;
|
|
489
525
|
}): string;
|
|
490
526
|
export declare function rosterDigestOf(entries: readonly ToolRosterEntry[]): string;
|
|
491
527
|
/** The materialized schema's top-level properties, in declaration order. */
|
|
@@ -502,6 +538,9 @@ export interface RosterBoundMembers {
|
|
|
502
538
|
aliases?: readonly string[];
|
|
503
539
|
/** An MCP/A2A mount's peer (the row's `origin.peer`) — a NAME on the roster, held to the wire name bound. */
|
|
504
540
|
peer?: string;
|
|
541
|
+
/** The server's own name for an MCP tool the row carries as `remoteName` — a NAME on the roster, held to the same bound, and to
|
|
542
|
+
* {@link NOT_IN_A_SERVER_TOOL_NAME}. */
|
|
543
|
+
remoteName?: string;
|
|
505
544
|
contractId?: string;
|
|
506
545
|
implementationRevision?: string;
|
|
507
546
|
modelGate?: string;
|
|
@@ -590,12 +629,24 @@ export interface RosterSnapshotFacts {
|
|
|
590
629
|
/** `TaskSpec.memory.trustedTools` — the exemption channel for an undeclared content class. */
|
|
591
630
|
trustedTools: ReadonlySet<string>;
|
|
592
631
|
}
|
|
632
|
+
/** A tool as a mount plan names it: the catalog definition it is (by its name and its contract) and its plan source. The one
|
|
633
|
+
* reading the leg's effective plan and the static plan's caller members both go through. */
|
|
634
|
+
export declare function planIdentityOf(tool: ToolContractFace, source: RosterSource | undefined): {
|
|
635
|
+
readonly id?: string;
|
|
636
|
+
readonly source: ToolMountSource;
|
|
637
|
+
};
|
|
593
638
|
export declare class RosterBuilder {
|
|
594
639
|
#private;
|
|
595
640
|
/** `effects` — the leg's by-name effect map, which the builder keeps equal to the mounted set's answering members. The leg's
|
|
596
641
|
* safety-axis tables are not the builder's: their marks live under the names they were laid on, and a call reads them under
|
|
597
642
|
* the names it answers to. */
|
|
598
643
|
constructor(effects: Map<string, ToolEffect>);
|
|
644
|
+
/** The leg's mount ledger: every mount site asks it before it mounts, and {@link settleMountPlan} checks the
|
|
645
|
+
* mounted set against it. */
|
|
646
|
+
readonly mounts: ToolMountLedger<AgentTool<Type.TSchema, unknown>>;
|
|
647
|
+
/** Check the mounted set (the mount array and the engine lane) against the mount table and return the leg's effective plan.
|
|
648
|
+
* Runs once, after the last mount and before the snapshot. */
|
|
649
|
+
settleMountPlan(): ToolMountPlan;
|
|
599
650
|
/** The mount array as a READ face. The order is the wire order. */
|
|
600
651
|
get tools(): readonly AgentTool[];
|
|
601
652
|
get length(): number;
|
|
@@ -617,6 +668,11 @@ export declare class RosterBuilder {
|
|
|
617
668
|
* Re-insert a NAME-PREFIX domain in place (the RefreshMcpTools seam): every instance whose name starts with
|
|
618
669
|
* `prefix` is removed and `fresh` is spliced in at the domain's lowest former index (the wire prefix a
|
|
619
670
|
* provider cache reads stays put); a domain that was not mounted appends at the tail.
|
|
671
|
+
*
|
|
672
|
+
* The swap is judged before it touches anything: a domain whose fresh tools would put the roster over
|
|
673
|
+
* {@link TOOL_ROSTER_MAX_ENTRIES} rows throws `config.tool_roster_bound` and leaves the builder as it was (the
|
|
674
|
+
* re-mint after the swap is the publish, which runs after the harness is rebuilt — too late to refuse at). An
|
|
675
|
+
* empty `fresh` only shrinks the set and always passes.
|
|
620
676
|
*/
|
|
621
677
|
replaceDomain(prefix: string, fresh: readonly AgentTool[], meta: RosterMountMeta): {
|
|
622
678
|
anchor: number;
|
|
@@ -624,7 +680,8 @@ export declare class RosterBuilder {
|
|
|
624
680
|
/** Mint the roster: one row per mounted NAME, in order. Two mounted instances under one name follow the
|
|
625
681
|
* harness's own yield (the LATER mount is the one the model dispatches to — design/141 Q4, the
|
|
626
682
|
* `auditToolCollisions` "yield" record): the roster carries the surviving instance's row at the
|
|
627
|
-
* yielded instance's position and never a row per object.
|
|
683
|
+
* yielded instance's position and never a row per object. A set that would mint more than
|
|
684
|
+
* {@link TOOL_ROSTER_MAX_ENTRIES} rows is refused (`config.tool_roster_bound`) before any row is minted. */
|
|
628
685
|
snapshot(facts: RosterSnapshotFacts): ToolRoster;
|
|
629
686
|
}
|
|
630
687
|
/**
|
|
@@ -636,7 +693,7 @@ export declare class RosterBuilder {
|
|
|
636
693
|
export declare function rosterEngineNamesProblem(roster: ToolRoster): string | undefined;
|
|
637
694
|
/** Which source a `TaskSpec.tools` entry mounts as: a definition carrying a CORE contract is a built-in the host chose
|
|
638
695
|
* to mount; anything else is the caller's own tool. Identity follows the object, never the name. */
|
|
639
|
-
export declare function callerMountSource(tool:
|
|
696
|
+
export declare function callerMountSource(tool: ToolContractFace): RosterSource;
|
|
640
697
|
/** The card namespace a roster row owns (design/388 §2.2 ④) — ONE mint, read by the row and by the prepare door that
|
|
641
698
|
* judges a caller's `renderHints.resultCards` against it: `builtin:<name>` for engine-owned definitions,
|
|
642
699
|
* `<mcp|a2a>:<peer>/<tool>` for protocol tools, `<caller|external>:<contractId>` for everything the caller mounts. */
|
|
@@ -647,6 +704,10 @@ export declare function callerCardIdOf(tool: Pick<AgentTool, "name" | "parameter
|
|
|
647
704
|
/** The protocol segment of a mounted protocol tool's name (`mcp__srv__write_file` ⇒ `write_file`): the name itself when no protocol owns it.
|
|
648
705
|
* ONE reading, asked by the row's mint below and by the judge that holds an MCP face's cards to the namespace that row will own. */
|
|
649
706
|
export declare function protocolToolOf(toolName: string): string;
|
|
707
|
+
/** The `remoteName` member a row minted under wire name `toolName` carries for a tool its server lists as `remote`: `remote`
|
|
708
|
+
* when the wire name's protocol segment does not spell it, else nothing (the segment is the server's name). ONE reading, asked by
|
|
709
|
+
* the row's mint and by the MCP intake that drops a listing entry whose member could not ride a row. */
|
|
710
|
+
export declare function rosterRemoteNameOf(toolName: string, remote: string | undefined): string | undefined;
|
|
650
711
|
/** The refusal of a `boundaryLegs` declaration that is not one — the ONE sentence the roster's declaration door and the row mint both
|
|
651
712
|
* throw (`config.tool_face_invalid`, the code a caller tool's bad face has). */
|
|
652
713
|
export declare function boundaryLegsRefusal(toolName: unknown): Error & {
|