@jianxx/dsh-cc-plugin-loader 0.1.0

package/lib/commands.js

@@ -0,0 +1,66 @@
+/**
+ * Mount a Claude Code plugin's slash commands.
+ *
+ * Translates manifest `commands` entries (inline content or a source file) into
+ * typed command definitions registered on the commands seam. Each handler
+ * returns the command's rendered content, so invoking `/name` surfaces the
+ * plugin author's instructions. Registration is effect-scoped.
+ *
+ * @module
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { ComponentTally } from "./seams.js";
+/** Commands live under this directory in a plugin root, when present. */
+export const STANDARD_COMMANDS_DIR = 'commands';
+/**
+ * Register a plugin's manifest commands.
+ * @param options - plugin root, manifest, and the commands seam.
+ * @returns mounted disposers and per-component counts.
+ */
+export function mountCommands(options) {
+    const tally = new ComponentTally('commands');
+    const disposers = [];
+    if (options.commands === undefined) {
+        tally.addSkipped('commands seam "commands" is not mounted');
+        return { disposers, tally };
+    }
+    const entries = options.manifest.commands;
+    if (entries.length === 0) {
+        tally.addSkipped('plugin ships no commands');
+        return { disposers, tally };
+    }
+    for (const entry of entries) {
+        const rendered = renderCommand(options.pluginRoot, entry);
+        if (rendered.error !== undefined) {
+            tally.addFailed(`command "${entry.name}": ${rendered.error}`);
+            continue;
+        }
+        disposers.push(options.commands.register({
+            name: entry.name,
+            description: entry.description ?? '',
+            handler: () => rendered.content === undefined
+                ? { kind: 'success' }
+                : { kind: 'success', text: rendered.content },
+        }));
+        tally.addLoaded();
+    }
+    return { disposers, tally };
+}
+/** Resolve a command entry to consumable content, or a failure reason. */
+function renderCommand(pluginRoot, entry) {
+    if (entry.content !== undefined) {
+        return { content: entry.content };
+    }
+    if (entry.source !== undefined) {
+        const path = resolve(pluginRoot, entry.source);
+        try {
+            return { content: readFileSync(path, 'utf8') };
+        }
+        catch (error) {
+            return { error: `could not read command file "${entry.source}": ${String(error)}` };
+        }
+    }
+    return { error: 'has neither "content" nor a readable "source"' };
+}
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.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;AAyB3C,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAA;AAY/C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,SAAS,GAAmB,EAAE,CAAA;IACpC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,UAAU,CAAC,yCAAyC,CAAC,CAAA;QAC3D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7B,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAA;IACzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAA;QAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7B,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QACzD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,IAAI,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;YAC7D,SAAQ;QACV,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;YACpC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;gBAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE;SAChD,CAAC,CAAC,CAAA;QACH,KAAK,CAAC,SAAS,EAAE,CAAA;IACnB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC;AAED,0EAA0E;AAC1E,SAAS,aAAa,CAAC,UAAkB,EAAE,KAAgB;IACzD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAC9C,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAA;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,KAAK,EAAE,gCAAgC,KAAK,CAAC,MAAM,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAA;QACrF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAA;AACnE,CAAC"}

package/lib/hooks.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 type { CcPluginManifest } from './types.ts';
+import { ComponentTally } from './seams.ts';
+/** The hooks seam: accepts a plugin's translated per-event hooks. */
+export interface HooksSeam {
+    /**
+     * Merge a plugin's hooks into the bridge.
+     * @param pluginName - the plugin that owns the hooks.
+     * @param config - the per-event hook map (`ClaudeCodeHookConfig` shape).
+     * @returns the exact disposer that removes the injected hooks.
+     */
+    mergePluginHooks(pluginName: string, config: unknown): () => void;
+}
+/** Hooks live under this file in a plugin root, when present. */
+export declare const STANDARD_HOOKS_FILE = "hooks/hooks.json";
+/** Options for mounting one plugin's hooks. */
+export interface MountHooksOptions {
+    /** The plugin root directory; the standard hooks file resolves against it. */
+    readonly pluginRoot: string;
+    /** The parsed manifest; `hooks` supplies an inline or file reference. */
+    readonly manifest: CcPluginManifest;
+    /** The hooks seam (probed; `undefined` to skip hooks). */
+    readonly hooks: HooksSeam | undefined;
+}
+/**
+ * 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 declare function mountHooks(options: MountHooksOptions): {
+    disposers: (() => void)[];
+    tally: ComponentTally;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/lib/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CAAA;CAClE;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,qBAAqB,CAAA;AAErD,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;CACtC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAmB3G"}

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,73 @@
+/**
+ * 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 @jianxx/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';
+export type { CcPluginManifest, CcCommand, CcSkillRef, CcAgentRef, CcMcpServer, ComponentKind, ComponentResult, PluginLoadReport } from './types.ts';
+export { parsePluginManifest } from './manifest.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. */
+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;
+    /** 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;
+    /**
+     * 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":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAMhF,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACpJ,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,EACrB,QAAQ,EACR,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAA;AAE7B,kDAAkD;AAClD,eAAO,MAAM,aAAa,gBAAgB,CAAA;AAE1C,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IAC/B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACrC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACnC,qBAAqB;IACrB,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACnC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC7B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC1B;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CACrC;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,MAAM,EAAE,gBAAgB,CAAA;IACxB;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmCvG"}

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 @jianxx/dsh-cc-plugin-loader
+ */
+import { readFile } from 'node:fs/promises';
+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";
+export { parsePluginManifest } from "./manifest.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. */
+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 raw = await readManifest(root);
+    const manifest = parsePluginManifest(raw, root);
+    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 } : {},
+    }));
+    fold(components, disposers, mountCommands({ pluginRoot: root, manifest, commands: probed.commands }));
+    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 },
+        dispose: () => effectDisposer(),
+    };
+}
+/** Read and JSON-parse the plugin manifest file. */
+async function readManifest(root) {
+    const path = resolve(root, MANIFEST_FILE);
+    const raw = await readFile(path, 'utf8');
+    return JSON.parse(raw);
+}
+/** 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,23 @@
+/**
+ * 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';
+/**
+ * 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.
+ * @returns the normalized manifest subset.
+ * @throws when the manifest is structurally invalid.
+ */
+export declare function parsePluginManifest(raw: unknown, source: string): 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;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAuBlF"}

package/lib/manifest.js

@@ -0,0 +1,117 @@
+/**
+ * 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.
+ * @returns the normalized manifest subset.
+ * @throws when the manifest is structurally invalid.
+ */
+export function parsePluginManifest(raw, source) {
+    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,
+        agents,
+        skills,
+        ...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"}