@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
|
@@ -2,7 +2,8 @@ import { uuidv7 } from "../../internal/harness.js";
|
|
|
2
2
|
import { snapshotActorAssertion } from "../../internal/llm.js";
|
|
3
3
|
import { MAX_STEER_INPUT_ID_CHARS } from "../checkpoint-store.js";
|
|
4
4
|
import { formatHookFeedback } from "../hooks.js";
|
|
5
|
-
import { classicEventBase, failedHandlerClause, screenUserPrompt } from "../mods/stations.js";
|
|
5
|
+
import { classicEventBase, failedHandlerClause, legNoticeTaskId, screenUserPrompt } from "../mods/stations.js";
|
|
6
|
+
import { countsAsOperator } from "../input-author.js";
|
|
6
7
|
import { buildHumanInputEvent, frameMidTurnUserInput, projectHumanInput } from "../human-input-projection.js";
|
|
7
8
|
import { injectionLaneOf, isSystemInjectionPriority, steerPriorityOf, SYSTEM_INJECTION_PRIORITIES } from "../task-notification.js";
|
|
8
9
|
import { deliverEngineNotice } from "../types.js";
|
|
@@ -12,7 +13,7 @@ import { steerReplayRefusal } from "../steer-replay.js";
|
|
|
12
13
|
export function streamSteerVerb(input) {
|
|
13
14
|
const { spec, internals, queue, acceptedSteerInputs, live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, steeringError, runner } = input;
|
|
14
15
|
let steerChain = Promise.resolve();
|
|
15
|
-
const
|
|
16
|
+
const steerAs = async (author, text, options) => {
|
|
16
17
|
if (options?.userAttachments !== undefined) {
|
|
17
18
|
throw steeringError("a steer carries no attachments — declare them in TaskSpec.userAttachments on the next objective", "steering.invalid_content");
|
|
18
19
|
}
|
|
@@ -48,7 +49,7 @@ export function streamSteerVerb(input) {
|
|
|
48
49
|
let payload;
|
|
49
50
|
let mintsAFrame;
|
|
50
51
|
const publishQueued = (h) => {
|
|
51
|
-
const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId,
|
|
52
|
+
const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId, sourceTaskId: h.hookIdentity.taskId } : {};
|
|
52
53
|
queue.push({
|
|
53
54
|
...buildHumanInputEvent({
|
|
54
55
|
carrier: "steer",
|
|
@@ -93,7 +94,7 @@ export function streamSteerVerb(input) {
|
|
|
93
94
|
}
|
|
94
95
|
if (live.resultValue !== undefined || h.loop.ended)
|
|
95
96
|
throw steeringError("the task is no longer running");
|
|
96
|
-
if (mintsAFrame) {
|
|
97
|
+
if (mintsAFrame && countsAsOperator(author)) {
|
|
97
98
|
const screen = await screenUserPrompt(h.modBus, {
|
|
98
99
|
...classicEventBase(h.hookIdentity, h.permissionMode.observed),
|
|
99
100
|
prompt: text,
|
|
@@ -115,7 +116,7 @@ export function streamSteerVerb(input) {
|
|
|
115
116
|
}
|
|
116
117
|
}
|
|
117
118
|
const injectFramed = async () => {
|
|
118
|
-
const noteOptions = { provenance: "engine-note",
|
|
119
|
+
const noteOptions = { provenance: "engine-note", author, parkRecord, ...(actor !== undefined ? { actor } : {}) };
|
|
119
120
|
if (mintsAFrame)
|
|
120
121
|
armAcceptance(parkRecord, () => publishQueued(h));
|
|
121
122
|
if (injectionLaneOf(priority) === "followUp") {
|
|
@@ -136,7 +137,7 @@ export function streamSteerVerb(input) {
|
|
|
136
137
|
sessionId: h.sessionId,
|
|
137
138
|
runId: h.runId,
|
|
138
139
|
...(actor?.id !== undefined ? { actorId: actor.id } : {}),
|
|
139
|
-
...(
|
|
140
|
+
...legNoticeTaskId(h.hookIdentity),
|
|
140
141
|
},
|
|
141
142
|
});
|
|
142
143
|
}
|
|
@@ -167,5 +168,5 @@ export function streamSteerVerb(input) {
|
|
|
167
168
|
steerChain = p.then(() => undefined, () => undefined);
|
|
168
169
|
return p;
|
|
169
170
|
};
|
|
170
|
-
return { steer };
|
|
171
|
+
return { steer: (text, options) => steerAs("operator", text, options), authoredSteer: (author, text) => steerAs(author, text, undefined) };
|
|
171
172
|
}
|
|
@@ -297,28 +297,31 @@ export function judgeRunToolLists(input) {
|
|
|
297
297
|
}
|
|
298
298
|
const pool = delegationPoolReading(spec.tools ?? [], valveLeaves(spec, selector));
|
|
299
299
|
const mounted = mountedToolNames([...tools, ...(spec.tools ?? [])]);
|
|
300
|
+
const withOwnServers = (servers) => servers === undefined || servers.length === 0 ? input.declaredPeers : { ...input.declaredPeers, mcp: [...(input.declaredPeers.mcp ?? []), ...servers] };
|
|
301
|
+
const definitionServers = [...(spec.agents ?? []).flatMap((d) => d.mcp ?? []), ...pool.tools.flatMap((t) => (t.agentToolFaces ?? []).flatMap((f) => f.servers ?? []))];
|
|
300
302
|
if (!input.judgedUpstream) {
|
|
301
|
-
const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool,
|
|
303
|
+
const root = rootFacingUniverse(input.ownBy !== undefined ? new Set([...mounted, input.ownBy.toolName]) : mounted, pool, withOwnServers(definitionServers));
|
|
302
304
|
const own = [["allowed", input.own.allow], ["denied", input.own.exclude]];
|
|
303
305
|
const tell = input.toldUpstream === true ? () => undefined : advise;
|
|
304
306
|
for (const [side, value] of own)
|
|
305
307
|
judgeToolNameList(ownWhere ?? (side === "allowed" ? "TaskSpec.allowTools" : "TaskSpec.excludeTools"), side, value, root, tell, "config.tool_face_control");
|
|
306
308
|
}
|
|
307
|
-
const
|
|
308
|
-
const taskTargets = pool.tools.length > 0 ? [...children.values()] : [childFacingUniverse(poolOf([]), input.declaredPeers)];
|
|
309
|
+
const childUniverses = (servers) => pool.tools.length > 0 ? pool.tools.map((t) => childFacingUniverse(poolOf([t]), withOwnServers(servers))) : [childFacingUniverse(poolOf([]), withOwnServers(servers))];
|
|
309
310
|
for (const def of spec.agents ?? []) {
|
|
310
|
-
for (const universe of
|
|
311
|
+
for (const universe of childUniverses(def.mcp)) {
|
|
311
312
|
judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "allowed", def.allowTools, universe, advise, "config.agent.unknown_tool");
|
|
312
313
|
judgeToolNameList(`TaskSpec.agents: agent "${def.name}"`, "denied", def.denyTools, universe, advise, "config.agent.unknown_tool");
|
|
313
314
|
}
|
|
314
315
|
}
|
|
315
316
|
const replaced = new Set((spec.agents ?? []).map((d) => d.name));
|
|
316
|
-
for (const
|
|
317
|
+
for (const t of pool.tools) {
|
|
318
|
+
const universe = childFacingUniverse(poolOf([t]), input.declaredPeers);
|
|
317
319
|
for (const face of t.agentToolFaces ?? []) {
|
|
318
320
|
if (face.authored === true && !replaced.has(face.name)) {
|
|
319
321
|
const faceWhere = delegationListWhere(t.name, face.name);
|
|
320
|
-
|
|
321
|
-
judgeToolNameList(faceWhere, "
|
|
322
|
+
const faceUniverse = childFacingUniverse(poolOf([t]), withOwnServers(face.servers));
|
|
323
|
+
judgeToolNameList(faceWhere, "allowed", face.allowTools, faceUniverse, advise, "config.agent.unknown_tool");
|
|
324
|
+
judgeToolNameList(faceWhere, "denied", face.denyTools, faceUniverse, advise, "config.agent.unknown_tool");
|
|
322
325
|
}
|
|
323
326
|
}
|
|
324
327
|
judgeToolNameList(delegationListWhere(t.name, undefined), "allowed", t.agentToolLevelAllowTools, universe, advise, "config.agent.unknown_tool");
|
|
@@ -2,7 +2,7 @@ import { Type } from "typebox";
|
|
|
2
2
|
import { defineTool } from "../tools.js";
|
|
3
3
|
import { sanitizeUntrustedText, SHELLED_BODY_ENVELOPE_TAGS } from "../untrusted-text.js";
|
|
4
4
|
import { SKILL_LISTING_DEFAULT_BUDGET, SKILL_LISTING_DESC_MAX_CHARS_DEFAULT } from "../skill-listing-budget.js";
|
|
5
|
-
import { readSkillTable, skillNamedBy } from "../skill-grant.js";
|
|
5
|
+
import { readSkillTable, skillNamedBy, skillNameHint } from "../skill-grant.js";
|
|
6
6
|
import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../tool-catalog-entries.js";
|
|
7
7
|
import { skillLoadReading, substituteSkillRoot, substituteSkillRootBounded } from "./skill-base-dir.js";
|
|
8
8
|
import { readSkillsSeat } from "./skills-seat.js";
|
|
@@ -180,7 +180,7 @@ export function createSkillTool(skills, grants) {
|
|
|
180
180
|
const name = String(a.skill ?? "");
|
|
181
181
|
const skill = skillNamedBy(a, skills);
|
|
182
182
|
if (!skill) {
|
|
183
|
-
throw new Error(`Unknown skill "${name}"
|
|
183
|
+
throw new Error(`Unknown skill "${name}".${skillNameHint(a, skills)} Available skills: ${names}. ` +
|
|
184
184
|
`(Only skills registered with this deployment are loadable — other products' skills directories are not read. ` +
|
|
185
185
|
`If the user wants one of those here, read its source file and recreate its content for this deployment instead.)`);
|
|
186
186
|
}
|
|
@@ -6,16 +6,26 @@
|
|
|
6
6
|
* `assemble-result.ts`'s (`terminalCauseOf`); this module only reads.
|
|
7
7
|
*/
|
|
8
8
|
import { type AssistantMessage, type ModelOutputInvalid } from "../../internal/llm.js";
|
|
9
|
+
import type { LoopTerminalReason } from "../../internal/harness-types.js";
|
|
9
10
|
import { type RequestRoute } from "../../brain/request-route.js";
|
|
10
11
|
import type { TerminalCause } from "../types.js";
|
|
11
|
-
import type
|
|
12
|
+
import { type TerminalFailureDetail } from "../terminal-cause.js";
|
|
12
13
|
type ProviderRejected = Extract<TerminalFailureDetail, {
|
|
13
14
|
kind: "provider_rejected";
|
|
14
15
|
}>;
|
|
16
|
+
/** The failure a loop exit word names ({@link LOOP_EXIT_FAILURE}), by own-row membership; `undefined` for every other word and for no word. */
|
|
17
|
+
export declare function loopExitFailureOf(reason: LoopTerminalReason | undefined): {
|
|
18
|
+
readonly code: string;
|
|
19
|
+
readonly message: string;
|
|
20
|
+
} | undefined;
|
|
15
21
|
/** The terminal message's provider-condition verdict, as the refusal account carries it: each member read once and
|
|
16
22
|
* admitted only as a word of its closed set (a host Brain mints this message too); the reset instant only beside a
|
|
17
23
|
* condition. Absent members stay absent. */
|
|
18
24
|
export declare function providerVerdictOf(final: AssistantMessage): Pick<ProviderRejected, "providerCondition" | "providerConditionSource" | "providerResetAtMs">;
|
|
25
|
+
/** The part of the request the terminal message's refusal named, from the message's `errorKind` and `refusedTool` as the
|
|
26
|
+
* terminal read them (each once): the kind admitted only as a word of `REFUSED_REQUEST_PARTS`, a tool-schema refusal only
|
|
27
|
+
* with its tool (a non-empty string), else no account. */
|
|
28
|
+
export declare function refusedPartOf(errorKind: unknown, refusedTool: unknown): Pick<ProviderRejected, "errorKind" | "tool">;
|
|
19
29
|
/** The terminal message's request route (`apiErrorRoute`), admitted as a shape some request carries
|
|
20
30
|
* (`ROUTE_CREDENTIAL_PAIRING`); anything else is no route. */
|
|
21
31
|
export declare function requestRouteOfMessage(final: AssistantMessage): RequestRoute | undefined;
|
|
@@ -2,11 +2,23 @@ import { MODEL_OUTPUT_INVALID_CAUSES } from "../../internal/llm.js";
|
|
|
2
2
|
import { isProviderEchoShape } from "../../brain/errors.js";
|
|
3
3
|
import { isProviderCondition, isProviderConditionSource } from "../../brain/provider-dialect.js";
|
|
4
4
|
import { admittedRequestRoute } from "../../brain/request-route.js";
|
|
5
|
+
import { REFUSED_REQUEST_PARTS } from "../terminal-cause.js";
|
|
5
6
|
import { readMember } from "../thrown-value.js";
|
|
6
7
|
import { egressText } from "../untrusted-egress.js";
|
|
7
8
|
import { REDACTION_MARK } from "../redaction-marks.js";
|
|
8
9
|
import { isSensitiveName, looksLikeCredentialValue } from "../secret-env.js";
|
|
9
10
|
import { isSensitiveRecordKey } from "../credential-vocabulary.js";
|
|
11
|
+
const LOOP_EXIT_FAILURE = {
|
|
12
|
+
completed: undefined,
|
|
13
|
+
aborted_before_stream: undefined,
|
|
14
|
+
assistant_error: undefined,
|
|
15
|
+
stop_requested: undefined,
|
|
16
|
+
malformed_tool_use_exhausted: { code: "model.malformed_tool_use_exhausted", message: "The model's tool call could not be parsed (retry also failed)." },
|
|
17
|
+
truncated_output_exhausted: { code: "model.truncated_output_exhausted", message: "The model's response exceeded the output token maximum (continuing also failed)." },
|
|
18
|
+
};
|
|
19
|
+
export function loopExitFailureOf(reason) {
|
|
20
|
+
return reason !== undefined && Object.hasOwn(LOOP_EXIT_FAILURE, reason) ? LOOP_EXIT_FAILURE[reason] : undefined;
|
|
21
|
+
}
|
|
10
22
|
export function providerVerdictOf(final) {
|
|
11
23
|
const condition = readMember(final, "providerCondition");
|
|
12
24
|
const source = readMember(final, "providerConditionSource");
|
|
@@ -15,6 +27,14 @@ export function providerVerdictOf(final) {
|
|
|
15
27
|
const resetAtMs = readMember(final, "providerResetAtMs");
|
|
16
28
|
return { providerCondition: condition, providerConditionSource: source, ...(typeof resetAtMs === "number" && Number.isFinite(resetAtMs) ? { providerResetAtMs: resetAtMs } : {}) };
|
|
17
29
|
}
|
|
30
|
+
const REFUSED_REQUEST_PART_SET = new Set(REFUSED_REQUEST_PARTS);
|
|
31
|
+
export function refusedPartOf(errorKind, refusedTool) {
|
|
32
|
+
if (!REFUSED_REQUEST_PART_SET.has(errorKind))
|
|
33
|
+
return {};
|
|
34
|
+
if (errorKind !== "tool_schema_refused")
|
|
35
|
+
return { errorKind: errorKind };
|
|
36
|
+
return typeof refusedTool === "string" && refusedTool.length > 0 ? { errorKind, tool: refusedTool } : {};
|
|
37
|
+
}
|
|
18
38
|
export function requestRouteOfMessage(final) {
|
|
19
39
|
return admittedRequestRoute(readMember(final, "apiErrorRoute"));
|
|
20
40
|
}
|
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
import type { CheckpointGate, CheckpointToken } from "../checkpoint-store.js";
|
|
2
2
|
import type { TaskResult, TaskStatus, TerminalCause } from "../types.js";
|
|
3
|
+
/** The words of a failed terminal's `unstartedRow` — read off the cause itself, so the two never drift. */
|
|
4
|
+
type UnstartedRowOutcome = NonNullable<Extract<TerminalCause, {
|
|
5
|
+
kind: "failed";
|
|
6
|
+
}>["unstartedRow"]>;
|
|
3
7
|
/** The plane words a {@link TerminalCause} reads as — one derivation, called by the faces that speak
|
|
4
8
|
* them. The paused arm's `status` is its gate kind's registry row (`suspended` for an approval,
|
|
5
9
|
* a resource slice or a platform pause; `needs_review` for a plan or dry-run review, which also
|
|
@@ -17,6 +21,8 @@ export declare function terminalProjection(terminal: TerminalCause): {
|
|
|
17
21
|
/**
|
|
18
22
|
* A compensation that changes WHY a settled result ended (a resume leg's approval reopened / could not
|
|
19
23
|
* be reopened) amends the CAUSE — the one record there is. The code fills only an empty seat (the leg's
|
|
20
|
-
* own terminal code, when it had one, still names the ending); the message is extended, not replaced
|
|
24
|
+
* own terminal code, when it had one, still names the ending); the message is extended, not replaced;
|
|
25
|
+
* the row's outcome is stated on its own member (`unstartedRow`), whatever the code says.
|
|
21
26
|
*/
|
|
22
|
-
export declare function amendTerminal(result: TaskResult, code: string, message: (prior: string | undefined) => string): void;
|
|
27
|
+
export declare function amendTerminal(result: TaskResult, code: string, unstartedRow: UnstartedRowOutcome, message: (prior: string | undefined) => string): void;
|
|
28
|
+
export {};
|
|
@@ -20,9 +20,9 @@ export function terminalProjection(terminal) {
|
|
|
20
20
|
}
|
|
21
21
|
}
|
|
22
22
|
}
|
|
23
|
-
export function amendTerminal(result, code, message) {
|
|
23
|
+
export function amendTerminal(result, code, unstartedRow, message) {
|
|
24
24
|
const t = result.terminal;
|
|
25
25
|
if (t.kind !== "failed")
|
|
26
26
|
return;
|
|
27
|
-
result.terminal = { ...t, code: t.code ?? code, message: message(t.message) };
|
|
27
|
+
result.terminal = { ...t, code: t.code ?? code, message: message(t.message), unstartedRow };
|
|
28
28
|
}
|
|
@@ -258,4 +258,7 @@ export declare function createToolSearchTool(opts: {
|
|
|
258
258
|
* and every "full schemas are loaded" claim about the tools block is dropped as false. Absent ⇒
|
|
259
259
|
* the swap posture (activation rewrites the tools block; prior wording, unchanged). */
|
|
260
260
|
staticSchemaFor?: (name: string) => TSchema | undefined;
|
|
261
|
+
/** Whether the model is shown this tool. A tool its view leaves out is outside this search, and it is never answered
|
|
262
|
+
* "already available" either: what the model is not shown it cannot find here. Absent ⇒ every tool is shown. */
|
|
263
|
+
inView?: (name: string) => boolean;
|
|
261
264
|
}): AgentTool;
|
|
@@ -234,7 +234,9 @@ export function extractDiscoveredToolNames(messages, registry) {
|
|
|
234
234
|
return [...names];
|
|
235
235
|
}
|
|
236
236
|
export function createToolSearchTool(opts) {
|
|
237
|
-
const {
|
|
237
|
+
const { active, rematerialize, listingRide, staticSchemaFor, isMounted, inView } = opts;
|
|
238
|
+
const shownRegistry = () => inView === undefined ? opts.registry : new Map([...opts.registry].filter(([n]) => inView(n)));
|
|
239
|
+
const shownMounted = () => inView === undefined ? opts.mountedNames?.() : new Set([...(opts.mountedNames?.() ?? [])].filter((n) => inView(n)));
|
|
238
240
|
const directCallEnabled = opts.directCallEnabled !== false;
|
|
239
241
|
const activationPosture = directCallEnabled
|
|
240
242
|
? (staticSchemaFor !== undefined
|
|
@@ -285,11 +287,12 @@ export function createToolSearchTool(opts) {
|
|
|
285
287
|
`selection in \`query\` instead: {"query":"select:ToolA,ToolB"}. Nothing was activated.`);
|
|
286
288
|
}
|
|
287
289
|
const args = (raw ?? {});
|
|
290
|
+
const registry = shownRegistry();
|
|
288
291
|
const resolved = resolveToolSearchDetailed(args, registry);
|
|
289
292
|
const missing = resolved.missing;
|
|
290
293
|
const withdrawn = isMounted === undefined ? [] : resolved.matched.filter((n) => !isMounted(n));
|
|
291
294
|
const matched = isMounted === undefined ? resolved.matched : resolved.matched.filter((n) => isMounted(n));
|
|
292
|
-
const mounted =
|
|
295
|
+
const mounted = shownMounted() ?? new Set();
|
|
293
296
|
const missCallable = missing.filter((n) => mounted.has(n));
|
|
294
297
|
const missUnknown = missing.filter((n) => !mounted.has(n));
|
|
295
298
|
const callableNote = missCallable.length > 0
|
|
@@ -312,7 +315,6 @@ export function createToolSearchTool(opts) {
|
|
|
312
315
|
missingNote,
|
|
313
316
|
details: {
|
|
314
317
|
type: "tool-search",
|
|
315
|
-
matched: [],
|
|
316
318
|
activated: [],
|
|
317
319
|
matches: [],
|
|
318
320
|
query: typeof args.query === "string" ? args.query : "",
|
|
@@ -366,7 +368,6 @@ export function createToolSearchTool(opts) {
|
|
|
366
368
|
content: `${head}\n${lines.join("\n")}${missingNote}${ride !== undefined ? `\n\n${ride}` : ""}`,
|
|
367
369
|
details: {
|
|
368
370
|
type: "tool-search",
|
|
369
|
-
matched: matched.map(safeName),
|
|
370
371
|
activated: newly.map(safeName),
|
|
371
372
|
matches: matched.map(safeName),
|
|
372
373
|
query: typeof args.query === "string" ? args.query : "",
|
|
@@ -33,7 +33,7 @@ export declare function batchResponseDigest(result: unknown): string | undefined
|
|
|
33
33
|
* Also the one place the gate outcome reaches a frame — see the parameter. */
|
|
34
34
|
export declare function toolEndBodyFrom(result: unknown, isError: boolean,
|
|
35
35
|
/** The leg's card projector (never a module default: the engine set alone drops every declared caller card unannounced) and media budget. */
|
|
36
|
-
leg: Pick<OccurrenceFrames, "structured" | "
|
|
36
|
+
leg: Pick<OccurrenceFrames, "structured" | "mediaBudgetBase64Chars">,
|
|
37
37
|
/** The gate's record of the pass that admitted or refused this call, supplied by the CALLER of this
|
|
38
38
|
* projection — the end projection ({@link emitSettled}) reads it off the call's occurrence (its latest gate
|
|
39
39
|
* record). Deliberately a parameter and never derived from `result`: a tool's own `details`
|
|
@@ -66,8 +66,8 @@ export type OccurrenceFrame = Omit<Extract<TaskEvent, {
|
|
|
66
66
|
export interface OccurrenceFrames {
|
|
67
67
|
push(frame: OccurrenceFrame): void;
|
|
68
68
|
structured: StructuredProjector;
|
|
69
|
-
/** `RunnerDeps.
|
|
70
|
-
|
|
69
|
+
/** `RunnerDeps.mediaBudgetBase64Chars` as given — the request trim's budget, read through the same `requestMediaBudget`; required, so no site reads a second one. */
|
|
70
|
+
mediaBudgetBase64Chars: number | undefined;
|
|
71
71
|
}
|
|
72
72
|
/** The START projection: the call's occurrence opens and its start frame goes out. Every leg that announces a call
|
|
73
73
|
* comes through here (the live loop's `tool_execution_start`, the resumed leg's approved call). */
|
|
@@ -36,7 +36,7 @@ export function batchResponseDigest(result) {
|
|
|
36
36
|
: text;
|
|
37
37
|
}
|
|
38
38
|
export function toolEndBodyFrom(result, isError, leg, gate, gatedCallIdOfRun) {
|
|
39
|
-
const o = toolOutputFrom(result, leg.
|
|
39
|
+
const o = toolOutputFrom(result, leg.mediaBudgetBase64Chars);
|
|
40
40
|
const st = leg.structured(result);
|
|
41
41
|
const det = isError ? result?.details : undefined;
|
|
42
42
|
const card = isPlainRecord(det) ? det : undefined;
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
* materialization entrance; the specs this file consumes carry that reader's copy, never the caller's object.
|
|
17
17
|
*/
|
|
18
18
|
import type { AgentTool } from "../../internal/harness-types.js";
|
|
19
|
-
import type
|
|
19
|
+
import { type McpServerSpec } from "../mcp-server-spec.js";
|
|
20
20
|
import { type ToolApprovalCard } from "../tool-face.js";
|
|
21
21
|
import { type EngineNotice } from "../engine-notice.js";
|
|
22
22
|
/** The keys each specialised approval card needs on the call (the SHELL owns the
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { callerText } from "../mcp-server-spec.js";
|
|
1
2
|
import { MCP_NAMESPACE } from "../protocol-table.js";
|
|
2
3
|
import { mintNamespacePrefix } from "../protocol-naming.js";
|
|
3
4
|
import { RESERVED_APPROVAL_CARDS, TOOL_APPROVAL_CARDS, TOOL_FAMILIES, TOOL_PATH_ABSENCES, TOOL_PATH_ACCESSES, TOOL_PATH_BASES, RENDER_HINT_ACTIVITY_MAX_CHARS, RENDER_HINT_MAX_CHARS, RENDER_HINT_MAX_LIST, TOOL_KEY_MAX_CHARS, } from "../tool-face.js";
|
|
@@ -22,34 +23,39 @@ export function toolFaceProblem(face, schema, tool) {
|
|
|
22
23
|
export function faceProblem(face, schema, tool) {
|
|
23
24
|
const bound = schema === undefined ? undefined : inputKeysOf(schema);
|
|
24
25
|
const top = bound === undefined ? undefined : new Set(bound.keys.map((k) => k.name));
|
|
25
|
-
|
|
26
|
-
|
|
26
|
+
const outside = (label, value, words) => value === undefined || words.includes(value) ? undefined : `${label} ${callerText(value)} is outside the closed set (${words.join(" | ")})`;
|
|
27
|
+
const family = outside("family", face.family, TOOL_FAMILIES);
|
|
28
|
+
if (family !== undefined)
|
|
29
|
+
return family;
|
|
27
30
|
const overlong = (label, values) => {
|
|
28
31
|
const k = values.find((v) => v.length > TOOL_KEY_MAX_CHARS);
|
|
29
|
-
return k === undefined ? undefined : `${label}
|
|
32
|
+
return k === undefined ? undefined : `${label} has a key of ${k.length} characters; a roster key is at most ${TOOL_KEY_MAX_CHARS}`;
|
|
30
33
|
};
|
|
31
34
|
const vocabulary = new Set(bound?.scalar);
|
|
32
35
|
if (face.pathTarget !== undefined) {
|
|
33
36
|
if (top !== undefined && (typeof face.pathTarget.param !== "string" || !top.has(face.pathTarget.param)))
|
|
34
|
-
return `pathTarget.param ${
|
|
35
|
-
|
|
36
|
-
|
|
37
|
+
return `pathTarget.param ${callerText(face.pathTarget.param)} is not a top-level property of the tool's schema`;
|
|
38
|
+
const access = outside("pathTarget.access", face.pathTarget.access, TOOL_PATH_ACCESSES);
|
|
39
|
+
if (access !== undefined)
|
|
40
|
+
return access;
|
|
37
41
|
const base = face.pathTarget.base;
|
|
38
|
-
|
|
39
|
-
|
|
42
|
+
const baseWord = outside("pathTarget.base", base, TOOL_PATH_BASES);
|
|
43
|
+
if (baseWord !== undefined)
|
|
44
|
+
return baseWord;
|
|
40
45
|
if (base === "root" && face.pathTarget.access !== "read")
|
|
41
46
|
return `pathTarget.base "root" needs pathTarget.access "read" — two write guards (the session-transcript directory guard and the frozen-spec deny) resolve a write target against the call's working directory only, so a write face declaring a root base would be judged on two different files (#638)`;
|
|
42
47
|
const absent = face.pathTarget.absent;
|
|
43
|
-
|
|
44
|
-
|
|
48
|
+
const absentWord = outside("pathTarget.absent", absent, TOOL_PATH_ABSENCES);
|
|
49
|
+
if (absentWord !== undefined)
|
|
50
|
+
return absentWord;
|
|
45
51
|
if (absent === "base" && face.pathTarget.access !== "read")
|
|
46
52
|
return `pathTarget.absent "base" needs pathTarget.access "read" — it says the call is about the whole base directory when the slot is empty, which is a search SCOPE; a write with no path names no file, and the containment fences judge a write on its own target`;
|
|
47
53
|
const patternParam = face.pathTarget.patternParam;
|
|
48
54
|
if (patternParam !== undefined) {
|
|
49
55
|
if (top !== undefined && (typeof patternParam !== "string" || !top.has(patternParam)))
|
|
50
|
-
return `pathTarget.patternParam ${
|
|
56
|
+
return `pathTarget.patternParam ${callerText(patternParam)} is not a top-level property of the tool's schema`;
|
|
51
57
|
if (absent !== "base")
|
|
52
|
-
return `pathTarget.patternParam
|
|
58
|
+
return `pathTarget.patternParam is declared but pathTarget.absent is ${JSON.stringify(absent ?? "none")} — the pattern base is only ever read for an absent slot, so this declaration would be inert`;
|
|
53
59
|
}
|
|
54
60
|
const long = overlong("pathTarget.param", [face.pathTarget.param]) ??
|
|
55
61
|
overlong("pathTarget.aliases", face.pathTarget.aliases ?? []) ??
|
|
@@ -68,7 +74,7 @@ export function faceProblem(face, schema, tool) {
|
|
|
68
74
|
if (face.pathTarget !== undefined)
|
|
69
75
|
return `hostTarget and pathTarget are both declared — a face names one protected target, the URL a call reaches or the path it touches`;
|
|
70
76
|
if (top !== undefined && (typeof face.hostTarget.param !== "string" || !top.has(face.hostTarget.param)))
|
|
71
|
-
return `hostTarget.param ${
|
|
77
|
+
return `hostTarget.param ${callerText(face.hostTarget.param)} is not a top-level property of the tool's schema`;
|
|
72
78
|
const long = overlong("hostTarget.param", [face.hostTarget.param]);
|
|
73
79
|
if (long !== undefined)
|
|
74
80
|
return long;
|
|
@@ -77,8 +83,9 @@ export function faceProblem(face, schema, tool) {
|
|
|
77
83
|
if (hints !== undefined) {
|
|
78
84
|
const card = hints.approvalCard;
|
|
79
85
|
if (card !== undefined) {
|
|
80
|
-
|
|
81
|
-
|
|
86
|
+
const cardWord = outside("renderHints.approvalCard", card, TOOL_APPROVAL_CARDS);
|
|
87
|
+
if (cardWord !== undefined)
|
|
88
|
+
return cardWord;
|
|
82
89
|
if (RESERVED_APPROVAL_CARDS.includes(card) && (tool === undefined || engineCardOf(tool) !== card))
|
|
83
90
|
return `renderHints.approvalCard ${JSON.stringify(card)} is reserved for the engine's own tool that owns it; a declared tool takes another card or none`;
|
|
84
91
|
const missing = top === undefined ? [] : APPROVAL_CARD_REQUIRED_KEYS[card].filter((k) => !top.has(k));
|
|
@@ -98,18 +105,18 @@ export function faceProblem(face, schema, tool) {
|
|
|
98
105
|
return long;
|
|
99
106
|
const foreignCard = tool?.cardId === undefined ? undefined : offendingResultCard(hints, tool.cardId, engineCardTypes());
|
|
100
107
|
if (foreignCard !== undefined)
|
|
101
|
-
return `renderHints.resultCards names ${
|
|
108
|
+
return `renderHints.resultCards names ${callerText(foreignCard)}, outside the tool's own card namespace "${tool.cardId}/<card>" (engine cards and other contracts' namespaces are reserved)`;
|
|
102
109
|
const stray = top === undefined ? undefined : (hints.summaryParams ?? []).find((p) => !top.has(p));
|
|
103
110
|
if (stray !== undefined)
|
|
104
|
-
return `renderHints.summaryParams names ${
|
|
111
|
+
return `renderHints.summaryParams names ${callerText(stray)}, which is not a top-level property`;
|
|
105
112
|
}
|
|
106
113
|
if (top !== undefined) {
|
|
107
114
|
for (const p of face.ruleFace?.params ?? [])
|
|
108
115
|
if (!vocabulary.has(p))
|
|
109
|
-
return `ruleFace.params names ${
|
|
116
|
+
return `ruleFace.params names ${callerText(p)}, which is neither a scalar top-level property nor the declared path target`;
|
|
110
117
|
for (const p of face.ruleFace?.primaryParams ?? [])
|
|
111
118
|
if (!vocabulary.has(p))
|
|
112
|
-
return `ruleFace.primaryParams names ${
|
|
119
|
+
return `ruleFace.primaryParams names ${callerText(p)}, which is neither a top-level property nor the declared path target`;
|
|
113
120
|
}
|
|
114
121
|
const long = overlong("ruleFace.params", face.ruleFace?.params ?? []) ?? overlong("ruleFace.primaryParams", face.ruleFace?.primaryParams ?? []);
|
|
115
122
|
if (long !== undefined)
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The `tool_end` output/structured projection, verbatim from
|
|
3
3
|
* `runtask.ts`'s runLocked R4 phase. Pure functions over the harness `AgentToolResult`: zero closure
|
|
4
|
-
* state, zero runtask coupling — the module-level inputs are the text cap below and the shared media budget
|
|
5
|
-
* (`
|
|
4
|
+
* state, zero runtask coupling — the module-level inputs are the text cap below and the shared media budget reading
|
|
5
|
+
* (`requestMediaBudget`); the leg hands in its own `mediaBudgetBase64Chars`.
|
|
6
6
|
*/
|
|
7
7
|
/** A block's own size in characters — the ONE counter `tool_end.totalChars` adds up over a tool result's blocks (a
|
|
8
8
|
* consumer that re-renders a result sums the same function): a text block its text plus whatever else it carries at
|
|
@@ -14,7 +14,7 @@ type ToolOutput = {
|
|
|
14
14
|
truncated: boolean;
|
|
15
15
|
totalChars?: number;
|
|
16
16
|
};
|
|
17
|
-
export declare const toolOutputFrom: (result: unknown,
|
|
17
|
+
export declare const toolOutputFrom: (result: unknown, mediaBudgetBase64Chars: number | undefined) => ToolOutput | undefined;
|
|
18
18
|
/** The `tool_end.structured` projection over a harness tool result: the CC card when `details.type` names a card
|
|
19
19
|
* the leg admits, else undefined. Minted per leg by {@link createStructuredProjector}; every body projection takes it
|
|
20
20
|
* as a parameter — there is no module-level card set to fall back to. */
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { isTextBlock, renderContentBlock } from "../../internal/llm.js";
|
|
2
|
-
import {
|
|
2
|
+
import { requestMediaBudget } from "../image-admission.js";
|
|
3
|
+
import { isMediaBlock, mediaBlockDescriptor, omittedMediaDescriptor } from "../media-byte-cap.js";
|
|
3
4
|
import { engineCardTypes } from "../tool-registry.js";
|
|
4
5
|
import { readMember } from "../thrown-value.js";
|
|
5
6
|
const MAX_TOOL_END_OUTPUT_CHARS = 16384;
|
|
@@ -45,7 +46,7 @@ const fitMedia = (media, budget) => {
|
|
|
45
46
|
}
|
|
46
47
|
return { blocks, degraded };
|
|
47
48
|
};
|
|
48
|
-
const project = (content,
|
|
49
|
+
const project = (content, mediaBudgetBase64Chars) => {
|
|
49
50
|
if (!Array.isArray(content)) {
|
|
50
51
|
const s = typeof content === "string" ? content : (JSON.stringify(content) ?? "");
|
|
51
52
|
if (s.length <= MAX_TOOL_END_OUTPUT_CHARS)
|
|
@@ -54,19 +55,19 @@ const project = (content, mediaByteCapBytes) => {
|
|
|
54
55
|
}
|
|
55
56
|
const media = content.map(isMediaBlock);
|
|
56
57
|
const text = boundTextLane(content, content.flatMap((_, i) => (media[i] ? [] : [i])));
|
|
57
|
-
const limit =
|
|
58
|
+
const limit = requestMediaBudget(mediaBudgetBase64Chars);
|
|
58
59
|
const textBytes = [...text.forms.values()].reduce((n, f) => n + wireBytes(f), 0);
|
|
59
|
-
const fit = fitMedia(content.filter((_, i) => media[i]), limit
|
|
60
|
+
const fit = fitMedia(content.filter((_, i) => media[i]), limit - SUMMARY_RESERVE - textBytes);
|
|
60
61
|
if (!text.cut && !fit.degraded)
|
|
61
62
|
return { output: content, truncated: false };
|
|
62
63
|
let next = 0;
|
|
63
64
|
const output = content.flatMap((_, i) => (media[i] ? (fit.blocks[next++] ?? []) : text.forms.has(i) ? [text.forms.get(i)] : []));
|
|
64
65
|
return { output, truncated: true, totalChars: content.reduce((n, b) => n + toolOutputBlockChars(b), 0) };
|
|
65
66
|
};
|
|
66
|
-
export const toolOutputFrom = (result,
|
|
67
|
+
export const toolOutputFrom = (result, mediaBudgetBase64Chars) => {
|
|
67
68
|
try {
|
|
68
69
|
const content = result !== null && typeof result === "object" ? result.content : result;
|
|
69
|
-
return content === undefined ? undefined : project(content,
|
|
70
|
+
return content === undefined ? undefined : project(content, mediaBudgetBase64Chars);
|
|
70
71
|
}
|
|
71
72
|
catch {
|
|
72
73
|
return { output: "[unserializable tool output]", truncated: true };
|
|
@@ -6,7 +6,8 @@
|
|
|
6
6
|
* closed-set words, counts, the call's identity and a media type only when it can be one — never the bytes.
|
|
7
7
|
*/
|
|
8
8
|
import { type EngineNotice } from "../engine-notice.js";
|
|
9
|
-
import type
|
|
9
|
+
import { type ToolResultMediaRefusal } from "../image-admission.js";
|
|
10
|
+
import type { ImageDownsampler } from "../image-downsample.js";
|
|
10
11
|
/** The run's attribution pair, as every per-run notice carries it. */
|
|
11
12
|
export interface ToolResultMediaSeatIds {
|
|
12
13
|
sessionId: string;
|
|
@@ -17,3 +18,10 @@ export declare function toolResultMediaRefusedSeat(onNotice: ((notice: EngineNot
|
|
|
17
18
|
toolCallId: string;
|
|
18
19
|
refused: readonly ToolResultMediaRefusal[];
|
|
19
20
|
}) => void;
|
|
21
|
+
/**
|
|
22
|
+
* The run's one account of an image that goes to the model unprocessed over `IMAGE_ADMISSION.soft.targetBytes`
|
|
23
|
+
* (`config.image_processor_unavailable`, operator): said ONCE per run, at the first such image wherever it entered — a
|
|
24
|
+
* tool's result (the tool-result seat), the task's images or a person's attachment (the leg). The detail carries the
|
|
25
|
+
* image's decoded size and the target — never the bytes.
|
|
26
|
+
*/
|
|
27
|
+
export declare function imageUnprocessedSeat(onNotice: ((notice: EngineNotice) => void) | undefined, seat: ImageDownsampler | false | undefined, ids: ToolResultMediaSeatIds): (bytes: number) => void;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { deliverEngineNotice } from "../engine-notice.js";
|
|
2
|
+
import { IMAGE_ADMISSION } from "../image-admission.js";
|
|
2
3
|
export function toolResultMediaRefusedSeat(onNotice, ids) {
|
|
3
4
|
return ({ toolName, toolCallId, refused }) => {
|
|
4
5
|
const reasons = [...new Set(refused.map((r) => r.reason))].join(", ");
|
|
@@ -6,8 +7,23 @@ export function toolResultMediaRefusedSeat(onNotice, ids) {
|
|
|
6
7
|
code: "tool_result.media_refused",
|
|
7
8
|
message: `The ${JSON.stringify(toolName)} tool's result carried ${refused.length} media block(s) whose bytes the media admission refused (${reasons}). ` +
|
|
8
9
|
`Each was replaced in the result by a text placeholder naming the refusal, so neither the model nor the event stream received those bytes; ` +
|
|
9
|
-
`the tool, or the server behind it, returned bytes that are not what their block claims.`,
|
|
10
|
+
`the tool, or the server behind it, returned bytes that are not what their block claims, or that are beyond what can be sent.`,
|
|
10
11
|
detail: { toolName, toolCallId, refused: refused.map((r) => ({ ...r })), sessionId: ids.sessionId, runId: ids.runId },
|
|
11
12
|
});
|
|
12
13
|
};
|
|
13
14
|
}
|
|
15
|
+
export function imageUnprocessedSeat(onNotice, seat, ids) {
|
|
16
|
+
let told = false;
|
|
17
|
+
return (bytes) => {
|
|
18
|
+
if (told)
|
|
19
|
+
return;
|
|
20
|
+
told = true;
|
|
21
|
+
const why = seat === false ? "`RunnerDeps.imageProcessor` is `false`" : "the optional sharp dependency did not resolve and `RunnerDeps.imageProcessor` sets none";
|
|
22
|
+
deliverEngineNotice(onNotice, {
|
|
23
|
+
code: "config.image_processor_unavailable",
|
|
24
|
+
message: `An image of ${bytes} bytes went to the model as it was, over the ${IMAGE_ADMISSION.soft.targetBytes}-byte target, because this run has no image processor: ${why}. ` +
|
|
25
|
+
`Images within the hard limits are sent uncompressed (more request bytes and tokens, earlier media-budget trims); set a processor or install sharp to compress them. Said once per run.`,
|
|
26
|
+
detail: { bytes, targetBytes: IMAGE_ADMISSION.soft.targetBytes, sessionId: ids.sessionId, runId: ids.runId },
|
|
27
|
+
});
|
|
28
|
+
};
|
|
29
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The model's VIEW of the leg's tool table — the tools one request shows it.
|
|
3
|
+
*
|
|
4
|
+
* ONE rule: a tool whose every call the run's deny rules refuse is not shown. The reference removes a tool a whole-tool deny
|
|
5
|
+
* rule names from the tool pool before the model sees it (built-in and protocol tools alike; a deny wins, no allow is
|
|
6
|
+
* consulted). Here every face that can refuse a model's call answers by its own whole-tool reading, the one its refusal of a
|
|
7
|
+
* call already takes: the leg's effective policy (the fold the gate runs — the caller policy, the session and ancestor rules,
|
|
8
|
+
* the inherited parent policies; {@link ToolPolicy.wholeToolRefusals}), and the stored rules — the person's persisted rows and
|
|
9
|
+
* the org's rows, over one read of the store (`PermissionRuleLanes.wholeToolRefusals`). Only a WHOLE-TOOL rule speaks here: a
|
|
10
|
+
* rule about some calls of a tool (a command, a path, a value) leaves the tool shown, and its calls meet the gate.
|
|
11
|
+
*
|
|
12
|
+
* Read once per request, every reading side by side, each settled by the fold's own law ({@link toolPolicyWholeToolRefusals}):
|
|
13
|
+
* one that cannot answer (it throws, it does not answer in time) refuses nothing here, and the readings beside it stand — its
|
|
14
|
+
* calls still meet the gate, which is where a refusal is decided. The leg's tools stay
|
|
15
|
+
* mounted: a call the model makes anyway (a name it learned elsewhere) meets the gate and its rule's refusal. The view and
|
|
16
|
+
* the gate never decide the same question: the view says what the model is shown, the gate whether a call runs.
|
|
17
|
+
*/
|
|
18
|
+
import type { Context, StreamFn } from "../../internal/llm.js";
|
|
19
|
+
import type { TurnPromptSnapshot } from "../../prompt-assembly/turn-snapshot.js";
|
|
20
|
+
import { type ToolFingerprintInput } from "../cache-break-detector.js";
|
|
21
|
+
import { type ToolRoster } from "../tool-roster.js";
|
|
22
|
+
import { type ToolPolicy } from "../tool-policy.js";
|
|
23
|
+
/** The faces the view reads, the roster whose face the gate stamps on a call of a tool, and the leg's prefix seats (the
|
|
24
|
+
* cache-break fingerprint and the turn snapshot name the tools ACTUALLY sent). */
|
|
25
|
+
export interface ToolTableViewFaces {
|
|
26
|
+
readonly policy: Pick<ToolPolicy, "wholeToolRefusals"> | undefined;
|
|
27
|
+
/** The stored rules — the person's rows and the org's, one read of the store for both. */
|
|
28
|
+
readonly stored: Pick<ToolPolicy, "wholeToolRefusals"> | undefined;
|
|
29
|
+
readonly roster: {
|
|
30
|
+
readonly current: ToolRoster | undefined;
|
|
31
|
+
};
|
|
32
|
+
readonly fpRef: {
|
|
33
|
+
current?: {
|
|
34
|
+
systemPrompt: string;
|
|
35
|
+
tools: ToolFingerprintInput[];
|
|
36
|
+
};
|
|
37
|
+
};
|
|
38
|
+
readonly turnSnapshotRef: {
|
|
39
|
+
current?: TurnPromptSnapshot;
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
export interface ToolTableView {
|
|
43
|
+
/** The request `context` as the model is shown it: its tools block without the tools the faces refuse whole (the same
|
|
44
|
+
* object when none is) — over one read of every face. */
|
|
45
|
+
request(context: Context, signal?: AbortSignal): Promise<Context>;
|
|
46
|
+
/** Whether the last request showed the tool (before any request: every tool) — the search space of a lane that answers the
|
|
47
|
+
* model about tools between requests (ToolSearch: a tool the model is not shown is no tool it can find). */
|
|
48
|
+
shows(toolName: string): boolean;
|
|
49
|
+
}
|
|
50
|
+
/** The leg's view — `undefined` when no face reads a whole-tool rule (every request then shows the tools block as built). */
|
|
51
|
+
export declare function createToolTableView(faces: ToolTableViewFaces): ToolTableView | undefined;
|
|
52
|
+
/** A request stream that rides the view: its tools block shows what {@link ToolTableView.request} shows. A leg whose view is
|
|
53
|
+
* not seated yet rides unchanged. */
|
|
54
|
+
export declare function streamShowingView(seat: {
|
|
55
|
+
readonly current?: ToolTableView;
|
|
56
|
+
}, stream: StreamFn): StreamFn;
|