@cargo-ai/cli 1.0.78 → 1.0.80

package/build/commands/ask/messageStream.d.ts

@@ -0,0 +1,33 @@
+export type StreamMessageInput = {
+    baseUrl: string;
+    getAccessToken: (forceRefresh?: boolean) => Promise<string | undefined>;
+    workspaceUuid: string | undefined;
+    chatUuid: string;
+    messageUuid: string;
+    parts: {
+        type: "text";
+        text: string;
+    }[];
+    agentUuid?: string;
+    /**
+     * Fired with the assistant message's uuid as soon as the server announces
+     * it, so a caller that stops reading can still cancel the message.
+     */
+    onAssistantMessageUuid?: (messageUuid: string) => void;
+    /**
+     * Stops reading the stream. The message keeps running server-side, so a
+     * caller that aborts should also cancel it by uuid — otherwise the next
+     * question in that chat is refused with `lastMessageNotFinished`.
+     */
+    abortSignal?: AbortSignal;
+};
+/**
+ * POST /v1/ai/messages/stream and yield assistant text deltas.
+ *
+ * The typed API client always buffers JSON, so Ask talks to the SSE endpoint
+ * directly — same contract as the web app's DefaultChatTransport.
+ */
+export declare function streamMessageTextDeltas(input: StreamMessageInput): AsyncGenerator<string>;
+/** Exported for tests — turns an error JSON body into a short message. */
+export declare function describeStreamFailure(status: number, body: string): string;
+//# sourceMappingURL=messageStream.d.ts.map

package/build/commands/ask/messageStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageStream.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/messageStream.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxE,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAuB,uBAAuB,CAC5C,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAAC,MAAM,CAAC,CA8FxB;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoC1E"}

package/build/commands/ask/messageStream.js

@@ -0,0 +1,114 @@
+import { parseJsonEventStream, uiMessageChunkSchema } from "ai";
+import { getProxyFetch } from "../../proxy.js";
+/**
+ * POST /v1/ai/messages/stream and yield assistant text deltas.
+ *
+ * The typed API client always buffers JSON, so Ask talks to the SSE endpoint
+ * directly — same contract as the web app's DefaultChatTransport.
+ */
+export async function* streamMessageTextDeltas(input) {
+    const token = await input.getAccessToken();
+    if (token === undefined) {
+        throw new Error("Not authenticated.");
+    }
+    const url = `${input.baseUrl.replace(/\/$/, "")}/v1/ai/messages/stream`;
+    const proxyFetch = getProxyFetch(url);
+    const fetchFn = proxyFetch !== undefined ? proxyFetch : globalThis.fetch;
+    const headers = {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+        Accept: "text/event-stream",
+        "x-cargo-origin": "cli",
+    };
+    if (input.workspaceUuid !== undefined) {
+        headers["selected-workspace-uuid"] = input.workspaceUuid;
+    }
+    const body = {
+        chatUuid: input.chatUuid,
+        chatTrigger: { type: "app" },
+        uuid: input.messageUuid,
+        parts: input.parts,
+    };
+    if (input.agentUuid !== undefined) {
+        body["agentUuid"] = input.agentUuid;
+    }
+    const response = await fetchFn(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        signal: input.abortSignal,
+    });
+    if (response.ok === false) {
+        const text = await response.text();
+        throw new Error(describeStreamFailure(response.status, text));
+    }
+    if (response.body === null) {
+        throw new Error("Message stream returned no body.");
+    }
+    const parsed = parseJsonEventStream({
+        stream: response.body,
+        schema: uiMessageChunkSchema,
+    });
+    const reader = parsed.getReader();
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done === true) {
+                break;
+            }
+            if (value.success === false) {
+                continue;
+            }
+            const chunk = value.value;
+            if (chunk.type === "start" && typeof chunk.messageId === "string") {
+                if (input.onAssistantMessageUuid !== undefined) {
+                    input.onAssistantMessageUuid(chunk.messageId);
+                }
+                continue;
+            }
+            if (chunk.type === "text-delta" && typeof chunk.delta === "string") {
+                yield chunk.delta;
+                continue;
+            }
+            if (chunk.type === "error") {
+                const message = typeof chunk.errorText === "string"
+                    ? chunk.errorText
+                    : "Message stream failed.";
+                throw new Error(message);
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/** Exported for tests — turns an error JSON body into a short message. */
+export function describeStreamFailure(status, body) {
+    try {
+        const parsed = JSON.parse(body);
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            "error" in parsed &&
+            typeof parsed.error === "object" &&
+            parsed.error !== null) {
+            const error = parsed.error;
+            const description = typeof error["description"] === "string"
+                ? error["description"]
+                : undefined;
+            const code = typeof error["code"] === "string" ? error["code"] : undefined;
+            if (description !== undefined) {
+                return description;
+            }
+            if (code !== undefined) {
+                return `Message stream failed (${String(status)}): ${code}`;
+            }
+        }
+    }
+    catch {
+        // Fall through to the raw body.
+    }
+    if (body.length > 0) {
+        return `Message stream failed (${String(status)}): ${body}`;
+    }
+    return `Message stream failed (${String(status)}).`;
+}

