@heyditto/cli 2.0.0 → 2.1.0

package/dist/agents/sessions.js

@@ -0,0 +1,63 @@
+import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { sessionsDir } from "../config.js";
+function fileFor(id) {
+    if (!/^[A-Za-z0-9._:@-]{1,128}$/.test(id))
+        throw new Error(`invalid session id: ${id}`);
+    return path.join(sessionsDir(), `${id}.json`);
+}
+export async function writeSession(record) {
+    await mkdir(sessionsDir(), { recursive: true, mode: 0o700 });
+    await writeFile(fileFor(record.id), `${JSON.stringify(record, null, 2)}\n`, { mode: 0o600 });
+}
+export async function readSession(id) {
+    try {
+        return JSON.parse(await readFile(fileFor(id), "utf8"));
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return undefined;
+        throw err;
+    }
+}
+export async function removeSession(id) {
+    try {
+        await rm(fileFor(id));
+        return true;
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return false;
+        throw err;
+    }
+}
+/** All local records, most recently launched first. */
+export async function listSessions() {
+    let names;
+    try {
+        names = await readdir(sessionsDir());
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const records = [];
+    for (const name of names) {
+        if (!name.endsWith(".json"))
+            continue;
+        try {
+            records.push(JSON.parse(await readFile(path.join(sessionsDir(), name), "utf8")));
+        }
+        catch {
+            /* skip unreadable record */
+        }
+    }
+    return records.sort((a, b) => (b.lastLaunchedAt ?? "").localeCompare(a.lastLaunchedAt ?? ""));
+}
+/** Most recent record for a harness, preferring one launched from the same directory. */
+export async function latestSession(harness, cwd) {
+    const all = (await listSessions()).filter((s) => s.harness === harness);
+    return all.find((s) => s.cwd === cwd || s.worktree === cwd) ?? all[0];
+}
+//# sourceMappingURL=sessions.js.map

package/dist/agents/sessions.js.map

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

package/dist/agents/types.d.ts

@@ -0,0 +1,50 @@
+/** Shared types for the coding-agent launchers. Pure data, no I/O. */
+export type Harness = "claude" | "codex";
+export declare const HARNESSES: readonly Harness[];
+export declare const KEY_EXPIRIES: readonly ["1h", "4h", "8h", "12h", "1d", "1w", "1mo", "3mo", "6mo", "1y", "never"];
+export type KeyExpiry = (typeof KEY_EXPIRIES)[number];
+/** Header the Ditto gateway groups turns by; every launch sends one. */
+export declare const SESSION_HEADER = "X-Ditto-Session-Id";
+/** Env var the Codex provider reads the endpoint key from. */
+export declare const CODEX_KEY_ENV = "DITTO_INFERENCE_API_KEY";
+/** Everything a harness planner needs to build argv + env. */
+export interface PlanInput {
+    /** Inference gateway base URL ending in /v1, e.g. https://api.heyditto.ai/v1 */
+    baseUrl: string;
+    /** Plaintext endpoint key (already minted) or a placeholder for --dry-run. */
+    apiKey: string;
+    /** Ditto session id sent as X-Ditto-Session-Id. */
+    sessionId: string;
+    /** Model id to request; undefined leaves the harness default (gateway routes it). */
+    model?: string;
+    /** Harness-native session/thread id to resume, when resuming. */
+    resumeId?: string;
+    /** Resume the most recent harness session (claude --continue / codex resume --last). */
+    resumeLast?: boolean;
+    /** Headless prompt: claude -p / codex exec. */
+    prompt?: string;
+    yolo?: boolean;
+    yellow?: boolean;
+    plan?: boolean;
+    /** Extra argv forwarded verbatim to the harness. */
+    passthrough: string[];
+    /** Parent environment to derive the child environment from. */
+    env: NodeJS.ProcessEnv;
+}
+export interface HarnessPlan {
+    command: string;
+    args: string[];
+    /** Env vars set on the child (in addition to the inherited environment). */
+    envSet: Record<string, string>;
+    /** Env vars removed from the child environment. */
+    envUnset: string[];
+    /** Human-readable install hint when the binary is missing. */
+    installHint: string;
+}
+/** Strips the first `--` separator commander leaves in a variadic passthrough list. */
+export declare function stripSeparator(args: string[]): string[];
+/** Applies a plan's env changes to a copy of the given environment. */
+export declare function childEnv(plan: HarnessPlan, parent: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** Base URL with a trailing /v1 removed: what ANTHROPIC_BASE_URL expects. */
+export declare function apiRootOf(baseUrl: string): string;
+export declare function maskKey(key: string): string;

package/dist/agents/types.js

@@ -0,0 +1,44 @@
+/** Shared types for the coding-agent launchers. Pure data, no I/O. */
+export const HARNESSES = ["claude", "codex"];
+export const KEY_EXPIRIES = [
+    "1h",
+    "4h",
+    "8h",
+    "12h",
+    "1d",
+    "1w",
+    "1mo",
+    "3mo",
+    "6mo",
+    "1y",
+    "never",
+];
+/** Header the Ditto gateway groups turns by; every launch sends one. */
+export const SESSION_HEADER = "X-Ditto-Session-Id";
+/** Env var the Codex provider reads the endpoint key from. */
+export const CODEX_KEY_ENV = "DITTO_INFERENCE_API_KEY";
+/** Strips the first `--` separator commander leaves in a variadic passthrough list. */
+export function stripSeparator(args) {
+    const i = args.indexOf("--");
+    if (i === -1)
+        return args;
+    return [...args.slice(0, i), ...args.slice(i + 1)];
+}
+/** Applies a plan's env changes to a copy of the given environment. */
+export function childEnv(plan, parent) {
+    const env = { ...parent };
+    for (const k of plan.envUnset)
+        delete env[k];
+    Object.assign(env, plan.envSet);
+    return env;
+}
+/** Base URL with a trailing /v1 removed: what ANTHROPIC_BASE_URL expects. */
+export function apiRootOf(baseUrl) {
+    return baseUrl.replace(/\/+$/, "").replace(/\/v1$/, "");
+}
+export function maskKey(key) {
+    if (key.length <= 8)
+        return "…";
+    return `${key.slice(0, 10)}…${key.slice(-4)}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAItE,MAAM,CAAC,MAAM,SAAS,GAAuB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,OAAO;CACC,CAAC;AAGX,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAEnD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAsCvD,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,IAAiB,EAAE,MAAyB;IACnE,MAAM,GAAG,GAAsB,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

package/dist/agents/worktree.d.ts

@@ -0,0 +1,19 @@
+import type { Harness } from "./types.js";
+/** Folder inside the repository that holds the CLI's worktrees (kept out of git). */
+export declare const WORKTREES_DIR = ".worktrees";
+/** `<harness>-<yyyymmdd-hhmm>`, e.g. `claude-20260904-1530`. */
+export declare function defaultWorktreeName(harness: Harness, now?: Date): string;
+export declare function validWorktreeName(name: string): boolean;
+export declare function repoRoot(cwd: string): string | undefined;
+/** Adds `.worktrees/` to the repo root .gitignore when it is not already listed. */
+export declare function ensureGitignore(root: string): Promise<boolean>;
+export interface WorktreeResult {
+    path: string;
+    branch: string;
+    created: boolean;
+}
+/**
+ * Creates (or reuses) `<repo>/.worktrees/<name>` on a branch of the same
+ * name, mirroring how Claude Code keeps worktrees inside the repository.
+ */
+export declare function ensureWorktree(cwd: string, name: string): Promise<WorktreeResult>;

package/dist/agents/worktree.js

@@ -0,0 +1,72 @@
+import { spawnSync } from "node:child_process";
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+/** Folder inside the repository that holds the CLI's worktrees (kept out of git). */
+export const WORKTREES_DIR = ".worktrees";
+function pad(n) {
+    return String(n).padStart(2, "0");
+}
+/** `<harness>-<yyyymmdd-hhmm>`, e.g. `claude-20260904-1530`. */
+export function defaultWorktreeName(harness, now = new Date()) {
+    const stamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
+        `-${pad(now.getHours())}${pad(now.getMinutes())}`;
+    return `${harness}-${stamp}`;
+}
+export function validWorktreeName(name) {
+    return /^[A-Za-z0-9][A-Za-z0-9._\/-]{0,80}$/.test(name) && !name.includes("..");
+}
+function git(args, cwd) {
+    const res = spawnSync("git", args, { cwd, encoding: "utf8" });
+    return { ok: res.status === 0, out: (res.stdout ?? "").trim(), err: (res.stderr ?? "").trim() };
+}
+export function repoRoot(cwd) {
+    const res = git(["rev-parse", "--show-toplevel"], cwd);
+    return res.ok && res.out ? res.out : undefined;
+}
+/** Adds `.worktrees/` to the repo root .gitignore when it is not already listed. */
+export async function ensureGitignore(root) {
+    const file = path.join(root, ".gitignore");
+    let current = "";
+    try {
+        current = await readFile(file, "utf8");
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+    }
+    const listed = current
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .some((l) => l === WORKTREES_DIR || l === `${WORKTREES_DIR}/` || l === `/${WORKTREES_DIR}` || l === `/${WORKTREES_DIR}/`);
+    if (listed)
+        return false;
+    const prefix = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
+    await appendFile(file, `${prefix}# Coding-agent worktrees created by heyditto\n${WORKTREES_DIR}/\n`);
+    return true;
+}
+/**
+ * Creates (or reuses) `<repo>/.worktrees/<name>` on a branch of the same
+ * name, mirroring how Claude Code keeps worktrees inside the repository.
+ */
+export async function ensureWorktree(cwd, name) {
+    const root = repoRoot(cwd);
+    if (!root)
+        throw new Error(`--worktree needs a git repository (no repo found at ${cwd})`);
+    if (!validWorktreeName(name))
+        throw new Error(`invalid worktree name: ${name}`);
+    await ensureGitignore(root);
+    const dir = path.join(root, WORKTREES_DIR, name);
+    await mkdir(path.dirname(dir), { recursive: true });
+    const existing = git(["worktree", "list", "--porcelain"], root);
+    if (existing.ok && existing.out.split("\n").includes(`worktree ${dir}`)) {
+        return { path: dir, branch: name, created: false };
+    }
+    const branchExists = git(["show-ref", "--verify", "--quiet", `refs/heads/${name}`], root).ok;
+    const add = branchExists
+        ? git(["worktree", "add", dir, name], root)
+        : git(["worktree", "add", "-b", name, dir], root);
+    if (!add.ok)
+        throw new Error(`git worktree add failed: ${add.err || add.out}`);
+    return { path: dir, branch: name, created: true };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/agents/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../src/agents/worktree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,MAAY,IAAI,IAAI,EAAE;IAC1E,MAAM,KAAK,GACT,GAAG,GAAG,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE;QACrE,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IACpD,OAAO,GAAG,OAAO,IAAI,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,GAAG,CAAC,IAAc,EAAE,GAAW;IACtC,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;IACD,MAAM,MAAM,GAAG,OAAO;SACnB,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,GAAG,aAAa,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,EAAE,IAAI,CAAC,KAAK,IAAI,aAAa,GAAG,CAAC,CAAC;IAC5H,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,MAAM,iDAAiD,aAAa,KAAK,CAAC,CAAC;IACrG,OAAO,IAAI,CAAC;AACd,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,GAAG,GAAG,CAAC,CAAC;IAC1F,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IAChF,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,IAAI,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,GAAG,EAAE,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;IAC7F,MAAM,GAAG,GAAG,YAAY;QACtB,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC;QAC3C,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/E,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC"}

package/dist/api.d.ts

@@ -0,0 +1,110 @@
+/** Minimal authenticated REST client for the Ditto management API. */
+export declare class ApiError extends Error {
+    status: number;
+    body: string;
+    constructor(message: string, status: number, body: string);
+}
+export declare function apiBase(): string;
+export declare function apiFetch<T>(path: string, init?: {
+    method?: string;
+    body?: unknown;
+    auth?: boolean;
+}): Promise<T>;
+export interface InferenceEndpoint {
+    id: string;
+    slug: string;
+    name: string;
+    model: string;
+    spendPeriod?: string;
+    spendLimitTokens?: number | null;
+    spentTokens?: number;
+    recordTrace?: boolean;
+    recallEnabled?: boolean;
+    recordEnabled?: boolean;
+    tools?: string[];
+}
+export interface InferenceEndpointsResponse {
+    baseUrl: string;
+    endpoints: InferenceEndpoint[];
+    limit?: number;
+    used?: number;
+}
+export declare function listEndpoints(): Promise<InferenceEndpointsResponse>;
+export interface InferenceKey {
+    id: string;
+    endpointId: string;
+    name: string;
+    keyHint: string;
+    key?: string;
+    expiresAt?: string | null;
+    spendLimitTokens?: number | null;
+    spendPeriod?: string;
+}
+export interface CreateKeyInput {
+    name: string;
+    expiresIn: string;
+    spendLimitTokens?: number;
+    spendPeriod?: string;
+}
+export declare function createKey(endpointId: string, input: CreateKeyInput): Promise<InferenceKey>;
+export declare function revokeKey(endpointId: string, keyId: string): Promise<void>;
+export interface InferenceSession {
+    id: string;
+    endpointId: string;
+    sessionKey: string;
+    threadId?: string;
+    harness?: string;
+    model?: string;
+    turnCount?: number;
+    firstSeenAt?: string;
+    lastSeenAt?: string;
+}
+export declare function listRemoteSessions(endpointId: string): Promise<InferenceSession[]>;
+export interface DeviceCode {
+    device_code: string;
+    user_code: string;
+    verification_url: string;
+    expires_in: number;
+    interval: number;
+}
+export declare function requestDeviceCode(): Promise<DeviceCode>;
+export type DeviceTokenResult = {
+    status: "ok";
+    accessToken: string;
+} | {
+    status: "pending";
+} | {
+    status: "slow_down";
+} | {
+    status: "denied";
+} | {
+    status: "expired";
+};
+export declare function pollDeviceToken(deviceCode: string): Promise<DeviceTokenResult>;
+export interface AgentConnection {
+    id: string;
+    agentId: string;
+    kind: string;
+    refId: string;
+    name: string;
+    sessionCooldownSeconds?: number;
+    createdAt: string;
+    lastUsedAt?: string | null;
+    expiresAt?: string | null;
+    revokedAt?: string | null;
+}
+export interface ChatAgent {
+    id: string;
+    kind: string;
+    name: string;
+    mainThreadId: string;
+    kgId?: string;
+    status: string;
+    pinned?: boolean;
+    threadCount?: number;
+    lastActivityAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    connections?: AgentConnection[];
+}
+export declare function listChatAgents(): Promise<ChatAgent[]>;

package/dist/api.js

@@ -0,0 +1,119 @@
+import { packageName, packageVersion, resolveApiKey } from "./config.js";
+/** Minimal authenticated REST client for the Ditto management API. */
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "ApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+export function apiBase() {
+    return (process.env.DITTO_API_BASE || "https://api.heyditto.ai").replace(/\/+$/, "");
+}
+function userAgent() {
+    return `${packageName}/${packageVersion}`;
+}
+async function requireKey() {
+    const { key } = await resolveApiKey();
+    if (!key) {
+        throw new Error("no Ditto API key configured.\n\n" +
+            "  Run: heyditto login\n" +
+            "  Or save an existing key with: heyditto login <key>\n");
+    }
+    return key;
+}
+export async function apiFetch(path, init = {}) {
+    const headers = {
+        Accept: "application/json",
+        "User-Agent": userAgent(),
+    };
+    if (init.body !== undefined)
+        headers["Content-Type"] = "application/json";
+    if (init.auth !== false)
+        headers.Authorization = `Bearer ${await requireKey()}`;
+    const response = await fetch(`${apiBase()}${path}`, {
+        method: init.method ?? "GET",
+        headers,
+        body: init.body === undefined ? undefined : JSON.stringify(init.body),
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        let detail = text;
+        try {
+            const parsed = JSON.parse(text);
+            detail = parsed.message || parsed.error || text;
+        }
+        catch {
+            /* raw body */
+        }
+        const hint = response.status === 401
+            ? " (is the saved key valid? run `heyditto login`)"
+            : response.status === 403
+                ? " (the key is not allowed to manage inference endpoints)"
+                : "";
+        throw new ApiError(`${init.method ?? "GET"} ${path} failed: HTTP ${response.status}${detail ? ` - ${detail.slice(0, 300)}` : ""}${hint}`, response.status, text);
+    }
+    if (response.status === 204)
+        return undefined;
+    return (await response.json());
+}
+export async function listEndpoints() {
+    const res = await apiFetch("/api/v5/inference/endpoints");
+    return {
+        baseUrl: (res.baseUrl || `${apiBase()}/v1`).replace(/\/+$/, ""),
+        endpoints: res.endpoints ?? [],
+        limit: res.limit,
+        used: res.used,
+    };
+}
+export async function createKey(endpointId, input) {
+    const key = await apiFetch(`/api/v5/inference/endpoints/${encodeURIComponent(endpointId)}/keys`, { method: "POST", body: input });
+    if (!key.key)
+        throw new Error("key creation succeeded but no plaintext key was returned");
+    return key;
+}
+export async function revokeKey(endpointId, keyId) {
+    await apiFetch(`/api/v5/inference/endpoints/${encodeURIComponent(endpointId)}/keys/${encodeURIComponent(keyId)}`, { method: "DELETE" });
+}
+export async function listRemoteSessions(endpointId) {
+    const res = await apiFetch(`/api/v5/inference/endpoints/${encodeURIComponent(endpointId)}/sessions`);
+    return res.sessions ?? [];
+}
+export async function requestDeviceCode() {
+    const res = await apiFetch("/api/v2/mcp/device-code", {
+        method: "POST",
+        body: {},
+        auth: false,
+    });
+    if (!res.device_code || !res.user_code || !res.verification_url) {
+        throw new Error("device login is not available on this API (malformed device-code response)");
+    }
+    return res;
+}
+export async function pollDeviceToken(deviceCode) {
+    const res = await apiFetch("/api/v2/mcp/device-token", {
+        method: "POST",
+        auth: false,
+        body: { device_code: deviceCode, grant_type: "urn:ietf:params:oauth:grant-type:device_code" },
+    });
+    if (res.access_token)
+        return { status: "ok", accessToken: res.access_token };
+    switch (res.error) {
+        case "authorization_pending":
+            return { status: "pending" };
+        case "slow_down":
+            return { status: "slow_down" };
+        case "access_denied":
+            return { status: "denied" };
+        default:
+            return { status: "expired" };
+    }
+}
+export async function listChatAgents() {
+    const out = await apiFetch("/api/v5/chat-agents");
+    return out.agents ?? [];
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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