@cursor/july 0.1.100 → 0.1.102

package/dist/extensions/cursor-cloud-agents/tools/dump.js

@@ -0,0 +1,54 @@
+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, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { defineTool } from "../../../tools.js";
+import { cloudAgentsBackend } from "../lib/backend.js";
+import { assertOwned } from "../lib/fleet.js";
+import { agentRef } from "../lib/inputs.js";
+import { lastAssistantText, transcriptLines, transcriptPath, } from "../lib/transcript.js";
+const dump = defineTool({
+    description: "Write a cloud agent's full conversation to a JSONL file in your workspace so you can read what it did: one JSON message per line (prompts, assistant text, thinking, tool calls). Read the last line for the final report.",
+    effect: "read",
+    inputSchema: agentRef,
+    execute(input, ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield assertOwned(ctx, input.agent_id);
+            const backend = cloudAgentsBackend();
+            const [messages, info] = yield Promise.all([
+                backend.conversation(input.agent_id),
+                backend.info(input.agent_id),
+            ]);
+            if (messages.length === 0) {
+                return {
+                    agentId: input.agent_id,
+                    lineCount: 0,
+                    status: info.status,
+                    note: "The agent has not produced any transcript yet.",
+                };
+            }
+            // Absolute: the harness's shell does not run in the workspace directory.
+            const path = join(ctx.workspaceDir, transcriptPath(input.agent_id));
+            const jsonl = `${transcriptLines(messages).join("\n")}\n`;
+            yield mkdir(dirname(path), { recursive: true });
+            yield writeFile(path, jsonl, "utf8");
+            return {
+                agentId: input.agent_id,
+                path,
+                sizeBytes: Buffer.byteLength(jsonl),
+                lineCount: messages.length,
+                status: info.status,
+                finalMessage: lastAssistantText(messages),
+                note: `One JSON message per line. Grep it, or read the final report with \`tail -n 1 ${path}\`.`,
+            };
+        });
+    },
+});
+export default dump;

package/dist/extensions/cursor-cloud-agents/tools/get.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const get: ToolDefinition;
+export default get;
+//# sourceMappingURL=get.d.ts.map

package/dist/extensions/cursor-cloud-agents/tools/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/get.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD,QAAA,MAAM,GAAG,EAAE,cAST,CAAC;eAEY,GAAG"}

package/dist/extensions/cursor-cloud-agents/tools/get.js

@@ -0,0 +1,25 @@
+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 { defineTool } from "../../../tools.js";
+import { cloudAgentsBackend } from "../lib/backend.js";
+import { assertOwned } from "../lib/fleet.js";
+import { agentRef } from "../lib/inputs.js";
+const get = defineTool({
+    description: "Look up a cloud agent you launched by id: its status, branch, pull request, changed-file counts, summary, and any error. Use dump to read everything it did.",
+    effect: "read",
+    inputSchema: agentRef,
+    execute(input, ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield assertOwned(ctx, input.agent_id);
+            return cloudAgentsBackend().info(input.agent_id);
+        });
+    },
+});
+export default get;

package/dist/extensions/cursor-cloud-agents/tools/launch.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const launch: ToolDefinition;
+export default launch;
+//# sourceMappingURL=launch.d.ts.map

package/dist/extensions/cursor-cloud-agents/tools/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/launch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,MAAM,EAAE,cAqDZ,CAAC;eAEY,MAAM"}

package/dist/extensions/cursor-cloud-agents/tools/launch.js

