autodev-cli 1.4.0 → 1.4.3

package/out/agentBackup/archive.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Abstraction over a zip archive used by the agent backup feature.
+ *
+ * Export and import depend on this interface rather than on `adm-zip`
+ * directly (Dependency Inversion). All path arguments that point at the
+ * filesystem are absolute; all `archivePath` arguments are POSIX-style
+ * paths *inside* the archive.
+ */
+export interface Archive {
+    /** Add a single file. No-op if the source is missing or not a file. */
+    addFile(absSource: string, archivePath: string): void;
+    /** Add a directory tree. No-op if the source is missing or not a dir. */
+    addDir(absSourceDir: string, archiveDir: string): void;
+    /** Add raw bytes at the given archive path. */
+    addBuffer(archivePath: string, data: Buffer): void;
+    /** Persist the archive to disk. */
+    write(destPath: string): void;
+    /** All entry paths in the archive (POSIX-style, dirs end with `/`). */
+    entryPaths(): string[];
+    /** Read a text entry, or `undefined` if it does not exist. */
+    readText(archivePath: string): string | undefined;
+    /**
+     * Extract every entry whose path starts with `archiveDirPrefix` into
+     * `destAbsDir`, preserving the structure *below* the prefix.
+     * Returns the number of files written.
+     */
+    extractDir(archiveDirPrefix: string, destAbsDir: string): number;
+}
+/** `adm-zip`-backed {@link Archive} implementation. */
+export declare class AdmZipArchive implements Archive {
+    private readonly zip;
+    private constructor();
+    /** Create an empty archive for writing. */
+    static create(): AdmZipArchive;
+    /** Open an existing archive on disk for reading. */
+    static open(zipPath: string): AdmZipArchive;
+    addFile(absSource: string, archivePath: string): void;
+    addDir(absSourceDir: string, archiveDir: string): void;
+    addBuffer(archivePath: string, data: Buffer): void;
+    write(destPath: string): void;
+    entryPaths(): string[];
+    readText(archivePath: string): string | undefined;
+    extractDir(archiveDirPrefix: string, destAbsDir: string): number;
+}

package/out/agentBackup/archive.js

