openchrome-mcp 1.7.16 → 1.8.4

package/dist/tools/session-resume.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Session Resume Tool — restores browser context after compaction.
+ * Reads a snapshot, cross-references with live state, generates resume guide.
+ * Part of #355: AI Agent Continuity.
+ */
+import { MCPServer } from '../mcp-server';
+interface SnapshotTab {
+    targetId: string;
+    workerId: string;
+    sessionId: string;
+    url: string;
+    title: string;
+}
+interface SnapshotMemo {
+    objective: string;
+    currentStep: string;
+    nextActions: string[];
+    completedSteps?: string[];
+    notes?: string;
+}
+interface SessionSnapshot {
+    version: 1;
+    id: string;
+    timestamp: number;
+    tabs: SnapshotTab[];
+    memo: SnapshotMemo;
+    label?: string;
+}
+type TabStatus = 'LIVE' | 'REMAPPED' | 'CLOSED';
+interface TabAnalysis {
+    saved: SnapshotTab;
+    status: TabStatus;
+    currentTargetId?: string;
+    currentUrl?: string;
+}
+export declare const SNAPSHOT_DIR: string;
+export declare function loadSnapshot(snapshotId?: string): SessionSnapshot | null;
+export declare function analyzeTabs(savedTabs: SnapshotTab[]): Promise<TabAnalysis[]>;
+export declare function generateResumeGuide(snapshot: SessionSnapshot, tabAnalysis: TabAnalysis[]): string;
+export declare function registerSessionResumeTool(server: MCPServer): void;
+export {};
+//# sourceMappingURL=session-resume.d.ts.map

package/dist/tools/session-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume.d.ts","sourceRoot":"","sources":["../../src/tools/session-resume.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM1C,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,KAAK,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhD,UAAU,WAAW;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyBD,eAAO,MAAM,YAAY,QAAsD,CAAC;AAEhF,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAYxE;AAID,wBAAsB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAmElF;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,CAsEjG;AA2CD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEjE"}

