@cursor/july 0.1.102 → 0.1.104

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

package/dist/internal/discovery/extension-overlay.js

@@ -0,0 +1,191 @@
+/**
+ * Directory-mount overlays: a same-named file replaces, disable() removes.
+ * Slot loaders do the walk; this file only applies replace/disable.
+ */
+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 { join } from "node:path";
+import { getDefinitionKind } from "../brand.js";
+import { loadABs } from "./ab.js";
+import { loadChannels } from "./channels.js";
+import { displayPath, errorMessage } from "./context.js";
+import { findModuleFile, isDirectory, isFile, isModuleFile, moduleStem, sortedEntries, } from "./fs.js";
+import { loadHooks } from "./hooks.js";
+import { loadInstructions } from "./instructions.js";
+import { importDefault } from "./modules.js";
+import { loadSchedules } from "./schedules.js";
+import { loadSkills } from "./skills.js";
+import { loadSubagents } from "./subagent.js";
+export function overlaySlot(ctx, site, contributed, entries, slot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        for (const { name, path } of entries) {
+            const definition = yield importDefault(ctx, path, [
+                slot.kind,
+                slot.disabledKind,
+                "disabled",
+            ]);
+            if (definition === undefined) {
+                continue;
+            }
+            const kind = getDefinitionKind(definition);
+            if (kind === slot.disabledKind || kind === "disabled") {
+                contributed.delete(name);
+                if (!slot.declared.has(name)) {
+                    unknownContribution(ctx, path, slot.disableHelper, name, site.ns);
+                }
+                continue;
+            }
+            const item = yield slot.compile(ctx, path, name, definition);
+            if (item !== undefined) {
+                contributed.set(name, item);
+            }
+        }
+    });
+}
+export function overlaySkills(ctx, site, contributed, dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield overlayNamed(ctx, site, contributed, dir, "disableSkill", (onDisable) => loadSkills(ctx, dir, onDisable));
+    });
+}
+export function overlayHooks(ctx, site, contributed, dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield overlayNamed(ctx, site, contributed, dir, "disableHook", (onDisable) => loadHooks(ctx, dir, onDisable));
+    });
+}
+export function overlaySchedules(ctx, site, contributed, dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield overlayNamed(ctx, site, contributed, dir, "disableSchedule", (onDisable) => loadSchedules(ctx, dir, onDisable));
+    });
+}
+export function overlayChannels(ctx, site, contributed, dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(yield isDirectory(dir))) {
+            return;
+        }
+        const declared = new Set(contributed.keys());
+        const { channels } = yield loadChannels(ctx, dir, "extension", (id, path) => {
+            contributed.delete(id);
+            if (!declared.has(id)) {
+                unknownContribution(ctx, path, "disableChannel", id, site.ns);
+            }
+        });
+        for (const channel of channels) {
+            contributed.set(channel.id, channel);
+        }
+    });
+}
+export function overlaySubagents(ctx, site, contributed, dir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(yield isDirectory(dir))) {
+            return;
+        }
+        const declared = new Set(contributed.keys());
+        for (const child of yield loadSubagents(ctx, dir)) {
+            contributed.set(child.name, child);
+        }
+        for (const entry of yield sortedEntries(dir)) {
+            const path = join(dir, entry.name);
+            if (!entry.isFile() || !isModuleFile(entry.name)) {
+                continue;
+            }
+            const name = moduleStem(entry.name);
+            const definition = yield importDefault(ctx, path, ["disabled"]);
+            if (definition === undefined) {
+                continue;
+            }
+            contributed.delete(name);
+            if (!declared.has(name)) {
+                unknownContribution(ctx, path, "disableSubagent", name, site.ns);
+            }
+        }
+    });
+}
+export function overlayInstructionsFragment(ctx, overlayDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const markdownPath = join(overlayDir, "instructions.md");
+        const modulePath = yield findModuleFile(overlayDir, "instructions");
+        const instructionsDir = join(overlayDir, "instructions");
+        if (!(yield isFile(markdownPath)) &&
+            modulePath === undefined &&
+            !(yield isDirectory(instructionsDir))) {
+            return "keep";
+        }
+        if (modulePath !== undefined) {
+            let mod;
+            try {
+                mod = yield ctx.importModule(modulePath);
+            }
+            catch (error) {
+                ctx.diagnostics.push({
+                    severity: "error",
+                    path: displayPath(ctx, modulePath),
+                    message: `Failed to load module: ${errorMessage(error)}`,
+                });
+                return "keep";
+            }
+            if (getDefinitionKind(mod.default) === "disabled") {
+                return undefined;
+            }
+        }
+        return loadInstructions(ctx, overlayDir, undefined, false);
+    });
+}
+export function overlayAbs(ctx, site, contributed, overlayDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const loaded = yield loadABs(ctx, overlayDir, (source, path) => {
+            if (!contributed.delete(source)) {
+                unknownContribution(ctx, path, "disableAB", source, site.ns);
+            }
+        });
+        for (const experiment of loaded) {
+            contributed.set((_a = experiment.source) !== null && _a !== void 0 ? _a : experiment.name, experiment);
+        }
+    });
+}
+export function overlayArtifacts(ctx, overlayDir, current) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const path = yield findModuleFile(overlayDir, "artifacts");
+        if (path === undefined) {
+            return current;
+        }
+        const definition = yield importDefault(ctx, path, ["artifacts", "disabled"]);
+        if (definition === undefined) {
+            return current;
+        }
+        if (getDefinitionKind(definition) === "disabled") {
+            return undefined;
+        }
+        return definition;
+    });
+}
+function overlayNamed(ctx, site, contributed, dir, helper, load) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!(yield isDirectory(dir))) {
+            return;
+        }
+        const declared = new Set(contributed.keys());
+        for (const item of yield load((name, path) => {
+            contributed.delete(name);
+            if (!declared.has(name)) {
+                unknownContribution(ctx, path, helper, name, site.ns);
+            }
+        })) {
+            contributed.set(item.name, item);
+        }
+    });
+}
+function unknownContribution(ctx, path, helper, name, ns) {
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, path),
+        message: `${helper}() targets "${name}", which extension "${ns}" does not contribute.`,
+    });
+}

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

