@cursor/july 0.1.102 → 0.1.103

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;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"}

package/dist/internal/discovery/agent.js

@@ -11,85 +11,72 @@ 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 { DEFAULT_MODEL, } from "../../types.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;
+        if (!options.isRoot) {
+            return {
+                agent: yield loadSubagent(ctx, agentDir, options.name),
+                projectSlots: {
+                    hooks: [],
+                    channels: [],
+                    schedules: [],
+                    abs: [],
+                    artifacts: undefined,
+                },
+            };
+        }
         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.
-        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,
-            });
-        }
-        // Root agents without authored instructions stay undefined (diagnostic
-        // already recorded).
-        const instructions = authoredInstructions === undefined
-            ? undefined
-            : withIdentityPreamble(name, authoredInstructions);
         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.
@@ -198,64 +185,28 @@ 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({ 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 }),
+            projectSlots: {
+                hooks,
+                channels,
+                schedules,
+                abs,
+                artifacts: contributions.artifacts,
+            },
+        };
     });
 }
 export function warnUnknownSlots(ctx, agentDir) {
@@ -268,8 +219,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),

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

@@ -5,12 +5,8 @@ import { type ConnectionDefinition, type ConnectionTransport, type DiscoveredCon
 import { type DiscoveryContext } from "./context.js";
 /** One-line `/v1/info` label for a connection transport. */
 export declare function connectionTransportLabel(transport: ConnectionTransport): string;
-/**
- * Prefer `agent/mcp-connections/`. Keep loading `agent/connections/` with a
- * deprecation warning so existing agents keep working during the rename.
- */
-export declare function resolveMcpConnectionsDir(ctx: DiscoveryContext, agentDir: string): Promise<string>;
 export declare function loadHostConnections(ctx: DiscoveryContext, agentDir: string, modelConnections: readonly DiscoveredConnection[]): Promise<DiscoveredConnection[]>;
+export declare function compileHostConnection(ctx: DiscoveryContext, path: string, name: string, definition: ConnectionDefinition): Promise<DiscoveredConnection | undefined>;
 export declare function loadConnections(ctx: DiscoveryContext, connectionsDir: string, role?: "model" | "host"): Promise<DiscoveredConnection[]>;
 /** Validate one `defineConnection` and resolve its transport. */
 export declare function compileConnection(ctx: DiscoveryContext, entryPath: string, name: string, connection: ConnectionDefinition, role: "model" | "host"): Promise<DiscoveredConnection | undefined>;

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

@@ -1 +1 @@
-{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/connections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAQ1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAKtB,4DAA4D;AAC5D,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAeR;AAkGD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,GAChD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAqCjC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuBjC;AAED,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAuN3C"}
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/connections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAQ1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAItB,4DAA4D;AAC5D,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAeR;AAkGD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,GAChD,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA4BjC;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAe3C;AA4BD,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuBjC;AAED,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,oBAAoB,EAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAuN3C"}

package/dist/internal/discovery/connections.js

@@ -14,7 +14,6 @@ import { join } from "node:path";
 import { cursorAccountServersHasMixedWildcard, isInlineStdioConnection, isToolEffect, normalizeConnectionEffects, normalizeConnectionTools, normalizeCursorAccountServers, } from "../../types.js";
 import { packageInlineStdioConnection } from "../package-inline-stdio.js";
 import { displayPath, errorMessage, isBlank, } from "./context.js";
-import { isDirectory } from "./fs.js";
 import { importDefault, moduleEntries } from "./modules.js";
 import { NAME_PATTERN } from "./names.js";
 /** One-line `/v1/info` label for a connection transport. */
@@ -106,35 +105,6 @@ function connectionTransport(connection) {
     }
     return undefined;
 }
-/**
- * Prefer `agent/mcp-connections/`. Keep loading `agent/connections/` with a
- * deprecation warning so existing agents keep working during the rename.
- */
-export function resolveMcpConnectionsDir(ctx, agentDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const preferred = join(agentDir, "mcp-connections");
-        const legacy = join(agentDir, "connections");
-        const hasPreferred = yield isDirectory(preferred);
-        const hasLegacy = yield isDirectory(legacy);
-        if (hasPreferred && hasLegacy) {
-            ctx.diagnostics.push({
-                severity: "warning",
-                path: displayPath(ctx, legacy),
-                message: "Both agent/mcp-connections/ and agent/connections/ exist; using mcp-connections/ and ignoring connections/. Rename or remove the legacy directory.",
-            });
-            return preferred;
-        }
-        if (hasLegacy) {
-            ctx.diagnostics.push({
-                severity: "warning",
-                path: displayPath(ctx, legacy),
-                message: "agent/connections/ is deprecated; rename it to agent/mcp-connections/. Loading from the legacy path for now.",
-            });
-            return legacy;
-        }
-        return preferred;
-    });
-}
 export function loadHostConnections(ctx, agentDir, modelConnections) {
     return __awaiter(this, void 0, void 0, function* () {
         const hostDir = join(agentDir, "host-connections");
@@ -150,20 +120,7 @@ export function loadHostConnections(ctx, agentDir, modelConnections) {
                 });
                 continue;
             }
-            if (connection.advertiseTools === true) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, join(hostDir, `${connection.name}.ts`)),
-                    message: "Host connections are off the model. `advertiseTools` cannot apply. Drop it.",
-                });
-                continue;
-            }
-            if (connection.auth !== undefined) {
-                ctx.diagnostics.push({
-                    severity: "error",
-                    path: displayPath(ctx, join(hostDir, `${connection.name}.ts`)),
-                    message: "Host connections are off the model. `auth` cannot apply. Use static headers or `oauth: true`.",
-                });
+            if (rejectHostConnectionFeatures(ctx, join(hostDir, `${connection.name}.ts`), connection)) {
                 continue;
             }
             hostConnections.push(connection);
@@ -171,6 +128,35 @@ export function loadHostConnections(ctx, agentDir, modelConnections) {
         return hostConnections;
     });
 }
