@cursor/july 0.1.7 → 0.1.9

package/dist/internal/deploy-source.js

@@ -32,18 +32,36 @@ const defaultGitRunner = (args, cwd) => __awaiter(void 0, void 0, void 0, functi
  * 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 function httpsGitRepoUrlFromRemote(remote) {
     let url = remote.trim();
     if (url === "") {
         return undefined;
     }
-    if (url.startsWith("git@")) {
-        // git@host:owner/repo.git → https://host/owner/repo.git
-        url = `https://${url.slice("git@".length).replace(":", "/")}`;
+    // SCP-like SSH: user@host:owner/repo(.git) — includes git@ and GitHub
+    // org deploy keys (org-NNNN@github.com:…).
+    const scpMatch = /^([^@/\s]+)@([^:/\s]+):(.+)$/.exec(url);
+    if (scpMatch !== null) {
+        const host = scpMatch[2];
+        const path = scpMatch[3];
+        url = `https://${host}/${path}`;
     }
-    else if (url.startsWith("ssh://git@")) {
-        url = `https://${url.slice("ssh://git@".length)}`;
+    else if (/^ssh:\/\//i.test(url)) {
+        // ssh://user@host[:port]/owner/repo → https://host/owner/repo
+        try {
+            const ssh = new URL(url);
+            const path = ssh.pathname.replace(/^\/+/, "");
+            if (ssh.hostname === "" || path === "") {
+                return undefined;
+            }
+            url = `https://${ssh.hostname}/${path}`;
+        }
+        catch (_a) {
+            return undefined;
+        }
     }
     else if (!/^https?:\/\//i.test(url)) {
         return undefined;
@@ -52,7 +70,7 @@ export function httpsGitRepoUrlFromRemote(remote) {
     try {
         parsed = new URL(url);
     }
-    catch (_a) {
+    catch (_b) {
         return undefined;
     }
     const path = parsed.pathname
@@ -62,7 +80,7 @@ export function httpsGitRepoUrlFromRemote(remote) {
     if (path === "" || !path.includes("/")) {
         return undefined;
     }
-    // Use hostname (not host) so ssh://git@github.com:22/… does not keep :22.
+    // Use hostname (not host) so ssh://…@github.com:22/… does not keep :22.
     return `https://${parsed.hostname}/${path}`;
 }
 /**

package/dist/internal/discovery.js

@@ -341,7 +341,7 @@ function resolveHosting(ctx, agentDir, hosting) {
             warn(`hosting.secretNames: ${nameError}`);
         }
         else if (isReservedSecretName(name)) {
-            warn(`hosting.secretNames: ${JSON.stringify(name)} is platform-reserved (CURSOR_*) and injected automatically; it cannot be set with \`secrets set\`.`);
+            warn(`hosting.secretNames: ${JSON.stringify(name)} is platform-managed (CURSOR_* / Cursor-hosted storage) and injected automatically; omit it from secretNames.`);
         }
     }
     return Object.assign(Object.assign({}, (hosting.egressDomains === undefined

package/dist/internal/distribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,qEAAqE;AACrE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAezC,CAAC"}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,qEAAqE;AACrE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAkBzC,CAAC"}

package/dist/internal/distribution.js

@@ -87,4 +87,7 @@ export const AUTHORING_ENTRY_FILES = [
     ["evals", "evals.js"],
     ["ab", "ab.js"],
     ["storage", "storage.js"],
+    ["storage/file-kv", "storage-backends/file-kv.js"],
+    ["storage/postgres-kv", "storage-backends/postgres-kv.js"],
+    ["storage/cursor-hosted", "storage-backends/cursor-hosted.js"],
 ];

package/dist/internal/host-kv.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Author-facing durable JSON KV for {@link HostContext.kv}.
+ *
+ * When `defineStorage` is authored and exposes `get`, values live in that
+ * sink under {@link storageKeys.kv}. Otherwise they land as one JSON file
+ * per key under `--state-root/kv` (local dogfood / no durable plug-in).
+ */
+import type { HostKvApi } from "../types.js";
+import type { StorageCoordinator } from "./storage-coordinator.js";
+export interface CreateHostKvApiOptions {
+    agentName: string;
+    stateRoot: string;
+    storage?: StorageCoordinator;
+}
+/** Build the host KV API for one agent process. */
+export declare function createHostKvApi(options: CreateHostKvApiOptions): HostKvApi;
+//# sourceMappingURL=host-kv.d.ts.map

package/dist/internal/host-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-kv.d.ts","sourceRoot":"","sources":["../../src/internal/host-kv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAa1E"}

package/dist/internal/host-kv.js

@@ -0,0 +1,77 @@
+/**
+ * Author-facing durable JSON KV for {@link HostContext.kv}.
+ *
+ * When `defineStorage` is authored and exposes `get`, values live in that
+ * sink under {@link storageKeys.kv}. Otherwise they land as one JSON file
+ * per key under `--state-root/kv` (local dogfood / no durable plug-in).
+ */
+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 { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { storageKeys } from "../storage.js";
+/** Build the host KV API for one agent process. */
+export function createHostKvApi(options) {
+    const storage = options.storage;
+    if ((storage === null || storage === void 0 ? void 0 : storage.supportsAuthorKv) === true) {
+        return {
+            get: (key) => storage.kvGet(normalizeAuthorKey(key)),
+            put: (key, value) => storage.kvPut(normalizeAuthorKey(key), value),
+            delete: (key) => storage.kvDelete(normalizeAuthorKey(key)),
+        };
+    }
+    return createFilesystemKvApi({
+        agentName: options.agentName,
+        stateRoot: options.stateRoot,
+    });
+}
+function createFilesystemKvApi(options) {
+    const dir = join(options.stateRoot, "kv");
+    const filePath = (authorKey) => join(dir, `${encodeURIComponent(storageKeys.kv(options.agentName, authorKey))}.json`);
+    return {
+        get(key) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const authorKey = normalizeAuthorKey(key);
+                try {
+                    return JSON.parse(yield readFile(filePath(authorKey), "utf8"));
+                }
+                catch (error) {
+                    if (error.code === "ENOENT") {
+                        return undefined;
+                    }
+                    throw error;
+                }
+            });
+        },
+        put(key, value) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const authorKey = normalizeAuthorKey(key);
+                yield mkdir(dir, { recursive: true });
+                const target = filePath(authorKey);
+                const tmp = join(dir, `.tmp-${randomUUID()}`);
+                yield writeFile(tmp, JSON.stringify(value), "utf8");
+                yield rename(tmp, target);
+            });
+        },
+        delete(key) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const authorKey = normalizeAuthorKey(key);
+                yield rm(filePath(authorKey), { force: true });
+            });
+        },
+    };
+}
+function normalizeAuthorKey(key) {
+    if (typeof key !== "string" || key.trim() === "") {
+        throw new Error("host.kv key must be a non-empty string");
+    }
+    return key;
+}