@@ -0,0 +1,59 @@
+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 { z } from "zod";
+import { defineTool } from "../../../tools.js";
+import extension from "../extension.js";
+import { cloudAgentsBackend } from "../lib/backend.js";
+import { recordLaunch } from "../lib/fleet.js";
+import { launchRepos } from "../lib/repos.js";
+const launch = defineTool({
+    description: "Launch a Cursor cloud agent on a repository with a self-contained task. Returns the agent id and URL; check on it with get, read what it did with dump.",
+    effect: "write",
+    needsApproval: () => extension.config.needsApproval,
+    inputSchema: z.object({
+        prompt: z
+            .string()
+            .min(1)
+            .describe("Self-contained task: goal, constraints, and what done looks like."),
+        repo: z
+            .string()
+            .url()
+            .optional()
+            .describe("GitHub repository URL, one of the configured repositories. Defaults to the configured repository."),
+        starting_ref: z
+            .string()
+            .optional()
+            .describe("Branch or commit to start from; defaults to the configured or default branch."),
+        pr_url: z
+            .string()
+            .url()
+            .optional()
+            .describe("Work on this pull request's branch instead of a new one."),
+        name: z
+            .string()
+            .max(100)
+            .optional()
+            .describe("Display name; derived from the prompt when omitted."),
+    }),
+    execute(input, ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { cloud, model } = extension.config;
+            const launched = yield cloudAgentsBackend().launch({
+                prompt: input.prompt,
+                name: input.name,
+                model,
+                cloud: Object.assign(Object.assign({}, cloud), { repos: launchRepos({ repo: input.repo, ref: input.starting_ref, prUrl: input.pr_url }, cloud) }),
+            });
+            yield recordLaunch(ctx, launched.agentId, input.name);
+            return launched;
+        });
+    },
+});
+export default launch;

package/dist/extensions/cursor-cloud-agents/tools/list.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const list: ToolDefinition;
+export default list;
+//# sourceMappingURL=list.d.ts.map

package/dist/extensions/cursor-cloud-agents/tools/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,QAAA,MAAM,IAAI,EAAE,cAsBV,CAAC;eAEY,IAAI"}

package/dist/extensions/cursor-cloud-agents/tools/list.js

@@ -0,0 +1,36 @@
+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 { z } from "zod";
+import { defineTool } from "../../../tools.js";
+import { agentUrl } from "../lib/backend.js";
+import { listFleet } from "../lib/fleet.js";
+const list = defineTool({
+    description: 'List the cloud agents launched in this session, newest first. Pass scope "all" for every agent you launched, in any session.',
+    effect: "read",
+    inputSchema: z.object({
+        scope: z
+            .enum(["session", "all"])
+            .default("session")
+            .describe("session: agents this session launched; all: every agent launched by you, in any session."),
+        limit: z.number().int().min(1).max(100).default(20),
+    }),
+    execute(input, ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const fleet = yield listFleet(ctx, input.scope);
+            return {
+                sessionId: ctx.session.id,
+                agents: fleet
+                    .slice(0, input.limit)
+                    .map((entry) => (Object.assign(Object.assign({}, entry), { url: agentUrl(entry.agentId) }))),
+            };
+        });
+    },
+});
+export default list;

package/dist/extensions/cursor-cloud-agents/tools/reply.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const reply: ToolDefinition;
+export default reply;
+//# sourceMappingURL=reply.d.ts.map

package/dist/extensions/cursor-cloud-agents/tools/reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/reply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,KAAK,EAAE,cAuBX,CAAC;eAEY,KAAK"}

package/dist/extensions/cursor-cloud-agents/tools/reply.js

@@ -0,0 +1,35 @@
+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 { z } from "zod";
+import { defineTool } from "../../../tools.js";
+import extension from "../extension.js";
+import { cloudAgentsBackend } from "../lib/backend.js";
+import { assertOwned } from "../lib/fleet.js";
+import { agentRef } from "../lib/inputs.js";
+const reply = defineTool({
+    description: "Send a follow-up prompt to a cloud agent you launched. It queues behind the current run; pass interrupt to stop that run's current step and deliver it now.",
+    effect: "write",
+    needsApproval: () => extension.config.needsApproval,
+    inputSchema: agentRef.extend({
+        prompt: z.string().min(1).describe("The follow-up instruction."),
+        interrupt: z
+            .boolean()
+            .default(false)
+            .describe("Deliver now, cancelling the in-flight step, instead of waiting for the current run to finish."),
+    }),
+    execute(input, ctx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield assertOwned(ctx, input.agent_id);
+            const { runId } = yield cloudAgentsBackend().followUp(input.agent_id, input.prompt, input.interrupt);
+            return { agentId: input.agent_id, runId, queued: !input.interrupt };
+        });
+    },
+});
+export default reply;

