@zerone-agent/open-agent-sdk 0.5.8 → 0.6.0

package/dist/snapshot/index.js

@@ -0,0 +1,288 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { createHash } from 'crypto';
+import { homedir } from 'os';
+import { mkdir, rm, readFile, writeFile, stat } from 'fs/promises';
+import { join } from 'path';
+import { Semaphore } from './semaphore.js';
+const execFileAsync = promisify(execFile);
+const LARGE_FILE_LIMIT = 2 * 1024 * 1024; // 2MB
+/**
+ * Compute the default snapshot directory for a worktree.
+ *
+ * Layout: ~/.openagent/snapshot/<project-hash>/<worktree-hash>/
+ *
+ * - project-hash: groups all worktrees of the same project together.
+ *   Derived from git remote URL, or directory path as fallback.
+ * - worktree-hash: identifies the specific worktree path.
+ */
+async function defaultSnapshotDir(worktree) {
+    const projectHash = await computeProjectHash(worktree);
+    const worktreeHash = createHash('sha256').update(worktree).digest('hex').slice(0, 16);
+    return join(homedir(), '.openagent', 'snapshot', projectHash, worktreeHash);
+}
+/**
+ * Derive a project-level hash from a worktree path.
+ *
+ * Strategy:
+ * 1. If git repo with remote → hash the remote URL (same project across clones/worktrees)
+ * 2. Otherwise → hash the absolute directory path
+ */
+async function computeProjectHash(worktree) {
+    try {
+        const { stdout } = await execFileAsync('git', ['remote', 'get-url', 'origin'], {
+            cwd: worktree,
+            env: { ...process.env },
+        });
+        const remote = stdout.trim();
+        if (remote) {
+            return createHash('sha256').update(remote).digest('hex').slice(0, 16);
+        }
+    }
+    catch {
+        // not a git repo or no remote — fall through
+    }
+    // Fallback: hash the directory path (without trailing slash)
+    return createHash('sha256').update(worktree.replace(/\/$/, '')).digest('hex').slice(0, 16);
+}
+export class SnapshotEngine {
+    worktree;
+    _gitDir;
+    lock = new Semaphore();
+    gcTimer;
+    gcInterval;
+    constructor(opts) {
+        this.worktree = opts.worktree;
+        this._gitDir = opts.snapshotDir;
+    }
+    /** Snapshot repo path. Available after init(). */
+    get gitDir() {
+        if (!this._gitDir)
+            throw new Error('SnapshotEngine not initialized — call init() first');
+        return this._gitDir;
+    }
+    /**
+     * Initialize the snapshot git repo.
+     * Creates a bare repo and syncs ignore rules from the source repo.
+     */
+    async init() {
+        // Resolve default path if not explicitly provided
+        if (!this._gitDir) {
+            this._gitDir = await defaultSnapshotDir(this.worktree);
+        }
+        await this.lock.acquire();
+        try {
+            await mkdir(this.gitDir, { recursive: true });
+            await this.execRaw(['init', '--bare', this.gitDir]);
+            await this.syncIgnoreRules();
+        }
+        finally {
+            this.lock.release();
+        }
+        this.startGc();
+    }
+    /**
+     * Run a git command with GIT_DIR and GIT_WORK_TREE set.
+     */
+    async exec(args) {
+        return execFileAsync('git', args, {
+            env: {
+                ...process.env,
+                GIT_DIR: this.gitDir,
+                GIT_WORK_TREE: this.worktree,
+            },
+            maxBuffer: 50 * 1024 * 1024,
+        });
+    }
+    /**
+     * Run a git command without GIT_DIR/GIT_WORK_TREE (for init).
+     */
+    async execRaw(args, cwd) {
+        return execFileAsync('git', args, {
+            env: { ...process.env },
+            maxBuffer: 50 * 1024 * 1024,
+            cwd,
+        });
+    }
+    /**
+     * Sync ignore rules from the source repo's .git/info/exclude.
+     */
+    async syncIgnoreRules() {
+        try {
+            const sourceExclude = join(this.worktree, '.git', 'info', 'exclude');
+            const content = await readFile(sourceExclude, 'utf-8');
+            const targetExclude = join(this.gitDir, 'info', 'exclude');
+            await mkdir(join(this.gitDir, 'info'), { recursive: true });
+            await writeFile(targetExclude, content, 'utf-8');
+        }
+        catch {
+            // no source exclude — skip
+        }
+    }
+    /**
+     * Snapshot the current workspace state.
+     * Returns a tree hash that can be used to restore or revert later.
+     */
+    async track() {
+        await this.lock.acquire();
+        try {
+            await this.filterLargeUntracked();
+            await this.exec(['add', '--all']);
+            const { stdout } = await this.exec(['write-tree']);
+            return stdout.trim();
+        }
+        finally {
+            this.lock.release();
+        }
+    }
+    /**
+     * Remove large untracked files from the index and add them to exclude.
+     */
+    async filterLargeUntracked() {
+        try {
+            const { stdout } = await this.exec(['status', '--porcelain', '--untracked-files=all']);
+            const excludeAdditions = [];
+            for (const line of stdout.split('\n')) {
+                if (!line.startsWith('??'))
+                    continue;
+                const filePath = line.slice(3).trim().replace(/"/g, '');
+                if (!filePath)
+                    continue;
+                try {
+                    const full = join(this.worktree, filePath);
+                    const s = await stat(full);
+                    if (s.size > LARGE_FILE_LIMIT) {
+                        excludeAdditions.push(filePath);
+                    }
+                }
+                catch {
+                    // stat failed — skip
+                }
+            }
+            if (excludeAdditions.length > 0) {
+                const targetExclude = join(this.gitDir, 'info', 'exclude');
+                const existing = await readFile(targetExclude, 'utf-8').catch(() => '');
+                const additions = excludeAdditions
+                    .filter((p) => !existing.includes(p))
+                    .join('\n');
+                if (additions) {
+                    await writeFile(targetExclude, existing + '\n' + additions + '\n', 'utf-8');
+                }
+            }
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    /**
+     * Restore the entire workspace to a snapshot state.
+     */
+    async restore(hash) {
+        await this.lock.acquire();
+        try {
+            await this.exec(['read-tree', hash]);
+            await this.exec(['checkout-index', '-a', '-f']);
+        }
+        finally {
+            this.lock.release();
+        }
+    }
+    /**
+     * List files changed since the given snapshot hash.
+     */
+    async patchList(fromHash) {
+        await this.lock.acquire();
+        try {
+            await this.filterLargeUntracked();
+            await this.exec(['add', '--all']);
+            const { stdout } = await this.exec(['diff', '--cached', '--name-only', fromHash]);
+            return stdout.trim().split('\n').filter(Boolean);
+        }
+        finally {
+            this.lock.release();
+        }
+    }
+    /**
+     * Generate a unified diff between a snapshot and the current workspace.
+     */
+    async diff(fromHash) {
+        await this.lock.acquire();
+        try {
+            await this.filterLargeUntracked();
+            await this.exec(['add', '--all']);
+            const { stdout } = await this.exec(['diff', '--cached', fromHash]);
+            return stdout;
+        }
+        finally {
+            this.lock.release();
+        }
+    }
+    /**
+     * Revert specific files to their state at a given snapshot.
+     * Files that did not exist in the snapshot are deleted.
+     */
+    async revert(entries) {
+        await this.lock.acquire();
+        try {
+            for (const entry of entries) {
+                const fullPath = join(this.worktree, entry.path);
+                try {
+                    await this.exec(['ls-tree', entry.hash, '--', entry.path]);
+                    await this.exec(['checkout', entry.hash, '--', entry.path]);
+                }
+                catch {
+                    try {
+                        await rm(fullPath, { recursive: true, force: true });
+                    }
+                    catch {
+                        // already gone — fine
+                    }
+                }
+            }
+        }
+        finally {
+            this.lock.release();
+        }
+    }
+    /**
+     * Run git gc to prune unreachable objects older than 7 days.
+     */
+    async gc() {
+        await this.lock.acquire();
+        try {
+            await this.exec(['gc', '--prune=7.days', '--quiet']);
+        }
+        catch {
+            // non-fatal — gc is best-effort
+        }
+        finally {
+            this.lock.release();
+        }
+    }
+    /**
+     * Start periodic background gc.
+     * First run after 1 minute, then every hour.
+     */
+    startGc() {
+        this.gcTimer = setTimeout(() => {
+            this.gc();
+            this.gcInterval = setInterval(() => {
+                this.gc();
+            }, 60 * 60 * 1000);
+        }, 60 * 1000);
+    }
+    /**
+     * Stop background gc. Call on engine shutdown or in test cleanup.
+     */
+    stopGc() {
+        if (this.gcTimer) {
+            clearTimeout(this.gcTimer);
+            this.gcTimer = undefined;
+        }
+        if (this.gcInterval) {
+            clearInterval(this.gcInterval);
+            this.gcInterval = undefined;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

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

package/dist/snapshot/semaphore.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Simple promise-based serial lock.
+ * Ensures git operations on the same repo are serialized.
+ */
+export declare class Semaphore {
+    private queue;
+    private locked;
+    acquire(): Promise<void>;
+    release(): void;
+}
+//# sourceMappingURL=semaphore.d.ts.map

package/dist/snapshot/semaphore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.d.ts","sourceRoot":"","sources":["../../src/snapshot/semaphore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAAQ;IAEhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,OAAO,IAAI,IAAI;CAQhB"}

package/dist/snapshot/semaphore.js

@@ -0,0 +1,27 @@
+/**
+ * Simple promise-based serial lock.
+ * Ensures git operations on the same repo are serialized.
+ */
+export class Semaphore {
+    queue = [];
+    locked = false;
+    async acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+}
+//# sourceMappingURL=semaphore.js.map

package/dist/snapshot/semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.js","sourceRoot":"","sources":["../../src/snapshot/semaphore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAS;IACZ,KAAK,GAAmB,EAAE,CAAA;IAC1B,MAAM,GAAG,KAAK,CAAA;IAEtB,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,OAAM;QACR,CAAC;QACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QAC/B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAA;QACR,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/tools/todo-tool.d.ts

@@ -1,22 +1,12 @@
-/**
- * TodoWriteTool - Session todo/checklist management
- *
- * Manages a session-scoped todo list for tracking work items.
- */
 import type { ToolDefinition } from '../types.js';
-export interface TodoItem {
-    id: number;
-    text: string;
-    done: boolean;
-    priority?: 'high' | 'medium' | 'low';
+export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
+export type TodoPriority = 'high' | 'medium' | 'low';
+export interface TodoInfo {
+    content: string;
+    status: TodoStatus;
+    priority: TodoPriority;
 }
-/**
- * Get all todos.
- */
-export declare function getTodos(): TodoItem[];
-/**
- * Clear all todos.
- */
-export declare function clearTodos(): void;
+export declare function getTodos(sessionId: string): Promise<TodoInfo[]>;
+export declare function clearTodos(sessionId: string): Promise<void>;
 export declare const TodoWriteTool: ToolDefinition;
 //# sourceMappingURL=todo-tool.d.ts.map

package/dist/tools/todo-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-tool.d.ts","sourceRoot":"","sources":["../../src/tools/todo-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAA;AAE7D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;CACrC;AAKD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,QAAQ,EAAE,CAErC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,eAAO,MAAM,aAAa,EAAE,cA8E3B,CAAA"}
+{"version":3,"file":"todo-tool.d.ts","sourceRoot":"","sources":["../../src/tools/todo-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAA;AAW1E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAA;AAC9E,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEpD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;CACvB;AA6FD,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErE;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE;AAED,eAAO,MAAM,aAAa,EAAE,cAqE3B,CAAA"}

package/dist/tools/todo-tool.js

@@ -1,93 +1,155 @@
-/**
- * TodoWriteTool - Session todo/checklist management
- *
- * Manages a session-scoped todo list for tracking work items.
- */
-const todoList = [];
-let todoCounter = 0;
-/**
- * Get all todos.
- */
-export function getTodos() {
-    return [...todoList];
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let _description;
+try {
+    _description = readFileSync(join(__dirname, 'todowrite.txt'), 'utf-8');
 }
-/**
- * Clear all todos.
- */
-export function clearTodos() {
-    todoList.length = 0;
-    todoCounter = 0;
+catch {
+    _description = 'Manage a structured task list for your current coding session.';
+}
+const VALID_STATUSES = ['pending', 'in_progress', 'completed', 'cancelled'];
+const VALID_PRIORITIES = ['high', 'medium', 'low'];
+function getTodosDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '/tmp';
+    return join(home, '.openagent', 'sessions');
+}
+function getTodosPath(sessionId) {
+    return join(getTodosDir(), sessionId, 'todos.json');
+}
+function validateSessionId(sessionId) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(sessionId)) {
+        throw new Error(`Invalid sessionId: ${sessionId}. Must match /^[a-zA-Z0-9_-]+$/`);
+    }
+    return sessionId;
+}
+async function saveTodos(sessionId, todos) {
+    validateSessionId(sessionId);
+    const dir = join(getTodosDir(), sessionId);
+    await mkdir(dir, { recursive: true });
+    const data = {
+        updatedAt: new Date().toISOString(),
+        todos,
+    };
+    await writeFile(getTodosPath(sessionId), JSON.stringify(data, null, 2), 'utf-8');
+}
+async function loadTodos(sessionId) {
+    validateSessionId(sessionId);
+    try {
+        const raw = await readFile(getTodosPath(sessionId), 'utf-8');
+        const data = JSON.parse(raw);
+        return data.todos || [];
+    }
+    catch {
+        return [];
+    }
+}
+function validateTodos(todos) {
+    if (!Array.isArray(todos))
+        return 'todos must be an array';
+    for (let i = 0; i < todos.length; i++) {
+        const item = todos[i];
+        if (!item.content || typeof item.content !== 'string' || item.content.trim() === '') {
+            return `todos[${i}].content must be a non-empty string`;
+        }
+        if (!VALID_STATUSES.includes(item.status)) {
+            return `todos[${i}].status must be one of: ${VALID_STATUSES.join(', ')}`;
+        }
+        if (!VALID_PRIORITIES.includes(item.priority)) {
+            return `todos[${i}].priority must be one of: ${VALID_PRIORITIES.join(', ')}`;
+        }
+    }
+    const inProgressCount = todos.filter((t) => t.status === 'in_progress').length;
+    if (inProgressCount > 1) {
+        return `Warning: ${inProgressCount} tasks are in_progress. Only one should be in_progress at a time.`;
+    }
+    return null;
+}
+const STATUS_MARKS = {
+    pending: ' ',
+    in_progress: '•',
+    completed: '✓',
+    cancelled: '✗',
+};
+function formatTodos(todos) {
+    if (todos.length === 0)
+        return 'No todos.';
+    const lines = [];
+    for (const t of todos) {
+        lines.push(`[${STATUS_MARKS[t.status]}] ${t.content}`);
+    }
+    return lines.join('\n');
+}
+export async function getTodos(sessionId) {
+    return loadTodos(sessionId);
+}
+export async function clearTodos(sessionId) {
+    await saveTodos(sessionId, []);
 }
 export const TodoWriteTool = {
     name: 'TodoWrite',
-    description: 'Manage a session todo/checklist. Supports add, toggle, remove, and list operations.',
+    description: _description,
     inputSchema: {
         type: 'object',
         properties: {
-            action: {
-                type: 'string',
-                enum: ['add', 'toggle', 'remove', 'list', 'clear'],
-                description: 'Operation to perform',
-            },
-            text: { type: 'string', description: 'Todo item text (for add)' },
-            id: { type: 'number', description: 'Todo item ID (for toggle/remove)' },
-            priority: {
-                type: 'string',
-                enum: ['high', 'medium', 'low'],
-                description: 'Priority level (for add)',
+            todos: {
+                type: 'array',
+                description: 'The updated todo list',
+                items: {
+                    type: 'object',
+                    properties: {
+                        content: { type: 'string', description: 'Brief description of the task' },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed', 'cancelled'],
+                            description: 'Current status of the task',
+                        },
+                        priority: {
+                            type: 'string',
+                            enum: ['high', 'medium', 'low'],
+                            description: 'Priority level of the task',
+                        },
+                    },
+                    required: ['content', 'status', 'priority'],
+                },
             },
         },
-        required: ['action'],
+        required: ['todos'],
     },
     isReadOnly: () => false,
     isConcurrencySafe: () => true,
     isEnabled: () => true,
-    async prompt() { return 'Manage session todo list.'; },
-    async call(input) {
-        switch (input.action) {
-            case 'add': {
-                if (!input.text) {
-                    return { type: 'tool_result', tool_use_id: '', content: 'text required', is_error: true };
-                }
-                const item = {
-                    id: ++todoCounter,
-                    text: input.text,
-                    done: false,
-                    priority: input.priority,
-                };
-                todoList.push(item);
-                return { type: 'tool_result', tool_use_id: '', content: `Todo added: #${item.id} "${item.text}"` };
-            }
-            case 'toggle': {
-                const item = todoList.find(t => t.id === input.id);
-                if (!item) {
-                    return { type: 'tool_result', tool_use_id: '', content: `Todo #${input.id} not found`, is_error: true };
-                }
-                item.done = !item.done;
-                return { type: 'tool_result', tool_use_id: '', content: `Todo #${item.id} ${item.done ? 'completed' : 'reopened'}` };
-            }
-            case 'remove': {
-                const idx = todoList.findIndex(t => t.id === input.id);
-                if (idx === -1) {
-                    return { type: 'tool_result', tool_use_id: '', content: `Todo #${input.id} not found`, is_error: true };
-                }
-                todoList.splice(idx, 1);
-                return { type: 'tool_result', tool_use_id: '', content: `Todo #${input.id} removed` };
-            }
-            case 'list': {
-                if (todoList.length === 0) {
-                    return { type: 'tool_result', tool_use_id: '', content: 'No todos.' };
-                }
-                const lines = todoList.map(t => `${t.done ? '[x]' : '[ ]'} #${t.id} ${t.text}${t.priority ? ` (${t.priority})` : ''}`);
-                return { type: 'tool_result', tool_use_id: '', content: lines.join('\n') };
-            }
-            case 'clear': {
-                todoList.length = 0;
-                return { type: 'tool_result', tool_use_id: '', content: 'All todos cleared.' };
-            }
-            default:
-                return { type: 'tool_result', tool_use_id: '', content: `Unknown action: ${input.action}`, is_error: true };
+    async prompt() {
+        return _description;
+    },
+    async call(input, context) {
+        const todos = input.todos;
+        if (!Array.isArray(todos)) {
+            return { type: 'tool_result', tool_use_id: '', content: 'todos must be an array', is_error: true };
+        }
+        const validationError = validateTodos(todos);
+        if (validationError && validationError.startsWith('todos[')) {
+            return { type: 'tool_result', tool_use_id: '', content: validationError, is_error: true };
+        }
+        const sessionId = context.sessionId || 'default';
+        try {
+            validateSessionId(sessionId);
+        }
+        catch (e) {
+            return { type: 'tool_result', tool_use_id: '', content: e.message, is_error: true };
         }
+        await saveTodos(sessionId, todos);
+        const formatted = formatTodos(todos);
+        const json = JSON.stringify(todos, null, 2);
+        const output = `${formatted}\n\n${json}`;
+        const warning = validationError ? `\n\nNote: ${validationError}` : '';
+        return {
+            type: 'tool_result',
+            tool_use_id: '',
+            content: output + warning,
+        };
     },
 };
 //# sourceMappingURL=todo-tool.js.map