@cursor/july 0.1.7 → 0.1.9

package/dist/internal/cli-mcp.js

@@ -0,0 +1,570 @@
+/**
+ * `agentkit mcp` — stdio ↔ streamable-HTTP proxy for an agent's MCP endpoint.
+ *
+ * Every served agent is an MCP server at `<base>/v1/mcp` (hosted deployments
+ * run in single mode, so the endpoint sits directly on the engine base URL).
+ * MCP clients that spawn stdio servers (Cursor, Claude Code, …) can reach it
+ * through this command: newline-delimited JSON-RPC on stdin/stdout, one POST
+ * per message to the remote endpoint.
+ *
+ * Targets:
+ * - `--prod [--slug <slug>]` — the team's hosted deployment. Short-lived
+ *   `engineAccess` credentials are minted through the management API with the
+ *   signed-in Cursor account, re-minted near expiry and once on auth-shaped
+ *   failures. No durable secret ever lands in a config file.
+ * - `--url <baseUrl>` — a running server (local `serve` mount or self-hosted
+ *   base URL), with optional `--bearer-token`.
+ *
+ * `agentkit mcp install` writes the matching entry into `~/.cursor/mcp.json`
+ * so the agent shows up as an MCP server in Cursor:
+ *
+ *   { "mcpServers": { "weather-agent": {
+ *       "command": "agentkit",
+ *       "args": ["mcp", "--prod", "--slug", "weather-agent"] } } }
+ *
+ * stdout is reserved for the MCP wire in serve mode; all logging goes to
+ * stderr.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { CLI_COMMAND_NAME as CLI, LOG_PREFIX } from "./distribution.js";
+import { ProdTargetError, resolveProdSlug, resolveProdTarget, } from "./resolve-prod-target.js";
+/** Mount path of the MCP surface relative to an agent base URL. */
+const MCP_PATH = "/v1/mcp";
+/** Re-mint engineAccess when within this window of `expiresAt`. */
+const ACCESS_EXPIRY_LEEWAY_MS = 5 * 60 * 1000;
+/**
+ * Upper bound per POST. The remote endpoint bounds `ask`/`check` waits at
+ * ~55s, so a healthy turn always responds well inside this; past it the
+ * engine is unreachable or hung.
+ */
+const REQUEST_TIMEOUT_MS = 120000;
+/** Attempts per message (initial + retries after refresh/backoff). */
+const FORWARD_ATTEMPTS = 3;
+/**
+ * Statuses that cannot have reached the agent's tool logic, so retrying
+ * cannot double-run a turn: auth/routing rejections (401/403/404), a
+ * hibernated engine (417), and proxy-unreachable errors (502/503/504).
+ * A plain 500 is ambiguous and is surfaced to the client instead.
+ */
+const RETRYABLE_STATUSES = new Set([401, 403, 404, 417, 502, 503, 504]);
+export function cmdMcp(subcommand, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const err = (_a = options.err) !== null && _a !== void 0 ? _a : defaultErr;
+        if (subcommand === undefined) {
+            return cmdMcpServe(options);
+        }
+        if (subcommand === "install") {
+            return cmdMcpInstall(options);
+        }
+        err(`Unknown mcp subcommand "${subcommand}".\n` +
+            `Usage: ${CLI} mcp [install] --prod [--slug <slug>] | --url <baseUrl>\n`);
+        return 1;
+    });
+}
+// ============================================================================
+// serve mode: stdio ↔ /v1/mcp
+// ============================================================================
+export function cmdMcpServe(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const err = (_a = options.err) !== null && _a !== void 0 ? _a : defaultErr;
+        const source = buildTargetSource(options, err);
+        if (typeof source === "string") {
+            err(`${source}\n`);
+            return 1;
+        }
+        // Resolve eagerly: a bad slug / signed-out host / stopped deployment fails
+        // fast in the client's MCP server logs instead of on the first tool call.
+        let initial;
+        try {
+            initial = yield source.get();
+        }
+        catch (error) {
+            err(`${describeError(error)}\n`);
+            return 1;
+        }
+        err(`${LOG_PREFIX} mcp: proxying stdio <-> ${initial.mcpUrl}\n`);
+        const stdin = (_b = options.stdin) !== null && _b !== void 0 ? _b : process.stdin;
+        const stdout = (_c = options.stdout) !== null && _c !== void 0 ? _c : process.stdout;
+        const fetchImpl = (_d = options.fetchImpl) !== null && _d !== void 0 ? _d : fetch;
+        const sleep = (_e = options.sleep) !== null && _e !== void 0 ? _e : sleepMs;
+        const pending = new Set();
+        const handleLine = (line) => __awaiter(this, void 0, void 0, function* () {
+            const outcome = yield forwardMessage({ source, fetchImpl, sleep, line });
+            if (outcome.kind === "empty") {
+                return;
+            }
+            if (outcome.kind === "json") {
+                writeWireBody(stdout, outcome.body, line, err);
+                return;
+            }
+            emitFailure(stdout, line, outcome.message, err);
+        });
+        yield new Promise((done) => {
+            let buffer = "";
+            const enqueueLine = (raw) => {
+                const line = raw.trim();
+                if (line === "") {
+                    return;
+                }
+                const task = handleLine(line)
+                    .catch((error) => {
+                    err(`${LOG_PREFIX} mcp: ${describeError(error)}\n`);
+                })
+                    .finally(() => {
+                    pending.delete(task);
+                });
+                pending.add(task);
+            };
+            const onChunk = (chunk) => {
+                buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+                let newline = buffer.indexOf("\n");
+                while (newline !== -1) {
+                    const line = buffer.slice(0, newline);
+                    buffer = buffer.slice(newline + 1);
+                    newline = buffer.indexOf("\n");
+                    enqueueLine(line);
+                }
+            };
+            let finished = false;
+            const finish = () => {
+                if (finished) {
+                    return;
+                }
+                finished = true;
+                enqueueLine(buffer);
+                buffer = "";
+                done();
+            };
+            stdin.on("data", onChunk);
+            stdin.once("end", finish);
+            stdin.once("close", finish);
+            stdin.once("error", finish);
+        });
+        // Drain in-flight turns so piped one-shot usage still sees its replies.
+        yield Promise.allSettled([...pending]);
+        return 0;
+    });
+}
+/** Returns a usage error string when the target flags are invalid. */
+function buildTargetSource(options, err) {
+    if (options.prod === true && options.url !== undefined) {
+        return "--prod and --url are mutually exclusive";
+    }
+    if (options.url !== undefined) {
+        const base = normalizeBaseUrl(options.url);
+        if (typeof base !== "string") {
+            return base.error;
+        }
+        return createStaticTargetSource(base, options.bearerToken);
+    }
+    if (options.prod === true) {
+        return createProdTargetSource(options, err);
+    }
+    return `${CLI} mcp requires --prod (hosted deployment) or --url <baseUrl>`;
+}
+function createStaticTargetSource(baseUrl, bearerToken) {
+    const headers = {};
+    if (bearerToken !== undefined && bearerToken.trim() !== "") {
+        headers.authorization = `Bearer ${bearerToken.trim()}`;
+    }
+    const target = { mcpUrl: joinMcpPath(baseUrl), headers };
+    return {
+        canRefresh: false,
+        get: () => Promise.resolve(target),
+        invalidate: () => { },
+    };
+}
+function createProdTargetSource(options, err) {
+    var _a, _b;
+    const resolveImpl = (_a = options.resolveProdTargetImpl) !== null && _a !== void 0 ? _a : resolveProdTarget;
+    const now = (_b = options.now) !== null && _b !== void 0 ? _b : Date.now;
+    let cached;
+    let inFlight;
+    const resolveFresh = () => __awaiter(this, void 0, void 0, function* () {
+        const prod = yield resolveImpl({
+            dir: options.dir,
+            cwd: options.cwd,
+            slug: options.slug,
+            team: options.team,
+            apiKey: options.apiKey,
+            fetchImpl: options.fetchImpl,
+            err,
+        });
+        const target = {
+            mcpUrl: joinMcpPath(prod.agentUrl),
+            headers: prod.headers,
+        };
+        const expiresAtMs = Date.parse(prod.expiresAt);
+        if (Number.isFinite(expiresAtMs)) {
+            target.expiresAtMs = expiresAtMs;
+        }
+        return target;
+    });
+    return {
+        canRefresh: true,
+        invalidate() {
+            cached = undefined;
+        },
+        get() {
+            const current = cached;
+            const fresh = current !== undefined &&
+                (current.expiresAtMs === undefined ||
+                    now() < current.expiresAtMs - ACCESS_EXPIRY_LEEWAY_MS);
+            if (fresh) {
+                return Promise.resolve(current);
+            }
+            if (inFlight === undefined) {
+                inFlight = resolveFresh()
+                    .then((target) => {
+                    cached = target;
+                    return target;
+                })
+                    .finally(() => {
+                    inFlight = undefined;
+                });
+            }
+            return inFlight;
+        },
+    };
+}
+function forwardMessage(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { source, fetchImpl, sleep, line } = args;
+        let lastFailure = "request failed";
+        for (let attempt = 0; attempt < FORWARD_ATTEMPTS; attempt++) {
+            if (attempt > 0) {
+                yield sleep(500 * attempt);
+            }
+            let target;
+            try {
+                target = yield source.get();
+            }
+            catch (error) {
+                lastFailure = describeError(error);
+                continue;
+            }
+            let response;
+            try {
+                response = yield fetchImpl(target.mcpUrl, {
+                    method: "POST",
+                    headers: Object.assign(Object.assign({}, target.headers), { "content-type": "application/json", 
+                        // The streamable-HTTP server transport 406s unless the client
+                        // accepts both, even in JSON response mode.
+                        accept: "application/json, text/event-stream" }),
+                    body: line,
+                    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+                });
+            }
+            catch (error) {
+                source.invalidate();
+                if (isTimeoutError(error)) {
+                    // The turn may have started; retrying could double-send it.
+                    return {
+                        kind: "failed",
+                        message: `no response within ${REQUEST_TIMEOUT_MS / 1000}s (the agent may still be processing; check its sessions)`,
+                    };
+                }
+                lastFailure = `request failed: ${describeError(error)}`;
+                continue;
+            }
+            if (response.status === 202) {
+                // Notification/response-only message: nothing to relay.
+                yield response.text().catch(() => "");
+                return { kind: "empty" };
+            }
+            const text = yield response.text().catch(() => "");
+            if (response.ok) {
+                if (text.trim() === "") {
+                    return { kind: "empty" };
+                }
+                return { kind: "json", body: text };
+            }
+            lastFailure = `upstream HTTP ${response.status}${text.trim() === "" ? "" : `: ${truncateForLog(text)}`}`;
+            if (RETRYABLE_STATUSES.has(response.status)) {
+                // Auth/expiry/hibernation shaped: re-mint credentials and retry.
+                source.invalidate();
+                continue;
+            }
+            return { kind: "failed", message: lastFailure };
+        }
+        return { kind: "failed", message: lastFailure };
+    });
+}
+/**
+ * Relay an upstream JSON body onto the stdio wire. The body is re-serialized
+ * so output is always one message per line, and batch responses are split
+ * into individual lines (the stdio transport has no batch framing).
+ */
+function writeWireBody(stdout, body, inboundLine, err) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch (_a) {
+        emitFailure(stdout, inboundLine, `upstream returned a non-JSON payload: ${truncateForLog(body)}`, err);
+        return;
+    }
+    const messages = Array.isArray(parsed) ? parsed : [parsed];
+    for (const message of messages) {
+        stdout.write(`${JSON.stringify(message)}\n`);
+    }
+}
+/**
+ * Answer every request id in the inbound message with a JSON-RPC error so
+ * the client fails the call instead of hanging on a lost response.
+ * Notification-only failures are stderr-logged.
+ */
+function emitFailure(stdout, inboundLine, message, err) {
+    err(`${LOG_PREFIX} mcp: ${message}\n`);
+    for (const id of requestIdsOf(inboundLine)) {
+        stdout.write(`${JSON.stringify({
+            jsonrpc: "2.0",
+            id,
+            error: { code: -32000, message },
+        })}\n`);
+    }
+}
+/** Ids of JSON-RPC *requests* (has `method` + `id`) in a raw wire line. */
+function requestIdsOf(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch (_a) {
+        return [];
+    }
+    const messages = Array.isArray(parsed) ? parsed : [parsed];
+    const ids = [];
+    for (const message of messages) {
+        if (message !== null &&
+            typeof message === "object" &&
+            "method" in message &&
+            "id" in message) {
+            const id = message.id;
+            if (typeof id === "string" || typeof id === "number") {
+                ids.push(id);
+            }
+        }
+    }
+    return ids;
+}
+export function cmdMcpInstall(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const err = (_a = options.err) !== null && _a !== void 0 ? _a : defaultErr;
+        const stdout = (_b = options.stdout) !== null && _b !== void 0 ? _b : process.stdout;
+        if (options.prod === true && options.url !== undefined) {
+            err("--prod and --url are mutually exclusive\n");
+            return 1;
+        }
+        let name;
+        let entry;
+        if (options.prod === true) {
+            let slug;
+            try {
+                slug = resolveProdSlug({
+                    dir: options.dir,
+                    cwd: options.cwd,
+                    slug: options.slug,
+                });
+            }
+            catch (error) {
+                err(`${describeError(error)}\n`);
+                return 1;
+            }
+            // Verify the deployment resolves before writing config that cannot work.
+            const resolveImpl = (_c = options.resolveProdTargetImpl) !== null && _c !== void 0 ? _c : resolveProdTarget;
+            try {
+                yield resolveImpl({
+                    dir: options.dir,
+                    cwd: options.cwd,
+                    slug,
+                    team: options.team,
+                    apiKey: options.apiKey,
+                    fetchImpl: options.fetchImpl,
+                    err,
+                });
+            }
+            catch (error) {
+                err(`${describeError(error)}\n`);
+                if (error instanceof ProdTargetError && error.notFound) {
+                    err(`Deploy it first: ${CLI} deploy --slug ${slug}\n`);
+                }
+                return 1;
+            }
+            name = resolveServerName(options.name, slug);
+            const args = ["mcp", "--prod", "--slug", slug];
+            if (options.team !== undefined && options.team !== "") {
+                args.push("--team", options.team);
+            }
+            entry = { command: CLI, args };
+        }
+        else if (options.url !== undefined) {
+            const base = normalizeBaseUrl(options.url);
+            if (typeof base !== "string") {
+                err(`${base.error}\n`);
+                return 1;
+            }
+            const derived = (_d = options.name) !== null && _d !== void 0 ? _d : deriveNameFromUrl(base);
+            if (derived === undefined) {
+                err(`Could not derive a server name from ${base}; pass --name <serverName>.\n`);
+                return 1;
+            }
+            name = resolveServerName(derived, derived);
+            const args = ["mcp", "--url", base];
+            if (options.bearerToken !== undefined && options.bearerToken !== "") {
+                args.push("--bearer-token", options.bearerToken);
+                err("note: --bearer-token is written to mcp.json in plain text; prefer --prod for hosted agents\n");
+            }
+            entry = { command: CLI, args };
+        }
+        else {
+            err(`${CLI} mcp install requires --prod (hosted deployment) or --url <baseUrl>\n`);
+            return 1;
+        }
+        if (options.print === true) {
+            stdout.write(`${JSON.stringify({ mcpServers: { [name]: entry } }, null, 2)}\n`);
+            return 0;
+        }
+        const path = cursorMcpJsonPath();
+        try {
+            yield upsertMcpJsonEntry(path, name, entry);
+        }
+        catch (error) {
+            err(`${describeError(error)}\n`);
+            return 1;
+        }
+        if (options.json === true) {
+            stdout.write(`${JSON.stringify({ ok: true, path, name, entry })}\n`);
+            return 0;
+        }
+        stdout.write(`Installed MCP server "${name}" in ${path}\n` +
+            `  ${entry.command} ${entry.args.join(" ")}\n` +
+            "Cursor watches this file; the server appears without a restart.\n");
+        return 0;
+    });
+}
+/** `~/.cursor/mcp.json` — the user-level Cursor MCP config. */
+export function cursorMcpJsonPath(home) {
+    var _a;
+    if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
+    const resolved = home.trim() === "" ? homedir() : home;
+    return join(resolved, ".cursor", "mcp.json");
+}
+function upsertMcpJsonEntry(path, name, entry) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let root = {};
+        let raw;
+        try {
+            raw = yield readFile(path, "utf8");
+        }
+        catch (_a) {
+            raw = undefined;
+        }
+        if (raw !== undefined && raw.trim() !== "") {
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch (error) {
+                throw new Error(`${path} is not valid JSON (${describeError(error)}); fix it and re-run.`);
+            }
+            if (parsed === null ||
+                typeof parsed !== "object" ||
+                Array.isArray(parsed)) {
+                throw new Error(`${path} must contain a JSON object; fix it and re-run.`);
+            }
+            root = parsed;
+        }
+        const existing = root.mcpServers;
+        const servers = existing !== null &&
+            typeof existing === "object" &&
+            !Array.isArray(existing)
+            ? existing
+            : {};
+        servers[name] = entry;
+        root.mcpServers = servers;
+        yield mkdir(dirname(path), { recursive: true });
+        yield writeFile(path, `${JSON.stringify(root, null, 2)}\n`, "utf8");
+    });
+}
+function resolveServerName(name, fallback) {
+    const trimmed = name === null || name === void 0 ? void 0 : name.trim();
+    if (trimmed !== undefined && trimmed !== "") {
+        return trimmed;
+    }
+    return fallback;
+}
+/** Last path segment of the agent base URL (the mount slug), if any. */
+function deriveNameFromUrl(baseUrl) {
+    const segments = new URL(baseUrl).pathname.split("/").filter((s) => s !== "");
+    const last = segments.at(-1);
+    if (last === undefined || last === "") {
+        return undefined;
+    }
+    return last;
+}
+// ============================================================================
+// Shared helpers
+// ============================================================================
+/** Agent base URL → MCP endpoint URL (idempotent when already pointed at it). */
+export function joinMcpPath(baseUrl) {
+    const parsed = new URL(baseUrl);
+    let pathname = parsed.pathname.replace(/\/+$/, "");
+    if (!pathname.endsWith(MCP_PATH)) {
+        pathname = `${pathname}${MCP_PATH}`;
+    }
+    parsed.pathname = pathname;
+    return parsed.toString();
+}
+function normalizeBaseUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch (_a) {
+        return { error: `invalid --url: ${raw}` };
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        return { error: `unsupported --url protocol: ${parsed.protocol}` };
+    }
+    return raw.replace(/\/+$/, "");
+}
+function isTimeoutError(error) {
+    return (error instanceof Error &&
+        (error.name === "TimeoutError" || error.name === "AbortError"));
+}
+function truncateForLog(text) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > 300 ? `${flat.slice(0, 300)}…` : flat;
+}
+function describeError(error) {
+    if (error instanceof Error) {
+        const cause = error.cause instanceof Error && error.cause.message !== ""
+            ? ` (${error.cause.message})`
+            : "";
+        return `${error.message}${cause}`;
+    }
+    return String(error);
+}
+function defaultErr(text) {
+    process.stderr.write(text);
+}
+function sleepMs(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}

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

