@sema-agent/core 7.66.1 → 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 +3483 -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 +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 +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.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/LICENSE
CHANGED
|
@@ -5,7 +5,8 @@ Parameters
|
|
|
5
5
|
Licensor: clay (github.com/clayboby)
|
|
6
6
|
Licensed Work: @sema-agent/core (sema-core) and the satellite packages
|
|
7
7
|
published from this repository (currently
|
|
8
|
-
@sema-agent/mods-kernel, @sema-agent/primitives
|
|
8
|
+
@sema-agent/mods-kernel, @sema-agent/primitives,
|
|
9
|
+
@sema-agent/core-stores-sql and @sema-agent/wiki-gate)
|
|
9
10
|
(formerly published as @sema-ai/core)
|
|
10
11
|
The Licensed Work is (c) 2026 clay.
|
|
11
12
|
Additional Use Grant: You may make production use of the Licensed Work for
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { describeRejectedValue } from "../core/tool-search-setting.js";
|
|
1
2
|
import { snapshotToolNameList } from "../core/tool-name-list.js";
|
|
2
3
|
import { snapshotAndValidateMcpEntries } from "../core/locked-config.js";
|
|
3
4
|
export function snapshotDefinitionLists(def) {
|
|
@@ -17,7 +18,7 @@ export function defineAgent(def) {
|
|
|
17
18
|
throw e;
|
|
18
19
|
}
|
|
19
20
|
if (def.memoryPersistenceCapable !== undefined && typeof def.memoryPersistenceCapable !== "boolean") {
|
|
20
|
-
const e = new Error(`defineAgent("${def.name}"): memoryPersistenceCapable must be a boolean when present — got ${
|
|
21
|
+
const e = new Error(`defineAgent("${def.name}"): memoryPersistenceCapable must be a boolean when present — got ${describeRejectedValue(def.memoryPersistenceCapable)} (a string "false" would silently read as capable).`);
|
|
21
22
|
e.code = "config.agent.invalid";
|
|
22
23
|
throw e;
|
|
23
24
|
}
|
|
@@ -36,7 +36,7 @@ export interface AgentTranscriptToolOptions {
|
|
|
36
36
|
* not_found, on a mount whose transcript tier declares transcript durability (`full`). Announced once
|
|
37
37
|
* per (handle, process); absent ⇒ the honest per-call degrade alone. */
|
|
38
38
|
onTranscriptIntegrityGap?: (handle: string, scope: string | undefined) => void;
|
|
39
|
-
/** The run's checkpoint seat — where a PARKED agent's
|
|
39
|
+
/** The run's checkpoint seat — where a PARKED agent's park card is read from for the state line
|
|
40
40
|
* (the same seat the Agent tool parks children into). Absent ⇒ the ctx seat
|
|
41
41
|
* (`checkpointStoreForChildren`) when the mount's ctx builder supplies one, else the card reads
|
|
42
42
|
* `unreadable`. */
|
|
@@ -10,6 +10,7 @@ import { REPORT_FIELD_MAX } from "./subagent.js";
|
|
|
10
10
|
import { getSessionRetainLedger } from "./retain-ledger.js";
|
|
11
11
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
12
12
|
import { thrownText } from "../core/thrown-value.js";
|
|
13
|
+
import { callScopeOf } from "../core/isolation-scope.js";
|
|
13
14
|
export const AGENT_TRANSCRIPT_TOOL_NAME = "AgentTranscript";
|
|
14
15
|
const AGENT_TRANSCRIPT_DEFAULT_N = 20;
|
|
15
16
|
const AGENT_TRANSCRIPT_MAX_N = 50;
|
|
@@ -34,8 +35,8 @@ export function createAgentTranscriptTool(opts) {
|
|
|
34
35
|
`the agent. Works for agents this run retained (retainSubagentSessions) and for agents whose durable ` +
|
|
35
36
|
`record preserved their transcript session; when neither holds you get an honest error. ` +
|
|
36
37
|
`The first line states the agent's current state: its status (running / parked / completed / failed / killed …), ` +
|
|
37
|
-
`when it last did anything, and — only for
|
|
38
|
-
`state and deadline. Each step shows how long ago it happened; a call still waiting for its result shows ` +
|
|
38
|
+
`when it last did anything, and — only for a parked agent — what its park waits on (a person's approval, or a yield ` +
|
|
39
|
+
`that continues when its owner runs again), the card id, state and deadline. Each step shows how long ago it happened; a call still waiting for its result shows ` +
|
|
39
40
|
`"started <age> ago, no result yet" (an approval answered in-process while the agent runs is not visible ` +
|
|
40
41
|
`here — such a wait shows only as that unfinished call). Report what these lines say rather than estimating progress.`,
|
|
41
42
|
parameters: Type.Object({
|
|
@@ -50,7 +51,7 @@ export function createAgentTranscriptTool(opts) {
|
|
|
50
51
|
const lastN = typeof a.lastN === "number" && Number.isFinite(a.lastN) ? Math.max(1, Math.min(AGENT_TRANSCRIPT_MAX_N, Math.floor(a.lastN))) : AGENT_TRANSCRIPT_DEFAULT_N;
|
|
51
52
|
const access = {
|
|
52
53
|
owner: ctx.taskId ?? opts.owner,
|
|
53
|
-
scope: ctx
|
|
54
|
+
scope: callScopeOf(ctx, opts),
|
|
54
55
|
...((ctx.sessionId ?? opts.sessionId) !== undefined ? { sessionId: ctx.sessionId ?? opts.sessionId } : {}),
|
|
55
56
|
};
|
|
56
57
|
const seat = opts.checkpointSeat ?? ctx.checkpointStoreForChildren;
|
|
@@ -11,6 +11,8 @@ import type { AgentDefinition } from "../core/types.js";
|
|
|
11
11
|
* coordinates and the drift re-checks live in the parity register, not here.
|
|
12
12
|
*
|
|
13
13
|
* sema adaptations (deliberate, each recorded):
|
|
14
|
+
* - The deny set also denies SaveToolResult (sema's writer of kept bytes, no reference counterpart): its write half is the
|
|
15
|
+
* reference's three plus every other write tool the catalog declares, held equal to the catalog's confinable writes by test.
|
|
14
16
|
* - De-branding (prompt-sovereignty / SUBAGENT_PROMPT precedent): CC's persona first sentences name the
|
|
15
17
|
* product ("… for Claude Code, Anthropic's official CLI for Claude." / "… for Claude Code.") — sema
|
|
16
18
|
* stays provider-neutral, the brand clause is dropped; every other byte is unchanged.
|
|
@@ -22,10 +24,10 @@ import type { AgentDefinition } from "../core/types.js";
|
|
|
22
24
|
* model (identical semantics). CC's Explore firstParty opus UPGRADE (`GAe`, 409162-409171: built-in
|
|
23
25
|
* Explore may upshift to opus on first-party subscriptions) is a CC-subscription ladder concern —
|
|
24
26
|
* NOT ported (sema is provider-neutral; inherit is the base arm both sides share).
|
|
25
|
-
* - `omitClaudeMd:!0` (422063: drops the CLAUDE.md user-context layer for these types) — NOT ported
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
27
|
+
* - `omitClaudeMd:!0` (422063: drops the CLAUDE.md user-context layer for these types) — NOT ported:
|
|
28
|
+
* a child inherits the task's instruction family (the parent spec seat) and reads the task root's
|
|
29
|
+
* instructions through the same lane; a type that should go without them is spawned with
|
|
30
|
+
* `projectMemory: "disabled"`. Recorded as the F7 residual.
|
|
29
31
|
* - `disallowedTools` → `denyTools` (sema name), with the DELEGATION-tool entry tracking the deployment's
|
|
30
32
|
* actual tool name (default "Agent"). "Artifact" (mounted on the `RunnerDeps.artifactHost`
|
|
31
33
|
* seat) and "ExitPlanMode" (present_plan's canonical name) both name first-party sema tools — the deny bites
|
|
@@ -42,9 +44,10 @@ export declare const EXPLORE_SYSTEM_PROMPT = "You are a file search specialist.
|
|
|
42
44
|
/** Plan persona, unix arm, first sentence de-branded. */
|
|
43
45
|
export declare const PLAN_SYSTEM_PROMPT = "You are a software architect and planning specialist. Your role is to explore the codebase and design implementation plans.\n\n=== CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS ===\nThis is a READ-ONLY planning task. You are STRICTLY PROHIBITED from:\n- Creating new files (no Write, touch, or file creation of any kind)\n- Modifying existing files (no Edit operations)\n- Deleting files (no rm or deletion)\n- Moving or copying files (no mv or cp)\n- Creating temporary files anywhere, including /tmp\n- Using redirect operators (>, >>, |) or heredocs to write to files\n- Running ANY commands that change system state\n\nYour role is EXCLUSIVELY to explore the codebase and design implementation plans. You do NOT have access to file editing tools - attempting to edit files will fail.\n\nYou will be provided with a set of requirements and optionally a perspective on how to approach the design process.\n\n## Your Process\n\n1. **Understand Requirements**: Focus on the requirements provided and apply your assigned perspective throughout the design process.\n\n2. **Explore Thoroughly**:\n - Read any files provided to you in the initial prompt\n - Find existing patterns and conventions using Glob, Grep, and Read\n - Understand the current architecture\n - Identify similar features as reference\n - Trace through relevant code paths\n - Use Bash ONLY for read-only operations (ls, git status, git log, git diff, find, cat, head, tail)\n - NEVER use Bash for: mkdir, touch, rm, cp, mv, git add, git commit, npm install, pip install, or any file creation/modification\n\n3. **Design Solution**:\n - Create implementation approach based on your assigned perspective\n - Consider trade-offs and architectural decisions\n - Follow existing patterns where appropriate\n\n4. **Detail the Plan**:\n - Provide step-by-step implementation strategy\n - Identify dependencies and sequencing\n - Anticipate potential challenges\n\n## Required Output\n\nEnd your response with:\n\n### Critical Files for Implementation\nList 3-5 files most critical for implementing this plan:\n- path/to/file1.ts\n- path/to/file2.ts\n- path/to/file3.ts\n\nREMEMBER: You can ONLY explore and plan. You CANNOT and MUST NOT write, edit, or modify any files. You do NOT have access to file editing tools.";
|
|
44
46
|
/**
|
|
45
|
-
* The
|
|
46
|
-
*
|
|
47
|
-
*
|
|
47
|
+
* The deny set shared by both read-only built-ins: Agent, Artifact, ExitPlanMode, Edit, Write, NotebookEdit (the reference's,
|
|
48
|
+
* verbatim) and SaveToolResult — every tool that writes a file by its path, the catalog's confinable writes (a test holds the
|
|
49
|
+
* write half equal to them, so a write tool the catalog gains is a red here, not a read-only child that can write).
|
|
50
|
+
* The delegation-tool entry is parameterized on the deployment's actual tool name (default = "Agent").
|
|
48
51
|
*/
|
|
49
52
|
export declare const BUILTIN_READONLY_DENY_TOOLS: (delegationToolName?: string) => string[];
|
|
50
53
|
/**
|
|
@@ -92,6 +92,7 @@ export const BUILTIN_READONLY_DENY_TOOLS = (delegationToolName = DEFAULT_DELEGAT
|
|
|
92
92
|
"Edit",
|
|
93
93
|
"Write",
|
|
94
94
|
"NotebookEdit",
|
|
95
|
+
"SaveToolResult",
|
|
95
96
|
];
|
|
96
97
|
export function builtinAgentDefinitions(delegationToolName = DEFAULT_DELEGATION_TOOL_NAME) {
|
|
97
98
|
const denyTools = BUILTIN_READONLY_DENY_TOOLS(delegationToolName);
|
package/dist/agents/cascade.d.ts
CHANGED
|
@@ -127,14 +127,22 @@ export interface CascadeAttempt {
|
|
|
127
127
|
}
|
|
128
128
|
export interface CascadeRunResult extends TaskResult {
|
|
129
129
|
/**
|
|
130
|
-
* The cascade's conclusion, **distinct from the inherited `status
|
|
131
|
-
*
|
|
132
|
-
* `
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
130
|
+
* The cascade's conclusion, **distinct from the inherited `status`**, in three words:
|
|
131
|
+
* - `"passed"` — some rung passed the gate.
|
|
132
|
+
* - `"exhausted"` — the cascade ended with no rung passing and nothing left to continue (the last rung's result is
|
|
133
|
+
* returned, and its `status` may still be "completed" — judge the cascade by `cascadeOutcome`, not `status`): the ladder
|
|
134
|
+
* ran out, a guard stopped it (escalation cap, cost ceiling, wall-clock budget, the caller's signal), or a resumed rung's
|
|
135
|
+
* approved action never started and its card is not pending again (`failed.unstartedRow` is `"declined"` — the store
|
|
136
|
+
* declined to reopen it — or `"unknown"` — its state is unproven): nothing continues that ladder, it ends as it stands.
|
|
137
|
+
* - `"suspended"` — the cascade is parked, not finished, and the host's token continues it: a rung durably parked
|
|
138
|
+
* (`failed.nestedPause` is on the terminal and the parked leg's session is held), or a resumed rung's approved action
|
|
139
|
+
* never started and its card is pending again (`failed.unstartedRow` is `"reopened"`). {@link resumeCascade} continues the
|
|
140
|
+
* ladder from the token. The rung's own code stays on `attempts[].errorCode` (`unexpected.suspended` for an approval /
|
|
141
|
+
* resource / platform park, `unexpected.needs_review` for a park that awaits a reviewer, the leg's own code for a resumed
|
|
142
|
+
* rung that never started) — the outcome says the ladder waits on the host, the code says which pause or why the resume
|
|
143
|
+
* did not start.
|
|
136
144
|
*/
|
|
137
|
-
cascadeOutcome: "passed" | "exhausted";
|
|
145
|
+
cascadeOutcome: "passed" | "exhausted" | "suspended";
|
|
138
146
|
/** F4: present when a finite `costCeilingMicroUsd` was configured but some rung's spend was unpriced —
|
|
139
147
|
* the ceiling could not be enforced over unknown cost, so the ladder STOPPED escalating (fail-closed)
|
|
140
148
|
* instead of riding an unbindable budget. Judge spend by the absent cost fields, not by 0. */
|
|
@@ -203,7 +211,10 @@ export declare function runCascade(runner: RunnerSelfSeat, spec: TaskSpec, confi
|
|
|
203
211
|
* carrying `placementRoot` = the fixed point that rung's result reports (`TaskResult.placementRoot`)
|
|
204
212
|
* unless the caller's object already resolves there (`placementRoot`, else `rootSessionId`: the
|
|
205
213
|
* ladder's fixed point), and `placementTarget` = that rung's target when it reported one (a later rung
|
|
206
|
-
* minted on another device is refused `config.placement_not_honored`).
|
|
214
|
+
* minted on another device is refused `config.placement_not_honored`). When the caller's object carries
|
|
215
|
+
* no fixed point and the spec names its session (`spec.sessionId`), rung 0 is dispatched with that
|
|
216
|
+
* session as `placementRoot`: the ladder is placed where a plain run of the spec would be — on the
|
|
217
|
+
* session a host binds its devices and cards to — not on a session minted for rung 0.
|
|
207
218
|
*
|
|
208
219
|
* The COMPOSITION-LEG delta: when the caller's spec names its session (`spec.sessionId`, which no rung
|
|
209
220
|
* runs in — every rung is a cold re-run in its own), every rung is dispatched with a copy carrying
|
|
@@ -219,7 +230,7 @@ internals?: RunInternals): Promise<CascadeRunResult>;
|
|
|
219
230
|
/**
|
|
220
231
|
* Continue a cascade from a rung's parked card, then climb the rest of the ladder: the resume entry beside {@link runCascade},
|
|
221
232
|
* as {@link import("./verify.js").resumeWithVerification} is beside its fresh-run entry. A rung that durably parks ends the
|
|
222
|
-
* ladder (`cascadeOutcome`, `failed.nestedPause`) — the host holds the token, and the card's
|
|
233
|
+
* ladder (`cascadeOutcome: "suspended"`, `failed.nestedPause`) — the host holds the token, and the card's
|
|
223
234
|
* `CheckpointState.compositionLeg` says which rung parked and which host session it belongs to. Once the pause is decided,
|
|
224
235
|
* the host calls this with the token, the outcome, the ORIGINAL task spec, the ladder config and that `compositionLeg` as the
|
|
225
236
|
* card records it.
|
|
@@ -240,8 +251,10 @@ internals?: RunInternals): Promise<CascadeRunResult>;
|
|
|
240
251
|
* refused by the escalation cap, the cost ceiling or the wall-clock budget, and the deadline does not cut it; it is run under
|
|
241
252
|
* the caller's `spec.signal` alone. Its result is gated exactly like a fresh rung: a pass ends the ladder `passed`, a fail
|
|
242
253
|
* escalates to the next rung, a re-park ends it again with that rung's own card. A resumed rung whose approved action never
|
|
243
|
-
* started (`resume.reopened_unstarted` / `resume.reopen_failed_unstarted`: the card is pending again, or
|
|
244
|
-
* is never escalated: the ladder ends there with its result as is
|
|
254
|
+
* started (`resume.reopened_unstarted` / `resume.reopen_failed_unstarted`: the card is pending again, or the store declined to
|
|
255
|
+
* reopen it, or its state is unproven) is never escalated: the ladder ends there with its result as is and the session kept.
|
|
256
|
+
* Only a card that is pending again (`unstartedRow: "reopened"`) is the same park standing — `cascadeOutcome: "suspended"`, and
|
|
257
|
+
* the same token resumes it again; a declined or unproven one ends the ladder `exhausted`, and the host reads the row first.
|
|
245
258
|
* - **Accounting covers this call**: `attempts` starts at the resumed rung (`index: parkedLeg.leg`), and the cumulative stats,
|
|
246
259
|
* the escalations counted against `maxEscalations`, the cost ceiling and `totalTimeoutMs` cover only the rungs this call
|
|
247
260
|
* dispatched. The resumed rung's stats are the engine's own report of that leg — never added to the stats of the call that
|
package/dist/agents/cascade.js
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
import { terminalProjection } from "../core/runner/terminal-projection.js";
|
|
2
2
|
import { releaseSession } from "./session-util.js";
|
|
3
3
|
import { mapNestedSuspend, isDurablePause, resumeNeverStarted } from "./suspend-guard.js";
|
|
4
|
-
import { buildCumulativeStats } from "./cumulative-stats.js";
|
|
4
|
+
import { buildCumulativeStats, emptyCumulativeUsageFacts, foldUsageFacts } from "./cumulative-stats.js";
|
|
5
|
+
import { foldIntake, withIntake } from "../core/task-intake.js";
|
|
5
6
|
import { createSafeNotifier } from "../core/safe-notify.js";
|
|
6
7
|
import { compositionPlacement } from "./composition-placement.js";
|
|
8
|
+
import { withLegIdentity } from "./leg-label.js";
|
|
7
9
|
import { thrownText } from "../core/thrown-value.js";
|
|
10
|
+
import { withoutSessionBinding } from "../core/task-spec-members.js";
|
|
8
11
|
const CASCADE_ON_RUNG_SITE = "cascade.onRung";
|
|
9
12
|
const CASCADE_CONFIG_ERROR_CODE = "config.cascade_invalid";
|
|
10
13
|
const CASCADE_NO_DISPATCH_ERROR_CODE = "cascade.budget_exhausted";
|
|
@@ -68,11 +71,12 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
68
71
|
let ownTokens = 0, ownTurns = 0, ownPrompt = 0, ownCached = 0, ownOutput = 0, ownCostMicro = 0;
|
|
69
72
|
let ownTotalInput = 0;
|
|
70
73
|
let ownCacheWrite = 0, ownCacheWriteLong = 0;
|
|
74
|
+
const ownUsageFacts = emptyCumulativeUsageFacts();
|
|
71
75
|
let nestedTokens = 0, nestedTurns = 0, nestedTasks = 0, nestedCostMicro = 0;
|
|
72
76
|
let ownLlmRootMicro = 0, ownCompactionMicro = 0;
|
|
73
77
|
let ownSideCallMicro;
|
|
74
78
|
let anyRungUnpriced = false;
|
|
75
|
-
let hrCount = 0, hrWaitMs = 0;
|
|
79
|
+
let hrKept = false, hrCount = 0, hrWaitMs = 0;
|
|
76
80
|
const hrGates = [];
|
|
77
81
|
const cumulativeStats = (baseStats) => buildCumulativeStats(baseStats, {
|
|
78
82
|
tokens: ownTokens,
|
|
@@ -89,14 +93,16 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
89
93
|
compactionMicroUsd: ownCompactionMicro,
|
|
90
94
|
...(ownSideCallMicro !== undefined ? { sideCallMicroUsd: ownSideCallMicro } : {}),
|
|
91
95
|
nested: { tokens: nestedTokens, turns: nestedTurns, tasks: nestedTasks, costMicroUsd: nestedCostMicro },
|
|
92
|
-
humanReview: { count: hrCount, totalWaitMs: hrWaitMs, gates: hrGates },
|
|
96
|
+
humanReview: { kept: hrKept, count: hrCount, totalWaitMs: hrWaitMs, gates: hrGates },
|
|
97
|
+
usageFacts: ownUsageFacts,
|
|
93
98
|
});
|
|
94
99
|
let lastResult;
|
|
95
100
|
let passedRung = -1;
|
|
96
101
|
let firstLegResult;
|
|
97
102
|
let finalRung = -1;
|
|
98
|
-
const
|
|
99
|
-
const
|
|
103
|
+
const rungIntakes = [];
|
|
104
|
+
const placement = compositionPlacement(internals, opening.kind === "fresh" ? opening.hostSessionId : undefined);
|
|
105
|
+
const specBase = withoutSessionBinding(spec);
|
|
100
106
|
const rungSpecOf = (rung, signal) => ({ ...specBase, model: rung.model, ...(rung.overrides ?? {}), ...(signal ? { signal } : {}) });
|
|
101
107
|
const resumeConfigOf = (task) => {
|
|
102
108
|
const { objective: _objective, userAttachments: _attachments, runOrigin: _origin, ...config } = task;
|
|
@@ -131,9 +137,10 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
131
137
|
let result;
|
|
132
138
|
const placed = firstLegResult === undefined ? placement.firstLeg : placement.laterLeg(firstLegResult);
|
|
133
139
|
const compositionLeg = resumed !== undefined ? resumed.parked : legOf(i);
|
|
134
|
-
const rungInternals = compositionLeg === undefined ? placed : { ...placed, compositionLeg };
|
|
135
140
|
const rungTask = rungSpecOf(rung, rungSignal);
|
|
141
|
+
let rungInternals;
|
|
136
142
|
try {
|
|
143
|
+
rungInternals = withLegIdentity(compositionLeg === undefined ? placed : { ...placed, compositionLeg }, { kind: "rung", round: i }, internals, resumed !== undefined ? "resumeStream" : "runTaskStream");
|
|
137
144
|
result = resumed !== undefined ? await runner.resume(resumed.token, resumed.outcome, resumeConfigOf(rungTask), rungInternals) : await runner.runTask(rungTask, rungInternals);
|
|
138
145
|
}
|
|
139
146
|
finally {
|
|
@@ -141,6 +148,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
141
148
|
clearTimeout(deadlineTimer);
|
|
142
149
|
}
|
|
143
150
|
lastResult = result;
|
|
151
|
+
rungIntakes.push(result.intake);
|
|
144
152
|
finalRung = i;
|
|
145
153
|
firstLegResult ??= result;
|
|
146
154
|
const s = result.stats;
|
|
@@ -157,6 +165,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
157
165
|
ownOutput += s.outputTokens ?? 0;
|
|
158
166
|
ownCacheWrite += s.cacheWriteTokens ?? 0;
|
|
159
167
|
ownCacheWriteLong += s.cacheWriteTokensLong ?? 0;
|
|
168
|
+
foldUsageFacts(ownUsageFacts, s);
|
|
160
169
|
ownCostMicro += s.costMicroUsd ?? 0;
|
|
161
170
|
if (s.costMicroUsd === undefined)
|
|
162
171
|
anyRungUnpriced = true;
|
|
@@ -167,6 +176,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
167
176
|
ownSideCallMicro = (ownSideCallMicro ?? 0) + s.costBreakdown.sideCallMicroUsd;
|
|
168
177
|
}
|
|
169
178
|
if (s.humanReview) {
|
|
179
|
+
hrKept = true;
|
|
170
180
|
hrCount += s.humanReview.count;
|
|
171
181
|
hrWaitMs += s.humanReview.totalWaitMs;
|
|
172
182
|
hrGates.push(...s.humanReview.gates);
|
|
@@ -178,12 +188,13 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
178
188
|
nestedCostMicro += s.nested.costMicroUsd ?? 0;
|
|
179
189
|
}
|
|
180
190
|
if (isDurablePause(result.terminal) || resumeNeverStarted(result)) {
|
|
191
|
+
const continuable = isDurablePause(result.terminal) || (result.terminal.kind === "failed" && result.terminal.unstartedRow === "reopened");
|
|
181
192
|
const mapped = mapNestedSuspend(result, { door: "resumeCascade", legFrom: rungInternals?.compositionLeg === undefined ? "caller" : "card" });
|
|
182
193
|
attempts.push({ index: i, model: rung.model, passed: false, costMicroUsd: rungCost, status: attemptTerminal(result).status, errorCode: attemptTerminal(mapped).errorCode });
|
|
183
194
|
return {
|
|
184
|
-
...mapped,
|
|
195
|
+
...withIntake(mapped, foldIntake(rungIntakes)),
|
|
185
196
|
stats: cumulativeStats(result.stats),
|
|
186
|
-
cascadeOutcome: "exhausted",
|
|
197
|
+
cascadeOutcome: continuable ? "suspended" : "exhausted",
|
|
187
198
|
...(config.costCeilingMicroUsd != null && !ceilingCostKnown ? { costCeilingUnenforceable: true } : {}),
|
|
188
199
|
escalated: i > 0,
|
|
189
200
|
finalRung: i,
|
|
@@ -248,6 +259,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
248
259
|
taskId: spec.taskId ?? "",
|
|
249
260
|
sessionId: "",
|
|
250
261
|
result: `runCascade: the overall wall-clock budget (totalTimeoutMs ${config.totalTimeoutMs}ms) was already spent when the ladder was entered — no rung dispatched`, resultEntryIds: [],
|
|
262
|
+
intake: { committed: false },
|
|
251
263
|
terminal: { kind: "failed", code: CASCADE_NO_DISPATCH_ERROR_CODE },
|
|
252
264
|
stats: { tokens: 0, turns: 0, costMicroUsd: 0 },
|
|
253
265
|
cascadeOutcome: "exhausted",
|
|
@@ -258,7 +270,7 @@ async function climbLadder(entryName, runner, spec, config, internals, opening)
|
|
|
258
270
|
}
|
|
259
271
|
const base = lastResult;
|
|
260
272
|
return {
|
|
261
|
-
...base,
|
|
273
|
+
...withIntake(base, foldIntake(rungIntakes)),
|
|
262
274
|
stats: cumulativeStats(base.stats),
|
|
263
275
|
cascadeOutcome: passedRung >= 0 ? "passed" : "exhausted",
|
|
264
276
|
...(config.costCeilingMicroUsd != null && !ceilingCostKnown ? { costCeilingUnenforceable: true } : {}),
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { terminalProjection } from "../core/runner/terminal-projection.js";
|
|
2
|
+
import type { TerminalFailureDetail } from "../core/terminal-cause.js";
|
|
2
3
|
import type { TerminalCause } from "../core/types.js";
|
|
3
4
|
import { type Egress } from "../core/untrusted-egress.js";
|
|
4
5
|
/** A child run's failure words can carry a credential: every parent-facing reader takes them from here, each through the
|
|
@@ -6,4 +7,33 @@ import { type Egress } from "../core/untrusted-egress.js";
|
|
|
6
7
|
* its thrown value (every string member, not the message alone). */
|
|
7
8
|
export declare const childTerminalFace: (terminal: TerminalCause) => ReturnType<typeof terminalProjection>;
|
|
8
9
|
export declare const childThrownText: (err: unknown) => Egress<"same-principal">;
|
|
10
|
+
/** A delegated child's failure code, read once per failure: the failure account's `code` and the `detail` of the same link (one
|
|
11
|
+
* walk of the thrown value's `cause` chain, the walk a failed terminal reads), and the string `errorKind` the thrower declared. A
|
|
12
|
+
* settled child has no thrown value: its account is `{ code: terminal.code }`. */
|
|
13
|
+
export interface ChildFailure {
|
|
14
|
+
readonly code?: string;
|
|
15
|
+
readonly errorKind?: string;
|
|
16
|
+
readonly detail?: TerminalFailureDetail;
|
|
17
|
+
}
|
|
18
|
+
export declare function childFailureOf(err: unknown): ChildFailure;
|
|
19
|
+
/** A rejected child run, read once: the sentence its faces carry and its failure account. */
|
|
20
|
+
export interface RejectedChild {
|
|
21
|
+
readonly text: Egress<"same-principal">;
|
|
22
|
+
readonly failure: ChildFailure;
|
|
23
|
+
}
|
|
24
|
+
export declare const rejectedChildOf: (err: unknown) => RejectedChild;
|
|
25
|
+
/** The ROW face of a child's failure — a background row, its notice and poll, a parked resume's cause: the code as it stands
|
|
26
|
+
* (a platform's word too: the host's own redaction, counting and alerts read the original), else the declared kind. */
|
|
27
|
+
export declare const childRowCode: (f: ChildFailure) => string | undefined;
|
|
28
|
+
/** The ANSWER face of a child's failure — a tool result the parent's model and frame read: the account's code when it is an
|
|
29
|
+
* engine word, else the declared kind. Only the account's item is screened: a declared `errorKind` is the thrower's
|
|
30
|
+
* statement, lifted as declared, the way every tool's is. */
|
|
31
|
+
export declare const childAnswerCode: (f: ChildFailure) => string | undefined;
|
|
32
|
+
/**
|
|
33
|
+
* A rejected child run's thrown value, as the parent's tool layer receives it: the `same-principal` snapshot (every own member
|
|
34
|
+
* kept), with its `details.code` set to the answer face's account item — the engine word of its failure account, or no `code`
|
|
35
|
+
* member at all. The snapshot is what is read, so the thrown value is read once and the answer describes the copy the parent
|
|
36
|
+
* receives (a member that serializes itself is read as the copy reads it). Its `errorKind` stands, so the frame's lift
|
|
37
|
+
* (`details.code`, else `errorKind`) answers {@link childAnswerCode}.
|
|
38
|
+
*/
|
|
9
39
|
export declare const childRejection: (err: unknown) => unknown;
|
|
@@ -1,8 +1,32 @@
|
|
|
1
|
+
import { thrownFailureOf } from "../core/runner/terminal-account.js";
|
|
1
2
|
import { terminalProjection } from "../core/runner/terminal-projection.js";
|
|
3
|
+
import { isPlainRecord } from "../core/mods/kernel/receive.js";
|
|
4
|
+
import { isEngineCodeShape, readMember, thrownMarksOf } from "../core/thrown-value.js";
|
|
2
5
|
import { egressText, egressThrownText, egressValue } from "../core/untrusted-egress.js";
|
|
3
6
|
export const childTerminalFace = (terminal) => {
|
|
4
7
|
const face = terminalProjection(terminal);
|
|
5
8
|
return typeof face.errorMessage === "string" ? { ...face, errorMessage: egressText("same-principal", face.errorMessage) } : face;
|
|
6
9
|
};
|
|
7
10
|
export const childThrownText = (err) => egressThrownText("same-principal", err);
|
|
8
|
-
export
|
|
11
|
+
export function childFailureOf(err) {
|
|
12
|
+
const { code, detail } = thrownFailureOf(err, "");
|
|
13
|
+
const errorKind = thrownMarksOf(err)?.errorKind;
|
|
14
|
+
return { ...(code !== undefined ? { code } : {}), ...(typeof errorKind === "string" ? { errorKind } : {}), ...(detail !== undefined ? { detail } : {}) };
|
|
15
|
+
}
|
|
16
|
+
export const rejectedChildOf = (err) => ({ text: childThrownText(err), failure: childFailureOf(err) });
|
|
17
|
+
export const childRowCode = (f) => f.code ?? f.errorKind;
|
|
18
|
+
const engineCodeOf = (f) => (f.code !== undefined && isEngineCodeShape(f.code) ? f.code : undefined);
|
|
19
|
+
export const childAnswerCode = (f) => engineCodeOf(f) ?? f.errorKind;
|
|
20
|
+
export const childRejection = (err) => {
|
|
21
|
+
const snapshot = egressValue("same-principal", err);
|
|
22
|
+
if (snapshot === null || typeof snapshot !== "object")
|
|
23
|
+
return snapshot;
|
|
24
|
+
const code = engineCodeOf(childFailureOf(snapshot));
|
|
25
|
+
const details = readMember(snapshot, "details");
|
|
26
|
+
if (!isPlainRecord(details) && code === undefined)
|
|
27
|
+
return snapshot;
|
|
28
|
+
const bag = isPlainRecord(details) ? details : {};
|
|
29
|
+
const { code: _stated, ...rest } = bag;
|
|
30
|
+
Object.defineProperty(snapshot, "details", { value: code !== undefined ? { ...rest, code } : rest, enumerable: true, writable: true, configurable: true });
|
|
31
|
+
return snapshot;
|
|
32
|
+
};
|
|
@@ -7,7 +7,11 @@ import type { TaskResult } from "../core/types.js";
|
|
|
7
7
|
* · the tree's fixed point (`RunInternals.placementRoot`): every later leg lands where the first leg landed — the first leg's
|
|
8
8
|
* own report of the fixed point its prepare resolved (`TaskResult.placementRoot`). It is minted into the copy unless the
|
|
9
9
|
* caller's object already resolves there by prepare's fold (`placementRoot`, else `rootSessionId`); on a fresh entry it
|
|
10
|
-
* always does whenever the caller carries a fixed point, so that caller's object rides unchanged.
|
|
10
|
+
* always does whenever the caller carries a fixed point, so that caller's object rides unchanged. A fresh entry whose caller
|
|
11
|
+
* carries none, over a task that names a host session, gives its first leg that session as the fixed point (the one value
|
|
12
|
+
* the first leg's own prepare would otherwise take from the leg it runs in, which is a session of its own when the entry
|
|
13
|
+
* strips the host's): the work is placed where a plain run of the same task would have been, and every later leg and every
|
|
14
|
+
* card reads it back from the first leg's report. A resume entry gives none — its card records the fixed point. The first leg is the one
|
|
11
15
|
* the entry drove first: a resume entry's resumed leg reports the fixed point its parked row recorded, which outranks a
|
|
12
16
|
* supplied `rootSessionId` there, so a caller whose `rootSessionId` names another session still sees every leg after it land
|
|
13
17
|
* where the composition's work was placed, not at that session or the resumed leg's own. A first leg that reported none (a
|
|
@@ -26,4 +30,4 @@ export interface CompositionPlacement {
|
|
|
26
30
|
/** The internals a later leg is dispatched with, given the first leg's result (its self-reported fixed point). */
|
|
27
31
|
laterLeg(firstLeg: Pick<TaskResult, "placementRoot">): RunInternals | undefined;
|
|
28
32
|
}
|
|
29
|
-
export declare function compositionPlacement(internals: RunInternals | undefined): CompositionPlacement;
|
|
33
|
+
export declare function compositionPlacement(internals: RunInternals | undefined, hostSessionId?: string): CompositionPlacement;
|
|
@@ -1,8 +1,12 @@
|
|
|
1
|
-
export function compositionPlacement(internals) {
|
|
1
|
+
export function compositionPlacement(internals, hostSessionId) {
|
|
2
2
|
let observed = false;
|
|
3
3
|
let firstTarget;
|
|
4
|
+
const declaredRoot = (bag) => bag?.placementRoot ?? bag?.rootSessionId ?? undefined;
|
|
5
|
+
const entry = internals === undefined ? undefined : { ...internals };
|
|
6
|
+
const hosted = declaredRoot(entry) === undefined ? hostSessionId : undefined;
|
|
4
7
|
const firstLeg = {
|
|
5
|
-
...
|
|
8
|
+
...entry,
|
|
9
|
+
...(hosted !== undefined ? { placementRoot: hosted } : {}),
|
|
6
10
|
onWorkspaceResolved: (workspace) => {
|
|
7
11
|
if (!observed) {
|
|
8
12
|
observed = true;
|
|
@@ -15,7 +19,7 @@ export function compositionPlacement(internals) {
|
|
|
15
19
|
firstLeg,
|
|
16
20
|
laterLeg(first) {
|
|
17
21
|
const landed = first.placementRoot;
|
|
18
|
-
const root = landed !== undefined && (internals
|
|
22
|
+
const root = landed !== undefined && declaredRoot(internals) !== landed ? landed : undefined;
|
|
19
23
|
if (root === undefined && firstTarget === undefined)
|
|
20
24
|
return internals;
|
|
21
25
|
return { ...internals, ...(root !== undefined ? { placementRoot: root } : {}), ...(firstTarget !== undefined ? { placementTarget: firstTarget } : {}) };
|
|
@@ -70,6 +70,14 @@ export declare function isCanonicalPeerAddress(address: string): boolean;
|
|
|
70
70
|
/** design/385 §4.2 — the canonical `from-scope` attribute form of a raw scope string.
|
|
71
71
|
* @throws CrossSessionCodecError on a non-string or a string with an unpaired surrogate. */
|
|
72
72
|
export declare function encodeScopeAttribute(rawScope: string): string;
|
|
73
|
+
/**
|
|
74
|
+
* Can this raw scope be spelled as a `from-scope` attribute — a well-formed string (no unpaired surrogate) that is a NAME by the
|
|
75
|
+
* engine's one name reading ({@link principalNameOf}: visible content, no control or line / paragraph separator, no format character
|
|
76
|
+
* but the two joiners; a scope is a principal's storage scope, so it is judged as the principal it came from was), and at most
|
|
77
|
+
* the attribute's byte bound once percent-encoded? The ONE judgment the envelope builder and parser apply, exported so a host that
|
|
78
|
+
* admits a scope at its own entrance asks the same question instead of restating the rule or the bound (the bound itself stays private).
|
|
79
|
+
*/
|
|
80
|
+
export declare function isSpellableFromScope(rawScope: string): boolean;
|
|
73
81
|
/** Inverse of {@link encodeScopeAttribute}; `undefined` when the bytes are not valid percent-encoded
|
|
74
82
|
* UTF-8 (the parser refuses the whole envelope on that). */
|
|
75
83
|
export declare function decodeScopeAttribute(encoded: string): string | undefined;
|
|
@@ -102,7 +110,8 @@ export interface CrossSessionEnvelopeFields {
|
|
|
102
110
|
*/
|
|
103
111
|
export declare function buildCrossSessionEnvelope(fields: CrossSessionEnvelopeFields, body: string): string;
|
|
104
112
|
/** Why a parse refused: `not_an_envelope` (the strict grammar did not match at all), `bad_scope_encoding`
|
|
105
|
-
* (a `from-scope`
|
|
113
|
+
* (a `from-scope` the codec cannot carry: not valid percent-encoded UTF-8, or one that decodes to a string
|
|
114
|
+
* {@link isSpellableFromScope} refuses — no name can be spelled that way), `roundtrip_mismatch` (the grammar matched
|
|
106
115
|
* but the canonical re-serialization differs — a near-miss / non-canonical form). All three mean
|
|
107
116
|
* "treat the text as ordinary data". */
|
|
108
117
|
export type CrossSessionEnvelopeRefusal = "not_an_envelope" | "bad_scope_encoding" | "roundtrip_mismatch";
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { ENGINE_AUTHORITY_ENVELOPE_TAGS, escapeEnvelopeTag, sanitizeUntrustedText } from "../core/untrusted-text.js";
|
|
2
|
+
import { principalNameOf } from "../core/principal-name.js";
|
|
2
3
|
export const CROSS_SESSION_MESSAGE_TAG = "cross-session-message";
|
|
3
4
|
const PEER_BODY_ENVELOPE_TAGS = [...ENGINE_AUTHORITY_ENVELOPE_TAGS];
|
|
4
5
|
export function neutralizePeerBody(body) {
|
|
@@ -69,6 +70,9 @@ export function encodeScopeAttribute(rawScope) {
|
|
|
69
70
|
assert(isScalarString(rawScope), "cross_session.invalid_from_scope", `a raw scope must be a well-formed string`);
|
|
70
71
|
return percentEncode(rawScope, /[^A-Za-z0-9._-]/gu);
|
|
71
72
|
}
|
|
73
|
+
export function isSpellableFromScope(rawScope) {
|
|
74
|
+
return isScalarString(rawScope) && principalNameOf(rawScope) !== undefined && FROM_SCOPE_ENCODED_RE.test(percentEncode(rawScope, /[^A-Za-z0-9._-]/gu));
|
|
75
|
+
}
|
|
72
76
|
export function decodeScopeAttribute(encoded) {
|
|
73
77
|
try {
|
|
74
78
|
return decodeURIComponent(encoded);
|
|
@@ -107,7 +111,7 @@ export function buildCrossSessionEnvelope(fields, body) {
|
|
|
107
111
|
}
|
|
108
112
|
if (fields.fromScope !== undefined) {
|
|
109
113
|
const encoded = encodeScopeAttribute(fields.fromScope);
|
|
110
|
-
assert(
|
|
114
|
+
assert(isSpellableFromScope(fields.fromScope), "cross_session.invalid_from_scope", `"from-scope" must be a name (visible content, no control, separator or format character but the joiners) of 1..${FROM_SCOPE_ENCODED_MAX_BYTES} bytes once percent-encoded`);
|
|
111
115
|
attrs.push(`from-scope="${encoded}"`);
|
|
112
116
|
}
|
|
113
117
|
const safeBody = escapeEnvelopeTag(CROSS_SESSION_MESSAGE_TAG, neutralizePeerBody(body));
|
|
@@ -129,7 +133,7 @@ export function parseCrossSessionEnvelope(text) {
|
|
|
129
133
|
let fromScope;
|
|
130
134
|
if (fromScopeEncoded !== undefined) {
|
|
131
135
|
fromScope = decodeScopeAttribute(fromScopeEncoded);
|
|
132
|
-
if (fromScope === undefined)
|
|
136
|
+
if (fromScope === undefined || !isSpellableFromScope(fromScope))
|
|
133
137
|
return { ok: false, reason: "bad_scope_encoding" };
|
|
134
138
|
}
|
|
135
139
|
const fields = {
|
|
@@ -131,7 +131,13 @@ export declare function judgeCrossSessionInbound(input: CrossSessionInboundInput
|
|
|
131
131
|
* blanket answering seat — the adapter's own reading of "nobody is watching");
|
|
132
132
|
* · `"unknown"` — otherwise, when the ask derivation is `unresolved` (the judge fails closed on it);
|
|
133
133
|
* · `prompting` — otherwise: an ask reaches a human or parks for one (`human_reachable`, `park_only`),
|
|
134
|
-
* and — CC's literal rule for a never-prompting-never-bypassing mode — `auto_deny
|
|
134
|
+
* and — CC's literal rule for a never-prompting-never-bypassing mode — `auto_deny`; and the deployment's approval
|
|
135
|
+
* policy (`policy_reachable`), under that seat's contract: a policy approver gives no new allow — it relays an answer a
|
|
136
|
+
* person gave before, refuses, or answers `"unavailable"` so the ask parks for a person (a deployment that answers every
|
|
137
|
+
* ask yes installs the blanket `onAsk: "allow"`, which folds `bypass`). The real-approval demand enforces the contract
|
|
138
|
+
* mechanically on the asks that carry it; on the others it is the deployment's word. A seat that declares a class table
|
|
139
|
+
* ({@link import("../core/tool-policy.js").declareClassAnswers}) folds by its form like any seat — `prompting`: it answers
|
|
140
|
+
* the classes it declares by itself, and every other ask still reaches a person or parks for one.
|
|
135
141
|
* `effective` absent (a leg with no mode fact) reads the ask derivation alone.
|
|
136
142
|
*
|
|
137
143
|
* WHAT THE CLASS IS: `fromMode` is a presence LABEL — whether a person is watching this session's approvals —
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { TaskResult } from "../core/types.js";
|
|
2
|
+
import type { UsageLane } from "../core/runner/side-call-account.js";
|
|
2
3
|
import type { CompositionSpend } from "./composition-allowance.js";
|
|
3
4
|
/**
|
|
4
5
|
* Shared CUMULATIVE-STATS constructor for the multi-leg agent compositions (cascade rungs, repair-loop
|
|
@@ -27,10 +28,38 @@ export interface CumulativeNestedTotals {
|
|
|
27
28
|
* {@link TaskResult}, so a leg's entry passes through with `toolName`/`toolArg` intact.
|
|
28
29
|
*/
|
|
29
30
|
export interface CumulativeHumanReviewTotals {
|
|
31
|
+
/** Some leg's result carried a ledger — the operation's result carries the sum then, `count: 0` included. */
|
|
32
|
+
kept: boolean;
|
|
30
33
|
count: number;
|
|
31
34
|
totalWaitMs: number;
|
|
32
35
|
gates: NonNullable<TaskResult["stats"]["humanReview"]>["gates"];
|
|
33
36
|
}
|
|
37
|
+
/** The usage sums a leg's stats may publish — each summed over the legs, and published on the cumulative stats exactly when some
|
|
38
|
+
* leg published it (a leg's 0 is a measured 0 and is kept; a member no leg published stays absent). */
|
|
39
|
+
declare const USAGE_SUM_KEYS: readonly ["promptTokens", "totalInputTokens", "cachedTokens", "outputTokens", "cacheWriteTokens", "cacheWriteTokensLong"];
|
|
40
|
+
type UsageSumKey = (typeof USAGE_SUM_KEYS)[number];
|
|
41
|
+
/**
|
|
42
|
+
* What the legs said about their usage beyond the sums, folded leg by leg ({@link foldUsageFacts}): which sums any leg published,
|
|
43
|
+
* the knownness marks — each the UNION over the legs (one leg that did not report makes the operation's figure unknown in the
|
|
44
|
+
* same way) — and the lanes a leg left out of its cache-hit rate, merged per lane with what they contributed. Held by every
|
|
45
|
+
* composition's fold (the tracker below, cascade, repair-loop), so the marks cannot be read off the last leg alone.
|
|
46
|
+
*/
|
|
47
|
+
export interface CumulativeUsageFacts {
|
|
48
|
+
readonly published: Set<UsageSumKey>;
|
|
49
|
+
usageMissing: boolean;
|
|
50
|
+
cacheReadUnreported: boolean;
|
|
51
|
+
cacheWriteUnreported: boolean;
|
|
52
|
+
readonly cacheHitRateExcludes: Map<UsageLane, {
|
|
53
|
+
cachedTokens: number;
|
|
54
|
+
totalInputTokens: number;
|
|
55
|
+
}>;
|
|
56
|
+
/** Some leg published the rate's denominator (`totalInputTokens`) without its numerator (`cachedTokens`): the operation's
|
|
57
|
+
* cached-token sum is short by an unknown amount, so no rate is derived. */
|
|
58
|
+
rateNumeratorShort: boolean;
|
|
59
|
+
}
|
|
60
|
+
export declare function emptyCumulativeUsageFacts(): CumulativeUsageFacts;
|
|
61
|
+
/** Fold ONE leg's usage facts (call once per leg, beside the leg's sums). */
|
|
62
|
+
export declare function foldUsageFacts(facts: CumulativeUsageFacts, s: TaskResult["stats"]): void;
|
|
34
63
|
/**
|
|
35
64
|
* The running totals a multi-leg composition accumulates. Every field is REQUIRED: an optional field here
|
|
36
65
|
* would re-open the exact "forgot to override one" hole this module exists to close — a caller that has
|
|
@@ -75,13 +104,17 @@ export interface CumulativeStatsAccumulator {
|
|
|
75
104
|
sideCallMicroUsd?: number;
|
|
76
105
|
nested: CumulativeNestedTotals;
|
|
77
106
|
humanReview: CumulativeHumanReviewTotals;
|
|
107
|
+
/** The legs' usage facts beyond the sums (published members, the knownness marks, the lanes left out of a hit rate). */
|
|
108
|
+
usageFacts: CumulativeUsageFacts;
|
|
78
109
|
}
|
|
79
110
|
/**
|
|
80
111
|
* Build the cumulative stats over a base (the FINAL leg's stats — it carries the non-accumulated fields
|
|
81
112
|
* such as `model`) with every accumulated field overridden.
|
|
82
113
|
*
|
|
83
|
-
* `cacheHitRate` is RE-DERIVED from the cumulative
|
|
84
|
-
*
|
|
114
|
+
* `cacheHitRate` is RE-DERIVED from the cumulative totals rather than spread from the base: a ratio is not additive, so the
|
|
115
|
+
* last leg's rate is never the operation's rate. It is derived by the one identity a leg's rate obeys: the totals minus what
|
|
116
|
+
* the lanes left out contributed — a lane is left out where a leg left it out (that leg's calls on it did not report the
|
|
117
|
+
* ratio's operands); the same lane's calls in a leg that reported them all stay in.
|
|
85
118
|
*/
|
|
86
119
|
export declare function buildCumulativeStats(base: TaskResult["stats"], acc: CumulativeStatsAccumulator): TaskResult["stats"];
|
|
87
120
|
/** A running {@link CumulativeStatsAccumulator} with the per-leg fold built in. */
|
|
@@ -113,3 +146,4 @@ export interface CumulativeStatsTracker {
|
|
|
113
146
|
* OWN and NESTED stay DISJOINT here too: `add` never folds a leg's `nested.*` into the own totals.
|
|
114
147
|
*/
|
|
115
148
|
export declare function createCumulativeStatsTracker(): CumulativeStatsTracker;
|
|
149
|
+
export {};
|