@cursor/july 0.1.32 → 0.1.34

package/dist/files.d.ts

@@ -112,6 +112,26 @@ export declare const fileKeys: {
     readonly deploymentPrefix: (agent: string) => string;
     readonly sessionPrefix: (agent: string, sessionId: string) => string;
 };
+/**
+ * Framework-owned keys for state that lives on the deployment's Agent Store
+ * but is not author `host.files` data: artifact rows and payloads, and the
+ * cross-session memory journal. Kept out of `files/` so author listings never
+ * see framework rows.
+ */
+export declare const agentStoreKeys: {
+    readonly artifactRow: (agent: string, id: string) => string;
+    readonly artifactRowPrefix: (agent: string) => string;
+    readonly artifactContent: (agent: string, id: string) => string;
+    readonly memoryDir: (agent: string) => string;
+    readonly memoryJournal: (agent: string) => string;
+    readonly memoryJournalRotated: (agent: string, stamp: string) => string;
+};
+/**
+ * Deployment store FUSE mount on cloud-runtime VMs. Mirrors
+ * `AGENT_STORE_MOUNT_ROOT` / `AGENT_SERVE_DEPLOYMENT_STORE_MOUNT_NAME` in
+ * `@anysphere/constants` (not a dependency of this published package).
+ */
+export declare const DEPLOYMENT_STORE_MOUNT_PATH = "/cursor/stores/deployment";
 /** Errors raised by the file surface. Thrown by sinks and by the framework. */
 export declare class FileConflictError extends Error {
     readonly key: string;

package/dist/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"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"}

package/dist/files.js

@@ -47,6 +47,26 @@ export const fileKeys = {
     deploymentPrefix: (agent) => `${STORAGE_KEY_ROOT}/${agent}/files/deployment/`,
     sessionPrefix: (agent, sessionId) => `${STORAGE_KEY_ROOT}/${agent}/files/sessions/${sessionId}/`,
 };
+/**
+ * Framework-owned keys for state that lives on the deployment's Agent Store
+ * but is not author `host.files` data: artifact rows and payloads, and the
+ * cross-session memory journal. Kept out of `files/` so author listings never
+ * see framework rows.
+ */
+export const agentStoreKeys = {
+    artifactRow: (agent, id) => `${STORAGE_KEY_ROOT}/${agent}/artifacts/rows/${encodeURIComponent(id)}.json`,
+    artifactRowPrefix: (agent) => `${STORAGE_KEY_ROOT}/${agent}/artifacts/rows/`,
+    artifactContent: (agent, id) => `${STORAGE_KEY_ROOT}/${agent}/artifacts/content/${encodeURIComponent(id)}`,
+    memoryDir: (agent) => `${STORAGE_KEY_ROOT}/${agent}/memory`,
+    memoryJournal: (agent) => `${STORAGE_KEY_ROOT}/${agent}/memory/journal.jsonl`,
+    memoryJournalRotated: (agent, stamp) => `${STORAGE_KEY_ROOT}/${agent}/memory/journal-${stamp}.jsonl`,
+};
+/**
+ * Deployment store FUSE mount on cloud-runtime VMs. Mirrors
+ * `AGENT_STORE_MOUNT_ROOT` / `AGENT_SERVE_DEPLOYMENT_STORE_MOUNT_NAME` in
+ * `@anysphere/constants` (not a dependency of this published package).
+ */
+export const DEPLOYMENT_STORE_MOUNT_PATH = "/cursor/stores/deployment";
 /** Errors raised by the file surface. Thrown by sinks and by the framework. */
 export class FileConflictError extends Error {
     constructor(key, options) {

package/dist/index.d.ts

@@ -23,12 +23,12 @@ export type { LoadAgentProjectOptions } from "./internal/discovery.js";
 export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
 export type { AgentServeGitHubTriggerEvent, AgentServeGitHubTriggerTarget, AgentServeTriggerEvent, AgentServeTriggerResult, AgentServeTriggerTargetResult, } from "./internal/handleAgentServeTrigger.js";
 export { collectGitHubTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
-export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, } from "./internal/mcp-endpoint.js";
+export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, TOOL_MCP_ENDPOINT_PATH, } from "./internal/mcp-endpoint.js";
 export { ReminderValidationError, UnknownReminderError, } from "./internal/reminder-runner.js";
 export type { AgentMount } from "./internal/server.js";
 export { SessionBusyError, ToolInputError, ToolNotDirectlyCallableError, UnknownChannelError, UnknownSessionError, UnknownToolError, } from "./internal/session-engine.js";
 export type { MemoryBackend, TurnMemoryRecord } from "./memory.js";
-export { fileMemoryBackend, memoryHook } from "./memory.js";
+export { agentStoreMemoryBackend, fileMemoryBackend, memoryHook, } from "./memory.js";
 export type { PromptTag } from "./prompt.js";
 export { prompt } from "./prompt.js";
 export type { ReminderBusyPolicy, ReminderCreateInput, ReminderFireContext, ReminderFireResult, ReminderHostApi, ReminderInfo, ReminderReschedule, ReminderScheduleKind, ReminderStatus, ReminderTarget, ReminderUntilContext, } from "./reminders.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -45,10 +45,10 @@ export { defineConnection } from "./connections.js";
 export { defineHook } from "./hooks.js";
 export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, projectInfo, resolveAgentMounts, } from "./internal/discovery.js";
 export { collectGitHubTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
-export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, } from "./internal/mcp-endpoint.js";
+export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, TOOL_MCP_ENDPOINT_PATH, } from "./internal/mcp-endpoint.js";
 export { ReminderValidationError, UnknownReminderError, } from "./internal/reminder-runner.js";
 export { SessionBusyError, ToolInputError, ToolNotDirectlyCallableError, UnknownChannelError, UnknownSessionError, UnknownToolError, } from "./internal/session-engine.js";
