@cursor/july 0.1.102 → 0.1.104

package/dist/internal/cursor-account-mcp-auth.js

@@ -23,6 +23,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { LOG_PREFIX } from "./distribution.js";
 import { openBrowser } from "./mcp-oauth.js";
+import { sleep as defaultSleep } from "./sleep.js";
 const DEFAULT_POLL_INTERVAL_MS = 3000;
 const DEFAULT_POLL_TIMEOUT_MS = 5 * 60 * 1000;
 /** Same default the dashboard uses; MCP_OAUTH_REDIRECT_URI overrides for dev. */
@@ -33,9 +34,6 @@ export function mcpOauthRedirectUri() {
     }
     return "https://www.cursor.com/agents/mcp/oauth/callback";
 }
-function sleepMs(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
 /**
  * Authorize the deployment service account for the connection's connectors.
  * Already-authorized connectors are skipped; the rest get a browser OAuth
@@ -46,7 +44,7 @@ export function authorizeCursorAccountConnectors(args) {
         var _a, _b, _c, _d, _e, _f;
         const { backendClient, teamId, serviceAccountId, connectionName, out, err } = args;
         const open = (_a = args.openBrowserImpl) !== null && _a !== void 0 ? _a : openBrowser;
-        const sleep = (_b = args.sleep) !== null && _b !== void 0 ? _b : sleepMs;
+        const sleep = (_b = args.sleep) !== null && _b !== void 0 ? _b : defaultSleep;
         const pollIntervalMs = (_c = args.pollIntervalMs) !== null && _c !== void 0 ? _c : DEFAULT_POLL_INTERVAL_MS;
         const pollTimeoutMs = (_d = args.pollTimeoutMs) !== null && _d !== void 0 ? _d : DEFAULT_POLL_TIMEOUT_MS;
         const redirectUri = mcpOauthRedirectUri();

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

@@ -4,6 +4,6 @@
 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): Promise<DiscoveredAB[]>;
+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

@@ -1 +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;AACnD,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAUlE,wBAAsB,OAAO,CAC3B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CA+CzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAyBnC"}
+{"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

@@ -11,23 +11,30 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 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) {
+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, "ab");
+            const definition = yield importDefault(ctx, single, onDisable === undefined ? "ab" : ["ab", "disabled"]);
             if (definition !== undefined) {
-                const name = resolveABName(definition, "ab");
-                seen.add(name);
-                abs.push({
-                    name,
-                    definition: definition,
-                });
+                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");
@@ -38,10 +45,14 @@ export function loadABs(ctx, agentDir) {
                 }
                 const rel = toPosix(relative(absDir, filePath));
                 const stem = rel.slice(0, -extname(rel).length);
-                const definition = yield importDefault(ctx, filePath, "ab");
+                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({
@@ -54,6 +65,7 @@ export function loadABs(ctx, agentDir) {
                 seen.add(name);
                 abs.push({
                     name,
+                    source: stem,
                     definition: definition,
                 });
             }

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

@@ -3,9 +3,14 @@
  */
 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<ResolvedAgent>;
+}): 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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkBnE,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAelE,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,aAAa,CAAC,CAyNxB;AAqDD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAcxB,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,CAyS1B;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/internal/discovery/agent.js

@@ -11,85 +11,74 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { join } from "node:path";
-import { DEFAULT_MODEL } from "../../types.js";
-import { builtinTools } from "../builtin-tools/index.js";
+import { canonicalizeFileSystemToolName, FileSystemConfigError, resolveFileSystemTools, resolveRootHarnessAllowlist, } from "../../filesystem.js";
+import { DEFAULT_MODEL, } from "../../types.js";
+import { synthesizedFileSystemToolNames } from "../filesystem/tools.js";
 import { withIdentityPreamble } from "../workspace.js";
 import { isValidModelSetting, loadAgentConfig, resolveAgentCwd, resolveArchitecture, resolveConcurrency, resolveHosting, resolveLocalCwd, runtimeArchitectureCompatibilityError, } from "./agent-config.js";
