@cargo-ai/cli 1.0.78 → 1.0.81

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

@@ -0,0 +1,20 @@
+export type SlashCard = {
+    kind: "card";
+    text: string;
+};
+export type SlashAction = {
+    kind: "action";
+    action: "exit" | "new" | "clear" | "pick-agent" | "cancel";
+};
+export type SlashResult = SlashCard | SlashAction;
+/**
+ * Parse a user line that starts with `/`. Anything else is prose for the agent.
+ *
+ * Exported for tests; the ask session is the only production caller.
+ */
+export declare function parseSlash(text: string): SlashResult | undefined;
+export declare class ChatSessionAction extends Error {
+    readonly action: SlashAction["action"];
+    constructor(action: SlashAction["action"]);
+}
+//# sourceMappingURL=slash.d.ts.map

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

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

@@ -0,0 +1,73 @@
+import { classifySlashToken } from "./completer.js";
+const HELP_TEXT = [
+    "Chat commands (these never reach the model):",
+    "",
+    "/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)",
+    "/cancel   Explain how to stop a turn (press Ctrl-C while it runs)",
+    "/exit     Leave without asking (same as an empty line)",
+    "",
+    "Ctrl-C stops the turn in flight and brings the prompt back; a chat command",
+    "cannot, because the prompt only reads a line between turns.",
+    "Default Ask is Claude Code on this machine (--dir / cwd), with no agent.",
+    "Slash suggestions and path completion appear as you type. Empty Enter also leaves.",
+    "To run a Cargo CLI command, leave Ask and type /orchestration, … in the palette.",
+].join("\n");
+/**
+ * Parse a user line that starts with `/`. Anything else is prose for the agent.
+ *
+ * Exported for tests; the ask session is the only production caller.
+ */
+export function parseSlash(text) {
+    const trimmed = text.trim();
+    if (trimmed.startsWith("/") === false) {
+        return undefined;
+    }
+    // A cookbook handoff launches Ask with `/cargo-cdk` 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.
+    if (trimmed.includes("\n") === true) {
+        return undefined;
+    }
+    const [firstWord] = trimmed.split(/\s+/);
+    const head = firstWord === undefined ? trimmed : firstWord;
+    // A path the completer offered is prose for the model, not a mistyped
+    // command — answering `/etc/hosts` with "is not a chat command" would
+    // reject its own suggestion. Same classifier as the completer so the two
+    // cannot disagree; `/orchestration` and typos come back "unknown" and still
+    // get the card below.
+    if (classifySlashToken(head) === "path") {
+        return undefined;
+    }
+    const command = head.slice(1).toLowerCase();
+    if (command === "help") {
+        return { kind: "card", text: HELP_TEXT };
+    }
+    if (command === "clear" || command === "new") {
+        return { kind: "action", action: command === "new" ? "new" : "clear" };
+    }
+    if (command === "agent") {
+        return { kind: "action", action: "pick-agent" };
+    }
+    if (command === "cancel") {
+        return { kind: "action", action: "cancel" };
+    }
+    if (command === "exit") {
+        return { kind: "action", action: "exit" };
+    }
+    return {
+        kind: "card",
+        text: `${head} is not a chat command. Run it from the palette as ${head}.`,
+    };
+}
+export class ChatSessionAction extends Error {
+    action;
+    constructor(action) {
+        super(`chat-command:${action}`);
+        this.name = "ChatSessionAction";
+        this.action = action;
+    }
+}

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

@@ -0,0 +1,9 @@
+export declare const ASK_STATE_VERSION = 1;
+export type AskState = {
+    version: typeof ASK_STATE_VERSION;
+    chatUuid: string;
+    agentUuid?: string;
+    updatedAt: string;
+};
+export declare function asAskState(value: unknown): AskState | undefined;
+//# sourceMappingURL=state.d.ts.map

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

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