-export { fileMemoryBackend, memoryHook } from "./memory.js";
+export { agentStoreMemoryBackend, fileMemoryBackend, memoryHook, } from "./memory.js";
 export { prompt } from "./prompt.js";
 export { defineSchedule } from "./schedules.js";
 export { defineSkill } from "./skills.js";

package/dist/internal/artifacts-store.d.ts

@@ -1,17 +1,21 @@
 /**
- * Durable artifact rows behind `ctx.artifacts` ({@link ArtifactsApi}).
+ * Durable artifact rows and payloads behind `ctx.artifacts`
+ * ({@link ArtifactsApi}).
  *
- * Mirror of host-kv: when `defineStorage` is authored with `get` + `list`,
- * rows live in that sink under `storageKeys.artifact`; otherwise one
- * JSON file per row under `--state-root/artifacts`.
+ * On Cursor-managed hosting rows and file payloads live on the deployment's
+ * Agent Store (the same store behind `ctx.host.files`, so they survive
+ * deploys and are visible on cloud VMs under the store mount); otherwise
+ * they land under `--state-root/artifacts` on local disk.
  */
+import { type FileSink } from "../files.js";
 import type { ArtifactListFilter, ArtifactRecord, ArtifactsConfig, ArtifactTagInput } from "../types.js";
-import type { StorageCoordinator } from "./storage-coordinator.js";
 export interface CreateArtifactsStoreOptions {
     stateRoot: string;
-    storage?: StorageCoordinator;
+    agentName: string;
     /** `agent/artifacts.ts` config, when authored. */
     config?: ArtifactsConfig;
+    /** Explicit sink override (tests). Omitted → hosted store or local disk. */
+    sink?: FileSink;
 }
 /** Kind used by freeform tags when no kinds are declared. */
 export declare const ARTIFACT_DEFAULT_KIND = "artifact";
