@heyditto/cli 2.42.0 → 3.0.0

package/dist/teleport/api.d.ts

@@ -2,7 +2,7 @@ import type { Manifest } from "./types.js";
 export interface Capsule {
     id: string;
     name: string;
-    rootKind: "repo" | "folder";
+    rootKind: "repo" | "folder" | "archive";
     harnessKind?: string;
     harnessSessionId?: string | null;
     headGeneration: number;
@@ -96,7 +96,7 @@ export type CommittedBy = "cli" | "runner";
 export declare function listCapsules(): Promise<Capsule[]>;
 export declare function createCapsule(input: {
     name: string;
-    rootKind: "repo" | "folder";
+    rootKind: "repo" | "folder" | "archive";
     harnessKind?: string;
     harnessSessionId?: string;
     mirrorPolicy?: Capsule["mirrorPolicy"];

package/dist/teleport/archive.d.ts

@@ -0,0 +1,88 @@
+import { type ChunkRef } from "./types.js";
+/**
+ * Archive capsules back up trees that only grow: coding-agent session
+ * history and local recovery data. Each source is one tar stream, cut into
+ * content-defined chunks (gear rolling hash) so an append or an edit only
+ * changes the chunks around it, and every chunk is zstd-compressed on its own
+ * so it dedupes by content and restores without its neighbours. The manifest
+ * lists the chunks in order; restore decompresses and concatenates them.
+ */
+export interface ArchiveSource {
+    /** Unique name in the capsule, e.g. "claude-code". */
+    name: string;
+    /** Directory whose contents are archived (paths stored relative to it). */
+    dir: string;
+}
+export interface ArchiveEntry {
+    name: string;
+    format: "tar";
+    chunkCompression: "zstd";
+    chunks: ChunkRef[];
+    entries: number;
+    bytes: number;
+}
+export interface ArchiveManifest {
+    v: number;
+    capsuleId: string;
+    generation: number;
+    parentGeneration: number;
+    createdAt: string;
+    machine: Record<string, unknown>;
+    root: {
+        kind: "archive";
+        name: string;
+    };
+    repos: [];
+    archives: ArchiveEntry[];
+    harness: {
+        kind: "none";
+        chunks: [];
+    };
+    totals: {
+        chunks: number;
+        bytes: number;
+        dedupedBytes?: number;
+    };
+}
+/**
+ * Content-defined boundaries over a buffer: a cut where the rolling hash's low
+ * bits are zero, bounded by MIN_CHUNK and MAX_CHUNK. Exported for tests.
+ */
+export declare function cdcBoundaries(buf: Buffer): number[];
+export interface BuiltArchive {
+    entry: ArchiveEntry;
+    /** sha256 → compressed bytes on disk, for upload. */
+    files: Map<string, string>;
+}
+/**
+ * Tars `src.dir` and writes each compressed chunk into `outDir`. The tar is
+ * read through a window of at most MAX_CHUNK + one read, so memory stays
+ * bounded however large the source grows; boundaries match cdcBoundaries.
+ */
+export declare function buildArchive(src: ArchiveSource, outDir: string): Promise<BuiltArchive>;
+export interface ArchivePushOutput {
+    generation: number;
+    logicalBytes: number;
+    storedBytes: number;
+    uploadedBytes: number;
+    uploaded: number;
+    reused: number;
+    archives: {
+        name: string;
+        entries: number;
+        bytes: number;
+        chunks: number;
+    }[];
+}
+/** Builds every source, uploads only chunks the server lacks, commits a generation. */
+export declare function pushArchive(capsuleId: string, rootName: string, sources: ArchiveSource[], parentGeneration: number): Promise<ArchivePushOutput>;
+/**
+ * Restores one archive of a generation into `dest` (which must not exist):
+ * downloads each chunk, checks its sha256, decompresses and untars.
+ */
+export declare function restoreArchive(capsuleId: string, name: string, dest: string, generation?: number): Promise<{
+    entries: number;
+    bytes: number;
+}>;
+/** Default sources: agent session history and infinite-disk's retained recovery data. */
+export declare function defaultArchiveSources(home?: string): ArchiveSource[];

package/dist/teleport/archive.js

@@ -0,0 +1,280 @@
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream } from "node:fs";
+import { mkdir, mkdtemp, open, readFile, rm, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { zstdCompressSync, zstdDecompressSync } from "node:zlib";
+import { packageVersion } from "../config.js";
+import * as tapi from "./api.js";
+import { CHUNK_BYTES, MANIFEST_VERSION, machineInfo } from "./types.js";
+const MIN_CHUNK = 512 * 1024;
+const AVG_BITS = 21; // ~2 MiB average
+const MAX_CHUNK = 8 * 1024 * 1024;
+const MASK = (1 << AVG_BITS) - 1;
+const NEGOTIATE_BATCH = 200;
+const PUT_CONCURRENCY = 4;
+/** Deterministic gear table: chunk boundaries must match across machines. */
+const GEAR = (() => {
+    const t = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        t[i] = createHash("sha256").update(`ditto-archive-gear-${i}`).digest().readUInt32LE(0);
+    }
+    return t;
+})();
+/**
+ * Content-defined boundaries over a buffer: a cut where the rolling hash's low
+ * bits are zero, bounded by MIN_CHUNK and MAX_CHUNK. Exported for tests.
+ */
+export function cdcBoundaries(buf) {
+    const cuts = [];
+    let start = 0;
+    while (start < buf.length) {
+        const end = Math.min(buf.length, start + MAX_CHUNK);
+        let cut = end;
+        let h = 0;
+        for (let i = start + MIN_CHUNK; i < end; i++) {
+            h = ((h << 1) + GEAR[buf[i]]) >>> 0;
+            if ((h & MASK) === 0) {
+                cut = i + 1;
+                break;
+            }
+        }
+        cuts.push(cut);
+        start = cut;
+    }
+    return cuts;
+}
+/**
+ * Tars `src.dir` and writes each compressed chunk into `outDir`. The tar is
+ * read through a window of at most MAX_CHUNK + one read, so memory stays
+ * bounded however large the source grows; boundaries match cdcBoundaries.
+ */
+export async function buildArchive(src, outDir) {
+    const tarFile = path.join(outDir, `${safe(src.name)}.tar`);
+    const entries = await tarDirectory(src.dir, tarFile);
+    const chunks = [];
+    const files = new Map();
+    let bytes = 0;
+    const emit = async (piece) => {
+        const z = zstdCompressSync(piece);
+        if (z.length > CHUNK_BYTES)
+            throw new Error(`compressed chunk exceeds ${CHUNK_BYTES} bytes`);
+        const sha = createHash("sha256").update(z).digest("hex");
+        chunks.push({ sha256: sha, size: z.length });
+        if (!files.has(sha)) {
+            const file = path.join(outDir, sha);
+            await writeFile(file, z);
+            files.set(sha, file);
+        }
+    };
+    try {
+        let pending = Buffer.alloc(0);
+        for await (const piece of createReadStream(tarFile, { highWaterMark: 1 << 20 })) {
+            const buf = piece;
+            bytes += buf.length;
+            pending = pending.length === 0 ? buf : Buffer.concat([pending, buf]);
+            // A cut is final once MAX_CHUNK bytes follow its start: later data
+            // can't move it. Keep the unfinished tail.
+            while (pending.length >= MAX_CHUNK) {
+                const cut = cdcBoundaries(pending.subarray(0, MAX_CHUNK))[0];
+                await emit(Buffer.from(pending.subarray(0, cut)));
+                pending = Buffer.from(pending.subarray(cut));
+            }
+        }
+        // The tail is under MAX_CHUNK; its cuts are offsets into this buffer.
+        let start = 0;
+        for (const cut of cdcBoundaries(pending)) {
+            await emit(Buffer.from(pending.subarray(start, cut)));
+            start = cut;
+        }
+    }
+    finally {
+        await rm(tarFile, { force: true });
+    }
+    return { entry: { name: src.name, format: "tar", chunkCompression: "zstd", chunks, entries, bytes }, files };
+}
+/** tar with paths relative to `dir`; returns the entry count. */
+async function tarDirectory(dir, outFile) {
+    const info = await stat(dir);
+    if (!info.isDirectory())
+        throw new Error(`${dir} is not a directory`);
+    const list = await run("tar", ["-c", "-f", outFile, "-C", dir, "."]);
+    if (list.code !== 0)
+        throw new Error(`tar failed for ${dir}: ${list.stderr.trim()}`);
+    const count = await run("tar", ["-t", "-f", outFile]);
+    return count.stdout.split("\n").filter((l) => l && !l.endsWith("/")).length;
+}
+/** Builds every source, uploads only chunks the server lacks, commits a generation. */
+export async function pushArchive(capsuleId, rootName, sources, parentGeneration) {
+    const tmp = await mkdtemp(path.join(os.tmpdir(), "teleport-archive-"));
+    try {
+        const archives = [];
+        const files = new Map();
+        for (const src of sources) {
+            const built = await buildArchive(src, tmp);
+            archives.push(built.entry);
+            for (const [sha, file] of built.files)
+                files.set(sha, file);
+        }
+        const all = archives.flatMap((a) => a.chunks);
+        const distinct = new Map();
+        for (const c of all)
+            distinct.set(c.sha256, c);
+        const generation = parentGeneration + 1;
+        const manifest = {
+            v: MANIFEST_VERSION,
+            capsuleId,
+            generation,
+            parentGeneration,
+            createdAt: new Date().toISOString(),
+            machine: machineInfo(packageVersion),
+            root: { kind: "archive", name: rootName },
+            repos: [],
+            archives,
+            harness: { kind: "none", chunks: [] },
+            totals: { chunks: distinct.size, bytes: [...distinct.values()].reduce((n, c) => n + c.size, 0) },
+        };
+        const manifestBytes = Buffer.from(JSON.stringify(manifest));
+        const manifestSha = createHash("sha256").update(manifestBytes).digest("hex");
+        const manifestFile = path.join(tmp, "manifest.json");
+        const fh = await open(manifestFile, "w");
+        await fh.writeFile(manifestBytes);
+        await fh.close();
+        files.set(manifestSha, manifestFile);
+        distinct.set(manifestSha, { sha256: manifestSha, size: manifestBytes.length });
+        const wanted = [...distinct.values()];
+        let uploaded = 0;
+        let uploadedBytes = 0;
+        for (let i = 0; i < wanted.length; i += NEGOTIATE_BATCH) {
+            const neg = await tapi.negotiate(capsuleId, wanted.slice(i, i + NEGOTIATE_BATCH));
+            await uploadAll(neg.missing, files);
+            uploaded += neg.missing.length;
+            for (const m of neg.missing)
+                uploadedBytes += m.size;
+        }
+        const committed = await tapi.commit(capsuleId, { manifest: manifest, manifestSha256: manifestSha, committedBy: "cli" });
+        return {
+            generation: committed.generation?.generation ?? generation,
+            logicalBytes: archives.reduce((n, a) => n + a.bytes, 0),
+            storedBytes: manifest.totals.bytes,
+            uploadedBytes,
+            uploaded,
+            reused: wanted.length - uploaded,
+            archives: archives.map((a) => ({ name: a.name, entries: a.entries, bytes: a.bytes, chunks: a.chunks.length })),
+        };
+    }
+    finally {
+        await rm(tmp, { recursive: true, force: true });
+    }
+}
+/**
+ * Restores one archive of a generation into `dest` (which must not exist):
+ * downloads each chunk, checks its sha256, decompresses and untars.
+ */
+export async function restoreArchive(capsuleId, name, dest, generation) {
+    const res = await tapi.resolveGeneration(capsuleId, generation);
+    const manifest = res.manifest;
+    const archive = manifest.archives?.find((a) => a.name === name);
+    if (!archive)
+        throw new Error(`generation ${res.generation} has no archive named "${name}"`);
+    const urls = new Map(res.chunks.map((c) => [c.sha256, c.getUrl]));
+    // Claim the destination atomically: a non-recursive mkdir fails if it exists.
+    await mkdir(path.dirname(dest), { recursive: true });
+    try {
+        await mkdir(dest);
+    }
+    catch (e) {
+        if (e.code === "EEXIST")
+            throw new Error(`${dest} already exists; restore never overwrites`);
+        throw e;
+    }
+    const tmp = await mkdtemp(path.join(os.tmpdir(), "teleport-archive-restore-"));
+    try {
+        const tarFile = path.join(tmp, "archive.tar");
+        const out = createWriteStream(tarFile);
+        const finished = new Promise((resolve, reject) => {
+            out.once("error", reject);
+            out.once("finish", resolve);
+        });
+        finished.catch(() => undefined);
+        let bytes = 0;
+        for (const c of archive.chunks) {
+            const url = urls.get(c.sha256);
+            if (!url)
+                throw new Error(`no download URL for chunk ${c.sha256.slice(0, 12)}`);
+            const body = Buffer.from(await (await fetchOk(url)).arrayBuffer());
+            if (createHash("sha256").update(body).digest("hex") !== c.sha256)
+                throw new Error(`chunk ${c.sha256.slice(0, 12)} failed its checksum`);
+            const plain = zstdDecompressSync(body);
+            bytes += plain.length;
+            if (!out.write(plain))
+                await Promise.race([new Promise((r) => out.once("drain", r)), finished]);
+        }
+        out.end();
+        await finished;
+        const x = await run("tar", ["-x", "-k", "-f", tarFile, "-C", dest]);
+        if (x.code !== 0)
+            throw new Error(`tar extract failed: ${x.stderr.trim()}`);
+        return { entries: archive.entries, bytes };
+    }
+    finally {
+        await rm(tmp, { recursive: true, force: true });
+    }
+}
+async function uploadAll(missing, files) {
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(PUT_CONCURRENCY, missing.length) }, async () => {
+        for (;;) {
+            const i = cursor++;
+            if (i >= missing.length)
+                return;
+            const file = files.get(missing[i].sha256);
+            if (!file)
+                throw new Error(`server asked for an unknown chunk ${missing[i].sha256}`);
+            const body = await readFile(file);
+            let delay = 400;
+            for (let attempt = 1;; attempt++) {
+                const r = await fetch(missing[i].putUrl, { method: "PUT", body });
+                if (r.ok)
+                    break;
+                await r.body?.cancel().catch(() => undefined);
+                if (attempt >= 4 || (r.status < 500 && r.status !== 429))
+                    throw new Error(`chunk upload failed: HTTP ${r.status}`);
+                await new Promise((s) => setTimeout(s, delay));
+                delay *= 2;
+            }
+        }
+    });
+    await Promise.all(workers);
+}
+async function fetchOk(url) {
+    const r = await fetch(url);
+    if (!r.ok)
+        throw new Error(`chunk download failed: HTTP ${r.status}`);
+    return r;
+}
+function run(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const p = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        p.stdout.on("data", (d) => (stdout += d));
+        p.stderr.on("data", (d) => (stderr += d));
+        p.on("error", reject);
+        p.on("close", (code) => resolve({ code: code ?? 1, stdout, stderr }));
+    });
+}
+function safe(name) {
+    return name.replace(/[^A-Za-z0-9._-]/g, "_") || "archive";
+}
+/** Default sources: agent session history and infinite-disk's retained recovery data. */
+export function defaultArchiveSources(home = os.homedir()) {
+    return [
+        { name: "claude-code", dir: path.join(home, ".claude", "projects") },
+        { name: "codex", dir: path.join(home, ".codex", "sessions") },
+        { name: "infinite-disk-recovery", dir: path.join(home, ".local", "share", "infinite-disk", "recovery-consolidated") },
+        { name: "infinite-disk-sessions", dir: path.join(home, ".local", "share", "infinite-disk", "session-backups") },
+    ];
+}
+//# sourceMappingURL=archive.js.map

