@heyditto/cli 2.10.0 → 2.12.0

package/dist/remote/controller.js

@@ -0,0 +1,352 @@
+import { randomUUID } from "node:crypto";
+import { buildPrompt, downloadAttachments } from "./attachments.js";
+import { commandInvocation, discoverCommands, watchCatalog } from "./catalog.js";
+import { HostClient } from "./host.js";
+export function harnessName(harness) {
+    return harness === "claude" ? "claude-code" : "codex";
+}
+const CLAUDE_PERMISSION_OPTIONS = [
+    { id: "1", label: "Yes" },
+    { id: "2", label: "Yes, and don't ask again this session" },
+    { id: "3", label: "No, and tell Claude what to do differently" },
+];
+export class RemoteSession {
+    host;
+    ctx;
+    hooks;
+    pty;
+    runHeadless;
+    queue = [];
+    current;
+    draining = false;
+    stopped = false;
+    catalog = [];
+    stopWatching;
+    pending;
+    constructor(ctx, hooks) {
+        this.ctx = ctx;
+        this.hooks = hooks;
+        this.host = new HostClient({
+            baseUrl: ctx.baseUrl,
+            apiKey: ctx.apiKey,
+            capabilities: {
+                harnesses: ["claude-code", "codex"],
+                attachments: true,
+                headless: true,
+                teleport: Boolean(ctx.checkpoint),
+            },
+            log: ctx.log,
+            handlers: {
+                onTurn: (frame) => this.onTurn(frame),
+                onInterrupt: (turnId) => this.onInterrupt(turnId),
+                onCheckpoint: (request) => void this.onCheckpoint(request),
+                onPromptAnswer: (answer) => this.answerPrompt(answer),
+            },
+            ...ctx.hostOptions,
+        });
+        hooks?.events.on("hook", (event) => this.onHook(event));
+    }
+    attachTui(pty) {
+        this.pty = pty;
+    }
+    attachHeadless(run) {
+        this.runHeadless = run;
+    }
+    /** The catalog last announced (tests and diagnostics). */
+    get commands() {
+        return this.catalog;
+    }
+    /** Connects (best effort), announces the session and its command catalog. Returns whether the backend answered in time. */
+    async start() {
+        const ok = await this.host.start();
+        this.host.announce({
+            sessionId: this.ctx.sessionId,
+            harness: harnessName(this.ctx.harness),
+            cwd: this.ctx.cwd,
+            mode: this.ctx.mode,
+            status: "idle",
+        });
+        await this.refreshCatalog();
+        this.stopWatching = watchCatalog(this.ctx.harness, this.ctx.cwd, () => void this.refreshCatalog());
+        return ok;
+    }
+    stop() {
+        this.stopped = true;
+        this.stopWatching?.();
+        this.host.close();
+    }
+    async refreshCatalog() {
+        try {
+            this.catalog = await discoverCommands(this.ctx.harness, this.ctx.cwd);
+        }
+        catch (err) {
+            this.ctx.log(`remote control: could not read the command catalog (${err instanceof Error ? err.message : String(err)})`);
+            return;
+        }
+        this.host.commands({
+            sessionId: this.ctx.sessionId,
+            harness: harnessName(this.ctx.harness),
+            commands: this.catalog,
+        });
+    }
+    finish(turnId, fields = {}) {
+        this.host.send({ type: "turn.finished", turnId, ...fields });
+    }
+    onTurn(frame) {
+        this.host.send({ type: "turn.ack", turnId: frame.turnId });
+        if (frame.sessionId !== this.ctx.sessionId) {
+            this.finish(frame.turnId, { error: "unknown session on this host" });
+            return;
+        }
+        if ((frame.kind ?? "prompt") === "answer") {
+            // Not a turn of its own: the running turn is waiting on this.
+            this.deliverAnswer(frame);
+            return;
+        }
+        this.queue.push(frame);
+        void this.drain();
+    }
+    onInterrupt(turnId) {
+        const current = this.current;
+        if (!current || current.turnId !== turnId)
+            return;
+        current.interrupted = true;
+        if (current.headless)
+            current.headless.interrupt();
+        else
+            this.pty?.interrupt(this.ctx.harness);
+    }
+    async onCheckpoint(request) {
+        if (!this.ctx.checkpoint) {
+            this.host.send({ type: "checkpoint.failed", sessionId: request.sessionId, error: "teleport is not available on this host" });
+            return;
+        }
+        try {
+            const generation = await this.ctx.checkpoint(this.ctx.cwd);
+            this.host.send({ type: "checkpoint.done", sessionId: request.sessionId, generation });
+        }
+        catch (err) {
+            this.host.send({ type: "checkpoint.failed", sessionId: request.sessionId, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    // ---------------------------------------------------------------------
+    // Harness prompts (permission dialogs, questions)
+    // ---------------------------------------------------------------------
+    onHook(event) {
+        const payload = event.payload ?? {};
+        if (event.source === "claude") {
+            switch (event.event) {
+                case "UserPromptSubmit":
+                    // Local typing also moves the session between running and idle, so
+                    // the app sees the same state whether the prompt came from the
+                    // phone or the keyboard.
+                    this.clearPending();
+                    this.host.status(this.ctx.sessionId, "running");
+                    return;
+                case "Notification":
+                    if (payload.notification_type === "permission_prompt") {
+                        this.requestPrompt({
+                            kind: "permission",
+                            text: String(payload.message ?? payload.title ?? "Claude Code is asking for permission"),
+                            options: CLAUDE_PERMISSION_OPTIONS,
+                            default: "1",
+                        });
+                    }
+                    return;
+                case "PreToolUse":
+                    if (payload.tool_name === "AskUserQuestion")
+                        this.requestQuestion(payload.tool_input);
+                    return;
+                case "Stop":
+                    this.turnEnded();
+                    return;
+                default:
+                    return;
+            }
+        }
+        if (/turn-complete|turn-ended|agent-turn/.test(event.event))
+            this.turnEnded();
+    }
+    turnEnded() {
+        this.clearPending();
+        if (!this.current)
+            this.host.status(this.ctx.sessionId, "idle");
+        this.current?.done();
+    }
+    requestQuestion(toolInput) {
+        const input = (toolInput ?? {});
+        const q = input.questions?.[0];
+        if (!q)
+            return;
+        const options = (q.options ?? []).map((o, i) => ({ id: String(i + 1), label: o.label ?? `option ${i + 1}` }));
+        this.requestPrompt({
+            kind: options.length > 0 ? "choice" : "question",
+            text: [q.header, q.question].filter(Boolean).join(": "),
+            ...(options.length > 0 ? { options } : {}),
+        });
+    }
+    requestPrompt(prompt) {
+        const pending = { promptId: randomUUID(), sessionId: this.ctx.sessionId, ...prompt };
+        this.pending = pending;
+        const { keys: _keys, ...frame } = pending;
+        this.host.send({ type: "prompt.request", ...frame });
+    }
+    clearPending() {
+        this.pending = undefined;
+    }
+    /** `prompt.answer` frame: inject the keystrokes for the pending prompt. */
+    answerPrompt(answer) {
+        const pending = this.pending;
+        if (!pending || pending.promptId !== answer.promptId)
+            return false;
+        if (!this.pty)
+            return false;
+        const option = pending.options?.find((o) => o.id === answer.value || o.label.toLowerCase() === answer.value.trim().toLowerCase());
+        const keys = option ? (pending.keys?.[option.id] ?? option.id) : answer.value;
+        this.pty.write(keys);
+        // A digit hotkey confirms on its own in Claude Code; the extra Enter is a
+        // no-op there and submits typed text everywhere else.
+        setTimeout(() => this.pty?.write("\r"), 150).unref?.();
+        this.pending = undefined;
+        return true;
+    }
+    /** `turn.deliver {kind: "answer"}`: same as a `prompt.answer`, reported as an instant turn. */
+    deliverAnswer(frame) {
+        if (!frame.answer)
+            return this.finish(frame.turnId, { error: "answer turn without an answer" });
+        if (!this.pty)
+            return this.finish(frame.turnId, { exitCode: 0, unsupported: "headless sessions cannot answer harness prompts" });
+        if (!this.pending)
+            return this.finish(frame.turnId, { error: "no prompt is pending" });
+        if (!this.answerPrompt({ type: "prompt.answer", ...frame.answer }))
+            return this.finish(frame.turnId, { error: `prompt ${frame.answer.promptId} is not pending` });
+        this.finish(frame.turnId, { exitCode: 0 });
+    }
+    // ---------------------------------------------------------------------
+    // Turns
+    // ---------------------------------------------------------------------
+    async drain() {
+        if (this.draining)
+            return;
+        this.draining = true;
+        try {
+            while (this.queue.length > 0 && !this.stopped) {
+                const frame = this.queue.shift();
+                await this.runTurn(frame);
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    lookupCommand(name) {
+        const bare = name.replace(/^[/$]/, "");
+        return this.catalog.find((c) => c.name === name || c.name === bare || c.name === `$${bare}` || c.name === `/${bare}`);
+    }
+    /** The text that goes into the harness for a turn, or a reason it cannot run here. */
+    async resolveText(frame) {
+        const attachments = await downloadAttachments(this.ctx.cwd, frame.turnId, frame.attachments);
+        if (attachments.length > 0) {
+            this.ctx.log(`remote control: ${attachments.length} attachment(s) saved under .tmp/ditto/attachments/${frame.turnId}`);
+        }
+        if ((frame.kind ?? "prompt") !== "command")
+            return { text: buildPrompt(frame.text, attachments) };
+        const name = frame.command?.name?.trim() || frame.text.trim().replace(/^[/$]/, "").split(/\s+/)[0];
+        if (!name)
+            return { unsupported: "command turn without a command name" };
+        const entry = this.lookupCommand(name);
+        const args = frame.command?.args ?? (frame.command ? undefined : frame.text.trim().split(/\s+/).slice(1).join(" "));
+        const invocation = commandInvocation(this.ctx.harness, entry, entry?.name ?? name, args);
+        if (this.ctx.mode === "headless") {
+            const headlessOk = entry ? entry.headless : false;
+            if (!headlessOk) {
+                return { unsupported: `${invocation.split(" ")[0]} only works in a terminal session (${entry ? "TUI-only builtin" : "not in this session's catalog"})` };
+            }
+        }
+        return { text: buildPrompt(invocation, attachments), entry };
+    }
+    async runTurn(frame) {
+        const { turnId } = frame;
+        this.host.status(this.ctx.sessionId, "running");
+        let resolved;
+        try {
+            resolved = await this.resolveText(frame);
+        }
+        catch (err) {
+            this.finish(turnId, { error: err instanceof Error ? err.message : String(err) });
+            this.host.status(this.ctx.sessionId, "idle");
+            return;
+        }
+        if ("unsupported" in resolved) {
+            this.finish(turnId, { exitCode: 0, unsupported: resolved.unsupported });
+            this.host.status(this.ctx.sessionId, "idle");
+            return;
+        }
+        const { text, entry } = resolved;
+        let finish = () => undefined;
+        const finished = new Promise((resolve) => {
+            finish = resolve;
+        });
+        this.current = { turnId, interrupted: false, done: finish };
+        try {
+            if (this.pty) {
+                this.ctx.log(`remote control: ${entry ? `command ${text.split("\n")[0]}` : "prompt"} received from the app (turn ${turnId.slice(0, 8)})`);
+                await this.pty.inject(text);
+                this.host.send({ type: "turn.started", turnId });
+                // Builtins (/model, /clear …) run no model turn, so no Stop hook
+                // fires; a short quiet period ends them.
+                const quiet = entry?.source === "builtin" ? Math.min(this.ctx.quietFallbackMs ?? 8000, 1500) : undefined;
+                await Promise.race([finished, this.pty.exit, this.quietFallback(finished, quiet)]);
+                this.finish(turnId, { exitCode: 0, ...(this.current.interrupted ? { interrupted: true } : {}) });
+            }
+            else if (this.runHeadless) {
+                const turn = this.runHeadless(text);
+                this.current.headless = turn;
+                this.host.send({ type: "turn.started", turnId });
+                const exitCode = await turn.exit;
+                this.finish(turnId, { exitCode, ...(this.current.interrupted ? { interrupted: true } : {}) });
+            }
+            else {
+                this.finish(turnId, { error: "no harness attached" });
+            }
+        }
+        catch (err) {
+            this.finish(turnId, { error: err instanceof Error ? err.message : String(err) });
+        }
+        finally {
+            this.current = undefined;
+            this.clearPending();
+            this.host.status(this.ctx.sessionId, "idle");
+        }
+    }
+    /**
+     * Safety net when a harness never reports its turn end (older builds, hooks
+     * disabled, builtin commands): once the screen has been quiet for the limit
+     * after the prompt went in, the turn counts as finished. Hooks are the
+     * primary signal; a pending prompt never times out this way.
+     */
+    quietFallback(finished, limitMs) {
+        const limit = limitMs ?? this.ctx.quietFallbackMs ?? 8000;
+        return new Promise((resolve) => {
+            let settled = false;
+            void finished.then(() => {
+                settled = true;
+                resolve();
+            });
+            const started = Date.now();
+            const timer = setInterval(() => {
+                if (settled)
+                    return clearInterval(timer);
+                const pty = this.pty;
+                if (!pty || this.pending)
+                    return;
+                if (Date.now() - started > Math.min(2000, limit) && pty.quietFor() >= limit) {
+                    clearInterval(timer);
+                    resolve();
+                }
+            }, 250);
+            timer.unref?.();
+        });
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/remote/controller.js.map

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

package/dist/remote/fork-command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+import { type ForkOptions } from "./fork.js";
+/**
+ * `heyditto fork <session>`: copy a coding session's conversation into a new
+ * session (optionally in a new worktree), locally or straight into Ditto Cloud.
+ */
+export declare function cmdFork(ref: string, options: ForkOptions): Promise<void>;
+export declare function registerForkCommand(program: Command, addExamples: (c: Command, ex: string) => Command): void;

package/dist/remote/fork-command.js

@@ -0,0 +1,50 @@
+import { cmdTeleport } from "../teleport/commands.js";
+import { forkSession } from "./fork.js";
+/**
+ * `heyditto fork <session>`: copy a coding session's conversation into a new
+ * session (optionally in a new worktree), locally or straight into Ditto Cloud.
+ */
+export async function cmdFork(ref, options) {
+    const result = await forkSession(ref, options);
+    const { session } = result;
+    const asJson = options.output === "json";
+    if (options.cloud) {
+        const root = session.worktree ?? session.cwd;
+        process.stderr.write(`Forked ${result.from} → ${session.id}; teleporting ${root} to Ditto Cloud…\n`);
+        await cmdTeleport(root, {
+            cloud: true,
+            endpoint: options.endpoint,
+            prompt: options.prompt,
+            session: session.harnessSessionId,
+            harness: session.harness,
+            output: options.output,
+        });
+        return;
+    }
+    if (asJson) {
+        process.stdout.write(`${JSON.stringify({ from: result.from, session, transcript: result.transcript }, null, 2)}\n`);
+        return;
+    }
+    process.stdout.write(`Forked ${result.from} → ${session.id} (${session.harness}${session.worktree ? `, worktree ${session.worktree}` : ""}).\n`);
+    process.stdout.write(`Open it with: heyditto ${session.harness} --resume ${session.id}\n`);
+}
+export function registerForkCommand(program, addExamples) {
+    const fork = program
+        .command("fork <session>")
+        .description("start a new session from a copy of an existing conversation, locally or in Ditto Cloud")
+        .summary("fork a coding session")
+        .option("-w, --worktree [name]", "put the fork in <repo>/.worktrees/<name> (a fresh branch of the same name)")
+        .option("--cloud", "teleport the fork and resume it in a Ditto Code cloud job")
+        .option("-e, --endpoint <slug>", "inference endpoint for the cloud session (with --cloud)")
+        .option("--prompt <text>", "first instruction for the cloud session (with --cloud)")
+        .option("-o, --output <format>", "text (default) or json")
+        .option("--json", "print machine-readable output")
+        .action(async (ref, options) => {
+        await cmdFork(ref, { ...options, output: options.json ? "json" : options.output });
+    });
+    addExamples(fork, `  heyditto fork 3f1c…                    copy the conversation into a new local session
+  heyditto fork 3f1c… --worktree try-b   same, on a fresh branch in .worktrees/try-b
+  heyditto fork 3f1c… --cloud            continue the copy in Ditto Cloud
+  heyditto sessions                       find session ids`);
+}
+//# sourceMappingURL=fork-command.js.map

package/dist/remote/fork-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-command.js","sourceRoot":"","sources":["../../src/remote/fork-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAoB,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,OAAoB;IAC7D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC;IACzC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,MAAM,OAAO,CAAC,EAAE,iBAAiB,IAAI,oBAAoB,CAAC,CAAC;QACrG,MAAM,WAAW,CAAC,IAAI,EAAE;YACtB,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,gBAAgB;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpH,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,MAAM,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACjJ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,CAAC,OAAO,aAAa,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,WAAgD;IACpG,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,wFAAwF,CAAC;SACrG,OAAO,CAAC,uBAAuB,CAAC;SAChC,MAAM,CAAC,uBAAuB,EAAE,4EAA4E,CAAC;SAC7G,MAAM,CAAC,SAAS,EAAE,2DAA2D,CAAC;SAC9E,MAAM,CAAC,uBAAuB,EAAE,yDAAyD,CAAC;SAC1F,MAAM,CAAC,iBAAiB,EAAE,wDAAwD,CAAC;SACnF,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAyC,EAAE,EAAE;QACvE,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IACL,WAAW,CACT,IAAI,EACJ;;;2DAGuD,CACxD,CAAC;AACJ,CAAC"}

package/dist/remote/fork.d.ts

@@ -0,0 +1,22 @@
+import { type SessionRecord } from "../agents/sessions.js";
+/**
+ * `heyditto fork <session>`: a new session that starts from a copy of an
+ * existing conversation. Locally that is a copy of the harness transcript
+ * under a fresh id (optionally in a new git worktree); `--cloud` then
+ * teleports the fork and resumes it in Ditto Code.
+ */
+export interface ForkOptions {
+    worktree?: string | boolean;
+    cloud?: boolean;
+    endpoint?: string;
+    prompt?: string;
+    output?: string;
+}
+export interface ForkResult {
+    from: string;
+    session: SessionRecord;
+    transcript?: string;
+}
+export declare function forkSession(ref: string, options: ForkOptions): Promise<ForkResult>;
+/** Lists transcripts present for a project dir; used by tests and diagnostics. */
+export declare function listClaudeTranscripts(cwd: string): Promise<string[]>;

package/dist/remote/fork.js

@@ -0,0 +1,113 @@
+import { randomUUID } from "node:crypto";
+import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { readSession, writeSession } from "../agents/sessions.js";
+import { defaultWorktreeName, ensureWorktree, repoRoot, validWorktreeName } from "../agents/worktree.js";
+import { canonicalCwd, locateClaude, locateCodex } from "../teleport/harness.js";
+import { cwdSlug } from "../teleport/types.js";
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function claudeProjectsDir() {
+    const home = process.env.CLAUDE_CONFIG_DIR?.trim() || path.join(os.homedir(), ".claude");
+    return path.join(home, "projects");
+}
+/** Copies a Claude transcript to a new session id (and, when the cwd moved, the new project slug). */
+async function forkClaudeTranscript(oldId, newId, fromCwd, toCwd) {
+    const loc = await locateClaude(oldId, fromCwd);
+    if (!loc)
+        throw new Error(`no local Claude Code transcript for session ${oldId} under ${fromCwd}`);
+    const fromCanon = canonicalCwd(fromCwd);
+    const toCanon = canonicalCwd(toCwd);
+    const toDir = path.join(claudeProjectsDir(), cwdSlug(toCanon));
+    await mkdir(toDir, { recursive: true });
+    const jsonl = loc.files.find((f) => f.endsWith(`${oldId}.jsonl`));
+    if (!jsonl)
+        throw new Error(`transcript ${oldId}.jsonl not found`);
+    let text = await readFile(jsonl, "utf8");
+    text = text.split(oldId).join(newId);
+    if (fromCanon !== toCanon)
+        text = text.split(fromCanon).join(toCanon).split(fromCwd).join(toCwd);
+    const target = path.join(toDir, `${newId}.jsonl`);
+    await writeFile(target, text);
+    const subdir = path.join(path.dirname(jsonl), oldId);
+    if (await exists(subdir)) {
+        for (const f of loc.files.filter((x) => x.startsWith(`${subdir}${path.sep}`))) {
+            const dest = path.join(toDir, newId, path.relative(subdir, f));
+            await mkdir(path.dirname(dest), { recursive: true });
+            await writeFile(dest, (await readFile(f, "utf8")).split(oldId).join(newId));
+        }
+    }
+    return target;
+}
+/** Copies a Codex rollout to a new thread id: same directory, id rewritten in the file name and body. */
+async function forkCodexTranscript(oldId, newId) {
+    const loc = await locateCodex(oldId);
+    if (!loc)
+        throw new Error(`no local Codex transcript for thread ${oldId}`);
+    let target = "";
+    for (const f of loc.files) {
+        const dest = path.join(path.dirname(f), path.basename(f).split(oldId).join(newId));
+        await writeFile(dest, (await readFile(f, "utf8")).split(oldId).join(newId));
+        target = target || dest;
+    }
+    return target;
+}
+export async function forkSession(ref, options) {
+    const record = await readSession(ref);
+    if (!record)
+        throw new Error(`no local session "${ref}"; see \`heyditto sessions\``);
+    const oldHarnessId = record.harnessSessionId ?? record.id;
+    const newId = randomUUID();
+    const sourceCwd = record.worktree ?? record.cwd;
+    let cwd = sourceCwd;
+    let worktree;
+    if (options.worktree !== undefined && options.worktree !== false) {
+        const name = typeof options.worktree === "string" ? options.worktree : defaultWorktreeName(record.harness);
+        if (!validWorktreeName(name))
+            throw new Error(`invalid worktree name "${name}"`);
+        const root = repoRoot(record.cwd);
+        if (!root)
+            throw new Error(`${record.cwd} is not inside a git repository; forks into a worktree need one`);
+        const wt = await ensureWorktree(root, name);
+        cwd = wt.path;
+        worktree = wt.path;
+    }
+    const transcript = record.harness === "claude"
+        ? await forkClaudeTranscript(oldHarnessId, newId, sourceCwd, cwd)
+        : await forkCodexTranscript(oldHarnessId, newId);
+    const now = new Date().toISOString();
+    const session = {
+        id: newId,
+        harness: record.harness,
+        endpointId: record.endpointId,
+        endpointSlug: record.endpointSlug,
+        harnessSessionId: newId,
+        cwd: worktree ? record.cwd : cwd,
+        worktree,
+        model: record.model,
+        createdAt: now,
+        lastLaunchedAt: now,
+        launches: 1,
+    };
+    await writeSession(session);
+    return { from: record.id, session, transcript };
+}
+/** Lists transcripts present for a project dir; used by tests and diagnostics. */
+export async function listClaudeTranscripts(cwd) {
+    const dir = path.join(claudeProjectsDir(), cwdSlug(canonicalCwd(cwd)));
+    try {
+        return (await readdir(dir)).filter((f) => f.endsWith(".jsonl")).sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=fork.js.map

package/dist/remote/fork.js.map

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

package/dist/remote/headless.d.ts

@@ -0,0 +1,30 @@
+import { type ChildProcess } from "node:child_process";
+import { type Harness, type PlanInput } from "../agents/types.js";
+/**
+ * Headless Remote Control: no terminal UI. Each delivered turn runs one
+ * harness invocation (`claude -p --resume …` / `codex exec resume --last …`)
+ * with the same endpoint, key and session id as an interactive launch, so the
+ * conversation lands in the same Ditto thread and can be picked up again from
+ * a TUI later.
+ */
+export interface HeadlessTurnInput {
+    harness: Harness;
+    /** Everything but prompt/resume, which this module fills in per turn. */
+    base: Omit<PlanInput, "prompt" | "resumeId" | "resumeLast" | "passthrough">;
+    prompt: string;
+    /** Claude: the session id to resume (after the first turn). Codex: resume the last thread. */
+    resumeId?: string;
+    resumeLast?: boolean;
+    cwd: string;
+    /** Extra args (e.g. Codex `-c notify=…`, Claude `--settings …`). */
+    extraArgs?: string[];
+    onProgress?: (line: string) => void;
+}
+export interface HeadlessTurn {
+    child: ChildProcess;
+    exit: Promise<number | null>;
+    interrupt(): void;
+}
+/** One line of progress from Claude's stream-json output, or undefined when the event is not worth showing. */
+export declare function summarizeClaudeEvent(line: string): string | undefined;
+export declare function startHeadlessTurn(input: HeadlessTurnInput): HeadlessTurn;