@heyditto/cli 2.11.0 → 2.12.0

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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAsB,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAuB/C,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACzF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,sGAAsG;AACtG,KAAK,UAAU,oBAAoB,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe,EAAE,KAAa;IAC9F,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,UAAU,OAAO,EAAE,CAAC,CAAC;IACnG,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,kBAAkB,CAAC,CAAC;IACnE,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,SAAS,KAAK,OAAO;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC;IAClD,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACrD,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yGAAyG;AACzG,KAAK,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC7D,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;IAC3E,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACnF,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,OAAoB;IACjE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,8BAA8B,CAAC,CAAC;IACrF,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC;IAEhD,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,IAAI,QAA4B,CAAC;IACjC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3G,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,iEAAiE,CAAC,CAAC;QAC3G,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;QACd,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GACd,MAAM,CAAC,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,MAAM,oBAAoB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC;QACjE,CAAC,CAAC,MAAM,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAErD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAkB;QAC7B,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,gBAAgB,EAAE,KAAK;QACvB,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAChC,QAAQ;QACR,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,GAAG;QACd,cAAc,EAAE,GAAG;QACnB,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAClD,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

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;

package/dist/remote/headless.js

@@ -0,0 +1,75 @@
+import { spawn } from "node:child_process";
+import { planClaude } from "../agents/claude.js";
+import { planCodex } from "../agents/codex.js";
+import { childEnv } from "../agents/types.js";
+import { withHookArgs } from "./hooks.js";
+/** One line of progress from Claude's stream-json output, or undefined when the event is not worth showing. */
+export function summarizeClaudeEvent(line) {
+    let ev;
+    try {
+        ev = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    const type = ev.type;
+    if (type === "assistant") {
+        const message = ev.message;
+        for (const part of message?.content ?? []) {
+            if (part.type === "tool_use")
+                return `tool ${part.name ?? "?"}`;
+            if (part.type === "text" && part.text)
+                return part.text.replace(/\s+/g, " ").slice(0, 100);
+        }
+        return undefined;
+    }
+    if (type === "result") {
+        const result = typeof ev.result === "string" ? ev.result : "";
+        return `done${ev.is_error ? " (error)" : ""}${result ? `: ${result.replace(/\s+/g, " ").slice(0, 100)}` : ""}`;
+    }
+    return undefined;
+}
+export function startHeadlessTurn(input) {
+    const planInput = {
+        ...input.base,
+        prompt: input.prompt,
+        resumeId: input.resumeId,
+        resumeLast: input.resumeLast,
+        passthrough: input.harness === "claude" ? ["--output-format", "stream-json", "--verbose"] : [],
+    };
+    const plan = input.harness === "claude" ? planClaude(planInput) : planCodex(planInput);
+    const args = withHookArgs(input.harness, plan.args, input.extraArgs ?? []);
+    const child = spawn(plan.command, args, {
+        cwd: input.cwd,
+        env: childEnv(plan, input.base.env),
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    let stdoutBuf = "";
+    child.stdout?.setEncoding("utf8");
+    child.stdout?.on("data", (chunk) => {
+        stdoutBuf += chunk;
+        let nl = stdoutBuf.indexOf("\n");
+        while (nl !== -1) {
+            const line = stdoutBuf.slice(0, nl).trim();
+            stdoutBuf = stdoutBuf.slice(nl + 1);
+            if (line) {
+                const summary = input.harness === "claude" ? summarizeClaudeEvent(line) : line.slice(0, 120);
+                if (summary)
+                    input.onProgress?.(summary);
+            }
+            nl = stdoutBuf.indexOf("\n");
+        }
+    });
+    child.stderr?.setEncoding("utf8");
+    child.stderr?.on("data", (chunk) => {
+        const line = chunk.trim().split("\n").pop();
+        if (line)
+            input.onProgress?.(line.slice(0, 160));
+    });
+    const exit = new Promise((resolve) => {
+        child.on("error", () => resolve(null));
+        child.on("exit", (code, signal) => resolve(code ?? (signal ? 130 : null)));
+    });
+    return { child, exit, interrupt: () => child.kill("SIGINT") };
+}
+//# sourceMappingURL=headless.js.map

package/dist/remote/headless.js.map

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

package/dist/remote/hook.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/remote/hook.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Hook relay run by the coding harness: `hook.js <socket> <source> [event] [json]`.
+ *
+ * Claude Code hooks pass their payload on stdin (with `hook_event_name`);
+ * Codex's `notify` passes a JSON payload as the last argument. Either way one
+ * JSON line goes to the Unix socket the CLI host opened, and the process exits
+ * 0 no matter what, so a missing socket can never block the harness.
+ */
+import net from "node:net";
+function readStdin(timeoutMs) {
+    return new Promise((resolve) => {
+        if (process.stdin.isTTY)
+            return resolve("");
+        let data = "";
+        const timer = setTimeout(() => resolve(data), timeoutMs);
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (c) => (data += c));
+        process.stdin.on("end", () => {
+            clearTimeout(timer);
+            resolve(data);
+        });
+        process.stdin.on("error", () => {
+            clearTimeout(timer);
+            resolve(data);
+        });
+    });
+}
+function parse(json) {
+    try {
+        const v = JSON.parse(json);
+        return typeof v === "object" && v !== null ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function main() {
+    const [socketPath, source, ...rest] = process.argv.slice(2);
+    if (!socketPath || !source)
+        return;
+    let event = rest[0] ?? "";
+    let payload;
+    if (source === "codex") {
+        // codex appends its JSON payload after our fixed arguments.
+        payload = parse(rest[rest.length - 1] ?? "");
+        event = typeof payload?.type === "string" ? payload.type : "agent-turn-complete";
+    }
+    else {
+        payload = parse(await readStdin(1500));
+        if (!event && typeof payload?.hook_event_name === "string")
+            event = payload.hook_event_name;
+    }
+    await new Promise((resolve) => {
+        const timer = setTimeout(resolve, 1500);
+        const conn = net.createConnection(socketPath, () => {
+            conn.end(`${JSON.stringify({ source, event, payload })}\n`, () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+        conn.on("error", () => {
+            clearTimeout(timer);
+            resolve();
+        });
+    });
+}
+main().finally(() => process.exit(0));
+//# sourceMappingURL=hook.js.map

package/dist/remote/hook.js.map

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

package/dist/remote/hooks.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from "node:events";
+import type { Harness } from "../agents/types.js";
+/**
+ * Turn boundaries come from the harnesses themselves, not from parsing their
+ * screens: Claude Code runs its `UserPromptSubmit` and `Stop` hooks, Codex runs
+ * its `notify` command when a turn ends. Both are pointed at a tiny script
+ * (dist/remote/hook.js) that writes one JSON line to a Unix socket this
+ * process listens on. Nothing in the hook can stall the harness: the script
+ * exits 0 whatever happens.
+ */
+export interface HookEvent {
+    source: Harness;
+    /** Claude: UserPromptSubmit | Stop. Codex: agent-turn-complete (as notify reports it). */
+    event: string;
+    payload?: Record<string, unknown>;
+}
+export interface HookServer {
+    socketPath: string;
+    events: EventEmitter;
+    close(): Promise<void>;
+}
+/** Absolute path of the compiled hook script next to this module. */
+export declare function hookScriptPath(): string;
+export declare function startHookServer(): Promise<HookServer>;
+/** The `--settings <json>` value that makes Claude Code report turn boundaries to `socketPath`. */
+export declare function claudeHookSettings(socketPath: string, script?: string, node?: string): string;
+/** The `-c notify=[...]` override that makes Codex report `agent-turn-complete` to `socketPath`. */
+export declare function codexNotifyOverride(socketPath: string, script?: string, node?: string): string;
+/** Inserts flags where each harness accepts them: after Codex's leading subcommand words (before its positional prompt), anywhere for Claude. */
+export declare function withHookArgs(harness: Harness, args: string[], extra: string[]): string[];

package/dist/remote/hooks.js

@@ -0,0 +1,95 @@
+import { randomBytes } from "node:crypto";
+import { EventEmitter } from "node:events";
+import { rm } from "node:fs/promises";
+import net from "node:net";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/** Absolute path of the compiled hook script next to this module. */
+export function hookScriptPath() {
+    return fileURLToPath(new URL("./hook.js", import.meta.url));
+}
+export async function startHookServer() {
+    const socketPath = path.join(os.tmpdir(), `heyditto-hook-${process.pid}-${randomBytes(4).toString("hex")}.sock`);
+    const events = new EventEmitter();
+    const server = net.createServer((conn) => {
+        let buf = "";
+        conn.setEncoding("utf8");
+        conn.on("data", (chunk) => {
+            buf += chunk;
+            let nl = buf.indexOf("\n");
+            while (nl !== -1) {
+                const line = buf.slice(0, nl).trim();
+                buf = buf.slice(nl + 1);
+                if (line)
+                    emitLine(events, line);
+                nl = buf.indexOf("\n");
+            }
+        });
+        conn.on("end", () => {
+            const line = buf.trim();
+            buf = "";
+            if (line)
+                emitLine(events, line);
+        });
+        conn.on("error", () => undefined);
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(socketPath, () => resolve());
+    });
+    server.unref();
+    return {
+        socketPath,
+        events,
+        close: async () => {
+            await new Promise((resolve) => server.close(() => resolve()));
+            await rm(socketPath, { force: true }).catch(() => undefined);
+        },
+    };
+}
+function emitLine(events, line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (parsed && typeof parsed.event === "string")
+            events.emit("hook", parsed);
+    }
+    catch {
+        /* ignore malformed hook lines */
+    }
+}
+function shellQuote(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+/** The `--settings <json>` value that makes Claude Code report turn boundaries to `socketPath`. */
+export function claudeHookSettings(socketPath, script = hookScriptPath(), node = process.execPath) {
+    const command = (event) => `${shellQuote(node)} ${shellQuote(script)} ${shellQuote(socketPath)} claude ${event}`;
+    const settings = {
+        hooks: {
+            UserPromptSubmit: [{ hooks: [{ type: "command", command: command("UserPromptSubmit"), timeout: 5 }] }],
+            Stop: [{ hooks: [{ type: "command", command: command("Stop"), timeout: 5 }] }],
+            // Permission dialogs arrive as notification_type "permission_prompt".
+            Notification: [{ hooks: [{ type: "command", command: command("Notification"), timeout: 5 }] }],
+            // AskUserQuestion carries its question and options in tool_input.
+            PreToolUse: [{ matcher: "AskUserQuestion", hooks: [{ type: "command", command: command("PreToolUse"), timeout: 5 }] }],
+        },
+    };
+    return JSON.stringify(settings);
+}
+/** The `-c notify=[...]` override that makes Codex report `agent-turn-complete` to `socketPath`. */
+export function codexNotifyOverride(socketPath, script = hookScriptPath(), node = process.execPath) {
+    const toml = (s) => JSON.stringify(s);
+    return `notify=[${[node, script, socketPath, "codex"].map(toml).join(",")}]`;
+}
+/** Inserts flags where each harness accepts them: after Codex's leading subcommand words (before its positional prompt), anywhere for Claude. */
+export function withHookArgs(harness, args, extra) {
+    if (extra.length === 0)
+        return args;
+    if (harness === "claude")
+        return [...args, ...extra];
+    let i = 0;
+    while (i < args.length && (args[i] === "exec" || args[i] === "resume"))
+        i += 1;
+    return [...args.slice(0, i), ...extra, ...args.slice(i)];
+}
+//# sourceMappingURL=hooks.js.map

package/dist/remote/hooks.js.map

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

package/dist/remote/host.d.ts

@@ -0,0 +1,63 @@
+import { type CheckpointRequestFrame, type HostCapabilities, type HostFrame, type PromptAnswerFrame, type SessionAnnounceFrame, type SessionCommandsFrame, type SessionStatus, type TurnDeliverFrame } from "./protocol.js";
+/**
+ * The host side of the bridge: one WebSocket to the backend that announces
+ * the coding sessions this machine runs and receives turns for them.
+ *
+ * The connection is best effort. A backend without the hosts endpoint, or a
+ * flaky network, never blocks the harness: the client keeps retrying in the
+ * background with backoff and re-announces every known session when it gets
+ * back in, and the harness keeps running locally the whole time.
+ */
+export interface HostHandlers {
+    onTurn: (turn: TurnDeliverFrame) => void;
+    onInterrupt: (turnId: string) => void;
+    onCheckpoint: (request: CheckpointRequestFrame) => void;
+    onPromptAnswer?: (answer: PromptAnswerFrame) => void;
+}
+export interface HostClientOptions {
+    baseUrl: string;
+    apiKey: string;
+    capabilities: HostCapabilities;
+    handlers: HostHandlers;
+    name?: string;
+    /** Called for status lines; defaults to silence. */
+    log?: (line: string) => void;
+    /** Overrides for tests. */
+    heartbeatSeconds?: number;
+    reconnectBaseMs?: number;
+    reconnectMaxMs?: number;
+}
+export declare class HostClient {
+    readonly options: HostClientOptions;
+    hostId?: string;
+    private socket?;
+    private connected;
+    private closing;
+    private attempt;
+    private heartbeat?;
+    private missedPongs;
+    private readonly sessions;
+    private readonly catalogs;
+    private readonly seenTurns;
+    private readonly seenSet;
+    private welcomeWaiters;
+    constructor(options: HostClientOptions);
+    get isConnected(): boolean;
+    /** Starts connecting; resolves after the first `welcome` or after `timeoutMs` (still retrying in the background). */
+    start(timeoutMs?: number): Promise<boolean>;
+    private connectLoop;
+    private connectOnce;
+    private onWelcome;
+    private dispatch;
+    private remember;
+    private startHeartbeat;
+    private stopHeartbeat;
+    send(frame: HostFrame): boolean;
+    announce(session: Omit<SessionAnnounceFrame, "type">): void;
+    /** Announces a session's command catalog; re-sent with the session after a reconnect. */
+    commands(frame: Omit<SessionCommandsFrame, "type">): void;
+    status(sessionId: string, status: SessionStatus): void;
+    closed(sessionId: string): void;
+    /** Announces every session closed and stops reconnecting. */
+    close(): void;
+}