package/dist/internal/hosting.d.ts

@@ -16,6 +16,13 @@ export declare const MAX_SECRET_VALUE_BYTES = 4096;
 export declare const MAX_SECRET_NAME_LENGTH = 64;
 /** Secret names the platform injects; user writes are rejected. */
 export declare const RESERVED_SECRET_NAME_PREFIX = "CURSOR_";
+/**
+ * Additional platform-managed env names for Cursor-hosted durable storage
+ * (Bugbot `agent_serve_*`). Mirrored from
+ * `@cursor/july/storage/cursor-hosted` so validate/secrets CLI stay in sync
+ * without importing the storage backend into the CLI graph.
+ */
+export declare const PLATFORM_HOSTED_STORAGE_SECRET_NAMES: readonly ["BUGBOTDB_URL", "AGENT_SERVE_DEPLOYMENT_ID"];
 /** Returns a human error message, or undefined when the domain is valid. */
 export declare function validateEgressDomain(domain: string): string | undefined;
 /**
@@ -25,11 +32,14 @@ export declare function validateEgressDomain(domain: string): string | undefined
  * diagnostic than the hard write-time rejection.
  */
 export declare function validateSecretName(name: string): string | undefined;
-/** True when the platform reserves this name (`CURSOR_*`); writes are rejected. */
+/**
+ * True when the platform manages this name (`CURSOR_*` or hosted-storage
+ * env vars); user writes / deletes are rejected.
+ */
 export declare function isReservedSecretName(name: string): boolean;
 /**
  * Human error for a secret name a user is trying to write or delete:
- * grammar plus the reserved `CURSOR_*` prefix.
+ * grammar plus platform-managed names (`CURSOR_*`, hosted storage).
  */
 export declare function validateSettableSecretName(name: string): string | undefined;
 /** `owner/name` — mirrors the backend's cursor-event repo grammar. */

