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

package/dist/tool-surface/discover.js

@@ -0,0 +1,87 @@
+// Skill discovery — locates packaged SKILL.md files on disk and reads them.
+// Extracted from cli/install-skill.ts as part of Ch 7 Task 39.
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const SUPPORTED_SKILLS = [
+    'multi-model-agent',
+    'mma-delegate',
+    'mma-audit',
+    'mma-review',
+    'mma-verify',
+    'mma-debug',
+    'mma-execute-plan',
+    'mma-retry',
+    'mma-context-blocks',
+    'mma-investigate',
+    'mma-explore',
+];
+/** Thrown when a skill's SKILL.md cannot be read from the bundled skills directory. */
+export class SkillNotFoundError extends Error {
+    code = 'skill_not_found';
+    constructor(skillName, checkedPath) {
+        super(`Skill '${skillName}' not found. ` +
+            `Checked: ${checkedPath}. ` +
+            `Available skills: ${SUPPORTED_SKILLS.join(', ')}`);
+    }
+}
+// Discover.ts lives in `packages/core/src/tool-surface/` (or its dist mirror).
+// Skills are bundled by the server package at `packages/server/src/skills/`
+// (and copied to `packages/server/dist/skills/` at build time). Probe both
+// candidates so dev (running .ts) and prod (running .js) resolve to a real
+// skills directory without environment-specific configuration.
+function locateSkillsRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.resolve(here, '..', '..', '..', 'server', 'src', 'skills'),
+        path.resolve(here, '..', '..', '..', 'server', 'dist', 'skills'),
+        // Fallback to old location semantics for any caller that doesn't go
+        // through the server package.
+        path.resolve(here, '..', 'skills'),
+    ];
+    for (const c of candidates) {
+        if (fs.existsSync(c))
+            return c;
+    }
+    return candidates[0];
+}
+const DEFAULT_SKILLS_ROOT = locateSkillsRoot();
+/**
+ * Return the absolute path to the skills root directory. Production: the
+ * bundled `packages/server/src/skills/` (or its dist mirror). Tests pass
+ * a fixture path explicitly.
+ */
+export function getSkillsRoot(skillsRoot) {
+    return skillsRoot ?? DEFAULT_SKILLS_ROOT;
+}
+/**
+ * Read the content of a skill's SKILL.md file. Returns null if the file
+ * does not exist; propagates other I/O errors so callers can distinguish
+ * "skill not found" from "can't access skill".
+ */
+export function readSkillContent(skillName, skillsRoot) {
+    const skillFile = path.join(getSkillsRoot(skillsRoot), skillName, 'SKILL.md');
+    try {
+        return fs.readFileSync(skillFile, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Return the per-client install directories where skills are written as
+ * subdirectories. Only includes clients that use the per-skill directory
+ * model (claude-code and codex). Gemini and Cursor bundle skills into a
+ * single file/extension and are not included.
+ */
+export function discoverPerClientInstallDirs(homeDir) {
+    const h = homeDir ?? os.homedir();
+    return {
+        'claude-code': path.join(h, '.claude', 'skills'),
+        'codex': path.join(h, '.codex', 'skills'),
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/tool-surface/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/tool-surface/discover.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+DAA+D;AAC/D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mBAAmB;IACnB,cAAc;IACd,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,kBAAkB;IAClB,WAAW;IACX,oBAAoB;IACpB,iBAAiB;IACjB,aAAa;CACL,CAAC;AAEX,uFAAuF;AACvF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,iBAA0B,CAAC;IAC3C,YAAY,SAAiB,EAAE,WAAmB;QAChD,KAAK,CACH,UAAU,SAAS,eAAe;YAClC,YAAY,WAAW,IAAI;YAC3B,qBAAqB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnD,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,+DAA+D;AAC/D,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC;QAC/D,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;QAChE,oEAAoE;QACpE,8BAA8B;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC;KACnC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC;AACxB,CAAC;AAED,MAAM,mBAAmB,GAAG,gBAAgB,EAAE,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAmB;IAC/C,OAAO,UAAU,IAAI,mBAAmB,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,UAAmB;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC9E,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,MAAM,CAAC,GAAG,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAClC,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC;QAChD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/tool-surface/include-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Inline `@include _shared/<path>` directives in `content`.
+ *
+ * Each line matching `@include _shared/<path>` (space after `@include`) is
+ * replaced with the full content of `<skillsRoot>/_shared/<path>`.
+ *
+ * Security constraints:
+ * - Only paths beginning with `_shared/` are accepted.
+ * - The resolved path must stay within `<skillsRoot>/_shared/`.
+ *   Path traversal attempts are rejected with a warning and the directive
+ *   line is dropped.
+ *
+ * If a shared file is missing (ENOENT):
+ * - A warning is written to stderr.
+ * - The include line is removed from the output (not preserved).
+ * - Processing continues for remaining directives.
+ *
+ * Other I/O errors (permission denied, EISDIR, etc.) are re-thrown so the
+ * caller can distinguish them from a simple missing-file case.
+ *
+ * @param skillContext  Used in warning messages to identify the skill context.
+ * @param content       Raw skill content (may contain @include directives).
+ * @param skillsRoot    Root directory containing `_shared/` sub-directory.
+ * @returns The content with directives inlined.
+ */
+export declare function inlineIncludes(skillContext: string, content: string, skillsRoot: string): string;
+//# sourceMappingURL=include-utils.d.ts.map

package/dist/tool-surface/include-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"include-utils.d.ts","sourceRoot":"","sources":["../../src/tool-surface/include-utils.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CA6DR"}

package/dist/tool-surface/include-utils.js

@@ -0,0 +1,90 @@
+/**
+ * Shared include-inlining utilities for skill writers.
+ *
+ * Provides a common implementation for `@include _shared/<path>` directive
+ * processing, used by all skill writers (Claude Code, Cursor, etc.).
+ *
+ * @module
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Regex matching a line that starts with `@include ` (exact space after
+ * `@include`) followed by a relative path.
+ */
+const INCLUDE_RE = /^@include\s+(.+)$/;
+/**
+ * Inline `@include _shared/<path>` directives in `content`.
+ *
+ * Each line matching `@include _shared/<path>` (space after `@include`) is
+ * replaced with the full content of `<skillsRoot>/_shared/<path>`.
+ *
+ * Security constraints:
+ * - Only paths beginning with `_shared/` are accepted.
+ * - The resolved path must stay within `<skillsRoot>/_shared/`.
+ *   Path traversal attempts are rejected with a warning and the directive
+ *   line is dropped.
+ *
+ * If a shared file is missing (ENOENT):
+ * - A warning is written to stderr.
+ * - The include line is removed from the output (not preserved).
+ * - Processing continues for remaining directives.
+ *
+ * Other I/O errors (permission denied, EISDIR, etc.) are re-thrown so the
+ * caller can distinguish them from a simple missing-file case.
+ *
+ * @param skillContext  Used in warning messages to identify the skill context.
+ * @param content       Raw skill content (may contain @include directives).
+ * @param skillsRoot    Root directory containing `_shared/` sub-directory.
+ * @returns The content with directives inlined.
+ */
+export function inlineIncludes(skillContext, 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] ?? '';
+        // Security: only accept paths beginning with `_shared/`
+        if (!relativePath.startsWith('_shared/')) {
+            process.stderr.write(`Warning: ${skillContext}: @include path must start with ` +
+                `"_shared/": ${relativePath}\n`);
+            // Directive line is dropped — do not push anything.
+            continue;
+        }
+        // Security: reject path traversal attempts
+        const resolvedPath = path.resolve(skillsRoot, relativePath);
+        const sharedDir = path.resolve(skillsRoot, '_shared');
+        if (!resolvedPath.startsWith(sharedDir + path.sep) &&
+            resolvedPath !== sharedDir) {
+            process.stderr.write(`Warning: ${skillContext}: @include path rejected ` +
+                `(path traversal): ${relativePath}\n`);
+            // Directive line is dropped.
+            continue;
+        }
+        const sharedFilePath = path.join(skillsRoot, relativePath);
+        try {
+            const sharedContent = fs.readFileSync(sharedFilePath, 'utf-8');
+            result.push(sharedContent);
+        }
+        catch (err) {
+            const nodeErr = err;
+            if (nodeErr.code === 'ENOENT') {
+                // Missing shared file — warn and drop the directive line.
+                const detail = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`Warning: ${skillContext}: shared file not found: ` +
+                    `${sharedFilePath} (referenced by @include ${relativePath}) — ${detail}\n`);
+                // Line is dropped — do not push anything.
+            }
+            else {
+                // Permission errors, EISDIR, etc. — re-throw so the caller notices.
+                throw err;
+            }
+        }
+    }
+    return result.join('\n');
+}
+//# sourceMappingURL=include-utils.js.map

package/dist/tool-surface/include-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"include-utils.js","sourceRoot":"","sources":["../../src/tool-surface/include-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,OAAe,EACf,UAAkB;IAElB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEpC,wDAAwD;QACxD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,YAAY,kCAAkC;gBAC1D,eAAe,YAAY,IAAI,CAChC,CAAC;YACF,oDAAoD;YACpD,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACtD,IACE,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;YAC9C,YAAY,KAAK,SAAS,EAC1B,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,YAAY,2BAA2B;gBACnD,qBAAqB,YAAY,IAAI,CACtC,CAAC;YACF,6BAA6B;YAC7B,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAA4B,CAAC;YAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9B,0DAA0D;gBAC1D,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,YAAY,2BAA2B;oBACnD,GAAG,cAAc,4BAA4B,YAAY,OAAO,MAAM,IAAI,CAC3E,CAAC;gBACF,0CAA0C;YAC5C,CAAC;iBAAM,CAAC;gBACN,oEAAoE;gBACpE,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/tool-surface/index.d.ts

@@ -0,0 +1,6 @@
+export * from './tool-surface-registry.js';
+export * from './register-all-tools.js';
+export * from './skill-installer.js';
+export * from './skill-manifest-sync.js';
+export * from './openapi-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tool-surface/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool-surface/index.ts"],"names":[],"mappings":"AAEA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/dist/tool-surface/index.js

@@ -0,0 +1,7 @@
+// tool-surface/index.ts — public surface barrel; per architecture.md:262-275.
+export * from './tool-surface-registry.js';
+export * from './register-all-tools.js';
+export * from './skill-installer.js';
+export * from './skill-manifest-sync.js';
+export * from './openapi-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/tool-surface/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tool-surface/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

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

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+/** Union of all supported AI client targets. */
+export type Client = 'claude-code' | 'gemini' | 'codex' | 'cursor';
+/** All known client values — used for --all-targets and target validation. */
+export declare const ALL_CLIENTS: readonly Client[];
+/**
+ * Detect which AI client directories exist in the home directory.
+ * Checks for evidence of each known client:
+ * - claude-code: ~/.claude/ directory present (installs skills under ~/.claude/skills/)
+ * - gemini:       ~/.gemini/extensions/ directory present
+ * - codex:        ~/.codex/ directory present (installs skills under ~/.codex/skills/)
+ * - cursor:       ~/.cursor/rules/ directory present
+ *
+ * The claude-code check deliberately accepts ~/.claude/ as sufficient signal
+ * even when ~/.claude/skills/ does not yet exist (fresh install with no skills).
+ */
+export declare function detectClients(homeDir: string): Client[];
+declare const manifestEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    skillVersion: z.ZodString;
+    installedAt: z.ZodNumber;
+    targets: z.ZodArray<z.ZodEnum<{
+        codex: "codex";
+        gemini: "gemini";
+        "claude-code": "claude-code";
+        cursor: "cursor";
+    }>>;
+}, z.core.$strip>;
+declare const installManifestSchema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    entries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        skillVersion: z.ZodString;
+        installedAt: z.ZodNumber;
+        targets: z.ZodArray<z.ZodEnum<{
+            codex: "codex";
+            gemini: "gemini";
+            "claude-code": "claude-code";
+            cursor: "cursor";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InstallManifest = z.infer<typeof installManifestSchema>;
+export type ManifestEntry = z.infer<typeof manifestEntrySchema>;
+/** Thrown when the manifest declares a version newer than this mmagent supports. */
+export declare class FutureManifestError extends Error {
+    constructor(version: number);
+}
+/** Thrown when the manifest file exists but cannot be parsed as valid JSON. */
+export declare class ManifestParseError extends Error {
+    constructor(manifestPath: string, cause: string);
+}
+/** Thrown when the manifest JSON parses but fails Zod structural validation. */
+export declare class ManifestSchemaValidationError extends Error {
+    constructor(manifestPath: string, issues: z.ZodError);
+}
+/** The directory where the manifest file lives. */
+export declare function manifestDir(homeDir?: string): string;
+/** Full path to the manifest file. */
+export declare function manifestPath(homeDir?: string): string;
+/**
+ * Return all manifest entries, newest-first.
+ */
+export declare function listEntries(homeDir?: string): ManifestEntry[];
+/**
+ * Find the entry for `skillName`, or undefined if not installed.
+ */
+export declare function getEntry(skillName: string, homeDir?: string): ManifestEntry | undefined;
+/**
+ * Append (or update) the entry for `skillName`.
+ *
+ * - New entry: creates with de-duplicated `newTargets`.
+ * - Existing entry: merges `newTargets` into existing targets (no duplicates),
+ *   refreshes `version` and `installedAt`.
+ *
+ * In both paths the stored `targets` array is a fresh copy — caller mutations
+ * after the call do not affect the in-memory object or persisted manifest.
+ *
+ * Returns the resulting entry.
+ */
+export declare function appendEntry(skillName: string, skillVersion: string, newTargets: Client[], homeDir?: string): ManifestEntry;
+/**
+ * Remove `targets` from the entry for `skillName`.
+ * If `targets` is omitted or empty, removes the entire entry.
+ * Returns the removed targets (or all targets for a full removal),
+ * or an empty array if the skill wasn't in the manifest.
+ */
+export declare function removeEntry(skillName: string, targets?: Client[], homeDir?: string): Client[];
+/**
+ * Returns true when `skillName` is recorded in the manifest with at least one target.
+ */
+export declare function isInstalled(skillName: string, homeDir?: string): boolean;
+export {};
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/tool-surface/manifest.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gDAAgD;AAChD,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnE,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAAiD,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAOvD;AAUD,QAAA,MAAM,mBAAmB;;;;;;;;;;iBAKvB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;iBAGzB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,oFAAoF;AACpF,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,+EAA+E;AAC/E,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAGhD;AAED,gFAAgF;AAChF,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ;CAKrD;AAID,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAwED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CA+Bf;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,EAAE,CAsBV;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAGxE"}

package/dist/tool-surface/manifest.js

@@ -0,0 +1,234 @@
+/**
+ * Install manifest management.
+ *
+ * The manifest lives at `<homeDir>/.multi-model/install-manifest.json` and records
+ * every skill ever installed so `install-skill --uninstall` can reverse
+ * the operation without leaving orphaned files.
+ *
+ * All functions accept an optional `homeDir` parameter for testability.
+ * When omitted, `os.homedir()` is used as the default.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { z } from 'zod';
+/** All known client values — used for --all-targets and target validation. */
+export const ALL_CLIENTS = ['claude-code', 'gemini', 'codex', 'cursor'];
+/**
+ * Detect which AI client directories exist in the home directory.
+ * Checks for evidence of each known client:
+ * - claude-code: ~/.claude/ directory present (installs skills under ~/.claude/skills/)
+ * - gemini:       ~/.gemini/extensions/ directory present
+ * - codex:        ~/.codex/ directory present (installs skills under ~/.codex/skills/)
+ * - cursor:       ~/.cursor/rules/ directory present
+ *
+ * The claude-code check deliberately accepts ~/.claude/ as sufficient signal
+ * even when ~/.claude/skills/ does not yet exist (fresh install with no skills).
+ */
+export function detectClients(homeDir) {
+    const detected = [];
+    if (fs.existsSync(path.join(homeDir, '.claude')))
+        detected.push('claude-code');
+    if (fs.existsSync(path.join(homeDir, '.gemini', 'extensions')))
+        detected.push('gemini');
+    if (fs.existsSync(path.join(homeDir, '.codex')))
+        detected.push('codex');
+    if (fs.existsSync(path.join(homeDir, '.cursor', 'rules')))
+        detected.push('cursor');
+    return detected;
+}
+const MANIFEST_NAME = 'install-manifest.json';
+// ─── Zod schema ──────────────────────────────────────────────────────────────
+/** Zod schema for a single client target value. */
+const clientSchema = z.enum(['claude-code', 'gemini', 'codex', 'cursor']);
+const manifestEntrySchema = z.object({
+    name: z.string().min(1),
+    skillVersion: z.string().min(1),
+    installedAt: z.number().int().nonnegative(),
+    targets: z.array(clientSchema),
+});
+const installManifestSchema = z.object({
+    version: z.literal(2),
+    entries: z.array(manifestEntrySchema),
+});
+/** Thrown when the manifest declares a version newer than this mmagent supports. */
+export class FutureManifestError extends Error {
+    constructor(version) {
+        super(`install-manifest.json was written by a newer mmagent (version ${version}); upgrade mmagent or remove the file to continue`);
+        this.name = 'FutureManifestError';
+    }
+}
+/** Thrown when the manifest file exists but cannot be parsed as valid JSON. */
+export class ManifestParseError extends Error {
+    constructor(manifestPath, cause) {
+        super(`Manifest file is corrupt (${manifestPath}): ${cause}`);
+    }
+}
+/** Thrown when the manifest JSON parses but fails Zod structural validation. */
+export class ManifestSchemaValidationError extends Error {
+    constructor(manifestPath, issues) {
+        super(`Manifest file has invalid structure (${manifestPath}): ${issues.message}`);
+    }
+}
+// ─── Path helpers ────────────────────────────────────────────────────────────
+/** The directory where the manifest file lives. */
+export function manifestDir(homeDir) {
+    return path.join(homeDir ?? os.homedir(), '.multi-model');
+}
+/** Full path to the manifest file. */
+export function manifestPath(homeDir) {
+    return path.join(manifestDir(homeDir), MANIFEST_NAME);
+}
+// ─── Low-level I/O ───────────────────────────────────────────────────────────
+function backupCorrupted(p) {
+    const backup = `${p}.bak-${Date.now()}`;
+    try {
+        fs.renameSync(p, backup);
+    }
+    catch { /* ignore — best effort */ }
+    return backup;
+}
+function readManifest(homeDir) {
+    const p = manifestPath(homeDir);
+    if (!fs.existsSync(p))
+        return emptyManifest();
+    let raw;
+    try {
+        raw = fs.readFileSync(p, 'utf-8');
+    }
+    catch {
+        return emptyManifest();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        const backup = backupCorrupted(p);
+        process.stderr.write(`[mmagent] manifest corrupt; rebuilt empty v2 (previous copy at ${backup})\n`);
+        const empty = emptyManifest();
+        writeManifest(empty, homeDir);
+        return empty;
+    }
+    const parsedVersion = parsed !== null && typeof parsed === 'object' && 'version' in parsed
+        ? parsed.version
+        : undefined;
+    if (typeof parsedVersion === 'number' && parsedVersion > 2) {
+        throw new FutureManifestError(parsedVersion);
+    }
+    // v2 — validate strictly
+    if (parsedVersion === 2) {
+        const result = installManifestSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new ManifestSchemaValidationError(p, result.error);
+        }
+        return result.data;
+    }
+    // Unrecognized shape (or pre-v2 manifest from an older mmagent) — back up and rebuild empty.
+    const backup = backupCorrupted(p);
+    process.stderr.write(`[mmagent] manifest unrecognized; rebuilt empty v2 (previous copy at ${backup})\n`);
+    const empty = emptyManifest();
+    writeManifest(empty, homeDir);
+    return empty;
+}
+function writeManifest(manifest, homeDir) {
+    fs.mkdirSync(manifestDir(homeDir), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(manifestPath(homeDir), JSON.stringify(manifest, null, 2) + '\n', {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+}
+function emptyManifest() {
+    return { version: 2, entries: [] };
+}
+// ─── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Return all manifest entries, newest-first.
+ */
+export function listEntries(homeDir) {
+    return readManifest(homeDir).entries;
+}
+/**
+ * Find the entry for `skillName`, or undefined if not installed.
+ */
+export function getEntry(skillName, homeDir) {
+    return readManifest(homeDir).entries.find((e) => e.name === skillName);
+}
+/**
+ * Append (or update) the entry for `skillName`.
+ *
+ * - New entry: creates with de-duplicated `newTargets`.
+ * - Existing entry: merges `newTargets` into existing targets (no duplicates),
+ *   refreshes `version` and `installedAt`.
+ *
+ * In both paths the stored `targets` array is a fresh copy — caller mutations
+ * after the call do not affect the in-memory object or persisted manifest.
+ *
+ * Returns the resulting entry.
+ */
+export function appendEntry(skillName, skillVersion, newTargets, homeDir) {
+    const manifest = readManifest(homeDir);
+    // De-duplicate incoming targets once, preserving order of first occurrence.
+    const seen = new Set();
+    const dedupedNewTargets = newTargets.filter((t) => {
+        if (seen.has(t))
+            return false;
+        seen.add(t);
+        return true;
+    });
+    const existing = manifest.entries.find((e) => e.name === skillName);
+    if (existing) {
+        for (const t of dedupedNewTargets) {
+            if (!existing.targets.includes(t))
+                existing.targets.push(t);
+        }
+        existing.skillVersion = skillVersion;
+        existing.installedAt = Date.now();
+    }
+    else {
+        // Clone the array so the caller cannot mutate the stored entry.
+        manifest.entries.push({
+            name: skillName,
+            skillVersion,
+            installedAt: Date.now(),
+            targets: [...dedupedNewTargets],
+        });
+    }
+    writeManifest(manifest, homeDir);
+    return existing ?? manifest.entries[manifest.entries.length - 1];
+}
+/**
+ * Remove `targets` from the entry for `skillName`.
+ * If `targets` is omitted or empty, removes the entire entry.
+ * Returns the removed targets (or all targets for a full removal),
+ * or an empty array if the skill wasn't in the manifest.
+ */
+export function removeEntry(skillName, targets = [], homeDir) {
+    const manifest = readManifest(homeDir);
+    const idx = manifest.entries.findIndex((e) => e.name === skillName);
+    if (idx === -1)
+        return [];
+    const entry = manifest.entries[idx];
+    if (targets.length === 0) {
+        // Full removal
+        manifest.entries.splice(idx, 1);
+        writeManifest(manifest, homeDir);
+        return [...entry.targets];
+    }
+    // Partial removal: only remove specified targets
+    const removed = entry.targets.filter((t) => targets.includes(t));
+    entry.targets = entry.targets.filter((t) => !removed.includes(t));
+    if (entry.targets.length === 0) {
+        manifest.entries.splice(idx, 1);
+    }
+    writeManifest(manifest, homeDir);
+    return removed;
+}
+/**
+ * Returns true when `skillName` is recorded in the manifest with at least one target.
+ */
+export function isInstalled(skillName, homeDir) {
+    const e = getEntry(skillName, homeDir);
+    return e !== undefined && e.targets.length > 0;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/tool-surface/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/tool-surface/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAsB,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/E,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxF,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxE,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAG1E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;CACtC,CAAC,CAAC;AAKH,oFAAoF;AACpF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,iEAAiE,OAAO,mDAAmD,CAAC,CAAC;QACnI,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,YAAoB,EAAE,KAAa;QAC7C,KAAK,CAAC,6BAA6B,YAAY,MAAM,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACtD,YAAY,YAAoB,EAAE,MAAkB;QAClD,KAAK,CACH,wCAAwC,YAAY,MAAM,MAAM,CAAC,OAAO,EAAE,CAC3E,CAAC;IACJ,CAAC;CACF;AAED,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5D,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,gFAAgF;AAEhF,SAAS,eAAe,CAAC,CAAS;IAChC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACxC,IAAI,CAAC;QAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB;IACpC,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,EAAE,CAAC;IAE9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kEAAkE,MAAM,KAAK,CAAC,CAAC;QACpG,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;QAC9B,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GACjB,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM;QAClE,CAAC,CAAE,MAA+B,CAAC,OAAO;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED,yBAAyB;IACzB,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,6BAA6B,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,6FAA6F;IAC7F,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uEAAuE,MAAM,KAAK,CAAC,CAAC;IACzG,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,QAAyB,EAAE,OAAgB;IAChE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;QAChF,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAED,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,OAAgB;IAC1D,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,SAAiB,EACjB,YAAoB,EACpB,UAAoB,EACpB,OAAgB;IAEhB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAEvC,4EAA4E;IAC5E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,iBAAiB,GAAa,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1D,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAEpE,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;QACrC,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,gEAAgE;QAChE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,SAAS;YACf,YAAY;YACZ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;YACvB,OAAO,EAAE,CAAC,GAAG,iBAAiB,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,SAAiB,EACjB,UAAoB,EAAE,EACtB,OAAgB;IAEhB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACpE,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAE,CAAC;IAErC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,eAAe;QACf,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,OAAgB;IAC7D,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AACjD,CAAC"}

package/dist/tool-surface/openapi-generator.d.ts

@@ -0,0 +1,15 @@
+/** Shared `cwd` query parameter (required by all tool endpoints). */
+declare const cwdQueryParam: {
+    name: string;
+    in: "query";
+    required: boolean;
+    description: string;
+    schema: {
+        type: "string";
+    };
+};
+export declare function buildOpenApiDoc(): Record<string, unknown>;
+/** Utility: serialize the OpenAPI doc with sorted keys for golden snapshots. */
+export declare function serializeOpenApiDoc(doc: Record<string, unknown>): string;
+export { cwdQueryParam };
+//# sourceMappingURL=openapi-generator.d.ts.map

package/dist/tool-surface/openapi-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-generator.d.ts","sourceRoot":"","sources":["../../src/tool-surface/openapi-generator.ts"],"names":[],"mappings":"AAmFA,qEAAqE;AACrE,QAAA,MAAM,aAAa;;;;;;;;CAMlB,CAAC;AAyDF,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuIzD;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC"}