package/dist/extensions.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Extensions — agent-shaped trees an agent mounts under a namespace.
+ *
+ * An extension is a directory laid out like `agent/`: `extension.ts`
+ * declares it, `tools/<name>.ts` and `skills/<name>.md|ts` are its
+ * contributions, `lib/` holds shared code.
+ *
+ * ```ts
+ * // extension.ts
+ * import { defineExtension } from "@cursor/july/extensions";
+ * import { z } from "zod";
+ *
+ * export default defineExtension({
+ *   root: import.meta.dirname,
+ *   description: "Investigate failing CI builds.",
+ *   config: z.object({ org: z.string(), token: z.string() }),
+ * });
+ *
+ * // tools/failed_jobs.ts
+ * import extension from "../extension.js";
+ *
+ * export default defineTool({
+ *   description: "List the failed jobs of a build.",
+ *   execute: (input) => failedJobs(extension.config, input),
+ * });
+ * ```
+ *
+ * A consumer mounts it from `agent/extensions/<ns>.ts`; the filename is the
+ * namespace, and every contribution is exposed as `<ns>__<name>`
+ * (`ci__failed_jobs`). `__` is reserved for that: an authored `agent/tools/`
+ * or `agent/skills/` name may not contain it.
+ *
+ * ```ts
+ * // agent/extensions/ci.ts
+ * import ci from "@acme/ci-triage";
+ *
+ * export default ci({ org: "acme", token: process.env.BUILDKITE_TOKEN! });
+ * ```
+ *
+ * To adjust a contribution, mount as a directory instead and overlay the
+ * slot: `agent/extensions/ci/extension.ts` holds the mount, and
+ * `agent/extensions/ci/tools/job_log.ts` replaces `ci__job_log` — or removes
+ * it with `export default disableTool()`.
+ *
+ * A Cursor plugin (the marketplace format: `.cursor-plugin/plugin.json`,
+ * `skills/`, `commands/`, `agents/`, `mcp.json`) mounts the same way with
+ * `cursorPlugin`. Its skills and commands become `<ns>__<name>` skills, its
+ * agents `<ns>__<name>` subagents, and its MCP servers `<ns>__<server>`
+ * connections. Rules and hooks are not mounted yet.
+ *
+ * ```ts
+ * // agent/extensions/notion.ts
+ * import { cursorPlugin } from "@cursor/july/extensions";
+ *
+ * export default cursorPlugin({
+ *   path: "plugins/notion-workspace",
+ *   variables: { NOTION_TOKEN: process.env.NOTION_TOKEN! },
+ * });
+ * ```
+ *
+ * A directory mount overlays its MCP servers too:
+ * `agent/extensions/notion/mcp-connections/notion.ts` replaces
+ * `notion__notion` with your own `defineConnection` (headers, `oauth`,
+ * `advertiseTools`), and `export default disableConnection()` drops a server
+ * the agent should not carry.
+ */
+import type { CursorPluginOptions, DisabledConnectionDefinition, DisabledToolDefinition, Extension, ExtensionMount, ExtensionOptions } from "./types.js";
+export type { CursorPluginDeclaration, CursorPluginOptions, DisabledConnectionDefinition, DisabledToolDefinition, DiscoveredExtension, Extension, ExtensionDeclaration, ExtensionMount, ExtensionOptions, } from "./types.js";
+export declare function defineExtension<TConfig = undefined, TInput = TConfig>(options: ExtensionOptions<TConfig, TInput>): Extension<TConfig, TInput>;
+export declare function disableTool(): DisabledToolDefinition;
+export declare function disableConnection(): DisabledConnectionDefinition;
+export declare function cursorPlugin(options: CursorPluginOptions): ExtensionMount;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,eAAe,CAAC,OAAO,GAAG,SAAS,EAAE,MAAM,GAAG,OAAO,EACnE,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,GACzC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CA6B5B;AAED,wBAAgB,WAAW,IAAI,sBAAsB,CAEpD;AAED,wBAAgB,iBAAiB,IAAI,4BAA4B,CAEhE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAUzE"}

package/dist/extensions.js

