@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
|
@@ -11,7 +11,7 @@ import type { RepairBundle } from "../agents/repair-loop.js";
|
|
|
11
11
|
import type { WorkspaceHandle } from "./remote-env.js";
|
|
12
12
|
import type { SessionPermissionRules } from "./session-policy-store.js";
|
|
13
13
|
import type { NestedUsageAccum, PermissionMode, ShellGateDoctrine, TaskResult } from "./types.js";
|
|
14
|
-
import type { ActiveWorktreeSession } from "../internal/harness-types.js";
|
|
14
|
+
import type { ActiveWorktreeSession, AgentMessage } from "../internal/harness-types.js";
|
|
15
15
|
import type { ReopenReason } from "./resume-startup-cause.js";
|
|
16
16
|
import { type RetentionDeclaration } from "./retention.js";
|
|
17
17
|
/**
|
|
@@ -587,7 +587,7 @@ export type ResumeOutcome = {
|
|
|
587
587
|
* no persisted hash → the resume skips this check, binding on `boundCallId` alone; new mints enforce.)
|
|
588
588
|
*/
|
|
589
589
|
boundInputHash: string;
|
|
590
|
-
/** `allow` → execute the pending tool call; `deny` → inject a denial result
|
|
590
|
+
/** `allow` → execute the pending tool call; `deny` → inject a denial result, then: a person's deny with no (or an empty) `reason` on a leg that is not a delegated child ends the turn awaiting the user (the run completes with `haltedOnUserRejection`) unless the resume also delivers a parked steer, which the model answers; any other deny continues. */
|
|
591
591
|
decision: "allow" | "deny";
|
|
592
592
|
/** A re-written arg payload (design/37 policy `allow` rewrite); re-validated on execute. */
|
|
593
593
|
updatedInput?: unknown;
|
|
@@ -649,6 +649,9 @@ export type ResumeOutcome = {
|
|
|
649
649
|
* characters, refused pre-CAS (`checkpoint.invalid_outcome`) otherwise — refused rather than dropped,
|
|
650
650
|
* because a settlement that silently lost its attributed party reads as unattributed.
|
|
651
651
|
*
|
|
652
|
+
* `decidedVia` — which machine seat answered a `"policy"` decision ({@link import("./gate-outcome.js").DECIDED_VIA}); the
|
|
653
|
+
* captured facts carry it to the resumed leg (refusal sentence, reminder's decider); refused pre-CAS outside the set or beside another decider.
|
|
654
|
+
*
|
|
652
655
|
* SCOPE — the facts ride the settlement, not the persisted winner: `winnerFromOutcome` records what an
|
|
653
656
|
* `env_failed` replay must reproduce exactly, and who reported a settlement is not part of that
|
|
654
657
|
* authorization; a replay states its own facts.
|
|
@@ -857,6 +860,9 @@ export type PendingAction = {
|
|
|
857
860
|
/** The PARK twin of `AskRequest.classes`: every class of the parked ask, in `ASK_CLASSES` order
|
|
858
861
|
* (`classes[0] === askClass`). Present exactly when {@link askClass} is. */
|
|
859
862
|
classes?: readonly import("./ask-origin.js").AskClass[];
|
|
863
|
+
/** The PARK twin of `AskRequest.askReasons` (the synchronous card's value, through the park's one carry): written only as a
|
|
864
|
+
* list of well-formed entries; a row parked before it reads ABSENT. Display metadata — no gate, CAS or resume path reads it. */
|
|
865
|
+
askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
860
866
|
/**
|
|
861
867
|
* design/80 D-1 §2 (slice 1a.2): the server-minted **opaque** boundInputHash of {@link args} — a
|
|
862
868
|
* SHA-256 (hex) via {@link import("./canonical-json.js").boundInputHashOf}, computed ONCE here at
|
|
@@ -1126,8 +1132,8 @@ export interface CheckpointState {
|
|
|
1126
1132
|
* alive in the resume leg's registry is an ORPHAN — aggregated into ONE "The container
|
|
1127
1133
|
* was restarted…" reminder appended to the resume continuation (single message: header +
|
|
1128
1134
|
* `- description (task id)` list + re-create instruction; never a per-task barrage). A survivor
|
|
1129
|
-
* (session-resident shell / in-window monitor) is excluded —
|
|
1130
|
-
*
|
|
1135
|
+
* (session-resident shell / in-window monitor) is excluded — its output file and TaskStop
|
|
1136
|
+
* still reach it, it needs no obituary. CC's per-orphan `Ku(task_id,"stopped")` status write (:707399)
|
|
1131
1137
|
* is N/A here: the suspend teardown already settled them killed with receipts. Absent for a run
|
|
1132
1138
|
* with no live background tasks at suspend, and for pre-1.262 checkpoints (deserialized without
|
|
1133
1139
|
* the field) — both resume silently, exactly like CC with an empty list.
|
|
@@ -1343,6 +1349,9 @@ export interface CheckpointState {
|
|
|
1343
1349
|
* delegated child (never `false` — presence-coded like the other monotonic bits here).
|
|
1344
1350
|
*/
|
|
1345
1351
|
isDelegatedChild?: true;
|
|
1352
|
+
/** The registry row the suspended leg ran as (`RunInternals.rowTaskId`), stamped at every mint and restored by a resume that
|
|
1353
|
+
* hands no internals. Present only on a row-lane leg's park, which then requires `row_task_id` (an older engine refuses it). */
|
|
1354
|
+
rowTaskId?: string;
|
|
1346
1355
|
/**
|
|
1347
1356
|
* design/380 O1③ — the run TREE's placement fixed point at suspend: the SAME three-segment fold the
|
|
1348
1357
|
* env-factory ctx mint uses (explicit `RunInternals.placementRoot` > the delegation lanes'
|
|
@@ -1365,9 +1374,21 @@ export interface CheckpointState {
|
|
|
1365
1374
|
* resolved empty on a factory-less run (never persisted as garbage).
|
|
1366
1375
|
*/
|
|
1367
1376
|
placementRootSessionId?: string;
|
|
1377
|
+
/**
|
|
1378
|
+
* Which composition leg parked this row and which host session it belongs to
|
|
1379
|
+
* ({@link import("./runner/contracts.js").CompositionLeg}): stamped at every mint from the ONE value the leg's prepare resolved
|
|
1380
|
+
* (the live `RunInternals.compositionLeg`, else this member restored from the row being resumed), so a re-suspend chain carries
|
|
1381
|
+
* it unchanged. A host links the row to its run by `hostSessionId` — the row's own {@link Checkpoint.sessionId} is the leg's
|
|
1382
|
+
* session, not the host's — and settles it by `entry`: a `cascade` card goes back to the cascade's resume entry, which reads
|
|
1383
|
+
* `leg` to know which rung it continues; a `verify` card is a verifier's own pause (resume it by its token, or void it with
|
|
1384
|
+
* `Runner.voidVerifierPause`). A resume that hands a CONTRADICTING live value is refused pre-CAS (`resume.composition_mismatch`); a live value
|
|
1385
|
+
* over a row without this member is that row's first record. Absent ⇒ the leg was not handed out by a composition entry, its
|
|
1386
|
+
* composition minted none (a cascade whose caller named no session), or the row was minted before the member.
|
|
1387
|
+
*/
|
|
1388
|
+
compositionLeg?: import("./runner/contracts.js").CompositionLeg;
|
|
1368
1389
|
/**
|
|
1369
1390
|
* design/380 O9a — MONOTONIC presence bit: this run's hand-tool content fold was EXTERNAL-TARGET
|
|
1370
|
-
* armed (the env declared `
|
|
1391
|
+
* armed (the env declared `capabilities.externalContentTarget`, or an earlier leg of this suspend
|
|
1371
1392
|
* chain did). Stamped at the suspend mint from the run's RESOLVED fold state — never from first
|
|
1372
1393
|
* tool use, so a park landing BEFORE the first hand call is covered too. Presence-coded like
|
|
1373
1394
|
* {@link isDelegatedChild} (absent = never armed; never `false`). The resume side folds
|
|
@@ -1775,6 +1796,12 @@ export interface CheckpointRow {
|
|
|
1775
1796
|
sessionId: string;
|
|
1776
1797
|
/** The session leaf the suspend happened at — the resume point (CAS write base, §5). */
|
|
1777
1798
|
leafId: string;
|
|
1799
|
+
/** The conversation rows the leg had admitted but not yet stored when it parked (a note an extension added while the turn
|
|
1800
|
+
* ran), in the order they were admitted — what the conversation owes after {@link leafId}. Written by the park's commit
|
|
1801
|
+
* alone, in the same step as the row; the resumed leg writes each once, at its transcript's first legal point (after the
|
|
1802
|
+
* parked batch's last result, before the continuation), never through the admission seat again. Absent ⇒ none were held;
|
|
1803
|
+
* present ⇒ the row carries the `held_rows` requirement word. */
|
|
1804
|
+
heldRows?: readonly AgentMessage[];
|
|
1778
1805
|
state: CheckpointState;
|
|
1779
1806
|
/** design/74 R3-B: cross-slice resource accounting. Present for a `resource_limit` gate (debited at the
|
|
1780
1807
|
* suspend's `put`; read on resume to size the next slice + aggregate the final stats). **design/80 D-E-core
|
|
@@ -1865,26 +1892,28 @@ export interface CheckpointRow {
|
|
|
1865
1892
|
*/
|
|
1866
1893
|
rev?: number;
|
|
1867
1894
|
/**
|
|
1868
|
-
* design S1d (source-tag persistence): the issuing
|
|
1869
|
-
*
|
|
1870
|
-
* raised it (the durable analog of {@link import("./tool-policy.js").AskRequest}.
|
|
1895
|
+
* design S1d (source-tag persistence): the issuing leg's session id, stamped at the APPROVAL and the
|
|
1896
|
+
* plan_review suspend mints so a supervisor inbox can attribute a paused/awaiting checkpoint to the worker that
|
|
1897
|
+
* raised it (the durable analog of {@link import("./tool-policy.js").AskRequest}.sourceSessionId — the durable
|
|
1871
1898
|
* suspend path does NOT invoke `onAsk`, so the synchronous source identity is captured here instead). It is
|
|
1872
|
-
* the SAME value the synchronous ask carries
|
|
1899
|
+
* the SAME value the synchronous ask carries, read from the same one mint. It names a conversation, never a
|
|
1900
|
+
* task: the parked leg's agent id is {@link CheckpointSummary.agentId}, derived from the row.
|
|
1873
1901
|
*
|
|
1874
1902
|
* **Security invariant (carried verbatim from the 1.113.0 ask-bubbling contract):** for a Runner-created
|
|
1875
1903
|
* DELEGATED subagent this is **worker-unforgeable** (a child never sets its own sessionId — the Runner mints
|
|
1876
1904
|
* it); a top-level caller MAY continue its own session id via {@link import("./types.js").TaskSpec.sessionId},
|
|
1877
1905
|
* so this is NOT a global "never forgeable" run id — aggregation only aggregates delegated workers, where it
|
|
1878
1906
|
* holds. **ECHO-ONLY triage metadata, NEVER a gate input:** no gate / CAS / winner / resume-validation path
|
|
1879
|
-
* reads it (a contract-test pins this).
|
|
1907
|
+
* reads it (a contract-test pins this). A row that carries it requires `source_session` (an older engine
|
|
1908
|
+
* refuses it). Absent ⇒ a non-ask gate, or a row an earlier engine parked (it named the member `sourceTaskId`).
|
|
1880
1909
|
*/
|
|
1881
|
-
|
|
1910
|
+
sourceSessionId?: string;
|
|
1882
1911
|
/**
|
|
1883
1912
|
* design S1d (source-tag persistence): the issuing task's authenticated end-user {@link
|
|
1884
1913
|
* import("./types.js").TaskSpec.principal} (design/62), stamped at the APPROVAL suspend mint — and, since
|
|
1885
1914
|
* #449 G2, at the `resource_limit` mint too — so an aggregating inbox can attribute a paused checkpoint
|
|
1886
1915
|
* per-user — the durable analog of {@link import("./tool-policy.js").AskRequest}.principal. Caller-set
|
|
1887
|
-
* (never a tool/worker arg), and like {@link
|
|
1916
|
+
* (never a tool/worker arg), and like {@link sourceSessionId} it is **NEVER a gate input**: no gate / CAS /
|
|
1888
1917
|
* winner path reads it. The RESUME ENTRY however does read it as the row's identity record (#449 G2):
|
|
1889
1918
|
* a resume config that omits `principal` inherits this value for the resumed leg (usage-ledger bucket,
|
|
1890
1919
|
* later mints' scope derivation, ask attribution — a dropped field must not silently move the leg onto
|
|
@@ -2013,10 +2042,15 @@ export interface CheckpointSummary {
|
|
|
2013
2042
|
spentMicroUsd?: number;
|
|
2014
2043
|
/** The awaiting-human SLA / abandonment deadline ({@link Checkpoint.deadline}, epoch ms) when present. */
|
|
2015
2044
|
deadline?: number;
|
|
2016
|
-
/** design S1d (source-tag): the issuing worker's session id ({@link Checkpoint.
|
|
2045
|
+
/** design S1d (source-tag): the issuing worker's session id ({@link Checkpoint.sourceSessionId}) — projected so
|
|
2017
2046
|
* a supervisor inbox attributes each pending checkpoint to its worker in ONE `listByScope` call (no N+1
|
|
2018
|
-
* `getCheckpoint`). ECHO-ONLY display/triage; absent on a non-ask gate
|
|
2019
|
-
|
|
2047
|
+
* `getCheckpoint`). ECHO-ONLY display/triage; absent on a non-ask gate and on a row an earlier engine parked. */
|
|
2048
|
+
sourceSessionId?: string;
|
|
2049
|
+
/** The parked leg's agent id when it is a delegated child (the parked twin of {@link import("./tool-policy.js").AskRequest}.agentId),
|
|
2050
|
+
* derived from the row by the live ask's predicate — nothing more is stored: its registry row ({@link CheckpointState.rowTaskId}) when
|
|
2051
|
+
* it ran as one, else its session id; absent on a host's row. The row does not record a task id the leg's spec declared, so a workflow
|
|
2052
|
+
* agent whose spec names a `taskId` summarizes as its session id while its live ask said the declared id. ECHO-ONLY display/triage. */
|
|
2053
|
+
agentId?: string;
|
|
2020
2054
|
/** design S1d (source-tag): the issuing task's end-user principal ({@link Checkpoint.principal}) for per-user
|
|
2021
2055
|
* inbox attribution. ECHO-ONLY display/triage; absent when the checkpoint carries no principal. */
|
|
2022
2056
|
principal?: string;
|
|
@@ -2069,7 +2103,7 @@ export interface CheckpointSummary {
|
|
|
2069
2103
|
* `toolInput` is the raw-data sibling for a consumer that wants the actual args.)
|
|
2070
2104
|
* - **same data as the full {@link Checkpoint}** — it is a projection of `pendingAction.args`, which the
|
|
2071
2105
|
* caller could already read via `get`; this adds NO new exposure, it only saves the round-trip.
|
|
2072
|
-
* - **ECHO-ONLY, like {@link
|
|
2106
|
+
* - **ECHO-ONLY, like {@link sourceSessionId}** — NO gate / CAS / resume / {@link winnerFromOutcome} path reads
|
|
2073
2107
|
* it (a contract test pins this); it is pure display/triage metadata, never a control input.
|
|
2074
2108
|
*/
|
|
2075
2109
|
toolInput?: string;
|
|
@@ -2168,7 +2202,7 @@ export interface CheckpointSummary {
|
|
|
2168
2202
|
* itself a TOTAL, bounded traversal (cycle-safe, per-type output forms, throwing getters to a
|
|
2169
2203
|
* placeholder, depth/node/char budgets with a truncation marker — never "full `JSON.stringify` then
|
|
2170
2204
|
* truncate", which does all the work and takes all the throws before the cap). ECHO-ONLY, like
|
|
2171
|
-
* {@link
|
|
2205
|
+
* {@link sourceSessionId}: a warning to a person, never a control input — resume/gate/CAS never read it.
|
|
2172
2206
|
*/
|
|
2173
2207
|
hasBidiControls?: true;
|
|
2174
2208
|
}
|
|
@@ -2246,9 +2280,8 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
|
|
|
2246
2280
|
| "not_a_list" | "not_a_string" | "unknown_name" | "unsupported_pattern" | "invalid_record" | "renamed_mount" | "registry_occupied"
|
|
2247
2281
|
/** On `config.unknown_role` (a fresh run's terminal `detail.detail.reason`; on a resume, `detail.reason` of `checkpoint.config_refused` with `detail.code` `config.unknown_role`)
|
|
2248
2282
|
* — a model binding or a role word the engine cannot read: a word the model catalog does not hold (`"unknown_model_ref"`), a value that is
|
|
2249
|
-
* no model reference at all — a number, a boolean, a list (`"not_a_model_ref"`), or a role word outside the vocabulary — a `roles` key, a
|
|
2250
|
-
|
|
2251
|
-
| "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word";
|
|
2283
|
+
* no model reference at all — a number, a boolean, a list (`"not_a_model_ref"`), or a role word outside the vocabulary — a `roles` key, a `modelRole` value (`"unknown_role_word"`) — or a task naming no model whose requested role and fallback chain supply none (`"no_model_for_role"`, `field` the requested role's seat). The sentence names the seat the refusal's `field` names (`roles.consolidate`, `tiers.pro`, `TaskSpec.model`). */
|
|
2284
|
+
| "unknown_model_ref" | "not_a_model_ref" | "unknown_role_word" | "no_model_for_role";
|
|
2252
2285
|
/**
|
|
2253
2286
|
* The codes a RESUME's pre-claim configuration screen carries as `detail.code` of a `checkpoint.config_refused` — the words prepare's
|
|
2254
2287
|
* doors throw, held unchanged so one refusal reads the same on a fresh run (`TaskResult.errorCode`) and on a resume: the mode, output-style,
|
|
@@ -2265,8 +2298,11 @@ export type CheckpointErrorReason = "version_newer" | "env_factory_missing" | "g
|
|
|
2265
2298
|
* retired `null` spelling, a store that declares no execution outcome), and the skills seat and the hands band (`config.invalid_argument`;
|
|
2266
2299
|
* a skill's `baseDir` by its own reader, `config.skill_base_dir_invalid`). A door not entered here (the leg's model, its rebuilt
|
|
2267
2300
|
* roster, its answer face, the approval seat's value) still refuses after the claim, each for a stated reason (INTEGRATION-CORE, "A resume's two doors").
|
|
2301
|
+
* The re-supplied config's one read (`readCallerSpec`, the read a run takes of its spec) refuses with its own two words, last in the set:
|
|
2302
|
+
* a member whose read throws (`config.spec_member_unreadable`) and a key the engine does not read (`config.spec_unknown_key`); its third,
|
|
2303
|
+
* a retired key, is `config.spec_retired_key` (first).
|
|
2268
2304
|
*/
|
|
2269
|
-
export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing"];
|
|
2305
|
+
export declare const CHECKPOINT_CONFIG_REFUSAL_CODES: readonly ["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"];
|
|
2270
2306
|
export type CheckpointConfigRefusalCode = (typeof CHECKPOINT_CONFIG_REFUSAL_CODES)[number];
|
|
2271
2307
|
export declare const isCheckpointConfigRefusalCode: (word: unknown) => word is CheckpointConfigRefusalCode;
|
|
2272
2308
|
/** The words of a {@link CheckpointError}'s optional `detail.field` (what each means: the `detail` member's doc). A CLOSED SET with one home, registered in
|
|
@@ -2332,6 +2368,9 @@ export declare class CheckpointError extends Error {
|
|
|
2332
2368
|
* checkpoint exists. Surfaced instead of silently treating the failed reopen as committed, so the
|
|
2333
2369
|
* caller's compensation path settles the token as terminally consumed. */
|
|
2334
2370
|
| "checkpoint.reopen_failed"
|
|
2371
|
+
/** `Runner.voidVerifierPause` voided the card — the row IS expired and its env duty ran — but releasing the verifier
|
|
2372
|
+
* session's pin threw or did not settle within the teardown bound: the session stays pinned until it is unpinned. */
|
|
2373
|
+
| "checkpoint.void_unpin_failed"
|
|
2335
2374
|
/** {@link CheckpointStore.recordExecutionOutcome} met a row that already carries a DIFFERENT
|
|
2336
2375
|
* execution record — see `ExecutionOutcomeConflictError` (checkpoint-execution-record.ts), the
|
|
2337
2376
|
* in-tree form of this code. Never a retry condition. */
|
|
@@ -2415,6 +2454,14 @@ export declare class CheckpointError extends Error {
|
|
|
2415
2454
|
* side absent (an older row / a claim-less resume) skips the check, and `""` reads as absence
|
|
2416
2455
|
* — the honest degradation arm. */
|
|
2417
2456
|
| "resume.placement_mismatch"
|
|
2457
|
+
/** The composition-leg twin of `resume.placement_mismatch`: the resume supplied trusted internals whose
|
|
2458
|
+
* `compositionLeg` differs from the {@link CheckpointState.compositionLeg} recorded at the suspend mint — the
|
|
2459
|
+
* composition's resume entry was handed another card's identity, and continuing would run this leg as a rung it is
|
|
2460
|
+
* not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
|
|
2461
|
+
* re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
|
|
2462
|
+
* the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
|
|
2463
|
+
* recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was. */
|
|
2464
|
+
| "resume.composition_mismatch"
|
|
2418
2465
|
/** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
|
|
2419
2466
|
* explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
|
|
2420
2467
|
* answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
|
|
@@ -2548,6 +2595,9 @@ export declare class CheckpointError extends Error {
|
|
|
2548
2595
|
* checkpoint exists. Surfaced instead of silently treating the failed reopen as committed, so the
|
|
2549
2596
|
* caller's compensation path settles the token as terminally consumed. */
|
|
2550
2597
|
| "checkpoint.reopen_failed"
|
|
2598
|
+
/** `Runner.voidVerifierPause` voided the card — the row IS expired and its env duty ran — but releasing the verifier
|
|
2599
|
+
* session's pin threw or did not settle within the teardown bound: the session stays pinned until it is unpinned. */
|
|
2600
|
+
| "checkpoint.void_unpin_failed"
|
|
2551
2601
|
/** {@link CheckpointStore.recordExecutionOutcome} met a row that already carries a DIFFERENT
|
|
2552
2602
|
* execution record — see `ExecutionOutcomeConflictError` (checkpoint-execution-record.ts), the
|
|
2553
2603
|
* in-tree form of this code. Never a retry condition. */
|
|
@@ -2631,6 +2681,14 @@ export declare class CheckpointError extends Error {
|
|
|
2631
2681
|
* side absent (an older row / a claim-less resume) skips the check, and `""` reads as absence
|
|
2632
2682
|
* — the honest degradation arm. */
|
|
2633
2683
|
| "resume.placement_mismatch"
|
|
2684
|
+
/** The composition-leg twin of `resume.placement_mismatch`: the resume supplied trusted internals whose
|
|
2685
|
+
* `compositionLeg` differs from the {@link CheckpointState.compositionLeg} recorded at the suspend mint — the
|
|
2686
|
+
* composition's resume entry was handed another card's identity, and continuing would run this leg as a rung it is
|
|
2687
|
+
* not, file its next card under another host session, or both. Rejected PRE-CAS (the checkpoint stays `pending`);
|
|
2688
|
+
* re-resume with the recorded value, or omit `internals.compositionLeg` to inherit it. A row that records none skips
|
|
2689
|
+
* the check (the live value becomes its first record). The same code refuses `Runner.voidVerifierPause` a card whose
|
|
2690
|
+
* recorded leg is not a `verify` leg (another entry's, or none recorded): nothing is settled, the row stays as it was. */
|
|
2691
|
+
| "resume.composition_mismatch"
|
|
2634
2692
|
/** design/380 O2: the deployment's `RunnerDeps.resumePreflight` refused this resume — an
|
|
2635
2693
|
* explicit refusal verdict, a throw, a timeout past its bounded deadline, or an unreadable
|
|
2636
2694
|
* answer (all fail-closed). The LAST rung before the CAS, so nothing was consumed. Two arms,
|
|
@@ -2974,8 +3032,8 @@ export interface CheckpointStore {
|
|
|
2974
3032
|
* **Load-bearing contract (design/51 §2/§4):** `expire` and {@link resolve} race the **same `pending`
|
|
2975
3033
|
* row**, so the store serializes them — exactly one wins. This is what makes {@link TaskStream.destroy}
|
|
2976
3034
|
* a correct *fence-then-reap*: `destroy` calls `expire` FIRST to fence any concurrent `resume` (which
|
|
2977
|
-
* goes through `resolve`); only the `
|
|
2978
|
-
* is **never both reaped and resumed**. `scope` is in the WHERE for multi-tenant isolation, like
|
|
3035
|
+
* goes through `resolve`); the paused env is destroyed only once the row is `expired` (this call won, or a loser
|
|
3036
|
+
* reads it so), so the same checkpoint is **never both reaped and resumed**. `scope` is in the WHERE for multi-tenant isolation, like
|
|
2979
3037
|
* `resolve`/`reap`.
|
|
2980
3038
|
*/
|
|
2981
3039
|
expire(token: CheckpointToken, scope: string): Promise<boolean>;
|
|
@@ -3076,12 +3134,9 @@ export interface CheckpointStore {
|
|
|
3076
3134
|
* full {@link Checkpoint} payloads. Read-only — it never mutates a row, takes no CAS, and has ZERO effect on
|
|
3077
3135
|
* the once-only resolve. The PENDING predicate is byte-for-byte the {@link resolve} CAS's (`scope === scope &&
|
|
3078
3136
|
* status === 'pending'`), so the list reflects exactly the rows that are still resumable. Order is unspecified
|
|
3079
|
-
* (the inbox sorts by `severity`/`deadline` itself). An empty scope returns `[]`.
|
|
3080
|
-
*
|
|
3081
|
-
* **OPTIONAL** for backward-compat (RL-1336-checkpoint-listbyscope) with external {@link CheckpointStore} impls (a caller probes
|
|
3082
|
-
* `store.listByScope?.(scope) ?? []`); ALL THREE first-party impls (in-memory, file, Pg) provide it.
|
|
3137
|
+
* (the inbox sorts by `severity`/`deadline` itself). An empty scope returns `[]`. Required: every store answers it.
|
|
3083
3138
|
*/
|
|
3084
|
-
listByScope
|
|
3139
|
+
listByScope(scope: string): Promise<CheckpointSummary[]>;
|
|
3085
3140
|
/**
|
|
3086
3141
|
* Deployment seam: the DISTINCT scopes that currently have at least one PENDING checkpoint — the
|
|
3087
3142
|
* enumeration face `listByScope` lacks. A host keeping its own scope registry (e.g. a sidecar file for a
|
|
@@ -3090,7 +3145,7 @@ export interface CheckpointStore {
|
|
|
3090
3145
|
* it matches `listByScope`'s visible surface, so `listScopes() × listByScope()` is exactly the full inbox,
|
|
3091
3146
|
* and a member the summary does not project is read with `get(token)` on the listed token — the composition
|
|
3092
3147
|
* a deployment's approval queue is, rather than a query of its own over the store's rows.
|
|
3093
|
-
* **OPTIONAL**
|
|
3148
|
+
* **OPTIONAL** (unlike the required {@link listByScope}); the in-memory and file first-party impls provide it.
|
|
3094
3149
|
*/
|
|
3095
3150
|
listScopes?(): Promise<string[]>;
|
|
3096
3151
|
/** The PENDING rows of every scope past their deadline, one facet per call ({@link CheckpointOverdueQuery}; read by
|
|
@@ -3250,9 +3305,8 @@ export declare class InMemoryCheckpointStore implements CheckpointStore {
|
|
|
3250
3305
|
readonly deleteSessionCheckpoints?: (sessionId: string, guard: CheckpointDeleteGuard) => Promise<number>;
|
|
3251
3306
|
/** `disclose` is the listing projections' own seat ({@link summarizeCheckpoint}'s and the listing faces'): this store has no
|
|
3252
3307
|
* path, so it forwards each sentence for a row read past a damage, called synchronously by the listing that read it.
|
|
3253
|
-
* `sessionHeadOf` (a session store's `headOf`) is what {@link CheckpointStore.deleteSessionCheckpoints} judges its guard by.
|
|
3254
|
-
|
|
3255
|
-
constructor(opts?: {
|
|
3308
|
+
* `sessionHeadOf` (a session store's `headOf`) is what {@link CheckpointStore.deleteSessionCheckpoints} judges its guard by; `holderIsCurrent` ({@link HolderJudge}), a resolve's `expect.holder`. */
|
|
3309
|
+
constructor(options?: {
|
|
3256
3310
|
disclose?: (sentence: string) => void;
|
|
3257
3311
|
sessionHeadOf?: (sessionId: string) => Promise<{
|
|
3258
3312
|
readonly owner: string | null;
|
|
@@ -2,8 +2,9 @@ import { randomBytes, randomUUID } from "node:crypto";
|
|
|
2
2
|
import { uuidv7 } from "../internal/harness.js";
|
|
3
3
|
import { PROBE_CAUSE_PATH_MAX, PROBE_REASON_MAX, inlineUntrusted, sanitizeUntrustedText } from "./untrusted-text.js";
|
|
4
4
|
import { carriesBidiControls } from "./tool-policy.js";
|
|
5
|
+
import { agentIdOf, legTaskIdOf } from "./leg-identity.js";
|
|
5
6
|
import { isAutoModeFallbackCause, readDenialLimitFallback } from "./auto-mode.js";
|
|
6
|
-
import { isAskOrigin, isPersistedRuleMandate } from "./ask-origin.js";
|
|
7
|
+
import { isAskOrigin, isPermissionMode, isPersistedRuleMandate } from "./ask-origin.js";
|
|
7
8
|
import { isRunOrigin, RUN_ORIGINS } from "./run-origin.js";
|
|
8
9
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
9
10
|
import { readBoundBinding } from "./skill-grant-binding.js";
|
|
@@ -14,8 +15,8 @@ import { checkpointDeadlinePassed, deleteSessionRowsAtStart, readCheckpointOverd
|
|
|
14
15
|
import { renderUntrustedCommandText, stripFormatCharacters } from "./permission-rule-model.js";
|
|
15
16
|
import { egressText } from "./untrusted-egress.js";
|
|
16
17
|
import { steerReplayRefusal } from "./steer-replay.js";
|
|
17
|
-
import { isPermissionMode } from "./ask-origin.js";
|
|
18
18
|
import { readRetentionDeclaration } from "./retention.js";
|
|
19
|
+
import { optionKeys, receiveOptions } from "./own-property-receipt.js";
|
|
19
20
|
export function mintCheckpointToken() {
|
|
20
21
|
return randomBytes(16).toString("hex");
|
|
21
22
|
}
|
|
@@ -307,6 +308,7 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
307
308
|
const hasBidi = tool !== undefined &&
|
|
308
309
|
(facts.hasBidiControls === true ||
|
|
309
310
|
carriesBidiControls([toolInput, tool.preview], { maxNodes: BIDI_BACKFILL_MAX_NODES, maxChars: BIDI_BACKFILL_MAX_CHARS }));
|
|
311
|
+
const agentId = agentIdOf({ taskId: legTaskIdOf({}, cp.state, cp.sessionId), isDelegatedChild: cp.state.isDelegatedChild === true });
|
|
310
312
|
return {
|
|
311
313
|
token: facts.token,
|
|
312
314
|
...(cp.checkpointId !== undefined ? { checkpointId: cp.checkpointId } : {}),
|
|
@@ -317,7 +319,8 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
317
319
|
...(cp.resourceLedger !== undefined ? { spentMicroUsd: cp.resourceLedger.spentMicroUsd } : {}),
|
|
318
320
|
...(facts.deadline !== null ? { deadline: facts.deadline } : {}),
|
|
319
321
|
createdAt: facts.createdAt,
|
|
320
|
-
...(cp.
|
|
322
|
+
...(cp.sourceSessionId !== undefined ? { sourceSessionId: cp.sourceSessionId } : {}),
|
|
323
|
+
...(agentId !== undefined ? { agentId } : {}),
|
|
321
324
|
...(cp.principal !== undefined ? { principal: cp.principal } : {}),
|
|
322
325
|
...(facts.toolCallId !== null ? { toolCallId: facts.toolCallId } : {}),
|
|
323
326
|
...(requestedByCallId !== undefined ? { requestedByCallId } : {}),
|
|
@@ -347,7 +350,7 @@ export function summarizeCheckpoint(cp, disclose) {
|
|
|
347
350
|
...(hasBidi ? { hasBidiControls: true } : {}),
|
|
348
351
|
};
|
|
349
352
|
}
|
|
350
|
-
export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing"]);
|
|
353
|
+
export const CHECKPOINT_CONFIG_REFUSAL_CODES = Object.freeze(["config.spec_retired_key", "config.output_style_invalid", "config.permission_mode_invalid", "config.shell_gate_value_retired", "config.approval_reach_invalid", "config.run_origin_invalid", "config.user_invoked_skill_unknown", "config.skill_deny_unreadable", "config.user_attachment_invalid", "config.tool_face_control", "config.deps_retired_key", "config.peer_presence_invalid", "config.tool_model_gate_invalid", "config.microcompact_invalid", "config.prompt_selector_invalid", "resume_at.conflicts_resume", "resume_at.mode_without_target", "config.read_face_invalid", "config.write_face_invalid", "config.invalid_argument", "config.tool_face_invalid", "config.memory_delegation_evidence", "config.memory_provenance", "config.memory_capture_policy", "config.cross_boundary_posture", "config.advisor_tool_invalid", "config.advisor_model_invalid", "config.auto_consolidation", "config.unknown_role", "config.tool_materialize_invalid", "config.memory_persistence_invalid", "config.tool_materialize_unreachable", "config.locked_registry", "config.locked_key", "config.mcp_content_class", "config.skill_listing_budget_invalid", "config.limit_unknown_key", "config.limit_invalid", "config.attachment_invalid", "config.usage_window_invalid", "config.brain_call_guardrail_invalid", "config.retention_policy", "config.retention_capability", "config.invalid_checkpoint_store", "config.skill_base_dir_invalid", "config.host_floor_invalid", "config.credential_in_declaration", "config.credential_ref_invalid", "config.peer_seat_missing", "config.spec_member_unreadable", "config.spec_unknown_key"]);
|
|
351
354
|
export const isCheckpointConfigRefusalCode = (word) => CHECKPOINT_CONFIG_REFUSAL_CODES.some((w) => w === word);
|
|
352
355
|
export class CheckpointError extends Error {
|
|
353
356
|
code;
|
|
@@ -574,6 +577,7 @@ export function appendPendingSteer(state, entry) {
|
|
|
574
577
|
export function checkpointRowMatches(cp, scope, status) {
|
|
575
578
|
return cp !== undefined && cp.scope === scope && cp.status === status;
|
|
576
579
|
}
|
|
580
|
+
const IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS = optionKeys()({ disclose: 0, sessionHeadOf: 0, holderIsCurrent: 0, retention: 0 });
|
|
577
581
|
export class InMemoryCheckpointStore {
|
|
578
582
|
retention;
|
|
579
583
|
durability = "process-local";
|
|
@@ -583,7 +587,8 @@ export class InMemoryCheckpointStore {
|
|
|
583
587
|
fault = null;
|
|
584
588
|
disclose;
|
|
585
589
|
holderIsCurrent;
|
|
586
|
-
constructor(
|
|
590
|
+
constructor(options) {
|
|
591
|
+
const opts = receiveOptions(options, "InMemoryCheckpointStore", IN_MEMORY_CHECKPOINT_STORE_OPTION_KEYS);
|
|
587
592
|
this.retention = readRetentionDeclaration("InMemoryCheckpointStore.retention", opts.retention);
|
|
588
593
|
this.disclose = opts.disclose;
|
|
589
594
|
this.holderIsCurrent = opts.holderIsCurrent;
|
|
@@ -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
|
+
}
|
|
@@ -32,7 +32,7 @@ export declare function resolveComplianceDenies(posture: CompliancePosture): Rea
|
|
|
32
32
|
/** One deny list member's refusal under the closed capability set, labelled with the list that carried it, or
|
|
33
33
|
* `undefined` when it is a member. */
|
|
34
34
|
export declare function complianceCapabilityProblem(cap: unknown, owner: string): string | undefined;
|
|
35
|
-
/** The core web-fetch tool face's canonical mounted name (`
|
|
35
|
+
/** The core web-fetch tool face's canonical mounted name (`webFetchToolSpec` in tools/web.ts). */
|
|
36
36
|
export declare const WEB_FETCH_TOOL_NAME = "WebFetch";
|
|
37
37
|
/**
|
|
38
38
|
* The CALL-TIME half of the `web_fetch` double point (CC form — mount check + call guard): given the
|
|
@@ -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)) {
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A protocol peer's account of itself, read without the credentials its connection's requests carried — the MCP server's `serverInfo`,
|
|
3
|
+
* its instructions and its tool listing, the A2A peer's agent card. The needle is the connection's credentials (`PeerCarrier.credentials`:
|
|
4
|
+
* what the seat answered that the withheld table holds) and the one eraser is `eraseSentCredentials` (protocol-http-auth.ts, beside the
|
|
5
|
+
* failure text's). Free text holding the needle is erased in place; a NAME holding it (a tool's name or input schema, the server's own
|
|
6
|
+
* name, a skill's id, the card's name) is never rewritten — what it names is refused instead. Either way the site is announced, once per
|
|
7
|
+
* (materialization, peer, site), as `mcp.credential_echoed` (operator) through {@link credentialEchoNotice}.
|
|
8
|
+
*/
|
|
9
|
+
import { type EngineNotice } from "./engine-notice.js";
|
|
10
|
+
import type { PeerCarrier } from "./peer-seat.js";
|
|
11
|
+
/** Where a peer echoed its connection's credentials into what it said about itself — the closed set `mcp.credential_echoed` names
|
|
12
|
+
* (`detail.where`). */
|
|
13
|
+
export declare const CREDENTIAL_ECHO_SITES: readonly ["server_info", "instructions", "tool_listing", "agent_card"];
|
|
14
|
+
export type CredentialEchoSite = (typeof CREDENTIAL_ECHO_SITES)[number];
|
|
15
|
+
/** What a peer's account is read with: the needle, and who hears that a site held it. */
|
|
16
|
+
export interface CredentialEcho {
|
|
17
|
+
readonly credentials: readonly string[];
|
|
18
|
+
readonly announce: (where: CredentialEchoSite) => void;
|
|
19
|
+
}
|
|
20
|
+
export declare const NO_CREDENTIAL_ECHO: CredentialEcho;
|
|
21
|
+
/** The drop reason of a tool whose name or input schema holds its connection's credential. */
|
|
22
|
+
export declare const CREDENTIAL_ECHO_DROP_REASON = "its name or input schema holds a credential this connection's requests carried (the server echoed it back); neither is rewritten, so the tool is not mounted";
|
|
23
|
+
/** A free text of the peer's with the needle erased in place (absent stays absent); a text that held it announces `where`. */
|
|
24
|
+
export declare function erasedEcho(text: string | undefined, echo: CredentialEcho, where: CredentialEchoSite): string | undefined;
|
|
25
|
+
/** Whether a NAME the peer gave holds the needle (announced as `where` when it does): such a name is refused, never rewritten. */
|
|
26
|
+
export declare function nameEchoes(name: string, echo: CredentialEcho, where: CredentialEchoSite): boolean;
|
|
27
|
+
/** A listed input schema as one text for the needle (its keys and values, JSON-escaped as the echo spellings expect); a schema JSON cannot
|
|
28
|
+
* carry reads as nothing (the schema gate refuses it on its own). */
|
|
29
|
+
export declare function schemaText(schema: unknown): string;
|
|
30
|
+
/** A listed tool the needle refuses — named with it, or its input schema holding it (the schema is the tool's structure: its property
|
|
31
|
+
* names are what the model sends, not prose to edit) — as its drop record, the name erased; `undefined` for a tool the needle leaves. */
|
|
32
|
+
export declare function echoedToolDrop(name: string, inputSchema: unknown, echo: CredentialEcho): {
|
|
33
|
+
tool: string;
|
|
34
|
+
reason: string;
|
|
35
|
+
} | undefined;
|
|
36
|
+
/** How a connection's account is read: its carrier's credentials, a site that held one announced through `announce`. */
|
|
37
|
+
export declare function carrierEcho(carrier: {
|
|
38
|
+
readonly credentials: PeerCarrier["credentials"] | readonly string[];
|
|
39
|
+
}, announce: ((where: CredentialEchoSite) => void) | undefined): CredentialEcho;
|
|
40
|
+
/** The server's `serverInfo` as its status projects it: `name` is a name (holding the needle, the record is not projected — never
|
|
41
|
+
* rewritten), `version` free text (erased in place). */
|
|
42
|
+
export declare function serverInfoOf(info: {
|
|
43
|
+
name: string;
|
|
44
|
+
version: string;
|
|
45
|
+
} | undefined, echo: CredentialEcho): {
|
|
46
|
+
name: string;
|
|
47
|
+
version: string;
|
|
48
|
+
} | undefined;
|
|
49
|
+
/** One materialization's announcer: each (peer, site) heard once, a throwing listener never a fault of the dial it describes. */
|
|
50
|
+
export declare function echoAnnouncer(onCredentialEchoed: ((peer: string, where: CredentialEchoSite) => void) | undefined): (peer: string, where: CredentialEchoSite) => void;
|
|
51
|
+
/** The runner's listener → `mcp.credential_echoed` (engine-notice.ts): the peer and the site, never a value; operator audience. */
|
|
52
|
+
export declare function credentialEchoNotice(onNotice: ((notice: EngineNotice) => void) | undefined, sessionId: string, runId: string, protocol: "mcp" | "a2a"): (server: string, where: CredentialEchoSite) => void;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { deliverEngineNotice } from "./engine-notice.js";
|
|
2
|
+
import { eraseSentCredentials } from "./protocol-http-auth.js";
|
|
3
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
|
+
export const CREDENTIAL_ECHO_SITES = Object.freeze(["server_info", "instructions", "tool_listing", "agent_card"]);
|
|
5
|
+
export const NO_CREDENTIAL_ECHO = Object.freeze({ credentials: Object.freeze([]), announce: () => undefined });
|
|
6
|
+
export const CREDENTIAL_ECHO_DROP_REASON = "its name or input schema holds a credential this connection's requests carried (the server echoed it back); neither is rewritten, so the tool is not mounted";
|
|
7
|
+
export function erasedEcho(text, echo, where) {
|
|
8
|
+
if (typeof text !== "string")
|
|
9
|
+
return text;
|
|
10
|
+
const erased = eraseSentCredentials(text, echo.credentials);
|
|
11
|
+
if (erased !== text)
|
|
12
|
+
echo.announce(where);
|
|
13
|
+
return erased;
|
|
14
|
+
}
|
|
15
|
+
export function nameEchoes(name, echo, where) {
|
|
16
|
+
const echoed = typeof name === "string" && eraseSentCredentials(name, echo.credentials) !== name;
|
|
17
|
+
if (echoed)
|
|
18
|
+
echo.announce(where);
|
|
19
|
+
return echoed;
|
|
20
|
+
}
|
|
21
|
+
export function schemaText(schema) {
|
|
22
|
+
try {
|
|
23
|
+
return JSON.stringify(schema) ?? "";
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
return "";
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
export function echoedToolDrop(name, inputSchema, echo) {
|
|
30
|
+
if (!nameEchoes(name, echo, "tool_listing") && !nameEchoes(schemaText(inputSchema), echo, "tool_listing"))
|
|
31
|
+
return undefined;
|
|
32
|
+
return { tool: inlineUntrusted(eraseSentCredentials(name, echo.credentials)), reason: CREDENTIAL_ECHO_DROP_REASON };
|
|
33
|
+
}
|
|
34
|
+
export function carrierEcho(carrier, announce) {
|
|
35
|
+
return { credentials: carrier.credentials, announce: announce ?? NO_CREDENTIAL_ECHO.announce };
|
|
36
|
+
}
|
|
37
|
+
export function serverInfoOf(info, echo) {
|
|
38
|
+
if (info === undefined)
|
|
39
|
+
return undefined;
|
|
40
|
+
if (nameEchoes(info.name, echo, "server_info"))
|
|
41
|
+
return undefined;
|
|
42
|
+
return { name: info.name, version: erasedEcho(info.version, echo, "server_info") ?? info.version };
|
|
43
|
+
}
|
|
44
|
+
export function echoAnnouncer(onCredentialEchoed) {
|
|
45
|
+
const announced = new Set();
|
|
46
|
+
return (peer, where) => {
|
|
47
|
+
const key = `${peer}\u0000${where}`;
|
|
48
|
+
if (onCredentialEchoed === undefined || announced.has(key))
|
|
49
|
+
return;
|
|
50
|
+
announced.add(key);
|
|
51
|
+
try {
|
|
52
|
+
onCredentialEchoed(peer, where);
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
}
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
const SITE_WORDS = { server_info: "serverInfo", instructions: "instructions", tool_listing: "tool listing", agent_card: "agent card" };
|
|
59
|
+
export function credentialEchoNotice(onNotice, sessionId, runId, protocol) {
|
|
60
|
+
return (server, where) => deliverEngineNotice(onNotice, {
|
|
61
|
+
code: "mcp.credential_echoed",
|
|
62
|
+
message: `${protocol === "mcp" ? "MCP server" : "A2A peer"} "${inlineUntrusted(server, 120)}" echoed a credential its requests carried into its ${SITE_WORDS[where]} — the engine erased it there (a name holding it was refused, not rewritten); the endpoint repeats what it is sent, so check what it logs and publishes.`,
|
|
63
|
+
detail: { protocol, server, where, sessionId, runId },
|
|
64
|
+
});
|
|
65
|
+
}
|