@hortus/cli 0.0.0-stage → 1.0.0

package/dist/api.d.ts

@@ -0,0 +1,53 @@
+import type { Plugin, SessionState } from "@hortus/core";
+import { type ComponentType } from "react";
+import type { UiState } from "./cli.ts";
+import type { Command } from "./commands.ts";
+export type { SessionState } from "@hortus/core";
+export { useShallow } from "zustand/react/shallow";
+export type { Cli, UiState } from "./cli.ts";
+export type { Candidate, Command } from "./commands.ts";
+export { theme, usageLine } from "./entry.ts";
+/** UI parts a plugin can replace. */
+export interface Slots {
+    statusBar: ComponentType;
+}
+/** Default export of a plugin whose hortus.json depends on "@hortus/cli". */
+export interface CliPlugin extends Plugin {
+    /** each slot override gets the implementation it replaces as `Default`: the built-in one or an earlier plugin's */
+    cli?: {
+        [K in keyof Slots]?: ComponentType<{
+            Default: Slots[K];
+        }>;
+    } & {
+        /** added to the `/` menu; one named like an earlier command (built-in or plugin) replaces it */
+        commands?: Command[];
+    };
+}
+export declare const CliContext: import("react").Context<{
+    ui: import("zustand").StoreApi<UiState>;
+    agent: {
+        providers: Record<string, import("@hortus/core").ProviderDef>;
+        plugins: Plugin[];
+        resolve: (opts?: Pick<import("@hortus/core").RunOptions, "model" | "provider">) => Promise<{
+            name: string;
+            model: string;
+            provider: import("@hortus/core").Provider;
+        }>;
+        listModels: () => Promise<{
+            provider: string;
+            id: string;
+        }[]>;
+        run: (history: import("@hortus/core").Message[], opts?: import("@hortus/core").RunOptions) => Promise<void>;
+    };
+    readonly session: import("@hortus/core").Session;
+    commands: Command[];
+    submit: (value: string) => boolean;
+    abort: () => void | undefined;
+    setCopied: (chars: number) => void;
+    report: (text: string) => void;
+    setSession: (session: import("@hortus/core").Session) => void;
+} | undefined>;
+/** Selectors must return primitives or existing references, or go through useShallow (zustand loops on a fresh object). */
+export declare const useSession: <T>(selector: (s: SessionState) => T) => T;
+export declare const useUi: <T>(selector: (s: UiState) => T) => T;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,KAAK,aAAa,EAA6B,MAAM,OAAO,CAAC;AAEtE,OAAO,KAAK,EAAO,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9C,qCAAqC;AACrC,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,6EAA6E;AAC7E,MAAM,WAAW,SAAU,SAAQ,MAAM;IACvC,mHAAmH;IACnH,GAAG,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC;YAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;SAAE,CAAC;KAAE,GAAG;QACpE,gGAAgG;QAChG,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;KACtB,CAAC;CACH;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;cAA4C,CAAC;AAQpE,2HAA2H;AAC3H,eAAO,MAAM,UAAU,GAAI,CAAC,YAAY,CAAC,CAAC,EAAE,YAAY,KAAK,CAAC,KAAG,CAI9D,CAAC;AACJ,eAAO,MAAM,KAAK,GAAI,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,KAAG,CAAoC,CAAC"}

package/dist/api.js

@@ -0,0 +1,15 @@
+import { createContext, useContext } from "react";
+import { useStore } from "zustand";
+export { useShallow } from "zustand/react/shallow";
+export { theme, usageLine } from "./entry.js";
+export const CliContext = createContext(undefined);
+function useCli() {
+    const cli = useContext(CliContext);
+    if (!cli)
+        throw new Error("hortus's hooks only work inside its TUI");
+    return cli;
+}
+/** Selectors must return primitives or existing references, or go through useShallow (zustand loops on a fresh object). */
+export const useSession = (selector) => useStore(useUi((s) => s.session), selector);
+export const useUi = (selector) => useStore(useCli().ui, selector);
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKnC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgB9C,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAkB,SAAS,CAAC,CAAC;AAEpE,SAAS,MAAM;IACb,MAAM,GAAG,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2HAA2H;AAC3H,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,QAAgC,EAAK,EAAE,CACnE,QAAQ,CACN,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EACvB,QAAQ,CACT,CAAC;AACJ,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,QAA2B,EAAK,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC"}