@@ -0,0 +1,112 @@
+/**
+ * Extensions — agent-shaped trees an agent mounts under a namespace.
+ *
+ * An extension is a directory laid out like `agent/`: `extension.ts`
+ * declares it, `tools/<name>.ts` and `skills/<name>.md|ts` are its
+ * contributions, `lib/` holds shared code.
+ *
+ * ```ts
+ * // extension.ts
+ * import { defineExtension } from "@cursor/july/extensions";
+ * import { z } from "zod";
+ *
+ * export default defineExtension({
+ *   root: import.meta.dirname,
+ *   description: "Investigate failing CI builds.",
+ *   config: z.object({ org: z.string(), token: z.string() }),
+ * });
+ *
+ * // tools/failed_jobs.ts
+ * import extension from "../extension.js";
+ *
+ * export default defineTool({
+ *   description: "List the failed jobs of a build.",
+ *   execute: (input) => failedJobs(extension.config, input),
+ * });
+ * ```
+ *
+ * A consumer mounts it from `agent/extensions/<ns>.ts`; the filename is the
+ * namespace, and every contribution is exposed as `<ns>__<name>`
+ * (`ci__failed_jobs`). `__` is reserved for that: an authored `agent/tools/`
+ * or `agent/skills/` name may not contain it.
+ *
+ * ```ts
+ * // agent/extensions/ci.ts
+ * import ci from "@acme/ci-triage";
+ *
+ * export default ci({ org: "acme", token: process.env.BUILDKITE_TOKEN! });
+ * ```
+ *
+ * To adjust a contribution, mount as a directory instead and overlay the
+ * slot: `agent/extensions/ci/extension.ts` holds the mount, and
+ * `agent/extensions/ci/tools/job_log.ts` replaces `ci__job_log` — or removes
+ * it with `export default disableTool()`.
+ *
+ * A Cursor plugin (the marketplace format: `.cursor-plugin/plugin.json`,
+ * `skills/`, `commands/`, `agents/`, `mcp.json`) mounts the same way with
+ * `cursorPlugin`. Its skills and commands become `<ns>__<name>` skills, its
+ * agents `<ns>__<name>` subagents, and its MCP servers `<ns>__<server>`
+ * connections. Rules and hooks are not mounted yet.
+ *
+ * ```ts
+ * // agent/extensions/notion.ts
+ * import { cursorPlugin } from "@cursor/july/extensions";
+ *
+ * export default cursorPlugin({
+ *   path: "plugins/notion-workspace",
+ *   variables: { NOTION_TOKEN: process.env.NOTION_TOKEN! },
+ * });
+ * ```
+ *
+ * A directory mount overlays its MCP servers too:
+ * `agent/extensions/notion/mcp-connections/notion.ts` replaces
+ * `notion__notion` with your own `defineConnection` (headers, `oauth`,
+ * `advertiseTools`), and `export default disableConnection()` drops a server
+ * the agent should not carry.
+ */
+import { brandDefinition } from "./internal/brand.js";
+export function defineExtension(options) {
+    let mounted;
+    const mount = (config) => {
+        const parsed = options.config === undefined
+            ? config
+            : options.config.parse(config);
+        mounted = { config: parsed };
+        return brandDefinition("extension", {
+            extension: handle,
+            config: parsed,
+        });
+    };
+    const handle = Object.defineProperties(mount, {
+        root: { value: options.root, enumerable: true },
+        description: { value: options.description, enumerable: true },
+        config: {
+            enumerable: true,
+            get() {
+                if (mounted === undefined) {
+                    throw new Error(`Extension at ${options.root} read its config before an agent mounted it. Mount it from agent/extensions/<ns>.ts; the mount runs before the tree loads.`);
+                }
+                return mounted.config;
+            },
+        },
+    });
+    return handle;
+}
+export function disableTool() {
+    return brandDefinition("disabled-tool", {});
+}
+export function disableConnection() {
+    return brandDefinition("disabled-connection", {});
+}
+export function cursorPlugin(options) {
+    var _a;
+    return brandDefinition("extension", {
+        extension: {
+            root: options.path,
+            description: undefined,
+            layout: "cursor-plugin",
+            variables: (_a = options.variables) !== null && _a !== void 0 ? _a : {},
+        },
+        config: undefined,
+    });
+}

