mixdog 1.4.2 → 1.4.4
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/package.json +2 -2
- package/scripts/build-shipped-history.mjs +15 -5
- package/scripts/gate-local.mjs +65 -19
- package/scripts/graph-parity.mjs +8 -3
- package/scripts/lib/gate-scheduler.mjs +2 -1
- package/scripts/lib/run-node-tests.mjs +17 -5
- package/scripts/lib/test-failure-summary.mjs +1 -8
- package/scripts/lib/test-spawn-ledger.mjs +33 -2
- package/scripts/post-release-check.mjs +26 -16
- package/scripts/provider-pingpong-live.mjs +1 -1
- package/scripts/prune-embedding-runtime.mjs +3 -1
- package/scripts/release-paths.mjs +7 -1
- package/src/defaults/shipped-history.json +24 -0
- package/src/defaults/skills/computer-use/SKILL.md +14 -3
- package/src/defaults/skills/memory-management/SKILL.md +10 -5
- package/src/defaults/skills/setup/SKILL.md +2 -2
- package/src/defaults/skills/setup/references/actions.md +17 -4
- package/src/defaults/skills/setup/references/surfaces.md +3 -0
- package/src/defaults/skills/setup-guide/SKILL.md +6 -1
- package/src/lib/instruction-text.cjs +36 -0
- package/src/lib/rules-builder.cjs +34 -20
- package/src/orchestration/balanced.md +23 -0
- package/src/orchestration/focused.md +22 -0
- package/src/orchestration/none.md +5 -0
- package/src/orchestration/swarm.md +24 -0
- package/src/rules/agent-mode/AGENT_MODE.md +3 -1
- package/src/rules/agent-mode/MIXY.md +5 -3
- package/src/runtime/agent/orchestrator/agent-runtime/agent-dispatch/session-prep.mjs +3 -3
- package/src/runtime/agent/orchestrator/agent-runtime/agent-dispatch.mjs +0 -1
- package/src/runtime/agent/orchestrator/agent-runtime/agent-progress-watchdog.mjs +4 -2
- package/src/runtime/agent/orchestrator/agent-runtime/cache-strategy.mjs +0 -9
- package/src/runtime/agent/orchestrator/agent-runtime/heartbeat-completion.mjs +2 -2
- package/src/runtime/agent/orchestrator/agent-runtime/session-builder.mjs +67 -0
- package/src/runtime/agent/orchestrator/agent-trace-format.mjs +1 -0
- package/src/runtime/agent/orchestrator/context/role-instructions.mjs +4 -4
- package/src/runtime/agent/orchestrator/mcp/agent-connectors.mjs +3 -1
- package/src/runtime/agent/orchestrator/mcp/child-tree.mjs +199 -46
- package/src/runtime/agent/orchestrator/mcp/client-config.mjs +3 -5
- package/src/runtime/agent/orchestrator/mcp/client-transport.mjs +9 -3
- package/src/runtime/agent/orchestrator/mcp/client.mjs +3 -5
- package/src/runtime/agent/orchestrator/mcp/oauth-client.mjs +1 -1
- package/src/runtime/agent/orchestrator/mcp/oauth-credentials.mjs +8 -2
- package/src/runtime/agent/orchestrator/mcp/oauth-probe.mjs +1 -1
- package/src/runtime/agent/orchestrator/mcp/oauth-provider.mjs +14 -0
- package/src/runtime/agent/orchestrator/mcp/oauth.mjs +1 -1
- package/src/runtime/agent/orchestrator/providers/admission-scheduler.mjs +2 -1
- package/src/runtime/agent/orchestrator/providers/anthropic-api-request.mjs +11 -1
- package/src/runtime/agent/orchestrator/providers/anthropic-oauth-client-version.mjs +1 -1
- package/src/runtime/agent/orchestrator/providers/anthropic-sse-turn/turn-events/content-block-start.mjs +4 -0
- package/src/runtime/agent/orchestrator/providers/anthropic-sse-turn/turn-events/content-block-stop.mjs +3 -3
- package/src/runtime/agent/orchestrator/providers/anthropic-sse-turn/turn-outcome.mjs +2 -0
- package/src/runtime/agent/orchestrator/providers/anthropic-turn-result.mjs +2 -0
- package/src/runtime/agent/orchestrator/providers/anthropic.mjs +2 -0
- package/src/runtime/agent/orchestrator/providers/codex-client-meta.mjs +1 -1
- package/src/runtime/agent/orchestrator/providers/custom-provider-config.mjs +121 -9
- package/src/runtime/agent/orchestrator/providers/custom-provider.mjs +4 -1
- package/src/runtime/agent/orchestrator/providers/gemini-thinking.mjs +2 -2
- package/src/runtime/agent/orchestrator/providers/lib/generation-window.mjs +9 -0
- package/src/runtime/agent/orchestrator/providers/openai-compat-chat-send.mjs +9 -1
- package/src/runtime/agent/orchestrator/providers/openai-compat-chat-stream/stream-result.mjs +2 -0
- package/src/runtime/agent/orchestrator/providers/openai-compat-chat-stream/stream-state.mjs +5 -0
- package/src/runtime/agent/orchestrator/providers/openai-compat-options.mjs +3 -0
- package/src/runtime/agent/orchestrator/providers/openai-compat-response-normalization.mjs +6 -6
- package/src/runtime/agent/orchestrator/providers/openai-compat-responses-head-parity.json +2784 -2872
- package/src/runtime/agent/orchestrator/providers/openai-compat-responses.mjs +10 -1
- package/src/runtime/agent/orchestrator/providers/openai-compat-xai.mjs +5 -8
- package/src/runtime/agent/orchestrator/providers/openai-http-sse-response-state/response-events.mjs +3 -0
- package/src/runtime/agent/orchestrator/providers/openai-http-sse-response-state/response-outcome.mjs +2 -0
- package/src/runtime/agent/orchestrator/providers/openai-responses-payload-parity.fixture.json +288 -300
- package/src/runtime/agent/orchestrator/providers/openai-ws-response-state.mjs +9 -2
- package/src/runtime/agent/orchestrator/providers/openrouter-provider-routing.mjs +28 -0
- package/src/runtime/agent/orchestrator/providers/openrouter.mjs +4 -1
- package/src/runtime/agent/orchestrator/providers/registry.mjs +30 -25
- package/src/runtime/agent/orchestrator/providers/vertex-ai.mjs +10 -1
- package/src/runtime/agent/orchestrator/providers/xai-tool-search-head-parity.json +10 -30
- package/src/runtime/agent/orchestrator/runtime-core/ask-user-result.mjs +66 -0
- package/src/runtime/agent/orchestrator/runtime-core/builtin-features.mjs +30 -0
- package/src/runtime/agent/orchestrator/runtime-core/config-helpers.mjs +0 -11
- package/src/runtime/agent/orchestrator/runtime-core/deferred-tool-availability.mjs +8 -0
- package/src/runtime/agent/orchestrator/runtime-core/deferred-tool-delta.mjs +17 -3
- package/src/runtime/agent/orchestrator/runtime-core/goal-control.mjs +47 -27
- package/src/runtime/agent/orchestrator/runtime-core/goal-deadlines.mjs +141 -10
- package/src/runtime/agent/orchestrator/runtime-core/goal-mutations.mjs +26 -63
- package/src/runtime/agent/orchestrator/runtime-core/goal-reminder.mjs +28 -3
- package/src/runtime/agent/orchestrator/runtime-core/goal-runtime.mjs +36 -11
- package/src/runtime/agent/orchestrator/runtime-core/goal-state.mjs +88 -56
- package/src/runtime/agent/orchestrator/runtime-core/goal-storage.mjs +4 -1
- package/src/runtime/agent/orchestrator/runtime-core/goal-store.mjs +51 -32
- package/src/runtime/agent/orchestrator/runtime-core/goal-text.mjs +45 -145
- package/src/runtime/agent/orchestrator/runtime-core/goal-tool-defs.mjs +15 -98
- package/src/runtime/agent/orchestrator/runtime-core/goal-tool-exec.mjs +32 -99
- package/src/runtime/agent/orchestrator/runtime-core/goal-turns.mjs +23 -78
- package/src/runtime/agent/orchestrator/runtime-core/orchestration.mjs +69 -48
- package/src/runtime/agent/orchestrator/runtime-core/todo-list.mjs +367 -0
- package/src/runtime/agent/orchestrator/runtime-core/todo-tool-defs.mjs +47 -0
- package/src/runtime/agent/orchestrator/runtime-core/tool-availability.mjs +155 -0
- package/src/runtime/agent/orchestrator/runtime-core/tool-catalog-data.mjs +9 -0
- package/src/runtime/agent/orchestrator/runtime-core/tool-catalog.mjs +119 -35
- package/src/runtime/agent/orchestrator/runtime-core/tool-defs.mjs +1 -1
- package/src/runtime/agent/orchestrator/runtime-core/workflow/context.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/agent-loop.mjs +28 -22
- package/src/runtime/agent/orchestrator/session/agent-pool-progress.mjs +30 -0
- package/src/runtime/agent/orchestrator/session/attachment-preflight.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/cache-warm.mjs +2 -2
- package/src/runtime/agent/orchestrator/session/catalog-db/index.mjs +2 -2
- package/src/runtime/agent/orchestrator/session/catalog-db/schema.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/compact/execution-tail.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/compact/runner.mjs +3 -0
- package/src/runtime/agent/orchestrator/session/compact/summary-route.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/context-utils.mjs +8 -12
- package/src/runtime/agent/orchestrator/session/conversation-import/claude.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/conversation-import/codex.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/conversation-import/convert.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/conversation-import/imported-session.mjs +7 -3
- package/src/runtime/agent/orchestrator/session/human-gate/held-message.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/human-gate/requests.mjs +1 -2
- package/src/runtime/agent/orchestrator/session/human-gate/run-policy.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/image-strip-recovery.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/loop/completion-guards.mjs +11 -1
- package/src/runtime/agent/orchestrator/session/loop/context-overflow.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/loop/loop-state.mjs +8 -1
- package/src/runtime/agent/orchestrator/session/loop/no-tool-turn/todo-check.mjs +196 -0
- package/src/runtime/agent/orchestrator/session/loop/no-tool-turn.mjs +116 -50
- package/src/runtime/agent/orchestrator/session/loop/pre-dispatch-deny.mjs +8 -1
- package/src/runtime/agent/orchestrator/session/loop/provider-tool-exclusions.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/loop/route-fallback.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/loop/steering.mjs +3 -1
- package/src/runtime/agent/orchestrator/session/loop/stored-tool-args.mjs +5 -6
- package/src/runtime/agent/orchestrator/session/loop/tool-exec/before-hook.mjs +6 -1
- package/src/runtime/agent/orchestrator/session/loop/tool-exec/dispatch.mjs +16 -2
- package/src/runtime/agent/orchestrator/session/loop/turn-report.mjs +35 -0
- package/src/runtime/agent/orchestrator/session/loop/usage.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/manager/ask-session.mjs +57 -26
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-auto-effort.mjs +9 -7
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-execute.mjs +21 -3
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-failure.mjs +27 -11
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-open.mjs +37 -34
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-prepare.mjs +15 -0
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-settle.mjs +25 -15
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-state.mjs +79 -24
- package/src/runtime/agent/orchestrator/session/manager/ask-turn-steering-drain.mjs +3 -0
- package/src/runtime/agent/orchestrator/session/manager/compaction-runner.mjs +12 -1
- package/src/runtime/agent/orchestrator/session/manager/context-meta.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/manager/idle-cleanup.mjs +6 -1
- package/src/runtime/agent/orchestrator/session/manager/pending-messages.mjs +9 -1
- package/src/runtime/agent/orchestrator/session/manager/pending-spool-path.mjs +2 -2
- package/src/runtime/agent/orchestrator/session/manager/pending-spool-shard.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/manager/prompt-settings.mjs +598 -0
- package/src/runtime/agent/orchestrator/session/manager/prompt-utils.mjs +19 -0
- package/src/runtime/agent/orchestrator/session/manager/rules-cache.mjs +19 -10
- package/src/runtime/agent/orchestrator/session/manager/runtime-liveness.mjs +8 -1
- package/src/runtime/agent/orchestrator/session/manager/session-close.mjs +5 -0
- package/src/runtime/agent/orchestrator/session/manager/session-fallback-title.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/manager/session-lifecycle.mjs +31 -0
- package/src/runtime/agent/orchestrator/session/manager/session-lock.mjs +31 -0
- package/src/runtime/agent/orchestrator/session/manager/session-prompt-composition.mjs +42 -6
- package/src/runtime/agent/orchestrator/session/manager/session-record.mjs +2 -0
- package/src/runtime/agent/orchestrator/session/manager/tool-resolution.mjs +11 -1
- package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint-context.mjs +8 -9
- package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint-journal.mjs +339 -88
- package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint-recovery.mjs +135 -11
- package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint.mjs +377 -104
- package/src/runtime/agent/orchestrator/session/manager/turn-durability.mjs +144 -0
- package/src/runtime/agent/orchestrator/session/manager/turn-interruption.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/manager/usage-metrics.mjs +4 -0
- package/src/runtime/agent/orchestrator/session/manager.mjs +6 -0
- package/src/runtime/agent/orchestrator/session/mixy-name.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/pre-send-compact.mjs +8 -1
- package/src/runtime/agent/orchestrator/session/save-session-worker.mjs +5 -1
- package/src/runtime/agent/orchestrator/session/store/canonical-reader.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/store/liveness-veto.mjs +2 -2
- package/src/runtime/agent/orchestrator/session/store/save-worker.mjs +23 -2
- package/src/runtime/agent/orchestrator/session/store/sweep/sub-agent-retention.mjs +3 -3
- package/src/runtime/agent/orchestrator/session/store/transcript-durability.mjs +88 -0
- package/src/runtime/agent/orchestrator/session/store-agent-worker-rows.mjs +5 -0
- package/src/runtime/agent/orchestrator/session/store-summary-log.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/store-transcript-projection.mjs +14 -5
- package/src/runtime/agent/orchestrator/session/store-transcript-worker.mjs +2 -2
- package/src/runtime/agent/orchestrator/session/store.mjs +17 -6
- package/src/runtime/agent/orchestrator/session/synthetic-user-envelope.mjs +7 -1
- package/src/runtime/agent/orchestrator/session/tail-reminder-rules.mjs +9 -1
- package/src/runtime/agent/orchestrator/session/transcript-restore/agent-envelope.mjs +1 -1
- package/src/runtime/agent/orchestrator/session/transcript-restore/restore.mjs +3 -1
- package/src/runtime/agent/orchestrator/session/transcript-restore/user-text.mjs +2 -2
- package/src/runtime/agent/orchestrator/stall-policy.mjs +3 -5
- package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/backgrounded-result.mjs +4 -1
- package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/misuse-guard.mjs +21 -3
- package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/result-format.mjs +1 -1
- package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/worktree-add-guard.mjs +77 -0
- package/src/runtime/agent/orchestrator/tools/builtin/bash-tool.mjs +0 -1
- package/src/runtime/agent/orchestrator/tools/builtin/git-command-tool.mjs +7 -3
- package/src/runtime/agent/orchestrator/tools/builtin/git-worktree-tool.mjs +27 -9
- package/src/runtime/agent/orchestrator/tools/builtin/lib/search-input-helpers.mjs +2 -2
- package/src/runtime/agent/orchestrator/tools/builtin/lib/shell-output-silence.mjs +64 -0
- package/src/runtime/agent/orchestrator/tools/builtin/lib/shell-task-output.mjs +20 -6
- package/src/runtime/agent/orchestrator/tools/builtin/read-range-index.mjs +1 -1
- package/src/runtime/agent/orchestrator/tools/builtin/read-single-fast-paths.mjs +0 -1
- package/src/runtime/agent/orchestrator/tools/builtin/search-tool.mjs +0 -10
- package/src/runtime/agent/orchestrator/tools/builtin/shell-jobs.mjs +1 -2
- package/src/runtime/agent/orchestrator/tools/builtin/task-tool.mjs +12 -1
- package/src/runtime/agent/orchestrator/tools/builtin.mjs +1 -24
- package/src/runtime/agent/orchestrator/tools/code-graph/graph-binary/child-kill.mjs +4 -3
- package/src/runtime/agent/orchestrator/tools/code-graph/graph-binary.mjs +1 -2
- package/src/runtime/agent/orchestrator/tools/code-graph/modes/calls.mjs +1 -1
- package/src/runtime/agent/orchestrator/tools/code-graph/modes/symbols.mjs +2 -2
- package/src/runtime/agent/orchestrator/tools/code-graph/search.mjs +4 -5
- package/src/runtime/agent/orchestrator/tools/code-graph/symbol-index.mjs +3 -4
- package/src/runtime/agent/orchestrator/tools/code-graph.mjs +4 -22
- package/src/runtime/agent/orchestrator/tools/lib/shell-descendants.mjs +2 -2
- package/src/runtime/agent/orchestrator/tools/lib/shell-run-state.mjs +1 -1
- package/src/runtime/agent/orchestrator/tools/shell-command.mjs +0 -4
- package/src/runtime/agent/orchestrator/tools/shell-policy.mjs +0 -1
- package/src/runtime/attachments/attachment-reference.mjs +1 -1
- package/src/runtime/attachments/pdf-extract.mjs +1 -1
- package/src/runtime/attachments/store.d.mts +1 -0
- package/src/runtime/attachments/store.mjs +2 -2
- package/src/runtime/channels/lib/config-reload-watch.mjs +42 -0
- package/src/runtime/channels/lib/owned-runtime/config-reload.mjs +29 -9
- package/src/runtime/channels/lib/routines-db.mjs +35 -0
- package/src/runtime/channels/lib/scheduler.mjs +33 -0
- package/src/runtime/channels/lib/schedules-db.mjs +15 -4
- package/src/runtime/channels/lib/webhook/session-dispatch.mjs +4 -1
- package/src/runtime/channels/lib/webhooks-db.mjs +13 -3
- package/src/runtime/channels/lib/whisper-server.mjs +12 -12
- package/src/runtime/channels/lib/worker-main.mjs +9 -31
- package/src/runtime/computer-bridge/action-schema.mjs +2 -2
- package/src/runtime/computer-bridge/core-actions.mjs +16 -2
- package/src/runtime/computer-bridge/linux-readiness.mjs +10 -14
- package/src/runtime/computer-bridge/result-canonical.mjs +6 -0
- package/src/runtime/connectors/connector-accounts-mcp.mjs +169 -33
- package/src/runtime/connectors/gmail-app-password.mjs +2 -2
- package/src/runtime/connectors/google-mcp.mjs +1 -1
- package/src/runtime/effort-judge/judge-client.mjs +2 -2
- package/src/runtime/effort-judge/judge-input.mjs +4 -4
- package/src/runtime/explore/explorer.mjs +0 -5
- package/src/runtime/explore/tool.mjs +3 -3
- package/src/runtime/local-provider/hardware.mjs +1 -1
- package/src/runtime/media/adapters/codex-image.mjs +3 -3
- package/src/runtime/media/adapters/gemini-video.mjs +1 -1
- package/src/runtime/media/media-usage.mjs +1 -1
- package/src/runtime/media/store.mjs +1 -1
- package/src/runtime/memory/index.mjs +11 -1
- package/src/runtime/memory/lib/embedding-reindex.mjs +27 -0
- package/src/runtime/memory/lib/memory-embed.mjs +83 -14
- package/src/runtime/memory/lib/memory-process-lock.mjs +159 -36
- package/src/runtime/memory/lib/memory-text-utils.mjs +6 -1
- package/src/runtime/memory/lib/memory.mjs +17 -0
- package/src/runtime/memory/lib/pg/process.mjs +1 -1
- package/src/runtime/memory/lib/pg/supervisor.mjs +16 -96
- package/src/runtime/memory/lib/recall-hybrid/hybrid-sql.mjs +12 -3
- package/src/runtime/memory/tool-defs.mjs +1 -1
- package/src/runtime/office/authoring/docx-html-runner.mjs +1 -1
- package/src/runtime/office/authoring/pptx-author-action.mjs +1 -1
- package/src/runtime/office/authoring/xlsx-html-build.mjs +1 -1
- package/src/runtime/office/authoring/xlsx-html-runner.mjs +1 -1
- package/src/runtime/office/capabilities.mjs +1 -1
- package/src/runtime/office/core/office-core.mjs +1 -1
- package/src/runtime/office/design/content-model.mjs +3 -3
- package/src/runtime/office/design/docx/design-docx/section.mjs +6 -6
- package/src/runtime/office/design/xlsx/design-xlsx-components.mjs +1 -1
- package/src/runtime/office/design/xlsx/design-xlsx.mjs +1 -1
- package/src/runtime/office/pdf/ocr-engine.mjs +1 -1
- package/src/runtime/office/pdf/pdf-writer.mjs +4 -4
- package/src/runtime/office/portable/portable-docx-operations.mjs +2 -2
- package/src/runtime/office/portable/portable-soffice.mjs +8 -6
- package/src/runtime/office/portable/xlsx-contract.mjs +1 -1
- package/src/runtime/shared/atomic-file.d.mts +8 -0
- package/src/runtime/shared/background-tasks.mjs +22 -4
- package/src/runtime/shared/background-wait.mjs +66 -0
- package/src/runtime/shared/child-guardian.mjs +17 -7
- package/src/runtime/shared/config.mjs +313 -16
- package/src/runtime/shared/connector-catalog.d.mts +4 -5
- package/src/runtime/shared/connector-catalog.mjs +11 -1
- package/src/runtime/shared/file-lock.mjs +8 -3
- package/src/runtime/shared/git-runner.mjs +7 -2
- package/src/runtime/shared/idle-gc.mjs +30 -7
- package/src/runtime/shared/llm/http-agent.mjs +8 -5
- package/src/runtime/shared/llm/system-proxy.mjs +2 -1
- package/src/runtime/shared/llm/usage-accounting.mjs +110 -19
- package/src/runtime/shared/llm/usage-context.mjs +1 -1
- package/src/runtime/shared/llm/usage-ledger-quota.mjs +33 -12
- package/src/runtime/shared/llm/usage-ledger-requests.mjs +183 -0
- package/src/runtime/shared/llm/usage-ledger-rollup.mjs +90 -10
- package/src/runtime/shared/llm/usage-ledger-worker.mjs +2 -0
- package/src/runtime/shared/llm/usage-ledger.mjs +60 -1
- package/src/runtime/shared/llm/usage-request-status.mjs +48 -0
- package/src/runtime/shared/llm/usage-rollup.mjs +48 -0
- package/src/runtime/shared/maintenance-schedule.mjs +109 -0
- package/src/runtime/shared/process-runner.mjs +8 -4
- package/src/runtime/shared/routine-trigger.d.mts +13 -0
- package/src/runtime/shared/routine-trigger.mjs +34 -0
- package/src/runtime/shared/run-child.d.mts +2 -1
- package/src/runtime/shared/run-child.mjs +70 -18
- package/src/runtime/shared/session-scratch.mjs +14 -2
- package/src/runtime/shared/shipped-definitions.mjs +7 -1
- package/src/runtime/shared/tool-card-model.golden.json +3 -12
- package/src/runtime/shared/tool-execution-contract.mjs +2 -0
- package/src/runtime/shared/tool-result-summary.mjs +1 -1
- package/src/runtime/shared/tool-work-units.mjs +31 -6
- package/src/runtime/shared/turn-snapshot.mjs +26 -4
- package/src/runtime/shared/turn-worktree-snapshot.mjs +6 -11
- package/src/runtime/shared/worker-requests.mjs +17 -3
- package/src/runtime/shared/worktrees/branch-management.mjs +1 -5
- package/src/runtime/shared/worktrees/contract.mjs +16 -6
- package/src/runtime/shared/worktrees/dependencies.mjs +127 -89
- package/src/runtime/shared/worktrees/disk.mjs +79 -2
- package/src/runtime/shared/worktrees/git.mjs +44 -11
- package/src/runtime/shared/worktrees/include.mjs +6 -4
- package/src/runtime/shared/worktrees/maintenance.mjs +422 -30
- package/src/runtime/shared/worktrees/manager.mjs +772 -75
- package/src/runtime/shared/worktrees/settings.mjs +33 -7
- package/src/runtime/shared/worktrees/test-support.mjs +5 -1
- package/src/runtime/shared/worktrees/worker-snapshots.mjs +82 -0
- package/src/runtime/tidy/process.mjs +2 -1
- package/src/runtime/web-search/index.mjs +3 -22
- package/src/runtime/web-search/lib/web-tools.mjs +2 -2
- package/src/runtime/web-search/tool-defs.mjs +17 -26
- package/src/session-runtime/agent-home-delivery.mjs +76 -8
- package/src/session-runtime/agent-profile-changes.mjs +55 -4
- package/src/session-runtime/agent-task-sessions.mjs +63 -22
- package/src/session-runtime/boot/apis.mjs +42 -4
- package/src/session-runtime/boot/begin.mjs +2 -0
- package/src/session-runtime/boot/config.mjs +10 -1
- package/src/session-runtime/boot/facade.mjs +1 -0
- package/src/session-runtime/boot/providers.mjs +70 -3
- package/src/session-runtime/boot/session.mjs +2 -0
- package/src/session-runtime/boot/tools.mjs +75 -25
- package/src/session-runtime/channel-config-api.mjs +1 -0
- package/src/session-runtime/config-change-effects.mjs +179 -0
- package/src/session-runtime/config-lifecycle/config-writers.mjs +1 -0
- package/src/session-runtime/config-lifecycle.mjs +160 -24
- package/src/session-runtime/conversation-import/discovery.mjs +86 -7
- package/src/session-runtime/conversation-import/service.mjs +3 -2
- package/src/session-runtime/goal-facade-api.mjs +49 -3
- package/src/session-runtime/internal-tool-executor/ask-user-tool.mjs +5 -57
- package/src/session-runtime/internal-tool-executor/bridge-tools.mjs +3 -2
- package/src/session-runtime/internal-tool-executor/feature-tools.mjs +3 -11
- package/src/session-runtime/internal-tool-executor/workspace-tools.mjs +18 -4
- package/src/session-runtime/internal-tool-executor.mjs +12 -19
- package/src/session-runtime/lifecycle/cold-heir.mjs +7 -0
- package/src/session-runtime/lifecycle/memory-ingest.mjs +3 -3
- package/src/session-runtime/lifecycle/session-switch/session-delete.mjs +53 -5
- package/src/session-runtime/lifecycle/session-switch.mjs +13 -2
- package/src/session-runtime/lifecycle/teardown/session-close.mjs +4 -4
- package/src/session-runtime/lifecycle-api.mjs +1 -0
- package/src/session-runtime/mcp-glue/server-catalog.mjs +14 -3
- package/src/session-runtime/mcp-glue/server-connection.mjs +34 -8
- package/src/session-runtime/model-route/route-persist.mjs +12 -4
- package/src/session-runtime/model-route/set-route.mjs +40 -7
- package/src/session-runtime/native-web-search/routes.mjs +3 -3
- package/src/session-runtime/provider-auth/refresh.mjs +6 -3
- package/src/session-runtime/provider-auth/setup.mjs +1 -1
- package/src/session-runtime/provider-models/row-hydration.mjs +2 -0
- package/src/session-runtime/provider-readiness.mjs +53 -4
- package/src/session-runtime/resource-api.mjs +1 -1
- package/src/session-runtime/resource-extension-sync.mjs +4 -8
- package/src/session-runtime/resource-mcp-connector-accounts.mjs +5 -1
- package/src/session-runtime/resource-mcp-secrets.mjs +3 -3
- package/src/session-runtime/resource-plugins-api.mjs +4 -0
- package/src/session-runtime/routine-executor.mjs +152 -0
- package/src/session-runtime/routine-home-turn.mjs +46 -5
- package/src/session-runtime/routine-owner.mjs +9 -3
- package/src/session-runtime/runtime-facade.mjs +5 -0
- package/src/session-runtime/runtime-feature-gates.mjs +2 -11
- package/src/session-runtime/schedule-session-run.mjs +1 -0
- package/src/session-runtime/services/agent-task-status.mjs +29 -1
- package/src/session-runtime/services/agent-tool/job-task-reconcile.mjs +6 -1
- package/src/session-runtime/services/agent-tool/job-views/session-progress.mjs +10 -0
- package/src/session-runtime/services/agent-tool/render.mjs +6 -1
- package/src/session-runtime/services/agent-tool/send-flow.mjs +110 -6
- package/src/session-runtime/services/agent-tool/spawn-flow/job-start.mjs +12 -0
- package/src/session-runtime/services/agent-tool/spawn-flow/spawn-plan.mjs +5 -0
- package/src/session-runtime/services/agent-tool/spawn-flow/spawn-run.mjs +24 -6
- package/src/session-runtime/services/agent-tool.mjs +51 -1
- package/src/session-runtime/services/channel-admin.mjs +62 -3
- package/src/session-runtime/services/hook-bus/command-handler.mjs +7 -11
- package/src/session-runtime/services/plugin-admin.mjs +50 -7
- package/src/session-runtime/services/provider-admin.mjs +5 -0
- package/src/session-runtime/services/seeds.mjs +7 -0
- package/src/session-runtime/services/usage-stats-model.mjs +32 -11
- package/src/session-runtime/session-create/materialize.mjs +4 -2
- package/src/session-runtime/session-create/session-options.mjs +2 -0
- package/src/session-runtime/settings-builtin-tools-api.mjs +1 -9
- package/src/session-runtime/setup-tool/agent-settings-actions.mjs +1 -1
- package/src/session-runtime/setup-tool/connector-widen-approval.mjs +1 -1
- package/src/session-runtime/setup-tool/executor.mjs +9 -2
- package/src/session-runtime/setup-tool/extended-actions.mjs +3 -1
- package/src/session-runtime/setup-tool/settings-contract.mjs +30 -2
- package/src/session-runtime/setup-tool/tool-defs.mjs +26 -1
- package/src/session-runtime/tool-policy/agent-profile-fold.mjs +40 -43
- package/src/session-runtime/tool-policy/mode-switch.mjs +1 -1
- package/src/session-runtime/tool-policy/policy-stage.mjs +106 -8
- package/src/session-runtime/tool-policy/workflow-overlay.mjs +2 -1
- package/src/session-runtime/tool-policy-refresh.mjs +182 -5
- package/src/session-runtime/tool-surface.mjs +38 -1
- package/src/session-runtime/turn/agent-ops.mjs +10 -2
- package/src/session-runtime/turn/session-ops.mjs +2 -0
- package/src/session-runtime/turn/turn-run/turn-prepare.mjs +5 -0
- package/src/session-runtime/turn/turn-run.mjs +1 -1
- package/src/session-runtime/usage-stats-api.mjs +117 -1
- package/src/session-runtime/webhook-session-run.mjs +2 -0
- package/src/session-runtime/workflow-agents-api/agent-connectors.mjs +37 -33
- package/src/session-runtime/workflow-agents-api/agent-editor.mjs +183 -23
- package/src/session-runtime/workflow-agents-api/agent-route.mjs +3 -10
- package/src/session-runtime/workflow-agents-api/instruction-files.mjs +165 -0
- package/src/session-runtime/workflow-agents-api/style-and-mode.mjs +5 -4
- package/src/session-runtime/workflow-agents-api/workflow-packs.mjs +2 -3
- package/src/session-runtime/workflow-agents-api.mjs +2 -0
- package/src/session-runtime/workspace/project-branches.mjs +1 -1
- package/src/session-runtime/workspace/session-view.mjs +1 -1
- package/src/session-runtime/workspace/transitions.mjs +20 -4
- package/src/session-runtime/workspace/worktree-maintenance.mjs +126 -6
- package/src/session-runtime/workspace/worktree-setup.mjs +13 -1
- package/src/session-runtime/workspace/worktree-tool.mjs +16 -0
- package/src/standalone/daemon-agent-control.mjs +25 -8
- package/src/standalone/daemon-desktop-runtime.mjs +6 -2
- package/src/standalone/daemon-lag-profiler.mjs +7 -7
- package/src/standalone/daemon.mjs +54 -2
- package/src/standalone/local-session-runtime.mjs +16 -0
- package/src/standalone/session-client/daemon-unavailable.mjs +1 -1
- package/src/standalone/session-protocol.mjs +12 -0
- package/src/standalone/session-service/agent-route-follow.mjs +23 -20
- package/src/standalone/session-service/agent-tree/agent-turns.mjs +18 -6
- package/src/standalone/session-service/quota-resume.mjs +9 -0
- package/src/standalone/session-service/retention/busy.mjs +3 -2
- package/src/standalone/session-service/session-calls/session-action.mjs +51 -1
- package/src/standalone/session-service/session-calls/session-turns.mjs +37 -18
- package/src/standalone/session-service/session-calls/turn-gate.mjs +34 -0
- package/src/standalone/session-service/session-calls.mjs +2 -1
- package/src/tui/App.jsx +8 -0
- package/src/tui/app/clipboard.mjs +1 -1
- package/src/tui/app/create-app-pickers.mjs +2 -0
- package/src/tui/app/doctor.mjs +2 -2
- package/src/tui/app/model-picker/model-footer.mjs +1 -1
- package/src/tui/app/model-picker/provider-models-list.mjs +7 -3
- package/src/tui/app/model-picker/route-selection/fast-parameters.mjs +23 -3
- package/src/tui/app/model-picker/route-selection.mjs +1 -0
- package/src/tui/app/panel-signature.mjs +1 -1
- package/src/tui/app/settings-picker.mjs +53 -8
- package/src/tui/app/shell-layout/row-budgets.mjs +2 -2
- package/src/tui/app/slash-commands.mjs +1 -1
- package/src/tui/app/slash-dispatch/route-commands.mjs +1 -1
- package/src/tui/app/slash-dispatch/session-commands.mjs +1 -1
- package/src/tui/app/use-prompt-queue-history.mjs +2 -2
- package/src/tui/app/use-transcript-activity.mjs +1 -1
- package/src/tui/app/use-transcript-window/geometry.mjs +1 -1
- package/src/tui/components/prompt-input/escape-policy.d.mts +0 -1
- package/src/tui/components/prompt-input/escape-policy.mjs +1 -1
- package/src/tui/components/question-panel-model.mjs +4 -4
- package/src/tui/components/tool-execution/standard-card.jsx +3 -4
- package/src/tui/components/user-message-skills.mjs +1 -1
- package/src/tui/dist/index.mjs +350 -37
- package/src/tui/markdown/render-ansi.mjs +1 -1
- package/src/tui/session/agent-job-feed/notification-router.mjs +10 -0
- package/src/tui/session/agent-job-feed.mjs +2 -0
- package/src/tui/session/context-state.mjs +3 -0
- package/src/tui/session/quota-resume.mjs +1 -1
- package/src/tui/session/session-api/integrations.mjs +3 -0
- package/src/tui/session/session-api/lifecycle/dispose.mjs +1 -0
- package/src/tui/session/session-api/lifecycle/session-reset.mjs +7 -0
- package/src/tui/session/session-api/routes-agent-definitions.mjs +5 -0
- package/src/tui/session/session-api/worktree.mjs +13 -1
- package/src/tui/session/session-flow/drain.mjs +11 -14
- package/src/tui/session/tool-approval-settle.mjs +24 -4
- package/src/tui/session/tool-approval.mjs +35 -10
- package/src/tui/session/tool-card-results/grouped-result.mjs +2 -2
- package/src/tui/session/turn-quiet.mjs +1 -1
- package/src/tui/session/turn.mjs +3 -0
- package/src/tui/session/worktree-setup-notice.mjs +1 -1
- package/src/tui/spinner-meta.mjs +3 -3
- package/src/tui/spinner-verbs.mjs +2 -2
- package/src/defaults/skills/goal-management/SKILL.md +0 -169
- package/src/runtime/agent/orchestrator/runtime-core/goal-tasks.mjs +0 -156
- package/src/session-runtime/goal-tasks.mjs +0 -1
|
@@ -4,38 +4,21 @@
|
|
|
4
4
|
* should continue, and retiring finished work on the next user prompt.
|
|
5
5
|
*/
|
|
6
6
|
import { continuationPrompt } from './goal-text.mjs';
|
|
7
|
-
import { GOAL_TASK_SETTLED } from './goal-tool-defs.mjs';
|
|
8
7
|
import {
|
|
9
8
|
assertSessionId,
|
|
10
9
|
checkpointActiveClock,
|
|
11
10
|
clearTurnFailures,
|
|
12
|
-
publicGoal,
|
|
13
11
|
resumeGoalState,
|
|
14
|
-
runningAgentWork,
|
|
15
12
|
startActiveClock,
|
|
16
13
|
stopActiveClock,
|
|
17
14
|
} from './goal-state.mjs';
|
|
18
15
|
import { goalFinished } from './goal-mutations.mjs';
|
|
19
|
-
import {
|
|
16
|
+
import { awaitingBackgroundWork } from '../../../shared/background-wait.mjs';
|
|
20
17
|
import { clean } from '../../../shared/clean.mjs';
|
|
21
18
|
|
|
22
|
-
//
|
|
23
|
-
//
|
|
24
|
-
|
|
25
|
-
function settledDurationWait(goal) {
|
|
26
|
-
return (
|
|
27
|
-
goal?.status === 'active' &&
|
|
28
|
-
goal.timeMode === 'duration' &&
|
|
29
|
-
goal.remainingMs > 0 &&
|
|
30
|
-
!goal.needsTaskReview &&
|
|
31
|
-
goal.tasks.length > 0 &&
|
|
32
|
-
goal.tasks.every((task) => GOAL_TASK_SETTLED.includes(task.status))
|
|
33
|
-
);
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
// The review is spent per Goal, turn, and actionable revision: a resumed,
|
|
37
|
-
// re-scoped, or re-planned Goal earns a fresh one without any extra clearing.
|
|
38
|
-
const idleReviewKey = (goal) => `${goal.id}:${goal.turnCount}:${goal.revision}`;
|
|
19
|
+
// The no-progress wait is spent per Goal and turn: the next user turn (or a
|
|
20
|
+
// resume, which starts a new turn) earns a fresh continuation.
|
|
21
|
+
const idleReviewKey = (goal) => `${goal.id}:${goal.turnCount}`;
|
|
39
22
|
|
|
40
23
|
// An automatic turn that called no tool answered its prompt without progress.
|
|
41
24
|
// Asking again over the same list only repeats that answer every few seconds
|
|
@@ -52,16 +35,8 @@ function automaticTurnWithoutActivity(detail, goal) {
|
|
|
52
35
|
|
|
53
36
|
// Continuation prompts are enqueued as meta user messages, so a delivered rules
|
|
54
37
|
// block stays in the transcript until the context is compacted or rewound. The
|
|
55
|
-
// marker records which Goal's rules are already there: a new session or Goal,
|
|
56
|
-
//
|
|
57
|
-
function needsFullContinuationRules(markedGoalId, goal) {
|
|
58
|
-
return markedGoalId !== goal.id || goal.needsTaskReview === true;
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
// A durable list drifts out of attention after roughly ten quiet turns — the
|
|
62
|
-
// staleness cadence task-reminder surfaces settle on across the industry — so
|
|
63
|
-
// the state block returns on that count rather than on an arbitrary period.
|
|
64
|
-
const GOAL_STATE_REMINDER_QUIET_TURNS = 10;
|
|
38
|
+
// marker records which Goal's rules are already there: a new session or Goal,
|
|
39
|
+
// or an explicit reset (compaction, objective edit) re-sends them.
|
|
65
40
|
|
|
66
41
|
/** Fold a settled turn's outcome (usage limit, cancel, failure, or a clean
|
|
67
42
|
* finish) into the Goal status and clocks. */
|
|
@@ -103,7 +78,7 @@ function applyTurnOutcome(goal, detail, at) {
|
|
|
103
78
|
if (goal.timeLimitMs > 0 && goal.timeUsedMs >= goal.timeLimitMs) {
|
|
104
79
|
stopActiveClock(goal, at);
|
|
105
80
|
goal.status = 'duration_reached';
|
|
106
|
-
goal.timeUsedMs =
|
|
81
|
+
goal.timeUsedMs = goal.timeLimitMs;
|
|
107
82
|
}
|
|
108
83
|
}
|
|
109
84
|
|
|
@@ -112,6 +87,7 @@ export function createGoalTurnLifecycle(ctx) {
|
|
|
112
87
|
now,
|
|
113
88
|
turnGoalIds,
|
|
114
89
|
turnStartedAt,
|
|
90
|
+
turnObjectiveRevisions,
|
|
115
91
|
idleReviewTurns,
|
|
116
92
|
continuationTiers,
|
|
117
93
|
unsavedStops,
|
|
@@ -129,22 +105,19 @@ export function createGoalTurnLifecycle(ctx) {
|
|
|
129
105
|
if (!goal || goal.archivedAt) {
|
|
130
106
|
turnGoalIds.delete(id);
|
|
131
107
|
turnStartedAt.delete(id);
|
|
108
|
+
turnObjectiveRevisions.delete(id);
|
|
132
109
|
return null;
|
|
133
110
|
}
|
|
134
111
|
const at = now();
|
|
135
112
|
turnGoalIds.set(id, goal.id);
|
|
136
113
|
turnStartedAt.set(id, at);
|
|
137
|
-
|
|
114
|
+
turnObjectiveRevisions.set(id, goal.objectiveRevision);
|
|
138
115
|
if (goal.status !== 'active') return visibleSnapshot(id);
|
|
139
116
|
goal.turnCount = Math.max(0, Math.floor(Number(goal.turnCount) || 0)) + 1;
|
|
140
117
|
startActiveClock(goal, at);
|
|
141
118
|
goal.updatedAt = at;
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
// the next continuation waits instead of asking again unchanged.
|
|
145
|
-
if (settledDurationWait(published)) idleReviewTurns.set(id, idleReviewKey(published));
|
|
146
|
-
else idleReviewTurns.delete(id);
|
|
147
|
-
return published;
|
|
119
|
+
idleReviewTurns.delete(id);
|
|
120
|
+
return commit(id, goal);
|
|
148
121
|
});
|
|
149
122
|
},
|
|
150
123
|
settleTurn(sessionId, detail = {}) {
|
|
@@ -152,6 +125,7 @@ export function createGoalTurnLifecycle(ctx) {
|
|
|
152
125
|
const expectedGoalId = turnGoalIds.get(id) || '';
|
|
153
126
|
turnGoalIds.delete(id);
|
|
154
127
|
turnStartedAt.delete(id);
|
|
128
|
+
turnObjectiveRevisions.delete(id);
|
|
155
129
|
const goal = readRecord(id).goal;
|
|
156
130
|
// commit() returns the record even when it is archived, so a settled
|
|
157
131
|
// turn on retired work would republish the capsule the user's prompt
|
|
@@ -192,50 +166,21 @@ export function createGoalTurnLifecycle(ctx) {
|
|
|
192
166
|
return commit(id, goal, options);
|
|
193
167
|
});
|
|
194
168
|
},
|
|
195
|
-
|
|
169
|
+
// `todo`: the session's open step list, carried in every continuation.
|
|
170
|
+
continuation(sessionId, { agentStatus = null, todo = '' } = {}) {
|
|
196
171
|
const goal = visibleSnapshot(sessionId);
|
|
197
172
|
if (goal?.status !== 'active') return { run: false, reason: goal?.status || 'missing', goal };
|
|
198
|
-
if (runningAgentWork(agentStatus)) return { run: false, reason: 'agent-running', goal };
|
|
199
173
|
const id = assertSessionId(sessionId);
|
|
174
|
+
// The same wait rule as the todo completion check: a running agent or
|
|
175
|
+
// an awaited background shell wakes the session when it ends.
|
|
176
|
+
if (awaitingBackgroundWork({ sessionId: id, agentStatus })) return { run: false, reason: 'awaiting-work', goal };
|
|
200
177
|
if (unsavedStops.get(id) === goal.id) return { run: false, reason: 'unsaved-stop', goal };
|
|
201
|
-
|
|
202
|
-
if (settledDurationWait(goal)) {
|
|
203
|
-
// The model already answered this exact list with no new work, so the
|
|
204
|
-
// deadline timer owns the rest of the wait and delivers closeout;
|
|
205
|
-
// task/scope changes still publish and wake newly actionable work.
|
|
206
|
-
if (answered) return { run: false, reason: 'duration-wait', goal };
|
|
207
|
-
// One turn to spend the remaining duration on new work or to park
|
|
208
|
-
// approval-dependent work: idling it away is not the requested wait.
|
|
209
|
-
// This turn has to decide the rest of the duration, so it carries the
|
|
210
|
-
// full rules that decision is judged against.
|
|
211
|
-
continuationTiers.set(id, { goalId: goal.id, revision: goal.revision, quietTurns: 0 });
|
|
212
|
-
return { run: true, reason: 'idle-review', goal, prompt: continuationPrompt(goal, { idleReview: true }) };
|
|
213
|
-
}
|
|
214
|
-
// The same wait for an unfinished list: a task change, a user turn, or
|
|
178
|
+
// An automatic turn already answered with no tool call: a user turn or
|
|
215
179
|
// the deadline's closeout starts the next Goal turn.
|
|
216
|
-
if (
|
|
217
|
-
const
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
return { run: true, reason: 'idle', goal, prompt: continuationPrompt(goal) };
|
|
221
|
-
}
|
|
222
|
-
// A changed revision means the model mutated tasks last turn and holds
|
|
223
|
-
// the fresh list in its own tool result; repeating it buys nothing. The
|
|
224
|
-
// state block returns only once the list has gone unread long enough to
|
|
225
|
-
// drift out of attention.
|
|
226
|
-
const quietTurns = entry.revision === goal.revision ? entry.quietTurns + 1 : 0;
|
|
227
|
-
const includeState = quietTurns >= GOAL_STATE_REMINDER_QUIET_TURNS;
|
|
228
|
-
continuationTiers.set(id, {
|
|
229
|
-
goalId: goal.id,
|
|
230
|
-
revision: goal.revision,
|
|
231
|
-
quietTurns: includeState ? 0 : quietTurns,
|
|
232
|
-
});
|
|
233
|
-
return {
|
|
234
|
-
run: true,
|
|
235
|
-
reason: 'idle',
|
|
236
|
-
goal,
|
|
237
|
-
prompt: continuationPrompt(goal, { includeRules: false, includeState }),
|
|
238
|
-
};
|
|
180
|
+
if (idleReviewTurns.get(id) === idleReviewKey(goal)) return { run: false, reason: 'no-progress-wait', goal };
|
|
181
|
+
const includeRules = continuationTiers.get(id) !== goal.id;
|
|
182
|
+
continuationTiers.set(id, goal.id);
|
|
183
|
+
return { run: true, reason: 'idle', goal, prompt: continuationPrompt(goal, { includeRules, todo }) };
|
|
239
184
|
},
|
|
240
185
|
resetContinuationRules(sessionId) {
|
|
241
186
|
continuationTiers.delete(assertSessionId(sessionId));
|
|
@@ -1,60 +1,81 @@
|
|
|
1
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
1
3
|
import { normalizeOrchestrationMode } from '../../../shared/orchestration.mjs';
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
focused: `Lead executes the main scope directly. Delegate only substantial,
|
|
5
|
-
self-contained supporting work, one agent per role; batch related tasks
|
|
6
|
-
rather than splitting them for parallelism.`,
|
|
7
|
-
balanced: `Delegate independent work by coherent feature or module, one agent per
|
|
8
|
-
scope; a scope is one verifiable deliverable. Batch related tasks within the
|
|
9
|
-
same change scope rather than splitting every file or step.`,
|
|
10
|
-
swarm: `Delegate every independent scope to its own agent; a scope is one
|
|
11
|
-
verifiable deliverable, not a bundle of steps. Treat disjoint file or
|
|
12
|
-
module sets as independent and merge scopes only on a true output
|
|
13
|
-
dependency.`,
|
|
14
|
-
};
|
|
15
|
-
|
|
16
|
-
const SOLO = `# Orchestration Mode: Solo
|
|
17
|
-
|
|
18
|
-
Lead executes all work directly and never delegates on its own judgment.
|
|
19
|
-
Only when the user explicitly asks for delegation, load the deferred \`agent\`
|
|
20
|
-
tool and brief each agent as the Lead rules describe.`;
|
|
4
|
+
import { mixdogRoot, resolvePluginData } from '../../../shared/plugin-paths.mjs';
|
|
5
|
+
import { decodeInstructionFile } from '../../../../lib/instruction-text.cjs';
|
|
21
6
|
|
|
22
7
|
/** Agent mode's fixed delegation block, in place of the orchestration mode. */
|
|
23
8
|
export const AGENT_MODE_DELEGATION = `# Delegation
|
|
24
9
|
|
|
25
|
-
Handle conversation yourself.
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
10
|
+
Handle conversation yourself. Do quick lookups and small edits yourself. Hand
|
|
11
|
+
self-contained investigation, writing or implementation to sub-agents
|
|
12
|
+
(\`agent\`); their reports return to this chat. Open a new agent task session
|
|
13
|
+
(\`session create\`) only for a big plan, multi-step work across many files or
|
|
14
|
+
stages that needs its own Lead, with a self-contained brief: start it when
|
|
15
|
+
already requested, otherwise suggest it. Then relay the result in your own
|
|
16
|
+
words. Promise a follow-up only when the session result allows it.`;
|
|
29
17
|
|
|
30
18
|
/** An agent-mode Lead's contact catalog intro: the user's other bots. */
|
|
31
19
|
export const MIXY_CONTACTS_INTRO = `The user's other bots. Hand one a request with \`session send\` to its chat and a
|
|
32
20
|
self-contained brief.`;
|
|
33
21
|
|
|
34
|
-
|
|
22
|
+
const modeFileName = (mode) => `${normalizeOrchestrationMode(mode)}.md`;
|
|
23
|
+
|
|
24
|
+
/** The shipped mode file (<root>/orchestration/<mode>.md). */
|
|
25
|
+
export const shippedOrchestrationPath = (mode) => join(mixdogRoot(), 'orchestration', modeFileName(mode));
|
|
26
|
+
/** The user's replacement (<data>/orchestration/<mode>.md). */
|
|
27
|
+
export const userOrchestrationPath = (mode) => join(resolvePluginData(), 'orchestration', modeFileName(mode));
|
|
28
|
+
|
|
29
|
+
// A file's text (CRLF → LF, trailing whitespace trimmed), null when it does not
|
|
30
|
+
// exist, or { problem } when it cannot serve as the prompt (instruction-text.cjs).
|
|
31
|
+
// promptRulesRevision reads every mode on each check, so a read is reused while
|
|
32
|
+
// the file's identity (mtime, ctime, inode, size) is unchanged — but only once
|
|
33
|
+
// the file is older than the timestamp granularity: a file written moments ago
|
|
34
|
+
// can change again within the same tick without any of those moving.
|
|
35
|
+
const SETTLED_MS = 2000;
|
|
36
|
+
const fileCache = new Map();
|
|
37
|
+
export function readInstructionFile(file) {
|
|
38
|
+
let stat;
|
|
39
|
+
try {
|
|
40
|
+
stat = statSync(file);
|
|
41
|
+
} catch (error) {
|
|
42
|
+
return error?.code === 'ENOENT' || error?.code === 'ENOTDIR' ? null : { problem: 'unreadable' };
|
|
43
|
+
}
|
|
44
|
+
const key = `${stat.mtimeMs}:${stat.ctimeMs}:${stat.ino}:${stat.size}`;
|
|
45
|
+
const hit = fileCache.get(file);
|
|
46
|
+
if (hit?.key === key && hit.settled) return hit.value;
|
|
47
|
+
let value;
|
|
48
|
+
try {
|
|
49
|
+
if (!stat.isFile()) value = { problem: 'unreadable' };
|
|
50
|
+
else {
|
|
51
|
+
const decoded = decodeInstructionFile(readFileSync(file));
|
|
52
|
+
value = decoded.problem ? decoded : { text: decoded.text.replace(/\r\n/g, '\n').trimEnd() };
|
|
53
|
+
}
|
|
54
|
+
} catch {
|
|
55
|
+
value = { problem: 'unreadable' };
|
|
56
|
+
}
|
|
57
|
+
fileCache.set(file, { key, value, settled: Date.now() - stat.mtimeMs > SETTLED_MS });
|
|
58
|
+
return value;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Where a mode's text comes from: the user's file when it is usable, else the
|
|
63
|
+
* shipped one. `problem` says why a user file that exists was passed over
|
|
64
|
+
* (empty, too-large, not-text, unreadable); `text` is the prompt text.
|
|
65
|
+
*/
|
|
66
|
+
function orchestrationModeSource(value) {
|
|
35
67
|
const mode = normalizeOrchestrationMode(value);
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
const
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
to spell out the edits themselves — a few localized changes whose sites Lead
|
|
50
|
-
already holds — Lead makes them directly in every mode; the number of files or
|
|
51
|
-
scopes does not change this.
|
|
52
|
-
|
|
53
|
-
Dispatch all ready independent scopes in one turn. Only a scope that requires
|
|
54
|
-
another's output waits. At most two building or testing scopes run at
|
|
55
|
-
once.
|
|
56
|
-
A new independent need goes to a new agent. When scopes touch the same file, name one owner for
|
|
57
|
-
that file in each brief.
|
|
58
|
-
Use only available agents; when none fits a role, Lead does that work itself
|
|
59
|
-
and never changes settings to enable one.`;
|
|
68
|
+
const user = readInstructionFile(userOrchestrationPath(mode));
|
|
69
|
+
if (user?.text) return { mode, source: 'user', text: user.text };
|
|
70
|
+
const shipped = readInstructionFile(shippedOrchestrationPath(mode));
|
|
71
|
+
return {
|
|
72
|
+
mode,
|
|
73
|
+
source: 'default',
|
|
74
|
+
text: shipped?.text ?? '',
|
|
75
|
+
...(user?.problem ? { problem: user.problem } : {}),
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
export function orchestrationInstructions(value) {
|
|
80
|
+
return orchestrationModeSource(value).text;
|
|
60
81
|
}
|
|
@@ -0,0 +1,367 @@
|
|
|
1
|
+
// The per-owner step list behind the `todo` tool. One list lives on each
|
|
2
|
+
// session record (`session.todo`: the Lead session, and each agent session),
|
|
3
|
+
// so it is saved with the session, survives a daemon restart and compaction,
|
|
4
|
+
// and is never shared between a Lead and its agents.
|
|
5
|
+
//
|
|
6
|
+
// Every mutation replaces `session.todo` with a new object: the published
|
|
7
|
+
// snapshot is memoized by that identity, and change listeners republish it.
|
|
8
|
+
import { emitSessionActivityChange } from '../../../shared/session-activity-signal.mjs';
|
|
9
|
+
import { MAX_TODO_ITEMS, MAX_TODO_TEXT_LENGTH, TODO_OPS, TODO_STATUSES } from './todo-tool-defs.mjs';
|
|
10
|
+
|
|
11
|
+
const DEFAULT_TODO_PHASE = 'Tasks';
|
|
12
|
+
const OPEN_STATUSES = new Set(['pending', 'in_progress']);
|
|
13
|
+
const listeners = new Set();
|
|
14
|
+
const snapshots = new WeakMap();
|
|
15
|
+
|
|
16
|
+
const oneLine = (value) =>
|
|
17
|
+
String(value ?? '')
|
|
18
|
+
.replace(/\s+/g, ' ')
|
|
19
|
+
.trim();
|
|
20
|
+
|
|
21
|
+
function itemText(value, what = 'item') {
|
|
22
|
+
const text = oneLine(value);
|
|
23
|
+
if (!text) throw new Error(`todo: ${what} wording is required`);
|
|
24
|
+
if ([...text].length > MAX_TODO_TEXT_LENGTH) {
|
|
25
|
+
throw new Error(`todo: ${what} exceeds ${MAX_TODO_TEXT_LENGTH} characters`);
|
|
26
|
+
}
|
|
27
|
+
return text;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function normalizeTask(raw) {
|
|
31
|
+
if (!raw || typeof raw !== 'object') return null;
|
|
32
|
+
const content = oneLine(raw.content);
|
|
33
|
+
if (!content) return null;
|
|
34
|
+
const status = TODO_STATUSES.includes(raw.status) ? raw.status : 'pending';
|
|
35
|
+
const task = { content, status };
|
|
36
|
+
if (status === 'blocked' && oneLine(raw.blocker)) task.blocker = oneLine(raw.blocker);
|
|
37
|
+
if (oneLine(raw.note)) task.note = oneLine(raw.note);
|
|
38
|
+
return task;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** The session's phases, normalized (stored records are untrusted). */
|
|
42
|
+
export function todoPhases(session) {
|
|
43
|
+
const phases = Array.isArray(session?.todo?.phases) ? session.todo.phases : [];
|
|
44
|
+
return phases
|
|
45
|
+
.map((phase) => ({
|
|
46
|
+
name: oneLine(phase?.name) || DEFAULT_TODO_PHASE,
|
|
47
|
+
tasks: (Array.isArray(phase?.tasks) ? phase.tasks : []).map(normalizeTask).filter(Boolean),
|
|
48
|
+
}))
|
|
49
|
+
.filter((phase) => phase.tasks.length > 0);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
const allTasks = (phases) => phases.flatMap((phase) => phase.tasks);
|
|
53
|
+
|
|
54
|
+
/** Exactly one in_progress while actionable work exists: several keep the
|
|
55
|
+
* earliest, none starts the earliest pending. Blocked never starts itself. */
|
|
56
|
+
function normalizeTodoPhases(phases) {
|
|
57
|
+
const tasks = allTasks(phases);
|
|
58
|
+
const active = tasks.filter((task) => task.status === 'in_progress');
|
|
59
|
+
for (const task of active.slice(1)) task.status = 'pending';
|
|
60
|
+
if (active.length === 0) {
|
|
61
|
+
const next = tasks.find((task) => task.status === 'pending');
|
|
62
|
+
if (next) next.status = 'in_progress';
|
|
63
|
+
}
|
|
64
|
+
return phases.filter((phase) => phase.tasks.length > 0);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function todoCounts(phases) {
|
|
68
|
+
const tasks = allTasks(phases);
|
|
69
|
+
return {
|
|
70
|
+
completed: tasks.filter((task) => task.status === 'completed').length,
|
|
71
|
+
abandoned: tasks.filter((task) => task.status === 'abandoned').length,
|
|
72
|
+
total: tasks.length,
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** Pending and in-progress items: the work the completion check asks about. */
|
|
77
|
+
export function openTodoItems(session) {
|
|
78
|
+
return allTasks(todoPhases(session)).filter((task) => OPEN_STATUSES.has(task.status));
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** Every item not completed or dropped (blocked included): what an agent
|
|
82
|
+
* leaves undone when it ends. */
|
|
83
|
+
export function unfinishedTodoItems(session) {
|
|
84
|
+
return allTasks(todoPhases(session)).filter((task) => task.status !== 'completed' && task.status !== 'abandoned');
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** The published session snapshot; null for an empty list. Identity-stable
|
|
88
|
+
* while the list is unchanged. */
|
|
89
|
+
export function todoSnapshot(session) {
|
|
90
|
+
const record = session?.todo;
|
|
91
|
+
if (!record || typeof record !== 'object') return null;
|
|
92
|
+
if (snapshots.has(record)) return snapshots.get(record);
|
|
93
|
+
const phases = todoPhases(session);
|
|
94
|
+
const snapshot = phases.length ? { phases, ...todoCounts(phases) } : null;
|
|
95
|
+
snapshots.set(record, snapshot);
|
|
96
|
+
return snapshot;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** Agent status rows: `{ completed, total, current? }`, or null. */
|
|
100
|
+
export function todoProgress(session) {
|
|
101
|
+
const snapshot = todoSnapshot(session);
|
|
102
|
+
if (!snapshot) return null;
|
|
103
|
+
const current = allTasks(snapshot.phases).find((task) => task.status === 'in_progress')?.content;
|
|
104
|
+
// Rows show completed/total directly, so dropped items leave the total.
|
|
105
|
+
return {
|
|
106
|
+
completed: snapshot.completed,
|
|
107
|
+
total: snapshot.total - snapshot.abandoned,
|
|
108
|
+
...(current ? { current } : {}),
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
export function onTodoChange(listener) {
|
|
113
|
+
if (typeof listener !== 'function') return () => {};
|
|
114
|
+
listeners.add(listener);
|
|
115
|
+
return () => listeners.delete(listener);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/** A list with items, every one completed or dropped. */
|
|
119
|
+
export function todoAllClosed(session) {
|
|
120
|
+
return todoPhases(session).length > 0 && unfinishedTodoItems(session).length === 0;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** Let go of the session's list. */
|
|
124
|
+
export function clearTodo(session, at = Date.now()) {
|
|
125
|
+
session.todo = null;
|
|
126
|
+
session.updatedAt = at;
|
|
127
|
+
publish(session);
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
function commitPhases(session, phases, at = Date.now()) {
|
|
131
|
+
session.todo = { phases, updatedAt: at };
|
|
132
|
+
session.updatedAt = at;
|
|
133
|
+
publish(session);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
function publish(session) {
|
|
137
|
+
// The Agents pool shows each agent's progress: it re-reads on this pulse.
|
|
138
|
+
emitSessionActivityChange(session.id || '');
|
|
139
|
+
for (const listener of [...listeners]) {
|
|
140
|
+
try {
|
|
141
|
+
listener({ sessionId: session.id || null, todo: todoSnapshot(session) });
|
|
142
|
+
} catch {
|
|
143
|
+
/* a listener never breaks the tool */
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
const MARKS = { completed: 'x', in_progress: '>', pending: ' ', blocked: '!', abandoned: '-' };
|
|
149
|
+
|
|
150
|
+
function progressLabel(phases) {
|
|
151
|
+
const { completed, abandoned, total } = todoCounts(phases);
|
|
152
|
+
return `${completed}/${total - abandoned}`;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
/** The whole list as text: init/view replies and context re-injection. */
|
|
156
|
+
function renderTodoList(phases) {
|
|
157
|
+
if (!phases.length) return 'todo: empty';
|
|
158
|
+
const lines = [progressLabel(phases)];
|
|
159
|
+
for (const phase of phases) {
|
|
160
|
+
lines.push(phase.name);
|
|
161
|
+
for (const task of phase.tasks) {
|
|
162
|
+
const detail = task.blocker ? ` — blocked: ${task.blocker}` : task.note ? ` — ${task.note}` : '';
|
|
163
|
+
lines.push(` [${MARKS[task.status]}] ${task.content}${detail}`);
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
return lines.join('\n');
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function summaryLine(phases, op, content) {
|
|
170
|
+
const tasks = allTasks(phases);
|
|
171
|
+
const parts = [progressLabel(phases), `${op}: ${content}`];
|
|
172
|
+
const current = tasks.find((task) => task.status === 'in_progress');
|
|
173
|
+
if (current) parts.push(`next: ${current.content}`);
|
|
174
|
+
else if (tasks.some((task) => task.status === 'blocked')) parts.push('next: none (blocked items wait)');
|
|
175
|
+
else parts.push('all closed');
|
|
176
|
+
return parts.join(' · ');
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
function initPhases(args) {
|
|
180
|
+
let source;
|
|
181
|
+
if (Array.isArray(args.phases) && args.phases.length) source = args.phases;
|
|
182
|
+
else if (Array.isArray(args.items) && args.items.length) {
|
|
183
|
+
source = [{ name: oneLine(args.phase) || DEFAULT_TODO_PHASE, items: args.items }];
|
|
184
|
+
} else throw new Error('todo: init requires items or phases');
|
|
185
|
+
const seen = new Set();
|
|
186
|
+
const phaseNames = new Set();
|
|
187
|
+
const phases = source.map((entry) => {
|
|
188
|
+
const name = itemText(entry?.name, 'phase');
|
|
189
|
+
if (phaseNames.has(name)) throw new Error(`todo: duplicate phase "${name}"`);
|
|
190
|
+
phaseNames.add(name);
|
|
191
|
+
const items = Array.isArray(entry?.items) ? entry.items : [];
|
|
192
|
+
if (!items.length) throw new Error(`todo: phase "${name}" has no items`);
|
|
193
|
+
return {
|
|
194
|
+
name,
|
|
195
|
+
tasks: items.map((raw) => {
|
|
196
|
+
const content = itemText(raw);
|
|
197
|
+
if (seen.has(content)) throw new Error(`todo: duplicate item "${content}"`);
|
|
198
|
+
seen.add(content);
|
|
199
|
+
return { content, status: 'pending' };
|
|
200
|
+
}),
|
|
201
|
+
};
|
|
202
|
+
});
|
|
203
|
+
if (seen.size > MAX_TODO_ITEMS) throw new Error(`todo: at most ${MAX_TODO_ITEMS} items`);
|
|
204
|
+
return phases;
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
function findTask(phases, rawContent) {
|
|
208
|
+
const content = oneLine(rawContent);
|
|
209
|
+
if (!content) throw new Error('todo: item (its exact wording) is required');
|
|
210
|
+
for (const phase of phases) {
|
|
211
|
+
const index = phase.tasks.findIndex((task) => task.content === content);
|
|
212
|
+
if (index >= 0) return { phase, index, task: phase.tasks[index] };
|
|
213
|
+
}
|
|
214
|
+
throw new Error(`todo: no item "${content}"; view the list for exact wordings`);
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
const OPS = {
|
|
218
|
+
start(phases, args) {
|
|
219
|
+
const { task } = findTask(phases, args.item);
|
|
220
|
+
if (task.status === 'completed') throw new Error(`todo: "${task.content}" is completed and stays closed`);
|
|
221
|
+
if (task.status === 'blocked') throw new Error(`todo: "${task.content}" is blocked; unblock it first`);
|
|
222
|
+
for (const other of allTasks(phases)) if (other.status === 'in_progress') other.status = 'pending';
|
|
223
|
+
task.status = 'in_progress';
|
|
224
|
+
return task.content;
|
|
225
|
+
},
|
|
226
|
+
done(phases, args) {
|
|
227
|
+
const { task } = findTask(phases, args.item);
|
|
228
|
+
task.status = 'completed';
|
|
229
|
+
delete task.blocker;
|
|
230
|
+
const note = oneLine(args.note);
|
|
231
|
+
if (note) task.note = note;
|
|
232
|
+
return task.content;
|
|
233
|
+
},
|
|
234
|
+
drop(phases, args) {
|
|
235
|
+
const { task } = findTask(phases, args.item);
|
|
236
|
+
if (task.status === 'completed') throw new Error(`todo: "${task.content}" is completed and stays closed`);
|
|
237
|
+
task.status = 'abandoned';
|
|
238
|
+
delete task.blocker;
|
|
239
|
+
return task.content;
|
|
240
|
+
},
|
|
241
|
+
block(phases, args) {
|
|
242
|
+
const { task } = findTask(phases, args.item);
|
|
243
|
+
if (task.status === 'completed' || task.status === 'abandoned') {
|
|
244
|
+
throw new Error(`todo: "${task.content}" is ${task.status}; only open items can block`);
|
|
245
|
+
}
|
|
246
|
+
task.status = 'blocked';
|
|
247
|
+
task.blocker = itemText(args.reason, 'block reason');
|
|
248
|
+
return task.content;
|
|
249
|
+
},
|
|
250
|
+
unblock(phases, args) {
|
|
251
|
+
const { task } = findTask(phases, args.item);
|
|
252
|
+
if (task.status !== 'blocked') throw new Error(`todo: "${task.content}" is not blocked`);
|
|
253
|
+
task.status = 'pending';
|
|
254
|
+
delete task.blocker;
|
|
255
|
+
return task.content;
|
|
256
|
+
},
|
|
257
|
+
append(phases, args) {
|
|
258
|
+
const items = Array.isArray(args.items) ? args.items.map((raw) => itemText(raw)) : [];
|
|
259
|
+
if (!items.length) throw new Error('todo: append requires items');
|
|
260
|
+
const existing = new Set(allTasks(phases).map((task) => task.content));
|
|
261
|
+
for (const content of items) {
|
|
262
|
+
if (existing.has(content)) throw new Error(`todo: item "${content}" already exists`);
|
|
263
|
+
existing.add(content);
|
|
264
|
+
}
|
|
265
|
+
if (existing.size > MAX_TODO_ITEMS) throw new Error(`todo: at most ${MAX_TODO_ITEMS} items`);
|
|
266
|
+
const name = oneLine(args.phase) || phases.at(-1)?.name || DEFAULT_TODO_PHASE;
|
|
267
|
+
let phase = phases.find((candidate) => candidate.name === name);
|
|
268
|
+
if (!phase) {
|
|
269
|
+
phase = { name, tasks: [] };
|
|
270
|
+
phases.push(phase);
|
|
271
|
+
}
|
|
272
|
+
phase.tasks.push(...items.map((content) => ({ content, status: 'pending' })));
|
|
273
|
+
return items.join(', ');
|
|
274
|
+
},
|
|
275
|
+
rm(phases, args) {
|
|
276
|
+
const { phase, index, task } = findTask(phases, args.item);
|
|
277
|
+
phase.tasks.splice(index, 1);
|
|
278
|
+
return task.content;
|
|
279
|
+
},
|
|
280
|
+
};
|
|
281
|
+
|
|
282
|
+
/** Run one `todo` call against the owner session. Returns the reply text. */
|
|
283
|
+
export function executeTodoTool(session, args = {}) {
|
|
284
|
+
if (!session || typeof session !== 'object') throw new Error('todo: no session owns this call');
|
|
285
|
+
const op = oneLine(args?.op).toLowerCase();
|
|
286
|
+
if (!TODO_OPS.includes(op)) throw new Error(`todo: op must be one of ${TODO_OPS.join(', ')}`);
|
|
287
|
+
if (op === 'view') return renderTodoList(todoPhases(session));
|
|
288
|
+
if (op === 'init') {
|
|
289
|
+
// Replacing a list that still has unfinished work would silently erase it
|
|
290
|
+
// (a follow-up ask re-initing mid-request): make the model close each first.
|
|
291
|
+
const unfinished = unfinishedTodoItems(session);
|
|
292
|
+
if (unfinished.length) {
|
|
293
|
+
const named = unfinished.slice(0, 5).map((task) => `"${task.content}"`);
|
|
294
|
+
if (unfinished.length > named.length) named.push(`${unfinished.length - named.length} more`);
|
|
295
|
+
throw new Error(
|
|
296
|
+
`todo: init would erase unfinished items (${named.join(', ')}); done or drop each first, or append to add asks`
|
|
297
|
+
);
|
|
298
|
+
}
|
|
299
|
+
const phases = normalizeTodoPhases(initPhases(args));
|
|
300
|
+
commitPhases(session, phases);
|
|
301
|
+
return renderTodoList(phases);
|
|
302
|
+
}
|
|
303
|
+
const phases = structuredClone(todoPhases(session));
|
|
304
|
+
if (!phases.length) throw new Error('todo: the list is empty; init it first');
|
|
305
|
+
const content = OPS[op](phases, args);
|
|
306
|
+
const next = normalizeTodoPhases(phases);
|
|
307
|
+
commitPhases(session, next);
|
|
308
|
+
return summaryLine(next, op, content);
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
/** Lines naming what an agent leaves undone, '' when nothing is. */
|
|
312
|
+
export function notDoneReport(session) {
|
|
313
|
+
const unfinished = unfinishedTodoItems(session);
|
|
314
|
+
if (!unfinished.length) return '';
|
|
315
|
+
return [
|
|
316
|
+
'Not done:',
|
|
317
|
+
...unfinished.map((task) => `- ${task.content}${task.blocker ? ` (blocked: ${task.blocker})` : ''}`),
|
|
318
|
+
].join('\n');
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
/** The open list as a hidden reminder (after compaction, or appended to a
|
|
322
|
+
* Goal continuation); '' when nothing is open. */
|
|
323
|
+
export function todoContextBlock(session, lead = 'Open todo items (exact wordings):', { whole = false } = {}) {
|
|
324
|
+
const phases = todoPhases(session);
|
|
325
|
+
if (!phases.length) return '';
|
|
326
|
+
if (!whole && !allTasks(phases).some((task) => task.status !== 'completed' && task.status !== 'abandoned')) {
|
|
327
|
+
return '';
|
|
328
|
+
}
|
|
329
|
+
return ['<todo_state>', lead, renderTodoList(phases), '</todo_state>'].join('\n');
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
// Legacy Goal task statuses as todo statuses.
|
|
333
|
+
const LEGACY_GOAL_TASK_STATUS = {
|
|
334
|
+
pending: 'pending',
|
|
335
|
+
in_progress: 'in_progress',
|
|
336
|
+
completed: 'completed',
|
|
337
|
+
dropped: 'abandoned',
|
|
338
|
+
awaiting_approval: 'blocked',
|
|
339
|
+
};
|
|
340
|
+
|
|
341
|
+
/** Move a legacy Goal record's tasks into the session's list (once; the Goal
|
|
342
|
+
* record drops them afterwards). Items already listed keep their state. */
|
|
343
|
+
export function adoptLegacyGoalTasks(session, legacyTasks) {
|
|
344
|
+
if (!session || !Array.isArray(legacyTasks) || !legacyTasks.length) return false;
|
|
345
|
+
const phases = structuredClone(todoPhases(session));
|
|
346
|
+
const existing = new Set(allTasks(phases).map((task) => task.content));
|
|
347
|
+
const adopted = [];
|
|
348
|
+
for (const raw of legacyTasks) {
|
|
349
|
+
// Migrated wording stays whole (old tasks allowed longer text); the
|
|
350
|
+
// length limit applies only to newly authored items.
|
|
351
|
+
const content = oneLine(raw?.text ?? raw?.content);
|
|
352
|
+
if (!content || existing.has(content)) continue;
|
|
353
|
+
existing.add(content);
|
|
354
|
+
const status = LEGACY_GOAL_TASK_STATUS[oneLine(raw?.status).toLowerCase()] || 'pending';
|
|
355
|
+
adopted.push(status === 'blocked' ? { content, status, blocker: 'awaiting user approval' } : { content, status });
|
|
356
|
+
}
|
|
357
|
+
if (!adopted.length) return false;
|
|
358
|
+
const name = phases.length ? 'Goal' : DEFAULT_TODO_PHASE;
|
|
359
|
+
let phase = phases.find((candidate) => candidate.name === name);
|
|
360
|
+
if (!phase) {
|
|
361
|
+
phase = { name, tasks: [] };
|
|
362
|
+
phases.push(phase);
|
|
363
|
+
}
|
|
364
|
+
phase.tasks.push(...adopted);
|
|
365
|
+
commitPhases(session, normalizeTodoPhases(phases));
|
|
366
|
+
return true;
|
|
367
|
+
}
|