@sema-agent/core 7.66.1 → 7.67.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3518 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +169 -0
- package/dist/brain/model-lane.js +505 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +164 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +105 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +24 -25
- package/dist/core/roles.js +148 -21
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +126 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +64 -34
- package/dist/index.js +45 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -92,7 +92,7 @@ export interface WorkflowAgentSpec extends ScriptClampSeats {
|
|
|
92
92
|
* restricting value, an add-only row through the row's script and entry laws. A row marked inherited-only (its
|
|
93
93
|
* restricting value switches off an operator-side record) is outside this set and is stripped like any other key.
|
|
94
94
|
*/
|
|
95
|
-
export declare const WHITELIST_KEYS: readonly ("
|
|
95
|
+
export declare const WHITELIST_KEYS: readonly ("images" | "thinking" | "objective" | "systemPrompt" | "limits" | ScriptSeat | "modelName")[];
|
|
96
96
|
/**
|
|
97
97
|
* #505 ② — ACCEPTED ALIAS SPELLINGS on the spec: `alias → the {@link WHITELIST_KEYS} member it means`.
|
|
98
98
|
*
|
|
@@ -212,9 +212,24 @@ export interface ResourceClampNote {
|
|
|
212
212
|
* baseline-contract question, deliberately not solved by resurrecting undocumented null semantics.
|
|
213
213
|
*/
|
|
214
214
|
export declare function overlayWorktreeBaseline(base: WorkflowGovernanceBaseline["base"], worktreeBase: WorkflowGovernanceBaseline["base"]): WorkflowGovernanceBaseline["base"];
|
|
215
|
-
/**
|
|
216
|
-
*
|
|
217
|
-
|
|
215
|
+
/**
|
|
216
|
+
* The model names an LLM-authored script may pick under this baseline, against this catalog.
|
|
217
|
+
*
|
|
218
|
+
* @contract workflow_models.one_reading — this function is the ONE answer to "which model names may a workflow script
|
|
219
|
+
* pick": the engine's pick gate reads it, and a host that DISPLAYS the names (a capability face) calls the same exported
|
|
220
|
+
* function with the catalog the Runner runs under (`Runner.agentCatalog.models`, the tier-expanded table). The answer is
|
|
221
|
+
* the allowlist's names that are entries of `models`, in list order without repeats; for the catalog word
|
|
222
|
+
* (`workflowModelAllowlist: "catalog"`) it is every entry of `models`, so a model renamed or added through
|
|
223
|
+
* `Runner.swapDeps` is pickable from the next leg on without a restart and without the baseline naming it. A listed
|
|
224
|
+
* allowlist is the deployment's own policy and is read as constructed: no swap seat changes it, so a catalog rename leaves
|
|
225
|
+
* a listed old name refused until the deployment lists the new one. An absent, `null`, empty or malformed allowlist
|
|
226
|
+
* answers no names (FAIL-CLOSED; the mount refuses a malformed one loudly first).
|
|
227
|
+
*/
|
|
228
|
+
export declare function workflowModelNamesOf(baseline: Pick<WorkflowGovernanceBaseline, "workflowModelAllowlist"> | undefined, models: Record<string, Model> | undefined): string[];
|
|
229
|
+
/** Resolve an LLM-supplied model NAME to a deploy-configured `Model`, FAIL-CLOSED: the name must be one
|
|
230
|
+
* {@link workflowModelNamesOf} answers. Throws (never falls open to the whole catalog unless the deployment wrote the
|
|
231
|
+
* catalog word) when no allowlist is configured or the name is not among the answered names. */
|
|
232
|
+
export declare function resolveModelName(name: string, allowlist: WorkflowGovernanceBaseline["workflowModelAllowlist"] | null, models: Record<string, Model> | undefined): Model;
|
|
218
233
|
/**
|
|
219
234
|
* Build a TRUSTED child `TaskSpec` for an LLM-authored sub-agent (design/98 §2.5). Complete-by-construction:
|
|
220
235
|
* 1. read ONLY the whitelist work-fields off the untrusted script spec (type-checked);
|
|
@@ -5,7 +5,8 @@ import { CLAMP_SET, SCRIPT_SEATS } from "../core/child-clamp-seats.js";
|
|
|
5
5
|
import { WorkflowScriptError } from "./workflow-meta.js";
|
|
6
6
|
import { uuidv7 } from "../engine/session/uuid.js";
|
|
7
7
|
import { retiredCheckpointStoreNull } from "../core/checkpoint-store.js";
|
|
8
|
-
import { catalogModel } from "../core/roles.js";
|
|
8
|
+
import { catalogModel, catalogSliceOf, isCatalogEntry } from "../core/roles.js";
|
|
9
|
+
import { WORKFLOW_MODELS_FOLLOW_CATALOG, isWellFormedModelAllowlist } from "./governance-baseline-validity.js";
|
|
9
10
|
import { thrownText } from "../core/thrown-value.js";
|
|
10
11
|
export class WorkflowModelNotAllowedError extends Error {
|
|
11
12
|
modelName;
|
|
@@ -92,17 +93,37 @@ export function overlayWorktreeBaseline(base, worktreeBase) {
|
|
|
92
93
|
}
|
|
93
94
|
return { ...base, ...overlay };
|
|
94
95
|
}
|
|
95
|
-
export function
|
|
96
|
-
|
|
97
|
-
|
|
96
|
+
export function workflowModelNamesOf(baseline, models) {
|
|
97
|
+
const allowlist = baseline?.workflowModelAllowlist;
|
|
98
|
+
if (!isWellFormedModelAllowlist(allowlist) || allowlist === undefined || allowlist === null)
|
|
99
|
+
return [];
|
|
100
|
+
if (allowlist === WORKFLOW_MODELS_FOLLOW_CATALOG) {
|
|
101
|
+
return Object.keys(models ?? {}).filter((name) => isCatalogEntry(name, models));
|
|
98
102
|
}
|
|
99
|
-
|
|
100
|
-
|
|
103
|
+
const names = [];
|
|
104
|
+
for (const name of allowlist) {
|
|
105
|
+
if (!names.includes(name) && isCatalogEntry(name, models))
|
|
106
|
+
names.push(name);
|
|
101
107
|
}
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
108
|
+
return names;
|
|
109
|
+
}
|
|
110
|
+
function modelRefusalReason(name, allowlist) {
|
|
111
|
+
if (allowlist === WORKFLOW_MODELS_FOLLOW_CATALOG)
|
|
112
|
+
return "not present in RunnerDeps.models (the workflow model allowlist follows the catalog)";
|
|
113
|
+
if (!Array.isArray(allowlist) || allowlist.length === 0) {
|
|
114
|
+
return "no workflowModelAllowlist is configured (fail-closed: an LLM-authored script cannot pick a model)";
|
|
105
115
|
}
|
|
116
|
+
if (!allowlist.includes(name))
|
|
117
|
+
return `not in the workflow model allowlist [${allowlist.join(", ")}]`;
|
|
118
|
+
return "allowed by name but not present in RunnerDeps.models";
|
|
119
|
+
}
|
|
120
|
+
export function resolveModelName(name, allowlist, models) {
|
|
121
|
+
const slice = catalogSliceOf(name, models);
|
|
122
|
+
const model = workflowModelNamesOf({ workflowModelAllowlist: allowlist ?? undefined }, slice).includes(name)
|
|
123
|
+
? catalogModel(name, slice, "workflowModelAllowlist")
|
|
124
|
+
: undefined;
|
|
125
|
+
if (model === undefined)
|
|
126
|
+
throw new WorkflowModelNotAllowedError(name, modelRefusalReason(name, allowlist));
|
|
106
127
|
return model;
|
|
107
128
|
}
|
|
108
129
|
function minDefined(...vals) {
|
|
@@ -47,4 +47,7 @@ parentCheckpointStore?: CheckpointStore | "disabled",
|
|
|
47
47
|
* faces, the effective deny list, the approval declaration, the write-hands and hard-headless clamps). Lazy: read at
|
|
48
48
|
* spawn time, after prepare has resolved them. Injected into every spawned child; see the injection below for why it
|
|
49
49
|
* outranks even a `worktreeBase: { handsReadOnly: false }` overlay. */
|
|
50
|
-
parentClamps?: () => ChildClampSource
|
|
50
|
+
parentClamps?: () => ChildClampSource,
|
|
51
|
+
/** The host run's RESOLVED interaction posture — what a spawned agent whose spec states none inherits through the trusted internals
|
|
52
|
+
* (the same value `RunWorkflowOptions.interactionPosture` carries). Lazy, read at spawn time. */
|
|
53
|
+
parentPosture?: () => "interactive" | "headless" | undefined): WorkflowPrimitives;
|
|
@@ -66,7 +66,7 @@ function formatResourceClampNote(notes) {
|
|
|
66
66
|
const parts = notes.map((n) => `${n.field}: requested ${n.requested === undefined ? "unset" : n.requested} → applied ${n.applied}`);
|
|
67
67
|
return `workflow governance tightened this agent's resource limits (${parts.join("; ")})`;
|
|
68
68
|
}
|
|
69
|
-
export function buildWorkflowPrimitives(ctx, governance, onAgentSpawn, parentCheckpointStore, parentClamps) {
|
|
69
|
+
export function buildWorkflowPrimitives(ctx, governance, onAgentSpawn, parentCheckpointStore, parentClamps, parentPosture) {
|
|
70
70
|
const agent = (spec, opts) => {
|
|
71
71
|
if (typeof spec === "string")
|
|
72
72
|
spec = { objective: spec };
|
|
@@ -81,7 +81,7 @@ export function buildWorkflowPrimitives(ctx, governance, onAgentSpawn, parentChe
|
|
|
81
81
|
const hostClamps = parentClamps?.();
|
|
82
82
|
const workflowChildClamps = childClampSeats(foldClampSources(childSpec, hostClamps));
|
|
83
83
|
Object.assign(childSpec, workflowChildClamps);
|
|
84
|
-
const posture = postureUnderClamps(childSpec.interactionPosture, { interactiveTools: workflowChildClamps.interactiveTools, approvalReach: workflowChildClamps.approvalReach });
|
|
84
|
+
const posture = postureUnderClamps(childSpec.interactionPosture, { interactiveTools: workflowChildClamps.interactiveTools, approvalReach: workflowChildClamps.approvalReach }, parentPosture?.());
|
|
85
85
|
if (posture !== undefined)
|
|
86
86
|
childSpec.interactionPosture = posture;
|
|
87
87
|
if (onAgentSpawn) {
|
|
@@ -19,7 +19,7 @@ export declare function isSelfOrchestrationActive(spec: TaskSpec, deps: RunnerDe
|
|
|
19
19
|
* (a shell that shows `/workflows` as available while the engine fail-closes the tool = the exact mismatch
|
|
20
20
|
* design/98 §6.3 forbids). Per-principal/tier gating does NOT exist today — this is deployment-wide.
|
|
21
21
|
*/
|
|
22
|
-
export declare function workflowsCapability(deps: RunnerDeps): boolean;
|
|
22
|
+
export declare function workflowsCapability(deps: Pick<RunnerDeps, "workflowScriptRunner" | "workflowGovernanceBaseline">): boolean;
|
|
23
23
|
/**
|
|
24
24
|
* design/98 §1.2 — the task OPTED IN (`selfOrchestration:true`) but the deployment did not meet the bar (a
|
|
25
25
|
* hard sandbox + a governance baseline), so self-orchestration is FAIL-CLOSED. Returns a human-readable
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
* previous attachment, falling back to the session-start snapshot) and emits a
|
|
35
35
|
* `workflow_size_guideline_change` attachment rendered with `ETd` on inequality. sema's equivalent
|
|
36
36
|
* lives at the run loop's turn-boundary steerer (`runtask.ts`, alongside the structurally identical
|
|
37
|
-
* date_change
|
|
37
|
+
* date_change lane): the leg's resolved guideline is the baseline, the live
|
|
38
38
|
* `RunnerDeps.workflowLimits` read is the current value, and {@link workflowSizeGuidelineChangeNotice}
|
|
39
39
|
* is the copy. Comparison is on the RESOLVED coordinate on both sides, CC-exact — `vTd` compares
|
|
40
40
|
* `Oft(...).size` against `Nsn(...).size`, so a deployment writing down the value already in force by
|
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
import type { TaskResult, TaskStatus, ToolActivity } from "../core/types.js";
|
|
2
|
-
|
|
2
|
+
/** A workflow run's lifecycle words (closed; the stored run's `status` is read against it). */
|
|
3
|
+
export declare const WORKFLOW_RUN_STATUSES: readonly ["running", "completed", "failed"];
|
|
4
|
+
export type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
|
|
3
5
|
/** Status of one phase / agent-run within a workflow. `"parked"` (#642) is an AGENT row's word only — the
|
|
4
6
|
* agent durably paused at an approval gate and the run suspended on it (the row carries the token, see
|
|
5
7
|
* {@link WorkflowAgentRun.parkedCheckpointToken}); a phase or group never parks (a parked agent ends the run). */
|
|
6
|
-
export
|
|
8
|
+
export declare const WORKFLOW_ITEM_STATUSES: readonly ["running", "completed", "failed", "parked"];
|
|
9
|
+
export type WorkflowItemStatus = (typeof WORKFLOW_ITEM_STATUSES)[number];
|
|
7
10
|
/** The arm a `workflow.park_truth_unreadable` resume refusal fired on (`detail.reason`): the prior run's record could not
|
|
8
11
|
* be read (`store_threw`), is absent under this scope (`record_missing` — never recorded under it, reaped, or deleted with
|
|
9
12
|
* the session that started it: one word, because after a deletion the three are the same absence), is not terminal (`record_not_terminal`),
|
|
@@ -613,21 +616,24 @@ export declare class WorkflowAgentBlockedError extends Error {
|
|
|
613
616
|
reason: string);
|
|
614
617
|
}
|
|
615
618
|
/** #642 — the machine code of a run that SUSPENDED on a parked agent (the thrown error's `code`, the run's
|
|
616
|
-
* failed terminal). Not a script fault and not a host fault:
|
|
619
|
+
* failed terminal). Not a script fault and not a host fault: a leg is parked, and what it waits on is that leg's
|
|
620
|
+
* checkpoint's gate — an approval a person still has to decide, or a resource limit (a scheduler's yield among them,
|
|
621
|
+
* which a resume of the run continues with no decision). */
|
|
617
622
|
export declare const WORKFLOW_AGENT_PARKED_ERROR_CODE = "workflow.agent_parked";
|
|
618
623
|
/** The agent rows that are PARKED — the one definition of "this row is parked" (the row's own word,
|
|
619
624
|
* {@link WorkflowItemStatus} `"parked"`). The `<usage>` block's `agents_parked` count and the run-level
|
|
620
625
|
* {@link runParkedOf} both read it, so the two can never disagree about which rows count. */
|
|
621
626
|
export declare function parkedAgentsOf<A extends Pick<WorkflowAgentRun, "status">>(agents: ReadonlyArray<A>): A[];
|
|
622
627
|
/**
|
|
623
|
-
* Run-level parked bit: this run is STILL RUNNING while at least one of its legs is parked
|
|
624
|
-
*
|
|
625
|
-
* rows; never stored on the run, never journaled, so there is no
|
|
628
|
+
* Run-level parked bit: this run is STILL RUNNING while at least one of its legs is parked (on any gate — what a leg
|
|
629
|
+
* waits on is its checkpoint's gate, never the run's) — something is being waited on, and the closed `status` word
|
|
630
|
+
* cannot say so. Derived on every read from the agent rows; never stored on the run, never journaled, so there is no
|
|
631
|
+
* second copy to drift from the rows.
|
|
626
632
|
*
|
|
627
633
|
* Two states, one word each. While the run still runs (a sibling leg has not settled yet) the bit is this
|
|
628
634
|
* function's `true`. Once the siblings have drained, the run SUSPENDS: it is recorded `failed` with
|
|
629
|
-
* {@link WORKFLOW_AGENT_PARKED_ERROR_CODE} and its parked rows beside it — that existing code is the "
|
|
630
|
-
*
|
|
635
|
+
* {@link WORKFLOW_AGENT_PARKED_ERROR_CODE} and its parked rows beside it — that existing code is the "a leg is
|
|
636
|
+
* parked" word and this bit does not say it a second time. A terminal record also stays exactly as written
|
|
631
637
|
* after a resume decides the park, so reading its rows would show "waiting" on a park long since decided: a
|
|
632
638
|
* non-running run answers `false`. Consumers surface the bit as an optional wire member that is `true` or absent,
|
|
633
639
|
* never `false`.
|
|
@@ -644,17 +650,20 @@ export declare function runParkedOf(run: Pick<WorkflowRun, "status" | "agents">)
|
|
|
644
650
|
* error, every later spawn is refused with it, and the run's terminal is the park whatever the script body returns.
|
|
645
651
|
* Nothing after the parked call runs; the script must not retry it (an identical call parks again). A resume of the
|
|
646
652
|
* suspended run (`resumeFromRunId`) with the host's decision for the token drives the parked child on and the script
|
|
647
|
-
* continues from here; without a decision the ordinal re-parks
|
|
653
|
+
* continues from here; without a decision the ordinal re-parks — except a leg that parked on a scheduler's yield
|
|
654
|
+
* (`resource_limit` / `preempt`): nobody decides a yield, so the resume continues it on its own.
|
|
648
655
|
*
|
|
649
|
-
* Carries the non-secret `checkpointId` (display/correlation)
|
|
650
|
-
* capability lives on the wa* row, a durable row, exactly as on the
|
|
656
|
+
* Carries the non-secret `checkpointId` (display/correlation), the gate kind and, for a resource limit, its reason
|
|
657
|
+
* (`limitReason`) — never the token (the resume capability lives on the wa* row, a durable row, exactly as on the
|
|
658
|
+
* background lane).
|
|
651
659
|
*/
|
|
652
660
|
export declare class WorkflowAgentParkedError extends Error {
|
|
653
661
|
readonly label: string;
|
|
654
662
|
readonly gateKind: string;
|
|
655
663
|
readonly checkpointId?: string | undefined;
|
|
664
|
+
readonly limitReason?: string | undefined;
|
|
656
665
|
readonly code = "workflow.agent_parked";
|
|
657
|
-
constructor(label: string, gateKind: string, checkpointId?: string | undefined);
|
|
666
|
+
constructor(label: string, gateKind: string, checkpointId?: string | undefined, limitReason?: string | undefined);
|
|
658
667
|
}
|
|
659
668
|
/** #2561 — what a live run did with one delivered decision ({@link import("./workflow-observe.js").redeemWorkflowParks}),
|
|
660
669
|
* by the decision's position: `driving` (the parked child is driven on with it, the call continues), `settled` (its
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
export const WORKFLOW_RUN_STATUSES = Object.freeze(["running", "completed", "failed"]);
|
|
2
|
+
export const WORKFLOW_ITEM_STATUSES = Object.freeze(["running", "completed", "failed", "parked"]);
|
|
1
3
|
export const PARK_TRUTH_UNREADABLE_REASONS = Object.freeze(["store_threw", "record_missing", "record_not_terminal", "parks_unreadable", "admission_incomplete", "checkpoint_store_threw", "capability_not_armed"]);
|
|
2
4
|
export const PARK_NOT_PENDING_STATUSES = Object.freeze(["resolved", "expired", "absent"]);
|
|
3
5
|
export class WorkflowBudgetExceededError extends Error {
|
|
@@ -68,14 +70,23 @@ export class WorkflowAgentParkedError extends Error {
|
|
|
68
70
|
label;
|
|
69
71
|
gateKind;
|
|
70
72
|
checkpointId;
|
|
73
|
+
limitReason;
|
|
71
74
|
code = WORKFLOW_AGENT_PARKED_ERROR_CODE;
|
|
72
|
-
constructor(label, gateKind, checkpointId) {
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
"
|
|
75
|
+
constructor(label, gateKind, checkpointId, limitReason) {
|
|
76
|
+
const at = `${gateKind}${limitReason !== undefined ? `/${limitReason}` : ""}${checkpointId !== undefined ? `, checkpoint ${checkpointId}` : ""}`;
|
|
77
|
+
super(gateKind !== "resource_limit"
|
|
78
|
+
? `workflow agent "${label}" is parked at an approval gate (${at}) — ` +
|
|
79
|
+
"the workflow is suspended until the approval is decided; nothing after this call runs. Do not re-issue the call: " +
|
|
80
|
+
"a resume of this run carrying the decision continues from here."
|
|
81
|
+
: limitReason === "preempt"
|
|
82
|
+
? `workflow agent "${label}" yielded (${at}) — the workflow is suspended; nothing after this call runs. Do not re-issue the call: ` +
|
|
83
|
+
"a resume of this run continues it from here (a yield needs no decision)."
|
|
84
|
+
: `workflow agent "${label}" is paused at a resource limit (${at}) — the workflow is suspended; nothing after this call runs. ` +
|
|
85
|
+
"Do not re-issue the call: a resume of this run carrying a continue decision continues from here.");
|
|
76
86
|
this.label = label;
|
|
77
87
|
this.gateKind = gateKind;
|
|
78
88
|
this.checkpointId = checkpointId;
|
|
89
|
+
this.limitReason = limitReason;
|
|
79
90
|
this.name = "WorkflowAgentParkedError";
|
|
80
91
|
}
|
|
81
92
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { TSchema } from "typebox";
|
|
2
|
-
import type { InheritedGate, RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
2
|
+
import type { InheritedGate, RunInternals, RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
3
3
|
import type { CheckpointStore, CheckpointToken, ResumeOutcome } from "../core/checkpoint-store.js";
|
|
4
4
|
import type { AgentDefinition, TaskEvent, TaskResult, TaskSpec, ThinkingLevel } from "../core/types.js";
|
|
5
5
|
import { type ParentSpecSeat } from "../core/parent-spec-seat.js";
|
|
@@ -19,6 +19,12 @@ export declare const WORKFLOW_SUBAGENT_APPEND = "---\n\nNOTE: You are running in
|
|
|
19
19
|
/** 198 composite schema-append `L0m` (pretty.js:447328) — VERBATIM incl. the `---` opener (F6/B6; the old
|
|
20
20
|
* sema text compressed the "Do your work, then call X" instruction out). */
|
|
21
21
|
export declare const WORKFLOW_SUBAGENT_APPEND_SCHEMA = "---\n\nNOTE: You are running inside a workflow script. You MUST return your final answer by calling the StructuredOutput tool exactly once \u2014 the tool's input schema defines the required shape. Do your work, then call StructuredOutput; do NOT put your answer in a text response (the script reads ONLY the tool call). If validation fails, read the error and call StructuredOutput again with a corrected shape.";
|
|
22
|
+
/** A workflow agent launched as an agent type: the spec its definition folded into, and — when the definition writes tool lists — the layer
|
|
23
|
+
* they make in the agent's selector, with the definition's name (`RunInternals.definitionToolLists`). */
|
|
24
|
+
export interface WorkflowAgentTypeLaunch {
|
|
25
|
+
readonly spec: TaskSpec;
|
|
26
|
+
readonly definitionToolLists?: NonNullable<RunInternals["definitionToolLists"]>;
|
|
27
|
+
}
|
|
22
28
|
/**
|
|
23
29
|
* Apply the G5 default persona to a `ctx.agent`/`ctx.agentStream` child spec. Two-state on the EFFECTIVE
|
|
24
30
|
* schema (`agentOpts.schema` wins over a spec-carried `outputSchema`, same as the runSpec injection):
|
|
@@ -36,12 +42,12 @@ export declare const WORKFLOW_SUBAGENT_APPEND_SCHEMA = "---\n\nNOTE: You are run
|
|
|
36
42
|
* (deployment SHADOW over built-ins) and fold the definition into the child spec — persona as
|
|
37
43
|
* `systemPrompt` (so {@link withWorkflowChildPersona} composes the return-contract NOTE via the
|
|
38
44
|
* custom-persona APPEND arm = CC `O0m` semantics), model/thinking/maxTurns/skills/memory/
|
|
39
|
-
* memoryPersistenceCapable when the spec didn't pin them
|
|
40
|
-
*
|
|
45
|
+
* memoryPersistenceCapable when the spec didn't pin them; its allow/denyTools are not folded into the spec: they come back as the
|
|
46
|
+
* definition's selector layer, which the launch hands the agent on its internals ({@link WorkflowAgentTypeLaunch}).
|
|
41
47
|
* The definition is DEPLOYMENT-TRUSTED (registry-declared, not script-authored), so its model bypasses
|
|
42
48
|
* the script-facing modelName allowlist by design — same trust tier as the Agent tool's registry.
|
|
43
49
|
*/
|
|
44
|
-
export declare function applyWorkflowAgentType(spec: TaskSpec, agentType: string | undefined, registry: AgentDefinition[]):
|
|
50
|
+
export declare function applyWorkflowAgentType(spec: TaskSpec, agentType: string | undefined, registry: AgentDefinition[]): WorkflowAgentTypeLaunch;
|
|
45
51
|
/** The agentType registry for one workflow run: built-ins (unless opted out) with deployment SHADOW. */
|
|
46
52
|
export declare function workflowAgentRegistry(opts: {
|
|
47
53
|
agents?: AgentDefinition[];
|
|
@@ -304,12 +310,14 @@ export interface WorkflowRunContext {
|
|
|
304
310
|
* the checkpoint token the wa* row is parked on (the row's `parkedCheckpointToken`, the redemption key), the
|
|
305
311
|
* caller's decision for it (the same {@link ResumeOutcome} a top-level `runner.resume` takes), and the optional
|
|
306
312
|
* cross-process re-supply of the checkpoint's opaque parent constraints. The token is matched by string equality
|
|
307
|
-
* against the parked ordinal's token — an ordinal whose token no entry names re-parks
|
|
313
|
+
* against the parked ordinal's token — an ordinal whose token no entry names re-parks, unless it parked on a scheduler's
|
|
314
|
+
* yield (`resource_limit` / `preempt`): nobody decides a yield, so a pending one is driven with `continue`.
|
|
308
315
|
*
|
|
309
316
|
* `outcome` is OPTIONAL. `{ token, outcome }` is a DECISION: a pending checkpoint is driven with it; one the store no
|
|
310
317
|
* longer calls pending is settled (the acknowledgement is implied). `{ token }` alone is an ACKNOWLEDGEMENT: it settles an
|
|
311
318
|
* ordinal whose checkpoint is resolved / expired / absent as a failed row (`workflow.park_not_pending`) so the script
|
|
312
|
-
* continues; if the re-read finds the checkpoint pending again it RE-PARKS — an acknowledgement never authorizes a drive
|
|
319
|
+
* continues; if the re-read finds the checkpoint pending again it RE-PARKS — an acknowledgement never authorizes a drive
|
|
320
|
+
* (a pending yield is driven with `continue` either way: it needs no authorization).
|
|
313
321
|
*/
|
|
314
322
|
export interface WorkflowParkedResume {
|
|
315
323
|
token: CheckpointToken;
|
|
@@ -345,6 +353,8 @@ export interface RunWorkflowOptions {
|
|
|
345
353
|
/** The occupant (`SessionMetadata.incarnation`) of {@link rootSessionId}'s row as the host tree holds it; rides the
|
|
346
354
|
* shared internals base beside the root anchor (`RunInternals.rootSessionIncarnation`). Absent = unknown. */
|
|
347
355
|
rootSessionIncarnation?: string;
|
|
356
|
+
/** The scope {@link rootSessionId}'s durable box mounts in, beside its occupant (`RunInternals.rootSessionScope`). Absent = none recorded. */
|
|
357
|
+
rootSessionScope?: string;
|
|
348
358
|
/** design/380 O1② (C12) — the host run's EXPLICIT placement fixed point
|
|
349
359
|
* (`RunInternals.placementRoot`, threaded by the run-workflow tool when the host carried one):
|
|
350
360
|
* every workflow-spawned agent inherits it verbatim so descendants of a cascade/verify leg stay
|
|
@@ -552,11 +562,26 @@ export interface RunWorkflowOptions {
|
|
|
552
562
|
* resume — `runner.resumeStream(token, outcome, …)` on the pinned session, the child's spec rebuilt from
|
|
553
563
|
* the script call exactly as at spawn — and settles its result at that ordinal, so the script continues past
|
|
554
564
|
* the call it parked on. A parked ordinal with NO decision here re-parks (the row and the journal say the
|
|
555
|
-
* same thing again, the run suspends again); it is never run live.
|
|
565
|
+
* same thing again, the run suspends again); it is never run live. One gate needs no decision: an ordinal
|
|
566
|
+
* parked on a scheduler's yield (`resource_limit` / `preempt`) is driven on with `continue` — nobody decides
|
|
567
|
+
* a yield, the run's next resume continues it. `inheritedGate` is the cross-process
|
|
556
568
|
* re-supply of the checkpoint's opaque parent constraints (the same seat the background lane's drive
|
|
557
569
|
* takes). TRUSTED: a host-supplied decision, never a script/model argument; requires `resumeFromRunId`.
|
|
558
570
|
*/
|
|
559
571
|
parkedResume?: ReadonlyArray<WorkflowParkedResume>;
|
|
572
|
+
/**
|
|
573
|
+
* The run's YIELD intent — the workflow twin of {@link TaskSpec.preemptSignal}. Raised, every leg this run has in
|
|
574
|
+
* flight parks at its own next clean turn boundary (`resource_limit` / `preempt`, its wa* row `parked`), and every
|
|
575
|
+
* leg it launches after that parks at its first one — the run then suspends on its parks
|
|
576
|
+
* ({@link WORKFLOW_AGENT_PARKED_ERROR_CODE}) and a resume of it ({@link resumeFromRunId}) continues them with no
|
|
577
|
+
* decision. Each leg (a spawn, a stall retry, a drive) is handed a FRESH signal as its own `preemptSignal`, at its
|
|
578
|
+
* prepare report — so a resumed leg's yield is never the one its resume entry strips. Only a run whose park lane is
|
|
579
|
+
* armed ({@link store} + {@link checkpointStore}) can hold a leg's park; on any other run a raised intent is answered
|
|
580
|
+
* by continuing, said once on the run log. The Workflow tool wires the intent of the runs it starts to the task
|
|
581
|
+
* registry's yield seat ({@link import("../core/task-registry.js").TaskRegistry.yieldBackground}); a directly-started
|
|
582
|
+
* workflow passes its own. TRUSTED host wiring, never a script/model argument; NOT call identity.
|
|
583
|
+
*/
|
|
584
|
+
preemptSignal?: AbortSignal;
|
|
560
585
|
/** The claim holder of the run on whose behalf the drives run (`RunInternals.holder`): every drive's resume carries it into its
|
|
561
586
|
* CAS (`expect.holder`), so a run whose grant was superseded applies none of the decisions above. TRUSTED, like the decisions. */
|
|
562
587
|
holder?: string;
|
|
@@ -633,6 +658,11 @@ export interface WorkflowHandle<T> {
|
|
|
633
658
|
readonly runId: string;
|
|
634
659
|
readonly done: Promise<RunWorkflowResult<T>>;
|
|
635
660
|
cancel(reason?: string): void;
|
|
661
|
+
/** The run-level parked bit read off the LIVE run, now ({@link runParkedOf}): `true` while the run is still `running` and a
|
|
662
|
+
* leg of it is parked (on any gate); `false` otherwise, a settled run included. Synchronous and total — it reads the
|
|
663
|
+
* engine's own run record, nothing a script or a host provides. Optional: a handle a host assembles itself need not answer,
|
|
664
|
+
* and a reader treats anything but `true` as "not waiting". */
|
|
665
|
+
parked?(): boolean;
|
|
636
666
|
}
|
|
637
667
|
/** Cap on items a single `parallel`/`pipeline` call accepts (matches the CC Workflow tool). */
|
|
638
668
|
export declare const MAX_WORKFLOW_ITEMS = 4096;
|