package/dist/internal/hosting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AASrD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3E;AAID,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}
+{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/internal/hosting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,kCAAkC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAY,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,YAC/C,cAAc,EACd,2BAA2B,CACnB,CAAC;AASX,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS3E;AAID,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/internal/hosting.js

@@ -16,6 +16,16 @@ export const MAX_SECRET_VALUE_BYTES = 4096;
 export const MAX_SECRET_NAME_LENGTH = 64;
 /** Secret names the platform injects; user writes are rejected. */
 export const RESERVED_SECRET_NAME_PREFIX = "CURSOR_";
+/**
+ * Additional platform-managed env names for Cursor-hosted durable storage
+ * (Bugbot `agent_serve_*`). Mirrored from
+ * `@cursor/july/storage/cursor-hosted` so validate/secrets CLI stay in sync
+ * without importing the storage backend into the CLI graph.
+ */
+export const PLATFORM_HOSTED_STORAGE_SECRET_NAMES = [
+    "BUGBOTDB_URL",
+    "AGENT_SERVE_DEPLOYMENT_ID",
+];
 const SECRET_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;
 // Lowercase hostname with >=2 labels, an alphabetic TLD, and at most one
 // leading `*.` wildcard. Labels: alphanumeric with interior hyphens.
@@ -42,13 +52,20 @@ export function validateSecretName(name) {
     }
     return undefined;
 }
-/** True when the platform reserves this name (`CURSOR_*`); writes are rejected. */
+/**
+ * True when the platform manages this name (`CURSOR_*` or hosted-storage
+ * env vars); user writes / deletes are rejected.
+ */
 export function isReservedSecretName(name) {
-    return name.startsWith(RESERVED_SECRET_NAME_PREFIX);
+    if (name.startsWith(RESERVED_SECRET_NAME_PREFIX)) {
+        return true;
+    }
+    const upper = name.toUpperCase();
+    return PLATFORM_HOSTED_STORAGE_SECRET_NAMES.some((managed) => managed === upper);
 }
 /**
  * Human error for a secret name a user is trying to write or delete:
- * grammar plus the reserved `CURSOR_*` prefix.
+ * grammar plus platform-managed names (`CURSOR_*`, hosted storage).
  */
 export function validateSettableSecretName(name) {
     const nameError = validateSecretName(name);
@@ -56,7 +73,7 @@ export function validateSettableSecretName(name) {
         return nameError;
     }
     if (isReservedSecretName(name)) {
-        return `Secret name ${JSON.stringify(name)} is platform-reserved (CURSOR_*); the platform injects those values automatically.`;
+        return `Secret name ${JSON.stringify(name)} is platform-managed; the platform injects CURSOR_* and Cursor-hosted storage values automatically.`;
     }
     return undefined;
 }

package/dist/internal/json-dir-store.js

