kubeview-mcp 1.2.0 → 1.3.0

package/dist/agent/codegen/CodegenManager.js

@@ -0,0 +1,222 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import ts from 'typescript';
+import { SchemaToTypeScriptMapper } from './SchemaToTypeScriptMapper.js';
+const DEFAULT_OPTIONS = {
+    outputDir: path.resolve(process.cwd(), 'generated/servers'),
+    runtimeImportPath: '../../runtime/callMCPTool.ts',
+    manifestPath: path.resolve(process.cwd(), 'generated/servers/manifest.json'),
+};
+export class CodegenManager {
+    introspector;
+    mapper = new SchemaToTypeScriptMapper();
+    printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+    options;
+    constructor(introspector, options) {
+        this.introspector = introspector;
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    async generate() {
+        const summaries = this.introspector.collectToolSchemas();
+        if (!summaries.length) {
+            return;
+        }
+        await fs.mkdir(this.options.outputDir, { recursive: true });
+        await this.ensureRuntimeHelpers();
+        const grouped = this.groupByServer(summaries);
+        for (const [server, tools] of grouped.entries()) {
+            const serverDir = path.join(this.options.outputDir, server);
+            await fs.rm(serverDir, { recursive: true, force: true });
+            await fs.mkdir(serverDir, { recursive: true });
+            await Promise.all(tools.map((tool) => this.writeToolFile(serverDir, server, tool)));
+            await this.writeServerIndex(serverDir, tools);
+        }
+        await this.writeRootIndex(Array.from(grouped.keys()));
+        await this.writeManifest(grouped);
+    }
+    groupByServer(summaries) {
+        const grouped = new Map();
+        for (const summary of summaries) {
+            if (!grouped.has(summary.server)) {
+                grouped.set(summary.server, []);
+            }
+            grouped.get(summary.server).push(summary);
+        }
+        return grouped;
+    }
+    async writeToolFile(baseDir, _server, tool) {
+        const statements = [];
+        statements.push(this.createRuntimeImport());
+        const pascalName = this.toPascalCase(tool.toolName);
+        const inputTypeName = `${pascalName}Input`;
+        const resultTypeName = `${pascalName}Result`;
+        statements.push(this.mapper.createTypeAliasDeclaration(inputTypeName, tool.inputSchema));
+        statements.push(this.mapper.createTypeAliasDeclaration(resultTypeName, undefined));
+        statements.push(this.createToolFunction(tool, inputTypeName, resultTypeName));
+        const content = this.printStatements(statements);
+        const filePath = path.join(baseDir, `${tool.toolName}.ts`);
+        await fs.writeFile(filePath, content, 'utf-8');
+    }
+    createRuntimeImport() {
+        const importPath = this.options.runtimeImportPath ?? DEFAULT_OPTIONS.runtimeImportPath;
+        return ts.factory.createImportDeclaration(undefined, ts.factory.createImportClause(false, undefined, ts.factory.createNamedImports([
+            ts.factory.createImportSpecifier(false, undefined, ts.factory.createIdentifier('callMCPTool')),
+        ])), ts.factory.createStringLiteral(importPath), undefined);
+    }
+    createToolFunction(tool, inputTypeName, resultTypeName) {
+        const docComment = tool.description
+            ? ts.factory.createJSDocComment(tool.description)
+            : undefined;
+        const fn = ts.factory.createFunctionDeclaration([ts.factory.createModifier(ts.SyntaxKind.ExportKeyword)], undefined, ts.factory.createIdentifier(this.toCamelCase(tool.toolName)), undefined, [
+            ts.factory.createParameterDeclaration(undefined, undefined, ts.factory.createIdentifier('input'), undefined, ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(inputTypeName)), undefined),
+        ], ts.factory.createTypeReferenceNode(ts.factory.createIdentifier('Promise'), [
+            ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(resultTypeName)),
+        ]), ts.factory.createBlock([
+            ts.factory.createReturnStatement(ts.factory.createCallExpression(ts.factory.createIdentifier('callMCPTool'), [ts.factory.createTypeReferenceNode(ts.factory.createIdentifier(resultTypeName))], [
+                ts.factory.createStringLiteral(tool.qualifiedName),
+                ts.factory.createIdentifier('input'),
+            ])),
+        ], true));
+        if (docComment) {
+            ts.addSyntheticLeadingComment(fn, ts.SyntaxKind.MultiLineCommentTrivia, `*\n * ${tool.description}\n `, true);
+        }
+        return fn;
+    }
+    async writeServerIndex(serverDir, tools) {
+        const statements = tools.map((tool) => ts.factory.createExportDeclaration(undefined, false, ts.factory.createNamedExports([
+            ts.factory.createExportSpecifier(false, undefined, ts.factory.createIdentifier(this.toCamelCase(tool.toolName))),
+        ]), ts.factory.createStringLiteral(`./${tool.toolName}.ts`), undefined));
+        const content = this.printStatements(statements);
+        await fs.writeFile(path.join(serverDir, 'index.ts'), content, 'utf-8');
+    }
+    async writeRootIndex(servers) {
+        const statements = servers.map((server) => ts.factory.createExportDeclaration(undefined, false, undefined, ts.factory.createStringLiteral(`./${server}/index.ts`), undefined));
+        const content = this.printStatements(statements);
+        await fs.writeFile(path.join(this.options.outputDir, 'index.ts'), content, 'utf-8');
+    }
+    async writeManifest(grouped) {
+        const manifest = Array.from(grouped.entries()).map(([server, tools]) => ({
+            server,
+            tools: tools.map((tool) => ({
+                name: tool.toolName,
+                qualifiedName: tool.qualifiedName,
+                description: tool.description,
+                inputSchema: tool.inputSchema, // Include full schema for runtime introspection
+            })),
+        }));
+        if (!this.options.manifestPath)
+            return;
+        await fs.writeFile(this.options.manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+    }
+    async ensureRuntimeHelpers() {
+        const runtimeDir = path.resolve(this.options.outputDir, '../runtime');
+        await fs.mkdir(runtimeDir, { recursive: true });
+        const filePath = path.join(runtimeDir, 'callMCPTool.ts');
+        const content = `declare global {
+  // eslint-disable-next-line no-var
+  var __callMCPTool: ((qualifiedName: string, args: unknown) => Promise<unknown>) | undefined;
+}
+
+export async function callMCPTool<T = unknown>(qualifiedName: string, args: unknown): Promise<T> {
+  if (typeof globalThis.__callMCPTool !== 'function') {
+    throw new Error('callMCPTool bridge not initialized');
+  }
+  const fn = globalThis.__callMCPTool as (name: string, params: unknown) => Promise<T>;
+  return fn(qualifiedName, args);
+}
+`;
+        await fs.writeFile(filePath, content, 'utf-8');
+        const searchHelperPath = path.join(runtimeDir, 'toolSearch.ts');
+        const searchContent = `import manifest from '../servers/manifest.json';
+
+export interface ToolManifestEntry {
+  server: string;
+  name: string;
+  qualifiedName: string;
+  description?: string;
+}
+
+const tools: ToolManifestEntry[] = manifest.flatMap((serverEntry) =>
+  serverEntry.tools.map((tool) => ({
+    server: serverEntry.server,
+    ...tool,
+  })),
+);
+
+export function listServers(): string[] {
+  return manifest.map((entry) => entry.server);
+}
+
+export function listTools(server?: string): ToolManifestEntry[] {
+  if (!server) return tools;
+  return tools.filter((tool) => tool.server === server);
+}
+
+export function searchTools(query: string, limit = 10): ToolManifestEntry[] {
+  const normalized = query.toLowerCase();
+  return tools
+    .filter(
+      (tool) =>
+        tool.name.toLowerCase().includes(normalized) ||
+        (tool.description ?? '').toLowerCase().includes(normalized),
+    )
+    .slice(0, limit);
+}
+`;
+        await fs.writeFile(searchHelperPath, searchContent, 'utf-8');
+        const workspaceHelperPath = path.join(runtimeDir, 'workspaceFs.ts');
+        const workspaceContent = `declare global {
+  // eslint-disable-next-line no-var
+  var __workspaceFs:
+    | {
+        readFile(path: string): Promise<string>;
+        writeFile(path: string, data: string): Promise<void>;
+        listDir(path?: string): Promise<string[]>;
+        exists(path: string): Promise<boolean>;
+      }
+    | undefined;
+}
+
+function ensureWorkspaceFs() {
+  if (!globalThis.__workspaceFs) {
+    throw new Error('Workspace filesystem bridge not initialized');
+  }
+  return globalThis.__workspaceFs;
+}
+
+export async function readWorkspaceFile(path: string): Promise<string> {
+  return ensureWorkspaceFs().readFile(path);
+}
+
+export async function writeWorkspaceFile(path: string, data: string): Promise<void> {
+  return ensureWorkspaceFs().writeFile(path, data);
+}
+
+export async function listWorkspaceDir(path?: string): Promise<string[]> {
+  return ensureWorkspaceFs().listDir(path);
+}
+
+export async function workspacePathExists(path: string): Promise<boolean> {
+  return ensureWorkspaceFs().exists(path);
+}
+`;
+        await fs.writeFile(workspaceHelperPath, workspaceContent, 'utf-8');
+    }
+    printStatements(statements) {
+        const sourceFile = ts.createSourceFile('temp.ts', '', ts.ScriptTarget.ES2020, false, ts.ScriptKind.TS);
+        return statements
+            .map((statement) => this.printer.printNode(ts.EmitHint.Unspecified, statement, sourceFile))
+            .join('\n\n');
+    }
+    toPascalCase(value) {
+        return value
+            .replace(/[_-]+/g, ' ')
+            .replace(/(?:^\w|[A-Z]|\b\w)/g, (word) => word.toUpperCase())
+            .replace(/\s+/g, '');
+    }
+    toCamelCase(value) {
+        const pascal = this.toPascalCase(value);
+        return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+    }
+}
+//# sourceMappingURL=CodegenManager.js.map

