@cargo-ai/cli 1.0.92 → 1.0.95

package/build/commands/ask/harness/usage.js

@@ -0,0 +1,87 @@
+/** Exported for tests. */
+export function createTurnAccumulator() {
+    return {
+        chunks: [],
+        usage: {
+            costUsd: 0,
+            totalTokens: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            cacheReadTokens: 0,
+            cacheWriteTokens: 0,
+            reasoningTokens: 0,
+        },
+    };
+}
+/**
+ * Whether the turn got as far as Anthropic. `costUsd` and `totalTokens` are
+ * reported independently by the harness, so either alone means it did.
+ */
+export function didReachAnthropic(usage) {
+    return usage.costUsd > 0 || usage.totalTokens > 0;
+}
+/**
+ * Add one stream's `finish` totals to the turn. `totalUsage` is the AI SDK
+ * shape; `costUsd` is what Claude Code reports for the same stream under
+ * `harnessMetadata`, and is stored on the ingested message.
+ */
+export function addTurnUsage(usage, part) {
+    const costUsd = readClaudeCodeCostUsd(part);
+    if (costUsd !== undefined) {
+        usage.costUsd += costUsd;
+    }
+    const totalUsage = part["totalUsage"];
+    if (typeof totalUsage !== "object" || totalUsage === null) {
+        return;
+    }
+    const totals = totalUsage;
+    usage.totalTokens += readCount(totals["totalTokens"]);
+    usage.inputTokens += readCount(totals["inputTokens"]);
+    usage.outputTokens += readCount(totals["outputTokens"]);
+    const inputDetails = totals["inputTokenDetails"];
+    if (typeof inputDetails === "object" && inputDetails !== null) {
+        const details = inputDetails;
+        usage.cacheReadTokens += readCount(details["cacheReadTokens"]);
+        usage.cacheWriteTokens += readCount(details["cacheWriteTokens"]);
+    }
+    const outputDetails = totals["outputTokenDetails"];
+    if (typeof outputDetails === "object" && outputDetails !== null) {
+        const details = outputDetails;
+        usage.reasoningTokens += readCount(details["reasoningTokens"]);
+    }
+}
+function readCount(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0
+        ? value
+        : 0;
+}
+/**
+ * What Claude Code says the turn cost, off the `finish` part.
+ *
+ * Two keys, because the value is renamed on its way here: the bridge emits
+ * `harnessMetadata`, and `HarnessAgent` republishes the same object as
+ * `providerMetadata` on the parts this code actually reads. Looking only for
+ * the bridge's name found nothing, so every local turn was ingested at a cost
+ * of zero and priced into no credits at all.
+ *
+ * Exported for tests.
+ */
+export function readClaudeCodeCostUsd(part) {
+    for (const key of ["providerMetadata", "harnessMetadata"]) {
+        const metadata = part[key];
+        if (typeof metadata !== "object" || metadata === null) {
+            continue;
+        }
+        const claudeCode = metadata["claude-code"];
+        if (typeof claudeCode !== "object" || claudeCode === null) {
+            continue;
+        }
+        const costUsd = claudeCode["costUsd"];
+        if (typeof costUsd === "number" &&
+            Number.isFinite(costUsd) &&
+            costUsd > 0) {
+            return costUsd;
+        }
+    }
+    return undefined;
+}

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

@@ -1,5 +1,14 @@
 import type { Command } from "commander";
 import type { Api } from "../../api.js";