package/dist/files-backends/cursor-hosted.d.ts

@@ -73,14 +73,6 @@ export declare const AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID_ENV_VAR = "AGENT_SERV
  * loudly when the sink is used.
  */
 export declare function isCursorHostedFilesAvailable(env?: NodeJS.ProcessEnv): boolean;
-/**
- * The framework-level store's source id, or `undefined` when the deployment
- * has none (v1, self-hosted, or a v2 deploy predating framework-store
- * provisioning). Same detection posture as
- * {@link isCursorHostedFilesAvailable}: keyed on the id alone — a missing
- * credential must fail loudly at use, not silently deselect the store.
- */
-export declare function cursorFrameworkStoreSourceId(env?: NodeJS.ProcessEnv): string | undefined;
 /**
  * Local `serve`/`run` with a personal `CURSOR_API_KEY` can address
  * `/v0/agent-serve-files/user`. Hosted deployments have a store source id

package/dist/files-backends/cursor-hosted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-hosted.d.ts","sourceRoot":"","sources":["../../src/files-backends/cursor-hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAC;AAerB;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,gCACjB,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6CAA6C,0CACjB,CAAC;AAgB1C;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAEpB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAYT;AAED,MAAM,WAAW,wBAAwB;IACvC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAuCD,KAAK,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG;IAChD,gFAAgF;IAChF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CAwXpB"}
+{"version":3,"file":"cursor-hosted.d.ts","sourceRoot":"","sources":["../../src/files-backends/cursor-hosted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EAGlB,MAAM,aAAa,CAAC;AAYrB;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,gCACjB,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6CAA6C,0CACjB,CAAC;AAgB1C;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAYT;AAED,MAAM,WAAW,wBAAwB;IACvC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAuCD,KAAK,kBAAkB,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG;IAChD,gFAAgF;IAChF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CAwXpB"}

package/dist/files-backends/cursor-hosted.js

@@ -53,7 +53,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { createHash } from "node:crypto";
 import { FileConflictError, } from "../files.js";
-import { resolveDeploymentStoreSourceIdSync, resolveFrameworkStoreSourceIdSync, } from "../internal/cursor/hosted-store-secrets.js";
+import { resolveDeploymentStoreSourceIdSync } from "../internal/cursor/hosted-store-secrets.js";
 import { createAgentStorePresignedUrlValidatorForBackend } from "./agent-store-presigned-url.js";
 /**
  * Same default as the hosted storage backend, inlined so this entrypoint does
@@ -105,16 +105,6 @@ const MAX_LIST_WALK_PAGES = 1000;
 export function isCursorHostedFilesAvailable(env = process.env) {
     return resolveDeploymentStoreSourceIdSync(env) !== undefined;
 }
-/**
- * The framework-level store's source id, or `undefined` when the deployment
- * has none (v1, self-hosted, or a v2 deploy predating framework-store
- * provisioning). Same detection posture as
- * {@link isCursorHostedFilesAvailable}: keyed on the id alone — a missing
- * credential must fail loudly at use, not silently deselect the store.
- */
-export function cursorFrameworkStoreSourceId(env = process.env) {
-    return resolveFrameworkStoreSourceIdSync(env);
-}
 /**
  * Local `serve`/`run` with a personal `CURSOR_API_KEY` can address
  * `/v0/agent-serve-files/user`. Hosted deployments have a store source id

package/dist/files.d.ts

@@ -133,7 +133,7 @@ export declare const AGENT_SERVE_USER_STORE_KEY_PREFIX = "agent-serve";
  * `--agent-store-skills-dir` walk finds them the same way it finds user-store
  * skills. Memory and artifacts stay under {@link STORAGE_KEY_ROOT}.
  */
