@akon-labs/nexus-cli 0.1.9 → 0.1.11-rc.2

package/dist/extensions/mcp/onboarding-state.js

@@ -0,0 +1,65 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { getAgentPath } from "./agent-dir.js";
+const DEFAULT_STATE = {
+    version: 1,
+    sharedConfigHintShown: false,
+    setupCompleted: false,
+};
+export function getOnboardingStatePath() {
+    return getAgentPath("mcp-onboarding.json");
+}
+export function loadOnboardingState() {
+    const path = getOnboardingStatePath();
+    if (!existsSync(path))
+        return { ...DEFAULT_STATE };
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf-8"));
+        if (!raw || typeof raw !== "object")
+            return { ...DEFAULT_STATE };
+        return {
+            version: 1,
+            sharedConfigHintShown: raw.sharedConfigHintShown === true,
+            setupCompleted: raw.setupCompleted === true,
+            ...(typeof raw.lastDiscoveryFingerprint === "string"
+                ? { lastDiscoveryFingerprint: raw.lastDiscoveryFingerprint }
+                : {}),
+        };
+    }
+    catch {
+        return { ...DEFAULT_STATE };
+    }
+}
+export function saveOnboardingState(state) {
+    const path = getOnboardingStatePath();
+    mkdirSync(dirname(path), { recursive: true });
+    const tmpPath = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmpPath, `${JSON.stringify(state, null, 2)}\n`, "utf-8");
+    renameSync(tmpPath, path);
+}
+export function updateOnboardingState(updater) {
+    const next = updater(loadOnboardingState());
+    saveOnboardingState(next);
+    return next;
+}
+export function markSharedConfigHintShown(fingerprint) {
+    return updateOnboardingState((state) => {
+        const lastDiscoveryFingerprint = fingerprint ?? state.lastDiscoveryFingerprint;
+        return {
+            ...state,
+            sharedConfigHintShown: true,
+            ...(lastDiscoveryFingerprint !== undefined ? { lastDiscoveryFingerprint } : {}),
+        };
+    });
+}
+export function markSetupCompleted(fingerprint) {
+    return updateOnboardingState((state) => {
+        const lastDiscoveryFingerprint = fingerprint ?? state.lastDiscoveryFingerprint;
+        return {
+            ...state,
+            setupCompleted: true,
+            ...(lastDiscoveryFingerprint !== undefined ? { lastDiscoveryFingerprint } : {}),
+        };
+    });
+}
+//# sourceMappingURL=onboarding-state.js.map

package/dist/extensions/mcp/onboarding-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-state.js","sourceRoot":"","sources":["../../../src/extensions/mcp/onboarding-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { getAgentPath } from \"./agent-dir.ts\";\n\nexport interface McpOnboardingState {\n\tversion: 1;\n\tsharedConfigHintShown: boolean;\n\tsetupCompleted: boolean;\n\tlastDiscoveryFingerprint?: string;\n}\n\nconst DEFAULT_STATE: McpOnboardingState = {\n\tversion: 1,\n\tsharedConfigHintShown: false,\n\tsetupCompleted: false,\n};\n\nexport function getOnboardingStatePath(): string {\n\treturn getAgentPath(\"mcp-onboarding.json\");\n}\n\nexport function loadOnboardingState(): McpOnboardingState {\n\tconst path = getOnboardingStatePath();\n\tif (!existsSync(path)) return { ...DEFAULT_STATE };\n\n\ttry {\n\t\tconst raw = JSON.parse(readFileSync(path, \"utf-8\")) as Partial<McpOnboardingState>;\n\t\tif (!raw || typeof raw !== \"object\") return { ...DEFAULT_STATE };\n\t\treturn {\n\t\t\tversion: 1,\n\t\t\tsharedConfigHintShown: raw.sharedConfigHintShown === true,\n\t\t\tsetupCompleted: raw.setupCompleted === true,\n\t\t\t...(typeof raw.lastDiscoveryFingerprint === \"string\"\n\t\t\t\t? { lastDiscoveryFingerprint: raw.lastDiscoveryFingerprint }\n\t\t\t\t: {}),\n\t\t};\n\t} catch {\n\t\treturn { ...DEFAULT_STATE };\n\t}\n}\n\nexport function saveOnboardingState(state: McpOnboardingState): void {\n\tconst path = getOnboardingStatePath();\n\tmkdirSync(dirname(path), { recursive: true });\n\tconst tmpPath = `${path}.${process.pid}.tmp`;\n\twriteFileSync(tmpPath, `${JSON.stringify(state, null, 2)}\\n`, \"utf-8\");\n\trenameSync(tmpPath, path);\n}\n\nexport function updateOnboardingState(updater: (state: McpOnboardingState) => McpOnboardingState): McpOnboardingState {\n\tconst next = updater(loadOnboardingState());\n\tsaveOnboardingState(next);\n\treturn next;\n}\n\nexport function markSharedConfigHintShown(fingerprint?: string): McpOnboardingState {\n\treturn updateOnboardingState((state) => {\n\t\tconst lastDiscoveryFingerprint = fingerprint ?? state.lastDiscoveryFingerprint;\n\t\treturn {\n\t\t\t...state,\n\t\t\tsharedConfigHintShown: true,\n\t\t\t...(lastDiscoveryFingerprint !== undefined ? { lastDiscoveryFingerprint } : {}),\n\t\t};\n\t});\n}\n\nexport function markSetupCompleted(fingerprint?: string): McpOnboardingState {\n\treturn updateOnboardingState((state) => {\n\t\tconst lastDiscoveryFingerprint = fingerprint ?? state.lastDiscoveryFingerprint;\n\t\treturn {\n\t\t\t...state,\n\t\t\tsetupCompleted: true,\n\t\t\t...(lastDiscoveryFingerprint !== undefined ? { lastDiscoveryFingerprint } : {}),\n\t\t};\n\t});\n}\n"]}

package/dist/extensions/mcp/package-mcp-loader.d.ts

@@ -0,0 +1,3 @@
+import type { McpConfig } from "./types.ts";
+export declare function loadPackageMcpConfigs(cwd?: string, includeProject?: boolean): McpConfig;
+//# sourceMappingURL=package-mcp-loader.d.ts.map

