@heyditto/cli 2.10.0 → 2.12.0

package/dist/remote/catalog.js

@@ -0,0 +1,309 @@
+import { watch } from "node:fs";
+import { readFile, readdir, stat } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+/**
+ * The command catalog a session announces (`session.commands`): what the app
+ * may put behind "/" in its composer. Builtins are listed per harness version
+ * we ship against; custom commands, skills and plugin skills are read from the
+ * same directories the harness reads, so the catalog is what the user would
+ * see locally. Everything is best effort: an unreadable directory contributes
+ * nothing rather than failing the session.
+ */
+function claudeHome() {
+    return process.env.CLAUDE_CONFIG_DIR?.trim() || path.join(os.homedir(), ".claude");
+}
+function codexHome() {
+    return process.env.CODEX_HOME?.trim() || path.join(os.homedir(), ".codex");
+}
+/**
+ * Claude Code 2.1.x builtins. `headless` is true only for the ones that are
+ * prompt expansions (they work under `claude -p`); the rest drive the TUI.
+ */
+const CLAUDE_BUILTINS = [
+    ["help", "show help and available commands", false],
+    ["clear", "clear conversation history", false],
+    ["compact", "compact the conversation, optionally with focus instructions", false, "[instructions]"],
+    ["context", "show current context usage", false],
+    ["cost", "show token usage and cost for this session", false],
+    ["model", "set the model for the session", false, "[model]"],
+    ["review", "review a pull request", true, "[pr]"],
+    ["init", "create a CLAUDE.md for this repository", true],
+    ["memory", "edit memory files", false],
+    ["config", "open the settings", false],
+    ["status", "show session status", false],
+    ["doctor", "check the health of the installation", false],
+    ["permissions", "view or update permissions", false],
+    ["mcp", "manage MCP servers", false],
+    ["agents", "manage agent configurations", false],
+    ["hooks", "manage hook configurations", false],
+    ["resume", "resume a previous conversation", false],
+    ["rewind", "rewind the conversation or code", false],
+    ["export", "export the conversation", false, "[file]"],
+    ["add-dir", "add a working directory", false, "<path>"],
+    ["plan", "enter plan mode", false],
+    ["fast", "toggle fast mode", false],
+    ["pr-comments", "fetch comments from a GitHub pull request", true, "[pr]"],
+    ["release-notes", "show release notes", false],
+    ["bug", "report a bug", false],
+    ["vim", "toggle vim editing mode", false],
+    ["exit", "exit the session", false],
+];
+/** Codex 0.153.x builtins; none of them exist under `codex exec`. */
+const CODEX_BUILTINS = [
+    ["model", "choose the model and reasoning effort"],
+    ["new", "start a new chat"],
+    ["compact", "summarize the conversation to free context"],
+    ["diff", "show git diff (including untracked files)"],
+    ["status", "show session configuration and token usage"],
+    ["approvals", "choose what Codex can do without approval"],
+    ["permissions", "choose what Codex can do without approval"],
+    ["init", "create an AGENTS.md for this repository"],
+    ["mention", "mention a file", "<path>"],
+    ["review", "review the working tree changes"],
+    ["mcp", "list configured MCP tools"],
+    ["skills", "list the available skills"],
+    ["plan", "plan mode"],
+    ["undo", "undo the last file changes"],
+    ["resume", "resume a saved chat"],
+    ["personality", "choose the assistant's personality"],
+    ["feedback", "send feedback"],
+    ["logout", "log out of Codex"],
+    ["quit", "exit Codex"],
+];
+/** `key: value` lines between the leading `---` fences; enough for command and skill files. */
+export function parseFrontmatter(text) {
+    const fields = {};
+    if (!text.startsWith("---"))
+        return { fields, body: text };
+    const end = text.indexOf("\n---", 3);
+    if (end === -1)
+        return { fields, body: text };
+    for (const line of text.slice(3, end).split("\n")) {
+        const m = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (m)
+            fields[m[1].toLowerCase()] = m[2].trim().replace(/^["']|["']$/g, "");
+    }
+    return { fields, body: text.slice(end + 4).replace(/^\r?\n/, "") };
+}
+function firstLine(body) {
+    const line = body
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l && !l.startsWith("#") && !l.startsWith("<!--"));
+    return (line ?? "").slice(0, 200);
+}
+async function isDir(p) {
+    try {
+        return (await stat(p)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function readText(p) {
+    try {
+        return await readFile(p, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Markdown command files under `dir` (recursive), as `<name>` entries. */
+async function commandFiles(dir, source, prefix = "") {
+    if (!(await isDir(dir)))
+        return [];
+    const out = [];
+    let entries;
+    try {
+        entries = (await readdir(dir)).sort();
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry);
+        if (await isDir(full)) {
+            out.push(...(await commandFiles(full, source, prefix)));
+            continue;
+        }
+        if (!entry.endsWith(".md"))
+            continue;
+        const text = await readText(full);
+        if (text === undefined)
+            continue;
+        const { fields, body } = parseFrontmatter(text);
+        out.push({
+            name: `${prefix}${path.basename(entry, ".md")}`,
+            description: fields.description || firstLine(body),
+            source,
+            ...(fields["argument-hint"] ? { argsHint: fields["argument-hint"] } : {}),
+            headless: true,
+        });
+    }
+    return out;
+}
+/** Skills (one SKILL.md per folder under `dir`) that the user may invoke by name. */
+async function skillDirs(dir, source, prefix = "") {
+    if (!(await isDir(dir)))
+        return [];
+    const out = [];
+    let entries;
+    try {
+        entries = (await readdir(dir)).sort();
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        const text = await readText(path.join(dir, entry, "SKILL.md"));
+        if (text === undefined)
+            continue;
+        const { fields, body } = parseFrontmatter(text);
+        if ((fields["user-invocable"] ?? fields["user-invokable"] ?? "true").toLowerCase() === "false")
+            continue;
+        out.push({
+            name: `${prefix}${fields.name || entry}`,
+            description: fields.description || firstLine(body),
+            source,
+            ...(fields["argument-hint"] ? { argsHint: fields["argument-hint"] } : {}),
+            headless: true,
+        });
+    }
+    return out;
+}
+/** Plugins from `~/.claude/plugins/installed_plugins.json` that apply to `cwd`. */
+async function installedPlugins(cwd) {
+    const text = await readText(path.join(claudeHome(), "plugins", "installed_plugins.json"));
+    if (!text)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const [key, installs] of Object.entries(parsed.plugins ?? {})) {
+        const name = key.split("@")[0];
+        for (const install of installs ?? []) {
+            if (!install.installPath)
+                continue;
+            if (install.scope === "project" && install.projectPath && !cwd.startsWith(install.projectPath))
+                continue;
+            out.push({ name, installPath: install.installPath, scope: install.scope, projectPath: install.projectPath });
+        }
+    }
+    return out;
+}
+/** Directories whose contents feed the catalog; watched for changes. */
+export function catalogDirs(harness, cwd) {
+    if (harness === "claude") {
+        return [
+            path.join(cwd, ".claude", "commands"),
+            path.join(cwd, ".claude", "skills"),
+            path.join(claudeHome(), "commands"),
+            path.join(claudeHome(), "skills"),
+            path.join(claudeHome(), "plugins"),
+        ];
+    }
+    return [
+        path.join(codexHome(), "prompts"),
+        path.join(codexHome(), "skills"),
+        path.join(cwd, ".agents", "skills"),
+        path.join(cwd, ".codex", "skills"),
+        path.join(os.homedir(), ".agents", "skills"),
+    ];
+}
+export async function discoverCommands(harness, cwd) {
+    const seen = new Set();
+    const out = [];
+    const add = (entries) => {
+        for (const e of entries) {
+            if (seen.has(e.name))
+                continue;
+            seen.add(e.name);
+            out.push(e);
+        }
+    };
+    if (harness === "claude") {
+        add(await commandFiles(path.join(cwd, ".claude", "commands"), "custom"));
+        add(await commandFiles(path.join(claudeHome(), "commands"), "custom"));
+        add(await skillDirs(path.join(cwd, ".claude", "skills"), "skill"));
+        add(await skillDirs(path.join(claudeHome(), "skills"), "skill"));
+        for (const plugin of await installedPlugins(cwd)) {
+            add(await skillDirs(path.join(plugin.installPath, "skills"), "plugin", `${plugin.name}:`));
+            add(await commandFiles(path.join(plugin.installPath, "commands"), "plugin", `${plugin.name}:`));
+        }
+        add(CLAUDE_BUILTINS.map(([name, description, headless, argsHint]) => ({
+            name,
+            description,
+            source: "builtin",
+            ...(argsHint ? { argsHint } : {}),
+            headless,
+        })));
+        return out;
+    }
+    // Codex: custom prompts are typed as /prompts:<name>; skills are mentioned as $<name>.
+    add(await commandFiles(path.join(codexHome(), "prompts"), "custom", "prompts:"));
+    add(await skillDirs(path.join(cwd, ".agents", "skills"), "skill", "$"));
+    add(await skillDirs(path.join(cwd, ".codex", "skills"), "skill", "$"));
+    add(await skillDirs(path.join(codexHome(), "skills"), "skill", "$"));
+    add(await skillDirs(path.join(os.homedir(), ".agents", "skills"), "skill", "$"));
+    add(CODEX_BUILTINS.map(([name, description, argsHint]) => ({
+        name,
+        description,
+        source: "builtin",
+        ...(argsHint ? { argsHint } : {}),
+        headless: false,
+    })));
+    return out;
+}
+/** The text typed into the harness for a catalog command. */
+export function commandInvocation(harness, entry, name, args) {
+    const trimmed = args?.trim();
+    const suffix = trimmed ? ` ${trimmed}` : "";
+    if (harness === "codex" && (entry?.source === "skill" || name.startsWith("$"))) {
+        return `${name.startsWith("$") ? name : `$${name}`}${suffix}`;
+    }
+    return `/${name.replace(/^\//, "")}${suffix}`;
+}
+/**
+ * Re-runs discovery when any catalog directory changes (debounced). Node's
+ * recursive watch is unsupported on some platforms; those fall back to a
+ * shallow watch, which still catches new command files and skill folders.
+ */
+export function watchCatalog(harness, cwd, onChange, debounceMs = 500) {
+    const watchers = [];
+    let timer;
+    const trigger = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(onChange, debounceMs);
+        timer.unref?.();
+    };
+    for (const dir of catalogDirs(harness, cwd)) {
+        try {
+            let w;
+            try {
+                w = watch(dir, { recursive: true, persistent: false }, trigger);
+            }
+            catch {
+                w = watch(dir, { persistent: false }, trigger);
+            }
+            w.on("error", () => undefined);
+            watchers.push(w);
+        }
+        catch {
+            /* directory missing or not watchable: nothing to watch */
+        }
+    }
+    return () => {
+        if (timer)
+            clearTimeout(timer);
+        for (const w of watchers)
+            w.close();
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/remote/catalog.js.map

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

package/dist/remote/controller.d.ts

@@ -0,0 +1,76 @@
+import type { Harness } from "../agents/types.js";
+import type { HeadlessTurn } from "./headless.js";
+import { HostClient, type HostClientOptions } from "./host.js";
+import type { HookServer } from "./hooks.js";
+import type { PtySession } from "./pty.js";
+import type { CommandEntry, HarnessName, SessionMode } from "./protocol.js";
+/**
+ * Glue between the host socket and the harness this process runs: turns
+ * arrive from the app, get typed into the harness (TUI) or run as one
+ * headless invocation, and the turn's lifecycle is reported back. One turn at
+ * a time; later turns queue. Answers to a pending harness prompt bypass the
+ * queue, since the running turn is what is waiting for them.
+ */
+export interface RemoteSessionContext {
+    harness: Harness;
+    sessionId: string;
+    cwd: string;
+    mode: SessionMode;
+    baseUrl: string;
+    apiKey: string;
+    log: (line: string) => void;
+    /** Pushes a teleport checkpoint for the session; resolves with the generation. */
+    checkpoint?: (cwd: string) => Promise<number>;
+    /** Milliseconds of screen silence after which a TUI turn counts as finished when no hook fired. */
+    quietFallbackMs?: number;
+    hostOptions?: Partial<HostClientOptions>;
+}
+export declare function harnessName(harness: Harness): HarnessName;
+export declare class RemoteSession {
+    readonly host: HostClient;
+    private readonly ctx;
+    private readonly hooks?;
+    private pty?;
+    private runHeadless?;
+    private readonly queue;
+    private current?;
+    private draining;
+    private stopped;
+    private catalog;
+    private stopWatching?;
+    private pending?;
+    constructor(ctx: RemoteSessionContext, hooks?: HookServer);
+    attachTui(pty: PtySession): void;
+    attachHeadless(run: (prompt: string) => HeadlessTurn): void;
+    /** The catalog last announced (tests and diagnostics). */
+    get commands(): CommandEntry[];
+    /** Connects (best effort), announces the session and its command catalog. Returns whether the backend answered in time. */
+    start(): Promise<boolean>;
+    stop(): void;
+    refreshCatalog(): Promise<void>;
+    private finish;
+    private onTurn;
+    private onInterrupt;
+    private onCheckpoint;
+    private onHook;
+    private turnEnded;
+    private requestQuestion;
+    private requestPrompt;
+    private clearPending;
+    /** `prompt.answer` frame: inject the keystrokes for the pending prompt. */
+    private answerPrompt;
+    /** `turn.deliver {kind: "answer"}`: same as a `prompt.answer`, reported as an instant turn. */
+    private deliverAnswer;
+    private drain;
+    private lookupCommand;
+    /** The text that goes into the harness for a turn, or a reason it cannot run here. */
+    private resolveText;
+    private runTurn;
+    /**
+     * 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.
+     */
+    private quietFallback;
+}