package/dist/tools/session-resume.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * Session Resume Tool — restores browser context after compaction.
+ * Reads a snapshot, cross-references with live state, generates resume guide.
+ * Part of #355: AI Agent Continuity.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SNAPSHOT_DIR = void 0;
+exports.loadSnapshot = loadSnapshot;
+exports.analyzeTabs = analyzeTabs;
+exports.generateResumeGuide = generateResumeGuide;
+exports.registerSessionResumeTool = registerSessionResumeTool;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const session_manager_1 = require("../session-manager");
+// ─── Tool Definition ───────────────────────────────────────────────────────
+const definition = {
+    name: 'oc_session_resume',
+    description: 'Restore working context after context compaction. ' +
+        'Reads the last oc_session_snapshot, checks which tabs are still alive, ' +
+        'and returns a resume guide with your objective, progress, and tab status. ' +
+        'Call this after compaction to continue where you left off.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            snapshotId: {
+                type: 'string',
+                description: 'Specific snapshot ID to restore (default: latest)',
+            },
+        },
+        required: [],
+    },
+};
+// ─── Snapshot Loading ──────────────────────────────────────────────────────
+exports.SNAPSHOT_DIR = path.join(os.homedir(), '.openchrome', 'snapshots');
+function loadSnapshot(snapshotId) {
+    try {
+        const filename = snapshotId ? `${snapshotId}.json` : 'latest.json';
+        const filepath = path.join(exports.SNAPSHOT_DIR, filename);
+        const content = fs.readFileSync(filepath, 'utf-8');
+        const snapshot = JSON.parse(content);
+        if (snapshot.version !== 1)
+            return null;
+        return snapshot;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Tab Analysis ──────────────────────────────────────────────────────────
+async function analyzeTabs(savedTabs) {
+    const results = [];
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    for (const saved of savedTabs) {
+        // Step 1: Try exact targetId match using the saved sessionId
+        let foundLive = false;
+        try {
+            const page = await sessionManager.getPage(saved.sessionId, saved.targetId, saved.workerId);
+            if (page) {
+                const currentUrl = page.url() || 'about:blank';
+                results.push({
+                    saved,
+                    status: 'LIVE',
+                    currentTargetId: saved.targetId,
+                    currentUrl,
+                });
+                foundLive = true;
+            }
+        }
+        catch {
+            // Target not found or session mismatch — try URL remapping below
+        }
+        if (foundLive)
+            continue;
+        // Step 2: Try URL-based remapping across all sessions/workers/targets
+        let remapped = false;
+        try {
+            const allSessionInfos = sessionManager.getAllSessionInfos();
+            outer: for (const sessionInfo of allSessionInfos) {
+                for (const workerInfo of sessionInfo.workers) {
+                    const targetIds = sessionManager.getWorkerTargetIds(sessionInfo.id, workerInfo.id);
+                    for (const targetId of targetIds) {
+                        try {
+                            const page = await sessionManager.getPage(sessionInfo.id, targetId);
+                            if (page && page.url() === saved.url) {
+                                results.push({
+                                    saved,
+                                    status: 'REMAPPED',
+                                    currentTargetId: targetId,
+                                    currentUrl: page.url(),
+                                });
+                                remapped = true;
+                                break outer;
+                            }
+                        }
+                        catch {
+                            // Skip unreachable targets
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Session manager error during URL scan — fall through to CLOSED
+        }
+        if (remapped)
+            continue;
+        // Step 3: Tab is gone
+        results.push({
+            saved,
+            status: 'CLOSED',
+        });
+    }
+    return results;
+}
+// ─── Resume Guide Generation ───────────────────────────────────────────────
+function generateResumeGuide(snapshot, tabAnalysis) {
+    const lines = [];
+    const age = Date.now() - snapshot.timestamp;
+    const ageStr = age < 60000 ? `${Math.round(age / 1000)}s` :
+        age < 3600000 ? `${Math.round(age / 60000)}m` :
+            `${Math.round(age / 3600000)}h`;
+    lines.push('=== CONTEXT RESTORED ===');
+    lines.push('');
+    lines.push(`Objective: ${snapshot.memo.objective}`);
+    lines.push(`Last step: ${snapshot.memo.currentStep}`);
+    lines.push(`Snapshot age: ${ageStr}${snapshot.label ? ` (${snapshot.label})` : ''}`);
+    if (age > 24 * 3600000) {
+        lines.push('WARNING: Snapshot is over 24 hours old. Tab states may be inaccurate.');
+    }
+    // Tab status
+    const live = tabAnalysis.filter(t => t.status === 'LIVE');
+    const remapped = tabAnalysis.filter(t => t.status === 'REMAPPED');
+    const closed = tabAnalysis.filter(t => t.status === 'CLOSED');
+    lines.push('');
+    lines.push(`Tabs: ${live.length} LIVE, ${remapped.length} REMAPPED, ${closed.length} CLOSED`);
+    if (tabAnalysis.length > 0) {
+        lines.push('');
+        for (const tab of tabAnalysis) {
+            const statusLabel = tab.status === 'LIVE' ? 'LIVE    ' :
+                tab.status === 'REMAPPED' ? 'REMAPPED' :
+                    'CLOSED  ';
+            const url = tab.saved.url;
+            const title = tab.saved.title ? ` "${tab.saved.title}"` : '';
+            if (tab.status === 'REMAPPED') {
+                lines.push(`  [${statusLabel}] ${tab.saved.targetId} -> ${tab.currentTargetId} ${url}${title}`);
+            }
+            else if (tab.status === 'CLOSED') {
+                lines.push(`  [${statusLabel}] ${url}${title}`);
+            }
+            else {
+                lines.push(`  [${statusLabel}] ${tab.currentTargetId} ${url}${title}`);
+            }
+        }
+    }
+    // Completed steps
+    if (snapshot.memo.completedSteps && snapshot.memo.completedSteps.length > 0) {
+        lines.push('');
+        lines.push('Completed:');
+        for (const step of snapshot.memo.completedSteps) {
+            lines.push(`  - ${step}`);
+        }
+    }
+    // Next actions
+    if (snapshot.memo.nextActions.length > 0) {
+        lines.push('');
+        lines.push('Next actions:');
+        snapshot.memo.nextActions.forEach((action, i) => {
+            lines.push(`  ${i + 1}. ${action}`);
+        });
+    }
+    // Notes
+    if (snapshot.memo.notes) {
+        lines.push('');
+        lines.push(`Notes: ${snapshot.memo.notes}`);
+    }
+    return lines.join('\n');
+}
+// ─── Handler ───────────────────────────────────────────────────────────────
+const handler = async (_sessionId, args) => {
+    const snapshotId = args.snapshotId;
+    const snapshot = loadSnapshot(snapshotId);
+    if (!snapshot) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: 'No snapshot found.' +
+                        (snapshotId ? ` Snapshot "${snapshotId}" does not exist.` : '') +
+                        ' Use oc_session_snapshot to save state before long operations.',
+                }],
+        };
+    }
+    let tabAnalysis;
+    try {
+        tabAnalysis = await analyzeTabs(snapshot.tabs);
+    }
+    catch {
+        // Can't analyze tabs (Chrome disconnected) — return snapshot data as-is
+        tabAnalysis = snapshot.tabs.map(tab => ({
+            saved: tab,
+            status: 'CLOSED',
+        }));
+    }
+    const guide = generateResumeGuide(snapshot, tabAnalysis);
+    return {
+        content: [{ type: 'text', text: guide }],
+        _snapshotId: snapshot.id,
+    };
+};
+// ─── Registration ──────────────────────────────────────────────────────────
+function registerSessionResumeTool(server) {
+    server.registerTool(definition.name, handler, definition);
+}
+//# sourceMappingURL=session-resume.js.map

package/dist/tools/session-resume.js.map

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

package/dist/tools/session-snapshot.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Session Snapshot Tool — captures browser state for context recovery.
+ * Part of #355: AI Agent Continuity.
+ */
+import { MCPServer } from '../mcp-server';
+export interface SnapshotTab {
+    targetId: string;
+    workerId: string;
+    sessionId: string;
+    url: string;
+    title: string;
+}
+export interface SnapshotMemo {
+    objective: string;
+    currentStep: string;
+    nextActions: string[];
+    completedSteps?: string[];
+    notes?: string;
+}
+export interface SessionSnapshot {
+    version: 1;
+    id: string;
+    timestamp: number;
+    tabs: SnapshotTab[];
+    memo: SnapshotMemo;
+    label?: string;
+}
+export declare const SNAPSHOT_DIR: string;
+export declare const MAX_SNAPSHOTS = 10;
+export declare function generateSnapshotId(): string;
+export declare function collectTabs(): Promise<SnapshotTab[]>;
+export declare function saveSnapshot(snapshot: SessionSnapshot): Promise<void>;
+export declare function pruneSnapshots(): Promise<void>;
+export declare function registerSessionSnapshotTool(server: MCPServer): void;
+//# sourceMappingURL=session-snapshot.d.ts.map

package/dist/tools/session-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-snapshot.d.ts","sourceRoot":"","sources":["../../src/tools/session-snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+CD,eAAO,MAAM,YAAY,QAAsD,CAAC;AAChF,eAAO,MAAM,aAAa,KAAK,CAAC;AAGhC,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAID,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAgD1D;AAQD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3E;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA+BpD;AAgDD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEnE"}

package/dist/tools/session-snapshot.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * Session Snapshot Tool — captures browser state for context recovery.
+ * Part of #355: AI Agent Continuity.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SNAPSHOTS = exports.SNAPSHOT_DIR = void 0;
+exports.generateSnapshotId = generateSnapshotId;
+exports.collectTabs = collectTabs;
+exports.saveSnapshot = saveSnapshot;
+exports.pruneSnapshots = pruneSnapshots;
+exports.registerSessionSnapshotTool = registerSessionSnapshotTool;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const session_manager_1 = require("../session-manager");
+const atomic_file_1 = require("../utils/atomic-file");
+// ─── Tool Definition ───────────────────────────────────────────────────────
+const definition = {
+    name: 'oc_session_snapshot',
+    description: 'Save browser state snapshot for context recovery after compaction. ' +
+        'Captures open tabs, worker state, and your task memo. ' +
+        'Use before long operations or periodically during multi-step tasks. ' +
+        'Restore with oc_session_resume.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            objective: {
+                type: 'string',
+                description: 'What you are trying to accomplish',
+            },
+            currentStep: {
+                type: 'string',
+                description: 'What step you are currently on',
+            },
+            nextActions: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Planned next actions',
+            },
+            completedSteps: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Steps already completed',
+            },
+            notes: {
+                type: 'string',
+                description: 'Additional context or notes',
+            },
+            label: {
+                type: 'string',
+                description: 'Optional label for this snapshot',
+            },
+        },
+        required: ['objective', 'currentStep', 'nextActions'],
+    },
+};
+// ─── Snapshot Directory ────────────────────────────────────────────────────
+exports.SNAPSHOT_DIR = path.join(os.homedir(), '.openchrome', 'snapshots');
+exports.MAX_SNAPSHOTS = 10;
+const MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+function generateSnapshotId() {
+    const now = new Date();
+    const ts = now.toISOString().replace(/[-:]/g, '').replace('T', '-').slice(0, 15);
+    const hex = Math.random().toString(16).slice(2, 6);
+    return `snap-${ts}-${hex}`;
+}
+// ─── Tab Collection ────────────────────────────────────────────────────────
+async function collectTabs() {
+    const tabs = [];
+    try {
+        const sessionManager = (0, session_manager_1.getSessionManager)();
+        const allSessionInfos = sessionManager.getAllSessionInfos();
+        for (const sessionInfo of allSessionInfos) {
+            const sessionId = sessionInfo.id;
+            for (const workerInfo of sessionInfo.workers) {
+                const workerId = workerInfo.id;
+                const targetIds = sessionManager.getWorkerTargetIds(sessionId, workerId);
+                for (const targetId of targetIds) {
+                    let url = 'about:blank';
+                    let title = '';
+                    try {
+                        const page = await sessionManager.getPage(sessionId, targetId, workerId);
+                        if (page) {
+                            url = page.url() || 'about:blank';
+                            try {
+                                title = await page.title();
+                            }
+                            catch {
+                                title = '';
+                            }
+                        }
+                    }
+                    catch {
+                        // Page may be closed or crashed
+                    }
+                    tabs.push({
+                        targetId,
+                        workerId,
+                        sessionId,
+                        url,
+                        title,
+                    });
+                }
+            }
+        }
+    }
+    catch (err) {
+        // Session manager may not be initialized or Chrome not connected
+        console.error('[SessionSnapshot] collectTabs error (graceful fallback):', err instanceof Error ? err.message : String(err));
+    }
+    return tabs;
+}
+// ─── File Management ───────────────────────────────────────────────────────
+async function ensureDir() {
+    await fs.promises.mkdir(exports.SNAPSHOT_DIR, { recursive: true });
+}
+async function saveSnapshot(snapshot) {
+    await ensureDir();
+    // Save as latest.json (atomic overwrite)
+    const latestPath = path.join(exports.SNAPSHOT_DIR, 'latest.json');
+    await (0, atomic_file_1.writeFileAtomicSafe)(latestPath, snapshot);
+    // Save history copy
+    const historyPath = path.join(exports.SNAPSHOT_DIR, `${snapshot.id}.json`);
+    await (0, atomic_file_1.writeFileAtomicSafe)(historyPath, snapshot);
+    // Prune old snapshots
+    await pruneSnapshots();
+}
+async function pruneSnapshots() {
+    try {
+        const files = await fs.promises.readdir(exports.SNAPSHOT_DIR);
+        const snapFiles = files
+            .filter(f => f.startsWith('snap-') && f.endsWith('.json'))
+            .sort(); // Lexicographic sort = chronological for our ID format
+        // Remove excess snapshots (keep MAX_SNAPSHOTS most recent)
+        if (snapFiles.length > exports.MAX_SNAPSHOTS) {
+            const toRemove = snapFiles.slice(0, snapFiles.length - exports.MAX_SNAPSHOTS);
+            for (const file of toRemove) {
+                await fs.promises.unlink(path.join(exports.SNAPSHOT_DIR, file)).catch(() => { });
+            }
+        }
+        // Remove snapshots older than MAX_AGE_MS
+        const cutoff = Date.now() - MAX_AGE_MS;
+        for (const file of snapFiles) {
+            const filePath = path.join(exports.SNAPSHOT_DIR, file);
+            try {
+                const stat = await fs.promises.stat(filePath);
+                if (stat.mtimeMs < cutoff) {
+                    await fs.promises.unlink(filePath);
+                }
+            }
+            catch {
+                // Skip
+            }
+        }
+    }
+    catch {
+        // Best-effort pruning
+    }
+}
+// ─── Handler ───────────────────────────────────────────────────────────────
+const handler = async (_sessionId, args) => {
+    const memo = {
+        objective: args.objective,
+        currentStep: args.currentStep,
+        nextActions: args.nextActions || [],
+        completedSteps: args.completedSteps || undefined,
+        notes: args.notes || undefined,
+    };
+    const tabs = await collectTabs();
+    const snapshotId = generateSnapshotId();
+    const snapshot = {
+        version: 1,
+        id: snapshotId,
+        timestamp: Date.now(),
+        tabs,
+        memo,
+        label: args.label || undefined,
+    };
+    await saveSnapshot(snapshot);
+    const text = [
+        `Snapshot saved: ${snapshotId}`,
+        `Tabs: ${tabs.length}`,
+        `Objective: ${memo.objective}`,
+        `Step: ${memo.currentStep}`,
+        `Next: ${memo.nextActions.join(', ')}`,
+        '',
+        'Use oc_session_resume to restore this context after compaction.',
+    ].join('\n');
+    return {
+        content: [{ type: 'text', text }],
+        _snapshotId: snapshotId,
+    };
+};
+// ─── Registration ──────────────────────────────────────────────────────────
+function registerSessionSnapshotTool(server) {
+    server.registerTool(definition.name, handler, definition);
+}
+//# sourceMappingURL=session-snapshot.js.map