package/dist/app.d.ts

@@ -0,0 +1,9 @@
+import { type CliPlugin, type Slots } from "./api.ts";
+import type { Cli } from "./cli.ts";
+/** Built-in slots, each wrapped by every plugin's override in load order (later plugins end up outermost). */
+export declare function composeSlots(plugins: CliPlugin[], onError: (text: string) => void): Slots;
+/** The TUI; plugins' `cli` overrides are composed once into the slots it renders. */
+export declare function App({ cli }: {
+    cli: Cli;
+}): import("react").JSX.Element;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,KAAK,EAAS,MAAM,UAAU,CAAC;AACzE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAgDpC,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,KAAK,CAgBzF;AAED,qFAAqF;AACrF,wBAAgB,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,+BAOxC"}

package/dist/app.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useApp, useBoxMetrics, useInput, useWindowSize } from "ink";
+import { Component, useMemo, useRef, useState } from "react";
+import { CliContext, useUi } from "./api.js";
+import { CommandMenu, useCommandMenu } from "./command-menu.js";
+import { theme } from "./entry.js";
+import { PromptInput } from "./prompt-input.js";
+import { StatusBar } from "./status-bar.js";
+import { Transcript } from "./transcript.js";
+/** Clips children to its own height. `fromBottom` = rows scrolled up from the end, so 0 follows new content. */
+function ScrollBox({ fromBottom, children, ...props }) {
+    const view = useRef(null);
+    const content = useRef(null);
+    const max = Math.max(0, useBoxMetrics(content).height - useBoxMetrics(view).height);
+    return (_jsx(Box, { ref: view, overflow: "hidden", flexDirection: "column", 
+        // size from the parent, not from the (taller/wider) content
+        flexBasis: 0, contentOffsetY: max - Math.min(fromBottom, max), ...props, children: _jsx(Box, { ref: content, flexShrink: 0, flexDirection: "column", width: "100%", children: children }) }));
+}
+const clamp = (n) => Math.max(0, Math.min(n, 10_000));
+const INPUT_ROWS = 8;
+/** A throwing plugin component falls back to the one it replaced instead of taking the whole TUI down. */
+class Guard extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError = () => ({ failed: true });
+    componentDidCatch(e) {
+        this.props.onError(e);
+    }
+    render() {
+        const Fallback = this.props.fallback;
+        return this.state.failed ? _jsx(Fallback, {}) : this.props.children;
+    }
+}
+/** Built-in slots, each wrapped by every plugin's override in load order (later plugins end up outermost). */
+export function composeSlots(plugins, onError) {
+    const slots = { statusBar: StatusBar };
+    for (const { cli } of plugins)
+        for (const k of Object.keys(slots)) {
+            const Override = cli?.[k];
+            if (!Override)
+                continue;
+            const Default = slots[k];
+            const fail = (e) => onError(`${k} plugin failed, showing the one it replaced: ${e instanceof Error ? e.message : String(e)}`);
+            slots[k] = () => (_jsx(Guard, { fallback: Default, onError: fail, children: _jsx(Override, { Default: Default }) }));
+        }
+    return slots;
+}
+/** The TUI; plugins' `cli` overrides are composed once into the slots it renders. */
+export function App({ cli }) {
+    const slots = useMemo(() => composeSlots(cli.agent.plugins, cli.report), [cli]);
+    return (_jsx(CliContext, { value: cli, children: _jsx(Layout, { cli: cli, slots: slots }) }));
+}
+function Layout({ cli, slots }) {
+    const entries = useUi((s) => s.entries);
+    const live = useUi((s) => s.live);
+    const busy = useUi((s) => s.busy);
+    const path = useUi((s) => s.session.path);
+    const [input, setInput] = useState("");
+    const menu = useCommandMenu(cli, input, setInput);
+    // rows the input is scrolled up from its end; clamped on read by ScrollBox, so overshoot just sticks at the top
+    const [inScroll, setInScroll] = useState(0);
+    const { rows } = useWindowSize();
+    const { exit } = useApp();
+    useInput((input, key) => {
+        if (key.ctrl && input === "d")
+            exit();
+        else if (key.ctrl && input === "c") {
+            setInput("");
+            setInScroll(0);
+        }
+        else if (key.escape && menu.shown)
+            menu.hide();
+        else if (key.escape)
+            cli.abort();
+    });
+    const submit = (value) => {
+        if (!cli.submit(value))
+            return;
+        setInput("");
+        setInScroll(0);
+    };
+    // stable across keystrokes, so Transcript doesn't re-wrap the whole history on every key
+    const shown = useMemo(() => [
+        ...entries,
+        ...(live.thinking ? [{ id: -2, kind: "thinking", text: live.thinking }] : []),
+        ...(live.text ? [{ id: -1, kind: "assistant", text: live.text }] : []),
+    ], [entries, live]);
+    return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsx(Transcript
+            // another session (/new) starts unscrolled, with nothing selected
+            , { entries: shown, onWheelBelow: (delta) => setInScroll((n) => clamp(n + delta)), onCopy: cli.setCopied }, path), _jsxs(Box, { flexShrink: 0, marginTop: 1, borderStyle: "round", borderColor: busy ? theme.borderIdle : theme.border, paddingX: 1, children: [_jsx(Text, { color: theme.accent, children: "> " }), _jsx(ScrollBox, { flexGrow: 1, maxHeight: INPUT_ROWS, fromBottom: inScroll, children: _jsx(PromptInput, { value: input, onChange: setInput, onSubmit: submit, onKey: menu.onKey, 
+                            // scroll just enough to keep the caret's row in view
+                            onCaretRow: (row) => setInScroll((n) => Math.min(row, Math.max(n, row - INPUT_ROWS + 1))) }) })] }), menu.shown && _jsx(CommandMenu, { rows: menu.rows, at: menu.at }), _jsx(slots.statusBar, {})] }));
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,66 @@
+import type { Agent, Message, Plugin, Session } from "@hortus/core";
+import { type Command } from "./commands.ts";
+import { type Entry } from "./entry.ts";
+/** What the TUI shows; written only by `createCli`, read through `useUi`. */
+export interface UiState {
+    /** the session shown and run on; swapped by `setSession` (e.g. /new) */
+    session: Session;
+    entries: Entry[];
+    /** streamed thinking and text not yet turned into entries */
+    live: {
+        thinking: string;
+        text: string;
+    };
+    /** messages of the running turn; appended to the session when the run ends */
+    turn: Message[];
+    busy: boolean;
+    /** provider name and model the next run would use, plus the context window when the API reports it */
+    status?: {
+        name: string;
+        model: string;
+        window?: number;
+    };
+    /** chars of the last copy, shown until the next submit */
+    copied?: number;
+}
+/** Transcript entries for messages already in the session, so a resumed one shows as it was left. */
+export declare function replay(messages: Message[]): Entry[];
+/**
+ * The TUI's logic, without React: runs the agent on `session` or a `/name arg` command, turns its events into
+ * transcript entries and keeps `status` in step with the session's model and provider. `makeAgent` creates the agent
+ * with the run observer it's given.
+ */
+export declare function createCli(session: Session, makeAgent: (observer: Plugin) => Promise<Agent>): Promise<{
+    ui: import("zustand/vanilla").StoreApi<UiState>;
+    agent: {
+        providers: Record<string, import("@hortus/core").ProviderDef>;
+        plugins: Plugin[];
+        resolve: (opts?: Pick<import("@hortus/core").RunOptions, "model" | "provider">) => Promise<{
+            name: string;
+            model: string;
+            provider: import("@hortus/core").Provider;
+        }>;
+        listModels: () => Promise<{
+            provider: string;
+            id: string;
+        }[]>;
+        run: (history: Message[], opts?: import("@hortus/core").RunOptions) => Promise<void>;
+    };
+    /** the session shown, `ui`'s `session` */
+    readonly session: Session;
+    /** the built-ins and every plugin's `cli.commands`, one per name */
+    commands: Command[];
+    /**
+     * starts `value` as a command or the next turn; false (the prompt keeps its input) when blank, still running or an
+     * unknown command
+     */
+    submit: (value: string) => boolean;
+    abort: () => void | undefined;
+    setCopied: (chars: number) => void;
+    /** adds an error entry to the transcript */
+    report: (text: string) => void;
+    /** shows `session` in place of the current one: the transcript restarts from its messages, and runs go to it */
+    setSession: (session: Session) => void;
+}>;
+export type Cli = Awaited<ReturnType<typeof createCli>>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AAG9E,OAAO,EAAmB,KAAK,OAAO,EAA6B,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,KAAK,KAAK,EAAqB,MAAM,YAAY,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,6DAA6D;IAC7D,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,8EAA8E;IAC9E,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,sGAAsG;IACtG,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qGAAqG;AACrG,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAenD;AAsBD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;IAsJ7F,0CAA0C;;IAI1C,oEAAoE;;IAEpE;;;OAGG;oBACa,MAAM;;uBAaH,MAAM;IACzB,4CAA4C;mBAC7B,MAAM;IACrB,gHAAgH;0BAC1F,OAAO;GAOhC;AAED,MAAM,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC"}