package/dist/extensions/mcp/package-mcp-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-mcp-loader.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/package-mcp-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAWzD,wBAAgB,qBAAqB,CAAC,GAAG,SAAgB,EAAE,cAAc,UAAO,GAAG,SAAS,CAmC3F","sourcesContent":["import { existsSync, readFileSync, realpathSync, statSync } from \"node:fs\";\nimport { isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport stripJsonComments from \"strip-json-comments\";\nimport { getAgentDir, getConfigDirName } from \"./agent-dir.ts\";\nimport type { McpConfig, ServerEntry } from \"./types.ts\";\n\ninterface PackageSetting {\n\tsource: string;\n}\n\ninterface PackageManifest {\n\tname?: unknown;\n\tnexus?: { mcp?: unknown };\n}\n\nexport function loadPackageMcpConfigs(cwd = process.cwd(), includeProject = true): McpConfig {\n\tconst mcpServers: Record<string, ServerEntry> = {};\n\tconst seen = new Set<string>();\n\n\tfor (const packageRoot of getConfiguredPackageRoots(cwd, includeProject)) {\n\t\tconst manifest = readPackageManifest(packageRoot);\n\t\tif (!manifest || typeof manifest.name !== \"string\" || !manifest.name) continue;\n\t\tconst paths = getManifestMcpPaths(manifest.nexus?.mcp, manifest.name);\n\t\tif (!paths) continue;\n\n\t\tconst packagePrefix = formatPackageName(manifest.name);\n\t\tconst packageServers = new Set<string>();\n\t\tfor (const path of paths) {\n\t\t\tconst configPath = resolvePackageConfigPath(packageRoot, path);\n\t\t\tif (!configPath) {\n\t\t\t\tconsole.warn(`Nexus package ${manifest.name} skips MCP config ${path}: file must stay inside the package`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst config = readMcpConfig(configPath, manifest.name);\n\t\t\tif (!config) continue;\n\t\t\tfor (const [serverName, server] of Object.entries(config.mcpServers)) {\n\t\t\t\tconst normalizedName = `${packagePrefix}__${formatServerName(serverName)}`;\n\t\t\t\tif (packageServers.has(normalizedName) || seen.has(normalizedName)) {\n\t\t\t\t\tconsole.warn(`Nexus package ${manifest.name} skips duplicate normalized MCP server ${normalizedName}`);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tpackageServers.add(normalizedName);\n\t\t\t\tseen.add(normalizedName);\n\t\t\t\tmcpServers[normalizedName] = server;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { mcpServers };\n}\n\nfunction getConfiguredPackageRoots(cwd: string, includeProject: boolean): string[] {\n\tconst roots: string[] = [];\n\tconst settingsSources: Array<readonly [string, \"project\" | \"user\"]> = [\n\t\t[join(getAgentDir(), \"settings.json\"), \"user\"],\n\t];\n\tif (includeProject) settingsSources.unshift([join(cwd, getConfigDirName(), \"settings.json\"), \"project\"]);\n\tfor (const [settingsPath, scope] of settingsSources) {\n\t\tconst settings = readOptionalJson(settingsPath, `${scope} Nexus settings`);\n\t\tif (settings === undefined) continue;\n\t\tif (typeof settings !== \"object\" || settings === null || Array.isArray(settings)) {\n\t\t\tthrow new Error(`${scope} Nexus settings ${settingsPath} must be a JSON object`);\n\t\t}\n\t\tconst packages = (settings as { packages?: unknown }).packages;\n\t\tif (packages === undefined) continue;\n\t\tif (!Array.isArray(packages))\n\t\t\tthrow new Error(`${scope} Nexus settings ${settingsPath} packages must be an array`);\n\t\tfor (const entry of packages) {\n\t\t\tconst source =\n\t\t\t\ttypeof entry === \"string\"\n\t\t\t\t\t? entry\n\t\t\t\t\t: entry &&\n\t\t\t\t\t\t\ttypeof entry === \"object\" &&\n\t\t\t\t\t\t\t!Array.isArray(entry) &&\n\t\t\t\t\t\t\ttypeof (entry as PackageSetting).source === \"string\"\n\t\t\t\t\t\t? (entry as PackageSetting).source\n\t\t\t\t\t\t: undefined;\n\t\t\tif (!source)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`${scope} Nexus settings ${settingsPath} package entries must be strings or objects with a string source`,\n\t\t\t\t);\n\t\t\tconst root = resolvePackageRoot(source, scope, cwd);\n\t\t\tif (root && !roots.includes(root)) roots.push(root);\n\t\t}\n\t}\n\treturn roots;\n}\n\nfunction resolvePackageRoot(source: string, scope: \"user\" | \"project\", cwd: string): string | null {\n\tconst baseDir = scope === \"user\" ? getAgentDir() : join(cwd, getConfigDirName());\n\tif (source.startsWith(\"npm:\")) {\n\t\tconst name = source\n\t\t\t.slice(4)\n\t\t\t.trim()\n\t\t\t.match(/^(@?[^@]+(?:\\/[^@]+)?)/)?.[1];\n\t\treturn name ? resolveContainedPath(join(baseDir, \"npm\", \"node_modules\"), name) : null;\n\t}\n\tconst gitSource = source.startsWith(\"git:\")\n\t\t? source.slice(4).trim()\n\t\t: /^(?:(?:https?|ssh):\\/\\/|git@[^:]+:)/.test(source)\n\t\t\t? source\n\t\t\t: null;\n\tif (gitSource) {\n\t\tconst value = gitSource\n\t\t\t.replace(/^ssh:\\/\\/git@/, \"\")\n\t\t\t.replace(/^git@([^:]+):/, \"$1/\")\n\t\t\t.replace(/^[a-z]+:\\/\\//i, \"\");\n\t\tconst path = value.replace(/@[^/]+$/, \"\").replace(/\\.git$/, \"\");\n\t\treturn path && !path.startsWith(\"/\") ? resolveContainedPath(join(baseDir, \"git\"), path) : null;\n\t}\n\treturn isAbsolute(source) ? resolve(source) : resolve(baseDir, source);\n}\n\nfunction readPackageManifest(packageRoot: string): PackageManifest | null {\n\tconst manifest = readOptionalJson(join(packageRoot, \"package.json\"), `Nexus package manifest ${packageRoot}`);\n\treturn manifest && typeof manifest === \"object\" && !Array.isArray(manifest) ? (manifest as PackageManifest) : null;\n}\n\nfunction getManifestMcpPaths(value: unknown, packageName: string): string[] | null {\n\tconst paths =\n\t\ttypeof value === \"string\"\n\t\t\t? [value]\n\t\t\t: Array.isArray(value) && value.every((path): path is string => typeof path === \"string\")\n\t\t\t\t? value\n\t\t\t\t: null;\n\tif (value !== undefined && !paths)\n\t\tconsole.warn(`Nexus package ${packageName} ignores invalid nexus.mcp manifest entry`);\n\treturn paths;\n}\n\nfunction readMcpConfig(path: string, packageName: string): McpConfig | null {\n\tconst config = readRequiredJson(path, `Nexus package ${packageName} MCP config`);\n\tif (!config || typeof config !== \"object\" || Array.isArray(config)) {\n\t\tthrow new Error(`Nexus package ${packageName} MCP config ${path} must be a JSON object`);\n\t}\n\tconst servers = (config as { mcpServers?: unknown }).mcpServers;\n\tif (!servers || typeof servers !== \"object\" || Array.isArray(servers)) {\n\t\tthrow new Error(`Nexus package ${packageName} MCP config ${path} must contain a JSON object mcpServers field`);\n\t}\n\tconst mcpServers: Record<string, ServerEntry> = {};\n\tfor (const [name, server] of Object.entries(servers)) {\n\t\tif (!server || typeof server !== \"object\" || Array.isArray(server)) {\n\t\t\tthrow new Error(`Nexus package ${packageName} MCP config ${path} server ${name} must be a JSON object`);\n\t\t}\n\t\tmcpServers[name] = server as ServerEntry;\n\t}\n\treturn { mcpServers };\n}\n\nfunction readRequiredJson(path: string, description: string): unknown {\n\ttry {\n\t\treturn JSON.parse(stripJsonComments(readFileSync(path, \"utf8\"), { trailingCommas: true }));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`${description} ${path} contains invalid JSON: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\nfunction readOptionalJson(path: string, description: string): unknown | undefined {\n\tif (!existsSync(path)) return undefined;\n\treturn readRequiredJson(path, description);\n}\n\nfunction resolveContainedPath(root: string, path: string): string | null {\n\tconst resolved = resolve(root, path);\n\tconst rel = relative(root, resolved);\n\treturn rel === \"\" || (!rel.startsWith(\"..\") && !rel.startsWith(sep) && !isAbsolute(rel)) ? resolved : null;\n}\n\nfunction resolvePackageConfigPath(packageRoot: string, path: string): string | null {\n\tconst lexicalPath = resolveContainedPath(packageRoot, path);\n\tif (!lexicalPath || !existsSync(lexicalPath) || !statSync(lexicalPath).isFile()) return null;\n\ttry {\n\t\tconst realPackageRoot = realpathSync(packageRoot);\n\t\tconst realConfigPath = realpathSync(lexicalPath);\n\t\treturn resolveContainedPath(realPackageRoot, realConfigPath);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction formatPackageName(name: string): string {\n\treturn name.replace(/[^A-Za-z0-9_-]+/g, \"_\").replace(/^[_-]+|[_-]+$/g, \"\") || \"package\";\n}\n\nfunction formatServerName(name: string): string {\n\treturn name.replace(/[^A-Za-z0-9_-]+/g, \"_\").replace(/^[_-]+|[_-]+$/g, \"\") || \"server\";\n}\n"]}