@@ -0,0 +1,18 @@
+export const ASK_STATE_VERSION = 1;
+export function asAskState(value) {
+    if (value === null || typeof value !== "object") {
+        return undefined;
+    }
+    const { version, chatUuid, agentUuid, updatedAt } = value;
+    if (version !== ASK_STATE_VERSION ||
+        typeof chatUuid !== "string" ||
+        typeof updatedAt !== "string") {
+        return undefined;
+    }
+    return {
+        version: ASK_STATE_VERSION,
+        chatUuid,
+        agentUuid: typeof agentUuid === "string" ? agentUuid : undefined,
+        updatedAt,
+    };
+}

package/build/commands/bookDemo.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from "commander";
+/**
+ * The Cal.com routing form behind "Talk to sales". Same id as
+ * `apps/website/src/components/DemoButton/cal.ts`, so a form swap has to
+ * update both.
+ */
+export declare const SALES_DEMO_FORM_ID = "88911f2a-4d5d-4218-98df-65bcf47bdf8a";
+export declare const SALES_DEMO_URL = "https://cal.com/forms/88911f2a-4d5d-4218-98df-65bcf47bdf8a";
+/**
+ * Prefill is allowed only when we have an address; never a guess.
+ */
+export declare function bookDemoUrl(email: string | undefined): string;
+export declare function registerBookDemoCommand(program: Command): void;
+//# sourceMappingURL=bookDemo.d.ts.map

package/build/commands/bookDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookDemo.d.ts","sourceRoot":"","sources":["../../src/commands/bookDemo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE,eAAO,MAAM,cAAc,+DAAgD,CAAC;AAE5E;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM7D;AAOD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B9D"}

package/build/commands/bookDemo.js

@@ -0,0 +1,100 @@
+import { createApi } from "../api.js";
+import { getConfig } from "../config.js";
+import { openBrowser } from "../utils/openBrowser.js";
+import { colors, info, outputJson } from "./runHandler.js";
+/**
+ * The Cal.com routing form behind "Talk to sales". Same id as
+ * `apps/website/src/components/DemoButton/cal.ts`, so a form swap has to
+ * update both.
+ */
+export const SALES_DEMO_FORM_ID = "88911f2a-4d5d-4218-98df-65bcf47bdf8a";
+export const SALES_DEMO_URL = `https://cal.com/forms/${SALES_DEMO_FORM_ID}`;
+/**
+ * Prefill is allowed only when we have an address; never a guess.
+ */
+export function bookDemoUrl(email) {
+    if (email === undefined) {
+        return SALES_DEMO_URL;
+    }
+    return `${SALES_DEMO_URL}?email=${encodeURIComponent(email)}`;
+}
+export function registerBookDemoCommand(program) {
+    program
+        .command("book-demo")
+        .description("Open the calendar to book a Cargo demo with sales")
+        .option("--email <email>", "Work email to prefill the calendar form; omit to use the signed-in account")
+        .option("--no-open", "Print the URL without launching a browser")
+        .addHelpText("after", `
+Prints the same Cal.com form the website's "Talk to sales" button opens, and
+opens it in a browser when one is available. A person still has to pick a time;
+this command does not create a booking.
+
+This is not the guided product tour. That is \`cargo-ai start --continue demo\`.
+
+When you are signed in, the form is prefilled with your account email unless
+you pass --email.
+
+Examples:
+  $ cargo-ai book-demo
+  $ cargo-ai book-demo --email you@company.com
+  $ cargo-ai book-demo --no-open`)
+        .action(async (opts) => {
+        await runBookDemo(opts);
+    });
+}
+async function runBookDemo(opts) {
+    const email = await resolveEmail(opts.email);
+    const url = bookDemoUrl(email);
+    const opened = opts.open === true;
+    info("");
+    info("To book a demo, open this URL in a browser:");
+    info(`  ${colors.cyan(url)}`);
+    info("");
+    info("A person has to pick a time; this command does not create a booking.");
+    info("");
+    if (opened === true) {
+        openBrowser(url);
+    }
+    outputJson({
+        ok: true,
+        url,
+        opened,
+        email,
+        note: "A person has to pick a time; this command does not create a booking.",
+    });
+}
+async function resolveEmail(flagged) {
+    const fromFlag = normalizeEmail(flagged);
+    if (fromFlag !== undefined) {
+        return fromFlag;
+    }
+    return signedInEmail();
+}
+function normalizeEmail(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed === "") {
+        return undefined;
+    }
+    return trimmed;
+}
+/**
+ * Best-effort prefill from the signed-in account. Booking does not depend on
+ * it, so a missing credential or a failing API call is not an error.
+ */
+async function signedInEmail() {
+    const { baseUrl, getAccessToken, workspaceUuid } = getConfig();
+    if (getAccessToken === undefined) {
+        return undefined;
+    }
+    try {
+        const api = createApi({ baseUrl, getAccessToken, workspaceUuid });
+        const { user } = await api.userManagement.user.getCurrent();
+        return normalizeEmail(user.email);
+    }
+    catch {
+        return undefined;
+    }
+}