package/build/commands/ask/persist.d.ts

@@ -0,0 +1,5 @@
+import { type AskState } from "./state.js";
+export declare function getAskStatePath(): string;
+export declare function loadAskState(): AskState | undefined;
+export declare function saveAskState(state: AskState): boolean;
+//# sourceMappingURL=persist.d.ts.map

package/build/commands/ask/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/persist.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,YAAY,IAAI,QAAQ,GAAG,SAAS,CAYnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAUrD"}

package/build/commands/ask/persist.js

@@ -0,0 +1,31 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getConfigDir } from "@cargo-ai/cdk/cli";
+import { asAskState } from "./state.js";
+export function getAskStatePath() {
+    return join(getConfigDir(), "ask.json");
+}
+export function loadAskState() {
+    const path = getAskStatePath();
+    if (existsSync(path) === false) {
+        return undefined;
+    }
+    try {
+        return asAskState(JSON.parse(readFileSync(path, "utf-8")));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function saveAskState(state) {
+    try {
+        mkdirSync(getConfigDir(), { recursive: true });
+        writeFileSync(getAskStatePath(), `${JSON.stringify(state, null, 2)}\n`, {
+            mode: 0o600,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/build/commands/ask/pnpmShim.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Claude Code's harness bootstrap always runs `pnpm install` under
+ * `.harness-bootstrap/claude-code/`. The recipe needs pnpm 10 (workspace
+ * `allowBuilds`) and must not hit a broken Volta shim or an older pnpm that
+ * refuses this npm-configured monorepo.
+ *
+ * Exported for tests.
+ */
+export declare const HARNESS_PNPM_PACKAGE = "pnpm@10";
+/** Directory holding the `pnpm` shim used for local Ask harness bootstrap. */
+export declare function getHarnessPnpmShimDir(): string;
+/**
+ * Write (or refresh) an executable `pnpm` that delegates to
+ * `npm exec --package=pnpm@10`, then prepend that directory to `process.env.PATH`
+ * so sandbox bootstrap and later commands see it first.
+ */
+export declare function ensureHarnessPnpmOnPath(): string;
+/** Body of the shim script. Exported for tests. */
+export declare function harnessPnpmShimScript(): string;
+//# sourceMappingURL=pnpmShim.d.ts.map

package/build/commands/ask/pnpmShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpmShim.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/pnpmShim.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,8EAA8E;AAC9E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAchD;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C"}

package/build/commands/ask/pnpmShim.js

@@ -0,0 +1,39 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { delimiter, join } from "node:path";
+import { getConfigDir } from "@cargo-ai/cdk/cli";
+/**
+ * Claude Code's harness bootstrap always runs `pnpm install` under
+ * `.harness-bootstrap/claude-code/`. The recipe needs pnpm 10 (workspace
+ * `allowBuilds`) and must not hit a broken Volta shim or an older pnpm that
+ * refuses this npm-configured monorepo.
+ *
+ * Exported for tests.
+ */
+export const HARNESS_PNPM_PACKAGE = "pnpm@10";
+/** Directory holding the `pnpm` shim used for local Ask harness bootstrap. */
+export function getHarnessPnpmShimDir() {
+    return join(getConfigDir(), "ask-shims");
+}
+/**
+ * Write (or refresh) an executable `pnpm` that delegates to
+ * `npm exec --package=pnpm@10`, then prepend that directory to `process.env.PATH`
+ * so sandbox bootstrap and later commands see it first.
+ */
+export function ensureHarnessPnpmOnPath() {
+    const dir = getHarnessPnpmShimDir();
+    mkdirSync(dir, { recursive: true });
+    const shimPath = join(dir, "pnpm");
+    writeFileSync(shimPath, harnessPnpmShimScript(), { mode: 0o755 });
+    const current = process.env["PATH"];
+    process.env["PATH"] =
+        current === undefined || current === ""
+            ? dir
+            : `${dir}${delimiter}${current}`;
+    return dir;
+}
+/** Body of the shim script. Exported for tests. */
+export function harnessPnpmShimScript() {
+    return `#!/bin/sh
+exec npm exec --yes --package=${HARNESS_PNPM_PACKAGE} -- pnpm "$@"
+`;
+}

package/build/commands/ask/prompt.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Ctrl-C on the Ask line.
+ *
+ * Raised rather than exiting on the spot so the chat session unwinds through
+ * its `finally` and destroys the local harness first. The command turns it
+ * back into exit code 130.
+ */
+export declare class AskInterrupted extends Error {
+    constructor();
+}
+/**
+ * Interactive Ask line: `◆  …` with a live suggestion menu under the rail
+ * while the line matches a slash command or a path-like token.
+ *
+ * Enter submits (accepting the highlighted suggestion when the menu is open).
+ * Empty Enter leaves. Tab inserts the highlight without submitting.
+ */
+export declare function readAskLine(input: NodeJS.ReadableStream, cwd: string): Promise<string | undefined>;
+//# sourceMappingURL=prompt.d.ts.map

package/build/commands/ask/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/prompt.ts"],"names":[],"mappings":";AAiBA;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,KAAK;;CAKxC;AASD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,CAAC,cAAc,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiQ7B"}

package/build/commands/ask/prompt.js

@@ -0,0 +1,228 @@
+import * as readline from "node:readline";
+import { colors } from "../runHandler.js";
+import { applyCompletion, ASK_COMPLETION_MENU_LIMIT, listCompletions, } from "./completer.js";
+/**
+ * Ctrl-C on the Ask line.
+ *
+ * Raised rather than exiting on the spot so the chat session unwinds through
+ * its `finally` and destroys the local harness first. The command turns it
+ * back into exit code 130.
+ */
+export class AskInterrupted extends Error {
+    constructor() {
+        super("ask-interrupted");
+        this.name = "AskInterrupted";
+    }
+}
+function isTTYStream(stream) {
+    return (typeof stream.setRawMode === "function" &&
+        stream.isTTY === true);
+}
+/**
+ * Interactive Ask line: `◆  …` with a live suggestion menu under the rail
+ * while the line matches a slash command or a path-like token.
+ *
+ * Enter submits (accepting the highlighted suggestion when the menu is open).
+ * Empty Enter leaves. Tab inserts the highlight without submitting.
+ */
+export async function readAskLine(input, cwd) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        let line = "";
+        let cursor = 0;
+        let selected = 0;
+        let painted = false;
+        let finished = false;
+        const wasRaw = isTTYStream(input) ? input.isRaw === true : false;
+        if (isTTYStream(input) === true) {
+            input.setRawMode(true);
+        }
+        // A prompt shown mid-turn — the clack select behind a tool approval — closes
+        // its readline interface on the way out, and `Interface.close()` pauses the
+        // stream it was reading. An explicitly paused stream does not start flowing
+        // again just because a listener is added, so without this the Ask line
+        // paints after such a turn and then ignores every keystroke.
+        input.resume();
+        readline.emitKeypressEvents(input);
+        const onKeypress = (str, key) => {
+            if (finished === true) {
+                return;
+            }
+            if (key.ctrl === true && key.name === "c") {
+                // Raw mode turns Ctrl-C into an ordinary keypress rather than a
+                // process-group SIGINT, so nothing else tears the harness down.
+                // Exiting here would skip the session's `finally` and leave Claude
+                // Code and its bridge running — the orphan this branch exists to fix.
+                // Unwind instead and let the caller exit once cleanup has run.
+                fail(new AskInterrupted());
+                return;
+            }
+            if (key.ctrl === true && key.name === "d") {
+                if (line === "") {
+                    finish(undefined);
+                }
+                return;
+            }
+            if (key.name === "return" || key.name === "enter") {
+                const matches = visibleMatches();
+                if (matches.length > 0) {
+                    const pick = matches[selected];
+                    if (pick !== undefined) {
+                        line = applyCompletion(line, pick);
+                        cursor = line.length;
+                    }
+                }
+                const trimmed = line.trim();
+                finish(trimmed === "" ? undefined : trimmed);
+                return;
+            }
+            if (key.name === "tab") {
+                const matches = visibleMatches();
+                if (matches.length === 0) {
+                    return;
+                }
+                const pick = matches[selected];
+                if (pick === undefined) {
+                    return;
+                }
+                line = applyCompletion(line, pick);
+                cursor = line.length;
+                selected = 0;
+                paint();
+                return;
+            }
+            if (key.name === "up") {
+                const matches = visibleMatches();
+                if (matches.length === 0) {
+                    return;
+                }
+                selected = selected <= 0 ? matches.length - 1 : selected - 1;
+                paint();
+                return;
+            }
+            if (key.name === "down") {
+                const matches = visibleMatches();
+                if (matches.length === 0) {
+                    return;
+                }
+                selected = selected >= matches.length - 1 ? 0 : selected + 1;
+                paint();
+                return;
+            }
+            if (key.name === "left") {
+                if (cursor > 0) {
+                    cursor -= 1;
+                    paint();
+                }
+                return;
+            }
+            if (key.name === "right") {
+                if (cursor < line.length) {
+                    cursor += 1;
+                    paint();
+                }
+                return;
+            }
+            if (key.name === "backspace") {
+                if (cursor === 0) {
+                    return;
+                }
+                line = `${line.slice(0, cursor - 1)}${line.slice(cursor)}`;
+                cursor -= 1;
+                selected = 0;
+                paint();
+                return;
+            }
+            if (key.name === "delete") {
+                if (cursor >= line.length) {
+                    return;
+                }
+                line = `${line.slice(0, cursor)}${line.slice(cursor + 1)}`;
+                selected = 0;
+                paint();
+                return;
+            }
+            if (str === undefined || str.length === 0) {
+                return;
+            }
+            if (key.ctrl === true || key.meta === true) {
+                return;
+            }
+            const code = str.codePointAt(0);
+            if (code === undefined || code < 32 || code === 127) {
+                return;
+            }
+            line = `${line.slice(0, cursor)}${str}${line.slice(cursor)}`;
+            cursor += str.length;
+            selected = 0;
+            paint();
+        };
+        input.on("keypress", onKeypress);
+        paint();
+        function visibleMatches() {
+            return listCompletions(line, cwd).slice(0, ASK_COMPLETION_MENU_LIMIT);
+        }
+        function clearFrame() {
+            if (painted === false || process.stderr.isTTY !== true) {
+                return;
+            }
+            // Cursor sits on the ◆ line; wipe from there through the menu below.
+            process.stderr.write("\r\x1B[J");
+            painted = false;
+        }
+        function paint() {
+            const matches = visibleMatches();
+            if (selected >= matches.length) {
+                selected = matches.length === 0 ? 0 : matches.length - 1;
+            }
+            clearFrame();
+            process.stderr.write(`${colors.cyan("◆")}  ${line}`);
+            if (matches.length > 0) {
+                process.stderr.write("\n");
+                for (let index = 0; index < matches.length; index += 1) {
+                    const hit = matches[index];
+                    if (hit === undefined) {
+                        continue;
+                    }
+                    const active = index === selected;
+                    const bullet = active === true ? colors.cyan("●") : colors.dim("○");
+                    const label = active === true ? colors.cyan(hit) : colors.dim(hit);
+                    process.stderr.write(`${colors.dim("│")}  ${bullet} ${label}`);
+                    if (index < matches.length - 1) {
+                        process.stderr.write("\n");
+                    }
+                }
+                // Return to the ◆ line so the next clearFrame / keystroke is correct.
+                process.stderr.write(`\x1B[${String(matches.length)}A`);
+            }
+            // Column after `◆  ` (3 visible cells) plus the cursor in the line.
+            const column = 3 + cursor + 1;
+            process.stderr.write(`\r\x1B[${String(column)}G`);
+            painted = true;
+        }
+        function cleanup() {
+            input.off("keypress", onKeypress);
+            if (isTTYStream(input) === true) {
+                input.setRawMode(wasRaw);
+            }
+        }
+        function finish(value) {
+            if (finished === true) {
+                return;
+            }
+            finished = true;
+            clearFrame();
+            cleanup();
+            resolvePromise(value);
+        }
+        function fail(error) {
+            if (finished === true) {
+                return;
+            }
+            finished = true;
+            clearFrame();
+            cleanup();
+            process.stderr.write("\n");
+            rejectPromise(error);
+        }
+    });
+}

package/build/commands/ask/rewriteChatFlag.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `cargo-ai --chat` is an entrance to `ask`, not a commander flag that a
+ * subcommand could collide with. Rewrite it away before parse so `ask` owns
+ * the rest of the argv.
+ *
+ * Exported for tests; `index.ts` is the only production caller.
+ */
+export declare function rewriteChatFlag(argv: readonly string[]): string[];
+//# sourceMappingURL=rewriteChatFlag.d.ts.map

package/build/commands/ask/rewriteChatFlag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriteChatFlag.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/rewriteChatFlag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CA0BjE"}

package/build/commands/ask/rewriteChatFlag.js

@@ -0,0 +1,26 @@
+/**
+ * `cargo-ai --chat` is an entrance to `ask`, not a commander flag that a
+ * subcommand could collide with. Rewrite it away before parse so `ask` owns
+ * the rest of the argv.
+ *
+ * Exported for tests; `index.ts` is the only production caller.
+ */
+export function rewriteChatFlag(argv) {
+    const prefix = argv.slice(0, 2);
+    const rest = argv.slice(2);
+    const chatIndex = rest.indexOf("--chat");
+    if (chatIndex === -1) {
+        return [...argv];
+    }
+    const firstCommand = rest.findIndex((arg) => arg.startsWith("-") === false);
+    if (firstCommand !== -1 &&
+        firstCommand < chatIndex &&
+        rest[firstCommand] !== "ask") {
+        return [...argv];
+    }
+    const without = rest.filter((arg) => arg !== "--chat");
+    if (without[0] === "ask") {
+        return [...prefix, ...without];
+    }
+    return [...prefix, "ask", ...without];
+}

package/build/commands/ask/session.d.ts

@@ -0,0 +1,94 @@
+import type { Ai } from "@cargo-ai/api";
+import type { Api } from "../../api.js";
+export type AskSessionOptions = {
+    api: Api;
+    message?: string;
+    continueChat: boolean;
+    agentUuid?: string;
+    chatUuid?: string;
+    dir: string;
+};
+type SessionMode = {
+    kind: "remote";
+} | {
+    kind: "local";
+};
+/**
+ * When the proxy token baked into the running harness stops being safe to
+ * reuse.
+ *
+ * The server re-arms the token on every proxy call, so the clock runs from
+ * the last turn that reached Anthropic rather than from when it was minted.
+ * Anchoring it to mint time instead would tear down a conversation that is
+ * still going — a cold start, a replayed history preamble and the loss of
+ * Claude Code's in-session memory, for a token that had not expired.
+ *
+ * Exported for tests.
+ */
+export declare function proxyTokenDeadlineMs(input: {
+    mintedAtMs: number;
+    lastUsedAtMs: number | undefined;
+    ttlMs: number;
+}): number;
+/**
+ * No agent → local Claude Code on the host. Any agent streams remotely, like
+ * the webapp chat: what it runs — a tool loop or a harness against its bound
+ * repo — follows from its deployed release, which the API resolves itself.
+ *
+ * Exported for tests.
+ */
+export declare function modeForAgent(agent: Ai.Agent | undefined): SessionMode;
+/**
+ * True when the chat is already on the server. A saved `--continue` uuid can
+ * point at nothing (Esc before the first turn, wiped local DB, different API),
+ * and that must become a create — not chatNotFound on the first message.
+ *
+ * Careful with the false case: it means "not readable", which covers a chat
+ * that was deleted as well as one that never existed. Deletion is soft, so
+ * the row keeps the uuid and creating it again fails on the primary key —
+ * see where `--continue` resolves its uuid.
+ */
+/**
+ * The result of trying to take the chat for one local turn. `busy` is an
+ * answer rather than a failure — another session is mid-turn — so it does not
+ * end the session the way a transport error does.
+ */
+type ChatTurnClaim = {
+    outcome: "claimed";
+} | {
+    outcome: "busy";
+} | {
+    outcome: "unavailable";
+    error: unknown;
+};
+/**
+ * Take the chat for one local turn.
+ *
+ * Exported for tests.
+ */
+export declare function claimChatTurn(api: Api, chatUuid: string, ownerId: string): Promise<ChatTurnClaim>;
+export declare function doesChatExist(api: Api, chatUuid: string): Promise<boolean>;
+/**
+ * A path inside the session directory reads better relative to it; anything
+ * outside stays absolute so it is obvious the turn left the project.
+ *
+ * Exported for tests.
+ */
+export declare function displayPath(path: string, dir: string): string;
+/**
+ * Same tree grammar as the palette:
+ *   ◇  <your message>
+ *   🧱  reply…
+ *   ◆
+ * Empty Enter or /exit leaves to the parent palette.
+ */
+export declare function runAskSession(options: AskSessionOptions): Promise<"palette" | "exit">;
+export declare function runAskPrint(input: {
+    api: Api;
+    message: string;
+    agentUuid?: string;
+    chatUuid?: string;
+    dir: string;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/build/commands/ask/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AA0BxC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAoB1D;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAKT;AAiBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,SAAS,GAAG,WAAW,CAErE;AA8ED;;;;;;;;;GASG;AACH;;;;GAIG;AACH,KAAK,aAAa,GACd;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,GACtB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/C;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC,CAkBxB;AAyCD,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAsSD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAkGD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,CA0b7B;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE;IACvC,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,IAAI,CAAC,CA8HhB"}