@sema-agent/core 7.66.0 → 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 +3498 -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 +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
- 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.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -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
|
@@ -27,11 +27,14 @@ export declare const AUTONOMOUS_LOOP_DYNAMIC_SENTINEL = "<<autonomous-loop-dynam
|
|
|
27
27
|
/** Runner-held 上下文 + run-stop 出口,工具工厂闭包捕获(模型触不到)。 */
|
|
28
28
|
export interface SchedulerToolContext {
|
|
29
29
|
/**
|
|
30
|
-
* **会话腿**的越界隔离键(Runner 填 sessionId ??
|
|
31
|
-
* {@link durableScopeOf} 从
|
|
30
|
+
* **会话腿**的越界隔离键(Runner 填 sessionId ?? isolation scope ?? taskId)。durable 腿不用这条链——它的键由
|
|
31
|
+
* {@link durableScopeOf} 从 isolation scope 独立铸(ruled 2026-08-03,见该函数注释)。
|
|
32
32
|
*/
|
|
33
33
|
scope: string;
|
|
34
|
+
/** 任务的人(`TaskSpec.principal`),原样交给宿主 capability;缺 `isolationScope` 时也是 durable 腿的键。 */
|
|
34
35
|
principal?: string;
|
|
36
|
+
/** 任务的 isolation scope(`TaskSpec.isolationScope`):在场时 durable 腿按它铸键(同一人的另一 scope 看不见这条 job)。 */
|
|
37
|
+
isolationScope?: string;
|
|
35
38
|
sessionId?: string;
|
|
36
39
|
taskConfig?: unknown;
|
|
37
40
|
/** `ctx.requestStopAfterTurn`(干净结束本 run 的 runner 原语出口)。design/136 §2.2:Sleep 撤除后本槽位
|
|
@@ -2,6 +2,8 @@ import { Type } from "typebox";
|
|
|
2
2
|
import { defineTool, errorResult } from "../core/tools.js";
|
|
3
3
|
import { hasScheduler, isValidCronExpr, } from "../core/scheduler.js";
|
|
4
4
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
5
|
+
import { isolationScopeOf } from "../core/isolation-scope.js";
|
|
6
|
+
import { envErrorDetail } from "./fs/env-error-detail.js";
|
|
5
7
|
export const SCHEDULE_WAKEUP_TOOL_NAME = "ScheduleWakeup";
|
|
6
8
|
export const AUTONOMOUS_LOOP_SENTINEL = "<<autonomous-loop>>";
|
|
7
9
|
export const AUTONOMOUS_LOOP_DYNAMIC_SENTINEL = "<<autonomous-loop-dynamic>>";
|
|
@@ -31,7 +33,7 @@ The runtime clamps to [60, 3600], so you don't need to clamp yourself.
|
|
|
31
33
|
One short sentence on what you chose and why. Goes to telemetry and is shown back to the user. "watching CI run" beats "waiting." The user reads this to understand what you're doing without having to predict your cadence in advance — make it specific.
|
|
32
34
|
`;
|
|
33
35
|
function durableScopeOf(c) {
|
|
34
|
-
return c
|
|
36
|
+
return isolationScopeOf(c) ?? "default";
|
|
35
37
|
}
|
|
36
38
|
function toSchedulerContext(c, scope) {
|
|
37
39
|
return {
|
|
@@ -296,7 +298,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
|
|
|
296
298
|
const knownIds = before.ok ? new Set(before.value.map((s) => s.id)) : undefined;
|
|
297
299
|
const r = await sched.schedule(intent, opCtx);
|
|
298
300
|
if (!r.ok)
|
|
299
|
-
return errorResult(`Error (CronCreate): ${r.error.message}`);
|
|
301
|
+
return errorResult(`Error (CronCreate): ${envErrorDetail(r.error.message)}`);
|
|
300
302
|
const replaced = knownIds?.has(r.value.id);
|
|
301
303
|
const afterList = await withinReadBudget(() => sched.list(opCtx), signal);
|
|
302
304
|
const nextFireAt = afterList?.ok === true ? nextFireAtOf(afterList.value.find((s) => s.id === r.value.id)) : undefined;
|
|
@@ -356,7 +358,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
|
|
|
356
358
|
if (!r.ok) {
|
|
357
359
|
if (r.error.code === "not_found")
|
|
358
360
|
return `CronDelete: no scheduled task "${id}" (already gone or not yours).`;
|
|
359
|
-
return errorResult(`Error (CronDelete): ${r.error.message}`);
|
|
361
|
+
return errorResult(`Error (CronDelete): ${envErrorDetail(r.error.message)}`);
|
|
360
362
|
}
|
|
361
363
|
return { content: `Cancelled scheduled task ${id}.`, details: { type: "cron-delete", id } };
|
|
362
364
|
},
|
|
@@ -373,7 +375,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
|
|
|
373
375
|
for (const lane of lanesDiffer ? [sessionCtx, durableCtx] : [sessionCtx]) {
|
|
374
376
|
const listed = await sched.list(lane);
|
|
375
377
|
if (!listed.ok)
|
|
376
|
-
return errorResult(`Error (CronList): ${listed.error.message}`);
|
|
378
|
+
return errorResult(`Error (CronList): ${envErrorDetail(listed.error.message)}`);
|
|
377
379
|
for (const s of listed.value) {
|
|
378
380
|
if (seen.has(s.id))
|
|
379
381
|
continue;
|
|
@@ -415,7 +417,7 @@ Only use minute 0 or 30 when the user names that exact time and clearly means it
|
|
|
415
417
|
const listPendingWakeups = async () => {
|
|
416
418
|
const r = await sched.list(sessionCtx);
|
|
417
419
|
if (!r.ok)
|
|
418
|
-
return { err: r.error.message };
|
|
420
|
+
return { err: envErrorDetail(r.error.message) };
|
|
419
421
|
return {
|
|
420
422
|
ids: r.value
|
|
421
423
|
.filter((s) => s.mode === "session-wakeup" || (s.mode === undefined && s.label === WAKEUP_LABEL))
|
|
@@ -503,7 +505,7 @@ MOUNT NOTE: this host does not vouch for session-scoped scheduling, so a wakeup
|
|
|
503
505
|
...(sessionReapVouched ? { lifetime: "session" } : {}),
|
|
504
506
|
}, sessionCtx);
|
|
505
507
|
if (!r.ok)
|
|
506
|
-
return errorResult(`Error (${SCHEDULE_WAKEUP_TOOL_NAME}): ${r.error.message}`);
|
|
508
|
+
return errorResult(`Error (${SCHEDULE_WAKEUP_TOOL_NAME}): ${envErrorDetail(r.error.message)}`);
|
|
507
509
|
const scheduledFor = Date.now() + clampedDelaySeconds * 1000;
|
|
508
510
|
const hhmmss = new Date(scheduledFor).toTimeString().slice(0, 8);
|
|
509
511
|
const clampNote = wasClamped ? ` (clamped to ${clampedDelaySeconds}s from your requested value)` : "";
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { ToolSpec } from "../core/types.js";
|
|
2
|
+
import { type DamagedRowVerdict } from "../core/row-shape.js";
|
|
2
3
|
/**
|
|
3
4
|
* design/119 — the structured task-list tool family: `TaskCreate` / `TaskGet` /
|
|
4
5
|
* `TaskUpdate` / `TaskList`. The upgrade path over TodoWrite: individual tasks with stable ids,
|
|
@@ -20,17 +21,54 @@ import type { ToolSpec } from "../core/types.js";
|
|
|
20
21
|
* trust domain — the list is model scratch either way, sharing adds no egress). The `owner` field's
|
|
21
22
|
* teammate-assignment semantics (trimmed in the 198 port) come back through this seam.
|
|
22
23
|
*/
|
|
24
|
+
/** A task's status words (closed; a stored entry's `status` is read against it). */
|
|
25
|
+
export declare const TASK_LIST_STATUSES: readonly ["pending", "in_progress", "completed"];
|
|
23
26
|
export interface TaskListItem {
|
|
24
27
|
id: string;
|
|
25
28
|
subject: string;
|
|
26
29
|
description: string;
|
|
27
30
|
activeForm?: string;
|
|
28
31
|
owner?: string;
|
|
29
|
-
status:
|
|
32
|
+
status: (typeof TASK_LIST_STATUSES)[number];
|
|
30
33
|
blocks: string[];
|
|
31
34
|
blockedBy: string[];
|
|
32
35
|
metadata?: Record<string, unknown>;
|
|
33
36
|
}
|
|
37
|
+
/** An entry of a task list that does not read as {@link TASK_LIST_ITEM_ROW_SHAPE}: the id the list files it under and its verdict.
|
|
38
|
+
* {@link TaskListStore.list} answers it in place of the item; it counts as open (it still blocks what depends on it). */
|
|
39
|
+
export interface DamagedTaskListItem {
|
|
40
|
+
readonly id: string;
|
|
41
|
+
readonly rowVerdict: DamagedRowVerdict;
|
|
42
|
+
}
|
|
43
|
+
/** One entry of {@link TaskListStore.list}: an item, or a damaged entry (narrow with `"rowVerdict" in entry`). */
|
|
44
|
+
export type TaskListEntry = TaskListItem | DamagedTaskListItem;
|
|
45
|
+
/** The refusal code of a task entry that does not read (`get`, an update of it, an edge to it) or a write whose item does not. */
|
|
46
|
+
export declare const TASK_LIST_ROW_MALFORMED_CODE = "task_list.row_malformed";
|
|
47
|
+
/** Typed task-list store error so callers branch on `code`. */
|
|
48
|
+
export declare class TaskListStoreError extends Error {
|
|
49
|
+
readonly code: typeof TASK_LIST_ROW_MALFORMED_CODE;
|
|
50
|
+
constructor(code: typeof TASK_LIST_ROW_MALFORMED_CODE, message: string);
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* THE TASK ENTRY'S MEMBER-SHAPE TABLE (`rowShapeReader`, row-shape.ts). An entry has no row predicate of its own — it is filed under
|
|
54
|
+
* its id in the list (`tasks[id]`), and the list document's own shape is its store's container judgment. `members` is what the
|
|
55
|
+
* tools read: the id (equal to the key it is filed under), subject, description, status word, the optional active form and owner,
|
|
56
|
+
* the dependency lists — whose ABSENCE reads as no dependencies (`[]`, in a read and a write alike) and which, present, are lists of
|
|
57
|
+
* task ids — and the metadata ({@link jsonMetadataProblem}). Exit `list-damaged`: a listing answers such an entry by its id, it
|
|
58
|
+
* counts as open, `get` and every update of it refuse in {@link TASK_LIST_ROW_MALFORMED_CODE}, and deletion by its id goes on.
|
|
59
|
+
*/
|
|
60
|
+
export declare const TASK_LIST_ITEM_ROW_SHAPE: import("../core/row-shape.js").RowShapeReader<TaskListItem>;
|
|
61
|
+
/**
|
|
62
|
+
* A stored entry as every reader reads it: the item (absent dependency lists read as `[]`), or the refusal
|
|
63
|
+
* ({@link TASK_LIST_ROW_MALFORMED_CODE}) of one that does not read, told to `disclose` first. A store's `get` goes through this.
|
|
64
|
+
*/
|
|
65
|
+
export declare function readStoredTaskListItem(raw: unknown, id: string, disclose?: (sentence: string) => void): TaskListItem;
|
|
66
|
+
/** One stored entry as a listing answers it: the item, or — an entry that does not read — its id and verdict (told to `disclose`). */
|
|
67
|
+
export declare function listStoredTaskListEntry(raw: unknown, id: string, disclose?: (sentence: string) => void): TaskListEntry;
|
|
68
|
+
/** A write's item held to {@link TASK_LIST_ITEM_ROW_SHAPE} (its metadata refused first by {@link assertJsonMetadata}): the item to
|
|
69
|
+
* store — absent dependency lists stored as `[]` — or the refusal before anything is written. A dependency list that is present
|
|
70
|
+
* and not a list of ids is refused. */
|
|
71
|
+
export declare function admitTaskListItem(item: TaskListItem, id: string): TaskListItem;
|
|
34
72
|
/**
|
|
35
73
|
* design/147 §6 D2 — the task-list persistence seam (storage-tier abstraction, same family as
|
|
36
74
|
* `RosterStore`/checkpoint store: core bundles a memory implementation; a deployment plugs pg/file
|
|
@@ -50,6 +88,11 @@ export interface TaskListItem {
|
|
|
50
88
|
* rows survive makes every receipt lie and every subsequent update miss).
|
|
51
89
|
* - Value semantics: `get`/`list` return detached copies; `set` stores a detached copy. Callers
|
|
52
90
|
* mutate their copy and write it back — a live-reference store would alias already-emitted events.
|
|
91
|
+
* - ENTRY SHAPE ({@link TASK_LIST_ITEM_ROW_SHAPE}, the one reading every backend makes): `set` stores the item the table admits —
|
|
92
|
+
* absent dependency lists stored as `[]`, a present one that is not a list of ids refused — or refuses it
|
|
93
|
+
* ({@link TASK_LIST_ROW_MALFORMED_CODE}) before anything is written. A stored entry that does not read (another writer's, an
|
|
94
|
+
* earlier release's) is `list`ed as a {@link DamagedTaskListItem} — its id and verdict — in its place, and `get` of it refuses in
|
|
95
|
+
* the same code; `delete` removes it by its id. The tools count such an entry as open, so it keeps blocking what depends on it.
|
|
53
96
|
* - RB-274: `list` is ordered by ID (numeric ascending), not by write order. The tool lane always
|
|
54
97
|
* allocates before it sets, so the two coincide there — but a store shared with an OUTSIDE writer
|
|
55
98
|
* (a real CC instance on the same directory) can set an id out of order, and then the backends
|
|
@@ -64,7 +107,7 @@ export interface TaskListStore {
|
|
|
64
107
|
get(id: string): TaskListItem | undefined | Promise<TaskListItem | undefined>;
|
|
65
108
|
set(id: string, item: TaskListItem): void | Promise<void>;
|
|
66
109
|
delete(id: string): boolean | Promise<boolean>;
|
|
67
|
-
list():
|
|
110
|
+
list(): TaskListEntry[] | Promise<TaskListEntry[]>;
|
|
68
111
|
allocateId(): string | Promise<string>;
|
|
69
112
|
/** the transaction boundary for adapters whose backend outlives one wrapper
|
|
70
113
|
* instance (pg, shared files): when present, the tools run EVERY read-modify-write sequence
|
|
@@ -76,24 +119,10 @@ export interface TaskListStore {
|
|
|
76
119
|
}
|
|
77
120
|
/** the clone policy behind the detached-copy contract: metadata must be JSON-shaped
|
|
78
121
|
* (structuredClone would accept — and SHARE — SharedArrayBuffer backing memory, and throws opaquely
|
|
79
|
-
* on functions/proxies; the tool lane is always JSON, so this guards DIRECT store users).
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
* The in-memory store rejected such a row incidentally: its snapshot helper spreads `t.blocks`, so a
|
|
84
|
-
* missing array threw "blocks is not iterable" at write. The file store had no such accident and wrote the
|
|
85
|
-
* row to disk, where it survived until `TaskUpdate` reached `t.blocks.includes(...)` — a contaminated row that
|
|
86
|
-
* passes the write and detonates at an unrelated later call, in a different session, with no trace of where
|
|
87
|
-
* it came from. Two backends disagreeing about what a valid row is means a test written against one has
|
|
88
|
-
* different semantics on the other.
|
|
89
|
-
*
|
|
90
|
-
* NORMALIZE rather than reject: the harm is a stored row that EXPLODES AT READ, not an incomplete one.
|
|
91
|
-
* Defaulting the arrays removes the harm without inventing a new failure mode for callers that legitimately
|
|
92
|
-
* write a partial row (a task with no dependencies has empty arrays — that is what the absence meant).
|
|
93
|
-
* Rejecting instead would have been a behaviour change dressed as a fix: the first attempt did exactly that
|
|
94
|
-
* and broke an in-tree test whose subject was id allocation, not row shape.
|
|
95
|
-
*/
|
|
96
|
-
export declare function normalizeTaskShape<T>(item: T): T;
|
|
122
|
+
* on functions/proxies; the tool lane is always JSON, so this guards DIRECT store users). The answer form:
|
|
123
|
+
* `undefined` = JSON-shaped, else the refusal's sentence naming the first member that is not. */
|
|
124
|
+
export declare function jsonMetadataProblem(value: unknown, path?: string): string | undefined;
|
|
125
|
+
/** {@link jsonMetadataProblem} as the write-time refusal (a store twin calls it before persisting). */
|
|
97
126
|
export declare function assertJsonMetadata(value: unknown, path?: string): void;
|
|
98
127
|
/**
|
|
99
128
|
* RB-274 — the contract's `list` order: numeric ids ascending (CC's own task order), any non-numeric id
|
package/dist/tools/task-list.js
CHANGED
|
@@ -1,5 +1,67 @@
|
|
|
1
1
|
import { Type } from "typebox";
|
|
2
2
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
3
|
+
import { absentReads, isListOf, isRowCorrupt, isString, isWord, optional, pair, required, rowShapeReader, takesExit } from "../core/row-shape.js";
|
|
4
|
+
export const TASK_LIST_STATUSES = Object.freeze(["pending", "in_progress", "completed"]);
|
|
5
|
+
export const TASK_LIST_ROW_MALFORMED_CODE = "task_list.row_malformed";
|
|
6
|
+
export class TaskListStoreError extends Error {
|
|
7
|
+
code;
|
|
8
|
+
constructor(code, message) {
|
|
9
|
+
super(message);
|
|
10
|
+
this.code = code;
|
|
11
|
+
this.name = "TaskListStoreError";
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
const isJsonMetadata = (v) => (jsonMetadataProblem(v) === undefined ? undefined : "is not JSON-serializable");
|
|
15
|
+
export const TASK_LIST_ITEM_ROW_SHAPE = rowShapeReader({
|
|
16
|
+
family: "task-list",
|
|
17
|
+
code: TASK_LIST_ROW_MALFORMED_CODE,
|
|
18
|
+
sentence: "This task list holds an entry that does not read the way this engine reads a task — it was written by another writer or an earlier release, or changed in storage. It stays as stored: it is listed as unreadable and counts as open (it still blocks the tasks that depend on it); it cannot be read or updated here, and it can be deleted.",
|
|
19
|
+
exit: "list-damaged",
|
|
20
|
+
segments: [
|
|
21
|
+
{
|
|
22
|
+
name: "members",
|
|
23
|
+
entries: [
|
|
24
|
+
required("id", isString),
|
|
25
|
+
pair("id", (r, ctx) => (r.id === ctx.key ? undefined : "its id is not the key the list files it under")),
|
|
26
|
+
pair("rowVerdict", (r) => (Object.hasOwn(r, "rowVerdict") ? "it carries rowVerdict, the member a listing reserves for an entry that does not read" : undefined)),
|
|
27
|
+
required("subject", isString),
|
|
28
|
+
required("description", isString),
|
|
29
|
+
required("status", isWord(TASK_LIST_STATUSES)),
|
|
30
|
+
optional("activeForm", isString),
|
|
31
|
+
optional("owner", isString),
|
|
32
|
+
absentReads("blocks", () => [], isListOf(isString)),
|
|
33
|
+
absentReads("blockedBy", () => [], isListOf(isString)),
|
|
34
|
+
optional("metadata", isJsonMetadata),
|
|
35
|
+
],
|
|
36
|
+
},
|
|
37
|
+
],
|
|
38
|
+
});
|
|
39
|
+
function taskListRefusal(corrupt) {
|
|
40
|
+
return new TaskListStoreError(TASK_LIST_ROW_MALFORMED_CODE, TASK_LIST_ITEM_ROW_SHAPE.refusalText(corrupt));
|
|
41
|
+
}
|
|
42
|
+
export function readStoredTaskListItem(raw, id, disclose) {
|
|
43
|
+
const answer = TASK_LIST_ITEM_ROW_SHAPE.read(raw, { key: id });
|
|
44
|
+
if (!isRowCorrupt(answer))
|
|
45
|
+
return answer.row;
|
|
46
|
+
disclose?.(`task #${id}: ${answer.why} — refused in ${TASK_LIST_ROW_MALFORMED_CODE}`);
|
|
47
|
+
throw taskListRefusal(answer);
|
|
48
|
+
}
|
|
49
|
+
export function listStoredTaskListEntry(raw, id, disclose) {
|
|
50
|
+
const answer = TASK_LIST_ITEM_ROW_SHAPE.read(raw, { key: id });
|
|
51
|
+
if (!isRowCorrupt(answer))
|
|
52
|
+
return answer.row;
|
|
53
|
+
takesExit(answer, "list-damaged", "task list listing");
|
|
54
|
+
disclose?.(`task #${id}: ${answer.why} — listed as unreadable`);
|
|
55
|
+
return { id, rowVerdict: TASK_LIST_ITEM_ROW_SHAPE.damagedVerdict(answer) };
|
|
56
|
+
}
|
|
57
|
+
export function admitTaskListItem(item, id) {
|
|
58
|
+
if (item.metadata)
|
|
59
|
+
assertJsonMetadata(item.metadata);
|
|
60
|
+
const answer = TASK_LIST_ITEM_ROW_SHAPE.admit(item, { key: id });
|
|
61
|
+
if (isRowCorrupt(answer))
|
|
62
|
+
throw taskListRefusal(answer);
|
|
63
|
+
return answer.row;
|
|
64
|
+
}
|
|
3
65
|
const STATUS = Type.Union([
|
|
4
66
|
Type.Literal("pending"),
|
|
5
67
|
Type.Literal("in_progress"),
|
|
@@ -22,39 +84,41 @@ function renderTask(t) {
|
|
|
22
84
|
.join("\n");
|
|
23
85
|
}
|
|
24
86
|
function snapTask(t) {
|
|
25
|
-
|
|
26
|
-
return { ...n, blocks: [...n.blocks], blockedBy: [...n.blockedBy], ...(n.metadata ? { metadata: structuredClone(n.metadata) } : {}) };
|
|
87
|
+
return { ...t, blocks: [...t.blocks], blockedBy: [...t.blockedBy], ...(t.metadata ? { metadata: structuredClone(t.metadata) } : {}) };
|
|
27
88
|
}
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
if (!Array.isArray(t.blocks) || !Array.isArray(t.blockedBy)) {
|
|
31
|
-
return {
|
|
32
|
-
...item,
|
|
33
|
-
blocks: Array.isArray(t.blocks) ? t.blocks : [],
|
|
34
|
-
blockedBy: Array.isArray(t.blockedBy) ? t.blockedBy : [],
|
|
35
|
-
};
|
|
36
|
-
}
|
|
37
|
-
return item;
|
|
89
|
+
function snapEntry(e) {
|
|
90
|
+
return "rowVerdict" in e ? { id: e.id, rowVerdict: e.rowVerdict } : snapTask(e);
|
|
38
91
|
}
|
|
39
|
-
export function
|
|
92
|
+
export function jsonMetadataProblem(value, path = "metadata") {
|
|
40
93
|
if (value === null)
|
|
41
|
-
return;
|
|
94
|
+
return undefined;
|
|
42
95
|
const t = typeof value;
|
|
43
96
|
if (t === "string" || t === "number" || t === "boolean")
|
|
44
|
-
return;
|
|
97
|
+
return undefined;
|
|
45
98
|
if (Array.isArray(value)) {
|
|
46
|
-
|
|
47
|
-
|
|
99
|
+
for (let i = 0; i < value.length; i++) {
|
|
100
|
+
const problem = jsonMetadataProblem(value[i], `${path}[${i}]`);
|
|
101
|
+
if (problem !== undefined)
|
|
102
|
+
return problem;
|
|
103
|
+
}
|
|
104
|
+
return undefined;
|
|
48
105
|
}
|
|
49
106
|
if (t === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)) {
|
|
50
107
|
for (const [k, v] of Object.entries(value)) {
|
|
51
108
|
if (v === undefined)
|
|
52
109
|
continue;
|
|
53
|
-
|
|
110
|
+
const problem = jsonMetadataProblem(v, `${path}.${k}`);
|
|
111
|
+
if (problem !== undefined)
|
|
112
|
+
return problem;
|
|
54
113
|
}
|
|
55
|
-
return;
|
|
114
|
+
return undefined;
|
|
56
115
|
}
|
|
57
|
-
|
|
116
|
+
return `Task ${path} must be JSON-serializable (found ${t === "object" ? "non-plain object" : t}).`;
|
|
117
|
+
}
|
|
118
|
+
export function assertJsonMetadata(value, path = "metadata") {
|
|
119
|
+
const problem = jsonMetadataProblem(value, path);
|
|
120
|
+
if (problem !== undefined)
|
|
121
|
+
throw new Error(problem);
|
|
58
122
|
}
|
|
59
123
|
export function compareTaskIds(a, b) {
|
|
60
124
|
const num = (id) => (/^\d+$/.test(id) ? Number.parseInt(id, 10) : Number.NaN);
|
|
@@ -73,15 +137,13 @@ export function createMemoryTaskListStore() {
|
|
|
73
137
|
return {
|
|
74
138
|
get: (id) => {
|
|
75
139
|
const t = tasks.get(id);
|
|
76
|
-
return t ? snapTask(t) : undefined;
|
|
140
|
+
return t ? snapTask(readStoredTaskListItem(t, id)) : undefined;
|
|
77
141
|
},
|
|
78
142
|
set: (id, item) => {
|
|
79
|
-
|
|
80
|
-
assertJsonMetadata(item.metadata);
|
|
81
|
-
tasks.set(id, snapTask(item));
|
|
143
|
+
tasks.set(id, snapTask(admitTaskListItem(item, id)));
|
|
82
144
|
},
|
|
83
145
|
delete: (id) => tasks.delete(id),
|
|
84
|
-
list: () => [...tasks.
|
|
146
|
+
list: () => [...tasks.entries()].sort(([a], [b]) => compareTaskIds(a, b)).map(([id, t]) => snapEntry(listStoredTaskListEntry(t, id))),
|
|
85
147
|
allocateId: () => String(nextId++),
|
|
86
148
|
};
|
|
87
149
|
}
|
|
@@ -290,19 +352,28 @@ export function createTaskListTools(store) {
|
|
|
290
352
|
execute: (args) => serialized(tasks, async (tx) => {
|
|
291
353
|
const a = args;
|
|
292
354
|
const id = String(a.taskId);
|
|
293
|
-
const
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
if (a.ifOwnerIs !== undefined) {
|
|
355
|
+
const notFound = () => new Error(`Task #${id} not found.`);
|
|
356
|
+
const guardOwner = (t) => {
|
|
357
|
+
if (a.ifOwnerIs === undefined)
|
|
358
|
+
return;
|
|
298
359
|
const match = a.ifOwnerIs === null ? t.owner === undefined : t.owner === a.ifOwnerIs;
|
|
299
360
|
if (!match) {
|
|
300
361
|
throw new Error(`Task #${id} owner guard failed: task is ${t.owner === undefined ? "unowned" : `owned by "${t.owner}"`}.`);
|
|
301
362
|
}
|
|
302
|
-
}
|
|
363
|
+
};
|
|
303
364
|
if (a.status === "deleted") {
|
|
304
|
-
|
|
305
|
-
|
|
365
|
+
const entries = await tx.list();
|
|
366
|
+
const target = entries.find((e) => e.id === id);
|
|
367
|
+
if (!target)
|
|
368
|
+
throw notFound();
|
|
369
|
+
if ("rowVerdict" in target) {
|
|
370
|
+
if (a.ifOwnerIs !== undefined)
|
|
371
|
+
await tx.get(id);
|
|
372
|
+
}
|
|
373
|
+
else
|
|
374
|
+
guardOwner(target);
|
|
375
|
+
for (const other of entries) {
|
|
376
|
+
if (other.id === id || "rowVerdict" in other)
|
|
306
377
|
continue;
|
|
307
378
|
const blocks = other.blocks.filter((x) => x !== id);
|
|
308
379
|
const blockedBy = other.blockedBy.filter((x) => x !== id);
|
|
@@ -313,6 +384,13 @@ export function createTaskListTools(store) {
|
|
|
313
384
|
await tx.delete(id);
|
|
314
385
|
return { content: `Task #${id} deleted.`, details: { type: "task", deleted: id } };
|
|
315
386
|
}
|
|
387
|
+
const t = await tx.get(id);
|
|
388
|
+
if (!t)
|
|
389
|
+
throw notFound();
|
|
390
|
+
guardOwner(t);
|
|
391
|
+
for (const b of [...(a.addBlocks ?? []), ...(a.addBlockedBy ?? [])])
|
|
392
|
+
if (b !== id)
|
|
393
|
+
await tx.get(b);
|
|
316
394
|
if (a.status)
|
|
317
395
|
t.status = a.status;
|
|
318
396
|
if (a.subject !== undefined)
|
|
@@ -427,15 +505,17 @@ export function createTaskListTools(store) {
|
|
|
427
505
|
if (all.length === 0) {
|
|
428
506
|
return { content: "The task list is empty.", details: { type: "task-list", tasks: [] } };
|
|
429
507
|
}
|
|
430
|
-
const openIds = new Set(all.filter((x) => x.status !== "completed").map((x) => x.id));
|
|
508
|
+
const openIds = new Set(all.filter((x) => "rowVerdict" in x || x.status !== "completed").map((x) => x.id));
|
|
431
509
|
const lines = all.map((t) => {
|
|
510
|
+
if ("rowVerdict" in t)
|
|
511
|
+
return `#${t.id} [unreadable]`;
|
|
432
512
|
const liveBlockers = t.blockedBy.filter((b) => openIds.has(b));
|
|
433
513
|
return `#${t.id} [${t.status}] ${t.subject}${t.owner ? ` (owner: ${t.owner})` : ""}${liveBlockers.length ? ` (blocked by: ${liveBlockers.join(", ")})` : ""}`;
|
|
434
514
|
});
|
|
435
515
|
const open = openIds.size;
|
|
436
516
|
return {
|
|
437
517
|
content: `${lines.join("\n")}\n(${all.length} total, ${open} open)`,
|
|
438
|
-
details: { type: "task-list", tasks: all.map(
|
|
518
|
+
details: { type: "task-list", tasks: all.map(snapEntry) },
|
|
439
519
|
};
|
|
440
520
|
}),
|
|
441
521
|
};
|
package/dist/tools/web.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { RunnerDeps, ToolSpec } from "../core/types.js";
|
|
2
2
|
import { type HostFloor } from "../core/host-floor.js";
|
|
3
3
|
import type { Model } from "../internal/llm.js";
|
|
4
4
|
/** WebFetch's factory options. Which hosts it may reach is not one of them: that is the deployment's host floor (`RunnerDeps.hostFloor`),
|
|
@@ -161,9 +161,14 @@ export interface WebFetchSummarizerOptions {
|
|
|
161
161
|
headers?: Record<string, string>;
|
|
162
162
|
} | undefined;
|
|
163
163
|
}
|
|
164
|
+
/**
|
|
165
|
+
* The seat a summarizer is built over: `RunnerDeps`' own two members for the model lane — the deployment's `brain` and the
|
|
166
|
+
* `modelFallback` policy the lane walks a catalog entry's `fallbacks` chain on (absent ⇒ the default gate).
|
|
167
|
+
*/
|
|
168
|
+
export type WebFetchSummarizerSeat = Pick<RunnerDeps, "brain" | "modelFallback">;
|
|
164
169
|
/**
|
|
165
170
|
* A reference {@link WebFetchConfig.summarize} implementation: reuses a
|
|
166
|
-
* caller-supplied
|
|
171
|
+
* caller-supplied brain seat (rather than requiring a dedicated second model) to extract a focused answer
|
|
167
172
|
* from fetched content per the caller's `prompt`, instead of the tool dumping the whole (fenced, still
|
|
168
173
|
* untrusted) page. CC ALWAYS routes fetched content through a secondary model this way
|
|
169
174
|
* (WebFetchTool/utils.ts:484-530); a deployment that omits `summarize` entirely gets `webFetchToolSpec`'s
|
|
@@ -177,8 +182,13 @@ export interface WebFetchSummarizerOptions {
|
|
|
177
182
|
* previously a private copy inside this package's own `sema-tb` CLI entry point, promoted here so other
|
|
178
183
|
* deployments (a server assembling `WebFetchConfig` for its own scenarios, for one) can reuse it directly
|
|
179
184
|
* rather than re-deriving it from source.
|
|
185
|
+
*
|
|
186
|
+
* The request goes out on the engine's model lane, like every other model call the engine makes: when `model` is a
|
|
187
|
+
* catalog entry with a `fallbacks` chain, a failure the seat's `modelFallback` gate admits moves the request to the next
|
|
188
|
+
* entry, and the summary is that entry's text. The seat is read once, here — a member it does not take, a `brain` that is
|
|
189
|
+
* not a Brain and a bad `modelFallback` are refused when the summarizer is built, not on the first page.
|
|
180
190
|
*/
|
|
181
|
-
export declare function createWebFetchSummarizer(
|
|
191
|
+
export declare function createWebFetchSummarizer(seat: WebFetchSummarizerSeat, model: Model, options?: WebFetchSummarizerOptions): (content: string, prompt: string, signal?: AbortSignal) => Promise<string | {
|
|
182
192
|
text: string;
|
|
183
193
|
truncated?: boolean;
|
|
184
194
|
inputTruncated?: boolean;
|
package/dist/tools/web.js
CHANGED
|
@@ -11,7 +11,11 @@ import { DEFAULT_CHARS_PER_TOKEN } from "../internal/harness.js";
|
|
|
11
11
|
import { binaryMagicFormat } from "./fs/safety.js";
|
|
12
12
|
import { pdfMagicMatches } from "../core/image-admission.js";
|
|
13
13
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
14
|
-
import { thrownText } from "../core/thrown-value.js";
|
|
14
|
+
import { codedRefusal, thrownText } from "../core/thrown-value.js";
|
|
15
|
+
import { optionKeys, receiptRefusal, receiveMembers } from "../core/own-property-receipt.js";
|
|
16
|
+
import { modelLaneBrainOf } from "../core/runner/model-lane-seat.js";
|
|
17
|
+
import { completeOf } from "../brain/brain-faces.js";
|
|
18
|
+
import { isBrain } from "../brain/routing.js";
|
|
15
19
|
const MAX_REDIRECTS = 10;
|
|
16
20
|
const MAX_URL_LENGTH = 2048;
|
|
17
21
|
const WEBFETCH_ACCEPT = "text/markdown, text/html, */*";
|
|
@@ -691,7 +695,16 @@ export function resolveSummaryInputChars(model, override) {
|
|
|
691
695
|
const derived = Math.floor(inputTokens * charsPerToken * WEBFETCH_SUMMARY_INPUT_HEADROOM);
|
|
692
696
|
return Math.min(WEBFETCH_SUMMARY_MAX_CONTENT, Math.max(WEBFETCH_SUMMARY_MIN_CONTENT, derived));
|
|
693
697
|
}
|
|
694
|
-
|
|
698
|
+
const SUMMARIZER_SEAT_KEYS = optionKeys()({ brain: 0, modelFallback: 0 });
|
|
699
|
+
export function createWebFetchSummarizer(seat, model, options = {}) {
|
|
700
|
+
if (typeof seat !== "object" || seat === null) {
|
|
701
|
+
throw receiptRefusal("createWebFetchSummarizer's seat must be a record of `brain` and (optionally) `modelFallback` — refused when the summarizer is built rather than wired without a Brain");
|
|
702
|
+
}
|
|
703
|
+
const held = receiveMembers(seat, { subject: "createWebFetchSummarizer's seat", unit: "member", moment: "when the summarizer is built" }, SUMMARIZER_SEAT_KEYS);
|
|
704
|
+
if (!isBrain(held.brain)) {
|
|
705
|
+
throw receiptRefusal("createWebFetchSummarizer's seat.brain is absent or is not a Brain (an object with a `stream` function) — refused when the summarizer is built rather than wired without one");
|
|
706
|
+
}
|
|
707
|
+
const complete = completeOf(modelLaneBrainOf(held));
|
|
695
708
|
const maxContentChars = resolveSummaryInputChars(model, options.maxContentChars);
|
|
696
709
|
return async (content, prompt, signal) => {
|
|
697
710
|
const promptOverflow = Math.max(0, prompt.length - SUMMARY_PROMPT_ALLOWANCE_CHARS);
|
|
@@ -706,9 +719,7 @@ export function createWebFetchSummarizer(brain, model, options = {}) {
|
|
|
706
719
|
...(auth?.apiKey !== undefined ? { apiKey: auth.apiKey } : {}),
|
|
707
720
|
...(auth?.headers !== undefined ? { headers: auth.headers } : {}),
|
|
708
721
|
};
|
|
709
|
-
const msg =
|
|
710
|
-
? await brain.complete(model, context, callOptions)
|
|
711
|
-
: await (await Promise.resolve(brain.stream(model, context, callOptions))).result();
|
|
722
|
+
const msg = await complete(model, context, callOptions);
|
|
712
723
|
if (msg.stopReason === "error" || msg.stopReason === "aborted") {
|
|
713
724
|
throw new Error(msg.errorMessage ?? `summarizer stopped with ${msg.stopReason}`);
|
|
714
725
|
}
|
|
@@ -984,7 +995,7 @@ export function createSearxngSearchBackend(baseUrl, options = {}) {
|
|
|
984
995
|
const timeout = AbortSignal.timeout(timeoutMs);
|
|
985
996
|
const followed = await fetchFollowing(doFetch, url, { method: "GET", headers: { accept: "application/json" }, signal: signal ? AbortSignal.any([signal, timeout]) : timeout }, { refusal: (hop) => hopRefusal(hop, opts?.hostFloor, false), follows: () => true, maxRedirects: SEARXNG_MAX_REDIRECTS });
|
|
986
997
|
if (followed.kind === "refused")
|
|
987
|
-
throw
|
|
998
|
+
throw codedRefusal(HOST_FLOOR_REFUSED_CODE, `SearXNG request is not sent — ${followed.reason}`);
|
|
988
999
|
if (followed.kind === "too_many")
|
|
989
1000
|
throw new Error(`SearXNG was redirected more than ${SEARXNG_MAX_REDIRECTS} times`);
|
|
990
1001
|
const res = followed.res;
|
package/dist/tools/worktree.d.ts
CHANGED
|
@@ -15,8 +15,9 @@
|
|
|
15
15
|
* M22 RESOLVED, live-CC anchor 2026-07-09: the previous worktree is left on disk untouched, only the
|
|
16
16
|
* new one is tracked for exit-time cleanup, and a path-entered tree is NEVER removed by ExitWorktree);
|
|
17
17
|
* ④ ExitWorktree outside a session is an honest NO-OP (CC errorCode 1), and a worktree with
|
|
18
|
-
* uncommitted files or commits is NOT deleted by default (CC refuses `remove` without
|
|
19
|
-
* `discard_changes`; sema keeps it and reports the path — inspect/merge in userland
|
|
18
|
+
* uncommitted files, files git ignores, or commits is NOT deleted by default (CC refuses `remove` without
|
|
19
|
+
* `discard_changes`; sema keeps it and reports the path — inspect/merge in userland; the ignored-files arm is sema's
|
|
20
|
+
* own: CC counts `status --porcelain` and commits only);
|
|
20
21
|
* ⑤ outside a git repository CC delegates to WorktreeCreate/WorktreeRemove hooks — sema has no such
|
|
21
22
|
* shell extension point, so the tool says so honestly and refuses (no silent degrade).
|
|
22
23
|
*
|
package/dist/tools/worktree.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { resolve } from "node:path";
|
|
2
2
|
import { Type } from "typebox";
|
|
3
3
|
import { defineTool, errorResult } from "../core/tools.js";
|
|
4
|
-
import { addWorktree, managedTreeAt, managedWorktreeBaseOf, pruneWorktrees, removeManagedWorktree, resolveBaseCommit, worktreeNameProblem, WORKTREE_PARENT } from "../core/git-worktree-env.js";
|
|
4
|
+
import { addWorktree, keptByHolds, managedTreeAt, managedWorktreeBaseOf, namedIgnored, pruneWorktrees, removeManagedWorktree, resolveBaseCommit, treeHoldsOf, worktreeNameProblem, WORKTREE_PARENT, } from "../core/git-worktree-env.js";
|
|
5
5
|
import { mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
6
6
|
import { thrownText } from "../core/thrown-value.js";
|
|
7
7
|
export function currentCheckoutOf(session, taskRoot) {
|
|
@@ -82,17 +82,30 @@ const EXIT_DESCRIPTION = "Exit a worktree session created by EnterWorktree and r
|
|
|
82
82
|
"## Behavior\n" +
|
|
83
83
|
"\n" +
|
|
84
84
|
"- Restores the session's working directory to where it was before EnterWorktree.\n" +
|
|
85
|
-
"- Default: if the worktree has NO changes (clean `git status`, no new commits), it is removed and " +
|
|
86
|
-
"pruned; if it HAS uncommitted files or new commits, it is KEPT on disk and its path reported so the " +
|
|
85
|
+
"- Default: if the worktree has NO changes (clean `git status`, no files git ignores, no new commits), it is removed and " +
|
|
86
|
+
"pruned; if it HAS uncommitted files, files git ignores (build output, `node_modules/`), or new commits, it is KEPT on disk and its path reported so the " +
|
|
87
87
|
"work can be inspected or merged — nothing is discarded.\n" +
|
|
88
88
|
"- A worktree entered via EnterWorktree `path` (not created by it) is NEVER removed — exit only restores " +
|
|
89
89
|
"the working directory.\n" +
|
|
90
90
|
"- `keep: true` always keeps the worktree on disk, changed or not.\n" +
|
|
91
|
-
"- `discardChanges: true` removes the worktree even when it HAS uncommitted files or new commits — they " +
|
|
91
|
+
"- `discardChanges: true` removes the worktree even when it HAS uncommitted files, files git ignores, or new commits — they " +
|
|
92
92
|
"are permanently discarded. Only set this when the work is confirmed disposable (a throwaway experiment, " +
|
|
93
93
|
"or the user asked to discard it); it cannot be combined with `keep: true`.\n" +
|
|
94
94
|
"- Once exited, EnterWorktree can be called again to create a fresh worktree.";
|
|
95
|
-
|
|
95
|
+
function heldSentence(holds) {
|
|
96
|
+
const parts = [];
|
|
97
|
+
if (holds !== undefined) {
|
|
98
|
+
if (holds.files > 0)
|
|
99
|
+
parts.push(`${holds.files} uncommitted ${holds.files === 1 ? "file" : "files"}`);
|
|
100
|
+
if (holds.commits !== undefined && holds.commits > 0)
|
|
101
|
+
parts.push(`${holds.commits} new ${holds.commits === 1 ? "commit" : "commits"}`);
|
|
102
|
+
if (holds.ignored.length > 0)
|
|
103
|
+
parts.push(`${holds.ignored.length} ${holds.ignored.length === 1 ? "path" : "paths"} git ignores (${namedIgnored(holds.ignored)})`);
|
|
104
|
+
}
|
|
105
|
+
if (parts.length === 0)
|
|
106
|
+
return "could not verify the worktree state — keeping it to be safe";
|
|
107
|
+
return parts.length <= 2 ? parts.join(" and ") : `${parts.slice(0, -1).join(", ")} and ${parts[parts.length - 1]}`;
|
|
108
|
+
}
|
|
96
109
|
function reasonOf(e) {
|
|
97
110
|
try {
|
|
98
111
|
if (typeof e === "object" && e !== null && !(e instanceof Error)) {
|
|
@@ -253,16 +266,16 @@ export function createWorktreeTools(env, opts) {
|
|
|
253
266
|
description: EXIT_DESCRIPTION,
|
|
254
267
|
parameters: Type.Object({
|
|
255
268
|
keep: Type.Optional(Type.Boolean({
|
|
256
|
-
description: "true = always keep the worktree on disk. Default: keep only when it has uncommitted files or new commits; remove when
|
|
269
|
+
description: "true = always keep the worktree on disk. Default: keep only when it has uncommitted files, files git ignores, or new commits; remove when it has none.",
|
|
257
270
|
})),
|
|
258
271
|
discardChanges: Type.Optional(Type.Boolean({
|
|
259
|
-
description: "true = remove the worktree even when it has uncommitted files or new commits, permanently discarding them. Default false: a changed worktree is kept and its changes listed. Cannot be combined with `keep: true`.",
|
|
272
|
+
description: "true = remove the worktree even when it has uncommitted files, files git ignores, or new commits, permanently discarding them. Default false: a changed worktree is kept and its changes listed. Cannot be combined with `keep: true`.",
|
|
260
273
|
})),
|
|
261
274
|
action: Type.Optional(Type.Union([Type.Literal("keep"), Type.Literal("remove")], {
|
|
262
275
|
description: '"keep" leaves the worktree and its branch on disk. "remove" takes the default removal path: an unchanged worktree is removed, a changed one is still KEPT unless `discard_changes: true`. A removed worktree\'s branch is deleted with it only when it carries no commits beyond the base; a branch with commits is kept and named in the reply.',
|
|
263
276
|
})),
|
|
264
277
|
discard_changes: Type.Optional(Type.Boolean({
|
|
265
|
-
description: 'Set true to remove the worktree even when it has uncommitted files or unmerged commits — they are permanently discarded. Without it a changed worktree is KEPT (the exit still completes and the reply lists the changes plus this escape), never refused.',
|
|
278
|
+
description: 'Set true to remove the worktree even when it has uncommitted files, files git ignores, or unmerged commits — they are permanently discarded. Without it a changed worktree is KEPT (the exit still completes and the reply lists the changes plus this escape), never refused.',
|
|
266
279
|
})),
|
|
267
280
|
}),
|
|
268
281
|
execute: async (args, ctx) => {
|
|
@@ -354,23 +367,9 @@ export function createWorktreeTools(env, opts) {
|
|
|
354
367
|
},
|
|
355
368
|
};
|
|
356
369
|
}
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
const
|
|
360
|
-
if (status.ok && status.value.exitCode === 0) {
|
|
361
|
-
const dirtyFiles = status.value.stdout.split("\n").filter((l) => l.trim() !== "").length;
|
|
362
|
-
const ahead = await env.exec(`git rev-list --count ${shq(`${active.baseSha}..HEAD`)}`, { cwd: active.worktreeDir, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
363
|
-
const commits = ahead.ok && ahead.value.exitCode === 0 ? parseInt(ahead.value.stdout.trim(), 10) || 0 : -1;
|
|
364
|
-
if (commits >= 0) {
|
|
365
|
-
changed = dirtyFiles > 0 || commits > 0;
|
|
366
|
-
const parts = [];
|
|
367
|
-
if (dirtyFiles > 0)
|
|
368
|
-
parts.push(`${dirtyFiles} uncommitted ${dirtyFiles === 1 ? "file" : "files"}`);
|
|
369
|
-
if (commits > 0)
|
|
370
|
-
parts.push(`${commits} new ${commits === 1 ? "commit" : "commits"}`);
|
|
371
|
-
changeDetail = parts.join(" and ");
|
|
372
|
-
}
|
|
373
|
-
}
|
|
370
|
+
const holds = await treeHoldsOf(env, active.worktreeDir, active.baseSha, () => readFloor, { rethrow: true });
|
|
371
|
+
const changed = keptByHolds(holds) !== undefined;
|
|
372
|
+
const changeDetail = heldSentence(holds);
|
|
374
373
|
if (keep === true || (changed && discardChanges !== true)) {
|
|
375
374
|
const why = keep === true ? "keep was requested" : `it has ${changeDetail}`;
|
|
376
375
|
const removeHint = wantsRemove && keep !== true
|