package/dist/extensions/mcp/package-mcp-loader.js

@@ -0,0 +1,170 @@
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import stripJsonComments from "strip-json-comments";
+import { getAgentDir, getConfigDirName } from "./agent-dir.js";
+export function loadPackageMcpConfigs(cwd = process.cwd(), includeProject = true) {
+    const mcpServers = {};
+    const seen = new Set();
+    for (const packageRoot of getConfiguredPackageRoots(cwd, includeProject)) {
+        const manifest = readPackageManifest(packageRoot);
+        if (!manifest || typeof manifest.name !== "string" || !manifest.name)
+            continue;
+        const paths = getManifestMcpPaths(manifest.nexus?.mcp, manifest.name);
+        if (!paths)
+            continue;
+        const packagePrefix = formatPackageName(manifest.name);
+        const packageServers = new Set();
+        for (const path of paths) {
+            const configPath = resolvePackageConfigPath(packageRoot, path);
+            if (!configPath) {
+                console.warn(`Nexus package ${manifest.name} skips MCP config ${path}: file must stay inside the package`);
+                continue;
+            }
+            const config = readMcpConfig(configPath, manifest.name);
+            if (!config)
+                continue;
+            for (const [serverName, server] of Object.entries(config.mcpServers)) {
+                const normalizedName = `${packagePrefix}__${formatServerName(serverName)}`;
+                if (packageServers.has(normalizedName) || seen.has(normalizedName)) {
+                    console.warn(`Nexus package ${manifest.name} skips duplicate normalized MCP server ${normalizedName}`);
+                    continue;
+                }
+                packageServers.add(normalizedName);
+                seen.add(normalizedName);
+                mcpServers[normalizedName] = server;
+            }
+        }
+    }
+    return { mcpServers };
+}
+function getConfiguredPackageRoots(cwd, includeProject) {
+    const roots = [];
+    const settingsSources = [
+        [join(getAgentDir(), "settings.json"), "user"],
+    ];
+    if (includeProject)
+        settingsSources.unshift([join(cwd, getConfigDirName(), "settings.json"), "project"]);
+    for (const [settingsPath, scope] of settingsSources) {
+        const settings = readOptionalJson(settingsPath, `${scope} Nexus settings`);
+        if (settings === undefined)
+            continue;
+        if (typeof settings !== "object" || settings === null || Array.isArray(settings)) {
+            throw new Error(`${scope} Nexus settings ${settingsPath} must be a JSON object`);
+        }
+        const packages = settings.packages;
+        if (packages === undefined)
+            continue;
+        if (!Array.isArray(packages))
+            throw new Error(`${scope} Nexus settings ${settingsPath} packages must be an array`);
+        for (const entry of packages) {
+            const source = typeof entry === "string"
+                ? entry
+                : entry &&
+                    typeof entry === "object" &&
+                    !Array.isArray(entry) &&
+                    typeof entry.source === "string"
+                    ? entry.source
+                    : undefined;
+            if (!source)
+                throw new Error(`${scope} Nexus settings ${settingsPath} package entries must be strings or objects with a string source`);
+            const root = resolvePackageRoot(source, scope, cwd);
+            if (root && !roots.includes(root))
+                roots.push(root);
+        }
+    }
+    return roots;
+}
+function resolvePackageRoot(source, scope, cwd) {
+    const baseDir = scope === "user" ? getAgentDir() : join(cwd, getConfigDirName());
+    if (source.startsWith("npm:")) {
+        const name = source
+            .slice(4)
+            .trim()
+            .match(/^(@?[^@]+(?:\/[^@]+)?)/)?.[1];
+        return name ? resolveContainedPath(join(baseDir, "npm", "node_modules"), name) : null;
+    }
+    const gitSource = source.startsWith("git:")
+        ? source.slice(4).trim()
+        : /^(?:(?:https?|ssh):\/\/|git@[^:]+:)/.test(source)
+            ? source
+            : null;
+    if (gitSource) {
+        const value = gitSource
+            .replace(/^ssh:\/\/git@/, "")
+            .replace(/^git@([^:]+):/, "$1/")
+            .replace(/^[a-z]+:\/\//i, "");
+        const path = value.replace(/@[^/]+$/, "").replace(/\.git$/, "");
+        return path && !path.startsWith("/") ? resolveContainedPath(join(baseDir, "git"), path) : null;
+    }
+    return isAbsolute(source) ? resolve(source) : resolve(baseDir, source);
+}
+function readPackageManifest(packageRoot) {
+    const manifest = readOptionalJson(join(packageRoot, "package.json"), `Nexus package manifest ${packageRoot}`);
+    return manifest && typeof manifest === "object" && !Array.isArray(manifest) ? manifest : null;
+}
+function getManifestMcpPaths(value, packageName) {
+    const paths = typeof value === "string"
+        ? [value]
+        : Array.isArray(value) && value.every((path) => typeof path === "string")
+            ? value
+            : null;
+    if (value !== undefined && !paths)
+        console.warn(`Nexus package ${packageName} ignores invalid nexus.mcp manifest entry`);
+    return paths;
+}
+function readMcpConfig(path, packageName) {
+    const config = readRequiredJson(path, `Nexus package ${packageName} MCP config`);
+    if (!config || typeof config !== "object" || Array.isArray(config)) {
+        throw new Error(`Nexus package ${packageName} MCP config ${path} must be a JSON object`);
+    }
+    const servers = config.mcpServers;
+    if (!servers || typeof servers !== "object" || Array.isArray(servers)) {
+        throw new Error(`Nexus package ${packageName} MCP config ${path} must contain a JSON object mcpServers field`);
+    }
+    const mcpServers = {};
+    for (const [name, server] of Object.entries(servers)) {
+        if (!server || typeof server !== "object" || Array.isArray(server)) {
+            throw new Error(`Nexus package ${packageName} MCP config ${path} server ${name} must be a JSON object`);
+        }
+        mcpServers[name] = server;
+    }
+    return { mcpServers };
+}
+function readRequiredJson(path, description) {
+    try {
+        return JSON.parse(stripJsonComments(readFileSync(path, "utf8"), { trailingCommas: true }));
+    }
+    catch (error) {
+        throw new Error(`${description} ${path} contains invalid JSON: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+}
+function readOptionalJson(path, description) {
+    if (!existsSync(path))
+        return undefined;
+    return readRequiredJson(path, description);
+}
+function resolveContainedPath(root, path) {
+    const resolved = resolve(root, path);
+    const rel = relative(root, resolved);
+    return rel === "" || (!rel.startsWith("..") && !rel.startsWith(sep) && !isAbsolute(rel)) ? resolved : null;
+}
+function resolvePackageConfigPath(packageRoot, path) {
+    const lexicalPath = resolveContainedPath(packageRoot, path);
+    if (!lexicalPath || !existsSync(lexicalPath) || !statSync(lexicalPath).isFile())
+        return null;
+    try {
+        const realPackageRoot = realpathSync(packageRoot);
+        const realConfigPath = realpathSync(lexicalPath);
+        return resolveContainedPath(realPackageRoot, realConfigPath);
+    }
+    catch {
+        return null;
+    }
+}
+function formatPackageName(name) {
+    return name.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || "package";
+}
+function formatServerName(name) {
+    return name.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || "server";
+}
+//# sourceMappingURL=package-mcp-loader.js.map

package/dist/extensions/mcp/package-mcp-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-mcp-loader.js","sourceRoot":"","sources":["../../../src/extensions/mcp/package-mcp-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, realpathSync, statSync } from \"node:fs\";\nimport { isAbsolute, join, relative, resolve, sep } from \"node:path\";\nimport stripJsonComments from \"strip-json-comments\";\nimport { getAgentDir, getConfigDirName } from \"./agent-dir.ts\";\nimport type { McpConfig, ServerEntry } from \"./types.ts\";\n\ninterface PackageSetting {\n\tsource: string;\n}\n\ninterface PackageManifest {\n\tname?: unknown;\n\tnexus?: { mcp?: unknown };\n}\n\nexport function loadPackageMcpConfigs(cwd = process.cwd(), includeProject = true): McpConfig {\n\tconst mcpServers: Record<string, ServerEntry> = {};\n\tconst seen = new Set<string>();\n\n\tfor (const packageRoot of getConfiguredPackageRoots(cwd, includeProject)) {\n\t\tconst manifest = readPackageManifest(packageRoot);\n\t\tif (!manifest || typeof manifest.name !== \"string\" || !manifest.name) continue;\n\t\tconst paths = getManifestMcpPaths(manifest.nexus?.mcp, manifest.name);\n\t\tif (!paths) continue;\n\n\t\tconst packagePrefix = formatPackageName(manifest.name);\n\t\tconst packageServers = new Set<string>();\n\t\tfor (const path of paths) {\n\t\t\tconst configPath = resolvePackageConfigPath(packageRoot, path);\n\t\t\tif (!configPath) {\n\t\t\t\tconsole.warn(`Nexus package ${manifest.name} skips MCP config ${path}: file must stay inside the package`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst config = readMcpConfig(configPath, manifest.name);\n\t\t\tif (!config) continue;\n\t\t\tfor (const [serverName, server] of Object.entries(config.mcpServers)) {\n\t\t\t\tconst normalizedName = `${packagePrefix}__${formatServerName(serverName)}`;\n\t\t\t\tif (packageServers.has(normalizedName) || seen.has(normalizedName)) {\n\t\t\t\t\tconsole.warn(`Nexus package ${manifest.name} skips duplicate normalized MCP server ${normalizedName}`);\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tpackageServers.add(normalizedName);\n\t\t\t\tseen.add(normalizedName);\n\t\t\t\tmcpServers[normalizedName] = server;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { mcpServers };\n}\n\nfunction getConfiguredPackageRoots(cwd: string, includeProject: boolean): string[] {\n\tconst roots: string[] = [];\n\tconst settingsSources: Array<readonly [string, \"project\" | \"user\"]> = [\n\t\t[join(getAgentDir(), \"settings.json\"), \"user\"],\n\t];\n\tif (includeProject) settingsSources.unshift([join(cwd, getConfigDirName(), \"settings.json\"), \"project\"]);\n\tfor (const [settingsPath, scope] of settingsSources) {\n\t\tconst settings = readOptionalJson(settingsPath, `${scope} Nexus settings`);\n\t\tif (settings === undefined) continue;\n\t\tif (typeof settings !== \"object\" || settings === null || Array.isArray(settings)) {\n\t\t\tthrow new Error(`${scope} Nexus settings ${settingsPath} must be a JSON object`);\n\t\t}\n\t\tconst packages = (settings as { packages?: unknown }).packages;\n\t\tif (packages === undefined) continue;\n\t\tif (!Array.isArray(packages))\n\t\t\tthrow new Error(`${scope} Nexus settings ${settingsPath} packages must be an array`);\n\t\tfor (const entry of packages) {\n\t\t\tconst source =\n\t\t\t\ttypeof entry === \"string\"\n\t\t\t\t\t? entry\n\t\t\t\t\t: entry &&\n\t\t\t\t\t\t\ttypeof entry === \"object\" &&\n\t\t\t\t\t\t\t!Array.isArray(entry) &&\n\t\t\t\t\t\t\ttypeof (entry as PackageSetting).source === \"string\"\n\t\t\t\t\t\t? (entry as PackageSetting).source\n\t\t\t\t\t\t: undefined;\n\t\t\tif (!source)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`${scope} Nexus settings ${settingsPath} package entries must be strings or objects with a string source`,\n\t\t\t\t);\n\t\t\tconst root = resolvePackageRoot(source, scope, cwd);\n\t\t\tif (root && !roots.includes(root)) roots.push(root);\n\t\t}\n\t}\n\treturn roots;\n}\n\nfunction resolvePackageRoot(source: string, scope: \"user\" | \"project\", cwd: string): string | null {\n\tconst baseDir = scope === \"user\" ? getAgentDir() : join(cwd, getConfigDirName());\n\tif (source.startsWith(\"npm:\")) {\n\t\tconst name = source\n\t\t\t.slice(4)\n\t\t\t.trim()\n\t\t\t.match(/^(@?[^@]+(?:\\/[^@]+)?)/)?.[1];\n\t\treturn name ? resolveContainedPath(join(baseDir, \"npm\", \"node_modules\"), name) : null;\n\t}\n\tconst gitSource = source.startsWith(\"git:\")\n\t\t? source.slice(4).trim()\n\t\t: /^(?:(?:https?|ssh):\\/\\/|git@[^:]+:)/.test(source)\n\t\t\t? source\n\t\t\t: null;\n\tif (gitSource) {\n\t\tconst value = gitSource\n\t\t\t.replace(/^ssh:\\/\\/git@/, \"\")\n\t\t\t.replace(/^git@([^:]+):/, \"$1/\")\n\t\t\t.replace(/^[a-z]+:\\/\\//i, \"\");\n\t\tconst path = value.replace(/@[^/]+$/, \"\").replace(/\\.git$/, \"\");\n\t\treturn path && !path.startsWith(\"/\") ? resolveContainedPath(join(baseDir, \"git\"), path) : null;\n\t}\n\treturn isAbsolute(source) ? resolve(source) : resolve(baseDir, source);\n}\n\nfunction readPackageManifest(packageRoot: string): PackageManifest | null {\n\tconst manifest = readOptionalJson(join(packageRoot, \"package.json\"), `Nexus package manifest ${packageRoot}`);\n\treturn manifest && typeof manifest === \"object\" && !Array.isArray(manifest) ? (manifest as PackageManifest) : null;\n}\n\nfunction getManifestMcpPaths(value: unknown, packageName: string): string[] | null {\n\tconst paths =\n\t\ttypeof value === \"string\"\n\t\t\t? [value]\n\t\t\t: Array.isArray(value) && value.every((path): path is string => typeof path === \"string\")\n\t\t\t\t? value\n\t\t\t\t: null;\n\tif (value !== undefined && !paths)\n\t\tconsole.warn(`Nexus package ${packageName} ignores invalid nexus.mcp manifest entry`);\n\treturn paths;\n}\n\nfunction readMcpConfig(path: string, packageName: string): McpConfig | null {\n\tconst config = readRequiredJson(path, `Nexus package ${packageName} MCP config`);\n\tif (!config || typeof config !== \"object\" || Array.isArray(config)) {\n\t\tthrow new Error(`Nexus package ${packageName} MCP config ${path} must be a JSON object`);\n\t}\n\tconst servers = (config as { mcpServers?: unknown }).mcpServers;\n\tif (!servers || typeof servers !== \"object\" || Array.isArray(servers)) {\n\t\tthrow new Error(`Nexus package ${packageName} MCP config ${path} must contain a JSON object mcpServers field`);\n\t}\n\tconst mcpServers: Record<string, ServerEntry> = {};\n\tfor (const [name, server] of Object.entries(servers)) {\n\t\tif (!server || typeof server !== \"object\" || Array.isArray(server)) {\n\t\t\tthrow new Error(`Nexus package ${packageName} MCP config ${path} server ${name} must be a JSON object`);\n\t\t}\n\t\tmcpServers[name] = server as ServerEntry;\n\t}\n\treturn { mcpServers };\n}\n\nfunction readRequiredJson(path: string, description: string): unknown {\n\ttry {\n\t\treturn JSON.parse(stripJsonComments(readFileSync(path, \"utf8\"), { trailingCommas: true }));\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`${description} ${path} contains invalid JSON: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\nfunction readOptionalJson(path: string, description: string): unknown | undefined {\n\tif (!existsSync(path)) return undefined;\n\treturn readRequiredJson(path, description);\n}\n\nfunction resolveContainedPath(root: string, path: string): string | null {\n\tconst resolved = resolve(root, path);\n\tconst rel = relative(root, resolved);\n\treturn rel === \"\" || (!rel.startsWith(\"..\") && !rel.startsWith(sep) && !isAbsolute(rel)) ? resolved : null;\n}\n\nfunction resolvePackageConfigPath(packageRoot: string, path: string): string | null {\n\tconst lexicalPath = resolveContainedPath(packageRoot, path);\n\tif (!lexicalPath || !existsSync(lexicalPath) || !statSync(lexicalPath).isFile()) return null;\n\ttry {\n\t\tconst realPackageRoot = realpathSync(packageRoot);\n\t\tconst realConfigPath = realpathSync(lexicalPath);\n\t\treturn resolveContainedPath(realPackageRoot, realConfigPath);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction formatPackageName(name: string): string {\n\treturn name.replace(/[^A-Za-z0-9_-]+/g, \"_\").replace(/^[_-]+|[_-]+$/g, \"\") || \"package\";\n}\n\nfunction formatServerName(name: string): string {\n\treturn name.replace(/[^A-Za-z0-9_-]+/g, \"_\").replace(/^[_-]+|[_-]+$/g, \"\") || \"server\";\n}\n"]}

package/dist/extensions/mcp/panel-keys.d.ts

@@ -0,0 +1,21 @@
+import { type KeyId } from "@earendil-works/pi-tui";
+/** The panel keybinding ids the adapter panels resolve through nexus-tui. */
+export type PanelSelectKeybinding = "tui.select.up" | "tui.select.down" | "tui.select.confirm";
+/** Structural subset of nexus-tui's `KeybindingsManager` (which satisfies it). */
+export interface PanelKeybindings {
+    matches(data: string, keybinding: PanelSelectKeybinding): boolean;
+    getUserBindings?(): Record<string, KeyId | KeyId[] | undefined>;
+}
+/**
+ * Key matchers for panel actions: user bindings when a manager is provided,
+ * otherwise the previous hardcoded defaults.
+ */
+export interface PanelKeys {
+    selectUp(data: string): boolean;
+    selectDown(data: string): boolean;
+    selectConfirm(data: string): boolean;
+    save(data: string): boolean;
+    saveLabel(): string | null;
+}
+export declare function createPanelKeys(keybindings?: PanelKeybindings): PanelKeys;
+//# sourceMappingURL=panel-keys.d.ts.map

package/dist/extensions/mcp/panel-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-keys.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/panel-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAc,MAAM,wBAAwB,CAAC;AAEhE,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAE/F,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAClE,eAAe,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;CAC3B;AAQD,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAqBzE","sourcesContent":["import { type KeyId, matchesKey } from \"@earendil-works/pi-tui\";\n\n/** The panel keybinding ids the adapter panels resolve through nexus-tui. */\nexport type PanelSelectKeybinding = \"tui.select.up\" | \"tui.select.down\" | \"tui.select.confirm\";\n\n/** Structural subset of nexus-tui's `KeybindingsManager` (which satisfies it). */\nexport interface PanelKeybindings {\n\tmatches(data: string, keybinding: PanelSelectKeybinding): boolean;\n\tgetUserBindings?(): Record<string, KeyId | KeyId[] | undefined>;\n}\n\n/**\n * Key matchers for panel actions: user bindings when a manager is provided,\n * otherwise the previous hardcoded defaults.\n */\nexport interface PanelKeys {\n\tselectUp(data: string): boolean;\n\tselectDown(data: string): boolean;\n\tselectConfirm(data: string): boolean;\n\tsave(data: string): boolean;\n\tsaveLabel(): string | null;\n}\n\nfunction configuredSaveKeys(keybindings?: PanelKeybindings): { keys: KeyId[]; configured: boolean } {\n\tconst explicit = keybindings?.getUserBindings?.()[\"mcp.panel.save\"];\n\tif (explicit !== undefined) return { keys: Array.isArray(explicit) ? explicit : [explicit], configured: true };\n\treturn { keys: [], configured: false };\n}\n\nexport function createPanelKeys(keybindings?: PanelKeybindings): PanelKeys {\n\tconst saveBinding = configuredSaveKeys(keybindings);\n\tif (keybindings) {\n\t\treturn {\n\t\t\tselectUp: (data) => keybindings.matches(data, \"tui.select.up\"),\n\t\t\tselectDown: (data) => keybindings.matches(data, \"tui.select.down\"),\n\t\t\tselectConfirm: (data) => keybindings.matches(data, \"tui.select.confirm\"),\n\t\t\tsave: (data) =>\n\t\t\t\tsaveBinding.keys.length > 0\n\t\t\t\t\t? saveBinding.keys.some((key) => matchesKey(data, key))\n\t\t\t\t\t: !saveBinding.configured && matchesKey(data, \"ctrl+s\"),\n\t\t\tsaveLabel: () => saveBinding.keys[0] ?? (saveBinding.configured ? null : \"ctrl+s\"),\n\t\t};\n\t}\n\treturn {\n\t\tselectUp: (data) => matchesKey(data, \"up\"),\n\t\tselectDown: (data) => matchesKey(data, \"down\"),\n\t\tselectConfirm: (data) => matchesKey(data, \"return\"),\n\t\tsave: (data) => matchesKey(data, \"ctrl+s\"),\n\t\tsaveLabel: () => \"ctrl+s\",\n\t};\n}\n"]}

package/dist/extensions/mcp/panel-keys.js

@@ -0,0 +1,29 @@
+import { matchesKey } from "@earendil-works/pi-tui";
+function configuredSaveKeys(keybindings) {
+    const explicit = keybindings?.getUserBindings?.()["mcp.panel.save"];
+    if (explicit !== undefined)
+        return { keys: Array.isArray(explicit) ? explicit : [explicit], configured: true };
+    return { keys: [], configured: false };
+}
+export function createPanelKeys(keybindings) {
+    const saveBinding = configuredSaveKeys(keybindings);
+    if (keybindings) {
+        return {
+            selectUp: (data) => keybindings.matches(data, "tui.select.up"),
+            selectDown: (data) => keybindings.matches(data, "tui.select.down"),
+            selectConfirm: (data) => keybindings.matches(data, "tui.select.confirm"),
+            save: (data) => saveBinding.keys.length > 0
+                ? saveBinding.keys.some((key) => matchesKey(data, key))
+                : !saveBinding.configured && matchesKey(data, "ctrl+s"),
+            saveLabel: () => saveBinding.keys[0] ?? (saveBinding.configured ? null : "ctrl+s"),
+        };
+    }
+    return {
+        selectUp: (data) => matchesKey(data, "up"),
+        selectDown: (data) => matchesKey(data, "down"),
+        selectConfirm: (data) => matchesKey(data, "return"),
+        save: (data) => matchesKey(data, "ctrl+s"),
+        saveLabel: () => "ctrl+s",
+    };
+}
+//# sourceMappingURL=panel-keys.js.map

package/dist/extensions/mcp/panel-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-keys.js","sourceRoot":"","sources":["../../../src/extensions/mcp/panel-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAuBhE,SAAS,kBAAkB,CAAC,WAA8B,EAA0C;IACnG,MAAM,QAAQ,GAAG,WAAW,EAAE,eAAe,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;IACpE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC/G,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAAA,CACvC;AAED,MAAM,UAAU,eAAe,CAAC,WAA8B,EAAa;IAC1E,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO;YACN,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;YAC9D,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC;YAClE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC;YACxE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CACd,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBAC1B,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACvD,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;YACzD,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;SAClF,CAAC;IACH,CAAC;IACD,OAAO;QACN,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;QAC1C,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;QAC9C,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;QACnD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC1C,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ;KACzB,CAAC;AAAA,CACF","sourcesContent":["import { type KeyId, matchesKey } from \"@earendil-works/pi-tui\";\n\n/** The panel keybinding ids the adapter panels resolve through nexus-tui. */\nexport type PanelSelectKeybinding = \"tui.select.up\" | \"tui.select.down\" | \"tui.select.confirm\";\n\n/** Structural subset of nexus-tui's `KeybindingsManager` (which satisfies it). */\nexport interface PanelKeybindings {\n\tmatches(data: string, keybinding: PanelSelectKeybinding): boolean;\n\tgetUserBindings?(): Record<string, KeyId | KeyId[] | undefined>;\n}\n\n/**\n * Key matchers for panel actions: user bindings when a manager is provided,\n * otherwise the previous hardcoded defaults.\n */\nexport interface PanelKeys {\n\tselectUp(data: string): boolean;\n\tselectDown(data: string): boolean;\n\tselectConfirm(data: string): boolean;\n\tsave(data: string): boolean;\n\tsaveLabel(): string | null;\n}\n\nfunction configuredSaveKeys(keybindings?: PanelKeybindings): { keys: KeyId[]; configured: boolean } {\n\tconst explicit = keybindings?.getUserBindings?.()[\"mcp.panel.save\"];\n\tif (explicit !== undefined) return { keys: Array.isArray(explicit) ? explicit : [explicit], configured: true };\n\treturn { keys: [], configured: false };\n}\n\nexport function createPanelKeys(keybindings?: PanelKeybindings): PanelKeys {\n\tconst saveBinding = configuredSaveKeys(keybindings);\n\tif (keybindings) {\n\t\treturn {\n\t\t\tselectUp: (data) => keybindings.matches(data, \"tui.select.up\"),\n\t\t\tselectDown: (data) => keybindings.matches(data, \"tui.select.down\"),\n\t\t\tselectConfirm: (data) => keybindings.matches(data, \"tui.select.confirm\"),\n\t\t\tsave: (data) =>\n\t\t\t\tsaveBinding.keys.length > 0\n\t\t\t\t\t? saveBinding.keys.some((key) => matchesKey(data, key))\n\t\t\t\t\t: !saveBinding.configured && matchesKey(data, \"ctrl+s\"),\n\t\t\tsaveLabel: () => saveBinding.keys[0] ?? (saveBinding.configured ? null : \"ctrl+s\"),\n\t\t};\n\t}\n\treturn {\n\t\tselectUp: (data) => matchesKey(data, \"up\"),\n\t\tselectDown: (data) => matchesKey(data, \"down\"),\n\t\tselectConfirm: (data) => matchesKey(data, \"return\"),\n\t\tsave: (data) => matchesKey(data, \"ctrl+s\"),\n\t\tsaveLabel: () => \"ctrl+s\",\n\t};\n}\n"]}

