@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 { randomBytes, randomUUID } from "node:crypto";
|
|
2
2
|
import { uuidv7 } from "../internal/harness.js";
|
|
3
|
-
import {
|
|
3
|
+
import { PROBE_REASON_MAX, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
|
|
4
|
+
import { CheckpointError, checkpointVersionOf, isPlainRecord, normalizeProbeCause, safeDataValue } from "./checkpoint-features.js";
|
|
5
|
+
import { judgeCheckpointRow, retiredSteerSeatRefusal } from "./checkpoint-row-verdict.js";
|
|
4
6
|
import { carriesBidiControls } from "./tool-policy.js";
|
|
7
|
+
import { agentIdOf, legTaskIdOf } from "./leg-identity.js";
|
|
5
8
|
import { isAutoModeFallbackCause, readDenialLimitFallback } from "./auto-mode.js";
|
|
6
|
-
import { isAskOrigin,
|
|
9
|
+
import { isAskOrigin, isPersistedRuleMandate } from "./ask-origin.js";
|
|
7
10
|
import { isRunOrigin, RUN_ORIGINS } from "./run-origin.js";
|
|
8
11
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
9
12
|
import { readBoundBinding } from "./skill-grant-binding.js";
|
|
@@ -15,7 +18,8 @@ import { renderUntrustedCommandText, stripFormatCharacters } from "./permission-
|
|
|
15
18
|
import { egressText } from "./untrusted-egress.js";
|
|
16
19
|
import { steerReplayRefusal } from "./steer-replay.js";
|
|
17
20
|
import { readRetentionDeclaration } from "./retention.js";
|
|
18
|
-
import { receiveOptions } from "./own-property-receipt.js";
|
|
21
|
+
import { memberPresent, optionKeys, receiveOptions } from "./own-property-receipt.js";
|
|
22
|
+
export { BINDING_CHECKPOINT_VERSION, CHECKPOINT_CONFIG_REFUSAL_CODES, CHECKPOINT_FEATURES, CheckpointError, checkpointVersionOf, CURRENT_CHECKPOINT_VERSION, encodeAtFidelity, F012_CHECKPOINT_VERSION, FACE_CHECKPOINT_VERSION, isCheckpointConfigRefusalCode, isPlainRecord, MAX_SUPPORTED_CHECKPOINT_VERSION, normalizeProbeCause, ORG_ADMISSION_CHECKPOINT_VERSION, REAL_APPROVAL_CHECKPOINT_VERSION, RESOURCE_CHECKPOINT_VERSION, safeDataValue, TOKEN_CHECKPOINT_VERSION, } from "./checkpoint-features.js";
|
|
19
23
|
export function mintCheckpointToken() {
|
|
20
24
|
return randomBytes(16).toString("hex");
|
|
21
25
|
}
|
|
@@ -23,37 +27,6 @@ export function mintCheckpointId() {
|
|
|
23
27
|
return `cp_${randomUUID()}`;
|
|
24
28
|
}
|
|
25
29
|
export { PROBE_REASON_MAX } from "./untrusted-text.js";
|
|
26
|
-
const PROBE_CAUSE_MAX_SHOWN = 8;
|
|
27
|
-
export function normalizeProbeCause(value) {
|
|
28
|
-
if (!isPlainRecord(value))
|
|
29
|
-
return undefined;
|
|
30
|
-
const code = safeDataValue(value, "code");
|
|
31
|
-
if (typeof code !== "string" || code.trim().length === 0)
|
|
32
|
-
return undefined;
|
|
33
|
-
const family = (raw) => {
|
|
34
|
-
if (!isPlainRecord(raw))
|
|
35
|
-
return undefined;
|
|
36
|
-
const shownRaw = safeDataValue(raw, "shown");
|
|
37
|
-
if (!Array.isArray(shownRaw))
|
|
38
|
-
return undefined;
|
|
39
|
-
const shown = shownRaw
|
|
40
|
-
.filter((p) => typeof p === "string")
|
|
41
|
-
.slice(0, PROBE_CAUSE_MAX_SHOWN)
|
|
42
|
-
.map((p) => inlineUntrusted(p, PROBE_CAUSE_PATH_MAX));
|
|
43
|
-
const totalRaw = safeDataValue(raw, "total");
|
|
44
|
-
const total = typeof totalRaw === "number" && Number.isFinite(totalRaw) ? Math.max(0, Math.floor(totalRaw)) : shown.length;
|
|
45
|
-
return { shown, total: Math.max(total, shown.length) };
|
|
46
|
-
};
|
|
47
|
-
const roots = family(safeDataValue(value, "roots"));
|
|
48
|
-
if (roots === undefined)
|
|
49
|
-
return undefined;
|
|
50
|
-
const further = family(safeDataValue(value, "further"));
|
|
51
|
-
return {
|
|
52
|
-
code: inlineUntrusted(code, PROBE_REASON_MAX),
|
|
53
|
-
roots,
|
|
54
|
-
...(further !== undefined && further.total > 0 ? { further } : {}),
|
|
55
|
-
};
|
|
56
|
-
}
|
|
57
30
|
export function riskSeverity(axes) {
|
|
58
31
|
return readRiskAxes(axes).tier;
|
|
59
32
|
}
|
|
@@ -83,26 +56,6 @@ export const MAX_PENDING_STEER_CHARS = 16_000;
|
|
|
83
56
|
export const PENDING_STEER_QUEUE_BYTE_BUDGET_BYTES = 48_000;
|
|
84
57
|
export const MAX_PENDING_STEER_ENTRIES = Math.floor(PENDING_STEER_QUEUE_BYTE_BUDGET_BYTES / MAX_PENDING_STEER_CHARS);
|
|
85
58
|
export const PENDING_STEER_FROZEN_FIELDS = Object.freeze(["text", "trusted", "actor", "seq", "inputId", "priority", "runOrigin"]);
|
|
86
|
-
export function isPlainRecord(x) {
|
|
87
|
-
try {
|
|
88
|
-
if (x === null || typeof x !== "object" || Array.isArray(x))
|
|
89
|
-
return false;
|
|
90
|
-
const p = Object.getPrototypeOf(x);
|
|
91
|
-
return p === Object.prototype || p === null;
|
|
92
|
-
}
|
|
93
|
-
catch {
|
|
94
|
-
return false;
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
export function safeDataValue(obj, key) {
|
|
98
|
-
try {
|
|
99
|
-
const d = Object.getOwnPropertyDescriptor(obj, key);
|
|
100
|
-
return d && "value" in d ? d.value : undefined;
|
|
101
|
-
}
|
|
102
|
-
catch {
|
|
103
|
-
return undefined;
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
59
|
function safeKeys(obj) {
|
|
107
60
|
try {
|
|
108
61
|
return Object.keys(obj);
|
|
@@ -196,29 +149,6 @@ export function realApprovalOrgFact(bit) {
|
|
|
196
149
|
return bit.org;
|
|
197
150
|
return bit.origin === "org_rule" ? "rule" : bit.origin === "org_unavailable" ? "unavailable" : undefined;
|
|
198
151
|
}
|
|
199
|
-
export const CHECKPOINT_FEATURES = {
|
|
200
|
-
baseline: { version: 1, introduced: "design/49", writes: "the row itself" },
|
|
201
|
-
resource: { version: 2, introduced: "design/74", writes: "resourceLedger; gate/pendingAction kind resource_limit" },
|
|
202
|
-
binding: { version: 3, introduced: "design/80", writes: "pendingAction.boundCallId + boundInputHash on a tool_approval; a plan_review carries the stamp only" },
|
|
203
|
-
token: { version: 5, introduced: "design/164", writes: "resourceLedger.totalTokens" },
|
|
204
|
-
orgAdmission: { version: 6, introduced: "org-admission", writes: "inheritedGate.admittedOrgScopes / ownAdmittedOrgScopes / ownAdmittedOrgWriteScope / orgAdmissionGoverned" },
|
|
205
|
-
f012: { version: 7, introduced: "F-012", writes: "inheritedGate.constraintChain + constraintDigest together; delegationProvenance" },
|
|
206
|
-
realApproval: { version: 8, introduced: "#130/#120", writes: "gate.realApproval (a well-formed bit) + pendingAction.requiresRealApproval; from v9: readFace.realApproval = true beside it" },
|
|
207
|
-
face: { version: 9, introduced: "design/199", writes: "state.readFace { face, denyEntries? } for a non-default posture; realApproval: true only at the mint whose gate carries the bit (a hands-less re-park never carries the seed's marker forward)" },
|
|
208
|
-
requirements: { version: 10, introduced: "#1320", writes: "requires (the row's words) + requirementsDigest (the row digest), both derived from its content (checkpoint-requirements.ts)" },
|
|
209
|
-
};
|
|
210
|
-
export const CURRENT_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.baseline.version;
|
|
211
|
-
export const RESOURCE_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.resource.version;
|
|
212
|
-
export const BINDING_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.binding.version;
|
|
213
|
-
export const TOKEN_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.token.version;
|
|
214
|
-
export const ORG_ADMISSION_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.orgAdmission.version;
|
|
215
|
-
export const F012_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.f012.version;
|
|
216
|
-
export const REAL_APPROVAL_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.realApproval.version;
|
|
217
|
-
export const FACE_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.face.version;
|
|
218
|
-
export const MAX_SUPPORTED_CHECKPOINT_VERSION = CHECKPOINT_FEATURES.requirements.version;
|
|
219
|
-
export function checkpointVersionOf(cp) {
|
|
220
|
-
return cp.version ?? 0;
|
|
221
|
-
}
|
|
222
152
|
function finiteBound(v) {
|
|
223
153
|
return v !== undefined && Number.isFinite(v) ? v : undefined;
|
|
224
154
|
}
|
|
@@ -281,13 +211,15 @@ export function planReviewRequesterOf(pendingAction) {
|
|
|
281
211
|
const id = pendingAction.requestedByCallId;
|
|
282
212
|
return typeof id === "string" && id !== "" ? id : undefined;
|
|
283
213
|
}
|
|
284
|
-
export function summarizeCheckpoint(cp, disclose) {
|
|
214
|
+
export function summarizeCheckpoint(cp, disclose, verdict) {
|
|
215
|
+
const rowVerdict = verdict ?? judgeCheckpointRow(cp);
|
|
285
216
|
const facts = checkpointIndexFacts(cp);
|
|
217
|
+
const rowName = `checkpoint ${JSON.stringify(cp.checkpointId ?? null)} of session ${JSON.stringify(cp.sessionId)}`;
|
|
286
218
|
const descriptor = facts.riskDescriptor;
|
|
287
219
|
const axes = descriptor === null ? undefined : readRiskAxes(descriptor?.axes);
|
|
288
220
|
const severity = axes?.tier;
|
|
289
221
|
if (axes?.problem !== undefined) {
|
|
290
|
-
disclose?.(
|
|
222
|
+
disclose?.(`${rowName}: the risk descriptor's axes are ${axes.problem} — ${severity === undefined ? "the summary carries no severity" : `the summary's severity ${severity} is read from the valid marks`}`);
|
|
291
223
|
}
|
|
292
224
|
const cardReading = parkedApprovalCardOf(cp.gate);
|
|
293
225
|
const tool = cp.pendingAction.kind === "tool_approval" ? cp.pendingAction : undefined;
|
|
@@ -304,11 +236,25 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
304
236
|
toolInput = undefined;
|
|
305
237
|
}
|
|
306
238
|
}
|
|
239
|
+
const shownPreview = tool?.preview;
|
|
307
240
|
const hasBidi = tool !== undefined &&
|
|
308
241
|
(facts.hasBidiControls === true ||
|
|
309
|
-
carriesBidiControls([toolInput,
|
|
242
|
+
carriesBidiControls([toolInput, shownPreview], { maxNodes: BIDI_BACKFILL_MAX_NODES, maxChars: BIDI_BACKFILL_MAX_CHARS }));
|
|
243
|
+
const agentId = agentIdOf({ taskId: legTaskIdOf({}, cp.state, cp.sessionId), isDelegatedChild: cp.state.isDelegatedChild === true });
|
|
244
|
+
const preview = (() => {
|
|
245
|
+
if (shownPreview === undefined)
|
|
246
|
+
return {};
|
|
247
|
+
try {
|
|
248
|
+
return { copy: structuredClone(shownPreview) };
|
|
249
|
+
}
|
|
250
|
+
catch {
|
|
251
|
+
disclose?.(`${rowName}: its approval preview is not a value a summary can copy — the summary carries no preview`);
|
|
252
|
+
return {};
|
|
253
|
+
}
|
|
254
|
+
})();
|
|
310
255
|
return {
|
|
311
256
|
token: facts.token,
|
|
257
|
+
rowVerdict,
|
|
312
258
|
...(cp.checkpointId !== undefined ? { checkpointId: cp.checkpointId } : {}),
|
|
313
259
|
sessionId: facts.sessionId,
|
|
314
260
|
scope: facts.scope,
|
|
@@ -317,7 +263,8 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
317
263
|
...(cp.resourceLedger !== undefined ? { spentMicroUsd: cp.resourceLedger.spentMicroUsd } : {}),
|
|
318
264
|
...(facts.deadline !== null ? { deadline: facts.deadline } : {}),
|
|
319
265
|
createdAt: facts.createdAt,
|
|
320
|
-
...(cp.
|
|
266
|
+
...(cp.sourceSessionId !== undefined ? { sourceSessionId: cp.sourceSessionId } : {}),
|
|
267
|
+
...(agentId !== undefined ? { agentId } : {}),
|
|
321
268
|
...(cp.principal !== undefined ? { principal: cp.principal } : {}),
|
|
322
269
|
...(facts.toolCallId !== null ? { toolCallId: facts.toolCallId } : {}),
|
|
323
270
|
...(requestedByCallId !== undefined ? { requestedByCallId } : {}),
|
|
@@ -328,7 +275,7 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
328
275
|
? { restoreMode: cp.state.workspaceHandle.restoreMode === "park_only" ? "park_only" : "snapshot" }
|
|
329
276
|
: {}),
|
|
330
277
|
...((runOrigin) => (isRunOrigin(runOrigin) ? { runOrigin } : {}))(cp.state.runOrigin),
|
|
331
|
-
...(
|
|
278
|
+
...("copy" in preview ? { preview: preview.copy } : {}),
|
|
332
279
|
...(tool?.previewWithheld === "oversize" || tool?.previewWithheld === "unavailable" ? { previewWithheld: tool.previewWithheld } : {}),
|
|
333
280
|
...(tool?.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
|
|
334
281
|
...(tool?.mandated === true ? { mandated: true } : {}),
|
|
@@ -347,17 +294,13 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
347
294
|
...(hasBidi ? { hasBidiControls: true } : {}),
|
|
348
295
|
};
|
|
349
296
|
}
|
|
350
|
-
export
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
constructor(code, message, detail) {
|
|
356
|
-
super(message);
|
|
357
|
-
this.code = code;
|
|
358
|
-
this.detail = detail;
|
|
359
|
-
this.name = "CheckpointError";
|
|
297
|
+
export function summarizeStoredCheckpoint(cp, memo, disclose) {
|
|
298
|
+
let verdict = memo.get(cp);
|
|
299
|
+
if (verdict === undefined) {
|
|
300
|
+
verdict = judgeCheckpointRow(cp);
|
|
301
|
+
memo.set(cp, verdict);
|
|
360
302
|
}
|
|
303
|
+
return summarizeCheckpoint(cp, disclose, verdict);
|
|
361
304
|
}
|
|
362
305
|
export function resolveDeclaredFidelity(store, storeName) {
|
|
363
306
|
const declared = store?.fidelity;
|
|
@@ -370,17 +313,6 @@ export function resolveDeclaredFidelity(store, storeName) {
|
|
|
370
313
|
e.code = "config.store_fidelity_invalid";
|
|
371
314
|
throw e;
|
|
372
315
|
}
|
|
373
|
-
export function encodeAtFidelity(fidelity, value) {
|
|
374
|
-
if (fidelity === "structured-clone")
|
|
375
|
-
return { ok: true, value };
|
|
376
|
-
try {
|
|
377
|
-
const encoded = JSON.stringify(value);
|
|
378
|
-
return { ok: true, value: encoded === undefined ? undefined : JSON.parse(encoded) };
|
|
379
|
-
}
|
|
380
|
-
catch (err) {
|
|
381
|
-
return { ok: false, cause: err };
|
|
382
|
-
}
|
|
383
|
-
}
|
|
384
316
|
export function resolveCheckpointStore(spec, deps) {
|
|
385
317
|
if (Object.is(spec.checkpointStore, null))
|
|
386
318
|
throw retiredCheckpointStoreNull();
|
|
@@ -539,9 +471,9 @@ function captureActorAssertion(actor) {
|
|
|
539
471
|
return { id, hostAsserted, ...(issuer !== undefined ? { issuer } : {}) };
|
|
540
472
|
}
|
|
541
473
|
export function readPendingSteerQueue(state) {
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
474
|
+
const retired = retiredSteerSeatRefusal(state);
|
|
475
|
+
if (retired !== undefined)
|
|
476
|
+
throw retired;
|
|
545
477
|
return [...(state.pendingSteerQueue ?? [])].sort((a, b) => a.seq - b.seq);
|
|
546
478
|
}
|
|
547
479
|
export function judgeParkedSteerRepeat(queue, entry) {
|
|
@@ -574,17 +506,19 @@ export function appendPendingSteer(state, entry) {
|
|
|
574
506
|
export function checkpointRowMatches(cp, scope, status) {
|
|
575
507
|
return cp !== undefined && cp.scope === scope && cp.status === status;
|
|
576
508
|
}
|
|
509
|
+
const IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ disclose: 0, sessionHeadOf: 0, holderIsCurrent: 0, retention: 0 });
|
|
577
510
|
export class InMemoryCheckpointStore {
|
|
578
511
|
retention;
|
|
579
512
|
durability = "process-local";
|
|
580
513
|
fidelity = "structured-clone";
|
|
581
514
|
execution = { outcome: true };
|
|
582
515
|
cps = new Map();
|
|
516
|
+
rowVerdicts = new WeakMap();
|
|
583
517
|
fault = null;
|
|
584
518
|
disclose;
|
|
585
519
|
holderIsCurrent;
|
|
586
520
|
constructor(options) {
|
|
587
|
-
const opts = receiveOptions(options, "InMemoryCheckpointStore");
|
|
521
|
+
const opts = receiveOptions(options, "InMemoryCheckpointStore", IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS);
|
|
588
522
|
this.retention = readRetentionDeclaration("InMemoryCheckpointStore.retention", opts.retention);
|
|
589
523
|
this.disclose = opts.disclose;
|
|
590
524
|
this.holderIsCurrent = opts.holderIsCurrent;
|
|
@@ -613,7 +547,7 @@ export class InMemoryCheckpointStore {
|
|
|
613
547
|
current: {
|
|
614
548
|
status: cp.status,
|
|
615
549
|
rev: checkpointRevOf(cp),
|
|
616
|
-
...(cp
|
|
550
|
+
...(memberPresent(cp, "resolvedOutcome") ? { resolvedOutcome: structuredClone(cp.resolvedOutcome) } : {}),
|
|
617
551
|
},
|
|
618
552
|
};
|
|
619
553
|
}
|
|
@@ -634,7 +568,7 @@ export class InMemoryCheckpointStore {
|
|
|
634
568
|
cp.rev = checkpointRevOf(cp) + 1;
|
|
635
569
|
if (winnerClone)
|
|
636
570
|
cp.resolvedOutcome = winnerClone;
|
|
637
|
-
cp.reopenReason
|
|
571
|
+
delete cp.reopenReason;
|
|
638
572
|
return { claimed: true };
|
|
639
573
|
}
|
|
640
574
|
claimExpireCore(token, scope) {
|
|
@@ -725,7 +659,7 @@ export class InMemoryCheckpointStore {
|
|
|
725
659
|
const out = [];
|
|
726
660
|
for (const cp of this.cps.values()) {
|
|
727
661
|
if (cp.scope === scope && cp.status === "pending")
|
|
728
|
-
out.push(
|
|
662
|
+
out.push(summarizeStoredCheckpoint(cp, this.rowVerdicts, this.disclose));
|
|
729
663
|
}
|
|
730
664
|
return out;
|
|
731
665
|
}
|
|
@@ -737,7 +671,7 @@ export class InMemoryCheckpointStore {
|
|
|
737
671
|
return [...out];
|
|
738
672
|
}
|
|
739
673
|
async listOverdue(query) {
|
|
740
|
-
return selectOverduePage(this.cps.entries(), readCheckpointOverdueQuery(query), (cp) =>
|
|
674
|
+
return selectOverduePage(this.cps.entries(), readCheckpointOverdueQuery(query), (cp) => summarizeStoredCheckpoint(cp, this.rowVerdicts, this.disclose), this.disclose);
|
|
741
675
|
}
|
|
742
676
|
async listBySession(query) {
|
|
743
677
|
return selectSessionPage(this.cps.entries(), readCheckpointSessionQuery(query), (cp) => structuredClone(cp), this.disclose);
|
|
@@ -749,35 +683,3 @@ export class InMemoryCheckpointStore {
|
|
|
749
683
|
return this.cps.size;
|
|
750
684
|
}
|
|
751
685
|
}
|
|
752
|
-
const RETIRED_MODE_SEED_MEMBERS = Object.freeze([
|
|
753
|
-
["autoModeRequested", () => true],
|
|
754
|
-
["approverPosture", () => true],
|
|
755
|
-
["shellGate", (v) => v !== "always"],
|
|
756
|
-
]);
|
|
757
|
-
export function refuseRetiredModeSeed(state) {
|
|
758
|
-
const gate = state.inheritedGate;
|
|
759
|
-
if (gate === undefined)
|
|
760
|
-
return;
|
|
761
|
-
for (const [key, retired] of RETIRED_MODE_SEED_MEMBERS) {
|
|
762
|
-
const value = gate[key];
|
|
763
|
-
if (value === undefined || !retired(value))
|
|
764
|
-
continue;
|
|
765
|
-
const shown = typeof value === "string" ? JSON.stringify(value.slice(0, 40)) : typeof value === "boolean" ? String(value) : typeof value;
|
|
766
|
-
throw new CheckpointError("checkpoint.unsupported_version", `this checkpoint's inheritedGate carries the retired mode-seed member \`${key}\` (${shown}), written before 7.34.0 and read by no engine since 7.39.0 — resume it once on an engine at 7.38.x or earlier (which reads it into \`permissionMode\`), or expire the row (\`CheckpointStore.expire\`); nothing was consumed`, { reason: "seat_retired" });
|
|
767
|
-
}
|
|
768
|
-
}
|
|
769
|
-
export function recordedModeSeed(gate) {
|
|
770
|
-
if (gate === undefined)
|
|
771
|
-
return {};
|
|
772
|
-
const refusal = (message) => {
|
|
773
|
-
const e = new Error(message);
|
|
774
|
-
e.code = "config.permission_mode_invalid";
|
|
775
|
-
return e;
|
|
776
|
-
};
|
|
777
|
-
const { permissionMode, prePlanMode, shellGate } = gate;
|
|
778
|
-
if (permissionMode !== undefined && !isPermissionMode(permissionMode))
|
|
779
|
-
throw refusal(`the checkpoint row's inheritedGate.permissionMode is ${JSON.stringify(permissionMode)}, not a permission mode — the row cannot be resumed under a mode this engine does not know`);
|
|
780
|
-
if (prePlanMode !== undefined && (!isPermissionMode(prePlanMode) || prePlanMode === "plan"))
|
|
781
|
-
throw refusal(`the checkpoint row's inheritedGate.prePlanMode is ${JSON.stringify(prePlanMode)}, not a permission mode a plan can return to`);
|
|
782
|
-
return { ...(permissionMode !== undefined ? { permissionMode } : {}), ...(prePlanMode !== undefined ? { prePlanMode } : {}), ...(shellGate !== undefined ? { shellGate } : {}) };
|
|
783
|
-
}
|
|
@@ -259,8 +259,9 @@ export declare function clampRecordError(message: string): Error & {
|
|
|
259
259
|
/**
|
|
260
260
|
* Refuse a caller-supplied clamp record that names a seat the table does not have (or, with `carrier`, a row another
|
|
261
261
|
* carrier hands on): a name nobody reads would sit on the record as if wired — the silent drop the retired-key door
|
|
262
|
-
* exists to prevent. `extra` names the record's own members that are not rows. Absent ⇒ nothing to judge
|
|
263
|
-
*
|
|
262
|
+
* exists to prevent. `extra` names the record's own members that are not rows. Absent ⇒ nothing to judge. The record is
|
|
263
|
+
* judged by the engine's one name judgment (every own key a row's name, whatever its value: a stray key holding `undefined`
|
|
264
|
+
* is a stray key); no value is read here — the readers read the record itself.
|
|
264
265
|
*/
|
|
265
266
|
export declare function assertClampRecord(record: unknown, owner: string, carrier?: ClampCarrier, extra?: readonly string[]): void;
|
|
266
267
|
/**
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { readDenyEntryProblem } from "../tools/fs/read-deny.js";
|
|
2
2
|
import { COMPLIANCE_CAPABILITIES, complianceCapabilityProblem } from "./compliance.js";
|
|
3
|
+
import { strayMembersOf } from "./own-property-receipt.js";
|
|
3
4
|
import { writeProtectedEntryIdentity, writeProtectedEntryProblem } from "./write-protect.js";
|
|
4
5
|
function readDenyIdentity(entry) {
|
|
5
6
|
return typeof entry === "string" ? `i:${entry}` : `${entry.caseSensitive === true ? "s" : "i"}:${entry.pattern}`;
|
|
@@ -235,9 +236,9 @@ export function assertClampRecord(record, owner, carrier, extra = []) {
|
|
|
235
236
|
if (record === null || typeof record !== "object")
|
|
236
237
|
throw clampRecordError(`${owner} must be a record of clamp seats, got ${record === null ? "null" : typeof record}`);
|
|
237
238
|
const legal = [...ROWS.filter(([, row]) => carrier === undefined || row.carrier === carrier).map(([seat]) => seat), ...extra];
|
|
238
|
-
const unknown =
|
|
239
|
-
if (unknown
|
|
240
|
-
throw clampRecordError(`${owner} names ${unknown.map((k) => JSON.stringify(k)).join(", ")}, which the clamp table does not carry there — the legal seats are ${legal.join(", ")}. Refused rather than ignored: a seat nobody reads would read to the caller as wired.`);
|
|
239
|
+
const unknown = strayMembersOf(record, { subject: owner, unit: "clamp seat", moment: "when the record is handed in" }, legal)?.names;
|
|
240
|
+
if (unknown !== undefined) {
|
|
241
|
+
throw clampRecordError(`${owner} names ${unknown.map((k) => JSON.stringify(String(k))).join(", ")}, which the clamp table does not carry there — the legal seats are ${legal.join(", ")}. Refused rather than ignored: a seat nobody reads would read to the caller as wired.`);
|
|
241
242
|
}
|
|
242
243
|
}
|
|
243
244
|
export function readClampFloor(floor) {
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The engine's one "did you mean" reading: the nearest name to a misspelled one, within two edits. A leaf (it imports
|
|
3
|
+
* nothing), so a low-level door — the options receipt — can name the near miss without depending on the task registry
|
|
4
|
+
* that first needed it.
|
|
5
|
+
*/
|
|
6
|
+
/** CC `gtr` (fable 复审 F1 — 亲核 @16169850: NOT plain Levenshtein but OSA / restricted
|
|
7
|
+
* Damerau-Levenshtein, WITH the adjacent-transposition term `o[i][s]=min(o[i][s], o[i-2][s-2]+1)`
|
|
8
|
+
* when `e[i-1]===t[s-2] && e[i-2]===t[s-1]`). The transposition matters: a typo like "tset"→"test"
|
|
9
|
+
* is distance 1 (CC has a Did-you-mean), plain Levenshtein would call it 2. */
|
|
10
|
+
export declare function editDistance(a: string, b: string): number;
|
|
11
|
+
/** CC `htr` shape (206:519814-519827): candidates within Levenshtein ≤2 (length-diff ≤2 pre-filter),
|
|
12
|
+
* best-first; the single best is the "Did you mean" suggestion (`htr(e, keys, 1)[0]`, 206:575196). */
|
|
13
|
+
export declare function closestName(query: string, candidates: Iterable<string>): string | undefined;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
export function editDistance(a, b) {
|
|
2
|
+
if (a === b)
|
|
3
|
+
return 0;
|
|
4
|
+
const m = a.length;
|
|
5
|
+
const n = b.length;
|
|
6
|
+
const d = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
|
|
7
|
+
for (let i = 1; i <= m; i++) {
|
|
8
|
+
for (let j = 1; j <= n; j++) {
|
|
9
|
+
const cost = a[i - 1] === b[j - 1] ? 0 : 1;
|
|
10
|
+
d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
|
|
11
|
+
if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
|
|
12
|
+
d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
return d[m][n];
|
|
17
|
+
}
|
|
18
|
+
export function closestName(query, candidates) {
|
|
19
|
+
let best;
|
|
20
|
+
let bestDist = 3;
|
|
21
|
+
const seen = new Set();
|
|
22
|
+
for (const c of candidates) {
|
|
23
|
+
if (seen.has(c))
|
|
24
|
+
continue;
|
|
25
|
+
seen.add(c);
|
|
26
|
+
if (Math.abs(c.length - query.length) > 2)
|
|
27
|
+
continue;
|
|
28
|
+
const dist = editDistance(query, c);
|
|
29
|
+
if (dist <= 2 && dist < bestDist) {
|
|
30
|
+
bestDist = dist;
|
|
31
|
+
best = c;
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
return best;
|
|
35
|
+
}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { tierAliasVia } from "./roles.js";
|
|
2
|
+
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
3
|
+
const OVERLAY_KEYS = optionKeys()({ contextTokens: 0, autoCompactTokens: 0, enabled: 0 });
|
|
2
4
|
export function contextOverlayFor(settings, ref, catalog) {
|
|
3
5
|
if (settings === undefined || typeof ref !== "string")
|
|
4
6
|
return undefined;
|
|
@@ -26,11 +28,7 @@ export function assertContextSettingsValue(v, where) {
|
|
|
26
28
|
if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
|
|
27
29
|
throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] must be a plain object (got ${raw === null ? "null" : Array.isArray(raw) ? "array" : typeof raw})`);
|
|
28
30
|
}
|
|
29
|
-
const o = raw;
|
|
30
|
-
const unknown = Object.keys(o).filter((k) => k !== "contextTokens" && k !== "autoCompactTokens" && k !== "enabled");
|
|
31
|
-
if (unknown.length > 0) {
|
|
32
|
-
throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] carries ${unknown.map((k) => JSON.stringify(k)).join(", ")} — this seat declares window geometry only (contextTokens | autoCompactTokens | enabled); routing, pricing and fencing stay on the model card`);
|
|
33
|
-
}
|
|
31
|
+
const o = receiveMembers(raw, { subject: `${where}: contextSettings[${JSON.stringify(word)}]`, unit: "member", moment: "when the overlay is read" }, OVERLAY_KEYS, (_, unknown) => new Error(`${where}: contextSettings[${JSON.stringify(word)}] carries ${unknown.map((k) => JSON.stringify(String(k))).join(", ")} — this seat declares window geometry only (contextTokens | autoCompactTokens | enabled); routing, pricing and fencing stay on the model card`));
|
|
34
32
|
for (const k of ["contextTokens", "autoCompactTokens"]) {
|
|
35
33
|
const n = o[k];
|
|
36
34
|
if (n !== undefined && (typeof n !== "number" || !Number.isFinite(n) || n <= 0)) {
|
|
@@ -57,7 +57,7 @@ export interface BoundaryLegsGiven {
|
|
|
57
57
|
readonly legs: readonly BoundaryLeg[];
|
|
58
58
|
readonly env?: Pick<ExecutionEnv, "capabilities">;
|
|
59
59
|
}
|
|
60
|
-
/** What a leg's session is still owed when the leg ends: the legs each unfinished background task its access (the
|
|
60
|
+
/** What a leg's session is still owed when the leg ends: the legs each unfinished background task its access (the registry task access) delivers
|
|
61
61
|
* along, read as the poll the session's next leg — another tree — would make of it (`TaskRegistry.owedDeliveries`). */
|
|
62
62
|
export type OwedDeliveries = () => readonly BoundaryLegsGiven[];
|
|
63
63
|
declare const CROSS_BOUNDARY_TREE_TOKEN: unique symbol;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type AssertAllKeysHandled } from "./ask-origin.js";
|
|
2
2
|
import type { DecisionMember, PermissionResult } from "./tool-policy.js";
|
|
3
3
|
export declare const refusedOutOfContract: (message: string) => PermissionResult;
|
|
4
4
|
/** Is `d` a refusal the engine itself minted (by object identity — a look-alike `deny` a caller built is not one)? The receipt's
|
|
@@ -47,6 +47,7 @@ export declare const DECISION_MEMBER_ARMS: Readonly<{
|
|
|
47
47
|
readonly origin: readonly ["ask"];
|
|
48
48
|
readonly askClass: readonly ["ask"];
|
|
49
49
|
readonly classes: readonly ["ask"];
|
|
50
|
+
readonly askReasons: readonly ["ask"];
|
|
50
51
|
readonly ruleUnreadable: readonly ["ask"];
|
|
51
52
|
readonly authoredBy: readonly ["ask"];
|
|
52
53
|
readonly editRewritten: readonly ["ask"];
|
|
@@ -54,6 +55,17 @@ export declare const DECISION_MEMBER_ARMS: Readonly<{
|
|
|
54
55
|
export type DecisionMemberArmsCoverTheUnion = AssertAllKeysHandled<{
|
|
55
56
|
[M in DecisionMember]: Exclude<ArmOf<M>, (typeof DECISION_MEMBER_ARMS)[M][number]>;
|
|
56
57
|
}[DecisionMember]>;
|
|
58
|
+
/**
|
|
59
|
+
* The members a PreToolUse hook's answer carries beyond the decision's, with their arms — the hook seat's half of the member ×
|
|
60
|
+
* arm table, read by the same screen: `additionalContext` (the text appended for the model, any arm) and `questionCause` (WHY
|
|
61
|
+
* the hook asked, {@link import("./ask-origin.js").HookQuestionCause} — the ask arm only). The hook seat's member list is the
|
|
62
|
+
* decision's plus these.
|
|
63
|
+
*/
|
|
64
|
+
export declare const HOOK_SEAT_MEMBER_ARMS: Readonly<{
|
|
65
|
+
readonly additionalContext: readonly ["allow", "ask", "deny"];
|
|
66
|
+
readonly questionCause: readonly ["ask"];
|
|
67
|
+
}>;
|
|
68
|
+
export type HookSeatMember = keyof typeof HOOK_SEAT_MEMBER_ARMS;
|
|
57
69
|
/**
|
|
58
70
|
* WHO writes each member of the decision union — one writer per fact, one table (fenced to the union like
|
|
59
71
|
* {@link DECISION_MEMBER_ARMS}: a member the union gains without a row is a type error):
|
|
@@ -85,6 +97,7 @@ export declare const DECISION_MEMBER_WRITERS: Readonly<{
|
|
|
85
97
|
readonly origin: "stamp";
|
|
86
98
|
readonly askClass: "stamp";
|
|
87
99
|
readonly classes: "stamp";
|
|
100
|
+
readonly askReasons: "stamp";
|
|
88
101
|
readonly ruleUnreadable: "composer";
|
|
89
102
|
readonly authoredBy: "composer";
|
|
90
103
|
readonly editRewritten: "composer";
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { types } from "node:util";
|
|
2
|
+
import { HOOK_QUESTION_CAUSES, isHookQuestionCause } from "./ask-origin.js";
|
|
2
3
|
import { AUTO_MODE_FALLBACK_CAUSES, isAutoModeFallbackCause, isDenialLimitBound } from "./auto-mode.js";
|
|
3
4
|
import { thrownText } from "./thrown-value.js";
|
|
4
5
|
const ENGINE_REFUSALS = new WeakSet();
|
|
@@ -26,6 +27,7 @@ const CLOSED_MEMBERS = [
|
|
|
26
27
|
{ member: "probeMandated", words: [true], has: (v) => v === true },
|
|
27
28
|
{ member: "crossBoundaryMandated", words: [true], has: (v) => v === true },
|
|
28
29
|
{ member: "mandated", words: [true], has: (v) => v === true },
|
|
30
|
+
{ member: "questionCause", words: HOOK_QUESTION_CAUSES, has: isHookQuestionCause },
|
|
29
31
|
];
|
|
30
32
|
const EVERY_ARM = ["allow", "ask", "deny"];
|
|
31
33
|
const ASK = ["ask"];
|
|
@@ -33,15 +35,16 @@ export const DECISION_MEMBER_ARMS = Object.freeze({
|
|
|
33
35
|
action: EVERY_ARM, updatedInput: EVERY_ARM, message: EVERY_ARM, decisionReason: EVERY_ARM, attestation: EVERY_ARM,
|
|
34
36
|
requiresRealApproval: ASK, denialLimitFallback: ASK, classifierNoRuling: ASK, allowRuleShadowed: ASK, probeReason: ASK, probeCause: ASK,
|
|
35
37
|
probeMandated: ASK, crossBoundaryMandated: ASK, mandated: ASK, mandate: ASK, probeReadRootCandidate: ASK, matchedAskRule: ASK, ruleEvidence: ASK,
|
|
36
|
-
segmentCoverage: ASK, origin: ASK, askClass: ASK, classes: ASK, ruleUnreadable: ASK, authoredBy: ASK,
|
|
38
|
+
segmentCoverage: ASK, origin: ASK, askClass: ASK, classes: ASK, askReasons: ASK, ruleUnreadable: ASK, authoredBy: ASK,
|
|
37
39
|
editRewritten: ASK,
|
|
38
40
|
});
|
|
41
|
+
export const HOOK_SEAT_MEMBER_ARMS = Object.freeze({ additionalContext: EVERY_ARM, questionCause: ASK });
|
|
39
42
|
export const DECISION_MEMBER_WRITERS = Object.freeze({
|
|
40
43
|
action: "composer", updatedInput: "composer", message: "composer", decisionReason: "composer", attestation: "record",
|
|
41
44
|
requiresRealApproval: "composer", denialLimitFallback: "composer", classifierNoRuling: "composer", allowRuleShadowed: "stamp", probeReason: "composer",
|
|
42
45
|
probeCause: "composer", probeMandated: "composer", crossBoundaryMandated: "composer", mandated: "composer", mandate: "stamp",
|
|
43
46
|
probeReadRootCandidate: "composer", matchedAskRule: "composer", ruleEvidence: "stamp", segmentCoverage: "stamp", origin: "stamp", askClass: "stamp",
|
|
44
|
-
classes: "stamp", ruleUnreadable: "composer", authoredBy: "composer", editRewritten: "composer",
|
|
47
|
+
classes: "stamp", askReasons: "stamp", ruleUnreadable: "composer", authoredBy: "composer", editRewritten: "composer",
|
|
45
48
|
});
|
|
46
49
|
const STAMP_MEMBERS = Object.keys(DECISION_MEMBER_WRITERS).filter((m) => DECISION_MEMBER_WRITERS[m] === "stamp");
|
|
47
50
|
const RETIRED_WINDOW_MEMBER = "autoDenyAfterMs";
|
|
@@ -101,7 +104,7 @@ export function screenContractValues(contract, opts) {
|
|
|
101
104
|
return unrecognized(member, v, words);
|
|
102
105
|
}
|
|
103
106
|
const arm = contract.action;
|
|
104
|
-
for (const [member, arms] of Object.entries(DECISION_MEMBER_ARMS)) {
|
|
107
|
+
for (const [member, arms] of Object.entries({ ...DECISION_MEMBER_ARMS, ...HOOK_SEAT_MEMBER_ARMS })) {
|
|
105
108
|
if (contract[member] === undefined || (arm === undefined ? EVERY_ARM.every((a) => arms.includes(a)) : arms.includes(arm)))
|
|
106
109
|
continue;
|
|
107
110
|
return refusedOutOfContract(`a permission decision carries "${member}" on ${arm === undefined ? "a result with no action (no opinion)" : `its "${arm}" arm`} — the member belongs to ` +
|
|
@@ -11,8 +11,10 @@ import type { TaskEvent } from "./task-event.js";
|
|
|
11
11
|
/**
|
|
12
12
|
* design/129-B — one lifecycle event of a BACKGROUND delegation child, delivered to the
|
|
13
13
|
* process-level {@link RunnerDeps.onBackgroundChildEvent} observer. Keys: `taskId` is the registry handle
|
|
14
|
-
* (`a*` domain — the
|
|
15
|
-
*
|
|
14
|
+
* (`a*` domain — the TaskStop / host-poll key), which is also the child run's own task id, so the child's
|
|
15
|
+
* own `task_progress` frames carry it; `sessionId` is the child run's session (uuid domain);
|
|
16
|
+
* `progressTaskId` is the task id of the leg whose frame a tick forwards (the child's own, or a nested
|
|
17
|
+
* descendant's).
|
|
16
18
|
*
|
|
17
19
|
* `kind: "spawn"` announces a fleet ROW's birth, which is a different fact from a child RUN's start
|
|
18
20
|
* (`TaskEvent` `task_started`): an `a*` row is born when its lane registers it, before the child run
|
|
@@ -24,9 +26,9 @@ export interface BackgroundChildEvent {
|
|
|
24
26
|
kind: "spawn" | "tick" | "terminal";
|
|
25
27
|
/** Row key, stable across all three kinds. The prefix is the DOMAIN DISCRIMINATOR (load-bearing,
|
|
26
28
|
* not opaque — design/149): `a*` = registry handle (background subagent —
|
|
27
|
-
*
|
|
28
|
-
* row (NOT a registry row — per-agent read face is the workflow's
|
|
29
|
-
*
|
|
29
|
+
* TaskStop addressable, fleet-footer display lane); `wa*` = synthetic workflow-agent
|
|
30
|
+
* row (NOT a registry row — per-agent read face is the workflow run's agent rows in its completion
|
|
31
|
+
* record + journal API). Display contract (CC anchor): CC's footer renders ONLY the
|
|
30
32
|
* workflow AGGREGATE row — `wa*` rows are read-face/observability rows and SHOULD NOT be
|
|
31
33
|
* rendered in the footer fleet tree; shells filter on the prefix. */
|
|
32
34
|
taskId: string;
|
|
@@ -79,9 +81,10 @@ export interface BackgroundChildEvent {
|
|
|
79
81
|
* authority; this field is the row-level convenience beside it.
|
|
80
82
|
*/
|
|
81
83
|
model?: string;
|
|
82
|
-
/** spawn: the HOST
|
|
83
|
-
*
|
|
84
|
-
*
|
|
84
|
+
/** spawn: the HOST leg's task id (parent attribution) — a host declared id, or the parent row's id
|
|
85
|
+
* when the host is itself a background sub-agent. Omitted when the host's task id is just its
|
|
86
|
+
* session id (a host that declared none, or a foreground child): writing it would launder a session
|
|
87
|
+
* id into a task-id field — the orphan-pointer shape; {@link parentSessionId} is the always-on linkage. */
|
|
85
88
|
parentTaskId?: string;
|
|
86
89
|
/** spawn: the HOST run's session id (uuid domain) — the always-on parent
|
|
87
90
|
* linkage, present whether or not a task id was declared. */
|
|
@@ -113,7 +116,8 @@ export interface BackgroundChildEvent {
|
|
|
113
116
|
* field (their own `taskId` is the per-child key). ABSENT, never invented, on a workflow started with no
|
|
114
117
|
* launching tool call. */
|
|
115
118
|
parentToolCallId?: string;
|
|
116
|
-
/** tick: the forwarded `task_progress` frame's own taskId (
|
|
119
|
+
/** tick: the forwarded `task_progress` frame's own taskId (the child's row id on its own ticks; a nested
|
|
120
|
+
* descendant's frame carries that descendant's task id). */
|
|
117
121
|
progressTaskId?: string;
|
|
118
122
|
/** tick: the forwarded frame's parentTaskId (nested attribution) · terminal: absent. */
|
|
119
123
|
progressParentTaskId?: string;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { anchorSpelling, canonicalizeTarget, familyFor, hasWin32AliasedComponent, isAbsoluteForFamily, normalizeAbsPathLexically, pathFamilyOf, pathIdentityOf, spellingOfIdentity, win32NamespaceScreen } from "../tools/fs/safety.js";
|
|
2
2
|
import { declaredPathTargetOf, pathTargetValue, protectivePathTargetOf } from "./tool-registry.js";
|
|
3
|
-
import { symlinkChainHops } from "./path-identity.js";
|
|
3
|
+
import { leafChainMayHold, symlinkChainHops } from "./path-identity.js";
|
|
4
4
|
import { DEFAULT_GATE_AWAIT_TIMEOUT_MS, withGateTimeout } from "./gate-bounded-await.js";
|
|
5
5
|
import { thrownText } from "./thrown-value.js";
|
|
6
6
|
import { canonicalize } from "./canonical-json.js";
|
|
@@ -106,8 +106,7 @@ export async function readPath(env, spelled, base, bases, contract, signal) {
|
|
|
106
106
|
if (contract.views === "lexical" || env === undefined || family === undefined || lexical?.kind === "unreadable")
|
|
107
107
|
return { lexical, hops: [] };
|
|
108
108
|
const canonical = await canonicalizeTarget(env, spelled, signal, family, base);
|
|
109
|
-
const
|
|
110
|
-
const followsALink = canonical.ok && (climbs(spelled) || climbs(base) || lexical?.kind !== "path" || absoluteTargetIdentityOf(canonical.key, bases) !== lexical.identity);
|
|
109
|
+
const followsALink = canonical.ok && leafChainMayHold([spelled, base], lexical?.kind !== "path" || absoluteTargetIdentityOf(canonical.key, bases) !== lexical.identity, family);
|
|
111
110
|
const chain = contract.views === "chain" && followsALink
|
|
112
111
|
? await withGateTimeout(symlinkChainHops(env, spelled, signal, family, base), DEFAULT_GATE_AWAIT_TIMEOUT_MS, signal, "canonicalChain").catch((err) => ({ ok: false, cause: thrownText(err), asked: true }))
|
|
113
112
|
: { ok: true, hops: [] };
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
* A leaf (type-only imports): the decision module that receives a record and the class derivation that reads one for its call
|
|
16
16
|
* both depend on it, and neither depends on the other through it.
|
|
17
17
|
*/
|
|
18
|
-
import type { AskClass, AskOrigin } from "./ask-origin.js";
|
|
18
|
+
import type { AskClass, AskOrigin, AskReason } from "./ask-origin.js";
|
|
19
19
|
import type { ClassifierDenyCause, Settlement } from "./gate-outcome.js";
|
|
20
20
|
import type { AutoModeClassifierRound } from "./auto-mode.js";
|
|
21
21
|
import type { AskUnresolvableCause } from "./ask-unresolvable-notice.js";
|
|
@@ -56,6 +56,16 @@ export interface EngineAttestation {
|
|
|
56
56
|
/** A seat refused the call's arguments because no approval can be bound to them: the refusal's sentence, carried by the
|
|
57
57
|
* refusal itself — the gate's deny exit reads it (the remedy it gives) instead of judging again. */
|
|
58
58
|
readonly bindingRefusal?: string;
|
|
59
|
+
/** The engine's own generic question the ask was composed with (the write gate's default "approve write to" sentence, the
|
|
60
|
+
* permission mode's own question) — not anyone's reason. The chain's entry mint ({@link
|
|
61
|
+
* import("./ask-origin.js").chainAskReasonsOf}) writes no entry while the ask's `message` IS this sentence; a later layer
|
|
62
|
+
* that spread the ask and put its own words in `message` keeps them. Written only by the station that composed that
|
|
63
|
+
* sentence, for that sentence; a composer cannot state it (an unbranded record is refused). */
|
|
64
|
+
readonly genericQuestion?: string;
|
|
65
|
+
/** The askers a station read off this ask where it first received it, before it narrated the sentence (an inherited station
|
|
66
|
+
* floating an ancestor's ask back into this leg's fold: its mark frames, its denial-limit fallback's sentence). The chain's
|
|
67
|
+
* entry mint takes these instead of the sentence; empty = the station read no asker. Written only by that float. */
|
|
68
|
+
readonly receivedAskReasons?: readonly AskReason[];
|
|
59
69
|
}
|
|
60
70
|
/** The members a station attests — everything but the call binding. */
|
|
61
71
|
export type AttestationMembers = Omit<EngineAttestation, "toolCallId" | "toolName">;
|