@prodisco/k8s-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Harshad Patil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,226 @@
+# ProDisco (Progressive Disclosure Kuberentes MCP Server)
+
+ProDisco gives MCP agents Kubernetes access that exactly follows Anthropic’s [Progressive Disclosure](https://www.anthropic.com/engineering/code-execution-with-mcp) pattern: the server exposes TypeScript modules, agents discover them through the filesystem, write code, and only the final console output returns to the chat.
+
+## Why Progressive Disclosure Matters
+
+Anthropic’s latest guidance explains why MCP servers should progressively reveal capabilities instead of dumping every tool definition into the model context. When agents explore a filesystem of TypeScript modules, as they do with ProDisco, they only load what they need and process data inside the execution environment, then return a concise result to the chat. This keeps token usage low, improves latency, and avoids copying large intermediate payloads through the model ([source](https://www.anthropic.com/engineering/code-execution-with-mcp)).
+
+In practice that means:
+- Agents only see a single advertised tool (`kubernetes.searchTools`); they call it with structured parameters (resourceType, action, scope) to discover the TypeScript modules (get pods, list nodes, fetch logs, etc.) that the server exposes, then write their own code to compose those modules without loading unused schemas.
+- Letting the model issue one instruction instead of micromanaging dozens of sequential tool calls.
+- Agents can mix and match multiple Kubernetes modules joining pod stats with node health, or correlating events with logs without shuttling raw outputs between tools in the chat loop, which dramatically cuts token usage.
+
+ProDisco ships with this layout out of the box, so any Claude Code or MCP-enabled agent can immediately adopt the progressive-disclosure workflow.
+
+---
+
+## Quick Start
+
+```bash
+npm install
+npm run build
+claude mcp add --transport stdio prodisco -- node dist/server.js
+claude mcp remove prodisco # remove when you're done
+```
+
+Only **one tool** (`kubernetes.searchTools`) is advertised to the agent. Everything else is discovered via resources, so agents naturally stay in code mode.
+
+### Scripts cache convention
+
+**Script Location:** `~/.prodisco/scripts/cache/`
+
+ProDisco automatically creates a `~/.prodisco/scripts/cache/` directory in your home directory for storing helper scripts. This ensures scripts work from any directory and persist across sessions.
+
+**How it works:**
+
+1. Call `kubernetes.searchTools` to get the `paths` object:
+   - `scriptsDirectory`: Where to write scripts (e.g., `~/.prodisco/scripts/cache/`)
+   - `packageDirectory`: Where dependencies are installed (use for imports)
+
+2. Write scripts to the `scriptsDirectory` path
+
+3. Import Kubernetes client from the `packageDirectory`:
+   ```typescript
+   import * as k8s from '/path/to/packageDirectory/node_modules/@kubernetes/client-node';
+   ```
+
+4. Execute with absolute paths:
+   ```bash
+   npx tsx ~/.prodisco/scripts/cache/<yourscript>.ts --flag=value
+   ```
+
+**Best practices:**
+- Always use paths from `kubernetes.searchTools` response (don't hardcode)
+- Scripts must parse CLI args or env vars for all required values
+- Print a brief usage message if arguments are missing
+- Scripts persist across sessions and work from any directory
+
+---
+
+## Available Tools
+
+ProDisco exposes two main tools for agents to discover and interact with the Kubernetes API:
+
+### 1. kubernetes.searchTools
+
+Find Kubernetes API methods by resource type and action.
+
+**Input:**
+```typescript
+{
+  resourceType: string;  // e.g., "Pod", "Deployment", "Service"
+  action?: string;       // e.g., "list", "read", "create", "delete", "patch", "replace", "connect"
+  scope?: 'namespaced' | 'cluster' | 'all';  // default: 'all'
+  exclude?: {            // Optional: filter out methods
+    actions?: string[];     // e.g., ["delete", "create"]
+    apiClasses?: string[];  // e.g., ["CoreV1Api"]
+  };
+  limit?: number;        // Max results (default: 10, max: 50)
+}
+```
+
+**Example Queries:**
+```typescript
+// List all Pod-related methods
+{ resourceType: "Pod" }
+
+// List namespaced Pods
+{ resourceType: "Pod", action: "list", scope: "namespaced" }
+
+// Create Deployment
+{ resourceType: "Deployment", action: "create" }
+
+// Pod methods excluding delete actions
+{ resourceType: "Pod", exclude: { actions: ["delete"] } }
+
+// Pod methods excluding CoreV1Api (shows only PolicyV1Api, AutoscalingV1Api, etc.)
+{ resourceType: "Pod", exclude: { apiClasses: ["CoreV1Api"] } }
+
+// Pod methods excluding delete from CoreV1Api only (AND logic)
+{ resourceType: "Pod", exclude: { actions: ["delete"], apiClasses: ["CoreV1Api"] } }
+```
+
+**Output Example:**
+```
+Found 1 method(s) for resource "Pod", action "list", scope "namespaced"
+
+1. CoreV1Api.listNamespacedPod
+   method_args: { namespace: "string" }
+   return_values: response.items (array of Pod)
+   return_types: export class V1PodList {
+     key properties: apiVersion?: string;, items: Array<V1Pod>;, kind?: string;
+     (use kubernetes.getTypeDefinition for complete type details)
+
+USAGE:
+- All methods require object parameter: await api.method({ param: value })
+- Write scripts to: /Users/you/.prodisco/scripts/cache/<yourscript>.ts
+- Run scripts with: npx tsx /Users/you/.prodisco/scripts/cache/<yourscript>.ts
+- Import dependencies from: /path/to/package/node_modules/@kubernetes/client-node
+
+Paths (use these in your scripts):
+{
+  "scriptsDirectory": "/Users/you/.prodisco/scripts/cache",
+  "packageDirectory": "/path/to/kubernetes-mcp"
+}
+```
+
+**Key Features:**
+- Structured parameter matching: specify resource type, action, and scope
+- **Exclude filtering for precise results**: Use the `exclude` parameter to filter out unwanted methods by actions and/or API classes
+  - Actions only: `{ actions: ["delete"] }` excludes all delete methods
+  - Multiple actions: `{ actions: ["delete", "create"] }` excludes both
+  - API classes only: `{ apiClasses: ["CoreV1Api"] }` excludes all CoreV1Api methods
+  - Both (AND logic): `{ actions: ["delete"], apiClasses: ["CoreV1Api"] }` excludes **only** delete methods from CoreV1Api (keeps other CoreV1Api methods and delete methods from other classes)
+  - **TIP**: Exclude is especially useful when broad searches return too many results (e.g., "Pod" matches CoreV1Api, AutoscalingV1Api, PolicyV1Api methods)
+- Shows all required parameters (including special cases like CustomObjectsApi)
+- Clear indication of return structure (`response` vs `response.items`)
+- Brief inline type information with key properties
+- Available actions: list, read, create, delete, patch, replace, connect, get, watch
+
+**Common Search Patterns:**
+```typescript
+// Pod logs: use "Log" or "PodLog", not "Pod" with "connect"
+{ resourceType: "Log" }  // Returns: CoreV1Api.readNamespacedPodLog
+
+// Pod exec/attach: use "Pod" with "connect"
+{ resourceType: "Pod", action: "connect" }  // Returns: connectGetNamespacedPodExec, connectPostNamespacedPodAttach
+
+// Pod eviction (drain nodes): use "Eviction" or "PodEviction"
+{ resourceType: "Eviction" }  // Returns: CoreV1Api.createNamespacedPodEviction
+
+// Binding pods to nodes: use "Binding" or "PodBinding"
+{ resourceType: "Binding" }  // Returns: CoreV1Api.createNamespacedPodBinding
+
+// Service account tokens: use "ServiceAccountToken"
+{ resourceType: "ServiceAccountToken" }  // Returns: CoreV1Api.createNamespacedServiceAccountToken
+
+// Cluster health: use "ComponentStatus"
+{ resourceType: "ComponentStatus" }  // Returns: CoreV1Api.listComponentStatus
+
+// Status subresources: search for the full resource name
+{ resourceType: "DeploymentStatus" }  // Returns: readNamespacedDeploymentStatus, patchNamespacedDeploymentStatus
+
+// Scale subresources: similar pattern
+{ resourceType: "DeploymentScale" }  // Returns: readNamespacedDeploymentScale, patchNamespacedDeploymentScale
+```
+
+### 2. kubernetes.getTypeDefinition
+
+Get detailed TypeScript type definitions for Kubernetes types.
+
+**Input:**
+```typescript
+{
+  types: string[];      // Type names or property paths
+                        // Examples: ["V1Pod", "V1Deployment.spec", "V1Pod.spec.containers"]
+  depth?: number;       // Nested type depth (default: 1, max: 2)
+}
+```
+
+**Dot Notation Support:**
+Navigate directly to nested types:
+- `V1Deployment.spec` → Returns `V1DeploymentSpec` type
+- `V1Pod.spec.containers` → Returns `V1Container` type (array element)
+- `V1Pod.status.conditions` → Returns `V1PodCondition` type
+
+**Example Output:**
+```typescript
+{
+  "V1Pod": {
+    "name": "V1Pod",
+    "definition": "V1Pod {\n  apiVersion?: string\n  kind?: string\n  metadata?: V1ObjectMeta\n  spec?: V1PodSpec\n  status?: V1PodStatus\n  ...\n}",
+    "nestedTypes": ["V1ObjectMeta", "V1PodSpec", "V1PodStatus"]
+  }
+}
+```
+
+**Key Features:**
+- Native TypeScript parsing (uses TypeScript Compiler API, no regex)
+- Dot notation for navigating nested types
+- Automatic resolution of `Array<T>`, unions, and type references
+- Controlled depth to avoid overwhelming output
+
+**Type Definitions Location:**
+All type definitions are read from:
+```
+node_modules/@kubernetes/client-node/dist/gen/models/
+```
+This directory contains 852 `.d.ts` files with complete Kubernetes type information.
+
+---
+
+## Integration Tests
+
+End-to-end testing instructions (KIND cluster + Claude Agent SDK driver) now live in `docs/integration-testing.md`. The workflow is manual-only for now and assumes your Anthropic credentials are already configured. Run it locally with:
+
+```bash
+npm run test:integration
+```
+
+---
+
+## License
+
+MIT
+

package/dist/codegen/generateTypes.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env tsx
+/**
+ * Generate inline TypeScript interfaces for Kubernetes tools
+ *
+ * Usage: npm run codegen
+ */
+export {};
+//# sourceMappingURL=generateTypes.d.ts.map

package/dist/codegen/generateTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateTypes.d.ts","sourceRoot":"","sources":["../../src/codegen/generateTypes.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/codegen/generateTypes.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env tsx
+/**
+ * Generate inline TypeScript interfaces for Kubernetes tools
+ *
+ * Usage: npm run codegen
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as ts from 'typescript';
+import { extractInterfaceFromFile, findKubernetesTypeFile } from './typeExtractor.js';
+import { generateExpandedInterface } from './interfaceGenerator.js';
+import { TOOL_TYPE_MAPPINGS } from './toolMapping.js';
+const DRY_RUN = process.argv.includes('--dry-run');
+console.log('🔧 Kubernetes Type Generator');
+console.log('============================\n');
+if (DRY_RUN) {
+    console.log('⚠️  DRY RUN MODE - No files will be modified\n');
+}
+for (const mapping of TOOL_TYPE_MAPPINGS) {
+    console.log(`📄 Processing ${mapping.toolFile}...`);
+    console.log(`   Type: ${mapping.kubernetesType} -> ${mapping.resultTypeName}`);
+    // Special handling for simple types
+    if (mapping.kubernetesType === 'string' ||
+        mapping.kubernetesType.startsWith('Array<') ||
+        mapping.kubernetesType === 'object') {
+        console.log(`   ⏭️  Skipping (simple type)\n`);
+        continue;
+    }
+    // Find the Kubernetes type file
+    const typeFile = findKubernetesTypeFile(mapping.kubernetesType);
+    if (!typeFile) {
+        console.log(`   ❌ Could not find type file for ${mapping.kubernetesType}\n`);
+        continue;
+    }
+    console.log(`   📖 Reading from ${path.basename(typeFile)}`);
+    // Extract the interface
+    const interfaceInfo = extractInterfaceFromFile(typeFile, mapping.kubernetesType);
+    if (!interfaceInfo) {
+        console.log(`   ❌ Could not extract interface ${mapping.kubernetesType}\n`);
+        continue;
+    }
+    console.log(`   ✅ Extracted ${interfaceInfo.fields.length} fields`);
+    // Generate the inline interface code
+    const interfaceCode = generateExpandedInterface(mapping.resultTypeName, mapping.kubernetesType, interfaceInfo);
+    if (DRY_RUN) {
+        console.log(`   📝 Generated interface (${interfaceCode.split('\n').length} lines)`);
+        console.log(`\n${interfaceCode}\n`);
+        continue;
+    }
+    // Read the tool file
+    const toolFilePath = path.resolve(process.cwd(), mapping.toolFile);
+    if (!fs.existsSync(toolFilePath)) {
+        console.log(`   ❌ Tool file not found: ${toolFilePath}\n`);
+        continue;
+    }
+    const toolFileContent = fs.readFileSync(toolFilePath, 'utf-8');
+    // Parse the tool file using TypeScript compiler
+    const sourceFile = ts.createSourceFile(toolFilePath, toolFileContent, ts.ScriptTarget.Latest, true);
+    // Find the interface declaration
+    let interfaceNode;
+    let interfaceStart = -1;
+    let interfaceEnd = -1;
+    function visit(node) {
+        if (ts.isInterfaceDeclaration(node) &&
+            node.name.text === mapping.resultTypeName &&
+            node.modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword)) {
+            interfaceNode = node;
+            // Get the full start (including JSDoc)
+            interfaceStart = node.getFullStart();
+            interfaceEnd = node.getEnd();
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    if (!interfaceNode) {
+        console.log(`   ⚠️  Could not find existing interface ${mapping.resultTypeName} to replace`);
+        console.log();
+        continue;
+    }
+    // Replace the interface
+    const beforeInterface = toolFileContent.substring(0, interfaceStart);
+    const afterInterface = toolFileContent.substring(interfaceEnd);
+    const newContent = beforeInterface + interfaceCode + afterInterface;
+    fs.writeFileSync(toolFilePath, newContent, 'utf-8');
+    console.log(`   ✅ Updated interface in ${mapping.toolFile}`);
+    console.log();
+}
+console.log('✨ Done!\n');
+if (!DRY_RUN) {
+    console.log('💡 Next steps:');
+    console.log('   1. Review the generated interfaces');
+    console.log('   2. Run: npm run build');
+    console.log('   3. Run: npm test');
+    console.log('   4. Commit the changes\n');
+}
+//# sourceMappingURL=generateTypes.js.map

package/dist/codegen/generateTypes.js.map

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

package/dist/codegen/interfaceGenerator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate inline TypeScript interfaces from Kubernetes types
+ */
+import { InterfaceInfo } from './typeExtractor.js';
+/**
+ * Generate expanded inline interface with detailed nested types
+ */
+export declare function generateExpandedInterface(resultTypeName: string, kubernetesType: string, interfaceInfo: InterfaceInfo): string;
+//# sourceMappingURL=interfaceGenerator.d.ts.map

package/dist/codegen/interfaceGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaceGenerator.d.ts","sourceRoot":"","sources":["../../src/codegen/interfaceGenerator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAoD,MAAM,oBAAoB,CAAC;AAsLrG;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,aAAa,GAC3B,MAAM,CAoCR"}

package/dist/codegen/interfaceGenerator.js

@@ -0,0 +1,185 @@
+/**
+ * Generate inline TypeScript interfaces from Kubernetes types
+ */
+import { extractInterfaceFromFile, findKubernetesTypeFile } from './typeExtractor.js';
+/**
+ * Types that should NOT be expanded (too complex or rarely used)
+ */
+const DONT_EXPAND_TYPES = new Set([
+    // Complex scheduling/affinity rules
+    'V1Affinity', 'V1NodeAffinity', 'V1PodAffinity', 'V1PodAntiAffinity',
+    'V1NodeSelector', 'V1NodeSelectorRequirement',
+    'V1LabelSelectorRequirement',
+    // Complex security contexts
+    'V1SecurityContext', 'V1PodSecurityContext', 'V1SELinuxOptions',
+    'V1SeccompProfile', 'V1WindowsSecurityContextOptions', 'V1Capabilities',
+    'V1AppArmorProfile',
+    // Probes (detailed structure not commonly needed)
+    'V1Probe', 'V1HTTPGetAction', 'V1TCPSocketAction', 'V1ExecAction',
+    'V1GRPCAction', 'V1SleepAction', 'V1HTTPHeader',
+    // Lifecycle hooks
+    'V1Lifecycle', 'V1LifecycleHandler',
+    // Volume types (too many variants)
+    'V1VolumeMount', 'V1PersistentVolumeClaimVolumeSource',
+    'V1ConfigMapVolumeSource', 'V1SecretVolumeSource', 'V1EmptyDirVolumeSource',
+    'V1HostPathVolumeSource', 'V1ProjectedVolumeSource', 'V1CSIVolumeSource',
+    // Resource references
+    'V1ResourceClaim', 'V1TypedLocalObjectReference',
+    'V1LocalObjectReference', 'V1ObjectReference',
+    // Field selectors
+    'V1EnvVarSource', 'V1ConfigMapKeySelector', 'V1SecretKeySelector',
+    'V1ObjectFieldSelector', 'V1ResourceFieldSelector',
+    'V1ConfigMapEnvSource', 'V1SecretEnvSource',
+    // Tolerations and taints
+    'V1Taint',
+    // Topology
+    'V1TopologySpreadConstraint', 'V1PodAffinityTerm', 'V1WeightedPodAffinityTerm',
+    // Other complex types
+    'V1PodReadinessGate', 'V1PodResourceClaim', 'V1ContainerResizePolicy',
+    'V1EphemeralContainer', 'V1HostAlias', 'V1PodOS',
+]);
+/**
+ * Check if a type should not be expanded (return generic object instead)
+ */
+function shouldNotExpand(typeName) {
+    return DONT_EXPAND_TYPES.has(typeName);
+}
+/**
+ * Check if a type is a primitive or should not be expanded
+ */
+function isPrimitiveType(typeName) {
+    const primitives = [
+        'string', 'number', 'boolean', 'unknown', 'any', 'void', 'null', 'undefined',
+        'Date', 'object', 'never'
+    ];
+    // Check if it's a primitive
+    if (primitives.includes(typeName)) {
+        return true;
+    }
+    // Check if it's a Record type
+    if (typeName.startsWith('Record<') || typeName.startsWith('{')) {
+        return true;
+    }
+    // Check if it's a union with primitives
+    if (typeName.includes('|')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract the inner type from Array<T>
+ */
+function extractArrayType(typeName) {
+    const match = typeName.match(/^Array<(.+)>$/);
+    return match && match[1] ? match[1] : null;
+}
+/**
+ * Recursively expand a type into an inline interface definition
+ */
+function expandType(typeName, indent = '  ', depth = 0, visited = new Set()) {
+    // Prevent infinite recursion - limit to 3 levels for reasonable file sizes
+    if (depth > 3) {
+        return '{ [key: string]: unknown }';
+    }
+    // Convert Date to string
+    if (typeName === 'Date') {
+        return 'string';
+    }
+    // Check if this type should not be expanded (too complex)
+    if (shouldNotExpand(typeName)) {
+        return '{ [key: string]: unknown }';
+    }
+    // Check if it's a primitive
+    if (isPrimitiveType(typeName)) {
+        return typeName === 'object' ? '{ [key: string]: unknown }' : typeName;
+    }
+    // Handle Array types
+    const arrayInnerType = extractArrayType(typeName);
+    if (arrayInnerType) {
+        const expandedInner = expandType(arrayInnerType, indent, depth + 1, visited);
+        // If the inner type is complex (multiline), format it properly
+        if (expandedInner.includes('\n')) {
+            return `Array<${expandedInner}>`;
+        }
+        return `Array<${expandedInner}>`;
+    }
+    // Check for circular reference
+    if (visited.has(typeName)) {
+        return '{ [key: string]: unknown }';
+    }
+    // Try to find and expand Kubernetes types
+    if (typeName.startsWith('V1') || typeName.startsWith('V2')) {
+        const typeFile = findKubernetesTypeFile(typeName);
+        if (typeFile) {
+            const typeInfo = extractInterfaceFromFile(typeFile, typeName);
+            if (typeInfo) {
+                visited.add(typeName);
+                const expanded = expandTypeInfo(typeInfo, indent + '  ', depth + 1, visited);
+                visited.delete(typeName);
+                return expanded;
+            }
+        }
+    }
+    // Fallback
+    return '{ [key: string]: unknown }';
+}
+/**
+ * Expand a complete InterfaceInfo into inline type definition
+ */
+function expandTypeInfo(typeInfo, indent, depth, visited) {
+    const lines = [];
+    lines.push('{');
+    for (const field of typeInfo.fields) {
+        // Skip static/internal fields
+        if (['discriminator', 'mapping', 'attributeTypeMap'].includes(field.name)) {
+            continue;
+        }
+        // Add field JSDoc if present
+        if (field.jsDoc) {
+            lines.push(`${indent}/** ${field.jsDoc} */`);
+        }
+        const optional = field.optional ? '?' : '';
+        const expandedType = expandType(field.type, indent, depth, visited);
+        // Handle multiline expanded types
+        if (expandedType.includes('\n')) {
+            lines.push(`${indent}${field.name}${optional}: ${expandedType};`);
+        }
+        else {
+            lines.push(`${indent}${field.name}${optional}: ${expandedType};`);
+        }
+    }
+    lines.push(indent.slice(0, -2) + '}');
+    return lines.join('\n');
+}
+/**
+ * Generate expanded inline interface with detailed nested types
+ */
+export function generateExpandedInterface(resultTypeName, kubernetesType, interfaceInfo) {
+    const lines = [];
+    // Add interface JSDoc
+    if (interfaceInfo.jsDoc) {
+        lines.push('/**');
+        lines.push(` * ${interfaceInfo.jsDoc}`);
+        lines.push(' */');
+    }
+    lines.push(`export interface ${resultTypeName} {`);
+    const visited = new Set();
+    visited.add(kubernetesType);
+    // Generate fields with recursive expansion
+    for (const field of interfaceInfo.fields) {
+        // Skip static fields
+        if (['discriminator', 'mapping', 'attributeTypeMap'].includes(field.name)) {
+            continue;
+        }
+        // Add field JSDoc
+        if (field.jsDoc) {
+            lines.push(`  /** ${field.jsDoc} */`);
+        }
+        const optional = field.optional ? '?' : '';
+        const expandedType = expandType(field.type, '  ', 0, visited);
+        lines.push(`  ${field.name}${optional}: ${expandedType};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+//# sourceMappingURL=interfaceGenerator.js.map

package/dist/codegen/interfaceGenerator.js.map

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

package/dist/codegen/toolMapping.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Mapping of tool files to their Kubernetes types
+ */
+export interface ToolTypeMapping {
+    toolFile: string;
+    resultTypeName: string;
+    kubernetesType: string;
+    description?: string;
+}
+export declare const TOOL_TYPE_MAPPINGS: ToolTypeMapping[];
+//# sourceMappingURL=toolMapping.d.ts.map

package/dist/codegen/toolMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolMapping.d.ts","sourceRoot":"","sources":["../../src/codegen/toolMapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAyE/C,CAAC"}