@heyditto/cli 2.0.0 → 2.1.0

package/README.md

@@ -42,6 +42,17 @@ You can also reorder your `PATH` so the npm global bin comes before `/usr/bin`,
 
 ## Auth
 
+Humans sign in through the browser:
+
+```bash
+heyditto login
+```
+
+This prints a short code, opens `https://heyditto.ai/device` (pre-filled with the
+code), and saves the resulting key to your CLI config directory once you approve
+it. Pass a key as an argument (`heyditto login ditto_mcp_…`), pipe it with
+`--stdin`, or use `--paste` for the older copy-a-key page.
+
 Agents can self-provision without a browser, email, or OTP:
 
 ```bash
@@ -111,6 +122,17 @@ heyditto graphs subscribers
 heyditto graphs sharing (--enable|--disable) [--title <t>] [--description <d>]
 heyditto init [--name <name>] [--subscribe <@graph>]... [<@graph>...] [--json]
 heyditto login [<key>] [--paste] [--stdin]
+heyditto endpoints [--set-default <slug>] [--clear-default]
+heyditto claude [options] [-- <claude args>]
+heyditto codex  [options] [-- <codex args>]
+heyditto sessions [--json] [--all]
+heyditto sessions rm <id>
+heyditto session new [<name>...] [--id <id>]
+heyditto session list [--all]
+heyditto session use <id>
+heyditto session current
+heyditto session end
+heyditto agents [--output <format>]
 heyditto logout
 heyditto status [--output <format>]
 heyditto config
@@ -289,10 +311,109 @@ graph. Choose it up front — renaming after init isn't yet supported. See
 
 Print a Claude Desktop / Cursor / generic-MCP-client config snippet for the Ditto memory server.
 
+## Coding agents
+
+`heyditto claude` and `heyditto codex` launch Claude Code or Codex through one of
+your Ditto **inference endpoints** (Settings → Developer → Inference endpoints
+in the Ditto app). Each launch:
+
+1. lists your endpoints and lets you pick one (or uses `--endpoint` / the saved default),
+2. mints a temporary endpoint key (optionally capped with `--budget <tokens>`),
+3. starts the agent with that key and a fresh `X-Ditto-Session-Id`, so the
+   session becomes its own thread with full traces under the endpoint,
+4. **revokes the key when the agent exits** (Ctrl+C included). The thread and
+   traces are kept; `--keep-key` opts out, `--expires` sets a server-side
+   safety expiry (default `1d`).
+
+```bash
+npx -y @heyditto/cli login
+npx -y @heyditto/cli claude --endpoint my-endpoint
+
+heyditto endpoints --set-default my-endpoint   # skip the picker next time
+heyditto claude                                # interactive Claude Code
+heyditto codex --yellow                        # Codex, auto-accept edits
+heyditto claude --yolo --worktree fix-login    # bypass prompts in <repo>/.worktrees/fix-login
+heyditto codex -p "summarize this repo" --json # headless (codex exec)
+heyditto claude -p "list TODOs" --output-format json --max-turns 3
+heyditto claude --resume                       # reopen the last session in the same thread
+heyditto claude -- --verbose                   # anything after -- goes to the agent
+```
+
+Options shared by both commands:
+
+| Flag | Meaning |
+| --- | --- |
+| `-e, --endpoint <slug>` | endpoint to route through (default: saved default, else a picker) |
+| `--budget <tokens>` | spend cap for this session's key, in Ditto tokens |
+| `--expires <1h…never>` | server-side key expiry; the key is still revoked on exit unless `--keep-key` |
+| `--session <id>` | reuse a Ditto session id so traces land in an existing thread |
+| `--resume [id]` / `-c, --continue` | resume a local session (`heyditto sessions`) / the agent's most recent conversation |
+| `--yolo` / `--yellow` / `--plan` | bypass permissions / auto-accept edits / plan mode (Claude only) |
+| `-p, --prompt <text>` | headless run: `claude -p` or `codex exec` |
+| `-m, --model <id>` | model to request (Codex defaults to the endpoint slug; Claude's ids follow the endpoint's routes) |
+| `-w, --worktree [name]` | run inside `<repo>/.worktrees/<name>` on a branch of that name; `.worktrees/` is added to `.gitignore` |
+| `--name <label>` | key name shown in the app (default `cli:<agent>:<hostname>`) |
+| `--dry-run` | print the command, args and env with the key masked; mints nothing |
+
+Unknown flags and everything after `--` are forwarded to the agent, so Claude's
+and Codex's own options keep working.
+
+How the wiring works:
+
+- **Claude Code** gets `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN` (a bearer
+  token, which skips Claude's "use this API key?" prompt) and
+  `ANTHROPIC_CUSTOM_HEADERS` with the session id. Any inherited
+  `ANTHROPIC_API_KEY` is removed from the child environment.
+- **Codex** speaks the Responses API only, so the endpoint is injected as a
+  `ditto` model provider via `-c` overrides (nothing is written to
+  `~/.codex/config.toml`) with the key in `DITTO_INFERENCE_API_KEY`.
+
+### `endpoints`
+
+List your inference endpoints with model and spend. `--set-default <slug>` picks
+the one used when `--endpoint` is omitted; `--output json` includes the gateway
+base URL.
+
+### `sessions`
+
+List the coding-agent sessions launched from this machine (stored under
+`~/.config/heyditto/cli/sessions/`). `heyditto sessions rm <id>` forgets a local
+record; the Ditto thread and traces are unaffected.
+
+### `session`
+
+Explicit MCP sessions. Without one, the server groups your saves and searches
+into a time-based *implicit* session (activity within a cooldown, auto-named
+when it goes quiet). `heyditto session new [name]` pins an explicit session:
+every MCP request from then on carries `X-Ditto-Session-Id`, and the name goes
+out once as `X-Ditto-Session-Name` so the thread gets that title. Saves and
+searches land in one thread inside the agent your key is attached to.
+
+```bash
+heyditto session new "refactor auth module"   # prints the id and makes it active
+heyditto save "Decided to keep JWT refresh in the gateway"
+heyditto session current                      # the active id (exit 1 when none)
+heyditto session list                         # local history, * marks the active one
+heyditto session end                          # back to implicit sessions
+heyditto session use 9e9a93c3                 # reactivate by id or unique prefix
+```
+
+`DITTO_SESSION_ID=<id>` pins a session for one shell or script (it overrides the
+saved one and never sends a name). Sessions are tracked locally in
+`~/.config/heyditto/cli/mcp-sessions.json`; the server keeps the threads.
+
+### `agents`
+
+List your Ditto agents (`GET /api/v5/chat-agents`): id, kind (`main`, `chat`,
+`inference_endpoint`, `mcp`, `connector`), name, thread count, last activity and
+the live connections (API keys, OAuth grants, endpoints) writing into each.
+
 ## Environment
 
 - `DITTO_API_KEY` (optional) — MCP API key override. Agents can instead run `heyditto init --json` for no-human setup.
 - `DITTO_API_BASE` (optional) — API base URL. Defaults to `https://api.heyditto.ai`. Useful for local dev (`http://localhost:3400`).
