kubeview-mcp 1.3.0 → 1.4.1

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [1.4.0] - 2025-11-29
+
+### Added
+- **RunCode Tool Exposure**: Exposed `run_code` tool by default in standard mode alongside other tools.
+- **Code-Mode Prompt**: Added `code-mode` prompt for injecting the full TypeScript API documentation, tool overview, and examples into the context.
+
+### Changed
+- **Documentation**: Improved README.md to be more professional, valid, and concise.
+- **Name Change**: Changed name from `kubeview-mcp` to `kubeview` to align with the new MCP server name.
+- **Dependencies**: Updated deprecated dependencies.
+
+### Fixed
+- **Filter Logic**: `kube_list` now honors namespace/selector filters even when `resourceType` is omitted.
+- **Runtime Errors**: Fixed `ERR_MODULE_NOT_FOUND` for `typescript` package.
+- **Build Issues**: Resolved TypeScript compilation errors in `src/index.ts`.
+- **Logging**: Fixed "Required parameter name was null or undefined" error in `kube_log` and `kube_logs` tools.
+
 ## [1.3.0] - 2025-11-27
 
 ### Added
@@ -14,9 +33,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **TypeScript Transpilation**: Integrated TypeScript compiler for runtime transpilation of agent code (ES2022 target)
 - **Global Type Definitions**: Added `/sys/global.d.ts` resource providing TypeScript type definitions for all available tools
 - **Tool Executor**: Implemented tool executor allowing sandboxed code to call MCP tools internally
-- **Helper Functions**: Added `callMCPTool()`, `searchTools()`, and `getToolHelp()` helper functions for progressive tool discovery
+- **Helper Functions**: Added namespaced `tools.*` helpers for discovery (`tools.list()`, `tools.search()`, `tools.help()`, `tools.call()`) and execution
 - **Code-Mode Configuration**: Added `CodeModeConfig` with configurable sandbox limits (memory, timeout) and workspace settings
-- **Dual Mode Support**: Added `NODE_MODE=code` environment variable to run server in code-mode (exposes only `run_code` tool)
+- **Mode Support**: Added `MCP_MODE` environment variable with three modes:
+  - `code`: exposes only `run_code` tool
+  - `tools`: exposes only Kubernetes/Helm/Argo tools (no `run_code`)
+  - `all`: exposes both tools and `run_code` (default)
+  - Replaced `NODE_MODE=code` with `MCP_MODE=code|tools|all`
 
 ### Changed
 - **Plugin Architecture**: Removed version property from various tools plugins and MCPServer for simplified plugin management

package/README.md

