@sema-agent/core 7.60.0 → 7.62.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 +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
import { SessionError, StreamingImportValidator, importRowCells, ownerCell, sessionLogMarkOf, uuidv7 } from "../internal/harness.js";
|
|
2
|
-
import { receiptRefusal,
|
|
2
|
+
import { optionKeys, receiptRefusal, receiveMembers } from "./own-property-receipt.js";
|
|
3
3
|
import { thrownText } from "./thrown-value.js";
|
|
4
4
|
const EXPORT_WORDS = { subject: "SessionLogExportOptions", unit: "member", moment: "at SessionLogTransfer.exportStream" };
|
|
5
5
|
const BEGIN_WORDS = { subject: "SessionLogTransfer.beginReplace options", unit: "member", moment: "at SessionLogTransfer.beginReplace" };
|
|
6
6
|
const COMMIT_WORDS = { subject: "SessionLogCommit", unit: "member", moment: "at SessionLogReplace.commit" };
|
|
7
|
+
const EXPORT_KEYS = optionKeys()({ afterSeq: 0, batchSize: 0 });
|
|
8
|
+
const BEGIN_KEYS = optionKeys()({ preserveActorAssertions: 0 });
|
|
9
|
+
const COMMIT_KEYS = optionKeys()({ owner: 0, decide: 0 });
|
|
7
10
|
async function logOrNull(seat, sessionId) {
|
|
8
11
|
return (await seat.readRow(sessionId))?.entries ?? null;
|
|
9
12
|
}
|
|
@@ -15,14 +18,10 @@ function committedHead(sessionId, answer) {
|
|
|
15
18
|
}
|
|
16
19
|
throw new SessionError("storage", `the repo's importEntries wrote session ${sessionId}'s log but answered no head (got ${answer === null ? "null" : typeof answer}) — a repo behind SessionStore.logTransfer answers the head its write committed; read the row again`);
|
|
17
20
|
}
|
|
18
|
-
function readRecord(raw, words,
|
|
21
|
+
function readRecord(raw, words, keys) {
|
|
19
22
|
if (typeof raw !== "object" || raw === null)
|
|
20
23
|
throw receiptRefusal(`${words.subject} must be an object, got ${raw === null ? "null" : typeof raw}`);
|
|
21
|
-
|
|
22
|
-
for (const name of Object.keys(got))
|
|
23
|
-
if (!names.includes(name))
|
|
24
|
-
throw receiptRefusal(`${words.subject} carries "${name}" — not a member this face reads`);
|
|
25
|
-
return got;
|
|
24
|
+
return receiveMembers(raw, words, keys, (_, [stray]) => receiptRefusal(`${words.subject} carries "${String(stray)}" — not a member this face reads`));
|
|
26
25
|
}
|
|
27
26
|
function isIntegerFrom(value, floor) {
|
|
28
27
|
return typeof value === "number" && Number.isSafeInteger(value) && value >= floor;
|
|
@@ -30,7 +29,7 @@ function isIntegerFrom(value, floor) {
|
|
|
30
29
|
function readExportOptions(raw) {
|
|
31
30
|
if (raw === undefined)
|
|
32
31
|
return { afterSeq: -1 };
|
|
33
|
-
const got = readRecord(raw, EXPORT_WORDS,
|
|
32
|
+
const got = readRecord(raw, EXPORT_WORDS, EXPORT_KEYS);
|
|
34
33
|
const afterSeq = got["afterSeq"];
|
|
35
34
|
if (afterSeq !== undefined && !isIntegerFrom(afterSeq, -1))
|
|
36
35
|
throw receiptRefusal("SessionLogExportOptions.afterSeq must be an integer ≥ -1 when present");
|
|
@@ -41,7 +40,7 @@ function readExportOptions(raw) {
|
|
|
41
40
|
function readBeginOptions(raw) {
|
|
42
41
|
if (raw === undefined)
|
|
43
42
|
return {};
|
|
44
|
-
const preserveActorAssertions = readRecord(raw, BEGIN_WORDS,
|
|
43
|
+
const preserveActorAssertions = readRecord(raw, BEGIN_WORDS, BEGIN_KEYS)["preserveActorAssertions"];
|
|
45
44
|
if (preserveActorAssertions === undefined)
|
|
46
45
|
return {};
|
|
47
46
|
if (typeof preserveActorAssertions !== "boolean")
|
|
@@ -49,7 +48,7 @@ function readBeginOptions(raw) {
|
|
|
49
48
|
return { preserveActorAssertions };
|
|
50
49
|
}
|
|
51
50
|
function readCommit(raw) {
|
|
52
|
-
const { owner, decide } = readRecord(raw, COMMIT_WORDS,
|
|
51
|
+
const { owner, decide } = readRecord(raw, COMMIT_WORDS, COMMIT_KEYS);
|
|
53
52
|
if (owner === undefined)
|
|
54
53
|
throw receiptRefusal("SessionLogCommit.owner must be a principal name or null (anonymous), got undefined");
|
|
55
54
|
try {
|
|
@@ -409,7 +409,7 @@ export declare class InMemorySessionPolicyStore implements SessionPolicyStore {
|
|
|
409
409
|
private readonly map;
|
|
410
410
|
/** {@link SessionPolicyStoreOptions.mountedToolNames}, read once at construction. */
|
|
411
411
|
private readonly mountedToolNames;
|
|
412
|
-
constructor(
|
|
412
|
+
constructor(options?: SessionPolicyStoreOptions);
|
|
413
413
|
/**
|
|
414
414
|
* The per-key mark {@link SessionPolicyStore.deleteBySession} may not erase: the largest `rev` this key has
|
|
415
415
|
* ever been stamped with, kept outside the row so removing the row cannot roll the counter back. Written by
|
|
@@ -8,6 +8,7 @@ import { NAME_RULE_FACES, noticeRuleText } from "./permission-rule-model.js";
|
|
|
8
8
|
import { parsePermissionRule, ruleSpellingOf } from "./permission-rule-syntax.js";
|
|
9
9
|
import { splitNamespacedName } from "./tool-name-aliases.js";
|
|
10
10
|
import { namesASetOfTools } from "./namespaced-rule-name.js";
|
|
11
|
+
import { optionKeys, receiveOptions } from "./own-property-receipt.js";
|
|
11
12
|
const SESSION_RULE_BUCKETS = { toolAllow: "allow", toolDeny: "deny", allowDirs: "dirs" };
|
|
12
13
|
const BUCKETS = Object.keys(SESSION_RULE_BUCKETS);
|
|
13
14
|
const ENTRY_FIELDS = BUCKETS.filter((f) => SESSION_RULE_BUCKETS[f] !== "dirs");
|
|
@@ -25,6 +26,7 @@ export class SessionPolicyError extends Error {
|
|
|
25
26
|
}
|
|
26
27
|
}
|
|
27
28
|
const NO_DECLARED_TOOLS = new Set();
|
|
29
|
+
const SESSION_POLICY_STORE_OPTION_KEYS = optionKeys()({ mountedToolNames: 0 });
|
|
28
30
|
export function readMountedToolNames(value) {
|
|
29
31
|
if (value === undefined)
|
|
30
32
|
return NO_DECLARED_TOOLS;
|
|
@@ -525,8 +527,9 @@ export function continuesLineage(a, b) {
|
|
|
525
527
|
export class InMemorySessionPolicyStore {
|
|
526
528
|
map = new Map();
|
|
527
529
|
mountedToolNames;
|
|
528
|
-
constructor(
|
|
529
|
-
|
|
530
|
+
constructor(options) {
|
|
531
|
+
const opts = receiveOptions(options, "InMemorySessionPolicyStore", SESSION_POLICY_STORE_OPTION_KEYS);
|
|
532
|
+
this.mountedToolNames = readMountedToolNames(opts.mountedToolNames);
|
|
530
533
|
}
|
|
531
534
|
highWater = new Map();
|
|
532
535
|
key(sessionId, principal) {
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { AgentMessage } from "../internal/harness-types.js";
|
|
1
|
+
import type { AgentMessage, RowAdmission } from "../internal/harness-types.js";
|
|
2
2
|
import type { ToolResultMessage } from "../internal/llm.js";
|
|
3
3
|
import type { Session } from "./session.js";
|
|
4
4
|
import type { ToolEffect } from "./types.js";
|
|
@@ -122,6 +122,7 @@ export declare const INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER = "[Request interru
|
|
|
122
122
|
*/
|
|
123
123
|
export declare function appendInterruptionMarker(session: Session, opts: {
|
|
124
124
|
toolUseInFlight: boolean;
|
|
125
|
+
admitRows?: RowAdmission;
|
|
125
126
|
}): Promise<string>;
|
|
126
127
|
/** One synthetic interrupted result: what a call with no recorded result is closed with. */
|
|
127
128
|
export interface InterruptedResult {
|
|
@@ -172,4 +173,4 @@ export declare function interruptedResultMessage(result: InterruptedResult, time
|
|
|
172
173
|
* never started: it is closed with a "never executed — safe to re-issue" result instead of the
|
|
173
174
|
* conservative unknown-outcome wording. When omitted, every orphan keeps the conservative texts.
|
|
174
175
|
*/
|
|
175
|
-
export declare function reconcileInterruptedSession(session: Session, toolEffects?: Map<string, ToolEffect>, suspendedBatch?: ReadonlySet<string>, startedToolCallIds?: ReadonlySet<string
|
|
176
|
+
export declare function reconcileInterruptedSession(session: Session, toolEffects?: Map<string, ToolEffect>, suspendedBatch?: ReadonlySet<string>, startedToolCallIds?: ReadonlySet<string>, admitRows?: RowAdmission): Promise<ReconcileReport>;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { appendAdmittedRow } from "./row-admission.js";
|
|
1
2
|
import { readMember } from "./thrown-value.js";
|
|
2
3
|
export const closeNeverExecuted = (errorKind) => errorKind === "interrupted_never_started";
|
|
3
4
|
const INTERRUPTED_UNKNOWN = "[INTERRUPTED] The previous run ended before this tool call's result was recorded. Its outcome " +
|
|
@@ -86,7 +87,7 @@ export function findOrphanToolCalls(messages, suspendedBatch) {
|
|
|
86
87
|
export const INTERRUPTED_BY_USER_MARKER = "[Request interrupted by user]";
|
|
87
88
|
export const INTERRUPTED_BY_USER_FOR_TOOL_USE_MARKER = "[Request interrupted by user for tool use]";
|
|
88
89
|
export async function appendInterruptionMarker(session, opts) {
|
|
89
|
-
return await session
|
|
90
|
+
return await appendAdmittedRow(opts.admitRows, session, {
|
|
90
91
|
role: "user",
|
|
91
92
|
content: [
|
|
92
93
|
{
|
|
@@ -145,14 +146,16 @@ function closableByAppend(messages, suspendedBatch) {
|
|
|
145
146
|
.sort((a, b) => a[1].order - b[1].order)
|
|
146
147
|
.map(([toolCallId, site]) => ({ toolCallId, toolName: site.toolName, args: site.args }));
|
|
147
148
|
}
|
|
148
|
-
export async function reconcileInterruptedSession(session, toolEffects, suspendedBatch, startedToolCallIds) {
|
|
149
|
+
export async function reconcileInterruptedSession(session, toolEffects, suspendedBatch, startedToolCallIds, admitRows) {
|
|
149
150
|
const { messages } = await session.buildContext();
|
|
150
151
|
const orphans = closableByAppend(messages, suspendedBatch);
|
|
151
152
|
const recovered = [];
|
|
152
153
|
const results = interruptedResults(orphans, toolEffects, startedToolCallIds);
|
|
153
154
|
for (const [i, result] of results.entries()) {
|
|
154
|
-
const
|
|
155
|
-
|
|
155
|
+
const row = interruptedResultMessage(result, Date.now());
|
|
156
|
+
const entryId = await appendAdmittedRow(admitRows, session, row);
|
|
157
|
+
const text = row.content.flatMap((b) => (b.type === "text" ? [b.text] : [])).join("\n");
|
|
158
|
+
recovered.push({ toolCallId: result.toolCallId, toolName: result.toolName, entryId, text, errorKind: result.errorKind, args: orphans[i].args });
|
|
156
159
|
}
|
|
157
160
|
return { recovered };
|
|
158
161
|
}
|
|
@@ -96,6 +96,8 @@ export declare function admitSessionPlacement(sessionId: string, persisted: Sess
|
|
|
96
96
|
}, capability: {
|
|
97
97
|
subagentPlacement: boolean;
|
|
98
98
|
}): void;
|
|
99
|
+
/** The hooks {@link TtlSessionStore} runs — a member of `hooks` outside it is refused by name. */
|
|
100
|
+
export declare const STORE_HOOK_KEYS: import("./own-property-receipt.js").OptionKeys<SessionStoreHooks>;
|
|
99
101
|
/**
|
|
100
102
|
* TTL-cached {@link SessionStore} over a pluggable {@link SessionRepo}.
|
|
101
103
|
*
|
|
@@ -338,6 +340,6 @@ export declare class TtlSessionStore implements SessionStore {
|
|
|
338
340
|
* Exported at the package root: the bundled store's `fork` and any other store's `fork` are the same question and must give the same
|
|
339
341
|
* answer — a backend reads the source session (`SessionRepo.open`), asks this, and hands the answer to `SessionRepo.fork` with the id
|
|
340
342
|
* and owner it mints. Forking the whole log instead copies the in-flight turn. The walk is one of the parent-chain walks, so it takes the
|
|
341
|
-
* shared guard: a leaf on a loop of tool-result messages is refused `
|
|
343
|
+
* shared guard: a leaf on a loop of tool-result messages is refused `corrupt_session` (the sentence of `getPathToRoot`) instead of followed.
|
|
342
344
|
*/
|
|
343
345
|
export declare function settledForkOptions(source: Session): Promise<ForkPoint>;
|
|
@@ -3,7 +3,7 @@ import { isSessionConflict, readSessionListQuery } from "./session.js";
|
|
|
3
3
|
import { readRetentionDeclaration } from "./retention.js";
|
|
4
4
|
import { readMember } from "./thrown-value.js";
|
|
5
5
|
import { principalNameFault, principalNameOf } from "./principal-name.js";
|
|
6
|
-
import { DECLARATION_RECEIPT_MODE, receiptRefusal,
|
|
6
|
+
import { DECLARATION_RECEIPT_MODE, optionKeys, receiptRefusal, receiveMembers, receiveOptions } from "./own-property-receipt.js";
|
|
7
7
|
import { describeFault, receive } from "./mods/kernel/receive.js";
|
|
8
8
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
9
9
|
import { readIntegerOption, TIMER_DELAY_MS } from "./integer-option.js";
|
|
@@ -25,6 +25,12 @@ export function admitSessionPlacement(sessionId, persisted, request, capability)
|
|
|
25
25
|
}
|
|
26
26
|
}
|
|
27
27
|
}
|
|
28
|
+
function placedRowCells(placement) {
|
|
29
|
+
const { owner, ...tuple } = placement;
|
|
30
|
+
return { placement: tuple, owner };
|
|
31
|
+
}
|
|
32
|
+
const TTL_SESSION_STORE_OPTION_KEYS = optionKeys()({ defaultTtlDays: 0, sweepIntervalMs: 0, repo: 0, evict: 0, durability: 0, placements: 0, retention: 0, hooks: 0 });
|
|
33
|
+
export const STORE_HOOK_KEYS = optionKeys()({ beforeSessionDelete: 0 });
|
|
28
34
|
export class TtlSessionStore {
|
|
29
35
|
retention;
|
|
30
36
|
durability;
|
|
@@ -47,7 +53,7 @@ export class TtlSessionStore {
|
|
|
47
53
|
evictPolicy;
|
|
48
54
|
sweepTimer;
|
|
49
55
|
constructor(options) {
|
|
50
|
-
const opts = receiveOptions(options, "TtlSessionStore");
|
|
56
|
+
const opts = receiveOptions(options, "TtlSessionStore", TTL_SESSION_STORE_OPTION_KEYS);
|
|
51
57
|
this.retention = readRetentionDeclaration("TtlSessionStoreOptions.retention", opts.retention);
|
|
52
58
|
const givenRepo = opts.repo;
|
|
53
59
|
this.repo = givenRepo ?? new InMemorySessionRepo();
|
|
@@ -195,7 +201,7 @@ export class TtlSessionStore {
|
|
|
195
201
|
async createAndStore(id, placement) {
|
|
196
202
|
let session;
|
|
197
203
|
try {
|
|
198
|
-
session = await this.repo.create({ ...(id !== undefined ? { id } : {}), ...(placement !== undefined ?
|
|
204
|
+
session = await this.repo.create({ ...(id !== undefined ? { id } : {}), ...(placement !== undefined ? placedRowCells(placement) : {}) });
|
|
199
205
|
}
|
|
200
206
|
catch (err) {
|
|
201
207
|
if (id === undefined || !isSessionConflict(err))
|
|
@@ -535,11 +541,7 @@ function readStoreHooks(hooks) {
|
|
|
535
541
|
return undefined;
|
|
536
542
|
if (typeof hooks !== "object" || hooks === null)
|
|
537
543
|
throw receiptRefusal(`TtlSessionStoreOptions.hooks must be an object when given, got ${hooks === null ? "null" : typeof hooks}`);
|
|
538
|
-
const got =
|
|
539
|
-
for (const name of Object.keys(got)) {
|
|
540
|
-
if (name !== "beforeSessionDelete")
|
|
541
|
-
throw receiptRefusal(`TtlSessionStoreOptions.hooks.${name} is not a hook this store runs (it runs beforeSessionDelete)`);
|
|
542
|
-
}
|
|
544
|
+
const got = receiveMembers(hooks, { subject: "TtlSessionStoreOptions.hooks", unit: "hook", moment: "at construction" }, STORE_HOOK_KEYS);
|
|
543
545
|
const hook = got["beforeSessionDelete"];
|
|
544
546
|
if (hook !== undefined && typeof hook !== "function")
|
|
545
547
|
throw receiptRefusal(`TtlSessionStoreOptions.hooks.beforeSessionDelete must be a function when given, got ${hook === null ? "null" : typeof hook}`);
|
package/dist/core/session.d.ts
CHANGED
|
@@ -33,6 +33,10 @@ export interface SessionPlacement {
|
|
|
33
33
|
rootSessionId?: string;
|
|
34
34
|
/** The durable agent row key (`a…`) — the store-side join key for orphan GC. */
|
|
35
35
|
handle?: string;
|
|
36
|
+
/** The delegation tree's owner: the owner of the tree root's row as the root run read it, carried unchanged to every descendant
|
|
37
|
+
* (`null` = the root is anonymous). The placing write records exactly it in the row's owner cell — never in the tuple
|
|
38
|
+
* ({@link SessionPlacementRecord} has no owner); a re-open ignores it (first-write immutable). */
|
|
39
|
+
owner: string | null;
|
|
36
40
|
}
|
|
37
41
|
/**
|
|
38
42
|
* One row of {@link SessionStore.listPlaced}. The row-store join key is the FULL `(scope, handle)`
|
|
@@ -83,7 +87,8 @@ export interface SessionStoreSummary {
|
|
|
83
87
|
/**
|
|
84
88
|
* An ENGINE-minted run identity for this session ({@link import("./types.js").TaskResult.runId}),
|
|
85
89
|
* recorded by the most recent {@link SessionStore.noteTaskRun} write to LAND.
|
|
86
|
-
* {@link lastTaskId} above is
|
|
90
|
+
* {@link lastTaskId} above is the leg's task id (a background row's id, else the declared one, else the
|
|
91
|
+
* session id), so on the ordinary deployment that supplies no
|
|
87
92
|
* host task id it answers the SESSION's own id: a "last run" handle that names the session it hangs off
|
|
88
93
|
* cannot say WHICH run it means. This one names a specific run — read the ORDERING clause below for
|
|
89
94
|
* exactly how strong "most recent" is here, which is weaker than the sibling field's wording implies.
|
|
@@ -206,7 +211,10 @@ export interface SessionStore<S extends SessionStoreSummary = SessionStoreSummar
|
|
|
206
211
|
* placement argument) returns the same session and never rewrites the tuple;
|
|
207
212
|
* 6. a placed id cannot be CLAIMED: a later claim-form acquire (no `requireExisting`, no
|
|
208
213
|
* creation placement) of an existing placed id refuses loudly
|
|
209
|
-
* (`SessionError("placement_refused")`) instead of attaching
|
|
214
|
+
* (`SessionError("placement_refused")`) instead of attaching;
|
|
215
|
+
* 7. the placing write records exactly `placement.owner` in the row's owner cell (no owner of its own derived), and the store
|
|
216
|
+
* answers {@link headOf} for every session it holds — with the row's `incarnation`, the same token the acquired session's
|
|
217
|
+
* metadata carries for a row this store created (a revived child reads its tree's owner off its own row through it).
|
|
210
218
|
*/
|
|
211
219
|
readonly placements?: {
|
|
212
220
|
subagent?: {
|
|
@@ -322,9 +330,12 @@ export interface SessionStore<S extends SessionStoreSummary = SessionStoreSummar
|
|
|
322
330
|
* from `acquire`, only a session of the occupant it names — a cached view of an occupant the row no longer holds (the row deleted,
|
|
323
331
|
* or deleted and created again, through another writer — on the File lane a writer in another process too) is not served — so its `incarnation` and the acquired session's metadata agree (the kit pins both); a run's own memory seat reads the session it ACQUIRED instead, never this lookup. The owner is a cell of the row: `null` = anonymous (admitted to every principal) — a row created
|
|
324
332
|
* with no owner (`acquire` names none), or a row written before the cell existed; a principal name = owned (a cell holding a blank string
|
|
325
|
-
* names nobody and is a read fault, never an owner). A placed row carries the owner its
|
|
326
|
-
*
|
|
327
|
-
*
|
|
333
|
+
* names nobody and is a read fault, never an owner). A placed row carries the owner of its delegation tree: the placing write records
|
|
334
|
+
* exactly `placement.owner` ({@link SessionPlacement.owner} — minted by the engine from the tree root's row, as the root run read it, and
|
|
335
|
+
* carried unchanged down the tree), and no store derives an owner of its own; the child's owner VALUE is its root's (`null` when the
|
|
336
|
+
* root is anonymous) — a deployment's gate may still admit an ownerless placed row more narrowly than an ownerless root row, because a
|
|
337
|
+
* row placed before 7.62.0 keeps what its placing write recorded (`null` on the bundled stores, whatever its root's owner), and a
|
|
338
|
+
* descendant spawned from such a row after a revival records that `null` too. **Optional**: absent ⇒ no by-id read,
|
|
328
339
|
* and a deployment's authorizer, which needs this and {@link register} together, takes its fail-closed arm.
|
|
329
340
|
*/
|
|
330
341
|
headOf?(sessionId: string): Promise<SessionHead | undefined>;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The seatbelt confinement a shell start runs under on the engine's macOS host: the launcher, the deny-default base every
|
|
3
|
+
* confined start runs under, the one assembly of a profile from the reads it refuses and the locations it holds in place,
|
|
4
|
+
* and the one wrapping of a start in its floor's profile. Below the engine and the tools both: an environment spawns
|
|
5
|
+
* through {@link confineShellStart} and probes with {@link SEATBELT_PROBE_PROFILE}; the floor's adapter translates its
|
|
6
|
+
* table into the expressions {@link seatbeltProfile} assembles (`ReadFloor.confinement`).
|
|
7
|
+
*/
|
|
8
|
+
import type { ReadFloor } from "../internal/harness-types.js";
|
|
9
|
+
/** The seatbelt launcher, by its absolute path (a PATH lookup could run another program in its place). */
|
|
10
|
+
export declare const SANDBOX_EXEC = "/usr/bin/sandbox-exec";
|
|
11
|
+
/** A profile: the base; reads open but for each of `reads` (an expression in the dialect's regex syntax), directory metadata
|
|
12
|
+
* still readable; writes open, and no unlink or create at any of `holds` (a rename cannot carry a refused file out from
|
|
13
|
+
* under its row). No expression on a side ⇒ no block for it. */
|
|
14
|
+
export declare function seatbeltProfile(reads: readonly string[], holds: readonly string[]): string;
|
|
15
|
+
/** The profile of no row: what an environment applies once to learn whether confinement works on this host at all. */
|
|
16
|
+
export declare const SEATBELT_PROBE_PROFILE: string;
|
|
17
|
+
/** A shell start as an environment spawns it: the shell and its arguments, the command last. */
|
|
18
|
+
export interface ShellStart {
|
|
19
|
+
readonly command: string;
|
|
20
|
+
readonly args: readonly string[];
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* The start confined to `floor` — the one wrapping every environment that spawns on the engine's host takes: no floor ⇒
|
|
24
|
+
* the start as it is (`profile` undefined); a floor ⇒ `sandbox-exec -p <the floor's seatbelt profile>` running the start,
|
|
25
|
+
* with that profile; a floor whose profile cannot be made ⇒ the row and why, and the start must not run. Pure: whether the
|
|
26
|
+
* host can apply a profile at all is the environment's probe, and an apply that fails at the start is the environment's to
|
|
27
|
+
* refuse.
|
|
28
|
+
*/
|
|
29
|
+
export declare function confineShellStart(start: ShellStart, floor: ReadFloor | undefined): {
|
|
30
|
+
readonly ok: true;
|
|
31
|
+
readonly start: ShellStart;
|
|
32
|
+
readonly profile: string | undefined;
|
|
33
|
+
} | {
|
|
34
|
+
readonly ok: false;
|
|
35
|
+
readonly row: string;
|
|
36
|
+
readonly reason: string;
|
|
37
|
+
};
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
export const SANDBOX_EXEC = "/usr/bin/sandbox-exec";
|
|
2
|
+
const SEATBELT_BASE = [
|
|
3
|
+
"(version 1)", "(deny default)", "(allow process-exec)", "(allow process-fork)", "(allow process-info* (target same-sandbox))",
|
|
4
|
+
"(allow signal (target same-sandbox))", "(allow mach-priv-task-port (target same-sandbox))", "(allow user-preference-read)", "(allow mach-lookup",
|
|
5
|
+
"(global-name \"com.apple.audio.systemsoundserver\")", "(global-name \"com.apple.distributed_notifications@Uv3\")",
|
|
6
|
+
"(global-name \"com.apple.FontObjectsServer\")", "(global-name \"com.apple.fonts\")", "(global-name \"com.apple.logd\")",
|
|
7
|
+
"(global-name \"com.apple.lsd.mapdb\")", "(global-name \"com.apple.PowerManagement.control\")", "(global-name \"com.apple.system.logger\")",
|
|
8
|
+
"(global-name \"com.apple.system.notification_center\")", "(global-name \"com.apple.system.opendirectoryd.libinfo\")",
|
|
9
|
+
"(global-name \"com.apple.system.opendirectoryd.membership\")", "(global-name \"com.apple.bsd.dirhelper\")",
|
|
10
|
+
"(global-name \"com.apple.securityd.xpc\")", "(global-name \"com.apple.coreservices.launchservicesd\")", ")", "(allow ipc-posix-shm)",
|
|
11
|
+
"(allow ipc-posix-sem)", "(allow iokit-open", "(iokit-registry-entry-class \"IOSurfaceRootUserClient\")",
|
|
12
|
+
"(iokit-registry-entry-class \"RootDomainUserClient\")", "(iokit-user-client-class \"IOSurfaceSendRight\")", ")", "(allow iokit-get-properties)",
|
|
13
|
+
"(allow system-socket (require-all (socket-domain AF_SYSTEM) (socket-protocol 2)))", "(allow sysctl-read", "(sysctl-name \"hw.activecpu\")",
|
|
14
|
+
"(sysctl-name \"hw.busfrequency_compat\")", "(sysctl-name \"hw.byteorder\")", "(sysctl-name \"hw.cacheconfig\")",
|
|
15
|
+
"(sysctl-name \"hw.cachelinesize_compat\")", "(sysctl-name \"hw.cpufamily\")", "(sysctl-name \"hw.cpufrequency\")",
|
|
16
|
+
"(sysctl-name \"hw.cpufrequency_compat\")", "(sysctl-name \"hw.cputype\")", "(sysctl-name \"hw.l1dcachesize_compat\")",
|
|
17
|
+
"(sysctl-name \"hw.l1icachesize_compat\")", "(sysctl-name \"hw.l2cachesize_compat\")", "(sysctl-name \"hw.l3cachesize_compat\")",
|
|
18
|
+
"(sysctl-name \"hw.logicalcpu\")", "(sysctl-name \"hw.logicalcpu_max\")", "(sysctl-name \"hw.machine\")", "(sysctl-name \"hw.memsize\")",
|
|
19
|
+
"(sysctl-name \"hw.ncpu\")", "(sysctl-name \"hw.nperflevels\")", "(sysctl-name \"hw.packages\")", "(sysctl-name \"hw.pagesize_compat\")",
|
|
20
|
+
"(sysctl-name \"hw.pagesize\")", "(sysctl-name \"hw.physicalcpu\")", "(sysctl-name \"hw.physicalcpu_max\")",
|
|
21
|
+
"(sysctl-name \"hw.tbfrequency_compat\")", "(sysctl-name \"hw.vectorunit\")", "(sysctl-name \"kern.argmax\")", "(sysctl-name \"kern.bootargs\")",
|
|
22
|
+
"(sysctl-name \"kern.hostname\")", "(sysctl-name \"kern.maxfiles\")", "(sysctl-name \"kern.maxfilesperproc\")", "(sysctl-name \"kern.maxproc\")",
|
|
23
|
+
"(sysctl-name \"kern.ngroups\")", "(sysctl-name \"kern.osproductversion\")", "(sysctl-name \"kern.osrelease\")", "(sysctl-name \"kern.ostype\")",
|
|
24
|
+
"(sysctl-name \"kern.osvariant_status\")", "(sysctl-name \"kern.osversion\")", "(sysctl-name \"kern.secure_kernel\")",
|
|
25
|
+
"(sysctl-name \"kern.tcsm_available\")", "(sysctl-name \"kern.tcsm_enable\")", "(sysctl-name \"kern.usrstack64\")", "(sysctl-name \"kern.version\")",
|
|
26
|
+
"(sysctl-name \"kern.willshutdown\")", "(sysctl-name \"machdep.cpu.brand_string\")", "(sysctl-name \"machdep.ptrauth_enabled\")",
|
|
27
|
+
"(sysctl-name \"security.mac.lockdown_mode_state\")", "(sysctl-name \"sysctl.proc_cputype\")", "(sysctl-name \"vm.loadavg\")",
|
|
28
|
+
"(sysctl-name-prefix \"hw.optional.arm\")", "(sysctl-name-prefix \"hw.optional.arm.\")", "(sysctl-name-prefix \"hw.optional.armv8_\")",
|
|
29
|
+
"(sysctl-name-prefix \"hw.perflevel\")", "(sysctl-name-prefix \"kern.proc.all\")", "(sysctl-name-prefix \"kern.proc.pgrp.\")",
|
|
30
|
+
"(sysctl-name-prefix \"kern.proc.pid.\")", "(sysctl-name-prefix \"machdep.cpu.\")", "(sysctl-name-prefix \"net.routetable.\")", ")",
|
|
31
|
+
"(allow sysctl-write", "(sysctl-name \"kern.tcsm_enable\")", ")", "(allow distributed-notification-post)",
|
|
32
|
+
"(allow mach-lookup (global-name \"com.apple.SecurityServer\"))", "(allow file-ioctl (literal \"/dev/null\"))",
|
|
33
|
+
"(allow file-ioctl (literal \"/dev/zero\"))", "(allow file-ioctl (literal \"/dev/random\"))", "(allow file-ioctl (literal \"/dev/urandom\"))",
|
|
34
|
+
"(allow file-ioctl (literal \"/dev/dtracehelper\"))", "(allow file-ioctl (literal \"/dev/tty\"))",
|
|
35
|
+
"(allow file-ioctl file-read-data file-write-data", "(require-all", "(literal \"/dev/null\")", "(vnode-type CHARACTER-DEVICE)", ")", ")",
|
|
36
|
+
"(allow network*)",
|
|
37
|
+
];
|
|
38
|
+
export function seatbeltProfile(reads, holds) {
|
|
39
|
+
const filters = (xs) => xs.map((x) => `(regex ${JSON.stringify(x)})`);
|
|
40
|
+
const lines = [...SEATBELT_BASE, "(allow file-read*)"];
|
|
41
|
+
if (reads.length > 0)
|
|
42
|
+
lines.push("(deny file-read*", ...filters(reads), ")", "(allow file-read-metadata (vnode-type DIRECTORY))");
|
|
43
|
+
lines.push("(allow file-write*)");
|
|
44
|
+
if (holds.length > 0)
|
|
45
|
+
lines.push("(deny file-write-unlink file-write-create", ...filters(holds), ")");
|
|
46
|
+
return lines.join("\n");
|
|
47
|
+
}
|
|
48
|
+
export const SEATBELT_PROBE_PROFILE = seatbeltProfile([], []);
|
|
49
|
+
export function confineShellStart(start, floor) {
|
|
50
|
+
if (floor === undefined)
|
|
51
|
+
return { ok: true, start, profile: undefined };
|
|
52
|
+
const c = floor.confinement("seatbelt");
|
|
53
|
+
if (!c.ok)
|
|
54
|
+
return c;
|
|
55
|
+
return { ok: true, start: { command: SANDBOX_EXEC, args: ["-p", c.profile, start.command, ...start.args] }, profile: c.profile };
|
|
56
|
+
}
|
package/dist/core/skill-grant.js
CHANGED
|
@@ -5,7 +5,7 @@ import { inlineUntrusted } from "./untrusted-text.js";
|
|
|
5
5
|
import { boundInputHashOf } from "./canonical-json.js";
|
|
6
6
|
import { NOT_BINDABLE } from "./skill-grant-binding.js";
|
|
7
7
|
import { readToolNameList } from "./tool-name-list.js";
|
|
8
|
-
import { closestName } from "./
|
|
8
|
+
import { closestName } from "./closest-name.js";
|
|
9
9
|
import { allowingRows, strippedInAuto, compileAllowList, readRuleEntry, inertEntryPhrase, judgeAllowEntries, nonListValueLabel, renderListEntry, spelledListEntry } from "./allow-entry.js";
|
|
10
10
|
export const SKILL_GRANT_ORIGINS = Object.freeze(["model", "user", "inherited"]);
|
|
11
11
|
const FROZEN_SKILL_GRANT_ORIGINS = new Set(["model", "inherited"]);
|
|
@@ -57,13 +57,16 @@ export declare function checkpointListByScopeSummaries(store: CheckpointStore):
|
|
|
57
57
|
/** The canonical expected summary projection (what `summarizeCheckpoint` must yield for the fixture above). */
|
|
58
58
|
export declare const EXPECTED_LISTBYSCOPE_SUMMARIES: ({
|
|
59
59
|
token: string;
|
|
60
|
+
rowVerdict: {
|
|
61
|
+
kind: string;
|
|
62
|
+
};
|
|
60
63
|
sessionId: string;
|
|
61
64
|
scope: string;
|
|
62
65
|
gateKind: string;
|
|
63
66
|
severity: number;
|
|
64
67
|
deadline: number;
|
|
65
68
|
createdAt: number;
|
|
66
|
-
|
|
69
|
+
sourceSessionId: string;
|
|
67
70
|
principal: string;
|
|
68
71
|
toolCallId: string;
|
|
69
72
|
toolName: string;
|
|
@@ -75,6 +78,9 @@ export declare const EXPECTED_LISTBYSCOPE_SUMMARIES: ({
|
|
|
75
78
|
spentMicroUsd?: undefined;
|
|
76
79
|
} | {
|
|
77
80
|
token: string;
|
|
81
|
+
rowVerdict: {
|
|
82
|
+
kind: string;
|
|
83
|
+
};
|
|
78
84
|
sessionId: string;
|
|
79
85
|
scope: string;
|
|
80
86
|
gateKind: string;
|
|
@@ -82,7 +88,7 @@ export declare const EXPECTED_LISTBYSCOPE_SUMMARIES: ({
|
|
|
82
88
|
createdAt: number;
|
|
83
89
|
severity?: undefined;
|
|
84
90
|
deadline?: undefined;
|
|
85
|
-
|
|
91
|
+
sourceSessionId?: undefined;
|
|
86
92
|
principal?: undefined;
|
|
87
93
|
toolCallId?: undefined;
|
|
88
94
|
toolName?: undefined;
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { strict as assert } from "node:assert";
|
|
2
2
|
import { executionVerdict } from "../checkpoint-execution-record.js";
|
|
3
3
|
import { MAX_PENDING_STEER_ENTRIES, checkpointIndexFacts, mintCheckpointToken, readPendingSteerQueue, } from "../checkpoint-store.js";
|
|
4
|
+
import { judgeCheckpointRow } from "../checkpoint-row-verdict.js";
|
|
5
|
+
import { memberPresent } from "../own-property-receipt.js";
|
|
4
6
|
import { checkpointFrom } from "../pause-registry.js";
|
|
5
7
|
import { beginContract } from "./contract-harness.js";
|
|
6
8
|
export function createCheckpointFixture(over = {}) {
|
|
@@ -31,6 +33,11 @@ export function createCheckpointFixture(over = {}) {
|
|
|
31
33
|
...over,
|
|
32
34
|
});
|
|
33
35
|
}
|
|
36
|
+
function damagedWriteFaceFixture(over) {
|
|
37
|
+
const cp = createCheckpointFixture(over);
|
|
38
|
+
Reflect.set(cp.state, "writeFace", { face: "neither" });
|
|
39
|
+
return cp;
|
|
40
|
+
}
|
|
34
41
|
export const ALLOW = {
|
|
35
42
|
gate: "policy_ask",
|
|
36
43
|
decision: "allow",
|
|
@@ -275,6 +282,48 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
|
|
|
275
282
|
assert.equal(list[0].token, pending.token);
|
|
276
283
|
assert.equal((await store.get(pending.token)).status, "pending");
|
|
277
284
|
});
|
|
285
|
+
run("rowVerdict: every listed summary's verdict equals judgeCheckpointRow of the row get hands back (an ok row, a damaged row), and editing a listed summary's preview leaves the stored row as it was", async () => {
|
|
286
|
+
const store = make();
|
|
287
|
+
const okRow = createCheckpointFixture({
|
|
288
|
+
sessionId: "verdict-ok",
|
|
289
|
+
pendingAction: { kind: "tool_approval", origin: "policy", toolCallId: "call-3", toolName: "Write", args: { path: "/x", content: "y" }, preview: { lines: ["a"] }, boundInputHash: "h0", boundGrantAbsence: "not_bindable", batchToolCallIds: ["call-3"], completedCallIds: [] },
|
|
290
|
+
});
|
|
291
|
+
const damagedRow = damagedWriteFaceFixture({ sessionId: "verdict-damaged" });
|
|
292
|
+
for (const cp of [okRow, damagedRow])
|
|
293
|
+
await store.put(cp.token, cp);
|
|
294
|
+
const listed = await store.listByScope("tenant-a");
|
|
295
|
+
assert.equal(listed.length, 2);
|
|
296
|
+
assert.equal(judgeCheckpointRow(okRow).kind, "ok");
|
|
297
|
+
assert.equal(judgeCheckpointRow(damagedRow).kind, "damaged");
|
|
298
|
+
for (const s of listed)
|
|
299
|
+
assert.deepEqual(s.rowVerdict, judgeCheckpointRow((await store.get(s.token))), `the listing and the get judge one row (${s.sessionId})`);
|
|
300
|
+
const byId = new Map(listed.map((s) => [s.sessionId, s]));
|
|
301
|
+
byId.get("verdict-ok").preview.lines.push("edited on the summary");
|
|
302
|
+
const stored = (await store.get(okRow.token)).pendingAction;
|
|
303
|
+
assert.deepEqual(stored.preview, { lines: ["a"] }, "a summary's preview is a copy: editing it does not edit the stored row");
|
|
304
|
+
const relisted = new Map((await store.listByScope("tenant-a")).map((s) => [s.sessionId, s]));
|
|
305
|
+
assert.deepEqual(relisted.get("verdict-ok").preview, { lines: ["a"] });
|
|
306
|
+
});
|
|
307
|
+
run("rowVerdict: a listed verdict is the verdict judged now — on a second listing, and (deleteSessionCheckpoints offered) after a token's row is replaced by a damaged one", async () => {
|
|
308
|
+
const store = make();
|
|
309
|
+
const row = createCheckpointFixture({ sessionId: "memo-row" });
|
|
310
|
+
await store.put(row.token, row);
|
|
311
|
+
const first = (await store.listByScope("tenant-a")).find((s) => s.token === row.token);
|
|
312
|
+
const second = (await store.listByScope("tenant-a")).find((s) => s.token === row.token);
|
|
313
|
+
assert.deepEqual(first.rowVerdict, judgeCheckpointRow((await store.get(row.token))));
|
|
314
|
+
assert.deepEqual(second.rowVerdict, first.rowVerdict);
|
|
315
|
+
const heads = options.sessionHeads;
|
|
316
|
+
if (store.deleteSessionCheckpoints === undefined || heads === undefined)
|
|
317
|
+
return;
|
|
318
|
+
heads.set("memo-row", { owner: null });
|
|
319
|
+
if ((await store.deleteSessionCheckpoints("memo-row", { owner: null })) !== 1)
|
|
320
|
+
return;
|
|
321
|
+
const replaced = damagedWriteFaceFixture({ token: row.token, sessionId: "memo-row" });
|
|
322
|
+
await store.put(replaced.token, replaced);
|
|
323
|
+
const after = (await store.listByScope("tenant-a")).find((s) => s.token === row.token);
|
|
324
|
+
assert.equal(after.rowVerdict.kind, "damaged", "a replaced row is judged again, never answered from the verdict its predecessor had");
|
|
325
|
+
assert.deepEqual(after.rowVerdict, judgeCheckpointRow((await store.get(row.token))));
|
|
326
|
+
});
|
|
278
327
|
run("#438 hasBidiControls three-form matrix: a row's `true` survives + projects; absent stays absent (clean args); an out-of-contract `false` reads as absent; a bit-less marked row backfills at projection", async () => {
|
|
279
328
|
const store = make();
|
|
280
329
|
const RLO = String.fromCodePoint(0x202e);
|
|
@@ -430,6 +479,19 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
|
|
|
430
479
|
const bareBack = (await store.get(bare.token));
|
|
431
480
|
assert.equal("requires" in bareBack || "requirementsDigest" in bareBack, false, "a row without a list or digest must stay without (never [] / null / \"\")");
|
|
432
481
|
});
|
|
482
|
+
run("held rows: a row's `heldRows` (the conversation rows owed after its leaf) survive the round-trip verbatim — every row, in its order, each member of each (text blocks, a string content, `provenance`, `rewrittenBy`); a row without them stays without", async () => {
|
|
483
|
+
const store = make();
|
|
484
|
+
const heldRows = [
|
|
485
|
+
{ role: "user", content: "first note", timestamp: 1, provenance: "engine-note" },
|
|
486
|
+
{ role: "user", content: [{ type: "text", text: "second note, rewritten" }], timestamp: 2, provenance: "engine-note", rewrittenBy: ["scrubber", "tagger"] },
|
|
487
|
+
];
|
|
488
|
+
const held = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "held-rows", heldRows });
|
|
489
|
+
const bare = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "held-none" });
|
|
490
|
+
for (const cp of [held, bare])
|
|
491
|
+
await store.put(cp.token, cp);
|
|
492
|
+
assert.deepEqual((await store.get(held.token)).heldRows, heldRows, "the held rows must survive the round-trip as the same rows, in the same order, every member kept");
|
|
493
|
+
assert.equal("heldRows" in (await store.get(bare.token)), false, "a row without held rows must stay without (never [] / null)");
|
|
494
|
+
});
|
|
433
495
|
run("run origin: a row's `state.runOrigin` survives the round-trip verbatim and rides the listing; absent stays absent; a word outside the set is kept on the row and reads as absent in the listing", async () => {
|
|
434
496
|
const store = make();
|
|
435
497
|
const member = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "ro-member" });
|
|
@@ -447,6 +509,23 @@ export async function checkpointStoreContract(make, runAssertion, options = {})
|
|
|
447
509
|
assert.equal((await store.get(bogus.token)).state.runOrigin, "weekly", "a word outside the set must be kept on the row verbatim");
|
|
448
510
|
assert.equal("runOrigin" in byId.get("ro-bogus"), false, "a word outside the closed set must read as absent in the listing, never project verbatim");
|
|
449
511
|
});
|
|
512
|
+
run("member presence: a row whose top level and `state` carry members holding undefined reads them absent — the value undefined (`memberPresent` false), the listing without them — and judges as its twin without the keys", async () => {
|
|
513
|
+
const store = make();
|
|
514
|
+
const holding = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "mp-holding" });
|
|
515
|
+
Object.assign(holding, { deadline: undefined, humanReview: undefined });
|
|
516
|
+
Object.assign(holding.state, { compositionLeg: undefined, rowTaskId: undefined });
|
|
517
|
+
const omitted = createCheckpointFixture({ token: mintCheckpointToken(), sessionId: "mp-omitted" });
|
|
518
|
+
for (const cp of [holding, omitted])
|
|
519
|
+
await store.put(cp.token, cp);
|
|
520
|
+
const got = (await store.get(holding.token));
|
|
521
|
+
for (const name of ["deadline", "humanReview"])
|
|
522
|
+
assert.equal(memberPresent(got, name), false, `a top-level ${name} holding undefined must read absent`);
|
|
523
|
+
for (const name of ["compositionLeg", "rowTaskId"])
|
|
524
|
+
assert.equal(memberPresent(got.state, name), false, `a state.${name} holding undefined must read absent`);
|
|
525
|
+
const listed = (await store.listByScope("tenant-a")).find((s) => s.sessionId === "mp-holding");
|
|
526
|
+
assert.equal("deadline" in listed, false, "the listing must leave out a deadline that holds undefined");
|
|
527
|
+
assert.deepEqual(judgeCheckpointRow(got), judgeCheckpointRow((await store.get(omitted.token))), "a member holding undefined must judge as the member left out");
|
|
528
|
+
});
|
|
450
529
|
run("decider pair: a policy-decided allow resolves like a person's — its `policy_allowed` record (party `policy`, the attribution) round-trips verbatim on the resolved winner and as the execution record; the same record is already_recorded, a person's record for that row conflicts", async () => {
|
|
451
530
|
const store = make();
|
|
452
531
|
const cp = createCheckpointFixture();
|
|
@@ -633,7 +712,7 @@ export async function checkpointListByScopeSummaries(store) {
|
|
|
633
712
|
sessionId: "needs-approval",
|
|
634
713
|
deadline: 1_999_999_999_999,
|
|
635
714
|
createdAt: 1_700_000_000_000,
|
|
636
|
-
|
|
715
|
+
sourceSessionId: "needs-approval",
|
|
637
716
|
principal: "alice@corp",
|
|
638
717
|
gate: {
|
|
639
718
|
kind: "human",
|
|
@@ -675,13 +754,14 @@ export async function checkpointListByScopeSummaries(store) {
|
|
|
675
754
|
export const EXPECTED_LISTBYSCOPE_SUMMARIES = [
|
|
676
755
|
{
|
|
677
756
|
token: "tok-escalation",
|
|
757
|
+
rowVerdict: { kind: "ok" },
|
|
678
758
|
sessionId: "needs-approval",
|
|
679
759
|
scope: "tenant-a",
|
|
680
760
|
gateKind: "human",
|
|
681
761
|
severity: 5,
|
|
682
762
|
deadline: 1_999_999_999_999,
|
|
683
763
|
createdAt: 1_700_000_000_000,
|
|
684
|
-
|
|
764
|
+
sourceSessionId: "needs-approval",
|
|
685
765
|
principal: "alice@corp",
|
|
686
766
|
toolCallId: "call-pr",
|
|
687
767
|
toolName: "open_pr",
|
|
@@ -693,6 +773,7 @@ export const EXPECTED_LISTBYSCOPE_SUMMARIES = [
|
|
|
693
773
|
},
|
|
694
774
|
{
|
|
695
775
|
token: "tok-resource",
|
|
776
|
+
rowVerdict: { kind: "ok" },
|
|
696
777
|
sessionId: "out-of-budget",
|
|
697
778
|
scope: "tenant-a",
|
|
698
779
|
gateKind: "resource_limit",
|
|
@@ -1,3 +1,6 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type FileHistoryStore } from "../file-history-store.js";
|
|
2
2
|
import { type ContractAssertionRunner } from "./contract-harness.js";
|
|
3
|
-
export declare function fileHistoryStoreContract(make: () => FileHistoryStore, runAssertion?: ContractAssertionRunner
|
|
3
|
+
export declare function fileHistoryStoreContract(make: () => FileHistoryStore, runAssertion?: ContractAssertionRunner, onOptionalMember?: (report: {
|
|
4
|
+
member: "blobExchange";
|
|
5
|
+
status: "verified" | "absent";
|
|
6
|
+
}) => void): Promise<void>;
|
|
@@ -3,6 +3,7 @@ import { createHash } from "node:crypto";
|
|
|
3
3
|
import { chmod, mkdtemp, mkdir, rm, stat, symlink, writeFile, readFile } from "node:fs/promises";
|
|
4
4
|
import { tmpdir } from "node:os";
|
|
5
5
|
import { join } from "node:path";
|
|
6
|
+
import { fileHistoryBlobExchangeOf } from "../file-history-store.js";
|
|
6
7
|
import { isGovernanceRetryClass } from "../governance-codes.js";
|
|
7
8
|
import { NodeExecutionEnv } from "../../internal/harness.js";
|
|
8
9
|
import { beginContract } from "./contract-harness.js";
|
|
@@ -51,8 +52,31 @@ async function withTree(fn) {
|
|
|
51
52
|
await rm(dir, { recursive: true, force: true });
|
|
52
53
|
}
|
|
53
54
|
}
|
|
54
|
-
export async function fileHistoryStoreContract(make, runAssertion) {
|
|
55
|
+
export async function fileHistoryStoreContract(make, runAssertion, onOptionalMember) {
|
|
55
56
|
const { run, settle } = beginContract(runAssertion);
|
|
57
|
+
run("blobExchange (optional member group): read as one group; put checks the address and stores nothing it refuses; has answers from the index; get round-trips; absence is REPORTED", async () => {
|
|
58
|
+
const exchange = fileHistoryBlobExchangeOf(make());
|
|
59
|
+
if (exchange === undefined) {
|
|
60
|
+
onOptionalMember?.({ member: "blobExchange", status: "absent" });
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
const bytes = new TextEncoder().encode("bytes another machine sent ahead of its import");
|
|
64
|
+
const other = new TextEncoder().encode("different bytes");
|
|
65
|
+
const hash = createHash("sha256").update(bytes).digest("hex");
|
|
66
|
+
const otherHash = createHash("sha256").update(other).digest("hex");
|
|
67
|
+
assert.deepEqual([...(await exchange.has([hash]))], [], "nothing is held before the put");
|
|
68
|
+
assert.equal(await exchange.get(hash), undefined, "get answers undefined for bytes the store does not hold");
|
|
69
|
+
const wrong = await exchange.put(otherHash, bytes);
|
|
70
|
+
assert.equal(wrong.ok, false, "bytes that do not hash to the address are refused");
|
|
71
|
+
assert.equal(!wrong.ok && wrong.error.code, "adopt_failed", "the refusal is the adoption family's word");
|
|
72
|
+
assert.equal(!wrong.ok && wrong.error.permanence, "terminal", "no retry makes the bytes hash differently");
|
|
73
|
+
assert.deepEqual([...(await exchange.has([otherHash, hash]))], [], "a refused put stores nothing under either address");
|
|
74
|
+
assert.deepEqual(await exchange.put(hash, bytes), { ok: true });
|
|
75
|
+
assert.deepEqual(await exchange.put(hash, bytes), { ok: true }, "a repeat put is idempotent");
|
|
76
|
+
assert.deepEqual([...(await exchange.has([hash, otherHash]))], [hash], "has names the held ones only");
|
|
77
|
+
assert.deepEqual([...((await exchange.get(hash)) ?? [])], [...bytes], "get round-trips the bytes");
|
|
78
|
+
onOptionalMember?.({ member: "blobExchange", status: "verified" });
|
|
79
|
+
});
|
|
56
80
|
run("absent everything: canRestore=false, restore=failed/not_found with an empty ledger, reap=0 — and none of it throws", async () => {
|
|
57
81
|
await withTree(async (dir, env) => {
|
|
58
82
|
const store = make();
|