@sema-agent/core 7.59.0 → 7.61.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,8 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { claimedMediaType } from "./media-byte-cap.js";
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
3
2
|
import { readMember } from "./thrown-value.js";
|
|
4
|
-
|
|
5
|
-
export const MAX_IMAGE_DOWNSAMPLE_INPUT_BYTES = 64 * 1024 * 1024;
|
|
3
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
6
4
|
export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024;
|
|
7
5
|
const spells = (b, at, text) => {
|
|
8
6
|
if (b.length < at + text.length)
|
|
@@ -14,51 +12,182 @@ const spells = (b, at, text) => {
|
|
|
14
12
|
};
|
|
15
13
|
const u32be = (b, at) => ((b[at] << 24) >>> 0) + (b[at + 1] << 16) + (b[at + 2] << 8) + b[at + 3];
|
|
16
14
|
const u16le = (b, at) => b[at] + (b[at + 1] << 8);
|
|
17
|
-
const
|
|
15
|
+
const u16be = (b, at) => (b[at] << 8) + b[at + 1];
|
|
16
|
+
const u24le = (b, at) => b[at] + (b[at + 1] << 8) + (b[at + 2] << 16);
|
|
17
|
+
const u32le = (b, at) => (u24le(b, at) + (b[at + 3] << 24)) >>> 0;
|
|
18
|
+
const IMAGE_HEADER_CHECKS = Object.freeze({
|
|
18
19
|
"image/png": (b) => b.length >= 24 && spells(b, 0, "\x89PNG\r\n\x1a\n") && u32be(b, 8) === 13 && spells(b, 12, "IHDR") && u32be(b, 16) > 0 && u32be(b, 20) > 0,
|
|
19
20
|
"image/jpeg": (b) => b.length >= 4 && b[0] === 0xff && b[1] === 0xd8 && b[2] === 0xff && b[3] >= 0xc0,
|
|
20
21
|
"image/gif": (b) => b.length >= 13 && (spells(b, 0, "GIF87a") || spells(b, 0, "GIF89a")) && u16le(b, 6) > 0 && u16le(b, 8) > 0,
|
|
21
22
|
"image/webp": (b) => b.length >= 16 && spells(b, 0, "RIFF") && spells(b, 8, "WEBP") && (spells(b, 12, "VP8 ") || spells(b, 12, "VP8L") || spells(b, 12, "VP8X")),
|
|
22
|
-
};
|
|
23
|
+
});
|
|
24
|
+
const MiB = 1024 * 1024;
|
|
25
|
+
const IMAGE_BASE64_CHARS = 5 * MiB;
|
|
26
|
+
const IMAGE_BASE64_RAW_BYTES = (IMAGE_BASE64_CHARS * 3) / 4;
|
|
27
|
+
export const IMAGE_ADMISSION = Object.freeze({
|
|
28
|
+
hard: Object.freeze({
|
|
29
|
+
formats: IMAGE_HEADER_CHECKS,
|
|
30
|
+
readBytes: Object.freeze({ withoutProcessor: IMAGE_BASE64_RAW_BYTES, withProcessor: 64 * MiB }),
|
|
31
|
+
urlBytes: 20 * MiB,
|
|
32
|
+
rejectEdge: 2000,
|
|
33
|
+
imageBase64Chars: IMAGE_BASE64_CHARS,
|
|
34
|
+
}),
|
|
35
|
+
soft: Object.freeze({ frameEdge: 2000, rawBytes: IMAGE_BASE64_RAW_BYTES, targetBytes: 512_000 }),
|
|
36
|
+
request: Object.freeze({
|
|
37
|
+
maxItems: 100,
|
|
38
|
+
largeWindow: Object.freeze({ fromContextWindow: 1_000_000, maxItems: 600 }),
|
|
39
|
+
margin: 20,
|
|
40
|
+
budgetBase64Chars: 40 * MiB,
|
|
41
|
+
hysteresisBase64Chars: 10 * MiB,
|
|
42
|
+
}),
|
|
43
|
+
});
|
|
44
|
+
const smallestRequestMediaBudget = () => 2 * IMAGE_ADMISSION.request.hysteresisBase64Chars;
|
|
45
|
+
export function requestMediaBudget(knob) {
|
|
46
|
+
const budget = knob ?? IMAGE_ADMISSION.request.budgetBase64Chars;
|
|
47
|
+
return budget === 0 ? Infinity : budget;
|
|
48
|
+
}
|
|
49
|
+
export function requestMediaLimits(model, knob) {
|
|
50
|
+
const { maxItems, largeWindow, margin, hysteresisBase64Chars } = IMAGE_ADMISSION.request;
|
|
51
|
+
const window = model.contextWindow;
|
|
52
|
+
return { maxItems: typeof window === "number" && window >= largeWindow.fromContextWindow ? largeWindow.maxItems : maxItems, margin, budgetBase64Chars: requestMediaBudget(knob), hysteresisBase64Chars };
|
|
53
|
+
}
|
|
54
|
+
export function checkedRequestMediaBudget(value, seat) {
|
|
55
|
+
if (value === undefined || value === 0 || value === Infinity || (Number.isInteger(value) && value >= smallestRequestMediaBudget()))
|
|
56
|
+
return;
|
|
57
|
+
const e = new Error(`${seat} ${describeRejectedValue(value)} is not a request media budget — expected a whole number of base64 characters of at least ${smallestRequestMediaBudget()} (twice the ${IMAGE_ADMISSION.request.hysteresisBase64Chars}-character margin a cut leaves under the budget), 0 or Infinity for no budget, or omit it for the default ${IMAGE_ADMISSION.request.budgetBase64Chars}`);
|
|
58
|
+
e.code = "config.invalid_argument";
|
|
59
|
+
throw e;
|
|
60
|
+
}
|
|
23
61
|
export function imageMagicMatches(bytes, mimeType) {
|
|
24
|
-
|
|
62
|
+
const formats = IMAGE_ADMISSION.hard.formats;
|
|
63
|
+
return Object.hasOwn(formats, mimeType) && formats[mimeType](bytes);
|
|
64
|
+
}
|
|
65
|
+
function jpegFrameAt(b) {
|
|
66
|
+
if (b.length < 4 || b[0] !== 0xff || b[1] !== 0xd8)
|
|
67
|
+
return undefined;
|
|
68
|
+
let at = 2;
|
|
69
|
+
while (at + 9 < b.length) {
|
|
70
|
+
if (b[at] !== 0xff) {
|
|
71
|
+
at++;
|
|
72
|
+
continue;
|
|
73
|
+
}
|
|
74
|
+
const marker = b[at + 1];
|
|
75
|
+
if (marker === 0xff) {
|
|
76
|
+
at++;
|
|
77
|
+
continue;
|
|
78
|
+
}
|
|
79
|
+
if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc)
|
|
80
|
+
return at;
|
|
81
|
+
if ((marker >= 0xd0 && marker <= 0xd9) || marker === 0x01) {
|
|
82
|
+
at += 2;
|
|
83
|
+
continue;
|
|
84
|
+
}
|
|
85
|
+
const length = u16be(b, at + 2);
|
|
86
|
+
if (length < 2)
|
|
87
|
+
return undefined;
|
|
88
|
+
at += 2 + length;
|
|
89
|
+
}
|
|
90
|
+
return undefined;
|
|
91
|
+
}
|
|
92
|
+
export function readImageHeaderDimensions(b) {
|
|
93
|
+
if (b.length < 10)
|
|
94
|
+
return undefined;
|
|
95
|
+
if (b[0] === 0x89 && b[1] === 0x50 && b[2] === 0x4e && b[3] === 0x47)
|
|
96
|
+
return b.length >= 24 ? { width: u32be(b, 16), height: u32be(b, 20) } : undefined;
|
|
97
|
+
if (b[0] === 0x47 && b[1] === 0x49 && b[2] === 0x46)
|
|
98
|
+
return { width: u16le(b, 6), height: u16le(b, 8) };
|
|
99
|
+
const frame = jpegFrameAt(b);
|
|
100
|
+
if (frame !== undefined)
|
|
101
|
+
return { height: u16be(b, frame + 5), width: u16be(b, frame + 7) };
|
|
102
|
+
if (b[0] === 0xff && b[1] === 0xd8)
|
|
103
|
+
return undefined;
|
|
104
|
+
if (b.length >= 30 && spells(b, 0, "RIFF") && spells(b, 8, "WEBP")) {
|
|
105
|
+
if (spells(b, 12, "VP8 "))
|
|
106
|
+
return { width: u16le(b, 26) & 0x3fff, height: u16le(b, 28) & 0x3fff };
|
|
107
|
+
if (spells(b, 12, "VP8L")) {
|
|
108
|
+
const bits = u32le(b, 21);
|
|
109
|
+
return { width: (bits & 0x3fff) + 1, height: ((bits >>> 14) & 0x3fff) + 1 };
|
|
110
|
+
}
|
|
111
|
+
if (spells(b, 12, "VP8X"))
|
|
112
|
+
return { width: u24le(b, 24) + 1, height: u24le(b, 27) + 1 };
|
|
113
|
+
}
|
|
114
|
+
return undefined;
|
|
25
115
|
}
|
|
26
116
|
export function pdfMagicMatches(bytes) {
|
|
27
117
|
return bytes.length >= 5 && bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46 && bytes[4] === 0x2d;
|
|
28
118
|
}
|
|
29
119
|
export const ADMITTED_IMAGE_MIME_TYPES = Object.freeze(["image/png", "image/jpeg", "image/gif", "image/webp"]);
|
|
30
|
-
export function imageReadCap(
|
|
31
|
-
|
|
120
|
+
export function imageReadCap(processor) {
|
|
121
|
+
const { readBytes } = IMAGE_ADMISSION.hard;
|
|
122
|
+
return processor === "none" ? readBytes.withoutProcessor : readBytes.withProcessor;
|
|
32
123
|
}
|
|
33
|
-
export
|
|
124
|
+
export function unprocessedSizeClause(a) {
|
|
125
|
+
return a.reason === "dimensions_unreadable"
|
|
126
|
+
? "it could not be processed and its header states no pixel size — convert it to PNG, JPEG, GIF, or WebP"
|
|
127
|
+
: `at ${a.width}x${a.height}px it is over the ${a.limit}x${a.limit}px limit and could not be shrunk — resize it to fit within ${a.limit}x${a.limit}px`;
|
|
128
|
+
}
|
|
129
|
+
export async function admitImageBytes(bytes, claimedMime, processor) {
|
|
34
130
|
const rawBytes = bytes.byteLength;
|
|
35
131
|
if (!ADMITTED_IMAGE_MIME_TYPES.includes(claimedMime))
|
|
36
132
|
return { ok: false, reason: "mime_unsupported", rawBytes };
|
|
37
|
-
const cap = imageReadCap(
|
|
133
|
+
const cap = imageReadCap(processor);
|
|
38
134
|
if (rawBytes > cap)
|
|
39
135
|
return { ok: false, reason: "raw_too_large", rawBytes, cap };
|
|
40
136
|
if (!imageMagicMatches(bytes, claimedMime))
|
|
41
137
|
return { ok: false, reason: "magic_mismatch", rawBytes };
|
|
42
|
-
let
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
138
|
+
let shipped;
|
|
139
|
+
const memory = processor !== "none" ? producedBy(processor) : undefined;
|
|
140
|
+
const inputDigest = memory !== undefined ? digestOf(bytes) : undefined;
|
|
141
|
+
const known = memory !== undefined && inputDigest !== undefined && memory.has(inputDigest);
|
|
142
|
+
if (processor !== "none" && !known) {
|
|
143
|
+
const out = await Promise.resolve()
|
|
144
|
+
.then(() => processor(Buffer.from(bytes), claimedMime))
|
|
145
|
+
.catch(() => undefined);
|
|
146
|
+
const outBytes = out !== undefined ? Buffer.from(out.base64, "base64") : undefined;
|
|
147
|
+
const outMime = outBytes !== undefined ? sniffImageMime(outBytes) : undefined;
|
|
148
|
+
if (out !== undefined && outBytes !== undefined && outMime !== undefined)
|
|
149
|
+
shipped = { bytes: outBytes, base64: out.base64, mimeType: outMime, ...(out.dimensions !== undefined ? { dimensions: out.dimensions } : {}) };
|
|
52
150
|
}
|
|
53
|
-
|
|
54
|
-
|
|
151
|
+
const fromProcessor = shipped !== undefined;
|
|
152
|
+
shipped ??= { bytes, base64: Buffer.from(bytes).toString("base64"), mimeType: claimedMime };
|
|
153
|
+
const header = readImageHeaderDimensions(shipped.bytes);
|
|
154
|
+
if (header === undefined)
|
|
155
|
+
return { ok: false, reason: "dimensions_unreadable", rawBytes };
|
|
156
|
+
const limit = IMAGE_ADMISSION.hard.rejectEdge;
|
|
157
|
+
if (header.width > limit || header.height > limit)
|
|
158
|
+
return { ok: false, reason: "dimensions_too_large", rawBytes, width: header.width, height: header.height, limit };
|
|
159
|
+
const { base64, mimeType, dimensions } = shipped;
|
|
160
|
+
if (base64.length > IMAGE_ADMISSION.hard.imageBase64Chars)
|
|
55
161
|
return { ok: false, reason: "base64_too_large", rawBytes, base64 };
|
|
56
162
|
const resized = dimensions !== undefined &&
|
|
57
163
|
dimensions.displayWidth > 0 &&
|
|
58
164
|
dimensions.displayHeight > 0 &&
|
|
59
165
|
(dimensions.originalWidth !== dimensions.displayWidth || dimensions.originalHeight !== dimensions.displayHeight);
|
|
166
|
+
if (memory !== undefined && (fromProcessor || known))
|
|
167
|
+
memory.add(fromProcessor ? digestOf(shipped.bytes) : inputDigest);
|
|
60
168
|
return { ok: true, block: { type: "image", data: base64, mimeType }, originalSize: rawBytes, ...(dimensions !== undefined ? { dimensions } : {}), resized };
|
|
61
169
|
}
|
|
170
|
+
const PRODUCED_KEPT = 256;
|
|
171
|
+
const produced = new WeakMap();
|
|
172
|
+
function producedBy(processor) {
|
|
173
|
+
let kept = produced.get(processor);
|
|
174
|
+
if (kept === undefined)
|
|
175
|
+
produced.set(processor, (kept = new Set()));
|
|
176
|
+
const set = kept;
|
|
177
|
+
return {
|
|
178
|
+
has: (digest) => set.has(digest),
|
|
179
|
+
add: (digest) => {
|
|
180
|
+
set.delete(digest);
|
|
181
|
+
set.add(digest);
|
|
182
|
+
if (set.size > PRODUCED_KEPT)
|
|
183
|
+
set.delete(set.values().next().value);
|
|
184
|
+
},
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
const digestOf = (bytes) => createHash("sha256").update(bytes).digest("base64");
|
|
188
|
+
export function sniffImageMime(bytes) {
|
|
189
|
+
return ADMITTED_IMAGE_MIME_TYPES.find((mime) => imageMagicMatches(bytes, mime));
|
|
190
|
+
}
|
|
62
191
|
export const ADMITTED_DOCUMENT_MIME_TYPES = Object.freeze(["application/pdf"]);
|
|
63
192
|
export function admitDocumentBytes(bytes, claimedMime) {
|
|
64
193
|
const rawBytes = bytes.byteLength;
|
|
@@ -77,22 +206,29 @@ const REFUSAL_CLAUSE = {
|
|
|
77
206
|
mime_unsupported: (r) => `${r.mimeType ?? "its media type"} is not a ${r.type} type the model accepts (${ADMITTED_FOR[r.type].join(", ")})`,
|
|
78
207
|
raw_too_large: (r) => `its ${r.bytes} bytes exceed the ${r.limit}-byte cap`,
|
|
79
208
|
magic_mismatch: (r) => `its ${r.bytes} bytes do not open with a valid ${r.mimeType ?? `${r.type}`} header`,
|
|
209
|
+
dimensions_unreadable: () => unprocessedSizeClause({ reason: "dimensions_unreadable" }),
|
|
210
|
+
dimensions_too_large: (r) => unprocessedSizeClause({ reason: "dimensions_too_large", width: r.width, height: r.height, limit: r.limit }),
|
|
80
211
|
base64_too_large: (r) => `its base64 encoding exceeds the ${r.limit}-character provider limit (${r.bytes} bytes)`,
|
|
81
212
|
};
|
|
82
213
|
const placeholderOf = (toolName, r) => ({
|
|
83
214
|
type: "text",
|
|
84
215
|
text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})]`,
|
|
85
216
|
});
|
|
217
|
+
const MEDIA_BLOCK_TYPES = new Set(["image", "document"]);
|
|
218
|
+
export function claimedMediaType(block) {
|
|
219
|
+
const type = readMember(block, "type");
|
|
220
|
+
return MEDIA_BLOCK_TYPES.has(type) ? type : undefined;
|
|
221
|
+
}
|
|
86
222
|
const claimsMedia = (block) => claimedMediaType(block) !== undefined;
|
|
87
|
-
async function admitBlock(block) {
|
|
223
|
+
async function admitBlock(block, processor) {
|
|
88
224
|
const type = claimedMediaType(block);
|
|
89
225
|
if (type === undefined)
|
|
90
226
|
return { block };
|
|
91
227
|
const data = readMember(block, "data");
|
|
92
228
|
const mime = readMember(block, "mimeType");
|
|
93
229
|
const echo = mediaTypeEcho(mime);
|
|
94
|
-
const refusal = (reason, bytes, limit) => ({
|
|
95
|
-
refusal: { type, reason, bytes, ...(limit !== undefined ? { limit } : {}), ...(echo !== undefined ? { mimeType: echo } : {}) },
|
|
230
|
+
const refusal = (reason, bytes, limit, size) => ({
|
|
231
|
+
refusal: { type, reason, bytes, ...(limit !== undefined ? { limit } : {}), ...(size ?? {}), ...(echo !== undefined ? { mimeType: echo } : {}) },
|
|
96
232
|
});
|
|
97
233
|
if (typeof data !== "string")
|
|
98
234
|
return refusal("undecodable", 0);
|
|
@@ -100,7 +236,7 @@ async function admitBlock(block) {
|
|
|
100
236
|
try {
|
|
101
237
|
const bytes = Buffer.from(data, "base64");
|
|
102
238
|
const claimed = typeof mime === "string" ? mime : "";
|
|
103
|
-
a = type === "image" ? await admitImageBytes(bytes, claimed,
|
|
239
|
+
a = type === "image" ? await admitImageBytes(bytes, claimed, processor) : admitDocumentBytes(bytes, claimed);
|
|
104
240
|
}
|
|
105
241
|
catch {
|
|
106
242
|
return refusal("undecodable", 0);
|
|
@@ -109,35 +245,54 @@ async function admitBlock(block) {
|
|
|
109
245
|
return { block: a.block };
|
|
110
246
|
if (a.reason === "raw_too_large")
|
|
111
247
|
return refusal(a.reason, a.rawBytes, a.cap);
|
|
248
|
+
if (a.reason === "dimensions_too_large")
|
|
249
|
+
return refusal(a.reason, a.rawBytes, a.limit, { width: a.width, height: a.height });
|
|
112
250
|
if (a.reason === "base64_too_large")
|
|
113
|
-
return refusal(a.reason, a.rawBytes,
|
|
251
|
+
return refusal(a.reason, a.rawBytes, IMAGE_ADMISSION.hard.imageBase64Chars);
|
|
114
252
|
return refusal(a.reason, a.rawBytes);
|
|
115
253
|
}
|
|
116
|
-
export function
|
|
117
|
-
|
|
254
|
+
export function firstUnprocessedOverTarget(blocks, processor) {
|
|
255
|
+
if (processor !== "none")
|
|
256
|
+
return undefined;
|
|
257
|
+
for (const b of blocks) {
|
|
258
|
+
if (claimedMediaType(b) !== "image")
|
|
259
|
+
continue;
|
|
260
|
+
const data = readMember(b, "data");
|
|
261
|
+
if (typeof data !== "string")
|
|
262
|
+
continue;
|
|
263
|
+
const bytes = Buffer.byteLength(data, "base64");
|
|
264
|
+
if (bytes > IMAGE_ADMISSION.soft.targetBytes)
|
|
265
|
+
return bytes;
|
|
266
|
+
}
|
|
267
|
+
return undefined;
|
|
268
|
+
}
|
|
269
|
+
export function toolResultMediaBlocks(content) {
|
|
118
270
|
try {
|
|
119
271
|
if (!Array.isArray(content))
|
|
120
272
|
return undefined;
|
|
121
|
-
blocks = Array.from(content);
|
|
122
|
-
|
|
123
|
-
return undefined;
|
|
273
|
+
const blocks = Array.from(content);
|
|
274
|
+
return blocks.some(claimsMedia) ? blocks : undefined;
|
|
124
275
|
}
|
|
125
276
|
catch {
|
|
126
277
|
return undefined;
|
|
127
278
|
}
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
else {
|
|
137
|
-
refused.push(r.refusal);
|
|
138
|
-
out.push(placeholderOf(toolName, r.refusal));
|
|
139
|
-
}
|
|
279
|
+
}
|
|
280
|
+
export async function admitToolResultMediaBlocks(blocks, toolName, processor) {
|
|
281
|
+
const refused = [];
|
|
282
|
+
const out = [];
|
|
283
|
+
for (const b of blocks) {
|
|
284
|
+
const r = await admitBlock(b, processor);
|
|
285
|
+
if ("block" in r) {
|
|
286
|
+
out.push(r.block);
|
|
140
287
|
}
|
|
141
|
-
|
|
142
|
-
|
|
288
|
+
else {
|
|
289
|
+
refused.push(r.refusal);
|
|
290
|
+
out.push(placeholderOf(toolName, r.refusal));
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
return { content: out, refused };
|
|
294
|
+
}
|
|
295
|
+
export function admitToolResultMedia(content, toolName, processor) {
|
|
296
|
+
const blocks = toolResultMediaBlocks(content);
|
|
297
|
+
return blocks === undefined ? undefined : admitToolResultMediaBlocks(blocks, toolName, processor);
|
|
143
298
|
}
|
|
@@ -1,51 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Generic image downsample/resize pipeline (design/157 S3 — split out of `core/mcp.ts`, which historically
|
|
3
|
-
* carried this alongside MCP-protocol plumbing even though the pipeline itself has no MCP dependency).
|
|
4
|
-
* Two consumers share this ONE pipeline + ONE size yardstick: the MCP inline-image bound (`core/mcp.ts`
|
|
5
|
-
* `boundedImageBlock`) and the Read tool's image branch (`tools/fs/index.ts`). `core/mcp.ts` re-exports
|
|
6
|
-
* everything below (`export * from "./image-downsample.js"`) so existing importers (`tools/fs/index.ts`,
|
|
7
|
-
* `core/types.ts`) needed no changes on this car.
|
|
8
|
-
*/
|
|
9
|
-
/**
|
|
10
|
-
* design/116 W5-1 — the max base64 size of ONE inline image (5MB). Value =
|
|
11
|
-
* `API_IMAGE_MAX_BASE64_SIZE` (constants/apiLimits.ts:22, "5 * 1024 * 1024 // 5 MB" — the hard Anthropic API
|
|
12
|
-
* limit on a base64 image block; CC resizes/compresses down to fit UNDER it, imageResizer.ts). An MCP server
|
|
13
|
-
* returning a bigger image previously passed straight through = a context/API bomb.
|
|
14
|
-
*/
|
|
15
|
-
export declare const MCP_IMAGE_MAX_BASE64: number;
|
|
16
|
-
/**
|
|
17
|
-
* 批③ image-pipeline — CC 2.1.x `constants/apiLimits.ts` values, shared by the MCP inline-image bound
|
|
18
|
-
* AND the Read tool's image branch (tools/fs — internal consistency: ONE yardstick per limit). That other
|
|
19
|
-
* consumers are the file tools (`tools/fs/fs-read.ts`'s image branch, plus `fs-pdf`/`fs-bash`), which IMPORT
|
|
20
|
-
* {@link MCP_IMAGE_MAX_BASE64} / {@link IMAGE_TARGET_RAW_SIZE} from here (through core/mcp.js's re-export)
|
|
21
|
-
* rather than re-deriving them — one limit, every consumer reading it, no drift.
|
|
22
|
-
* - `IMAGE_TARGET_RAW_SIZE` (apiLimits.ts:29): raw-byte target that guarantees the base64 encoding stays
|
|
23
|
-
* under {@link MCP_IMAGE_MAX_BASE64} (raw × 4/3 = base64 → 3.75MB raw = 5MB base64).
|
|
24
|
-
* - `IMAGE_MAX_WIDTH/HEIGHT` (apiLimits.ts:42-43): client-side resize box. The API internally resizes
|
|
25
|
-
* above 1568px anyway; 2000px preserves a little extra quality while bounding token burn (~3x for a
|
|
26
|
-
* full-resolution screenshot vs the box).
|
|
27
|
-
*/
|
|
28
|
-
export declare const IMAGE_TARGET_RAW_SIZE: number;
|
|
29
|
-
export declare const IMAGE_MAX_WIDTH = 2000;
|
|
30
|
-
export declare const IMAGE_MAX_HEIGHT = 2000;
|
|
31
|
-
/**
|
|
32
|
-
* design/116 W5-1 — bound an inline MCP image. HONEST DELTA vs CC: CC really resizes/downsamples an
|
|
33
|
-
* oversized image with sharp (utils/imageResizer.ts `maybeResizeAndDownsampleImageBuffer`: ≤2000x2000px,
|
|
34
|
-
* ≤3.75MB raw = 5MB base64, progressive JPEG/PNG quality ladder). Core deliberately takes NO image-processing
|
|
35
|
-
* dependency (arch decision — sharp is a native module we won't force on every consumer), so instead of
|
|
36
|
-
* resizing we BOUND: an image whose base64 exceeds {@link MCP_IMAGE_MAX_BASE64} is spilled to disk and
|
|
37
|
-
* replaced by an explanatory text block with the size + path; a within-limit image passes through unchanged.
|
|
38
|
-
*/
|
|
39
|
-
/**
|
|
40
|
-
* Optional image-resize seam (design/116 review CONFIRM-1, 裁定 2026-07-02 加 seam 保体验): given an
|
|
41
|
-
* over-limit image, return a smaller re-encoded one — or undefined when it can't. CC resizes with sharp
|
|
42
|
-
* (imageResizer.ts: fit within 2000x2000, JPEG quality ladder) so the model still SEES a degraded image;
|
|
43
|
-
* core must not hard-depend on a native image library, so the capability is injected (or auto-detected).
|
|
44
|
-
*/
|
|
45
|
-
export type McpImageResizer = (base64: string, mimeType: string) => Promise<{
|
|
46
|
-
base64: string;
|
|
47
|
-
mimeType: string;
|
|
48
|
-
} | undefined>;
|
|
49
1
|
/**
|
|
50
2
|
* 批③ image-pipeline — original vs displayed size of a processed image (CC `imageResizer.ts`
|
|
51
3
|
* `ImageDimensions`). `display*` = what the model actually sees; the Read tool renders the CC coordinate-
|
|
@@ -65,10 +17,9 @@ export interface DownsampledImage {
|
|
|
65
17
|
dimensions?: ImageDimensions;
|
|
66
18
|
}
|
|
67
19
|
/**
|
|
68
|
-
*
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
* UNCHANGED (with dimensions when known) — pass-through is not a failure.
|
|
20
|
+
* An image processor: the bytes the admission checked, in; the bytes the model gets, out — or undefined when the input
|
|
21
|
+
* can't be processed (corrupt/unsupported), and the admission then judges the original bytes as they are. A
|
|
22
|
+
* within-target image passes through UNCHANGED (with dimensions when known) — pass-through is not a failure.
|
|
72
23
|
*/
|
|
73
24
|
export type ImageDownsampler = (input: Buffer, mimeType: string) => Promise<DownsampledImage | undefined>;
|
|
74
25
|
/** Minimal structural slice of the sharp API the pipeline uses (fresh instance per operation — CC note:
|
|
@@ -79,7 +30,9 @@ interface SharpOps {
|
|
|
79
30
|
width?: number;
|
|
80
31
|
height?: number;
|
|
81
32
|
format?: string;
|
|
33
|
+
orientation?: number;
|
|
82
34
|
}>;
|
|
35
|
+
rotate: () => SharpOps;
|
|
83
36
|
resize: (w: number, h: number, o: {
|
|
84
37
|
fit: "inside";
|
|
85
38
|
withoutEnlargement: boolean;
|
|
@@ -91,29 +44,43 @@ interface SharpOps {
|
|
|
91
44
|
compressionLevel: number;
|
|
92
45
|
palette: boolean;
|
|
93
46
|
}) => SharpOps;
|
|
47
|
+
flatten: (o: {
|
|
48
|
+
background: string;
|
|
49
|
+
}) => SharpOps;
|
|
94
50
|
toBuffer: () => Promise<Buffer>;
|
|
95
51
|
}
|
|
96
52
|
/**
|
|
97
|
-
* The
|
|
98
|
-
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
53
|
+
* The processor over an injected sharp factory (so both stages are unit-testable without the native dependency). Two
|
|
54
|
+
* stages, in the order of `VS` (cli309.js:262027), after a frame that asks to be shown turned is turned upright:
|
|
55
|
+
* 1. the frame ladder (CC `IGe`, called by FileReadTool `readImageWithTokenBudget`), toward `soft.frameEdge` and
|
|
56
|
+
* `soft.rawBytes`:
|
|
57
|
+
* a. fits already (raw ≤ rawBytes AND inside the frame) → pass through, dimensions attached;
|
|
58
|
+
* b. dims fit but bytes over → full-resolution compression first (PNG lossless/palette for PNGs, then
|
|
59
|
+
* JPEG quality ladder 80/60/40/20) — preserves resolution when possible;
|
|
60
|
+
* c. dims over → constrain to the frame (aspect kept), then the same ladder on the resized image if still over; last
|
|
61
|
+
* rung = ≤1000px wide JPEG q20;
|
|
62
|
+
* d. metadata without dimensions → JPEG q80 when over rawBytes, else pass through (CC branch);
|
|
63
|
+
* 2. the byte-target step ({@link toByteTarget}) when the ladder's bytes are over `soft.targetBytes`. A failure of this
|
|
64
|
+
* step keeps the ladder's bytes (CC: "passing through unbudgeted").
|
|
65
|
+
* An image already inside the frame and at or under the target passes both stages byte-identical, so a second
|
|
66
|
+
* admission of what the first one sent changes nothing. The caller's base64 gate stays the final arbiter.
|
|
108
67
|
*/
|
|
109
68
|
export declare function createImageDownsampler(sharp: SharpFactory): ImageDownsampler;
|
|
69
|
+
/**
|
|
70
|
+
* Production processor factory: dynamic `import("sharp")`. sharp is an OPTIONAL native dependency — declared under
|
|
71
|
+
* `optionalDependencies`, never `dependencies` (arch decision, design/116 W5-1: core won't force a native module on
|
|
72
|
+
* every consumer; RB-213 made the optional-ness VISIBLE to package managers without changing the decision —
|
|
73
|
+
* `optionalDependencies` still installs best-effort and never fails the parent install if the native build fails). A
|
|
74
|
+
* turnkey deployment that has it available gets the CC experience automatically; without it this resolves to undefined.
|
|
75
|
+
*/
|
|
110
76
|
export declare function sharpImageDownsampler(): Promise<ImageDownsampler | undefined>;
|
|
77
|
+
/** The seat's value door (at `new Runner`): a processor, `false`, or absent — anything else is refused by name rather than read
|
|
78
|
+
* as "detect" or "none" (`config.invalid_argument`). */
|
|
79
|
+
export declare function checkedImageProcessorSeat(value: unknown, seat: string): void;
|
|
111
80
|
/**
|
|
112
|
-
*
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
* the contract is unchanged: undefined when sharp is missing, the input is corrupt, or even the lowest
|
|
116
|
-
* ladder rung stays over the API limit.
|
|
81
|
+
* The one reading of the image processor seat (`RunnerDeps.imageProcessor`): a function is the processor; `false` is
|
|
82
|
+
* `"none"` (nothing is detected); absent detects sharp once per process ({@link sharpImageDownsampler}) and answers
|
|
83
|
+
* `"none"` when it does not resolve. Every carrier that admits an image reads its processor here.
|
|
117
84
|
*/
|
|
118
|
-
export declare function
|
|
85
|
+
export declare function resolveImageProcessor(seat: ImageDownsampler | false | undefined): Promise<ImageDownsampler | "none">;
|
|
119
86
|
export {};
|