+/**
+ * `cargo ask` layout:
+ *
+ * - `index.ts`, `argvFlags.ts`, `rewriteChatFlag.ts` — command and argv
+ * - `session/` — chat loop, tree, turn claim
+ * - `input/` — reading the user (prompt, slash, completion, type-ahead)
+ * - `persist/` — last chat on disk and history preamble
+ * - `harness/` — local Claude Code
+ */
 export type AskOptions = {
     continue?: boolean;
     print?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOxC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,EACjB,IAAI,EAAE,cAAc,GACnB,IAAI,CAwIN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/ask/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOxC;;;;;;;;GAQG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,EACjB,IAAI,EAAE,cAAc,GACnB,IAAI,CAwIN"}

package/build/commands/ask/index.js

@@ -2,17 +2,17 @@ import { resolve } from "node:path";
 import { isInteractive } from "@cargo-ai/cdk/cli";
 import { parseBooleanOption } from "../../utils/booleanOption.js";
 import { ExitCodes, failWith } from "../runHandler.js";
-import { loadAskState } from "./persist.js";
-import { AskInterrupted } from "./prompt.js";
-import { doesChatExist, runAskPrint, runAskSession } from "./session.js";
+import { AskInterrupted } from "./input/index.js";
+import { loadAskState } from "./persist/index.js";
+import { doesChatExist, runAskPrint, runAskSession } from "./session/index.js";
 export function registerAskCommand(program, getApi, deps) {
     program
         .command("ask")
-        .description("Chat in the palette tree. Defaults to Claude Code on this machine; optional --agent-uuid streams as that agent.")
+        .description("Chat in the palette tree. Defaults to Claude Code on this machine; optional --agent-uuid attaches that agent to the same local session.")
         .argument("[message...]", "Question to send as the first message")
         .option("--continue [true|false]", "Reopen the last chat from this machine (defaults to true when passed bare; starts a new chat when there is none)", parseBooleanOption)
         .option("--print [true|false]", "One turn, JSON on stdout (defaults to true when passed bare)", parseBooleanOption)
-        .option("--agent-uuid <uuid>", "Talk to this workspace agent instead of the local Claude Code default")
+        .option("--agent-uuid <uuid>", "Talk to this workspace agent in the local Claude Code session")
         .option("--chat-uuid <uuid>", "Existing chat to continue")
         .option("--dir <path>", "Working directory for the local Claude Code workspace (default: cwd)")
         .addHelpText("after", `
@@ -25,8 +25,8 @@ Examples:
 
 Default Ask is Claude Code on this machine (--dir, default cwd), with no
 agent. --continue reopens the last chat thread but does not reattach an
-agent. Workspace agents are optional via --agent-uuid or /agent (remote
-turns use POST /v1/ai/messages/stream, like the webapp chat).
+agent. Workspace agents are optional via --agent-uuid or /agent; they stay
+in the same local session and the same --dir.
 
 Ask continues the palette tree and streams the reply as it arrives:
   ◇  your message

package/build/commands/ask/input/completer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completer.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/input/completer.ts"],"names":[],"mappings":"AAYA,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,oEAOrB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;AAEhE,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAgBhE;AAED,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAU5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CASnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,GAAG,SAAS,CAY1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAwE1E"}

package/build/commands/ask/input/index.d.ts

@@ -0,0 +1,5 @@
+export { applyCompletion, ASK_COMPLETION_MENU_LIMIT, ASK_SLASH_COMMANDS, type AskCompleter, classifySlashToken, completePath, completeSlash, createAskCompleter, listCompletions, type SlashTokenKind, } from "./completer.js";
+export { AskInterrupted, readAskLine } from "./prompt.js";
+export { ChatSessionAction, parseSlash, type SlashAction, type SlashCard, type SlashResult, } from "./slash.js";
+export { collectTypeAhead, EMPTY_TYPE_AHEAD, type TypeAhead, type TypeAheadCollector, } from "./typeAhead.js";
+//# sourceMappingURL=index.d.ts.map

package/build/commands/ask/input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/input/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,YAAY,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC"}

package/build/commands/ask/input/index.js

@@ -0,0 +1,4 @@
+export { applyCompletion, ASK_COMPLETION_MENU_LIMIT, ASK_SLASH_COMMANDS, classifySlashToken, completePath, completeSlash, createAskCompleter, listCompletions, } from "./completer.js";
+export { AskInterrupted, readAskLine } from "./prompt.js";
+export { ChatSessionAction, parseSlash, } from "./slash.js";
+export { collectTypeAhead, EMPTY_TYPE_AHEAD, } from "./typeAhead.js";

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/input/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;AACX;;;;GAIG;AACH,WAAW,SAAK,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiQ7B"}

package/build/commands/ask/{prompt.js → input/prompt.js}

@@ -1,5 +1,5 @@
 import * as readline from "node:readline";
-import { colors } from "../runHandler.js";
+import { colors } from "../../runHandler.js";
 import { applyCompletion, ASK_COMPLETION_MENU_LIMIT, listCompletions, } from "./completer.js";
 /**
  * Ctrl-C on the Ask line.

package/build/commands/ask/input/slash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/input/slash.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAmBlD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAqDhE;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAE3B,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;CAK1C"}

package/build/commands/ask/{slash.js → input/slash.js}

@@ -5,7 +5,7 @@ const HELP_TEXT = [
     "/help     List these commands",
     "/clear    Start a fresh local session (no agent)",
     "/new      Same as /clear",
-    "/agent    Pick a workspace agent, or Local workspace (default)",
+    "/agent    Pick a workspace agent, or Local workspace (default). Stays on this machine.",
     "/cancel   Explain how to stop a turn (press Ctrl-C while it runs)",
     "/exit     Leave without asking (same as an empty line)",
     "",
@@ -25,7 +25,7 @@ export function parseSlash(text) {
     if (trimmed.startsWith("/") === false) {
         return undefined;
     }
-    // A cookbook handoff launches Ask with `/cargo-cdk` then a multi-line brief.
+    // A cookbook handoff launches Ask with `/cargo-project` then a multi-line brief.
     // Chat commands are a single line (`/help`, `/exit`); anything with a
     // newline is prose for the model, including a skill command the harness
     // expands before the first turn.

package/build/commands/ask/input/typeAhead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeAhead.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/input/typeAhead.ts"],"names":[],"mappings":";AAGA;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAG9B,CAAC;AA4BF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,iDAAiD;IACjD,IAAI,EAAE,MAAM,SAAS,CAAC;CACvB,CAAC;AAgBF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,wEAAwE;IACxE,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,kBAAkB,CAqJrB"}

package/build/commands/ask/{history.d.ts → persist/history.d.ts}

@@ -1,4 +1,4 @@
-import type { Api } from "../../api.js";
+import type { Api } from "../../../api.js";
 /**
  * The earlier turns of a chat, rendered for a Claude Code session that has
  * never seen them.

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/persist/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AA0B3C;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU9B;AAED,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,MAAM,GAAG,SAAS,CA6CpB"}

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

@@ -0,0 +1,4 @@
+export { loadChatHistoryPreamble, renderHistoryPreamble } from "./history.js";
+export { getAskStatePath, loadAskState, saveAskState } from "./persist.js";
+export { asAskState, ASK_STATE_VERSION, type AskState } from "./state.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/persist/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/build/commands/ask/persist/index.js

@@ -0,0 +1,3 @@
+export { loadChatHistoryPreamble, renderHistoryPreamble } from "./history.js";
+export { getAskStatePath, loadAskState, saveAskState } from "./persist.js";
+export { asAskState, ASK_STATE_VERSION } from "./state.js";

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

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/persist/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/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/persist/state.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,OAAO,iBAAiB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CA0B/D"}

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

@@ -0,0 +1,56 @@
+import type { Api } from "../../../api.js";
+/**
+ * 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;
+/**
+ * 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.
+ */
+export 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>;
+/**
+ * Report an API failure the way every other call in the CLI does, and exit.
+ * Never returns: `handleApiCall` exits on a recognised API error, and anything
+ * else is rethrown for the top-level handler.
+ */
+export declare function reportApiFailure(error: unknown): Promise<never>;
+/**
+ * Hand the chat back after a turn.
+ *
+ * Recording the turn already does this, but a turn that spent nothing has
+ * nothing to record — a stall, an expired token, a workspace out of credits —
+ * and the claim would sit there until it expired, telling the next process the
+ * chat was busy.
+ *
+ * Best effort: the TTL is the backstop, and a reply the user has already read
+ * must not fail on the way out.
+ */
+export declare function releaseChatTurn(api: Api, chatUuid: string, ownerId: string): Promise<void>;
+//# sourceMappingURL=claim.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/session/claim.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAU3C;;;;;;;;;;;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;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;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;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CASrE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/build/commands/ask/session/claim.js

@@ -0,0 +1,76 @@
+import { determineIfIsFetcherError } from "@cargo-ai/api";
+import { handleApiCall } from "../../runHandler.js";
+/**
+ * How long before a proxy token's stated expiry to stop trusting it. Covers
+ * the gap between deciding to reuse the harness and the first proxy call the
+ * turn makes.
+ */
+const TOKEN_REFRESH_MARGIN_MS = 5 * 60_000;
+/**
+ * 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 function proxyTokenDeadlineMs(input) {
+    const armedAtMs = input.lastUsedAtMs === undefined ? input.mintedAtMs : input.lastUsedAtMs;
+    return armedAtMs + input.ttlMs - TOKEN_REFRESH_MARGIN_MS;
+}
+/**
+ * Take the chat for one local turn.
+ *
+ * Exported for tests.
+ */
+export async function claimChatTurn(api, chatUuid, ownerId) {
+    try {
+        await api.ai.chat.turn.claim(chatUuid, { ownerId });
+        return { outcome: "claimed" };
+    }
+    catch (error) {
+        if (determineIfIsFetcherError(error) === true &&
+            error.status === 409) {
+            return { outcome: "busy" };
+        }
+        // Handed back rather than reported from here. Reporting an API failure
+        // ends the process, and the interactive session has a Claude Code process
+        // to shut down first — `process.exit` does not run the `finally` that
+        // would have done it.
+        return { outcome: "unavailable", error };
+    }
+}
+/**
+ * Report an API failure the way every other call in the CLI does, and exit.
+ * Never returns: `handleApiCall` exits on a recognised API error, and anything
+ * else is rethrown for the top-level handler.
+ */
+export async function reportApiFailure(error) {
+    await handleApiCall(async () => {
+        throw error;
+    }, { spinner: false });
+    throw error;
+}
+/**
+ * Hand the chat back after a turn.
+ *
+ * Recording the turn already does this, but a turn that spent nothing has
+ * nothing to record — a stall, an expired token, a workspace out of credits —
+ * and the claim would sit there until it expired, telling the next process the
+ * chat was busy.
+ *
+ * Best effort: the TTL is the backstop, and a reply the user has already read
+ * must not fail on the way out.
+ */
+export async function releaseChatTurn(api, chatUuid, ownerId) {
+    try {
+        await api.ai.chat.turn.release(chatUuid, { ownerId });
+    }
+    catch {
+        // Nothing useful to say to the user about this one.
+    }
+}

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

@@ -0,0 +1,5 @@
+export { type ChatTurnClaim, claimChatTurn, proxyTokenDeadlineMs, } from "./claim.js";
+export { type AskSessionOptions, doesChatExist, runAskPrint, runAskSession, } from "./run.js";
+export { ASK_THINKING_WORDS, pickThinkingWord } from "./thinking.js";
+export { displayPath, wrapLine } from "./tree.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,iBAAiB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/build/commands/ask/session/index.js

@@ -0,0 +1,4 @@
+export { claimChatTurn, proxyTokenDeadlineMs, } from "./claim.js";
+export { doesChatExist, runAskPrint, runAskSession, } from "./run.js";
+export { ASK_THINKING_WORDS, pickThinkingWord } from "./thinking.js";
+export { displayPath, wrapLine } from "./tree.js";

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

@@ -0,0 +1,36 @@
+import type { Api } from "../../../api.js";
+export type AskSessionOptions = {
+    api: Api;
+    message?: string;
+    continueChat: boolean;
+    agentUuid?: string;
+    chatUuid?: string;
+    dir: string;
+};
+/**
+ * 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.
+ */
+export declare function doesChatExist(api: Api, chatUuid: string): Promise<boolean>;
+/**
+ * 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>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/commands/ask/session/run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAmD3C,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;AAkHF;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAyND;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,CAulB7B;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,CAqGhB"}