@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.0

package/dist/tool-surface/skill-installers/claude-code.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Options for installing a Claude Code skill.
+ */
+export interface ClaudeCodeInstallOpts {
+    /** Human-readable name of the skill (used in file path). */
+    skillName: string;
+    /**
+     * Raw skill content. May contain `@include _shared/<file>.md` directives
+     * which are inlined before writing.
+     */
+    content: string;
+    /**
+     * Home directory — replaces `os.homedir()` in all file operations.
+     * Must NOT default to `os.homedir()`.
+     */
+    homeDir: string;
+    /** Root of the skills directory for @include resolution. */
+    skillsRoot: string;
+}
+/**
+ * Write (or overwrite) the SKILL.md file for a Claude Code skill.
+ *
+ * Target path: `<homeDir>/.claude/skills/<skillName>/SKILL.md`
+ *
+ * @param opts  Installation options (see `ClaudeCodeInstallOpts`).
+ */
+export declare function installClaudeCode(opts: ClaudeCodeInstallOpts): void;
+/**
+ * Uninstall a Claude Code skill by removing its directory.
+ *
+ * Target: `<homeDir>/.claude/skills/<skillName>/`
+ *
+ * Security: `skillName` is validated against the expected skills directory
+ * boundary to prevent path traversal (e.g. `../other-dir`). If `skillName`
+ * resolves outside the skills directory, the function is a no-op.
+ *
+ * This is also a no-op when the directory does not exist (no error is thrown).
+ *
+ * @param skillName  Name of the skill to uninstall.
+ * @param homeDir    Home directory where the skill directory lives.
+ */
+export declare function uninstallClaudeCode(skillName: string, homeDir: string): void;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/tool-surface/skill-installers/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/tool-surface/skill-installers/claude-code.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAUnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAe5E"}

package/dist/tool-surface/skill-installers/claude-code.js