@@ -11,7 +11,7 @@
  */
 export type DeploymentStatus = "pending" | "deploying" | "running" | "degraded" | "failed" | "stopping" | "stopped";
 /** Customer-safe deploy progress (no hosting phase / infra names). */
-export type DeploymentProgress = "queued" | "preparing" | "building" | "finalizing" | "running" | "failed" | "stopping" | "stopped" | "degraded";
+export type DeploymentProgress = "queued" | "preparing" | "creating" | "building" | "starting" | "finalizing" | "running" | "failed" | "stopping" | "stopped" | "degraded";
 export declare const TERMINAL_DEPLOY_STATUSES: ReadonlySet<DeploymentStatus>;
 /**
  * What gets deployed. Today the control plane builds the engine itself from
@@ -73,6 +73,12 @@ export interface Deployment {
      * backends; older responses omit it.
      */
     progress?: DeploymentProgress;
+    /**
+     * Live step while the deploy converges (e.g. "Checking out source…").
+     * Null when running / stopped or when only a failure is on the row.
+     * Present on newer backends; older responses omit it.
+     */
+    statusMessage?: string | null;
     generation: number;
     observedGeneration?: number | null;
     engineGeneration?: number | null;

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

@@ -1 +1 @@
-{"version":3,"file":"deploy-client.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAEd,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,gBAAgB,CAKjE,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,CAAC;AAIF,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOtE;AAED,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM;IAJrC,YACE,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;IACvB,oEAAoE;IAC3D,iBAAiB,CAAC,EAAE,MAAM,YAAA,EAIpC;CACF;AASD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,4DAA4D;IAC5D,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AA6HD,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,YAAY,OAAO,EAAE,6BAA6B,EAMjD;IAED,yEAAyE;IACnE,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,YAAY,CAAC;KACtB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuC1B;IAEK,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAOrE;IAEK,aAAa,CAAC,IAAI,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAO5B;IAEK,cAAc,CAAC,IAAI,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAOxB;IAED,sEAAsE;IAChE,gBAAgB,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlB;IAED;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BpB;IAED,gEAAgE;IAC1D,WAAW,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAOxB;IAED,yDAAyD;IACnD,YAAY,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;IAED;;;;OAIG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlB;IAED,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpC;YAEa,OAAO;CAyCtB"}
+{"version":3,"file":"deploy-client.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-client.ts"],"names":[],"mappings":"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"}

