@sema-agent/core 7.60.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 +605 -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 +61 -10
- package/dist/agents/cascade.js +60 -20
- 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-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.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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- 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-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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 +49 -18
- 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 +2 -1
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- 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 +2 -1
- 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 +220 -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.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/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- 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 +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/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 +38 -16
- package/dist/core/mods/stations.js +25 -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 +61 -2
- package/dist/core/own-property-receipt.js +42 -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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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 +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 +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- 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/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/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 +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- 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 +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- 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 +56 -28
- 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 +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-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.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- 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 +40 -29
- 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 +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/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/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-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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- 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 +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 +2 -0
- package/dist/core/session-store.js +5 -7
- 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.js +1 -1
- 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 +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- 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 +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- 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 +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 +2 -3
- 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 +108 -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-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- 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 +41 -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/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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 +16 -3
- package/dist/stores/file/session-store.js +21 -20
- 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/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/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- 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 +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 +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -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
|
@@ -143,6 +143,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
143
143
|
"config.path_view_unresolved",
|
|
144
144
|
"config.execution_env_capability_invalid",
|
|
145
145
|
"config.read_deny_floor_unkept",
|
|
146
|
+
"config.read_floor_confinement_unavailable",
|
|
146
147
|
"config.tool_card_undeclared",
|
|
147
148
|
"config.tool_face_undeclared",
|
|
148
149
|
"config.tool_face_invalid",
|
|
@@ -211,7 +212,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
211
212
|
"model.capability_downgraded",
|
|
212
213
|
"model.role_defaulted",
|
|
213
214
|
"context.tool_turn_repaired",
|
|
214
|
-
"context.
|
|
215
|
+
"context.media_removed",
|
|
216
|
+
"context.tool_schema_removed",
|
|
215
217
|
"task.user_steer_undrained",
|
|
216
218
|
"task.user_followup_undrained",
|
|
217
219
|
"steering.parked_input_blocked",
|
|
@@ -229,6 +231,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
229
231
|
"tool_result.offload_put_failed",
|
|
230
232
|
"tool_result.media_refused",
|
|
231
233
|
"config.image_processor_unavailable",
|
|
234
|
+
"fs.staging_file_left",
|
|
235
|
+
"fs.staging_file_swept",
|
|
232
236
|
"instructions.source_changed",
|
|
233
237
|
"session.records_skipped",
|
|
234
238
|
"memory.layer_locked_legacy",
|
|
@@ -247,7 +251,7 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
247
251
|
"classifier.denial_limit": "user",
|
|
248
252
|
"classifier.unavailable": "user",
|
|
249
253
|
"classifier.fallback": "operator",
|
|
250
|
-
"classifier.seat_rate_limited": "
|
|
254
|
+
"classifier.seat_rate_limited": "user",
|
|
251
255
|
"classifier.role_defaulted": "operator",
|
|
252
256
|
"classifier.contract_broken": "operator",
|
|
253
257
|
"task.turn_interrupted": "user",
|
|
@@ -294,6 +298,7 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
294
298
|
"config.path_view_unresolved": "operator",
|
|
295
299
|
"config.execution_env_capability_invalid": "operator",
|
|
296
300
|
"config.read_deny_floor_unkept": "operator",
|
|
301
|
+
"config.read_floor_confinement_unavailable": "operator",
|
|
297
302
|
"config.tool_card_undeclared": "operator",
|
|
298
303
|
"config.tool_face_undeclared": "operator",
|
|
299
304
|
"config.tool_face_invalid": "operator",
|
|
@@ -334,12 +339,15 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
334
339
|
"model.capability_downgraded": "user",
|
|
335
340
|
"model.role_defaulted": "operator",
|
|
336
341
|
"context.tool_turn_repaired": "operator",
|
|
337
|
-
"context.
|
|
342
|
+
"context.media_removed": "user",
|
|
343
|
+
"context.tool_schema_removed": "user",
|
|
338
344
|
"skills.listing_truncated": "operator",
|
|
339
345
|
"agents.listing_truncated": "operator",
|
|
340
346
|
"tool_result.offload_put_failed": "operator",
|
|
341
347
|
"tool_result.media_refused": "operator",
|
|
342
348
|
"config.image_processor_unavailable": "operator",
|
|
349
|
+
"fs.staging_file_left": "operator",
|
|
350
|
+
"fs.staging_file_swept": "operator",
|
|
343
351
|
"config.forward_sink_failed": "operator",
|
|
344
352
|
"instructions.source_changed": "user",
|
|
345
353
|
"session.records_skipped": "user",
|
|
@@ -371,6 +379,7 @@ const NOTICE_MINTER_TABLE = {
|
|
|
371
379
|
"config.path_view_unresolved": "engine",
|
|
372
380
|
"config.execution_env_capability_invalid": "engine",
|
|
373
381
|
"config.read_deny_floor_unkept": "engine",
|
|
382
|
+
"config.read_floor_confinement_unavailable": "engine",
|
|
374
383
|
"config.tool_card_undeclared": "engine",
|
|
375
384
|
"config.tool_face_undeclared": "engine",
|
|
376
385
|
"config.tool_face_invalid": "engine",
|
|
@@ -439,7 +448,8 @@ const NOTICE_MINTER_TABLE = {
|
|
|
439
448
|
"model.capability_downgraded": "engine",
|
|
440
449
|
"model.role_defaulted": "engine",
|
|
441
450
|
"context.tool_turn_repaired": "engine",
|
|
442
|
-
"context.
|
|
451
|
+
"context.media_removed": "engine",
|
|
452
|
+
"context.tool_schema_removed": "engine",
|
|
443
453
|
"task.user_steer_undrained": "engine",
|
|
444
454
|
"task.user_followup_undrained": "engine",
|
|
445
455
|
"steering.parked_input_blocked": "engine",
|
|
@@ -457,6 +467,8 @@ const NOTICE_MINTER_TABLE = {
|
|
|
457
467
|
"tool_result.offload_put_failed": "engine",
|
|
458
468
|
"tool_result.media_refused": "engine",
|
|
459
469
|
"config.image_processor_unavailable": "engine",
|
|
470
|
+
"fs.staging_file_left": "engine",
|
|
471
|
+
"fs.staging_file_swept": "engine",
|
|
460
472
|
"instructions.source_changed": "server",
|
|
461
473
|
"session.records_skipped": "server",
|
|
462
474
|
"memory.layer_locked_legacy": "server",
|
package/dist/core/hooks.d.ts
CHANGED
|
@@ -450,8 +450,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
|
|
|
450
450
|
export interface HookInvocationIdentity {
|
|
451
451
|
/** The run's session id (uuid domain) — the same key `TaskResult.sessionId` reports. */
|
|
452
452
|
readonly sessionId: string;
|
|
453
|
-
/** The run's unified task id (
|
|
454
|
-
*
|
|
453
|
+
/** The run's unified task id (the leg's one mint; TaskEvent's `sourceTaskId` and `task_progress` key on it): a background
|
|
454
|
+
* sub-agent's registry task id, else the host's declared task id, else {@link sessionId}. */
|
|
455
455
|
readonly taskId: string;
|
|
456
456
|
/** Which prepared leg this invocation belongs to — the wiring manifest's own `leg.kind`
|
|
457
457
|
* derivation, verbatim ({@link WiringLegKind}: `"root" | "child" | "resume"`). NOTE the fork
|
|
@@ -549,6 +549,10 @@ export interface HookToolOutput {
|
|
|
549
549
|
*/
|
|
550
550
|
export type PreToolUseResult = PermissionResult & {
|
|
551
551
|
additionalContext?: string;
|
|
552
|
+
/** WHY the hook asks, on an `ask` only ({@link import("./ask-origin.js").HookQuestionCause}; absent reads `asked`): on the two
|
|
553
|
+
* `verdict_*` words the `message` is the host's account, which no entry carries. Outside the set, or on another arm, the
|
|
554
|
+
* decision receipt refuses it (an engine fail-closed deny). */
|
|
555
|
+
questionCause?: import("./ask-origin.js").HookQuestionCause;
|
|
552
556
|
};
|
|
553
557
|
/** A PostToolUse hook result: replace the tool output and/or append context (both optional). */
|
|
554
558
|
export interface PostToolUseResult {
|
|
@@ -1384,11 +1388,14 @@ export interface AskCarry {
|
|
|
1384
1388
|
readonly mandate?: import("./ask-origin.js").PersistedRuleMandate;
|
|
1385
1389
|
/** The deployment's authorship ({@link import("./tool-policy.js").AskRequest.authoredBy}), for the row's twin. */
|
|
1386
1390
|
readonly authoredBy?: "deployment";
|
|
1391
|
+
/** The surviving ask's askers' entries ({@link import("./tool-policy.js").AskRequest.askReasons}), for the row's twin — the
|
|
1392
|
+
* same value the synchronous card carries. */
|
|
1393
|
+
readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1387
1394
|
}
|
|
1388
1395
|
/** What a durable row persists of an {@link AskCarry}: the fallback member COPIED (the row never aliases
|
|
1389
1396
|
* the gate's object; its window is already `0` — the gate's carry mint is the one writer of that
|
|
1390
|
-
* number), the origin word only when it is a member of the closed set,
|
|
1391
|
-
* well-formed, as
|
|
1397
|
+
* number), the origin word only when it is a member of the closed set, the class pair and the askers' entries only when
|
|
1398
|
+
* well-formed, as fresh copies (the carry is typed, but the row is the boundary a host reads back through —
|
|
1392
1399
|
* the same screen the summary applies to the word). */
|
|
1393
1400
|
export declare function askCarryRowMembers(carry: AskCarry | undefined): {
|
|
1394
1401
|
denialLimitFallback?: import("./auto-mode.js").DenialLimitFallback;
|
|
@@ -1396,6 +1403,7 @@ export declare function askCarryRowMembers(carry: AskCarry | undefined): {
|
|
|
1396
1403
|
origin?: import("./ask-origin.js").AskOrigin;
|
|
1397
1404
|
askClass?: import("./ask-origin.js").AskClass;
|
|
1398
1405
|
classes?: readonly import("./ask-origin.js").AskClass[];
|
|
1406
|
+
askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1399
1407
|
};
|
|
1400
1408
|
/**
|
|
1401
1409
|
* The design/37 **two-phase tool gate** — the single chokepoint that makes the load-bearing invariant
|
package/dist/core/hooks.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import { argsAsTheToolReads, stampArgsReading } from "./effective-path-target.js";
|
|
2
2
|
import { extensionAuthors, noteRewrite, readRejudge, rewriteChasedSentence, screeningAuthorship } from "./rewrite-rejudge.js";
|
|
3
|
-
import { decisionText, describeThrown, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
|
|
3
|
+
import { decisionText, describeThrown, extensionQuestionText, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
|
|
4
4
|
import { createSettlementLedger, engineFailClosedExit, hookDenyExit, settledScreen, settledScreenExit, takeInheritedScreen, unownedArgsExit } from "./runner/gate-exit.js";
|
|
5
5
|
import { composeCallSignal } from "./runner/abort-race.js";
|
|
6
6
|
import { classicEventBase, dispatchClassic, ENGINE_CORE_ANSWER, failedHandlerClause, judgedInputOf, observePermissionDenied } from "./mods/stations.js";
|
|
7
7
|
import { runGateFold } from "./gate-fold.js";
|
|
8
8
|
import { runGateLanes } from "./gate-lanes.js";
|
|
9
9
|
export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
|
|
10
|
-
import { isAskOrigin, screenAskClassMembers } from "./ask-origin.js";
|
|
10
|
+
import { hookAskReasonOf, isAskOrigin, receiveAskReasons, screenAskClassMembers } from "./ask-origin.js";
|
|
11
11
|
import { isAutoModeFallbackCause } from "./auto-mode.js";
|
|
12
12
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
13
13
|
export { formatHookFeedback } from "./reminder-mint.js";
|
|
@@ -111,6 +111,11 @@ function preToolUseRefusedReason(subject, failed) {
|
|
|
111
111
|
: "";
|
|
112
112
|
return `a PreToolUse hook ${failedHandlerClause(failed)} while screening ${subject}; the call was NOT executed (fail-closed).${tail}`;
|
|
113
113
|
}
|
|
114
|
+
function hookAskOf(r, answeredBy, toolName) {
|
|
115
|
+
const { questionCause, ...ask } = r;
|
|
116
|
+
const entry = hookAskReasonOf(answeredBy, questionCause ?? "asked", decisionText(ask));
|
|
117
|
+
return { ...ask, ...(answeredBy !== undefined ? { message: extensionQuestionText(toolName, entry) } : {}), askReasons: Object.freeze([entry]) };
|
|
118
|
+
}
|
|
114
119
|
export function createPreToolUseScreening(input, readSettled = (decision) => ({ decision })) {
|
|
115
120
|
const own = input.modBus !== undefined && input.modBus.hasHandlers("classic.PreToolUse") ? input.modBus : undefined;
|
|
116
121
|
const inherited = (input.inheritedInstallations ?? []).filter((i) => i.bus.hasHandlers("classic.PreToolUse", i.judges));
|
|
@@ -143,7 +148,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
|
|
|
143
148
|
if (outcome.kind === "failed")
|
|
144
149
|
return { kind: "refused", reason: preToolUseRefusedReason(subject, outcome), extension: outcome.registration };
|
|
145
150
|
const r = screenPreToolUseResult(outcome.answer);
|
|
146
|
-
const answer = r === null || r === false ? undefined : r;
|
|
151
|
+
const answer = r === null || r === false || r === undefined ? undefined : r.action === "ask" ? hookAskOf(r, outcome.answeredBy, toolName) : r;
|
|
147
152
|
const rewrittenBy = authorship.of(outcome.answer);
|
|
148
153
|
return { kind: "answered", answer, ...(outcome.answeredBy !== undefined ? { answeredBy: outcome.answeredBy } : {}), rewrittenBy: answer?.updatedInput === undefined ? [] : rewrittenBy.length > 0 || outcome.answeredBy === undefined ? rewrittenBy : [outcome.answeredBy] };
|
|
149
154
|
};
|
|
@@ -214,7 +219,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
|
|
|
214
219
|
allowedBy.set(i, r.answeredBy);
|
|
215
220
|
if (verdict?.action !== "ask")
|
|
216
221
|
return undefined;
|
|
217
|
-
const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}) };
|
|
222
|
+
const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}), ...(verdict.askReasons !== undefined ? { askReasons: verdict.askReasons } : {}) };
|
|
218
223
|
const call = Object.freeze({ toolName, toolCallId, args: bytes, ...(as.face !== undefined ? { face: as.face } : {}) });
|
|
219
224
|
const settled = readSettled(await seat.installation.settle(ask, call, signal));
|
|
220
225
|
if (settled.decision.action === "deny")
|
|
@@ -241,11 +246,13 @@ export function askCarryRowMembers(carry) {
|
|
|
241
246
|
const origin = carry.origin;
|
|
242
247
|
const why = carry.classifierNoRuling;
|
|
243
248
|
const classed = screenAskClassMembers(carry.askClass, carry.classes);
|
|
249
|
+
const askReasons = receiveAskReasons(carry.askReasons);
|
|
244
250
|
return {
|
|
245
251
|
...(carry.denialLimitFallback !== undefined ? { denialLimitFallback: { ...carry.denialLimitFallback } } : {}),
|
|
246
252
|
...(isAutoModeFallbackCause(why) ? { classifierNoRuling: why } : {}),
|
|
247
253
|
...(isAskOrigin(origin) ? { origin } : {}),
|
|
248
254
|
...(classed !== undefined ? classed : {}),
|
|
255
|
+
...(askReasons !== undefined ? { askReasons } : {}),
|
|
249
256
|
};
|
|
250
257
|
}
|
|
251
258
|
export async function runToolGate(input) {
|
package/dist/core/host-floor.js
CHANGED
|
@@ -2,7 +2,7 @@ import { isIP } from "node:net";
|
|
|
2
2
|
import { HOST_UNREADABLE_SENTENCE, callHostTargetOf, hostOfUrl, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
|
|
3
3
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
4
|
import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
5
|
-
import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
|
|
5
|
+
import { DECLARATION_RECEIPT_MODE, optionKeys, refuseStrayMembers } from "./own-property-receipt.js";
|
|
6
6
|
function isPrivateV4(ip) {
|
|
7
7
|
const o = ip.split(".").map(Number);
|
|
8
8
|
if (o.length !== 4 || o.some((n) => !Number.isInteger(n) || n < 0 || n > 255))
|
|
@@ -48,7 +48,7 @@ export function isPrivateHost(host) {
|
|
|
48
48
|
return /^fe[89ab]/.test(h) || /^f[cd]/.test(h) || /^fe[c-f]/.test(h);
|
|
49
49
|
}
|
|
50
50
|
export const HOST_FLOOR_INVALID_CODE = "config.host_floor_invalid";
|
|
51
|
-
const
|
|
51
|
+
const FLOOR_KEYS = optionKeys()({ deny: 0, only: 0 });
|
|
52
52
|
function floorInvalid(what) {
|
|
53
53
|
return Object.assign(new Error(`RunnerDeps.hostFloor ${what} — a host floor that does not read is refused whole, never half-armed (an entry is a host pattern: \`example.com\` or \`*.example.com\`).`), { code: HOST_FLOOR_INVALID_CODE });
|
|
54
54
|
}
|
|
@@ -95,9 +95,7 @@ export function compileHostFloor(declared) {
|
|
|
95
95
|
return undefined;
|
|
96
96
|
if (!isPlainRecord(value))
|
|
97
97
|
throw floorInvalid(`must be a record { deny?, only? } (got ${value === null ? "null" : Array.isArray(value) ? "a list" : typeof value})`);
|
|
98
|
-
|
|
99
|
-
if (unknownMember !== undefined)
|
|
100
|
-
throw floorInvalid(`has a member "${inlineUntrusted(unknownMember, 60)}" — its members are \`deny\` and \`only\``);
|
|
98
|
+
refuseStrayMembers(value, { subject: "RunnerDeps.hostFloor", unit: "member", moment: "when the floor is compiled" }, FLOOR_KEYS, (_, [stray]) => floorInvalid(`has a member "${inlineUntrusted(String(stray), 60)}" — its members are \`deny\` and \`only\``));
|
|
101
99
|
const deny = readEntries(value.deny, "deny") ?? [];
|
|
102
100
|
const only = readEntries(value.only, "only");
|
|
103
101
|
for (const o of only ?? []) {
|
|
@@ -1,24 +1,32 @@
|
|
|
1
1
|
import type { DocumentContent, ImageContent } from "../internal/llm.js";
|
|
2
2
|
import type { ImageDimensions, ImageDownsampler } from "./image-downsample.js";
|
|
3
|
-
import {
|
|
3
|
+
import type { MediaBlock } from "./media-byte-cap.js";
|
|
4
4
|
/** Max raw size sent whole as a document block (CC `PDF_TARGET_RAW_SIZE`). */
|
|
5
5
|
export declare const PDF_TARGET_RAW_SIZE: number;
|
|
6
6
|
/**
|
|
7
7
|
* Every number an image passes on its way to the model, in one table — the admission and its processor read it, and so
|
|
8
8
|
* does every carrier that words a refusal; a downstream that bounds an image by the same limit reads the same field.
|
|
9
|
-
* - `hard`: what refuses. `formats` (the header rows above), `readBytes` (the raw read cap —
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* `
|
|
9
|
+
* - `hard`: what refuses. `formats` (the header rows above), `readBytes` (the raw read cap — without a processor the bytes
|
|
10
|
+
* ship as they are, so the cap is the raw size whose base64 fits `imageBase64Chars`, the one bound that binds there;
|
|
11
|
+
* with one it is larger, since the processor shrinks what was read, and the 64 MiB bound is an OOM sanity bound, CC
|
|
12
|
+
* reads the file whole), `urlBytes` (a fetched image's body), `rejectEdge` (the longest edge the bytes that ship may
|
|
13
|
+
* state — `fI` (cli309.js:253044), the 2000 box, its no-flag reject width), `imageBase64Chars` (the provider's
|
|
14
|
+
* single-image limit, on the base64 length — CC `fI` `maxBase64Size`).
|
|
14
15
|
* - `soft`: what the processor aims at, best effort. `frameEdge` and `rawBytes` are the frame ladder's box and byte rung
|
|
15
16
|
* (CC `fI` `maxWidth` / `targetRawSize`: 3.75 MB raw = 5 MiB base64); `targetBytes` is the byte-target step's goal
|
|
16
17
|
* (`SZ` (cli309.js:253044), the bytes `N$o` compresses toward).
|
|
17
|
-
*
|
|
18
|
+
* - `request`: what one provider request may carry of the media the conversation holds (CC `eSn` (cli309.js:265961) and
|
|
19
|
+
* its constants `Xai` / `Jai` (cli309.js:253044)), every size in base64 characters — the unit the provider counts. Over `maxItems`
|
|
20
|
+
* media blocks (images and documents together; `largeWindow.maxItems` for a model whose window is at least
|
|
21
|
+
* `largeWindow.fromContextWindow` tokens) the oldest go until `maxItems - margin` remain; over the budget the oldest go
|
|
22
|
+
* until `hysteresisBase64Chars` under it. `budgetBase64Chars` is the default budget a deployment may replace
|
|
23
|
+
* (`RunnerDeps.mediaBudgetBase64Chars`); it is not CC's first-party 24 MiB, because a sema deployment mostly serves
|
|
24
|
+
* endpoints CC treats as third-party, for which CC's own budget is 75 MiB. There is no document-only budget: CC holds
|
|
25
|
+
* one for its first-party endpoint alone.
|
|
18
26
|
*/
|
|
19
27
|
export declare const IMAGE_ADMISSION: Readonly<{
|
|
20
28
|
readonly hard: Readonly<{
|
|
21
|
-
formats: Readonly<Record<"image/
|
|
29
|
+
formats: Readonly<Record<"image/png" | "image/jpeg" | "image/gif" | "image/webp", (b: Uint8Array) => boolean>>;
|
|
22
30
|
readBytes: Readonly<{
|
|
23
31
|
withoutProcessor: number;
|
|
24
32
|
withProcessor: number;
|
|
@@ -32,7 +40,37 @@ export declare const IMAGE_ADMISSION: Readonly<{
|
|
|
32
40
|
rawBytes: number;
|
|
33
41
|
targetBytes: 512000;
|
|
34
42
|
}>;
|
|
43
|
+
readonly request: Readonly<{
|
|
44
|
+
maxItems: 100;
|
|
45
|
+
largeWindow: Readonly<{
|
|
46
|
+
fromContextWindow: 1000000;
|
|
47
|
+
maxItems: 600;
|
|
48
|
+
}>;
|
|
49
|
+
margin: 20;
|
|
50
|
+
budgetBase64Chars: number;
|
|
51
|
+
hysteresisBase64Chars: number;
|
|
52
|
+
}>;
|
|
35
53
|
}>;
|
|
54
|
+
/** What one request may carry, resolved for a model and a deployment's budget: the media-block count, the margin a count
|
|
55
|
+
* cut leaves under it, the base64 budget (`Infinity`: none) and the hysteresis a budget cut leaves under that. */
|
|
56
|
+
export interface RequestMediaLimits {
|
|
57
|
+
maxItems: number;
|
|
58
|
+
margin: number;
|
|
59
|
+
budgetBase64Chars: number;
|
|
60
|
+
hysteresisBase64Chars: number;
|
|
61
|
+
}
|
|
62
|
+
/** The one reading of a deployment's request media budget (`RunnerDeps.mediaBudgetBase64Chars`, screened by
|
|
63
|
+
* {@link checkedRequestMediaBudget} at `new Runner`), for both of its readers — the request trim and the `tool_end.output`
|
|
64
|
+
* projection: absent ⇒ `IMAGE_ADMISSION.request.budgetBase64Chars`; `0` or `Infinity` ⇒ no budget (`Infinity`). */
|
|
65
|
+
export declare function requestMediaBudget(knob: number | undefined): number;
|
|
66
|
+
/** The limits a request on `model` under the deployment's budget `knob` is trimmed to. */
|
|
67
|
+
export declare function requestMediaLimits(model: {
|
|
68
|
+
readonly contextWindow?: unknown;
|
|
69
|
+
}, knob: number | undefined): RequestMediaLimits;
|
|
70
|
+
/** The deployment's request media budget, screened once at `new Runner`: absent, `0` or `Infinity` (no budget), or a whole
|
|
71
|
+
* number of base64 characters no smaller than twice the hysteresis. Anything else — a non-number, `NaN`, a negative, a
|
|
72
|
+
* fraction, a budget a cut would empty — is refused (`config.invalid_argument`), never read as a default or as none. */
|
|
73
|
+
export declare function checkedRequestMediaBudget(value: unknown, seat: string): void;
|
|
36
74
|
/** Verify the raw bytes actually ARE the image format the claimed type names (`IMAGE_ADMISSION.hard.formats`). Extension
|
|
37
75
|
* alone is forgeable: a `.png` holding text / an empty file / a truncated blob / an Apple-optimized PNG would otherwise
|
|
38
76
|
* become a malformed `ImageContent` that makes the NEXT provider request fail (400). Pure — no I/O. */
|
|
@@ -149,6 +187,8 @@ export interface ToolResultMediaAdmission {
|
|
|
149
187
|
content: unknown[];
|
|
150
188
|
refused: ToolResultMediaRefusal[];
|
|
151
189
|
}
|
|
190
|
+
/** The media type a block claims — its `type`, read once, when that is a media type — or `undefined` for any other value. */
|
|
191
|
+
export declare function claimedMediaType(block: unknown): MediaBlock["type"] | undefined;
|
|
152
192
|
/**
|
|
153
193
|
* The decoded size of the first image block that goes to the model over `IMAGE_ADMISSION.soft.targetBytes` with no
|
|
154
194
|
* processor to bring it down — the one fact the run's operator notice reads (`config.image_processor_unavailable`), at
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
-
import { claimedMediaType } from "./media-byte-cap.js";
|
|
3
2
|
import { readMember } from "./thrown-value.js";
|
|
3
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
4
4
|
export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024;
|
|
5
5
|
const spells = (b, at, text) => {
|
|
6
6
|
if (b.length < at + text.length)
|
|
@@ -22,16 +22,42 @@ const IMAGE_HEADER_CHECKS = Object.freeze({
|
|
|
22
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")),
|
|
23
23
|
});
|
|
24
24
|
const MiB = 1024 * 1024;
|
|
25
|
+
const IMAGE_BASE64_CHARS = 5 * MiB;
|
|
26
|
+
const IMAGE_BASE64_RAW_BYTES = (IMAGE_BASE64_CHARS * 3) / 4;
|
|
25
27
|
export const IMAGE_ADMISSION = Object.freeze({
|
|
26
28
|
hard: Object.freeze({
|
|
27
29
|
formats: IMAGE_HEADER_CHECKS,
|
|
28
|
-
readBytes: Object.freeze({ withoutProcessor:
|
|
30
|
+
readBytes: Object.freeze({ withoutProcessor: IMAGE_BASE64_RAW_BYTES, withProcessor: 64 * MiB }),
|
|
29
31
|
urlBytes: 20 * MiB,
|
|
30
32
|
rejectEdge: 2000,
|
|
31
|
-
imageBase64Chars:
|
|
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,
|
|
32
42
|
}),
|
|
33
|
-
soft: Object.freeze({ frameEdge: 2000, rawBytes: (5 * MiB * 3) / 4, targetBytes: 512_000 }),
|
|
34
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
|
+
}
|
|
35
61
|
export function imageMagicMatches(bytes, mimeType) {
|
|
36
62
|
const formats = IMAGE_ADMISSION.hard.formats;
|
|
37
63
|
return Object.hasOwn(formats, mimeType) && formats[mimeType](bytes);
|
|
@@ -188,6 +214,11 @@ const placeholderOf = (toolName, r) => ({
|
|
|
188
214
|
type: "text",
|
|
189
215
|
text: `[${r.type} from the ${JSON.stringify(toolName)} tool not shown: ${REFUSAL_CLAUSE[r.reason](r)} (media admission: ${r.reason})]`,
|
|
190
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
|
+
}
|
|
191
222
|
const claimsMedia = (block) => claimedMediaType(block) !== undefined;
|
|
192
223
|
async function admitBlock(block, processor) {
|
|
193
224
|
const type = claimedMediaType(block);
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type { RunInternals } from "./runner/contracts.js";
|
|
2
|
+
export declare const INPUT_AUTHORS: readonly ["operator", "parent_model", "workflow", "peer", "observer", "engine"];
|
|
3
|
+
export type InputAuthor = (typeof INPUT_AUTHORS)[number];
|
|
4
|
+
/** Membership test for {@link InputAuthor}. */
|
|
5
|
+
export declare function isInputAuthor(v: unknown): v is InputAuthor;
|
|
6
|
+
/** An author as read: a member of the set, or `unknown` for anything else. */
|
|
7
|
+
export type InputAuthorReading = InputAuthor | "unknown";
|
|
8
|
+
/** The one reader: a member reads as itself, anything else (`undefined` included) as `unknown`. */
|
|
9
|
+
export declare function readInputAuthor(raw: unknown): InputAuthorReading;
|
|
10
|
+
/** THE predicate: does this input count as the operator's — screened by `classic.UserPromptSubmit`, carried across a pause, on
|
|
11
|
+
* the person's undelivered-input account? An unreadable word does (a filter's safe side); the five other words do not. */
|
|
12
|
+
export declare function countsAsOperator(reading: InputAuthorReading): boolean;
|
|
13
|
+
/**
|
|
14
|
+
* The objective's author on a leg, from the trusted channel's word (`RunInternals.objectiveAuthor`): absent is the public
|
|
15
|
+
* entry's own mint, `operator` — the host that called `runTask` wrote the objective or relays the person who did; a member is
|
|
16
|
+
* itself; anything else is `unknown`, screened like the operator's, and its sentence is handed to `onUnreadable` (the caller
|
|
17
|
+
* reports it once).
|
|
18
|
+
*/
|
|
19
|
+
export declare function objectiveAuthorOf(declared: unknown, onUnreadable: (error: Error) => void): InputAuthorReading;
|
|
20
|
+
/** The trusted channel of a recipe's continuation leg — the one mint of `engine`: a fresh shallow copy of the internals the leg rides
|
|
21
|
+
* otherwise, its objective the recipe's own words (the caller's request rode the recipe's first leg). A composition whose later legs
|
|
22
|
+
* re-run the caller's objective (a cascade's rungs) does not call it. */
|
|
23
|
+
export declare function recipeContinuationLeg(internals: RunInternals | undefined): RunInternals;
|
|
24
|
+
/**
|
|
25
|
+
* The engine's own relay into a running stream's steer lane, under the author it states. The public `TaskStream.steer` mints
|
|
26
|
+
* `operator` on every call; this seat is how the engine hands a stream an input someone else wrote (an observer's report). It
|
|
27
|
+
* lives on the stream object the Runner minted — registered here, never on the package face — so no caller can name an author.
|
|
28
|
+
*/
|
|
29
|
+
export type AuthoredSteer = (author: InputAuthor, text: string) => Promise<void>;
|
|
30
|
+
/** Register the authored steer of a stream the Runner minted (the driver calls this once per stream). */
|
|
31
|
+
export declare function bindAuthoredSteer(stream: object, steer: AuthoredSteer): void;
|
|
32
|
+
/** The authored steer of a stream the Runner minted; `undefined` for any other object. */
|
|
33
|
+
export declare function authoredSteerOf(stream: object): AuthoredSteer | undefined;
|
|
34
|
+
/** The terminal account's sentence for inputs of other authors a run accepted and never delivered: they are dropped, never
|
|
35
|
+
* carried across a pause and never counted as the person's (the caller hands it to `onError` once, `phase: "degraded"`). */
|
|
36
|
+
export declare function droppedInputsDisclosure(authors: readonly InputAuthor[]): Error;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
2
|
+
export const INPUT_AUTHORS = Object.freeze(["operator", "parent_model", "workflow", "peer", "observer", "engine"]);
|
|
3
|
+
const INPUT_AUTHOR_SET = new Set(INPUT_AUTHORS);
|
|
4
|
+
export function isInputAuthor(v) {
|
|
5
|
+
return INPUT_AUTHOR_SET.has(v);
|
|
6
|
+
}
|
|
7
|
+
export function readInputAuthor(raw) {
|
|
8
|
+
return isInputAuthor(raw) ? raw : "unknown";
|
|
9
|
+
}
|
|
10
|
+
const COUNTS_AS_OPERATOR = Object.freeze({ operator: true, parent_model: false, workflow: false, peer: false, observer: false, engine: false });
|
|
11
|
+
export function countsAsOperator(reading) {
|
|
12
|
+
return reading === "unknown" || COUNTS_AS_OPERATOR[reading];
|
|
13
|
+
}
|
|
14
|
+
export function objectiveAuthorOf(declared, onUnreadable) {
|
|
15
|
+
if (declared === undefined)
|
|
16
|
+
return "operator";
|
|
17
|
+
const reading = readInputAuthor(declared);
|
|
18
|
+
if (reading === "unknown") {
|
|
19
|
+
onUnreadable(new Error(`RunInternals.objectiveAuthor ${describeRejectedValue(declared)} is not an input author (${INPUT_AUTHORS.join(" / ")}) — the objective is screened as the operator's`));
|
|
20
|
+
}
|
|
21
|
+
return reading;
|
|
22
|
+
}
|
|
23
|
+
export function recipeContinuationLeg(internals) {
|
|
24
|
+
return { ...internals, objectiveAuthor: "engine" };
|
|
25
|
+
}
|
|
26
|
+
const authoredSteers = new WeakMap();
|
|
27
|
+
export function bindAuthoredSteer(stream, steer) {
|
|
28
|
+
authoredSteers.set(stream, steer);
|
|
29
|
+
}
|
|
30
|
+
export function authoredSteerOf(stream) {
|
|
31
|
+
return authoredSteers.get(stream);
|
|
32
|
+
}
|
|
33
|
+
export function droppedInputsDisclosure(authors) {
|
|
34
|
+
const counts = new Map();
|
|
35
|
+
for (const a of authors)
|
|
36
|
+
counts.set(a, (counts.get(a) ?? 0) + 1);
|
|
37
|
+
const named = [...counts].map(([a, n]) => `${n} from ${a}`).join(", ");
|
|
38
|
+
return new Error(`the run ended with ${authors.length} accepted input(s) it never delivered that are not the operator's (${named}): they are dropped — only an operator's input is carried across a pause or counted as the person's undelivered input`);
|
|
39
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A leg's two identity readings, as pure functions with no runtime imports — so a store's projection reads them exactly as
|
|
3
|
+
* the prepare mint and the stations do (one predicate each, never a second spelling at a reader that cannot reach the
|
|
4
|
+
* mods layer).
|
|
5
|
+
*/
|
|
6
|
+
import type { HookInvocationIdentity } from "./hooks.js";
|
|
7
|
+
import type { AskSourceIdentity } from "./tool-policy.js";
|
|
8
|
+
/**
|
|
9
|
+
* The id a delegated leg's events carry as `agentId`: the leg's task id ({@link legTaskIdOf}) — for a background child, the
|
|
10
|
+
* registry task id its spawner registered it under (the string its row, launch card, notifications, `TaskStop` and
|
|
11
|
+
* `SendMessage` use); a foreground child has no row, so it is its session id. A top-level leg carries none. It reads two facts of
|
|
12
|
+
* the leg's identity, so a face minted before the leg's hook envelope (the ask source) asks it with the same two, and a parked
|
|
13
|
+
* row's summary asks it with the two the row records.
|
|
14
|
+
*/
|
|
15
|
+
export declare function agentIdOf(identity: Pick<HookInvocationIdentity, "taskId" | "isDelegatedChild"> | undefined): string | undefined;
|
|
16
|
+
/** A leg's task id — the row a delegation lane runs it as (`internals.rowTaskId`), else its host's `spec.taskId`, else its
|
|
17
|
+
* session id. Minted once at prepare (`Prepared.taskId`); a reader before prepare asks this same function (the resume screen;
|
|
18
|
+
* the throw backstop, which has no session yet). The session id is the leg's transcript address. */
|
|
19
|
+
export declare function legTaskIdOf(spec: {
|
|
20
|
+
readonly taskId?: string | undefined;
|
|
21
|
+
}, internals: {
|
|
22
|
+
readonly rowTaskId?: string | undefined;
|
|
23
|
+
} | undefined, sessionId: string): string;
|
|
24
|
+
export declare function legTaskIdOf(spec: {
|
|
25
|
+
readonly taskId?: string | undefined;
|
|
26
|
+
}, internals: {
|
|
27
|
+
readonly rowTaskId?: string | undefined;
|
|
28
|
+
} | undefined, sessionId: string | undefined): string | undefined;
|
|
29
|
+
/** The facts a leg's ask source is minted from — all the leg's own, read once its session and task id are minted. */
|
|
30
|
+
export interface AskSourceFacts {
|
|
31
|
+
/** The leg's end-user principal (its spec's). */
|
|
32
|
+
readonly principal: string | undefined;
|
|
33
|
+
/** The leg's session id: the conversation every ask of the leg is raised in. */
|
|
34
|
+
readonly sessionId: string;
|
|
35
|
+
/** The leg's one task id ({@link legTaskIdOf}, as minted at prepare). */
|
|
36
|
+
readonly taskId: string;
|
|
37
|
+
/** The leg's effective delegation fact — forks included, the checkpoint's record on a deps-only resume. */
|
|
38
|
+
readonly isDelegatedChild: boolean;
|
|
39
|
+
/** The leg's trusted internals: the parent link and the display names. */
|
|
40
|
+
readonly internals: {
|
|
41
|
+
readonly parentTaskId?: string | undefined;
|
|
42
|
+
readonly explicitAgentName?: string | undefined;
|
|
43
|
+
readonly agentName?: string | undefined;
|
|
44
|
+
} | undefined;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* The leg's ask source, minted ONCE per leg and read by every face that names the issuing leg: the four `resolveAsk`
|
|
48
|
+
* construction sites (the main gate, both inherited wrapper arms, the approved-edit re-ask) spread it, the question tool and
|
|
49
|
+
* the gate's question routing project it, and the approval and plan_review parks stamp its session onto the row — so the
|
|
50
|
+
* explicit "from a background agent" discriminator can never be dropped on one leg, and the same leg is never named two ways.
|
|
51
|
+
* Every member is a fact of THIS leg's own prepare (an inherited ask fires in the child's gate): `internals` never rides a
|
|
52
|
+
* TaskSpec, so a worker cannot self-declare or suppress them.
|
|
53
|
+
*
|
|
54
|
+
* - `sourceSessionId` — the leg's session: the conversation, never a task.
|
|
55
|
+
* - `agentId` — {@link agentIdOf} over the leg's task id and delegation fact: present exactly on a delegated child.
|
|
56
|
+
* - `fromSubagent` — the attribution discriminator: trusted `parentTaskId` presence (a directly-started workflow's agent has
|
|
57
|
+
* none, so it carries `agentId` without it).
|
|
58
|
+
* - `isDelegatedChild` — the refusal posture: the RAW delegation fact, forks included (a fork's interaction contract is
|
|
59
|
+
* one-shot — "no waiting for the user" — so a stop-and-wait refusal would ask it the impossible), so `resolveAsk`'s human
|
|
60
|
+
* refusal texts speak the right posture (parent thread: stop and wait for the user; delegated child: adapt or report).
|
|
61
|
+
*/
|
|
62
|
+
export declare function mintAskSourceIdentity(leg: AskSourceFacts): AskSourceIdentity;
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
export function agentIdOf(identity) {
|
|
2
|
+
return identity?.isDelegatedChild === true ? identity.taskId : undefined;
|
|
3
|
+
}
|
|
4
|
+
export function legTaskIdOf(spec, internals, sessionId) {
|
|
5
|
+
return internals?.rowTaskId ?? spec.taskId ?? sessionId;
|
|
6
|
+
}
|
|
7
|
+
export function mintAskSourceIdentity(leg) {
|
|
8
|
+
const agentId = agentIdOf({ taskId: leg.taskId, isDelegatedChild: leg.isDelegatedChild });
|
|
9
|
+
const sourceAgentName = leg.internals?.explicitAgentName ?? leg.internals?.agentName;
|
|
10
|
+
return Object.freeze({
|
|
11
|
+
principal: leg.principal,
|
|
12
|
+
sourceSessionId: leg.sessionId,
|
|
13
|
+
...(agentId !== undefined ? { agentId } : {}),
|
|
14
|
+
...(leg.internals?.parentTaskId !== undefined ? { fromSubagent: true } : {}),
|
|
15
|
+
...(sourceAgentName !== undefined ? { sourceAgentName } : {}),
|
|
16
|
+
...(leg.isDelegatedChild ? { isDelegatedChild: true } : {}),
|
|
17
|
+
});
|
|
18
|
+
}
|
|
@@ -204,7 +204,8 @@ export declare function judgeEntrySessionMetaKey(copy: McpServerSpec): {
|
|
|
204
204
|
/**
|
|
205
205
|
* The host-transport question for ONE snapshot MCP entry: a `{ kind: "host" }` transport carries no member beyond its kind (its host seat
|
|
206
206
|
* carries its own pieces — a reference, a principal header, a command or a url would be declared and never in force), and its server
|
|
207
|
-
* cannot opt in to `elicitation` (the
|
|
207
|
+
* cannot opt in to `elicitation` (the server behind a host's pipe is the host's own code: a question it has for the user goes through the
|
|
208
|
+
* host's own interface, and the engine advertises no elicitation for it). Either refuses under
|
|
208
209
|
* `config.invalid_argument`, naming the server and the member. Any other entry is unchanged.
|
|
209
210
|
*/
|
|
210
211
|
export declare function judgeEntryHostTransport(copy: McpServerSpec): {
|
|
@@ -3,7 +3,7 @@ import { DECLARATION_ENTRY_WORDS, DECLARATION_PATH_RULES, NO_DECLARATION_PATH_RU
|
|
|
3
3
|
import { isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
4
4
|
import { TOOL_FACE_WORDS, readToolFaces } from "./tool-face-reader.js";
|
|
5
5
|
import { judgeSessionMetaKey } from "./mcp-call-meta.js";
|
|
6
|
-
import { CONFIG_RECEIPT_MODE } from "./own-property-receipt.js";
|
|
6
|
+
import { CONFIG_RECEIPT_MODE, optionKeys, strayMembersOf } from "./own-property-receipt.js";
|
|
7
7
|
import { isToolContentOrigin, TOOL_CONTENT_ORIGINS } from "./memory-engine/content-origin.js";
|
|
8
8
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
9
9
|
import { assertNoRetiredToolPolicyKeys } from "./retired-keys.js";
|
|
@@ -150,15 +150,17 @@ export function judgeEntrySessionMetaKey(copy) {
|
|
|
150
150
|
return { ok: true, entry: copy };
|
|
151
151
|
return { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${inlineUntrusted(read.problem, 200)}. The key decides where the leg's session id rides on this server's requests, so it is refused rather than dropped or defaulted — a connector keyed on a session it never receives would share one state across every session.`) };
|
|
152
152
|
}
|
|
153
|
+
const HOST_TRANSPORT_KEYS = optionKeys()({ kind: 0 });
|
|
153
154
|
export function judgeEntryHostTransport(copy) {
|
|
154
155
|
const transport = copy.transport;
|
|
155
156
|
if (!isPlainRecord(transport) || transport["kind"] !== "host")
|
|
156
157
|
return { ok: true, entry: copy };
|
|
157
|
-
const
|
|
158
|
+
const stray = strayMembersOf(transport, { subject: "a host-supplied transport", unit: "member", moment: "when the entry is read" }, HOST_TRANSPORT_KEYS)?.names[0];
|
|
159
|
+
const extra = stray === undefined ? undefined : String(stray);
|
|
158
160
|
const problem = extra !== undefined
|
|
159
161
|
? `a host-supplied transport with the member ${inlineUntrusted(JSON.stringify(extra), 80)}: a host transport carries its kind alone — the host seat carries what each request needs, so a member here would read as in force while nothing carries it`
|
|
160
162
|
: copy.elicitation === true
|
|
161
|
-
? `elicitation on a host-supplied transport: the host
|
|
163
|
+
? `elicitation on a host-supplied transport: the server behind a host's pipe is the host's own code, so a question it has for the user goes through the host's own interface — the engine advertises no elicitation for it`
|
|
162
164
|
: undefined;
|
|
163
165
|
return problem === undefined ? { ok: true, entry: copy } : { ok: false, error: codedError("config.invalid_argument", `${declarerWord("mcp")} ${declarerNameOf(copy.name)} declares ${problem}.`) };
|
|
164
166
|
}
|
package/dist/core/lsp.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { type RootsSeat } from "../tools/fs/safety.js";
|
|
|
2
2
|
import { type ReadDenyMatcher } from "../tools/fs/read-deny.js";
|
|
3
3
|
import type { HomeViewsCarrier } from "../tools/fs/read-deny-home.js";
|
|
4
4
|
import type { ContainmentFace } from "../tools/fs/containment-face.js";
|
|
5
|
-
import type { AgentTool, BoundFileObject, ExecutionEnv } from "../internal/harness-types.js";
|
|
5
|
+
import type { AgentTool, BoundFileObject, ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
|
|
6
6
|
/**
|
|
7
7
|
* LSP code-intelligence tool (design/64 §13.1) — the app-dev命门 (go-to-def / find-refs / hover across
|
|
8
8
|
* Dart/Kotlin/TS). A single `lsp` tool with a 9-operation enum, built over a pluggable {@link LspServerManager}.
|
|
@@ -301,6 +301,8 @@ export interface LspToolOptions {
|
|
|
301
301
|
export declare function createLspTool(manager: LspServerManager, opts?: LspToolOptions): AgentTool;
|
|
302
302
|
/**
|
|
303
303
|
* A git-check-ignore-based path filter for {@link LspToolOptions.isPathIgnored} (CC parity). Best-effort:
|
|
304
|
-
* if git isn't available or the check fails, nothing is treated as ignored (keep all). Caches per path.
|
|
304
|
+
* if git isn't available or the check fails, nothing is treated as ignored (keep all). Caches per path. `readFloor` = the
|
|
305
|
+
* byte floor each check's start carries, read as it starts (a run's: the run's base table; absent ⇒ none — a caller with
|
|
306
|
+
* no run). A floor that cannot be read is a failed check.
|
|
305
307
|
*/
|
|
306
|
-
export declare function gitCheckIgnoreFilter(env: ExecutionEnv, root: string): (uri: string) => Promise<boolean>;
|
|
308
|
+
export declare function gitCheckIgnoreFilter(env: ExecutionEnv, root: string, readFloor?: () => ReadFloor | undefined): (uri: string) => Promise<boolean>;
|
package/dist/core/lsp.js
CHANGED
|
@@ -349,7 +349,7 @@ function toModelBase(result) {
|
|
|
349
349
|
}
|
|
350
350
|
return result;
|
|
351
351
|
}
|
|
352
|
-
export function gitCheckIgnoreFilter(env, root) {
|
|
352
|
+
export function gitCheckIgnoreFilter(env, root, readFloor) {
|
|
353
353
|
const cache = new Map();
|
|
354
354
|
return async (uri) => {
|
|
355
355
|
const path = uriToPath(uri);
|
|
@@ -359,7 +359,8 @@ export function gitCheckIgnoreFilter(env, root) {
|
|
|
359
359
|
let ignored = false;
|
|
360
360
|
try {
|
|
361
361
|
const q = `'${path.replace(/'/g, `'\\''`)}'`;
|
|
362
|
-
const
|
|
362
|
+
const floor = readFloor?.();
|
|
363
|
+
const res = await env.exec(`git check-ignore ${q}`, { cwd: root, timeout: 10, ...(floor !== undefined ? { readFloor: floor } : {}) });
|
|
363
364
|
ignored = res.ok && res.value.exitCode === 0;
|
|
364
365
|
}
|
|
365
366
|
catch {
|