@@ -0,0 +1,65 @@
+/**
+ * Claude Code skill writer for install-skill.
+ *
+ * Writes each skill's SKILL.md to `<homeDir>/.claude/skills/<skillName>/SKILL.md`.
+ *
+ * Before writing, inlines any `@include _shared/<file>.md` directives found in
+ * the content. The directive line is replaced with the full content of the
+ * corresponding shared file sourced from `<skillsRoot>/_shared/<file>.md`.
+ * The `@include` directive is NOT preserved in the written file.
+ *
+ * If a referenced shared file is missing (ENOENT):
+ * - A warning is logged to stderr.
+ * - The include line is removed from the output (not preserved).
+ * - Processing continues for remaining content.
+ *
+ * @module
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { inlineIncludes } from '../include-utils.js';
+/**
+ * Write (or overwrite) the SKILL.md file for a Claude Code skill.
+ *
+ * Target path: `<homeDir>/.claude/skills/<skillName>/SKILL.md`
+ *
+ * @param opts  Installation options (see `ClaudeCodeInstallOpts`).
+ */
+export function installClaudeCode(opts) {
+    const { skillName, content, homeDir, skillsRoot } = opts;
+    // Inline @include directives before writing
+    const inlinedContent = inlineIncludes('Claude Code skill writer', content, skillsRoot);
+    // Determine target path: <homeDir>/.claude/skills/<skillName>/SKILL.md
+    const skillDir = path.join(homeDir, '.claude', 'skills', skillName);
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), inlinedContent, 'utf-8');
+}
+/**
+ * Uninstall a Claude Code skill by removing its directory.
+ *
+ * Target: `<homeDir>/.claude/skills/<skillName>/`
+ *
+ * Security: `skillName` is validated against the expected skills directory
+ * boundary to prevent path traversal (e.g. `../other-dir`). If `skillName`
+ * resolves outside the skills directory, the function is a no-op.
+ *
+ * This is also a no-op when the directory does not exist (no error is thrown).
+ *
+ * @param skillName  Name of the skill to uninstall.
+ * @param homeDir    Home directory where the skill directory lives.
+ */
+export function uninstallClaudeCode(skillName, homeDir) {
+    const skillsBase = path.resolve(homeDir, '.claude', 'skills');
+    // Security: validate skillName does not escape the skills directory.
+    // Normalize skillName and verify the resolved path stays within the base.
+    const normalizedName = path.normalize(skillName);
+    const resolvedSkillDir = path.resolve(skillsBase, normalizedName);
+    const baseResolved = skillsBase + path.sep;
+    if (!resolvedSkillDir.startsWith(baseResolved)) {
+        // skillName traversal attempt — no-op rather than throwing, matching
+        // the "no error when directory does not exist" behaviour.
+        return;
+    }
+    fs.rmSync(resolvedSkillDir, { recursive: true, force: true });
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/tool-surface/skill-installers/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/tool-surface/skill-installers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsBrD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEzD,4CAA4C;IAC5C,MAAM,cAAc,GAAG,cAAc,CAAC,0BAA0B,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAEvF,uEAAuE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,OAAe;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE9D,qEAAqE;IACrE,0EAA0E;IAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC;IAC3C,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/C,qEAAqE;QACrE,0DAA0D;QAC1D,OAAO;IACT,CAAC;IAED,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/tool-surface/skill-installers/codex-cli.d.ts

@@ -0,0 +1,27 @@
+export interface CodexCliInstallOpts {
+    /** Human-readable name of the skill (used in file path). */
+    skillName: string;
+    /** Raw skill content, possibly containing @include directives. */
+    content: string;
+    /**
+     * Home directory — replaces `os.homedir()` in all file operations.
+     * Must NOT default to `os.homedir()`.
+     */
+    homeDir: string;
+    /** Root of the skills directory for @include resolution. */
+    skillsRoot: string;
+}
+/**
+ * Write (or overwrite) the SKILL.md file for a Codex CLI skill.
+ *
+ * Target path: `<homeDir>/.codex/skills/<skillName>/SKILL.md`
+ */
+export declare function installCodexCli(opts: CodexCliInstallOpts): void;
+/**
+ * Uninstall a Codex CLI skill by removing its directory.
+ *
+ * This is a no-op when the directory does not exist or when `skillName` would
+ * escape the Codex skills directory.
+ */
+export declare function uninstallCodexCli(skillName: string, homeDir: string): void;
+//# sourceMappingURL=codex-cli.d.ts.map

package/dist/tool-surface/skill-installers/codex-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-cli.d.ts","sourceRoot":"","sources":["../../../src/tool-surface/skill-installers/codex-cli.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAuCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAW/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK1E"}

package/dist/tool-surface/skill-installers/codex-cli.js

@@ -0,0 +1,84 @@
+/**
+ * Codex CLI skill writer for install-skill.
+ *
+ * Writes each skill's SKILL.md to `<homeDir>/.codex/skills/<skillName>/SKILL.md`.
+ * Codex discovers skills from that directory on the next session start. Existing
+ * `AGENTS.md` instructions are user-owned and are not modified by this writer.
+ *
+ * Before writing, any `@include _shared/<file>.md` directives are inlined using
+ * the shared include utility. Missing shared files are warned about and omitted,
+ * matching the other client writers.
+ *
+ * @module
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { inlineIncludes } from '../include-utils.js';
+const LEGACY_MANAGED_BEGIN = '<!-- multi-model-agent:BEGIN -->';
+const LEGACY_MANAGED_END = '<!-- multi-model-agent:END -->';
+function codexSkillsBase(homeDir) {
+    return path.resolve(homeDir, '.codex', 'skills');
+}
+function resolveSkillDir(homeDir, skillName) {
+    const base = codexSkillsBase(homeDir);
+    const resolved = path.resolve(base, path.normalize(skillName));
+    if (!resolved.startsWith(base + path.sep))
+        return null;
+    return resolved;
+}
+function removeLegacyManagedAgentsBlock(homeDir) {
+    const agentsPath = path.join(homeDir, '.codex', 'AGENTS.md');
+    let content;
+    try {
+        content = fs.readFileSync(agentsPath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    const beginIdx = content.indexOf(LEGACY_MANAGED_BEGIN);
+    const endIdx = content.indexOf(LEGACY_MANAGED_END);
+    if (beginIdx === -1 || endIdx === -1 || beginIdx > endIdx)
+        return;
+    const suffixStart = endIdx + LEGACY_MANAGED_END.length;
+    const prefix = content.slice(0, beginIdx);
+    const suffix = content.slice(suffixStart).replace(/^\n+/, '');
+    const nextContent = `${prefix}${suffix}`;
+    if (nextContent.trim() === '') {
+        fs.unlinkSync(agentsPath);
+    }
+    else {
+        fs.writeFileSync(agentsPath, nextContent, 'utf-8');
+    }
+}
+/**
+ * Write (or overwrite) the SKILL.md file for a Codex CLI skill.
+ *
+ * Target path: `<homeDir>/.codex/skills/<skillName>/SKILL.md`
+ */
+export function installCodexCli(opts) {
+    const { skillName, content, homeDir, skillsRoot } = opts;
+    const skillDir = resolveSkillDir(homeDir, skillName);
+    if (skillDir === null) {
+        throw new Error(`Invalid Codex CLI skill name: ${skillName}`);
+    }
+    removeLegacyManagedAgentsBlock(homeDir);
+    const inlinedContent = inlineIncludes('Codex CLI skill writer', content, skillsRoot);
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), inlinedContent, 'utf-8');
+}
+/**
+ * Uninstall a Codex CLI skill by removing its directory.
+ *
+ * This is a no-op when the directory does not exist or when `skillName` would
+ * escape the Codex skills directory.
+ */
+export function uninstallCodexCli(skillName, homeDir) {
+    removeLegacyManagedAgentsBlock(homeDir);
+    const skillDir = resolveSkillDir(homeDir, skillName);
+    if (skillDir === null)
+        return;
+    fs.rmSync(skillDir, { recursive: true, force: true });
+}
+//# sourceMappingURL=codex-cli.js.map

