@cursor/july 0.1.2 → 0.1.3

package/dist/internal/cli-cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-cursor.d.ts","sourceRoot":"","sources":["../../src/internal/cli-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+FzE;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAWjD;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC1E"}
+{"version":3,"file":"cli-cursor.d.ts","sourceRoot":"","sources":["../../src/internal/cli-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0BH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuGzE;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAWjD;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC1E"}

package/dist/internal/cli-cursor.js

@@ -16,16 +16,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { spawn } from "node:child_process";
 import { hostname } from "node:os";
-import { join } from "node:path";
 import { CursorBackendClient, CursorBackendError, createUserApiKeyWithSessionToken, revokeMintedUserApiKey, } from "./cursor/backend-client.js";
 import { clearStoredCredentials, credentialsFilePath, cursorBackendUrl, pollForLoginTokens, readStoredCredentials, resolveApiKey, SIGN_IN_HINT, startBrowserLogin, writeStoredCredentials, } from "./cursor/credentials.js";
 import { CLI_COMMAND_NAME } from "./distribution.js";
+import { openBrowser } from "./open-browser.js";
+import { stderrPalette, stdoutPalette } from "./terminal-style.js";
 export function cmdLogin(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const backendUrl = cursorBackendUrl();
+        const err = stderrPalette();
+        const out = stdoutPalette();
         let apiKey;
         // Set only on the browser-mint path; carries what the revoke-on-failure
         // cleanup needs (the session token that minted the key + its label).
@@ -36,7 +38,7 @@ export function cmdLogin(options) {
         }
         else {
             const { loginUrl, uuid, verifier } = startBrowserLogin();
-            process.stderr.write(`Opening your browser to sign in to Cursor…\n\n  ${loginUrl}\n\n(waiting for the browser sign-in to complete)\n`);
+            process.stderr.write(err.dim(`Opening your browser to sign in to Cursor…\n\n  ${loginUrl}\n\n(waiting for the browser sign-in to complete)\n`));
             openBrowser(loginUrl);
             const login = yield pollForLoginTokens({
                 uuid,
@@ -68,7 +70,7 @@ export function cmdLogin(options) {
                 throw error;
             }
             minted = { keyName, sessionToken: login.accessToken };
-            process.stderr.write(`Minted the "${keyName}" API key.\n`);
+            process.stderr.write(err.dim(`Minted the "${keyName}" API key.\n`));
         }
         // Revoke the just-minted key when a later step fails, so a botched login
         // never leaves an orphaned live credential (no-op on the headless path).
@@ -101,9 +103,9 @@ export function cmdLogin(options) {
             process.stderr.write(`Could not store credentials at ${credentialsFilePath()}: ${describeError(error)}\n`);
             return 1;
         }
-        process.stdout.write(`Signed in as ${formatIdentity(identity)} (${backendUrl})\nCredentials stored at ${credentialsFilePath()}\n`);
+        process.stdout.write(`Signed in as ${formatIdentity(identity)} (${backendUrl})\n${out.dim(`Credentials stored at ${credentialsFilePath()}`)}\n`);
         if (process.env.CURSOR_API_KEY !== undefined) {
-            process.stderr.write("note: CURSOR_API_KEY is set in this shell and takes precedence over the stored login.\n");
+            process.stderr.write(err.dim("note: CURSOR_API_KEY is set in this shell and takes precedence over the stored login.\n"));
         }
         return 0;
     });
@@ -192,36 +194,6 @@ function describeLoginPollFailure(result) {
             ].join("\n");
     }
 }
-/** Best-effort browser open; the URL is always printed as the fallback. */
-function openBrowser(url) {
-    var _a;
-    const command = process.platform === "darwin"
-        ? { cmd: "open", args: [url] }
-        : process.platform === "win32"
-            ? {
-                cmd: join((_a = process.env.SYSTEMROOT) !== null && _a !== void 0 ? _a : "C:\\Windows", "System32", "WindowsPowerShell", "v1.0", "powershell.exe"),
-                args: [
-                    "-NoProfile",
-                    "-NonInteractive",
-                    "-WindowStyle",
-                    "Hidden",
-                    "-Command",
-                    `Start-Process '${url.replace(/'/g, "''")}'`,
-                ],
-            }
-            : { cmd: "xdg-open", args: [url] };
-    try {
-        const child = spawn(command.cmd, command.args, {
-            stdio: "ignore",
-            detached: true,
-        });
-        child.on("error", () => { });
-        child.unref();
-    }
-    catch (_b) {
-        // The printed URL is the fallback.
-    }
-}
 function describeError(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/dist/internal/cli-deploy.d.ts

@@ -8,19 +8,45 @@
  * `hosting` manifest block), call the management API through
  * `deploy-client.ts`, poll status, and render.
  */
