@cursor/bdk 0.2.6 → 0.2.7

package/dist/internal/store-api-protocol.d.ts

@@ -1,19 +1,5 @@
 /**
- * Domain-call wire contract for the factory store API:
- * `POST /internal/agentsdk/store/api/<call>` carrying a versioned JSON
- * envelope `{ v, call, payload }`. This is the lane where the **server** owns
- * the storage pattern (journal sharding, rotation, compaction), so a
- * pathological pattern is fixable in a backend deploy instead of a July
- * release plus a rebake of every deployment. The verb lane (`/flush`,
- * `/read`, `/list`) keeps carrying bulk presigned file IO.
- *
- * Deliberately duplicated on the backend
- * (`backend/server/src/factory/agent-sdk/agentsdkStoreApiProtocol.ts`): this
- * package is published to npm, so the backend cannot depend on it and it
- * cannot depend on backend packages. A backend drift test compares the two
- * sources — same shape as the hosted-delivery protocol twins — which is why
- * every exported constant here stays a single `export const NAME = <literal>;`
- * line and every schema field stays on its own line.
+ * Versioned wire contract for Cursor-managed store operations.
  *
  * Evolution rules (the compat contract): additive optional fields only; no
  * renames, no retypes, no semantic reuse of an old field; unknown fields are
@@ -23,26 +9,23 @@
  */
 import { z } from "zod";
 export declare const STORE_API_PROTOCOL_VERSION = 1;