-import { loadConnections, loadHostConnections, resolveMcpConnectionsDir, } from "./connections.js";
+import { loadConnections, loadHostConnections } from "./connections.js";
 import { displayPath } from "./context.js";
 import { appendExtensions } from "./extensions.js";
-import { findModuleFile, isDirectory, sortedEntries } from "./fs.js";
+import { sortedEntries } from "./fs.js";
 import { loadInstructions } from "./instructions.js";
-import { validateName } from "./names.js";
 import { checkGrokBotRuntimeLimitations, resolveRuntime, warnCloudRuntimeLimitations, } from "./runtime.js";
 import { loadSeedFiles } from "./seed-files.js";
 import { loadSkills } from "./skills.js";
-import { subagent } from "./subagent.js";
+import { loadSubagent, loadSubagents } from "./subagent.js";
 import { appendBuiltinTools, loadTools } from "./tools.js";
 export function loadAgent(ctx, agentDir, options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
-        var _e;
-        const config = yield loadAgentConfig(ctx, agentDir, options.isRoot);
-        const name = (_e = config === null || config === void 0 ? void 0 : config.name) !== null && _e !== void 0 ? _e : options.name;
-        const authoredInstructions = yield loadInstructions(ctx, agentDir, config, options.isRoot);
-        // Subagents run as Cursor SDK custom subagents (prompt + description +
-        // model); their other slots are inert today, so don't load them — just
-        // warn that they exist.
+        var _a, _b, _c, _d, _e, _f, _g;
+        var _h;
         if (!options.isRoot) {
-            yield warnUnsupportedSubagentSlots(ctx, agentDir);
-            if ((config === null || config === void 0 ? void 0 : config.builtinTools) !== undefined) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, join(agentDir, "agent.ts")),
-                    message: "builtinTools is not supported on subagents; ignoring.",
-                });
-            }
-            if ((config === null || config === void 0 ? void 0 : config.tools) !== undefined) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, join(agentDir, "agent.ts")),
-                    message: "tools is not supported on subagents (they keep the harness task-tool toolset); ignoring.",
-                });
-            }
-            if ((config === null || config === void 0 ? void 0 : config.architecture) !== undefined) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, join(agentDir, "agent.ts")),
-                    message: "architecture is not supported on subagents; ignoring.",
-                });
-            }
-            const artifactsPath = yield findModuleFile(agentDir, "artifacts");
-            if (artifactsPath !== undefined) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, artifactsPath),
-                    message: "artifacts are not supported on subagents; ignoring.",
-                });
-            }
-            return subagent(name, {
-                description: config === null || config === void 0 ? void 0 : config.description,
-                model: config === null || config === void 0 ? void 0 : config.model,
-                prompt: authoredInstructions,
-            });
+            return {
+                agent: yield loadSubagent(ctx, agentDir, options.name),
+                projectSlots: {
+                    hooks: [],
+                    channels: [],
+                    schedules: [],
+                    abs: [],
+                    artifacts: undefined,
+                },
+            };
         }
-        // Root agents without authored instructions stay undefined (diagnostic
-        // already recorded).
-        const instructions = authoredInstructions === undefined
-            ? undefined
-            : withIdentityPreamble(name, authoredInstructions);
+        const config = yield loadAgentConfig(ctx, agentDir, options.isRoot);
+        const name = (_h = config === null || config === void 0 ? void 0 : config.name) !== null && _h !== void 0 ? _h : options.name;
+        const authoredInstructions = yield loadInstructions(ctx, agentDir, config, options.isRoot);
         const tools = yield loadTools(ctx, join(agentDir, "tools"));
         const skills = yield loadSkills(ctx, join(agentDir, "skills"));
-        const connections = yield loadConnections(ctx, yield resolveMcpConnectionsDir(ctx, agentDir));
+        const connections = yield loadConnections(ctx, join(agentDir, "mcp-connections"));
         const subagents = yield loadSubagents(ctx, join(agentDir, "subagents"));
