@sema-agent/core 7.66.0 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3498 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +7 -6
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
package/dist/core/side-query.js
CHANGED
|
@@ -2,26 +2,27 @@ import { ensureToolTurnInvariants } from "../internal/llm.js";
|
|
|
2
2
|
import { resolveTaskModel } from "./roles.js";
|
|
3
3
|
import { runRenderer } from "../prompt-assembly/renderers.js";
|
|
4
4
|
import { roleBaseOf } from "../prompt-assembly/role-base.js";
|
|
5
|
-
import { effectiveTraitsOf, readModelPromptTraits, selectorsOf } from "../prompt-assembly/select.js";
|
|
6
|
-
import { readDegradation } from "../brain/degrading.js";
|
|
5
|
+
import { effectiveTraitsOf, readModelPromptTraits, resolvePromptLocale, selectorsOf } from "../prompt-assembly/select.js";
|
|
7
6
|
import { extractErrorCode } from "../brain/errors.js";
|
|
8
7
|
import { cacheFamilyOf, uncachedInputTokensOf } from "./runner/usage-accounting.js";
|
|
9
|
-
import { priceReply } from "./runner/reply-pricing.js";
|
|
8
|
+
import { billsOf, priceReply } from "./runner/reply-pricing.js";
|
|
9
|
+
import { modelLaneBrainOf } from "./runner/model-lane-seat.js";
|
|
10
10
|
import { providerReportedModel } from "./message-utils.js";
|
|
11
11
|
import { providerToolCallId } from "../brain/tool-call-id.js";
|
|
12
12
|
function normalizeSideQueryUsage(model, u) {
|
|
13
|
-
const input = uncachedInputTokensOf(cacheFamilyOf(model), u);
|
|
13
|
+
const input = uncachedInputTokensOf(cacheFamilyOf(model), { input: u.input, cacheRead: u.cacheRead ?? 0, cacheWrite: u.cacheWrite ?? 0 });
|
|
14
14
|
return input === u.input ? u : { ...u, input };
|
|
15
15
|
}
|
|
16
16
|
const NO_RUN_FACTS = Object.freeze({ policyEnabled: false, hooksEnabled: false, isolationEnabled: false, withinTaskCompactionEnabled: false, supervisorEnabled: false, orchestrationEnabled: false, awarenessEnabled: false, goalEnabled: false, worktreeIsolated: false, teammateEnabled: false });
|
|
17
|
-
function sideQueryRoleBase(role, model, tools) {
|
|
18
|
-
const selectors = selectorsOf(NO_RUN_FACTS, { role }, undefined, effectiveTraitsOf(readModelPromptTraits(model), undefined));
|
|
17
|
+
function sideQueryRoleBase(role, model, tools, locale) {
|
|
18
|
+
const selectors = selectorsOf(NO_RUN_FACTS, { role }, undefined, effectiveTraitsOf(readModelPromptTraits(model), undefined), locale);
|
|
19
19
|
return runRenderer("role-base", { facts: NO_RUN_FACTS, toolNames: (tools ?? []).map((t) => t.name) }, selectors)?.text;
|
|
20
20
|
}
|
|
21
21
|
export async function runSideQuery(spec, deps) {
|
|
22
22
|
if (!Array.isArray(spec.messages) || spec.messages.length === 0) {
|
|
23
23
|
throw new Error("sideQuery requires a non-empty messages array");
|
|
24
24
|
}
|
|
25
|
+
const promptLocale = resolvePromptLocale(spec, "SideQuerySpec.promptLocale");
|
|
25
26
|
const resolved = resolveTaskModel({
|
|
26
27
|
...(spec.model !== undefined ? { model: spec.model } : {}),
|
|
27
28
|
...(spec.modelRole !== undefined ? { modelRole: spec.modelRole } : {}),
|
|
@@ -50,9 +51,10 @@ export async function runSideQuery(spec, deps) {
|
|
|
50
51
|
return { role: "user", content: m.content, timestamp };
|
|
51
52
|
};
|
|
52
53
|
const decided = roleBaseOf([spec.systemPrompt !== undefined ? { systemPrompt: spec.systemPrompt } : undefined, resolved]);
|
|
53
|
-
const effectiveSystemPrompt = decided?.systemPrompt ?? (decided?.promptRole !== undefined ? sideQueryRoleBase(decided.promptRole, resolved.model, spec.tools) : undefined);
|
|
54
|
+
const effectiveSystemPrompt = decided?.systemPrompt ?? (decided?.promptRole !== undefined ? sideQueryRoleBase(decided.promptRole, resolved.model, spec.tools, promptLocale) : undefined);
|
|
54
55
|
const context = {
|
|
55
56
|
...(effectiveSystemPrompt !== undefined ? { systemPrompt: effectiveSystemPrompt } : {}),
|
|
57
|
+
...(promptLocale !== undefined ? { promptLocale } : {}),
|
|
56
58
|
messages: ensureToolTurnInvariants(spec.messages.map(normalize)).messages,
|
|
57
59
|
...(spec.tools !== undefined && spec.tools.length > 0
|
|
58
60
|
? { tools: spec.tools.map((t) => ({ name: t.name, description: t.description, parameters: t.parameters })) }
|
|
@@ -67,7 +69,7 @@ export async function runSideQuery(spec, deps) {
|
|
|
67
69
|
...(auth?.apiKey !== undefined ? { apiKey: auth.apiKey } : {}),
|
|
68
70
|
...(auth?.headers !== undefined ? { headers: auth.headers } : {}),
|
|
69
71
|
};
|
|
70
|
-
const stream = await Promise.resolve(deps.
|
|
72
|
+
const stream = await Promise.resolve(modelLaneBrainOf(deps).stream(resolved.model, context, options));
|
|
71
73
|
const msg = (await stream.result());
|
|
72
74
|
const text = msg.content
|
|
73
75
|
.filter((c) => c.type === "text")
|
|
@@ -79,16 +81,17 @@ export async function runSideQuery(spec, deps) {
|
|
|
79
81
|
const wireId = providerToolCallId(c);
|
|
80
82
|
return { id: c.id, ...(wireId !== c.id ? { wireId } : {}), name: c.name, args: c.arguments };
|
|
81
83
|
});
|
|
82
|
-
const
|
|
84
|
+
const { reading, bills } = billsOf(resolved.model, msg);
|
|
85
|
+
const degraded = reading.degraded;
|
|
83
86
|
const servedModel = typeof msg.model === "string" && msg.model.length > 0 ? msg.model : resolved.model.id;
|
|
84
87
|
const reportedModel = providerReportedModel(msg);
|
|
85
88
|
const errorCode = extractErrorCode(msg.errorMessage);
|
|
86
|
-
const priced = priceReply(
|
|
89
|
+
const priced = bills.map((b) => priceReply(b.usage, b.model, deps.pricing));
|
|
87
90
|
const account = {
|
|
88
91
|
origin: "side_query",
|
|
89
|
-
tokens:
|
|
90
|
-
...(priced.priced ? { costMicroUsd: priced.costMicroUsd } : {}),
|
|
91
|
-
...(
|
|
92
|
+
tokens: bills.reduce((n, b) => n + (b.usage.totalTokens || 0), 0),
|
|
93
|
+
...(priced.every((p) => p.priced) ? { costMicroUsd: priced.reduce((n, p) => n + p.costMicroUsd, 0) } : {}),
|
|
94
|
+
...(bills.some((b) => b.usageMissing === true) ? { usageMissing: true } : {}),
|
|
92
95
|
};
|
|
93
96
|
return {
|
|
94
97
|
text,
|
|
@@ -97,7 +100,7 @@ export async function runSideQuery(spec, deps) {
|
|
|
97
100
|
servedModel,
|
|
98
101
|
...(degraded !== undefined ? { degraded } : {}),
|
|
99
102
|
...(reportedModel !== undefined ? { responseModel: reportedModel } : {}),
|
|
100
|
-
usage: normalizeSideQueryUsage(
|
|
103
|
+
usage: normalizeSideQueryUsage(reading.served, msg.usage),
|
|
101
104
|
...(msg.usageMissing === true ? { usageMissing: true } : {}),
|
|
102
105
|
account,
|
|
103
106
|
stopReason: msg.stopReason,
|
package/dist/core/skill-grant.js
CHANGED
|
@@ -8,6 +8,7 @@ import { readToolNameList } from "./tool-name-list.js";
|
|
|
8
8
|
import { deliverEngineNotice } from "./engine-notice.js";
|
|
9
9
|
import { retiredToolNameNotice } from "./retired-tool-name-account.js";
|
|
10
10
|
import { closestName } from "./closest-name.js";
|
|
11
|
+
import { codedRefusal } from "./thrown-value.js";
|
|
11
12
|
import { allowingRows, strippedInAuto, compileAllowList, isRetiredLeftOut, readRuleEntry, inertEntryPhrase, judgeAllowEntries, nonListValueLabel, renderListEntry, spelledListEntry } from "./allow-entry.js";
|
|
12
13
|
export const SKILL_GRANT_ORIGINS = Object.freeze(["model", "user", "inherited"]);
|
|
13
14
|
const FROZEN_SKILL_GRANT_ORIGINS = new Set(["model", "inherited"]);
|
|
@@ -316,7 +317,5 @@ function skillDenyUnreadable(skill, entries, site) {
|
|
|
316
317
|
const message = site === "activation"
|
|
317
318
|
? `Skill "${name}" was not activated: its disallowed-tools entr${one ? `y ${listed} reads` : `ies ${listed} read`} as nothing — a refusal this engine cannot read is not dropped, so the activation does not happen (its instructions are not loaded and nothing it lists is granted). Spell each entry as the tool is mounted, or remove it, in its definition.`
|
|
318
319
|
: `the grant rows carried for Skill "${name}" (a park's frozen rows, or a parent's capture) hold the disallowed-tools entr${one ? `y ${listed}, which reads` : `ies ${listed}, which read`} as nothing for this run — a refusal this engine cannot read is not dropped, so this leg does not start without it. A parked task an earlier release wrote can be finished on a worker of that release; otherwise correct the entry in its disallowed-tools and submit the task again.`;
|
|
319
|
-
|
|
320
|
-
e.code = SKILL_DENY_UNREADABLE_CODE;
|
|
321
|
-
return e;
|
|
320
|
+
return codedRefusal(SKILL_DENY_UNREADABLE_CODE, message);
|
|
322
321
|
}
|
|
@@ -5,7 +5,8 @@ import { physicalPathOf } from "./physical-path.js";
|
|
|
5
5
|
import { isPhysicallyWithin } from "../tools/fs/path-containment.js";
|
|
6
6
|
import { assertNoRetiredKeys } from "./retired-keys.js";
|
|
7
7
|
import { ruleSpellingOf } from "./permission-rule-syntax.js";
|
|
8
|
-
import {
|
|
8
|
+
import { EntryCutter, isBlank, notARule, SEQUENCE_NOT_A_NAME } from "./tool-list-grammar.js";
|
|
9
|
+
import { callerText } from "./caller-text.js";
|
|
9
10
|
import { thrownText } from "./thrown-value.js";
|
|
10
11
|
const SKILL_FILE = "SKILL.md";
|
|
11
12
|
const RESOURCE_DIRS = ["assets", "references", "scripts"];
|
|
@@ -20,7 +21,6 @@ const TOOL_LIST_KEYS = new Set([ALLOWED_TOOLS_KEY, DISALLOWED_TOOLS_KEY, DISALLO
|
|
|
20
21
|
const UNREAD_CONTINUATION = "it is followed by indented lines the frontmatter reader does not read";
|
|
21
22
|
const TEXT_AFTER_END = "text follows its closing quote or its closing `]` on the same line";
|
|
22
23
|
const SEQUENCE_NOT_AN_ENTRY = "its `- name` entries are not indented alike";
|
|
23
|
-
const SEQUENCE_NOT_A_NAME = "an entry is not a plain or quoted name (nested, mapping, anchor, tag, flow and block-scalar entries, and number, boolean and null entries, are not read)";
|
|
24
24
|
const VALUE_IS_A_MAPPING = "its value is a mapping or holds one (`key: value` or `{…}`), not a list of names";
|
|
25
25
|
const VALUE_NOT_A_STRING = "its value is a number or a boolean, not a list of names";
|
|
26
26
|
const YAML_ALIAS = 'it holds a YAML alias (an unquoted `*<name>`), which the reader does not resolve — quote a value or entry that is meant as a tool-name pattern ("*Edit")';
|
|
@@ -29,12 +29,9 @@ const QUOTE_NOT_CLOSED = "a quote in it does not close";
|
|
|
29
29
|
const flowNotClosed = (opener) => `its \`${opener}\` does not close within its lines`;
|
|
30
30
|
const strayLine = (line) => `a flush-left line that is no key follows it (line ${line})`;
|
|
31
31
|
const NOT_A_KEY_LINE = "a flush-left frontmatter line is a key — letters, digits, `_` and `-`, or one quoted scalar — then `:` and a blank or nothing; a comment starts with `#`";
|
|
32
|
-
const PARENS_NOT_ONE_ZONE = "an entry's parentheses are not one group that closes it (a `(` that does not close, a `)` with no `(`, or text after the closing `)` — `\\(` / `\\)` are a rule's own text)";
|
|
33
32
|
const KEY_REPEATED = "the key is written more than once";
|
|
34
|
-
const
|
|
35
|
-
const keyInsideValue = (inner) => `an indented line under its value is a mapping key, \`${inlineUntrusted(inner, 64)}\` — YAML reads no key there (under a value that is not a mapping, or indented less than the nested block it follows)`;
|
|
33
|
+
const keyInsideValue = (inner) => `an indented line under its value is a mapping key, ${callerText(inner)} — YAML reads no key there (under a value that is not a mapping, or indented less than the nested block it follows)`;
|
|
36
34
|
const toolListOutOfPlace = (inner) => `it holds the tool-list key \`${inner}\` — a tool list is read only as a key of the frontmatter, written flush left; anywhere else its list would be lost`;
|
|
37
|
-
const isBlank = (ch) => ch === " " || ch === "\t";
|
|
38
35
|
function leadingBlanks(text) {
|
|
39
36
|
let n = 0;
|
|
40
37
|
while (n < text.length && isBlank(text.charAt(n)))
|
|
@@ -354,66 +351,6 @@ function readBlockSequence(lines, start, end) {
|
|
|
354
351
|
}
|
|
355
352
|
const YAML_NULL = /^(?:null|Null|NULL|~)$/;
|
|
356
353
|
const YAML_BOOL_OR_NUMBER = /^(?:true|True|TRUE|false|False|FALSE|[-+]?[0-9]+|0o[0-7]+|0x[0-9a-fA-F]+|[-+]?(?:\.[0-9]+|[0-9]+(?:\.[0-9]*)?)(?:[eE][-+]?[0-9]+)?|[-+]?\.(?:inf|Inf|INF)|\.(?:nan|NaN|NAN))$/;
|
|
357
|
-
class EntryCutter {
|
|
358
|
-
entries = [];
|
|
359
|
-
problem;
|
|
360
|
-
depth = 0;
|
|
361
|
-
closed = false;
|
|
362
|
-
current = "";
|
|
363
|
-
blanks = "";
|
|
364
|
-
escaping = false;
|
|
365
|
-
push(ch) {
|
|
366
|
-
const escaped = this.escaping;
|
|
367
|
-
this.escaping = ch === "\\" && !escaped;
|
|
368
|
-
if (this.depth === 0 && (ch === "," || ch === " ")) {
|
|
369
|
-
this.cut();
|
|
370
|
-
return;
|
|
371
|
-
}
|
|
372
|
-
if (isBlank(ch)) {
|
|
373
|
-
if (this.current !== "")
|
|
374
|
-
this.blanks += ch;
|
|
375
|
-
return;
|
|
376
|
-
}
|
|
377
|
-
if (this.closed)
|
|
378
|
-
this.fail(PARENS_NOT_ONE_ZONE);
|
|
379
|
-
if (ch === "(" && !escaped)
|
|
380
|
-
this.depth++;
|
|
381
|
-
else if (ch === ")" && !escaped) {
|
|
382
|
-
if (this.depth === 0)
|
|
383
|
-
this.fail(PARENS_NOT_ONE_ZONE);
|
|
384
|
-
else
|
|
385
|
-
this.closed = --this.depth === 0;
|
|
386
|
-
}
|
|
387
|
-
this.current += this.blanks + ch;
|
|
388
|
-
this.blanks = "";
|
|
389
|
-
}
|
|
390
|
-
fold(breaks) {
|
|
391
|
-
this.blanks = "";
|
|
392
|
-
if (breaks === 1)
|
|
393
|
-
this.push(" ");
|
|
394
|
-
else
|
|
395
|
-
for (let n = 1; n < breaks; n++)
|
|
396
|
-
this.push("\n");
|
|
397
|
-
}
|
|
398
|
-
endScalar() {
|
|
399
|
-
if (this.depth > 0)
|
|
400
|
-
this.fail(PARENS_NOT_ONE_ZONE);
|
|
401
|
-
this.depth = 0;
|
|
402
|
-
this.escaping = false;
|
|
403
|
-
this.cut();
|
|
404
|
-
}
|
|
405
|
-
fail(why) {
|
|
406
|
-
this.problem ??= why;
|
|
407
|
-
}
|
|
408
|
-
cut() {
|
|
409
|
-
const entry = this.current;
|
|
410
|
-
this.current = "";
|
|
411
|
-
this.blanks = "";
|
|
412
|
-
this.closed = false;
|
|
413
|
-
if (entry !== "")
|
|
414
|
-
this.entries.push(entry);
|
|
415
|
-
}
|
|
416
|
-
}
|
|
417
354
|
function scanValue(text, seat) {
|
|
418
355
|
const cut = new EntryCutter();
|
|
419
356
|
let state = "start";
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** A leg's frame seat: the run binds its sink once, and observes after every step that may have moved what the frame reports. */
|
|
2
|
+
export interface SnapshotFrameSeat<S> {
|
|
3
|
+
/** Bind this leg's frame sink and send the leg-start snapshot through it. The first binding wins; a later one is ignored. */
|
|
4
|
+
subscribe(push: (snapshot: S) => void): void;
|
|
5
|
+
/** Re-project, and send iff the snapshot differs from the last one sent. Nothing is sent before the sink is bound. */
|
|
6
|
+
observe(): void;
|
|
7
|
+
}
|
|
8
|
+
export declare function createSnapshotFrameSeat<S>(project: () => S): SnapshotFrameSeat<S>;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { canonicalJsonStringify } from "./canonical-json.js";
|
|
2
|
+
export function createSnapshotFrameSeat(project) {
|
|
3
|
+
let push;
|
|
4
|
+
let lastSent;
|
|
5
|
+
const send = () => {
|
|
6
|
+
if (push === undefined)
|
|
7
|
+
return;
|
|
8
|
+
const snapshot = project();
|
|
9
|
+
const digest = canonicalJsonStringify(snapshot);
|
|
10
|
+
if (digest === lastSent)
|
|
11
|
+
return;
|
|
12
|
+
lastSent = digest;
|
|
13
|
+
push(snapshot);
|
|
14
|
+
};
|
|
15
|
+
return {
|
|
16
|
+
subscribe(sink) {
|
|
17
|
+
if (push !== undefined)
|
|
18
|
+
return;
|
|
19
|
+
push = sink;
|
|
20
|
+
send();
|
|
21
|
+
},
|
|
22
|
+
observe: send,
|
|
23
|
+
};
|
|
24
|
+
}
|
|
@@ -3,24 +3,40 @@
|
|
|
3
3
|
* steer under its key — the parked queue (`appendPendingSteer`) and the live verb's accepted-input domain — and that
|
|
4
4
|
* one answer feeds the replay decision, the refusal's machine-readable `detail.differs` and its sentence.
|
|
5
5
|
*
|
|
6
|
-
* Both seats compare the record the CALLER sent (text, trusted, tier, actor, run origin) — never the delivered bytes: the live
|
|
6
|
+
* Both seats compare the record the CALLER sent (text, trusted, tier, actor, run origin, source) — never the delivered bytes: the live
|
|
7
7
|
* delivery folds `trusted` (the framing) and the actor (the speaker label) into its payload, so comparing payloads
|
|
8
8
|
* would report one changed facet as two.
|
|
9
9
|
*/
|
|
10
10
|
import type { ActorAssertion } from "../internal/llm.js";
|
|
11
11
|
import { type SystemInjectionPriority } from "./task-notification.js";
|
|
12
12
|
import type { RunOrigin } from "./run-origin.js";
|
|
13
|
+
import type { HumanInputSource } from "./task-event.js";
|
|
13
14
|
/** The facets a steer's replay identity is made of, in the order a refusal lists them. Closed. */
|
|
14
|
-
export declare const STEER_REPLAY_FACETS: readonly ["text", "trusted", "priority", "actor", "runOrigin"];
|
|
15
|
+
export declare const STEER_REPLAY_FACETS: readonly ["text", "trusted", "priority", "actor", "runOrigin", "source"];
|
|
15
16
|
export type SteerReplayFacet = (typeof STEER_REPLAY_FACETS)[number];
|
|
17
|
+
/** Who a steer's sender says wrote it: `"steer"` — a person's words — or `"system"` — text its sender produced itself (a
|
|
18
|
+
* shell's own plan outcome, a wake notice), which no face reads as a person's speech. Two of {@link HumanInputSource}'s own
|
|
19
|
+
* words; the steer verb's option ({@link import("./task-stream.js").TaskStream.steer}, `steer.source`) is this domain. */
|
|
20
|
+
export type SteerSource = Extract<HumanInputSource, "steer" | "system">;
|
|
21
|
+
/** The ONE reading of a steer's source: absent reads as `"steer"` (the default every caller had before the option). */
|
|
22
|
+
export declare function steerSourceOf(x: {
|
|
23
|
+
readonly source?: SteerSource;
|
|
24
|
+
}): SteerSource;
|
|
25
|
+
/** The source an input reports on every face that names one — its delivered frame, its `human_input` frame, its screen's
|
|
26
|
+
* `e.source`: `"system"` when its sender said so, else the name of the carrier or entrance it arrived on. */
|
|
27
|
+
export declare function inputSourceOf<C extends string>(x: {
|
|
28
|
+
readonly source?: SteerSource;
|
|
29
|
+
}, carrier: C): C | "system";
|
|
16
30
|
/** What a seat remembers a steer by: the caller's own statement, as validated. The parked entry and the live park
|
|
17
|
-
* record both are this shape. An absent `priority` reads as `"next"` ({@link steerPriorityOf})
|
|
31
|
+
* record both are this shape. An absent `priority` reads as `"next"` ({@link steerPriorityOf}), an absent `source` as
|
|
32
|
+
* `"steer"` ({@link steerSourceOf}). */
|
|
18
33
|
export interface SteerReplayRecord {
|
|
19
34
|
readonly text: string;
|
|
20
35
|
readonly trusted: boolean;
|
|
21
36
|
readonly priority?: SystemInjectionPriority;
|
|
22
37
|
readonly actor?: ActorAssertion;
|
|
23
38
|
readonly runOrigin?: RunOrigin;
|
|
39
|
+
readonly source?: SteerSource;
|
|
24
40
|
}
|
|
25
41
|
/** The facets `repeat` differs from `held` in, in {@link STEER_REPLAY_FACETS} order. Empty = the idempotent replay. */
|
|
26
42
|
export declare function steerReplayDiffers(held: SteerReplayRecord, repeat: SteerReplayRecord): SteerReplayFacet[];
|
|
@@ -1,11 +1,18 @@
|
|
|
1
1
|
import { steerPriorityOf } from "./task-notification.js";
|
|
2
|
-
export const STEER_REPLAY_FACETS = Object.freeze(["text", "trusted", "priority", "actor", "runOrigin"]);
|
|
2
|
+
export const STEER_REPLAY_FACETS = Object.freeze(["text", "trusted", "priority", "actor", "runOrigin", "source"]);
|
|
3
|
+
export function steerSourceOf(x) {
|
|
4
|
+
return x.source === "system" ? "system" : "steer";
|
|
5
|
+
}
|
|
6
|
+
export function inputSourceOf(x, carrier) {
|
|
7
|
+
return steerSourceOf(x) === "system" ? "system" : carrier;
|
|
8
|
+
}
|
|
3
9
|
const FACET_IS_SAME = {
|
|
4
10
|
text: (a, b) => a.text === b.text,
|
|
5
11
|
trusted: (a, b) => a.trusted === b.trusted,
|
|
6
12
|
priority: (a, b) => steerPriorityOf(a) === steerPriorityOf(b),
|
|
7
13
|
actor: (a, b) => a.actor?.id === b.actor?.id && a.actor?.hostAsserted === b.actor?.hostAsserted && a.actor?.issuer === b.actor?.issuer,
|
|
8
14
|
runOrigin: (a, b) => a.runOrigin === b.runOrigin,
|
|
15
|
+
source: (a, b) => steerSourceOf(a) === steerSourceOf(b),
|
|
9
16
|
};
|
|
10
17
|
export function steerReplayDiffers(held, repeat) {
|
|
11
18
|
return STEER_REPLAY_FACETS.filter((facet) => !FACET_IS_SAME[facet](held, repeat));
|
|
@@ -25,9 +25,24 @@ import { type ContractAssertionRunner } from "./contract-harness.js";
|
|
|
25
25
|
/** 契约统一用的租户 scope(核心层的多租户用例会另外显式构造第二个)。 */
|
|
26
26
|
export declare const BACKGROUND_AGENT_CONTRACT_SCOPE = "tenant-A";
|
|
27
27
|
/**
|
|
28
|
-
*
|
|
28
|
+
* The damaged-row clause's hooks (additive): `plantRow` leaves a row as a foreign writer (or an earlier engine) would — `raw`
|
|
29
|
+
* stored under (handle, scope), past every write gate — and answers the store to read it from (a file backend reopens its
|
|
30
|
+
* directory, since its replay is where a stored row is read). A backend with no bytes a foreign writer could damage declares
|
|
31
|
+
* `unplantable` with the reason instead. Passing neither in a hooks object is refused.
|
|
29
32
|
*/
|
|
30
|
-
export
|
|
33
|
+
export interface BackgroundAgentStoreContractHooks {
|
|
34
|
+
readonly plantRow?: (store: BackgroundAgentStore, key: {
|
|
35
|
+
readonly handle: string;
|
|
36
|
+
readonly scope: string;
|
|
37
|
+
}, raw: unknown) => Promise<BackgroundAgentStore>;
|
|
38
|
+
readonly unplantable?: string;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* 核心不变量层 —— 每个 {@link BackgroundAgentStore} 后端都必须过。With `hooks.plantRow`, also the damaged-row clause: a row whose
|
|
42
|
+
* members do not read is listed as its handle and verdict, `get` / `update` refuse it in {@link BACKGROUND_AGENT_ROW_MALFORMED_CODE}
|
|
43
|
+
* without handing back anything planted, a sweep leaves it, and deletion by its handle goes on.
|
|
44
|
+
*/
|
|
45
|
+
export declare function backgroundAgentStoreContract(mk: () => BackgroundAgentStore, runAssertion?: ContractAssertionRunner, hooks?: BackgroundAgentStoreContractHooks): Promise<void>;
|
|
31
46
|
/**
|
|
32
47
|
* 可选能力层 —— 只挂实现了 {@link BackgroundAgentStore.listScopes} 的后端。接口把该方法标为可选
|
|
33
48
|
* (一个把租户清单记在别处的部署可以省略它),所以它不能进核心层:核心层里的「没实现就跳过」等于
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import { strict as assert } from "node:assert";
|
|
2
|
-
import { STALE_RUNNING_REAP_ATTRIBUTION, } from "../background-agent-store.js";
|
|
2
|
+
import { BACKGROUND_AGENT_ROW_MALFORMED_CODE, STALE_RUNNING_REAP_ATTRIBUTION, } from "../background-agent-store.js";
|
|
3
3
|
import { CLAMP_SEATS, CLAMP_SET } from "../child-clamp-seats.js";
|
|
4
4
|
import { beginContract } from "./contract-harness.js";
|
|
5
|
+
import { thrownText } from "../thrown-value.js";
|
|
6
|
+
const readRows = (rows) => rows.filter((r) => !("rowVerdict" in r));
|
|
5
7
|
export const BACKGROUND_AGENT_CONTRACT_SCOPE = "tenant-A";
|
|
6
8
|
function record(over = {}) {
|
|
7
9
|
return {
|
|
@@ -39,7 +41,11 @@ async function held(store, handle, scope = BACKGROUND_AGENT_CONTRACT_SCOPE) {
|
|
|
39
41
|
assert.notEqual(row, null, `row ${handle} should exist in scope ${scope}`);
|
|
40
42
|
return row;
|
|
41
43
|
}
|
|
42
|
-
|
|
44
|
+
const codeOf = (e) => (typeof e === "object" && e !== null ? Reflect.get(e, "code") : undefined);
|
|
45
|
+
export async function backgroundAgentStoreContract(mk, runAssertion, hooks) {
|
|
46
|
+
if (hooks !== undefined && hooks.plantRow === undefined && (hooks.unplantable === undefined || hooks.unplantable.trim() === "")) {
|
|
47
|
+
throw new TypeError("backgroundAgentStoreContract: pass plantRow, or declare unplantable with the reason this backend keeps no bytes a foreign writer could damage");
|
|
48
|
+
}
|
|
43
49
|
const { run: runRaw, settle } = beginContract(runAssertion);
|
|
44
50
|
const run = (name, fn) => runRaw(name, () => withStores(mk, fn));
|
|
45
51
|
const S = BACKGROUND_AGENT_CONTRACT_SCOPE;
|
|
@@ -112,6 +118,16 @@ export async function backgroundAgentStoreContract(mk, runAssertion) {
|
|
|
112
118
|
assert.equal(await store.update("a1", S, after, { rev: withOccupant.rev }), true);
|
|
113
119
|
assert.equal((await held(store, "a1")).rootSessionIncarnation, "occ-root-1", "a CAS update must carry the root occupant it did not change");
|
|
114
120
|
});
|
|
121
|
+
run("the root anchor's box scope round-trips beside the anchor — ABSENT stays absent, a CAS carries it", async (make) => {
|
|
122
|
+
const store = make();
|
|
123
|
+
await store.put(record({ handle: "a1", rootSessionId: "sess-root", rootSessionIncarnation: "occ-root-1", rootSessionScope: "box-scope" }));
|
|
124
|
+
const withScope = await held(store, "a1");
|
|
125
|
+
assert.equal(withScope.rootSessionScope, "box-scope");
|
|
126
|
+
await store.put(record({ handle: "a2", rootSessionId: "sess-root" }));
|
|
127
|
+
assert.equal((await held(store, "a2")).rootSessionScope, undefined, "a row that records no box scope must not read back with one");
|
|
128
|
+
assert.equal(await store.update("a1", S, { ...withScope, status: "completed", settledAt: 2_000 }, { rev: withScope.rev }), true);
|
|
129
|
+
assert.equal((await held(store, "a1")).rootSessionScope, "box-scope", "a CAS update must carry the box scope it did not change");
|
|
130
|
+
});
|
|
115
131
|
run("put refuses a scopeless row (a row with no tenant partition would be world-readable)", async (make) => {
|
|
116
132
|
const store = make();
|
|
117
133
|
await assert.rejects(store.put(record({ scope: "" })), "an empty scope must be refused loudly, not stored");
|
|
@@ -193,6 +209,19 @@ export async function backgroundAgentStoreContract(mk, runAssertion) {
|
|
|
193
209
|
assert.deepEqual(await store.listBySession("tenant-B", "sess-1"), [], "another tenant sees nothing");
|
|
194
210
|
assert.deepEqual((await store.listBySession(S, "sess-mid")).map((r) => r.handle), ["a3"], "the intermediate anchor still lists its direct child");
|
|
195
211
|
});
|
|
212
|
+
run("a list summary carries the record's completion identity verbatim — identity, not content; ABSENT stays absent", async (make) => {
|
|
213
|
+
const store = make();
|
|
214
|
+
await store.put(record({ handle: "a1", status: "completed", settledAt: 2_000, completionId: "cid-a1" }));
|
|
215
|
+
await store.put(record({ handle: "a2", status: "running", spawnedAt: 2_000 }));
|
|
216
|
+
for (const rows of [await store.listBySession(S, "sess-1"), await store.listByScope(S)]) {
|
|
217
|
+
const settled = rows.find((r) => r.handle === "a1");
|
|
218
|
+
const running = rows.find((r) => r.handle === "a2");
|
|
219
|
+
assert.notEqual(settled, undefined);
|
|
220
|
+
assert.notEqual(running, undefined);
|
|
221
|
+
assert.equal("rowVerdict" in settled ? undefined : settled.completionId, "cid-a1", "the summary must carry the record's completion identity unchanged");
|
|
222
|
+
assert.equal(Object.hasOwn(running, "completionId"), false, "a row that records no completion identity must not list with one");
|
|
223
|
+
}
|
|
224
|
+
});
|
|
196
225
|
run("listBySession/listByScope filter one status; listByScope enumerates the whole tenant", async (make) => {
|
|
197
226
|
const store = make();
|
|
198
227
|
await store.put(record({ handle: "a1", status: "running", spawnedAt: 1_000 }));
|
|
@@ -205,6 +234,54 @@ export async function backgroundAgentStoreContract(mk, runAssertion) {
|
|
|
205
234
|
assert.deepEqual((await store.listBySession(S, "sess-1", { status: "completed" })).map((r) => r.handle), ["a2"]);
|
|
206
235
|
assert.deepEqual((await store.listByScope("tenant-B")).map((r) => r.handle), ["a4"], "tenants are separate ledgers");
|
|
207
236
|
});
|
|
237
|
+
run("every list summary carries the scope its row lives in", async (make) => {
|
|
238
|
+
const store = make();
|
|
239
|
+
await store.put(record({ handle: "a1" }));
|
|
240
|
+
await store.put(record({ handle: "a2", scope: "tenant-B" }));
|
|
241
|
+
assert.deepEqual(readRows(await store.listByScope(S)).map((r) => [r.handle, r.scope]), [["a1", S]]);
|
|
242
|
+
assert.deepEqual(readRows(await store.listBySession("tenant-B", "sess-1")).map((r) => [r.handle, r.scope]), [["a2", "tenant-B"]]);
|
|
243
|
+
assert.deepEqual(readRows(await store.listByRoot("sess-1")).map((r) => [r.handle, r.scope]).sort(), [["a1", S], ["a2", "tenant-B"]]);
|
|
244
|
+
});
|
|
245
|
+
run("listByRoot lists one delegation tree in EVERY scope by its root (rootSessionId ?? parentSessionId ?? session-scoped owner), newest-first", async (make) => {
|
|
246
|
+
const store = make();
|
|
247
|
+
await store.put(record({ handle: "a1", rootSessionId: "sess-1", spawnedAt: 1_000, finalOutput: "SECRET", summary: "s", error: "e", recentSteps: [] }));
|
|
248
|
+
await store.put(record({ handle: "a2", scope: "tenant-B", owner: "sess-1", sessionScoped: true, parentSessionId: undefined, spawnedAt: 2_000 }));
|
|
249
|
+
await store.put(record({ handle: "a3", parentSessionId: "sess-mid", rootSessionId: "sess-1", spawnedAt: 3_000 }));
|
|
250
|
+
await store.put(record({ handle: "a4", spawnedAt: 4_000 }));
|
|
251
|
+
await store.put(record({ handle: "a5", rootSessionId: "sess-other", spawnedAt: 5_000 }));
|
|
252
|
+
await store.put(record({ handle: "a6", parentSessionId: "sess-other", spawnedAt: 6_000 }));
|
|
253
|
+
await store.put(record({ handle: "a7", owner: "sess-1", parentSessionId: undefined, spawnedAt: 7_000 }));
|
|
254
|
+
const rows = readRows(await store.listByRoot("sess-1"));
|
|
255
|
+
assert.deepEqual(rows.map((r) => [r.handle, r.scope]), [["a4", S], ["a3", S], ["a2", "tenant-B"], ["a1", S]], "the whole tree, every scope, newest-first");
|
|
256
|
+
for (const row of rows) {
|
|
257
|
+
for (const field of ["finalOutput", "summary", "error", "recentSteps", "editedFiles"]) {
|
|
258
|
+
assert.equal(Object.hasOwn(row, field), false, `list projections must not carry ${field}`);
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
assert.deepEqual((await store.listByRoot("sess-1", { limit: 2 })).map((r) => r.handle), ["a4", "a3"], "limit keeps the NEWEST n");
|
|
262
|
+
assert.deepEqual(await store.listByRoot("sess-mid"), [], "an intermediate session is not a tree root: its child's root is sess-1");
|
|
263
|
+
assert.deepEqual((await store.listByRoot("sess-other")).map((r) => r.handle), ["a6", "a5"]);
|
|
264
|
+
for (const row of rows)
|
|
265
|
+
assert.equal(await store.delete(row.handle, row.scope), true, `${row.handle} is deleted in ${row.scope}`);
|
|
266
|
+
assert.deepEqual(await store.listByRoot("sess-1"), []);
|
|
267
|
+
});
|
|
268
|
+
run("listByRoot filters one status like the other lists", async (make) => {
|
|
269
|
+
const store = make();
|
|
270
|
+
await store.put(record({ handle: "a1", status: "running", spawnedAt: 1_000 }));
|
|
271
|
+
await store.put(record({ handle: "a2", status: "completed", scope: "tenant-B", spawnedAt: 2_000 }));
|
|
272
|
+
await store.put(record({ handle: "a3", status: "completed", spawnedAt: 3_000 }));
|
|
273
|
+
assert.deepEqual((await store.listByRoot("sess-1", { status: "completed" })).map((r) => r.handle), ["a3", "a2"]);
|
|
274
|
+
assert.deepEqual((await store.listByRoot("sess-1", { status: "completed", limit: 1 })).map((r) => r.handle), ["a3"]);
|
|
275
|
+
});
|
|
276
|
+
run("listByRoot refuses a root that is not a non-empty string of at most 256 characters without a control character", async (make) => {
|
|
277
|
+
const store = make();
|
|
278
|
+
await store.put(record({ handle: "a1", rootSessionId: "r".repeat(256) }));
|
|
279
|
+
for (const bad of ["", "r".repeat(257), "sess\n1", "sess\u00001", "sess\u00851", 42, null, undefined, { id: "sess-1" }]) {
|
|
280
|
+
await assert.rejects(Promise.resolve().then(() => Reflect.apply(store.listByRoot, store, [bad])), (e) => e.code === "config.invalid_argument", `root ${typeof bad === "string" ? JSON.stringify(bad.length > 20 ? `${bad.slice(0, 8)}…(${bad.length})` : bad) : String(bad)} must be refused with config.invalid_argument`);
|
|
281
|
+
}
|
|
282
|
+
assert.deepEqual((await store.listByRoot("r".repeat(256))).map((r) => r.handle), ["a1"], "256 characters is a root");
|
|
283
|
+
assert.deepEqual(await store.listByRoot("sess.1:x/y"), [], "a root is not held to the peer lane's id alphabet");
|
|
284
|
+
});
|
|
208
285
|
run("delete is row-precise and CONDITIONAL when a rev is supplied (a concurrent revival must win)", async (make) => {
|
|
209
286
|
const store = make();
|
|
210
287
|
await store.put(record({ handle: "a1", status: "completed" }));
|
|
@@ -258,12 +335,64 @@ export async function backgroundAgentStoreContract(mk, runAssertion) {
|
|
|
258
335
|
assert.equal(await store.reap(S, 100_000, { staleRunningMaxAgeMs: 50_000 }), 0);
|
|
259
336
|
assert.equal((await held(store, "a3")).status, "running");
|
|
260
337
|
});
|
|
338
|
+
run("reap's stale-running flip gives each row its own completion identity, and the summary replays it", async (make) => {
|
|
339
|
+
const store = make();
|
|
340
|
+
await store.put(record({ handle: "a1", status: "running", updatedAt: 1_000 }));
|
|
341
|
+
await store.put(record({ handle: "a2", status: "running", updatedAt: 1_000, spawnedAt: 2_000 }));
|
|
342
|
+
assert.equal(await store.reap(S, 100_000, { staleRunningMaxAgeMs: 50_000 }), 2);
|
|
343
|
+
const first = await held(store, "a1");
|
|
344
|
+
const second = await held(store, "a2");
|
|
345
|
+
for (const row of [first, second]) {
|
|
346
|
+
assert.equal(typeof row.completionId, "string", `the flipped row ${row.handle} must carry a completion identity`);
|
|
347
|
+
assert.notEqual(row.completionId, "", `the flipped row ${row.handle} must carry a non-empty completion identity`);
|
|
348
|
+
}
|
|
349
|
+
assert.notEqual(first.completionId, second.completionId, "two completions, two identities");
|
|
350
|
+
const listed = await store.listByScope(S);
|
|
351
|
+
assert.equal(((a1) => (a1 === undefined || "rowVerdict" in a1 ? undefined : a1.completionId))(listed.find((r) => r.handle === "a1")), first.completionId, "the summary replays the flipped row's identity");
|
|
352
|
+
});
|
|
261
353
|
run("reap counts each ROW once even when the same sweep flips it AND removes it", async (make) => {
|
|
262
354
|
const store = make();
|
|
263
355
|
await store.put(record({ handle: "a1", status: "running", spawnedAt: 1_000, updatedAt: 1_000 }));
|
|
264
356
|
assert.equal(await store.reap(S, 100_000, { staleRunningMaxAgeMs: 50_000, keep: 0 }), 1, "one row changed, so the count is 1");
|
|
265
357
|
assert.equal(await store.get("a1", S), null, "and it really is gone (flipped, then trimmed)");
|
|
266
358
|
});
|
|
359
|
+
const plantRow = hooks?.plantRow;
|
|
360
|
+
if (plantRow !== undefined) {
|
|
361
|
+
const SENTINEL = "planted-marker-1023";
|
|
362
|
+
const BAD = "a0000000000000001";
|
|
363
|
+
const GOOD = "a0000000000000002";
|
|
364
|
+
const forged = (over) => ({ ...JSON.parse(JSON.stringify(record({ handle: BAD, agentType: SENTINEL }))), ...over });
|
|
365
|
+
const damaged = [
|
|
366
|
+
["owner retyped", { owner: 42 }],
|
|
367
|
+
["status outside the set", { status: "paused-later" }],
|
|
368
|
+
["rev not a count", { rev: "7" }],
|
|
369
|
+
["sessionScoped not a boolean", { sessionScoped: "yes" }],
|
|
370
|
+
];
|
|
371
|
+
for (const [what, over] of damaged) {
|
|
372
|
+
run(`damaged row (${what}): listed as its handle and verdict, the other row intact; get and update refuse in the family code quoting nothing planted; the stale sweep leaves it; delete by handle removes it`, async (make) => {
|
|
373
|
+
const seeded = make();
|
|
374
|
+
await seeded.put(record({ handle: GOOD, spawnedAt: 2_000 }));
|
|
375
|
+
const s = await plantRow(seeded, { handle: BAD, scope: S }, forged(over));
|
|
376
|
+
try {
|
|
377
|
+
const listed = await s.listByScope(S);
|
|
378
|
+
assert.deepEqual(listed.map((x) => x.handle), [GOOD, BAD]);
|
|
379
|
+
const bad = listed[1];
|
|
380
|
+
assert.ok("rowVerdict" in bad && bad.rowVerdict.code === BACKGROUND_AGENT_ROW_MALFORMED_CODE, "the planted row is listed as damaged");
|
|
381
|
+
assert.ok(!JSON.stringify(listed).includes(SENTINEL), "the listing carries no planted value");
|
|
382
|
+
const refused = (e) => codeOf(e) === BACKGROUND_AGENT_ROW_MALFORMED_CODE && !thrownText(e).includes(SENTINEL);
|
|
383
|
+
await assert.rejects(s.get(BAD, S), refused, "get refuses in the family code");
|
|
384
|
+
await assert.rejects(s.update(BAD, S, record({ handle: BAD, status: "completed" }), { rev: 0 }), refused, "update refuses in the family code");
|
|
385
|
+
await s.reap(S, 1e12, { staleRunningMaxAgeMs: 0 });
|
|
386
|
+
assert.equal((await s.listByScope(S)).filter((x) => "rowVerdict" in x).length, 1, "the stale sweep leaves it as stored");
|
|
387
|
+
assert.equal(await s.delete(BAD, S), true, "deletion by its handle goes on");
|
|
388
|
+
assert.deepEqual((await s.listByScope(S)).map((x) => x.handle), [GOOD]);
|
|
389
|
+
}
|
|
390
|
+
finally {
|
|
391
|
+
s.close?.();
|
|
392
|
+
}
|
|
393
|
+
});
|
|
394
|
+
}
|
|
395
|
+
}
|
|
267
396
|
await settle();
|
|
268
397
|
}
|
|
269
398
|
export async function backgroundAgentStoreScopesContract(mk, runAssertion) {
|
|
@@ -187,6 +187,45 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
|
|
|
187
187
|
assert.equal(await store.resolve(cp.token, cp.scope, ALLOW, { rev: 0 }), false);
|
|
188
188
|
assert.equal(await store.resolve(cp.token, cp.scope, ALLOW, { rev: 2 }), true);
|
|
189
189
|
});
|
|
190
|
+
run("reopen carries the generation a claim produced (`expect.rev`): only the claimer's generation is given back — a stale, a later or a wrong-scope expectation loses with the row untouched, a delayed reopen finds a newer claim's generation and loses, no expectation is as before", async () => {
|
|
191
|
+
const store = make();
|
|
192
|
+
const cp = createCheckpointFixture();
|
|
193
|
+
await store.put(cp.token, cp);
|
|
194
|
+
assert.equal(await store.resolve(cp.token, cp.scope, ALLOW, { rev: 0 }), true);
|
|
195
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed", { rev: 0 }), false, "the generation the claimer READ is not the one its claim produced");
|
|
196
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed", { rev: 2 }), false, "a generation the row has not reached");
|
|
197
|
+
assert.equal(await store.reopen(cp.token, "tenant-b", "env_failed", { rev: 1 }), false, "a wrong-scope reopen never wins, with the right generation too");
|
|
198
|
+
const untouched = (await store.get(cp.token));
|
|
199
|
+
assert.equal(untouched.status, "resolved", "a refused reopen leaves the row consumed");
|
|
200
|
+
assert.equal(untouched.rev, 1, "a refused reopen bumps nothing");
|
|
201
|
+
assert.equal(untouched.reopenReason, undefined, "a refused reopen records no reason");
|
|
202
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed", { rev: 1 }), true);
|
|
203
|
+
const reopened = (await store.get(cp.token));
|
|
204
|
+
assert.equal(reopened.status, "pending");
|
|
205
|
+
assert.equal(reopened.rev, 2);
|
|
206
|
+
assert.equal(reopened.reopenReason, "env_failed");
|
|
207
|
+
assert.equal(await store.resolve(cp.token, cp.scope, ALLOW, { rev: 2 }), true);
|
|
208
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed", { rev: 1 }), false, "a delayed reopen of an earlier claim finds a later generation");
|
|
209
|
+
const claimedByB = (await store.get(cp.token));
|
|
210
|
+
assert.equal(claimedByB.status, "resolved", "B's claim stays consumed");
|
|
211
|
+
assert.equal(claimedByB.rev, 3);
|
|
212
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed", { rev: 3 }), true, "B's own generation gives it back");
|
|
213
|
+
assert.equal((await store.get(cp.token)).rev, 4);
|
|
214
|
+
assert.equal(await store.resolve(cp.token, cp.scope, ALLOW, { rev: 4 }), true);
|
|
215
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed"), true);
|
|
216
|
+
assert.equal((await store.get(cp.token)).rev, 6);
|
|
217
|
+
});
|
|
218
|
+
run("reopen with the claimer's generation is still refused on a row that carries an execution record (the settled action wins over the generation)", async () => {
|
|
219
|
+
const store = make();
|
|
220
|
+
const cp = createCheckpointFixture();
|
|
221
|
+
await store.put(cp.token, cp);
|
|
222
|
+
assert.equal(await store.resolve(cp.token, cp.scope, ALLOW, { rev: 0 }), true);
|
|
223
|
+
assert.equal(await store.recordExecutionOutcome(cp.token, cp.scope, EXECUTED_ALLOW), "recorded");
|
|
224
|
+
assert.equal(await store.reopen(cp.token, cp.scope, "env_failed", { rev: 1 }), false);
|
|
225
|
+
const got = (await store.get(cp.token));
|
|
226
|
+
assert.equal(got.status, "resolved");
|
|
227
|
+
assert.equal(got.rev, 1, "a refused reopen bumps nothing");
|
|
228
|
+
});
|
|
190
229
|
run("setPendingSteer rejects a </system-reminder> variant BEFORE mutation (byte-identical error)", async () => {
|
|
191
230
|
const store = make();
|
|
192
231
|
const cp = createCheckpointFixture();
|
|
@@ -361,7 +400,7 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
|
|
|
361
400
|
const store = make();
|
|
362
401
|
const carried = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "id-carried" });
|
|
363
402
|
const group = {
|
|
364
|
-
capabilityId: "
|
|
403
|
+
capabilityId: "c3f1e7a2b94d5608",
|
|
365
404
|
contractId: "acme.write@2",
|
|
366
405
|
shapeDigest: "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
|
|
367
406
|
implementationRevision: "r7",
|
|
@@ -411,6 +450,29 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
|
|
|
411
450
|
assert.equal("previewWithheld" in byId.get("pw-absent"), false, "absent must project the key OMITTED, not null/empty");
|
|
412
451
|
assert.equal("previewWithheld" in byId.get("pw-bogus"), false, "an out-of-contract spelling must read as absent, never project verbatim");
|
|
413
452
|
});
|
|
453
|
+
run("existingTarget three shapes: each survives the row round-trip verbatim; absent stays absent; none is projected to the summary", async () => {
|
|
454
|
+
const store = make();
|
|
455
|
+
const shapes = [
|
|
456
|
+
{ kind: "text", text: "line one\nline two\n" },
|
|
457
|
+
{ kind: "absent" },
|
|
458
|
+
{ kind: "withheld", why: "read_refused" },
|
|
459
|
+
];
|
|
460
|
+
const rows = shapes.map((existingTarget, i) => {
|
|
461
|
+
const cp = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: `et-${i}` });
|
|
462
|
+
cp.pendingAction.existingTarget = existingTarget;
|
|
463
|
+
return cp;
|
|
464
|
+
});
|
|
465
|
+
const bare = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "et-bare" });
|
|
466
|
+
for (const cp of [...rows, bare])
|
|
467
|
+
await store.put(cp.token, cp);
|
|
468
|
+
for (const [i, cp] of rows.entries()) {
|
|
469
|
+
const back = (await store.get(cp.token)).pendingAction;
|
|
470
|
+
assert.deepEqual(back.existingTarget, shapes[i], "the row's existingTarget must survive the round-trip verbatim (dropped, a parked write's inbox card loses what its target holds)");
|
|
471
|
+
}
|
|
472
|
+
assert.equal("existingTarget" in (await store.get(bare.token)).pendingAction, false, "an absent existingTarget must stay OMITTED");
|
|
473
|
+
for (const s of await store.listByScope("tenant-a"))
|
|
474
|
+
assert.equal("existingTarget" in s, false, "the target's text is not a summary member");
|
|
475
|
+
});
|
|
414
476
|
run("#1079 mandated presence bit: a row's `true` survives + projects; absent stays absent; an out-of-contract `false` or string reads as absent", async () => {
|
|
415
477
|
const store = make();
|
|
416
478
|
const asserted = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "md-true" });
|
|
@@ -23,11 +23,24 @@ import { type ContractAssertionRunner } from "./contract-harness.js";
|
|
|
23
23
|
*/
|
|
24
24
|
/** 核心层统一用的 scope —— 每个后端都必须服务它(租户轴受限的后端只服务它)。 */
|
|
25
25
|
export declare const MAILBOX_CONTRACT_SCOPE = "default";
|
|
26
|
+
/**
|
|
27
|
+
* The damaged-record clause's hooks (additive): `plantRow` leaves the box (scope, handle) holding exactly `records` (each an
|
|
28
|
+
* `append` event's record, in seq order) as a foreign writer would — past the append gate — and answers the store to read it
|
|
29
|
+
* from (a file backend reopens its directory). A backend whose boxes hold nothing another writer could reach says why in
|
|
30
|
+
* `unplantable`; a hooks object with neither is refused.
|
|
31
|
+
*/
|
|
32
|
+
export interface MailboxStoreContractHooks {
|
|
33
|
+
readonly plantRow?: (store: MailboxStore, key: {
|
|
34
|
+
readonly scope: string;
|
|
35
|
+
readonly handle: string;
|
|
36
|
+
}, records: readonly unknown[]) => Promise<MailboxStore>;
|
|
37
|
+
readonly unplantable?: string;
|
|
38
|
+
}
|
|
26
39
|
/**
|
|
27
40
|
* T1 核心不变量层 —— 每个后端都跑。用例出处见每条内联注释(`src/core/mailbox-store.ts` 的接口
|
|
28
|
-
* 契约段是权威文本)。
|
|
41
|
+
* 契约段是权威文本)。With `hooks.plantRow`, also the damaged-record clause (the box's exit is `block`).
|
|
29
42
|
*/
|
|
30
|
-
export declare function mailboxStoreContract(mk: () => MailboxStore, runAssertion?: ContractAssertionRunner): Promise<void>;
|
|
43
|
+
export declare function mailboxStoreContract(mk: () => MailboxStore, runAssertion?: ContractAssertionRunner, hooks?: MailboxStoreContractHooks): Promise<void>;
|
|
31
44
|
/**
|
|
32
45
|
* T1 核心不变量层(MB1 分册)—— ack 的 owner 围栏,与 {@link mailboxStoreContract} 同层同权重,
|
|
33
46
|
* 单独成函数只是为了让 MB1 的出处叙述留在它自己的挂载文件里
|