-/** Path family on the factory surface; one segment per call. */
+/** Managed storage endpoint, with one trailing segment per call. */
 export declare const STORE_API_PATH = "/internal/agentsdk/store/api";
 export declare const STORE_API_MEMORY_APPEND_CALL = "memory.append";
 /**
  * Semantic cap on one serialized memory record. Text fields are truncated
  * client-side (`memoryHook` default 2000 chars per field), so a well-formed
  * record is a few KiB; 16 KiB is generous headroom, not a target. The cap is
- * part of the wire contract but rides the layers, not the schema: the
- * backend's store controller enforces it as a typed 4xx, and the store API
- * client (`cursor/store-api-client.ts`) pre-checks it before spending a
- * doomed request.
+ * part of the wire contract but not the schema. The service enforces it as a
+ * typed 4xx, and the client checks it before sending a request.
  */
 export declare const MEMORY_APPEND_MAX_RECORD_BYTES: number;
 /** Serialized size of a record, as counted against the byte cap. */
 export declare function serializedRecordBytes(record: unknown): number;
 /**
- * One turn's memory record as it crosses the wire — July's
- * `TurnMemoryRecord` (memory.ts). The extra-key record mirrors the schema's
- * `.passthrough()`: a newer client's additive optional fields are journaled
- * verbatim rather than stripped by an older server.
+ * One turn's memory record as it crosses the wire. The extra-key record
+ * mirrors the schema's `.passthrough()`: a newer client's additive optional
+ * fields are journaled verbatim rather than stripped by an older server.
  */
 export type TurnMemoryRecordWire = {
     at: string;
@@ -69,8 +52,8 @@ export type MemoryAppendPayload = {
 /**
  * `memory.append` payload shape. The agent name becomes a store key segment
  * on the server, so it must be exactly one segment. Unknown payload fields
- * are stripped (= ignored), per the evolution rules. The byte cap is
- * semantics, not shape — the backend's store controller owns it.
+ * are stripped (= ignored), per the evolution rules. The service owns the
+ * byte cap because it is a semantic limit rather than part of the shape.
  */
 export declare const memoryAppendPayloadSchema: z.ZodType<MemoryAppendPayload>;
 /** The versioned request body for the `memory.append` call. */
@@ -110,13 +93,9 @@ export type MemoryReadEnvelope = {
 /** The whole request body. Unknown envelope fields are stripped (= ignored). */
 export declare const memoryReadEnvelopeSchema: z.ZodType<MemoryReadEnvelope>;
 /**
- * `memory.read` success body. The call is flush-on-read: the server drains
- * the agent's pending append buffer before presigning. Best-effort: when
- * the drain succeeds the journal includes every append that preceded the
- * read; a busy flush lock, a buffer outage, or an oversized backlog
- * degrades to the already-flushed state (callers must not regress their
- * local view on a shorter download). `journal` is null while the agent has
- * no journal at all.
+ * `memory.read` success body. The snapshot is best-effort and may lag
+ * accepted appends, so callers retain a longer local view. `journal` is null
+ * while the agent has no journal.
  */
 export type MemoryReadResponse = {
     v: typeof STORE_API_PROTOCOL_VERSION;

package/dist/internal/store-api-protocol.d.ts.map

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

package/dist/internal/store-api-protocol.js

@@ -1,19 +1,5 @@
 /**
- * Domain-call wire contract for the factory store API:
- * `POST /internal/agentsdk/store/api/<call>` carrying a versioned JSON
- * envelope `{ v, call, payload }`. This is the lane where the **server** owns
- * the storage pattern (journal sharding, rotation, compaction), so a
- * pathological pattern is fixable in a backend deploy instead of a July
- * release plus a rebake of every deployment. The verb lane (`/flush`,
- * `/read`, `/list`) keeps carrying bulk presigned file IO.
- *
- * Deliberately duplicated on the backend
- * (`backend/server/src/factory/agent-sdk/agentsdkStoreApiProtocol.ts`): this
- * package is published to npm, so the backend cannot depend on it and it
- * cannot depend on backend packages. A backend drift test compares the two
- * sources — same shape as the hosted-delivery protocol twins — which is why
- * every exported constant here stays a single `export const NAME = <literal>;`
- * line and every schema field stays on its own line.
+ * Versioned wire contract for Cursor-managed store operations.
  *
  * Evolution rules (the compat contract): additive optional fields only; no
  * renames, no retypes, no semantic reuse of an old field; unknown fields are
@@ -23,17 +9,15 @@
  */
 import { z } from "zod";
 export const STORE_API_PROTOCOL_VERSION = 1;
-/** Path family on the factory surface; one segment per call. */
+/** Managed storage endpoint, with one trailing segment per call. */
 export const STORE_API_PATH = "/internal/agentsdk/store/api";
 export const STORE_API_MEMORY_APPEND_CALL = "memory.append";
 /**
  * Semantic cap on one serialized memory record. Text fields are truncated
  * client-side (`memoryHook` default 2000 chars per field), so a well-formed
  * record is a few KiB; 16 KiB is generous headroom, not a target. The cap is
- * part of the wire contract but rides the layers, not the schema: the
- * backend's store controller enforces it as a typed 4xx, and the store API
- * client (`cursor/store-api-client.ts`) pre-checks it before spending a
- * doomed request.
+ * part of the wire contract but not the schema. The service enforces it as a
+ * typed 4xx, and the client checks it before sending a request.
  */
 export const MEMORY_APPEND_MAX_RECORD_BYTES = 16 * 1024;
 /** Serialized size of a record, as counted against the byte cap. */
@@ -61,8 +45,8 @@ export const turnMemoryRecordWireSchema = z
 /**
  * `memory.append` payload shape. The agent name becomes a store key segment
  * on the server, so it must be exactly one segment. Unknown payload fields
- * are stripped (= ignored), per the evolution rules. The byte cap is
- * semantics, not shape — the backend's store controller owns it.
+ * are stripped (= ignored), per the evolution rules. The service owns the
+ * byte cap because it is a semantic limit rather than part of the shape.
  */
 export const memoryAppendPayloadSchema = z.object({
     agent: z

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

@@ -1,5 +1,5 @@
 /**
- * Mirror an authored file tree onto an Agent Store prefix. Shared by the
+ * Mirror an authored file tree onto a durable storage prefix. Shared by the
  * skills, workspace seed, and session workspaceFile syncs so they keep the
  * same write-then-sweep discipline and the same path refusals.
  */
@@ -19,11 +19,10 @@ export declare function mirrorToStore(args: {
 }): Promise<void>;
 /**
  * Same refusals as local materialization's `resolveInside`: a rel that
- * escapes its directory or would not round-trip through the FUSE mount
+ * escapes its directory or cannot round-trip through managed storage
  * (`..`, `.`, `//`, absolute) fails the sync, exactly as it fails a local
- * turn's workspace write. Backslashes are refused too — the store
- * normalizes `\` to `/` on write, so the stored key would differ from the
- * desired one and the stale pass would delete the file it just wrote.
+ * workspace write. Backslashes are refused because storage normalizes path
+ * separators, which would change the desired key.
  */
 export declare function storeRelPath(relPath: string, what: "skill file" | "workspace file"): string;
 //# sourceMappingURL=store-mirror.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"store-mirror.d.ts","sourceRoot":"","sources":["../../src/internal/store-mirror.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,gHAAgH;IAChH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,gBAAgB,GAAG,MAAM,CAY3F"}
+{"version":3,"file":"store-mirror.d.ts","sourceRoot":"","sources":["../../src/internal/store-mirror.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,gHAAgH;IAChH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,gBAAgB,GAAG,MAAM,CAY3F"}

package/dist/internal/store-mirror.js

@@ -1,5 +1,5 @@
 /**
- * Mirror an authored file tree onto an Agent Store prefix. Shared by the
+ * Mirror an authored file tree onto a durable storage prefix. Shared by the
  * skills, workspace seed, and session workspaceFile syncs so they keep the
  * same write-then-sweep discipline and the same path refusals.
  */
@@ -33,11 +33,10 @@ export function mirrorToStore(args) {
 }
 /**
  * Same refusals as local materialization's `resolveInside`: a rel that
- * escapes its directory or would not round-trip through the FUSE mount
+ * escapes its directory or cannot round-trip through managed storage
  * (`..`, `.`, `//`, absolute) fails the sync, exactly as it fails a local
- * turn's workspace write. Backslashes are refused too — the store
- * normalizes `\` to `/` on write, so the stored key would differ from the
- * desired one and the stale pass would delete the file it just wrote.
+ * workspace write. Backslashes are refused because storage normalizes path
+ * separators, which would change the desired key.
  */
 export function storeRelPath(relPath, what) {
     if (relPath.includes("\0") ||
@@ -51,9 +50,8 @@ export function storeRelPath(relPath, what) {
     return relPath;
 }
 /**
- * Last writer wins. A raced conditional put (dual engine pods during a
- * deploy rollover) clears the sink's cached etag, so one retry re-learns
- * the current version and lands.
+ * Last writer wins. A raced conditional put clears the sink's cached etag,
+ * so one retry re-learns the current version and lands.
  */
 function putLastWriterWins(sink, key, body) {
     return __awaiter(this, void 0, void 0, function* () {

package/dist/internal/turn-lease-store.d.ts

@@ -2,11 +2,11 @@
  * Durable per-session turn ownership: `activeTurns` is in-memory, so servers
  * sharing a state root would otherwise both run the same session.
  *
- * Exclusion, staleness and liveness refresh come from `proper-lockfile`, which
- * the monorepo already uses for the git cache. Hand-rolling them means
- * inferring that a process died — timeouts, heartbeats, and a takeover path
- * that has to stay atomic while removing another owner's claim. That is where
- * the subtle races live, and none of it is specific to turns.
+ * Exclusion and liveness refresh come from `proper-lockfile`, which the
+ * monorepo already uses for the git cache. Taking an abandoned lock over is
+ * handled here, because the library does it by removing the stale lock and
+ * then creating its own, and contenders that interleave those two steps each
+ * come away holding the session.
  *
  * Liveness is lock age, not pid: containers have separate PID namespaces.
  */
@@ -32,6 +32,13 @@ export declare class TurnLeaseStore {
      * of answering alongside its successor.
      */
     acquire(sessionId: string, onCompromised?: () => void): Promise<TurnLease | undefined>;
+    /**
+     * Clear an abandoned lock, leaving a claim itself a single atomic `mkdir`.
+     * Only the contender holding the takeover removes anything, and no claim can
+     * land on an occupied path meanwhile, so the rest just race that `mkdir`.
+     */
+    private evictStaleLock;
+    private isStale;
     private handle;
     /** Graceful shutdown: drop every claim so a successor need not wait it out. */
     releaseAll(): Promise<void>;

package/dist/internal/turn-lease-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-lease-store.d.ts","sourceRoot":"","sources":["../../src/internal/turn-lease-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAmBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IAEpD,YAAY,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAIxD;IAED,OAAO,CAAC,IAAI;IAIZ;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CA6B3F;IAED,OAAO,CAAC,MAAM;IAwBd,+EAA+E;IACzE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhC;IAED;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAY1D;CACF"}
+{"version":3,"file":"turn-lease-store.d.ts","sourceRoot":"","sources":["../../src/internal/turn-lease-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAmBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IAEpD,YAAY,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAIxD;IAED,OAAO,CAAC,IAAI;IAIZ;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CA+B3F;IAED;;;;OAIG;YACW,cAAc;YAmCd,OAAO;IAKrB,OAAO,CAAC,MAAM;IAwBd,+EAA+E;IACzE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhC;IAED;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAY1D;CACF"}

package/dist/internal/turn-lease-store.js

@@ -2,11 +2,11 @@
  * Durable per-session turn ownership: `activeTurns` is in-memory, so servers
  * sharing a state root would otherwise both run the same session.
  *
- * Exclusion, staleness and liveness refresh come from `proper-lockfile`, which
- * the monorepo already uses for the git cache. Hand-rolling them means
- * inferring that a process died — timeouts, heartbeats, and a takeover path
- * that has to stay atomic while removing another owner's claim. That is where
- * the subtle races live, and none of it is specific to turns.
+ * Exclusion and liveness refresh come from `proper-lockfile`, which the
+ * monorepo already uses for the git cache. Taking an abandoned lock over is
+ * handled here, because the library does it by removing the stale lock and
+ * then creating its own, and contenders that interleave those two steps each
+ * come away holding the session.
  *
  * Liveness is lock age, not pid: containers have separate PID namespaces.
  */
@@ -19,9 +19,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { mkdir } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { mkdir, rename, rm, stat } from "node:fs/promises";
 import { join } from "node:path";
 import * as lockfile from "proper-lockfile";
+/** Long enough that the library never runs its own takeover. */
+const NEVER_STALE_MS = 365 * 24 * 60 * 60000;
 /** Reject path traversal; session ids are opaque strings from the caller. */
 function safeKey(sessionId) {
     const sanitized = sessionId
@@ -60,12 +63,14 @@ export class TurnLeaseStore {
                 return this.handle(sessionId);
             }
             yield mkdir(this.dir, { recursive: true });
+            const path = this.path(sessionId);
+            yield this.evictStaleLock(path);
             let release;
             try {
-                release = yield lockfile.lock(this.path(sessionId), {
+                release = yield lockfile.lock(path, {
                     realpath: false,
                     retries: 0,
-                    stale: this.staleMs,
+                    stale: NEVER_STALE_MS,
                     // How often the library refreshes the lock's mtime while we hold it.
                     update: 5000,
                     onCompromised: () => {
@@ -84,6 +89,54 @@ export class TurnLeaseStore {
             return this.handle(sessionId);
         });
     }
+    /**
+     * Clear an abandoned lock, leaving a claim itself a single atomic `mkdir`.
+     * Only the contender holding the takeover removes anything, and no claim can
+     * land on an occupied path meanwhile, so the rest just race that `mkdir`.
+     */
+    evictStaleLock(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // proper-lockfile's own naming for the lock it creates.
+            const lockPath = `${path}.lock`;
+            if (!(yield this.isStale(lockPath))) {
+                return;
+            }
+            const takeoverPath = `${path}.takeover`;
+            if (yield this.isStale(takeoverPath)) {
+                // Left by a process that died mid-takeover. Grabbing it by rename admits
+                // one clearer, where checking and then removing would admit several.
+                const abandoned = `${takeoverPath}.${randomUUID()}`;
+                try {
+                    yield rename(takeoverPath, abandoned);
+                }
+                catch (_a) {
+                    return;
+                }
+                yield rm(abandoned, { recursive: true, force: true });
+            }
+            try {
+                yield mkdir(takeoverPath);
+            }
+            catch (_b) {
+                return;
+            }
+            try {
+                // A successor may have claimed the session while this contender queued.
+                if (yield this.isStale(lockPath)) {
+                    yield rm(lockPath, { recursive: true, force: true });
+                }
+            }
+            finally {
+                yield rm(takeoverPath, { recursive: true, force: true });
+            }
+        });
+    }
+    isStale(lockPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const entry = yield stat(lockPath).catch(() => undefined);
+            return entry !== undefined && entry.mtimeMs < Date.now() - this.staleMs;
+        });
+    }
     handle(sessionId) {
         let released = false;
         return {

package/dist/internal/v2-hosting.d.ts

@@ -1,10 +1,8 @@
 import type { AgentArchitecture } from "../types.js";
 import { type CursorManagedV2StoreIds } from "./cursor/hosted-store-secrets.js";
 /**
- * Exported (as `1`) by the control plane's start script for a version
- * container of a persistent deployment. Its presence, not the agent's
- * `persistent` flag, is what tells the runtime it owns a durable state
- * directory.
+ * Platform-managed marker for persistent hosting. Its presence tells the
+ * runtime the host provides a durable state directory.
  */
 export declare const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
 export type AgentV2Hosting = {
@@ -20,9 +18,8 @@ export type AgentV2Hosting = {
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.
  *
- * Managed freeze processes exist before task bind, so store resolution stays
- * lazy. Consumers can branch once on `kind`; managed storage operations then
- * receive a resolver whose successful result always contains both ids.
+ * Managed storage resolution stays lazy. Consumers branch once on `kind`,
+ * and a successful managed resolver always returns both storage identities.
  */
 export declare function resolveAgentV2Hosting(input: {
     architecture: AgentArchitecture | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAEvE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;CACnC,CAAC;AAEN;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAejB"}
+{"version":3,"file":"v2-hosting.d.ts","sourceRoot":"","sources":["../../src/internal/v2-hosting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAG1C;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AAEvE,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,uBAAuB,CAAC;CAChD,GACD;IACE,IAAI,EAAE,2BAA2B,CAAC;CACnC,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,YAAY,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,cAAc,CAejB"}

package/dist/internal/v2-hosting.js

@@ -1,18 +1,15 @@
 import { requireCursorManagedV2StoreIdsSync, } from "./cursor/hosted-store-secrets.js";
 import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
 /**
- * Exported (as `1`) by the control plane's start script for a version
- * container of a persistent deployment. Its presence, not the agent's
- * `persistent` flag, is what tells the runtime it owns a durable state
- * directory.
+ * Platform-managed marker for persistent hosting. Its presence tells the
+ * runtime the host provides a durable state directory.
  */
 export const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.
  *
- * Managed freeze processes exist before task bind, so store resolution stays
- * lazy. Consumers can branch once on `kind`; managed storage operations then
- * receive a resolver whose successful result always contains both ids.
+ * Managed storage resolution stays lazy. Consumers branch once on `kind`,
+ * and a successful managed resolver always returns both storage identities.
  */
 export function resolveAgentV2Hosting(input) {
     var _a;

package/dist/internal/workspace-sync.d.ts

@@ -1,10 +1,7 @@
 /**
- * Sync workspace trees onto an Agent Store so cloud-runtime turns read
- * them from the store mount. Authored `agent/sandbox/workspace/**` seeds
- * land at store-root `workspace/<path>` (see `buildCloudWorkspaceSection`).
- * Per-turn `workspaceFiles` land at `sessions/<sessionId>/workspace/<path>`
- * (see `buildCloudSessionWorkspaceSection`). Personal-key local+cloud
- * nests both under `agent-serve/<agent>/`.
+ * Sync authored workspace trees to cloud-turn storage. Project seeds and
+ * per-turn `workspaceFiles` use separate deployment and session scopes.
+ * User-scoped storage also namespaces both by agent.
  */
 import { type FileSink } from "../files.js";
 import type { SeedFile } from "../types.js";

package/dist/internal/workspace-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-sync.d.ts","sourceRoot":"","sources":["../../src/internal/workspace-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,0EAA0E;AAC1E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAkB,IAAI,0BAA0B;CACjD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBpB;AAED,2DAA2D;AAC3D,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhB"}
+{"version":3,"file":"workspace-sync.d.ts","sourceRoot":"","sources":["../../src/internal/workspace-sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,0EAA0E;AAC1E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAkB,IAAI,0BAA0B;CACjD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBpB;AAED,2DAA2D;AAC3D,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhB"}

package/dist/internal/workspace-sync.js

@@ -1,10 +1,7 @@
 /**
- * Sync workspace trees onto an Agent Store so cloud-runtime turns read
- * them from the store mount. Authored `agent/sandbox/workspace/**` seeds
- * land at store-root `workspace/<path>` (see `buildCloudWorkspaceSection`).
- * Per-turn `workspaceFiles` land at `sessions/<sessionId>/workspace/<path>`
- * (see `buildCloudSessionWorkspaceSection`). Personal-key local+cloud
- * nests both under `agent-serve/<agent>/`.
+ * Sync authored workspace trees to cloud-turn storage. Project seeds and
+ * per-turn `workspaceFiles` use separate deployment and session scopes.
+ * User-scoped storage also namespaces both by agent.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }

package/dist/internal/workspace.d.ts

@@ -2,7 +2,7 @@
  * Session workspace materialization. Each session gets its own working
  * directory that the Cursor harness treats as the project: skills land in
  * `.cursor/skills/<name>/SKILL.md`, agent-side tools land in
- * `.agent-serve/tools/<name>.sh`, and `agent/sandbox/workspace/**` seed files
+ * `.agent-serve/tools/<name>.sh`, and `bot/sandbox/workspace/**` seed files
  * are mirrored in. The harness picks all of this up natively through its
  * project setting source. Instructions are not written here: local turns
  * deliver them as the harness system prompt ({@link buildAgentsMdContent}),
@@ -19,33 +19,27 @@ export interface MaterializeWorkspaceOptions {
     seed: boolean;
     /**
      * Agent state root. `<stateRoot>/memory/` (the durable cross-session
-     * directory the memory hook journals into — on hosting a local mirror of
-     * the Agent Store journal) is created and symlinked into the workspace as
-     * `memory` so the agent reads it with plain file tools. Cloud VMs have no
-     * materialized workspace; they read the store mount directly (see
+     * directory the memory hook journals into) is created and symlinked into
+     * the workspace as `memory` so the agent reads it with plain file tools.
+     * Cloud turns read the managed storage path directly (see
      * {@link buildCloudMemorySection}).
      */
     stateRoot: string;
 }
 /**
- * First-turn preamble section for cloud-runtime sessions on hosted
- * deployments: cloud VMs read the memory journal from the store mount.
+ * First-turn preamble for cloud sessions that read managed memory.
  */
 export declare function buildCloudMemorySection(agentName: string): string;
 /**
  * First-turn preamble section for cloud-runtime sessions with authored
- * `agent/sandbox/workspace/**` seeds. Cloud VMs get no materialized
- * workspace; the seeds are synced onto the store mount instead (see
- * `syncWorkspaceToStore`), so the model has to be told where they are.
+ * `bot/sandbox/workspace/**` seeds. The prompt names their managed storage
+ * path because cloud turns have no local materialized workspace.
  */
 export declare function buildCloudWorkspaceSection(dir: string): string;
 /**
- * Per-turn preamble for cloud `workspaceFiles` after they land on the
- * session store prefix (see `syncSessionWorkspaceFiles`). Omitted when
- * the sync did not land.
- *
- * Same shared Agent Store mount as authored seeds — the session path is
- * replace-per-send / task-end wipe lifetime, not a separate mount ACL.
+ * Per-turn preamble for cloud `workspaceFiles` after they reach
+ * session-scoped storage. Omitted when the sync did not land. The session
+ * path is replaced on each send and removed when a task session ends.
  */
 export declare function buildCloudSessionWorkspaceSection(dir: string, relPaths: readonly string[]): string;
 /** Relative path of an agent-side tool script inside the session workspace. */

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

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMlF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,CAOR;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA8CR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,CA6BR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B9F;AAyFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtF,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMlF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,CAOR;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA8B,GAC/D,MAAM,CA8CR;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,CA6BR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUpE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B9F;AAyFD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtF,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/internal/workspace.js

@@ -2,7 +2,7 @@
  * Session workspace materialization. Each session gets its own working
  * directory that the Cursor harness treats as the project: skills land in
  * `.cursor/skills/<name>/SKILL.md`, agent-side tools land in
- * `.agent-serve/tools/<name>.sh`, and `agent/sandbox/workspace/**` seed files
+ * `.agent-serve/tools/<name>.sh`, and `bot/sandbox/workspace/**` seed files
  * are mirrored in. The harness picks all of this up natively through its
  * project setting source. Instructions are not written here: local turns
  * deliver them as the harness system prompt ({@link buildAgentsMdContent}),
@@ -28,22 +28,20 @@ import { parseFrontmatter, serializeFrontmatter } from "./frontmatter.js";
 import { buildIdentitySection } from "./prompt-context.js";
 const execFileAsync = promisify(execFile);
 /**
- * First-turn preamble section for cloud-runtime sessions on hosted
- * deployments: cloud VMs read the memory journal from the store mount.
+ * First-turn preamble for cloud sessions that read managed memory.
  */
 export function buildCloudMemorySection(agentName) {
     const dir = `${DEPLOYMENT_STORE_MOUNT_PATH}/${agentStoreKeys.memoryDir(agentName)}`;
     return [
         "## Shared session memory",
         "",
-        `The cross-session memory journal (the \`memory/\` directory your instructions may reference) lives at \`${dir}\` on this machine — read \`${dir}/journal.jsonl\` with your normal file tools.`,
+        `The cross-session memory journal (the \`memory/\` directory your instructions may reference) is available at \`${dir}\` on this machine. Read \`${dir}/journal.jsonl\` with your normal file tools.`,
     ].join("\n");
 }
 /**
  * First-turn preamble section for cloud-runtime sessions with authored
- * `agent/sandbox/workspace/**` seeds. Cloud VMs get no materialized
- * workspace; the seeds are synced onto the store mount instead (see
- * `syncWorkspaceToStore`), so the model has to be told where they are.
+ * `bot/sandbox/workspace/**` seeds. The prompt names their managed storage
+ * path because cloud turns have no local materialized workspace.
  */
 export function buildCloudWorkspaceSection(dir) {
     return [
@@ -53,19 +51,16 @@ export function buildCloudWorkspaceSection(dir) {
     ].join("\n");
 }
 /**
- * Per-turn preamble for cloud `workspaceFiles` after they land on the
- * session store prefix (see `syncSessionWorkspaceFiles`). Omitted when
- * the sync did not land.
- *
- * Same shared Agent Store mount as authored seeds — the session path is
- * replace-per-send / task-end wipe lifetime, not a separate mount ACL.
+ * Per-turn preamble for cloud `workspaceFiles` after they reach
+ * session-scoped storage. Omitted when the sync did not land. The session
+ * path is replaced on each send and removed when a task session ends.
  */
 export function buildCloudSessionWorkspaceSection(dir, relPaths) {
     const listed = relPaths.map(path => `\`${path}\``).join(", ");
     return [
         "## Session workspace files",
         "",
-        `This turn's workspace files live at \`${dir}\` on this machine (${listed}). Read them with your normal file tools. They sit on the same shared Agent Store mount as authored workspace seeds; the session directory is replaced on the next send for this session, and task sessions remove it when they finish.`,
+        `This turn's workspace files are available at \`${dir}\` on this machine (${listed}). Read them with your normal file tools. The session directory is replaced on the next send for this session, and task sessions remove it when they finish.`,
     ].join("\n");
 }
 /** Relative path of an agent-side tool script inside the session workspace. */