@@ -0,0 +1,100 @@
+/**
+ * Small filesystem helpers for one-JSON-file-per-id persistence under a
+ * project-relative directory (eval run snapshots, A/B aggregate snapshots).
+ */
+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 { randomBytes } from "node:crypto";
+import { mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+export function assertNonEmptyDir(dir, fnName) {
+    if (typeof dir !== "string" || dir.trim() === "") {
+        throw new Error(`${fnName}: dir must be a non-empty string`);
+    }
+    return dir;
+}
+/** Resolve `dir` against `projectRoot` when relative. */
+export function resolveProjectRelativeDir(args) {
+    return isAbsolute(args.dir) ? args.dir : join(args.projectRoot, args.dir);
+}
+function isEnoent(error) {
+    return (error !== null &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+/** List `*.json` basenames in `root` (any order). Missing dir → []. */
+export function listJsonBasenames(root) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let names;
+        try {
+            names = yield readdir(root);
+        }
+        catch (error) {
+            if (isEnoent(error)) {
+                return [];
+            }
+            throw error;
+        }
+        return names.filter((name) => name.endsWith(".json"));
+    });
+}
+/**
+ * Read and JSON.parse every `*.json` file under `root`. Missing dir → [].
+ * Unreadable or corrupt files are skipped so one bad snapshot cannot wipe
+ * the rest of the history.
+ */
+export function readJsonDir(root, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let names = yield listJsonBasenames(root);
+        if ((options === null || options === void 0 ? void 0 : options.sortBasenames) === "asc") {
+            names = [...names].sort();
+        }
+        else if ((options === null || options === void 0 ? void 0 : options.sortBasenames) === "desc") {
+            names = [...names].sort().reverse();
+        }
+        const out = [];
+        for (const name of names) {
+            try {
+                const raw = yield readFile(join(root, name), "utf8");
+                out.push(JSON.parse(raw));
+            }
+            catch (_a) {
+                // skip corrupt / unreadable files
+            }
+        }
+        return out;
+    });
+}
+/** Atomically write JSON under `root`/`fileName` (temp file + rename). */
+export function writeJsonFile(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { root, fileName, value } = args;
+        // Serialize before any await so callers get a stable snapshot even if they
+        // mutate `value` afterward.
+        const body = `${JSON.stringify(value, null, 2)}\n`;
+        yield mkdir(root, { recursive: true });
+        const finalPath = join(root, fileName);
+        const tmpPath = `${finalPath}.${randomBytes(4).toString("hex")}.tmp`;
+        yield writeFile(tmpPath, body, "utf8");
+        yield rename(tmpPath, finalPath);
+    });
+}
+/** Best-effort delete; ignores missing files. */
+export function deleteFileInDir(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield rm(join(args.root, args.fileName), { force: true });
+        }
+        catch (_a) {
+            // ignore
+        }
+    });
+}

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

@@ -14,10 +14,24 @@ export interface LogsResponse {
     entries: LogRingEntry[];
     nextAfter: number;
 }
-export type LogsProgress = DeploymentProgress | "queued" | "preparing" | "building" | "finalizing" | "running" | "failed" | "stopping" | "stopped" | "degraded";
-export declare function progressMessage(progress: LogsProgress, lastError?: string | null): string;
+export type LogsProgress = DeploymentProgress | "queued" | "preparing" | "creating" | "building" | "starting" | "finalizing" | "running" | "failed" | "stopping" | "stopped" | "degraded";
+/**
+ * Customer-facing line for the current deploy step. Prefer the live
+ * `statusMessage` from the API when present; otherwise the progress
+ * vocabulary. Failed/degraded always append sanitized `lastError`.
+ */
+export declare function progressMessage(progress: LogsProgress, lastError?: string | null, statusMessage?: string | null): string;
 /** Strip obvious hosting internals from error text shown to customers. */
 export declare function sanitizeCustomerError(message: string): string;