package/dist/agent/codegen/CodegenManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodegenManager.js","sourceRoot":"","sources":["../../../src/agent/codegen/CodegenManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AASzE,MAAM,eAAe,GAA0B;IAC7C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC;IAC3D,iBAAiB,EAAE,8BAA8B;IACjD,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iCAAiC,CAAC;CAC7E,CAAC;AAEF,MAAM,OAAO,cAAc;IAMN;IALF,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAC;IACxC,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,OAAO,CAAwB;IAEhD,YACmB,YAAoC,EACrD,OAAwC;QADvB,iBAAY,GAAZ,YAAY,CAAwB;QAGrD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAElC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YACpF,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAEO,aAAa,CAAC,SAA8B;QAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;QACvD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,OAAe,EACf,OAAe,EACf,IAAuB;QAEvB,MAAM,UAAU,GAAmB,EAAE,CAAC;QACtC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAE5C,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,aAAa,GAAG,GAAG,UAAU,OAAO,CAAC;QAC3C,MAAM,cAAc,GAAG,GAAG,UAAU,QAAQ,CAAC;QAE7C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACzF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;QAEnF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;QAE9E,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAEO,mBAAmB;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,eAAe,CAAC,iBAAkB,CAAC;QACxF,OAAO,EAAE,CAAC,OAAO,CAAC,uBAAuB,CACvC,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAC3B,KAAK,EACL,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;YAC5B,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAC9B,KAAK,EACL,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAC3C;SACF,CAAC,CACH,EACD,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAC1C,SAAS,CACV,CAAC;IACJ,CAAC;IAEO,kBAAkB,CACxB,IAAuB,EACvB,aAAqB,EACrB,cAAsB;QAEtB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW;YACjC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAC7C,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACxD,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAC5D,SAAS,EACT;YACE,EAAE,CAAC,OAAO,CAAC,0BAA0B,CACnC,SAAS,EACT,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,EACpC,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,EAC9E,SAAS,CACV;SACF,EACD,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE;YACzE,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;SAChF,CAAC,EACF,EAAE,CAAC,OAAO,CAAC,WAAW,CACpB;YACE,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAC9B,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAC7B,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAC1C,CAAC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,EACjF;gBACE,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC;gBAClD,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC;aACrC,CACF,CACF;SACF,EACD,IAAI,CACL,CACF,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACf,EAAE,CAAC,0BAA0B,CAC3B,EAAE,EACF,EAAE,CAAC,UAAU,CAAC,sBAAsB,EACpC,SAAS,IAAI,CAAC,WAAW,KAAK,EAC9B,IAAI,CACL,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,KAA0B;QAC1E,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACpC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAChC,SAAS,EACT,KAAK,EACL,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;YAC5B,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAC9B,KAAK,EACL,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC7D;SACF,CAAC,EACF,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC,QAAQ,KAAK,CAAC,EACvD,SAAS,CACV,CACF,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAAiB;QAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACxC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAChC,SAAS,EACT,KAAK,EACL,SAAS,EACT,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,MAAM,WAAW,CAAC,EACtD,SAAS,CACV,CACF,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAyC;QACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACvE,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1B,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,gDAAgD;aAChF,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;YAAE,OAAO;QACvC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5F,CAAC;IAEO,KAAK,CAAC,oBAAoB;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACtE,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG;;;;;;;;;;;;CAYnB,CAAC;QACE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE/C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAChE,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCzB,CAAC;QACE,MAAM,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QAE7D,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACpE,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC5B,CAAC;QACE,MAAM,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAEO,eAAe,CAAC,UAA0B;QAChD,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,SAAS,EACT,EAAE,EACF,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,KAAK,EACL,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;QACF,OAAO,UAAU;aACd,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;aAC1F,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,OAAO,KAAK;aACT,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;aAC5D,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/agent/codegen/SchemaToTypeScriptMapper.d.ts