package/dist/internal/deploy-client.js

@@ -92,7 +92,9 @@ const deploymentSchema = z.object({
         .enum([
         "queued",
         "preparing",
+        "creating",
         "building",
+        "starting",
         "finalizing",
         "running",
         "failed",
@@ -101,6 +103,7 @@ const deploymentSchema = z.object({
         "degraded",
     ])
         .optional(),
+    statusMessage: z.string().nullable().optional(),
     generation: z.number(),
     observedGeneration: z.number().nullable().optional(),
     engineGeneration: z.number().nullable().optional(),

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

@@ -17,6 +17,9 @@ export interface InferredDeploySource {
  * Normalize a git remote URL to the https form the control plane accepts
  * (`https://host/owner/repo`, no `.git` suffix). Returns undefined for
  * unrecognized shapes.
+ *
+ * Accepts HTTPS, `git@host:path`, GitHub org-scoped SSH
+ * (`org-123@github.com:owner/repo.git`), and `ssh://user@host[:port]/path`.
  */
 export declare function httpsGitRepoUrlFromRemote(remote: string): string | undefined;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"deploy-source.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,CACtB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA6B5E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAYpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,SAAS,CAAA;CAAE,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}
+{"version":3,"file":"deploy-source.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,CACtB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4C5E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAYpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,SAAS,CAAA;CAAE,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}