@sema-agent/core 7.59.0 → 7.61.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 +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- 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 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- 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 +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- 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 +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- 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/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- 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-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- 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/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- 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 +106 -32
- 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 +15 -0
- package/dist/core/frame-settlement.js +10 -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 +9 -6
- package/dist/core/gate-lanes.js +46 -12
- 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 +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -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 +55 -3
- package/dist/core/locked-config.js +84 -51
- 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-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -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 +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- 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 +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- 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 +23 -55
- package/dist/core/mcp.js +172 -156
- 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-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- 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/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- 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/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- 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 +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- 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 +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -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 +141 -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 +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- 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 +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- 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/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- 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/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -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 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- 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/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- 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 +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- 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/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- 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/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- 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 +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- 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 +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- 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-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -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 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- 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-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- 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 +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- 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 +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- 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 +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- 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/skills-seat.js +2 -2
- 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 +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- 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 -4
- 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.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- 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-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- 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 +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- 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 +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -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/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- 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 +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- 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 +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- 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.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- 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 +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- 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 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- 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 +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- 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 +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- 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.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- 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.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -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/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- 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 +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- 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/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,33 +1,8 @@
|
|
|
1
1
|
import type { AgentMessage } from "../internal/harness-types.js";
|
|
2
|
-
import type
|
|
3
|
-
|
|
4
|
-
* Aggregate MEDIA (image) byte budget — the multimodal sibling of {@link AGGREGATE_TOOL_RESULT_BUDGET_CHARS}
|
|
5
|
-
* (which only counts TEXT, design/64 §17.2). batch-C added image reads (`Read` → `ImageContent`); each is bounded
|
|
6
|
-
* per-image (`MAX_IMAGE_READ_BYTES`), but N images accumulate ACROSS turns in the context and would otherwise grow
|
|
7
|
-
* the request unboundedly (a real gap — the reference added the same cap, `tengu_media_byte_cap`, validating it).
|
|
8
|
-
*
|
|
9
|
-
* This caps the SUM of inline image bytes across the whole message list: while over budget, the OLDEST images are
|
|
10
|
-
* stripped (replaced with a short text marker) until it fits — recent media (most relevant) is kept. Like the text
|
|
11
|
-
* budget it is a REQUEST-ONLY, NON-DESTRUCTIVE transform (returns a new array; the durable session keeps the full
|
|
12
|
-
* image, and the model can re-`Read` the file if it still needs it) applied in the `harness.on("context")` hook,
|
|
13
|
-
* and DETERMINISTIC (same messages + limit → same strip set → byte-identical request → prompt-cache safe).
|
|
14
|
-
*/
|
|
15
|
-
/** Default aggregate inline-media budget (bytes). Generous — only the pathological "N parallel huge image reads"
|
|
16
|
-
* case strips. Bounds the request while leaving normal multimodal use untouched. Overridable per-deployment. */
|
|
17
|
-
export declare const AGGREGATE_MEDIA_BUDGET_BYTES: number;
|
|
18
|
-
/** The one reading of a deployment's media budget (`RunnerDeps.mediaByteCapBytes`, screened by {@link checkedMediaByteCap}
|
|
19
|
-
* at `new Runner`), for both of its readers — the request strip below and the `tool_end.output` projection: absent ⇒
|
|
20
|
-
* {@link AGGREGATE_MEDIA_BUDGET_BYTES}; a finite positive number ⇒ itself; `0` or `Infinity` ⇒ no budget, `Infinity`
|
|
21
|
-
* (a direct caller of {@link capAggregateMediaBytes} that passes a negative or `NaN` meets the same no-op). */
|
|
22
|
-
export declare function mediaBudgetBytes(cap: number | undefined): number;
|
|
23
|
-
/** The deployment's media budget, screened once at `new Runner`: absent, a non-negative number of bytes, or `Infinity`
|
|
24
|
-
* (`0` and `Infinity` both mean "no budget"). A non-number, `NaN` or a negative is refused (`config.invalid_argument`),
|
|
25
|
-
* never read as "no budget". */
|
|
26
|
-
export declare function checkedMediaByteCap(value: unknown, seat: string): void;
|
|
2
|
+
import { type DocumentContent, type ImageContent } from "../internal/llm.js";
|
|
3
|
+
import { type RequestMediaLimits } from "./image-admission.js";
|
|
27
4
|
/** A media block: an image or a document whose payload is a base64 string. */
|
|
28
5
|
export type MediaBlock = ImageContent | DocumentContent;
|
|
29
|
-
/** The media type a block claims — its `type`, read once, when that is a media type — or `undefined` for any other value. */
|
|
30
|
-
export declare function claimedMediaType(block: unknown): MediaBlock["type"] | undefined;
|
|
31
6
|
/** Whether a value is a media block: its `type` is a media type and its `data` a string. A block of a media type with no
|
|
32
7
|
* string `data` is not one — a {@link MediaDescriptor} is such a block. */
|
|
33
8
|
export declare function isMediaBlock(block: unknown): block is MediaBlock;
|
|
@@ -49,24 +24,24 @@ export type MediaDescriptor = {
|
|
|
49
24
|
export declare function mediaBlockDescriptor(block: MediaBlock): MediaDescriptor;
|
|
50
25
|
/** The one summary of media blocks that leave together: how many, and their decoded size. */
|
|
51
26
|
export declare function omittedMediaDescriptor(blocks: readonly MediaBlock[]): MediaDescriptor;
|
|
52
|
-
/** Decoded byte size of a base64 media payload (4 base64 chars ≈ 3 bytes)
|
|
53
|
-
* PDF read: `document` blocks (base64 PDFs) count against the SAME aggregate budget — same class of inline
|
|
54
|
-
* media bytes, same unbounded-accumulation failure mode. */
|
|
27
|
+
/** Decoded byte size of a base64 media payload (4 base64 chars ≈ 3 bytes) — what a descriptor states of the block. */
|
|
55
28
|
export declare function imageBytes(b: ImageContent | DocumentContent): number;
|
|
56
|
-
/**
|
|
57
|
-
export interface
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
29
|
+
/** One block the trim took out: the input's own block object, and its type and base64 as the trim read them (once). */
|
|
30
|
+
export interface RemovedMedia {
|
|
31
|
+
block: object;
|
|
32
|
+
type: MediaBlock["type"];
|
|
33
|
+
data: string;
|
|
34
|
+
}
|
|
35
|
+
/** What one request's trim did: the request's messages (the input array itself when nothing went), the blocks that went
|
|
36
|
+
* (oldest first) and their base64 characters, and the request's media as it came — how many blocks, how many base64
|
|
37
|
+
* characters. */
|
|
38
|
+
export interface RequestMediaTrim {
|
|
39
|
+
messages: AgentMessage[];
|
|
40
|
+
removed: RemovedMedia[];
|
|
41
|
+
removedBase64Chars: number;
|
|
42
|
+
items: number;
|
|
43
|
+
base64Chars: number;
|
|
62
44
|
}
|
|
63
|
-
/**
|
|
64
|
-
*
|
|
65
|
-
|
|
66
|
-
* shallow-cloned array with the stripped messages replaced (originals untouched). `onStripped` fires once if anything
|
|
67
|
-
* was removed.
|
|
68
|
-
*/
|
|
69
|
-
export declare function capAggregateMediaBytes(messages: AgentMessage[], opts: {
|
|
70
|
-
limitBytes: number;
|
|
71
|
-
onStripped?: (info: MediaStripInfo) => void;
|
|
72
|
-
}): AgentMessage[];
|
|
45
|
+
/** Trim the media of `messages` to `limits` (see the module head). A block's size is its base64 length (CC `Pkn`), `0` for
|
|
46
|
+
* one that carries no base64 string — such a block counts toward `maxItems` and is never cut for the budget. */
|
|
47
|
+
export declare function trimRequestMedia(messages: AgentMessage[], limits: RequestMediaLimits): RequestMediaTrim;
|
|
@@ -1,23 +1,6 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { mediaRemovedPlaceholder } from "../internal/llm.js";
|
|
2
|
+
import { claimedMediaType } from "./image-admission.js";
|
|
2
3
|
import { readMember } from "./thrown-value.js";
|
|
3
|
-
export const AGGREGATE_MEDIA_BUDGET_BYTES = 30 * 1024 * 1024;
|
|
4
|
-
export function mediaBudgetBytes(cap) {
|
|
5
|
-
const limit = cap ?? AGGREGATE_MEDIA_BUDGET_BYTES;
|
|
6
|
-
return Number.isFinite(limit) && limit > 0 ? limit : Infinity;
|
|
7
|
-
}
|
|
8
|
-
export function checkedMediaByteCap(value, seat) {
|
|
9
|
-
if (value === undefined || (typeof value === "number" && value >= 0))
|
|
10
|
-
return;
|
|
11
|
-
const e = new Error(`${seat} ${describeRejectedValue(value)} is not a media byte budget — expected a non-negative number of bytes (0 or Infinity: no budget), or omit it for the default ${AGGREGATE_MEDIA_BUDGET_BYTES}`);
|
|
12
|
-
e.code = "config.invalid_argument";
|
|
13
|
-
throw e;
|
|
14
|
-
}
|
|
15
|
-
const MEDIA_STRIPPED_MARKER = "[media removed to fit the request media budget — re-read the file if you still need to see it]";
|
|
16
|
-
const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
|
|
17
|
-
export function claimedMediaType(block) {
|
|
18
|
-
const type = readMember(block, "type");
|
|
19
|
-
return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
|
|
20
|
-
}
|
|
21
4
|
const mediaTyped = (b) => claimedMediaType(b) !== undefined;
|
|
22
5
|
export function isMediaBlock(block) {
|
|
23
6
|
return mediaTyped(block) && typeof readMember(block, "data") === "string";
|
|
@@ -35,44 +18,61 @@ function blocksOf(m) {
|
|
|
35
18
|
const content = m.content;
|
|
36
19
|
return Array.isArray(content) ? content : undefined;
|
|
37
20
|
}
|
|
38
|
-
export function
|
|
39
|
-
const
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
21
|
+
export function trimRequestMedia(messages, limits) {
|
|
22
|
+
const media = [];
|
|
23
|
+
const contents = messages.map(blocksOf);
|
|
24
|
+
for (const [mi, blocks] of contents.entries()) {
|
|
25
|
+
const ordinal = { image: 0, document: 0 };
|
|
26
|
+
for (const [bi, b] of (blocks ?? []).entries()) {
|
|
27
|
+
const type = claimedMediaType(b);
|
|
28
|
+
if (type === undefined)
|
|
29
|
+
continue;
|
|
30
|
+
const data = readMember(b, "data");
|
|
31
|
+
media.push({ message: mi, block: bi, type, ordinal: ++ordinal[type], data: typeof data === "string" ? data : "" });
|
|
32
|
+
}
|
|
49
33
|
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
34
|
+
const sizes = media.map((m) => m.data.length);
|
|
35
|
+
const base64Total = sizes.reduce((n, s) => n + s, 0);
|
|
36
|
+
const cut = new Set();
|
|
37
|
+
const kept = [];
|
|
38
|
+
const keepAfterCountCut = Math.max(0, limits.maxItems - limits.margin);
|
|
39
|
+
let keptChars = 0;
|
|
40
|
+
for (const [i, size] of sizes.entries()) {
|
|
41
|
+
kept.push(i);
|
|
42
|
+
keptChars += size;
|
|
43
|
+
if (kept.length > limits.maxItems) {
|
|
44
|
+
for (const j of kept.splice(0, kept.length - keepAfterCountCut)) {
|
|
45
|
+
cut.add(j);
|
|
46
|
+
keptChars -= sizes[j];
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
if (keptChars > limits.budgetBase64Chars) {
|
|
50
|
+
for (let k = 0; k < kept.length && keptChars > limits.budgetBase64Chars - limits.hysteresisBase64Chars;) {
|
|
51
|
+
const j = kept[k];
|
|
52
|
+
if (sizes[j] === 0) {
|
|
53
|
+
k++;
|
|
54
|
+
continue;
|
|
55
|
+
}
|
|
56
|
+
kept.splice(k, 1);
|
|
57
|
+
cut.add(j);
|
|
58
|
+
keptChars -= sizes[j];
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
if (cut.size === 0)
|
|
63
|
+
return { messages, removed: [], removedBase64Chars: 0, items: sizes.length, base64Chars: base64Total };
|
|
64
|
+
const removed = [];
|
|
55
65
|
const out = messages.slice();
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
if (!
|
|
66
|
+
const rewritten = new Map();
|
|
67
|
+
for (const [i, at] of media.entries()) {
|
|
68
|
+
if (!cut.has(i))
|
|
59
69
|
continue;
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
remaining -= bytes;
|
|
65
|
-
removedBytes += bytes;
|
|
66
|
-
removedCount += 1;
|
|
67
|
-
changed = true;
|
|
68
|
-
return { type: "text", text: MEDIA_STRIPPED_MARKER };
|
|
69
|
-
}
|
|
70
|
-
return b;
|
|
71
|
-
});
|
|
72
|
-
if (changed)
|
|
73
|
-
out[i] = { ...out[i], content: next };
|
|
70
|
+
const blocks = rewritten.get(at.message) ?? contents[at.message].slice();
|
|
71
|
+
rewritten.set(at.message, blocks);
|
|
72
|
+
removed.push({ block: blocks[at.block], type: at.type, data: at.data });
|
|
73
|
+
blocks[at.block] = { type: "text", text: mediaRemovedPlaceholder("media_budget", at.type, at.ordinal) };
|
|
74
74
|
}
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
return out;
|
|
75
|
+
for (const [mi, content] of rewritten)
|
|
76
|
+
out[mi] = { ...messages[mi], content };
|
|
77
|
+
return { messages: out, removed, removedBase64Chars: removed.reduce((n, r) => n + r.data.length, 0), items: sizes.length, base64Chars: base64Total };
|
|
78
78
|
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `face`'s members `members`, read as one group. `undefined` when none is present and the group was not declared;
|
|
3
|
+
* the bound members when every one is a function; otherwise a refusal (`config.invalid_argument`) naming the group's
|
|
4
|
+
* owner and what is wrong. `declared` = the group's own container is present (a nested group object), so even zero
|
|
5
|
+
* members present is half a group.
|
|
6
|
+
*/
|
|
7
|
+
export declare function readMemberGroup<K extends string>(owner: string, face: object, members: readonly K[], declared?: boolean): Readonly<Record<K, (...args: never[]) => unknown>> | undefined;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
|
+
import { thrownText } from "./thrown-value.js";
|
|
3
|
+
function invalidGroup(message) {
|
|
4
|
+
const e = new Error(message);
|
|
5
|
+
e.code = "config.invalid_argument";
|
|
6
|
+
return e;
|
|
7
|
+
}
|
|
8
|
+
export function readMemberGroup(owner, face, members, declared = false) {
|
|
9
|
+
const read = new Map();
|
|
10
|
+
for (const member of members) {
|
|
11
|
+
let value;
|
|
12
|
+
try {
|
|
13
|
+
value = face[member];
|
|
14
|
+
}
|
|
15
|
+
catch (cause) {
|
|
16
|
+
throw invalidGroup(`${owner}.${member} could not be read (${thrownText(cause)}) — ${members.join(" / ")} are one capability, read as one group.`);
|
|
17
|
+
}
|
|
18
|
+
read.set(member, value);
|
|
19
|
+
}
|
|
20
|
+
const present = members.filter((m) => read.get(m) !== undefined);
|
|
21
|
+
if (present.length === 0 && !declared)
|
|
22
|
+
return undefined;
|
|
23
|
+
const missing = members.filter((m) => read.get(m) === undefined);
|
|
24
|
+
if (missing.length > 0) {
|
|
25
|
+
throw invalidGroup(`${owner} ${present.length === 0 ? "declares the group" : `carries ${present.join(" / ")}`} but not ${missing.join(" / ")} — ${members.join(" / ")} are one capability: every one of them, or none.`);
|
|
26
|
+
}
|
|
27
|
+
const out = {};
|
|
28
|
+
for (const member of members) {
|
|
29
|
+
const value = read.get(member);
|
|
30
|
+
if (typeof value !== "function")
|
|
31
|
+
throw invalidGroup(`${owner}.${member} is ${describeRejectedValue(value)}, not a function — ${members.join(" / ")} are one capability, each a function.`);
|
|
32
|
+
out[member] = value.bind(face);
|
|
33
|
+
}
|
|
34
|
+
return Object.freeze(out);
|
|
35
|
+
}
|
|
@@ -6,6 +6,26 @@ export interface MemoryScopeRequest {
|
|
|
6
6
|
scope: string;
|
|
7
7
|
origin: MemoryScopeOrigin;
|
|
8
8
|
}
|
|
9
|
+
/** A deployment-origin org scope: the only kind an admission with no caller is asked about. */
|
|
10
|
+
export interface DeploymentMemoryScopeRequest extends MemoryScopeRequest {
|
|
11
|
+
origin: "deployment";
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* What the resolver is asked, discriminated by whether a caller asks. `principal` a string: the caller's principal name,
|
|
15
|
+
* and the request may hold scopes of either origin. `principal: undefined`: no caller — the door has already refused
|
|
16
|
+
* every request-origin scope, so only deployment-origin ones are asked about. Caller presence is read once, at the door
|
|
17
|
+
* (`readPrincipal`: absent = omitted or the empty string; a provided value that is no name is refused); a resolver reads
|
|
18
|
+
* this discriminant and never decides absence for itself.
|
|
19
|
+
*/
|
|
20
|
+
export type MemoryScopeAdmissionInput = {
|
|
21
|
+
principal: string;
|
|
22
|
+
requested: ReadonlyArray<MemoryScopeRequest>;
|
|
23
|
+
requestedWriteScope: MemoryScopeRequest | null;
|
|
24
|
+
} | {
|
|
25
|
+
principal: undefined;
|
|
26
|
+
requested: ReadonlyArray<DeploymentMemoryScopeRequest>;
|
|
27
|
+
requestedWriteScope: DeploymentMemoryScopeRequest | null;
|
|
28
|
+
};
|
|
9
29
|
/**
|
|
10
30
|
* The resolver's verdict — exactly two states. `ok: true` carries the FROZEN admitted projection:
|
|
11
31
|
* `scopes` must be a subset of the requested org scopes (an unrequested grant is a resolver fault ⇒
|
|
@@ -23,16 +43,13 @@ export type MemoryAdmissionVerdict = {
|
|
|
23
43
|
/**
|
|
24
44
|
* The trusted deployment resolver ({@link import("./types.js").RunnerDeps.memoryScopeAdmission}).
|
|
25
45
|
* Receives ONLY the org-parsed scopes (non-org scopes are not its business), each tagged with its
|
|
26
|
-
* origin,
|
|
46
|
+
* origin, and the caller ({@link MemoryScopeAdmissionInput}). Both async and sync forms are accepted.
|
|
27
47
|
*/
|
|
28
|
-
export type MemoryScopeAdmission = (input:
|
|
29
|
-
principal: string | undefined;
|
|
30
|
-
requested: ReadonlyArray<MemoryScopeRequest>;
|
|
31
|
-
requestedWriteScope: MemoryScopeRequest | null;
|
|
32
|
-
}) => MemoryAdmissionVerdict | Promise<MemoryAdmissionVerdict>;
|
|
48
|
+
export type MemoryScopeAdmission = (input: MemoryScopeAdmissionInput) => MemoryAdmissionVerdict | Promise<MemoryAdmissionVerdict>;
|
|
33
49
|
/** Inputs to {@link admitMemoryScopes} — assembled by the prepare path (prepare-memory.ts). */
|
|
34
50
|
export interface MemoryAdmissionInput {
|
|
35
51
|
memorySpec: NormalizedMemorySpec;
|
|
52
|
+
/** The task's principal as given (`TaskSpec.principal`); the door reads caller presence from it. */
|
|
36
53
|
principal: string | undefined;
|
|
37
54
|
admission: MemoryScopeAdmission | undefined;
|
|
38
55
|
/** The deployment's self-certified org scopes (`RunnerDeps.deploymentMemoryScopes`). */
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { parseScopeKey } from "./memory-engine/scope-contract.js";
|
|
2
|
+
import { readPrincipal } from "./principal-name.js";
|
|
2
3
|
import { thrownText } from "./thrown-value.js";
|
|
3
4
|
function codedError(code, message) {
|
|
4
5
|
const e = new Error(message);
|
|
@@ -19,6 +20,22 @@ function orgScopesOf(spec) {
|
|
|
19
20
|
const writeOrg = spec.writeScope !== null && parseScopeKey(spec.writeScope).kind === "org" ? spec.writeScope : null;
|
|
20
21
|
return { readOrg, writeOrg };
|
|
21
22
|
}
|
|
23
|
+
const isDeploymentRequest = (r) => r.origin === "deployment";
|
|
24
|
+
function admissionInputOf(principal, requested, requestedWriteScope) {
|
|
25
|
+
const copy = (r) => ({ ...r });
|
|
26
|
+
const caller = readPrincipal(principal);
|
|
27
|
+
if (caller.kind === "name")
|
|
28
|
+
return { principal: caller.name, requested: requested.map(copy), requestedWriteScope: requestedWriteScope && copy(requestedWriteScope) };
|
|
29
|
+
if (caller.kind === "invalid") {
|
|
30
|
+
throw codedError("memory.admission_denied", `the task's principal is not a principal name (got ${caller.fault}) — org memory admission takes a principal name or none.`);
|
|
31
|
+
}
|
|
32
|
+
const deployment = requested.filter(isDeploymentRequest);
|
|
33
|
+
const write = requestedWriteScope === null || isDeploymentRequest(requestedWriteScope) ? requestedWriteScope : undefined;
|
|
34
|
+
if (deployment.length === requested.length && write !== undefined)
|
|
35
|
+
return { principal: undefined, requested: deployment.map(copy), requestedWriteScope: write && copy(write) };
|
|
36
|
+
throw codedError("memory.admission_denied", `org memory scope(s) ${requested.filter((r) => !isDeploymentRequest(r)).map((r) => `"${r.scope}"`).join(", ")} require an authenticated ` +
|
|
37
|
+
`TaskSpec.principal for admission — a principal-less request cannot be admitted to a tenant plane.`);
|
|
38
|
+
}
|
|
22
39
|
export async function admitMemoryScopes(input) {
|
|
23
40
|
const { memorySpec, principal, admission, deploymentScopes, parentAdmittedOrgScopes } = input;
|
|
24
41
|
const governed = admission !== undefined ||
|
|
@@ -109,17 +126,10 @@ export async function admitMemoryScopes(input) {
|
|
|
109
126
|
writeScopeNarrowed: false,
|
|
110
127
|
});
|
|
111
128
|
}
|
|
112
|
-
|
|
113
|
-
throw codedError("memory.admission_denied", `org memory scope(s) ${requestOrigin.map((r) => `"${r.scope}"`).join(", ")} require an authenticated ` +
|
|
114
|
-
`TaskSpec.principal for admission — a principal-less request cannot be admitted to a tenant plane.`);
|
|
115
|
-
}
|
|
129
|
+
const asked = admissionInputOf(principal, requests, writeOrg !== null ? requests[allOrg.indexOf(writeOrg)] : null);
|
|
116
130
|
let verdict;
|
|
117
131
|
try {
|
|
118
|
-
verdict = await admission(
|
|
119
|
-
principal,
|
|
120
|
-
requested: requests,
|
|
121
|
-
requestedWriteScope: writeOrg !== null ? { scope: writeOrg, origin: originOf(writeOrg) } : null,
|
|
122
|
-
});
|
|
132
|
+
verdict = await admission(asked);
|
|
123
133
|
}
|
|
124
134
|
catch (err) {
|
|
125
135
|
const hinted = err.retryAfterMs;
|
|
@@ -179,7 +179,7 @@ export interface ScreenedConsolidationOptions {
|
|
|
179
179
|
* - D-13a: `multiNode: true` without an injected lease refuses — the declaration exists exactly
|
|
180
180
|
* to make that omission explicit.
|
|
181
181
|
*/
|
|
182
|
-
export declare function screenConsolidationOptions(
|
|
182
|
+
export declare function screenConsolidationOptions(given: MemoryConsolidationOptions, provenance: "off" | "carry"): ScreenedConsolidationOptions;
|
|
183
183
|
/** §1.2-2 — the supersession fuse ceiling: min(N-1, max(floor, ⌊ratio×N⌋)); N ≤ 1 ⇒ 0 (one plan
|
|
184
184
|
* may NEVER empty the active set — the N-1 ceiling is unconditional, G21). */
|
|
185
185
|
export declare function supersessionFuseCeiling(activeSetSize: number, opts: Pick<ScreenedConsolidationOptions, "supersedeRatioCap" | "supersedeAbsoluteFloor">): number;
|
|
@@ -3,6 +3,7 @@ import { join } from "node:path";
|
|
|
3
3
|
import { uuidv7 } from "../../engine/session/uuid.js";
|
|
4
4
|
import { atomicWriteFileSync, lockedStrictUpdate, readStrictSidecar, ControlPlaneCorruptError, ensureDirExists } from "./layout.js";
|
|
5
5
|
import { thrownText } from "../thrown-value.js";
|
|
6
|
+
import { optionKeys, receiveMembers } from "../own-property-receipt.js";
|
|
6
7
|
export function deriveSupersededSet(headers, opts = {}) {
|
|
7
8
|
const byId = new Map();
|
|
8
9
|
for (const h of headers)
|
|
@@ -34,6 +35,10 @@ export function memorySupersededNote(carrierId) {
|
|
|
34
35
|
return `note: a newer consolidated entry supersedes this one — memory entry ${carrierId} carries the current form; this entry remains readable as evidence.`;
|
|
35
36
|
}
|
|
36
37
|
export const MEMORY_SEARCH_SUPERSEDED_TAG = "[superseded]";
|
|
38
|
+
const CONSOLIDATION_OPTION_KEYS = optionKeys()({
|
|
39
|
+
supersedeRatioCap: 0, supersedeAbsoluteFloor: 0, maxProductsPerRun: 0, maxInputsPerProduct: 0, maxDirectedPatchesPerPlan: 0, minRunIntervalMs: 0,
|
|
40
|
+
minSessionsBetweenRuns: 0, scanRefusalRatioCap: 0, scanRefusalMaxPerPlan: 0, allowInstructionProducts: 0, multiNode: 0, lease: 0,
|
|
41
|
+
});
|
|
37
42
|
export const CONSOLIDATION_DEFAULTS = {
|
|
38
43
|
supersedeRatioCap: 0.25,
|
|
39
44
|
supersedeAbsoluteFloor: 4,
|
|
@@ -53,10 +58,11 @@ function coded(message, code) {
|
|
|
53
58
|
e.code = code;
|
|
54
59
|
return e;
|
|
55
60
|
}
|
|
56
|
-
export function screenConsolidationOptions(
|
|
61
|
+
export function screenConsolidationOptions(given, provenance) {
|
|
57
62
|
if (provenance === "off") {
|
|
58
63
|
throw coded(`MemoryEngineOptions.consolidation cannot be enabled under provenance: "off" — the consolidation fold law must be able to mint origin markers (a marked input's product would otherwise commit unmarked). Enable provenance "carry" or remove the consolidation options.`, "config.memory_consolidation_provenance_off");
|
|
59
64
|
}
|
|
65
|
+
const raw = receiveMembers(given, { subject: "MemoryEngineOptions.consolidation", unit: "option", moment: "at construction" }, CONSOLIDATION_OPTION_KEYS);
|
|
60
66
|
const num = (name, v, check, want) => {
|
|
61
67
|
if (v === undefined)
|
|
62
68
|
return CONSOLIDATION_DEFAULTS[name];
|
|
@@ -34,6 +34,13 @@ export interface AgentToolFace {
|
|
|
34
34
|
* level and this face does not exclude the delegation tool). Such a child can reach any SIBLING
|
|
35
35
|
* face, so its own narrowing is not the boundary — see {@link delegationCallIsExternal}. */
|
|
36
36
|
canRedelegate?: boolean;
|
|
37
|
+
/** The MCP servers a child of this type declares itself (its definition's `mcp`), each with the content class its declaration states:
|
|
38
|
+
* tools of the child's universe that no pool row carries — a server lists them only once the child dials it — so a face reaches one
|
|
39
|
+
* of them exactly when its lists can admit a tool of that server, and it is classified by the server's declaration. */
|
|
40
|
+
servers?: ReadonlyArray<{
|
|
41
|
+
readonly name: string;
|
|
42
|
+
readonly contentOrigin?: ToolContentOrigin;
|
|
43
|
+
}>;
|
|
37
44
|
}
|
|
38
45
|
/** One tool in the pool a delegated child draws from — enough to classify it, nothing more. */
|
|
39
46
|
export interface AgentPoolTool {
|
|
@@ -78,6 +85,12 @@ export declare function delegationCallIsExternal(input: {
|
|
|
78
85
|
pool: ReadonlyArray<AgentPoolTool> | undefined;
|
|
79
86
|
/** Whether one pool tool carries a polluting class — the caller owns the deployment's config. */
|
|
80
87
|
isPolluting: (tool: AgentPoolTool) => boolean;
|
|
88
|
+
/** The MCP servers the spawning run declares, when the delegation tool's children inherit its mount: one of them may hold its namespace
|
|
89
|
+
* over a face's own server of the same namespace ({@link AgentToolFace.servers}), so it is counted beside it. */
|
|
90
|
+
inheritedServers?: ReadonlyArray<{
|
|
91
|
+
readonly name: string;
|
|
92
|
+
readonly contentOrigin?: ToolContentOrigin;
|
|
93
|
+
}>;
|
|
81
94
|
}): boolean;
|
|
82
95
|
/** Whether a tool of `origin` pollutes the session's memory when invoked (strict = the
|
|
83
96
|
* `execIsExternalContent` upgrade). */
|
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
import { resolveToolSubset } from "../../agents/tool-filter.js";
|
|
1
|
+
import { compileToolSelector, resolveToolSubset, valveLeaves, valveLeavesPeer } from "../../agents/tool-filter.js";
|
|
2
|
+
import { MCP_RESOURCE_FACES } from "../mounted-mcp.js";
|
|
3
|
+
import { mintNamespacePrefix } from "../protocol-naming.js";
|
|
4
|
+
import { MCP_NAMESPACE } from "../protocol-table.js";
|
|
2
5
|
const TOOL_CONTENT_ORIGIN_SET = { external: true, execution: true, local: true };
|
|
3
6
|
export const TOOL_CONTENT_ORIGINS = Object.keys(TOOL_CONTENT_ORIGIN_SET);
|
|
4
7
|
export function isToolContentOrigin(value) {
|
|
@@ -25,9 +28,24 @@ export function delegationCallIsExternal(input) {
|
|
|
25
28
|
if (face === undefined)
|
|
26
29
|
return true;
|
|
27
30
|
const selectedFor = (f) => resolveToolSubset(input.pool, f.allowTools, f.denyTools);
|
|
28
|
-
|
|
31
|
+
const broughtBy = (f) => {
|
|
32
|
+
if (f.servers === undefined || f.servers.length === 0)
|
|
33
|
+
return [];
|
|
34
|
+
const own = f.servers;
|
|
35
|
+
const lists = compileToolSelector([{ ...(f.allowTools !== undefined ? { allow: f.allowTools } : {}), deny: f.denyTools ?? [] }]);
|
|
36
|
+
const peerLeft = valveLeavesPeer({}, lists);
|
|
37
|
+
const sameNamespace = (input.inheritedServers ?? []).filter((p) => own.some((s) => mintNamespacePrefix(MCP_NAMESPACE, s.name) === mintNamespacePrefix(MCP_NAMESPACE, p.name)));
|
|
38
|
+
const namespaces = [...own, ...sameNamespace].flatMap((s) => {
|
|
39
|
+
const prefix = mintNamespacePrefix(MCP_NAMESPACE, s.name);
|
|
40
|
+
return peerLeft(prefix) ? [{ name: prefix, ...(s.contentOrigin !== undefined ? { contentOrigin: s.contentOrigin } : {}) }] : [];
|
|
41
|
+
});
|
|
42
|
+
const readers = MCP_RESOURCE_FACES.filter((name) => valveLeaves({}, lists)({ name })).map((name) => ({ name, contentOrigin: "external" }));
|
|
43
|
+
return [...namespaces, ...readers];
|
|
44
|
+
};
|
|
45
|
+
const reachesPolluting = (f) => [...selectedFor(f), ...broughtBy(f)].some((t) => input.isPolluting(t));
|
|
46
|
+
if (reachesPolluting(face))
|
|
29
47
|
return true;
|
|
30
|
-
if (face.canRedelegate === true && input.faces.some(
|
|
48
|
+
if (face.canRedelegate === true && input.faces.some(reachesPolluting))
|
|
31
49
|
return true;
|
|
32
50
|
return false;
|
|
33
51
|
}
|
|
@@ -2,6 +2,7 @@ import type { ParsedScopeKey } from "./scope-contract.js";
|
|
|
2
2
|
import type { HarvestReport, MemoryBackend } from "./types.js";
|
|
3
3
|
import type { MemoryInjection } from "./engine.js";
|
|
4
4
|
import { type MemoryPartitionIncidentSink } from "./layout.js";
|
|
5
|
+
import { type MemoryErasureAttestation } from "./file-backend.js";
|
|
5
6
|
/** The personal plane's shared mount under the config root (ALL projects, one home — the plane is
|
|
6
7
|
* keyed by scope, not by repo: `user:alice` is the same disk from every checkout). */
|
|
7
8
|
export declare function derivePersonalMemoryDir(configRoot: string): string;
|
|
@@ -69,6 +70,18 @@ export interface MemoryScopeStoreInput {
|
|
|
69
70
|
* as a session's opening does); resolve once per scope and keep it.
|
|
70
71
|
*/
|
|
71
72
|
export declare function resolveMemoryScopeStore(input: MemoryScopeStoreInput): MemoryScopeStore;
|
|
73
|
+
/** The two deployment facts a store resolution reads besides the backend, judged as {@link resolveMemoryScopeStore}
|
|
74
|
+
* states (required keys; `undefined` written out states absence) — one judgment for every face that takes them. */
|
|
75
|
+
export declare function judgeMemoryStoreSeat(face: string, input: {
|
|
76
|
+
scopeContract: "v2" | undefined;
|
|
77
|
+
memoryEngineDir: string | undefined;
|
|
78
|
+
}): void;
|
|
79
|
+
/** The plane carrying `scope`, read as a session spells the key: the Runner's own normalization (trimmed;
|
|
80
|
+
* under v2 the contract's parse), then {@link scopePlanesOf}. A key the contract cannot read, or a blank or
|
|
81
|
+
* non-string one, is refused (`config.memory_scope_key`). */
|
|
82
|
+
export declare function memoryScopePlaneOf(face: string, scope: unknown, scopeContract: "v2" | undefined): "project" | "personal";
|
|
83
|
+
/** The store-resolution input refusal (`config.memory_scope_key`), named by the face that refused. */
|
|
84
|
+
export declare function refuseMemoryStoreInput(face: string, what: string, v: unknown, cause?: unknown): never;
|
|
72
85
|
/** True when the classified session needs the dual-root assembly at all. */
|
|
73
86
|
export declare function needsDualRoots(planes: ScopePlanes): boolean;
|
|
74
87
|
/** Convenience for the placement gate: the parsed keys that stay on the PROJECT plane. */
|
|
@@ -86,3 +99,21 @@ export declare function mergeInjections(project: MemoryInjection | undefined, pe
|
|
|
86
99
|
* merged lists). 独立轨 F7: pass the WRITE plane's report as `a` — first-argument fields (incident
|
|
87
100
|
* seat, degraded seat) prefer `a`, and the write plane's degradation is the one that matters. */
|
|
88
101
|
export declare function mergeHarvestReports(a: HarvestReport, b: HarvestReport): HarvestReport;
|
|
102
|
+
/**
|
|
103
|
+
* Merge two stores' receipts for ONE erasure request (same requestId, same selector) into the one receipt the
|
|
104
|
+
* request answers — the harvest merge's law on the erasure report: counters add, lists concatenate, and
|
|
105
|
+
* `status` is `"complete"` only when both receipts are (each store's own `erasureStatusOf` answer): a
|
|
106
|
+
* store that could not establish its share keeps the request partial, whatever the other store erased. Pass
|
|
107
|
+
* the receipts in store order (the project plane's first). Member by member:
|
|
108
|
+
* - `at` is the later of the two (the receipt stands as of the last store's answer); `requestId`, `select`,
|
|
109
|
+
* `selectHash` are the request's (both receipts carry the same);
|
|
110
|
+
* - `resolvedIds` is the union; `erased`, `erasedPreviously`, `conflicts` concatenate; a `notFound` id is
|
|
111
|
+
* dropped when the other store claimed it (erased / erasedPreviously — the id had a row there), appears once
|
|
112
|
+
* otherwise, and carries `historyUnknown` when either store that resolved it could not judge its history;
|
|
113
|
+
* - `evidenceCapability` is `"journal"` only when both are; `custodyState` is the worse of the two
|
|
114
|
+
* (`damaged` ≻ `capability-absent` ≻ `complete`);
|
|
115
|
+
* - each carrier class adds `removed` / `remaining`, and is `unverified` when either store's answer is (or is
|
|
116
|
+
* missing); `quarantineUnattributed` / `derivedEntries` add their counts the same way; `replay` is
|
|
117
|
+
* `"converges"` only when both are; `propagation` stays `"local-store-only"` (every store merged is local).
|
|
118
|
+
*/
|
|
119
|
+
export declare function mergeErasureAttestations(a: MemoryErasureAttestation, b: MemoryErasureAttestation): MemoryErasureAttestation;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { isCentralAuthorityScope, parseScopeKey } from "./scope-contract.js";
|
|
2
2
|
import { CONTROL_PLANE_DIR, resolveMemoryEngineRoot } from "./layout.js";
|
|
3
|
-
import { FileMemoryEngineBackend } from "./file-backend.js";
|
|
3
|
+
import { ERASURE_CARRIER_CLASSES, FileMemoryEngineBackend } from "./file-backend.js";
|
|
4
4
|
import { thrownText } from "../thrown-value.js";
|
|
5
5
|
import { normalizeMemorySpec } from "../memory.js";
|
|
6
6
|
import { join } from "node:path";
|
|
@@ -32,30 +32,37 @@ export function memoryPlaneStore(plane, backend, engineRoot, onIncident) {
|
|
|
32
32
|
return new FileMemoryEngineBackend(derivePersonalMemoryDir(engineRoot), { controlDir: derivePersonalControlDir(engineRoot), ...(onIncident !== undefined ? { onIncident } : {}) });
|
|
33
33
|
}
|
|
34
34
|
export function resolveMemoryScopeStore(input) {
|
|
35
|
-
const
|
|
35
|
+
const face = "resolveMemoryScopeStore";
|
|
36
|
+
judgeMemoryStoreSeat(face, input);
|
|
37
|
+
const plane = memoryScopePlaneOf(face, input.scope, input.scopeContract);
|
|
38
|
+
return { plane, backend: memoryPlaneStore(plane, input.backend, resolveMemoryEngineRoot(input.memoryEngineDir), input.onIncident) };
|
|
39
|
+
}
|
|
40
|
+
export function judgeMemoryStoreSeat(face, input) {
|
|
41
|
+
const { scopeContract, memoryEngineDir } = input;
|
|
36
42
|
for (const key of ["scopeContract", "memoryEngineDir"]) {
|
|
37
43
|
if (!Object.prototype.hasOwnProperty.call(input, key))
|
|
38
|
-
|
|
44
|
+
refuseMemoryStoreInput(face, `${key} is a required key (write undefined to state its absence)`, undefined);
|
|
39
45
|
}
|
|
40
46
|
if (scopeContract !== undefined && scopeContract !== "v2")
|
|
41
|
-
|
|
47
|
+
refuseMemoryStoreInput(face, `scopeContract must be "v2" or undefined`, scopeContract);
|
|
42
48
|
if (memoryEngineDir !== undefined && (typeof memoryEngineDir !== "string" || memoryEngineDir === ""))
|
|
43
|
-
|
|
49
|
+
refuseMemoryStoreInput(face, "memoryEngineDir must be a non-empty string or undefined", memoryEngineDir);
|
|
50
|
+
}
|
|
51
|
+
export function memoryScopePlaneOf(face, scope, scopeContract) {
|
|
44
52
|
let spec;
|
|
45
53
|
try {
|
|
46
54
|
spec = normalizeMemorySpec({ scopes: [scope], writeScope: scope, ...(scopeContract === "v2" ? { scopeContract } : {}) });
|
|
47
55
|
}
|
|
48
56
|
catch (err) {
|
|
49
|
-
|
|
57
|
+
refuseMemoryStoreInput(face, `the scope contract cannot read the key: ${thrownText(err)}`, scope, err);
|
|
50
58
|
}
|
|
51
59
|
if (spec === undefined || spec.writeScope === null)
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
return { plane, backend: memoryPlaneStore(plane, input.backend, resolveMemoryEngineRoot(memoryEngineDir), input.onIncident) };
|
|
60
|
+
refuseMemoryStoreInput(face, "scope must be a non-empty key", scope);
|
|
61
|
+
return scopePlanesOf(spec.scopes, spec.writeScope, spec.scopeContract)?.writePlane ?? "project";
|
|
55
62
|
}
|
|
56
|
-
function
|
|
63
|
+
export function refuseMemoryStoreInput(face, what, v, cause) {
|
|
57
64
|
const got = typeof v === "string" ? JSON.stringify(v.length > 64 ? `${v.slice(0, 64)}…` : v) : v === null ? "null" : typeof v;
|
|
58
|
-
const e = new Error(
|
|
65
|
+
const e = new Error(`${face}: ${what} (got ${got}) — refusing to guess which store was meant.`, cause !== undefined ? { cause } : undefined);
|
|
59
66
|
e.code = "config.memory_scope_key";
|
|
60
67
|
throw e;
|
|
61
68
|
}
|
|
@@ -140,3 +147,44 @@ export function mergeHarvestReports(a, b) {
|
|
|
140
147
|
}
|
|
141
148
|
return merged;
|
|
142
149
|
}
|
|
150
|
+
export function mergeErasureAttestations(a, b) {
|
|
151
|
+
const claimed = new Set([...a.erased, ...b.erased, ...(a.erasedPreviously ?? []), ...(b.erasedPreviously ?? [])].map((row) => row.id));
|
|
152
|
+
const notFound = new Map();
|
|
153
|
+
for (const row of [...a.notFound, ...b.notFound]) {
|
|
154
|
+
if (claimed.has(row.id))
|
|
155
|
+
continue;
|
|
156
|
+
const unknown = row.historyUnknown === true || notFound.get(row.id)?.historyUnknown === true;
|
|
157
|
+
notFound.set(row.id, unknown ? { id: row.id, historyUnknown: true } : { id: row.id });
|
|
158
|
+
}
|
|
159
|
+
const answered = (x) => typeof x === "object" && x !== null && typeof x.removed === "number" && typeof x.remaining === "number";
|
|
160
|
+
const carrier = (x, y) => (answered(x) && answered(y) ? { removed: x.removed + y.removed, remaining: x.remaining + y.remaining } : { unverified: true });
|
|
161
|
+
const counted = (x) => typeof x === "object" && x !== null && typeof x.count === "number";
|
|
162
|
+
const count = (x, y) => (counted(x) && counted(y) ? { count: x.count + y.count } : { unverified: true });
|
|
163
|
+
const custodyRank = { complete: 0, "capability-absent": 1, damaged: 2 };
|
|
164
|
+
const erasedPreviously = [...(a.erasedPreviously ?? []), ...(b.erasedPreviously ?? [])];
|
|
165
|
+
const carriers = {};
|
|
166
|
+
for (const cls of ERASURE_CARRIER_CLASSES)
|
|
167
|
+
carriers[cls] = carrier(a.residuals.carriers[cls], b.residuals.carriers[cls]);
|
|
168
|
+
return {
|
|
169
|
+
v: 2,
|
|
170
|
+
requestId: a.requestId,
|
|
171
|
+
at: Math.max(a.at, b.at),
|
|
172
|
+
status: a.status === "complete" && b.status === "complete" ? "complete" : "partial",
|
|
173
|
+
evidenceCapability: a.evidenceCapability === "journal" && b.evidenceCapability === "journal" ? "journal" : "none",
|
|
174
|
+
custodyState: custodyRank[a.custodyState] >= custodyRank[b.custodyState] ? a.custodyState : b.custodyState,
|
|
175
|
+
select: a.select,
|
|
176
|
+
selectHash: a.selectHash,
|
|
177
|
+
resolvedIds: [...new Set([...a.resolvedIds, ...b.resolvedIds])],
|
|
178
|
+
erased: [...a.erased, ...b.erased],
|
|
179
|
+
notFound: [...notFound.values()],
|
|
180
|
+
...(erasedPreviously.length > 0 ? { erasedPreviously } : {}),
|
|
181
|
+
conflicts: [...a.conflicts, ...b.conflicts],
|
|
182
|
+
residuals: {
|
|
183
|
+
carriers,
|
|
184
|
+
quarantineUnattributed: count(a.residuals.quarantineUnattributed, b.residuals.quarantineUnattributed),
|
|
185
|
+
derivedEntries: count(a.residuals.derivedEntries, b.residuals.derivedEntries),
|
|
186
|
+
replay: a.residuals.replay === "converges" && b.residuals.replay === "converges" ? "converges" : "unsupported",
|
|
187
|
+
propagation: "local-store-only",
|
|
188
|
+
},
|
|
189
|
+
};
|
|
190
|
+
}
|