+export function compileHostConnection(ctx, path, name, definition) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const connection = yield compileConnection(ctx, path, name, definition, "host");
+        if (connection === undefined ||
+            rejectHostConnectionFeatures(ctx, path, connection)) {
+            return undefined;
+        }
+        return connection;
+    });
+}
+function rejectHostConnectionFeatures(ctx, path, connection) {
+    if (connection.advertiseTools === true) {
+        ctx.diagnostics.push({
+            severity: "error",
+            path: displayPath(ctx, path),
+            message: "Host connections are off the model. `advertiseTools` cannot apply. Drop it.",
+        });
+        return true;
+    }
+    if (connection.auth !== undefined) {
+        ctx.diagnostics.push({
+            severity: "error",
+            path: displayPath(ctx, path),
+            message: "Host connections are off the model. `auth` cannot apply. Use static headers or `oauth: true`.",
+        });
+        return true;
+    }
+    return false;
+}
 export function loadConnections(ctx_1, connectionsDir_1) {
     return __awaiter(this, arguments, void 0, function* (ctx, connectionsDir, role = "model") {
         const connections = [];

package/dist/internal/discovery/cursor-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-plugin.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/cursor-plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAItB,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,4EAA4E;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAoGD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAqCvC"}
+{"version":3,"file":"cursor-plugin.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/cursor-plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAItB,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,4EAA4E;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAoGD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAqCvC"}

package/dist/internal/discovery/cursor-plugin.js

@@ -14,6 +14,7 @@ import { readFile } from "node:fs/promises";
 import { basename, dirname, extname, isAbsolute, join } from "node:path";
 import { z } from "zod";
 import { parseYamlFrontmatter } from "../frontmatter.js";
+import { isRecord } from "../is-record.js";
 import { displayPath, errorMessage, isBlank, } from "./context.js";
 import { isDirectory, isFile, sortedEntries, walkFiles } from "./fs.js";
 import { skillDescription, skillFiles } from "./skills.js";
@@ -565,6 +566,3 @@ function firstIssue(error) {
 function fileStem(path) {
     return basename(path, extname(path));
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}

package/dist/internal/discovery/extension-overlay.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Directory-mount overlays: a same-named file replaces, disable() removes.
+ * Slot loaders do the walk; this file only applies replace/disable.
+ */
+import type { ArtifactsDefinition, DiscoveredAB, DiscoveredChannel, DiscoveredHook, DiscoveredSchedule, DiscoveredSkill, ResolvedAgent } from "../../types.js";
+import { type DiscoveryContext } from "./context.js";
+export interface OverlaySite {
+    ns: string;
+}
+interface OverlaySlot<T> {
+    kind: "tool" | "connection";
+    disabledKind: "disabled-tool" | "disabled-connection";
+    disableHelper: string;
+    declared: ReadonlySet<string>;
+    compile: (ctx: DiscoveryContext, path: string, name: string, definition: unknown) => Promise<T | undefined> | T | undefined;
+}
+export declare function overlaySlot<T extends {
+    name: string;
+}>(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, T>, entries: Array<{
+    name: string;
+    path: string;
+}>, slot: OverlaySlot<T>): Promise<void>;
+export declare function overlaySkills(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, DiscoveredSkill>, dir: string): Promise<void>;
+export declare function overlayHooks(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, DiscoveredHook>, dir: string): Promise<void>;
+export declare function overlaySchedules(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, DiscoveredSchedule>, dir: string): Promise<void>;
+export declare function overlayChannels(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, DiscoveredChannel>, dir: string): Promise<void>;
+export declare function overlaySubagents(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, ResolvedAgent>, dir: string): Promise<void>;
+export declare function overlayInstructionsFragment(ctx: DiscoveryContext, overlayDir: string): Promise<string | undefined | "keep">;
+export declare function overlayAbs(ctx: DiscoveryContext, site: OverlaySite, contributed: Map<string, DiscoveredAB>, overlayDir: string): Promise<void>;
+export declare function overlayArtifacts(ctx: DiscoveryContext, overlayDir: string, current: ArtifactsDefinition | undefined): Promise<ArtifactsDefinition | undefined>;
+export {};
+//# sourceMappingURL=extension-overlay.d.ts.map

package/dist/internal/discovery/extension-overlay.d.ts.map

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