package/dist/tool-surface/skill-installers/codex-cli.js.map

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

package/dist/tool-surface/skill-installers/cursor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Options for installing a Cursor skill.
+ *
+ * NOTE: `homeDir` is accepted for API parity with other skill writers
+ * (Claude Code, Gemini CLI, etc.) but is intentionally not used by this
+ * writer. The Cursor rules target path is always CWD-relative under
+ * `<cwd>/.cursor/rules/`, not homeDir-relative. This is intentional to
+ * keep Cursor rules scoped to the project directory.
+ */
+export interface CursorInstallOpts {
+    /**
+     * Raw skill content. May contain `@include _shared/<file>.md` directives
+     * which are inlined before writing.
+     */
+    content: string;
+    /**
+     * Working directory — replaces `process.cwd()`.
+     * Used to construct the CWD-relative target path:
+     * `<cwd>/.cursor/rules/multi-model-agent.mdc`
+     */
+    cwd: string;
+    /**
+     * Home directory. Accepted for API signature compatibility with other
+     * skill writers, but NOT used by this writer. Cursor rules are always
+     * written relative to `cwd`, not `homeDir`.
+     */
+    homeDir: string;
+    /**
+     * Where shared files live. The writer reads `<skillsRoot>/_shared/<path>`
+     * when inlining `@include` directives.
+     */
+    skillsRoot: string;
+    /**
+     * If true, overwrite the existing file. If false (default), skip writing
+     * when the file already exists.
+     */
+    force?: boolean;
+}
+/**
+ * Result of `installCursor`.
+ */
+export interface CursorInstallResult {
+    /**
+     * `true` if the file was written, `false` if it was skipped because it
+     * already exists and `force` was not set.
+     */
+    written: boolean;
+    /** The full path that was (or would have been) written. */
+    targetPath: string;
+}
+/**
+ * Install the multi-model-agent skill for Cursor.
+ *
+ * - Target path is `<cwd>/.cursor/rules/multi-model-agent.mdc` (CWD-relative).
+ * - Creates `<cwd>/.cursor/rules/` if it does not exist.
+ * - Inlines `@include` directives before writing (see `inlineIncludes`).
+ * - If the file already exists and `force` is not set, skips writing and
+ *   returns `written: false`.
+ *
+ * @param opts  Installation options (see `CursorInstallOpts`).
+ */
+export declare function installCursor(opts: CursorInstallOpts): CursorInstallResult;
+/**
+ * Uninstall the multi-model-agent Cursor skill.
+ *
+ * Removes `<cwd>/.cursor/rules/multi-model-agent.mdc`.
+ * This is a no-op when the file does not exist (no error is thrown).
+ *
+ * @param cwd  Working directory (replaces `process.cwd()`).
+ */
+export declare function uninstallCursor(cwd: string): void;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/tool-surface/skill-installers/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/tool-surface/skill-installers/cursor.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAmB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAmBjD"}