@@ -0,0 +1,131 @@
+"use strict";
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdmZipArchive = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+/** Normalise to forward slashes (adm-zip stores POSIX separators). */
+function toPosix(p) {
+    return p.replace(/\\/g, '/');
+}
+/** `adm-zip`-backed {@link Archive} implementation. */
+class AdmZipArchive {
+    zip;
+    constructor(zip) {
+        this.zip = zip;
+    }
+    /** Create an empty archive for writing. */
+    static create() {
+        return new AdmZipArchive(new adm_zip_1.default());
+    }
+    /** Open an existing archive on disk for reading. */
+    static open(zipPath) {
+        return new AdmZipArchive(new adm_zip_1.default(zipPath));
+    }
+    addFile(absSource, archivePath) {
+        if (!fs.existsSync(absSource)) {
+            return;
+        }
+        try {
+            if (!fs.statSync(absSource).isFile()) {
+                return;
+            }
+            const ap = toPosix(archivePath);
+            this.zip.addLocalFile(absSource, path.posix.dirname(ap), path.posix.basename(ap));
+        }
+        catch { /* ignore unreadable file */ }
+    }
+    addDir(absSourceDir, archiveDir) {
+        if (!fs.existsSync(absSourceDir)) {
+            return;
+        }
+        try {
+            if (!fs.statSync(absSourceDir).isDirectory()) {
+                return;
+            }
+            this.zip.addLocalFolder(absSourceDir, toPosix(archiveDir));
+        }
+        catch { /* ignore unreadable dir */ }
+    }
+    addBuffer(archivePath, data) {
+        this.zip.addFile(toPosix(archivePath), data);
+    }
+    write(destPath) {
+        this.zip.writeZip(destPath);
+    }
+    entryPaths() {
+        return this.zip.getEntries().map(e => toPosix(e.entryName));
+    }
+    readText(archivePath) {
+        const entry = this.zip.getEntry(toPosix(archivePath));
+        if (!entry || entry.isDirectory) {
+            return undefined;
+        }
+        try {
+            return entry.getData().toString('utf8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    extractDir(archiveDirPrefix, destAbsDir) {
+        const prefix = toPosix(archiveDirPrefix).replace(/\/$/, '') + '/';
+        let written = 0;
+        for (const entry of this.zip.getEntries()) {
+            const name = toPosix(entry.entryName);
+            if (entry.isDirectory || !name.startsWith(prefix)) {
+                continue;
+            }
+            const rel = name.slice(prefix.length);
+            if (!rel || rel.includes('..')) {
+                continue;
+            } // guard against zip-slip
+            const dest = path.join(destAbsDir, rel);
+            fs.mkdirSync(path.dirname(dest), { recursive: true });
+            try {
+                fs.writeFileSync(dest, entry.getData());
+                written++;
+            }
+            catch { /* ignore unwritable target */ }
+        }
+        return written;
+    }
+}
+exports.AdmZipArchive = AdmZipArchive;
+//# sourceMappingURL=archive.js.map

package/out/agentBackup/archive.js.map

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

package/out/agentBackup/export.d.ts

@@ -0,0 +1,18 @@
+import { ProviderManifestEntry } from './manifest';
+export interface ExportResult {
+    destPath: string;
+    /** Provider ids for which real traces were captured. */
+    capturedProviders: string[];
+    /** Per-provider manifest entries (portability, discovered IDs, etc.). */
+    providers: Record<string, ProviderManifestEntry>;
+}
+/**
+ * Pure (vscode-free) core: build and write the agent backup ZIP.
+ * Called both by the VS Code command (with a dialog-chosen path) and directly
+ * from the CLI (with a CLI-supplied path).
+ */
+export declare function createAgentBackup(root: string, destPath: string): Promise<ExportResult>;
+/**
+ * VS Code command handler: show a save dialog then call {@link createAgentBackup}.
+ * Imports `vscode` lazily so this module stays loadable outside the extension host.
+ */

package/out/agentBackup/export.js

@@ -0,0 +1,92 @@
+"use strict";
+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.createAgentBackup = createAgentBackup;
+const path = __importStar(require("path"));
+const archive_1 = require("./archive");
+const layout_1 = require("./layout");
+const sessionProviders_1 = require("./sessionProviders");
+const manifest_1 = require("./manifest");
+/**
+ * Pure (vscode-free) core: build and write the agent backup ZIP.
+ * Called both by the VS Code command (with a dialog-chosen path) and directly
+ * from the CLI (with a CLI-supplied path).
+ */
+async function createAgentBackup(root, destPath) {
+    const archive = archive_1.AdmZipArchive.create();
+    // Workspace state directories (single source of truth in layout).
+    for (const rel of layout_1.WORKSPACE_DIRS) {
+        archive.addDir(path.join(root, rel), `${layout_1.ARCHIVE_PATHS.workspace}/${rel}`);
+    }
+    // Root-level agent docs.
+    for (const f of layout_1.ROOT_DOCS) {
+        archive.addFile(path.join(root, f), `${layout_1.ARCHIVE_PATHS.workspace}/${f}`);
+    }
+    // Provider session traces (Strategy — one entry per provider family).
+    const sessionState = (0, manifest_1.readSessionState)(root);
+    const providers = {};
+    const capturedProviders = [];
+    for (const provider of sessionProviders_1.SESSION_BACKUP_PROVIDERS) {
+        const result = await provider.collect(root, archive);
+        const connected = {};
+        for (const key of provider.sessionStateKeys) {
+            connected[key] = sessionState[key] ?? null;
+        }
+        providers[provider.id] = {
+            portability: provider.portability,
+            note: provider.note,
+            discoveredSessionIds: result.discoveredIds,
+            connectedSessionIds: connected,
+            tracesCaptured: result.tracesCaptured,
+        };
+        if (result.tracesCaptured) {
+            capturedProviders.push(provider.id);
+        }
+    }
+    // Session-ID manifest (per-provider, honest portability tags).
+    const manifest = {
+        exportedAt: new Date().toISOString(),
+        workspaceRoot: root,
+        providers,
+    };
+    archive.addBuffer(layout_1.ARCHIVE_PATHS.manifest, Buffer.from(JSON.stringify(manifest, null, 2), 'utf8'));
+    archive.write(destPath);
+    return { destPath, capturedProviders, providers };
+}
+/**
+ * VS Code command handler: show a save dialog then call {@link createAgentBackup}.
+ * Imports `vscode` lazily so this module stays loadable outside the extension host.
+ */
+//# sourceMappingURL=export.js.map

package/out/agentBackup/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/agentBackup/export.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,8CA2CC;AA9DD,2CAA6B;AAC7B,uCAA0C;AAC1C,qCAAoE;AACpE,yDAA8D;AAC9D,yCAAsF;AAUtF;;;;GAIG;AACI,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IACpE,MAAM,OAAO,GAAG,uBAAa,CAAC,MAAM,EAAE,CAAC;IAEvC,kEAAkE;IAClE,KAAK,MAAM,GAAG,IAAI,uBAAc,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,sBAAa,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,CAAC,IAAI,kBAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,GAAG,sBAAa,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,sEAAsE;IACtE,MAAM,YAAY,GAAG,IAAA,2BAAgB,EAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAA0C,EAAE,CAAC;IAC5D,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,KAAK,MAAM,QAAQ,IAAI,2CAAwB,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,GAAkC,EAAE,CAAC;QACpD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC5C,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAC7C,CAAC;QACD,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG;YACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,oBAAoB,EAAE,MAAM,CAAC,aAAa;YAC1C,mBAAmB,EAAE,SAAS;YAC9B,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC;QACF,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;IACrE,CAAC;IAED,+DAA+D;IAC/D,MAAM,QAAQ,GAAoB;QAChC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,aAAa,EAAE,IAAI;QACnB,SAAS;KACV,CAAC;IACF,OAAO,CAAC,SAAS,CAAC,sBAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAExB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG"}

package/out/agentBackup/import.d.ts

@@ -0,0 +1,21 @@
+export interface ImportResult {
+    destRoot: string;
+    workspaceFiles: number;
+    /** Provider id → number of session-trace files restored. */
+    restoredByProvider: Record<string, number>;
+    manifestRestored: boolean;
+}
+/**
+ * Restore an agent backup ZIP into a destination folder and wire up its
+ * session state so it resumes there. Mirrors {@link './export'} using the
+ * same shared layout (DRY).
+ *
+ * The workspace `.autodev/` (including `session-state.json`) is restored
+ * verbatim, so connected session IDs travel automatically — the per-provider
+ * `restore()` calls place the matching traces into each host store.
+ */
+export declare function restoreAgentBackup(zipPath: string, destRoot: string): Promise<ImportResult>;
+/**
+ * Interactive command flow: pick a backup ZIP, pick a destination folder,
+ * restore, then offer to open the restored workspace.
+ */

package/out/agentBackup/import.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restoreAgentBackup = restoreAgentBackup;
+const archive_1 = require("./archive");
+const layout_1 = require("./layout");
+const sessionProviders_1 = require("./sessionProviders");
+const manifest_1 = require("./manifest");
+/**
+ * Restore an agent backup ZIP into a destination folder and wire up its
+ * session state so it resumes there. Mirrors {@link './export'} using the
+ * same shared layout (DRY).
+ *
+ * The workspace `.autodev/` (including `session-state.json`) is restored
+ * verbatim, so connected session IDs travel automatically — the per-provider
+ * `restore()` calls place the matching traces into each host store.
+ */
+async function restoreAgentBackup(zipPath, destRoot) {
+    const archive = archive_1.AdmZipArchive.open(zipPath);
+    // Reject archives that aren't an agent backup.
+    if (!archive.entryPaths().some(p => p.startsWith(`${layout_1.TOP_FOLDER}/`))) {
+        throw new Error('Not an AutoDev agent backup (missing agent-export/ root).');
+    }
+    // 1. Workspace state + root docs back into the destination folder.
+    const workspaceFiles = archive.extractDir(layout_1.ARCHIVE_PATHS.workspace, destRoot);
+    // 2. Provider session traces into their host stores (Strategy).
+    const restoredByProvider = {};
+    for (const provider of sessionProviders_1.SESSION_BACKUP_PROVIDERS) {
+        const n = await provider.restore(destRoot, archive);
+        if (n > 0) {
+            restoredByProvider[provider.id] = n;
+        }
+    }
+    const manifest = (0, manifest_1.parseManifest)(archive.readText(layout_1.ARCHIVE_PATHS.manifest));
+    return { destRoot, workspaceFiles, restoredByProvider, manifestRestored: !!manifest };
+}
+/**
+ * Interactive command flow: pick a backup ZIP, pick a destination folder,
+ * restore, then offer to open the restored workspace.
+ */
+//# sourceMappingURL=import.js.map

package/out/agentBackup/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/agentBackup/import.ts"],"names":[],"mappings":";;AAuBA,gDAoBC;AA1CD,uCAA0C;AAC1C,qCAAqD;AACrD,yDAA8D;AAC9D,yCAA2C;AAU3C;;;;;;;;GAQG;AACI,KAAK,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAgB;IACxE,MAAM,OAAO,GAAG,uBAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,+CAA+C;IAC/C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,mBAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,mEAAmE;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,sBAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE7E,gEAAgE;IAChE,MAAM,kBAAkB,GAA2B,EAAE,CAAC;IACtD,KAAK,MAAM,QAAQ,IAAI,2CAAwB,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,wBAAa,EAAC,OAAO,CAAC,QAAQ,CAAC,sBAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AACxF,CAAC;AAED;;;GAGG"}

package/out/agentBackup/index.d.ts

@@ -0,0 +1,6 @@
+export { createAgentBackup } from './export';
+export type { ExportResult } from './export';
+export { restoreAgentBackup } from './import';
+export type { ImportResult } from './import';
+export { uploadAgentBackup, downloadAgentBackup } from './upload';
+export type { UploadResult } from './upload';

package/out/agentBackup/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadAgentBackup = exports.uploadAgentBackup = exports.restoreAgentBackup = exports.createAgentBackup = void 0;
+var export_1 = require("./export");
+Object.defineProperty(exports, "createAgentBackup", { enumerable: true, get: function () { return export_1.createAgentBackup; } });
+var import_1 = require("./import");
+Object.defineProperty(exports, "restoreAgentBackup", { enumerable: true, get: function () { return import_1.restoreAgentBackup; } });
+var upload_1 = require("./upload");
+Object.defineProperty(exports, "uploadAgentBackup", { enumerable: true, get: function () { return upload_1.uploadAgentBackup; } });
+Object.defineProperty(exports, "downloadAgentBackup", { enumerable: true, get: function () { return upload_1.downloadAgentBackup; } });
+//# sourceMappingURL=index.js.map

package/out/agentBackup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agentBackup/index.ts"],"names":[],"mappings":";;;AAAA,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA;AAE1B,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA;AAE3B,mCAAkE;AAAzD,2GAAA,iBAAiB,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}

package/out/agentBackup/layout.d.ts

@@ -0,0 +1,30 @@
+/** Top-level folder inside the archive that everything lives under. */
+export declare const TOP_FOLDER = "agent-export";
+/** Archive sub-paths, derived once from {@link TOP_FOLDER}. */
+export declare const ARCHIVE_PATHS: {
+    readonly workspace: "agent-export/workspace";
+    readonly sessionsRoot: "agent-export/sessions";
+    readonly manifest: "agent-export/manifest/session-ids.json";
+};
+/** Archive path for a given provider's session traces. */
+export declare function sessionsPath(providerId: string): string;
+/**
+ * Root-level documents that carry agent context/protocol. Backed up and
+ * restored verbatim relative to the workspace root.
+ */
+export declare const ROOT_DOCS: readonly string[];
+/**
+ * Directories under the workspace that hold agent state. Each maps a
+ * workspace-relative source to the same relative location inside
+ * `agent-export/workspace/`. This single list is the source of truth shared
+ * by both export and import (DRY).
+ */
+export declare const WORKSPACE_DIRS: readonly string[];
+/** Normalise a filesystem path for comparison (case-insensitive, slash-form). */
+export declare function normalizePath(p: string): string;
+/** Root of the Copilot CLI store. */
+export declare function copilotDir(): string;
+/** `~/.copilot/session-state` — one sub-folder per session, keyed by uuid. */
+export declare function copilotSessionStateDir(): string;
+/** Resolve the OpenCode data directory if present (first existing wins). */
+export declare function findOpenCodeDataDir(): string | undefined;

package/out/agentBackup/layout.js

@@ -0,0 +1,126 @@
+"use strict";
+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.WORKSPACE_DIRS = exports.ROOT_DOCS = exports.ARCHIVE_PATHS = exports.TOP_FOLDER = void 0;
+exports.sessionsPath = sessionsPath;
+exports.normalizePath = normalizePath;
+exports.copilotDir = copilotDir;
+exports.copilotSessionStateDir = copilotSessionStateDir;
+exports.findOpenCodeDataDir = findOpenCodeDataDir;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/** Top-level folder inside the archive that everything lives under. */
+exports.TOP_FOLDER = 'agent-export';
+/** Archive sub-paths, derived once from {@link TOP_FOLDER}. */
+exports.ARCHIVE_PATHS = {
+    workspace: `${exports.TOP_FOLDER}/workspace`,
+    sessionsRoot: `${exports.TOP_FOLDER}/sessions`,
+    manifest: `${exports.TOP_FOLDER}/manifest/session-ids.json`,
+};
+/** Archive path for a given provider's session traces. */
+function sessionsPath(providerId) {
+    return `${exports.ARCHIVE_PATHS.sessionsRoot}/${providerId}`;
+}
+/**
+ * Root-level documents that carry agent context/protocol. Backed up and
+ * restored verbatim relative to the workspace root.
+ */
+exports.ROOT_DOCS = [
+    'AGENTS.md', 'CLAUDE.md', 'SOUL.md', 'JOURNAL.md', 'CONTRACTS.md', 'TODO.md',
+    'DONE.md', 'TASKS.md', 'LESSONS.md', 'NOTES.md', 'SCRATCHPAD.md',
+];
+/**
+ * Directories under the workspace that hold agent state. Each maps a
+ * workspace-relative source to the same relative location inside
+ * `agent-export/workspace/`. This single list is the source of truth shared
+ * by both export and import (DRY).
+ */
+exports.WORKSPACE_DIRS = [
+    '.autodev',
+    path.posix.join('media', 'profile'),
+    path.posix.join('media', 'skills'),
+];
+/** Normalise a filesystem path for comparison (case-insensitive, slash-form). */
+function normalizePath(p) {
+    return p.replace(/\\/g, '/').replace(/\/+$/, '').toLowerCase();
+}
+// ---------------------------------------------------------------------------
+// Copilot CLI store — VERIFIED on-disk layout (PLAN §2.6)
+//   ~/.copilot/session-state/<uuid>/  (events.jsonl, workspace.yaml, …)
+//   ~/.copilot/session-store.db       (SQLite index — not touched on restore)
+// ---------------------------------------------------------------------------
+/** Root of the Copilot CLI store. */
+function copilotDir() {
+    return path.join(os.homedir(), '.copilot');
+}
+/** `~/.copilot/session-state` — one sub-folder per session, keyed by uuid. */
+function copilotSessionStateDir() {
+    return path.join(copilotDir(), 'session-state');
+}
+// ---------------------------------------------------------------------------
+// OpenCode store — VERIFIED on-disk layout (PLAN §2.6)
+//   ~/.local/share/opencode/opencode.db   (SQLite — sessions + messages)
+//   ~/.local/share/opencode/storage/…      (diffs/snapshots only, not a session)
+// There is NO per-session directory, so per-session restore is NOT supported
+// without a SQLite dependency. Kept only for discovery/diagnostics.
+// ---------------------------------------------------------------------------
+/** Resolve the OpenCode data directory if present (first existing wins). */
+function findOpenCodeDataDir() {
+    const candidates = [];
+    const xdg = process.env['XDG_DATA_HOME'];
+    if (xdg) {
+        candidates.push(path.join(xdg, 'opencode'));
+    }
+    candidates.push(path.join(os.homedir(), '.local', 'share', 'opencode'));
+    candidates.push(path.join(os.homedir(), '.opencode'));
+    const appdata = process.env['APPDATA'];
+    if (appdata) {
+        candidates.push(path.join(appdata, 'opencode'));
+    }
+    const localAppData = process.env['LOCALAPPDATA'];
+    if (localAppData) {
+        candidates.push(path.join(localAppData, 'opencode'));
+    }
+    return candidates.find(d => {
+        try {
+            return fs.statSync(d).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+//# sourceMappingURL=layout.js.map

package/out/agentBackup/layout.js.map

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

package/out/agentBackup/manifest.d.ts

@@ -0,0 +1,24 @@
+import type { Portability } from './sessionProviders';
+/** Per-provider record in the manifest. */
+export interface ProviderManifestEntry {
+    /** Portability classification for this provider family. */
+    portability: Portability;
+    /** Human-readable explanation of what was/wasn't captured. */
+    note: string;
+    /** Session IDs discovered for this workspace. */
+    discoveredSessionIds: string[];
+    /** Currently connected session ID(s) from session-state.json, keyed. */
+    connectedSessionIds: Record<string, string | null>;
+    /** True if real conversation traces were written into the archive. */
+    tracesCaptured: boolean;
+}
+/** Manifest written into the archive describing what was captured. */
+export interface SessionManifest {
+    exportedAt: string;
+    workspaceRoot: string;
+    providers: Record<string, ProviderManifestEntry>;
+}
+/** Read all string-valued session IDs from `<root>/.autodev/session-state.json`. */
+export declare function readSessionState(root: string): Record<string, string>;
+/** Parse a manifest from its JSON text, or `undefined` if invalid. */
+export declare function parseManifest(text: string | undefined): SessionManifest | undefined;

package/out/agentBackup/manifest.js

@@ -0,0 +1,70 @@
+"use strict";
+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.readSessionState = readSessionState;
+exports.parseManifest = parseManifest;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Read all string-valued session IDs from `<root>/.autodev/session-state.json`. */
+function readSessionState(root) {
+    const out = {};
+    const p = path.join(root, '.autodev', 'session-state.json');
+    try {
+        if (!fs.existsSync(p)) {
+            return out;
+        }
+        const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
+        for (const [k, v] of Object.entries(raw)) {
+            if (typeof v === 'string' && v.trim()) {
+                out[k] = v;
+            }
+        }
+    }
+    catch { /* ignore malformed file */ }
+    return out;
+}
+/** Parse a manifest from its JSON text, or `undefined` if invalid. */
+function parseManifest(text) {
+    if (!text) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=manifest.js.map