@@ -23,6 +27,7 @@ export declare const ARTIFACT_DEFAULT_KIND = "artifact";
  */
 export declare class ArtifactsStore {
     private readonly rows;
+    private readonly content;
     private readonly config;
     private readonly max;
     /** Serializes tags so read-modify-write upserts and eviction don't race. */
@@ -30,6 +35,9 @@ export declare class ArtifactsStore {
     constructor(options: CreateArtifactsStoreOptions);
     tag(input: ArtifactTagInput): Promise<ArtifactRecord>;
     private tagSerialized;
+    get(id: string): Promise<ArtifactRecord | undefined>;
+    /** Payload bytes for one artifact; undefined when it carries none. */
+    getContent(id: string): Promise<Uint8Array | undefined>;
     list(filter?: ArtifactListFilter): Promise<ArtifactRecord[]>;
     /**
      * Resolve the effective kind (freeform when no kinds are declared) and

package/dist/internal/artifacts-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts-store.d.ts","sourceRoot":"","sources":["../../src/internal/artifacts-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAYnE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,kDAAkD;IAClD,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAuC;IAEvD,YAAY,OAAO,EAAE,2BAA2B,EAO/C;IAED,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAIpD;YAEa,aAAa;IA6BrB,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAUjE;IAED;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;YA8BZ,YAAY;CAU3B;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD"}
+{"version":3,"file":"artifacts-store.d.ts","sourceRoot":"","sources":["../../src/internal/artifacts-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5D,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAkBrB,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAuC;IAEvD,YAAY,OAAO,EAAE,2BAA2B,EAa/C;IAED,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAIpD;YAEa,aAAa;IAkD3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAEnD;IAED,sEAAsE;IACtE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAEtD;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAUjE;IAED;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;YA8BZ,YAAY;CAgB3B;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/internal/artifacts-store.js

@@ -1,9 +1,11 @@
 /**
- * Durable artifact rows behind `ctx.artifacts` ({@link ArtifactsApi}).
+ * Durable artifact rows and payloads behind `ctx.artifacts`
+ * ({@link ArtifactsApi}).
  *
- * Mirror of host-kv: when `defineStorage` is authored with `get` + `list`,
- * rows live in that sink under `storageKeys.artifact`; otherwise one
- * JSON file per row under `--state-root/artifacts`.
+ * On Cursor-managed hosting rows and file payloads live on the deployment's
+ * Agent Store (the same store behind `ctx.host.files`, so they survive
+ * deploys and are visible on cloud VMs under the store mount); otherwise
+ * they land under `--state-root/artifacts` on local disk.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -18,6 +20,8 @@ import { createHash, randomUUID } from "node:crypto";
 import { mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import { join } from "node:path";
 import { resolveArtifactsMax } from "../artifacts.js";
+import { agentStoreKeys } from "../files.js";
+import { cursorHostedFiles, isCursorHostedFilesAvailable, } from "../files-backends/cursor-hosted.js";
 /** Kind used by freeform tags when no kinds are declared. */
 export const ARTIFACT_DEFAULT_KIND = "artifact";
 /**
@@ -31,10 +35,15 @@ export class ArtifactsStore {
         var _a;
         /** Serializes tags so read-modify-write upserts and eviction don't race. */
         this.tagChain = Promise.resolve();
-        this.rows =
-            ((_a = options.storage) === null || _a === void 0 ? void 0 : _a.supportsArtifacts) === true
-                ? createCoordinatorRowStore(options.storage)
-                : createFilesystemRowStore(options.stateRoot);
+        const sink = (_a = options.sink) !== null && _a !== void 0 ? _a : (isCursorHostedFilesAvailable() ? cursorHostedFiles() : undefined);
+        if (sink === undefined) {
+            this.rows = createFilesystemRowStore(options.stateRoot);
+            this.content = createFilesystemContentStore(options.stateRoot);
+        }
+        else {
+            this.rows = createSinkRowStore(sink, options.agentName);
+            this.content = createSinkContentStore(sink, options.agentName);
+        }
         this.config = options.config;
         this.max = resolveArtifactsMax(options.config);
     }
@@ -50,7 +59,8 @@ export class ArtifactsStore {
             const id = input.key === undefined
                 ? `art_${randomUUID()}`
                 : artifactIdForKey(input.key);
-            const existing = yield this.rows.get(id);
+            // Fresh random ids can't collide; only keyed tags upsert.
+            const existing = input.key === undefined ? undefined : yield this.rows.get(id);
             const now = new Date().toISOString();
             const record = {
                 id,
@@ -64,6 +74,26 @@ export class ArtifactsStore {
                 createdAt: (_b = existing === null || existing === void 0 ? void 0 : existing.createdAt) !== null && _b !== void 0 ? _b : now,
                 updatedAt: now,
             };
+            if (input.contents !== undefined) {
+                const body = typeof input.contents === "string"
+                    ? Buffer.from(input.contents, "utf8")
+                    : input.contents;
+                yield this.content.put(id, body);
+                record.content = {
+                    size: body.byteLength,
+                    contentType: input.contentType,
+                };
+            }
+            else if ((existing === null || existing === void 0 ? void 0 : existing.content) !== undefined) {
+                if (existing.sessionId === record.sessionId) {
+                    record.content = existing.content;
+                }
+                else {
+                    // Keys are deployment-global: rebinding a keyed row to another
+                    // session must not carry the prior session's payload with it.
+                    yield this.content.delete(id);
+                }
+            }
             yield this.rows.put(record);
             if (existing === undefined) {
                 yield this.evictPastCap();
@@ -71,6 +101,13 @@ export class ArtifactsStore {
             return record;
         });
     }
+    get(id) {
+        return this.rows.get(id);
+    }
+    /** Payload bytes for one artifact; undefined when it carries none. */
+    getContent(id) {
+        return this.content.get(id);
+    }
     list(filter) {
         return __awaiter(this, void 0, void 0, function* () {
             const records = yield this.rows.list();
@@ -113,6 +150,9 @@ export class ArtifactsStore {
     }
     evictPastCap() {
         return __awaiter(this, void 0, void 0, function* () {
+            if ((yield this.rows.count()) <= this.max) {
+                return;
+            }
             const records = yield this.rows.list();
             if (records.length <= this.max) {
                 return;
@@ -120,6 +160,9 @@ export class ArtifactsStore {
             const oldestFirst = records.sort((a, b) => byNewestUpdated(b, a));
             for (const record of oldestFirst.slice(0, records.length - this.max)) {
                 yield this.rows.delete(record.id);
+                if (record.content !== undefined) {
+                    yield this.content.delete(record.id);
+                }
             }
         });
     }
@@ -160,28 +203,83 @@ function isArtifactRecord(value) {
     }
     return true;
 }
-function createCoordinatorRowStore(storage) {
+function parseRecordBytes(bytes) {
+    if (bytes === undefined) {
+        return undefined;
+    }
+    let value;
+    try {
+        value = JSON.parse(Buffer.from(bytes).toString("utf8"));
+    }
+    catch (_a) {
+        // A corrupt row must not poison list().
+        return undefined;
+    }
+    return isArtifactRecord(value) ? value : undefined;
+}
+function sinkBody(found) {
+    if (found === undefined) {
+        return undefined;
+    }
+    return found instanceof Uint8Array ? found : found.body;
+}
+/** Rows as one JSON file each on the deployment's Agent Store. */
+function createSinkRowStore(sink, agentName) {
+    const key = (id) => agentStoreKeys.artifactRow(agentName, id);
     return {
         get(id) {
             return __awaiter(this, void 0, void 0, function* () {
-                const value = yield storage.artifactGet(id);
-                return isArtifactRecord(value) ? value : undefined;
+                return parseRecordBytes(sinkBody(yield sink.get(key(id))));
             });
         },
         put(record) {
             return __awaiter(this, void 0, void 0, function* () {
-                yield storage.artifactPut(record.id, record);
+                yield sink.put(key(record.id), Buffer.from(JSON.stringify(record), "utf8"));
             });
         },
         delete(id) {
             return __awaiter(this, void 0, void 0, function* () {
-                yield storage.artifactDelete(id);
+                yield sink.delete(key(id));
             });
         },
         list() {
             return __awaiter(this, void 0, void 0, function* () {
-                const values = yield storage.artifactList();
-                return values.filter(isArtifactRecord);
+                const entries = yield sink.list(agentStoreKeys.artifactRowPrefix(agentName));
+                const bodies = yield Promise.all(entries.map((entry) => sink.get(entry.key)));
+                const records = [];
+                for (const body of bodies) {
+                    const record = parseRecordBytes(sinkBody(body));
+                    if (record !== undefined) {
+                        records.push(record);
+                    }
+                }
+                return records;
+            });
+        },
+        count() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const entries = yield sink.list(agentStoreKeys.artifactRowPrefix(agentName));
+                return entries.length;
+            });
+        },
+    };
+}
+function createSinkContentStore(sink, agentName) {
+    const key = (id) => agentStoreKeys.artifactContent(agentName, id);
+    return {
+        get(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                return sinkBody(yield sink.get(key(id)));
+            });
+        },
+        put(id, body) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield sink.put(key(id), body);
+            });
+        },
+        delete(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield sink.delete(key(id));
             });
         },
     };
