@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,4 +1,4 @@
|
|
|
1
|
-
import type { AgentMessage, ExecutionEnv, GitAnnouncementKind, SessionTreeEntry } from "../../internal/harness-types.js";
|
|
1
|
+
import type { AgentMessage, ExecutionEnv, GitAnnouncementKind, ReadFloor, SessionTreeEntry } from "../../internal/harness-types.js";
|
|
2
2
|
/** Bound into the hash domain: bump when the frame's wording/structure changes so the upgraded
|
|
3
3
|
* renderer re-announces on its first leg instead of being suppressed by a pre-upgrade hash. */
|
|
4
4
|
export declare const GIT_STATUS_FRAME_FORMAT_VERSION = 1;
|
|
@@ -155,6 +155,9 @@ export declare function probeGitStatusLane(args: {
|
|
|
155
155
|
};
|
|
156
156
|
handsEnabled: boolean;
|
|
157
157
|
taskRoot: string;
|
|
158
|
+
/** The byte floor of the snapshot's start, read as it starts: the run's base read-deny table (`git config` reads what an
|
|
159
|
+
* `include.path` names). A floor that cannot be read degrades the frame, as a failed snapshot does. */
|
|
160
|
+
readFloor?: () => ReadFloor | undefined;
|
|
158
161
|
onDegrade: (reason: string) => void;
|
|
159
162
|
}): Promise<GitStatusLaneRef>;
|
|
160
163
|
/**
|
|
@@ -189,7 +192,7 @@ export declare function newestEngineGitFrame(branch: SessionTreeEntry[], mark?:
|
|
|
189
192
|
entryId: string;
|
|
190
193
|
positive: boolean;
|
|
191
194
|
} | undefined;
|
|
192
|
-
export declare function stripGitStatusUnits(text: string
|
|
195
|
+
export declare function stripGitStatusUnits(text: string): string;
|
|
193
196
|
/**
|
|
194
197
|
* The readable-absence tombstone question (R2-1), answered by the classifier above: does the
|
|
195
198
|
* branch carry a still-context-visible POSITIVE engine frame as its newest git frame? A newest
|
|
@@ -62,7 +62,7 @@ export function resolveGitStatusFrame(outcome, canonicalRoot, degradedMaterial)
|
|
|
62
62
|
return resolved;
|
|
63
63
|
}
|
|
64
64
|
export async function probeGitStatusLane(args) {
|
|
65
|
-
const { executionEnv, envFacts, handsEnabled, taskRoot, onDegrade } = args;
|
|
65
|
+
const { executionEnv, envFacts, handsEnabled, taskRoot, readFloor, onDegrade } = args;
|
|
66
66
|
const ref = {};
|
|
67
67
|
if (!handsEnabled)
|
|
68
68
|
return ref;
|
|
@@ -75,7 +75,8 @@ export async function probeGitStatusLane(args) {
|
|
|
75
75
|
...(envFacts.gitDirty !== undefined ? { dirty: envFacts.gitDirty } : {}),
|
|
76
76
|
};
|
|
77
77
|
try {
|
|
78
|
-
const
|
|
78
|
+
const snapFloor = readFloor?.();
|
|
79
|
+
const snap = await executionEnv.exec(`(m=$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null); m=\${m#origin/}; for s in "$m" main master; do if [ -n "$s" ] && git show-ref --verify --quiet "refs/remotes/origin/$s"; then echo "$s"; break; fi; done) || true; echo "${SEP}"; (git config user.name 2>/dev/null || true); echo "${SEP}"; gs=$(git --no-optional-locks status --short) || exit 41; printf '%s\\n' "$gs"; echo "${SEP}"; gl=$(git --no-optional-locks log --oneline -n 5) || exit 42; printf '%s\\n' "$gl"`, { cwd: envFacts.cwd, timeout: 10, ...(snapFloor !== undefined ? { readFloor: snapFloor } : {}) });
|
|
79
80
|
if (snap.ok && snap.value.exitCode === 0) {
|
|
80
81
|
const parts = snap.value.stdout.split(`${SEP}\n`);
|
|
81
82
|
if (parts.length === 4) {
|
|
@@ -208,8 +209,7 @@ function hasNestedReminderOpenTag(seg) {
|
|
|
208
209
|
}
|
|
209
210
|
return false;
|
|
210
211
|
}
|
|
211
|
-
export function stripGitStatusUnits(text
|
|
212
|
-
void mark;
|
|
212
|
+
export function stripGitStatusUnits(text) {
|
|
213
213
|
const close = "</system-reminder>";
|
|
214
214
|
const findHead = (out, from) => {
|
|
215
215
|
for (let at = out.indexOf("<system-reminder", from); at !== -1; at = out.indexOf("<system-reminder", at + 1)) {
|
|
@@ -21,7 +21,8 @@ export interface UnconsumedHaltDisclosureInput {
|
|
|
21
21
|
onNotice: RunnerDeps["onNotice"];
|
|
22
22
|
sessionId: string;
|
|
23
23
|
runId: string;
|
|
24
|
-
taskId
|
|
24
|
+
/** The leg's own task id (`Prepared.taskId`) — always present. */
|
|
25
|
+
taskId: string;
|
|
25
26
|
}
|
|
26
27
|
/**
|
|
27
28
|
* The ACCEPTED-but-UNCONSUMED halt: the verb latched the stop (and may have cut a seat), but the run ended for
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { legNoticeTaskId } from "../mods/stations.js";
|
|
1
2
|
import { deliverEngineNotice } from "../types.js";
|
|
2
3
|
export function haltConsumed(c) {
|
|
3
4
|
return c?.turnCut === "halt" || c?.boundaryStop?.sources.includes("halt") === true;
|
|
@@ -10,7 +11,7 @@ export function discloseUnconsumedHalt(input) {
|
|
|
10
11
|
message: "a user halt was accepted, but the run ended for its own reason before the halt stopped or cut anything: " +
|
|
11
12
|
"no turn was settled as its cut and no boundary stopped for it — the run's own ending stands, and the result " +
|
|
12
13
|
"will not carry haltedByUser for this halt.",
|
|
13
|
-
detail: { sessionId: input.sessionId, runId: input.runId, ...(input
|
|
14
|
+
detail: { sessionId: input.sessionId, runId: input.runId, ...legNoticeTaskId(input) },
|
|
14
15
|
});
|
|
15
16
|
return true;
|
|
16
17
|
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { ImageContent } from "../../internal/llm.js";
|
|
2
2
|
import { type HostFloor } from "../host-floor.js";
|
|
3
3
|
import type { ImageInput } from "../types.js";
|
|
4
|
+
import { type ImageDownsampler } from "../image-downsample.js";
|
|
4
5
|
/**
|
|
5
6
|
* The guard of a remote image URL: https only, then the one egress hop judge with the private-network floor (`hopRefusal`,
|
|
6
7
|
* host-floor.ts) — the deployment's host floor (`RunnerDeps.hostFloor`, `floor`) must admit the host, and a private host is
|
|
@@ -8,5 +9,9 @@ import type { ImageInput } from "../types.js";
|
|
|
8
9
|
* `169.254.169.254` or a private box. The host is read literally (no DNS resolution). Throws on a refused URL.
|
|
9
10
|
*/
|
|
10
11
|
export declare function defaultImageUrlGuard(raw: string, floor?: HostFloor): void;
|
|
11
|
-
/** Resolve an {@link ImageInput} (inline base64 or a URL to fetch) into a vendored `ImageContent` block
|
|
12
|
-
|
|
12
|
+
/** Resolve an {@link ImageInput} (inline base64 or a URL to fetch) into a vendored `ImageContent` block: both arms pass
|
|
13
|
+
* the one byte admission with the run's processor (inline-image.ts) — a fetched body after the URL's own guard and cap. */
|
|
14
|
+
export declare function toImageContent(img: ImageInput, floor: HostFloor | undefined, processor: ImageDownsampler | "none"): Promise<ImageContent>;
|
|
15
|
+
/** The task's images (`TaskSpec.images`), each through {@link toImageContent} with the run's one processor (`seat` =
|
|
16
|
+
* `RunnerDeps.imageProcessor`); the first one sent unprocessed over the soft target is told to `unprocessed`. */
|
|
17
|
+
export declare function toImageContents(images: readonly ImageInput[], floor: HostFloor | undefined, seat: ImageDownsampler | false | undefined, unprocessed: (bytes: number) => void): Promise<ImageContent[]>;
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
import { hopRefusal } from "../host-floor.js";
|
|
2
|
-
import {
|
|
2
|
+
import { firstUnprocessedOverTarget, IMAGE_ADMISSION, sniffImageMime } from "../image-admission.js";
|
|
3
|
+
import { resolveImageProcessor } from "../image-downsample.js";
|
|
3
4
|
import { admitInlineImage } from "./inline-image.js";
|
|
4
|
-
function sniffImageMime(bytes) {
|
|
5
|
-
return ADMITTED_IMAGE_MIME_TYPES.find((mime) => imageMagicMatches(bytes, mime));
|
|
6
|
-
}
|
|
7
5
|
export function defaultImageUrlGuard(raw, floor) {
|
|
8
6
|
let u;
|
|
9
7
|
try {
|
|
@@ -20,7 +18,7 @@ export function defaultImageUrlGuard(raw, floor) {
|
|
|
20
18
|
throw new Error(`image url not fetched — ${refused}`);
|
|
21
19
|
}
|
|
22
20
|
const IMAGE_FETCH_TIMEOUT_MS = 30_000;
|
|
23
|
-
const IMAGE_MAX_BYTES =
|
|
21
|
+
const IMAGE_MAX_BYTES = IMAGE_ADMISSION.hard.urlBytes;
|
|
24
22
|
async function readImageBodyCapped(res) {
|
|
25
23
|
const reader = res.body?.getReader();
|
|
26
24
|
if (!reader) {
|
|
@@ -67,12 +65,20 @@ async function fetchImageCapped(url) {
|
|
|
67
65
|
}
|
|
68
66
|
return { buf, mimeType: sniffed };
|
|
69
67
|
}
|
|
70
|
-
export async function toImageContent(img, floor) {
|
|
68
|
+
export async function toImageContent(img, floor, processor) {
|
|
71
69
|
if ("url" in img) {
|
|
72
70
|
const url = img.url;
|
|
73
71
|
defaultImageUrlGuard(url, floor);
|
|
74
72
|
const { buf, mimeType } = await fetchImageCapped(url);
|
|
75
|
-
return {
|
|
73
|
+
return admitInlineImage({ data: buf.toString("base64"), mimeType }, processor, "the image fetched from its url");
|
|
76
74
|
}
|
|
77
|
-
return admitInlineImage(img);
|
|
75
|
+
return admitInlineImage(img, processor);
|
|
76
|
+
}
|
|
77
|
+
export async function toImageContents(images, floor, seat, unprocessed) {
|
|
78
|
+
const processor = await resolveImageProcessor(seat);
|
|
79
|
+
const blocks = await Promise.all(images.map((img) => toImageContent(img, floor, processor)));
|
|
80
|
+
const over = firstUnprocessedOverTarget(blocks, processor);
|
|
81
|
+
if (over !== undefined)
|
|
82
|
+
unprocessed(over);
|
|
83
|
+
return blocks;
|
|
78
84
|
}
|
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The `TaskSpec.images`
|
|
3
|
-
* (image-admission.ts) — a claimed type the API accepts, within the raw cap, that type's
|
|
4
|
-
* the
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
2
|
+
* The `TaskSpec.images` arms' admission: the same byte admission a file the Read tool serves passes
|
|
3
|
+
* (image-admission.ts), with the run's processor — a claimed type the API accepts, within the raw cap, that type's
|
|
4
|
+
* signature, then the processor (or, with none, a header-stated size within the reject edge), under the provider's
|
|
5
|
+
* base64 limit. Without it a mis-declared image rode straight to the provider and 400'd the whole request. Like the
|
|
6
|
+
* Read lane it checks the SIGNATURE, not decodability: a file cut short after its signature passes when no processor
|
|
7
|
+
* reads it (KL-1311a-c). The block is built from the bytes that were checked (or the processor made from them).
|
|
8
8
|
*/
|
|
9
9
|
import type { ImageContent } from "../../internal/llm.js";
|
|
10
10
|
import type { ImageInput } from "../types.js";
|
|
11
|
-
|
|
11
|
+
import type { ImageDownsampler } from "../image-downsample.js";
|
|
12
|
+
/** Admit one entry's bytes (`{ data, mimeType }` — inline, or a URL arm's fetched body, `subject` naming which) or throw
|
|
13
|
+
* `config.image_invalid`. */
|
|
12
14
|
export declare function admitInlineImage(img: Extract<ImageInput, {
|
|
13
15
|
data: string;
|
|
14
|
-
}
|
|
16
|
+
}>, processor: ImageDownsampler | "none", subject?: string): Promise<ImageContent>;
|
|
@@ -1,26 +1,28 @@
|
|
|
1
|
-
import { admitImageBytes, ADMITTED_IMAGE_MIME_TYPES } from "../image-admission.js";
|
|
2
|
-
import { MCP_IMAGE_MAX_BASE64 } from "../image-downsample.js";
|
|
1
|
+
import { admitImageBytes, ADMITTED_IMAGE_MIME_TYPES, IMAGE_ADMISSION, unprocessedSizeClause } from "../image-admission.js";
|
|
3
2
|
function inlineImageRefusal(detail) {
|
|
4
3
|
const e = new Error(`TaskSpec.images: ${detail}`);
|
|
5
4
|
e.code = "config.image_invalid";
|
|
6
5
|
return e;
|
|
7
6
|
}
|
|
8
|
-
export async function admitInlineImage(img) {
|
|
7
|
+
export async function admitInlineImage(img, processor, subject = "an inline image") {
|
|
9
8
|
const data = img.data;
|
|
10
9
|
const mimeType = img.mimeType;
|
|
11
10
|
if (typeof data !== "string" || typeof mimeType !== "string")
|
|
12
|
-
throw inlineImageRefusal(
|
|
13
|
-
const admitted = await admitImageBytes(Buffer.from(data, "base64"), mimeType,
|
|
11
|
+
throw inlineImageRefusal(`${subject} needs a base64 string \`data\` and a string \`mimeType\`.`);
|
|
12
|
+
const admitted = await admitImageBytes(Buffer.from(data, "base64"), mimeType, processor);
|
|
14
13
|
if (admitted.ok)
|
|
15
14
|
return admitted.block;
|
|
16
15
|
switch (admitted.reason) {
|
|
17
16
|
case "mime_unsupported":
|
|
18
|
-
throw inlineImageRefusal(
|
|
17
|
+
throw inlineImageRefusal(`${subject} declares mimeType ${JSON.stringify(mimeType.slice(0, 80))}, which the model API does not accept (accepted: ${ADMITTED_IMAGE_MIME_TYPES.join(", ")}).`);
|
|
19
18
|
case "magic_mismatch":
|
|
20
|
-
throw inlineImageRefusal(
|
|
19
|
+
throw inlineImageRefusal(`${subject}'s bytes do not open with a valid ${mimeType} header (empty, truncated, mis-declared, not base64, or a variant such as an Apple-optimized PNG that model APIs cannot read) — refused rather than sent.`);
|
|
21
20
|
case "raw_too_large":
|
|
22
|
-
throw inlineImageRefusal(
|
|
21
|
+
throw inlineImageRefusal(`${subject} is ${admitted.rawBytes} bytes, over the ${admitted.cap}-byte cap.`);
|
|
22
|
+
case "dimensions_unreadable":
|
|
23
|
+
case "dimensions_too_large":
|
|
24
|
+
throw inlineImageRefusal(`${subject} is refused rather than sent: ${unprocessedSizeClause(admitted)}.`);
|
|
23
25
|
case "base64_too_large":
|
|
24
|
-
throw inlineImageRefusal(
|
|
26
|
+
throw inlineImageRefusal(`${subject}'s base64 is ${admitted.base64.length} chars, over the ${IMAGE_ADMISSION.hard.imageBase64Chars}-char / 5MB API image limit — shrink it before sending.`);
|
|
25
27
|
}
|
|
26
28
|
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The Runner's same-Runner settle claims on checkpoint tokens. A claim is PER ATTEMPT: every in-Runner actor that settles a
|
|
3
|
+
* row (a resume's resolve, an in-Runner expire) opens its own claim with its CAS attempt and closes exactly that claim, once,
|
|
4
|
+
* when its duty is decided (a lost CAS, or the winner's duty done). A token is held while ANY attempt's claim is open — so a
|
|
5
|
+
* losing attempt never closes a winner's still-open claim, and a stream-side reap that loses its own expire preserves the
|
|
6
|
+
* paused-env reap record for whichever same-Runner winner is still on its way to it.
|
|
7
|
+
*/
|
|
8
|
+
import type { CheckpointToken } from "../checkpoint-store.js";
|
|
9
|
+
export declare class LocalClaims {
|
|
10
|
+
#private;
|
|
11
|
+
/** Open one attempt's claim on `token` (with its CAS attempt). */
|
|
12
|
+
open(token: CheckpointToken): void;
|
|
13
|
+
/** Close one attempt's claim on `token` — the attempt's own, once, at its duty decision. */
|
|
14
|
+
close(token: CheckpointToken): void;
|
|
15
|
+
/** Whether any same-Runner attempt's claim on `token` is open. */
|
|
16
|
+
held(token: CheckpointToken): boolean;
|
|
17
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export class LocalClaims {
|
|
2
|
+
#open = new Map();
|
|
3
|
+
open(token) {
|
|
4
|
+
this.#open.set(token, (this.#open.get(token) ?? 0) + 1);
|
|
5
|
+
}
|
|
6
|
+
close(token) {
|
|
7
|
+
const n = this.#open.get(token);
|
|
8
|
+
if (n === undefined)
|
|
9
|
+
return;
|
|
10
|
+
if (n > 1)
|
|
11
|
+
this.#open.set(token, n - 1);
|
|
12
|
+
else
|
|
13
|
+
this.#open.delete(token);
|
|
14
|
+
}
|
|
15
|
+
held(token) {
|
|
16
|
+
return this.#open.has(token);
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The person's account of the media that left the model's view of a request (`context.media_removed`, user) — one code,
|
|
3
|
+
* the reason in `detail.reason`, the message minted once here for both:
|
|
4
|
+
* - `rejected_by_provider`: the harness's request view removes the images a provider refusal points at
|
|
5
|
+
* (`engine/llm/rejected-images.ts`) and hands {@link createProviderRefusalSeat} the removals the run itself met; every
|
|
6
|
+
* request re-reads the transcript — the live failure, then its record or a rebuilt copy — so that seat announces ONCE
|
|
7
|
+
* PER RUN PER REFUSAL, keyed by the identity all of those share (`refusalAt`);
|
|
8
|
+
* - `media_budget`: the request trim (`media-byte-cap.ts`) hands {@link createMediaBudgetSeat} what it did to a request
|
|
9
|
+
* view the context hook handed on (the lane's observation flush, KL-2988-a); that seat traces every such view (`context.media_removed`, the request's numbers) and announces
|
|
10
|
+
* each block ONCE PER SESSION, by the block's identity — the digest of its bytes, which a compaction, a resume or a
|
|
11
|
+
* rewind does not change. The digest rides the session's announced record (the advisory arm, bounded) and the write is
|
|
12
|
+
* parked for the leg's flush; best effort — a lost write, or a block whose digest the bound let go, is said again by a
|
|
13
|
+
* later run, never lost. Within a run a block is looked at once.
|
|
14
|
+
* Beside the provider's image refusal sits its other refused part, a tool's input schema ({@link createToolSchemaRemovedSeat},
|
|
15
|
+
* its own code).
|
|
16
|
+
*/
|
|
17
|
+
import { type EngineNotice } from "../engine-notice.js";
|
|
18
|
+
import type { RejectedImageRemoval } from "../../internal/llm.js";
|
|
19
|
+
import type { RequestMediaLimits } from "../image-admission.js";
|
|
20
|
+
import type { RequestMediaTrim } from "../media-byte-cap.js";
|
|
21
|
+
import { type TracerHook } from "../trace.js";
|
|
22
|
+
import type { Prepared } from "./contracts.js";
|
|
23
|
+
import type { NoticeSeatInput } from "./notice-seat-input.js";
|
|
24
|
+
/** The session's announced record and the leg's receipt ledger (the parked write). */
|
|
25
|
+
export type MediaBudgetRecord = Pick<Prepared, "announcedListingsRef" | "frameReceipts">;
|
|
26
|
+
/** The provider-refusal account: one notice per refusal, once per run. */
|
|
27
|
+
export declare function createProviderRefusalSeat(ids: NoticeSeatInput): (removals: readonly RejectedImageRemoval[]) => void;
|
|
28
|
+
/**
|
|
29
|
+
* The run's account of a tool whose input schema a provider refused (`context.tool_schema_removed`, user): the loop re-sent
|
|
30
|
+
* the turn with that tool's parameters taken out of what the model sees (`engine/llm/rejected-images.ts`), and every later
|
|
31
|
+
* request built from a transcript the refusal's record stands in sends it so. ONCE PER REFUSAL (`refusalAt`): the loop
|
|
32
|
+
* re-sends once per refusal, and a refusal recorded before the run began is never re-sent, so never announced again.
|
|
33
|
+
*/
|
|
34
|
+
export declare function createToolSchemaRemovedSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: {
|
|
35
|
+
sessionId: string;
|
|
36
|
+
runId: string;
|
|
37
|
+
}): (refusal: {
|
|
38
|
+
tool: string;
|
|
39
|
+
refusalAt: number;
|
|
40
|
+
}) => void;
|
|
41
|
+
/** The request budget's account of one request view the trim cut: its trace frame, then — of the blocks it left out, those
|
|
42
|
+
* the session was not yet told of — one notice. */
|
|
43
|
+
export declare function createMediaBudgetSeat(ids: NoticeSeatInput, record: MediaBudgetRecord, trace: {
|
|
44
|
+
readonly tracer: TracerHook | undefined;
|
|
45
|
+
readonly taskId: string;
|
|
46
|
+
}): (trim: RequestMediaTrim, limits: RequestMediaLimits) => void;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { deliverEngineNotice } from "../engine-notice.js";
|
|
2
|
+
import { inlineUntrusted } from "../untrusted-text.js";
|
|
3
|
+
import { emitTrace } from "../trace.js";
|
|
4
|
+
import { announceDigest, withAnnounceDigests } from "./announce-once-ledger.js";
|
|
5
|
+
const MEDIA_REMOVED = "context.media_removed";
|
|
6
|
+
const counted = (n, noun) => (n === 1 ? `${noun === "image" ? "an" : "a"} ${noun}` : `${n} ${noun}s`);
|
|
7
|
+
function announceMediaRemoved(ids, reason, images, documents) {
|
|
8
|
+
const what = [images > 0 ? counted(images, "image") : undefined, documents > 0 ? counted(documents, "document") : undefined].filter((s) => s !== undefined).join(" and ");
|
|
9
|
+
const one = images + documents === 1;
|
|
10
|
+
const it = one ? "it" : "them";
|
|
11
|
+
const message = reason === "rejected_by_provider"
|
|
12
|
+
? `The model provider could not process ${what} in this conversation, so ${one ? "it was" : "they were"} removed ` +
|
|
13
|
+
`from what the model sees (each replaced by a line saying so) and the request was sent again without ${it}. ` +
|
|
14
|
+
`The session still holds the original; to show the model this content again, send it in another format.`
|
|
15
|
+
: `${what[0].toUpperCase()}${what.slice(1)} in this conversation no longer fit the request's media budget, so ${one ? "it was" : "they were"} removed ` +
|
|
16
|
+
`from what the model sees (the oldest go first; each is replaced by a line saying so). ` +
|
|
17
|
+
`The session still holds the original; to show the model ${it} again, read the file again or send ${it} again. Said once per image or document per conversation.`;
|
|
18
|
+
deliverEngineNotice(ids.onNotice, { code: MEDIA_REMOVED, message, detail: { reason, images, documents, sessionId: ids.sessionId, runId: ids.runId } });
|
|
19
|
+
}
|
|
20
|
+
export function createProviderRefusalSeat(ids) {
|
|
21
|
+
const announced = new Set();
|
|
22
|
+
return (removals) => {
|
|
23
|
+
for (const { refusalAt, images } of removals) {
|
|
24
|
+
if (announced.has(refusalAt))
|
|
25
|
+
continue;
|
|
26
|
+
announced.add(refusalAt);
|
|
27
|
+
announceMediaRemoved(ids, "rejected_by_provider", images, 0);
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export function createToolSchemaRemovedSeat(onNotice, ids) {
|
|
32
|
+
const announced = new Set();
|
|
33
|
+
return ({ tool, refusalAt }) => {
|
|
34
|
+
if (announced.has(refusalAt))
|
|
35
|
+
return;
|
|
36
|
+
announced.add(refusalAt);
|
|
37
|
+
const name = inlineUntrusted(tool, 160);
|
|
38
|
+
deliverEngineNotice(onNotice, {
|
|
39
|
+
code: "context.tool_schema_removed",
|
|
40
|
+
message: `Tool "${name}": the model provider refused this tool's input schema, so the request was sent again with the tool's parameters ` +
|
|
41
|
+
`taken out of what the model sees. The model can still call the tool in this conversation, but does not see its parameters. ` +
|
|
42
|
+
`Fix the schema on the server that provides the tool, then start a new conversation.`,
|
|
43
|
+
detail: { tool, sessionId: ids.sessionId, runId: ids.runId },
|
|
44
|
+
});
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
export function createMediaBudgetSeat(ids, record, trace) {
|
|
48
|
+
const lookedAt = new WeakSet();
|
|
49
|
+
return ({ removed, removedBase64Chars, items, base64Chars }, { maxItems, budgetBase64Chars }) => {
|
|
50
|
+
const cutImages = removed.filter((r) => r.type === "image").length;
|
|
51
|
+
emitTrace(trace.tracer, () => ({
|
|
52
|
+
kind: MEDIA_REMOVED,
|
|
53
|
+
version: 1,
|
|
54
|
+
taskId: trace.taskId,
|
|
55
|
+
reason: "media_budget",
|
|
56
|
+
images: cutImages,
|
|
57
|
+
documents: removed.length - cutImages,
|
|
58
|
+
removedBase64Chars,
|
|
59
|
+
items,
|
|
60
|
+
base64Chars,
|
|
61
|
+
maxItems,
|
|
62
|
+
...(budgetBase64Chars !== Infinity ? { budgetBase64Chars } : {}),
|
|
63
|
+
ts: Date.now(),
|
|
64
|
+
}));
|
|
65
|
+
const told = new Set(record.announcedListingsRef.advisories ?? []);
|
|
66
|
+
const fresh = new Set();
|
|
67
|
+
let images = 0;
|
|
68
|
+
let documents = 0;
|
|
69
|
+
for (const { block, type, data } of removed) {
|
|
70
|
+
if (lookedAt.has(block))
|
|
71
|
+
continue;
|
|
72
|
+
lookedAt.add(block);
|
|
73
|
+
const digest = announceDigest(MEDIA_REMOVED, `${type}\n${data}`);
|
|
74
|
+
if (told.has(digest) || fresh.has(digest))
|
|
75
|
+
continue;
|
|
76
|
+
fresh.add(digest);
|
|
77
|
+
if (type === "image")
|
|
78
|
+
images++;
|
|
79
|
+
else
|
|
80
|
+
documents++;
|
|
81
|
+
}
|
|
82
|
+
if (fresh.size === 0)
|
|
83
|
+
return;
|
|
84
|
+
announceMediaRemoved(ids, "media_budget", images, documents);
|
|
85
|
+
record.announcedListingsRef.advisories = withAnnounceDigests(record.announcedListingsRef.advisories, [...fresh]);
|
|
86
|
+
record.frameReceipts.listingSnapshotOwed = true;
|
|
87
|
+
};
|
|
88
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { brainToRuntime } from "../runtime.js";
|
|
2
|
-
import {
|
|
2
|
+
import { catalogOfDeps, roleModelIfSet, unheldChainRefusal } from "../roles.js";
|
|
3
3
|
import { isAliasModelId, openAiCompatChatSeat } from "../memory-engine/distiller.js";
|
|
4
4
|
import { runMemoryConsolidationDriver } from "../memory-engine/consolidation-driver.js";
|
|
5
5
|
import { recommendationUnconsumed } from "../memory-engine/consolidation.js";
|
|
@@ -26,7 +26,7 @@ export function resolveMemoryConsolidationDriver(deps) {
|
|
|
26
26
|
model = seat.chat.model;
|
|
27
27
|
}
|
|
28
28
|
else {
|
|
29
|
-
const models =
|
|
29
|
+
const models = catalogOfDeps(deps);
|
|
30
30
|
const resolved = roleModelIfSet("consolidate", {}, { models, roles: deps.roles }) ?? roleModelIfSet("summarize", {}, { models, roles: deps.roles });
|
|
31
31
|
if (resolved === undefined) {
|
|
32
32
|
throw unheldChainRefusal(["consolidate", "summarize"], models, deps.roles) ?? seatRefusal('memory consolidation has no model seat: configure RunnerDeps.memoryConsolidationDriver.chat (an endpoint triple or a chat function), or declare roles.consolidate / roles.summarize (a tier-expanded catalog\'s "flash" binding also satisfies the summarize hop). The chain deliberately does NOT fall back to the default main model — a whole-library distillation must not silently ride the most expensive seat.');
|
|
@@ -65,7 +65,7 @@ export function resolveMemoryConsolidationDriver(deps) {
|
|
|
65
65
|
export function consolidationSeatResolvable(deps) {
|
|
66
66
|
if (deps.memoryConsolidationDriver?.chat !== undefined)
|
|
67
67
|
return true;
|
|
68
|
-
const models =
|
|
68
|
+
const models = catalogOfDeps(deps);
|
|
69
69
|
return (roleModelIfSet("consolidate", {}, { models, roles: deps.roles }) ?? roleModelIfSet("summarize", {}, { models, roles: deps.roles })) !== undefined;
|
|
70
70
|
}
|
|
71
71
|
export function autoRunConsolidationFromRecommendation(args) {
|
|
@@ -116,6 +116,6 @@ export function assertAutoConsolidationWirable(deps) {
|
|
|
116
116
|
throw autoRunRefusal("RunnerDeps.autoRunOnRecommendation is true but RunnerDeps.memoryConsolidation is absent — the recommendation that would trigger a run is never minted (consolidation is OFF) and the engine's verbs refuse coded, so the trigger can never fire. An armed-but-unrunnable trigger is refused, never folded to off: wire memoryConsolidation, or leave autoRunOnRecommendation unset.");
|
|
117
117
|
}
|
|
118
118
|
if (!consolidationSeatResolvable(deps)) {
|
|
119
|
-
throw unheldChainRefusal(["consolidate", "summarize"],
|
|
119
|
+
throw unheldChainRefusal(["consolidate", "summarize"], catalogOfDeps(deps), deps.roles) ?? autoRunRefusal("RunnerDeps.autoRunOnRecommendation is true but no consolidation model seat resolves — configure RunnerDeps.memoryConsolidationDriver.chat (an endpoint triple or a chat function), or declare roles.consolidate / roles.summarize. Arming auto-run with no model to run it is refused, never folded to off (a whole-library distillation must not silently ride the default main model).");
|
|
120
120
|
}
|
|
121
121
|
}
|
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
* marker the loop stamps on the contaminated siblings, and the deadline arithmetic every mint shares (the retention
|
|
4
4
|
* defaults and the one TTL sanitizer). Moved whole out of the orchestrator so the boundary-parks phase (resource /
|
|
5
5
|
* platform / review) and the park-ask phase (the approval park) reach DOWN for the same publication seam and the same
|
|
6
|
-
* numbers, and the driver keeps reaching down for the marker its harness stamps.
|
|
7
|
-
* is the caller's.
|
|
6
|
+
* numbers, and the driver keeps reaching down for the marker its harness stamps. No engine state of its own (the
|
|
7
|
+
* publication writes the pause holder and marks the harness's capture); the only clock is the caller's.
|
|
8
8
|
*/
|
|
9
9
|
import { type CheckpointGate, type CheckpointToken, type PendingAction } from "../checkpoint-store.js";
|
|
10
10
|
import type { WorkspaceHandle } from "../remote-env.js";
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
* position (a permanent no-op) and a layer's mere presence flips `hasEffectAwareGate`, which would
|
|
24
24
|
* silence the ungated-write warning for deployments that wired no policy at all.
|
|
25
25
|
*/
|
|
26
|
-
import type
|
|
26
|
+
import { type ToolPolicy, type AskRuleEvidence, type ToolCallRequest, type WholeToolRefusal } from "../tool-policy.js";
|
|
27
27
|
import { persistedRuleMandateOf, type RuleClearanceFacts, type RuleOffersAbsence } from "../ask-origin.js";
|
|
28
28
|
import { type OrgGateVerdict, type PersistedRuleAnswer, type PersistedRuleHit, type PersistedRuleUnreadable } from "../hooks.js";
|
|
29
29
|
import type { PersistedRule, PersistedRuleVerdict, RuleOffer, ScopeRootIdentity, SegmentCoverage } from "../permission-rule-model.js";
|
|
@@ -111,7 +111,11 @@ export interface PermissionRuleLanes {
|
|
|
111
111
|
} | undefined;
|
|
112
112
|
org: {
|
|
113
113
|
adjudicate: (req: ToolCallRequest) => Promise<OrgGateVerdict>;
|
|
114
|
+
refusesWholeOver: (resolution: OrgRuleResolution) => WholeToolRefusal;
|
|
114
115
|
} | undefined;
|
|
116
|
+
/** The tools the stored rules refuse every call of — the person's and the org's, over ONE read (a request's view is one
|
|
117
|
+
* judgment), a fold of the two readings; `undefined` when neither lane is wired. */
|
|
118
|
+
wholeToolRefusals: ToolPolicy["wholeToolRefusals"];
|
|
115
119
|
}
|
|
116
120
|
/** The ORG lane: the org's verdict about one call, off the store view `read` supplies — the gate's `orgRules` face over the
|
|
117
121
|
* call's pinned read ({@link createPermissionRuleLanes}), and {@link orgVerdictBeforeClaim} over a view of its own.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import { REFUSES_NO_WHOLE_TOOL, TOOL_TABLE_VIEW_READ, toolPolicyWholeToolRefusals } from "../tool-policy.js";
|
|
1
2
|
import { persistedRuleMandateOf, ruleClearanceOf } from "../ask-origin.js";
|
|
2
3
|
import {} from "../hooks.js";
|
|
3
|
-
import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText,
|
|
4
|
+
import { adjudicatePersistedDomainRules, adjudicatePersistedNameRules, adjudicatePersistedPathRules, adjudicatePersistedRules, adjudicatePersistedToolRules, callPathFaceOf, cardRuleFormOf, eligiblePersisted, escapeForDisclosure, faceRowsSpeakFor, parseRuleText, ruleWordsOf, nameRuleSubjectOf, ruleToolGrammarOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, wholeToolRuleReaches } from "../permission-rule-model.js";
|
|
4
5
|
import { callHostTargetOf } from "../host-target.js";
|
|
5
6
|
import { callTargetViewsOf, validatePath } from "../effective-path-target.js";
|
|
6
7
|
import { bindPathRules, persistedRowAnchors, projectScopeIdentity } from "../path-rule-binding.js";
|
|
@@ -54,9 +55,10 @@ export function pathRuleLaneAnswer(table, req, ctx) {
|
|
|
54
55
|
return persistedRuleAnswerOf(adjudicatePersistedPathRules(table, { tool: req.toolName, cwd: ctx.root, sessionId: ctx.sessionId, face: callPathFaceOf(req), ...(ctx.scopeIdentity !== undefined ? { scopeIdentity: ctx.scopeIdentity } : {}) }, { ...(tighten !== undefined ? { tighten } : {}), ...(allow !== undefined ? { allow } : {}) }, ctx.anchorsOf, ctx.leads));
|
|
55
56
|
}
|
|
56
57
|
export function orgRuleLane(cfg) {
|
|
58
|
+
const questionToolExempt = (call) => wireOf("offer.orgQuestionExemption", call) === cfg.questionToolName && cfg.questionToolMounted;
|
|
57
59
|
return {
|
|
58
60
|
adjudicate: async (req) => {
|
|
59
|
-
if (
|
|
61
|
+
if (questionToolExempt(req))
|
|
60
62
|
return { status: "available" };
|
|
61
63
|
let resolution;
|
|
62
64
|
try {
|
|
@@ -73,13 +75,19 @@ export function orgRuleLane(cfg) {
|
|
|
73
75
|
return { status: "unavailable", disclosures: [`the store's org resolution cannot be read (${reading.refused}) — unreadable governance, never an empty one`] };
|
|
74
76
|
const command = req.args?.command;
|
|
75
77
|
const face = callPathFaceOf(req);
|
|
76
|
-
const verdict = reading.verdictFor({ tool:
|
|
78
|
+
const verdict = reading.verdictFor({ tool: ruleWordsOf(req, "deny"), ...(typeof command === "string" ? { command } : {}), ...(face !== undefined ? { face } : {}) });
|
|
77
79
|
const revisionCell = orgRevisionEvidenceOf(resolution, cfg.onRevisionDefect);
|
|
78
80
|
const degraded = describeUnreadableOrgRows(reading.unreadable, revisionCell.revision);
|
|
79
81
|
if (degraded !== undefined)
|
|
80
82
|
cfg.onDegraded(degraded);
|
|
81
83
|
return verdict === undefined ? { status: "available", ...revisionCell } : { status: "available", verdict, ...revisionCell };
|
|
82
84
|
},
|
|
85
|
+
refusesWholeOver: (resolution) => {
|
|
86
|
+
const reading = resolution.status === "unavailable" || resolution.status === "ungoverned" ? undefined : readOrgRules(resolution.rules);
|
|
87
|
+
if (reading === undefined || "refused" in reading)
|
|
88
|
+
return REFUSES_NO_WHOLE_TOOL;
|
|
89
|
+
return (tool) => !questionToolExempt(tool) && reading.verdictFor({ tool: ruleWordsOf(tool, "deny"), face: callPathFaceOf({ ...tool, args: undefined }) })?.behavior === "deny";
|
|
90
|
+
},
|
|
83
91
|
};
|
|
84
92
|
}
|
|
85
93
|
export function orgVerdictBeforeClaim(cfg, req) {
|
|
@@ -106,7 +114,7 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
106
114
|
}
|
|
107
115
|
}
|
|
108
116
|
if (provider === undefined)
|
|
109
|
-
return { personal: undefined, org: undefined };
|
|
117
|
+
return { personal: undefined, org: undefined, wholeToolRefusals: undefined };
|
|
110
118
|
const anonymous = readPrincipal(cfg.principal).kind === "absent";
|
|
111
119
|
const reader = cfg.rows;
|
|
112
120
|
const orgViewOf = async (toolCallId, judged) => {
|
|
@@ -119,11 +127,11 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
119
127
|
const personalAdjudicate = async (req) => {
|
|
120
128
|
if (anonymous && !cfg.localOwnerDeclared)
|
|
121
129
|
return undefined;
|
|
122
|
-
const judged =
|
|
123
|
-
if (!judged.some(([, g]) => g === "path") && faceRowsSpeakFor(callPathFaceOf(req)))
|
|
124
|
-
judged.push([req.toolName, "path"]);
|
|
130
|
+
const judged = ruleWordsOf(req, "deny").map((n) => [n, ruleToolGrammarOf(n), ruleWordsOf(req, "allow").includes(n)]);
|
|
131
|
+
if (!judged.some(([, g, grants]) => g === "path" && grants) && faceRowsSpeakFor(callPathFaceOf(req)))
|
|
132
|
+
judged.push([req.toolName, "path", true]);
|
|
125
133
|
const view = await reader.pin(req.toolCallId, req.args);
|
|
126
|
-
const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req);
|
|
134
|
+
const ownRow = (r) => judged.some(([n]) => n === r.tool) || wholeToolRuleReaches(r.tool, req, r.behavior);
|
|
127
135
|
if (judged.length === 0 && !view.rules.some(ownRow))
|
|
128
136
|
return view.unreadable !== undefined ? { unreadable: true } : undefined;
|
|
129
137
|
try {
|
|
@@ -139,7 +147,7 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
139
147
|
const leads = judgesPath ? await cfg.leads.resolve(bindPathRules(table.filter((r) => r.match === "path" || r.match === "subpath").map((r) => ({ parsed: r, ruleText: r.rule, rule: r })), (spec) => anchorsOf(spec.rule))) : NO_LEADS;
|
|
140
148
|
const scopeIdentity = await projectScopeIdentity(table, cfg.rootCanonical, cfg.leads);
|
|
141
149
|
const wholeTool = persistedRuleAnswerOf(adjudicatePersistedToolRules(table, { request: req, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }));
|
|
142
|
-
const judgedAnswer = strongestAnswer([...judged.map(([n, grammar]) => judgeAgainst(table, { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
|
|
150
|
+
const judgedAnswer = strongestAnswer([...judged.map(([n, grammar, grants]) => judgeAgainst(grants ? table : table.filter((r) => r.behavior !== "allow"), { ...req, toolName: n }, grammar, leads, scopeIdentity)), wholeTool]);
|
|
143
151
|
const unjudged = noRule.find(({ row }) => (row.behavior === "deny" || row.behavior === "ask") && eligiblePersisted(row, { tool: row.tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) }, row.behavior));
|
|
144
152
|
const answer = unjudged !== undefined && !(judgedAnswer !== undefined && "behavior" in judgedAnswer && judgedAnswer.behavior === "deny") ? unjudgedRowAnswer(unjudged.row, unjudged.why, req.toolName) : judgedAnswer;
|
|
145
153
|
const stands = answer !== undefined && (("behavior" in answer && answer.behavior === "deny") || "unreadable" in answer);
|
|
@@ -176,8 +184,19 @@ export function createPermissionRuleLanes(cfg) {
|
|
|
176
184
|
const coverage = segmentCoverageOf(command, { persisted: table }, { tool: req.toolName, cwd: cfg.root, sessionId: cfg.sessionId, ...execCwd, ...scope });
|
|
177
185
|
return coverage !== undefined ? { segmentCoverage: coverage } : undefined;
|
|
178
186
|
};
|
|
187
|
+
const personalRefusesWholeOver = async (rules) => {
|
|
188
|
+
const deny = anonymous && !cfg.localOwnerDeclared ? [] : rules.filter((r) => r.behavior === "deny" && r.match === "tool");
|
|
189
|
+
const scopeIdentity = deny.length === 0 ? undefined : await projectScopeIdentity(deny, cfg.rootCanonical, cfg.leads);
|
|
190
|
+
return deny.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => !routesContent(tool.face) && adjudicatePersistedToolRules(deny, { request: tool, cwd: cfg.root, sessionId: cfg.sessionId, ...(scopeIdentity !== undefined ? { scopeIdentity } : {}) })?.behavior === "deny";
|
|
191
|
+
};
|
|
179
192
|
const personal = provider.partitions.durable ? { adjudicate: personalAdjudicate } : undefined;
|
|
180
|
-
|
|
193
|
+
let inFlight;
|
|
194
|
+
const viewRead = () => (inFlight ??= reader.pin(TOOL_TABLE_VIEW_READ).finally(() => (inFlight = undefined)));
|
|
195
|
+
const wholeToolRefusals = toolPolicyWholeToolRefusals([
|
|
196
|
+
personal !== undefined ? { wholeToolRefusals: async () => personalRefusesWholeOver((await viewRead()).rules) } : undefined,
|
|
197
|
+
org !== undefined ? { wholeToolRefusals: async () => ((read) => (read.org !== undefined ? org.refusesWholeOver(read.org) : REFUSES_NO_WHOLE_TOOL))(await viewRead()) } : undefined,
|
|
198
|
+
]);
|
|
199
|
+
return { personal, org, wholeToolRefusals };
|
|
181
200
|
}
|
|
182
201
|
export function createRuleOffersOf(cfg) {
|
|
183
202
|
return (call, args, ask) => {
|
|
@@ -271,7 +271,7 @@ export function createPersonPathRows(cfg) {
|
|
|
271
271
|
unexcludableUnder: (scope) => judging().readDeny.unexcludableUnder?.(scope) ?? false,
|
|
272
272
|
rowUnderRoot: (scope) => judging().readDeny.rowUnderRoot?.(scope) ?? null,
|
|
273
273
|
rowAtOrBelow: (path) => judging().readDeny.rowAtOrBelow?.(path) ?? null,
|
|
274
|
-
forCall: (id) => tablesFor(id).readDeny,
|
|
274
|
+
forCall: (id) => (id === undefined ? judging() : tablesFor(id)).readDeny,
|
|
275
275
|
});
|
|
276
276
|
const writeDeny = {
|
|
277
277
|
face: "write",
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The placement fence's two engine readings (the seat and its contract: `ExecutionEnvFactoryContext.placementTarget`,
|
|
3
|
+
* remote-env.ts): the MINT folds a leg's fence once, and the SETTLE POINT reads the leg's own target once — which is
|
|
4
|
+
* also every fenced leg's receipt (a restore takes the same receipt earlier as well, against the env before and the
|
|
5
|
+
* handle after `resumeVM`, in prepare-workspace-restore.ts).
|
|
6
|
+
*/
|
|
7
|
+
import { type PlacementTarget, type WorkspaceHandle } from "../remote-env.js";
|
|
8
|
+
import type { ExecutionEnv } from "../../internal/harness.js";
|
|
9
|
+
/**
|
|
10
|
+
* The fence a leg is minted under, from its two sources: the target its checkpoint row recorded (a durable resume leg)
|
|
11
|
+
* and the one its trusted internals carry (the leg that handed it work). Member by member — a member the row states
|
|
12
|
+
* wins, a member it does not state is the internals' (a row recorded before `deviceId` existed takes the waking leg's
|
|
13
|
+
* device) — so neither source replaces the other whole. `undefined` when neither names a provider. A handed value the
|
|
14
|
+
* engine cannot read as a target (no non-empty string `provider`, a `deviceId` that is not a string) is refused loudly
|
|
15
|
+
* rather than read as "no fence", which would place the leg wherever the current binding points.
|
|
16
|
+
*/
|
|
17
|
+
export declare function mintPlacementFence(row: WorkspaceHandle | undefined, handedValue: unknown): PlacementTarget | undefined;
|
|
18
|
+
/**
|
|
19
|
+
* The leg's OWN target, read once at its settle point (what its env reports, {@link reportedPlacementTarget}) — the fence
|
|
20
|
+
* of every leg it hands work to — and every fenced leg's receipt on that same reading: an env that does not name the
|
|
21
|
+
* device its fence names is refused before anything reports the workspace or runs on it. A leg that restored a
|
|
22
|
+
* checkpointed workspace (its restore took the receipt already, against the restored handle) is refused
|
|
23
|
+
* `resume.env_failed` here too — its env may have moved after the restore (re-initialization reconnecting elsewhere) —
|
|
24
|
+
* any other leg `config.placement_not_honored`.
|
|
25
|
+
*/
|
|
26
|
+
export declare function settleOwnTarget(env: ExecutionEnv | undefined, fence: PlacementTarget | undefined, restoredCheckpoint: boolean): PlacementTarget | undefined;
|