package/dist/tools/session-snapshot.js.map

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

package/dist/tools/tabs-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabs-create.d.ts","sourceRoot":"","sources":["../../src/tools/tabs-create.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA8F1C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE9D"}
+{"version":3,"file":"tabs-create.d.ts","sourceRoot":"","sources":["../../src/tools/tabs-create.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAyG1C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE9D"}

package/dist/tools/tabs-create.js

@@ -21,6 +21,10 @@ const definition = {
                 type: 'string',
                 description: 'Worker ID for parallel ops. Default: default',
             },
+            profileDirectory: {
+                type: 'string',
+                description: 'Chrome profile directory name (e.g., "Profile 1"). Use list_profiles to see available profiles. Launches a separate Chrome instance for each profile. If omitted, uses the server default. Cannot be combined with workerId.',
+            },
         },
         required: ['url'],
     },
@@ -28,7 +32,14 @@ const definition = {
 const handler = async (sessionId, args) => {
     const sessionManager = (0, session_manager_1.getSessionManager)();
     const url = args.url;
-    const workerId = args.workerId;
+    const profileDirectory = args.profileDirectory;
+    if (args.workerId && profileDirectory) {
+        return {
+            content: [{ type: 'text', text: 'Error: workerId and profileDirectory cannot be used together. Use profileDirectory alone (a worker is auto-created per profile).' }],
+            isError: true,
+        };
+    }
+    const workerId = args.workerId || (profileDirectory ? `profile:${profileDirectory}` : undefined);
     // URL is required
     if (!url) {
         return {
@@ -57,7 +68,7 @@ const handler = async (sessionId, args) => {
         };
     }
     try {
-        const { targetId, page, workerId: assignedWorkerId } = await sessionManager.createTarget(sessionId, url, workerId);
+        const { targetId, page, workerId: assignedWorkerId } = await sessionManager.createTarget(sessionId, url, workerId, profileDirectory);
         return {
             content: [
                 {

package/dist/tools/tabs-create.js.map

@@ -1 +1 @@
-{"version":3,"file":"tabs-create.js","sourceRoot":"","sources":["../../src/tools/tabs-create.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAgGH,wDAEC;AA9FD,wDAAuD;AACvD,oDAAgD;AAChD,2DAA+D;AAE/D,MAAM,UAAU,GAAsB;IACpC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,4BAA4B;IACzC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;CACF,CAAC;AAEF,MAAM,OAAO,GAAgB,KAAK,EAChC,SAAiB,EACjB,IAA6B,EACT,EAAE;IACtB,MAAM,cAAc,GAAG,IAAA,mCAAiB,GAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;IAErD,kBAAkB;IAClB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yFAAyF;iBAChG;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC;QACH,IAAA,kCAAmB,EAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEnH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,QAAQ;wBACf,QAAQ,EAAE,gBAAgB;wBAC1B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;wBACf,KAAK,EAAE,MAAM,IAAA,sBAAS,EAAC,IAAI,CAAC;qBAC7B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACtF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,SAAgB,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"tabs-create.js","sourceRoot":"","sources":["../../src/tools/tabs-create.ts"],"names":[],"mappings":"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"}

package/dist/tools/wait-and-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait-and-click.d.ts","sourceRoot":"","sources":["../../src/tools/wait-and-click.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAyL1C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEhE"}
+{"version":3,"file":"wait-and-click.d.ts","sourceRoot":"","sources":["../../src/tools/wait-and-click.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAyO1C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEhE"}