@@ -0,0 +1,13 @@
+import ts from 'typescript';
+import type { NormalizedSchema } from './types.js';
+export declare class SchemaToTypeScriptMapper {
+    private readonly factory;
+    constructor(factory?: ts.NodeFactory);
+    createTypeAliasDeclaration(name: string, schema?: NormalizedSchema): ts.TypeAliasDeclaration;
+    typeNodeFromSchema(schema?: NormalizedSchema): ts.TypeNode;
+    private keywordType;
+    private enumTypeNode;
+    private arrayTypeNode;
+    private objectTypeNode;
+}
+//# sourceMappingURL=SchemaToTypeScriptMapper.d.ts.map

package/dist/agent/codegen/SchemaToTypeScriptMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaToTypeScriptMapper.d.ts","sourceRoot":"","sources":["../../../src/agent/codegen/SchemaToTypeScriptMapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,iBAAa;IAE1C,0BAA0B,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,gBAAgB,GACxB,EAAE,CAAC,oBAAoB;IASnB,kBAAkB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,EAAE,CAAC,QAAQ;IAwBjE,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,cAAc;CA+BvB"}

package/dist/agent/codegen/SchemaToTypeScriptMapper.js

@@ -0,0 +1,54 @@
+import ts from 'typescript';
+export class SchemaToTypeScriptMapper {
+    factory;
+    constructor(factory = ts.factory) {
+        this.factory = factory;
+    }
+    createTypeAliasDeclaration(name, schema) {
+        return this.factory.createTypeAliasDeclaration([this.factory.createModifier(ts.SyntaxKind.ExportKeyword)], this.factory.createIdentifier(name), undefined, this.typeNodeFromSchema(schema));
+    }
+    typeNodeFromSchema(schema) {
+        if (!schema) {
+            return this.factory.createKeywordTypeNode(ts.SyntaxKind.AnyKeyword);
+        }
+        switch (schema.kind) {
+            case 'string':
+                return this.keywordType(ts.SyntaxKind.StringKeyword);
+            case 'number':
+            case 'integer':
+                return this.keywordType(ts.SyntaxKind.NumberKeyword);
+            case 'boolean':
+                return this.keywordType(ts.SyntaxKind.BooleanKeyword);
+            case 'enum':
+                return this.enumTypeNode(schema);
+            case 'array':
+                return this.arrayTypeNode(schema);
+            case 'object':
+                return this.objectTypeNode(schema);
+            default:
+                return this.keywordType(ts.SyntaxKind.AnyKeyword);
+        }
+    }
+    keywordType(kind) {
+        return this.factory.createKeywordTypeNode(kind);
+    }
+    enumTypeNode(schema) {
+        if (!schema.values.length) {
+            return this.keywordType(ts.SyntaxKind.StringKeyword);
+        }
+        return this.factory.createUnionTypeNode(schema.values.map((value) => this.factory.createLiteralTypeNode(this.factory.createStringLiteral(value))));
+    }
+    arrayTypeNode(schema) {
+        return this.factory.createArrayTypeNode(this.typeNodeFromSchema(schema.items));
+    }
+    objectTypeNode(schema) {
+        const members = schema.properties.map((property) => this.factory.createPropertySignature(undefined, this.factory.createIdentifier(property.name), property.required ? undefined : this.factory.createToken(ts.SyntaxKind.QuestionToken), this.typeNodeFromSchema(property.schema)));
+        if (schema.additionalProperties) {
+            members.push(this.factory.createIndexSignature(undefined, [
+                this.factory.createParameterDeclaration(undefined, undefined, this.factory.createIdentifier('key'), undefined, this.keywordType(ts.SyntaxKind.StringKeyword), undefined),
+            ], this.keywordType(ts.SyntaxKind.AnyKeyword)));
+        }
+        return this.factory.createTypeLiteralNode(members);
+    }
+}
+//# sourceMappingURL=SchemaToTypeScriptMapper.js.map

