@cursor/july 0.1.101 → 0.1.103

package/dist/internal/cursor-deployment-relay.d.ts

@@ -36,9 +36,13 @@ export interface DeploymentEventRelayOptions {
 }
 /** Current subscriptions: a live getter, otherwise the snapshot. */
 export declare function currentDeploymentSubscriptions(subscriptions: DeploymentSubscriptionSource): readonly ResolvedSubscription[];
-/** Normalize the channel's `deploySourceUris` option into concrete subscriptions. */
+/**
+ * Normalize the channel's `deploySourceUris` option into concrete
+ * subscriptions. An omitted or empty option resolves to none, which callers
+ * read as "defer to the deploy scope".
+ */
 export declare function resolveDeploymentSubscriptions(options: {
-    deploySourceUris: readonly (string | DeploymentSubscription)[];
+    deploySourceUris?: readonly (string | DeploymentSubscription)[];
     environments?: readonly string[];
     events?: readonly DeploymentEventType[];
 }): ResolvedSubscription[];

package/dist/internal/cursor-deployment-relay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-deployment-relay.d.ts","sourceRoot":"","sources":["../../src/internal/cursor-deployment-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAK1C;yBACyB;AACzB,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;CAClC;AAQD,MAAM,MAAM,4BAA4B,GACpC,SAAS,oBAAoB,EAAE,GAC/B,CAAC,MAAM,SAAS,oBAAoB,EAAE,CAAC,CAAC;AAE5C,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oEAAoE;AACpE,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,4BAA4B,GAC1C,SAAS,oBAAoB,EAAE,CAEjC;AAED,qFAAqF;AACrF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,gBAAgB,EAAE,SAAS,CAAC,MAAM,GAAG,sBAAsB,CAAC,EAAE,CAAC;IAC/D,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzC,GAAG,oBAAoB,EAAE,CA8CzB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,SAAS,oBAAoB,EAAE,CAAC,EAAE,GACnD,oBAAoB,EAAE,CA2BxB;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,oBAAoB,EAClC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAQT;AAED,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC7C,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB;AAED,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAE1D,YAA6B,OAAO,EAAE,2BAA2B,EAuEhE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAsBtB,KAAK,IAAI,IAAI,CAEZ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF"}
+{"version":3,"file":"cursor-deployment-relay.d.ts","sourceRoot":"","sources":["../../src/internal/cursor-deployment-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAK1C;yBACyB;AACzB,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;CAClC;AAQD,MAAM,MAAM,4BAA4B,GACpC,SAAS,oBAAoB,EAAE,GAC/B,CAAC,MAAM,SAAS,oBAAoB,EAAE,CAAC,CAAC;AAE5C,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oEAAoE;AACpE,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,4BAA4B,GAC1C,SAAS,oBAAoB,EAAE,CAEjC;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,gBAAgB,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,sBAAsB,CAAC,EAAE,CAAC;IAChE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzC,GAAG,oBAAoB,EAAE,CA8CzB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,SAAS,oBAAoB,EAAE,CAAC,EAAE,GACnD,oBAAoB,EAAE,CA2BxB;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,oBAAoB,EAClC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAQT;AAED,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC7C,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB;AAED,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAE1D,YAA6B,OAAO,EAAE,2BAA2B,EAuEhE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAsBtB,KAAK,IAAI,IAAI,CAEZ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF"}

package/dist/internal/cursor-deployment-relay.js

@@ -33,11 +33,15 @@ const DEFAULT_EVENTS = ["deployment.succeeded"];
 export function currentDeploymentSubscriptions(subscriptions) {
     return typeof subscriptions === "function" ? subscriptions() : subscriptions;
 }
-/** Normalize the channel's `deploySourceUris` option into concrete subscriptions. */
+/**
+ * Normalize the channel's `deploySourceUris` option into concrete
+ * subscriptions. An omitted or empty option resolves to none, which callers
+ * read as "defer to the deploy scope".
+ */
 export function resolveDeploymentSubscriptions(options) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const bySource = new Map();
-    for (const entry of options.deploySourceUris) {
+    for (const entry of (_a = options.deploySourceUris) !== null && _a !== void 0 ? _a : []) {
         const subscription = typeof entry === "string" ? { deploySourceUri: entry } : entry;
         // Case-folded only: `Deployment.deploy_source_uri` has no documented
         // format, and the server keys subscriptions the same way.
@@ -46,11 +50,11 @@ export function resolveDeploymentSubscriptions(options) {
             throw new Error(`deploymentsChannel: invalid deploy source "${subscription.deploySourceUri}".`);
         }
         const environments = [
-            ...new Set(((_b = (_a = subscription.environments) !== null && _a !== void 0 ? _a : options.environments) !== null && _b !== void 0 ? _b : [])
+            ...new Set(((_c = (_b = subscription.environments) !== null && _b !== void 0 ? _b : options.environments) !== null && _c !== void 0 ? _c : [])
                 .map((value) => value.trim())
                 .filter(Boolean)),
         ];
-        const events = new Set((_d = (_c = subscription.events) !== null && _c !== void 0 ? _c : options.events) !== null && _d !== void 0 ? _d : DEFAULT_EVENTS);
+        const events = new Set((_e = (_d = subscription.events) !== null && _d !== void 0 ? _d : options.events) !== null && _e !== void 0 ? _e : DEFAULT_EVENTS);
         if (events.size === 0) {
             throw new Error(`deploymentsChannel: deploy source "${deploySourceUri}" subscribes to no events.`);
         }
@@ -68,10 +72,10 @@ export function resolveDeploymentSubscriptions(options) {
                 ? []
                 : [...new Set([...existing.environments, ...environments])];
     }
-    // Empty is legal here and means "this channel wants nothing". The
-    // wire-level empty list means deregister. The host re-resolves on each
-    // heartbeat, so a channel that later fills `deploySourceUris` can
-    // register without a restart.
+    // Empty means "this channel names nothing". The relay wire reads that as
+    // deregistration, hosted admission reads it as "defer to the deploy
+    // scope". The host re-resolves on each heartbeat, so a channel that later
+    // fills `deploySourceUris` registers without a restart.
     return [...bySource.values()];
 }
 /**

package/dist/internal/deploy-manifest.d.ts

@@ -28,8 +28,8 @@
  * Keep that capability per-channel: do not reintroduce a provider-wide event
  * union for control-plane consumers.
  */
-import type { ContinuationIdentity } from "../continuation.js";
 import type { AgentProject, AgentProjectInfo } from "../types.js";
+import { type ContinuationIdentity } from "./continuation-identity.js";
 export declare const DEPLOY_MANIFEST_VERSION: 1;
 export interface AgentDeployManifestDeclarations {
     egressDomains: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAclE,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AAiC5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,qBAAqB,CA0DvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,SAAS,CAOnC"}
+{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOlE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAOpC,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AAiC5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,qBAAqB,CA0DvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,SAAS,CAOnC"}

package/dist/internal/deploy-manifest.js

@@ -32,7 +32,7 @@ import { z } from "zod";
 import { isPublicEndpointPolicy } from "../channels.js";
 import { isCursorHostedStorage } from "../storage-backends/cursor-hosted.js";
 import { applyAgentContinuationDefaults, channelContinuationIdentity, channelDeclaredEventTypes, handshakeChannelContinuation, } from "./continuation-channel.js";
-import { CONTINUATION_SELECTORS } from "./continuation-identity.js";
+import { CONTINUATION_SELECTORS, } from "./continuation-identity.js";
 import { projectInfo, runtimeArchitectureCompatibilityError, } from "./discovery.js";
 import { packageVersion } from "./distribution.js";
 export const DEPLOY_MANIFEST_VERSION = 1;

package/dist/internal/discovery/ab.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agent/ab.ts` or `agent/ab/*.ts` plus `agent/ab.config.ts`: live A/B experiments.
+ */
+import type { ABConfigFile } from "../../ab.js";
+import type { DiscoveredAB } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+export declare function loadABs(ctx: DiscoveryContext, agentDir: string, onDisable?: (source: string, path: string) => void): Promise<DiscoveredAB[]>;
+export declare function loadABConfig(ctx: DiscoveryContext, agentDir: string): Promise<ABConfigFile | undefined>;
+//# sourceMappingURL=ab.d.ts.map

package/dist/internal/discovery/ab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/ab.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAUlE,wBAAsB,OAAO,CAC3B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACjD,OAAO,CAAC,YAAY,EAAE,CAAC,CAiEzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAyBnC"}

package/dist/internal/discovery/ab.js

@@ -0,0 +1,113 @@
+/**
+ * `agent/ab.ts` or `agent/ab/*.ts` plus `agent/ab.config.ts`: live A/B experiments.
+ */
+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 { basename, extname, join, relative } from "node:path";
+import { getDefinitionKind } from "../brand.js";
+import { displayPath } from "./context.js";
+import { findModuleFile, isDirectory, isModuleFile, toPosix, walkFiles, } from "./fs.js";
+import { importDefault } from "./modules.js";
+export function loadABs(ctx, agentDir, onDisable) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const abs = [];
+        const seen = new Set();
+        const single = yield findModuleFile(agentDir, "ab");
+        if (single !== undefined) {
+            const definition = yield importDefault(ctx, single, onDisable === undefined ? "ab" : ["ab", "disabled"]);
+            if (definition !== undefined) {
+                if (getDefinitionKind(definition) === "disabled") {
+                    onDisable === null || onDisable === void 0 ? void 0 : onDisable("ab", single);
+                }
+                else {
+                    const name = resolveABName(definition, "ab");
+                    seen.add(name);
+                    abs.push({
+                        name,
+                        source: "ab",
+                        definition: definition,
+                    });
+                }
+            }
+        }
+        const absDir = join(agentDir, "ab");
+        if (yield isDirectory(absDir)) {
+            for (const filePath of yield walkFiles(absDir)) {
+                if (!isModuleFile(basename(filePath))) {
+                    continue;
+                }
+                const rel = toPosix(relative(absDir, filePath));
+                const stem = rel.slice(0, -extname(rel).length);
+                const definition = yield importDefault(ctx, filePath, onDisable === undefined ? "ab" : ["ab", "disabled"]);
+                if (definition === undefined) {
+                    continue;
+                }
+                if (getDefinitionKind(definition) === "disabled") {
+                    onDisable === null || onDisable === void 0 ? void 0 : onDisable(stem, filePath);
+                    continue;
+                }
+                const name = resolveABName(definition, stem);
+                if (seen.has(name)) {
+                    ctx.diagnostics.push({
+                        severity: "error",
+                        path: displayPath(ctx, filePath),
+                        message: `Duplicate A/B experiment name ${JSON.stringify(name)}.`,
+                    });
+                    continue;
+                }
+                seen.add(name);
+                abs.push({
+                    name,
+                    source: stem,
+                    definition: definition,
+                });
+            }
+        }
+        return abs;
+    });
+}
+export function loadABConfig(ctx, agentDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const path = yield findModuleFile(agentDir, "ab.config");
+        if (path === undefined) {
+            return undefined;
+        }
+        try {
+            const mod = yield ctx.importModule(path);
+            if (mod.default === null || typeof mod.default !== "object") {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, path),
+                    message: "ab.config.ts must default-export defineABConfig({ ... }) from @cursor/july/ab.",
+                });
+                return undefined;
+            }
+            return mod.default;
+        }
+        catch (error) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, path),
+                message: `Failed to load ab.config: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            return undefined;
+        }
+    });
+}
+function resolveABName(definition, fallback) {
+    if (typeof definition === "object" &&
+        definition !== null &&
+        "name" in definition &&
+        typeof definition.name === "string" &&
+        definition.name.length > 0) {
+        return definition.name;
+    }
+    return fallback;
+}

package/dist/internal/discovery/agent-config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `agent/agent.ts`: model, runtime architecture, working directory, hosting, and concurrency.
+ */
+import { type AgentArchitecture, type AgentConcurrencyOptions, type AgentConfigDefinition, type AgentHostingOptions, type AgentRuntime, type ModelSetting } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+export declare function runtimeArchitectureCompatibilityError(agent: {
+    runtime: AgentRuntime;
+    architecture?: AgentArchitecture;
+}): string | undefined;
+export declare function resolveArchitecture(ctx: DiscoveryContext, agentDir: string, architecture: AgentArchitecture | undefined): AgentArchitecture | undefined;
+/** Absolute harness cwd parent, or undefined when unset / blank. */
+export declare function resolveAgentCwd(ctx: DiscoveryContext, authored: string | undefined): string | undefined;
+/**
+ * Nested git checkouts inherit ancestor AGENTS.md / .cursor rules and MCP.
+ * Point those harnesses at ~/.cache/agent-serve/<dir> unless the agent
+ * already set cwd or workspaceDir.
+ */
+export declare function resolveLocalCwd(ctx: DiscoveryContext, authoredCwd: string | undefined, authoredWorkspaceDir: string | undefined): Promise<string | undefined>;
+/**
+ * Validate the authored `hosting` block against the same grammar the
+ * backend enforces on deploy. Violations are warning diagnostics (reported
+ * by `agent-sdk validate`), not hard failures: the backend stays
+ * authoritative and `agent-sdk deploy` re-checks before any network call.
+ */
+export declare function resolveHosting(ctx: DiscoveryContext, agentDir: string, hosting: AgentHostingOptions | undefined): AgentHostingOptions | undefined;
+/**
+ * Validate the authored `concurrency` block. Invalid values are **error**
+ * diagnostics (serve refuses to start): silently dropping a turn ceiling
+ * would fail open to unlimited parallelism, the opposite of what the
+ * author asked for.
+ */
+export declare function resolveConcurrency(ctx: DiscoveryContext, agentDir: string, concurrency: AgentConcurrencyOptions | undefined): AgentConcurrencyOptions | undefined;
+export declare function loadAgentConfig(ctx: DiscoveryContext, agentDir: string, isRoot: boolean): Promise<AgentConfigDefinition | undefined>;
+export declare function isValidModelSetting(model: unknown): model is ModelSetting;
+//# sourceMappingURL=agent-config.d.ts.map

package/dist/internal/discovery/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAEjB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AAI3E,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,MAAM,GAAG,SAAS,CAIrB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAc/B;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,mBAAmB,GAAG,SAAS,CAyCjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA4B5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUzE"}

package/dist/internal/discovery/agent-config.js

@@ -0,0 +1,173 @@
+/**
+ * `agent/agent.ts`: model, runtime architecture, working directory, hosting, and concurrency.
+ */
+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 { basename, isAbsolute, join, resolve } from "node:path";
+import { MAX_RUNNING_TURNS_LIMIT, } from "../../types.js";
+import { normalizePositiveInt } from "../bounded-int.js";
+import { isReservedSecretName, MAX_EGRESS_DOMAINS, validateEgressDomain, validateSecretName, } from "../hosting.js";
+import { defaultLocalHarnessCwd, isNestedInGitRepo } from "../workspace.js";
+import { displayPath, isBlank } from "./context.js";
+import { findModuleFile } from "./fs.js";
+import { importDefault } from "./modules.js";
+export function runtimeArchitectureCompatibilityError(agent) {
+    return agent.architecture === "v2" && agent.runtime === "grokbot"
+        ? 'architecture: "v2" cannot use runtime: "grokbot": the grokbot runtime executes through the signed-in account\'s hosted /v0/grokbot box, not a deployment-scoped v2 runtime.'
+        : undefined;
+}
+export function resolveArchitecture(ctx, agentDir, architecture) {
+    if (architecture === undefined ||
+        architecture === "v1" ||
+        architecture === "v2") {
+        return architecture;
+    }
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, join(agentDir, "agent.ts")),
+        message: `architecture must be "v1" or "v2"; got ${JSON.stringify(architecture)}.`,
+    });
+    return undefined;
+}
+/** Absolute harness cwd parent, or undefined when unset / blank. */
+export function resolveAgentCwd(ctx, authored) {
+    if (authored === undefined) {
+        return undefined;
+    }
+    const trimmed = authored.trim();
+    if (trimmed === "") {
+        return undefined;
+    }
+    return isAbsolute(trimmed) ? trimmed : resolve(ctx.rootDir, trimmed);
+}
+/**
+ * Nested git checkouts inherit ancestor AGENTS.md / .cursor rules and MCP.
+ * Point those harnesses at ~/.cache/agent-serve/<dir> unless the agent
+ * already set cwd or workspaceDir.
+ */
+export function resolveLocalCwd(ctx, authoredCwd, authoredWorkspaceDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cwd = resolveAgentCwd(ctx, authoredCwd);
+        if (cwd !== undefined) {
+            return cwd;
+        }
+        if (resolveAgentCwd(ctx, authoredWorkspaceDir) !== undefined) {
+            return undefined;
+        }
+        if (!(yield isNestedInGitRepo(ctx.rootDir))) {
+            return undefined;
+        }
+        return defaultLocalHarnessCwd(basename(ctx.rootDir));
+    });
+}
+/**
+ * Validate the authored `hosting` block against the same grammar the
+ * backend enforces on deploy. Violations are warning diagnostics (reported
+ * by `agent-sdk validate`), not hard failures: the backend stays
+ * authoritative and `agent-sdk deploy` re-checks before any network call.
+ */
+export function resolveHosting(ctx, agentDir, hosting) {
+    var _a, _b;
+    if (hosting === undefined) {
+        return undefined;
+    }
+    const agentPath = displayPath(ctx, join(agentDir, "agent.ts"));
+    const warn = (message) => {
+        ctx.diagnostics.push({ severity: "warning", path: agentPath, message });
+    };
+    const egressDomains = (_a = hosting.egressDomains) !== null && _a !== void 0 ? _a : [];
+    for (const domain of egressDomains) {
+        const domainError = validateEgressDomain(domain);
+        if (domainError !== undefined) {
+            warn(`hosting.egressDomains: ${domainError}`);
+        }
+    }
+    if (egressDomains.length > MAX_EGRESS_DOMAINS) {
+        warn(`hosting.egressDomains lists ${egressDomains.length} domains; deploys are capped at ${MAX_EGRESS_DOMAINS}.`);
+    }
+    for (const name of (_b = hosting.secretNames) !== null && _b !== void 0 ? _b : []) {
+        const nameError = validateSecretName(name);
+        if (nameError !== undefined) {
+            warn(`hosting.secretNames: ${nameError}`);
+        }
+        else if (isReservedSecretName(name)) {
+            warn(`hosting.secretNames: ${JSON.stringify(name)} is platform-managed (CURSOR_* / reserved hosted-storage names); omit it from secretNames.`);
+        }
+    }
+    return Object.assign(Object.assign({}, (hosting.egressDomains === undefined
+        ? {}
+        : { egressDomains: [...hosting.egressDomains] })), (hosting.secretNames === undefined
+        ? {}
+        : { secretNames: [...hosting.secretNames] }));
+}
+/**
+ * Validate the authored `concurrency` block. Invalid values are **error**
+ * diagnostics (serve refuses to start): silently dropping a turn ceiling
+ * would fail open to unlimited parallelism, the opposite of what the
+ * author asked for.
+ */
+export function resolveConcurrency(ctx, agentDir, concurrency) {
+    if (concurrency === undefined || concurrency.maxRunningTurns === undefined) {
+        return undefined;
+    }
+    try {
+        return {
+            maxRunningTurns: normalizePositiveInt(concurrency.maxRunningTurns, {
+                label: "concurrency.maxRunningTurns",
+                max: MAX_RUNNING_TURNS_LIMIT,
+            }),
+        };
+    }
+    catch (error) {
+        ctx.diagnostics.push({
+            severity: "error",
+            path: displayPath(ctx, join(agentDir, "agent.ts")),
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+}
+export function loadAgentConfig(ctx, agentDir, isRoot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const configPath = yield findModuleFile(agentDir, "agent");
+        if (configPath === undefined) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, join(agentDir, "agent.ts")),
+                message: isRoot
+                    ? "agent.ts is required on the root agent: default-export defineAgent({ ... })"
+                    : "agent.ts is required on a subagent: default-export defineAgent({ description: ... })",
+            });
+            return undefined;
+        }
+        const definition = yield importDefault(ctx, configPath, "agent");
+        if (definition === undefined) {
+            return undefined;
+        }
+        const config = definition;
+        if (!isRoot && isBlank(config.description)) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, configPath),
+                message: "Subagents require a description; the parent model reads it to decide when to delegate.",
+            });
+        }
+        return config;
+    });
+}
+export function isValidModelSetting(model) {
+    if (typeof model === "string") {
+        return model.trim() !== "";
+    }
+    return (typeof model === "object" &&
+        model !== null &&
+        typeof model.id === "string" &&
+        model.id.trim() !== "");
+}

package/dist/internal/discovery/agent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Compile one `agent/` directory (and its subagents) into a {@link ResolvedAgent}.
+ */
+import { type ResolvedAgent } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+import type { ExtensionContributions } from "./extensions.js";
+export interface LoadedRootAgent {
+    agent: ResolvedAgent;
+    projectSlots: Pick<ExtensionContributions, "hooks" | "channels" | "schedules" | "abs" | "artifacts">;
+}
+export declare function loadAgent(ctx: DiscoveryContext, agentDir: string, options: {
+    name: string;
+    isRoot: boolean;
+}): Promise<LoadedRootAgent>;
+export declare function warnUnknownSlots(ctx: DiscoveryContext, agentDir: string): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/internal/discovery/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAaxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAc9D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,IAAI,CAChB,sBAAsB,EACtB,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,WAAW,CACzD,CAAC;CACH;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CA0N1B;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA0Cf"}