@sema-agent/core 7.66.1 → 7.67.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 +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -8,13 +8,21 @@
|
|
|
8
8
|
* any in-flight call silent for {@link TOOL_HEARTBEAT_MS}.
|
|
9
9
|
*
|
|
10
10
|
* THE CALLS IN FLIGHT ARE THE LEG'S OCCURRENCES (`tool-occurrence.ts`), not a set of this lane's own: the record
|
|
11
|
-
* that carries a call's start frame carries its elapsed origin, its silence clock
|
|
12
|
-
* the beat can never describe a call the frames say ended, nor miss one they say started.
|
|
11
|
+
* that carries a call's start frame carries its elapsed origin (its release), its silence clock, its wait on the
|
|
12
|
+
* person and its classification, so the beat can never describe a call the frames say ended, nor miss one they say started.
|
|
13
13
|
*
|
|
14
14
|
* ONE ORIGIN PER CALL, the producer owns FACTS. A producer reports what it has seen (the tail, the totals),
|
|
15
15
|
* never how long it has run: `elapsedTimeSeconds` is computed HERE from the occurrence's origin — its
|
|
16
|
-
*
|
|
17
|
-
* beat could be followed moments later by a shell tick reporting 1 s,
|
|
16
|
+
* RELEASE, the moment the engine let the call go to its executor — because a shell command's own clock could only
|
|
17
|
+
* start at its spawn. With two origins a 30 s beat could be followed moments later by a shell tick reporting 1 s,
|
|
18
|
+
* breaking the monotonicity the frame promises.
|
|
19
|
+
*
|
|
20
|
+
* ELAPSED IS EXECUTION TIME, COUNTED FROM THE RELEASE, NOT FROM THE ANNOUNCEMENT. The start frame goes out before the
|
|
21
|
+
* gate runs, so a call announced and still at its gate (a hook, a classifier, a card put to the person) is waiting, not
|
|
22
|
+
* running: counting its elapsed from the announcement made the person's ten seconds on a card the command's first ten.
|
|
23
|
+
* A call not yet released is still beaten like any other — its elapsed reads 0, it has executed for no time — and the
|
|
24
|
+
* frame says who holds it (`gate`, read off the occurrence at the mint — see `tool_progress.gate` in `task-event.ts`), so
|
|
25
|
+
* the beat never says "running" of a call that has not started.
|
|
18
26
|
*
|
|
19
27
|
* THE CADENCE HAS ONE ENFORCEMENT POINT, same reason: a producer's timer is a SAMPLING clock, not the
|
|
20
28
|
* contract. `emit` drops a frame landing inside {@link TOOL_PROGRESS_MIN_INTERVAL_MS} of that call's last.
|
|
@@ -32,6 +40,13 @@
|
|
|
32
40
|
* container's clock settling after a resume — makes each difference negative and silences BOTH producers
|
|
33
41
|
* until it catches up: the exact failure this lane exists to prevent.
|
|
34
42
|
*
|
|
43
|
+
* WORK IS TOLD ONLY BY A PRODUCER, AND ONLY WHEN ITS TOTALS ADVANCED. The leg's activity seat (`onWork`: the same
|
|
44
|
+
* seat a tool start, a tool end and an MCP progress notification beat) hears a frame a PRODUCER offered whose
|
|
45
|
+
* `totalBytes` is larger than that call's last frame carried — a command that is printing is working. The lane's own
|
|
46
|
+
* heartbeat never tells it (it says "still in flight", and a hung call must read as silent), and neither does a producer's
|
|
47
|
+
* tick whose totals did not move (a command that printed once and went quiet) or that carries none (a command that has
|
|
48
|
+
* printed nothing, a buffered environment).
|
|
49
|
+
*
|
|
35
50
|
* LIVENESS ONLY — see the `tool_progress` member's contract in `task-event.ts`. The timer is `unref`'d and
|
|
36
51
|
* every emission is fault-contained. */
|
|
37
52
|
import type { TaskEvent, TaskEventIdentity } from "../types.js";
|
|
@@ -47,4 +62,4 @@ export declare const TOOL_PROGRESS_MIN_INTERVAL_MS = 1000;
|
|
|
47
62
|
/** Build the lane over the run's content pusher (`pushContent` — the ONE seat that puts a frame on this
|
|
48
63
|
* run's queue and, for a sub-agent, forwards it to the parent's sink), its identity mint and the leg's
|
|
49
64
|
* occurrence table (the calls in flight). */
|
|
50
|
-
export declare function createToolProgressLane(push: (e: TaskEvent) => void, ident: () => TaskEventIdentity, occurrences: ToolOccurrenceTable): ToolProgressLane;
|
|
65
|
+
export declare function createToolProgressLane(push: (e: TaskEvent) => void, ident: () => TaskEventIdentity, occurrences: ToolOccurrenceTable, onWork?: () => void): ToolProgressLane;
|
|
@@ -1,8 +1,9 @@
|
|
|
1
|
-
import { occurrenceClock } from "./tool-occurrence.js";
|
|
1
|
+
import { gatePhaseOf, occurrenceClock } from "./tool-occurrence.js";
|
|
2
2
|
export const TOOL_HEARTBEAT_MS = 30_000;
|
|
3
3
|
export const TOOL_PROGRESS_MIN_INTERVAL_MS = 1_000;
|
|
4
|
-
export function createToolProgressLane(push, ident, occurrences) {
|
|
4
|
+
export function createToolProgressLane(push, ident, occurrences, onWork) {
|
|
5
5
|
let timer;
|
|
6
|
+
const printed = new Map();
|
|
6
7
|
const arm = () => {
|
|
7
8
|
if (timer !== undefined)
|
|
8
9
|
return;
|
|
@@ -16,19 +17,39 @@ export function createToolProgressLane(push, ident, occurrences) {
|
|
|
16
17
|
timer = undefined;
|
|
17
18
|
};
|
|
18
19
|
occurrences.onOpen(arm);
|
|
19
|
-
const
|
|
20
|
+
const noteWork = (toolCallId, attempt, bytes) => {
|
|
21
|
+
if (bytes === undefined || !Number.isFinite(bytes))
|
|
22
|
+
return;
|
|
23
|
+
const last = printed.get(toolCallId);
|
|
24
|
+
const before = last !== undefined && last.attempt === attempt ? last.bytes : 0;
|
|
25
|
+
printed.set(toolCallId, { attempt, bytes });
|
|
26
|
+
if (bytes <= before)
|
|
27
|
+
return;
|
|
28
|
+
try {
|
|
29
|
+
onWork?.();
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
const mint = (body, offeredByProducer) => {
|
|
20
35
|
const now = occurrenceClock();
|
|
21
36
|
const unseen = occurrences.get(body.toolCallId) === undefined;
|
|
22
37
|
const occ = occurrences.ensure({ toolCallId: body.toolCallId, spelledName: body.toolName, args: undefined });
|
|
38
|
+
if (unseen)
|
|
39
|
+
occurrences.release(occ.toolCallId);
|
|
23
40
|
if (!unseen && now - occ.lastHeardAt < TOOL_PROGRESS_MIN_INTERVAL_MS)
|
|
24
41
|
return;
|
|
25
42
|
occurrences.heard(occ.toolCallId);
|
|
43
|
+
const gate = gatePhaseOf(occ);
|
|
26
44
|
try {
|
|
27
|
-
push({ type: "tool_progress", ...body, elapsedTimeSeconds: Math.floor((now - occ.
|
|
45
|
+
push({ type: "tool_progress", ...body, elapsedTimeSeconds: Math.floor((now - (occ.releasedAt ?? now)) / 1000), ...(gate !== undefined ? { gate } : {}), ...ident() });
|
|
28
46
|
}
|
|
29
47
|
catch {
|
|
30
48
|
}
|
|
49
|
+
if (offeredByProducer)
|
|
50
|
+
noteWork(occ.toolCallId, occ.attempt, body.totalBytes);
|
|
31
51
|
};
|
|
52
|
+
const emit = (body) => mint(body, true);
|
|
32
53
|
function beat() {
|
|
33
54
|
const now = occurrenceClock();
|
|
34
55
|
const inFlight = occurrences.live().filter((o) => o.beating);
|
|
@@ -39,7 +60,7 @@ export function createToolProgressLane(push, ident, occurrences) {
|
|
|
39
60
|
for (const o of inFlight) {
|
|
40
61
|
if (now - o.lastHeardAt < TOOL_HEARTBEAT_MS)
|
|
41
62
|
continue;
|
|
42
|
-
|
|
63
|
+
mint({ toolCallId: o.toolCallId, toolName: o.spelledName }, false);
|
|
43
64
|
}
|
|
44
65
|
}
|
|
45
66
|
return {
|
|
@@ -47,6 +68,7 @@ export function createToolProgressLane(push, ident, occurrences) {
|
|
|
47
68
|
clear() {
|
|
48
69
|
occurrences.quiesce();
|
|
49
70
|
disarm();
|
|
71
|
+
printed.clear();
|
|
50
72
|
},
|
|
51
73
|
};
|
|
52
74
|
}
|
|
@@ -1,13 +1,17 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The run's
|
|
2
|
+
* The run's accounts of a tool's media and binary content it could not hand the model as content. The loop's
|
|
3
3
|
* post-execution half admits every media block an executed call's result carries (`admitToolResultMedia`, the last step
|
|
4
|
-
* of `finalizeToolOutcome`) and hands each call's refusals here once
|
|
5
|
-
*
|
|
6
|
-
*
|
|
4
|
+
* of `finalizeToolOutcome`) and hands each call's refusals here once (`tool_result.media_refused`, operator); an MCP
|
|
5
|
+
* call or resource read whose server sent binary content that is not media the model reads hands what became of it here
|
|
6
|
+
* once (`tool_result.media_persisted`, operator). The lines that stand in the result are already there, so these
|
|
7
|
+
* seats only word the account and deliver it on the deployment's notice sink. The details carry closed-set words,
|
|
8
|
+
* counts, the call's identity, a media type only when it can be one, and the ref each piece is kept under in the run's
|
|
9
|
+
* tool-result store — or why it is not (with the store's own error text for the operator) — never the bytes.
|
|
7
10
|
*/
|
|
8
11
|
import { type EngineNotice } from "../engine-notice.js";
|
|
9
12
|
import { type ToolResultMediaRefusal } from "../image-admission.js";
|
|
10
13
|
import type { ImageDownsampler } from "../image-downsample.js";
|
|
14
|
+
import type { McpBinaryKept } from "../mcp.js";
|
|
11
15
|
/** The run's attribution pair, as every per-run notice carries it. */
|
|
12
16
|
export interface ToolResultMediaSeatIds {
|
|
13
17
|
sessionId: string;
|
|
@@ -18,6 +22,13 @@ export declare function toolResultMediaRefusedSeat(onNotice: ((notice: EngineNot
|
|
|
18
22
|
toolCallId: string;
|
|
19
23
|
refused: readonly ToolResultMediaRefusal[];
|
|
20
24
|
}) => void;
|
|
25
|
+
/**
|
|
26
|
+
* The run's account of an MCP server's binary content (`tool_result.media_persisted`, operator): once per call or resource
|
|
27
|
+
* read that carried any — an audio block, or a resource blob of a type outside the media admission's sets. The model read a
|
|
28
|
+
* line naming each piece's ref (or why it was not kept) instead of the bytes. The detail carries the server, the call, and
|
|
29
|
+
* per piece its size, its media type when it can be one, and the ref — or why it was not kept.
|
|
30
|
+
*/
|
|
31
|
+
export declare function mcpBinaryKeptSeat(onNotice: ((notice: EngineNotice) => void) | undefined, ids: ToolResultMediaSeatIds): (info: McpBinaryKept) => void;
|
|
21
32
|
/**
|
|
22
33
|
* The run's one account of an image that goes to the model unprocessed over `IMAGE_ADMISSION.soft.targetBytes`
|
|
23
34
|
* (`config.image_processor_unavailable`, operator): said ONCE per run, at the first such image wherever it entered — a
|
|
@@ -3,15 +3,31 @@ import { IMAGE_ADMISSION } from "../image-admission.js";
|
|
|
3
3
|
export function toolResultMediaRefusedSeat(onNotice, ids) {
|
|
4
4
|
return ({ toolName, toolCallId, refused }) => {
|
|
5
5
|
const reasons = [...new Set(refused.map((r) => r.reason))].join(", ");
|
|
6
|
+
const kept = refused.filter((r) => r.ref !== undefined).length;
|
|
7
|
+
const unkept = refused.filter((r) => r.notKept !== undefined).length;
|
|
6
8
|
deliverEngineNotice(onNotice, {
|
|
7
9
|
code: "tool_result.media_refused",
|
|
8
10
|
message: `The ${JSON.stringify(toolName)} tool's result carried ${refused.length} media block(s) whose bytes the media admission refused (${reasons}). ` +
|
|
9
11
|
`Each was replaced in the result by a text placeholder naming the refusal, so neither the model nor the event stream received those bytes; ` +
|
|
10
|
-
`the tool, or the server behind it, returned bytes that are not what their block claims, or that are beyond what can be sent
|
|
12
|
+
`the tool, or the server behind it, returned bytes that are not what their block claims, or that are beyond what can be sent.` +
|
|
13
|
+
(kept > 0 ? ` ${kept} refused for their size were kept in the run's tool-result store, and their placeholders name each one's ref (detail.refused[].ref).` : "") +
|
|
14
|
+
(unkept > 0 ? ` ${unkept} refused for their size were not kept (detail.refused[].notKept says why).` : ""),
|
|
11
15
|
detail: { toolName, toolCallId, refused: refused.map((r) => ({ ...r })), sessionId: ids.sessionId, runId: ids.runId },
|
|
12
16
|
});
|
|
13
17
|
};
|
|
14
18
|
}
|
|
19
|
+
export function mcpBinaryKeptSeat(onNotice, ids) {
|
|
20
|
+
return ({ server, toolName, toolCallId, kept }) => {
|
|
21
|
+
const stored = kept.filter((k) => "ref" in k).length;
|
|
22
|
+
deliverEngineNotice(onNotice, {
|
|
23
|
+
code: "tool_result.media_persisted",
|
|
24
|
+
message: `MCP server ${JSON.stringify(server)} sent ${kept.length} piece(s) of binary content in the ${JSON.stringify(toolName)} result that are not media the model reads (audio, or a type outside the image and document types it accepts). ` +
|
|
25
|
+
`${stored} were kept in the run's tool-result store and the result names each one's ref in place of the bytes` +
|
|
26
|
+
(stored < kept.length ? `; ${kept.length - stored} were not kept (detail.kept[].notKept says why), and the result says so.` : "."),
|
|
27
|
+
detail: { server, toolName, toolCallId, kept: kept.map((k) => ({ ...k })), sessionId: ids.sessionId, runId: ids.runId },
|
|
28
|
+
});
|
|
29
|
+
};
|
|
30
|
+
}
|
|
15
31
|
export function imageUnprocessedSeat(onNotice, seat, ids) {
|
|
16
32
|
let told = false;
|
|
17
33
|
return (bytes) => {
|
|
@@ -30,7 +30,7 @@ export function createToolTableView(faces) {
|
|
|
30
30
|
const fingerprint = faces.fpRef.current;
|
|
31
31
|
if (fingerprint !== undefined && !sameNames(fingerprint.tools, shown))
|
|
32
32
|
fingerprint.tools = inputs;
|
|
33
|
-
faces.turnSnapshotRef.current?.refreshTools(inputs);
|
|
33
|
+
faces.turnSnapshotRef.current?.refreshTools(inputs, "view");
|
|
34
34
|
}
|
|
35
35
|
hidOne = hides;
|
|
36
36
|
return hides ? { ...context, tools: shown } : context;
|
|
@@ -2,9 +2,12 @@ import type { McpDroppedTool } from "../mcp.js";
|
|
|
2
2
|
import { type McpUnavailableEntry } from "../mcp-failure.js";
|
|
3
3
|
import type { McpInstructionsEntry } from "../prompt-section-seat.js";
|
|
4
4
|
import type { TaskSpec } from "../types.js";
|
|
5
|
+
import type { AttachmentSource } from "../attachment-source.js";
|
|
6
|
+
import type { ChangedFilesNotice } from "../../internal/llm.js";
|
|
5
7
|
import { type BackgroundTaskTableRow } from "../task-notification.js";
|
|
6
8
|
import { type SkillListingEntry, type SkillsBlockRender } from "./synthetic-tools.js";
|
|
7
9
|
import { type ResolvedSkillListingBudget } from "../skill-listing-budget.js";
|
|
10
|
+
import { type EngineText } from "../../prompt-assembly/engine-text.js";
|
|
8
11
|
/**
|
|
9
12
|
* Turn-boundary attachment seam: the PURE producer layer (CC `getContextAttachments`
|
|
10
13
|
* parity). This module is the single home of the CC-parity cadence judgment + reminder copy (提示词主权批:
|
|
@@ -77,7 +80,6 @@ export declare const CHANGED_FILES_MTIME_EPS_MS = 2000;
|
|
|
77
80
|
/** Per-boundary byte cap over the bundle's CLIPPABLE frames (weak-model context economics). Intact-class
|
|
78
81
|
* frames ride outside it — see {@link ATTACHMENT_DELIVERY_CLASS}. */
|
|
79
82
|
export declare const ATTACHMENT_BYTE_CAP: number;
|
|
80
|
-
export type AttachmentSource = "todo_reminder" | "task_reminder" | "tool_search_usage_reminder" | "changed_files" | "output_style" | "date_change" | "instructions_change" | "workflow_size_guideline_change" | "budget_usd" | "total_tokens_reminder" | "background_tasks" | "tools_delta" | "mcp_unavailable" | "agent_listing" | "skills_listing" | "mcp_instructions" | "mcp_dropped_tools";
|
|
81
83
|
/** How the bundle cap treats a source — see {@link ATTACHMENT_DELIVERY_CLASS}. */
|
|
82
84
|
export type AttachmentDeliveryClass = {
|
|
83
85
|
readonly class: "clippable";
|
|
@@ -152,10 +154,6 @@ export declare const ATTACHMENT_DELIVERY_CLASS: {
|
|
|
152
154
|
readonly class: "intact";
|
|
153
155
|
readonly bound: () => number;
|
|
154
156
|
};
|
|
155
|
-
readonly instructions_change: {
|
|
156
|
-
readonly class: "intact";
|
|
157
|
-
readonly bound: () => number;
|
|
158
|
-
};
|
|
159
157
|
readonly workflow_size_guideline_change: {
|
|
160
158
|
readonly class: "intact";
|
|
161
159
|
readonly bound: () => number;
|
|
@@ -199,6 +197,12 @@ export interface TurnAttachment {
|
|
|
199
197
|
* lane cap it rides under) so the echo is the list the model received, not the first row or two of it. Absent = the
|
|
200
198
|
* shared budget ({@link import("./steering-preview.js").STEERING_PREVIEW_BUDGET}). */
|
|
201
199
|
echoBound?: number;
|
|
200
|
+
/** changed_files only: the files the body lists, in order — each the (path, modification time) the model is told
|
|
201
|
+
* about ({@link changedFilesNoticeIn} records them on the carrying message). */
|
|
202
|
+
noticed?: ReadonlyArray<{
|
|
203
|
+
readonly path: string;
|
|
204
|
+
readonly mtimeMs: number;
|
|
205
|
+
}>;
|
|
202
206
|
}
|
|
203
207
|
/** H4 — the thin projection of a todo list kept run-local (NEVER the wire-capped `tool_end.structured` card).
|
|
204
208
|
* Pure CONTENT memory: the write-window anchor lives on {@link AttachmentState.todoLastWriteTurn}
|
|
@@ -246,9 +250,6 @@ export interface AttachmentState {
|
|
|
246
250
|
/** Cadence-clock value at the last tool_search_usage_reminder emitted (the reference's
|
|
247
251
|
* `turnsSinceLastReminder`, found by scanning back for the attachment entry itself). */
|
|
248
252
|
lastToolSearchReminderTurn: number;
|
|
249
|
-
/** changed_files per-path dedup: the last mtime already surfaced for a path — the same (path, mtime)
|
|
250
|
-
* is never reported twice. Evicted alongside readFileState's ENOENT eviction (LOW-9: bounded by it). */
|
|
251
|
-
surfacedMtime: Map<string, number>;
|
|
252
253
|
/** G1 backgroundTasks (CC /compact parity): SET by the run loop when a compaction LANDS,
|
|
253
254
|
* CONSUMED at the next boundary the collector actually runs (a steered-away boundary carries it
|
|
254
255
|
* forward untouched — the collector is never called there). One-shot: post-compact announce once,
|
|
@@ -321,31 +322,13 @@ export interface AttachmentState {
|
|
|
321
322
|
export interface DateChangeState {
|
|
322
323
|
announcedDate: string;
|
|
323
324
|
}
|
|
324
|
-
/**
|
|
325
|
-
* [A2] C-4 (design-A §4.2/§4.3) — the instructions_change lane's OWN state, the date_change
|
|
326
|
-
* discipline exactly: deliberately NOT an {@link AttachmentState} member (allocating that would
|
|
327
|
-
* activate the cadence reducers on runs that only carry an instruction snapshot), one field, zero
|
|
328
|
-
* reducers. `lastAnnouncedHash` starts as the snapshot's declared per-path hashes
|
|
329
|
-
* (`ProjectMemoryLoad.instructionSources` — what the model is already seeing) and the RUN LOOP
|
|
330
|
-
* commits it via {@link commitInstructionsChange} when it actually appends the frame (the producer
|
|
331
|
-
* below is pure). The frame rides ABOVE the 8KB bundle cap as a fixed ≤{@link INSTRUCTIONS_CHANGE_BYTE_CAP}
|
|
332
|
-
* item — no clipping face exists, so commit-at-append is sound (the A1-R argument verbatim).
|
|
333
|
-
* `null` value = "announced as removed" (a reappearing file re-announces by hash inequality).
|
|
334
|
-
*/
|
|
335
|
-
export interface InstructionsChangeState {
|
|
336
|
-
lastAnnouncedHash: Map<string, string | null>;
|
|
337
|
-
}
|
|
338
|
-
/** [A2] C-4 — hard byte ceiling of one instructions_change frame body (design-A §4.3: fixed small
|
|
339
|
-
* frame riding above the 8KB bundle cap; paths are ellipsis-truncated and overflow files are
|
|
340
|
-
* summarized as a count rather than ever growing the frame). */
|
|
341
|
-
export declare const INSTRUCTIONS_CHANGE_BYTE_CAP = 512;
|
|
342
325
|
/**
|
|
343
326
|
* `workflow_size_guideline_change` (the third above-cap fixed-frame lane) has NO state interface and
|
|
344
327
|
* no producer here on purpose: its copy is the Workflow tool's own
|
|
345
328
|
* `workflowSizeGuidelineChangeNotice`, and rendering it from this module would put an
|
|
346
329
|
* orchestration dependency on the pure attachment producer layer. Its one-field run-local state and
|
|
347
330
|
* its baseline/live comparison live at the single steerer instead (runtask.ts, next to the
|
|
348
|
-
* date_change
|
|
331
|
+
* date_change lane it is structurally identical to). The kind is listed in
|
|
349
332
|
* {@link AttachmentSource} because the steer wrapper, the byte accounting and the
|
|
350
333
|
* `steering_injected` echo are all keyed on that wordlist.
|
|
351
334
|
*/
|
|
@@ -611,6 +594,9 @@ export interface AttachmentInputs {
|
|
|
611
594
|
added: ReadonlyArray<McpInstructionsEntry>;
|
|
612
595
|
removed: readonly string[];
|
|
613
596
|
};
|
|
597
|
+
/** The run's engine text reading (its locale's): the frame's catalog lines render through it, and the caller's
|
|
598
|
+
* intact-survival check renders through the same one. The Runner's boundary always hands it; absent ⇒ canonical. */
|
|
599
|
+
engineText?: EngineText;
|
|
614
600
|
/** [cc216] mcp_dropped_tools: intake-dropped MCP tools snapshotted from
|
|
615
601
|
* `MaterializedMcp.droppedTools` (rides the `mcpInstructions` opt-in — same MCP announce lane).
|
|
616
602
|
* CALLER-owned consumption on intact cap survival (same `newTools` discipline). Tool names are
|
|
@@ -634,6 +620,34 @@ export interface AttachmentInputs {
|
|
|
634
620
|
* least afford to lose.
|
|
635
621
|
*/
|
|
636
622
|
export declare function collectDueAttachments(state: AttachmentState, inp: AttachmentInputs): readonly TurnAttachment[];
|
|
623
|
+
/**
|
|
624
|
+
* The changed_files frame for one scan's result — the ONE collector, shared by the turn boundary's bundle and a leg's first
|
|
625
|
+
* request: every file the scan found changed and not read again, or `undefined` when there is none. Whether the model was
|
|
626
|
+
* already told is not this collector's question: it is asked of the request's own view, which carries each listed
|
|
627
|
+
* (path, modification time) once (`request-copy-projection.ts`, over the record {@link changedFilesNoticeIn} writes). So a
|
|
628
|
+
* notice the request lost — the byte cap starved it, a trim or a summary took it — is minted again by the next scan, and
|
|
629
|
+
* the record step is nothing.
|
|
630
|
+
*/
|
|
631
|
+
export declare function collectChangedFilesAttachment(changed: ReadonlyArray<{
|
|
632
|
+
path: string;
|
|
633
|
+
mtimeMs: number;
|
|
634
|
+
}>): TurnAttachment | undefined;
|
|
635
|
+
/**
|
|
636
|
+
* The same frame for a leg's first request, under the bundle's own lane cap ({@link ATTACHMENT_BYTE_CAP}, the one cut
|
|
637
|
+
* {@link capAttachments} makes): the list is unbounded where the boundary clips it, so a frame the first request carries is clipped
|
|
638
|
+
* by the same function, alone — it is the one clippable frame a first request owes.
|
|
639
|
+
*/
|
|
640
|
+
export declare function collectChangedFilesFirstRequestFrame(changed: ReadonlyArray<{
|
|
641
|
+
path: string;
|
|
642
|
+
mtimeMs: number;
|
|
643
|
+
}>): TurnAttachment | undefined;
|
|
644
|
+
/**
|
|
645
|
+
* The record of a changed_files block as it stands in `text` — the message that carries it (its `changedFilesNotices`):
|
|
646
|
+
* `block` is the frame's minted bytes, found at their first occurrence; each listed file is found
|
|
647
|
+
* at its own list line in them, in order, and a file whose line the byte cap cut (with every one after it) is not listed.
|
|
648
|
+
* `undefined` when the block is not in `text` or lists no whole line — the request then carries it as written.
|
|
649
|
+
*/
|
|
650
|
+
export declare function changedFilesNoticeIn(text: string, block: string, frame: TurnAttachment): ChangedFilesNotice | undefined;
|
|
637
651
|
/**
|
|
638
652
|
* The `tool_search_usage_reminder` renderer text, with the two
|
|
639
653
|
* interpolations resolved: the name list (+ `(+N more)` tail when the census exceeds
|
|
@@ -671,47 +685,6 @@ export declare function renderDateChange(newDate: string): string;
|
|
|
671
685
|
* `state.announcedDate = today` when the carrying message's receipt settles (see {@link DateChangeState}).
|
|
672
686
|
*/
|
|
673
687
|
export declare function collectDateChange(state: DateChangeState, today: string): TurnAttachment | undefined;
|
|
674
|
-
/**
|
|
675
|
-
* [A2] C-4 — the instructions_change producer (design-A §4.3): the project-instruction snapshot is
|
|
676
|
-
* FROZEN for the session (§4.1); when the deployment probe reports a file hash that walked away from
|
|
677
|
-
* the last ANNOUNCED one, the model is told at the tail — it can Read the truth on demand (the
|
|
678
|
-
* seeded-read dedup disarms on a changed file, §4.4, so the Read returns the real new content).
|
|
679
|
-
*
|
|
680
|
-
* PURE — same split as {@link collectDateChange}: the caller commits via
|
|
681
|
-
* {@link commitInstructionsChange} when it actually appends the frame (append-⇔-commit holds because
|
|
682
|
-
* the frame rides ABOVE the byte-capped bundle). Rules:
|
|
683
|
-
* - `probed === null` ⇒ the probe declined this boundary (remote cwd / EACCES / transient IO):
|
|
684
|
-
* silent skip, nothing committed, next boundary retries.
|
|
685
|
-
* - string INEQUALITY against the last announced hash triggers (a rollback to an old value is also
|
|
686
|
-
* a change — the date lane's same rule); the SAME value never announces twice (终身一次).
|
|
687
|
-
* - `contentHash: null` = the file is GONE — announced once as removed (`hash → absent`);
|
|
688
|
-
* a reappearing file re-announces by inequality against the committed `null`.
|
|
689
|
-
* - probed paths the snapshot never declared are ignored (the deployment owns the file-name policy;
|
|
690
|
-
* core only compares against the declared baseline).
|
|
691
|
-
* - the frame body is HARD-BOUNDED to {@link INSTRUCTIONS_CHANGE_BYTE_CAP}: paths are
|
|
692
|
-
* ellipsis-truncated, and files that don't fit are summarized as `(+N more…)` — those stay
|
|
693
|
-
* UNCOMMITTED (absent from `announced`) and re-announce at the next boundary.
|
|
694
|
-
* - multi-file changes merge into ONE frame, one line per file (§4.3).
|
|
695
|
-
*
|
|
696
|
-
* Returns the frame plus the `announced` entries that actually rode it (the caller's commit set),
|
|
697
|
-
* or `undefined` when nothing is due.
|
|
698
|
-
*/
|
|
699
|
-
export declare function collectInstructionsChange(state: InstructionsChangeState, probed: ReadonlyArray<{
|
|
700
|
-
path: string;
|
|
701
|
-
contentHash: string | null;
|
|
702
|
-
}> | null): {
|
|
703
|
-
attachment: TurnAttachment;
|
|
704
|
-
announced: ReadonlyArray<{
|
|
705
|
-
path: string;
|
|
706
|
-
contentHash: string | null;
|
|
707
|
-
}>;
|
|
708
|
-
} | undefined;
|
|
709
|
-
/** [A2] C-4 — the run loop's commit half (append-⇔-commit, {@link InstructionsChangeState}): advance
|
|
710
|
-
* the per-path last-announced hashes for exactly the entries that rode the appended frame. */
|
|
711
|
-
export declare function commitInstructionsChange(state: InstructionsChangeState, announced: ReadonlyArray<{
|
|
712
|
-
path: string;
|
|
713
|
-
contentHash: string | null;
|
|
714
|
-
}>): void;
|
|
715
688
|
export declare function renderBudgetUsd(used: number, total: number): string;
|
|
716
689
|
/**
|
|
717
690
|
* The whole body is the one-line envelope (cli296.js:188983): "<total_tokens>N tokens left</total_tokens>",
|
|
@@ -1006,14 +979,14 @@ export declare const MCP_INSTRUCTIONS_MAX_CHARS = 4096;
|
|
|
1006
979
|
* own choice of tag count. One measurement, taken where the cut happens, is the only shape that cannot
|
|
1007
980
|
* drift.
|
|
1008
981
|
*/
|
|
1009
|
-
export declare function fenceMcpServerInstructions(server: string, text: string): string;
|
|
982
|
+
export declare function fenceMcpServerInstructions(server: string, text: string, say?: EngineText): string;
|
|
1010
983
|
/**
|
|
1011
984
|
* The ONE renderer of an MCP instructions entry, read by both lanes. A server's text rides the fence above;
|
|
1012
985
|
* a host's replacement is host text and takes the reference's per-server block, `## <server>` then the
|
|
1013
986
|
* text (cli296.js B[17396126,17396429), `Yqe`), unfenced. Both are bounded by the same per-entry cap and
|
|
1014
987
|
* disclose the same cut, so the frame's size bound holds for the entry that actually rides.
|
|
1015
988
|
*/
|
|
1016
|
-
export declare function renderMcpInstructionsEntry(entry: McpInstructionsEntry): string;
|
|
989
|
+
export declare function renderMcpInstructionsEntry(entry: McpInstructionsEntry, say?: EngineText): string;
|
|
1017
990
|
/**
|
|
1018
991
|
* G1 续批 — MCP server-instruction delta (the reference header, cli296.js:250602: "The following MCP servers have provided instructions").
|
|
1019
992
|
* Deliberate deviations from the reference (recorded):
|
|
@@ -1029,7 +1002,7 @@ export declare function renderMcpInstructionsEntry(entry: McpInstructionsEntry):
|
|
|
1029
1002
|
* carry the prefix — the asymmetry is the reference's, kept as is). Exported for the run loop's
|
|
1030
1003
|
* intact-survival consumption check (tools_delta discipline).
|
|
1031
1004
|
*/
|
|
1032
|
-
export declare function renderMcpInstructionsDelta(added: ReadonlyArray<McpInstructionsEntry>, removed: readonly string[]): string | undefined;
|
|
1005
|
+
export declare function renderMcpInstructionsDelta(added: ReadonlyArray<McpInstructionsEntry>, removed: readonly string[], say?: EngineText): string | undefined;
|
|
1033
1006
|
/**
|
|
1034
1007
|
* [cc216] mcp_dropped_tools — announce intake-dropped MCP tools ONCE (CC's
|
|
1035
1008
|
* `mcp_dropped_tools_delta` system reminder). Per-entry line shape follows CC's `qny`
|
|
@@ -7,6 +7,7 @@ import { renderSkillLinesWithin, renderSkillsBlock } from "./synthetic-tools.js"
|
|
|
7
7
|
import { SKILL_LISTING_DEFAULT_BUDGET } from "../skill-listing-budget.js";
|
|
8
8
|
import { foldListingWithin, foldRemovalArmWithin, removalArmFloor } from "./listing-fold.js";
|
|
9
9
|
import { eventDefaultOn } from "../../prompt-assembly/event-registry.js";
|
|
10
|
+
import { engineTextFor } from "../../prompt-assembly/engine-text.js";
|
|
10
11
|
import { TOOL_SEARCH_NAME as TOOL_SEARCH_TOOL_NAME } from "./tool-disclosure.js";
|
|
11
12
|
export const TODO_REMINDER_CONFIG = {
|
|
12
13
|
TURNS_SINCE_WRITE: 10,
|
|
@@ -44,7 +45,6 @@ export const ATTACHMENT_DELIVERY_CLASS = {
|
|
|
44
45
|
mcp_instructions: { class: "intact", bound: (inp) => mcpInstructionsBound(inp) },
|
|
45
46
|
mcp_dropped_tools: { class: "intact", bound: (inp) => mcpDroppedToolsBound(inp) },
|
|
46
47
|
date_change: { class: "intact", bound: () => DATE_CHANGE_MAX_BYTES },
|
|
47
|
-
instructions_change: { class: "intact", bound: () => INSTRUCTIONS_CHANGE_BYTE_CAP },
|
|
48
48
|
workflow_size_guideline_change: { class: "intact", bound: () => WORKFLOW_SIZE_GUIDELINE_CHANGE_MAX_BYTES },
|
|
49
49
|
};
|
|
50
50
|
export function isIntactSource(source) {
|
|
@@ -61,13 +61,11 @@ const ATTACHMENT_TAGS_OWNED = {
|
|
|
61
61
|
export function attachmentEnvelopeTags(source) {
|
|
62
62
|
return ATTACHMENT_TAGS_OWNED[source] ?? ATTACHMENT_TAGS_DEFAULT;
|
|
63
63
|
}
|
|
64
|
-
export const INSTRUCTIONS_CHANGE_BYTE_CAP = 512;
|
|
65
64
|
export function createAttachmentState() {
|
|
66
65
|
return {
|
|
67
66
|
lastTodoReminderTurn: 0,
|
|
68
67
|
lastTaskReminderTurn: 0,
|
|
69
68
|
lastToolSearchReminderTurn: 0,
|
|
70
|
-
surfacedMtime: new Map(),
|
|
71
69
|
postCompactPending: false,
|
|
72
70
|
};
|
|
73
71
|
}
|
|
@@ -242,23 +240,57 @@ export function collectDueAttachments(state, inp) {
|
|
|
242
240
|
if (skillsListingBody !== undefined)
|
|
243
241
|
(out ??= []).push({ source: "skills_listing", body: skillsListingBody });
|
|
244
242
|
if (inp.config.mcpInstructions && inp.mcpInstructions !== undefined) {
|
|
245
|
-
const body = renderMcpInstructionsDelta(inp.mcpInstructions.added, inp.mcpInstructions.removed);
|
|
243
|
+
const body = renderMcpInstructionsDelta(inp.mcpInstructions.added, inp.mcpInstructions.removed, inp.engineText);
|
|
246
244
|
if (body !== undefined)
|
|
247
245
|
(out ??= []).push({ source: "mcp_instructions", body });
|
|
248
246
|
}
|
|
249
247
|
if (inp.config.mcpInstructions && inp.mcpDroppedTools !== undefined && inp.mcpDroppedTools.length > 0) {
|
|
250
248
|
(out ??= []).push({ source: "mcp_dropped_tools", body: renderMcpDroppedTools(inp.mcpDroppedTools) });
|
|
251
249
|
}
|
|
252
|
-
if (inp.config.changedFiles && inp.changedFiles !== undefined
|
|
253
|
-
const
|
|
254
|
-
if (
|
|
255
|
-
(out ??= []).push(
|
|
256
|
-
}
|
|
250
|
+
if (inp.config.changedFiles && inp.changedFiles !== undefined) {
|
|
251
|
+
const frame = collectChangedFilesAttachment(inp.changedFiles);
|
|
252
|
+
if (frame !== undefined)
|
|
253
|
+
(out ??= []).push(frame);
|
|
257
254
|
}
|
|
258
255
|
if (out === undefined)
|
|
259
256
|
return EMPTY;
|
|
260
257
|
return capAttachments(out);
|
|
261
258
|
}
|
|
259
|
+
export function collectChangedFilesAttachment(changed) {
|
|
260
|
+
if (changed.length === 0)
|
|
261
|
+
return undefined;
|
|
262
|
+
return { source: "changed_files", body: renderChangedFiles(changed.map((c) => c.path)), noticed: changed.map((c) => ({ path: c.path, mtimeMs: c.mtimeMs })) };
|
|
263
|
+
}
|
|
264
|
+
export function collectChangedFilesFirstRequestFrame(changed) {
|
|
265
|
+
const frame = collectChangedFilesAttachment(changed);
|
|
266
|
+
if (frame === undefined)
|
|
267
|
+
return undefined;
|
|
268
|
+
const [capped] = capAttachments([frame]);
|
|
269
|
+
return capped === undefined ? undefined : { ...frame, body: capped.body };
|
|
270
|
+
}
|
|
271
|
+
export function changedFilesNoticeIn(text, block, frame) {
|
|
272
|
+
const at = text.indexOf(block);
|
|
273
|
+
if (at < 0 || frame.noticed === undefined)
|
|
274
|
+
return undefined;
|
|
275
|
+
const tags = attachmentEnvelopeTags("changed_files");
|
|
276
|
+
const files = [];
|
|
277
|
+
let cursor = 0;
|
|
278
|
+
for (const f of frame.noticed) {
|
|
279
|
+
const line = `\n${sanitizeUntrustedText(`- ${f.path}`, tags)}`;
|
|
280
|
+
let found = -1;
|
|
281
|
+
for (let i = block.indexOf(line, cursor); i >= 0; i = block.indexOf(line, i + 1)) {
|
|
282
|
+
if (block[i + line.length] === "\n") {
|
|
283
|
+
found = i;
|
|
284
|
+
break;
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
if (found < 0)
|
|
288
|
+
break;
|
|
289
|
+
files.push({ path: f.path, mtimeMs: f.mtimeMs, start: at + found, end: at + found + line.length });
|
|
290
|
+
cursor = found + line.length;
|
|
291
|
+
}
|
|
292
|
+
return files.length === 0 ? undefined : { start: at, end: at + block.length, files };
|
|
293
|
+
}
|
|
262
294
|
const TODO_REMINDER_BASE = `The TodoWrite tool hasn't been used recently. If you're working on tasks that would benefit from tracking progress, consider using the TodoWrite tool to track progress. Also consider cleaning up the todo list if has become stale and no longer matches what you are working on. Only use it if it's relevant to the current work. This is just a gentle reminder - ignore if not applicable.\n`;
|
|
263
295
|
const TASK_REMINDER_BASE = `The task tools haven't been used recently. If you're working on tasks that would benefit from tracking progress, consider using TaskCreate to add new tasks and TaskUpdate to update task status (set to in_progress when starting, completed when done). Also consider cleaning up the task list if it has become stale. Only use these if relevant to the current work. This is just a gentle reminder - ignore if not applicable.\n`;
|
|
264
296
|
function renderTodoReminder(state) {
|
|
@@ -301,92 +333,6 @@ export function collectDateChange(state, today) {
|
|
|
301
333
|
return undefined;
|
|
302
334
|
return { source: "date_change", body: renderDateChange(today) };
|
|
303
335
|
}
|
|
304
|
-
function shortHash(hash) {
|
|
305
|
-
const colon = hash.indexOf(":");
|
|
306
|
-
const bare = colon >= 0 ? hash.slice(colon + 1) : hash;
|
|
307
|
-
return bare.slice(0, 8) || "unknown";
|
|
308
|
-
}
|
|
309
|
-
function clipInstructionPath(path) {
|
|
310
|
-
if (Buffer.byteLength(path, "utf8") <= 96)
|
|
311
|
-
return path;
|
|
312
|
-
const points = Array.from(path);
|
|
313
|
-
let out = "";
|
|
314
|
-
for (let i = points.length - 1; i >= 0; i--) {
|
|
315
|
-
const next = points[i] + out;
|
|
316
|
-
if (Buffer.byteLength(next, "utf8") > 95)
|
|
317
|
-
break;
|
|
318
|
-
out = next;
|
|
319
|
-
}
|
|
320
|
-
return `…${out}`;
|
|
321
|
-
}
|
|
322
|
-
const INSTRUCTIONS_CHANGE_TAIL_READ = "The snapshot in your context is from session start and has NOT been updated. Read the file if the current content matters to your next steps. Do not mention this notice to the user unless relevant.";
|
|
323
|
-
const INSTRUCTIONS_CHANGE_TAIL_REMOVED = "The snapshot in your context is from session start and has NOT been updated. Do not mention this notice to the user unless relevant.";
|
|
324
|
-
export function collectInstructionsChange(state, probed) {
|
|
325
|
-
if (probed === null)
|
|
326
|
-
return undefined;
|
|
327
|
-
const due = [];
|
|
328
|
-
const seen = new Set();
|
|
329
|
-
for (const p of probed) {
|
|
330
|
-
if (!state.lastAnnouncedHash.has(p.path))
|
|
331
|
-
continue;
|
|
332
|
-
if (seen.has(p.path))
|
|
333
|
-
continue;
|
|
334
|
-
seen.add(p.path);
|
|
335
|
-
const last = state.lastAnnouncedHash.get(p.path);
|
|
336
|
-
if (p.contentHash === last)
|
|
337
|
-
continue;
|
|
338
|
-
due.push({ path: p.path, from: last, to: p.contentHash });
|
|
339
|
-
}
|
|
340
|
-
if (due.length === 0)
|
|
341
|
-
return undefined;
|
|
342
|
-
const line = (d) => d.to === null
|
|
343
|
-
? `- ${clipInstructionPath(d.path)} was removed on disk (hash ${shortHash(d.from ?? "")} → absent)`
|
|
344
|
-
: `- ${clipInstructionPath(d.path)} (hash ${d.from === null ? "absent" : shortHash(d.from)} → ${shortHash(d.to)})`;
|
|
345
|
-
let body;
|
|
346
|
-
let announced;
|
|
347
|
-
if (due.length === 1) {
|
|
348
|
-
const d = due[0];
|
|
349
|
-
body =
|
|
350
|
-
d.to === null
|
|
351
|
-
? `Project instruction file was removed on disk during this session: ${clipInstructionPath(d.path)} (hash ${shortHash(d.from ?? "")} → absent). ${INSTRUCTIONS_CHANGE_TAIL_REMOVED}`
|
|
352
|
-
: `Project instruction file changed on disk during this session: ${clipInstructionPath(d.path)} (hash ${d.from === null ? "absent" : shortHash(d.from)} → ${shortHash(d.to)}). ${INSTRUCTIONS_CHANGE_TAIL_READ}`;
|
|
353
|
-
}
|
|
354
|
-
else {
|
|
355
|
-
const header = "Project instruction files changed on disk during this session:";
|
|
356
|
-
const tail = due.some((d) => d.to !== null) ? INSTRUCTIONS_CHANGE_TAIL_READ.replace("Read the file ", "Read the files ") : INSTRUCTIONS_CHANGE_TAIL_REMOVED;
|
|
357
|
-
const fixed = Buffer.byteLength(`${header}\n\n${tail}`, "utf8");
|
|
358
|
-
const overflowReserve = Buffer.byteLength("\n- (+99 more…)", "utf8");
|
|
359
|
-
let used = fixed;
|
|
360
|
-
const kept = [];
|
|
361
|
-
for (const d of due) {
|
|
362
|
-
const l = line(d);
|
|
363
|
-
const cost = Buffer.byteLength(`\n${l}`, "utf8");
|
|
364
|
-
if (used + cost + (kept.length + 1 < due.length ? overflowReserve : 0) > INSTRUCTIONS_CHANGE_BYTE_CAP)
|
|
365
|
-
break;
|
|
366
|
-
kept.push(d);
|
|
367
|
-
used += cost;
|
|
368
|
-
}
|
|
369
|
-
if (kept.length === 0) {
|
|
370
|
-
const d = due[0];
|
|
371
|
-
body =
|
|
372
|
-
d.to === null
|
|
373
|
-
? `Project instruction file was removed on disk during this session: ${clipInstructionPath(d.path)} (hash ${shortHash(d.from ?? "")} → absent). ${INSTRUCTIONS_CHANGE_TAIL_REMOVED}`
|
|
374
|
-
: `Project instruction file changed on disk during this session: ${clipInstructionPath(d.path)} (hash ${d.from === null ? "absent" : shortHash(d.from)} → ${shortHash(d.to)}). ${INSTRUCTIONS_CHANGE_TAIL_READ}`;
|
|
375
|
-
announced = [{ path: d.path, contentHash: d.to }];
|
|
376
|
-
return { attachment: { source: "instructions_change", body }, announced };
|
|
377
|
-
}
|
|
378
|
-
const more = due.length - kept.length;
|
|
379
|
-
body = `${header}\n${kept.map(line).join("\n")}${more > 0 ? `\n- (+${more} more…)` : ""}\n${tail}`;
|
|
380
|
-
announced = kept.map((d) => ({ path: d.path, contentHash: d.to }));
|
|
381
|
-
return { attachment: { source: "instructions_change", body }, announced };
|
|
382
|
-
}
|
|
383
|
-
announced = due.map((d) => ({ path: d.path, contentHash: d.to }));
|
|
384
|
-
return { attachment: { source: "instructions_change", body }, announced };
|
|
385
|
-
}
|
|
386
|
-
export function commitInstructionsChange(state, announced) {
|
|
387
|
-
for (const a of announced)
|
|
388
|
-
state.lastAnnouncedHash.set(a.path, a.contentHash);
|
|
389
|
-
}
|
|
390
336
|
export function renderBudgetUsd(used, total) {
|
|
391
337
|
return `USD budget: $${used}/$${total}; $${total - used} remaining`;
|
|
392
338
|
}
|
|
@@ -685,25 +631,27 @@ export function commitSkillsListing(state, entries) {
|
|
|
685
631
|
state.announcedSkills = new Map(entries.map((e) => [e.name, e.description]));
|
|
686
632
|
}
|
|
687
633
|
export const MCP_INSTRUCTIONS_MAX_CHARS = 4096;
|
|
688
|
-
export function fenceMcpServerInstructions(server, text) {
|
|
634
|
+
export function fenceMcpServerInstructions(server, text, say = engineTextFor()) {
|
|
689
635
|
const fence = delimitUntrustedWithClip(`MCP server "${server}" instructions`, text, MCP_INSTRUCTIONS_MAX_CHARS);
|
|
690
|
-
return fence.clipped ? `${fence.text}\n${
|
|
636
|
+
return fence.clipped ? `${fence.text}\n${mcpInstructionsTruncationNote(say)}` : fence.text;
|
|
637
|
+
}
|
|
638
|
+
function mcpInstructionsTruncationNote(say) {
|
|
639
|
+
return say("core/engine.mcp-entry-truncated", { max: String(MCP_INSTRUCTIONS_MAX_CHARS) });
|
|
691
640
|
}
|
|
692
|
-
|
|
693
|
-
export function renderMcpInstructionsEntry(entry) {
|
|
641
|
+
export function renderMcpInstructionsEntry(entry, say = engineTextFor()) {
|
|
694
642
|
if (entry.author !== "host")
|
|
695
|
-
return fenceMcpServerInstructions(entry.server, entry.text);
|
|
643
|
+
return fenceMcpServerInstructions(entry.server, entry.text, say);
|
|
696
644
|
const cps = [...entry.text];
|
|
697
|
-
const body = cps.length > MCP_INSTRUCTIONS_MAX_CHARS ? `${cps.slice(0, MCP_INSTRUCTIONS_MAX_CHARS - 1).join("")}…\n${
|
|
645
|
+
const body = cps.length > MCP_INSTRUCTIONS_MAX_CHARS ? `${cps.slice(0, MCP_INSTRUCTIONS_MAX_CHARS - 1).join("")}…\n${mcpInstructionsTruncationNote(say)}` : entry.text;
|
|
698
646
|
return `## ${inlineUntrusted(entry.server, 160)}\n${body}`;
|
|
699
647
|
}
|
|
700
|
-
export function renderMcpInstructionsDelta(added, removed) {
|
|
648
|
+
export function renderMcpInstructionsDelta(added, removed, say = engineTextFor()) {
|
|
701
649
|
const blocks = [];
|
|
702
650
|
if (added.length > 0) {
|
|
703
|
-
blocks.push(
|
|
651
|
+
blocks.push(`${say("core/engine.mcp-header")}\n\n${say("core/engine.mcp-intro")}\n\n${added.map((entry) => renderMcpInstructionsEntry(entry, say)).join("\n\n")}`);
|
|
704
652
|
}
|
|
705
653
|
if (removed.length > 0) {
|
|
706
|
-
blocks.push(
|
|
654
|
+
blocks.push(`${say("core/engine.mcp-disconnected")}\n${removed.join("\n")}`);
|
|
707
655
|
blocks.push(AMBIENT_CONTEXT_NOTE);
|
|
708
656
|
}
|
|
709
657
|
return blocks.length > 0 ? blocks.join("\n\n") : undefined;
|