-export declare const agentStoreKeys: {
+declare function createAgentStoreKeys(root: string): {
     readonly artifactRow: (agent: string, id: string) => string;
     readonly artifactRowPrefix: (agent: string) => string;
     readonly artifactContent: (agent: string, id: string) => string;
@@ -147,6 +147,9 @@ export declare const agentStoreKeys: {
     readonly conversationManifest: (agent: string, sdkAgentId: string) => string;
     readonly conversationBlob: (agent: string, sdkAgentId: string, blobId: string) => string;
 };
+export type AgentStoreKeys = ReturnType<typeof createAgentStoreKeys>;
+export declare const agentStoreKeys: AgentStoreKeys;
+export declare const agentSdkAgentStoreKeys: AgentStoreKeys;
 /**
  * Deployment store FUSE mount on cloud-runtime VMs. Mirrors
  * `AGENT_STORE_MOUNT_ROOT` / `AGENT_SERVE_DEPLOYMENT_STORE_MOUNT_NAME` in
@@ -177,4 +180,5 @@ export declare class FileTooLargeError extends Error {
     readonly maxBytes: number;
     constructor(key: string, size: number, maxBytes: number);
 }
+export {};
 //# sourceMappingURL=files.d.ts.map

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

@@ -22,7 +22,7 @@
  * their failure** — an author who writes evidence and then delegates has to
  * know the write did not land.
  */
-import { STORAGE_KEY_ROOT } from "./storage.js";
+import { AGENTSDK_STORAGE_KEY_ROOT, STORAGE_KEY_ROOT } from "./storage.js";
 // ============================================================================
 // Key scheme
 // ============================================================================
@@ -68,23 +68,27 @@ export const AGENT_SERVE_USER_STORE_KEY_PREFIX = "agent-serve";
  * `--agent-store-skills-dir` walk finds them the same way it finds user-store
  * skills. Memory and artifacts stay under {@link STORAGE_KEY_ROOT}.
  */
-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)}`,
-    skillFile: (skillName, relPath, skillsPrefix = "skills/") => `${skillsPrefix}${skillName}/${relPath}`,
-    skillsPrefix: () => "skills/",
-    /** Personal-key cloud agents: namespaced so they cannot collide with the user's own `skills/`. */
-    userSkillsPrefix: (agent) => `${AGENT_SERVE_USER_STORE_KEY_PREFIX}/${agent}/skills/`,
-    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`,
-    // SDK conversation mirror (the runner's SQLite store, exported through the
-    // store APIs): one manifest per SDK agent id plus its content-addressed
-    // checkpoint blobs. See internal/conversation-mirror.ts.
-    conversationManifest: (agent, sdkAgentId) => `${STORAGE_KEY_ROOT}/${agent}/conversations/${encodeURIComponent(sdkAgentId)}/manifest.json`,
-    conversationBlob: (agent, sdkAgentId, blobId) => `${STORAGE_KEY_ROOT}/${agent}/conversations/${encodeURIComponent(sdkAgentId)}/blobs/${encodeURIComponent(blobId)}`,
-};
+function createAgentStoreKeys(root) {
+    return {
+        artifactRow: (agent, id) => `${root}/${agent}/artifacts/rows/${encodeURIComponent(id)}.json`,
+        artifactRowPrefix: (agent) => `${root}/${agent}/artifacts/rows/`,
+        artifactContent: (agent, id) => `${root}/${agent}/artifacts/content/${encodeURIComponent(id)}`,
+        skillFile: (skillName, relPath, skillsPrefix = "skills/") => `${skillsPrefix}${skillName}/${relPath}`,
+        skillsPrefix: () => "skills/",
+        /** Personal-key cloud agents: namespaced so they cannot collide with the user's own `skills/`. */
+        userSkillsPrefix: (agent) => `${AGENT_SERVE_USER_STORE_KEY_PREFIX}/${agent}/skills/`,
+        memoryDir: (agent) => `${root}/${agent}/memory`,
+        memoryJournal: (agent) => `${root}/${agent}/memory/journal.jsonl`,
+        memoryJournalRotated: (agent, stamp) => `${root}/${agent}/memory/journal-${stamp}.jsonl`,
+        // SDK conversation mirror (the runner's SQLite store, exported through the
+        // store APIs): one manifest per SDK agent id plus its content-addressed
+        // checkpoint blobs. See internal/conversation-mirror.ts.
+        conversationManifest: (agent, sdkAgentId) => `${root}/${agent}/conversations/${encodeURIComponent(sdkAgentId)}/manifest.json`,
+        conversationBlob: (agent, sdkAgentId, blobId) => `${root}/${agent}/conversations/${encodeURIComponent(sdkAgentId)}/blobs/${encodeURIComponent(blobId)}`,
+    };
+}
+export const agentStoreKeys = createAgentStoreKeys(STORAGE_KEY_ROOT);
+export const agentSdkAgentStoreKeys = createAgentStoreKeys(AGENTSDK_STORAGE_KEY_ROOT);
 /**
  * Deployment store FUSE mount on cloud-runtime VMs. Mirrors
  * `AGENT_STORE_MOUNT_ROOT` / `AGENT_SERVE_DEPLOYMENT_STORE_MOUNT_NAME` in

package/dist/index.d.ts

@@ -20,6 +20,7 @@ export { allowAll, bearerAuth, DELETE, defineChannel, GET, httpChannel, localDev
 export { defineConnection } from "./connections.js";
 export type { ContinuationBuiltin, ContinuationClaim, ContinuationIdentity, ContinuationSelector, ConversationType, MailboxContinuation, ParsedContinuation, } from "./continuation.js";
 export { BUILTINS, bindMailboxContinuationSend, CONTINUATION_SELECTORS, continuationSource, defaultContinuationSelector, extractContinuation, formatConversationKey, handshakeContinuation, isContinuationSelector, mintClaim, normalizeIdentity, parseContinuationSelector, resolveContinuation, resolveV2Key, stampMailboxContinuation, V2EngineError, } from "./continuation.js";
+export { cursorPlugin, defineExtension, disableConnection, disableTool, } from "./extensions.js";
 export { defineHook } from "./hooks.js";
 export { InvalidAsOfError, VacuousTimeArgsError, } from "./internal/as-of.js";
 export type { LoadAgentProjectOptions } from "./internal/discovery.js";
@@ -40,11 +41,11 @@ export { prompt } from "./prompt.js";
 export type { ReminderBusyPolicy, ReminderCreateInput, ReminderFireContext, ReminderFireResult, ReminderHostApi, ReminderInfo, ReminderReschedule, ReminderScheduleKind, ReminderStatus, ReminderTarget, ReminderUntilContext, } from "./reminders.js";
 export { defineSchedule } from "./schedules.js";
 export { defineSkill } from "./skills.js";
-export type { DurableSessionRecord, DurableSessionSummary, StorageABTable, StorageCasTable, StorageConfig, StorageContext, StorageDefinition, StorageEntry, StorageEvalsTable, StoragePolicy, StorageRestorePolicy, } from "./storage.js";
-export { defineStorage, isDurableSessionRecordKey, parseDurableSessionRecord, STORAGE_KEY_ROOT, storageKeys, summarizeDurableSessionRecord, } from "./storage.js";
+export type { DurableSessionRecord, DurableSessionSummary, StorageABTable, StorageCasTable, StorageConfig, StorageContext, StorageDefinition, StorageEntry, StorageEvalsTable, StorageKeys, StoragePolicy, StorageRestorePolicy, } from "./storage.js";
+export { AGENTSDK_STORAGE_KEY_ROOT, agentSdkStorageKeys, defineStorage, isDurableSessionRecordKey, parseDurableSessionRecord, STORAGE_KEY_ROOT, storageKeys, storageKeysForArchitecture, summarizeDurableSessionRecord, } from "./storage.js";
 export { defineTool } from "./tools.js";
 export type * from "./types.js";
-export { cursorAccountServersHasMixedWildcard, DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, isToolEffect, MAX_RUNNING_TURNS_LIMIT, normalizeConnectionEffects, normalizeCursorAccountServers, supportsKvCas, } from "./types.js";
+export { cursorAccountServersHasMixedWildcard, DEFAULT_MODEL, DIRECT_TOOL_CALL_CHANNEL_ID, isCursorAccountTransport, isPeerConnectionTransport, isSymbolicConnectionTransport, isToolEffect, MAX_RUNNING_TURNS_LIMIT, normalizeConnectionEffects, normalizeConnectionTools, normalizeCursorAccountServers, supportsKvCas, } from "./types.js";
 /**
  * Runtime config for an agent — authored at `agent/agent.ts` (the root
  * agent) or `agent/subagents/<id>/agent.ts` (a subagent). Set