@sema-agent/core 7.60.0 → 7.62.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { canonicalizeTarget, isWinFormPath, pathFamilyOf, writeTargetPath } from "../../tools/fs/safety.js";
|
|
2
|
+
import { REFUSES_NO_WHOLE_TOOL, TOOL_TABLE_VIEW_READ } from "../tool-policy.js";
|
|
2
3
|
import { SESSION_RULES_GRAMMAR, compileSessionRuleBucket, continuesLineage, earlierGrammarAnnouncer, earlierGrammarEntries, earlierGrammarRefusalClause, readSessionRulesShape, unreadableDenyEntries } from "../session-policy-store.js";
|
|
3
|
-
import { compiledEntryName, judgeAllowEntries, uncoveredCommandSegment } from "../allow-entry.js";
|
|
4
|
+
import { compiledEntryName, judgeAllowEntries, uncoveredCommandSegment, wholeToolEntryOf } from "../allow-entry.js";
|
|
4
5
|
import { inlineUntrusted } from "../untrusted-text.js";
|
|
5
6
|
import { callTargetReadingOf, pathTargetBaseOf, readCallTarget } from "../effective-path-target.js";
|
|
6
7
|
import { egressThrownText } from "../untrusted-egress.js";
|
|
@@ -137,6 +138,10 @@ export function createSessionRulePolicy(rules, opts) {
|
|
|
137
138
|
const seedNames = compile(seed).names;
|
|
138
139
|
return {
|
|
139
140
|
nameSets: [{ ...(seedNames.deny.length > 0 ? { deny: seedNames.deny } : {}), ...(seedNames.allow.length > 0 ? { allow: seedNames.allow } : {}) }],
|
|
141
|
+
async wholeToolRefusals(signal) {
|
|
142
|
+
const { deny: denyRows, unreadable } = compile(await readRules(TOOL_TABLE_VIEW_READ, signal));
|
|
143
|
+
return unreadable !== undefined || denyRows.length === 0 ? REFUSES_NO_WHOLE_TOOL : (tool) => wholeToolEntryOf(denyRows, tool, "deny") !== undefined;
|
|
144
|
+
},
|
|
140
145
|
async check(req, signal) {
|
|
141
146
|
const { deny: denyRows, allow: allowRows, earlier, allowDirs, unreadable, pathRows } = compile(await readRules(req.toolCallId, signal));
|
|
142
147
|
if (unreadable !== undefined)
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* ONE FACT, ONE MINT. Which entries a shell child loses is decided by the execution environment's one composition
|
|
6
6
|
* (`inheritedHostEnv(policy, findings)` and the adapter's explicit grants), and the environment hands the result over as
|
|
7
7
|
* the read `ExecutionEnv.withheldEnv`. This seat reads that answer and tells it; it never recomputes it (the policy and
|
|
8
|
-
* the grants are the adapter's, not the run's). The split into the scrub's half and the
|
|
8
|
+
* the grants are the adapter's, not the run's). The split into the scrub's half and the engine's own credentials is
|
|
9
9
|
* the one the operator notice uses (`withheldEnvNames`).
|
|
10
10
|
*
|
|
11
11
|
* WHEN. At the start of every call to the engine's own shell tool (its mount, judged by the catalog's mount judge), on a
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The display bound, in characters, of a prose frame's echo. The wire contract names no number ("the injected text
|
|
3
|
+
* clipped to a display bound"); this is the one the stream has always used. A frame whose body is a list of rows the
|
|
4
|
+
* renderer already bounds declares its own wider bound on the frame (`TurnAttachment.echoBound`) rather than being
|
|
5
|
+
* cut mid-row by this one.
|
|
6
|
+
*/
|
|
7
|
+
export declare const STEERING_PREVIEW_BUDGET = 220;
|
|
8
|
+
/** The echo text of an injected frame body, bounded at `bound` (the shared budget when the frame declares none). */
|
|
9
|
+
export declare function steeringPreview(body: string, bound?: number): string;
|
|
@@ -1,19 +1,6 @@
|
|
|
1
|
-
|
|
2
|
-
* The TaskStream façade's HALT verbs (T7), verbatim from `Runner.runTaskStream`: `halt` (the bare
|
|
3
|
-
* user interrupt — the finished-task refusal, the fresh liveness test on the resolved handle, `apply` with its
|
|
4
|
-
* pre-abort ownership snapshot, the conjunctive attribution seat, the unconsumed-halt and turn-cut notices, and
|
|
5
|
-
* the birth-window poll; never on the steer FIFO chain) and `destroy` (the once-memoized reap: abort, await the
|
|
6
|
-
* run's settle bounded, then the reap lane's step). Two Runner reads, both the deployment's notice sink.
|
|
7
|
-
*
|
|
8
|
-
* Both closures are the ones the one-file façade returned, installed by the driver under their old names — no
|
|
9
|
-
* await inside either moved off its tick. `destroyOnce` (the verb's memo) moved with the verb: it is written and
|
|
10
|
-
* read by `destroy` alone.
|
|
11
|
-
*/
|
|
12
|
-
import { type TaskSpec, type TaskStream } from "../types.js";
|
|
1
|
+
import { type TaskStream } from "../types.js";
|
|
13
2
|
import type { LiveHandle, RunnerDepsSeat, TaskStreamLiveSeat } from "./contracts.js";
|
|
14
3
|
export interface StreamHaltVerbsInput {
|
|
15
|
-
/** borrowed-readonly — the task spec (`taskId` on the notices' detail). */
|
|
16
|
-
spec: TaskSpec;
|
|
17
4
|
/** borrowed-readonly — the stream's live state: `resultValue` (the finished-task refusal, the liveness tests) and `handle`. */
|
|
18
5
|
live: TaskStreamLiveSeat;
|
|
19
6
|
/** borrowed-readonly — the readiness promise; halt and destroy resolve the handle through it while the run body has not published one. */
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import { legNoticeTaskId } from "../mods/stations.js";
|
|
1
2
|
import { deliverEngineNotice } from "../types.js";
|
|
2
3
|
export function streamHaltVerbs(input) {
|
|
3
|
-
const {
|
|
4
|
+
const { live, ready, orTimeout, readyTimeoutMs: READY_TIMEOUT_MS, run, reapSuspended, runner } = input;
|
|
4
5
|
let destroyOnce;
|
|
5
6
|
const halt = async () => {
|
|
6
7
|
const haltRefused = (msg) => {
|
|
@@ -28,7 +29,7 @@ export function streamHaltVerbs(input) {
|
|
|
28
29
|
detail: {
|
|
29
30
|
sessionId: h.sessionId,
|
|
30
31
|
runId: h.runId,
|
|
31
|
-
...(
|
|
32
|
+
...legNoticeTaskId(h.hookIdentity),
|
|
32
33
|
},
|
|
33
34
|
});
|
|
34
35
|
}
|
|
@@ -42,7 +43,7 @@ export function streamHaltVerbs(input) {
|
|
|
42
43
|
cause: "user_halt",
|
|
43
44
|
sessionId: h.sessionId,
|
|
44
45
|
runId: h.runId,
|
|
45
|
-
...(
|
|
46
|
+
...legNoticeTaskId(h.hookIdentity),
|
|
46
47
|
},
|
|
47
48
|
});
|
|
48
49
|
}
|
|
@@ -1,23 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The TaskStream façade's REAP lane (T4), verbatim from `Runner.runTaskStream`: `destroy()`'s
|
|
3
3
|
* once-memoized work for a run that SUSPENDED. Runs AFTER `run` has settled (the destroy verb awaits the run before
|
|
4
|
-
* calling it), fences any concurrent resume first (the single-shot `expire` CAS
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
4
|
+
* calling it), fences any concurrent resume first (the single-shot `expire` CAS), and once the row is expired —
|
|
5
|
+
* by this CAS or by any other settler — runs the expired-row duty: evicts the token's parked-constraint entry and
|
|
6
|
+
* destroys the paused env (bounded, best-effort) behind a swallow-guarded onError sink, so the memoized `destroy()`
|
|
7
|
+
* promise keeps its "never throws" contract.
|
|
8
8
|
*
|
|
9
9
|
* The lane returns the same async function the one-file façade declared; the destroy verb still calls it in the
|
|
10
10
|
* same position (after its own `await orTimeout(run.catch(…))`), so every await inside it sits on the tick it did.
|
|
11
11
|
*/
|
|
12
12
|
import type { CheckpointToken } from "../checkpoint-store.js";
|
|
13
13
|
import type { InheritedGate, RunnerDepsSeat, SuspendReap, TaskStreamLiveSeat } from "./contracts.js";
|
|
14
|
+
import type { LocalClaims } from "./local-claims.js";
|
|
14
15
|
export interface StreamReapInput {
|
|
15
16
|
/** borrowed-readonly — the stream's live state; `reapHandle` is read ONCE at the call (the run has settled, so it is the terminal fact). */
|
|
16
17
|
live: TaskStreamLiveSeat;
|
|
17
18
|
/** borrowed-readonly — the Runner's deployment deps, read LIVE (`onError`, after the fence's await too). */
|
|
18
19
|
runner: RunnerDepsSeat;
|
|
19
|
-
/** borrowed-readonly — the Runner's same-Runner
|
|
20
|
-
locallyClaimedTokens:
|
|
20
|
+
/** borrowed-readonly — the Runner's same-Runner claims: a lost fence preserves the reap record only while one is open. */
|
|
21
|
+
locallyClaimedTokens: LocalClaims;
|
|
21
22
|
/** borrowed-mutable — the Runner's parked-constraint registry: the expired token's entry is evicted. */
|
|
22
23
|
parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
|
|
23
24
|
/** borrowed-mutable — the Runner's suspended-env reap handles: the winner (and an unclaimed loser) retires this token's record. */
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { runExpiredDuty, settleLostRow } from "./expire-settle.js";
|
|
2
2
|
export function streamReap(input) {
|
|
3
3
|
const { live, runner, locallyClaimedTokens, parentConstraintRegistry, suspendedEnvReaps } = input;
|
|
4
4
|
const reapSuspended = async () => {
|
|
@@ -20,21 +20,18 @@ export function streamReap(input) {
|
|
|
20
20
|
reportErr(err);
|
|
21
21
|
return;
|
|
22
22
|
}
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
reportErr(err);
|
|
36
|
-
}
|
|
37
|
-
}
|
|
23
|
+
const duty = {
|
|
24
|
+
token: rh.token, store: rh.store, parentConstraintRegistry, suspendedEnvReaps,
|
|
25
|
+
destroyLabel: "suspended stream env destroy",
|
|
26
|
+
onDestroyError: (err) => reportErr(err),
|
|
27
|
+
};
|
|
28
|
+
if (won)
|
|
29
|
+
return runExpiredDuty(duty);
|
|
30
|
+
const claimed = locallyClaimedTokens.held(rh.token);
|
|
31
|
+
const seen = await settleLostRow(duty);
|
|
32
|
+
const settledAway = seen === "resolved" || seen === "absent";
|
|
33
|
+
if (settledAway && !claimed && !locallyClaimedTokens.held(rh.token))
|
|
34
|
+
suspendedEnvReaps.delete(rh.token);
|
|
38
35
|
};
|
|
39
36
|
return { reapSuspended };
|
|
40
37
|
}
|
|
@@ -3,6 +3,7 @@ import type { PushQueue } from "../push-queue.js";
|
|
|
3
3
|
import type { SessionStore } from "../session.js";
|
|
4
4
|
import { type TaskEvent, type TaskSpec } from "../types.js";
|
|
5
5
|
import type { InheritedGate, ResumeRun, RunnerDepsSeat, SuspendReap, TaskIdRef, TaskStreamLiveSeat } from "./contracts.js";
|
|
6
|
+
import type { LocalClaims } from "./local-claims.js";
|
|
6
7
|
export interface StreamSettleBackstopInput {
|
|
7
8
|
/** borrowed-readonly — the task spec (read for the subagent-forwarding predicate the terminal push drains under). */
|
|
8
9
|
spec: TaskSpec;
|
|
@@ -24,8 +25,8 @@ export interface StreamSettleBackstopInput {
|
|
|
24
25
|
runner: RunnerDepsSeat;
|
|
25
26
|
/** borrowed-readonly — the Runner's session store (the terminal resume-failure arm's `unpin`). */
|
|
26
27
|
sessions: SessionStore;
|
|
27
|
-
/** borrowed-mutable — the Runner's same-Runner
|
|
28
|
-
locallyClaimedTokens:
|
|
28
|
+
/** borrowed-mutable — the Runner's same-Runner claims: a failure leg closes the resume attempt's own claim (unless the minted result's exit already did). */
|
|
29
|
+
locallyClaimedTokens: LocalClaims;
|
|
29
30
|
/** borrowed-mutable — the Runner's parked-constraint registry: the reopen-failure and terminal-failure arms evict the consumed resume token's entry. */
|
|
30
31
|
parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
|
|
31
32
|
/** borrowed-mutable — the Runner's suspended-env reap handles: the terminal resume-failure arm takes and destroys this token's. */
|
|
@@ -16,8 +16,10 @@ export function streamSettleBackstop(input) {
|
|
|
16
16
|
const reopenable = resume !== undefined && live.resultValue === undefined && resume.pendingActionStarted !== true && !(resumeDecisionWasNegative(resume) && resume.decisionDelivered === true);
|
|
17
17
|
let reopenCommitted = false;
|
|
18
18
|
let reopenStateUnknown = false;
|
|
19
|
+
let unstartedRow;
|
|
19
20
|
if (reopenable && resume !== undefined) {
|
|
20
21
|
const row = await compensateUnstarted(resume.reopenUnstarted, reopenReason);
|
|
22
|
+
unstartedRow = row.kind;
|
|
21
23
|
if (row.kind === "reopened") {
|
|
22
24
|
reopenCommitted = true;
|
|
23
25
|
message = `${message} — ${unstartedRowSentence(row)}`;
|
|
@@ -33,8 +35,8 @@ export function streamSettleBackstop(input) {
|
|
|
33
35
|
detail = replacement.detail;
|
|
34
36
|
}
|
|
35
37
|
}
|
|
36
|
-
if (resume)
|
|
37
|
-
locallyClaimedTokens.
|
|
38
|
+
if (resume && live.resultValue === undefined)
|
|
39
|
+
locallyClaimedTokens.close(resume.cp.token);
|
|
38
40
|
if (resume && !reopenCommitted && live.resultValue === undefined) {
|
|
39
41
|
parentConstraintRegistry.delete(resume.cp.token);
|
|
40
42
|
await settleTeardownLeg(() => sessions.unpin?.(resume.cp.sessionId), "sessions.unpin (resume-failure leg)", (e) => runner.deps.onError?.(e, { phase: "config", sessionId: resume.cp.sessionId }));
|
|
@@ -70,7 +72,7 @@ export function streamSettleBackstop(input) {
|
|
|
70
72
|
taskId: taskIdRef.current ?? "unknown",
|
|
71
73
|
sessionId: taskIdRef.sessionId ?? "unknown",
|
|
72
74
|
...(taskIdRef.runId !== undefined ? { runId: taskIdRef.runId } : {}),
|
|
73
|
-
terminal: { kind: "failed", ...(code !== undefined ? { code } : {}), message, ...(detail !== undefined ? { detail } : {}) },
|
|
75
|
+
terminal: { kind: "failed", ...(code !== undefined ? { code } : {}), message, ...(detail !== undefined ? { detail } : {}), ...(unstartedRow !== undefined ? { unstartedRow } : {}) },
|
|
74
76
|
result: "", resultEntryIds: [],
|
|
75
77
|
...(remoteEnvFailure !== undefined ? { remoteEnvFailures: remoteEnvFailure } : {}),
|
|
76
78
|
...(taskIdRef.effectiveMemoryScopes !== undefined ? { effectiveMemoryScopes: taskIdRef.effectiveMemoryScopes } : {}),
|
|
@@ -1,9 +1,10 @@
|
|
|
1
|
+
import { type AuthoredSteer } from "../input-author.js";
|
|
1
2
|
import type { PushQueue } from "../push-queue.js";
|
|
2
3
|
import { type TaskEvent, type TaskSpec, type TaskStream } from "../types.js";
|
|
3
4
|
import type { LiveHandle, RunInternals, RunnerDepsSeat, TaskStreamLiveSeat } from "./contracts.js";
|
|
4
5
|
import { type SteerReplayRecord, type SteerReplayRefusalDetail } from "../steer-replay.js";
|
|
5
6
|
export interface StreamSteerVerbInput {
|
|
6
|
-
/** borrowed-readonly — the task spec (`principal
|
|
7
|
+
/** borrowed-readonly — the task spec (`principal`). */
|
|
7
8
|
spec: TaskSpec;
|
|
8
9
|
/** borrowed-readonly — the trusted run-internals channel (the spawning tool id the ledger frame carries). */
|
|
9
10
|
internals: RunInternals | undefined;
|
|
@@ -25,7 +26,9 @@ export interface StreamSteerVerbInput {
|
|
|
25
26
|
runner: RunnerDepsSeat;
|
|
26
27
|
}
|
|
27
28
|
export interface StreamSteerVerbResult {
|
|
28
|
-
/** The stream's `steer` verb. */
|
|
29
|
+
/** The stream's `steer` verb: every input it takes is the operator's. */
|
|
29
30
|
steer: TaskStream["steer"];
|
|
31
|
+
/** The same verb under an author the engine states (an observer's report) — registered on the stream object, never on the package face. */
|
|
32
|
+
authoredSteer: AuthoredSteer;
|
|
30
33
|
}
|
|
31
34
|
export declare function streamSteerVerb(input: StreamSteerVerbInput): StreamSteerVerbResult;
|
|
@@ -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
|
}
|
|
@@ -47,8 +48,9 @@ export function streamSteerVerb(input) {
|
|
|
47
48
|
};
|
|
48
49
|
let payload;
|
|
49
50
|
let mintsAFrame;
|
|
51
|
+
let rewrittenBy;
|
|
50
52
|
const publishQueued = (h) => {
|
|
51
|
-
const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId,
|
|
53
|
+
const identity = internals?.parentToolCallId !== undefined ? { parentToolCallId: internals.parentToolCallId, sourceTaskId: h.hookIdentity.taskId } : {};
|
|
52
54
|
queue.push({
|
|
53
55
|
...buildHumanInputEvent({
|
|
54
56
|
carrier: "steer",
|
|
@@ -59,6 +61,7 @@ export function streamSteerVerb(input) {
|
|
|
59
61
|
...(actor !== undefined ? { actor } : {}),
|
|
60
62
|
...(actor?.issuer !== undefined ? { issuer: actor.issuer } : {}),
|
|
61
63
|
...(spec.principal !== undefined ? { principal: spec.principal } : {}),
|
|
64
|
+
...(rewrittenBy !== undefined ? { rewrittenBy } : {}),
|
|
62
65
|
}),
|
|
63
66
|
eventId: uuidv7(),
|
|
64
67
|
...identity,
|
|
@@ -93,7 +96,7 @@ export function streamSteerVerb(input) {
|
|
|
93
96
|
}
|
|
94
97
|
if (live.resultValue !== undefined || h.loop.ended)
|
|
95
98
|
throw steeringError("the task is no longer running");
|
|
96
|
-
if (mintsAFrame) {
|
|
99
|
+
if (mintsAFrame && countsAsOperator(author)) {
|
|
97
100
|
const screen = await screenUserPrompt(h.modBus, {
|
|
98
101
|
...classicEventBase(h.hookIdentity, h.permissionMode.observed),
|
|
99
102
|
prompt: text,
|
|
@@ -110,12 +113,18 @@ export function streamSteerVerb(input) {
|
|
|
110
113
|
if (screen?.block !== undefined && screen.block !== "") {
|
|
111
114
|
throw steeringError(`the deployment's userPromptSubmit hook blocked this steering input: ${inlineUntrusted(screen.block)}`, "steering.blocked_by_hook");
|
|
112
115
|
}
|
|
116
|
+
if (screen?.kind === "answered" && screen.rewrittenBy !== undefined) {
|
|
117
|
+
const rewritten = projectHumanInput({ text: screen.text, actor, source: "steer" });
|
|
118
|
+
payload = trusted ? formatHookFeedback(rewritten, h.reminderMark) : frameMidTurnUserInput(rewritten);
|
|
119
|
+
mintsAFrame = payload.trim().length !== 0;
|
|
120
|
+
rewrittenBy = screen.rewrittenBy;
|
|
121
|
+
}
|
|
113
122
|
if (screen?.additionalContext !== undefined && screen.additionalContext !== "") {
|
|
114
123
|
payload = `${formatHookFeedback(screen.additionalContext, h.reminderMark)}\n\n${payload}`;
|
|
115
124
|
}
|
|
116
125
|
}
|
|
117
126
|
const injectFramed = async () => {
|
|
118
|
-
const noteOptions = { provenance: "engine-note",
|
|
127
|
+
const noteOptions = { provenance: "engine-note", author, parkRecord, ...(actor !== undefined ? { actor } : {}) };
|
|
119
128
|
if (mintsAFrame)
|
|
120
129
|
armAcceptance(parkRecord, () => publishQueued(h));
|
|
121
130
|
if (injectionLaneOf(priority) === "followUp") {
|
|
@@ -136,7 +145,7 @@ export function streamSteerVerb(input) {
|
|
|
136
145
|
sessionId: h.sessionId,
|
|
137
146
|
runId: h.runId,
|
|
138
147
|
...(actor?.id !== undefined ? { actorId: actor.id } : {}),
|
|
139
|
-
...(
|
|
148
|
+
...legNoticeTaskId(h.hookIdentity),
|
|
140
149
|
},
|
|
141
150
|
});
|
|
142
151
|
}
|
|
@@ -167,5 +176,5 @@ export function streamSteerVerb(input) {
|
|
|
167
176
|
steerChain = p.then(() => undefined, () => undefined);
|
|
168
177
|
return p;
|
|
169
178
|
};
|
|
170
|
-
return { steer };
|
|
179
|
+
return { steer: (text, options) => steerAs("operator", text, options), authoredSteer: (author, text) => steerAs(author, text, undefined) };
|
|
171
180
|
}
|
|
@@ -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
|
|
@@ -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,6 +16,8 @@ export const APPROVAL_CARD_REQUIRED_KEYS = Object.freeze({
|
|
|
16
16
|
plan: [],
|
|
17
17
|
question: [],
|
|
18
18
|
generic: [],
|
|
19
|
+
"computer-access": ["apps"],
|
|
20
|
+
"computer-control": [],
|
|
19
21
|
});
|
|
20
22
|
export function toolFaceProblem(face, schema, tool) {
|
|
21
23
|
return faceProblem(face, schema, tool);
|
|
@@ -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 };
|