@@ -246,5 +344,51 @@ function createFilesystemRowStore(stateRoot) {
                 return records;
             });
         },
+        count() {
+            return __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const names = yield readdir(dir);
+                    return names.filter((name) => !name.startsWith(".") && name.endsWith(".json")).length;
+                }
+                catch (error) {
+                    if (error.code === "ENOENT") {
+                        return 0;
+                    }
+                    throw error;
+                }
+            });
+        },
+    };
+}
+function createFilesystemContentStore(stateRoot) {
+    const dir = join(stateRoot, "artifacts", "content");
+    const filePath = (id) => join(dir, encodeURIComponent(id));
+    return {
+        get(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                try {
+                    return new Uint8Array(yield readFile(filePath(id)));
+                }
+                catch (error) {
+                    if (error.code === "ENOENT") {
+                        return undefined;
+                    }
+                    throw error;
+                }
+            });
+        },
+        put(id, body) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield mkdir(dir, { recursive: true });
+                const tmp = join(dir, `.tmp-${randomUUID()}`);
+                yield writeFile(tmp, body);
+                yield rename(tmp, filePath(id));
+            });
+        },
+        delete(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield rm(filePath(id), { force: true });
+            });
+        },
     };
 }

package/dist/internal/cli-convert-automation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `agent-serve convert-automation <url>` — export a Cursor Automation into
+ * an agentkit project.
+ *
+ * Fetches the automation's workflow from the backend export endpoint
+ * (Bearer user API key, same credential chain as deploy), runs the pure
+ * converter, writes the converted files (wx — existing files are kept),
+ * fills in the init scaffold around them, and installs npm dependencies
+ * (like `init`). MCP servers convert to Cursor-account connections resolved
+ * at runtime (no URLs or credentials in the project; authorization is
+ * managed in Cursor, dashboard → MCP). The generated project is NEVER
+ * imported/executed here — it embeds server-derived data, so checking it is
+ * left to an explicit `validate` next step the user runs after review.
+ * Exit 0 even with warnings; nonzero only for bad args, auth/fetch
+ * failures, or filesystem write failures.
+ */
+import { installScaffoldDependencies } from "./init-project.js";
+export interface ConvertAutomationCliOptions {
+    /** Positional: automation URL or bare uuid. */
+    url?: string;
+    /** Target directory; defaults to ./<automation-name-slug>. */
+    dir?: string;
+    json?: boolean;
+    apiKey?: string;
+    /** Test seams. */
+    fetchImpl?: typeof fetch;
+    out?: (text: string) => void;
+    err?: (text: string) => void;
+    installImpl?: typeof installScaffoldDependencies;
+    cwd?: string;
+}
+/**
+ * Extract the automation uuid from a dashboard URL
+ * (`/automations/<uuid>` or `/custom-agents/<uuid>`, any origin — dev
+ * hosts included) or a bare uuid. Undefined when nothing matches.
+ */
+export declare function parseAutomationRef(input: string): string | undefined;
+export declare function cmdConvertAutomation(options: ConvertAutomationCliOptions): Promise<number>;
+//# sourceMappingURL=cli-convert-automation.d.ts.map

package/dist/internal/cli-convert-automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-convert-automation.d.ts","sourceRoot":"","sources":["../../src/internal/cli-convert-automation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsBH,OAAO,EAIL,2BAA2B,EAE5B,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,2BAA2B;IAC1C,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,2BAA2B,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0BpE;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CA8HjB"}