@@ -1,14 +1,23 @@
 /**
- * `agent/extensions/<ns>.ts` | `agent/extensions/<ns>/extension.ts`: agent-shaped trees and Cursor plugins mounted under a namespace.
+ * `agent/extensions/<ns>.ts` | `agent/extensions/<ns>/extension.ts`:
+ * agent-shaped trees and Cursor plugins mounted under a namespace.
  */
-import type { DiscoveredConnection, DiscoveredExtension, DiscoveredSkill, DiscoveredTool, ResolvedAgent } from "../../types.js";
+import type { ArtifactsDefinition, DiscoveredAB, DiscoveredChannel, DiscoveredConnection, DiscoveredExtension, DiscoveredHook, DiscoveredSchedule, DiscoveredSkill, DiscoveredTool, ResolvedAgent, SeedFile } from "../../types.js";
 import { type DiscoveryContext } from "./context.js";
 /** The agent's authored slot lists that mounted extensions append to. */
 export interface ExtensionContributions {
     tools: DiscoveredTool[];
     skills: DiscoveredSkill[];
     connections: DiscoveredConnection[];
+    hostConnections: DiscoveredConnection[];
     subagents: ResolvedAgent[];
+    hooks: DiscoveredHook[];
+    channels: DiscoveredChannel[];
+    schedules: DiscoveredSchedule[];
+    instructionParts: string[];
+    seedFiles: SeedFile[];
+    abs: DiscoveredAB[];
+    artifacts: ArtifactsDefinition | undefined;
 }
 /**
  * Mount every extension under `agent/extensions/` and append what it

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

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extensions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,cAAc,EAEd,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAgBlE,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA4BhC"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,mBAAmB,EAEnB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EAEd,aAAa,EACb,QAAQ,EAET,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAgClE,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,SAAS,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA4BhC"}