package/dist/agent/codegen/SchemaToTypeScriptMapper.js.map

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

package/dist/agent/codegen/ToolDescriptionBuilder.d.ts

@@ -0,0 +1,67 @@
+import type { ToolSchemaSummary } from './types.js';
+export interface ToolSignature {
+    name: string;
+    camelName: string;
+    signature: string;
+    shortDescription: string;
+    hiddenParamCount: number;
+}
+export interface ParameterDoc {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    enumValues?: string[];
+}
+export interface Example {
+    description: string;
+    code: string;
+}
+export interface ToolDetailedHelp {
+    name: string;
+    camelName: string;
+    description: string;
+    parameters: ParameterDoc[];
+    examples: Example[];
+}
+/**
+ * Generates tool descriptions with progressive disclosure for LLM agents.
+ * Layer 1: Overview tree - compact tool listing
+ * Layer 2: Signatures - typed function signatures
+ * Layer 3: On-demand help via getToolHelp()
+ */
+export declare class ToolDescriptionBuilder {
+    private readonly maxSignatureParams;
+    constructor(options?: {
+        maxSignatureParams?: number;
+    });
+    /**
+     * Layer 1: Compact tree overview of all tools
+     */
+    buildOverviewTree(tools: ToolSchemaSummary[]): string;
+    /**
+     * Layer 2: Generate compact signatures for specified tools
+     */
+    buildSignatures(tools: ToolSchemaSummary[]): ToolSignature[];
+    /**
+     * Layer 2: Format signatures as readable string block
+     */
+    formatSignaturesBlock(tools: ToolSchemaSummary[], indent?: string): string;
+    /**
+     * Layer 3: Full documentation for a tool (used by getToolHelp runtime)
+     */
+    buildDetailedHelp(tool: ToolSchemaSummary): ToolDetailedHelp;
+    /**
+     * Build all help data for runtime injection
+     */
+    buildAllHelpData(tools: ToolSchemaSummary[]): ToolDetailedHelp[];
+    private buildToolSignature;
+    private extractParameters;
+    private compactType;
+    private schemaToTypeString;
+    private generateExamples;
+    private groupByServer;
+    private truncate;
+    private toCamelCase;
+}
+//# sourceMappingURL=ToolDescriptionBuilder.d.ts.map