@@ -4,300 +4,148 @@
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.8+-blue)](https://www.typescriptlang.org/)
 
-KubeView MCP is a read-only Model Context Protocol (MCP) server that exposes AI-friendly tools for safe Kubernetes, Helm, Argo Workflows, and Argo CD introspection. It pairs with Cursor IDE, Claude Code/Desktop, and other MCP clients to let you inspect, diagnose, and debug clusters via natural language and without any write operations.
+**KubeView** is a read-only Model Context Protocol (MCP) server that enables AI agents (like Cursor, Claude Desktop) to inspect, diagnose, and debug Kubernetes clusters safely. It provides a comprehensive set of tools for Kubernetes, Helm, Argo Workflows, and Argo CD.
 
 ---
 
 ## ✨ Features
 
-- **Kubernetes tools (read-only)**: list, get/describe, metrics, single-pod logs, multi-pod streaming logs with event merge, exec (read-only), port-forward, and in-cluster network diagnostics
-- **Cluster overview**: one-shot, LLM-optimized diagnostics across nodes, workloads, storage, events, and security posture
-- **Helm integration**: list releases; fetch values, manifest, notes, hooks, history, status, and parsed resources
-- **Argo Workflows**: list/get workflows and fetch workflow logs
-- **Argo CD**: list/get app details, resources, history, logs, and status via a single multi-operation tool
-- **Sensitive data masking**: global redaction for secrets/tokens in ConfigMaps, Secrets, and Helm values
-- **Zero write access**: designed to be safe in production from day one
+- **🛡️ Read-Only & Safe**: Designed for production safety with zero write access and sensitive data masking.
+- **☸️ Kubernetes Integration**: List/get resources, fetch metrics, stream logs, execute commands, and diagnose network issues.
+- **📦 Helm Support**: Inspect releases, values, manifests, and history.
+- **🐙 Argo Ecosystem**: Manage Argo Workflows and Argo CD applications.
+- **🧠 Code Mode**: Sandboxed TypeScript environment for complex reasoning and multi-step workflows.
 
 ---
 
 ## 🚀 Quick Start
 
-Add to your MCP client config:
+### Prerequisites
 
-```json
-{
-  "mcpServers": {
-    "kubeview-mcp": {
-      "command": "npx",
-      "args": ["-y", "https://github.com/mikhae1/kubeview-mcp"],
-      "env": {
-        "KUBECONFIG": "$HOME/.kube/config"
-      }
-    }
-  }
-}
+- Node.js ≥ 18
+- Access to a Kubernetes cluster
+- Optional CLIs on current $PATH if you want to use those plugins: `helm`, `argo`, `argocd`
+
+### Installation
+
+Run directly with `npx`:
+
+```bash
+npx -y kubeview-mcp
 ```
 
-If you want to use code-mode only (heavy context tasks, like logs parsing, etc.):
+### Configuration for MCP Clients
+
+Add to your `mcpServers` configuration (e.g., in Cursor or Claude Desktop):
 
 ```json
 {
   "mcpServers": {
-    "kubeview-mcp": {
+    "kubeview": {
       "command": "npx",
-      "args": ["-y", "https://github.com/mikhae1/kubeview-mcp"],
-      "env": {
-        "KUBECONFIG": "$HOME/.kube/config",
-        "NODE_MODE": "code"
-      }
+      "args": ["-y", "kubeview-mcp"]
     }
   }
 }
 ```
 
-### Prerequisites
-
-- Node.js ≥ 18
-- Access to a Kubernetes cluster (kubeconfig)
-- Optional CLIs on PATH if you want to use those plugins: `helm`, `argo`, `argocd`
+### Environment Variables
 
-### Local install
+Configure the server using environment variables:
 
-#### npx
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KUBECONFIG` | Path to kubeconfig file | `~/.kube/config` |
+| `MCP_MODE` | Server mode: `all`, `code`, or `tools` | `all` |
+| `MCP_LOG_LEVEL` | Log level (`error`, `warn`, `info`, `debug`) | `info` |
+| `MCP_HIDE_SENSITIVE` | Enable global sensitive data masking | `false` |
 
-```bash
-npx -y https://github.com/mikhae1/kubeview-mcp
-```
+---
 
-#### git
+## 🛠️ Tools Overview
 
-```bash
-git clone https://github.com/mikhae1/kubeview-mcp.git
-cd kubeview-mcp
-npm install
+### Kubernetes
+- **`kube_list`**: List resources or get cluster diagnostics.
+- **`kube_get`**: Describe specific resources (supports all K8s types).
+- **`kube_metrics`**: Fetch CPU/memory metrics for nodes and pods.
+- **`kube_logs`**: Fetch or stream container logs.
+- **`kube_exec`**: Execute commands in containers (read-only recommended).
+- **`kube_port`**: Port-forward to pods/services.
+- **`kube_net`**: Run in-cluster network diagnostics.
 
-# Generate local MCP config entries for Cursor and/or Claude Desktop
-npm run setup
-```
+### Helm
+- **`helm_list`**: List Helm releases.
+- **`helm_get`**: Fetch release values, manifests, and history.
 
-### Run
+### Argo
+- **`argo_list` / `argo_get`**: Manage Argo Workflows.
+- **`argocd_app`**: Inspect Argo CD applications and resources.
 
-```bash
-# Build and start
-npm run build
-npm start
+### Utilities
+- **`run_code`**: Execute sandboxed TypeScript code for complex tasks.
 
-# Or use the bundled binary wrapper
-kubeview-mcp serve
+> **Note**: For detailed parameter usage, the AI agent can query the tool definitions directly.
 
-# Launch the code-mode runtime (see section below)
-npm run code-mode
-```
+---
 
-## 🧠 Code-Mode Execution
+## 🧠 Code Mode
 
-Inspired by [Code execution with MCP](https://www.anthropic.com/engineering/code-execution-with-mcp), KubeView now ships with a code-mode runtime that lets agents explore generated TypeScript API, search tools progressively, and run sandboxed workflows without piping giant schemas through the model context.
+Inspired by [Code execution with MCP](https://www.anthropic.com/engineering/code-execution-with-mcp), KubeView ships with a code-mode runtime that allows agents to explore the API, search tools, and execute complex workflows in a sandboxed environment.
 
 ### What it provides
 
-- **MCP bridge layer** – connects to MCP server tools.
-- **Schema→TypeScript codegen** – converts every tool schema into `generated/servers/<server>/<tool>.ts` wrappers plus runtime helpers (`generated/runtime/*`), so agents can `import` strongly-typed helpers instead of copying JSON schemas.
-- **Tool search utilities** – manifests + runtime helpers (`toolSearch.ts`, `search_tools` MCP tool) let agents progressively discover servers and tools without loading everything upfront.
-- **Sandboxed execution** – `isolated-vm` powers a locked-down Node.js-like environment with controlled `console`, MCP tool access, and a scoped filesystem bridge.
-- **Stateful workspace & skills** – the sandbox exposes a safe filesystem rooted at `./workspace`, including a `skills/` folder with a `SKILL.md` convention for reusable snippets.
-
-### How to use
+- **MCP Bridge Layer**: Seamlessly connects to all registered MCP server tools.
+- **Dynamic TypeScript Definitions**: Automatically converts tool schemas into a strongly-typed `global.d.ts` resource, enabling agents to use valid TypeScript patterns and enjoy type safety without hallucinating parameters.
+- **Tool Search Utilities**: Runtime helpers like `tools.search()` and `tools.list()` allow agents to progressively discover capabilities without needing to load the entire schema context upfront.
+- **Sandboxed Execution**: A locked-down Node.js environment (via `vm`) with controlled access to the `console` and the `tools` global object, ensuring safe execution of agent-generated code.
 
-#### Exposing only the code-mode entry tool
+### Usage
 
-To present a single `run_code` tool to your MCP client (and force all heavy work through the filesystem runtime), start the server with `NODE_MODE=code`, e.g.:
+For complex tasks requiring logic, loops, or data processing, use **Code Mode**:
 
-```bash
-NODE_MODE=code npx -y https://github.com/mikhae1/kubeview-mcp
+```json
+"env": { "MCP_MODE": "code" }
 ```
 
-In this mode the server registers only the `run_code` tool, which accepts the following parameters:
+### 💡 Pro Tip: Code Mode Prompt
 
-```ts
-{
-  code: string;          // required – snippet you plan to execute in the sandbox
-  input?: string;        // optional stdin payload
-}
-```
+The server includes a built-in prompt named **`code-mode`** that injects the full TypeScript API documentation, tool overview, and examples into the context.
 
-Calling `run_code` doesn’t execute anything inside the MCP process; instead it returns the generated filesystem tree (`generated/servers/...`, `generated/runtime/...`) plus instructions for launching `kubeview-mcp-code-mode` / `npm run code-mode`, keeping the MCP handshake tiny while the real work happens inside the sandbox.
+**In Cursor IDE**:
+Simply type `/kubeview/code-mode` in the prompt (or select it from the `/` prompt menu). This gives the AI the exact context it needs to write correct `run_code` scripts immediately.
 
-### Manually setting up the sandbox
+---
+
+## 💻 Local Development
 
-1. Copy the sample config and edit it for your environment:
+1. **Clone & Install**:
    ```bash
-   cp kube-mcp.code-mode.example.json kube-mcp.code-mode.json
+   git clone https://github.com/mikhae1/kubeview-mcp.git
+   cd kubeview-mcp
+   npm install
    ```
-2. Build the project so the CLI wrapper can import the compiled entrypoint:
+
+2. **Build & Run**:
    ```bash
    npm run build
+   npm start
    ```
-3. Edit `workspace/main.ts` (auto-created on first run) to import generated helpers:
 
-4. Run the runtime (or use the new `kubeview-mcp-code-mode` binary):
+3. **Test**:
    ```bash
-   npm run code-mode
-   # or
-   kubeview-mcp-code-mode
+   npm test
    ```
 
-Generated modules call back into real MCP servers via the sandbox bridge, so large responses stay in the execution environment and only summaries hit the model context.
+### CLI Usage
 
-The runtime writes everything under `generated/` and `workspace/`. Clean them up at any time to force regeneration.
-
-## 📟 Tool Index (CLI)
-
-Invoke tools with the helper:
+You can test tools directly via the CLI:
 
 ```bash
-npm run command -- <tool_name> [--param=value ...]
-```
-
-### Kubernetes
-
-- **kube_list**: List resources or, when no `resourceType` is provided, return a cluster diagnostics overview
-  - Params: `resourceType`, `namespace`, `labelSelector`, `fieldSelector`
-  - Supported `resourceType` for listing: `pod`, `service`, `deployment`, `node`, `namespace`, `persistentvolume`, `persistentvolumeclaim`, `secret`, `configmap`, `role`, `clusterrole`, `rolebinding`, `clusterrolebinding`
-- **kube_get**: Describe a single resource or list a type using plural, kind, shortname, or fully-qualified `group/version/resource`
-  - Params: `resourceType` (required), `name`, `namespace`, `includeEvents`, `includeDiagnostics`, `eventsLimit`, `restartThreshold`, `skipSanitize` (for ConfigMaps)
-- **kube_metrics**: Node and pod CPU/memory metrics, optional Prometheus enrichment and diagnostics
-  - Params: `scope` (`all|nodes|pods`), `namespace`, `podName`, `includeSummary`, `diagnostics`, `prometheusQueries[]`, `fetchPodSpecs`, thresholds (`topN`, `cpuSaturationThreshold`, `memorySaturationThreshold`, `podRestartThreshold`, `podLimitPressureThreshold`)
-- **kube_logs**: Pod/container logs (like `kubectl logs`)
-  - Params: `podName` (required), `namespace`, `container`, `tailLines`, `since`, `previous`, `timestamps`
-- **kube_log**: Multi-pod & multi-container log tail with dynamic discovery and merged Events
-  - Selectors: `namespace`, `labelSelector`, `ownerKind` (`Deployment|DaemonSet|Job`), `ownerName`
-  - Filters: `podRegex`, `containerRegex`, `messageRegex`, `excludeRegex`, `jsonPaths` (e.g., `[{"path":"level","equals":"error"}]`)
-  - Time/tail: `tailLines`, `since` (e.g., `15m`), `sinceTime` (RFC3339), `timestamps`, `previous`
-  - Session bounds: `durationSeconds` (default 30), `maxLines`
-  - Events: `includeEvents` (default true), `eventType` (`Normal|Warning|All`)
-  - Output: `structure` (`object|text`). In object mode each line has `type: 'log'|'event'`. In text mode events are prefixed with `[event]`.
-- **kube_exec**: Execute a command in a container via Kubernetes API only; returns stdout/stderr
-  - Params: `podName` (required), `namespace`, `container`, `args[]` | `argv` | `command`, `stdin`, `tty`, `timeoutSeconds`, `shell`
-- **kube_port**: Temporary port-forward to a pod or service (auto-terminates)
-  - Params: `namespace`, `podName` | `serviceName`, `remotePort` (required), `localPort`, `address`, `timeoutSeconds`, `readinessTimeoutSeconds`
-- **kube_net**: In-pod network diagnostics (DNS resolution, internet egress, pod/service connectivity)
-  - Params: `sourcePod` (required), `namespace`, `container`, `targetPod`, `targetPodNamespace`, `targetService`, `targetServiceNamespace`, `targetPort`, `externalHost`, `externalPort`, `dnsNames[]`, toggles: `runDnsTest`, `runInternetTest`, `runPodConnectivityTest`, `runServiceConnectivityTest`, `timeoutSeconds`
-
-### Helm
-
-- **helm_list**: List Helm releases
-  - Params: `namespace`, `allNamespaces`, `outputFormat`, `selector`, `maxReleases`, `deployed`, `failed`, `pending`, `superseded`, `uninstalled`, `uninstalling`
-- **helm_get**: Get release data
-  - Params: `what` (`values|manifest|notes|hooks|resources|status|history`), `releaseName` (required), `namespace`, `revision`, `outputFormat`, `allValues`, `resourceType`, `showResources`
-
-### Argo Workflows
-
-- **argo_list**: List workflows with rich filters
-  - Params: `namespace`, `allNamespaces`, `outputFormat`, `selector`, status flags (`running|succeeded|failed|pending|completed|status`), `since`, `chunked`, `maxWorkflows`
-- **argo_get**: Get workflow details
-  - Params: `workflowName` (required), `namespace`, `outputFormat`, `showParameters`, `showArtifacts`, `showEvents`, `nodeFieldSelector`
-- **argo_logs**: Get workflow logs
-  - Params: `workflowName` (required), `namespace`, `container`, `follow`, `previous`, `since`, `sinceTime`, `tail`, `timestamps`, `grep`, `noColor`
-
-### Argo CD
-
-- **argocd_app**: Multi-operation tool for Argo CD apps
-  - Params: `operation` (`list|get|resources|logs|history|status`) plus operation-specific flags (`appName`, `outputFormat`, `selector`, `project`, `cluster`, `namespace`, `repo`, `health`, `sync`, `server`, `grpcWeb`, `plaintext`, `insecure`, `refresh`, `hardRefresh`, `group`, `kind`, `name`, `container`, `follow`, `previous`, `since`, `sinceTime`, `tail`, `timestamps`)
-
----
-
-## ⚙️ Configuration
-
-Provide env vars via your MCP client config or shell.
-
-- **KUBECONFIG**: Path to kubeconfig (default: `$HOME/.kube/config`)
-- **MCP_LOG_LEVEL**: `error|warn|info|debug`
-- **MCP_LOG_ENABLE**: `true|1` to enable server file logging (default: disabled)
-- **MCP_LOG_FILE**: Path to server log file (default when enabled: `kubeview-mcp.log`)
-- **MCP_TIMEOUT**: Global per-tool timeout in ms (applies to all tools)
-- CLI timeouts: **MCP_HELM_TIMEOUT**, **MCP_ARGO_TIMEOUT**, **MCP_ARGOCD_TIMEOUT** (ms)
-- CLI executable overrides: **MCP_HELM_PATH**, **MCP_ARGO_PATH**, **MCP_ARGOCD_PATH**
-- Plugin toggles: **MCP_DISABLE_KUBERNETES_PLUGIN**, **MCP_DISABLE_HELM_PLUGIN**, **MCP_DISABLE_ARGO_PLUGIN**, **MCP_DISABLE_ARGOCD_PLUGIN** (`true|1` to disable)
-- Kubernetes options: **MCP_KUBE_CONTEXT**, **MCP_K8S_SKIP_TLS_VERIFY** (`true|1`)
-
-Example (Cursor `mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "kubeview-mcp": {
-      "command": "npx",
-      "args": ["-y", "https://github.com/mikhae1/kubeview-mcp"],
-      "env": {
-        "KUBECONFIG": "$HOME/.kube/config",
-        "MCP_LOG_LEVEL": "info",
-        "MCP_HELM_TIMEOUT": "45000",
-        "MCP_DISABLE_ARGO_PLUGIN": "1"
-      }
-    }
-  }
-}
-```
-
----
-
-## 🔒 Sensitive Data Masking
-
-Global masking prevents accidental disclosure of secrets (enabled when any of the flags below are set):
-
-- Enable: `MCP_HIDE_SENSITIVE` or `MCP_HIDE_SENSITIVE_DATA` or `MCP_MASK_SENSITIVE_DATA` → `true|1|yes|on`
-- Mask text override: `MCP_SENSITIVE_MASK` (default: `*** FILTERED ***`)
-
-Effects:
-
-- ConfigMaps: values redacted by key/value heuristics; forcing `skipSanitize=true` on `kube_get` will still be overridden by global masking
-- Secrets: list/describe returns only key names; values are masked
-- Helm: `helm_get` with `what=values` applies masking on returned text
-
----
-
-## 💡 Examples
-
-```bash
-# Cluster diagnostics overview (no resourceType)
-npm run command -- kube_list
-
-# Pods in a namespace
-npm run command -- kube_list --resourceType=pod --namespace=default
-
-# Describe a deployment with events and diagnostics
-npm run command -- kube_get --resourceType=deployment --name=web --namespace=prod
-
-# Metrics summary with diagnostics
-npm run command -- kube_metrics --includeSummary=true --diagnostics=true
-
-# Logs from a pod (last 200 lines)
-npm run command -- kube_logs --podName=nginx-123 --namespace=default --tailLines=200
-
-# Stream logs across pods by owner with events (10 minutes back)
-npm run command -- kube_log --namespace=prod --ownerKind=Deployment --ownerName=api --since=10m --includeEvents=true --durationSeconds=20
-
-# Filter by labels and container name, text output
-npm run command -- kube_log --namespace=default --labelSelector='app=db,tier=api' --containerRegex='^(main|sidecar)$' --structure=text --durationSeconds=15
-
-# Only errors from JSON logs
-npm run command -- kube_log --namespace=prod --labelSelector='app=my-api' --jsonPaths='[{"path":"level","equals":"error"}]' --messageRegex='timeout|exception' --since=30m --durationSeconds=20
-
-# Only events (text mode)
-npm run command -- kube_log --namespace=default --includeEvents=true --structure=text --messageRegex='^\\[event\\]' --durationSeconds=10
-
-# Port-forward service 80 -> local 8080 for 90s
-npm run command -- kube_port --serviceName=my-svc --namespace=default --remotePort=80 --localPort=8080 --timeoutSeconds=90
-
-# Network diagnostics from a pod
-npm run command -- kube_net --sourcePod=api-0 --namespace=prod --targetService=db --runServiceConnectivityTest=true
-
-# Helm release values (masked)
-npm run command -- helm_get --what=values --releaseName=my-release --namespace=default --allValues=true
+npm run command -- kube_list --namespace=default
 ```
 
 ---
 
 ## 📄 License
 
-MIT – see `LICENSE`.
+MIT © [kubeview-mcp team](https://github.com/mikhae1/kubeview-mcp)

package/TODO.md

@@ -1,2 +1,2 @@
 - kube_logs (multiple log streams + events, selectors support)
--
+- add support for k8s context selector

package/bin/kubeview-mcp.js

@@ -154,7 +154,10 @@ class KubeMCPCLI {
 
     try {
       // Determine the correct index path after build
-      const finalIndexPath = fs.existsSync(indexPathFlat) ? indexPathFlat : indexPathNested;
+      // Prefer the nested path because the TypeScript build outputs to dist/src by default.
+      // Older builds may leave a flat dist/index.js behind, which can point to stale artifacts
+      // (e.g., missing version.cjs). Prioritizing the nested path avoids those mismatches.
+      const finalIndexPath = fs.existsSync(indexPathNested) ? indexPathNested : indexPathFlat;
 
       // Debug: Check if the file actually exists
       if (!fs.existsSync(finalIndexPath)) {

package/bin/setup.js

@@ -343,11 +343,12 @@ class SetupManager {
     console.log('Add the following to your mcp.json (e.g. ~/.cursor/mcp.json):\n');
     console.log(`{
   "mcpServers": {
-    "kubeview-mcp": {
+    "kubeview": {
       "command": "npx",
-      "args": ["https://github.com/mikhae1/kubeview-mcp"],
+      "args": ["-y", "kubeview-mcp"],
       "env": {
-        "KUBECONFIG": "$HOME/.kube/config"
+        "KUBECONFIG": "$HOME/.kube/config",
+        "MCP_MODE": "all"
       }
     }
   }

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

@@ -62,6 +62,5 @@ export declare class ToolDescriptionBuilder {
     private generateExamples;
     private groupByServer;
     private truncate;
-    private toCamelCase;
 }
 //# sourceMappingURL=ToolDescriptionBuilder.d.ts.map

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

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

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

@@ -1,3 +1,4 @@
+import { formatToolAccessor } from '../../utils/toolNamespaces.js';
 /**
  * Generates tool descriptions with progressive disclosure for LLM agents.
  * Layer 1: Overview tree - compact tool listing
@@ -16,16 +17,20 @@ export class ToolDescriptionBuilder {
         const grouped = this.groupByServer(tools);
         const lines = [];
         for (const [server, serverTools] of grouped) {
-            lines.push(`/${server}/`);
+            // Skip server header for "local" server
+            if (server !== 'local') {
+                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 accessor = formatToolAccessor(tool.toolName);
                 const shortDesc = this.truncate(tool.description, 50);
-                lines.push(`  ${prefix}${fn}()${shortDesc ? ' - ' + shortDesc : ''}`);
+                const indent = server === 'local' ? '' : '  ';
+                lines.push(`${indent}${prefix}${accessor}()${shortDesc ? ' - ' + shortDesc : ''}`);
             }
         }
-        return lines.join('\n');
+        return lines.length > 0 ? lines.join('\n') : '';
     }
     /**
      * Layer 2: Generate compact signatures for specified tools
@@ -47,7 +52,7 @@ export class ToolDescriptionBuilder {
         const params = this.extractParameters(tool.inputSchema);
         return {
             name: tool.toolName,
-            camelName: this.toCamelCase(tool.toolName),
+            camelName: formatToolAccessor(tool.toolName),
             description: tool.description ?? '',
             parameters: params,
             examples: this.generateExamples(tool),
@@ -68,11 +73,11 @@ export class ToolDescriptionBuilder {
         if (hiddenCount > 0) {
             paramStr += `, ...`; // indicate more params
         }
-        const fn = this.toCamelCase(tool.toolName);
-        const signature = params.length > 0 ? `${fn}({ ${paramStr} })` : `${fn}()`;
+        const accessor = formatToolAccessor(tool.toolName);
+        const signature = params.length > 0 ? `${accessor}({ ${paramStr} })` : `${accessor}()`;
         return {
             name: tool.toolName,
-            camelName: fn,
+            camelName: accessor,
             signature: hiddenCount > 0 ? `${signature} // +${hiddenCount} params` : signature,
             shortDescription: this.truncate(tool.description, 60),
             hiddenParamCount: hiddenCount,
@@ -126,22 +131,22 @@ export class ToolDescriptionBuilder {
     }
     generateExamples(tool) {
         const examples = [];
-        const fn = this.toCamelCase(tool.toolName);
+        const accessor = formatToolAccessor(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}({})` });
+            examples.push({ description: 'List all', code: `await ${accessor}({})` });
             if (paramNames.has('namespace')) {
                 examples.push({
                     description: 'Filter by namespace',
-                    code: `await ${fn}({ namespace: 'default' })`,
+                    code: `await ${accessor}({ namespace: 'default' })`,
                 });
             }
             if (paramNames.has('allNamespaces')) {
                 examples.push({
                     description: 'All namespaces',
-                    code: `await ${fn}({ allNamespaces: true })`,
+                    code: `await ${accessor}({ allNamespaces: true })`,
                 });
             }
         }
@@ -153,30 +158,30 @@ export class ToolDescriptionBuilder {
                     : 'kind';
             examples.push({
                 description: 'Get resource',
-                code: `await ${fn}({ ${nameParam}: 'my-resource' })`,
+                code: `await ${accessor}({ ${nameParam}: 'my-resource' })`,
             });
         }
         else if (tool.toolName.includes('log')) {
             examples.push({
                 description: 'Tail logs',
-                code: `await ${fn}({ podName: 'my-pod', tailLines: 100 })`,
+                code: `await ${accessor}({ 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'] })`,
+                code: `await ${accessor}({ podName: 'my-pod', namespace: 'default', command: ['ls', '-la'] })`,
             });
         }
         else if (tool.toolName.includes('metrics')) {
             examples.push({
                 description: 'Get metrics',
-                code: `await ${fn}({})`,
+                code: `await ${accessor}({})`,
             });
         }
         // Fallback
         if (examples.length === 0) {
-            examples.push({ description: 'Basic usage', code: `await ${fn}({})` });
+            examples.push({ description: 'Basic usage', code: `await ${accessor}({})` });
         }
         return examples;
     }
@@ -194,8 +199,5 @@ export class ToolDescriptionBuilder {
             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/src/agent/codegen/ToolDescriptionBuilder.js.map

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