@sema-agent/core 7.66.0 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3498 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/dist/core/tool-roster.js
CHANGED
|
@@ -1,17 +1,18 @@
|
|
|
1
|
-
import { createHash } from "node:crypto";
|
|
2
1
|
import { types } from "node:util";
|
|
3
2
|
import { Type } from "typebox";
|
|
4
3
|
import { toolNameIndex } from "../internal/llm.js";
|
|
5
|
-
import { getToolContract } from "../prompt-assembly/tool-catalog.js";
|
|
4
|
+
import { getToolContract, toolContractOfFace } from "../prompt-assembly/tool-catalog.js";
|
|
6
5
|
import { protocolOf } from "./protocol-table.js";
|
|
7
6
|
import { describeToolCatalog } from "./tool-registry.js";
|
|
7
|
+
import { TOOL_CATALOG_ENTRIES } from "./tool-catalog-entries.js";
|
|
8
|
+
import { ToolMountLedger } from "./tool-mount-plan.js";
|
|
8
9
|
import { RENDER_HINT_ACTIVITY_MAX_CHARS, RENDER_HINT_MAX_CHARS, RENDER_HINT_MAX_LIST, RESERVED_APPROVAL_CARDS, isToolApprovalCard, TOOL_APPROVAL_CARDS, TOOL_CARD_ID_MAX_CHARS, TOOL_CONTRACT_MAX_CHARS, TOOL_FAMILIES, TOOL_KEYS_MAX, TOOL_KEY_MAX_CHARS, TOOL_MOUNT_TAGS, TOOL_WIRE_NAME_MAX_CHARS, TOOL_PATH_ABSENCES, TOOL_PATH_BASES, } from "./tool-face.js";
|
|
9
10
|
import { ASK_USER_QUESTION_TOOL_NAME } from "./ask-question.js";
|
|
10
11
|
import { PRESENT_PLAN_TOOL_NAME } from "./present-plan-tool.js";
|
|
11
12
|
import { wireOf } from "./tool-name-readings.js";
|
|
12
13
|
import { BOUNDARY_LEGS, rosterBoundaryLegs } from "./cross-boundary-taint.js";
|
|
13
14
|
import { isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
14
|
-
import { boundInputHashOf } from "./canonical-json.js";
|
|
15
|
+
import { boundInputHashOf, canonicalJsonStringify, sha16 } from "./canonical-json.js";
|
|
15
16
|
function lit(values) {
|
|
16
17
|
return Type.Union(values.map((v) => Type.Literal(v)));
|
|
17
18
|
}
|
|
@@ -19,6 +20,18 @@ const Name = Type.String({ minLength: 1, maxLength: TOOL_WIRE_NAME_MAX_CHARS });
|
|
|
19
20
|
const Short = Type.String({ maxLength: TOOL_CONTRACT_MAX_CHARS });
|
|
20
21
|
const Key = Type.String({ maxLength: TOOL_KEY_MAX_CHARS });
|
|
21
22
|
const Digest16 = Type.String({ minLength: 16, maxLength: 16 });
|
|
23
|
+
export const TOOL_ROSTER_MAX_ENTRIES = 2048;
|
|
24
|
+
function rosterRowCount(tools) {
|
|
25
|
+
const names = new Set();
|
|
26
|
+
for (const t of tools)
|
|
27
|
+
names.add(t.name);
|
|
28
|
+
return names.size;
|
|
29
|
+
}
|
|
30
|
+
function rosterEntryCountProblem(rows) {
|
|
31
|
+
if (rows <= TOOL_ROSTER_MAX_ENTRIES)
|
|
32
|
+
return undefined;
|
|
33
|
+
return `the tool roster would carry ${rows} rows; a roster carries at most ${TOOL_ROSTER_MAX_ENTRIES} (one per distinct tool name, deferred tools included) — narrow the leg's tool face (the selector / excludeTools) or split the MCP servers across legs`;
|
|
34
|
+
}
|
|
22
35
|
export const ROSTER_SOURCES = Object.freeze(["builtin", "caller", "host", "mcp", "a2a", "external", "synthetic"]);
|
|
23
36
|
export const ToolRosterRenderHints = Type.Object({
|
|
24
37
|
userFacingName: Type.Optional(Type.String({ maxLength: RENDER_HINT_MAX_CHARS })),
|
|
@@ -32,6 +45,7 @@ export const ToolRosterEntry = Type.Object({
|
|
|
32
45
|
aliases: Type.Array(Name, { uniqueItems: true }),
|
|
33
46
|
source: lit(ROSTER_SOURCES),
|
|
34
47
|
origin: Type.Optional(Type.Object({ peer: Name, declaredBy: Type.Optional(lit(["center", "file", "request"])) }, { additionalProperties: false })),
|
|
48
|
+
remoteName: Type.Optional(Name),
|
|
35
49
|
contract: Type.Object({ contractId: Short, implementationRevision: Short }, { additionalProperties: false }),
|
|
36
50
|
shapeDigest: Digest16,
|
|
37
51
|
wireSchemaDigest: Digest16,
|
|
@@ -74,7 +88,7 @@ export const ToolRosterEntry = Type.Object({
|
|
|
74
88
|
export const ToolRoster = Type.Object({
|
|
75
89
|
schemaVersion: Type.Literal(1),
|
|
76
90
|
count: Type.Integer({ minimum: 0 }),
|
|
77
|
-
entries: Type.Array(ToolRosterEntry, { maxItems:
|
|
91
|
+
entries: Type.Array(ToolRosterEntry, { maxItems: TOOL_ROSTER_MAX_ENTRIES }),
|
|
78
92
|
digest: Digest16,
|
|
79
93
|
}, { additionalProperties: false });
|
|
80
94
|
export const ToolRosterDelta = Type.Object({
|
|
@@ -174,6 +188,7 @@ export const ROSTER_APPROVAL_BINDING = Object.freeze({
|
|
|
174
188
|
aliases: { unbound: "the names a call answers to are the call's own (the row's `names`); a resumed belt judges under the live names" },
|
|
175
189
|
source: { identity: ["capabilityId"] },
|
|
176
190
|
origin: { unbound: "the peer is the identity's (capabilityId); who declared the server is provenance no decision reads" },
|
|
191
|
+
remoteName: { identity: ["capabilityId"] },
|
|
177
192
|
contract: { identity: ["contractId", "implementationRevision"] },
|
|
178
193
|
shapeDigest: { identity: ["shapeDigest"] },
|
|
179
194
|
wireSchemaDigest: { unbound: "the schema with its description prose for the model; the shape a call is validated against is the identity's (shapeDigest)" },
|
|
@@ -209,22 +224,11 @@ const DECLARATION_MEMBERS = Object.keys(ROSTER_APPROVAL_BINDING).filter((k) => R
|
|
|
209
224
|
export function toolDeclarationDigestOf(entry) {
|
|
210
225
|
return boundInputHashOf(Object.fromEntries(DECLARATION_MEMBERS.flatMap((k) => (entry[k] === undefined ? [] : [[k, entry[k]]]))));
|
|
211
226
|
}
|
|
212
|
-
function canonical(node) {
|
|
213
|
-
if (Array.isArray(node))
|
|
214
|
-
return `[${node.map(canonical).join(",")}]`;
|
|
215
|
-
if (node === null || typeof node !== "object")
|
|
216
|
-
return JSON.stringify(node) ?? "null";
|
|
217
|
-
const keys = Object.keys(node).sort();
|
|
218
|
-
return `{${keys.map((k) => `${JSON.stringify(k)}:${canonical(node[k])}`).join(",")}}`;
|
|
219
|
-
}
|
|
220
|
-
function sha16(text) {
|
|
221
|
-
return createHash("sha256").update(text).digest("hex").slice(0, 16);
|
|
222
|
-
}
|
|
223
227
|
export function mintCapabilityId(t) {
|
|
224
|
-
return sha16(
|
|
228
|
+
return sha16(canonicalJsonStringify({ source: t.source, peer: t.peer, name: t.name, contractId: t.contractId, ...(t.remote !== undefined ? { remote: t.remote } : {}) }));
|
|
225
229
|
}
|
|
226
230
|
export function rosterDigestOf(entries) {
|
|
227
|
-
return sha16(
|
|
231
|
+
return sha16(canonicalJsonStringify(entries));
|
|
228
232
|
}
|
|
229
233
|
const SCALAR_TYPES = new Set(["string", "number", "integer", "boolean"]);
|
|
230
234
|
function schemaTypeOf(node) {
|
|
@@ -293,6 +297,7 @@ export function schemaKeyBoundProblem(schema) {
|
|
|
293
297
|
return `the schema property ${JSON.stringify(long.slice(0, 40) + "…")} is ${long.length} characters; a roster key is at most ${TOOL_KEY_MAX_CHARS}`;
|
|
294
298
|
return undefined;
|
|
295
299
|
}
|
|
300
|
+
const NOT_IN_A_SERVER_TOOL_NAME = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]|(?! )\p{Zs}/u;
|
|
296
301
|
export function rosterMemberBoundProblem(m) {
|
|
297
302
|
if (typeof m.name !== "string")
|
|
298
303
|
return { code: "config.tool_roster_bound", message: `tool has no string name (got ${m.name === null ? "null" : typeof m.name}); every roster row is keyed by a string \`name\`` };
|
|
@@ -305,6 +310,12 @@ export function rosterMemberBoundProblem(m) {
|
|
|
305
310
|
return { code: "config.tool_name_too_long", message: of(over("alias", alias, TOOL_WIRE_NAME_MAX_CHARS)) };
|
|
306
311
|
if (m.peer !== undefined && m.peer.length > TOOL_WIRE_NAME_MAX_CHARS)
|
|
307
312
|
return { code: "config.tool_name_too_long", message: of(over("peer", m.peer, TOOL_WIRE_NAME_MAX_CHARS)) };
|
|
313
|
+
if (m.remoteName !== undefined && m.remoteName.length > TOOL_WIRE_NAME_MAX_CHARS)
|
|
314
|
+
return { code: "config.tool_name_too_long", message: of(over("server tool name", m.remoteName, TOOL_WIRE_NAME_MAX_CHARS)) };
|
|
315
|
+
if (m.remoteName === "")
|
|
316
|
+
return { code: "config.tool_roster_bound", message: of("the server lists the tool under the empty name; a roster row carries a server tool name of at least one character") };
|
|
317
|
+
if (m.remoteName !== undefined && NOT_IN_A_SERVER_TOOL_NAME.test(m.remoteName))
|
|
318
|
+
return { code: "config.tool_roster_bound", message: of("the server lists the tool under a name with a control, separator, direction or zero-width character; a roster row carries a server tool name that prints as it is spelled") };
|
|
308
319
|
for (const [label, v] of [["contractId", m.contractId], ["implementationRevision", m.implementationRevision]]) {
|
|
309
320
|
if (v !== undefined && v.length > TOOL_CONTRACT_MAX_CHARS)
|
|
310
321
|
return { code: "config.tool_contract_too_long", message: of(over(`contract ${label}`, v, TOOL_CONTRACT_MAX_CHARS)) };
|
|
@@ -359,6 +370,24 @@ export function survivorsByName(mounted) {
|
|
|
359
370
|
}
|
|
360
371
|
export const faceOf = (t) => t;
|
|
361
372
|
const protocolFolded = (source) => source === "mcp" || source === "a2a";
|
|
373
|
+
function catalogIdOf(name, contract) {
|
|
374
|
+
return TOOL_CATALOG_ENTRIES.find((e) => e.name === name && e.face.contract?.contractId === contract)?.id;
|
|
375
|
+
}
|
|
376
|
+
export function planIdentityOf(tool, source) {
|
|
377
|
+
const id = catalogIdOf(tool.name, toolContractOfFace(tool, "core").contractId);
|
|
378
|
+
return { ...(id !== undefined ? { id } : {}), source: planSourceOf(source) };
|
|
379
|
+
}
|
|
380
|
+
function planSourceOf(source) {
|
|
381
|
+
switch (source) {
|
|
382
|
+
case "builtin":
|
|
383
|
+
case "synthetic":
|
|
384
|
+
case "mcp":
|
|
385
|
+
case "a2a":
|
|
386
|
+
return source;
|
|
387
|
+
default:
|
|
388
|
+
return "scenario";
|
|
389
|
+
}
|
|
390
|
+
}
|
|
362
391
|
function configError(code, message) {
|
|
363
392
|
const e = new Error(message);
|
|
364
393
|
e.code = code;
|
|
@@ -372,6 +401,15 @@ export class RosterBuilder {
|
|
|
372
401
|
constructor(effects) {
|
|
373
402
|
this.#effects = effects;
|
|
374
403
|
}
|
|
404
|
+
mounts = new ToolMountLedger((t) => getToolContract(t, "core").contractId);
|
|
405
|
+
settleMountPlan() {
|
|
406
|
+
const all = [...this.#tools, ...this.#engineLane];
|
|
407
|
+
const members = [...survivorsByName(all).values()].map((t) => {
|
|
408
|
+
const meta = this.#meta.get(t);
|
|
409
|
+
return { name: t.name, ...planIdentityOf(t, meta?.source), mountedBy: meta?.mountedBy ?? "scenario", state: "mounted" };
|
|
410
|
+
});
|
|
411
|
+
return this.mounts.settle(all, members);
|
|
412
|
+
}
|
|
375
413
|
get tools() {
|
|
376
414
|
return this.#tools;
|
|
377
415
|
}
|
|
@@ -443,6 +481,9 @@ export class RosterBuilder {
|
|
|
443
481
|
this.#meta.set(tool, meta);
|
|
444
482
|
}
|
|
445
483
|
replaceDomain(prefix, fresh, meta) {
|
|
484
|
+
const over = rosterEntryCountProblem(rosterRowCount([...this.#tools.filter((t) => !t.name.startsWith(prefix)), ...fresh, ...this.#engineLane]));
|
|
485
|
+
if (over !== undefined)
|
|
486
|
+
throw configError("config.tool_roster_bound", over);
|
|
446
487
|
let anchor = -1;
|
|
447
488
|
const removed = [];
|
|
448
489
|
for (let i = this.#tools.length - 1; i >= 0; i--) {
|
|
@@ -462,6 +503,9 @@ export class RosterBuilder {
|
|
|
462
503
|
}
|
|
463
504
|
snapshot(facts) {
|
|
464
505
|
const all = [...this.#tools, ...this.#engineLane];
|
|
506
|
+
const over = rosterEntryCountProblem(rosterRowCount(all));
|
|
507
|
+
if (over !== undefined)
|
|
508
|
+
throw configError("config.tool_roster_bound", over);
|
|
465
509
|
const winner = survivorsByName(all);
|
|
466
510
|
const entries = [];
|
|
467
511
|
const emitted = new Set();
|
|
@@ -512,7 +556,7 @@ export function rosterEngineNamesProblem(roster) {
|
|
|
512
556
|
return undefined;
|
|
513
557
|
}
|
|
514
558
|
export function callerMountSource(tool) {
|
|
515
|
-
return
|
|
559
|
+
return toolContractOfFace(tool, "caller").origin === "core" ? "builtin" : "caller";
|
|
516
560
|
}
|
|
517
561
|
export function rosterCardId(source, toolName, peer, protocolTool, contractId) {
|
|
518
562
|
return source === "builtin" || source === "synthetic"
|
|
@@ -528,6 +572,9 @@ export function callerCardIdOf(tool) {
|
|
|
528
572
|
export function protocolToolOf(toolName) {
|
|
529
573
|
return protocolOf(toolName)?.parse(toolName)?.tool ?? toolName;
|
|
530
574
|
}
|
|
575
|
+
export function rosterRemoteNameOf(toolName, remote) {
|
|
576
|
+
return remote !== undefined && remote !== protocolToolOf(toolName) ? remote : undefined;
|
|
577
|
+
}
|
|
531
578
|
export function boundaryLegsRefusal(toolName) {
|
|
532
579
|
const named = typeof toolName === "string" ? JSON.stringify(toolName.slice(0, 128)) : `(a ${typeof toolName} name)`;
|
|
533
580
|
return configError("config.tool_face_invalid", `tool ${named}: its boundaryLegs declaration is neither "per_call" nor a list of ${BOUNDARY_LEGS.join(" | ")}`);
|
|
@@ -560,6 +607,7 @@ export function mintRosterEntry(tool, meta, facts) {
|
|
|
560
607
|
const d = getToolContract(tool, fallbackOrigin);
|
|
561
608
|
const peer = meta.origin?.peer ?? null;
|
|
562
609
|
const protocolTool = peer !== null ? protocolToolOf(tool.name) : tool.name;
|
|
610
|
+
const remoteName = rosterRemoteNameOf(tool.name, typeof tool.mcpRemoteName === "string" ? tool.mcpRemoteName : undefined);
|
|
563
611
|
const cardId = rosterCardId(meta.source, tool.name, peer, protocolTool, d.contractId);
|
|
564
612
|
const { keys: inputKeys } = inputKeysOf(tool.parameters);
|
|
565
613
|
const declaredEffect = face.effect;
|
|
@@ -587,6 +635,7 @@ export function mintRosterEntry(tool, meta, facts) {
|
|
|
587
635
|
name: tool.name,
|
|
588
636
|
aliases: tool.aliases,
|
|
589
637
|
...(peer !== null ? { peer } : {}),
|
|
638
|
+
...(remoteName !== undefined ? { remoteName } : {}),
|
|
590
639
|
contractId: d.contractId,
|
|
591
640
|
implementationRevision: d.implementationRevision,
|
|
592
641
|
...(typeof face.modelGate === "string" ? { modelGate: face.modelGate } : {}),
|
|
@@ -599,11 +648,12 @@ export function mintRosterEntry(tool, meta, facts) {
|
|
|
599
648
|
aliases: [...new Set(tool.aliases ?? [])],
|
|
600
649
|
source: meta.source,
|
|
601
650
|
...(meta.origin !== undefined ? { origin: { peer: meta.origin.peer, ...(meta.origin.declaredBy !== undefined ? { declaredBy: meta.origin.declaredBy } : {}) } } : {}),
|
|
651
|
+
...(remoteName !== undefined ? { remoteName } : {}),
|
|
602
652
|
contract: { contractId: d.contractId, implementationRevision: d.implementationRevision },
|
|
603
653
|
shapeDigest: d.shapeDigest,
|
|
604
654
|
wireSchemaDigest: d.wireSchemaDigest,
|
|
605
655
|
cardId,
|
|
606
|
-
capabilityId: mintCapabilityId({ source: meta.source, peer, name: tool.name, contractId: d.contractId }),
|
|
656
|
+
capabilityId: mintCapabilityId({ source: meta.source, peer, name: tool.name, contractId: d.contractId, remote: remoteName }),
|
|
607
657
|
inputKeys,
|
|
608
658
|
effect,
|
|
609
659
|
effectProvenance,
|
|
@@ -706,8 +756,8 @@ export function ruleFacesFromRoster(roster) {
|
|
|
706
756
|
};
|
|
707
757
|
}
|
|
708
758
|
export function diffToolRoster(prev, next) {
|
|
709
|
-
const before = new Map(prev.entries.map((e) => [e.name,
|
|
710
|
-
const after = new Map(next.entries.map((e) => [e.name,
|
|
759
|
+
const before = new Map(prev.entries.map((e) => [e.name, canonicalJsonStringify(e)]));
|
|
760
|
+
const after = new Map(next.entries.map((e) => [e.name, canonicalJsonStringify(e)]));
|
|
711
761
|
const added = [];
|
|
712
762
|
const removed = [];
|
|
713
763
|
const changed = [];
|
|
@@ -1,9 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The deferral gate's POLICY SEAT as vocabulary: the three states a deployment may declare
|
|
3
|
-
* (`RunnerDeps.toolSearch`), the word a disclosure reports, and the ONE reader that lowers the seat to the
|
|
4
|
-
* single number the gate compares against. Pure — no harness, no roster, no I/O. `runner/tool-defer-gate.ts`
|
|
5
|
-
* owns the gate that consumes the number.
|
|
6
|
-
*/
|
|
7
1
|
/** The default threshold percent: with no seat, the candidate set defers when its inlined size reaches this
|
|
8
2
|
* percent of the model's context window. `DEFER_THRESHOLD_FRACTION` is derived from it. */
|
|
9
3
|
export declare const TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT = 10;
|
|
@@ -60,9 +54,13 @@ export declare function resolveToolSearch(setting: ToolSearchSetting | undefined
|
|
|
60
54
|
* `toString`); and `NaN` / `Infinity` — the two numbers these seats reject most — both came out as `null`,
|
|
61
55
|
* the spelling of a value the caller never wrote.
|
|
62
56
|
*
|
|
63
|
-
* So:
|
|
64
|
-
* and the `-0` a caller can only have written deliberately);
|
|
65
|
-
*
|
|
57
|
+
* So: a NUMBER, a boolean, a bigint, `null` and `undefined` are spelled exactly (a number through `String`, which is
|
|
58
|
+
* total and keeps `NaN`, `Infinity` and the `-0` a caller can only have written deliberately); a STRING or a symbol
|
|
59
|
+
* is the caller's text and takes its `callerText` shape — the redaction mark and its length, never the text (a
|
|
60
|
+
* deployment can put a credential in the wrong field, and this sentence travels to logs and panels); anything else
|
|
61
|
+
* is DESCRIBED structurally — its shape, the engine's word for its kind when its prototype is one of the built-ins
|
|
62
|
+
* in `BUILTIN_KINDS` (a `constructor` member or a class name is caller text and is never read as the word), and how
|
|
63
|
+
* many own keys it has (the keys are caller text too: counted, never spelled). Reading those may still hit a proxy's
|
|
66
64
|
* traps (every read is guarded), but NOTHING a read hands back is turned into text unless it is already a
|
|
67
65
|
* primitive of the expected domain — a formatting hook of the value is never what writes this sentence. A description is worth less to a reader than the value would be; a WRONG value is worth less than
|
|
68
66
|
* nothing, because it sends them to fix something they did not write.
|
|
@@ -1,3 +1,19 @@
|
|
|
1
|
+
import { callerText } from "./caller-text.js";
|
|
2
|
+
const BUILTIN_KINDS = Object.freeze([
|
|
3
|
+
[Map.prototype, "Map"],
|
|
4
|
+
[Set.prototype, "Set"],
|
|
5
|
+
[WeakMap.prototype, "WeakMap"],
|
|
6
|
+
[WeakSet.prototype, "WeakSet"],
|
|
7
|
+
[Date.prototype, "Date"],
|
|
8
|
+
[RegExp.prototype, "RegExp"],
|
|
9
|
+
[Promise.prototype, "Promise"],
|
|
10
|
+
[Error.prototype, "Error"],
|
|
11
|
+
[TypeError.prototype, "TypeError"],
|
|
12
|
+
[RangeError.prototype, "RangeError"],
|
|
13
|
+
[URL.prototype, "URL"],
|
|
14
|
+
[ArrayBuffer.prototype, "ArrayBuffer"],
|
|
15
|
+
[Uint8Array.prototype, "Uint8Array"],
|
|
16
|
+
]);
|
|
1
17
|
export const TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT = 10;
|
|
2
18
|
export const TOOL_SEARCH_INVALID_CODE = "config.tool_search_invalid";
|
|
3
19
|
export const TOOL_SEARCH_POLICIES = Object.freeze(["always", "never", "auto"]);
|
|
@@ -27,7 +43,7 @@ export function resolveToolSearch(setting) {
|
|
|
27
43
|
}
|
|
28
44
|
const stray = keys.find((k) => k !== "mode" && k !== "thresholdPercent");
|
|
29
45
|
if (stray !== undefined) {
|
|
30
|
-
throw toolSearchRefusal(`unknown member ${
|
|
46
|
+
throw toolSearchRefusal(`unknown member ${callerText(stray)} — the object form carries mode and thresholdPercent only`);
|
|
31
47
|
}
|
|
32
48
|
if (percent === undefined)
|
|
33
49
|
return { policy: "auto", thresholdPercent: TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT, fraction: TOOL_SEARCH_DEFAULT_THRESHOLD_PERCENT / 100 };
|
|
@@ -42,9 +58,8 @@ export function describeRejectedValue(value) {
|
|
|
42
58
|
case "bigint":
|
|
43
59
|
return `${value}n`;
|
|
44
60
|
case "symbol":
|
|
45
|
-
return String(value);
|
|
46
61
|
case "string":
|
|
47
|
-
return
|
|
62
|
+
return callerText(value);
|
|
48
63
|
case "number":
|
|
49
64
|
return Object.is(value, -0) ? "-0" : String(value);
|
|
50
65
|
case "boolean":
|
|
@@ -57,9 +72,10 @@ export function describeRejectedValue(value) {
|
|
|
57
72
|
return String(value);
|
|
58
73
|
let ctor = "";
|
|
59
74
|
try {
|
|
60
|
-
const
|
|
61
|
-
|
|
62
|
-
|
|
75
|
+
const proto = Object.getPrototypeOf(value);
|
|
76
|
+
const kind = BUILTIN_KINDS.find(([p]) => p === proto);
|
|
77
|
+
if (kind !== undefined)
|
|
78
|
+
ctor = ` (${kind[1]})`;
|
|
63
79
|
}
|
|
64
80
|
catch {
|
|
65
81
|
}
|
|
@@ -70,7 +86,7 @@ export function describeRejectedValue(value) {
|
|
|
70
86
|
const keys = Object.keys(value);
|
|
71
87
|
if (keys.length === 0)
|
|
72
88
|
return `an object${ctor} with no keys`;
|
|
73
|
-
return `an object${ctor} with
|
|
89
|
+
return `an object${ctor} with ${keys.length} key${keys.length === 1 ? "" : "s"}`;
|
|
74
90
|
}
|
|
75
91
|
catch {
|
|
76
92
|
return `a value of type ${value === null ? "null" : typeof value} that cannot be described`;
|
package/dist/core/tool-spec.d.ts
CHANGED
|
@@ -713,6 +713,9 @@ export interface ToolExecuteContext {
|
|
|
713
713
|
* (`RunInternals.rootSessionIncarnation`) and a background spawn persists it on its row, where a revival reads it back;
|
|
714
714
|
* absent = unknown (a row minted before occupants, a revival of a row that recorded none). */
|
|
715
715
|
rootSessionIncarnation?: string;
|
|
716
|
+
/** The scope that root session's box mounts in, beside its occupant by the same fixed point (`RunInternals.rootSessionScope`):
|
|
717
|
+
* a background spawn persists it on its row. Runner-filled, trusted; absent = none recorded. */
|
|
718
|
+
rootSessionScope?: string;
|
|
716
719
|
/** The run's delegation tree owner seat (`RunInternals.delegationOwner`, Runner-filled): a delegation tool reads the tree's owner
|
|
717
720
|
* through it for the rows it creates for a child (a placed transcript, a fork, a park's durable row) and threads it into a spawned
|
|
718
721
|
* child's internals by reference — never into a revival's. */
|
|
@@ -961,8 +964,20 @@ export interface ToolExecuteContext {
|
|
|
961
964
|
* verbatim to its child task so the end-user identity is inherited down the delegation tree (the worker
|
|
962
965
|
* cannot substitute a different principal — it is not a tool argument). Undefined when the task has no
|
|
963
966
|
* principal or the tool runs outside a Runner task.
|
|
967
|
+
*
|
|
968
|
+
* It names the PERSON. A tool that keys working state (a registry row it stops or lists, a background
|
|
969
|
+
* output it adopts, a peer address it guards) reads {@link isolationScope} instead — never this seat.
|
|
964
970
|
*/
|
|
965
971
|
principal?: string;
|
|
972
|
+
/**
|
|
973
|
+
* The running task's ISOLATION SCOPE ({@link TaskSpec.isolationScope}, else its principal), **read-only** — the
|
|
974
|
+
* Runner fills it on the same trusted seat as {@link principal}, never a model / tool argument. It is the key
|
|
975
|
+
* of the task's working state: a tool that registers, stops, lists or guards rows scoped to the run reads it
|
|
976
|
+
* through `callScopeOf(ctx, opts)` (the run's value, else the tool's mounted `scope`), so a row the run wrote
|
|
977
|
+
* and the tool that acts on it name one bucket. Undefined when the task has neither member or the tool runs
|
|
978
|
+
* outside a Runner task.
|
|
979
|
+
*/
|
|
980
|
+
isolationScope?: string;
|
|
966
981
|
/**
|
|
967
982
|
* ruled 2026-08-04 — the RUNNING task's EFFECTIVE synchronous approver (`spec.onAsk ?? deps.onAsk`,
|
|
968
983
|
* the exact value this task's own gate resolves an `ask` at), Runner-filled read-only on the same
|
|
@@ -1284,14 +1299,15 @@ export interface ToolExecuteContext {
|
|
|
1284
1299
|
decider: import("./auto-mode.js").AutoModeDecider;
|
|
1285
1300
|
};
|
|
1286
1301
|
/**
|
|
1287
|
-
* design/153 §7.4 (件4) — the parent task's `durableApproval` opt-in (value copy
|
|
1302
|
+
* design/153 §7.4 (件4) — the parent task's EFFECTIVE `durableApproval` opt-in (value copy: its own, or the one a
|
|
1303
|
+
* `forceDurableGate` entitlement synthesizes on a root leg — `effectiveDurableApprovalOf`), Runner-filled so a
|
|
1288
1304
|
* delegation tool can FORWARD it into an eligible background child's spec (named non-fork child + durable
|
|
1289
1305
|
* row + checkpoint store + `ensureChildSessionDurable` attested — the §7.3 park-eligibility family). With
|
|
1290
1306
|
* it forwarded, a child's plain policy `ask` suspends durably and the settle watcher PARKS the row instead
|
|
1291
1307
|
* of the pre-153 `unexpected.suspended` failure. Tighten-only: forwarding grants the child a PARK
|
|
1292
1308
|
* capability, never a permission widening — the park's resume decision stays with the operator, and the
|
|
1293
1309
|
* ancestor mandate chain (frozen at chain assembly) is unchanged by the child's own spec. Runner-filled,
|
|
1294
|
-
* read-only, NEVER a model/tool argument. Undefined when the parent
|
|
1310
|
+
* read-only, NEVER a model/tool argument. Undefined when the parent has no effective opt-in (children keep the
|
|
1295
1311
|
* pre-153 lifecycle byte-for-byte). Side effect worth noting (件4 复审): forwarding also flips the
|
|
1296
1312
|
* child's `durableQuestionFace` true (a wired checkpoint store + this opt-in), so an eligible child
|
|
1297
1313
|
* additionally mounts `AskUserQuestion` — a deliberate consequence (a question the child can't resolve
|
|
@@ -1325,6 +1341,14 @@ export interface ToolExecuteContext {
|
|
|
1325
1341
|
* {@link checkpointStoreForChildren}.
|
|
1326
1342
|
*/
|
|
1327
1343
|
taskRegistry?: import("./task-registry.js").TaskRegistry;
|
|
1344
|
+
/**
|
|
1345
|
+
* Whether the host run has committed a durable park (any gate) — read at call time. Runner-filled, read-only, NEVER a
|
|
1346
|
+
* model/tool argument; ABSENT when the tool runs outside a Runner task. A delegation tool's background lane reads it
|
|
1347
|
+
* when the host's abort reaches it: the abort a parking run stops its turn with is not a cancel of the background work
|
|
1348
|
+
* it owns — the run's own end decides that work's fate (each agent that can park yields, the rest are stopped), so the
|
|
1349
|
+
* lane leaves it to the run instead of killing the agent on the spot.
|
|
1350
|
+
*/
|
|
1351
|
+
hostRunParked?: () => boolean;
|
|
1328
1352
|
/**
|
|
1329
1353
|
* The host run's checkpoint SCOPE, for its children — the scope this run's own parked rows land in (the one
|
|
1330
1354
|
* value its prepare derived; a delegated host's is the scope ITS parent handed it, so a whole tree answers
|
|
@@ -1386,6 +1410,12 @@ export interface ToolExecuteContext {
|
|
|
1386
1410
|
* tool holding this ctx could self-declare one, so a consumer validates `parentTaskId` against its known runs.
|
|
1387
1411
|
*/
|
|
1388
1412
|
forwardEvent?: (event: TaskEvent) => void;
|
|
1413
|
+
/**
|
|
1414
|
+
* The host run's activity seat (`RunInternals.onSubtreeActivity`): a delegation tool threads it into each foreground child it runs, so the
|
|
1415
|
+
* child's — and its descendants' — tool work beats the same seat as the host's own. TRUSTED, run-scoped; absent when the run has no
|
|
1416
|
+
* seat. A timestamp write: it must not throw or wait.
|
|
1417
|
+
*/
|
|
1418
|
+
onSubtreeActivity?: () => void;
|
|
1389
1419
|
/**
|
|
1390
1420
|
* Subagent steer verb (2026-07-03): the host run's opt-in SUBAGENT-STEER-HANDLE sink
|
|
1391
1421
|
* (threaded from `RunInternals.onSubagentSpawn`). When present, `createSubagentTool` runs each sync
|
package/dist/core/tools.js
CHANGED
|
@@ -1,23 +1,12 @@
|
|
|
1
1
|
import { Value } from "typebox/value";
|
|
2
2
|
import { formatToolError, formatZodValidationError } from "./tool-errors.js";
|
|
3
|
-
import { readMember } from "./thrown-value.js";
|
|
3
|
+
import { readMember, thrownMarksOf } from "./thrown-value.js";
|
|
4
4
|
import { frozenToolSpec } from "./tool-spec-members.js";
|
|
5
5
|
import { carryDelegationName } from "./delegation-name.js";
|
|
6
6
|
import { attachEngineToolContract, attachToolContract, contractOriginOf } from "../prompt-assembly/tool-catalog.js";
|
|
7
7
|
import { isCatalogContract } from "./tool-catalog-entries.js";
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
10
|
-
import { carryNotStartedReceipt } from "./delegation-not-started.js";
|
|
11
|
-
const TOOL_DATA_MODE = Object.freeze({ accessors: "call-once", depth: Infinity, others: "copy", contain: true, wire: true, isProxy: (v) => types.isProxy(v) });
|
|
12
|
-
function receivedData(v) {
|
|
13
|
-
if (v === null || v === undefined || typeof v === "string" || typeof v === "number" || typeof v === "boolean")
|
|
14
|
-
return v;
|
|
15
|
-
const r = receive(v, TOOL_DATA_MODE);
|
|
16
|
-
if (!r.ok)
|
|
17
|
-
return undefined;
|
|
18
|
-
carryNotStartedReceipt(v, r.value);
|
|
19
|
-
return r.value;
|
|
20
|
-
}
|
|
8
|
+
import { appendOwn, dataMember, isPlainRecord } from "./mods/kernel/receive.js";
|
|
9
|
+
import { receivedToolData } from "./tool-data-door.js";
|
|
21
10
|
const CONTENT_BLOCK_FIELDS = Object.freeze({ text: ["text"], image: ["data", "mimeType"], document: ["data", "mimeType"] });
|
|
22
11
|
function blockOf(element) {
|
|
23
12
|
if (!isPlainRecord(element))
|
|
@@ -34,7 +23,7 @@ function blockOf(element) {
|
|
|
34
23
|
return block;
|
|
35
24
|
}
|
|
36
25
|
function receivedContent(raw) {
|
|
37
|
-
const copy =
|
|
26
|
+
const copy = receivedToolData(raw);
|
|
38
27
|
if (!Array.isArray(copy))
|
|
39
28
|
return undefined;
|
|
40
29
|
const out = [];
|
|
@@ -57,7 +46,7 @@ function receiveToolReturn(ret) {
|
|
|
57
46
|
isError: true,
|
|
58
47
|
};
|
|
59
48
|
}
|
|
60
|
-
return { content: content, details:
|
|
49
|
+
return { content: content, details: receivedToolData(readMember(ret, "details")), terminate: readMember(ret, "terminate") === true, isError: readMember(ret, "isError") === true };
|
|
61
50
|
}
|
|
62
51
|
function isEmptyToolContent(content) {
|
|
63
52
|
if (content.length === 0)
|
|
@@ -168,12 +157,9 @@ function buildProduct(spec, owner, options) {
|
|
|
168
157
|
}
|
|
169
158
|
catch (err) {
|
|
170
159
|
const wrapped = new Error(formatToolError(err));
|
|
171
|
-
const marks =
|
|
160
|
+
const marks = thrownMarksOf(err);
|
|
172
161
|
if (marks !== undefined)
|
|
173
162
|
wrapped.details = marks;
|
|
174
|
-
const errorKind = readMember(err, "errorKind");
|
|
175
|
-
if (typeof errorKind === "string")
|
|
176
|
-
wrapped.errorKind = errorKind;
|
|
177
163
|
throw wrapped;
|
|
178
164
|
}
|
|
179
165
|
},
|
package/dist/core/trace.d.ts
CHANGED
|
@@ -21,7 +21,8 @@ import type { ThinkingLevel } from "../internal/harness-types.js";
|
|
|
21
21
|
import type { ToolManifestRow } from "../prompt-assembly/tool-catalog.js";
|
|
22
22
|
import type { PromptEpochActivation, PromptIdentityLayers } from "../prompt-assembly/epoch.js";
|
|
23
23
|
import type { ChainLink, SupersededOverlay } from "../prompt-assembly/overlay.js";
|
|
24
|
-
import type { HostForm, HostRole, RendererId } from "../prompt-assembly/catalog/schema.js";
|
|
24
|
+
import type { HostForm, HostRole, PromptLocale, RendererId } from "../prompt-assembly/catalog/schema.js";
|
|
25
|
+
import type { AssertAllKeysHandled } from "./ask-origin.js";
|
|
25
26
|
/** The run's prompt identity as the manifest reports it: the identity digest, its inputs, and the session record that
|
|
26
27
|
* names it (the record's counter and how it came to be). */
|
|
27
28
|
export interface PromptManifestIdentity {
|
|
@@ -39,10 +40,14 @@ export interface PromptManifestSelectors {
|
|
|
39
40
|
form: HostForm;
|
|
40
41
|
};
|
|
41
42
|
facts: Record<string, boolean>;
|
|
43
|
+
/** Which rendering of the catalog the run reads (`TaskSpec.promptLocale`; absent ⇒ `canonical`). Always present. */
|
|
44
|
+
locale: PromptLocale;
|
|
42
45
|
}
|
|
43
|
-
/** One rendered section: where it sits, which variant and renderer made it,
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
+
/** One rendered section: where it sits, which variant and renderer made it, where its text comes from (`locale`, a
|
|
47
|
+
* source class, not a language reading: `overlay` — an overlay author's text is in force; else the run's locale when
|
|
48
|
+
* the section is catalog text or a renderer reported rendering a catalog message; else `canonical` — engine text
|
|
49
|
+
* outside the catalog or the run's own inputs), its content digest (`sha256:` unsalted for published text, `salted:`
|
|
50
|
+
* for text carrying the task's or the run's own inputs) and its history (`chain`). */
|
|
46
51
|
export interface PromptManifestSection {
|
|
47
52
|
id: string;
|
|
48
53
|
band: string;
|
|
@@ -53,7 +58,7 @@ export interface PromptManifestSection {
|
|
|
53
58
|
version: number;
|
|
54
59
|
};
|
|
55
60
|
chars: number;
|
|
56
|
-
locale:
|
|
61
|
+
locale: PromptLocale | "overlay";
|
|
57
62
|
contentHash: string;
|
|
58
63
|
chain: ChainLink[];
|
|
59
64
|
}
|
|
@@ -66,7 +71,7 @@ export interface PromptManifestSection {
|
|
|
66
71
|
export interface TraceMechanismsSummary {
|
|
67
72
|
finalVerifyInjections?: number;
|
|
68
73
|
attachmentsInjected?: number;
|
|
69
|
-
/** design/164: how many LIMIT-APPROACH
|
|
74
|
+
/** design/164: how many distinct LIMIT-APPROACH sentences a model request carried this run (0..2). */
|
|
70
75
|
approachNoticesSent?: number;
|
|
71
76
|
repetitionCuts?: number;
|
|
72
77
|
repetitionSpared?: number;
|
|
@@ -174,6 +179,15 @@ export type TraceEvent = {
|
|
|
174
179
|
cacheIdentity: string;
|
|
175
180
|
elements: import("../prompt-assembly/turn-snapshot.js").CacheIdentityElements;
|
|
176
181
|
};
|
|
182
|
+
/** Why the prefix moved — the declared word ({@link import("./cache-break-detector.js").PrefixChangeDeclaration});
|
|
183
|
+
* `leg_start_inputs` is the leg's first frame, against the session's anchor rather than an earlier request. */
|
|
184
|
+
cause: import("./cache-break-detector.js").PrefixChangeCause;
|
|
185
|
+
/** `tool_table` only: which writer moved the table. */
|
|
186
|
+
source?: import("../prompt-assembly/turn-snapshot.js").ToolTableSource;
|
|
187
|
+
/** `leg_start_inputs` only: the head segments that differ from the anchor (prompt block ids, `tools`). */
|
|
188
|
+
segments?: string[];
|
|
189
|
+
/** `tool_table` only: the first tool position whose wire face differs. */
|
|
190
|
+
firstChangedIndex?: number;
|
|
177
191
|
ts: number;
|
|
178
192
|
} | {
|
|
179
193
|
/**
|
|
@@ -350,8 +364,11 @@ export type TraceEvent = {
|
|
|
350
364
|
* cacheWrite`) — the figure `costMicroUsd` is computed from. */
|
|
351
365
|
totalInputTokens: number;
|
|
352
366
|
completionTokens: number;
|
|
353
|
-
|
|
354
|
-
|
|
367
|
+
/** Prompt tokens this call read from the provider's prefix cache; ABSENT when the call did not report it (never a 0). */
|
|
368
|
+
cacheRead?: number;
|
|
369
|
+
/** Prompt tokens this call wrote to the provider's prefix cache; ABSENT when the call did not report it (the
|
|
370
|
+
* OpenAI-shaped wires never do). */
|
|
371
|
+
cacheWrite?: number;
|
|
355
372
|
/** Wall time from the brain request to its final message. */
|
|
356
373
|
latencyMs: number;
|
|
357
374
|
/** Time to the first content delta (excludes thinking) — maps to OTel time_to_first_chunk (×1000). */
|
|
@@ -421,7 +438,7 @@ export type TraceEvent = {
|
|
|
421
438
|
taskId: string;
|
|
422
439
|
from: string;
|
|
423
440
|
to: string;
|
|
424
|
-
reason: "
|
|
441
|
+
reason: import("./model-fallbacks.js").DegradeReason;
|
|
425
442
|
atTurn: number;
|
|
426
443
|
ts: number;
|
|
427
444
|
} | {
|
|
@@ -567,11 +584,21 @@ export type TraceEvent = {
|
|
|
567
584
|
* The device lane's cross-boundary TAINT on a tree that executes on a target device: once when a leg is prepared on an armed
|
|
568
585
|
* tree (`phase: "prepare"`; `"resume"` on a durable resume's leg), and once when this leg first lets an off-target read into the
|
|
569
586
|
* tree (`"observed"`, with the call). A tree that never armed emits none. Metadata only.
|
|
587
|
+
*
|
|
588
|
+
* The frame is filed by `root` and labelled by `taskId`: `root` is the session the tree's person watches, the address a user-face
|
|
589
|
+
* notice of the same leg goes to (`noticeAddressOf`), so a tree's frames meet at one key whichever leg emitted them; `taskId`
|
|
590
|
+
* names the leg that emitted it.
|
|
570
591
|
*/
|
|
571
592
|
kind: "permission.cross_boundary_taint";
|
|
572
593
|
version: 1;
|
|
573
594
|
taskId: string;
|
|
574
595
|
runId: string;
|
|
596
|
+
/** Where the frame is filed. A top-level leg: its own session, no `occupant`. A delegated leg: the delegation tree's root
|
|
597
|
+
* session and, when the tree knows it, the occupant that session held when the tree was born (absent = unknown). */
|
|
598
|
+
root: {
|
|
599
|
+
sessionId: string;
|
|
600
|
+
occupant?: string;
|
|
601
|
+
};
|
|
575
602
|
phase: "prepare" | "resume" | "observed";
|
|
576
603
|
/** The tree's taint bits after the event. */
|
|
577
604
|
taint: readonly import("./cross-boundary-taint.js").CrossBoundaryTaintBit[];
|
|
@@ -964,8 +991,9 @@ export type TraceEvent = {
|
|
|
964
991
|
field: "requestId" | "responseModel" | "apiErrorCode";
|
|
965
992
|
ts: number;
|
|
966
993
|
} | {
|
|
967
|
-
/**
|
|
968
|
-
*
|
|
994
|
+
/** A `preemptSignal` this leg could not honour (it cannot suspend durably, or the suspend was refused
|
|
995
|
+
* without writing anything): the run keeps going. The telemetry projection of the same answer the
|
|
996
|
+
* deployment's error face carries; once per leg. */
|
|
969
997
|
kind: "preempt.ignored";
|
|
970
998
|
version: 1;
|
|
971
999
|
taskId: string;
|
|
@@ -1006,3 +1034,27 @@ export type TracerHook = (e: TraceEvent) => void;
|
|
|
1006
1034
|
* (`egressAccount`) — so a frame that carries a host's, a store's or a remote's words (a thrown text, a failure reason) needs no
|
|
1007
1035
|
* remembering at its mint site. */
|
|
1008
1036
|
export declare function emitTrace(tracer: TracerHook | undefined, build: () => TraceEvent): void;
|
|
1037
|
+
/** The kinds this build mints, one per {@link TraceEvent} arm — the union is the source, this list follows it. */
|
|
1038
|
+
export declare const TRACE_EVENT_KINDS: readonly ["task.start", "prompt.assembled", "prompt.snapshot_changed", "reasoning.resolved", "config.assembled", "config.additional_directory_skipped", "task.end", "turn.end", "brain.call", "tool.call", "repetition.detected", "task.degraded", "observer.notify_failed", "permission.persisted_rule_allowed", "permission.read_only_allowed", "permission.skill_allowed", "permission.allowed_tools_allowed", "permission.rule_store_unreadable", "permission.rule_sync_resurrected", "permission.rule_sync_dropped", "permission.org_snapshot_unavailable", "permission.cross_boundary_taint", "permission.sandbox_admitted", "auto_mode.classified", "brain.failover", "breaker.transition", "brain.retry", "loop.recovery", "compaction.suppressed", "compaction.unevaluable", "compaction.blocked", "compaction.failed", "compaction.mooted", "compaction.noop", "compaction.disabled", "compaction.window_config_warning", "compaction.model_fallback", "compaction.clamp_disclosure", "compaction.manual_in_finalize", "compaction.input_truncated", "compaction.phase_timings", "compaction.announce_dropped", "context.trim", "context.mc_clear", "context.mc_null", "tool_result.capped", "context.media_removed", "vision.placeholder", "brain.echo_dropped", "preempt.ignored", "review.dropped", "task.onerror_sink_failed"];
|
|
1039
|
+
/** Compile-time fence: `never` while the list and the union's `kind` words are the same words. */
|
|
1040
|
+
export type TraceEventKindsMatchTheUnion = AssertAllKeysHandled<Exclude<TraceEvent["kind"], (typeof TRACE_EVENT_KINDS)[number]> | Exclude<(typeof TRACE_EVENT_KINDS)[number], TraceEvent["kind"]>>;
|
|
1041
|
+
/** A word-valued member as a reader across a build boundary meets it: this build's words, or a word a later build adds. */
|
|
1042
|
+
type OpenWords<V> = V extends string ? (string extends V ? V : V | (string & {})) : V;
|
|
1043
|
+
type ReadArm<Arm> = Arm extends unknown ? {
|
|
1044
|
+
[K in keyof Arm]: K extends "kind" ? Arm[K] : OpenWords<Arm[K]>;
|
|
1045
|
+
} : never;
|
|
1046
|
+
/** A {@link TraceEvent} arm of a kind this build mints, as read from another build: the kind exact, every other word open. */
|
|
1047
|
+
export type KnownTraceRecord = ReadArm<TraceEvent>;
|
|
1048
|
+
/**
|
|
1049
|
+
* A trace record read where it may come from another build — stored and read back, or forwarded and read
|
|
1050
|
+
* elsewhere: an arm of a kind this build mints, or a record of a kind it does not. {@link TracerHook} keeps the
|
|
1051
|
+
* closed {@link TraceEvent}, since in process the record is this build's own. Its reading is `vocabulary.open`
|
|
1052
|
+
* (`OPEN_FACE`); branch on its arms only after {@link isKnownTraceEvent}.
|
|
1053
|
+
*/
|
|
1054
|
+
export type TraceRecord = KnownTraceRecord | {
|
|
1055
|
+
readonly kind: string;
|
|
1056
|
+
readonly [member: string]: unknown;
|
|
1057
|
+
};
|
|
1058
|
+
/** Whether a record's own `kind` is one this build mints — an inherited or non-string `kind` is not. Only the kind is read. */
|
|
1059
|
+
export declare function isKnownTraceEvent(record: TraceRecord): record is KnownTraceRecord;
|
|
1060
|
+
export {};
|
package/dist/core/trace.js
CHANGED
|
@@ -8,3 +8,22 @@ export function emitTrace(tracer, build) {
|
|
|
8
8
|
catch {
|
|
9
9
|
}
|
|
10
10
|
}
|
|
11
|
+
export const TRACE_EVENT_KINDS = Object.freeze([
|
|
12
|
+
"task.start", "prompt.assembled", "prompt.snapshot_changed", "reasoning.resolved", "config.assembled",
|
|
13
|
+
"config.additional_directory_skipped", "task.end", "turn.end", "brain.call", "tool.call", "repetition.detected",
|
|
14
|
+
"task.degraded", "observer.notify_failed", "permission.persisted_rule_allowed", "permission.read_only_allowed",
|
|
15
|
+
"permission.skill_allowed", "permission.allowed_tools_allowed", "permission.rule_store_unreadable",
|
|
16
|
+
"permission.rule_sync_resurrected", "permission.rule_sync_dropped", "permission.org_snapshot_unavailable",
|
|
17
|
+
"permission.cross_boundary_taint", "permission.sandbox_admitted", "auto_mode.classified", "brain.failover",
|
|
18
|
+
"breaker.transition", "brain.retry", "loop.recovery", "compaction.suppressed", "compaction.unevaluable",
|
|
19
|
+
"compaction.blocked", "compaction.failed", "compaction.mooted", "compaction.noop", "compaction.disabled",
|
|
20
|
+
"compaction.window_config_warning", "compaction.model_fallback", "compaction.clamp_disclosure",
|
|
21
|
+
"compaction.manual_in_finalize", "compaction.input_truncated", "compaction.phase_timings",
|
|
22
|
+
"compaction.announce_dropped", "context.trim", "context.mc_clear", "context.mc_null", "tool_result.capped",
|
|
23
|
+
"context.media_removed", "vision.placeholder", "brain.echo_dropped", "preempt.ignored", "review.dropped",
|
|
24
|
+
"task.onerror_sink_failed",
|
|
25
|
+
]);
|
|
26
|
+
const TRACE_EVENT_KIND_SET = new Set(TRACE_EVENT_KINDS);
|
|
27
|
+
export function isKnownTraceEvent(record) {
|
|
28
|
+
return typeof record === "object" && record !== null && Object.hasOwn(record, "kind") && TRACE_EVENT_KIND_SET.has(record.kind);
|
|
29
|
+
}
|