@trenchwork/erosolar 1.1.28 → 1.1.29

package/dist/tools/interactionTools.js

@@ -0,0 +1,207 @@
+/**
+ * AskUserQuestion + PushNotification — agent-callable user-interaction tools.
+ *
+ * AskUserQuestion presents structured single/multi-select prompts. The
+ * user's answer comes back as the tool result. The CLI surface uses
+ * src/utils/askUserPrompt for rendering; in non-interactive contexts
+ * (HITL pause / portal-driven runs) the prompt is queued for the host.
+ *
+ * PushNotification fires an OS-native desktop notification — useful
+ * when the agent is running detached (long fuzz job, scheduled run)
+ * and wants to flag the user without stealing focus.
+ */
+import { execFile, execFileSync } from 'node:child_process';
+import { platform } from 'node:os';
+import { createInterface } from 'node:readline';
+import { formatAskUserPrompt } from '../utils/askUserPrompt.js';
+import { callLambda } from '../utils/lambdaClient.js';
+const MAX_OPTIONS = 9;
+function parseSelection(raw, optionCount, multiSelect) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return [];
+    const tokens = multiSelect ? trimmed.split(/[,\s]+/) : [trimmed];
+    const out = [];
+    for (const token of tokens) {
+        const idx = Number.parseInt(token, 10) - 1;
+        if (Number.isFinite(idx) && idx >= 0 && idx < optionCount) {
+            out.push(idx);
+        }
+    }
+    return Array.from(new Set(out));
+}
+async function askViaPortal(question, header, options, multiSelect, timeoutMs) {
+    // Push the question to Firestore via Lambda; the portal renders it
+    // under the "Pending questions" panel. The user clicks an answer,
+    // which writes back through cliQuestionAnswer; we poll until the
+    // doc says answered or we hit the timeout.
+    const created = await callLambda('cliQuestionCreate', {
+        question, header, multiSelect, options,
+    });
+    if (!created.ok || !created.result?.id) {
+        return { selected: [], cancelled: true };
+    }
+    const id = created.result.id;
+    const deadline = Date.now() + timeoutMs;
+    const interval = 1500;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, interval));
+        const polled = await callLambda('cliQuestionPoll', { id });
+        if (polled.ok && polled.result?.found && polled.result.answered) {
+            return { selected: polled.result.selected ?? [], cancelled: false };
+        }
+    }
+    return { selected: [], cancelled: true };
+}
+async function askInternal(question, header, options, multiSelect) {
+    if (!process.stdin.isTTY) {
+        // HITL bridge: ask through the portal. 10-minute timeout by default
+        // so a forgotten detached agent eventually returns rather than
+        // hanging forever.
+        if (process.env['EROSOLAR_DISABLE_PORTAL_HITL'] === '1') {
+            return { selected: [], cancelled: true };
+        }
+        return askViaPortal(question, header, options, multiSelect, 10 * 60 * 1000);
+    }
+    const formatted = formatAskUserPrompt({ question, header, options, multiSelect });
+    process.stdout.write(formatted.lines.join('\n') + '\n');
+    process.stdout.write(multiSelect
+        ? 'Enter option numbers (comma-separated), or blank to cancel: '
+        : 'Enter option number, or blank to cancel: ');
+    const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+    try {
+        const line = await new Promise((resolve) => {
+            rl.once('line', (l) => resolve(l));
+            rl.once('close', () => resolve(''));
+        });
+        const indices = parseSelection(line, options.length, multiSelect);
+        if (indices.length === 0)
+            return { selected: [], cancelled: true };
+        return { selected: indices.map((i) => options[i].label), cancelled: false };
+    }
+    finally {
+        rl.close();
+    }
+}
+function notifyLinux(title, body) {
+    try {
+        execFileSync('notify-send', ['--', title, body], {
+            stdio: ['ignore', 'ignore', 'ignore'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function notifyMac(title, body) {
+    // osascript is built into macOS; no extra install required.
+    const escapedTitle = title.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    const escapedBody = body.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    const script = `display notification "${escapedBody}" with title "${escapedTitle}"`;
+    try {
+        execFileSync('osascript', ['-e', script], { stdio: ['ignore', 'ignore', 'ignore'] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function notifyFallback(title, body) {
+    // Last resort: ring the bell + write the title/body to stderr so the
+    // user at least sees it in the active terminal session.
+    process.stderr.write(`\x07[notify] ${title}\n${body}\n`);
+}
+export async function pushNotification(title, body) {
+    const t = title.trim();
+    const b = body.trim();
+    if (!t)
+        return 'fallback';
+    const os = platform();
+    if (os === 'linux' && notifyLinux(t, b))
+        return 'os';
+    if (os === 'darwin' && notifyMac(t, b))
+        return 'os';
+    notifyFallback(t, b);
+    return 'fallback';
+}
+export function createInteractionTools() {
+    return [
+        {
+            name: 'AskUserQuestion',
+            description: 'Ask the user a structured question (single or multi-select). ' +
+                'Use to disambiguate scope, pick between trade-offs, or confirm ' +
+                'an irreversible action. Each option needs a label + description.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    question: { type: 'string', description: 'The full question (≤200 chars).' },
+                    header: { type: 'string', description: 'Short label (≤24 chars).' },
+                    multiSelect: { type: 'boolean', description: 'Allow multiple answers.' },
+                    options: {
+                        type: 'array',
+                        description: `Between 2 and ${MAX_OPTIONS} options. Each: { label, description }.`,
+                        items: {
+                            type: 'object',
+                            properties: {
+                                label: { type: 'string' },
+                                description: { type: 'string' },
+                            },
+                            required: ['label', 'description'],
+                        },
+                    },
+                },
+                required: ['question', 'header', 'options'],
+            },
+            handler: async (args) => {
+                const question = String(args['question'] ?? '').trim();
+                const header = String(args['header'] ?? '').trim().slice(0, 24);
+                const multiSelect = Boolean(args['multiSelect']);
+                const rawOptions = Array.isArray(args['options']) ? args['options'] : [];
+                if (!question)
+                    return 'AskUserQuestion requires `question`.';
+                if (rawOptions.length < 2 || rawOptions.length > MAX_OPTIONS) {
+                    return `AskUserQuestion requires 2..${MAX_OPTIONS} options.`;
+                }
+                const options = rawOptions.map((raw) => {
+                    const r = (raw ?? {});
+                    return {
+                        label: String(r['label'] ?? '').trim() || '(unlabeled)',
+                        description: String(r['description'] ?? '').trim(),
+                    };
+                });
+                const answer = await askInternal(question, header, options, multiSelect);
+                if (answer.cancelled)
+                    return 'User cancelled the question.';
+                return JSON.stringify({ selected: answer.selected });
+            },
+        },
+        {
+            name: 'PushNotification',
+            description: 'Fire an OS-native desktop notification (Linux notify-send / macOS ' +
+                'osascript). Use when the agent is running detached and wants to ' +
+                'flag the user without stealing focus. Falls back to terminal-bell ' +
+                '+ stderr if no native channel is available.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Short notification title.' },
+                    body: { type: 'string', description: 'Body text.' },
+                },
+                required: ['title'],
+            },
+            handler: async (args) => {
+                const title = String(args['title'] ?? '').trim();
+                if (!title)
+                    return 'PushNotification requires a title.';
+                const body = String(args['body'] ?? '').trim();
+                const channel = await pushNotification(title, body);
+                return `Notification dispatched (${channel}): ${title}`;
+            },
+        },
+    ];
+}
+// Suppress "unused import" warnings for the shape execFile is here in case
+// callers want a non-blocking variant later; intentionally not deleted.
+void execFile;
+//# sourceMappingURL=interactionTools.js.map

package/dist/tools/interactionTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionTools.js","sourceRoot":"","sources":["../../src/tools/interactionTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/monitorTools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Monitor — Claude-Code-parity background process management.
+ *
+ * Spawns a long-running command and lets the agent inspect/stream/stop it
+ * without blocking the conversation. Used for: dev servers, watchers,
+ * fuzzers, builds-in-progress. The Bash tool stays best for short
+ * commands; Monitor takes over once `run_in_background: true` is desired.
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function getMonitorRegistry(): ReadonlyMap<string, {
+    command: string;
+    status: string;
+}>;
+export declare function shutdownAllMonitors(): Promise<void>;
+export declare function createMonitorTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=monitorTools.d.ts.map

package/dist/tools/monitorTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitorTools.d.ts","sourceRoot":"","sources":["../../src/tools/monitorTools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+B7D,wBAAgB,kBAAkB,IAAI,WAAW,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAI7F;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWzD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CA8GvE"}

package/dist/tools/monitorTools.js

@@ -0,0 +1,159 @@
+/**
+ * Monitor — Claude-Code-parity background process management.
+ *
+ * Spawns a long-running command and lets the agent inspect/stream/stop it
+ * without blocking the conversation. Used for: dev servers, watchers,
+ * fuzzers, builds-in-progress. The Bash tool stays best for short
+ * commands; Monitor takes over once `run_in_background: true` is desired.
+ */
+import { spawn } from 'node:child_process';
+const REGISTRY = new Map();
+const MAX_BUFFER_LINES = 1000;
+function nextId() {
+    return `mon-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+}
+function appendOutput(entry, chunk) {
+    const text = typeof chunk === 'string' ? chunk : chunk.toString('utf-8');
+    for (const line of text.split(/\r?\n/)) {
+        if (line.length === 0)
+            continue;
+        entry.buffer.push(line);
+    }
+    if (entry.buffer.length > MAX_BUFFER_LINES) {
+        entry.buffer.splice(0, entry.buffer.length - MAX_BUFFER_LINES);
+    }
+}
+export function getMonitorRegistry() {
+    const out = new Map();
+    for (const [id, e] of REGISTRY)
+        out.set(id, { command: e.command, status: e.status });
+    return out;
+}
+export async function shutdownAllMonitors() {
+    for (const entry of REGISTRY.values()) {
+        if (entry.status === 'running') {
+            try {
+                entry.proc.kill('SIGTERM');
+            }
+            catch {
+                // Ignore: process may already have exited.
+            }
+        }
+    }
+    REGISTRY.clear();
+}
+export function createMonitorTools(workingDir) {
+    return [
+        {
+            name: 'MonitorStart',
+            description: 'Spawn a long-running shell command in the background and return ' +
+                'a monitor id. Use for dev servers, watchers, fuzzers, builds. ' +
+                'Subsequent MonitorRead calls stream stdout/stderr lines.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: { type: 'string', description: 'Shell command to run.' },
+                    cwd: { type: 'string', description: 'Working directory (defaults to session cwd).' },
+                },
+                required: ['command'],
+            },
+            handler: async (args) => {
+                const command = String(args['command'] ?? '').trim();
+                if (!command)
+                    return 'MonitorStart requires a command.';
+                const cwd = typeof args['cwd'] === 'string' && args['cwd'].trim() ? args['cwd'].trim() : workingDir;
+                const id = nextId();
+                const proc = spawn(command, {
+                    cwd,
+                    shell: true,
+                    detached: false,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                });
+                const entry = {
+                    id,
+                    command,
+                    startedAt: new Date().toISOString(),
+                    status: 'running',
+                    buffer: [],
+                    proc,
+                };
+                proc.stdout?.on('data', (chunk) => appendOutput(entry, chunk));
+                proc.stderr?.on('data', (chunk) => appendOutput(entry, chunk));
+                proc.on('exit', (code, signal) => {
+                    entry.status = 'exited';
+                    entry.exitCode = code;
+                    entry.signal = signal;
+                });
+                proc.on('error', (err) => {
+                    appendOutput(entry, `[monitor error] ${err.message}`);
+                    entry.status = 'exited';
+                    entry.exitCode = -1;
+                });
+                REGISTRY.set(id, entry);
+                return `Monitor "${id}" started: ${command}`;
+            },
+        },
+        {
+            name: 'MonitorRead',
+            description: 'Read buffered output from a monitor. Pass `since: <line-index>` ' +
+                'to only return lines added since that index (the response includes ' +
+                'a `nextCursor` to use for the next read).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Monitor id from MonitorStart.' },
+                    since: { type: 'number', description: 'Cursor returned by previous read.' },
+                },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const id = String(args['id'] ?? '');
+                const entry = REGISTRY.get(id);
+                if (!entry)
+                    return `No monitor with id "${id}".`;
+                const since = Number.isFinite(Number(args['since'])) ? Math.max(0, Number(args['since'])) : 0;
+                const slice = entry.buffer.slice(since);
+                const cursor = entry.buffer.length;
+                const head = `[${entry.status}${entry.status === 'exited' ? ` exit=${entry.exitCode ?? 'null'}` : ''}] cursor=${cursor}`;
+                return [head, ...slice].join('\n');
+            },
+        },
+        {
+            name: 'MonitorStop',
+            description: 'Send SIGTERM to a running monitor. Idempotent.',
+            parameters: {
+                type: 'object',
+                properties: { id: { type: 'string' } },
+                required: ['id'],
+            },
+            handler: async (args) => {
+                const id = String(args['id'] ?? '');
+                const entry = REGISTRY.get(id);
+                if (!entry)
+                    return `No monitor with id "${id}".`;
+                if (entry.status === 'running') {
+                    try {
+                        entry.proc.kill('SIGTERM');
+                    }
+                    catch (err) {
+                        return `MonitorStop kill failed: ${err instanceof Error ? err.message : String(err)}`;
+                    }
+                }
+                return `Monitor "${id}" stopped.`;
+            },
+        },
+        {
+            name: 'MonitorList',
+            description: 'List active and recently-exited monitors.',
+            parameters: { type: 'object', properties: {} },
+            handler: async () => {
+                if (REGISTRY.size === 0)
+                    return 'No monitors.';
+                return Array.from(REGISTRY.values())
+                    .map((e) => `${e.id} [${e.status}] ${e.command}`)
+                    .join('\n');
+            },
+        },
+    ];
+}
+//# sourceMappingURL=monitorTools.js.map

package/dist/tools/monitorTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitorTools.js","sourceRoot":"","sources":["../../src/tools/monitorTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/planModeTools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * EnterPlanMode / ExitPlanMode — Claude-Code-parity planning workflow.
+ *
+ * The agent enters plan mode to write down a multi-step implementation
+ * plan that the user reviews and approves before any tool that mutates
+ * state runs. ExitPlanMode is called when the plan is approved.
+ *
+ * Plans are persisted to <workingDir>/.erosolar/plans/<id>.json so the
+ * portal can render them and the user can revisit them later.
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export type PlanStepStatus = 'pending' | 'in_progress' | 'completed' | 'skipped';
+export interface PlanStep {
+    id: string;
+    title: string;
+    detail?: string;
+    status: PlanStepStatus;
+}
+export interface PlanRecord {
+    id: string;
+    title: string;
+    goal?: string;
+    steps: PlanStep[];
+    status: 'draft' | 'approved' | 'completed' | 'abandoned';
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function getActivePlan(): PlanRecord | null;
+export declare function clearActivePlan(): void;
+export declare function listStoredPlans(workingDir: string): PlanRecord[];
+export declare function createPlanModeTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=planModeTools.d.ts.map

package/dist/tools/planModeTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planModeTools.d.ts","sourceRoot":"","sources":["../../src/tools/planModeTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AA8BD,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CAahE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CA6IxE"}

package/dist/tools/planModeTools.js

@@ -0,0 +1,200 @@
+/**
+ * EnterPlanMode / ExitPlanMode — Claude-Code-parity planning workflow.
+ *
+ * The agent enters plan mode to write down a multi-step implementation
+ * plan that the user reviews and approves before any tool that mutates
+ * state runs. ExitPlanMode is called when the plan is approved.
+ *
+ * Plans are persisted to <workingDir>/.erosolar/plans/<id>.json so the
+ * portal can render them and the user can revisit them later.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+let ACTIVE_PLAN = null;
+function planStore(workingDir) {
+    return join(workingDir, '.erosolar', 'plans');
+}
+function planPath(workingDir, id) {
+    return join(planStore(workingDir), `${id}.json`);
+}
+function safeId(input) {
+    const s = typeof input === 'string' ? input.trim() : '';
+    if (!s)
+        return `plan-${Date.now().toString(36)}`;
+    return s.replace(/[^a-zA-Z0-9_-]/g, '-').slice(0, 96);
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function persist(workingDir, plan) {
+    const dir = planStore(workingDir);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(planPath(workingDir, plan.id), JSON.stringify(plan, null, 2), 'utf-8');
+}
+export function getActivePlan() {
+    return ACTIVE_PLAN ? { ...ACTIVE_PLAN, steps: [...ACTIVE_PLAN.steps] } : null;
+}
+export function clearActivePlan() {
+    ACTIVE_PLAN = null;
+}
+export function listStoredPlans(workingDir) {
+    const dir = planStore(workingDir);
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const name of readdirSync(dir)) {
+        if (!name.endsWith('.json'))
+            continue;
+        try {
+            out.push(JSON.parse(readFileSync(join(dir, name), 'utf-8')));
+        }
+        catch {
+            // Skip malformed plan files.
+        }
+    }
+    return out.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+}
+export function createPlanModeTools(workingDir) {
+    return [
+        {
+            name: 'EnterPlanMode',
+            description: 'Open a structured plan for a multi-step task and pause execution ' +
+                'until the user approves it. Pass title + goal + steps[]. The plan ' +
+                'is persisted to .erosolar/plans/ and surfaced in the portal. Use ' +
+                'this for any change spanning multiple files or systems.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Optional stable id (alnum/-/_, ≤96 chars).' },
+                    title: { type: 'string', description: 'Short title (≤120 chars).' },
+                    goal: { type: 'string', description: 'One-sentence goal/outcome.' },
+                    steps: {
+                        type: 'array',
+                        description: 'Ordered steps. Each: { title, detail? }.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                title: { type: 'string' },
+                                detail: { type: 'string' },
+                            },
+                            required: ['title'],
+                        },
+                    },
+                },
+                required: ['title', 'steps'],
+            },
+            handler: async (args) => {
+                const id = safeId(args['id']);
+                const title = String(args['title'] ?? '').trim().slice(0, 120) || 'Untitled plan';
+                const goal = typeof args['goal'] === 'string' ? args['goal'].trim() : undefined;
+                const rawSteps = Array.isArray(args['steps']) ? args['steps'] : [];
+                if (rawSteps.length === 0) {
+                    return 'EnterPlanMode requires at least one step.';
+                }
+                const steps = rawSteps.map((raw, idx) => {
+                    const r = raw;
+                    return {
+                        id: `s${idx + 1}`,
+                        title: typeof r['title'] === 'string' ? r['title'].trim() : `Step ${idx + 1}`,
+                        detail: typeof r['detail'] === 'string' ? r['detail'] : undefined,
+                        status: 'pending',
+                    };
+                });
+                const plan = {
+                    id,
+                    title,
+                    ...(goal ? { goal } : {}),
+                    steps,
+                    status: 'draft',
+                    createdAt: nowIso(),
+                    updatedAt: nowIso(),
+                };
+                ACTIVE_PLAN = plan;
+                persist(workingDir, plan);
+                return [
+                    `Plan "${id}" entered. Awaiting user approval before execution.`,
+                    `Title: ${title}`,
+                    goal ? `Goal: ${goal}` : null,
+                    `Steps:`,
+                    ...steps.map((s, i) => `  ${i + 1}. ${s.title}${s.detail ? ` — ${s.detail}` : ''}`),
+                ]
+                    .filter(Boolean)
+                    .join('\n');
+            },
+        },
+        {
+            name: 'ExitPlanMode',
+            description: 'Close the active plan. Pass `outcome: "approved"` once the user has ' +
+                'okayed the plan and the agent is moving to execute, `"completed"` ' +
+                'once all steps are done, or `"abandoned"` if the plan was discarded.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    outcome: {
+                        type: 'string',
+                        enum: ['approved', 'completed', 'abandoned'],
+                        description: 'Terminal status for the plan.',
+                    },
+                    note: { type: 'string', description: 'Optional explanatory note.' },
+                },
+                required: ['outcome'],
+            },
+            handler: async (args) => {
+                if (!ACTIVE_PLAN) {
+                    return 'No active plan; nothing to exit.';
+                }
+                const outcome = String(args['outcome']);
+                ACTIVE_PLAN = {
+                    ...ACTIVE_PLAN,
+                    status: outcome === 'approved' ? 'approved' : outcome,
+                    updatedAt: nowIso(),
+                };
+                persist(workingDir, ACTIVE_PLAN);
+                const id = ACTIVE_PLAN.id;
+                if (outcome !== 'approved') {
+                    ACTIVE_PLAN = null;
+                }
+                const note = typeof args['note'] === 'string' && args['note'].trim() ? ` — ${args['note'].trim()}` : '';
+                return `Plan "${id}" exited (${outcome})${note}.`;
+            },
+        },
+        {
+            name: 'UpdatePlanStep',
+            description: 'Update the status of a single plan step. Use during execution to ' +
+                'mark each step in_progress/completed/skipped as work proceeds.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    stepId: { type: 'string', description: 'Step id (e.g. "s1") or 1-based index.' },
+                    status: {
+                        type: 'string',
+                        enum: ['pending', 'in_progress', 'completed', 'skipped'],
+                    },
+                },
+                required: ['stepId', 'status'],
+            },
+            handler: async (args) => {
+                if (!ACTIVE_PLAN)
+                    return 'No active plan.';
+                const target = String(args['stepId']);
+                const status = String(args['status']);
+                let idx = ACTIVE_PLAN.steps.findIndex((s) => s.id === target);
+                if (idx < 0) {
+                    const numeric = Number.parseInt(target, 10);
+                    if (Number.isFinite(numeric))
+                        idx = numeric - 1;
+                }
+                if (idx < 0 || idx >= ACTIVE_PLAN.steps.length) {
+                    return `Step "${target}" not found.`;
+                }
+                ACTIVE_PLAN.steps[idx].status = status;
+                ACTIVE_PLAN.updatedAt = nowIso();
+                persist(workingDir, ACTIVE_PLAN);
+                return `Step ${idx + 1} (${ACTIVE_PLAN.steps[idx].title}) → ${status}.`;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=planModeTools.js.map