+import { AgentServeDeployClient } from "./deploy-client.js";
+import { type GitRunner } from "./deploy-source.js";
+import { type ChildAgentDir } from "./discovery.js";
+/** One agent directory selected for deploy (single or multi-agent parent). */
+export type DeployTarget = ChildAgentDir;
+/**
+ * Interactive / test seam: pick which agents under a multi-agent parent to
+ * deploy. Return `null` to cancel.
+ */
+export type ChooseDeployTargets = (agents: readonly DeployTarget[]) => Promise<DeployTarget[] | null>;
 export interface DeployCliOptions {
     dir?: string;
     slug?: string;
+    /**
+     * deploy `--all`: when `--dir` is a multi-agent parent, deploy every
+     * child agent (skips the interactive picker).
+     */
+    all?: boolean;
     /** `--team <id>`; resolved from the account when omitted. */
     team?: string;
     json?: boolean;
     noWait?: boolean;
     apiKey?: string;
-    /** deploy `--repo <url>`: https git repo the control plane builds from. */
+    /**
+     * deploy `--repo <url>`: https git repo the control plane builds from.
+     * Optional — inferred from `git remote origin` when omitted inside an
+     * agent project checkout.
+     */
     repo?: string;
-    /** deploy `--ref <ref>`: git ref (defaults to the default branch server-side). */
+    /**
+     * deploy `--ref <ref>`: git ref to build. Optional — inferred from the
+     * current branch (or HEAD SHA if detached) when omitted; otherwise the
+     * server uses the repo's default branch.
+     */
     ref?: string;
-    /** deploy `--path <agentPath>`: agent directory relative to the repo root. */
+    /**
+     * deploy `--path <agentPath>`: agent directory relative to the repo root.
+     * Optional — inferred from `--dir` vs the git toplevel when omitted.
+     */
     path?: string;
     /** deploy `--cursor-events-repo <owner/name>` (repeatable). */
     cursorEventsRepos?: string[];
@@ -28,6 +54,10 @@ export interface DeployCliOptions {
     allowDomains?: string[];
     /** Test seams. */
     fetchImpl?: typeof fetch;
+    /** Inject git probing for deploy source inference (tests). */
+    git?: GitRunner;
+    /** Inject the multi-agent picker (tests / non-interactive hosts). */
+    chooseTargets?: ChooseDeployTargets;
     pollIntervalMs?: number;
     timeoutMs?: number;
     out?: (text: string) => void;
@@ -40,7 +70,33 @@ export type SecretInputStream = NodeJS.ReadableStream & {
     isTTY?: boolean;
     setRawMode?: (mode: boolean) => void;
 };
+export interface ResolveDeployAuthOptions {
+    team?: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    /** Quiet team-resolution chatter (default: write to stderr). */
+    err?: (text: string) => void;
+}
+export interface ResolvedDeployAuth {
+    client: AgentServeDeployClient;
+    teamId: number;
+}
+/**
+ * Credentials → deploy client → team id. Shared by deploy commands and
+ * `--prod` AX routing. Returns an exit code (error already rendered) on
+ * failure.
+ */
+export declare function resolveDeployAuth(options: ResolveDeployAuthOptions): Promise<ResolvedDeployAuth | number>;
 export declare function cmdDeploy(options: DeployCliOptions): Promise<number>;
+/**
+ * TTY picker for multi-agent parents. Non-interactive callers get `[]`
+ * so {@link resolveDeployTargets} can print the --slug/--all hint.
+ */
+export declare function promptChooseDeployTargets(agents: readonly DeployTarget[], options: {
+    err: (text: string) => void;
+    stdin: SecretInputStream;
+    interactive: boolean;
+}): Promise<DeployTarget[] | null>;
 export declare function cmdDeployments(options: DeployCliOptions): Promise<number>;
 export declare function cmdDeploymentStatus(slug: string | undefined, options: DeployCliOptions): Promise<number>;
 export declare function cmdStop(slug: string | undefined, options: DeployCliOptions): Promise<number>;

package/dist/internal/cli-deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-deploy.d.ts","sourceRoot":"","sources":["../../src/internal/cli-deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,cAAc,GAAG;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC,CAAC;AA8FF,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmI1E;AA6CD,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAMD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAyEjB;AAMD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAMD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAMD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAMD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAgEjB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CA4BjB"}
+{"version":3,"file":"cli-deploy.d.ts","sourceRoot":"","sources":["../../src/internal/cli-deploy.ts"],"names":[],"mappings":"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"}

package/dist/internal/cli-deploy.js

@@ -19,30 +19,37 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { basename, resolve } from "node:path";
 import { CursorBackendClient } from "./cursor/backend-client.js";
-import { cursorBackendUrl, resolveApiKey, SIGN_IN_HINT, } from "./cursor/credentials.js";
+import { cursorExternalApiUrl, resolveApiKey, SIGN_IN_HINT, } from "./cursor/credentials.js";
 import { AgentServeDeployClient, DeployApiError, slugFromDirectoryName, TERMINAL_DEPLOY_STATUSES, validateDeploymentSlug, } from "./deploy-client.js";
-import { isAgentProjectDir, loadAgentProject } from "./discovery.js";
+import { inferDeployGitSource } from "./deploy-source.js";
+import { isAgentProjectDir, listChildAgentDirs, loadAgentProject, } from "./discovery.js";
 import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
 import { isValidCursorEventRepo, validateSettableSecretName, } from "./hosting.js";
+import { stderrPalette } from "./terminal-style.js";
 const DEFAULT_POLL_INTERVAL_MS = 3000;
 const DEFAULT_DEPLOY_TIMEOUT_MS = 10 * 60 * 1000;
 /**
- * Shared preamble: credentials → client → team id. Returns an exit code
- * (with the error already rendered) when resolution fails.
+ * Credentials → deploy client → team id. Shared by deploy commands and
+ * `--prod` AX routing. Returns an exit code (error already rendered) on
+ * failure.
  */
-function prepare(options) {
+export function resolveDeployAuth(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
-        const out = (_a = options.out) !== null && _a !== void 0 ? _a : ((text) => void process.stdout.write(text));
-        const err = (_b = options.err) !== null && _b !== void 0 ? _b : ((text) => void process.stderr.write(text));
+        var _a;
+        const err = (_a = options.err) !== null && _a !== void 0 ? _a : ((text) => void process.stderr.write(text));
         const resolved = yield resolveApiKey(options.apiKey === undefined ? undefined : { apiKey: options.apiKey });
         if (resolved === undefined) {
             err(`Not signed in to Cursor. ${SIGN_IN_HINT}\n`);
             return 1;
         }
-        const client = new AgentServeDeployClient(Object.assign({ backendUrl: resolved.backendUrl, apiKey: resolved.apiKey }, (options.fetchImpl === undefined
-            ? {}
-            : { fetchImpl: options.fetchImpl })));
+        // The deployment management routes live on the external API host
+        // (api.cursor.com), not the default backend (api2.cursor.sh) — see
+        // cursorExternalApiUrl. GetMe below stays on the resolved backend.
+        const client = new AgentServeDeployClient({
+            backendUrl: cursorExternalApiUrl(),
+            apiKey: resolved.apiKey,
+            fetchImpl: options.fetchImpl,
+        });
         let teamId;
         if (options.team !== undefined) {
             teamId = Number.parseInt(options.team, 10);
@@ -52,9 +59,11 @@ function prepare(options) {
             }
         }
         else {
-            const account = new CursorBackendClient(Object.assign({ backendUrl: resolved.backendUrl, apiKey: resolved.apiKey }, (options.fetchImpl === undefined
-                ? {}
-                : { fetchImpl: options.fetchImpl })));
+            const account = new CursorBackendClient({
+                backendUrl: resolved.backendUrl,
+                apiKey: resolved.apiKey,
+                fetchImpl: options.fetchImpl,
+            });
             let identity;
             try {
                 identity = yield account.getMe();
@@ -68,11 +77,33 @@ function prepare(options) {
                 return 1;
             }
             teamId = identity.teamId;
-            err(`Using team ${teamId}${identity.teamName === undefined ? "" : ` (${identity.teamName})`} — the account's team; pass --team to override.\n`);
+            const dim = stderrPalette().dim;
+            err(`${dim(`Using team ${teamId}${identity.teamName === undefined ? "" : ` (${identity.teamName})`} — the account's team; pass --team to override.`)}\n`);
+        }
+        return { client, teamId };
+    });
+}
+/**
+ * Shared preamble: credentials → client → team id. Returns an exit code
+ * (with the error already rendered) when resolution fails.
+ */
+function prepare(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const out = (_a = options.out) !== null && _a !== void 0 ? _a : ((text) => void process.stdout.write(text));
+        const err = (_b = options.err) !== null && _b !== void 0 ? _b : ((text) => void process.stderr.write(text));
+        const auth = yield resolveDeployAuth({
+            team: options.team,
+            apiKey: options.apiKey,
+            fetchImpl: options.fetchImpl,
+            err,
+        });
+        if (typeof auth === "number") {
+            return auth;
         }
         return {
-            client,
-            teamId,
+            client: auth.client,
+            teamId: auth.teamId,
             json: options.json === true,
             noWait: options.noWait === true,
             pollIntervalMs: (_c = options.pollIntervalMs) !== null && _c !== void 0 ? _c : DEFAULT_POLL_INTERVAL_MS,
@@ -87,54 +118,293 @@ function prepare(options) {
 // ============================================================================
 export function cmdDeploy(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
         const ctx = yield prepare(options);
         if (typeof ctx === "number") {
             return ctx;
         }
+        const targets = yield resolveDeployTargets(options, ctx);
+        if (typeof targets === "number") {
+            return targets;
+        }
+        // --path is per-agent (relative to the repo root). When deploying several
+        // agents, ignore a shared --path so each target can infer its own path.
+        let deployOptions = options;
+        if (targets.length > 1 && options.path !== undefined) {
+            if (!ctx.json) {
+                ctx.err(`warning: ignoring --path ${JSON.stringify(options.path)} for a multi-agent deploy; each agent infers its own path from git.\n`);
+            }
+            deployOptions = Object.assign(Object.assign({}, options), { path: undefined });
+        }
+        if (targets.length === 1) {
+            return deployOne(ctx, deployOptions, targets[0]);
+        }
+        // Multi-agent batch: deploy sequentially; --json emits an array.
+        const jsonResults = [];
+        let failures = 0;
+        for (const [index, target] of targets.entries()) {
+            if (!ctx.json) {
+                ctx.err(`\n=== [${index + 1}/${targets.length}] Deploying ${target.slug} ===\n`);
+            }
+            const before = jsonResults.length;
+            const code = yield deployOne(ctx, deployOptions, target, {
+                jsonCollect: ctx.json ? jsonResults : undefined,
+            });
+            if (code !== 0) {
+                failures += 1;
+                if (ctx.json && jsonResults.length === before) {
+                    jsonResults.push({ slug: target.slug, error: "deploy failed" });
+                }
+            }
+        }
+        if (ctx.json) {
+            ctx.out(`${JSON.stringify(jsonResults, null, 2)}\n`);
+        }
+        else if (failures > 0) {
+            ctx.err(`\n${failures} of ${targets.length} deploy(s) failed.\n`);
+        }
+        else {
+            ctx.err(`\nDeployed ${targets.length} agents.\n`);
+        }
+        return failures === 0 ? 0 : 1;
+    });
+}
+/**
+ * Resolve which agent directory(ies) to deploy from `--dir` / `--slug` /
+ * `--all`, with an interactive picker when a multi-agent parent is on a TTY.
+ */
+function resolveDeployTargets(options, ctx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
         const dir = resolve((_a = options.dir) !== null && _a !== void 0 ? _a : ".");
-        let slug;
         if (options.slug !== undefined) {
             const slugError = validateDeploymentSlug(options.slug);
             if (slugError !== undefined) {
                 ctx.err(`${slugError}\n`);
                 return 1;
             }
-            slug = options.slug;
         }
-        else {
-            const derived = slugFromDirectoryName(basename(dir));
-            if (derived === undefined) {
-                ctx.err(`Could not derive a deployment slug from the directory name ${JSON.stringify(basename(dir))}; pass --slug.\n`);
+        if (options.all === true && options.slug !== undefined) {
+            ctx.err("Pass either --slug or --all, not both.\n");
+            return 1;
+        }
+        if (yield isAgentProjectDir(dir)) {
+            if (options.all === true) {
+                ctx.err(`--all requires a multi-agent parent directory (several child agents under --dir); ${dir} is a single agent project.\n`);
                 return 1;
             }
-            slug = derived;
-            ctx.err(`Deploying as "${slug}" (from the directory name).\n`);
+            let slug;
+            if (options.slug !== undefined) {
+                slug = options.slug;
+            }
+            else {
+                const derived = slugFromDirectoryName(basename(dir));
+                if (derived === undefined) {
+                    ctx.err(`Could not derive a deployment slug from the directory name ${JSON.stringify(basename(dir))}; pass --slug.\n`);
+                    return 1;
+                }
+                slug = derived;
+                if (!ctx.json) {
+                    ctx.err(`Deploying as "${slug}" (from the directory name).\n`);
+                }
+            }
+            return [{ slug, dir }];
+        }
+        let children;
+        try {
+            children = yield listChildAgentDirs(dir);
+        }
+        catch (error) {
+            ctx.err(`${describeError(error)}\n`);
+            return 1;
+        }
+        // Deploy slugs are lowercase-only; normalize directory names the same way
+        // single-agent deploy does so MixedCase child dirs still deploy.
+        children = children.flatMap((child) => {
+            const slug = slugFromDirectoryName(basename(child.dir));
+            if (slug === undefined) {
+                return [];
+            }
+            return [{ slug, dir: child.dir }];
+        });
+        if (children.length === 0) {
+            if (options.all === true) {
+                ctx.err(`--all requires child agent projects under --dir; none found in ${dir}.\n`);
+                return 1;
+            }
+            // Static / bare-slug deploy against a non-agent directory.
+            let slug;
+            if (options.slug !== undefined) {
+                slug = options.slug;
+            }
+            else {
+                const derived = slugFromDirectoryName(basename(dir));
+                if (derived === undefined) {
+                    ctx.err(`No agent projects under ${dir}, and could not derive a slug from ${JSON.stringify(basename(dir))}; pass --slug or --dir <agent>.\n`);
+                    return 1;
+                }
+                slug = derived;
+                if (!ctx.json) {
+                    ctx.err(`Deploying as "${slug}" (static; no agent project at ${dir}).\n`);
+                }
+            }
+            return [{ slug, dir }];
+        }
+        if (children.length === 1) {
+            const only = children[0];
+            if (options.all === true) {
+                // One child is fine for --all (degenerate multi-agent parent).
+            }
+            else if (options.slug !== undefined &&
+                options.slug.toLowerCase() !== only.slug) {
+                ctx.err(`No agent "${options.slug}" under ${dir}; found "${only.slug}".\n`);
+                return 1;
+            }
+            if (!ctx.json) {
+                ctx.err(`Deploying "${only.slug}" (only agent under ${basename(dir)}).\n`);
+            }
+            return [only];
+        }
+        // Multiple children.
+        if (options.all === true) {
+            if (!ctx.json) {
+                ctx.err(`Deploying all ${children.length} agents under ${basename(dir)}: ${children.map((c) => c.slug).join(", ")}.\n`);
+            }
+            return [...children];
+        }
+        if (options.slug !== undefined) {
+            const wanted = options.slug.toLowerCase();
+            const match = children.find((child) => child.slug === wanted);
+            if (match === undefined) {
+                ctx.err(`No agent "${options.slug}" under ${dir}.\n` +
+                    formatAgentList(children) +
+                    `Pass --slug <name> or --all.\n`);
+                return 1;
+            }
+            return [match];
+        }
+        const chooser = (_b = options.chooseTargets) !== null && _b !== void 0 ? _b : ((agents) => { var _a, _b; return promptChooseDeployTargets(agents, {
+            err: ctx.err,
+            stdin: (_a = options.stdin) !== null && _a !== void 0 ? _a : process.stdin,
+            interactive: ctx.json !== true &&
+                ((_b = options.stdin) !== null && _b !== void 0 ? _b : process.stdin).isTTY === true &&
+                process.stderr.isTTY === true,
+        }); });
+        const chosen = yield chooser(children);
+        if (chosen === null) {
+            ctx.err("Deploy cancelled.\n");
+            return 1;
+        }
+        if (chosen.length === 0) {
+            ctx.err(`Multiple agents under ${dir}:\n` +
+                formatAgentList(children) +
+                `Pass --slug <name> or --all (or re-run on a TTY to pick interactively).\n`);
+            return 1;
         }
-        if (options.repo !== undefined && !options.repo.startsWith("https://")) {
-            ctx.err(`Invalid --repo: ${options.repo} (expected an https:// git repository URL)\n`);
+        return chosen;
+    });
+}
+function formatAgentList(agents) {
+    return agents.map((agent, i) => `  ${i + 1}) ${agent.slug}\n`).join("");
+}
+/**
+ * TTY picker for multi-agent parents. Non-interactive callers get `[]`
+ * so {@link resolveDeployTargets} can print the --slug/--all hint.
+ */
+export function promptChooseDeployTargets(agents, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        options.err(`Multiple agents (${agents.length}):\n` +
+            formatAgentList(agents) +
+            `  a) all\n`);
+        if (!options.interactive) {
+            return [];
+        }
+        options.err('Deploy which? Enter a number, slug, "all", or "q" to cancel: ');
+        const readLine = createLineReader(options.stdin);
+        // createLineReader pauses until data; ensure stdin is flowing on a TTY.
+        (_b = (_a = options.stdin).resume) === null || _b === void 0 ? void 0 : _b.call(_a);
+        const answer = (_c = (yield readLine())) === null || _c === void 0 ? void 0 : _c.trim().toLowerCase();
+        if (answer === undefined || answer === "q" || answer === "quit") {
+            return null;
+        }
+        if (answer === "a" || answer === "all" || answer === "*") {
+            return [...agents];
+        }
+        const asIndex = Number.parseInt(answer, 10);
+        if (!Number.isNaN(asIndex) &&
+            String(asIndex) === answer &&
+            asIndex >= 1 &&
+            asIndex <= agents.length) {
+            return [agents[asIndex - 1]];
+        }
+        const bySlug = agents.find((agent) => agent.slug.toLowerCase() === answer);
+        if (bySlug !== undefined) {
+            return [bySlug];
+        }
+        options.err(`Unrecognized choice ${JSON.stringify(answer)} — expected 1–${agents.length}, a slug, "all", or "q". Aborting.\n`);
+        return null;
+    });
+}
+function deployOne(ctx, options, target, extras) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const { dir, slug } = target;
+        // Fill --repo/--ref/--path from the local git checkout when omitted so
+        // `agentkit deploy` inside an agent directory is enough. Only probe git
+        // for real agent projects (avoids ambient monorepo remotes when someone
+        // deploys a bare --slug). Explicit flags always win.
+        const isAgent = yield isAgentProjectDir(dir);
+        const needsGitInference = isAgent &&
+            (options.repo === undefined ||
+                options.ref === undefined ||
+                options.path === undefined);
+        const inferred = needsGitInference
+            ? yield inferDeployGitSource(dir, Object.assign({}, (options.git === undefined ? {} : { git: options.git })))
+            : {};
+        const gitRepoUrl = (_a = options.repo) !== null && _a !== void 0 ? _a : inferred.gitRepoUrl;
+        const gitRef = (_b = options.ref) !== null && _b !== void 0 ? _b : inferred.gitRef;
+        const agentPath = (_c = options.path) !== null && _c !== void 0 ? _c : inferred.agentPath;
+        if (gitRepoUrl !== undefined && !gitRepoUrl.startsWith("https://")) {
+            ctx.err(`Invalid --repo: ${gitRepoUrl} (expected an https:// git repository URL)\n`);
             return 1;
         }
-        for (const repo of (_b = options.cursorEventsRepos) !== null && _b !== void 0 ? _b : []) {
+        for (const repo of (_d = options.cursorEventsRepos) !== null && _d !== void 0 ? _d : []) {
             if (!isValidCursorEventRepo(repo)) {
                 ctx.err(`Invalid --cursor-events-repo: ${repo} (expected owner/name)\n`);
                 return 1;
             }
         }
+        if (!ctx.json && gitRepoUrl !== undefined) {
+            const inferredBits = [];
+            if (options.repo === undefined && inferred.gitRepoUrl !== undefined) {
+                inferredBits.push("repo");
+            }
+            if (options.ref === undefined && inferred.gitRef !== undefined) {
+                inferredBits.push("ref");
+            }
+            if (options.path === undefined && inferred.agentPath !== undefined) {
+                inferredBits.push("path");
+            }
+            ctx.err(`  source: ${gitRepoUrl}${gitRef === undefined ? "" : ` @ ${gitRef}`}\n` +
+                (agentPath === undefined ? "" : `  path:   ${agentPath}\n`) +
+                (inferredBits.length === 0
+                    ? ""
+                    : `  (inferred ${inferredBits.join(", ")} from git; pass --repo/--ref/--path to override)\n`));
+        }
         // The package manifest (`defineAgent({ hosting })`) is the source of
         // truth for egress domains and expected secret names; flags override or
         // augment it. Directories without an agent project (static placeholder
         // deploys) simply have no manifest.
-        const hosting = yield readHostingManifest(dir);
+        const hosting = isAgent ? yield readHostingManifest(dir) : undefined;
         const egressAllowedDomains = [
             ...new Set([
-                ...((_c = hosting === null || hosting === void 0 ? void 0 : hosting.egressDomains) !== null && _c !== void 0 ? _c : []),
-                ...((_d = options.allowDomains) !== null && _d !== void 0 ? _d : []),
+                ...((_e = hosting === null || hosting === void 0 ? void 0 : hosting.egressDomains) !== null && _e !== void 0 ? _e : []),
+                ...((_f = options.allowDomains) !== null && _f !== void 0 ? _f : []),
             ]),
         ];
         // Today's only source shape: the control plane builds from a git ref (or
         // serves the static placeholder). See DeploySource for the artifact seam.
-        const source = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ kind: "git-ref" }, (options.repo === undefined ? {} : { gitRepoUrl: options.repo })), (options.ref === undefined ? {} : { gitRef: options.ref })), (options.path === undefined ? {} : { agentPath: options.path })), (options.cursorEventsRepos === undefined ||
+        const source = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ kind: "git-ref" }, (gitRepoUrl === undefined ? {} : { gitRepoUrl })), (gitRef === undefined ? {} : { gitRef })), (agentPath === undefined ? {} : { agentPath })), (options.cursorEventsRepos === undefined ||
             options.cursorEventsRepos.length === 0
             ? {}
             : { cursorEventRepos: options.cursorEventsRepos })), (egressAllowedDomains.length === 0 ? {} : { egressAllowedDomains }));
