@dsh-cc/plugin-loader 0.5.0

package/lib/hooks.js

@@ -0,0 +1,89 @@
+/**
+ * Mount a Claude Code plugin's hooks.
+ *
+ * Reads the plugin's `hooks/hooks.json` (or an inline manifest `hooks`
+ * declaration), validates the structure, and injects the hooks into the
+ * hooks-claude-code bridge through the optional `hooks` guest seam. When the
+ * seam is absent the component is reported skipped, never failed, so a
+ * deployment without the bridge keeps loading the rest of the plugin.
+ *
+ * @module
+ */
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { ComponentTally } from "./seams.js";
+/** Hooks live under this file in a plugin root, when present. */
+export const STANDARD_HOOKS_FILE = 'hooks/hooks.json';
+/**
+ * Read and inject a plugin's hooks through the optional seam.
+ * @param options - plugin root, manifest, and the hooks seam.
+ * @returns mounted disposers and per-component counts.
+ */
+export function mountHooks(options) {
+    const tally = new ComponentTally('hooks');
+    const disposers = [];
+    if (options.hooks === undefined) {
+        tally.addSkipped('hooks seam "hooks" is not mounted');
+        return { disposers, tally };
+    }
+    const hooks = resolveHooks(options.pluginRoot, options.manifest);
+    if (hooks.error !== undefined) {
+        tally.addFailed(hooks.error);
+        return { disposers, tally };
+    }
+    if (hooks.value === undefined) {
+        tally.addSkipped('plugin declares no hooks');
+        return { disposers, tally };
+    }
+    disposers.push(options.hooks.mergePluginHooks(options.manifest.name, hooks.value));
+    tally.addLoaded();
+    return { disposers, tally };
+}
+/** Resolve the plugin's hooks map, or a failure reason. */
+function resolveHooks(pluginRoot, manifest) {
+    const inline = manifest.hooks;
+    if (typeof inline === 'string') {
+        return readHooksFile(resolve(pluginRoot, inline), `manifest hooks path "${inline}"`);
+    }
+    if (inline !== undefined) {
+        if (!isRecord(inline)) {
+            return { error: 'manifest "hooks" must be an object or a hooks file path' };
+        }
+        const fromInline = inline['hooks'] !== undefined ? inline['hooks'] : inline;
+        return validateHooks(fromInline);
+    }
+    return readHooksFile(join(pluginRoot, STANDARD_HOOKS_FILE), 'hooks/hooks.json');
+}
+/** Read and validate a hooks JSON file (absent file means no hooks). */
+function readHooksFile(path, label) {
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch {
+        return { value: undefined }; // absent standard hooks file is valid empty state
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { error: `could not parse ${label}` };
+    }
+    return validateHooks(parsed);
+}
+/** Validate a hooks value into a per-event map. */
+function validateHooks(value) {
+    if (!isRecord(value)) {
+        return { error: 'hooks must be an object keyed by event name' };
+    }
+    const hooks = (value['hooks'] !== undefined ? value['hooks'] : value);
+    if (!isRecord(hooks)) {
+        return { error: 'hooks "hooks" field must be an object keyed by event name' };
+    }
+    return { value: hooks };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/hooks.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A Claude Code `plugin.json` compatibility loader: reads a CC plugin manifest
+ * and mounts each component as an in-memory dsh plugin.
+ *
+ * The loader is peer-style: it parses the manifest subset, translates each
+ * component with the pure helpers from `dsh-skill-claude-code` and
+ * `dsh-claude-code-agents`, then consults the host seam for that component via
+ * `ctx.get(...)`. A component whose seam is absent is reported skipped (never a
+ * whole-load failure), matching "misconfiguration fails loud" for the manifest
+ * itself but graceful degradation for missing host seams. Every component
+ * mount is a Cordis effect, so disabling the plugin recalls all of it.
+ *
+ * @module @dsh-cc/plugin-loader
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { HooksSeam } from './hooks.ts';
+import type { McpSeam } from './mcp.ts';
+import type { CommandsSeam } from './commands.ts';
+import type { SettingsSeam } from './settings.ts';
+import type { PluginLoadReport } from './types.ts';
+import { type SkillsSeam } from './skills.ts';
+import { type ResolveModel, type SubagentsSeam } from './agents.ts';
+import { type MountedPluginCommand } from './commands.ts';
+export type { CcPluginManifest, CcCommand, CcSkillRef, CcAgentRef, CcMcpServer, ComponentKind, ComponentResult, PluginLoadReport } from './types.ts';
+export type { CcPluginCommandInfo, MountedPluginCommand } from './commands.ts';
+export { parsePluginManifest } from './manifest.ts';
+export { discoverCcPluginRoots, resolveClaudeHome, NESTED_MANIFEST, TOP_LEVEL_MANIFEST } from './discovery.ts';
+export type { DiscoveredCcPlugin, DiscoverCcPluginRootsOptions } from './discovery.ts';
+export { AgentProvider, STANDARD_AGENTS_DIR } from './agents.ts';
+export type { ResolveModel } from './agents.ts';
+export type { McpSeam, HooksSeam } from './seams.ts';
+export { skillToolRestriction, resolveSkillExecution, forbidsInlineShell, activationFor, registerSkillPathActivator, applySkillRestriction, PROVIDER, type AgentScope, type SkillExecution, type SkillActivation, } from './skill-semantics.ts';
+/** The plugin.json file name at a plugin root (legacy / fixture path). */
+export declare const MANIFEST_FILE = "plugin.json";
+/** The component host seams the loader probes. */
+export interface MountedSeams {
+    /** Skill registry seam. */
+    skills?: SkillsSeam | undefined;
+    /** Subagent registry seam. */
+    subagents?: SubagentsSeam | undefined;
+    /** Command registry seam. */
+    commands?: CommandsSeam | undefined;
+    /** Settings seam. */
+    settings?: SettingsSeam | undefined;
+    /** Hooks bridge seam (guest; absent in the harness today). */
+    hooks?: HooksSeam | undefined;
+    /** MCP server seam (guest; absent in the harness today). */
+    mcp?: McpSeam | undefined;
+}
+/** Options for mounting one Claude Code plugin. */
+export interface MountCcPluginOptions {
+    /** The plugin root directory holding `plugin.json` and its components. */
+    readonly root: string;
+    /** Installed plugin name (no `@marketplace`); matches a marketplace overlay. */
+    readonly nameHint?: string;
+    /** Optional seam overrides; when omitted the loader probes `ctx.get(...)`. */
+    readonly seams?: MountedSeams;
+    /** Optional spawn-time model resolver threaded into every mounted agent. */
+    readonly resolveModel?: ResolveModel;
+}
+/** The structural report plus a disposer that recalls every mounted component. */
+export interface CcPluginMount {
+    /** The structural load report. */
+    report: PluginLoadReport;
+    /** The plugin's mounted slash commands (colon display names, host-served). */
+    commands: MountedPluginCommand[];
+    /**
+     * Recall every mounted component. Effect-scoped: calling it also releases
+     * the Cordis effect, and a context teardown calls it automatically.
+     */
+    dispose(): void;
+}
+/**
+ * Load a Claude Code plugin manifest and mount its components.
+ * @param ctx - active context carrying the component host seams.
+ * @param options - plugin root and optional seam overrides.
+ * @returns the structural report and a disposer that recalls every mount.
+ * @throws when the manifest itself is invalid (with the plugin path/name).
+ */
+export declare function mountCcPlugin(ctx: Context, options: MountCcPluginOptions): Promise<CcPluginMount>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -0,0 +1,92 @@
+/**
+ * A Claude Code `plugin.json` compatibility loader: reads a CC plugin manifest
+ * and mounts each component as an in-memory dsh plugin.
+ *
+ * The loader is peer-style: it parses the manifest subset, translates each
+ * component with the pure helpers from `dsh-skill-claude-code` and
+ * `dsh-claude-code-agents`, then consults the host seam for that component via
+ * `ctx.get(...)`. A component whose seam is absent is reported skipped (never a
+ * whole-load failure), matching "misconfiguration fails loud" for the manifest
+ * itself but graceful degradation for missing host seams. Every component
+ * mount is a Cordis effect, so disabling the plugin recalls all of it.
+ *
+ * @module @dsh-cc/plugin-loader
+ */
+import { resolve } from 'node:path';
+import { parsePluginManifest } from "./manifest.js";
+import { mountSkills } from "./skills.js";
+import { mountAgents } from "./agents.js";
+import { mountCommands } from "./commands.js";
+import { mountHooks } from "./hooks.js";
+import { mountMcpServers } from "./mcp.js";
+import { mountSettings } from "./settings.js";
+import { resolvePluginManifest } from "./resolve-manifest.js";
+export { parsePluginManifest } from "./manifest.js";
+export { discoverCcPluginRoots, resolveClaudeHome, NESTED_MANIFEST, TOP_LEVEL_MANIFEST } from "./discovery.js";
+export { AgentProvider, STANDARD_AGENTS_DIR } from "./agents.js";
+export { skillToolRestriction, resolveSkillExecution, forbidsInlineShell, activationFor, registerSkillPathActivator, applySkillRestriction, PROVIDER, } from "./skill-semantics.js";
+/** The plugin.json file name at a plugin root (legacy / fixture path). */
+export const MANIFEST_FILE = 'plugin.json';
+/**
+ * Load a Claude Code plugin manifest and mount its components.
+ * @param ctx - active context carrying the component host seams.
+ * @param options - plugin root and optional seam overrides.
+ * @returns the structural report and a disposer that recalls every mount.
+ * @throws when the manifest itself is invalid (with the plugin path/name).
+ */
+export async function mountCcPlugin(ctx, options) {
+    const root = resolve(options.root);
+    const resolved = resolvePluginManifest(root, options.nameHint);
+    const manifest = parsePluginManifest(resolved.raw, root, {
+        skillsReplaceDefault: resolved.skillsReplaceDefault,
+    });
+    const probed = await probeSeams(ctx, options.seams);
+    const disposers = [];
+    const components = [];
+    fold(components, disposers, await mountSkills({
+        ctx,
+        pluginRoot: root,
+        manifest,
+        skills: probed.skills,
+        subagentsPresent: probed.subagents !== undefined,
+    }));
+    fold(components, disposers, await mountAgents({
+        pluginRoot: root,
+        manifest,
+        subagents: probed.subagents,
+        ...options.resolveModel !== undefined ? { resolveModel: options.resolveModel } : {},
+    }));
+    const commandMount = mountCommands({ pluginRoot: root, manifest, commands: probed.commands });
+    components.push(commandMount.tally.result());
+    disposers.push(...commandMount.disposers);
+    fold(components, disposers, mountHooks({ pluginRoot: root, manifest, hooks: probed.hooks }));
+    fold(components, disposers, mountMcpServers({ pluginRoot: root, manifest, mcp: probed.mcp }));
+    fold(components, disposers, mountSettings({ manifest, settings: probed.settings }));
+    const tearDown = () => {
+        for (const dispose of disposers)
+            dispose();
+    };
+    const effectDisposer = ctx.effect(() => tearDown, 'cc-plugin-loader.mount');
+    return {
+        report: { name: manifest.name, components },
+        commands: commandMount.mounted,
+        dispose: () => effectDisposer(),
+    };
+}
+/** Probe each component host seam, preferring explicit overrides. */
+async function probeSeams(ctx, overrides) {
+    return {
+        skills: overrides?.skills ?? ctx.get('skills'),
+        subagents: overrides?.subagents ?? ctx.get('subagents'),
+        commands: overrides?.commands ?? ctx.get('commands'),
+        settings: overrides?.settings ?? ctx.get('settings'),
+        hooks: overrides?.hooks ?? ctx.get('hooks'),
+        mcp: overrides?.mcp ?? ctx.get('mcp'),
+    };
+}
+/** Fold one component mount into the report and disposer list. */
+function fold(components, disposers, mount) {
+    components.push(mount.tally.result());
+    disposers.push(...mount.disposers);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/manifest.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Parse the Claude Code `plugin.json` manifest subset this loader consumes.
+ *
+ * Validation happens on the raw manifest object at load time: a malformed
+ * manifest (wrong types, a blank or space-containing plugin name, an unreadable
+ * file) throws with the plugin name so the failure is actionable. Component
+ * fields accept the union shapes Claude Code allows (single path, array, or
+ * object map for commands) and are normalized to the loader's typed view.
+ * Unknown top-level fields are ignored, matching Claude Code's tolerant
+ * top-level handling.
+ *
+ * @module
+ */
+import type { CcPluginManifest } from './types.ts';
+/** Extra flags the resolver threads in (not authored in plugin.json). */
+export interface ParsePluginManifestOptions {
+    /** Marketplace-root overlay: listed `skills` replace the default `skills/` scan. */
+    readonly skillsReplaceDefault?: boolean;
+}
+/**
+ * Validate a raw `plugin.json` object into the loader's typed manifest subset.
+ * @param raw - the parsed JSON contents of `plugin.json`.
+ * @param source - the plugin name or path used to prefix validation errors.
+ * @param options - resolver flags that are not authored in the JSON.
+ * @returns the normalized manifest subset.
+ * @throws when the manifest is structurally invalid.
+ */
+export declare function parsePluginManifest(raw: unknown, source: string, options?: ParsePluginManifestOptions): CcPluginManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/lib/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAA;AAE1E,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CACxC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,0BAA+B,GACvC,gBAAgB,CAyBlB"}

package/lib/manifest.js

@@ -0,0 +1,120 @@
+/**
+ * Parse the Claude Code `plugin.json` manifest subset this loader consumes.
+ *
+ * Validation happens on the raw manifest object at load time: a malformed
+ * manifest (wrong types, a blank or space-containing plugin name, an unreadable
+ * file) throws with the plugin name so the failure is actionable. Component
+ * fields accept the union shapes Claude Code allows (single path, array, or
+ * object map for commands) and are normalized to the loader's typed view.
+ * Unknown top-level fields are ignored, matching Claude Code's tolerant
+ * top-level handling.
+ *
+ * @module
+ */
+/**
+ * Validate a raw `plugin.json` object into the loader's typed manifest subset.
+ * @param raw - the parsed JSON contents of `plugin.json`.
+ * @param source - the plugin name or path used to prefix validation errors.
+ * @param options - resolver flags that are not authored in the JSON.
+ * @returns the normalized manifest subset.
+ * @throws when the manifest is structurally invalid.
+ */
+export function parsePluginManifest(raw, source, options = {}) {
+    if (!isRecord(raw)) {
+        throw new Error(`plugin ${source}: manifest must be a JSON object`);
+    }
+    const name = readName(raw['name'], source);
+    const commands = normalizeCommands(raw['commands'], name);
+    const agents = normalizeStringList(raw['agents'], name, 'agents');
+    const skills = normalizeStringList(raw['skills'], name, 'skills');
+    const { mcpServers, mcpServersPath } = normalizeMcpServers(raw['mcpServers'], name);
+    const settings = isRecord(raw['settings']) ? raw['settings'] : {};
+    return {
+        name,
+        ...typeof raw['version'] === 'string' ? { version: raw['version'] } : {},
+        ...typeof raw['description'] === 'string' ? { description: raw['description'] } : {},
+        ...raw['author'] !== undefined ? { author: raw['author'] } : {},
+        commands,
+        commandsDeclared: raw['commands'] !== undefined,
+        agents,
+        skills,
+        skillsReplaceDefault: options.skillsReplaceDefault === true,
+        ...raw['hooks'] !== undefined ? { hooks: raw['hooks'] } : {},
+        mcpServers,
+        ...mcpServersPath !== undefined ? { mcpServersPath } : {},
+        settings,
+    };
+}
+/** Require and validate the mandatory plugin `name`. */
+function readName(raw, source) {
+    if (typeof raw !== 'string' || raw.length === 0) {
+        throw new Error(`plugin ${source}: "name" must be a non-empty string`);
+    }
+    if (raw.includes(' ')) {
+        throw new Error(`plugin ${raw}: "name" cannot contain spaces; use kebab-case`);
+    }
+    return raw;
+}
+function normalizeCommands(raw, name) {
+    if (raw === undefined)
+        return [];
+    if (typeof raw === 'string')
+        return [{ name, source: raw }];
+    if (isStringArray(raw))
+        return raw.map(path => ({ name, source: path }));
+    if (isRecord(raw)) {
+        return Object.entries(raw).map(([commandName, meta]) => {
+            if (!isRecord(meta))
+                throw new Error(`plugin ${name}: command "${commandName}" must be an object`);
+            const entry = commandEntry(meta, name, commandName);
+            return { name: commandName, ...entry };
+        });
+    }
+    throw new Error(`plugin ${name}: "commands" must be a path, a list, or an object map`);
+}
+/** Validate one inline command metadata record; `source` and `content` are exclusive. */
+function commandEntry(meta, name, commandName) {
+    const hasSource = typeof meta['source'] === 'string';
+    const hasContent = typeof meta['content'] === 'string';
+    if (hasSource === hasContent) {
+        throw new Error(`plugin ${name}: command "${commandName}" must provide exactly one of "source" (path) or "content" (inline)`);
+    }
+    const entry = {};
+    if (hasSource)
+        entry.source = meta['source'];
+    if (hasContent)
+        entry.content = meta['content'];
+    for (const key of ['description', 'argumentHint', 'model']) {
+        if (typeof meta[key] === 'string')
+            entry[key] = meta[key];
+    }
+    if (Array.isArray(meta['allowedTools'])) {
+        entry.allowedTools = meta['allowedTools'];
+    }
+    return entry;
+}
+function normalizeStringList(raw, name, field) {
+    if (raw === undefined)
+        return [];
+    if (typeof raw === 'string')
+        return [raw];
+    if (isStringArray(raw))
+        return [...raw];
+    throw new Error(`plugin ${name}: "${field}" must be a path or a list of paths`);
+}
+function normalizeMcpServers(raw, name) {
+    if (raw === undefined)
+        return { mcpServers: {} };
+    if (typeof raw === 'string')
+        return { mcpServers: {}, mcpServersPath: raw }; // an `.mcp.json` path
+    if (isRecord(raw))
+        return { mcpServers: raw };
+    throw new Error(`plugin ${name}: "mcpServers" must be a path or an object map of server configs`);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(item => typeof item === 'string');
+}
+//# sourceMappingURL=manifest.js.map

package/lib/manifest.js.map

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

package/lib/mcp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Mount a Claude Code plugin's MCP servers.
+ *
+ * Collects server definitions from the manifest inline `mcpServers` record or
+ * an `.mcp.json` file, then registers each through the optional `mcp` guest
+ * seam. Tool naming (`mcp__<server>__<tool>`) is the seam's responsibility.
+ * When the seam is absent the component is reported skipped, never failed.
+ *
+ * @module
+ */
+import type { CcPluginManifest } from './types.ts';
+import { ComponentTally } from './seams.ts';
+/** The MCP seam: registers a named server for tool discovery. */
+export interface McpSeam {
+    /**
+     * Register one MCP server.
+     * @param name - unique server name.
+     * @param config - server transport configuration.
+     * @returns the exact disposer that unregisters the server.
+     */
+    registerServer(name: string, config: Record<string, unknown>): () => void;
+}
+/** Options for mounting one plugin's MCP servers. */
+export interface MountMcpServersOptions {
+    /** The plugin root directory; an `.mcp.json` path resolves against it. */
+    readonly pluginRoot: string;
+    /** The parsed manifest; `mcpServers` and `mcpServersPath` drive the mount. */
+    readonly manifest: CcPluginManifest;
+    /** The mcp seam (probed; `undefined` to skip mcpServers). */
+    readonly mcp: McpSeam | undefined;
+}
+/**
+ * Collect and register a plugin's MCP servers through the optional seam.
+ * @param options - plugin root, manifest, and the mcp seam.
+ * @returns mounted disposers and per-component counts.
+ */
+export declare function mountMcpServers(options: MountMcpServersOptions): {
+    disposers: (() => void)[];
+    tally: ComponentTally;
+};
+//# sourceMappingURL=mcp.d.ts.map

package/lib/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,iEAAiE;AACjE,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI,CAAA;CAC1E;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAAA;CAClC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAAE,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAkBrH"}

package/lib/mcp.js

@@ -0,0 +1,64 @@
+/**
+ * Mount a Claude Code plugin's MCP servers.
+ *
+ * Collects server definitions from the manifest inline `mcpServers` record or
+ * an `.mcp.json` file, then registers each through the optional `mcp` guest
+ * seam. Tool naming (`mcp__<server>__<tool>`) is the seam's responsibility.
+ * When the seam is absent the component is reported skipped, never failed.
+ *
+ * @module
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { ComponentTally } from "./seams.js";
+/**
+ * Collect and register a plugin's MCP servers through the optional seam.
+ * @param options - plugin root, manifest, and the mcp seam.
+ * @returns mounted disposers and per-component counts.
+ */
+export function mountMcpServers(options) {
+    const tally = new ComponentTally('mcpServers');
+    const disposers = [];
+    if (options.mcp === undefined) {
+        tally.addSkipped('mcp seam "mcp" is not mounted');
+        return { disposers, tally };
+    }
+    const servers = collectServers(options.pluginRoot, options.manifest);
+    const entries = Object.entries(servers);
+    if (entries.length === 0) {
+        tally.addSkipped('plugin declares no MCP servers');
+        return { disposers, tally };
+    }
+    for (const [name, config] of entries) {
+        disposers.push(options.mcp.registerServer(name, config));
+        tally.addLoaded();
+    }
+    return { disposers, tally };
+}
+/** Combine inline and file-backed MCP server definitions. */
+function collectServers(pluginRoot, manifest) {
+    const servers = {};
+    if (manifest.mcpServersPath !== undefined) {
+        const path = resolve(pluginRoot, manifest.mcpServersPath);
+        Object.assign(servers, readMcpJson(path));
+    }
+    for (const [name, config] of Object.entries(manifest.mcpServers)) {
+        servers[name] = config;
+    }
+    return servers;
+}
+/** Read an `.mcp.json` file's `mcpServers` key (absent/invalid yields none). */
+function readMcpJson(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        const servers = parsed['mcpServers'];
+        if (typeof servers === 'object' && servers !== null && !Array.isArray(servers)) {
+            return servers;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/lib/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAuB3C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,YAAY,CAAC,CAAA;IAC9C,MAAM,SAAS,GAAmB,EAAE,CAAA;IACpC,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAA;QACjD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7B,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,UAAU,CAAC,gCAAgC,CAAC,CAAA;QAClD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7B,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACrC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QACxD,KAAK,CAAC,SAAS,EAAE,CAAA;IACnB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC;AAED,6DAA6D;AAC7D,SAAS,cAAc,CAAC,UAAkB,EAAE,QAA0B;IACpE,MAAM,OAAO,GAA4C,EAAE,CAAA;IAC3D,IAAI,QAAQ,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;QACzD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3C,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAiC,CAAA;IACnD,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA4B,CAAA;QAChF,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;QACpC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/E,OAAO,OAAkD,CAAA;QAC3D,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/lib/resolve-manifest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Resolve the raw JSON a plugin root should load as its manifest.
+ *
+ * Preference: `.claude-plugin/plugin.json`, then top-level `plugin.json`, then
+ * a matching `marketplace.json` overlay (requires `nameHint`), then a
+ * synthesized `{ name }` so a truly optional manifest still mounts default
+ * component dirs. A marketplace file with no matching entry is a hard miss —
+ * never fall through to synthesis (that would load the whole skills repo).
+ *
+ * @module
+ */
+/** Resolved raw manifest plus the marketplace replace-default flag. */
+export interface ResolvedPluginManifest {
+    /** JSON object to feed `parsePluginManifest`. */
+    readonly raw: unknown;
+    /** When true, listed `skills` replace the default `skills/` scan. */
+    readonly skillsReplaceDefault: boolean;
+}
+/**
+ * Locate and return the raw manifest for one plugin root.
+ * @param root - plugin root directory.
+ * @param nameHint - installed plugin name (no `@marketplace`), for overlays.
+ * @returns the raw JSON and whether skills should replace the default dir.
+ * @throws when a present file is unreadable/invalid, or a marketplace overlay misses `nameHint`.
+ */
+export declare function resolvePluginManifest(root: string, nameHint?: string): ResolvedPluginManifest;
+//# sourceMappingURL=resolve-manifest.d.ts.map

package/lib/resolve-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-manifest.d.ts","sourceRoot":"","sources":["../src/resolve-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,qEAAqE;IACrE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAA;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAS7F"}