package/dist/cli.js

@@ -0,0 +1,235 @@
+import { createStore } from "zustand/vanilla";
+import { builtinCommands, findCommand, parseCommand } from "./commands.js";
+import { entry, formatTool } from "./entry.js";
+/** Transcript entries for messages already in the session, so a resumed one shows as it was left. */
+export function replay(messages) {
+    const out = [];
+    const calls = new Map();
+    for (const m of messages) {
+        if (m.role === "user")
+            out.push(entry("user", `\n${m.content}\n`));
+        else if (m.role === "assistant") {
+            if (m.text)
+                out.push(entry("assistant", m.text));
+            for (const c of m.toolCalls)
+                calls.set(c.id, c);
+        }
+        else
+            for (const r of m.results) {
+                const c = calls.get(r.id);
+                if (c)
+                    out.push(entry(r.isError ? "toolError" : "toolOk", formatTool(c, r)));
+            }
+    }
+    return out;
+}
+/** UI state for showing `session` from its start: its file and settings, then its messages so far. */
+function show(session) {
+    const { messages, model, provider } = session.getState();
+    return {
+        session,
+        entries: [
+            entry("info", `Session: ${session.path} (${messages.length} messages)${provider ? ` · provider: ${provider}` : ""}${model ? ` · model: ${model}` : ""}`),
+            ...replay(messages),
+        ],
+        live: { thinking: "", text: "" },
+        turn: [],
+        copied: undefined,
+    };
+}
+const errorText = (e) => (e instanceof Error ? e.message : String(e));
+/**
+ * The TUI's logic, without React: runs the agent on `session` or a `/name arg` command, turns its events into
+ * transcript entries and keeps `status` in step with the session's model and provider. `makeAgent` creates the agent
+ * with the run observer it's given.
+ */
+export async function createCli(session, makeAgent) {
+    const ui = createStore()(() => ({ ...show(session), busy: false }));
+    const push = (...e) => ui.setState((s) => ({ entries: [...s.entries, ...e] }));
+    // Deltas reach `live` at most once a frame: every store change renders synchronously (useSyncExternalStore), and a
+    // fast stream of back-to-back sync renders trips React's nested-update limit while Ink's useBoxMetrics has updates
+    // pending.
+    let pending = { thinking: "", text: "" };
+    let timer;
+    const take = () => {
+        clearTimeout(timer);
+        timer = undefined;
+        const p = pending;
+        pending = { thinking: "", text: "" };
+        return p;
+    };
+    const stream = (key, delta) => {
+        pending[key] += delta;
+        timer ??= setTimeout(() => {
+            const p = take();
+            ui.setState(({ live }) => ({ live: { thinking: live.thinking + p.thinking, text: live.text + p.text } }));
+        }, 1000 / 30);
+    };
+    // streamed-but-unfinished thinking and text become entries, then the live view resets
+    const flush = () => {
+        const p = take();
+        ui.setState(({ entries, live }) => {
+            const thinking = live.thinking + p.thinking;
+            const text = live.text + p.text;
+            return {
+                entries: [
+                    ...entries,
+                    ...(thinking ? [entry("thinking", thinking)] : []),
+                    ...(text ? [entry("assistant", text)] : []),
+                ],
+                live: { thinking: "", text: "" },
+            };
+        });
+    };
+    // pending tool blocks by call id, replaced by their result block when it arrives
+    const calls = new Map();
+    const agent = await makeAgent({
+        on: {
+            thinking: (delta) => stream("thinking", delta),
+            text: (delta) => stream("text", delta),
+            tool_call: (call) => {
+                const e = entry("tool", formatTool(call));
+                calls.set(call.id, { call, entry: e });
+                push(e);
+            },
+            message: (message) => {
+                if (message.role === "tool") {
+                    const done = new Map();
+                    for (const r of message.results) {
+                        const c = calls.get(r.id);
+                        if (!c)
+                            continue;
+                        done.set(c.entry, { ...c.entry, kind: r.isError ? "toolError" : "toolOk", text: formatTool(c.call, r) });
+                        calls.delete(r.id);
+                    }
+                    ui.setState((s) => ({ entries: s.entries.map((e) => done.get(e) ?? e) }));
+                }
+                // an assistant message closes the streamed thinking and text
+                flush();
+                ui.setState((s) => ({ turn: [...s.turn, message] }));
+            },
+        },
+    });
+    // later plugins win, so a command can be replaced by name (like tools)
+    const commands = [
+        ...new Map([...builtinCommands, ...agent.plugins.flatMap((p) => p.cli?.commands ?? [])].map((c) => [
+            c.name,
+            c,
+        ])).values(),
+    ];
+    // re-resolved whenever the session, or its model or provider, changes
+    let seq = 0;
+    async function refreshStatus() {
+        const n = ++seq;
+        const { model, provider } = ui.getState().session.getState();
+        try {
+            const r = await agent.resolve({ model, provider });
+            // a newer change won; don't overwrite it with a stale result
+            if (n !== seq)
+                return;
+            ui.setState({ status: { name: r.name, model: r.model } });
+            const window = await r.provider.contextWindow?.(r.model).catch(() => undefined);
+            if (n === seq)
+                ui.setState({ status: { name: r.name, model: r.model, window } });
+        }
+        catch {
+            if (n === seq)
+                ui.setState({ status: undefined });
+        }
+    }
+    const watch = (session) => session.subscribe((s, prev) => {
+        if (s.model !== prev.model || s.provider !== prev.provider)
+            void refreshStatus();
+    });
+    let unwatch = watch(session);
+    ui.subscribe((s, prev) => {
+        if (s.session === prev.session)
+            return;
+        unwatch();
+        unwatch = watch(s.session);
+        void refreshStatus();
+    });
+    void refreshStatus();
+    let aborter;
+    async function run(value) {
+        const { session } = ui.getState();
+        const turn = [{ role: "user", content: value }];
+        // blank rows pad the message's background, as pi does
+        ui.setState((s) => ({ busy: true, turn, entries: [...s.entries, entry("user", `\n${value}\n`)] }));
+        const abort = new AbortController();
+        aborter = abort;
+        try {
+            const { messages, model, provider } = session.getState();
+            await agent.run([...messages, ...turn], { model, provider, signal: abort.signal }).catch((e) => {
+                if (!abort.signal.aborted)
+                    throw e;
+            });
+            if (abort.signal.aborted) {
+                // the partial reply stays on screen but not in history; completed messages are kept
+                flush();
+                // error entries get no separator row, so the leading newline adds one; the next turn adds the one below
+                push(entry("error", "\nInterrupted"));
+            }
+            // the turn moves into session.messages in one tick, so the usage line never counts it twice
+            const saved = session.append(ui.getState().turn);
+            ui.setState({ turn: [] });
+            await saved;
+        }
+        catch (e) {
+            flush();
+            push(entry("error", errorText(e)));
+        }
+        ui.setState({ busy: false });
+    }
+    // not busy meanwhile, so a command can start a turn with `submit`
+    async function command(c, arg) {
+        try {
+            const text = await c.run(arg, cli);
+            if (text)
+                push(entry("info", text));
+        }
+        catch (e) {
+            push(entry("error", errorText(e)));
+        }
+    }
+    const cli = {
+        ui,
+        agent,
+        /** the session shown, `ui`'s `session` */
+        get session() {
+            return ui.getState().session;
+        },
+        /** the built-ins and every plugin's `cli.commands`, one per name */
+        commands,
+        /**
+         * starts `value` as a command or the next turn; false (the prompt keeps its input) when blank, still running or an
+         * unknown command
+         */
+        submit: (value) => {
+            if (!value.trim() || ui.getState().busy)
+                return false;
+            const cmd = parseCommand(value.trim());
+            const c = cmd && findCommand(commands, cmd.name);
+            if (cmd && !c) {
+                push(entry("error", `Unknown command: /${cmd.name}`));
+                return false;
+            }
+            ui.setState({ copied: undefined });
+            (c ? command(c, cmd?.arg ?? "") : run(value)).catch((e) => push(entry("error", errorText(e))));
+            return true;
+        },
+        abort: () => aborter?.abort(),
+        setCopied: (chars) => ui.setState({ copied: chars }),
+        /** adds an error entry to the transcript */
+        report: (text) => push(entry("error", text)),
+        /** shows `session` in place of the current one: the transcript restarts from its messages, and runs go to it */
+        setSession: (session) => {
+            // the running turn would end up split between the two
+            if (ui.getState().busy)
+                throw new Error("Can't switch sessions while a turn is running");
+            ui.setState(show(session));
+        },
+    };
+    return cli;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/command-menu.d.ts

@@ -0,0 +1,33 @@
+import { type Key } from "ink";
+import type { Cli } from "./cli.ts";
+import { type Candidate, type Command } from "./commands.ts";
+/** One row of the `/` menu, and the input once it's chosen. */
+export interface Suggestion {
+    label: string;
+    /** dim text after the label */
+    description?: string;
+    value: string;
+}
+/**
+ * The `/` menu's rows for `input`: commands while the name is typed, then the command's candidates from `loaded` for
+ * its argument; undefined while those are still loading.
+ */
+export declare function suggest(commands: Command[], input: string, loaded: Map<Command, Candidate[]>): Suggestion[] | undefined;
+/**
+ * The `/` menu for the prompt's `input`. `onKey` takes the prompt's ↑/↓ (select), Tab (put the selected row into the
+ * input) and Enter (the same, unless the input already is it or nothing has loaded yet: then it submits) while the menu
+ * shows; `hide` is Esc.
+ */
+export declare function useCommandMenu(cli: Cli, input: string, setInput: (value: string) => void): {
+    rows: Suggestion[] | undefined;
+    at: number;
+    shown: boolean;
+    hide: () => void;
+    onKey: (_: string, key: Key) => boolean;
+};
+/** `rows` under the prompt, at most five, scrolled to keep the selected (accent) one in view; undefined = loading. */
+export declare function CommandMenu({ rows, at }: {
+    rows: Suggestion[] | undefined;
+    at: number;
+}): import("react").JSX.Element;
+//# sourceMappingURL=command-menu.d.ts.map

package/dist/command-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-menu.d.ts","sourceRoot":"","sources":["../src/command-menu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAQ,MAAM,KAAK,CAAC;AAG1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAA6B,MAAM,eAAe,CAAC;AAGxF,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAgBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,4BAmC5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;;;;;eAkDrE,MAAM,OAAO,GAAG;EAYnC;AAID,sHAAsH;AACtH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;IAAE,IAAI,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,+BA2BvF"}