@lyupro/skillforge-mcp 1.4.0 → 1.5.0

package/dist/installers/cursor-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-installer.d.ts","sourceRoot":"","sources":["../../src/installers/cursor-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAsDD,qBAAa,eAAgB,YAAW,SAAS;;IAC/C,QAAQ,CAAC,IAAI,YAAY;gBAKb,SAAS,GAAE,4BAAiC;IAMlD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBrD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAUrC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAsBlG"}
+{"version":3,"file":"cursor-installer.d.ts","sourceRoot":"","sources":["../../src/installers/cursor-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAyCD,qBAAa,eAAgB,YAAW,SAAS;;IAC/C,QAAQ,CAAC,IAAI,YAAY;gBAKb,SAAS,GAAE,4BAAiC;IAMlD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBrD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAUrC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAsBlG"}

package/dist/installers/cursor-installer.js

@@ -12,14 +12,8 @@ import { spawnSync } from 'node:child_process';
 import { access } from 'node:fs/promises';
 import { readJsonSafe, writeJsonAtomic } from './atomic-write.js';
 import { cursorConfigPath, defaultBinaryPath } from './paths.js';
+import { buildEntry } from './entry.js';
 const SKILL_KEY = 'skillforge';
-const NPX_PKG = '@lyupro/skillforge-mcp';
-function buildEntry(opts, binaryFallback) {
-    if (opts.entry === 'npx') {
-        return { command: 'npx', args: ['-y', NPX_PKG, 'serve'] };
-    }
-    return { command: 'node', args: [opts.binaryPath ?? binaryFallback] };
-}
 function probeCursorBinary() {
     try {
         const result = spawnSync('cursor', ['--version'], { stdio: 'ignore' });

package/dist/installers/cursor-installer.js.map

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

package/dist/installers/entry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Server-entry resolution shared by every host installer.
+ *
+ * A host config entry is a { command, args } pair the host spawns to start
+ * the SkillForge MCP server. Three entry shapes:
+ *
+ *  - 'npx'   — command=npx, args=['-y', <pkg>, 'serve']. Resolves the package
+ *              from the registry on every server spawn; needed only for a
+ *              one-shot `npx … install` run with nothing installed on disk.
+ *  - 'local' — command=node, args=[<binary>, 'serve']. Explicit binary path.
+ *  - 'auto'  — (default) inspect the installer's own on-disk location: a
+ *              stable install resolves to a node-entry on the absolute
+ *              dispatcher path (no registry round-trip, offline-safe); an
+ *              ephemeral `npx` run has no stable file to point at and falls
+ *              back to an npx-entry.
+ */
+import type { InstallOptions } from './types.js';
+/** npm package name used by the npx entry shape. */
+export declare const NPX_PKG = "@lyupro/skillforge-mcp";
+/** A host MCP server config entry — the { command, args } pair to spawn. */
+export interface ServerEntry {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+/** npx entry — registry round-trip on every server spawn. */
+export declare function npxEntry(): ServerEntry;
+/** Local node entry pointing at an absolute binary path. */
+export declare function localEntry(binary: string): ServerEntry;
+/**
+ * True when `modulePath` lives inside an npx cache directory — i.e. the
+ * installer is running from a one-shot `npx @lyupro/skillforge-mcp install`
+ * rather than a stable global / local install. npx caches each package run
+ * under a `_npx` path segment (`~/.npm/_npx/<hash>/node_modules/...`).
+ */
+export declare function isEphemeralPath(modulePath: string): boolean;
+/**
+ * Resolve the absolute path to `dist/cli/dispatcher.js` from a module URL.
+ * This file lives at <root>/(dist|src)/installers/entry.(js|ts); the
+ * dispatcher target is always <root>/dist/cli/dispatcher.js, so resolving
+ * three segments up to the package root then down works from both layouts.
+ */
+export declare function resolveDispatcherPath(moduleUrl: string): string;
+/**
+ * `--entry auto`: a stable install → a node-entry on the absolute dispatcher
+ * path; an ephemeral `npx` run → an npx-entry (no stable file to point at).
+ * `moduleUrl` is injectable so tests can exercise both branches.
+ */
+export declare function resolveAutoEntry(moduleUrl?: string): ServerEntry;
+/**
+ * Build the server entry for the requested shape. An explicit `--binary-path`
+ * forces a local entry on that path regardless of `npx` vs `auto`.
+ */
+export declare function buildEntry(opts: InstallOptions, binaryFallback: string): ServerEntry;
+//# sourceMappingURL=entry.d.ts.map

package/dist/installers/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/installers/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,oDAAoD;AACpD,eAAO,MAAM,OAAO,2BAA2B,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,IAAI,WAAW,CAEtC;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,MAAwB,GAAG,WAAW,CAIjF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,GAAG,WAAW,CAMpF"}

package/dist/installers/entry.js

@@ -0,0 +1,73 @@
+/**
+ * Server-entry resolution shared by every host installer.
+ *
+ * A host config entry is a { command, args } pair the host spawns to start
+ * the SkillForge MCP server. Three entry shapes:
+ *
+ *  - 'npx'   — command=npx, args=['-y', <pkg>, 'serve']. Resolves the package
+ *              from the registry on every server spawn; needed only for a
+ *              one-shot `npx … install` run with nothing installed on disk.
+ *  - 'local' — command=node, args=[<binary>, 'serve']. Explicit binary path.
+ *  - 'auto'  — (default) inspect the installer's own on-disk location: a
+ *              stable install resolves to a node-entry on the absolute
+ *              dispatcher path (no registry round-trip, offline-safe); an
+ *              ephemeral `npx` run has no stable file to point at and falls
+ *              back to an npx-entry.
+ */
+import { fileURLToPath } from 'node:url';
+import { resolve } from 'node:path';
+/** npm package name used by the npx entry shape. */
+export const NPX_PKG = '@lyupro/skillforge-mcp';
+/** npx entry — registry round-trip on every server spawn. */
+export function npxEntry() {
+    return { command: 'npx', args: ['-y', NPX_PKG, 'serve'] };
+}
+/** Local node entry pointing at an absolute binary path. */
+export function localEntry(binary) {
+    return { command: 'node', args: [binary, 'serve'] };
+}
+/**
+ * True when `modulePath` lives inside an npx cache directory — i.e. the
+ * installer is running from a one-shot `npx @lyupro/skillforge-mcp install`
+ * rather than a stable global / local install. npx caches each package run
+ * under a `_npx` path segment (`~/.npm/_npx/<hash>/node_modules/...`).
+ */
+export function isEphemeralPath(modulePath) {
+    return modulePath.split(/[\\/]/).includes('_npx');
+}
+/**
+ * Resolve the absolute path to `dist/cli/dispatcher.js` from a module URL.
+ * This file lives at <root>/(dist|src)/installers/entry.(js|ts); the
+ * dispatcher target is always <root>/dist/cli/dispatcher.js, so resolving
+ * three segments up to the package root then down works from both layouts.
+ */
+export function resolveDispatcherPath(moduleUrl) {
+    const here = fileURLToPath(moduleUrl);
+    return resolve(here, '..', '..', '..', 'dist', 'cli', 'dispatcher.js');
+}
+/**
+ * `--entry auto`: a stable install → a node-entry on the absolute dispatcher
+ * path; an ephemeral `npx` run → an npx-entry (no stable file to point at).
+ * `moduleUrl` is injectable so tests can exercise both branches.
+ */
+export function resolveAutoEntry(moduleUrl = import.meta.url) {
+    const here = fileURLToPath(moduleUrl);
+    if (isEphemeralPath(here))
+        return npxEntry();
+    return localEntry(resolveDispatcherPath(moduleUrl));
+}
+/**
+ * Build the server entry for the requested shape. An explicit `--binary-path`
+ * forces a local entry on that path regardless of `npx` vs `auto`.
+ */
+export function buildEntry(opts, binaryFallback) {
+    if (opts.entry === 'local')
+        return localEntry(opts.binaryPath ?? binaryFallback);
+    if (opts.entry === 'npx')
+        return npxEntry();
+    // 'auto'
+    if (opts.binaryPath !== undefined)
+        return localEntry(opts.binaryPath);
+    return resolveAutoEntry();
+}
+//# sourceMappingURL=entry.js.map

package/dist/installers/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/installers/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,oDAAoD;AACpD,MAAM,CAAC,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAShD,6DAA6D;AAC7D,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,MAAM,CAAC,IAAI,CAAC,GAAG;IAClE,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,eAAe,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,EAAE,CAAC;IAC7C,OAAO,UAAU,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAoB,EAAE,cAAsB;IACrE,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,IAAI,cAAc,CAAC,CAAC;IACjF,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,QAAQ,EAAE,CAAC;IAC5C,SAAS;IACT,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/installers/hermes-installer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hermes installer — edits the Hermes config (YAML) mcp_servers.skillforge.
+ *
+ * Hermes stores its config as YAML at ~/.hermes/config.yaml (or
+ * $HERMES_HOME/config.yaml). MCP servers live under the top-level
+ * `mcp_servers` map; an unrelated top-level `mcp:` key holds the LLM
+ * provider config and is never touched here.
+ *
+ * The config is round-tripped through the `yaml` Document API so existing
+ * entries, the `mcp:` block, and operator comments survive a load/save.
+ */
+import type { Installer, InstallOptions, InstallResult, PreviewResult, UninstallResult } from './types.js';
+export interface HermesInstallerPathOverrides {
+    configPath?: string;
+    binaryPath?: string;
+    binaryProbe?: () => boolean;
+}
+export declare class HermesInstaller implements Installer {
+    #private;
+    readonly name = "hermes";
+    constructor(overrides?: HermesInstallerPathOverrides);
+    detect(): Promise<boolean>;
+    install(opts: InstallOptions): Promise<InstallResult>;
+    uninstall(): Promise<UninstallResult>;
+    preview(opts: InstallOptions & {
+        action: 'install' | 'uninstall';
+    }): Promise<PreviewResult>;
+}
+//# sourceMappingURL=hermes-installer.d.ts.map

package/dist/installers/hermes-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-installer.d.ts","sourceRoot":"","sources":["../../src/installers/hermes-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAwDD,qBAAa,eAAgB,YAAW,SAAS;;IAC/C,QAAQ,CAAC,IAAI,YAAY;gBAKb,SAAS,GAAE,4BAAiC;IAMlD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAK1B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBrD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAcrC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;CAmBlG"}

package/dist/installers/hermes-installer.js

@@ -0,0 +1,133 @@
+/**
+ * Hermes installer — edits the Hermes config (YAML) mcp_servers.skillforge.
+ *
+ * Hermes stores its config as YAML at ~/.hermes/config.yaml (or
+ * $HERMES_HOME/config.yaml). MCP servers live under the top-level
+ * `mcp_servers` map; an unrelated top-level `mcp:` key holds the LLM
+ * provider config and is never touched here.
+ *
+ * The config is round-tripped through the `yaml` Document API so existing
+ * entries, the `mcp:` block, and operator comments survive a load/save.
+ */
+import { spawnSync } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import { Document, parseDocument } from 'yaml';
+import { readTextSafe, writeTextAtomic } from './atomic-write.js';
+import { hermesConfigPath, defaultBinaryPath } from './paths.js';
+import { buildEntry } from './entry.js';
+const SKILL_KEY = 'skillforge';
+const MCP_SERVERS_KEY = 'mcp_servers';
+// Hermes-specific connection knobs (seconds). Hermes expects these on the
+// server entry; the Claude / Codex / Cursor schemas have no such fields.
+const HERMES_TIMEOUT = 120;
+const HERMES_CONNECT_TIMEOUT = 60;
+function buildHermesEntry(opts, binaryFallback) {
+    const entry = buildEntry(opts, binaryFallback);
+    return {
+        command: entry.command,
+        args: entry.args,
+        enabled: true,
+        timeout: HERMES_TIMEOUT,
+        connect_timeout: HERMES_CONNECT_TIMEOUT,
+    };
+}
+function probeHermesBinary() {
+    try {
+        const result = spawnSync('hermes', ['--version'], { stdio: 'ignore' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse the config text into a yaml Document. An empty or missing file
+ * yields a fresh empty-map document. Corrupt YAML throws a clear error so
+ * the installer fails fast rather than overwriting a half-written file.
+ */
+function parseConfig(raw, configPath) {
+    if (raw === null || raw.trim() === '')
+        return new Document({});
+    const doc = parseDocument(raw);
+    if (doc.errors.length > 0) {
+        throw new Error(`Hermes config at "${configPath}" is not valid YAML: ${doc.errors[0].message}`);
+    }
+    return doc;
+}
+export class HermesInstaller {
+    name = 'hermes';
+    #configPath;
+    #binaryFallback;
+    #probe;
+    constructor(overrides = {}) {
+        this.#configPath = overrides.configPath ?? hermesConfigPath();
+        this.#binaryFallback = overrides.binaryPath ?? defaultBinaryPath();
+        this.#probe = overrides.binaryProbe ?? probeHermesBinary;
+    }
+    async detect() {
+        if (this.#probe())
+            return true;
+        return fileExists(this.#configPath);
+    }
+    async install(opts) {
+        const raw = await readTextSafe(this.#configPath);
+        const doc = parseConfig(raw, this.#configPath);
+        const exists = doc.hasIn([MCP_SERVERS_KEY, SKILL_KEY]);
+        if (exists && opts.force !== true) {
+            return {
+                tool: this.name,
+                status: 'already-installed',
+                configPath: this.#configPath,
+                message: `SkillForge entry already present; pass --force to overwrite`,
+            };
+        }
+        doc.setIn([MCP_SERVERS_KEY, SKILL_KEY], buildHermesEntry(opts, this.#binaryFallback));
+        await writeTextAtomic(this.#configPath, doc.toString());
+        return {
+            tool: this.name,
+            status: exists ? 'updated' : 'installed',
+            configPath: this.#configPath,
+        };
+    }
+    async uninstall() {
+        const raw = await readTextSafe(this.#configPath);
+        if (raw === null) {
+            return { tool: this.name, status: 'not-installed', configPath: this.#configPath };
+        }
+        const doc = parseConfig(raw, this.#configPath);
+        if (!doc.hasIn([MCP_SERVERS_KEY, SKILL_KEY])) {
+            return { tool: this.name, status: 'not-installed', configPath: this.#configPath };
+        }
+        doc.deleteIn([MCP_SERVERS_KEY, SKILL_KEY]);
+        await writeTextAtomic(this.#configPath, doc.toString());
+        return { tool: this.name, status: 'uninstalled', configPath: this.#configPath };
+    }
+    async preview(opts) {
+        const raw = await readTextSafe(this.#configPath);
+        const doc = parseConfig(raw, this.#configPath);
+        if (opts.action === 'install') {
+            doc.setIn([MCP_SERVERS_KEY, SKILL_KEY], buildHermesEntry(opts, this.#binaryFallback));
+        }
+        else if (doc.hasIn([MCP_SERVERS_KEY, SKILL_KEY])) {
+            doc.deleteIn([MCP_SERVERS_KEY, SKILL_KEY]);
+        }
+        return {
+            tool: this.name,
+            configPath: this.#configPath,
+            willCreate: raw === null,
+            before: raw,
+            after: doc.toString(),
+            action: opts.action,
+        };
+    }
+}
+//# sourceMappingURL=hermes-installer.js.map

package/dist/installers/hermes-installer.js.map

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

package/dist/installers/paths.d.ts

@@ -9,6 +9,7 @@ export interface PathOverrides {
     claudeConfigPath: string;
     codexConfigPath: string;
     cursorConfigPath: string;
+    hermesConfigPath: string;
     defaultBinaryPath: string;
 }
 /**
@@ -17,15 +18,17 @@ export interface PathOverrides {
  * working directory so a single repo can opt into SkillForge.
  */
 export type Scope = 'global' | 'project';
-export type HostName = 'claude' | 'codex' | 'cursor';
+export type HostName = 'claude' | 'codex' | 'cursor' | 'hermes';
 export declare function claudeConfigPath(): string;
 export declare function codexConfigPath(): string;
 export declare function cursorConfigPath(): string;
+export declare function hermesConfigPath(): string;
 export declare function defaultBinaryPath(): string;
 export declare function defaultPaths(): PathOverrides;
 export declare function claudeProjectConfigPath(projectRoot: string): string;
 export declare function codexProjectConfigPath(projectRoot: string): string;
 export declare function cursorProjectConfigPath(projectRoot: string): string;
+export declare function hermesProjectConfigPath(projectRoot: string): string;
 /**
  * Validate that `projectRoot` is a usable directory for `--scope project`.
  * Throws a clear error otherwise (caller maps this to a non-zero exit).

package/dist/installers/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/installers/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzC,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAKD,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,YAAY,IAAI,aAAa,CAO5C;AAWD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAID,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAKD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAc3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,KAAK,EACZ,WAAW,GAAE,MAAsB,GAClC,MAAM,CAUR"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/installers/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzC,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAQD,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,YAAY,IAAI,aAAa,CAQ5C;AAWD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAID,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE;AAKD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAID,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAc3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,KAAK,EACZ,WAAW,GAAE,MAAsB,GAClC,MAAM,CAYR"}

package/dist/installers/paths.js

@@ -22,20 +22,35 @@ export function codexConfigPath() {
 export function cursorConfigPath() {
     return join(homedir(), '.cursor', 'mcp.json');
 }
+// Hermes stores its config as YAML. The location honors the HERMES_HOME
+// environment variable when set (Hermes profiles / non-standard home);
+// otherwise it falls back to ~/.hermes/config.yaml. MCP servers live under
+// the top-level `mcp_servers` key — distinct from the `mcp:` provider key.
+export function hermesConfigPath() {
+    const home = process.env.HERMES_HOME;
+    if (home !== undefined && home.trim() !== '') {
+        return join(home, 'config.yaml');
+    }
+    return join(homedir(), '.hermes', 'config.yaml');
+}
 // Fallback `--entry local` target when --binary-path is not supplied.
-// Resolves to <package root>/dist/server.js via import.meta.url so the
-// path works whether the file is executed from dist/ or src/ (tsx).
+// Resolves to <package root>/dist/cli/dispatcher.js via import.meta.url so
+// the path works whether the file is executed from dist/ or src/ (tsx).
+// dispatcher.js is the single CLI entry point — invoked with `serve` it
+// starts the MCP stdio server. (The legacy dist/server.js path was retired
+// when the dispatcher landed.)
 export function defaultBinaryPath() {
     const here = fileURLToPath(import.meta.url);
     // here = <root>/(dist|src)/installers/paths.(js|ts)
-    // Resolve up three segments to reach the package root, then dist/server.js.
-    return resolve(here, '..', '..', '..', 'dist', 'server.js');
+    // Resolve up three segments to the package root, then dist/cli/dispatcher.js.
+    return resolve(here, '..', '..', '..', 'dist', 'cli', 'dispatcher.js');
 }
 export function defaultPaths() {
     return {
         claudeConfigPath: claudeConfigPath(),
         codexConfigPath: codexConfigPath(),
         cursorConfigPath: cursorConfigPath(),
+        hermesConfigPath: hermesConfigPath(),
         defaultBinaryPath: defaultBinaryPath(),
     };
 }
@@ -61,6 +76,11 @@ export function codexProjectConfigPath(projectRoot) {
 export function cursorProjectConfigPath(projectRoot) {
     return join(projectRoot, '.cursor', 'mcp.json');
 }
+// Hermes reads project-local config from `.hermes/config.yaml` at the repo
+// root, the same YAML `mcp_servers` shape as the global `~/.hermes/config.yaml`.
+export function hermesProjectConfigPath(projectRoot) {
+    return join(projectRoot, '.hermes', 'config.yaml');
+}
 /**
  * Validate that `projectRoot` is a usable directory for `--scope project`.
  * Throws a clear error otherwise (caller maps this to a non-zero exit).
@@ -90,13 +110,17 @@ export function resolveConfigPath(host, scope, projectRoot = process.cwd()) {
             return claudeConfigPath();
         if (host === 'codex')
             return codexConfigPath();
-        return cursorConfigPath();
+        if (host === 'cursor')
+            return cursorConfigPath();
+        return hermesConfigPath();
     }
     assertProjectRoot(projectRoot);
     if (host === 'claude')
         return claudeProjectConfigPath(projectRoot);
     if (host === 'codex')
         return codexProjectConfigPath(projectRoot);
-    return cursorProjectConfigPath(projectRoot);
+    if (host === 'cursor')
+        return cursorProjectConfigPath(projectRoot);
+    return hermesProjectConfigPath(projectRoot);
 }
 //# sourceMappingURL=paths.js.map

package/dist/installers/paths.js.map

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

package/dist/installers/registry.d.ts

@@ -1,6 +1,7 @@
 /**
- * Installer registry — stable enumeration of the three host installers
- * consumed by the `--all` dispatcher and by --claude / --codex / --cursor.
+ * Installer registry — stable enumeration of the four host installers
+ * consumed by the `--all` dispatcher and by --claude / --codex / --cursor /
+ * --hermes.
  */
 import { type HostName, type Scope } from './paths.js';
 import type { Installer } from './types.js';

package/dist/installers/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/installers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,KAAK,GAAE,KAAgB,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,CAKX;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,KAAgB,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,EAAE,CAIb"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/installers/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,KAAK,GAAE,KAAgB,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,CAMX;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,GAAE,KAAgB,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,SAAS,EAAE,CAIb"}

package/dist/installers/registry.js

@@ -1,10 +1,12 @@
 /**
- * Installer registry — stable enumeration of the three host installers
- * consumed by the `--all` dispatcher and by --claude / --codex / --cursor.
+ * Installer registry — stable enumeration of the four host installers
+ * consumed by the `--all` dispatcher and by --claude / --codex / --cursor /
+ * --hermes.
  */
 import { ClaudeInstaller } from './claude-installer.js';
 import { CodexInstaller } from './codex-installer.js';
 import { CursorInstaller } from './cursor-installer.js';
+import { HermesInstaller } from './hermes-installer.js';
 import { resolveConfigPath } from './paths.js';
 /**
  * Build a single installer for `host`, with its config path resolved for the
@@ -17,9 +19,11 @@ export function getInstallerByName(name, scope = 'global', projectRoot) {
         return new ClaudeInstaller({ configPath });
     if (name === 'codex')
         return new CodexInstaller({ configPath });
-    return new CursorInstaller({ configPath });
+    if (name === 'cursor')
+        return new CursorInstaller({ configPath });
+    return new HermesInstaller({ configPath });
 }
 export function getAllInstallers(scope = 'global', projectRoot) {
-    return ['claude', 'codex', 'cursor'].map((name) => getInstallerByName(name, scope, projectRoot));
+    return ['claude', 'codex', 'cursor', 'hermes'].map((name) => getInstallerByName(name, scope, projectRoot));
 }
 //# sourceMappingURL=registry.js.map

package/dist/installers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/installers/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAA6B,MAAM,YAAY,CAAC;AAG1E;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAc,EACd,QAAe,QAAQ,EACvB,WAAoB;IAEpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAChE,OAAO,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAe,QAAQ,EACvB,WAAoB;IAEpB,OAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3D,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/installers/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAA6B,MAAM,YAAY,CAAC;AAG1E;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAc,EACd,QAAe,QAAQ,EACvB,WAAoB;IAEpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAChE,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,OAAO,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAe,QAAQ,EACvB,WAAoB;IAEpB,OAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrE,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,CAC7C,CAAC;AACJ,CAAC"}

package/dist/installers/types.d.ts

@@ -5,7 +5,7 @@
  * implementing this contract so the CLI dispatcher can iterate them
  * uniformly under `--all`, `--dry-run`, and `--uninstall`.
  */
-export type EntryKind = 'npx' | 'local';
+export type EntryKind = 'npx' | 'local' | 'auto';
 export interface InstallOptions {
     entry: EntryKind;
     binaryPath?: string;

package/dist/installers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/installers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,mBAAmB,GACnB,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,eAAe,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7F"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/installers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,mBAAmB,GACnB,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,eAAe,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7F"}

package/dist/server.d.ts

@@ -1,12 +1,20 @@
-#!/usr/bin/env node
 /**
- * SkillForge MCP — stdio entry point.
+ * SkillForge MCP — server module.
  *
- * buildServer() and buildDeps() are exported for integration tests so the
- * same wiring is exercised in-process without spawning a subprocess.
+ * Exports the server wiring: buildServer() + buildDeps() (also used by the
+ * integration tests for in-process exercise) and startServer(), the single
+ * server-start sequence. This file is a pure module — it is never run
+ * directly; the canonical entry point is dist/cli/dispatcher.js (`serve`).
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ServerDeps } from './server-deps.js';
 export declare function buildServer(deps: ServerDeps): McpServer;
 export declare function buildDeps(): Promise<ServerDeps>;
+/**
+ * Start the MCP stdio server: build deps, register tools, connect the stdio
+ * transport, then start the runtime watchers and shutdown handlers. This is
+ * the single server-start sequence — the dispatcher's `serve` command calls
+ * it, and nothing else does.
+ */
+export declare function startServer(): Promise<void>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAmGvD;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CA8ErD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAmGvD;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CA8ErD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}