+/**
+ * One-line label for `agentkit deploy` polling (TTY spinner / non-TTY
+ * transitions). Uses statusMessage → progress → raw status.
+ */
+export declare function deployProgressLabel(detail: {
+    status: string;
+    progress?: DeploymentProgress;
+    statusMessage?: string | null;
+}): string;
 export declare function fetchLogs(args: {
     baseUrl: string;
     after?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"logs-client.d.ts","sourceRoot":"","sources":["../../src/internal/logs-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAW7E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAcf,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,CAgBR;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxB;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC5E"}
+{"version":3,"file":"logs-client.d.ts","sourceRoot":"","sources":["../../src/internal/logs-client.ts"],"names":[],"mappings":"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"}

package/dist/internal/logs-client.js

@@ -24,7 +24,9 @@ function isAborted(signal) {
 const PROGRESS_MESSAGES = {
     queued: "Waiting to start…",
     preparing: "Preparing runtime…",
-    building: "Building and starting agent…",
+    creating: "Creating runtime…",
+    building: "Checking out source and installing dependencies…",
+    starting: "Starting agent and waiting for health…",
     finalizing: "Finishing deployment…",
     running: "Deployment running",
     failed: "Deploy failed",
@@ -32,7 +34,12 @@ const PROGRESS_MESSAGES = {
     stopped: "Deployment stopped",
     degraded: "Deployment degraded",
 };
-export function progressMessage(progress, lastError) {
+/**
+ * Customer-facing line for the current deploy step. Prefer the live
+ * `statusMessage` from the API when present; otherwise the progress
+ * vocabulary. Failed/degraded always append sanitized `lastError`.
+ */
+export function progressMessage(progress, lastError, statusMessage) {
     if (progress === "failed") {
         const detail = lastError === null || lastError === undefined || lastError.trim() === ""
             ? ""
@@ -45,6 +52,11 @@ export function progressMessage(progress, lastError) {
             : `: ${sanitizeCustomerError(lastError)}`;
         return `Deployment degraded${detail}`;
     }
+    if (statusMessage !== null &&
+        statusMessage !== undefined &&
+        statusMessage.trim() !== "") {
+        return statusMessage.trim();
+    }
     return PROGRESS_MESSAGES[progress];
 }
 /** Strip obvious hosting internals from error text shown to customers. */
@@ -56,7 +68,31 @@ export function sanitizeCustomerError(message) {
         .replace(/\bcursorvm\.com\b/gi, "host")
         .replace(/\bx-anyrun-[a-z0-9-]+\b/gi, "header")
         .replace(/\bPROVISIONING\b/g, "building")
-        .replace(/\bPLANNED\b/g, "preparing");
+        .replace(/\bPLANNED\b/g, "preparing")
+        .replace(/\bgitCloneCheckout\b/gi, "git clone")
+        .replace(/\bgitFetchCheckout\b/gi, "git fetch")
+        .replace(/\bgitCheckout:clone\b/gi, "checkout")
+        .replace(/\bgitCheckout:fetch\b/gi, "checkout");
+}
+/**
+ * One-line label for `agentkit deploy` polling (TTY spinner / non-TTY
+ * transitions). Uses statusMessage → progress → raw status.
+ */
+export function deployProgressLabel(detail) {
+    if (detail.statusMessage !== null &&
+        detail.statusMessage !== undefined &&
+        detail.statusMessage.trim() !== "") {
+        return detail.statusMessage
+            .trim()
+            .replace(/…$/, "")
+            .replace(/\.\.\.$/, "");
+    }
+    if (detail.progress !== undefined) {
+        return PROGRESS_MESSAGES[detail.progress]
+            .replace(/…$/, "")
+            .replace(/\.\.\.$/, "");
+    }
+    return detail.status;
 }
 export function fetchLogs(args) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -139,7 +175,7 @@ function followProdLogs(args) {
             // cmdLogs (which wires deploy auth).
             throw new Error("Internal error: deploy progress requires a deployment lookup.");
         }));
-        let lastProgress;
+        let lastEmittedKey;
         const slugHint = args.slug !== undefined && args.slug !== "" ? args.slug : "";
         if (args.once !== true) {
             const label = slugHint !== "" ? slugHint : "deployment";
@@ -157,27 +193,27 @@ function followProdLogs(args) {
                 throw customerDeployLookupError(error);
             }
             const progress = resolveProgress(detail);
+            const message = progressMessage(progress, detail.lastError, detail.statusMessage);
+            const emitKey = `${progress}\0${message}`;
             if (progress === "failed") {
-                const message = progressMessage(progress, detail.lastError);
-                if (progress !== lastProgress) {
-                    lastProgress = progress;
+                if (emitKey !== lastEmittedKey) {
+                    lastEmittedKey = emitKey;
                     emitProgress(args.write, args.json === true, progress, message);
                 }
                 throw new Error(`Deployment "${detail.slug}" failed.`);
             }
             if (progress === "stopped") {
-                const message = progressMessage(progress, detail.lastError);
-                if (progress !== lastProgress) {
-                    lastProgress = progress;
+                if (emitKey !== lastEmittedKey) {
+                    lastEmittedKey = emitKey;
                     emitProgress(args.write, args.json === true, progress, message);
                 }
                 throw new Error(`Deployment "${detail.slug}" is stopped.`);
             }
             if (progress === "running" || progress === "degraded") {
                 // Hand off to runtime logs. Print degraded once; skip a "running" line.
-                if (progress === "degraded" && progress !== lastProgress) {
-                    lastProgress = progress;
-                    emitProgress(args.write, args.json === true, progress, progressMessage(progress, detail.lastError));
+                if (progress === "degraded" && emitKey !== lastEmittedKey) {
+                    lastEmittedKey = emitKey;
+                    emitProgress(args.write, args.json === true, progress, message);
                 }
                 const runtime = yield resolveRuntime();
                 yield followRuntimeLogs({
@@ -196,9 +232,8 @@ function followProdLogs(args) {
                 });
                 return;
             }
-            const message = progressMessage(progress, detail.lastError);
-            if (progress !== lastProgress) {
-                lastProgress = progress;
+            if (emitKey !== lastEmittedKey) {
+                lastEmittedKey = emitKey;
                 emitProgress(args.write, args.json === true, progress, message);
             }
             if (args.once === true) {

package/dist/internal/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAoFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CA2lB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAoFrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAapE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAYD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAsmB3B"}

package/dist/internal/server.js

@@ -272,6 +272,10 @@ export function startServer(mounts_1) {
                             engine.trackBackground(promise);
                         },
                         resolveApproval: (sessionId, callId, decision, auth) => engine.resolveApproval(sessionId, callId, decision, auth),
+                        hasContinuationSession: (continuationToken) => engine.hasContinuationSession(channel.id, continuationToken),
+                        isContinuationBusy: (continuationToken) => engine.isContinuationBusy(channel.id, continuationToken),
+                        getContinuationLastBotMessageTs: (continuationToken) => engine.getContinuationLastBotMessageTs(channel.id, continuationToken),
+                        interruptContinuation: (continuationToken) => engine.interruptContinuation(channel.id, continuationToken),
                         logger,
                     };
                     try {
@@ -1254,6 +1258,10 @@ function startCursorSlackRelay(input) {
                     envelope,
                     send: args.send,
                     host: args.host,
+                    hasContinuationSession: (continuationToken) => target.runtime.engine.hasContinuationSession(target.channelId, continuationToken),
+                    isContinuationBusy: (continuationToken) => target.runtime.engine.isContinuationBusy(target.channelId, continuationToken),
+                    getContinuationLastBotMessageTs: (continuationToken) => target.runtime.engine.getContinuationLastBotMessageTs(target.channelId, continuationToken),
+                    interruptContinuation: (continuationToken) => target.runtime.engine.interruptContinuation(target.channelId, continuationToken),
                 });
             }),
         });