@@ -150,7 +420,10 @@ export function cmdDeploy(options) {
             ctx.out(aliasTokenBlock(accepted.aliasToken));
         }
         if (ctx.noWait) {
-            if (ctx.json) {
+            if ((extras === null || extras === void 0 ? void 0 : extras.jsonCollect) !== undefined) {
+                extras.jsonCollect.push(accepted);
+            }
+            else if (ctx.json) {
                 ctx.out(`${JSON.stringify(accepted, null, 2)}\n`);
             }
             else {
@@ -168,10 +441,15 @@ export function cmdDeploy(options) {
             return renderApiError(error, ctx.err);
         }
         warnMissingSecrets(ctx, slug, hosting === null || hosting === void 0 ? void 0 : hosting.secretNames, detail.secretNames);
+        const payload = accepted.aliasToken === undefined
+            ? detail
+            : Object.assign(Object.assign({}, detail), { aliasToken: accepted.aliasToken });
+        if ((extras === null || extras === void 0 ? void 0 : extras.jsonCollect) !== undefined) {
+            extras.jsonCollect.push(payload);
+            return detail.status === "running" ? 0 : 1;
+        }
         if (ctx.json) {
-            ctx.out(`${JSON.stringify(accepted.aliasToken === undefined
-                ? detail
-                : Object.assign(Object.assign({}, detail), { aliasToken: accepted.aliasToken }), null, 2)}\n`);
+            ctx.out(`${JSON.stringify(payload, null, 2)}\n`);
             return detail.status === "running" ? 0 : 1;
         }
         if (detail.status !== "running") {
@@ -185,7 +463,7 @@ export function cmdDeploy(options) {
             `  generation:  ${detail.generation}\n` +
             `  kind:        ${detail.deploymentKind}\n` +
             `  alias:       ${aliasUrl}\n` +
-            `  playground:  ${aliasUrl}/playground (send X-Agent-Alias-Token)\n`);
+            `  playground:  ${CLI} playground --prod --slug ${slug} --team ${ctx.teamId}\n`);
         return 0;
     });
 }