package/build/commands/runHandler.d.ts

@@ -47,6 +47,14 @@ type HandleApiCallOpts = {
 };
 export declare function handleApiCall<T>(fn: () => Promise<T>, opts?: HandleApiCallOpts): Promise<T>;
 export declare function sleep(ms: number): Promise<void>;
-export declare function pollUntilFinished<T>(getResult: () => Promise<T>, getFinishedAt: (result: T) => Date | string | null | undefined, intervalMs: number): Promise<T>;
+/**
+ * Poll until the thing reports a `finishedAt`.
+ *
+ * `timeoutMs` is opt-in: a run or batch is allowed to take as long as it
+ * takes, and a caller watching one interactively can see that it is still
+ * going. Pass it where nobody is watching — a non-interactive turn that never
+ * finishes would otherwise wait forever in a pipe or a CI job.
+ */
+export declare function pollUntilFinished<T>(getResult: () => Promise<T>, getFinishedAt: (result: T) => Date | string | null | undefined, intervalMs: number, timeoutMs?: number): Promise<T>;
 export {};
 //# sourceMappingURL=runHandler.d.ts.map

package/build/commands/runHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runHandler.d.ts","sourceRoot":"","sources":["../../src/commands/runHandler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAclE,eAAO,MAAM,MAAM;aACR,MAAM,KAAG,MAAM;eACb,MAAM,KAAG,MAAM;gBACd,MAAM,KAAG,MAAM;cACjB,MAAM,KAAG,MAAM;aAChB,MAAM,KAAG,MAAM;cACd,MAAM,KAAG,MAAM;CAC1B,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM/C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAID,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhE;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,CAgCpE;AAKD,MAAM,MAAM,OAAO,GAAG;IAEpB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAGlC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAIF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBrD;AAkDD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAQhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASxD;AAKD,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,CAAC,CAAC,CAgEZ;AA0ED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9D,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAaZ"}
+{"version":3,"file":"runHandler.d.ts","sourceRoot":"","sources":["../../src/commands/runHandler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAclE,eAAO,MAAM,MAAM;aACR,MAAM,KAAG,MAAM;eACb,MAAM,KAAG,MAAM;gBACd,MAAM,KAAG,MAAM;cACjB,MAAM,KAAG,MAAM;aAChB,MAAM,KAAG,MAAM;cACd,MAAM,KAAG,MAAM;CAC1B,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM/C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAID,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhE;AAED,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,CAgCpE;AAKD,MAAM,MAAM,OAAO,GAAG;IAEpB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAGlC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAIF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBrD;AAkDD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAQhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,CAAC,EAAE,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASxD;AAKD,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,CAAC,CAAC,CAgEZ;AA0ED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9D,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/build/commands/runHandler.js

@@ -290,13 +290,28 @@ function extractApiErrorDetail(body) {
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-export async function pollUntilFinished(getResult, getFinishedAt, intervalMs) {
+/**
+ * Poll until the thing reports a `finishedAt`.
+ *
+ * `timeoutMs` is opt-in: a run or batch is allowed to take as long as it
+ * takes, and a caller watching one interactively can see that it is still
+ * going. Pass it where nobody is watching — a non-interactive turn that never
+ * finishes would otherwise wait forever in a pipe or a CI job.
+ */
+export async function pollUntilFinished(getResult, getFinishedAt, intervalMs, timeoutMs) {
+    const startedAt = Date.now();
     let result = await handleApiCall(getResult, { spinner: false });
     while (true) {
         const finishedAt = getFinishedAt(result);
         if (finishedAt !== null && finishedAt !== undefined) {
             return result;
         }
+        if (timeoutMs !== undefined && Date.now() - startedAt >= timeoutMs) {
+            const waited = timeoutMs >= 120_000
+                ? `${String(Math.round(timeoutMs / 60_000))} minutes`
+                : `${String(Math.max(1, Math.round(timeoutMs / 1000)))}s`;
+            failWith(`Gave up waiting after ${waited}. It had not finished and may still be running.`);
+        }
         await sleep(intervalMs);
         result = await handleApiCall(getResult, { spinner: false });
     }

package/build/index.js

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { availableCodingAgents, BRAND, canRunPalette, cdkProjectDir, cdkProjectRoot, declareSources, fetchCreditsLeft, fetchWorkspaceName, formatWorkspaceSuffix, isInteractive, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
+import { availableCodingAgents, BRAND, canRunPalette, cdkProjectDir, cdkProjectRoot, creditsLeftOf, declareSources, fetchSubscription, fetchWorkspaceName, formatWorkspaceSuffix, isInteractive, isUnpaidPlan, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
 import { Command } from "commander";
 import { AGENT_SKILLS_HINT } from "./agentSkills.js";
 import { createApi } from "./api.js";
 import { registerAiCommands } from "./commands/ai/index.js";
+import { pinAskBooleanFlags } from "./commands/ask/argvFlags.js";
+import { registerAskCommand } from "./commands/ask/index.js";
+import { rewriteChatFlag } from "./commands/ask/rewriteChatFlag.js";
 import { registerAuthCommands } from "./commands/auth/index.js";
 import { registerBillingCommands } from "./commands/billing/index.js";
+import { registerBookDemoCommand } from "./commands/bookDemo.js";
 import { registerConnectionCommands } from "./commands/connection/index.js";
 import { registerContentCommands } from "./commands/content/index.js";
 import { registerContextCommands } from "./commands/context/index.js";
@@ -62,6 +66,15 @@ Authentication:
   Use env variables:  CARGO_API_TOKEN, CARGO_WORKSPACE_UUID, CARGO_BASE_URL
   Check status:       cargo-ai whoami
 
+Ask:
+  cargo-ai ask "…"          Ask in the palette tree, with a first message
+  cargo-ai ask --continue   Continue the last chat
+  cargo-ai ask --print "…"  One turn, JSON on stdout
+  cargo-ai --chat           Open Ask instead of the palette
+
+Talk to sales:
+  cargo-ai book-demo        Open the calendar to book a demo (a person still picks a time)
+
 All commands output JSON to stdout. Status messages, prompts, and errors go to stderr.
 
 Exit codes:
@@ -85,6 +98,8 @@ const SETUP_HEADER_SKIP = [
     "doctor",
     "version",
     "mcp",
+    "ask",
+    "book-demo",
 ];
 /**
  * Say what is wrong before the command runs rather than after it fails, and
@@ -205,14 +220,17 @@ declareSources({
         },
     ],
 });
+const argv = pinAskBooleanFlags(rewriteChatFlag(process.argv));
 const binPath = process.argv[1] === undefined ? "cargo-ai" : process.argv[1];
 // First, so it is the first row of the palette: for someone signed in, this is
 // the shortest path to a briefed coding agent, and it was previously reachable
 // only by knowing the name of a command that sounds like a one-time thing.
 registerStartCommand(program, getApi, { binPath, openPalette });
+registerAskCommand(program, getApi, { openPalette });
 registerAuthCommands(program, getApi);
 registerVersionCommand(program, version);
 registerDoctorCommand(program, version);
+registerBookDemoCommand(program);
 registerObservabilityCommands(program, getApi);
 registerOrchestrationCommands(program, getApi);
 registerWorkspaceManagementCommands(program, getApi);
@@ -236,7 +254,7 @@ registerCdkCommands(program
 // Bare `cargo-ai` in a terminal opens the palette instead of printing the help
 // wall: twenty command groups is a list to navigate, not one to read. Anything
 // non-interactive (a pipe, CI, an agent) keeps the help it has always had.
-const bare = process.argv.slice(2).length === 0 && canRunPalette();
+const bare = argv.slice(2).length === 0 && canRunPalette();
 // ...except for someone who has never signed in, for whom that palette is
 // twenty groups that all exit 3. They get the entrance instead, once.
 const entrance = bare === true &&
@@ -246,13 +264,13 @@ const entrance = bare === true &&
         ranBefore: loadStartState() !== undefined,
     });
 const start = bare === false
-    ? program.parseAsync()
+    ? program.parseAsync(argv)
     : entrance === true
         ? runStart(getApi, { binPath, openPalette }, {})
         : openPalette();
 async function openPalette(startPath) {
-    const [title, latestVersion] = await Promise.all([
-        paletteTitle(),
+    const [chrome, latestVersion] = await Promise.all([
+        paletteChrome(),
         maybeRefreshUpdateCache(),
     ]);
     // Probed once: this shells out to `which` per candidate agent, and nobody
@@ -262,7 +280,7 @@ async function openPalette(startPath) {
     // Re-read after each command: signing in or out from inside the palette
     // changes both what the setup line says and which rows are worth pinning.
     // The cwd is re-tested too — a command can create a project in it.
-    const rebuildLayout = () => {
+    const layoutFor = (unpaidPlan) => {
         // Read once: a layout describing two different directories could offer to
         // deploy one and name the other.
         const cwd = process.cwd();
@@ -277,36 +295,56 @@ async function openPalette(startPath) {
             // undefined, and `deploy` would fall back to the root it must not use.
             cdkProjectDir: root === undefined ? undefined : cdkProjectDir(root),
             cwd,
+            unpaidPlan,
         });
     };
     await runPalette({
         program,
         binPath,
         startPath,
-        title,
+        title: chrome.title,
         issues: collectIssues(),
         refreshIssues: collectIssues,
-        layout: rebuildLayout(),
-        refreshLayout: rebuildLayout,
+        // First paint reuses the subscription already fetched for the title.
+        layout: layoutFor(chrome.unpaidPlan),
+        // After a command the plan can change (sign-in, upgrade); look it up again.
+        refreshLayout: async () => layoutFor(await resolveUnpaidPlan()),
     });
 }
 /**
- * `🧱 cargo-ai 1.0.66 · Acme · 9,657.48 credits`. The two lookups behind the
- * second half are the same best-effort, time-boxed ones `cargo-cdk` uses, so a
- * bare invocation still opens promptly when the network does not answer — and
- * they are skipped entirely when there is no credential to make them with.
+ * `🧱 cargo-ai 1.0.66 · Acme · 9,657.48 credits`, plus whether the workspace
+ * is unpaid so the first palette paint can pin Book a demo without a second
+ * billing round-trip. Skipped entirely when there is no credential.
  */
-async function paletteTitle() {
+async function paletteChrome() {
     const base = `${BRAND} cargo-ai ${version}`;
     if (isSignedIn() === false) {
-        return base;
+        return { title: base, unpaidPlan: false };
     }
     const api = getApi();
-    const [name, creditsLeft] = await Promise.all([
+    const [name, subscription] = await Promise.all([
         fetchWorkspaceName(api),
-        fetchCreditsLeft(api),
+        fetchSubscription(api),
     ]);
-    return `${base}${formatWorkspaceSuffix(name, creditsLeft)}`;
+    const creditsLeft = subscription === undefined ? undefined : creditsLeftOf(subscription);
+    return {
+        title: `${base}${formatWorkspaceSuffix(name, creditsLeft)}`,
+        unpaidPlan: subscription === undefined ? false : isUnpaidPlan(subscription),
+    };
+}
+/**
+ * Best-effort: true only when we can see an Orb $0 plan. A failed lookup or a
+ * signed-out session leaves the pin off rather than guessing.
+ */
+async function resolveUnpaidPlan() {
+    if (isSignedIn() === false) {
+        return false;
+    }
+    const subscription = await fetchSubscription(getApi());
+    if (subscription === undefined) {
+        return false;
+    }
+    return isUnpaidPlan(subscription);
 }
 start
     .then(() => maybeRefreshUpdateCache())

package/build/paletteLayout.d.ts

@@ -1,4 +1,4 @@
-import type { CodingAgent, PaletteLayout, PinnedRow } from "@cargo-ai/cdk/cli";
+import { type CodingAgent, type PaletteLayout, type PinnedRow } from "@cargo-ai/cdk/cli";
 export type PaletteLayoutInput = {
     signedIn: boolean;
     agents: readonly CodingAgent[];
@@ -20,6 +20,11 @@ export type PaletteLayoutInput = {
      * on screen or one somewhere above it.
      */
     cwd: string;
+    /**
+     * Pin "Book a demo" when the workspace is unpaid (Orb + $0 plan). Omit or
+     * false leaves it in the last section only.
+     */
+    unpaidPlan?: boolean;
 };
 export declare function buildPaletteLayout(input: PaletteLayoutInput): PaletteLayout;
 /**

package/build/paletteLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAwE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA4CjE"}
+{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AA8E3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAS3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CA+DjE"}

package/build/paletteLayout.js

@@ -8,18 +8,22 @@
 // down behind `start`. This is the missing opinion, kept in one place and as
 // data, so it can be read and tested rather than inferred from a menu.
 import { basename, relative, resolve } from "node:path";
+import { ASK, } from "@cargo-ai/cdk/cli";
 /** Pinned row values. The leading space keeps them out of the command namespace. */
 const SIGN_IN = " sign-in";
 const DEMO = " demo";
 const CODE = " code";
 const ADD = " add";
 const DEPLOY = " deploy";
+const BOOK_DEMO = " book-demo";
 /**
  * `start` runs most of these; the pinned row is the shortcut to one of them.
  * The exceptions are "Add" and "Deploy", which run `cdk add` and `cdk deploy`
  * directly: neither is a `start` destination, because neither needs the sign-in
  * step nor a choice of where to carry on — you are already in the project. Bare
- * `cdk add` asks connector vs cookbook, then shows that kind's list.
+ * `cdk add` asks connector vs cookbook, then shows that kind's list. "Book a
+ * demo" is the other exception: it is only pinned on an unpaid plan, and runs
+ * `book-demo` itself.
  */
 const ENTRANCE = "start";
 /**
@@ -28,16 +32,19 @@ const ENTRANCE = "start";
  * opening a menu is looking for.
  *
  * `start` is hidden because its destinations are pinned above: a row that
- * opens a menu of rows already on screen is a detour. `version` is
- * `--version`, and `doctor` reports it anyway.
+ * opens a menu of rows already on screen is a detour. `ask` is the same kind
+ * of entrance — pinned as "Ask Cargo" — so drawing it again in the tree is a
+ * second door to the same room. `version` is `--version`, and `doctor`
+ * reports it anyway. `book-demo` is hidden only when it is pinned (see
+ * `buildPaletteLayout`); otherwise it stays in the last section.
  */
-const HIDDEN = [ENTRANCE, "version"];
+const HIDDEN = [ENTRANCE, "ask", "version"];
 /**
  * The sections, in reading order: everything the workspace is made of, then
  * the workspace as code on its own, then the machine you are sitting at —
- * which ends beside `/exit`, since leaving and checking your setup are the
- * same kind of errand. What people reach for most is not here at all; those
- * are the pinned rows, above the first section.
+ * which ends beside `/exit`, since leaving, checking your setup, and talking
+ * to sales are the same kind of errand. What people reach for most is not
+ * here at all; those are the pinned rows, above the first section.
  *
  * Anything a release adds and nobody lists here still appears, in tree order,
  * in a final section — a new command is never invisible by omission. So a new
@@ -72,13 +79,15 @@ const SECTIONS = [
     // The workspace as code sits on its own: it is the same resources again,
     // declared in a repo rather than run from here.
     ["cdk"],
-    ["doctor", "whoami", "login", "logout"],
+    ["doctor", "whoami", "login", "logout", "book-demo"],
 ];
 export function buildPaletteLayout(input) {
+    const pinBookDemo = input.signedIn === true && input.unpaidPlan === true;
     return {
         pinned: pinnedRows(input),
-        hide: HIDDEN,
+        hide: pinBookDemo === true ? [...HIDDEN, "book-demo"] : HIDDEN,
         sections: SECTIONS,
+        placeholder: "type to filter, or ask a question",
     };
 }
 /**
@@ -119,7 +128,23 @@ export function pinnedRows(input) {
                 argv: [ENTRANCE, "--continue", "code"],
             },
         ];
+    const bookDemoRow = input.unpaidPlan === true
+        ? [
+            {
+                value: BOOK_DEMO,
+                label: "Book a demo",
+                hint: "talk to sales",
+                argv: ["book-demo"],
+            },
+        ]
+        : [];
     return [
+        {
+            value: ASK,
+            label: "Ask Cargo",
+            hint: "describe what you want, in plain English",
+            argv: ["ask"],
+        },
         ...input.agents.map((agent) => ({
             value: ` agent:${agent.bin}`,
             label: `Open ${agent.label}`,
@@ -127,6 +152,7 @@ export function pinnedRows(input) {
             argv: [ENTRANCE, "--continue", agent.bin],
         })),
         ...projectRows,
+        ...bookDemoRow,
     ];
 }
 /** The two rows for a palette standing in the CDK project rooted at `root`. */

package/build/utils/cdkState.d.ts

@@ -5,15 +5,28 @@ export declare function resolveDefaultExport(mod: {
  * Load a `.ts`/`.js` module through the tsx ESM loader (so `.ts` sources and
  * their imports of `@cargo-ai/*` / `zod` are transpiled on the fly) and return
  * its resolved default export. Shared by both `--file` loaders: the workflow
- * loader validates the result as a compiled workflow; the agent loader reads the
- * agent back out of the CDK registry that loading populated (so it must
- * `resetRegistry()` BEFORE calling this). `subject` labels the file in errors
- * (e.g. "Workflow", "Agent").
+ * loader validates the result as a compiled workflow; the agent loader reads
+ * the exported handle to learn which agent the file declares, then loads the
+ * whole project for the nodes. `subject` labels the file in errors (e.g.
+ * "Workflow", "Agent").
  */
 export declare function importModuleDefault(file: string, subject: string): Promise<{
     absPath: string;
     defaultExport: unknown;
 }>;
+/**
+ * The CDK project directory a `--file` module belongs to — the directory `cdk
+ * plan` and `cdk deploy` run in, which is what a harness agent's inferred
+ * `rootDirectory` is measured from. Walk up to the repo, then back down to the
+ * project (`infra/` in a scaffolded repo); a file in no recognisable project
+ * answers its own directory.
+ *
+ * Deliberately NOT the nearest cargo.state.json. That file's position is
+ * incidental — a repo deployed before `cdk deploy` ran from the project has one
+ * at the repo root — so measuring from it would report no `rootDirectory` and
+ * clone the repo root, while the deployed agent clones `infra/`.
+ */
+export declare function cdkProjectDirFor(file: string): string;
 /**
  * Deep-resolve every `@cargo-ai/cdk` handle token in `value` to its real uuid
  * using the nearest cargo.state.json (searched from `file`'s directory upward,

package/build/utils/cdkState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdkState.d.ts","sourceRoot":"","sources":["../../src/utils/cdkState.ts"],"names":[],"mappings":"AAmBA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CASxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBtD;AAaD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAuCT"}
+{"version":3,"file":"cdkState.d.ts","sourceRoot":"","sources":["../../src/utils/cdkState.ts"],"names":[],"mappings":"AAoBA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CASxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD;AAaD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAuCT"}