@cursor/july 0.1.101 → 0.1.103

package/dist/internal/skills-sync.js

@@ -15,9 +15,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { readFile } from "node:fs/promises";
-import { posix } from "node:path";
-import { agentStoreKeys, FileConflictError } from "../files.js";
+import { agentStoreKeys } from "../files.js";
 import { STORAGE_KEY_ROOT } from "../storage.js";
+import { mirrorToStore, storeRelPath } from "./store-mirror.js";
 import { buildSkillMd } from "./workspace.js";
 /** Pre-native layout. Deleted on every sync so a rolled-forward deploy does not leave undiscoverable copies. */
 function legacySkillsPrefix(agent) {
@@ -27,10 +27,7 @@ function legacySkillsPrefix(agent) {
  * Mirror the agent's skills onto the store: write every SKILL.md (with the
  * same generated frontmatter local materialization uses) plus sibling files,
  * and delete keys no authored skill claims so redeploys drop removed skills.
- *
- * Everything loads and validates before the store is touched, and writes
- * land before stale deletes, so a failed sync never leaves a gap a
- * concurrent cloud reader could see.
+ * Everything loads and validates before the store is touched.
  */
 export function syncSkillsToStore(args) {
     return __awaiter(this, void 0, void 0, function* () {
@@ -41,52 +38,15 @@ export function syncSkillsToStore(args) {
             const key = (relPath) => agentStoreKeys.skillFile(skill.name, relPath, skillsPrefix);
             desired.set(key("SKILL.md"), Buffer.from(buildSkillMd(skill), "utf8"));
             for (const [relPath, source] of Object.entries(skill.files)) {
-                desired.set(key(storeRelPath(relPath)), yield sourceBytes(source));
+                desired.set(key(storeRelPath(relPath, "skill file")), yield sourceBytes(source));
             }
         }
-        yield Promise.all([...desired].map(([key, body]) => putLastWriterWins(args.sink, key, body)));
-        const [existing, leftover] = yield Promise.all([
-            args.sink.list(skillsPrefix),
-            args.sink.list(legacySkillsPrefix(args.agentName)),
-        ]);
-        yield Promise.all([...existing.filter((entry) => !desired.has(entry.key)), ...leftover].map((entry) => args.sink.delete(entry.key)));
-    });
-}
-/**
- * Same refusals as local materialization's `resolveInside`: a rel that
- * escapes the skill directory or would not round-trip through the FUSE
- * mount (`..`, `.`, `//`, 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.
- */
-function storeRelPath(relPath) {
-    if (relPath.includes("\0") ||
-        relPath.includes("\\") ||
-        posix.isAbsolute(relPath) ||
-        relPath.endsWith("/") ||
-        relPath.split("/").some((seg) => seg === ".." || seg === ".") ||
-        posix.normalize(relPath) !== relPath) {
-        throw new Error(`Refusing skill file path "${relPath}" (must be a normalized relative path)`);
-    }
-    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.
- */
-function putLastWriterWins(sink, key, body) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            yield sink.put(key, body);
-        }
-        catch (error) {
-            if (!(error instanceof FileConflictError)) {
-                throw error;
-            }
-            yield sink.put(key, body);
-        }
+        yield mirrorToStore({
+            sink: args.sink,
+            prefix: skillsPrefix,
+            desired,
+            legacyPrefixes: [legacySkillsPrefix(args.agentName)],
+        });
     });
 }
 function sourceBytes(source) {

package/dist/internal/sleep.d.ts

@@ -0,0 +1,2 @@
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/internal/sleep.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/internal/sleep.js

@@ -0,0 +1,3 @@
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/internal/start-log-store.d.ts

@@ -8,7 +8,7 @@
  * after park/discard.
  *
  * Same flush moments as `hosted-execution.json` and session-runs —
- * see `hosted-execution-flush.ts`. Keys: {@link storageKeys.log}.
+ * see `hosted-execution-flush.ts`. Keys: {@link agentSdkStorageKeys.log}.
  * Values are raw UTF-8, not JSON.
  */
 import type { FileSink } from "../files.js";

package/dist/internal/start-log-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-log-store.d.ts","sourceRoot":"","sources":["../../src/internal/start-log-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAwB,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,sCACL,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB9B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,aAAa,CAkChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,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,aAAa,GAAG,SAAS,CAiB5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}
+{"version":3,"file":"start-log-store.d.ts","sourceRoot":"","sources":["../../src/internal/start-log-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAwB,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,sCACL,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB9B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,aAAa,CAkChB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,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,aAAa,GAAG,SAAS,CAiB5B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}

package/dist/internal/start-log-store.js

@@ -8,7 +8,7 @@
  * after park/discard.
  *
  * Same flush moments as `hosted-execution.json` and session-runs —
- * see `hosted-execution-flush.ts`. Keys: {@link storageKeys.log}.
+ * see `hosted-execution-flush.ts`. Keys: {@link agentSdkStorageKeys.log}.
  * Values are raw UTF-8, not JSON.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -21,11 +21,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { readFile } from "node:fs/promises";
-import { cursorFrameworkStoreSourceId, cursorHostedFiles, } from "../files-backends/cursor-hosted.js";
-import { storageKeys } from "../storage-protocol.js";
+import { cursorHostedFiles } from "../files-backends/cursor-hosted.js";
+import { agentSdkStorageKeys } from "../storage-protocol.js";
 import { resolveApiKeySync } from "./cursor/credentials.js";
-import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
 import { describeError } from "./describe-error.js";
+import { resolveAgentV2Hosting } from "./v2-hosting.js";
 /**
  * Last N bytes flushed to the store. Matches the Temporal catch-up cap
  * so guest snapshots and host catch-up stay interchangeable. The store
@@ -85,7 +85,7 @@ export function createStartLogStore(input) {
     return {
         persist(startLogId, contents) {
             return __awaiter(this, void 0, void 0, function* () {
-                const key = storageKeys.log(agentName, startLogId);
+                const key = agentSdkStorageKeys.log(agentName, startLogId);
                 const body = tailStartLogText(contents, START_LOG_STORE_MAX_BYTES);
                 try {
                     yield sink.put(key, new TextEncoder().encode(body));
@@ -97,7 +97,7 @@ export function createStartLogStore(input) {
         },
         read(startLogId) {
             return __awaiter(this, void 0, void 0, function* () {
-                const key = storageKeys.log(agentName, startLogId);
+                const key = agentSdkStorageKeys.log(agentName, startLogId);
                 try {
                     const body = yield sink.get(key);
                     if (body === undefined) {
@@ -118,18 +118,16 @@ export function createStartLogStore(input) {
  * Same selection as the session-run log: architecture-v2 hosted engines.
  */
 export function selectStartLogStore(input) {
-    var _a;
-    if (input.project.agent.architecture !== "v2") {
-        return undefined;
-    }
-    const env = (_a = input.env) !== null && _a !== void 0 ? _a : process.env;
-    if (env[AGENT_SERVE_GENERATION_ENV_VAR] === undefined) {
+    const hosting = resolveAgentV2Hosting({
+        architecture: input.project.agent.architecture,
+        env: input.env,
+    });
+    if (hosting.kind !== "cursor-managed") {
         return undefined;
     }
-    const envSnapshot = env;
     return createStartLogStore({
         sink: cursorHostedFiles({
-            resolveStoreSourceId: () => cursorFrameworkStoreSourceId(envSnapshot),
+            resolveStoreSourceId: () => hosting.resolveStoreIds().frameworkStoreSourceId,
             resolveApiKey: () => { var _a; return (_a = resolveApiKeySync()) === null || _a === void 0 ? void 0 : _a.apiKey; },
         }),
         agentName: input.project.name,

package/dist/internal/storage-coordinator.d.ts

@@ -23,7 +23,7 @@
  * seam deliberately does not touch.
  */
 import type { ABMetricSample } from "../ab.js";
-import { type ResolvedStoragePolicy, type StorageContext, type StorageDefinition } from "../storage.js";
+import { type ResolvedStoragePolicy, type StorageContext, type StorageDefinition, type StorageKeys } from "../storage.js";
 import type { JsonValue, SessionEvent, SessionRecord } from "../types.js";
 import type { ABSnapshot } from "./ab-snapshot.js";
 import type { EvalRunStorage } from "./eval-run-store.js";
@@ -33,10 +33,13 @@ export interface StorageCoordinatorOptions {
     agentName: string;
     projectRoot: string;
     logger: (line: string) => void;
+    /** Defaults to the architecture-v1 key contract. */
+    keys?: StorageKeys;
 }
 export declare class StorageCoordinator implements FrameworkSessionStore, AuthorKvStore, EvalAbStore {
     readonly policy: ResolvedStoragePolicy;
     private readonly definition;
+    private readonly keys;
     private readonly agentName;
     private readonly projectRoot;
     private readonly logger;

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

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

package/dist/internal/storage-coordinator.js

@@ -72,6 +72,7 @@ function sessionRecordsOf(entries) {
 }
 export class StorageCoordinator {
     constructor(options) {
+        var _a;
         /** Per-session pending state (events + coalesced record). */
         this.buffers = new Map();
         /**
@@ -88,6 +89,7 @@ export class StorageCoordinator {
         this.lastAbSnapshotAt = 0;
         this.closed = false;
         this.definition = options.definition;
+        this.keys = (_a = options.keys) !== null && _a !== void 0 ? _a : storageKeys;
         this.policy = resolveStoragePolicy(options.definition.policy);
         this.agentName = options.agentName;
         this.projectRoot = options.projectRoot;
@@ -155,10 +157,10 @@ export class StorageCoordinator {
         const ops = [];
         const first = buffer.events[0];
         if (first !== undefined) {
-            ops.push(this.putOp(storageKeys.sessionEvents(this.agentName, sessionId, first.index), buffer.events));
+            ops.push(this.putOp(this.keys.sessionEvents(this.agentName, sessionId, first.index), buffer.events));
         }
         if (buffer.record !== undefined) {
-            ops.push(this.putOp(storageKeys.session(this.agentName, sessionId), buffer.record));
+            ops.push(this.putOp(this.keys.session(this.agentName, sessionId), buffer.record));
             ops.push(...this.continuationOps(buffer.record));
         }
         if (ops.length > 0) {
@@ -178,10 +180,10 @@ export class StorageCoordinator {
         this.continuationIndex.set(record.sessionId, next);
         const ops = [];
         if (previous != null) {
-            ops.push(this.deleteOp(storageKeys.continuation(this.agentName, record.channelId, previous)));
+            ops.push(this.deleteOp(this.keys.continuation(this.agentName, record.channelId, previous)));
         }
         if (next != null) {
-            ops.push(this.putOp(storageKeys.continuation(this.agentName, record.channelId, next), { sessionId: record.sessionId }));
+            ops.push(this.putOp(this.keys.continuation(this.agentName, record.channelId, next), { sessionId: record.sessionId }));
         }
         return ops;
     }
@@ -220,7 +222,7 @@ export class StorageCoordinator {
      */
     listSessions() {
         return __awaiter(this, void 0, void 0, function* () {
-            const entries = yield this.tryList(storageKeys.sessionPrefix(this.agentName));
+            const entries = yield this.tryList(this.keys.sessionPrefix(this.agentName));
             return entries
                 .map((entry) => entry.value)
                 .filter((record) => record != null);
@@ -237,7 +239,7 @@ export class StorageCoordinator {
             if (list === undefined) {
                 throw new Error("storage sink has no list");
             }
-            const entries = yield list(storageKeys.sessionPrefix(this.agentName), this.context("restore"));
+            const entries = yield list(this.keys.sessionPrefix(this.agentName), this.context("restore"));
             if (!Array.isArray(entries)) {
                 throw new Error("storage list returned a non-array");
             }
@@ -256,7 +258,7 @@ export class StorageCoordinator {
             if (listNewest === undefined) {
                 return undefined;
             }
-            const entries = yield listNewest(storageKeys.sessionPrefix(this.agentName), limit, this.context("restore"));
+            const entries = yield listNewest(this.keys.sessionPrefix(this.agentName), limit, this.context("restore"));
             if (!Array.isArray(entries)) {
                 throw new Error("storage listNewest returned a non-array");
             }
@@ -270,7 +272,7 @@ export class StorageCoordinator {
      */
     listSessionEvents(sessionId) {
         return __awaiter(this, void 0, void 0, function* () {
-            const entries = yield this.tryList(storageKeys.sessionEventsPrefix(this.agentName, sessionId));
+            const entries = yield this.tryList(this.keys.sessionEventsPrefix(this.agentName, sessionId));
             const events = [];
             for (const entry of entries) {
                 if (Array.isArray(entry.value)) {
@@ -296,7 +298,7 @@ export class StorageCoordinator {
                 return undefined;
             }
             const ctx = this.context("restore");
-            const record = (yield get(storageKeys.session(this.agentName, sessionId), ctx));
+            const record = (yield get(this.keys.session(this.agentName, sessionId), ctx));
             if (record == null) {
                 return undefined;
             }
@@ -322,7 +324,7 @@ export class StorageCoordinator {
                 return undefined;
             }
             const ctx = this.context("restore");
-            const pointer = yield get(storageKeys.continuation(this.agentName, channelId, continuationKey), ctx);
+            const pointer = yield get(this.keys.continuation(this.agentName, channelId, continuationKey), ctx);
             if (pointer == null) {
                 return undefined;
             }
@@ -370,7 +372,7 @@ export class StorageCoordinator {
             if (get === undefined) {
                 throw new Error("storage get is not configured");
             }
-            const key = storageKeys.kv(this.agentName, authorKey);
+            const key = this.keys.kv(this.agentName, authorKey);
             // Preserve stored JSON `null` (distinct from a missing key).
             return yield get(key, this.context("restore"));
         });
@@ -381,7 +383,7 @@ export class StorageCoordinator {
      */
     kvPut(authorKey, value) {
         return __awaiter(this, void 0, void 0, function* () {
-            const key = storageKeys.kv(this.agentName, authorKey);
+            const key = this.keys.kv(this.agentName, authorKey);
             yield this.definition.put(key, value, this.context("policy"));
         });
     }
@@ -389,7 +391,7 @@ export class StorageCoordinator {
     kvDelete(authorKey) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
-            const key = storageKeys.kv(this.agentName, authorKey);
+            const key = this.keys.kv(this.agentName, authorKey);
             yield (_b = (_a = this.definition).delete) === null || _b === void 0 ? void 0 : _b.call(_a, key, this.context("policy"));
         });
     }

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

@@ -0,0 +1,29 @@
+/**
+ * Mirror an authored file tree onto an Agent Store prefix. Shared by the
+ * skills and workspace seed syncs so both keep the same write-then-sweep
+ * discipline and the same path refusals.
+ */
+import { type FileSink } from "../files.js";
+/**
+ * Write every `desired` key, then delete keys under `prefix` (and the
+ * `legacyPrefixes`) that nothing claims, so a redeploy drops removed files.
+ * Writes land before stale deletes, so a failed sync never leaves a gap a
+ * concurrent cloud reader could see.
+ */
+export declare function mirrorToStore(args: {
+    sink: FileSink;
+    prefix: string;
+    desired: ReadonlyMap<string, Uint8Array>;
+    /** Pre-native layouts emptied on every sync so a rolled-forward deploy does not leave undiscoverable copies. */
+    legacyPrefixes?: readonly string[];
+}): Promise<void>;
+/**
+ * Same refusals as local materialization's `resolveInside`: a rel that
+ * escapes its directory or would not round-trip through the FUSE mount
+ * (`..`, `.`, `//`, 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.
+ */
+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

@@ -0,0 +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,CAiBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,gBAAgB,GACpC,MAAM,CAcR"}

package/dist/internal/store-mirror.js

@@ -0,0 +1,70 @@
+/**
+ * Mirror an authored file tree onto an Agent Store prefix. Shared by the
+ * skills and workspace seed syncs so both keep the same write-then-sweep
+ * discipline and the same path refusals.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { posix } from "node:path";
+import { FileConflictError } from "../files.js";
+/**
+ * Write every `desired` key, then delete keys under `prefix` (and the
+ * `legacyPrefixes`) that nothing claims, so a redeploy drops removed files.
+ * Writes land before stale deletes, so a failed sync never leaves a gap a
+ * concurrent cloud reader could see.
+ */
+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)));
+        yield Promise.all(listed
+            .flat()
+            .filter((entry) => !args.desired.has(entry.key))
+            .map((entry) => args.sink.delete(entry.key)));
+    });
+}
+/**
+ * Same refusals as local materialization's `resolveInside`: a rel that
+ * escapes its directory or would not round-trip through the FUSE mount
+ * (`..`, `.`, `//`, 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.
+ */
+export function storeRelPath(relPath, what) {
+    if (relPath.includes("\0") ||
+        relPath.includes("\\") ||
+        posix.isAbsolute(relPath) ||
+        relPath.endsWith("/") ||
+        relPath.split("/").some((seg) => seg === ".." || seg === ".") ||
+        posix.normalize(relPath) !== relPath) {
+        throw new Error(`Refusing ${what} path "${relPath}" (must be a normalized relative path)`);
+    }
+    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.
+ */
+function putLastWriterWins(sink, key, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield sink.put(key, body);
+        }
+        catch (error) {
+            if (!(error instanceof FileConflictError)) {
+                throw error;
+            }
+            yield sink.put(key, body);
+        }
+    });
+}

package/dist/internal/tenant-slack/relay.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Relay-backed Slack posting for managed deployments.
+ *
+ * On AgentSDK v2 managed deployments the fork never receives a Slack token.
+ * The delivery envelope carries the matched automation's configured Slack
+ * **channel ids** only (`managedAutomation.slackChannels`, absent when the
+ * customer toggled "Send to Slack" off); each post goes through the control
+ * plane's Slack relay
+ * (`/internal/agent-serve/agent-sdk-slack-relay/:automationUuid`),
+ * authenticated with the pod's own `CURSOR_API_KEY`. The relay re-checks
+ * that the channel is configured on exactly that automation, renders the
+ * markdown, and posts as the Cursor Slack app with the customer's stored
+ * workspace token.
+ *
+ * INTERNAL: first-party multi-tenant deployment plumbing. Deliberately
+ * excluded from the published `@cursor/july` npm package (see the `files`
+ * whitelist); consumed by internal deployments via relative source imports.
+ */
+/**
+ * Path prefix of the backend relay route. Must match the mount in
+ * `backend/server/src/agentServe/agentServeEndpoints.ts`
+ * (`agentSdkSlackRelayRoutes`).
+ */
+export declare const AGENT_SDK_SLACK_RELAY_PATH_PREFIX = "/internal/agent-serve/agent-sdk-slack-relay";
+/** Mirrors the relay's body bound; longer summaries are truncated client-side. */
+export declare const AGENT_SDK_SLACK_RELAY_MAX_MESSAGE_CHARS = 12000;
+/**
+ * Relay URL scoped to the source managed automation the delivery envelope
+ * attributed, so the relay checks the destination against exactly that
+ * automation's configured channels.
+ */
+export declare function relaySlackPostUrl(args: {
+    baseUrl: string;
+    automationUuid: string;
+}): string;
+export type RelaySlackPostResult = {
+    ok: true;
+    channel: string;
+    ts?: string;
+    permalink?: string;
+} | {
+    ok: false;
+    channel: string;
+    /** HTTP status from the relay, or 0 when the request never completed. */
+    status: number;
+    error: string;
+};
+export interface RelaySlackPostTarget {
+    relayBaseUrl: string;
+    apiKey: string;
+}
+/** Pod credential + external API base URL, or undefined off-platform. */
+export declare function resolveRelaySlackTarget(): RelaySlackPostTarget | undefined;
+/**
+ * Post one markdown message to one configured channel through the relay.
+ * Never throws: every failure is a `{ ok: false }` result so product code
+ * can log and continue (a Slack outage must not fail the review).
+ */
+export declare function postRelaySlackMessage(args: {
+    /** Source managed automation uuid from the delivery envelope. */
+    automationUuid: string;
+    /** Configured channel id (from `managedAutomation.slackChannels`). */
+    channel: string;
+    /** Markdown body. */
+    message: string;
+    /** Parent message ts to reply in a thread. */
+    threadTs?: string;
+    /** Test seam; defaults to the pod credential + external API base URL. */
+    resolve?: () => RelaySlackPostTarget | undefined;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<RelaySlackPostResult>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/internal/tenant-slack/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../../src/internal/tenant-slack/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,gDACC,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,uCAAuC,QAAS,CAAC;AAI9D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAKT;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IACE,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAM1E;AAmBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAC;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmEhC"}