package/dist/tool-surface/skill-installers/cursor.js

@@ -0,0 +1,81 @@
+/**
+ * Cursor skill writer.
+ *
+ * Writes the skill content to `<cwd>/.cursor/rules/multi-model-agent.mdc`.
+ *
+ * Before writing, inlines any `@include _shared/<file>.md` directives found in
+ * the content. The directive line is replaced with the full content of
+ * the corresponding shared file sourced from `<skillsRoot>/_shared/<path>`.
+ * The `@include` directive is NOT preserved in the written file.
+ *
+ * If a referenced shared file is missing (ENOENT):
+ * - A warning is logged to stderr.
+ * - The include line is removed from the output (not preserved).
+ * - Processing continues for remaining directives.
+ *
+ * Security constraints on `@include` directives:
+ * - Only paths beginning with `_shared/` are accepted.
+ * - The resolved path must stay within `<skillsRoot>/_shared/`.
+ *   Path traversal attempts (e.g. `_shared/../secrets.txt`) are rejected
+ *   with a warning and the directive line is dropped.
+ * - Non-`_shared/` paths are rejected with a warning and the directive
+ *   line is dropped.
+ *
+ * @module
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { inlineIncludes } from '../include-utils.js';
+/**
+ * Install the multi-model-agent skill for Cursor.
+ *
+ * - Target path is `<cwd>/.cursor/rules/multi-model-agent.mdc` (CWD-relative).
+ * - Creates `<cwd>/.cursor/rules/` if it does not exist.
+ * - Inlines `@include` directives before writing (see `inlineIncludes`).
+ * - If the file already exists and `force` is not set, skips writing and
+ *   returns `written: false`.
+ *
+ * @param opts  Installation options (see `CursorInstallOpts`).
+ */
+export function installCursor(opts) {
+    const { content, cwd, skillsRoot, force } = opts;
+    const targetPath = path.join(cwd, '.cursor', 'rules', 'multi-model-agent.mdc');
+    if (!force && fs.existsSync(targetPath)) {
+        process.stderr.write(`Warning: Cursor skill writer: file already exists: ${targetPath} — skipping (use force: true to overwrite)\n`);
+        return { written: false, targetPath };
+    }
+    const rulesDir = path.join(cwd, '.cursor', 'rules');
+    fs.mkdirSync(rulesDir, { recursive: true, mode: 0o700 });
+    const finalContent = inlineIncludes('Cursor skill writer', content, skillsRoot);
+    fs.writeFileSync(targetPath, finalContent, 'utf-8');
+    return { written: true, targetPath };
+}
+/**
+ * Uninstall the multi-model-agent Cursor skill.
+ *
+ * Removes `<cwd>/.cursor/rules/multi-model-agent.mdc`.
+ * This is a no-op when the file does not exist (no error is thrown).
+ *
+ * @param cwd  Working directory (replaces `process.cwd()`).
+ */
+export function uninstallCursor(cwd) {
+    const targetPath = path.join(cwd, '.cursor', 'rules', 'multi-model-agent.mdc');
+    // Only remove the file if it exists and is a file (not a directory).
+    // This is a no-op when the path does not exist.
+    try {
+        const stat = fs.statSync(targetPath);
+        if (stat.isFile()) {
+            fs.unlinkSync(targetPath);
+        }
+        // If it's a directory or symlink to directory, do nothing — the brief
+        // specifies removing a file, not a directory tree.
+    }
+    catch (err) {
+        const nodeErr = err;
+        // ENOENT means the file doesn't exist — that's fine, we were asked to remove it
+        if (nodeErr.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/tool-surface/skill-installers/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/tool-surface/skill-installers/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsDrD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAEjD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAE/E,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sDAAsD,UAAU,8CAA8C,CAC/G,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEzD,MAAM,YAAY,GAAG,cAAc,CAAC,qBAAqB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAChF,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAEpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAE/E,qEAAqE;IACrE,gDAAgD;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAClB,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,sEAAsE;QACtE,mDAAmD;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAA4B,CAAC;QAC7C,gFAAgF;QAChF,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tool-surface/skill-installers/gemini-cli.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Options for installing a skill via the Gemini CLI writer.
+ */
+export interface GeminiCliInstallOpts {
+    /** Skill name (currently informational; writes always go to multi-model-agent extension). */
+    skillName: string;
+    /**
+     * Raw SKILL.md content. May contain `@include _shared/<file>.md` directives
+     * which are inlined before writing.
+     */
+    content: string;
+    /**
+     * Version string for the extension manifest's `version` field.
+     */
+    skillVersion: string;
+    /**
+     * The "home directory" that replaces `os.homedir()`.
+     * Must NOT default to `os.homedir()` — always required explicitly.
+     */
+    homeDir: string;
+    /**
+     * Where shared files live. The writer reads `<skillsRoot>/_shared/<file>.md`
+     * when inlining `@include` directives.
+     */
+    skillsRoot: string;
+}
+/**
+ * Inline `@include _shared/<file>.md` directives in `content`.
+ *
+ * Each line matching `@include <path>` (space after `@include`) is replaced with
+ * the full content of `<skillsRoot>/_shared/<path>`.
+ *
+ * If a shared file is missing:
+ * - A warning is written to stderr.
+ * - The include line is removed from the output (not preserved).
+ * - Processing continues for remaining directives.
+ *
+ * @param content     Raw SKILL.md content (may contain @include directives).
+ * @param skillsRoot  Root directory containing `_shared/` sub-directory.
+ * @returns The content with directives inlined.
+ */
+export declare function inlineIncludes(content: string, skillsRoot: string): string;
+/**
+ * Install a skill to the Gemini CLI extensions directory.
+ *
+ * Writes two files into `<homeDir>/.gemini/extensions/multi-model-agent/`:
+ *   1. `gemini-extension.json` — the extension manifest
+ *   2. `SKILL.md` — the skill content with @include directives inlined
+ *
+ * The directory (and any parent directories) are created with mode `0o700`.
+ * Calling this function multiple times overwrites the previous installation
+ * (idempotent).
+ *
+ * @param opts  Installation options (see `GeminiCliInstallOpts`).
+ */
+export declare function installGeminiCli(opts: GeminiCliInstallOpts): void;
+/**
+ * Uninstall the multi-model-agent Gemini CLI extension.
+ *
+ * Recursively removes `<homeDir>/.gemini/extensions/multi-model-agent/`.
+ * This is a no-op when the directory does not exist (no error is thrown).
+ *
+ * @param homeDir  The "home directory" that replaces `os.homedir()`.
+ */
+export declare function uninstallGeminiCli(homeDir: string): void;
+//# sourceMappingURL=gemini-cli.d.ts.map

package/dist/tool-surface/skill-installers/gemini-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-cli.d.ts","sourceRoot":"","sources":["../../../src/tool-surface/skill-installers/gemini-cli.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA6B1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAuBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKxD"}

package/dist/tool-surface/skill-installers/gemini-cli.js

@@ -0,0 +1,111 @@
+/**
+ * Gemini CLI skill writer.
+ *
+ * Writes to `<homeDir>/.gemini/extensions/multi-model-agent/`:
+ *   - `gemini-extension.json`  — extension manifest
+ *   - `SKILL.md`               — skill content (with @include directives inlined)
+ *
+ * The extension is always named `multi-model-agent` regardless of `skillName`
+ * (the extension loads whichever skill files are provided).  This is a
+ * judgment call because the Gemini CLI extension format is not fully
+ * standardized; a minimal JSON schema is used.
+ *
+ * Before writing SKILL.md, any `@include _shared/<file>.md` directive lines
+ * are replaced with the file content from `<skillsRoot>/_shared/<file>.md`.
+ * Missing shared files → warning to stderr, line is dropped.
+ *
+ * @module
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** Regex matching a line that starts with `@include ` followed by a relative path. */
+const INCLUDE_RE = /^@include\s+(.+)$/;
+/**
+ * Inline `@include _shared/<file>.md` directives in `content`.
+ *
+ * Each line matching `@include <path>` (space after `@include`) is replaced with
+ * the full content of `<skillsRoot>/_shared/<path>`.
+ *
+ * If a shared file is missing:
+ * - A warning is written to stderr.
+ * - The include line is removed from the output (not preserved).
+ * - Processing continues for remaining directives.
+ *
+ * @param content     Raw SKILL.md content (may contain @include directives).
+ * @param skillsRoot  Root directory containing `_shared/` sub-directory.
+ * @returns The content with directives inlined.
+ */
+export function inlineIncludes(content, skillsRoot) {
+    const lines = content.split('\n');
+    const result = [];
+    for (const line of lines) {
+        const match = INCLUDE_RE.exec(line);
+        if (!match) {
+            result.push(line);
+            continue;
+        }
+        const relativePath = match[1];
+        const sharedFilePath = path.join(skillsRoot, relativePath);
+        try {
+            const sharedContent = fs.readFileSync(sharedFilePath, 'utf-8');
+            result.push(sharedContent);
+        }
+        catch (err) {
+            // Log warning to stderr and drop the include line.
+            const detail = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`Warning: Gemini CLI skill writer: shared file not found: ` +
+                `${sharedFilePath} (referenced by @include ${relativePath}) — ${detail}\n`);
+            // Line is dropped — do not push anything.
+        }
+    }
+    return result.join('\n');
+}
+/**
+ * Install a skill to the Gemini CLI extensions directory.
+ *
+ * Writes two files into `<homeDir>/.gemini/extensions/multi-model-agent/`:
+ *   1. `gemini-extension.json` — the extension manifest
+ *   2. `SKILL.md` — the skill content with @include directives inlined
+ *
+ * The directory (and any parent directories) are created with mode `0o700`.
+ * Calling this function multiple times overwrites the previous installation
+ * (idempotent).
+ *
+ * @param opts  Installation options (see `GeminiCliInstallOpts`).
+ */
+export function installGeminiCli(opts) {
+    const { skillName: _skillName, content, skillVersion, homeDir, skillsRoot } = opts;
+    const extDir = path.join(homeDir, '.gemini', 'extensions', 'multi-model-agent');
+    fs.mkdirSync(extDir, { recursive: true, mode: 0o700 });
+    // Write the extension manifest.
+    // Shape is a minimal reasonable schema; Gemini CLI extension format is not
+    // fully standardized, so we document this judgment call.
+    const manifest = {
+        name: 'multi-model-agent',
+        version: skillVersion,
+        description: 'multi-model-agent skills for Gemini CLI',
+        schemaVersion: '1.0',
+        contextFiles: ['SKILL.md'],
+    };
+    const manifestPath = path.join(extDir, 'gemini-extension.json');
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+    // Write the skill content with @include directives inlined.
+    const finalContent = inlineIncludes(content, skillsRoot);
+    const skillPath = path.join(extDir, 'SKILL.md');
+    fs.writeFileSync(skillPath, finalContent, 'utf-8');
+}
+/**
+ * Uninstall the multi-model-agent Gemini CLI extension.
+ *
+ * Recursively removes `<homeDir>/.gemini/extensions/multi-model-agent/`.
+ * This is a no-op when the directory does not exist (no error is thrown).
+ *
+ * @param homeDir  The "home directory" that replaces `os.homedir()`.
+ */
+export function uninstallGeminiCli(homeDir) {
+    const extDir = path.join(homeDir, '.gemini', 'extensions', 'multi-model-agent');
+    if (fs.existsSync(extDir)) {
+        fs.rmSync(extDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=gemini-cli.js.map

package/dist/tool-surface/skill-installers/gemini-cli.js.map

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

package/dist/tool-surface/skill-manifest-sync.d.ts

@@ -0,0 +1,11 @@
+import type { Client } from './manifest.js';
+export interface DriftEntry {
+    skill: string;
+    client: Client;
+    issue: 'missing' | 'outdated' | 'orphan';
+}
+export interface SkillManifestSync {
+    driftReport(): DriftEntry[];
+}
+export declare function makeSkillManifestSync(perClientInstallDirs: Partial<Record<Client, string>>): SkillManifestSync;
+//# sourceMappingURL=skill-manifest-sync.d.ts.map

package/dist/tool-surface/skill-manifest-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest-sync.d.ts","sourceRoot":"","sources":["../../src/tool-surface/skill-manifest-sync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,IAAI,UAAU,EAAE,CAAC;CAC7B;AAcD,wBAAgB,qBAAqB,CAAC,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,iBAAiB,CAuC9G"}