-        const extensions = yield appendExtensions(ctx, join(agentDir, "extensions"), {
+        const hostConnections = yield loadHostConnections(ctx, agentDir, connections);
+        const seedFiles = yield loadSeedFiles(ctx, agentDir);
+        const hooks = [];
+        const channels = [];
+        const schedules = [];
+        const abs = [];
+        const instructionParts = [];
+        const contributions = {
             tools,
             skills,
             connections,
+            hostConnections,
             subagents,
-        });
-        const hostConnections = yield loadHostConnections(ctx, agentDir, connections);
-        const seedFiles = yield loadSeedFiles(ctx, agentDir);
+            hooks,
+            channels,
+            schedules,
+            instructionParts,
+            seedFiles,
+            abs,
+            artifacts: undefined,
+        };
+        const extensions = yield appendExtensions(ctx, join(agentDir, "extensions"), contributions);
+        const promptParts = [...instructionParts];
+        if (authoredInstructions !== undefined && authoredInstructions !== "") {
+            promptParts.unshift(authoredInstructions);
+        }
+        const prompt = promptParts.join("\n\n");
+        // Root agents without authored instructions stay undefined (diagnostic
+        // already recorded) unless an extension contributed a fragment.
+        const instructions = prompt === "" ? undefined : withIdentityPreamble(name, prompt);
         const runtime = resolveRuntime(ctx, agentDir, config === null || config === void 0 ? void 0 : config.runtime);
         // Keep authored `cloud` even when default runtime is local — per-session
         // `send({ cloud })` merges it under cloudOverride for handoff sessions.
@@ -106,9 +95,80 @@ export function loadAgent(ctx, agentDir, options) {
         // second layer (authored tools, mcp-connections, the harness cwd's
         // ambient config).
         const authoredAllowlist = config === null || config === void 0 ? void 0 : config.tools;
-        const allowedTools = authoredAllowlist === undefined || authoredAllowlist.includes("mcp")
+        const root = config === null || config === void 0 ? void 0 : config.root;
+        const hasRoot = root !== undefined;
+        if (hasRoot) {
+            if (((_e = config === null || config === void 0 ? void 0 : config.local) === null || _e === void 0 ? void 0 : _e.cwd) !== undefined ||
+                ((_f = config === null || config === void 0 ? void 0 : config.local) === null || _f === void 0 ? void 0 : _f.workspaceDir) !== undefined ||
+                ((_g = config === null || config === void 0 ? void 0 : config.local) === null || _g === void 0 ? void 0 : _g.sandbox) === true) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "agent.ts")),
+                    message: "`root` cannot be combined with `local.cwd`, `local.workspaceDir`, or `local.sandbox`. Those fields configure the host tree the override replaced.",
+                });
+            }
+            if (runtime === "cloud" || runtime === "grokbot") {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "agent.ts")),
+                    message: `\`root\` cannot be combined with runtime: "${runtime}".`,
+                });
+            }
+            if ((authoredAllowlist === null || authoredAllowlist === void 0 ? void 0 : authoredAllowlist.includes("shell")) === true ||
+                (authoredAllowlist === null || authoredAllowlist === void 0 ? void 0 : authoredAllowlist.includes("Shell")) === true) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "agent.ts")),
+                    message: '`root` cannot be combined with `tools` containing `"shell"`. Shell is not a FileSystem method and must not bind the host shell onto a virtual tree.',
+                });
+            }
+        }
+        const reservedNames = new Set(synthesizedFileSystemToolNames({
+            hasRoot,
+            tools: authoredAllowlist,
+        }));
+        const clash = tools.find((tool) => {
+            if (reservedNames.has(tool.name)) {
+                return true;
+            }
+            const canonical = canonicalizeFileSystemToolName(tool.name);
+            return canonical !== undefined && reservedNames.has(canonical);
+        });
+        if (clash !== undefined) {
+            ctx.diagnostics.push({
+                severity: "error",
+                path: displayPath(ctx, join(agentDir, "tools", `${clash.name}.ts`)),
+                message: `agent/tools/${clash.name}.ts: that name is reserved for the synthesized FileSystem tool.`,
+            });
+        }
+        let allowedTools = authoredAllowlist === undefined || authoredAllowlist.includes("mcp")
             ? authoredAllowlist
             : [...authoredAllowlist, "mcp"];