package/dist/teleport/archive.js.map

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

package/dist/teleport/commands.d.ts

@@ -75,6 +75,15 @@ export declare function cmdStorageList(options: OutputOptions): Promise<void>;
 export declare function cmdStorageTest(ref: string, options: OutputOptions): Promise<void>;
 export declare function cmdStorageRemove(ref: string): Promise<void>;
 export declare function cmdStorageMirror(ref: string, targetsArg: string): Promise<void>;
+interface ArchiveOptions extends OutputOptions {
+    name?: string;
+    source?: string[];
+}
+export declare function cmdTeleportArchive(options: ArchiveOptions): Promise<void>;
+export declare function cmdTeleportArchiveRestore(archiveName: string, dest: string, options: {
+    name?: string;
+    generation?: string;
+}): Promise<void>;
 export declare function registerTeleportCommands(program: Command, addExamples: (c: Command, ex: string) => Command): void;
 /**
  * Remote Control checkpoint: push the session's root as a new generation and

package/dist/teleport/commands.js

@@ -14,6 +14,8 @@ import { discoverRepos } from "../teleport/discover.js";
 import { offloadBlockers, planCapture } from "../teleport/workspace.js";
 import { formatCapturePlan } from "../dittoconfig/commands.js";
 import { formatBytes } from "../teleport/types.js";
+import { defaultArchiveSources, pushArchive, restoreArchive } from "../teleport/archive.js";
+import { stat } from "node:fs/promises";
 function out(line) {
     process.stdout.write(`${line}\n`);
 }
@@ -438,6 +440,63 @@ function jsonAlias() {
 function withOutput(c) {
     return c.addOption(outputOption()).addOption(jsonAlias());
 }
+/** Parses repeatable --source name=dir; defaults to agent history and infinite-disk recovery data. */
+async function archiveSources(options) {
+    const names = new Set();
+    const sources = options.source?.length
+        ? options.source.map((s) => {
+            const at = s.indexOf("=");
+            const dir = s.slice(at + 1);
+            if (at <= 0 || !dir)
+                throw new Error(`--source must be name=dir, got "${s}"`);
+            const name = s.slice(0, at);
+            if (names.has(name))
+                throw new Error(`duplicate --source name "${name}"`);
+            names.add(name);
+            return { name, dir: path.resolve(dir) };
+        })
+        : defaultArchiveSources();
+    const present = [];
+    for (const src of sources) {
+        const info = await stat(src.dir).catch(() => undefined);
+        if (info?.isDirectory())
+            present.push(src);
+        else if (options.source?.length)
+            throw new Error(`${src.dir} is not a directory`);
+    }
+    if (present.length === 0)
+        throw new Error("nothing to archive: no source directory exists");
+    return present;
+}
+export async function cmdTeleportArchive(options) {
+    const name = options.name ?? "agent-traces";
+    const sources = await archiveSources(options);
+    let capsule = (await tapi.listCapsules()).find((c) => c.name === name && c.status !== "deleted");
+    if (capsule && capsule.rootKind !== "archive") {
+        throw new Error(`capsule "${name}" is a ${capsule.rootKind} capsule; choose another --name for the archive`);
+    }
+    if (!capsule)
+        capsule = await tapi.createCapsule({ name, rootKind: "archive" });
+    if (!json(options)) {
+        err(`Archiving ${sources.map((s) => s.name).join(", ")} into "${name}" (generation ${capsule.headGeneration + 1})…`);
+    }
+    const res = await pushArchive(capsule.id, name, sources, capsule.headGeneration);
+    if (json(options)) {
+        out(JSON.stringify({ capsule: capsule.id, ...res }));
+        return;
+    }
+    for (const a of res.archives)
+        out(`  ${pad(a.name, 24)} ${pad(String(a.entries), 7)} files  ${formatBytes(a.bytes)}`);
+    out(`Generation ${res.generation}: ${formatBytes(res.logicalBytes)} archived, ${formatBytes(res.storedBytes)} stored compressed, ${formatBytes(res.uploadedBytes)} uploaded (${res.reused} chunks already stored).`);
+    out("Billed as storage on your plan; restore with `heyditto teleport archive-restore`.");
+}
+export async function cmdTeleportArchiveRestore(archiveName, dest, options) {
+    const generation = options.generation === undefined ? undefined : Number(options.generation);
+    if (generation !== undefined && (!Number.isInteger(generation) || generation < 1))
+        throw new Error("--generation must be a positive integer");
+    const res = await restoreArchive(options.name ?? "agent-traces", archiveName, path.resolve(dest), generation);
+    out(`Restored ${res.entries} files (${formatBytes(res.bytes)}) into ${path.resolve(dest)}.`);
+}
 export function registerTeleportCommands(program, addExamples) {
     const teleport = withOutput(program
         .command("teleport")
@@ -491,6 +550,18 @@ export function registerTeleportCommands(program, addExamples) {
         for (const line of formatCapturePlan(plan))
             out(line);
     }));
+    withOutput(teleport
+        .command("archive")
+        .description("back up agent session history and recovery data as storage (no capsule slot)")
+        .option("--name <capsule>", "archive capsule name", "agent-traces")
+        .option("--source <name=dir...>", "archive these directories instead of the defaults (~/.claude/projects, ~/.codex/sessions, infinite-disk recovery data)")
+        .action(cmdTeleportArchive));
+    teleport
+        .command("archive-restore <archive> <dest>")
+        .description("restore one archive (e.g. claude-code) into a new directory; never overwrites")
+        .option("--name <capsule>", "archive capsule name", "agent-traces")
+        .option("--generation <n>", "generation to restore (default: latest)")
+        .action(cmdTeleportArchiveRestore);
     withOutput(teleport.command("rm <capsule>").description("delete a capsule and its generations").option("--yes", "skip the confirmation").action(cmdTeleportRm));
     addExamples(teleport, `  heyditto teleport                       push the current directory
   heyditto teleport --cloud --endpoint work   push, then resume in Ditto Code