@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
|
@@ -9,6 +9,9 @@ import { mintNamespacePrefix } from "../protocol-naming.js";
|
|
|
9
9
|
import { PROTOCOL_TABLE, protocolOf } from "../protocol-table.js";
|
|
10
10
|
import { grantWildcardRefusalOf, mountedToolNames, splitNamespacedName } from "../tool-name-aliases.js";
|
|
11
11
|
import { POLICY_NAME_REFUSAL_CODE, retiredToolNameNotice } from "../retired-tool-name-account.js";
|
|
12
|
+
import { unmatchedNameIdentity, unmatchedNameWarning, unmatchedNamesNotice } from "../unmatched-tool-names.js";
|
|
13
|
+
import { DEFINITION_ENTRY_CODE, DEFINITION_ENTRY_REASON, definitionEntryIdentity, definitionEntryNotice, definitionEntryWarning } from "../definition-entry-grammar.js";
|
|
14
|
+
import { closestName } from "../closest-name.js";
|
|
12
15
|
import { projectionToolNames } from "../tool-policy.js";
|
|
13
16
|
import { declaredDelegationNameOf } from "../delegation-name.js";
|
|
14
17
|
import { announceDigest } from "./announce-once-ledger.js";
|
|
@@ -61,6 +64,7 @@ function childFacingUniverse(pool, declaredPeers) {
|
|
|
61
64
|
const known = new Set([...mountedToolNames(ENGINE_TOOLS), ...pool.names]);
|
|
62
65
|
return { known, peers: peersOf(known, declaredPeers), complete: pool.complete, carrierOf: (name) => (pool.names.has(name) ? "pool" : "catalog") };
|
|
63
66
|
}
|
|
67
|
+
const NO_LISTS = Object.freeze({ deny: Object.freeze([]) });
|
|
64
68
|
const DENY_LIST_NAMES_ONLY = "To block by path or command, write a deny rule in the caller's permission policy: a tool-name list only takes tool names (it narrows which tools are mounted).";
|
|
65
69
|
function universeCarries(reach, entry, universe) {
|
|
66
70
|
for (const name of universe.known)
|
|
@@ -94,23 +98,53 @@ const NEAR_MISS_EFFECT = {
|
|
|
94
98
|
function nearMissRefusal(where, side, flaw, code) {
|
|
95
99
|
return refused(`${where} declares tool ${inertEntryPhrase(flaw)} in its ${LIST_WORD[side]}, a spelling that reaches no tool a run mounts — ${NEAR_MISS_EFFECT[side]}. Write the name as the tool is mounted.`, code, "near_miss");
|
|
96
100
|
}
|
|
97
|
-
function
|
|
98
|
-
return
|
|
101
|
+
function grammarSentence(where, side, entry, consequence) {
|
|
102
|
+
return `${where} declares tool ${inertEntryPhrase({ entry, reason: "grammar" })} in its ${LIST_WORD[side]}, a spelling no tool name can have — ${consequence} ${DENY_LIST_NAMES_ONLY}`;
|
|
99
103
|
}
|
|
100
|
-
|
|
104
|
+
const GRAMMAR_REFUSES_THE_RUN = "fix the entry.";
|
|
105
|
+
const GRAMMAR_REFUSES_THE_DEFINITION = "this agent cannot be delegated to until the entry is fixed.";
|
|
106
|
+
const isGrammarFlaw = (flaw) => flaw.reason === DEFINITION_ENTRY_REASON;
|
|
107
|
+
const isStructuralFlaw = (flaw) => flaw.reason !== DEFINITION_ENTRY_REASON;
|
|
108
|
+
function readToolNameListForm(where, side, value) {
|
|
101
109
|
if (value === undefined || value === null)
|
|
102
|
-
return [];
|
|
110
|
+
return { entries: [], flaws: [] };
|
|
103
111
|
const list = readToolNameList(value);
|
|
104
112
|
if (list.kind !== "entries")
|
|
105
|
-
|
|
106
|
-
|
|
113
|
+
return { entries: [], flaws: [{ reason: "not_a_list", message: notAListSentence(where, side, list) }] };
|
|
114
|
+
const entries = [];
|
|
115
|
+
const flaws = [];
|
|
116
|
+
list.entries.forEach((entry, index) => {
|
|
107
117
|
const read = readDeniedEntry(entry);
|
|
108
118
|
if (read.kind === "not_a_string")
|
|
109
|
-
|
|
110
|
-
if (read.kind === "unreadable")
|
|
111
|
-
|
|
112
|
-
|
|
119
|
+
flaws.push({ reason: "not_a_string", message: notAStringSentence(where, side, index, read.type) });
|
|
120
|
+
else if (read.kind === "unreadable")
|
|
121
|
+
flaws.push({ reason: DEFINITION_ENTRY_REASON, entry: read.entry });
|
|
122
|
+
else
|
|
123
|
+
entries.push({ entry: entry, name: read.name, content: read.content });
|
|
113
124
|
});
|
|
125
|
+
return { entries, flaws };
|
|
126
|
+
}
|
|
127
|
+
function formRefusal(where, side, flaw, code) {
|
|
128
|
+
if (isStructuralFlaw(flaw))
|
|
129
|
+
return refused(flaw.message, code, flaw.reason);
|
|
130
|
+
return refused(grammarSentence(where, side, flaw.entry, GRAMMAR_REFUSES_THE_RUN), code, "unknown_name");
|
|
131
|
+
}
|
|
132
|
+
function readableToolNameList(where, side, value, code) {
|
|
133
|
+
const form = readToolNameListForm(where, side, value);
|
|
134
|
+
const first = form.flaws[0];
|
|
135
|
+
if (first !== undefined)
|
|
136
|
+
throw formRefusal(where, side, first, code);
|
|
137
|
+
return form.entries;
|
|
138
|
+
}
|
|
139
|
+
export function toolNameListFlaw(where, side, value, withGrammar) {
|
|
140
|
+
return definitionFlawOf(where, side, readToolNameListForm(where, side, value).flaws, withGrammar);
|
|
141
|
+
}
|
|
142
|
+
function definitionFlawOf(where, side, flaws, withGrammar) {
|
|
143
|
+
const structural = flaws.find(isStructuralFlaw);
|
|
144
|
+
if (structural !== undefined)
|
|
145
|
+
return { message: structural.message, reason: structural.reason };
|
|
146
|
+
const grammar = withGrammar ? flaws.find(isGrammarFlaw) : undefined;
|
|
147
|
+
return grammar !== undefined ? { message: grammarSentence(where, side, grammar.entry, GRAMMAR_REFUSES_THE_DEFINITION), reason: grammar.reason } : undefined;
|
|
114
148
|
}
|
|
115
149
|
const KEPT_ENTRY = {
|
|
116
150
|
allowed: "it grants nothing today and stays in force for a tool of that name mounted later",
|
|
@@ -118,8 +152,16 @@ const KEPT_ENTRY = {
|
|
|
118
152
|
};
|
|
119
153
|
const KEPT_ENTRY_UNLISTED_POOL = "so it is kept here: the pool this delegation tool hands its child cannot be listed, and the spawned child judges the entry against its own roster (another spelling of a tool it carries refuses the child before it starts; an exact name takes effect; a name nothing answers to there stays in force for a tool of that name mounted later)";
|
|
120
154
|
const PEER_WORD = { mcp: "MCP server", a2a: "A2A peer" };
|
|
121
|
-
function judgeToolNameList(where, side, value, universe, advise, code, retired) {
|
|
122
|
-
|
|
155
|
+
function judgeToolNameList(where, side, value, universe, advise, code, retired, definition) {
|
|
156
|
+
const form = readToolNameListForm(where, side, value);
|
|
157
|
+
const refusing = definition === true ? form.flaws.find(isStructuralFlaw) : form.flaws[0];
|
|
158
|
+
if (refusing !== undefined)
|
|
159
|
+
throw formRefusal(where, side, refusing, code);
|
|
160
|
+
const first = form.flaws.find(isGrammarFlaw);
|
|
161
|
+
if (first !== undefined) {
|
|
162
|
+
advise(definitionEntryWarning(grammarSentence(where, side, first.entry, GRAMMAR_REFUSES_THE_DEFINITION), { where: inlineUntrusted(where, 160), side, entry: inlineUntrusted(first.entry, 120), identity: JSON.stringify([where, side, first.entry]) }));
|
|
163
|
+
}
|
|
164
|
+
for (const { entry, name: toolName, content: written } of form.entries) {
|
|
123
165
|
if (toolName === "*" && !written)
|
|
124
166
|
continue;
|
|
125
167
|
const name = side === "denied" || !written ? toolName : entry;
|
|
@@ -152,11 +194,26 @@ function judgeToolNameList(where, side, value, universe, advise, code, retired)
|
|
|
152
194
|
const phrase = flaw !== undefined ? inertEntryPhrase(flaw) : renderListEntry(entry);
|
|
153
195
|
const undeclared = split !== undefined && split.peer !== "" && !split.peer.includes("*") && !universe.peers.has(mintNamespacePrefix(split.ns, split.peer));
|
|
154
196
|
const why = undeclared ? `no ${PEER_WORD[split.ns.id]} named "${inlineUntrusted(split.peer, 80)}" is declared for this task` : universe.complete ? "no tool of this task answers to that name" : "no tool this run can list answers to that name";
|
|
155
|
-
|
|
197
|
+
const near = flaw?.currentName === undefined ? closestName(toolName, universe.known) : undefined;
|
|
198
|
+
const nearest = near !== undefined && near !== toolName ? near : undefined;
|
|
199
|
+
const hint = nearest !== undefined ? ` The nearest name ${universe.complete ? "a tool of this task answers to" : "a tool this run can list answers to"} is "${inlineUntrusted(nearest, 80)}".` : "";
|
|
200
|
+
advise(unmatchedNameWarning(`${where} declares tool ${phrase} in its ${LIST_WORD[side]}: ${why}, ${universe.complete ? `so ${KEPT_ENTRY[side]}` : KEPT_ENTRY_UNLISTED_POOL}. If the name is misspelt, fix the entry.${hint}`, {
|
|
201
|
+
where: inlineUntrusted(where, 160),
|
|
202
|
+
side,
|
|
203
|
+
entry: inlineUntrusted(entry, 120),
|
|
204
|
+
identity: JSON.stringify([where, side, entry]),
|
|
205
|
+
...(nearest !== undefined ? { nearest: inlineUntrusted(nearest, 80) } : {}),
|
|
206
|
+
}));
|
|
156
207
|
}
|
|
157
208
|
}
|
|
158
|
-
export function
|
|
159
|
-
return
|
|
209
|
+
export function workflowAgentTypeWhere(agentType) {
|
|
210
|
+
return `workflow agentType "${inlineUntrusted(agentType, 80)}"`;
|
|
211
|
+
}
|
|
212
|
+
export function refuseUnusableDefinition(agentType, lists) {
|
|
213
|
+
const where = workflowAgentTypeWhere(agentType);
|
|
214
|
+
const flaw = toolNameListFlaw(where, "allowed", lists.allowTools, true) ?? toolNameListFlaw(where, "denied", lists.denyTools, true);
|
|
215
|
+
if (flaw !== undefined)
|
|
216
|
+
throw refused(flaw.message, DEFINITION_ENTRY_CODE, flaw.reason);
|
|
160
217
|
}
|
|
161
218
|
function inheritedListsWhere(ceilings, i) {
|
|
162
219
|
const up = ceilings - 1 - i;
|
|
@@ -192,32 +249,42 @@ export function readToolSelector(input) {
|
|
|
192
249
|
});
|
|
193
250
|
return compileToolSelector(read, input.legs);
|
|
194
251
|
}
|
|
195
|
-
function
|
|
252
|
+
function readOwnToolListsRecord(value) {
|
|
196
253
|
try {
|
|
197
254
|
if (typeof value !== "object" || value === null || Array.isArray(value))
|
|
198
|
-
return `a value that is ${valueTypeLabel(value)}, not a tool name with an agent definition name and the digest of the lists it wrote
|
|
255
|
+
return { flaw: `a value that is ${valueTypeLabel(value)}, not a tool name with an agent definition name and the digest of the lists it wrote` };
|
|
199
256
|
const { toolName, definition, lists } = value;
|
|
200
257
|
if (typeof toolName !== "string" || toolName.length === 0)
|
|
201
|
-
return `a tool whose name is ${typeof toolName === "string" ? "empty" : `a value that is ${valueTypeLabel(toolName)}`}, not a tool name
|
|
258
|
+
return { flaw: `a tool whose name is ${typeof toolName === "string" ? "empty" : `a value that is ${valueTypeLabel(toolName)}`}, not a tool name` };
|
|
202
259
|
const problem = callerToolNameProblem(toolName);
|
|
203
260
|
if (problem !== undefined)
|
|
204
|
-
return `a tool whose name is not one a caller tool can carry (${problem})
|
|
261
|
+
return { flaw: `a tool whose name is not one a caller tool can carry (${problem})` };
|
|
205
262
|
if (definition !== undefined && typeof definition !== "string")
|
|
206
|
-
return `an agent definition whose name is a value that is ${valueTypeLabel(definition)}, not a name
|
|
263
|
+
return { flaw: `an agent definition whose name is a value that is ${valueTypeLabel(definition)}, not a name` };
|
|
207
264
|
if (definition === "")
|
|
208
|
-
return "an agent definition whose name is empty, not a name";
|
|
265
|
+
return { flaw: "an agent definition whose name is empty, not a name" };
|
|
209
266
|
if (lists === undefined)
|
|
210
|
-
return "a record with no digest of the lists it wrote";
|
|
267
|
+
return { flaw: "a record with no digest of the lists it wrote" };
|
|
211
268
|
if (typeof lists !== "string")
|
|
212
|
-
return `a digest of the lists it wrote that is a value that is ${valueTypeLabel(lists)}, not a digest
|
|
269
|
+
return { flaw: `a digest of the lists it wrote that is a value that is ${valueTypeLabel(lists)}, not a digest` };
|
|
213
270
|
if (lists.length === 0)
|
|
214
|
-
return "a digest of the lists it wrote that is empty, not a digest";
|
|
215
|
-
return
|
|
271
|
+
return { flaw: "a digest of the lists it wrote that is empty, not a digest" };
|
|
272
|
+
return { lists };
|
|
216
273
|
}
|
|
217
274
|
catch {
|
|
218
|
-
return "a value that cannot be read";
|
|
275
|
+
return { flaw: "a value that cannot be read" };
|
|
219
276
|
}
|
|
220
277
|
}
|
|
278
|
+
function ownToolListsFlaw(value) {
|
|
279
|
+
const read = readOwnToolListsRecord(value);
|
|
280
|
+
return "flaw" in read ? read.flaw : undefined;
|
|
281
|
+
}
|
|
282
|
+
export function ownToolListsDigestOf(value) {
|
|
283
|
+
if (value === undefined)
|
|
284
|
+
return undefined;
|
|
285
|
+
const read = readOwnToolListsRecord(value);
|
|
286
|
+
return "lists" in read ? read.lists : undefined;
|
|
287
|
+
}
|
|
221
288
|
export function persistedToolNamesRefusal(ceiling, chain, ownLists) {
|
|
222
289
|
const pending = "refused before the claim (the checkpoint stays pending): finish it on a worker of the engine that parked it, or expire it and run the work again";
|
|
223
290
|
const ownFlaw = ownLists === undefined ? undefined : ownToolListsFlaw(ownLists);
|
|
@@ -290,36 +357,69 @@ export function judgeRunToolLists(input) {
|
|
|
290
357
|
catch {
|
|
291
358
|
}
|
|
292
359
|
};
|
|
360
|
+
const authorWarnings = [];
|
|
361
|
+
const adviseAuthor = (err) => {
|
|
362
|
+
advise(err);
|
|
363
|
+
authorWarnings.push(err);
|
|
364
|
+
};
|
|
365
|
+
const tellOnce = (code, identity, deliver) => {
|
|
366
|
+
try {
|
|
367
|
+
onceLedger.oncePerSession(announceDigest(`${code}:user`, identity), deliver);
|
|
368
|
+
}
|
|
369
|
+
catch {
|
|
370
|
+
}
|
|
371
|
+
};
|
|
372
|
+
const tellAuthors = () => {
|
|
373
|
+
for (const warning of authorWarnings) {
|
|
374
|
+
const unmatched = unmatchedNamesNotice(warning, sessionId);
|
|
375
|
+
const unmatchedKey = unmatchedNameIdentity(warning);
|
|
376
|
+
if (unmatched !== undefined && unmatchedKey !== undefined)
|
|
377
|
+
tellOnce(unmatched.code, unmatchedKey, () => deliverEngineNotice(input.onNotice, unmatched));
|
|
378
|
+
const grammar = definitionEntryNotice(warning, sessionId);
|
|
379
|
+
const grammarKey = definitionEntryIdentity(warning);
|
|
380
|
+
if (grammar !== undefined && grammarKey !== undefined)
|
|
381
|
+
tellOnce(grammar.code, grammarKey, () => deliverEngineNotice(input.onNotice, grammar));
|
|
382
|
+
}
|
|
383
|
+
};
|
|
293
384
|
const ownWhere = ownListsWhereOf(input.ownBy);
|
|
294
385
|
const selector = input.selector;
|
|
295
|
-
const
|
|
296
|
-
|
|
297
|
-
|
|
386
|
+
const definitionAt = input.definition !== undefined ? selector.layers.length - 2 : -1;
|
|
387
|
+
const definitionLayer = selector.layers[definitionAt];
|
|
388
|
+
const definitionWhere = input.definition !== undefined ? workflowAgentTypeWhere(input.definition.agentType) : undefined;
|
|
389
|
+
const denied = deniedProtocolTools(selector.layers.filter((_, i) => i !== definitionAt), input.legs);
|
|
390
|
+
const deniedByDefinition = definitionLayer !== undefined ? deniedProtocolTools([definitionLayer, NO_LISTS], input.legs) : [];
|
|
391
|
+
if (denied.length > 0 || deniedByDefinition.length > 0) {
|
|
392
|
+
const names = [...new Set([...denied, ...deniedByDefinition].map((h) => `"${h.name}"`))];
|
|
298
393
|
const one = names.length === 1;
|
|
299
|
-
const deniedBy = (own, whose) => {
|
|
300
|
-
const hits =
|
|
301
|
-
return hits.length > 0 ? [`${whose} denies ${one ? "it" : hits.join(", ")}`] : [];
|
|
394
|
+
const deniedBy = (from, own, whose) => {
|
|
395
|
+
const hits = from.filter((h) => h.own === own).map((h) => `"${h.name}"`);
|
|
396
|
+
return hits.length > 0 && whose !== undefined ? [`${whose} denies ${one ? "it" : hits.join(", ")}`] : [];
|
|
302
397
|
};
|
|
303
|
-
const by = [...deniedBy(true, ownWhere ?? "this run's own excludeTools"), ...deniedBy(false, "an inherited list (the spawning run's excludeTools, or one it inherits)")];
|
|
398
|
+
const by = [...deniedBy(denied, true, ownWhere ?? "this run's own excludeTools"), ...deniedBy(deniedByDefinition, false, definitionWhere), ...deniedBy(denied, false, "an inherited list (the spawning run's excludeTools, or one it inherits)")];
|
|
304
399
|
throw refused(`This kind of leg (${input.legs.join(", ")}) relies on ${names.join(", ")}, but ${by.join(" and ")} — the leg cannot work without ${one ? "it" : "them"}. Remove the entry from the list that names it.`, "config.tool_face_control", "protocol_denied");
|
|
305
400
|
}
|
|
306
401
|
const pool = delegationPoolReading(spec.tools ?? [], valveLeaves(spec, selector));
|
|
307
402
|
const mounted = mountedToolNames([...tools, ...(spec.tools ?? [])]);
|
|
308
403
|
const withOwnServers = (servers) => servers === undefined || servers.length === 0 ? input.declaredPeers : { ...input.declaredPeers, mcp: [...(input.declaredPeers.mcp ?? []), ...servers] };
|
|
309
404
|
const definitionServers = [...(spec.agents ?? []).flatMap((d) => d.mcp ?? []), ...pool.tools.flatMap((t) => (t.agentToolFaces ?? []).flatMap((f) => f.servers ?? []))];
|
|
405
|
+
const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, withOwnServers(definitionServers));
|
|
310
406
|
if (!input.judgedUpstream) {
|
|
311
|
-
const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, withOwnServers(definitionServers));
|
|
312
407
|
const own = [["allowed", input.own.allow], ["denied", input.own.exclude]];
|
|
313
408
|
const silent = () => undefined;
|
|
314
409
|
const told = input.toldUpstream === true;
|
|
410
|
+
const ownAdvise = told ? silent : ownWhere === undefined ? adviseAuthor : advise;
|
|
315
411
|
for (const [side, value] of own)
|
|
316
|
-
judgeToolNameList(ownWhere ?? (side === "allowed" ? "TaskSpec.allowTools" : "TaskSpec.excludeTools"), side, value, root,
|
|
412
|
+
judgeToolNameList(ownWhere ?? (side === "allowed" ? "TaskSpec.allowTools" : "TaskSpec.excludeTools"), side, value, root, ownAdvise, "config.tool_face_control", told ? silent : retire);
|
|
413
|
+
}
|
|
414
|
+
if (definitionLayer !== undefined && definitionWhere !== undefined) {
|
|
415
|
+
judgeToolNameList(definitionWhere, "allowed", definitionLayer.allow, root, advise, "config.agent.unknown_tool", undefined, true);
|
|
416
|
+
judgeToolNameList(definitionWhere, "denied", definitionLayer.deny, root, advise, "config.agent.unknown_tool", retire, true);
|
|
317
417
|
}
|
|
318
418
|
const childUniverses = (servers) => pool.tools.length > 0 ? pool.tools.map((t) => childFacingUniverse(poolOf([t]), withOwnServers(servers))) : [childFacingUniverse(poolOf([]), withOwnServers(servers))];
|
|
319
419
|
for (const def of spec.agents ?? []) {
|
|
320
420
|
for (const universe of childUniverses(def.mcp)) {
|
|
321
|
-
judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "allowed", def.allowTools, universe,
|
|
322
|
-
judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "denied", def.denyTools, universe,
|
|
421
|
+
judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "allowed", def.allowTools, universe, adviseAuthor, "config.agent.unknown_tool", undefined, true);
|
|
422
|
+
judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "denied", def.denyTools, universe, adviseAuthor, "config.agent.unknown_tool", retire, true);
|
|
323
423
|
}
|
|
324
424
|
}
|
|
325
425
|
const replaced = new Set((spec.agents ?? []).map((d) => d.name));
|
|
@@ -329,13 +429,14 @@ export function judgeRunToolLists(input) {
|
|
|
329
429
|
if (face.authored === true && !replaced.has(face.name)) {
|
|
330
430
|
const faceWhere = delegationListWhere(t.name, face.name);
|
|
331
431
|
const faceUniverse = childFacingUniverse(poolOf([t]), withOwnServers(face.servers));
|
|
332
|
-
judgeToolNameList(faceWhere, "allowed", face.allowTools, faceUniverse, advise, "config.agent.unknown_tool");
|
|
333
|
-
judgeToolNameList(faceWhere, "denied", face.denyTools, faceUniverse, advise, "config.agent.unknown_tool", retire);
|
|
432
|
+
judgeToolNameList(faceWhere, "allowed", face.allowTools, faceUniverse, advise, "config.agent.unknown_tool", undefined, true);
|
|
433
|
+
judgeToolNameList(faceWhere, "denied", face.denyTools, faceUniverse, advise, "config.agent.unknown_tool", retire, true);
|
|
334
434
|
}
|
|
335
435
|
}
|
|
336
436
|
judgeToolNameList(delegationListWhere(t.name, undefined), "allowed", t.agentToolLevelAllowTools, universe, advise, "config.agent.unknown_tool");
|
|
337
437
|
judgeToolNameList(delegationListWhere(t.name, undefined), "denied", t.agentToolLevelDenyTools, universe, advise, "config.agent.unknown_tool", retire);
|
|
338
438
|
}
|
|
439
|
+
tellAuthors();
|
|
339
440
|
if (retiredLeftOut.length > 0) {
|
|
340
441
|
const notice = retiredToolNameNotice("task_selector", retiredLeftOut, sessionId);
|
|
341
442
|
const whole = [...new Set(retiredLeftOut.map((e) => `${e.field}\u0000${e.entry}\u0000${e.source ?? ""}`))].sort();
|
|
@@ -40,3 +40,9 @@ export declare class TeardownLegTimeoutError extends Error {
|
|
|
40
40
|
* arm it could not previously keep.
|
|
41
41
|
*/
|
|
42
42
|
export declare function settleTeardownLeg(leg: () => Promise<unknown> | unknown, label: string, report?: (err: Error) => void): Promise<void>;
|
|
43
|
+
/**
|
|
44
|
+
* The same bound for a leg whose ANSWER the caller needs (a worktree settle says `pruned` or `kept`): the leg's value, its
|
|
45
|
+
* own throw, or a {@link TeardownLegTimeoutError} when it has not settled within the bound — the caller decides what each
|
|
46
|
+
* means. {@link settleTeardownLeg} is this race with every outcome routed to a report; one bound, one race.
|
|
47
|
+
*/
|
|
48
|
+
export declare function raceTeardownLeg<T>(leg: () => Promise<T> | T, label: string): Promise<T>;
|
|
@@ -15,14 +15,8 @@ export class TeardownLegTimeoutError extends Error {
|
|
|
15
15
|
}
|
|
16
16
|
}
|
|
17
17
|
export async function settleTeardownLeg(leg, label, report) {
|
|
18
|
-
let timer;
|
|
19
18
|
try {
|
|
20
|
-
await
|
|
21
|
-
Promise.resolve().then(leg),
|
|
22
|
-
new Promise((_, reject) => {
|
|
23
|
-
timer = setTimeout(() => reject(new TeardownLegTimeoutError(label, teardownLegBudgetMs)), teardownLegBudgetMs);
|
|
24
|
-
}),
|
|
25
|
-
]);
|
|
19
|
+
await raceTeardownLeg(leg, label);
|
|
26
20
|
}
|
|
27
21
|
catch (e) {
|
|
28
22
|
try {
|
|
@@ -31,6 +25,17 @@ export async function settleTeardownLeg(leg, label, report) {
|
|
|
31
25
|
catch {
|
|
32
26
|
}
|
|
33
27
|
}
|
|
28
|
+
}
|
|
29
|
+
export async function raceTeardownLeg(leg, label) {
|
|
30
|
+
let timer;
|
|
31
|
+
try {
|
|
32
|
+
return await Promise.race([
|
|
33
|
+
Promise.resolve().then(leg),
|
|
34
|
+
new Promise((_, reject) => {
|
|
35
|
+
timer = setTimeout(() => reject(new TeardownLegTimeoutError(label, teardownLegBudgetMs)), teardownLegBudgetMs);
|
|
36
|
+
}),
|
|
37
|
+
]);
|
|
38
|
+
}
|
|
34
39
|
finally {
|
|
35
40
|
if (timer !== undefined)
|
|
36
41
|
clearTimeout(timer);
|
|
@@ -22,6 +22,8 @@ export declare function loopExitFailureOf(reason: LoopTerminalReason | undefined
|
|
|
22
22
|
* admitted only as a word of its closed set (a host Brain mints this message too); the reset instant only beside a
|
|
23
23
|
* condition. Absent members stay absent. */
|
|
24
24
|
export declare function providerVerdictOf(final: AssistantMessage): Pick<ProviderRejected, "providerCondition" | "providerConditionSource" | "providerResetAtMs">;
|
|
25
|
+
/** The terminal message's provider sentence, admitted through the one pass over a remote's words (a host Brain mints this message too); absent when it states none. */
|
|
26
|
+
export declare function providerSentenceOf(final: AssistantMessage): Pick<ProviderRejected, "providerMessage">;
|
|
25
27
|
/** The part of the request the terminal message's refusal named, from the message's `errorKind` and `refusedTool` as the
|
|
26
28
|
* terminal read them (each once): the kind admitted only as a word of `REFUSED_REQUEST_PARTS`, a tool-schema refusal only
|
|
27
29
|
* with its tool (a non-empty string), else no account. */
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { MODEL_OUTPUT_INVALID_CAUSES } from "../../internal/llm.js";
|
|
2
2
|
import { isProviderEchoShape } from "../../brain/errors.js";
|
|
3
|
+
import { admittedProviderMessage } from "../../brain/provider-message.js";
|
|
3
4
|
import { isProviderCondition, isProviderConditionSource } from "../../brain/provider-dialect.js";
|
|
4
5
|
import { admittedRequestRoute } from "../../brain/request-route.js";
|
|
5
6
|
import { REFUSED_REQUEST_PARTS } from "../terminal-cause.js";
|
|
@@ -13,7 +14,7 @@ const LOOP_EXIT_FAILURE = {
|
|
|
13
14
|
aborted_before_stream: undefined,
|
|
14
15
|
assistant_error: undefined,
|
|
15
16
|
stop_requested: undefined,
|
|
16
|
-
malformed_tool_use_exhausted: { code: "model.malformed_tool_use_exhausted", message: "The model's tool call could not be
|
|
17
|
+
malformed_tool_use_exhausted: { code: "model.malformed_tool_use_exhausted", message: "The model's tool call could not be run: it kept arriving unparseable or naming the same missing tool (retry also failed)." },
|
|
17
18
|
truncated_output_exhausted: { code: "model.truncated_output_exhausted", message: "The model's response exceeded the output token maximum (continuing also failed)." },
|
|
18
19
|
};
|
|
19
20
|
export function loopExitFailureOf(reason) {
|
|
@@ -27,6 +28,10 @@ export function providerVerdictOf(final) {
|
|
|
27
28
|
const resetAtMs = readMember(final, "providerResetAtMs");
|
|
28
29
|
return { providerCondition: condition, providerConditionSource: source, ...(typeof resetAtMs === "number" && Number.isFinite(resetAtMs) ? { providerResetAtMs: resetAtMs } : {}) };
|
|
29
30
|
}
|
|
31
|
+
export function providerSentenceOf(final) {
|
|
32
|
+
const sentence = admittedProviderMessage(readMember(final, "providerMessage"));
|
|
33
|
+
return sentence === undefined ? {} : { providerMessage: sentence };
|
|
34
|
+
}
|
|
30
35
|
const REFUSED_REQUEST_PART_SET = new Set(REFUSED_REQUEST_PARTS);
|
|
31
36
|
export function refusedPartOf(errorKind, refusedTool) {
|
|
32
37
|
if (!REFUSED_REQUEST_PART_SET.has(errorKind))
|
|
@@ -3,6 +3,7 @@ import { Value } from "typebox/value";
|
|
|
3
3
|
import { defineTool, errorResult } from "../tools.js";
|
|
4
4
|
import { formatZodValidationError, truncateError } from "../tool-errors.js";
|
|
5
5
|
import { mountRuleFace, toolFace } from "../tool-catalog-entries.js";
|
|
6
|
+
import { projectToolSchema } from "../../brain/tool-schema-projection.js";
|
|
6
7
|
export const TOOL_SEARCH_NAME = "ToolSearch";
|
|
7
8
|
export const TOOL_SEARCH_DEFAULT_MAX_RESULTS = 5;
|
|
8
9
|
const MAX_QUERY_RESULTS = 25;
|
|
@@ -27,7 +28,7 @@ export function buildDeferredRegistry(deferred, tools) {
|
|
|
27
28
|
function renderSchemaForModel(schema) {
|
|
28
29
|
let json;
|
|
29
30
|
try {
|
|
30
|
-
json = JSON.stringify(schema);
|
|
31
|
+
json = JSON.stringify(projectToolSchema(schema));
|
|
31
32
|
}
|
|
32
33
|
catch {
|
|
33
34
|
return undefined;
|
|
@@ -55,7 +55,7 @@ export function toolEndBodyFrom(result, isError, leg, gate, gatedCallIdOfRun) {
|
|
|
55
55
|
...(gate !== undefined ? { gate } : {}),
|
|
56
56
|
};
|
|
57
57
|
}
|
|
58
|
-
const startFrameOf = (o, recovered) => ({ type: "tool_start", toolCallId: o.toolCallId, toolName: o.spelledName, ...(o.label !== undefined ? { label: o.label } : {}), args: o.args, ...(recovered ? { recovered: true } : {}), ...(o.requestedBy !== undefined ? { requestedBy: o.requestedBy } : {}) });
|
|
58
|
+
const startFrameOf = (o, recovered) => ({ type: "tool_start", toolCallId: o.toolCallId, toolName: o.spelledName, ...(o.label !== undefined ? { label: o.label } : {}), args: o.args, ...(recovered ? { recovered: true } : {}), ...(o.requestedBy !== undefined ? { requestedBy: o.requestedBy } : {}), ...(o.resumesCheckpoint !== undefined ? { resumesCheckpoint: o.resumesCheckpoint } : {}) });
|
|
59
59
|
export function announceToolCall(table, start, frames) {
|
|
60
60
|
table.open(start);
|
|
61
61
|
frames.push(startFrameOf(start, false));
|
|
@@ -76,7 +76,9 @@ export function emitSettled(table, start, end, frames) {
|
|
|
76
76
|
isError,
|
|
77
77
|
...toolEndBodyFrom(end.result, isError, frames, gate, end.gatedCallIdOfRun),
|
|
78
78
|
...(gate?.disposition.kind === "denied" && occ.wireName !== undefined ? { wireName: occ.wireName } : {}),
|
|
79
|
+
...(gate?.disposition.kind === "denied" && occ.finalInput !== undefined ? { refusedInput: occ.finalInput } : {}),
|
|
79
80
|
...(notExecuted ? { notExecuted: true } : {}), ...(occ.answeredInPlaceBy !== undefined ? { answeredBy: occ.answeredInPlaceBy } : {}), ...(occ.requestedBy !== undefined ? { requestedBy: occ.requestedBy } : {}),
|
|
81
|
+
...(occ.resumesCheckpoint !== undefined ? { resumesCheckpoint: occ.resumesCheckpoint } : {}),
|
|
80
82
|
...(occ.rewrite !== undefined && !neverRan ? { rewrite: occ.rewrite } : {}),
|
|
81
83
|
});
|
|
82
84
|
return { ...(gate !== undefined ? { gate } : {}), isError, ...(notExecuted ? { notExecuted: true } : {}) };
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* materialization entrance; the specs this file consumes carry that reader's copy, never the caller's object.
|
|
17
17
|
*/
|
|
18
18
|
import type { AgentTool } from "../../internal/harness-types.js";
|
|
19
|
-
import {
|
|
19
|
+
import type { McpServerSpec } from "../mcp-server-spec.js";
|
|
20
20
|
import { type ToolApprovalCard } from "../tool-face.js";
|
|
21
21
|
import { type EngineNotice } from "../engine-notice.js";
|
|
22
22
|
/** The keys each specialised approval card needs on the call (the SHELL owns the
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { callerText } from "../
|
|
1
|
+
import { callerText } from "../caller-text.js";
|
|
2
2
|
import { MCP_NAMESPACE } from "../protocol-table.js";
|
|
3
3
|
import { mintNamespacePrefix } from "../protocol-naming.js";
|
|
4
4
|
import { RESERVED_APPROVAL_CARDS, TOOL_APPROVAL_CARDS, TOOL_FAMILIES, TOOL_PATH_ABSENCES, TOOL_PATH_ACCESSES, TOOL_PATH_BASES, RENDER_HINT_ACTIVITY_MAX_CHARS, RENDER_HINT_MAX_CHARS, RENDER_HINT_MAX_LIST, TOOL_KEY_MAX_CHARS, } from "../tool-face.js";
|
|
@@ -10,10 +10,13 @@
|
|
|
10
10
|
* to its executor: the resumed leg right before it runs the tool body itself, a live leg at the gate's allow
|
|
11
11
|
* exit — the loop starts the body after it and the runner does not observe that moment) → `settled` or
|
|
12
12
|
* `interrupted`. A call that closes still `announced` was never let go: whatever the tool's body did, this call
|
|
13
|
-
* did not do it (`refusedBeforeRelease`, `tool-not-executed.ts`).
|
|
13
|
+
* did not do it (`refusedBeforeRelease`, `tool-not-executed.ts`). The release is also the call's RUNNING origin
|
|
14
|
+
* (`releasedAt`): the nearest moment to the body's start the runner observes, and the one the progress lane counts
|
|
15
|
+
* from — an announced call is waiting on its gate, not running. Leaving a terminal state is an engine defect and throws;
|
|
14
16
|
* - the WAIT ON A PERSON, re-entrant: every ask put to the person's seat for this call counts one entry and one
|
|
15
17
|
* exit (several rounds of one gate pass, a confirmation asked during the execution) — a count, never a bit,
|
|
16
|
-
* because the waits nest and overlap
|
|
18
|
+
* because the waits nest and overlap — and, beside it, every auto-mode classification of the call in flight, the
|
|
19
|
+
* same count shape. The two counts are the one gate-phase fact the frames read ({@link gatePhaseOf});
|
|
17
20
|
* - the GATE ROUNDS: one record per gate exit for this call, and one more when a station AFTER the gate refuses
|
|
18
21
|
* it (the shell read admission that re-establishes what the gate judged, a resumed leg's belts). The latest
|
|
19
22
|
* record is the call's disposition: a refusal after the gate is a refusal, never a tool failure under an
|
|
@@ -21,9 +24,12 @@
|
|
|
21
24
|
*
|
|
22
25
|
* WHAT IS NOT HERE: frames, clocks of a lane, the deny observer. This module is the record and its transitions;
|
|
23
26
|
* the projections read it. A durable park that crosses legs is two occurrences on two tables (the parking leg's,
|
|
24
|
-
* the resumed leg's), joined by the checkpoint row the resumed leg was opened from
|
|
27
|
+
* the resumed leg's), joined by the checkpoint row the resumed leg was opened from: the resumed leg's occurrence for
|
|
28
|
+
* the held call names that row ({@link OccurrenceStart.resumesCheckpoint}) and both of its frames carry the name — the
|
|
29
|
+
* one join a consumer reads, minted where the resumed leg opens the held call.
|
|
25
30
|
*/
|
|
26
31
|
import type { DeniedBy, GateOutcome } from "../gate-outcome.js";
|
|
32
|
+
import type { ToolGatePhase } from "../task-event.js";
|
|
27
33
|
import { type GateExitFacts } from "./gate-exit.js";
|
|
28
34
|
/** The one clock the occurrence's heartbeat facts are stamped on. MONOTONIC for the reason the progress lane
|
|
29
35
|
* states: every reading is subtracted from another, and a wall-clock step backwards would silence the beat. A
|
|
@@ -45,6 +51,9 @@ export interface OccurrenceStart {
|
|
|
45
51
|
readonly args: unknown;
|
|
46
52
|
/** An extension's own call (`$.tool.call`): who asked for it — the frames carry it. Absent for a call a model message carried. */
|
|
47
53
|
readonly requestedBy?: import("../task-event.js").ExtensionRequester;
|
|
54
|
+
/** The held call a resumed leg runs: the id of the checkpoint row it was opened from — the frames carry it
|
|
55
|
+
* (`tool_start.resumesCheckpoint`). Absent on every other call, and on a held call whose row carries no id. */
|
|
56
|
+
readonly resumesCheckpoint?: string;
|
|
48
57
|
}
|
|
49
58
|
/** The record, as its readers see it. Written only through {@link ToolOccurrenceTable}. */
|
|
50
59
|
export interface ToolOccurrence extends OccurrenceStart {
|
|
@@ -53,18 +62,25 @@ export interface ToolOccurrence extends OccurrenceStart {
|
|
|
53
62
|
readonly life: OccurrenceLife;
|
|
54
63
|
/** How many asks put to the person for this call are open right now. */
|
|
55
64
|
readonly awaitingUser: number;
|
|
65
|
+
/** How many auto-mode classifications of this call are in flight right now (the leg's own classifier, or an ancestor's
|
|
66
|
+
* frozen one judging it). */
|
|
67
|
+
readonly classifying: number;
|
|
56
68
|
/** One outcome per gate exit, plus one per refusal after the gate; the last one is the call's disposition. */
|
|
57
69
|
readonly gateRounds: readonly GateOutcome[];
|
|
58
70
|
/** The input the latest gate exit decided on, as a FROZEN snapshot (absent when no gate saw the call). */
|
|
59
71
|
readonly finalInput?: unknown;
|
|
60
72
|
/** The call's start frame is out on this leg. */
|
|
61
73
|
readonly startEmitted: boolean;
|
|
62
|
-
/** When the call
|
|
63
|
-
|
|
64
|
-
|
|
74
|
+
/** When the engine let the call go, on {@link occurrenceClock} — the progress clock's one origin. Absent until the
|
|
75
|
+
* call is released: a call still at its gate is not running, so the lane counts no running time for it (a frame
|
|
76
|
+
* minted for it reads elapsed 0). Written once, by {@link ToolOccurrenceTable.release}. */
|
|
77
|
+
readonly releasedAt?: number;
|
|
78
|
+
/** The last moment anything was heard from the call (its release, a frame for it, or its return from a wait on the
|
|
79
|
+
* person). */
|
|
65
80
|
readonly lastHeardAt: number;
|
|
66
|
-
/** The heartbeat covers it. Cleared when the loop leaves the call behind at a turn end with no
|
|
67
|
-
* the record stays (a later settlement must still know its start frame went out) but no beat
|
|
81
|
+
/** The heartbeat covers it. Cleared when the loop leaves the call behind at a turn end with no
|
|
82
|
+
* end of its own: the record stays (a later settlement must still know its start frame went out) but no beat
|
|
83
|
+
* describes it. */
|
|
68
84
|
readonly beating: boolean;
|
|
69
85
|
/** An extension at `tool.call` answered for the call in place of its body — its result, or its refusal — and named here:
|
|
70
86
|
* the body was never called (positive evidence the call did not run). Absent: no station answered in its place. */
|
|
@@ -88,7 +104,9 @@ export interface ToolOccurrenceTable {
|
|
|
88
104
|
ensure(start: OccurrenceStart): ToolOccurrence;
|
|
89
105
|
/** The call's start frame is out. */
|
|
90
106
|
noteStartEmitted(toolCallId: string): void;
|
|
91
|
-
/** The engine lets the call go to its executor — the one transition into `released`, whichever leg makes it.
|
|
107
|
+
/** The engine lets the call go to its executor — the one transition into `released`, whichever leg makes it. It also
|
|
108
|
+
* starts the call's progress clock and its silence clock: whatever came before (the gate, a person's answer) is not
|
|
109
|
+
* time the call spent running. */
|
|
92
110
|
release(toolCallId: string): void;
|
|
93
111
|
/** A gate exit for this call: its record and the input it decided on (frozen by the gate's exit). */
|
|
94
112
|
gateRound(toolCallId: string, outcome: GateOutcome, finalInput?: unknown, rewrite?: import("../task-event.js").ToolInputRewrite): void;
|
|
@@ -108,6 +126,10 @@ export interface ToolOccurrenceTable {
|
|
|
108
126
|
* settles, either way. Returns `ask`'s own value, so the asker awaits exactly what it awaited before; a synchronous
|
|
109
127
|
* answer (or anything that is not a promise) was no wait at all. */
|
|
110
128
|
whileAwaitingUser<T>(toolCallId: string, ask: () => T): T;
|
|
129
|
+
/** The same bracket around a classification of this call: its {@link ToolOccurrence.classifying} count rises before
|
|
130
|
+
* `judge` dispatches and lowers when the verdict settles, either way. The silence clock is untouched — a classification
|
|
131
|
+
* is the engine's own work on the call, and the heartbeat keeps covering it. */
|
|
132
|
+
whileClassifying<T>(toolCallId: string, judge: () => T): T;
|
|
111
133
|
/** A frame for the call went out: its silence clock restarts. */
|
|
112
134
|
heard(toolCallId: string): void;
|
|
113
135
|
/** The call ended: it leaves the table and the record is returned for the end projection. */
|
|
@@ -117,4 +139,7 @@ export interface ToolOccurrenceTable {
|
|
|
117
139
|
/** Called whenever an attempt opens (the heartbeat arms its timer). One listener — the leg's one lane. */
|
|
118
140
|
onOpen(listener: () => void): void;
|
|
119
141
|
}
|
|
142
|
+
/** Who holds the call at its gate right now (`tool_progress.gate`): a classification in flight answers `classifier`, else an
|
|
143
|
+
* open ask to the person answers `approval`, else nothing holds it. The one reading of the two counts. */
|
|
144
|
+
export declare function gatePhaseOf(occ: ToolOccurrence): ToolGatePhase | undefined;
|
|
120
145
|
export declare function createToolOccurrenceTable(): ToolOccurrenceTable;
|
|
@@ -1,6 +1,13 @@
|
|
|
1
1
|
import { mintGateOutcome } from "./gate-exit.js";
|
|
2
2
|
export const occurrenceClock = () => (typeof performance !== "undefined" ? performance.now() : Date.now());
|
|
3
3
|
const TERMINAL = { announced: false, released: false, settled: true, interrupted: true };
|
|
4
|
+
export function gatePhaseOf(occ) {
|
|
5
|
+
if (occ.classifying > 0)
|
|
6
|
+
return "classifier";
|
|
7
|
+
if (occ.awaitingUser > 0)
|
|
8
|
+
return "approval";
|
|
9
|
+
return undefined;
|
|
10
|
+
}
|
|
4
11
|
export function createToolOccurrenceTable() {
|
|
5
12
|
const byId = new Map();
|
|
6
13
|
const attempts = new Map();
|
|
@@ -22,12 +29,13 @@ export function createToolOccurrenceTable() {
|
|
|
22
29
|
...(start.label !== undefined ? { label: start.label } : {}),
|
|
23
30
|
args: start.args,
|
|
24
31
|
...(start.requestedBy !== undefined ? { requestedBy: start.requestedBy } : {}),
|
|
32
|
+
...(start.resumesCheckpoint !== undefined ? { resumesCheckpoint: start.resumesCheckpoint } : {}),
|
|
25
33
|
attempt,
|
|
26
34
|
life: "announced",
|
|
27
35
|
awaitingUser: 0,
|
|
36
|
+
classifying: 0,
|
|
28
37
|
gateRounds: [],
|
|
29
38
|
startEmitted: false,
|
|
30
|
-
startedAt: now,
|
|
31
39
|
lastHeardAt: now,
|
|
32
40
|
beating: true,
|
|
33
41
|
};
|
|
@@ -36,11 +44,11 @@ export function createToolOccurrenceTable() {
|
|
|
36
44
|
listener?.();
|
|
37
45
|
return occ;
|
|
38
46
|
};
|
|
39
|
-
const
|
|
47
|
+
const hold = (toolCallId, count) => {
|
|
40
48
|
const occ = byId.get(toolCallId);
|
|
41
49
|
if (occ === undefined)
|
|
42
50
|
return () => { };
|
|
43
|
-
occ
|
|
51
|
+
occ[count] += 1;
|
|
44
52
|
let returned = false;
|
|
45
53
|
return () => {
|
|
46
54
|
if (returned)
|
|
@@ -48,29 +56,31 @@ export function createToolOccurrenceTable() {
|
|
|
48
56
|
returned = true;
|
|
49
57
|
if (byId.get(toolCallId) !== occ)
|
|
50
58
|
return;
|
|
51
|
-
occ
|
|
52
|
-
if (occ.awaitingUser === 0)
|
|
59
|
+
occ[count] -= 1;
|
|
60
|
+
if (count === "awaitingUser" && occ.awaitingUser === 0)
|
|
53
61
|
occ.lastHeardAt = occurrenceClock();
|
|
54
62
|
};
|
|
55
63
|
};
|
|
64
|
+
const bracket = (release, held) => {
|
|
65
|
+
let value;
|
|
66
|
+
try {
|
|
67
|
+
value = held();
|
|
68
|
+
}
|
|
69
|
+
catch (err) {
|
|
70
|
+
release();
|
|
71
|
+
throw err;
|
|
72
|
+
}
|
|
73
|
+
if (value instanceof Promise)
|
|
74
|
+
value.then(release, release);
|
|
75
|
+
else
|
|
76
|
+
release();
|
|
77
|
+
return value;
|
|
78
|
+
};
|
|
79
|
+
const awaitUser = (toolCallId) => hold(toolCallId, "awaitingUser");
|
|
56
80
|
return {
|
|
57
81
|
awaitUser,
|
|
58
|
-
whileAwaitingUser(toolCallId, ask)
|
|
59
|
-
|
|
60
|
-
let answer;
|
|
61
|
-
try {
|
|
62
|
-
answer = ask();
|
|
63
|
-
}
|
|
64
|
-
catch (err) {
|
|
65
|
-
resumeFromUser();
|
|
66
|
-
throw err;
|
|
67
|
-
}
|
|
68
|
-
if (answer instanceof Promise)
|
|
69
|
-
answer.then(resumeFromUser, resumeFromUser);
|
|
70
|
-
else
|
|
71
|
-
resumeFromUser();
|
|
72
|
-
return answer;
|
|
73
|
-
},
|
|
82
|
+
whileAwaitingUser: (toolCallId, ask) => bracket(awaitUser(toolCallId), ask),
|
|
83
|
+
whileClassifying: (toolCallId, judge) => bracket(hold(toolCallId, "classifying"), judge),
|
|
74
84
|
get: (toolCallId) => byId.get(toolCallId),
|
|
75
85
|
live: () => [...byId.values()],
|
|
76
86
|
open,
|
|
@@ -83,6 +93,7 @@ export function createToolOccurrenceTable() {
|
|
|
83
93
|
if (occ.life !== "announced")
|
|
84
94
|
throw new Error(`tool occurrence: call "${toolCallId}" (attempt ${occ.attempt}) cannot be released from "${occ.life}"`);
|
|
85
95
|
occ.life = "released";
|
|
96
|
+
occ.releasedAt = occ.lastHeardAt = occurrenceClock();
|
|
86
97
|
},
|
|
87
98
|
gateRound(toolCallId, outcome, finalInput, rewrite) {
|
|
88
99
|
const occ = held(toolCallId, "a gate round");
|