@cursor/july 0.1.109 → 0.1.112

package/dist/internal/storage-coordinator.js

@@ -55,11 +55,13 @@ const MAX_PENDING_OPS = 1000;
 const CLOSE_DRAIN_TIMEOUT_MS = 10000;
 /** Debounced event batching flushes early past this many buffered events. */
 const DEBOUNCE_MAX_BATCH = 200;
+/** Cap on the per-session acked-record dedupe cache (oldest-out). */
+const MAX_ACKED_RECORDS = 5000;
 /** Session records out of raw sink entries; rows without a usable id are dropped. */
 function sessionRecordsOf(entries) {
     return entries
-        .map((entry) => entry.value)
-        .filter((record) => record != null &&
+        .map(entry => entry.value)
+        .filter(record => record != null &&
         typeof record.sessionId === "string" &&
         record.sessionId !== "");
 }
@@ -73,6 +75,15 @@ export class StorageCoordinator {
          * change emits a delete for the stale index entry alongside the new put.
          */
         this.continuationIndex = new Map();
+        /**
+         * Serialized form of the last session record each session **successfully**
+         * wrote, so a flush whose record is byte-identical skips the rewrite (the
+         * record rides every flush, changed or not). Keyed on acknowledged writes
+         * only: a failed write clears the entry, so at-most-once delivery never
+         * turns into never-delivered. Bounded; eviction only costs a redundant
+         * rewrite.
+         */
+        this.lastAckedRecordJson = new Map();
         /** Single delivery chain: writes reach the sink serialized, in order. */
         this.queue = Promise.resolve();
         /** Ops on the queue not yet delivered (bounded by MAX_PENDING_OPS). */
@@ -147,18 +158,107 @@ export class StorageCoordinator {
             clearTimeout(buffer.debounceTimer);
         }
         const ops = [];
+        const puts = [];
         const first = buffer.events[0];
         if (first !== undefined) {
-            ops.push(this.putOp(this.keys.sessionEvents(this.agentName, sessionId, first.index), buffer.events));
+            puts.push({
+                key: this.keys.sessionEvents(this.agentName, sessionId, first.index),
+                value: buffer.events,
+            });
+        }
+        /** Set after the record write is acknowledged; undefined = no record write. */
+        let recordAck;
+        if (buffer.record !== undefined) {
+            const recordJson = JSON.stringify(buffer.record);
+            if (this.lastAckedRecordJson.get(sessionId) === recordJson) {
+                // Byte-identical to the last acknowledged write: rewriting it buys
+                // nothing. Events and continuation index still flush normally.
+            }
+            else {
+                puts.push({
+                    key: this.keys.session(this.agentName, sessionId),
+                    value: JSON.parse(recordJson),
+                });
+                recordAck = { sessionId, json: recordJson };
+            }
+        }
+        if (puts.length > 0) {
+            ops.push(this.putsOp(puts, recordAck));
         }
         if (buffer.record !== undefined) {
-            ops.push(this.putOp(this.keys.session(this.agentName, sessionId), buffer.record));
             ops.push(...this.continuationOps(buffer.record));
         }
         if (ops.length > 0) {
             this.enqueue(ops, reason);
         }
     }
+    /**
+     * One queued op covering every put of a flush. When the sink offers
+     * `putMany`, the whole flush is one backend round trip (on the hosted
+     * file store: one presign call instead of one per key); otherwise the
+     * puts run sequentially, exactly as before. Failures stay per-key —
+     * logged and dropped (at-most-once), never failing batch siblings.
+     */
+    putsOp(puts, recordAck) {
+        var _a;
+        const recordKey = recordAck === undefined
+            ? undefined
+            : this.keys.session(this.agentName, recordAck.sessionId);
+        const settleRecord = (failed) => {
+            if (recordAck === undefined) {
+                return;
+            }
+            if (failed) {
+                this.lastAckedRecordJson.delete(recordAck.sessionId);
+                return;
+            }
+            if (this.lastAckedRecordJson.size >= MAX_ACKED_RECORDS) {
+                const oldest = this.lastAckedRecordJson.keys().next();
+                if (!oldest.done) {
+                    this.lastAckedRecordJson.delete(oldest.value);
+                }
+            }
+            this.lastAckedRecordJson.set(recordAck.sessionId, recordAck.json);
+        };
+        const putMany = (_a = this.definition.putMany) === null || _a === void 0 ? void 0 : _a.bind(this.definition);
+        if (putMany !== undefined) {
+            return {
+                label: `putMany(${puts.map(entry => entry.key).join(", ")})`,
+                run: (ctx) => __awaiter(this, void 0, void 0, function* () {
+                    const results = yield putMany(puts, ctx);
+                    let recordFailed = false;
+                    for (const result of results) {
+                        if (result.error === undefined) {
+                            continue;
+                        }
+                        if (result.key === recordKey) {
+                            recordFailed = true;
+                        }
+                        this.logger(`[agent-sdk] storage put(${result.key}) failed: ${describeError(result.error)}`);
+                    }
+                    settleRecord(recordFailed);
+                }),
+            };
+        }
+        return {
+            label: `put(${puts.map(entry => entry.key).join(", ")})`,
+            run: (ctx) => __awaiter(this, void 0, void 0, function* () {
+                let recordFailed = false;
+                for (const entry of puts) {
+                    try {
+                        yield this.definition.put(entry.key, entry.value, ctx);
+                    }
+                    catch (error) {
+                        if (entry.key === recordKey) {
+                            recordFailed = true;
+                        }
+                        this.logger(`[agent-sdk] storage put(${entry.key}) failed: ${describeError(error)}`);
+                    }
+                }
+                settleRecord(recordFailed);
+            }),
+        };
+    }
     /**
      * Index maintenance for `continuation/{channelId}/{token}` → sessionId:
      * put the current token, delete the previous one when it changed.
@@ -183,14 +283,14 @@ export class StorageCoordinator {
     putOp(key, value) {
         return {
             label: `put(${key})`,
-            run: (ctx) => this.definition.put(key, value, ctx),
+            run: ctx => this.definition.put(key, value, ctx),
         };
     }
     /** KV delete op on the sink's `delete` (skipped when the hook is absent). */
     deleteOp(key) {
         return {
             label: `delete(${key})`,
-            run: (ctx) => { var _a, _b; return (_b = (_a = this.definition).delete) === null || _b === void 0 ? void 0 : _b.call(_a, key, ctx); },
+            run: ctx => { var _a, _b; return (_b = (_a = this.definition).delete) === null || _b === void 0 ? void 0 : _b.call(_a, key, ctx); },
         };
     }
     // ==========================================================================
@@ -216,8 +316,8 @@ export class StorageCoordinator {
         return __awaiter(this, void 0, void 0, function* () {
             const entries = yield this.tryList(this.keys.sessionPrefix(this.agentName));
             return entries
-                .map((entry) => entry.value)
-                .filter((record) => record != null);
+                .map(entry => entry.value)
+                .filter(record => record != null);
         });
     }
     /**
@@ -408,7 +508,7 @@ export class StorageCoordinator {
                 this.enqueue([
                     {
                         label: `evals.put(${run.runId})`,
-                        run: (ctx) => table.put(snapshot, ctx),
+                        run: ctx => table.put(snapshot, ctx),
                     },
                 ], "policy");
             },
@@ -416,7 +516,7 @@ export class StorageCoordinator {
                 this.enqueue([
                     {
                         label: `evals.delete(${runId})`,
-                        run: (ctx) => table.delete(runId, ctx),
+                        run: ctx => table.delete(runId, ctx),
                     },
                 ], "policy");
             },
@@ -451,7 +551,7 @@ export class StorageCoordinator {
             let timer;
             const drained = yield Promise.race([
                 this.queue.then(() => true),
-                new Promise((resolve) => {
+                new Promise(resolve => {
                     var _a;
                     timer = setTimeout(() => resolve(false), CLOSE_DRAIN_TIMEOUT_MS);
                     (_a = timer.unref) === null || _a === void 0 ? void 0 : _a.call(timer);

package/dist/internal/storage.d.ts

@@ -0,0 +1,2 @@
+export * from "../storage.js";
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/internal/storage.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/internal/storage.js

@@ -0,0 +1 @@
+export * from "../storage.js";

package/dist/internal/store-mirror.js

@@ -24,11 +24,11 @@ export function mirrorToStore(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         yield Promise.all([...args.desired].map(([key, body]) => putLastWriterWins(args.sink, key, body)));
-        const listed = yield Promise.all([args.prefix, ...((_a = args.legacyPrefixes) !== null && _a !== void 0 ? _a : [])].map((prefix) => args.sink.list(prefix)));
+        const listed = yield Promise.all([args.prefix, ...((_a = args.legacyPrefixes) !== null && _a !== void 0 ? _a : [])].map(prefix => args.sink.list(prefix)));
         yield Promise.all(listed
             .flat()
-            .filter((entry) => !args.desired.has(entry.key))
-            .map((entry) => args.sink.delete(entry.key)));
+            .filter(entry => !args.desired.has(entry.key))
+            .map(entry => args.sink.delete(entry.key)));
     });
 }
 /**
@@ -44,7 +44,7 @@ export function storeRelPath(relPath, what) {
         relPath.includes("\\") ||
         posix.isAbsolute(relPath) ||
         relPath.endsWith("/") ||
-        relPath.split("/").some((seg) => seg === ".." || seg === ".") ||
+        relPath.split("/").some(seg => seg === ".." || seg === ".") ||
         posix.normalize(relPath) !== relPath) {
         throw new Error(`Refusing ${what} path "${relPath}" (must be a normalized relative path)`);
     }

package/dist/internal/terminal-style.js

@@ -70,7 +70,7 @@ export function formatTerminalBox(lines, options) {
     var _a, _b, _c;
     const color = (_a = options === null || options === void 0 ? void 0 : options.color) !== null && _a !== void 0 ? _a : IDENTITY;
     const padding = (_b = options === null || options === void 0 ? void 0 : options.padding) !== null && _b !== void 0 ? _b : 1;
-    const contentWidth = Math.max((_c = options === null || options === void 0 ? void 0 : options.minWidth) !== null && _c !== void 0 ? _c : 0, ...lines.map((line) => visibleWidth(line)), 1);
+    const contentWidth = Math.max((_c = options === null || options === void 0 ? void 0 : options.minWidth) !== null && _c !== void 0 ? _c : 0, ...lines.map(line => visibleWidth(line)), 1);
     const inner = contentWidth + padding * 2;
     const padLine = (line) => {
         const extra = contentWidth - visibleWidth(line);
@@ -79,7 +79,7 @@ export function formatTerminalBox(lines, options) {
     const paint = (line) => color(line);
     const box = [
         paint(`╭${"─".repeat(inner)}╮`),
-        ...lines.map((line) => paint(padLine(line))),
+        ...lines.map(line => paint(padLine(line))),
         paint(`╰${"─".repeat(inner)}╯`),
     ].join("\n");
     return box;

package/dist/internal/tool-result.js

@@ -38,8 +38,8 @@ export function toolCallErrorMessage(result) {
         return undefined;
     }
     const texts = result.content
-        .filter((part) => part.type === "text" && typeof part.text === "string")
-        .map((part) => part.text.trim())
-        .filter((text) => text !== "");
+        .filter(part => part.type === "text" && typeof part.text === "string")
+        .map(part => part.text.trim())
+        .filter(text => text !== "");
     return texts.length === 0 ? undefined : texts.join("\n");
 }

package/dist/internal/trajectory.js

@@ -103,7 +103,7 @@ export function buildTrajectory(events) {
                     };
                     pendingCalls.set(call.callId, entry);
                     if (parentCallId !== undefined) {
-                        let sub = turn.subagents.find((s) => s.callId === parentCallId);
+                        let sub = turn.subagents.find(s => s.callId === parentCallId);
                         if (sub === undefined) {
                             sub = { callId: parentCallId, toolCalls: [] };
                             turn.subagents.push(sub);
@@ -154,7 +154,7 @@ export function buildTrajectory(events) {
                         parentCallId: event.data.parentCallId,
                     };
                     if (event.data.parentCallId !== undefined) {
-                        let sub = turn.subagents.find((s) => s.callId === event.data.parentCallId);
+                        let sub = turn.subagents.find(s => s.callId === event.data.parentCallId);
                         if (sub === undefined) {
                             sub = {
                                 callId: event.data.parentCallId,
@@ -173,7 +173,7 @@ export function buildTrajectory(events) {
             case "subagent.called": {
                 if (event.turnId !== undefined) {
                     const turn = ensureTurn(event.turnId);
-                    const existing = turn.subagents.find((s) => s.callId === event.data.callId);
+                    const existing = turn.subagents.find(s => s.callId === event.data.callId);
                     if (existing !== undefined) {
                         existing.name = event.data.name;
                         existing.description = event.data.description;
@@ -229,13 +229,13 @@ export function buildTrajectory(events) {
                 break;
         }
     }
-    const turns = turnOrder.map((id) => turnsById.get(id));
-    const turnsFailed = turns.filter((t) => t.failed).length;
+    const turns = turnOrder.map(id => turnsById.get(id));
+    const turnsFailed = turns.filter(t => t.failed).length;
     const toolCallCount = turns.reduce((n, t) => n +
         t.toolCalls.length +
         t.subagents.reduce((m, s) => m + s.toolCalls.length, 0), 0);
-    const lastGood = [...turns].reverse().find((t) => t.assistantText !== "");
-    const costedTurns = turns.filter((t) => t.cost !== undefined);
+    const lastGood = [...turns].reverse().find(t => t.assistantText !== "");
+    const costedTurns = turns.filter(t => t.cost !== undefined);
     const totalCostUsd = costedTurns.length === 0
         ? undefined
         : roundCostUsd(costedTurns.reduce((sum, t) => { var _a; var _b; return sum + ((_b = (_a = t.cost) === null || _a === void 0 ? void 0 : _a.totalUsd) !== null && _b !== void 0 ? _b : 0); }, 0));

package/dist/internal/turn-governor.js

@@ -52,11 +52,11 @@ export class TurnGovernor {
         if (((_a = args.signal) === null || _a === void 0 ? void 0 : _a.aborted) === true) {
             return Promise.resolve(undefined);
         }
-        return new Promise((resolve) => {
+        return new Promise(resolve => {
             var _a, _b;
             const waiter = {
                 sessionId: args.sessionId,
-                grant: (permit) => resolve(permit),
+                grant: permit => resolve(permit),
                 cancel: () => resolve(undefined),
                 cleanup: () => {
                     var _a;

package/dist/internal/turn-outbox.js

@@ -58,7 +58,7 @@ export class TurnOutbox {
                 return [];
             }
             const items = [];
-            for (const name of names.filter((n) => n.endsWith(".json")).sort()) {
+            for (const name of names.filter(n => n.endsWith(".json")).sort()) {
                 const path = join(dir, name);
                 try {
                     const raw = yield readFile(path, "utf8");

package/dist/internal/update-check.js

@@ -299,7 +299,7 @@ function findDependingProjectDir(packageRoot, packageName) {
             }
             const inNodeModules = dir
                 .split(sep)
-                .some((part) => part === "node_modules" || part === ".pnpm");
+                .some(part => part === "node_modules" || part === ".pnpm");
             if (!inNodeModules && (yield declaresDependency(dir, packageName))) {
                 return dir;
             }
@@ -424,7 +424,7 @@ function runUpdateCommand(command) {
             shell: process.platform === "win32",
         });
         child.on("error", reject);
-        child.on("close", (code) => {
+        child.on("close", code => {
             resolve(code !== null && code !== void 0 ? code : 1);
         });
     });

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

@@ -1,5 +1,12 @@
 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.
+ */
+export declare const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
 export type AgentV2Hosting = {
     kind: "not-v2";
 } | {
@@ -7,6 +14,8 @@ export type AgentV2Hosting = {
 } | {
     kind: "cursor-managed";
     resolveStoreIds: () => CursorManagedV2StoreIds;
+} | {
+    kind: "cursor-managed-persistent";
 };
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.

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,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,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,CAYjB"}
+{"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"}

package/dist/internal/v2-hosting.js

@@ -1,5 +1,12 @@
 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.
+ */
+export const AGENT_SERVE_PERSISTENT_ENV_VAR = "AGENT_SERVE_PERSISTENT";
 /**
  * Close the architecture/hosting inputs into a compiler-owned union.
  *
@@ -16,6 +23,9 @@ export function resolveAgentV2Hosting(input) {
     if (env[AGENT_SERVE_GENERATION_ENV_VAR] === undefined) {
         return { kind: "self-hosted" };
     }
+    if (env[AGENT_SERVE_PERSISTENT_ENV_VAR] === "1") {
+        return { kind: "cursor-managed-persistent" };
+    }
     return {
         kind: "cursor-managed",
         resolveStoreIds: () => requireCursorManagedV2StoreIdsSync(env),

package/dist/internal/workspace.d.ts

@@ -1,10 +1,12 @@
 /**
  * Session workspace materialization. Each session gets its own working
- * directory that the Cursor harness treats as the project: instructions land
- * in `AGENTS.md`, skills land in `.cursor/skills/<name>/SKILL.md`,
- * agent-side tools land in `.agent-serve/tools/<name>.sh`, and
- * `agent/sandbox/workspace/**` seed files are mirrored in. The harness picks
- * all of this up natively through its project setting source.
+ * 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
+ * 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}),
+ * and cloud / grokbot harnesses never read the session workspace.
  */
 import type { DiscoveredSkill, DiscoveredTool, ResolvedAgent } from "../types.js";
 export interface MaterializeWorkspaceOptions {
@@ -89,11 +91,12 @@ export declare function buildServerToolsCatalog(tools: DiscoveredTool[], options
     mcpServerName: string;
 }): string;
 /**
- * The full AGENTS.md-equivalent context for an agent: instructions, identity
- * section, and the agent-side tool catalog. Written to the session workspace
- * as `AGENTS.md`, and inlined into the first turn's prompt when the harness
- * cannot discover that file (cloud runtime, or a local workspace the harness
- * will not treat as the project root — see {@link isNestedInGitRepo}).
+ * The full instructions context for an agent: instructions, identity
+ * section, and the agent-side tool catalog. Local turns send it as the
+ * harness system prompt (`AgentOptions.systemPrompt`, replacing Cursor's
+ * built-in prompt), grokbot turns carry it into the hosted session's system
+ * prompt, and cloud turns inline it into the first prompt because a cloud VM
+ * has no materialized workspace to read it from.
  *
  * `serverToolsMcpName` is cloud-only: when the turn's MCP config carries the
  * session-bound server-tool endpoint, the catalog names that server so the

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

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAMrB,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;;;;;;;;;;;;;GAaG;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,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAkCf;AAqGD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CACX,MAAM,EACN,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CACjE,GACA,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/internal/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAMrB,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,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAqGD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,CACX,MAAM,EACN,MAAM,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CACjE,GACA,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/internal/workspace.js

@@ -1,10 +1,12 @@
 /**
  * Session workspace materialization. Each session gets its own working
- * directory that the Cursor harness treats as the project: instructions land
- * in `AGENTS.md`, skills land in `.cursor/skills/<name>/SKILL.md`,
- * agent-side tools land in `.agent-serve/tools/<name>.sh`, and
- * `agent/sandbox/workspace/**` seed files are mirrored in. The harness picks
- * all of this up natively through its project setting source.
+ * 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
+ * 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}),
+ * and cloud / grokbot harnesses never read the session workspace.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -59,7 +61,7 @@ export function buildCloudWorkspaceSection(dir) {
  * replace-per-send / task-end wipe lifetime, not a separate mount ACL.
  */
 export function buildCloudSessionWorkspaceSection(dir, relPaths) {
-    const listed = relPaths.map((path) => `\`${path}\``).join(", ");
+    const listed = relPaths.map(path => `\`${path}\``).join(", ");
     return [
         "## Session workspace files",
         "",
@@ -115,7 +117,7 @@ export function withIdentityPreamble(name, instructions) {
  *   Local workspaces omit bodies because the files already exist on disk.
  */
 export function buildAgentToolsCatalog(tools, options = { includeScripts: false }) {
-    const agentTools = tools.filter((tool) => tool.execution === "agent");
+    const agentTools = tools.filter(tool => tool.execution === "agent");
     if (agentTools.length === 0) {
         return "";
     }
@@ -169,7 +171,7 @@ export function buildAgentToolsCatalog(tools, options = { includeScripts: false
  * a host tool and the host-side marker never appears.
  */
 export function buildServerToolsCatalog(tools, options) {
-    const serverTools = tools.filter((tool) => tool.execution === "server");
+    const serverTools = tools.filter(tool => tool.execution === "server");
     if (serverTools.length === 0) {
         return "";
     }
@@ -196,11 +198,12 @@ export function buildServerToolsCatalog(tools, options) {
     return `${parts.join("\n").trimEnd()}\n`;
 }
 /**
- * The full AGENTS.md-equivalent context for an agent: instructions, identity
- * section, and the agent-side tool catalog. Written to the session workspace
- * as `AGENTS.md`, and inlined into the first turn's prompt when the harness
- * cannot discover that file (cloud runtime, or a local workspace the harness
- * will not treat as the project root — see {@link isNestedInGitRepo}).
+ * The full instructions context for an agent: instructions, identity
+ * section, and the agent-side tool catalog. Local turns send it as the
+ * harness system prompt (`AgentOptions.systemPrompt`, replacing Cursor's
+ * built-in prompt), grokbot turns carry it into the hosted session's system
+ * prompt, and cloud turns inline it into the first prompt because a cloud VM
+ * has no materialized workspace to read it from.
  *
  * `serverToolsMcpName` is cloud-only: when the turn's MCP config carries the
  * session-bound server-tool endpoint, the catalog names that server so the
@@ -224,7 +227,7 @@ export function buildAgentsMdContent(agent, options) {
             includeScripts: options.includeScripts,
         }),
     ]
-        .filter((part) => part !== "")
+        .filter(part => part !== "")
         .join("\n\n");
 }
 /**
@@ -288,8 +291,6 @@ export function materializeWorkspace(options) {
         if (seed) {
             yield linkSharedMemoryDir(workspaceDir, stateRoot);
         }
-        const agentsMd = buildAgentsMdContent(agent, { includeScripts: false });
-        yield writeFile(join(workspaceDir, "AGENTS.md"), agentsMd, "utf8");
         for (const tool of agent.tools) {
             if (tool.execution !== "agent" || tool.script === undefined) {
                 continue;

package/dist/kv/memory-kv.d.ts

@@ -1,9 +1,11 @@
 /**
- * In-memory {@link HostKvCasApi} — the test/dev implementation of the
- * interface module (`@cursor/july/kv`), exported at
- * `@cursor/july/kv/memory`.
+ * In-memory {@link HostKvCasApi} — the test/dev implementation of
+ * `@cursor/july/kv`.
  *
- * The memory KV *is* the dev shim: tests and local runs exercise the
+ * Internal only: SDK tests and Cursor factory code. Not a public Agent
+ * SDK export.
+ *
+ * The memory KV *is* the test shim: tests and local runs exercise the
  * CAS contract, not a mock of an RPC. Values are deep-copied on both write and
  * read so callers can never observe (or cause) shared-reference mutation.
  */

package/dist/kv/memory-kv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-kv.d.ts","sourceRoot":"","sources":["../../src/kv/memory-kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,aAAa,CAAC;AAErB,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,CA4D7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAShD"}
+{"version":3,"file":"memory-kv.d.ts","sourceRoot":"","sources":["../../src/kv/memory-kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,aAAa,CAAC;AAErB,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,CA4D7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,eAAe,CAShD"}

package/dist/kv/memory-kv.js

@@ -1,9 +1,11 @@
 /**
- * In-memory {@link HostKvCasApi} — the test/dev implementation of the
- * interface module (`@cursor/july/kv`), exported at
- * `@cursor/july/kv/memory`.
+ * In-memory {@link HostKvCasApi} — the test/dev implementation of
+ * `@cursor/july/kv`.
  *
- * The memory KV *is* the dev shim: tests and local runs exercise the
+ * Internal only: SDK tests and Cursor factory code. Not a public Agent
+ * SDK export.
+ *
+ * The memory KV *is* the test shim: tests and local runs exercise the
  * CAS contract, not a mock of an RPC. Values are deep-copied on both write and
  * read so callers can never observe (or cause) shared-reference mutation.
  */
@@ -79,7 +81,7 @@ export function createMemoryKv() {
         },
         listKeys(prefix) {
             return __awaiter(this, void 0, void 0, function* () {
-                return [...entries.keys()].filter((key) => key.startsWith(prefix)).sort();
+                return [...entries.keys()].filter(key => key.startsWith(prefix)).sort();
             });
         },
     };
@@ -94,9 +96,9 @@ export function createMemoryKv() {
 export function memoryCasTable() {
     const kv = createMemoryKv();
     return {
-        getWithVersion: (key) => kv.getWithVersion(key),
+        getWithVersion: key => kv.getWithVersion(key),
         putIfAbsent: (key, value) => kv.putIfAbsent(key, value),
         putIfVersion: (key, value, expectedVersion) => kv.putIfVersion(key, value, expectedVersion),
-        listKeys: (prefix) => kv.listKeys(prefix),
+        listKeys: prefix => kv.listKeys(prefix),
     };
 }

package/dist/kv.d.ts

@@ -8,13 +8,10 @@
  * stores of unknown provenance — a `defineStorage` backend declares CAS
  * through its `cas` group instead, so it never needs probing.
  *
- * Implementations live elsewhere:
- *
- * - `@cursor/july/kv/memory` — `createMemoryKv`, the test/dev shim.
- * - The storage backends implement the same operations as the `cas`
- *   group on `defineStorage` (see `StorageCasTable` in
- *   `@cursor/july/storage`): `fileKv` (single-process) and
- *   `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
+ * Implementations live on the storage backends: they implement the same
+ * operations as the `cas` group on the internal-only `defineStorage`
+ * (its `StorageCasTable` member): `fileKv` (single-process) and
+ * `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
  */
 export type { HostKvApi, HostKvCasApi, KvCasResult, KvVersionedEntry, } from "./types.js";
 export { supportsKvCas } from "./types.js";

package/dist/kv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../src/kv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/kv.js

@@ -8,12 +8,9 @@
  * stores of unknown provenance — a `defineStorage` backend declares CAS
  * through its `cas` group instead, so it never needs probing.
  *
- * Implementations live elsewhere:
- *
- * - `@cursor/july/kv/memory` — `createMemoryKv`, the test/dev shim.
- * - The storage backends implement the same operations as the `cas`
- *   group on `defineStorage` (see `StorageCasTable` in
- *   `@cursor/july/storage`): `fileKv` (single-process) and
- *   `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
+ * Implementations live on the storage backends: they implement the same
+ * operations as the `cas` group on the internal-only `defineStorage`
+ * (its `StorageCasTable` member): `fileKv` (single-process) and
+ * `cursorHostedStorage` (control-plane proxy). See `docs/storage.md`.
  */
 export { supportsKvCas } from "./types.js";