package/dist/extensions/mcp/prompts.d.ts

@@ -0,0 +1,63 @@
+import type { GetPromptResult } from "@modelcontextprotocol/client";
+import type { ExtensionAPI, ExtensionCommandContext } from "../../core/extensions/types.ts";
+import type { McpExtensionState } from "./state.ts";
+import { formatPromptCommandName, type McpConfig, type PromptMetadata } from "./types.ts";
+/**
+ * Resolve prompt metadata for slash-command registration at extension load
+ * time. Mirrors `resolveDirectTools`: reads the persistent metadata cache so
+ * commands are available before any server connects.
+ */
+export declare function resolveCachedPrompts(config: McpConfig): PromptMetadata[];
+/**
+ * Parse a slash-command argument string into positional and named MCP prompt
+ * arguments. Supports bash-style quoting so callers can pass values with
+ * spaces:
+ *
+ *   /mcp__demo__brief today "important tasks"
+ *   /mcp__demo__brief day=today topic="important tasks"
+ */
+export declare function parsePromptArgs(input: string): {
+    positional: string[];
+    named: Record<string, string>;
+};
+export interface ResolvedPromptArgs {
+    ok: boolean;
+    /** Present when `ok === true`. */
+    args?: Record<string, string>;
+    /** Present when `ok === false`. */
+    error?: string;
+}
+/**
+ * Map positional and named arguments onto the prompt's declared argument
+ * list. Named arguments win over positional when both target the same slot.
+ * Missing required arguments produce a helpful usage message that the
+ * command handler surfaces via `ctx.ui.notify`.
+ */
+export declare function resolvePromptArgs(metadata: PromptMetadata, parsed: {
+    positional: string[];
+    named: Record<string, string>;
+}): ResolvedPromptArgs;
+/**
+ * Flatten a `GetPromptResult` into a single string suitable for
+ * `nexus.sendUserMessage`. MCP prompts can contain multiple messages with
+ * mixed roles; we preserve role attribution as inline markers so the model
+ * still sees the intended conversational shape without needing a
+ * multi-message replay API on the nexus side.
+ */
+export declare function formatPromptResult(result: GetPromptResult): string;
+/**
+ * Build the nexus command definition for a single MCP prompt. Registered once
+ * per prompt at extension load time from the metadata cache; the same
+ * factory is reused by tests to invoke the handler without a running nexus.
+ */
+export declare function createPromptCommand(nexus: ExtensionAPI, getState: () => McpExtensionState | null, metadata: PromptMetadata): {
+    description: string;
+    handler: (args: string, ctx: ExtensionCommandContext) => Promise<void>;
+};
+/**
+ * Public helper used by `/mcp prompts` to render the list of prompts known
+ * to the adapter, whether from a live connection or the metadata cache.
+ */
+export declare function listAllPromptMetadata(state: McpExtensionState): PromptMetadata[];
+export { formatPromptCommandName };
+//# sourceMappingURL=prompts.d.ts.map