package/dist/agent/codegen/ToolDescriptionBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolDescriptionBuilder.d.ts","sourceRoot":"","sources":["../../../src/agent/codegen/ToolDescriptionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAKlB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAEhC,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrD;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM;IAkBrD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,aAAa,EAAE;IAI5D;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,MAAM,SAAO,GAAG,MAAM;IAKxE;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB;IAW5D;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,EAAE;IAIhE,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,gBAAgB;IAwDxB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/agent/codegen/ToolDescriptionBuilder.js

@@ -0,0 +1,201 @@
+/**
+ * Generates tool descriptions with progressive disclosure for LLM agents.
+ * Layer 1: Overview tree - compact tool listing
+ * Layer 2: Signatures - typed function signatures
+ * Layer 3: On-demand help via getToolHelp()
+ */
+export class ToolDescriptionBuilder {
+    maxSignatureParams;
+    constructor(options) {
+        this.maxSignatureParams = options?.maxSignatureParams ?? 4;
+    }
+    /**
+     * Layer 1: Compact tree overview of all tools
+     */
+    buildOverviewTree(tools) {
+        const grouped = this.groupByServer(tools);
+        const lines = [];
+        for (const [server, serverTools] of grouped) {
+            lines.push(`/${server}/`);
+            for (let i = 0; i < serverTools.length; i++) {
+                const tool = serverTools[i];
+                const prefix = i === serverTools.length - 1 ? '└── ' : '├── ';
+                const fn = this.toCamelCase(tool.toolName);
+                const shortDesc = this.truncate(tool.description, 50);
+                lines.push(`  ${prefix}${fn}()${shortDesc ? ' - ' + shortDesc : ''}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Layer 2: Generate compact signatures for specified tools
+     */
+    buildSignatures(tools) {
+        return tools.map((tool) => this.buildToolSignature(tool));
+    }
+    /**
+     * Layer 2: Format signatures as readable string block
+     */
+    formatSignaturesBlock(tools, indent = '  ') {
+        const signatures = this.buildSignatures(tools);
+        return signatures.map((s) => `${indent}${s.signature}`).join('\n');
+    }
+    /**
+     * Layer 3: Full documentation for a tool (used by getToolHelp runtime)
+     */
+    buildDetailedHelp(tool) {
+        const params = this.extractParameters(tool.inputSchema);
+        return {
+            name: tool.toolName,
+            camelName: this.toCamelCase(tool.toolName),
+            description: tool.description ?? '',
+            parameters: params,
+            examples: this.generateExamples(tool),
+        };
+    }
+    /**
+     * Build all help data for runtime injection
+     */
+    buildAllHelpData(tools) {
+        return tools.map((t) => this.buildDetailedHelp(t));
+    }
+    buildToolSignature(tool) {
+        const params = this.extractParameters(tool.inputSchema);
+        const visibleParams = params.slice(0, this.maxSignatureParams);
+        const hiddenCount = Math.max(0, params.length - this.maxSignatureParams);
+        const paramParts = visibleParams.map((p) => `${p.name}${p.required ? '' : '?'}: ${this.compactType(p)}`);
+        let paramStr = paramParts.join(', ');
+        if (hiddenCount > 0) {
+            paramStr += `, ...`; // indicate more params
+        }
+        const fn = this.toCamelCase(tool.toolName);
+        const signature = params.length > 0 ? `${fn}({ ${paramStr} })` : `${fn}()`;
+        return {
+            name: tool.toolName,
+            camelName: fn,
+            signature: hiddenCount > 0 ? `${signature} // +${hiddenCount} params` : signature,
+            shortDescription: this.truncate(tool.description, 60),
+            hiddenParamCount: hiddenCount,
+        };
+    }
+    extractParameters(schema) {
+        if (!schema || schema.kind !== 'object')
+            return [];
+        const objSchema = schema;
+        return objSchema.properties.map((prop) => ({
+            name: prop.name,
+            type: this.schemaToTypeString(prop.schema),
+            required: prop.required,
+            description: prop.description,
+            enumValues: prop.schema.kind === 'enum' ? prop.schema.values : undefined,
+        }));
+    }
+    compactType(param) {
+        if (param.enumValues) {
+            if (param.enumValues.length <= 3) {
+                return param.enumValues.map((v) => `'${v}'`).join(' | ');
+            }
+            return `'${param.enumValues[0]}' | '${param.enumValues[1]}' | ...`;
+        }
+        return param.type;
+    }
+    schemaToTypeString(schema) {
+        switch (schema.kind) {
+            case 'string':
+                return 'string';
+            case 'number':
+            case 'integer':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'array': {
+                const arrSchema = schema;
+                return `${this.schemaToTypeString(arrSchema.items)}[]`;
+            }
+            case 'enum': {
+                const enumSchema = schema;
+                return enumSchema.values.length <= 3
+                    ? enumSchema.values.map((v) => `'${v}'`).join(' | ')
+                    : 'string';
+            }
+            case 'object':
+                return 'object';
+            default:
+                return 'any';
+        }
+    }
+    generateExamples(tool) {
+        const examples = [];
+        const fn = this.toCamelCase(tool.toolName);
+        const params = this.extractParameters(tool.inputSchema);
+        const paramNames = new Set(params.map((p) => p.name));
+        // Generate contextual examples based on tool patterns
+        if (tool.toolName.includes('list')) {
+            examples.push({ description: 'List all', code: `await ${fn}({})` });
+            if (paramNames.has('namespace')) {
+                examples.push({
+                    description: 'Filter by namespace',
+                    code: `await ${fn}({ namespace: 'default' })`,
+                });
+            }
+            if (paramNames.has('allNamespaces')) {
+                examples.push({
+                    description: 'All namespaces',
+                    code: `await ${fn}({ allNamespaces: true })`,
+                });
+            }
+        }
+        else if (tool.toolName.includes('get')) {
+            const nameParam = paramNames.has('name')
+                ? 'name'
+                : paramNames.has('podName')
+                    ? 'podName'
+                    : 'kind';
+            examples.push({
+                description: 'Get resource',
+                code: `await ${fn}({ ${nameParam}: 'my-resource' })`,
+            });
+        }
+        else if (tool.toolName.includes('log')) {
+            examples.push({
+                description: 'Tail logs',
+                code: `await ${fn}({ podName: 'my-pod', tailLines: 100 })`,
+            });
+        }
+        else if (tool.toolName.includes('exec')) {
+            examples.push({
+                description: 'Execute command',
+                code: `await ${fn}({ podName: 'my-pod', namespace: 'default', command: ['ls', '-la'] })`,
+            });
+        }
+        else if (tool.toolName.includes('metrics')) {
+            examples.push({
+                description: 'Get metrics',
+                code: `await ${fn}({})`,
+            });
+        }
+        // Fallback
+        if (examples.length === 0) {
+            examples.push({ description: 'Basic usage', code: `await ${fn}({})` });
+        }
+        return examples;
+    }
+    groupByServer(tools) {
+        const grouped = new Map();
+        for (const tool of tools) {
+            if (!grouped.has(tool.server))
+                grouped.set(tool.server, []);
+            grouped.get(tool.server).push(tool);
+        }
+        return grouped;
+    }
+    truncate(text, maxLen = 50) {
+        if (!text)
+            return '';
+        return text.length > maxLen ? text.slice(0, maxLen - 3) + '...' : text;
+    }
+    toCamelCase(name) {
+        return name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+    }
+}
+//# sourceMappingURL=ToolDescriptionBuilder.js.map

package/dist/agent/codegen/ToolDescriptionBuilder.js.map

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

package/dist/agent/codegen/ToolSchemaIntrospector.d.ts

@@ -0,0 +1,10 @@
+import type { MCPBridge } from '../bridge/MCPBridge.js';
+import type { ToolSchemaSummary } from './types.js';
+export declare class ToolSchemaIntrospector {
+    private readonly bridge;
+    constructor(bridge: MCPBridge);
+    collectToolSchemas(): ToolSchemaSummary[];
+    private normalizeSchema;
+    private normalizeObjectSchema;
+}
+//# sourceMappingURL=ToolSchemaIntrospector.d.ts.map

package/dist/agent/codegen/ToolSchemaIntrospector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolSchemaIntrospector.d.ts","sourceRoot":"","sources":["../../../src/agent/codegen/ToolSchemaIntrospector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAoB,iBAAiB,EAA4B,MAAM,YAAY,CAAC;AAYhG,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAEvC,kBAAkB,IAAI,iBAAiB,EAAE;IAUhD,OAAO,CAAC,eAAe;IA4CvB,OAAO,CAAC,qBAAqB;CAwB9B"}