cmdr-agent 2.5.5 → 3.0.0

package/dist/src/server/index.js

@@ -0,0 +1,281 @@
+/**
+ * cmdr serve — HTTP/SSE server exposing the agent API.
+ *
+ * Endpoints:
+ *   POST /v1/chat     — JSON request/response
+ *   POST /v1/stream   — SSE streaming response
+ *   GET  /health      — health check
+ *   GET  /v1/models   — list available models
+ *
+ * Uses Node.js built-in http module (no Express).
+ */
+import { createServer } from 'node:http';
+import { Agent } from '../core/agent.js';
+import { createAdapter } from '../llm/provider-factory.js';
+import { ToolRegistry } from '../tools/registry.js';
+import { registerBuiltInTools } from '../tools/built-in/index.js';
+import { PermissionManager } from '../core/permissions.js';
+import { SOLO_CODER } from '../core/presets.js';
+import { discoverProject } from '../session/project-context.js';
+import { buildSystemPrompt } from '../session/prompt-builder.js';
+import { discoverOllamaModels } from '../llm/model-registry.js';
+import { MemoryManager } from '../memory/memory-manager.js';
+/** Read request body as JSON, with a size limit. */
+async function readBody(req, maxBytes = 10 * 1024 * 1024) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxBytes) {
+                req.destroy();
+                reject(new Error('Request body too large'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            try {
+                const body = Buffer.concat(chunks).toString('utf-8');
+                resolve(JSON.parse(body));
+            }
+            catch {
+                reject(new Error('Invalid JSON'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+function sendJson(res, status, data) {
+    const body = JSON.stringify(data);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+function sendError(res, status, message) {
+    sendJson(res, status, { error: message });
+}
+/** Set CORS headers for development use. */
+function setCorsHeaders(res) {
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+}
+export async function startServer(options) {
+    const cwd = process.cwd();
+    // Resolve provider
+    const provider = options.provider ?? 'ollama';
+    const adapter = createAdapter({ provider, ollamaUrl: options.ollamaUrl });
+    // Discover project context
+    const projectContext = await discoverProject(cwd);
+    // Memory
+    const memoryManager = new MemoryManager(cwd);
+    const memoryPrompt = await memoryManager.getMemoryPrompt();
+    // System prompt
+    const systemPrompt = buildSystemPrompt({
+        basePrompt: SOLO_CODER.systemPrompt,
+        projectContext,
+        model: options.model,
+        memoryPrompt: memoryPrompt || undefined,
+    });
+    // Tools
+    const toolRegistry = new ToolRegistry();
+    registerBuiltInTools(toolRegistry);
+    // Permission manager (yolo for server mode — approvals aren't interactive)
+    const permissionManager = new PermissionManager('yolo');
+    // Discover models for Ollama
+    if (provider === 'ollama') {
+        const ollamaAdapter = adapter;
+        const healthy = await ollamaAdapter.healthCheck();
+        if (!healthy) {
+            console.error(`Cannot connect to Ollama at ${options.ollamaUrl}`);
+            process.exit(1);
+        }
+        await discoverOllamaModels(options.ollamaUrl);
+    }
+    /** Create a fresh agent for each request. */
+    function createAgent(model) {
+        const allowedToolNames = Array.from(new Set([
+            ...(SOLO_CODER.tools ?? []),
+            ...toolRegistry.list().map(t => t.name),
+        ]));
+        return new Agent({
+            ...SOLO_CODER,
+            model,
+            systemPrompt,
+            tools: allowedToolNames,
+        }, adapter, toolRegistry, cwd, permissionManager);
+    }
+    const server = createServer(async (req, res) => {
+        setCorsHeaders(res);
+        // Handle CORS preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = req.url ?? '/';
+        try {
+            // GET /health
+            if (req.method === 'GET' && url === '/health') {
+                sendJson(res, 200, {
+                    status: 'ok',
+                    model: options.model,
+                    provider,
+                    uptime: process.uptime(),
+                });
+                return;
+            }
+            // GET /v1/models
+            if (req.method === 'GET' && url === '/v1/models') {
+                if (provider === 'ollama') {
+                    const ollamaAdapter = adapter;
+                    const models = await ollamaAdapter.listModels();
+                    sendJson(res, 200, { models });
+                }
+                else {
+                    sendJson(res, 200, { models: [options.model] });
+                }
+                return;
+            }
+            // POST /v1/chat — non-streaming chat
+            if (req.method === 'POST' && url === '/v1/chat') {
+                const body = await readBody(req);
+                if (!body?.message) {
+                    sendError(res, 400, 'Missing "message" field');
+                    return;
+                }
+                const model = body.model ?? options.model;
+                const agent = createAgent(model);
+                const startTime = Date.now();
+                const toolsCalled = [];
+                let currentToolStart = 0;
+                let currentToolName = '';
+                let fullOutput = '';
+                for await (const event of agent.stream(body.message)) {
+                    switch (event.type) {
+                        case 'text':
+                            fullOutput += event.data;
+                            break;
+                        case 'tool_use': {
+                            const block = event.data;
+                            currentToolName = block.name;
+                            currentToolStart = Date.now();
+                            break;
+                        }
+                        case 'tool_result': {
+                            toolsCalled.push({ name: currentToolName, duration_ms: Date.now() - currentToolStart });
+                            currentToolName = '';
+                            break;
+                        }
+                    }
+                }
+                const state = agent.getState();
+                const tokens = state.tokenUsage;
+                sendJson(res, 200, {
+                    model,
+                    response: fullOutput,
+                    tools_called: toolsCalled,
+                    tokens: { input: tokens.input_tokens, output: tokens.output_tokens },
+                    duration_ms: Date.now() - startTime,
+                });
+                return;
+            }
+            // POST /v1/stream — SSE streaming
+            if (req.method === 'POST' && url === '/v1/stream') {
+                const body = await readBody(req);
+                if (!body?.message) {
+                    sendError(res, 400, 'Missing "message" field');
+                    return;
+                }
+                const model = body.model ?? options.model;
+                const agent = createAgent(model);
+                const startTime = Date.now();
+                const toolsCalled = [];
+                let currentToolStart = 0;
+                let currentToolName = '';
+                res.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                    'Connection': 'keep-alive',
+                    'Access-Control-Allow-Origin': '*',
+                });
+                const sendEvent = (data) => {
+                    res.write(`data: ${JSON.stringify(data)}\n\n`);
+                };
+                try {
+                    for await (const event of agent.stream(body.message)) {
+                        switch (event.type) {
+                            case 'text':
+                                sendEvent({ type: 'text', data: event.data, timestamp: Date.now() });
+                                break;
+                            case 'tool_use': {
+                                const block = event.data;
+                                currentToolName = block.name;
+                                currentToolStart = Date.now();
+                                sendEvent({ type: 'tool_use', tool: block.name, input: block.input, timestamp: Date.now() });
+                                break;
+                            }
+                            case 'tool_result': {
+                                const block = event.data;
+                                const duration_ms = Date.now() - currentToolStart;
+                                toolsCalled.push({ name: currentToolName, duration_ms });
+                                sendEvent({ type: 'tool_result', tool: currentToolName, output: block.content, is_error: block.is_error, duration_ms, timestamp: Date.now() });
+                                currentToolName = '';
+                                break;
+                            }
+                            case 'error': {
+                                const err = event.data;
+                                sendEvent({ type: 'error', message: err.message, timestamp: Date.now() });
+                                break;
+                            }
+                        }
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    sendEvent({ type: 'error', message: msg, timestamp: Date.now() });
+                }
+                const state = agent.getState();
+                const tokens = state.tokenUsage;
+                sendEvent({
+                    type: 'done',
+                    tokens: { input: tokens.input_tokens, output: tokens.output_tokens },
+                    duration_ms: Date.now() - startTime,
+                });
+                res.end();
+                return;
+            }
+            // 404 for anything else
+            sendError(res, 404, `Not found: ${url}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[cmdr serve] Error:`, msg);
+            if (!res.headersSent) {
+                sendError(res, 500, msg);
+            }
+        }
+    });
+    server.listen(options.port, options.host, () => {
+        console.log(`cmdr serve running on http://${options.host}:${options.port}`);
+        console.log(`  Model:    ${options.model}`);
+        console.log(`  Provider: ${provider}`);
+        console.log(`  Endpoints:`);
+        console.log(`    GET  /health      — health check`);
+        console.log(`    GET  /v1/models   — list models`);
+        console.log(`    POST /v1/chat     — JSON chat`);
+        console.log(`    POST /v1/stream   — SSE streaming`);
+    });
+    // Graceful shutdown
+    const shutdown = () => {
+        console.log('\nShutting down cmdr serve...');
+        server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/server/index.js.map

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

package/dist/src/session/branch-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * BranchManager — fork, switch, and merge conversation branches.
+ *
+ * Branches are persisted as JSON files under:
+ *   ~/.cmdr/sessions/{sessionId}/branches/{branch-id}.json
+ *
+ * Each branch stores a snapshot of the conversation at fork time,
+ * plus any messages added after the fork.
+ */
+import type { LLMMessage } from '../core/types.js';
+export interface Branch {
+    readonly id: string;
+    readonly name: string;
+    readonly model: string;
+    readonly messages: LLMMessage[];
+    readonly messageCount: number;
+    readonly createdAt: string;
+    readonly parentBranch?: string;
+    readonly forkPoint: number;
+}
+export declare class BranchManager {
+    private sessionId;
+    private currentBranchId;
+    constructor(sessionId: string);
+    get activeBranch(): string | null;
+    /** Fork the conversation at the current point. */
+    fork(name: string, messages: LLMMessage[], model: string, parentBranch?: string): Promise<Branch>;
+    /** Switch to a branch by ID. Returns the branch data or null. */
+    switch(id: string): Promise<Branch | null>;
+    /** List all branches for this session, newest first. */
+    list(): Promise<Omit<Branch, 'messages'>[]>;
+    /** Merge branch messages onto a target (appends after fork point). */
+    merge(sourceId: string, targetMessages: LLMMessage[]): Promise<LLMMessage[] | null>;
+    /** Delete a branch by ID. */
+    delete(id: string): Promise<boolean>;
+    /** Save the current state of a branch (update messages). */
+    update(id: string, messages: LLMMessage[], model: string): Promise<boolean>;
+}
+//# sourceMappingURL=branch-manager.d.ts.map

package/dist/src/session/branch-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-manager.d.ts","sourceRoot":"","sources":["../../../src/session/branch-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAKlD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAsB;gBAEjC,SAAS,EAAE,MAAM;IAI7B,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,kDAAkD;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBvG,iEAAiE;IAC3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAchD,wDAAwD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;IAmCjD,sEAAsE;IAChE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IASzF,6BAA6B;IACvB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1C,4DAA4D;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmBlF"}

package/dist/src/session/branch-manager.js

@@ -0,0 +1,142 @@
+/**
+ * BranchManager — fork, switch, and merge conversation branches.
+ *
+ * Branches are persisted as JSON files under:
+ *   ~/.cmdr/sessions/{sessionId}/branches/{branch-id}.json
+ *
+ * Each branch stores a snapshot of the conversation at fork time,
+ * plus any messages added after the fork.
+ */
+import { readFile, writeFile, mkdir, readdir, unlink } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CMDR_DIR = join(homedir(), '.cmdr');
+const SESSIONS_DIR = join(CMDR_DIR, 'sessions');
+function branchDir(sessionId) {
+    return join(SESSIONS_DIR, sessionId, 'branches');
+}
+export class BranchManager {
+    sessionId;
+    currentBranchId = null;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    get activeBranch() {
+        return this.currentBranchId;
+    }
+    /** Fork the conversation at the current point. */
+    async fork(name, messages, model, parentBranch) {
+        const dir = branchDir(this.sessionId);
+        await mkdir(dir, { recursive: true });
+        const id = `br_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+        const branch = {
+            id,
+            name,
+            model,
+            messages: [...messages],
+            messageCount: messages.length,
+            createdAt: new Date().toISOString(),
+            parentBranch,
+            forkPoint: messages.length,
+        };
+        await writeFile(join(dir, `${id}.json`), JSON.stringify(branch, null, 2), 'utf-8');
+        this.currentBranchId = id;
+        return branch;
+    }
+    /** Switch to a branch by ID. Returns the branch data or null. */
+    async switch(id) {
+        const filePath = join(branchDir(this.sessionId), `${id}.json`);
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const data = await readFile(filePath, 'utf-8');
+            const branch = JSON.parse(data);
+            this.currentBranchId = id;
+            return branch;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List all branches for this session, newest first. */
+    async list() {
+        const dir = branchDir(this.sessionId);
+        if (!existsSync(dir))
+            return [];
+        try {
+            const files = await readdir(dir);
+            const branches = [];
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const data = await readFile(join(dir, file), 'utf-8');
+                    const br = JSON.parse(data);
+                    branches.push({
+                        id: br.id,
+                        name: br.name,
+                        model: br.model,
+                        messageCount: br.messageCount,
+                        createdAt: br.createdAt,
+                        parentBranch: br.parentBranch,
+                        forkPoint: br.forkPoint,
+                    });
+                }
+                catch {
+                    // skip malformed files
+                }
+            }
+            return branches.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Merge branch messages onto a target (appends after fork point). */
+    async merge(sourceId, targetMessages) {
+        const source = await this.switch(sourceId);
+        if (!source)
+            return null;
+        // Messages added after fork point
+        const newMessages = source.messages.slice(source.forkPoint);
+        return [...targetMessages, ...newMessages];
+    }
+    /** Delete a branch by ID. */
+    async delete(id) {
+        const filePath = join(branchDir(this.sessionId), `${id}.json`);
+        if (!existsSync(filePath))
+            return false;
+        try {
+            await unlink(filePath);
+            if (this.currentBranchId === id)
+                this.currentBranchId = null;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Save the current state of a branch (update messages). */
+    async update(id, messages, model) {
+        const filePath = join(branchDir(this.sessionId), `${id}.json`);
+        if (!existsSync(filePath))
+            return false;
+        try {
+            const data = await readFile(filePath, 'utf-8');
+            const branch = JSON.parse(data);
+            const updated = {
+                ...branch,
+                messages: [...messages],
+                messageCount: messages.length,
+                model,
+            };
+            await writeFile(filePath, JSON.stringify(updated, null, 2), 'utf-8');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=branch-manager.js.map

package/dist/src/session/branch-manager.js.map

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

package/dist/src/session/checkpoint-manager.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CheckpointManager — save and restore conversation snapshots.
+ *
+ * Checkpoints are persisted as JSON files under:
+ *   ~/.cmdr/sessions/{sessionId}/checkpoints/{checkpoint-id}.json
+ */
+import type { LLMMessage } from '../core/types.js';
+export interface Checkpoint {
+    readonly id: string;
+    readonly label: string;
+    readonly model: string;
+    readonly messages: LLMMessage[];
+    readonly messageCount: number;
+    readonly createdAt: string;
+}
+export declare class CheckpointManager {
+    private sessionId;
+    constructor(sessionId: string);
+    /** Save a checkpoint with an optional label. */
+    save(label: string, messages: LLMMessage[], model: string): Promise<Checkpoint>;
+    /** Restore a checkpoint by ID. Returns null if not found. */
+    restore(id: string): Promise<Checkpoint | null>;
+    /** List all checkpoints for this session, newest first. */
+    list(): Promise<Omit<Checkpoint, 'messages'>[]>;
+    /** Delete a checkpoint by ID. Returns true if deleted. */
+    delete(id: string): Promise<boolean>;
+}
+//# sourceMappingURL=checkpoint-manager.d.ts.map

package/dist/src/session/checkpoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../src/session/checkpoint-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAKlD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAQ;gBAEb,SAAS,EAAE,MAAM;IAI7B,gDAAgD;IAC1C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBrF,6DAA6D;IACvD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAYrD,2DAA2D;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;IAiCrD,0DAA0D;IACpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAW3C"}

package/dist/src/session/checkpoint-manager.js

@@ -0,0 +1,96 @@
+/**
+ * CheckpointManager — save and restore conversation snapshots.
+ *
+ * Checkpoints are persisted as JSON files under:
+ *   ~/.cmdr/sessions/{sessionId}/checkpoints/{checkpoint-id}.json
+ */
+import { readFile, writeFile, mkdir, readdir, unlink } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CMDR_DIR = join(homedir(), '.cmdr');
+const SESSIONS_DIR = join(CMDR_DIR, 'sessions');
+function checkpointDir(sessionId) {
+    return join(SESSIONS_DIR, sessionId, 'checkpoints');
+}
+export class CheckpointManager {
+    sessionId;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    /** Save a checkpoint with an optional label. */
+    async save(label, messages, model) {
+        const dir = checkpointDir(this.sessionId);
+        await mkdir(dir, { recursive: true });
+        const id = `cp_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+        const checkpoint = {
+            id,
+            label,
+            model,
+            messages: [...messages],
+            messageCount: messages.length,
+            createdAt: new Date().toISOString(),
+        };
+        await writeFile(join(dir, `${id}.json`), JSON.stringify(checkpoint, null, 2), 'utf-8');
+        return checkpoint;
+    }
+    /** Restore a checkpoint by ID. Returns null if not found. */
+    async restore(id) {
+        const filePath = join(checkpointDir(this.sessionId), `${id}.json`);
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const data = await readFile(filePath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List all checkpoints for this session, newest first. */
+    async list() {
+        const dir = checkpointDir(this.sessionId);
+        if (!existsSync(dir))
+            return [];
+        try {
+            const files = await readdir(dir);
+            const checkpoints = [];
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const data = await readFile(join(dir, file), 'utf-8');
+                    const cp = JSON.parse(data);
+                    checkpoints.push({
+                        id: cp.id,
+                        label: cp.label,
+                        model: cp.model,
+                        messageCount: cp.messageCount,
+                        createdAt: cp.createdAt,
+                    });
+                }
+                catch {
+                    // skip malformed files
+                }
+            }
+            return checkpoints.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Delete a checkpoint by ID. Returns true if deleted. */
+    async delete(id) {
+        const filePath = join(checkpointDir(this.sessionId), `${id}.json`);
+        if (!existsSync(filePath))
+            return false;
+        try {
+            await unlink(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/src/session/checkpoint-manager.js.map

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

package/dist/src/tools/built-in/browser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Browser tools — optional Playwright-based browser automation.
+ *
+ * These tools are only registered when `--browser` is passed and
+ * playwright-core is available. Each tool dynamically imports
+ * playwright-core to avoid hard dependency.
+ */
+import type { ToolDefinition } from '../../core/types.js';
+export declare const browserOpenTool: ToolDefinition<{
+    url: string;
+    waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+}>;
+export declare const browserScreenshotTool: ToolDefinition<{
+    path?: string | undefined;
+    fullPage?: boolean | undefined;
+}>;
+export declare const browserClickTool: ToolDefinition<{
+    selector: string;
+}>;
+export declare const browserFillTool: ToolDefinition<{
+    value: string;
+    selector: string;
+}>;
+export declare const browserTextTool: ToolDefinition<{
+    selector?: string | undefined;
+}>;
+export declare const BROWSER_TOOLS: ToolDefinition<any>[];
+/** Check if playwright-core is available. */
+export declare function isPlaywrightAvailable(): Promise<boolean>;
+/** Close the browser if open (for cleanup). */
+export declare function closeBrowser(): Promise<void>;
+//# sourceMappingURL=browser.d.ts.map