+- `DITTO_SESSION_ID` (optional) — pin an explicit MCP session id for this shell (see `session`).
+- `DITTO_CONFIG_DIR` (optional) — config directory for the saved key, default endpoint and session records. Defaults to `$XDG_CONFIG_HOME/heyditto/cli` or `~/.config/heyditto/cli`.
 
 ## Output
 

package/dist/agents/claude.d.ts

@@ -0,0 +1,11 @@
+import { type HarnessPlan, type PlanInput } from "./types.js";
+/**
+ * Builds the `claude` invocation.
+ *
+ * Auth goes through ANTHROPIC_AUTH_TOKEN (sent as `Authorization: Bearer`):
+ * unlike ANTHROPIC_API_KEY it never triggers the interactive "use this API
+ * key? No (recommended)" approval prompt, so the same plan works headless.
+ * Any inherited ANTHROPIC_API_KEY is removed so it cannot re-trigger that
+ * prompt or add a stray x-api-key header.
+ */
+export declare function planClaude(input: PlanInput): HarnessPlan;

package/dist/agents/claude.js

@@ -0,0 +1,48 @@
+import { SESSION_HEADER, apiRootOf } from "./types.js";
+/**
+ * Builds the `claude` invocation.
+ *
+ * Auth goes through ANTHROPIC_AUTH_TOKEN (sent as `Authorization: Bearer`):
+ * unlike ANTHROPIC_API_KEY it never triggers the interactive "use this API
+ * key? No (recommended)" approval prompt, so the same plan works headless.
+ * Any inherited ANTHROPIC_API_KEY is removed so it cannot re-trigger that
+ * prompt or add a stray x-api-key header.
+ */
+export function planClaude(input) {
+    const args = [];
+    if (input.yolo)
+        args.push("--dangerously-skip-permissions");
+    else if (input.yellow)
+        args.push("--permission-mode", "acceptEdits");
+    else if (input.plan)
+        args.push("--permission-mode", "plan");
+    if (input.resumeId)
+        args.push("--resume", input.resumeId);
+    else if (input.resumeLast)
+        args.push("--continue");
+    else
+        args.push("--session-id", input.sessionId);
+    if (input.model)
+        args.push("--model", input.model);
+    if (input.prompt !== undefined)
+        args.push("-p", input.prompt);
+    args.push(...input.passthrough);
+    const headers = [input.env.ANTHROPIC_CUSTOM_HEADERS?.trim(), `${SESSION_HEADER}: ${input.sessionId}`]
+        .filter((h) => Boolean(h))
+        .join("\n");
+    const envSet = {
+        ANTHROPIC_BASE_URL: apiRootOf(input.baseUrl),
+        ANTHROPIC_AUTH_TOKEN: input.apiKey,
+        ANTHROPIC_CUSTOM_HEADERS: headers,
+    };
+    if (input.model)
+        envSet.ANTHROPIC_MODEL = input.model;
+    return {
+        command: "claude",
+        args,
+        envSet,
+        envUnset: ["ANTHROPIC_API_KEY"],
+        installHint: "install Claude Code: npm i -g @anthropic-ai/claude-code (or see https://code.claude.com)",
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzF;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;SACvD,IAAI,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;SAChE,IAAI,KAAK,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAE5D,IAAI,KAAK,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;SACrD,IAAI,KAAK,CAAC,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;;QAC9C,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAEhD,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAEhC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE,EAAE,GAAG,cAAc,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;SAClG,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;SACtC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GAA2B;QACrC,kBAAkB,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5C,oBAAoB,EAAE,KAAK,CAAC,MAAM;QAClC,wBAAwB,EAAE,OAAO;KAClC,CAAC;IACF,IAAI,KAAK,CAAC,KAAK;QAAE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC;IAEtD,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,IAAI;QACJ,MAAM;QACN,QAAQ,EAAE,CAAC,mBAAmB,CAAC;QAC/B,WAAW,EAAE,0FAA0F;KACxG,CAAC;AACJ,CAAC"}

package/dist/agents/codex.d.ts

@@ -0,0 +1,13 @@
+import { type HarnessPlan, type PlanInput } from "./types.js";
+/** Quotes a string as a TOML basic string for `codex -c key=value`. */
+export declare function tomlString(value: string): string;
+/**
+ * Builds the `codex` invocation.
+ *
+ * Codex ignores OPENAI_BASE_URL while a ChatGPT login exists and only speaks
+ * the Responses wire, so the endpoint is injected as a dedicated `ditto`
+ * model provider through `-c` overrides (nothing is written to
+ * ~/.codex/config.toml). The session header rides on the provider's
+ * http_headers so every request lands in the same Ditto thread.
+ */
+export declare function planCodex(input: PlanInput): HarnessPlan;

package/dist/agents/codex.js

@@ -0,0 +1,48 @@
+import { CODEX_KEY_ENV, SESSION_HEADER } from "./types.js";
+/** Quotes a string as a TOML basic string for `codex -c key=value`. */
+export function tomlString(value) {
+    return JSON.stringify(value);
+}
+/**
+ * Builds the `codex` invocation.
+ *
+ * Codex ignores OPENAI_BASE_URL while a ChatGPT login exists and only speaks
+ * the Responses wire, so the endpoint is injected as a dedicated `ditto`
+ * model provider through `-c` overrides (nothing is written to
+ * ~/.codex/config.toml). The session header rides on the provider's
+ * http_headers so every request lands in the same Ditto thread.
+ */
+export function planCodex(input) {
+    const args = [];
+    if (input.prompt !== undefined)
+        args.push("exec");
+    else if (input.resumeId || input.resumeLast)
+        args.push("resume");
+    args.push("-c", `model_provider=${tomlString("ditto")}`, "-c", `model_providers.ditto.name=${tomlString("Ditto")}`, "-c", `model_providers.ditto.base_url=${tomlString(input.baseUrl)}`, "-c", `model_providers.ditto.env_key=${tomlString(CODEX_KEY_ENV)}`, "-c", `model_providers.ditto.wire_api=${tomlString("responses")}`, "-c", `model_providers.ditto.http_headers={${tomlString(SESSION_HEADER)}=${tomlString(input.sessionId)}}`);
+    if (input.model)
+        args.push("-m", input.model);
+    if (input.yolo)
+        args.push("--dangerously-bypass-approvals-and-sandbox");
+    else if (input.yellow)
+        args.push("-a", "on-request", "-s", "workspace-write");
+    if (input.prompt !== undefined) {
+        args.push("--skip-git-repo-check", ...input.passthrough, input.prompt);
+    }
+    else if (input.resumeId) {
+        args.push(...input.passthrough, input.resumeId);
+    }
+    else if (input.resumeLast) {
+        args.push("--last", ...input.passthrough);
+    }
+    else {
+        args.push(...input.passthrough);
+    }
+    return {
+        command: "codex",
+        args,
+        envSet: { [CODEX_KEY_ENV]: input.apiKey },
+        envUnset: [],
+        installHint: "install Codex: npm i -g @openai/codex (or brew install codex)",
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/agents/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoC,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7F,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC7C,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEjE,IAAI,CAAC,IAAI,CACP,IAAI,EACJ,kBAAkB,UAAU,CAAC,OAAO,CAAC,EAAE,EACvC,IAAI,EACJ,8BAA8B,UAAU,CAAC,OAAO,CAAC,EAAE,EACnD,IAAI,EACJ,kCAAkC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAC7D,IAAI,EACJ,iCAAiC,UAAU,CAAC,aAAa,CAAC,EAAE,EAC5D,IAAI,EACJ,kCAAkC,UAAU,CAAC,WAAW,CAAC,EAAE,EAC3D,IAAI,EACJ,uCAAuC,UAAU,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CACpG,CAAC;IACF,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,KAAK,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;SACnE,IAAI,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAE9E,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,IAAI;QACJ,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE;QACzC,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,+DAA+D;KAC7E,CAAC;AACJ,CAAC"}

package/dist/agents/launch.d.ts

@@ -0,0 +1,20 @@
+import { type Harness } from "./types.js";
+export interface LaunchOptions {
+    endpoint?: string;
+    budget?: string;
+    expires?: string;
+    keepKey?: boolean;
+    session?: string;
+    resume?: string | boolean;
+    continue?: boolean;
+    yolo?: boolean;
+    yellow?: boolean;
+    plan?: boolean;
+    prompt?: string;
+    model?: string;
+    worktree?: string | boolean;
+    name?: string;
+    dryRun?: boolean;
+}
+/** Launches a coding harness against a Ditto inference endpoint with a temporary key. */
+export declare function launchHarness(harness: Harness, rawArgs: string[], options: LaunchOptions): Promise<void>;

package/dist/agents/launch.js

@@ -0,0 +1,274 @@
+import { spawn, spawnSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import os from "node:os";
+import { createInterface } from "node:readline/promises";
+import { createKey, listEndpoints, revokeKey, } from "../api.js";
+import { readStoredAuth } from "../store.js";
+import { planClaude } from "./claude.js";
+import { planCodex } from "./codex.js";
+import { latestSession, readSession, writeSession } from "./sessions.js";
+import { KEY_EXPIRIES, childEnv, maskKey, stripSeparator, } from "./types.js";
+import { defaultWorktreeName, ensureWorktree } from "./worktree.js";
+const DRY_RUN_KEY = "ditto_inf_<minted-at-launch>";
+function log(line) {
+    process.stderr.write(`ditto: ${line}\n`);
+}
+function planFor(harness, input) {
+    return harness === "claude" ? planClaude(input) : planCodex(input);
+}
+function binaryAvailable(command) {
+    const probe = process.platform === "win32" ? "where" : "which";
+    return spawnSync(probe, [command], { stdio: "ignore" }).status === 0;
+}
+function parseBudget(raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw.replace(/[_,]/g, ""));
+    if (!Number.isInteger(n) || n <= 0)
+        throw new Error(`--budget must be a positive integer token count, got "${raw}"`);
+    return n;
+}
+function parseExpiry(raw) {
+    const value = (raw ?? "1d").trim();
+    if (KEY_EXPIRIES.includes(value))
+        return value;
+    throw new Error(`--expires must be one of: ${KEY_EXPIRIES.join(", ")}`);
+}
+function formatSpend(e) {
+    const used = e.spentTokens ?? 0;
+    if (e.spendLimitTokens == null || e.spendLimitTokens < 0)
+        return `${used.toLocaleString()} tokens used, no limit`;
+    return `${used.toLocaleString()} / ${e.spendLimitTokens.toLocaleString()} tokens${e.spendPeriod && e.spendPeriod !== "never" ? ` per ${e.spendPeriod.replace(/ly$/, "")}` : ""}`;
+}
+async function pickEndpoint(endpoints) {
+    if (!process.stdin.isTTY || !process.stderr.isTTY) {
+        throw new Error("no endpoint selected. Pass --endpoint <slug>, or set a default with `heyditto endpoints --set-default <slug>`.");
+    }
+    process.stderr.write("Ditto inference endpoints:\n\n");
+    endpoints.forEach((e, i) => {
+        process.stderr.write(`  ${i + 1}) ${e.slug}  ${e.name !== e.slug ? `(${e.name})  ` : ""}model=${e.model}\n`);
+        process.stderr.write(`     ${formatSpend(e)}${e.recordTrace ? "  · traces on" : "  · traces off"}\n`);
+    });
+    process.stderr.write("\n");
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        for (;;) {
+            const answer = (await rl.question(`Connect to which endpoint? [1-${endpoints.length}] `)).trim();
+            const idx = Number(answer);
+            if (Number.isInteger(idx) && idx >= 1 && idx <= endpoints.length)
+                return endpoints[idx - 1];
+            const bySlug = endpoints.find((e) => e.slug === answer || e.id === answer);
+            if (bySlug)
+                return bySlug;
+            process.stderr.write("Pick a number from the list.\n");
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+async function resolveEndpoint(wanted, endpoints) {
+    if (endpoints.length === 0) {
+        throw new Error("you have no inference endpoints yet. Create one in the Ditto app: Settings → Developer → Inference endpoints.");
+    }
+    const stored = (await readStoredAuth())?.defaultEndpoint;
+    const target = wanted?.trim() || stored?.trim();
+    if (target) {
+        const match = endpoints.find((e) => e.slug === target || e.id === target);
+        if (match)
+            return match;
+        if (wanted) {
+            throw new Error(`no endpoint named "${target}". Available: ${endpoints.map((e) => e.slug).join(", ")}`);
+        }
+        log(`default endpoint "${target}" no longer exists; pick another`);
+    }
+    if (endpoints.length === 1)
+        return endpoints[0];
+    return pickEndpoint(endpoints);
+}
+function forwardSignals(child) {
+    // Ctrl+C reaches the child directly through the shared terminal; the
+    // wrapper only has to survive it so it can revoke the key afterwards.
+    const onInt = () => {
+        /* keep running until the harness exits */
+    };
+    const onTerm = () => child.kill("SIGTERM");
+    const onHup = () => child.kill("SIGHUP");
+    process.on("SIGINT", onInt);
+    process.on("SIGTERM", onTerm);
+    process.on("SIGHUP", onHup);
+    return () => {
+        process.off("SIGINT", onInt);
+        process.off("SIGTERM", onTerm);
+        process.off("SIGHUP", onHup);
+    };
+}
+function waitForExit(child) {
+    return new Promise((resolve, reject) => {
+        child.on("error", reject);
+        child.on("exit", (code, signal) => resolve(code ?? (signal ? 128 + (os.constants.signals[signal] ?? 0) : null)));
+    });
+}
+/** Launches a coding harness against a Ditto inference endpoint with a temporary key. */
+export async function launchHarness(harness, rawArgs, options) {
+    const passthrough = stripSeparator(rawArgs);
+    const budget = parseBudget(options.budget);
+    const expiresIn = parseExpiry(options.expires);
+    if (options.plan && harness !== "claude")
+        throw new Error("--plan is only supported for claude");
+    if ([options.yolo, options.yellow, options.plan].filter(Boolean).length > 1) {
+        throw new Error("choose only one of --yolo, --yellow, --plan");
+    }
+    if (options.resume !== undefined && options.continue)
+        throw new Error("use either --resume or --continue");
+    if (options.resume !== undefined && options.session)
+        throw new Error("--session cannot be combined with --resume");
+    if (!options.dryRun && !binaryAvailable(harness)) {
+        const hint = planFor(harness, {
+            baseUrl: "",
+            apiKey: "",
+            sessionId: "",
+            passthrough: [],
+            env: {},
+        }).installHint;
+        throw new Error(`"${harness}" is not on your PATH; ${hint}`);
+    }
+    // Resume: reuse the local record's Ditto session id so the traces stay in
+    // the same thread; a fresh key is minted every launch.
+    let record;
+    let resumeLast = Boolean(options.continue);
+    if (options.resume !== undefined) {
+        record =
+            typeof options.resume === "string"
+                ? await readSession(options.resume)
+                : await latestSession(harness, process.cwd());
+        if (!record) {
+            throw new Error(typeof options.resume === "string"
+                ? `no local session "${options.resume}"; see \`heyditto sessions\``
+                : `no previous ${harness} session to resume; see \`heyditto sessions\``);
+        }
+        if (record.harness !== harness)
+            throw new Error(`session ${record.id} was a ${record.harness} session`);
+        if (!record.harnessSessionId)
+            resumeLast = true;
+    }
+    const catalog = await listEndpoints();
+    const endpoint = await resolveEndpoint(options.endpoint ?? record?.endpointSlug, catalog.endpoints);
+    let cwd = record?.worktree ?? process.cwd();
+    let worktreePath = record?.worktree;
+    if (options.worktree !== undefined && options.worktree !== false) {
+        const name = typeof options.worktree === "string" ? options.worktree : defaultWorktreeName(harness);
+        if (options.dryRun) {
+            log(`would create worktree .worktrees/${name}`);
+        }
+        else {
+            const wt = await ensureWorktree(process.cwd(), name);
+            log(`${wt.created ? "created" : "reusing"} worktree ${wt.path} (branch ${wt.branch})`);
+            cwd = wt.path;
+            worktreePath = wt.path;
+        }
+    }
+    const sessionId = record?.id ?? options.session?.trim() ?? randomUUID();
+    if (!/^[A-Za-z0-9._:@-]{1,128}$/.test(sessionId)) {
+        throw new Error("--session must match ^[A-Za-z0-9._:@-]{1,128}$");
+    }
+    const harnessSessionId = record?.harnessSessionId ?? (harness === "claude" && !resumeLast ? sessionId : undefined);
+    const model = options.model ?? record?.model ?? (harness === "codex" ? endpoint.slug : undefined);
+    const now = new Date().toISOString();
+    const keyName = options.name?.trim() || `cli:${harness}:${os.hostname()}`;
+    let key;
+    if (!options.dryRun) {
+        key = await createKey(endpoint.id, {
+            name: keyName,
+            expiresIn,
+            ...(budget !== undefined ? { spendLimitTokens: budget, spendPeriod: "never" } : {}),
+        });
+    }
+    const plan = planFor(harness, {
+        baseUrl: catalog.baseUrl,
+        apiKey: key?.key ?? DRY_RUN_KEY,
+        sessionId,
+        model,
+        resumeId: record ? record.harnessSessionId : undefined,
+        resumeLast,
+        prompt: options.prompt,
+        yolo: options.yolo,
+        yellow: options.yellow,
+        plan: options.plan,
+        passthrough,
+        env: process.env,
+    });
+    const banner = [
+        `endpoint=${endpoint.slug}`,
+        `model=${model ?? "(harness default → endpoint routes)"}`,
+        `key=${key ? `…${key.keyHint || maskKey(key.key ?? "")}` : "(dry run)"}`,
+        `expires=${expiresIn}${options.keepKey ? "" : " (revoked on exit)"}`,
+        budget !== undefined ? `budget=${budget.toLocaleString()} tokens` : undefined,
+        `session=${sessionId}`,
+    ]
+        .filter(Boolean)
+        .join("  ");
+    log(banner);
+    log(`traces: Ditto app → Settings → Developer → Inference endpoints → ${endpoint.slug}`);
+    if (options.dryRun) {
+        const env = Object.fromEntries(Object.entries(plan.envSet).map(([k, v]) => [k, v === DRY_RUN_KEY ? "<key>" : v]));
+        process.stdout.write(`${JSON.stringify({
+            harness,
+            command: plan.command,
+            args: plan.args,
+            env,
+            unsetEnv: plan.envUnset,
+            cwd,
+            endpoint: { id: endpoint.id, slug: endpoint.slug, model: endpoint.model },
+            sessionId,
+            key: { name: keyName, expiresIn, spendLimitTokens: budget ?? null },
+        }, null, 2)}\n`);
+        return;
+    }
+    if (!key)
+        throw new Error("internal: key was not minted");
+    const nextRecord = {
+        id: sessionId,
+        harness,
+        endpointId: endpoint.id,
+        endpointSlug: endpoint.slug,
+        keyId: key.id,
+        keyHint: key.keyHint,
+        harnessSessionId,
+        cwd: record?.cwd ?? process.cwd(),
+        worktree: worktreePath,
+        model,
+        createdAt: record?.createdAt ?? now,
+        lastLaunchedAt: now,
+        launches: (record?.launches ?? 0) + 1,
+    };
+    await writeSession(nextRecord);
+    const child = spawn(plan.command, plan.args, {
+        stdio: "inherit",
+        env: childEnv(plan, process.env),
+        cwd,
+    });
+    const restore = forwardSignals(child);
+    let exitCode = null;
+    try {
+        exitCode = await waitForExit(child);
+    }
+    finally {
+        restore();
+        if (options.keepKey) {
+            log(`kept key …${key.keyHint} (expires ${expiresIn}); revoke it from the Ditto app when done`);
+        }
+        else {
+            try {
+                await revokeKey(endpoint.id, key.id);
+                log(`revoked session key …${key.keyHint}; thread kept (resume with: heyditto ${harness} --resume ${sessionId})`);
+            }
+            catch (err) {
+                log(`could not revoke key …${key.keyHint} (${err instanceof Error ? err.message : String(err)}); it expires in ${expiresIn}`);
+            }
+        }
+        await writeSession({ ...nextRecord, endedAt: new Date().toISOString(), exitCode });
+    }
+    process.exitCode = exitCode ?? 1;
+}
+//# sourceMappingURL=launch.js.map

package/dist/agents/launch.js.map

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

package/dist/agents/sessions.d.ts

@@ -0,0 +1,28 @@
+import type { Harness } from "./types.js";
+/** One coding-agent session launched by the CLI; the Ditto session id is the file name. */
+export interface SessionRecord {
+    id: string;
+    harness: Harness;
+    endpointId: string;
+    endpointSlug: string;
+    /** Last key minted for this session; revoked on exit unless --keep-key. */
+    keyId?: string;
+    keyHint?: string;
+    /** Harness-native id used to resume (Claude's --session-id; Codex thread id when known). */
+    harnessSessionId?: string;
+    cwd: string;
+    worktree?: string;
+    model?: string;
+    createdAt: string;
+    lastLaunchedAt: string;
+    endedAt?: string;
+    exitCode?: number | null;
+    launches: number;
+}
+export declare function writeSession(record: SessionRecord): Promise<void>;
+export declare function readSession(id: string): Promise<SessionRecord | undefined>;
+export declare function removeSession(id: string): Promise<boolean>;
+/** All local records, most recently launched first. */
+export declare function listSessions(): Promise<SessionRecord[]>;
+/** Most recent record for a harness, preferring one launched from the same directory. */
+export declare function latestSession(harness: Harness, cwd: string): Promise<SessionRecord | undefined>;