+        if (hasRoot) {
+            try {
+                if (typeof root !== "function") {
+                    resolveFileSystemTools({
+                        root,
+                        tools: authoredAllowlist,
+                    });
+                }
+                else {
+                    resolveRootHarnessAllowlist(authoredAllowlist);
+                }
+                allowedTools = authoredAllowlist;
+            }
+            catch (error) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, join(agentDir, "agent.ts")),
+                    message: error instanceof FileSystemConfigError
+                        ? error.message
+                        : error instanceof Error
+                            ? error.message
+                            : String(error),
+                });
+            }
+        }
         // The allowlist states runtime-agnostic intent, but only the local
         // harness can enforce it (the Cursor SDK rejects tool restrictions on
         // cloud agents, and the Grok Bot harness has its own fixed toolset) — a
@@ -198,64 +258,27 @@ export function loadAgent(ctx, agentDir, options) {
                 hasLocalSandbox: localSandbox,
             });
         }
-        return Object.assign(Object.assign(Object.assign(Object.assign({ name, description: config === null || config === void 0 ? void 0 : config.description, 
-            // Root agents always get a concrete model: authored value or DEFAULT_MODEL.
-            model: isValidModelSetting(config === null || config === void 0 ? void 0 : config.model) ? config.model : DEFAULT_MODEL, instructions,
-            runtime,
-            cloud,
-            local }, (allowedTools === undefined ? {} : { allowedTools })), { hosting,
-            concurrency }), (architecture === undefined ? {} : { architecture })), { tools,
-            skills,
-            extensions,
-            connections,
-            hostConnections,
-            subagents,
-            seedFiles });
-    });
-}
-function loadSubagents(ctx, subagentsDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!(yield isDirectory(subagentsDir))) {
-            return [];
-        }
-        const subagents = [];
-        for (const entry of yield sortedEntries(subagentsDir)) {
-            if (!entry.isDirectory()) {
-                continue;
-            }
-            const subagentDir = join(subagentsDir, entry.name);
-            if (!validateName(ctx, "subagent", entry.name, subagentDir)) {
-                continue;
-            }
-            subagents.push(yield loadAgent(ctx, subagentDir, { name: entry.name, isRoot: false }));
-        }
-        return subagents;
-    });
-}
-function warnUnsupportedSubagentSlots(ctx, subagentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const unsupported = [
-            ["tools", "tools"],
-            ["skills", "skills"],
-            ["extensions", "extensions"],
-            ["mcp-connections", "MCP connections"],
-            ["host-connections", "host MCP connections"],
-            ["connections", "MCP connections"],
-            ["subagents", "nested subagents"],
-            ["channels", "channels"],
-            ["schedules", "schedules"],
-            ["hooks", "hooks"],
-            ["sandbox", "sandbox files"],
-        ];
-        for (const [slot, label] of unsupported) {
-            if (yield isDirectory(join(subagentDir, slot))) {
-                ctx.diagnostics.push({
-                    severity: "warning",
-                    path: displayPath(ctx, join(subagentDir, slot)),
-                    message: `Subagent ${label} are not supported on the Cursor harness yet; the subagent runs with the parent's execution surface. Ignoring.`,
-                });
-            }
-        }
+        return {
+            agent: Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ name, description: config === null || config === void 0 ? void 0 : config.description, 
+                // Root agents always get a concrete model: authored value or DEFAULT_MODEL.
+                model: isValidModelSetting(config === null || config === void 0 ? void 0 : config.model) ? config.model : DEFAULT_MODEL, instructions,
+                runtime }, (root === undefined ? {} : { root })), { cloud,
+                local }), (allowedTools === undefined ? {} : { allowedTools })), { hosting,
+                concurrency }), (architecture === undefined ? {} : { architecture })), { tools,
+                skills,
+                extensions,
+                connections,
+                hostConnections,
+                subagents,
+                seedFiles }),
+            projectSlots: {
+                hooks,
+                channels,
+                schedules,
+                abs,
+                artifacts: contributions.artifacts,
+            },
+        };
     });
 }
 export function warnUnknownSlots(ctx, agentDir) {
@@ -268,8 +291,6 @@ export function warnUnknownSlots(ctx, agentDir) {
             "extensions",
             "mcp-connections",
             "host-connections",
-            // Legacy slot name; resolveMcpConnectionsDir warns and still loads it.
-            "connections",
             "subagents",
             "channels",
             "schedules",

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

@@ -3,7 +3,7 @@
  */
 import type { DiscoveredChannel, HttpChannelDefinition } from "../../types.js";
 import { type DiscoveryContext } from "./context.js";
-export declare function loadChannels(ctx: DiscoveryContext, channelsDir: string): Promise<{
+export declare function loadChannels(ctx: DiscoveryContext, channelsDir: string, mode?: "agent" | "extension", onDisable?: (id: string, path: string) => void): Promise<{
     channels: DiscoveredChannel[];
     httpChannelDefinition: HttpChannelDefinition | undefined;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/channels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAEV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,cAAc,CAAC;AAIhF,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC1D,CAAC,CAgFD"}
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/channels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAEV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,gBAAgB,EAA6B,MAAM,cAAc,CAAC;AAIhF,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,OAAO,GAAG,WAAqB,EACrC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7C,OAAO,CAAC;IACT,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC1D,CAAC,CAiFD"}

package/dist/internal/discovery/channels.js

@@ -11,13 +11,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { join } from "node:path";
-import { httpChannel } from "../../channels.js";
 import { getDefinitionKind } from "../brand.js";
 import { displayPath, errorMessage } from "./context.js";
 import { isDirectory, isModuleFile, moduleStem, sortedEntries } from "./fs.js";
-import { NAME_PATTERN } from "./names.js";
-export function loadChannels(ctx, channelsDir) {
-    return __awaiter(this, void 0, void 0, function* () {
+import { validateName } from "./names.js";
+export function loadChannels(ctx_1, channelsDir_1) {
+    return __awaiter(this, arguments, void 0, function* (ctx, channelsDir, mode = "agent", onDisable) {
         var _a;
         var _b;
         const channels = [];
@@ -31,12 +30,7 @@ export function loadChannels(ctx, channelsDir) {
                 continue;
             }
             const id = moduleStem(entry.name);
-            if (!NAME_PATTERN.test(id)) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, entryPath),
-                    message: `Channel id "${id}" must match ${NAME_PATTERN}.`,
-                });
+            if (!validateName(ctx, "channel", id, entryPath)) {
                 continue;
             }
             let mod;
@@ -52,12 +46,18 @@ export function loadChannels(ctx, channelsDir) {
                 continue;
             }
             const kind = getDefinitionKind(mod.default);
+            if (kind === "disabled") {
+                onDisable === null || onDisable === void 0 ? void 0 : onDisable(id, entryPath);
+                continue;
+            }
             if (kind === "http-channel") {
-                if (id !== "http") {
+                if (mode === "extension" || id !== "http") {
                     ctx.diagnostics.push({
                         severity: "error",
                         path: displayPath(ctx, entryPath),
-                        message: "httpChannel() configures the built-in HTTP channel and must be authored at channels/http.ts.",
+                        message: mode === "extension"
+                            ? "httpChannel() configures the agent's built-in HTTP channel; an extension cannot contribute it."
+                            : "httpChannel() configures the built-in HTTP channel and must be authored at channels/http.ts.",
                     });
                     continue;
                 }
@@ -68,13 +68,13 @@ export function loadChannels(ctx, channelsDir) {
                 ctx.diagnostics.push({
                     severity: "error",
                     path: displayPath(ctx, entryPath),
-                    message: id === "http"
+                    message: id === "http" && mode === "agent"
                         ? "channels/http.ts must default-export httpChannel({ ... })."
                         : "Channel modules must default-export defineChannel({ ... }).",
                 });
                 continue;
             }
-            if (id === "http") {
+            if (id === "http" && mode === "agent") {
                 ctx.diagnostics.push({
                     severity: "error",
                     path: displayPath(ctx, entryPath),