package/dist/extensions/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/extensions/mcp/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,8BAA8B,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAI5F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAoB,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5G;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,EAAE,CAexE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAmBtG;AA+DD,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7D,kBAAkB,CAyBpB;AAQD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAYlE;AA2BD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,iBAAiB,GAAG,IAAI,EACxC,QAAQ,EAAE,cAAc;;;EA8FxB;AAeD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAKhF;AAID,OAAO,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["import type { GetPromptResult, PromptMessage } from \"@modelcontextprotocol/client\";\nimport type { ExtensionAPI, ExtensionCommandContext } from \"../../core/extensions/types.ts\";\nimport { lazyConnect } from \"./init.ts\";\nimport { logger } from \"./logger.ts\";\nimport { isServerCacheValid, loadMetadataCache, reconstructPromptMetadata } from \"./metadata-cache.ts\";\nimport type { McpExtensionState } from \"./state.ts\";\nimport { formatPromptCommandName, isServerDisabled, type McpConfig, type PromptMetadata } from \"./types.ts\";\nimport { truncateAtWord } from \"./utils.ts\";\n\n/**\n * Resolve prompt metadata for slash-command registration at extension load\n * time. Mirrors `resolveDirectTools`: reads the persistent metadata cache so\n * commands are available before any server connects.\n */\nexport function resolveCachedPrompts(config: McpConfig): PromptMetadata[] {\n\tconst cache = loadMetadataCache();\n\tif (!cache?.servers) return [];\n\n\tconst prefix = config.settings?.toolPrefix ?? \"server\";\n\tconst specs: PromptMetadata[] = [];\n\n\tfor (const [serverName, entry] of Object.entries(cache.servers)) {\n\t\tconst definition = config.mcpServers[serverName];\n\t\tif (!definition || isServerDisabled(definition)) continue;\n\t\tif (!entry?.prompts?.length || !isServerCacheValid(entry, definition)) continue;\n\t\tspecs.push(...reconstructPromptMetadata(serverName, entry.prompts, prefix, definition));\n\t}\n\n\treturn specs;\n}\n\n/**\n * Parse a slash-command argument string into positional and named MCP prompt\n * arguments. Supports bash-style quoting so callers can pass values with\n * spaces:\n *\n *   /mcp__demo__brief today \"important tasks\"\n *   /mcp__demo__brief day=today topic=\"important tasks\"\n */\nexport function parsePromptArgs(input: string): { positional: string[]; named: Record<string, string> } {\n\tconst positional: string[] = [];\n\tconst named: Record<string, string> = {};\n\n\tconst tokens = tokenizeArgs(input);\n\tfor (const token of tokens) {\n\t\tconst eq = findUnquotedEquals(token);\n\t\tif (eq > 0) {\n\t\t\tconst key = token.slice(0, eq).trim();\n\t\t\tconst value = stripQuotes(token.slice(eq + 1).trim());\n\t\t\tif (key) {\n\t\t\t\tnamed[key] = value;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tpositional.push(stripQuotes(token));\n\t}\n\n\treturn { positional, named };\n}\n\nfunction tokenizeArgs(input: string): string[] {\n\tconst tokens: string[] = [];\n\tlet current = \"\";\n\tlet quote: '\"' | \"'\" | null = null;\n\tlet escaped = false;\n\n\tfor (const char of input) {\n\t\tif (escaped) {\n\t\t\tcurrent += char;\n\t\t\tescaped = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (char === \"\\\\\" && quote !== \"'\") {\n\t\t\tescaped = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (quote) {\n\t\t\tcurrent += char;\n\t\t\tif (char === quote) quote = null;\n\t\t\tcontinue;\n\t\t}\n\t\tif (char === '\"' || char === \"'\") {\n\t\t\tquote = char;\n\t\t\tcurrent += char;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(char)) {\n\t\t\tif (current.length > 0) {\n\t\t\t\ttokens.push(current);\n\t\t\t\tcurrent = \"\";\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tcurrent += char;\n\t}\n\n\tif (current.length > 0) tokens.push(current);\n\treturn tokens;\n}\n\nfunction findUnquotedEquals(token: string): number {\n\tlet quote: '\"' | \"'\" | null = null;\n\tfor (let i = 0; i < token.length; i++) {\n\t\tconst ch = token[i];\n\t\tif (quote) {\n\t\t\tif (ch === quote) quote = null;\n\t\t\tcontinue;\n\t\t}\n\t\tif (ch === '\"' || ch === \"'\") quote = ch;\n\t\telse if (ch === \"=\") return i;\n\t}\n\treturn -1;\n}\n\nfunction stripQuotes(value: string): string {\n\tif (value.length >= 2 && (value.startsWith('\"') || value.startsWith(\"'\")) && value.endsWith(value.charAt(0))) {\n\t\treturn value.slice(1, -1);\n\t}\n\treturn value;\n}\n\nexport interface ResolvedPromptArgs {\n\tok: boolean;\n\t/** Present when `ok === true`. */\n\targs?: Record<string, string>;\n\t/** Present when `ok === false`. */\n\terror?: string;\n}\n\n/**\n * Map positional and named arguments onto the prompt's declared argument\n * list. Named arguments win over positional when both target the same slot.\n * Missing required arguments produce a helpful usage message that the\n * command handler surfaces via `ctx.ui.notify`.\n */\nexport function resolvePromptArgs(\n\tmetadata: PromptMetadata,\n\tparsed: { positional: string[]; named: Record<string, string> },\n): ResolvedPromptArgs {\n\tconst args: Record<string, string> = {};\n\n\tconst declared = metadata.arguments;\n\tlet positionalIndex = 0;\n\tfor (const argDef of declared) {\n\t\tconst value = parsed.named[argDef.name] ?? parsed.positional[positionalIndex++];\n\t\tif (value !== undefined && value !== \"\") {\n\t\t\targs[argDef.name] = value;\n\t\t}\n\t}\n\n\t// Preserve named arguments the prompt did not declare so servers with\n\t// permissive schemas still receive them. The MCP spec allows arbitrary\n\t// string key/values in `prompts/get` params.arguments.\n\tfor (const [key, value] of Object.entries(parsed.named)) {\n\t\tif (!(key in args)) args[key] = value;\n\t}\n\n\tconst missing = declared.filter((a) => a.required && (args[a.name] === undefined || args[a.name] === \"\"));\n\tif (missing.length > 0) {\n\t\treturn { ok: false, error: buildUsageMessage(metadata, missing) };\n\t}\n\n\treturn { ok: true, args };\n}\n\nfunction buildUsageMessage(metadata: PromptMetadata, missing: PromptMetadata[\"arguments\"]): string {\n\tconst usage = metadata.arguments.map((a) => (a.required ? `<${a.name}>` : `[${a.name}]`)).join(\" \");\n\tconst missingList = missing.map((a) => a.name).join(\", \");\n\treturn `Missing required argument${missing.length > 1 ? \"s\" : \"\"}: ${missingList}.\\nUsage: /${metadata.commandName} ${usage}`.trim();\n}\n\n/**\n * Flatten a `GetPromptResult` into a single string suitable for\n * `nexus.sendUserMessage`. MCP prompts can contain multiple messages with\n * mixed roles; we preserve role attribution as inline markers so the model\n * still sees the intended conversational shape without needing a\n * multi-message replay API on the nexus side.\n */\nexport function formatPromptResult(result: GetPromptResult): string {\n\tconst lines: string[] = [];\n\tfor (const message of result.messages) {\n\t\tconst text = extractMessageText(message);\n\t\tif (!text) continue;\n\t\tif (message.role === \"user\" && result.messages.length === 1) {\n\t\t\tlines.push(text);\n\t\t} else {\n\t\t\tlines.push(`[${message.role}] ${text}`);\n\t\t}\n\t}\n\treturn lines.join(\"\\n\\n\").trim();\n}\n\nfunction extractMessageText(message: PromptMessage): string {\n\tconst content = message.content;\n\tif (!content || typeof content !== \"object\") return \"\";\n\tswitch (content.type) {\n\t\tcase \"text\":\n\t\t\treturn content.text ?? \"\";\n\t\tcase \"resource\": {\n\t\t\tconst resource = content.resource;\n\t\t\tif (!resource) return \"\";\n\t\t\tif (\"text\" in resource && typeof resource.text === \"string\") {\n\t\t\t\treturn `[resource ${resource.uri}]\\n${resource.text}`;\n\t\t\t}\n\t\t\treturn `[resource ${resource.uri}]`;\n\t\t}\n\t\tcase \"resource_link\":\n\t\t\treturn `[resource_link ${content.uri ?? \"\"}${content.name ? ` — ${content.name}` : \"\"}]`;\n\t\tcase \"image\":\n\t\t\treturn `[image ${content.mimeType ?? \"unknown\"}${content.data ? \" (embedded)\" : \"\"}]`;\n\t\tcase \"audio\":\n\t\t\treturn `[audio ${content.mimeType ?? \"unknown\"}]`;\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\n/**\n * Build the nexus command definition for a single MCP prompt. Registered once\n * per prompt at extension load time from the metadata cache; the same\n * factory is reused by tests to invoke the handler without a running nexus.\n */\nexport function createPromptCommand(\n\tnexus: ExtensionAPI,\n\tgetState: () => McpExtensionState | null,\n\tmetadata: PromptMetadata,\n) {\n\tconst description = buildCommandDescription(metadata);\n\n\treturn {\n\t\tdescription,\n\t\thandler: async (args: string, ctx: ExtensionCommandContext) => {\n\t\t\tconst state = getState();\n\t\t\tif (!state) {\n\t\t\t\tif (ctx.hasUI) ctx.ui.notify(\"MCP not initialized\", \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst liveMetadata = findLivePromptMetadata(state, metadata.serverName, metadata.originalName);\n\t\t\tif (state.promptMetadataLive?.has(metadata.serverName) && !liveMetadata) {\n\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\tctx.ui.notify(\n\t\t\t\t\t\t`MCP prompt \"${metadata.originalName}\" is no longer advertised by server \"${metadata.serverName}\". Run /mcp reconnect to refresh.`,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst live = liveMetadata ?? metadata;\n\t\t\tconst parsed = parsePromptArgs(args ?? \"\");\n\t\t\tconst resolved = resolvePromptArgs(live, parsed);\n\t\t\tif (!resolved.ok) {\n\t\t\t\tif (ctx.hasUI) ctx.ui.notify(resolved.error ?? \"Invalid prompt arguments\", \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst promptArgs = resolved.args ?? {};\n\n\t\t\tif (!state.config.mcpServers[metadata.serverName]) {\n\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\tctx.ui.notify(\n\t\t\t\t\t\t`MCP prompt \"${live.originalName}\" is no longer configured. Run /mcp reconnect to refresh.`,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst connected = await lazyConnect(state, metadata.serverName, ctx.signal);\n\t\t\tif (!connected) {\n\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\tconst conn = state.manager.getConnection(metadata.serverName);\n\t\t\t\t\tconst message =\n\t\t\t\t\t\tconn?.status === \"needs-auth\"\n\t\t\t\t\t\t\t? `MCP server \"${metadata.serverName}\" needs authentication. Run /mcp-auth ${metadata.serverName}.`\n\t\t\t\t\t\t\t: `MCP server \"${metadata.serverName}\" is not available. Run /mcp reconnect ${metadata.serverName}.`;\n\t\t\t\t\tctx.ui.notify(message, \"error\");\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst refreshed = findLivePromptMetadata(state, metadata.serverName, metadata.originalName);\n\t\t\tif (state.promptMetadataLive?.has(metadata.serverName) && !refreshed) {\n\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\tctx.ui.notify(\n\t\t\t\t\t\t`MCP prompt \"${metadata.originalName}\" is no longer advertised by server \"${metadata.serverName}\". Run /mcp reconnect to refresh.`,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst dispatchMetadata = refreshed ?? live;\n\t\t\tlet result: GetPromptResult;\n\t\t\ttry {\n\t\t\t\tresult = await state.manager.getPrompt(\n\t\t\t\t\tmetadata.serverName,\n\t\t\t\t\tdispatchMetadata.originalName,\n\t\t\t\t\tObject.keys(promptArgs).length > 0 ? promptArgs : undefined,\n\t\t\t\t\tctx.signal,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tlogger.debug(`MCP prompt \"${live.originalName}\" on ${metadata.serverName} failed: ${message}`);\n\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\tctx.ui.notify(`MCP prompt \"${live.originalName}\" failed: ${message}`, \"error\");\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst text = formatPromptResult(result);\n\t\t\tif (!text) {\n\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\tctx.ui.notify(`MCP prompt \"${live.originalName}\" returned no text content.`, \"warning\");\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tnexus.sendUserMessage(text);\n\t\t},\n\t};\n}\n\nfunction findLivePromptMetadata(\n\tstate: McpExtensionState,\n\tserverName: string,\n\toriginalName: string,\n): PromptMetadata | undefined {\n\treturn state.promptMetadata?.get(serverName)?.find((p) => p.originalName === originalName);\n}\n\nfunction buildCommandDescription(metadata: PromptMetadata): string {\n\tconst base = metadata.description || metadata.title || `MCP prompt from ${metadata.serverName}`;\n\treturn truncateAtWord(`MCP: ${base}`, 120) || `MCP prompt from ${metadata.serverName}`;\n}\n\n/**\n * Public helper used by `/mcp prompts` to render the list of prompts known\n * to the adapter, whether from a live connection or the metadata cache.\n */\nexport function listAllPromptMetadata(state: McpExtensionState): PromptMetadata[] {\n\tconst flat: PromptMetadata[] = [];\n\tfor (const list of state.promptMetadata?.values() ?? []) flat.push(...list);\n\tflat.sort((a, b) => a.commandName.localeCompare(b.commandName));\n\treturn flat;\n}\n\n// Re-exported so index.ts can format cache-only prompt-command names without\n// duplicating the namespace logic.\nexport { formatPromptCommandName };\n"]}