@cursor/july 0.1.93 → 0.1.95

package/dist/internal/advertise-tools.js

@@ -23,6 +23,10 @@
  * `normalizeMcpToolName` uses for IDE/Sand MCP tools. A listing failure
  * still fails the turn rather than running it with a silently shrunken
  * toolset.
+ *
+ * `defineConnection({ effects })` filters the listing before names are
+ * assigned: only tools whose MCP annotations classify as an intended
+ * effect are advertised. Unclassified tools are omitted, not guessed.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -35,6 +39,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { brandDefinition } from "./brand.js";
 import { sanitizeMcpToolName, suffixMcpToolName, } from "./sanitize-mcp-tool-name.js";
+import { classifyAnnotationsEffect } from "./tool-policy.js";
 /**
  * Model-facing advertised names after {@link sanitizeMcpToolName} — the
  * same MCP-client shape the Cursor-account bridge documents
@@ -62,15 +67,21 @@ export function resolveAdvertisedTools(args) {
         const claimed = new Set(args.agent.tools.map((tool) => tool.name));
         const resolved = [];
         for (const connection of advertising) {
-            const source = yield sourceFor(connection, args.session, args.hostMcp);
             let listed;
+            let source;
             try {
+                source = yield sourceFor(connection, args.session, args.hostMcp);
                 listed = yield source.listTools();
             }
             catch (error) {
+                if (args.onConnectionError !== undefined) {
+                    args.onConnectionError(connection.name, error);
+                    continue;
+                }
                 throw new Error(`Failed to list tools on advertised connection "${connection.name}": ${describeError(error)}`, { cause: error });
             }
-            const exposed = exposeListedTools(listed, claimed);
+            const intended = listed.filter((info) => matchesIntendedEffects(info.annotations, connection.effects));
+            const exposed = exposeListedTools(intended, claimed);
             for (const { info, exposedName } of exposed) {
                 resolved.push(toDiscoveredTool(connection, info, exposedName, source));
                 claimed.add(exposedName);
@@ -146,6 +157,13 @@ function exposeListedTools(listed, claimed) {
         exposedName: exposedNameByInfo.get(info),
     }));
 }
+function matchesIntendedEffects(annotations, effects) {
+    if (effects === undefined) {
+        return true;
+    }
+    const effect = classifyAnnotationsEffect(annotations);
+    return effect !== undefined && effects.includes(effect);
+}
 function toDiscoveredTool(connection, info, exposedName, source) {
     var _a;
     const description = info.description === undefined || info.description.trim() === ""
@@ -153,14 +171,34 @@ function toDiscoveredTool(connection, info, exposedName, source) {
         : info.description;
     const inputSchema = (_a = info.inputSchema) !== null && _a !== void 0 ? _a : ANY_OBJECT_SCHEMA;
     const outputSchema = info.outputSchema;
-    const definition = brandDefinition("tool", Object.assign(Object.assign({ description,
-        inputSchema }, (outputSchema === undefined ? {} : { outputSchema })), { execute: (input) => __awaiter(this, void 0, void 0, function* () {
+    const effect = connection.effects === undefined
+        ? undefined
+        : classifyAnnotationsEffect(info.annotations);
+    const definition = brandDefinition("tool", {
+        description,
+        inputSchema,
+        outputSchema,
+        effect,
+        execute: (input) => __awaiter(this, void 0, void 0, function* () {
             return formatMcpToolResult(connection.name, info.name, yield source.callTool(info.name, input !== null && input !== void 0 ? input : {}));
-        }) }));
-    return Object.assign(Object.assign(Object.assign(Object.assign({ name: exposedName, description,
-        inputSchema }, (outputSchema === undefined ? {} : { outputSchema })), { execution: "server", needsApproval: false }), (info.annotations === undefined
-        ? {}
-        : { annotations: info.annotations })), { advertised: true, definition });
+        }),
+    });
+    return {
+        name: exposedName,
+        description,
+        inputSchema,
+        outputSchema,
+        execution: "server",
+        needsApproval: false,
+        effect,
+        // The server's own annotations ride along (bounded at listing time), so
+        // the harness listing carries them and effect classification can read
+        // them. Absent stays absent — the fail-closed state.
+        annotations: info.annotations,
+        advertised: true,
+        connection: connection.name,
+        definition,
+    };
 }
 /**
  * Render an MCP call result for the model: text parts joined, non-text

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

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

package/dist/internal/cli-deploy.js

@@ -139,18 +139,34 @@ export function cmdDeploy(options) {
         if (typeof targets === "number") {
             return targets;
         }
+        if (targets.length === 1) {
+            return deployOne(ctx, options, targets[0]);
+        }
+        // Multi-agent parent: when every child declares `architecture: "v2"`,
+        // the v2 control plane models sibling agents as release components of
+        // ONE application, so deploy them together (one app, one component per
+        // child) instead of minting a separate application per child. Mixed and
+        // v1 parents keep the per-child sequential deploys.
+        const manifests = [];
+        for (const target of targets) {
+            manifests.push(yield readDeployManifest(target.dir));
+        }
+        if (manifests.every((manifest) => manifest.architecture === "v2")) {
+            return deployAgentsdkApplication(ctx, options, targets);
+        }
+        if (!ctx.json &&
+            manifests.some((manifest) => manifest.architecture === "v2")) {
+            ctx.err(`warning: agents under this parent mix architectures; deploying each separately (v2 children become standalone single-component applications).\n`);
+        }
         // --path is per-agent (relative to the repo root). When deploying several
         // agents, ignore a shared --path so each target can infer its own path.
         let deployOptions = options;
-        if (targets.length > 1 && options.path !== undefined) {
+        if (options.path !== undefined) {
             if (!ctx.json) {
                 ctx.err(`warning: ignoring --path ${JSON.stringify(options.path)} for a multi-agent deploy; each agent infers its own path from git.\n`);
             }
             deployOptions = Object.assign(Object.assign({}, options), { path: undefined });
         }
-        if (targets.length === 1) {
-            return deployOne(ctx, deployOptions, targets[0]);
-        }
         // Multi-agent batch: deploy sequentially; --json emits an array.
         const jsonResults = [];
         let failures = 0;
@@ -295,6 +311,16 @@ function resolveDeployTargets(options, ctx) {
             }
             return [match];
         }
+        // An all-v2 parent deploys as ONE application (siblings are components
+        // of a single app on the v2 control plane), so "deploy the parent" is
+        // unambiguous and needs no picker or --all. A child that is v1 — or
+        // fails to load — keeps the interactive picker below.
+        if (yield allChildrenAreV2(children)) {
+            if (!ctx.json) {
+                ctx.err(`Deploying all ${children.length} v2 agents under ${basename(dir)} as one application (pass --slug <name> to deploy a single agent standalone).\n`);
+            }
+            return [...children];
+        }
         const chooser = (_b = options.chooseTargets) !== null && _b !== void 0 ? _b : ((agents) => { var _a, _b; return promptChooseDeployTargets(agents, {
             err: ctx.err,
             stdin: (_a = options.stdin) !== null && _a !== void 0 ? _a : process.stdin,
@@ -319,6 +345,27 @@ function resolveDeployTargets(options, ctx) {
 function formatAgentList(agents) {
     return agents.map((agent, i) => `  ${i + 1}) ${agent.slug}\n`).join("");
 }
+/**
+ * True when every child agent project loads and declares
+ * `architecture: "v2"`. Broken projects count as not-v2 so target
+ * resolution falls back to the picker instead of failing the whole deploy
+ * on a child the user might not even select.
+ */
+function allChildrenAreV2(children) {
+    return __awaiter(this, void 0, void 0, function* () {
+        for (const child of children) {
+            try {
+                if ((yield readDeployManifest(child.dir)).architecture !== "v2") {
+                    return false;
+                }
+            }
+            catch (_a) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
 /**
  * TTY picker for multi-agent parents. Non-interactive callers get `[]`
  * so {@link resolveDeployTargets} can print the --slug/--all hint.
@@ -526,6 +573,76 @@ function deployOne(ctx, options, target, extras) {
         return 0;
     });
 }
+/**
+ * Multi-agent parent whose children all declare `architecture: "v2"`:
+ * deploy ONE application whose release carries a component per child. The
+ * application slug derives from the parent directory name; each component
+ * key is the child's slug and its path is the child directory relative to
+ * the repo root (a shared --path names the parent's directory in the repo).
+ */
+function deployAgentsdkApplication(ctx, options, targets) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const parentDir = resolve((_a = options.dir) !== null && _a !== void 0 ? _a : ".");
+        const slug = slugFromDirectoryName(basename(parentDir));
+        if (slug === undefined) {
+            ctx.err(`Could not derive an application slug from the parent directory name ${JSON.stringify(basename(parentDir))} — rename it (deploy slugs use lowercase letters, digits, '-' or '_').\n`);
+            return 1;
+        }
+        const needsGitInference = options.repo === undefined ||
+            options.ref === undefined ||
+            options.path === undefined;
+        const inferred = needsGitInference
+            ? yield inferDeployGitSource(parentDir, Object.assign({}, (options.git === undefined ? {} : { git: options.git })))
+            : {};
+        const gitRepoUrl = (_b = options.repo) !== null && _b !== void 0 ? _b : inferred.gitRepoUrl;
+        const gitRef = (_c = options.ref) !== null && _c !== void 0 ? _c : inferred.gitRef;
+        const parentPath = (_d = options.path) !== null && _d !== void 0 ? _d : inferred.agentPath;
+        if (gitRepoUrl !== undefined && !gitRepoUrl.startsWith("https://")) {
+            ctx.err(`Invalid --repo: ${gitRepoUrl} (expected an https:// git repository URL)\n`);
+            return 1;
+        }
+        if (gitRepoUrl === undefined) {
+            ctx.err(`Could not resolve an https:// git repository URL for this deploy.\n` +
+                `  Pass --repo https://github.com/<owner>/<repo> (inferred from origin when possible).\n`);
+            return 1;
+        }
+        for (const repo of (_e = options.cursorEventsRepos) !== null && _e !== void 0 ? _e : []) {
+            if (!isValidCursorEventRepo(repo)) {
+                ctx.err(`Invalid --cursor-events-repo: ${repo} (expected owner/name)\n`);
+                return 1;
+            }
+        }
+        const components = targets.map((target) => ({
+            componentKey: target.slug,
+            agentPath: [parentPath, basename(target.dir)]
+                .filter((part) => part !== undefined && part !== "")
+                .join("/"),
+        }));
+        if (!ctx.json) {
+            ctx.err(`Deploying "${slug}" as one v2 application with ${targets.length} components (slug from the parent directory name).\n` +
+                `  architecture: v2\n` +
+                `  source: ${gitRepoUrl}${gitRef === undefined ? "" : ` @ ${gitRef}`}\n` +
+                components
+                    .map((component) => { var _a; return `  component: ${component.componentKey} (${(_a = component.agentPath) !== null && _a !== void 0 ? _a : "."})\n`; })
+                    .join(""));
+        }
+        // Components bake sequentially on the control plane, so the default wait
+        // budget is per component; otherwise a 2+ component deploy routinely hits
+        // the client-side timeout while the server-side deploy is still fine. An
+        // explicitly passed timeout always wins.
+        const waitCtx = options.timeoutMs === undefined
+            ? Object.assign(Object.assign({}, ctx), { timeoutMs: ctx.timeoutMs * targets.length }) : ctx;
+        return deployOneAgentsdk(waitCtx, undefined, {
+            slug,
+            gitRepoUrl,
+            gitRef,
+            agentPath: undefined,
+            components,
+            repositories: options.cursorEventsRepos,
+        });
+    });
+}
 /**
  * `architecture: "v2"` deploy: POST `/internal/agentkit/deployments` and
  * poll the matching GET. The v2 accept path starts freeze bake; it does
@@ -534,6 +651,11 @@ function deployOne(ctx, options, target, extras) {
 function deployOneAgentsdk(ctx, extras, args) {
     return __awaiter(this, void 0, void 0, function* () {
         const { slug } = args;
+        const componentsLine = args.components === undefined
+            ? ""
+            : `  components:  ${args.components
+                .map((component) => component.componentKey)
+                .join(", ")}\n`;
         let accepted;
         try {
             accepted = yield ctx.client.deployAgentkit({
@@ -542,6 +664,7 @@ function deployOneAgentsdk(ctx, extras, args) {
                 gitRepoUrl: args.gitRepoUrl,
                 gitRef: args.gitRef,
                 agentPath: args.agentPath,
+                components: args.components,
                 repositories: args.repositories,
             });
         }
@@ -558,7 +681,8 @@ function deployOneAgentsdk(ctx, extras, args) {
             else {
                 ctx.out(`Deploy accepted: ${slug} (team ${ctx.teamId}, v2)\n` +
                     `  application: ${accepted.applicationId}\n` +
-                    `  release:     ${accepted.releaseId}\n`);
+                    `  release:     ${accepted.releaseId}\n` +
+                    componentsLine);
             }
             return 0;
         }
@@ -585,7 +709,12 @@ function deployOneAgentsdk(ctx, extras, args) {
             `  status:       running\n` +
             `  architecture: v2\n` +
             `  application:  ${detail.applicationId}\n` +
-            `  release:      ${detail.releaseId}\n`);
+            `  release:      ${detail.releaseId}\n` +
+            (args.components === undefined
+                ? ""
+                : `  components:   ${args.components
+                    .map((component) => component.componentKey)
+                    .join(", ")}\n`));
         return 0;
     });
 }

package/dist/internal/cli-mcp-oauth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-mcp-oauth.d.ts","sourceRoot":"","sources":["../../src/internal/cli-mcp-oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAiB5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAiBF,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA0DjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC3E;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAElB;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAoG7B"}
+{"version":3,"file":"cli-mcp-oauth.d.ts","sourceRoot":"","sources":["../../src/internal/cli-mcp-oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAiB5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAiBF,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA4DjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC3E;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAElB;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAoG7B"}

package/dist/internal/cli-mcp-oauth.js

@@ -43,14 +43,17 @@ function describe(error) {
 }
 export function cmdMcpOauth(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
+        var _a, _b, _c;
         const err = (_a = options.err) !== null && _a !== void 0 ? _a : ((text) => process.stderr.write(text));
         const out = (_b = options.out) !== null && _b !== void 0 ? _b : ((text) => process.stdout.write(text));
         const project = yield loadAgentProject(options.dir);
-        const connection = project.agent.connections.find((entry) => entry.name === options.connection);
+        const authored = [
+            ...project.agent.connections,
+            ...((_c = project.agent.hostConnections) !== null && _c !== void 0 ? _c : []),
+        ];
+        const connection = authored.find((entry) => entry.name === options.connection);
         if (connection === undefined) {
-            const known = project.agent.connections.map((entry) => entry.name).join(", ") ||
-                "(none)";
+            const known = authored.map((entry) => entry.name).join(", ") || "(none)";
             err(`${LOG_PREFIX} Unknown MCP connection "${options.connection}". Authored: ${known}.\n`);
             return 1;
         }

package/dist/internal/conversation-mirror.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Durable mirror for the SDK runner's conversation store.
+ *
+ * The Cursor SDK keeps each local conversation in SQLite under the engine's
+ * state root (`runner/index.db` + `runner/agents/agent-<hash>/store.db`).
+ * That disk dies with the pod: on architecture v2, session **records** and
+ * event chunks survive replacement through the control-plane storage mirror
+ * (framework-storage-selection.ts), but the conversation itself was never
+ * hydrated anywhere — a replacement pod resumed every thread as a fresh
+ * conversation.
+ *
+ * This module mirrors the conversation through the SDK's own store APIs —
+ * the agent document (which carries `sdkMetadata.blobEncryptionKey`, without
+ * which the checkpoint blobs cannot be decrypted) plus its content-addressed
+ * checkpoint blobs — into the deployment's shared file storage. On
+ * Cursor-managed hosting that is the Agent Store reached over
+ * `/v0/agent-serve-files` presigned URLs: the store is **not mounted** as a
+ * filesystem in the engine VM (the FUSE mount at
+ * {@link DEPLOYMENT_STORE_MOUNT_PATH} exists only on cloud-runtime VMs), so
+ * the mirror moves bytes through the {@link FileSink} contract instead.
+ *
+ * Going through the store APIs rather than copying `store.db` files sidesteps
+ * WAL consistency and the shared `index.db` (per-session raw copies would
+ * clobber other sessions' rows); checkpoint blobs are content-addressed, so
+ * repeat persists upload only what is new.
+ *
+ * Timing: the runner hydrates before `Agent.resume` (so a follow-up landing
+ * on a fresh pod — including a v2 hosted-execution delivery — finds the
+ * conversation before the turn runs) and persists after each local turn
+ * settles, **awaited**, because a hosted pod can be parked immediately after
+ * the execution reply.
+ *
+ * Run rows and run events are deliberately not mirrored: they are per-pod
+ * bookkeeping (turn numbers, stream offsets), and the durable session event
+ * stream already lives in the control-plane storage mirror.
+ */
+import type { LocalAgentStore } from "@cursor/sdk";
+import { type FileSink } from "../files.js";
+import type { AgentProject } from "../types.js";
+/**
+ * Persist/restore one SDK conversation between a {@link LocalAgentStore} and
+ * durable file storage. Implemented by {@link createConversationMirror};
+ * consumed by the SDK runner.
+ */
+export interface ConversationMirror {
+    /**
+     * Restore `sdkAgentId`'s conversation into `store` when the store does not
+     * already hold it. Resolves `true` when a conversation was restored,
+     * `false` on a definitive miss (never persisted, or already local — the
+     * caller falls through to its fresh-conversation path). A sink **failure**
+     * propagates: an outage must fail the turn (retryable) rather than
+     * silently fork the thread onto a fresh conversation.
+     */
+    hydrate(store: LocalAgentStore, sdkAgentId: string): Promise<boolean>;
+    /**
+     * Mirror `sdkAgentId`'s conversation from `store` to the sink
+     * (last write wins). No-op until the conversation has a checkpoint.
+     */
+    persist(store: LocalAgentStore, sdkAgentId: string): Promise<void>;
+}
+export interface CreateConversationMirrorOptions {
+    sink: FileSink;
+    /** Agent name baked into every minted key. */
+    agentName: string;
+    logger?: (line: string) => void;
+}
+/** Build a {@link ConversationMirror} over a {@link FileSink}. */
+export declare function createConversationMirror(options: CreateConversationMirrorOptions): ConversationMirror;
+/**
+ * Whether (and over which sink) this serve process mirrors conversations.
+ *
+ * Selected for architecture-v2 agents on Cursor-managed hosting — the same
+ * generation signal as framework-storage-selection.ts, plus a provisioned
+ * deployment file store. Self-hosted v2 keeps everything on the state root
+ * (the operator owns the disk), and v1 keeps today's behavior while it runs.
+ */
+export declare function selectConversationMirror(input: {
+    project: AgentProject;
+    logger?: (line: string) => void;
+    env?: Record<string, string | undefined>;
+}): ConversationMirror | undefined;
+//# sourceMappingURL=conversation-mirror.d.ts.map

package/dist/internal/conversation-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-mirror.d.ts","sourceRoot":"","sources":["../../src/internal/conversation-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAsB,eAAe,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAYD,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,kBAAkB,CAwJpB;AAsDD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,GAAG,kBAAkB,GAAG,SAAS,CAqBjC"}