@vibe-agent-toolkit/gateway-mcp 0.1.2-rc.4

package/README.md

@@ -0,0 +1,368 @@
+# @vibe-agent-toolkit/gateway-mcp
+
+MCP Gateway for exposing VAT agents through the Model Context Protocol, enabling orchestration by LLM systems like Claude Desktop.
+
+## Features
+
+- **Stdio Transport** - Native integration with Claude Desktop and other MCP clients
+- **Stateless Agent Support** - Pure Function Tools and One-Shot LLM Analyzers
+- **Multi-Agent Servers** - Expose multiple agents through a single MCP server
+- **Runtime Agnostic** - Works with any VAT runtime adapter (Vercel AI SDK, OpenAI, LangChain, Claude Agent SDK)
+- **Type-Safe** - Full TypeScript support with branded session IDs
+- **Error Classification** - Distinguishes retryable vs non-retryable errors for intelligent retry logic
+- **Observability Ready** - Hooks for OpenTelemetry integration (console logger included)
+
+## Installation
+
+```bash
+# Using bun
+bun add @vibe-agent-toolkit/gateway-mcp
+
+# Using npm
+npm install @vibe-agent-toolkit/gateway-mcp
+
+# Using pnpm
+pnpm add @vibe-agent-toolkit/gateway-mcp
+```
+
+## Quick Start
+
+### Single Agent Server
+
+Expose a single VAT agent via MCP stdio transport:
+
+```typescript
+import { StdioMCPGateway, NoOpObservabilityProvider } from '@vibe-agent-toolkit/gateway-mcp';
+import { haikuValidator } from '@vibe-agent-toolkit/vat-example-cat-agents';
+
+const gateway = new StdioMCPGateway({
+  name: 'haiku-validator-server',
+  version: '1.0.0',
+  agents: [
+    {
+      name: 'haiku-validator',
+      agent: haikuValidator,
+      runtime: null, // Pure function, no runtime needed
+    },
+  ],
+  observability: new NoOpObservabilityProvider(),
+});
+
+await gateway.start();
+```
+
+Run with:
+```bash
+bun run my-server.ts
+```
+
+### Multi-Agent Server
+
+Expose multiple agents through one MCP server:
+
+```typescript
+import { StdioMCPGateway, NoOpObservabilityProvider } from '@vibe-agent-toolkit/gateway-mcp';
+import { haikuValidator, photoAnalyzer } from '@vibe-agent-toolkit/vat-example-cat-agents';
+
+const gateway = new StdioMCPGateway({
+  name: 'vat-agents',
+  version: '1.0.0',
+  agents: [
+    {
+      name: 'haiku-validator',
+      agent: haikuValidator,
+      runtime: null, // Pure function
+    },
+    {
+      name: 'photo-analyzer',
+      agent: photoAnalyzer,
+      runtime: null, // Mock mode
+    },
+  ],
+  observability: new NoOpObservabilityProvider(),
+});
+
+await gateway.start();
+```
+
+## Claude Desktop Configuration
+
+Add to `~/.claude/config.json`:
+
+```json
+{
+  "mcpServers": {
+    "vat-agents": {
+      "command": "bun",
+      "args": ["run", "/absolute/path/to/your/server.ts"]
+    }
+  }
+}
+```
+
+**Notes:**
+- Use absolute paths (Claude Desktop doesn't expand `~` or relative paths)
+- Restart Claude Desktop after updating config
+- Check logs in Claude Desktop developer console if server doesn't connect
+
+## Architecture Overview
+
+### Design Principles
+
+1. **MCP is an interface, not a runtime** - Gateway exposes agents but doesn't execute them
+2. **Gateway discovers configured agents** - System startup registers agents, gateway provides access
+3. **Respect runtime patterns** - Each runtime manages state its own way (LangGraph checkpointers, OpenAI threads, etc.)
+4. **Archetype-aware** - Different agent types need different interface patterns (stateless vs stateful)
+5. **Separation of concerns** - MCP handles protocol translation and routing, runtimes handle execution and state
+
+### Layers
+
+```
+┌─────────────────────────────────────────────────┐
+│  External Systems (Claude Desktop, etc.)        │
+└─────────────────────────────────────────────────┘
+                      ↓
+┌─────────────────────────────────────────────────┐
+│  Interface Layer (Gateway)                      │
+│  ├─ MCP Server (stdio/HTTP)                     │
+│  └─ Stateless Adapter                           │
+└─────────────────────────────────────────────────┘
+                      ↓
+┌─────────────────────────────────────────────────┐
+│  VAT Agents (business logic)                    │
+│  ├─ Pure Function Tools                         │
+│  └─ One-Shot LLM Analyzers                      │
+└─────────────────────────────────────────────────┘
+```
+
+### Stdio Protocol Compliance
+
+**Critical constraint for Claude Desktop integration:**
+
+- **stdout** - JSON-RPC protocol messages ONLY (MCP spec requirement)
+- **stderr** - All logs, debug output, errors
+- **Process lifetime** - Server runs until stdin closes (natural stdio connection lifetime)
+
+Violating stdout purity breaks MCP clients with JSON parse errors. All logging infrastructure must write to stderr.
+
+### Package-Scoped Collections
+
+Agents are discovered via npm package exports:
+
+```typescript
+// Package: @my-scope/my-agents
+// Export: /mcp-collections
+
+export const myAgents: MCPCollection = {
+  name: 'my-agents',
+  description: 'My agent collection',
+  agents: [
+    { name: 'agent-1', agent: agent1, description: '...' },
+    { name: 'agent-2', agent: agent2, description: '...' },
+  ],
+};
+
+export const collections: Record<string, MCPCollection> = {
+  'my-agents': myAgents,
+};
+
+export const defaultCollection = myAgents;
+```
+
+CLI command: `vat mcp serve @my-scope/my-agents`
+
+**Future Enhancement**: Global discovery registry with versioning.
+
+### Key Concepts
+
+**Gateway is Passive** - Agents are already instantiated with their runtimes. The gateway discovers them and exposes them via MCP protocol.
+
+**Archetype-Aware** - Different agent archetypes map to different MCP patterns (stateless tools, conversational agents, orchestrations, etc.)
+
+**Runtime Separation** - MCP handles protocol translation and routing. Runtimes handle execution and state management.
+
+## Supported Archetypes
+
+### Pure Function Tool
+**Archetype:** `pure-function-tool`
+
+Direct synchronous functions with no LLM calls or external state.
+
+**MCP Mapping:**
+- One MCP tool = One VAT agent
+- No session state
+- Direct pass-through execution
+
+**Example:** Haiku validator
+
+### One-Shot LLM Analyzer
+**Archetype:** `one-shot-llm-analyzer`
+
+Single LLM call to analyze input and return structured output.
+
+**MCP Mapping:**
+- One MCP tool = One VAT agent
+- No session state (stateless LLM call)
+- Input → LLM → Structured output
+
+**Example:** Photo analyzer
+
+## Current Features
+
+**Implemented:**
+- ✅ Stdio transport for Claude Desktop
+- ✅ Stateless agent support (Pure Function Tools, One-Shot LLM Analyzers)
+- ✅ Multi-agent servers (multiple tools per server)
+- ✅ Package-scoped collections
+- ✅ CLI integration (`vat mcp serve <package>`)
+- ✅ Observability hooks (console logger included)
+- ✅ System tests for protocol compliance
+
+**Current Limitations:**
+- Process-per-server model (no multi-tenancy)
+- Single stdio connection (Claude Desktop spawns dedicated process)
+- No session state management (stateless agents only)
+
+## Planned Features
+
+**Stateful Agents:**
+- **Conversational Assistants** - Multi-turn conversations with session state
+- **Orchestrations** - Workflow coordination with sub-agents
+- **Event Integrators (HITL)** - Human-in-the-loop approval patterns
+
+**Transport & Discovery:**
+- **HTTP Transport** - Remote MCP servers with multiple concurrent connections
+- **Global Discovery Registry** - Namespace management and versioning
+
+**Observability:**
+- **Full OpenTelemetry Integration** - Traces, metrics, and structured logs
+
+## API Reference
+
+### `StdioMCPGateway`
+
+Creates an MCP gateway using stdio transport (for Claude Desktop).
+
+```typescript
+interface StdioMCPGatewayConfig {
+  name: string;                      // Server name
+  version: string;                   // Server version
+  agents: AgentRegistration[];       // Agents to expose
+  observability: ObservabilityProvider; // Logging and tracing
+}
+
+interface AgentRegistration {
+  name: string;                      // Tool name in MCP
+  agent: VATAgent;                   // VAT agent instance
+  runtime: RuntimeAdapter | null;    // Runtime adapter (or null for pure functions)
+}
+```
+
+**Methods:**
+- `start(): Promise<void>` - Start the MCP server on stdio
+
+**Example:**
+```typescript
+const gateway = new StdioMCPGateway({
+  name: 'my-agents',
+  version: '1.0.0',
+  agents: [{ name: 'my-tool', agent: myAgent, runtime: null }],
+  observability: new NoOpObservabilityProvider(),
+});
+
+await gateway.start();
+```
+
+### `NoOpObservabilityProvider`
+
+No-op implementation for when observability is not needed.
+
+```typescript
+const observability = new NoOpObservabilityProvider();
+```
+
+### `ConsoleLogger`
+
+Console-based logger for development (logs to stderr for MCP compatibility).
+
+```typescript
+import { ConsoleLogger } from '@vibe-agent-toolkit/gateway-mcp';
+
+const logger = new ConsoleLogger('my-server');
+logger.info('Server started', { port: 3000 });
+logger.error('Error occurred', { error: err });
+```
+
+### Error Handling
+
+The gateway translates VAT result envelopes to MCP responses:
+
+**VAT Result Envelope:**
+```typescript
+{
+  status: 'success' | 'error',
+  data?: TOutput,
+  error?: { type: string, message: string },
+  confidence?: number,
+  warnings?: string[]
+}
+```
+
+**MCP Tool Result:**
+```typescript
+{
+  content: [{ type: 'text', text: string }],
+  isError?: boolean
+}
+```
+
+**Error Classification:**
+- Retryable: `llm-rate-limit`, `llm-timeout`, `llm-unavailable`
+- Non-retryable: `llm-refusal`, `llm-invalid-output`, `invalid-input`
+
+## Examples
+
+See [examples/README.md](./examples/README.md) for:
+- Haiku validator server (Pure Function Tool)
+- Photo analyzer server (One-Shot LLM Analyzer)
+- Combined multi-agent server
+- Claude Desktop configuration examples
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Build package
+bun run build
+
+# Run tests
+bun run test
+
+# Run tests in watch mode
+bun run test:watch
+
+# Generate coverage report
+bun run test:coverage
+```
+
+## CLI Integration
+
+See [CLI MCP Commands Documentation](../cli/docs/mcp.md) for:
+- `vat mcp list-collections` - List available agent packages
+- `vat mcp serve <package>` - Start MCP server for a package
+- Claude Desktop configuration generation
+- Local development setup with `VAT_ROOT_DIR`
+
+## Design Documentation
+
+For complete architecture and future phases, see:
+- [State Persistence Patterns](../../docs/research/state-persistence-patterns.md)
+- [VAT Architecture](../../docs/architecture/README.md)
+
+**Note:** Detailed design documents (requirements, implementation plans) are kept in `docs/plans/` (gitignored). Architectural decisions and constraints are documented here in the README.
+
+## License
+
+MIT

package/dist/adapters/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Archetype adapters for MCP Gateway
+ *
+ * Each adapter handles a specific agent archetype (Pure Function, LLM Analyzer, Conversational, etc.)
+ */
+export { StatelessAdapter } from './stateless-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,7 @@
+/**
+ * Archetype adapters for MCP Gateway
+ *
+ * Each adapter handles a specific agent archetype (Pure Function, LLM Analyzer, Conversational, etc.)
+ */
+export { StatelessAdapter } from './stateless-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/adapters/stateless-adapter.d.ts

@@ -0,0 +1,27 @@
+import type { Agent, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+import type { ArchetypeAdapter, ConnectionId, MCPToolDefinition, MCPToolResult } from '../types.js';
+/**
+ * Adapter for stateless agents (Pure Function Tool, One-Shot LLM Analyzer)
+ *
+ * Direct pass-through with no session management.
+ * Maps agent.execute() → MCP tool result.
+ */
+export declare class StatelessAdapter implements ArchetypeAdapter {
+    readonly name = "stateless";
+    private readonly translator;
+    /**
+     * Create MCP tool definition from agent manifest
+     */
+    createToolDefinition(agent: Agent<unknown, unknown>): MCPToolDefinition;
+    /**
+     * Execute agent and return MCP result
+     */
+    execute(agent: Agent<unknown, OneShotAgentOutput<unknown, string>>, args: Record<string, unknown>, _connectionId: ConnectionId): Promise<MCPToolResult>;
+    /**
+     * Extract input schema from agent (will be enhanced in future)
+     *
+     * Phase 2: Extract from agent.manifest.interface.input or agent metadata
+     */
+    private extractInputSchema;
+}
+//# sourceMappingURL=stateless-adapter.d.ts.map

package/dist/adapters/stateless-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/stateless-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGlF,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpG;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IAErD;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,iBAAiB;IAUvE;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAC1D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,aAAa,EAAE,YAAY,GAC1B,OAAO,CAAC,aAAa,CAAC;IAQzB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/adapters/stateless-adapter.js

@@ -0,0 +1,46 @@
+import { ResultTranslator } from '../server/result-translator.js';
+/**
+ * Adapter for stateless agents (Pure Function Tool, One-Shot LLM Analyzer)
+ *
+ * Direct pass-through with no session management.
+ * Maps agent.execute() → MCP tool result.
+ */
+export class StatelessAdapter {
+    name = 'stateless';
+    translator = new ResultTranslator();
+    /**
+     * Create MCP tool definition from agent manifest
+     */
+    createToolDefinition(agent) {
+        const { manifest } = agent;
+        return {
+            name: manifest.name,
+            description: manifest.description ?? `Agent: ${manifest.name}`,
+            inputSchema: this.extractInputSchema(agent),
+        };
+    }
+    /**
+     * Execute agent and return MCP result
+     */
+    async execute(agent, args, _connectionId) {
+        // Direct pass-through, no session state needed
+        const output = await agent.execute(args);
+        // Translate VAT result envelope to MCP format
+        return this.translator.toMCPResult(output);
+    }
+    /**
+     * Extract input schema from agent (will be enhanced in future)
+     *
+     * Phase 2: Extract from agent.manifest.interface.input or agent metadata
+     */
+    extractInputSchema(agent) {
+        // For Phase 1, create a generic schema
+        return {
+            type: 'object',
+            properties: {},
+            additionalProperties: true,
+            description: `Input for ${agent.manifest.name}`,
+        };
+    }
+}
+//# sourceMappingURL=stateless-adapter.js.map

package/dist/adapters/stateless-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-adapter.js","sourceRoot":"","sources":["../../src/adapters/stateless-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,WAAW,CAAC;IACX,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAErD;;OAEG;IACH,oBAAoB,CAAC,KAA8B;QACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;QAE3B,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,UAAU,QAAQ,CAAC,IAAI,EAAE;YAC9D,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA0D,EAC1D,IAA6B,EAC7B,aAA2B;QAE3B,+CAA+C;QAC/C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEzC,8CAA8C;QAC9C,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACK,kBAAkB,CAAC,KAA8B;QACvD,uCAAuC;QACvC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,oBAAoB,EAAE,IAAI;YAC1B,WAAW,EAAE,aAAa,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE;SAChD,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @vibe-agent-toolkit/gateway-mcp
+ *
+ * MCP Gateway for exposing VAT agents through Model Context Protocol.
+ */
+export * from './types.js';
+export * from './observability/interfaces.js';
+export { NoOpObservabilityProvider } from './observability/no-op-provider.js';
+export { ConsoleLogger } from './observability/console-logger.js';
+export { MCPGateway } from './server/mcp-gateway.js';
+export { StdioMCPGateway } from './server/stdio-transport.js';
+export { StatelessAdapter } from './adapters/stateless-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @vibe-agent-toolkit/gateway-mcp
+ *
+ * MCP Gateway for exposing VAT agents through Model Context Protocol.
+ */
+// Core types
+export * from './types.js';
+// Observability (Task 3)
+export * from './observability/interfaces.js';
+export { NoOpObservabilityProvider } from './observability/no-op-provider.js';
+export { ConsoleLogger } from './observability/console-logger.js';
+// Server (Tasks 4-7)
+export { MCPGateway } from './server/mcp-gateway.js';
+export { StdioMCPGateway } from './server/stdio-transport.js';
+// Adapters (Tasks 5-6)
+export { StatelessAdapter } from './adapters/stateless-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,cAAc,YAAY,CAAC;AAE3B,yBAAyB;AACzB,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,qBAAqB;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,uBAAuB;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/observability/console-logger.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from '../types.js';
+/**
+ * Simple console-based logger for development
+ */
+export declare class ConsoleLogger implements Logger {
+    info(message: string, context?: Record<string, unknown>): void;
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=console-logger.d.ts.map

package/dist/observability/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../src/observability/console-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAY9E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAOhE"}

package/dist/observability/console-logger.js

@@ -0,0 +1,44 @@
+/**
+ * Simple console-based logger for development
+ */
+export class ConsoleLogger {
+    info(message, context) {
+        if (context) {
+            console.error(`[INFO] ${message}`, context);
+        }
+        else {
+            console.error(`[INFO] ${message}`);
+        }
+    }
+    error(message, error, context) {
+        if (error && context) {
+            console.error(`[ERROR] ${message}`, error, context);
+        }
+        else if (error) {
+            console.error(`[ERROR] ${message}`, error);
+        }
+        else if (context) {
+            console.error(`[ERROR] ${message}`, context);
+        }
+        else {
+            console.error(`[ERROR] ${message}`);
+        }
+    }
+    warn(message, context) {
+        if (context) {
+            console.warn(`[WARN] ${message}`, context);
+        }
+        else {
+            console.warn(`[WARN] ${message}`);
+        }
+    }
+    debug(message, context) {
+        if (context) {
+            console.error(`[DEBUG] ${message}`, context);
+        }
+        else {
+            console.error(`[DEBUG] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=console-logger.js.map

package/dist/observability/console-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.js","sourceRoot":"","sources":["../../src/observability/console-logger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAa,EAAE,OAAiC;QACrE,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/observability/interfaces.d.ts

@@ -0,0 +1,2 @@
+export type { Counter, Histogram, Logger, Meter, ObservabilityProvider, Span, Tracer, } from '../types.js';
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/observability/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/observability/interfaces.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,SAAS,EACT,MAAM,EACN,KAAK,EACL,qBAAqB,EACrB,IAAI,EACJ,MAAM,GACP,MAAM,aAAa,CAAC"}

package/dist/observability/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/observability/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/observability/interfaces.ts"],"names":[],"mappings":""}

package/dist/observability/no-op-provider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * No-op observability provider
+ *
+ * This file implements the Null Object pattern for observability.
+ * All methods are intentionally empty - they satisfy the interface
+ * contract without performing any operations.
+ *
+ * SonarQube: Empty methods are intentional (no-op pattern)
+ */
+import type { Logger, Meter, ObservabilityProvider, Tracer } from '../types.js';
+/**
+ * No-op observability provider (default when observability not configured)
+ */
+export declare class NoOpObservabilityProvider implements ObservabilityProvider {
+    private readonly logger;
+    private readonly tracer;
+    private readonly meter;
+    getLogger(): Logger;
+    getTracer(): Tracer;
+    getMeter(): Meter;
+}
+//# sourceMappingURL=no-op-provider.d.ts.map

package/dist/observability/no-op-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-provider.d.ts","sourceRoot":"","sources":["../../src/observability/no-op-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAGV,MAAM,EACN,KAAK,EACL,qBAAqB,EAErB,MAAM,EACP,MAAM,aAAa,CAAC;AAyCrB;;GAEG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,KAAK;CAGlB"}

package/dist/observability/no-op-provider.js

@@ -0,0 +1,59 @@
+/**
+ * No-op observability provider
+ *
+ * This file implements the Null Object pattern for observability.
+ * All methods are intentionally empty - they satisfy the interface
+ * contract without performing any operations.
+ *
+ * SonarQube: Empty methods are intentional (no-op pattern)
+ */
+class NoOpLogger {
+    info() { } // NOSONAR - intentional no-op
+    error() { } // NOSONAR - intentional no-op
+    warn() { } // NOSONAR - intentional no-op
+    debug() { } // NOSONAR - intentional no-op
+}
+class NoOpSpan {
+    setAttribute() { } // NOSONAR - intentional no-op
+    recordException() { } // NOSONAR - intentional no-op
+    setStatus() { } // NOSONAR - intentional no-op
+    end() { } // NOSONAR - intentional no-op
+}
+class NoOpTracer {
+    async startActiveSpan(_name, fn) {
+        const span = new NoOpSpan();
+        return fn(span);
+    }
+}
+class NoOpCounter {
+    add() { } // NOSONAR - intentional no-op
+}
+class NoOpHistogram {
+    record() { } // NOSONAR - intentional no-op
+}
+class NoOpMeter {
+    createCounter() {
+        return new NoOpCounter();
+    }
+    createHistogram() {
+        return new NoOpHistogram();
+    }
+}
+/**
+ * No-op observability provider (default when observability not configured)
+ */
+export class NoOpObservabilityProvider {
+    logger = new NoOpLogger();
+    tracer = new NoOpTracer();
+    meter = new NoOpMeter();
+    getLogger() {
+        return this.logger;
+    }
+    getTracer() {
+        return this.tracer;
+    }
+    getMeter() {
+        return this.meter;
+    }
+}
+//# sourceMappingURL=no-op-provider.js.map

package/dist/observability/no-op-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-provider.js","sourceRoot":"","sources":["../../src/observability/no-op-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,UAAU;IACd,IAAI,KAAU,CAAC,CAAC,8BAA8B;IAC9C,KAAK,KAAU,CAAC,CAAC,8BAA8B;IAC/C,IAAI,KAAU,CAAC,CAAC,8BAA8B;IAC9C,KAAK,KAAU,CAAC,CAAC,8BAA8B;CAChD;AAED,MAAM,QAAQ;IACZ,YAAY,KAAU,CAAC,CAAC,8BAA8B;IACtD,eAAe,KAAU,CAAC,CAAC,8BAA8B;IACzD,SAAS,KAAU,CAAC,CAAC,8BAA8B;IACnD,GAAG,KAAU,CAAC,CAAC,8BAA8B;CAC9C;AAED,MAAM,UAAU;IACd,KAAK,CAAC,eAAe,CAAI,KAAa,EAAE,EAA8B;QACpE,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;CACF;AAED,MAAM,WAAW;IACf,GAAG,KAAU,CAAC,CAAC,8BAA8B;CAC9C;AAED,MAAM,aAAa;IACjB,MAAM,KAAU,CAAC,CAAC,8BAA8B;CACjD;AAED,MAAM,SAAS;IACb,aAAa;QACX,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACnB,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAC1B,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAC1B,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IAEzC,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/server/mcp-gateway.d.ts

@@ -0,0 +1,45 @@
+import type { Agent, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+import type { AgentRegistration, ArchetypeAdapter, GatewayConfig, Logger, MCPToolDefinition, ObservabilityProvider } from '../types.js';
+/**
+ * Internal registration with resolved adapter
+ */
+interface ResolvedToolRegistration {
+    name: string;
+    agent: Agent<unknown, OneShotAgentOutput<unknown, string>>;
+    adapter: ArchetypeAdapter;
+    definition: MCPToolDefinition;
+}
+/**
+ * MCP Gateway - exposes VAT agents through Model Context Protocol
+ *
+ * Phase 1: Stdio transport, stateless agents only
+ */
+export declare class MCPGateway {
+    protected readonly tools: Map<string, ResolvedToolRegistration>;
+    protected readonly observability: ObservabilityProvider;
+    protected readonly logger: Logger;
+    protected readonly transport: 'stdio' | 'http';
+    constructor(config: GatewayConfig);
+    /**
+     * Register an agent with the gateway
+     */
+    protected registerAgent(registration: AgentRegistration): void;
+    /**
+     * Get adapter for archetype (Phase 1: stateless only)
+     */
+    protected getAdapter(archetype: string): ArchetypeAdapter;
+    /**
+     * Get all registered tool definitions (for MCP tools/list)
+     */
+    getToolDefinitions(): MCPToolDefinition[];
+    /**
+     * Get tool registration by name
+     */
+    protected getToolRegistration(name: string): ResolvedToolRegistration;
+    /**
+     * Start the gateway (to be implemented by transport-specific subclasses)
+     */
+    start(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=mcp-gateway.d.ts.map

package/dist/server/mcp-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-gateway.d.ts","sourceRoot":"","sources":["../../src/server/mcp-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAIlF,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,MAAM,EACN,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,SAAS,CAAC,QAAQ,CAAC,KAAK,wCAA+C;IACvE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IACxD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;gBAEnC,MAAM,EAAE,aAAa;IAgBjC;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI;IAyB9D;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAiBzD;;OAEG;IACH,kBAAkB,IAAI,iBAAiB,EAAE;IAIzC;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB;IAQrE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/server/mcp-gateway.js

@@ -0,0 +1,89 @@
+import { StatelessAdapter } from '../adapters/stateless-adapter.js';
+import { NoOpObservabilityProvider } from '../observability/no-op-provider.js';
+/**
+ * MCP Gateway - exposes VAT agents through Model Context Protocol
+ *
+ * Phase 1: Stdio transport, stateless agents only
+ */
+export class MCPGateway {
+    tools = new Map();
+    observability;
+    logger;
+    transport;
+    constructor(config) {
+        this.transport = config.transport;
+        this.observability = config.observability ?? new NoOpObservabilityProvider();
+        this.logger = this.observability.getLogger();
+        // Register all agents
+        for (const registration of config.agents) {
+            this.registerAgent(registration);
+        }
+        this.logger.info('MCPGateway initialized', {
+            transport: this.transport,
+            agentCount: this.tools.size,
+        });
+    }
+    /**
+     * Register an agent with the gateway
+     */
+    registerAgent(registration) {
+        const { agent } = registration;
+        const { manifest } = agent;
+        // Auto-detect adapter from archetype (or use provided adapter)
+        const adapter = registration.adapter ?? this.getAdapter(manifest.archetype);
+        // Create MCP tool definition
+        const definition = adapter.createToolDefinition(agent);
+        // Store registration
+        this.tools.set(registration.name, {
+            name: registration.name,
+            agent,
+            adapter,
+            definition,
+        });
+        this.logger.debug('Agent registered', {
+            name: registration.name,
+            archetype: manifest.archetype,
+            adapter: adapter.name,
+        });
+    }
+    /**
+     * Get adapter for archetype (Phase 1: stateless only)
+     */
+    getAdapter(archetype) {
+        switch (archetype) {
+            case 'pure-function':
+            case 'one-shot-llm-analyzer':
+                return new StatelessAdapter();
+            // Phase 2+: Add more archetypes
+            case 'conversational':
+            case 'orchestration':
+            case 'external-event-integrator':
+                throw new Error(`Unsupported archetype: ${archetype} (coming in Phase 2+)`);
+            default:
+                throw new Error(`Unknown archetype: ${archetype}`);
+        }
+    }
+    /**
+     * Get all registered tool definitions (for MCP tools/list)
+     */
+    getToolDefinitions() {
+        return [...this.tools.values()].map((reg) => reg.definition);
+    }
+    /**
+     * Get tool registration by name
+     */
+    getToolRegistration(name) {
+        const registration = this.tools.get(name);
+        if (!registration) {
+            throw new Error(`Tool not found: ${name}`);
+        }
+        return registration;
+    }
+    /**
+     * Start the gateway (to be implemented by transport-specific subclasses)
+     */
+    async start() {
+        throw new Error('start() must be implemented by transport-specific subclass');
+    }
+}
+//# sourceMappingURL=mcp-gateway.js.map

package/dist/server/mcp-gateway.js.map

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

package/dist/server/result-translator.d.ts

@@ -0,0 +1,24 @@
+import { type OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+import type { MCPToolResult } from '../types.js';
+/**
+ * Translates VAT agent results to MCP tool results
+ */
+export declare class ResultTranslator {
+    /**
+     * Convert VAT agent output envelope to MCP tool result
+     */
+    toMCPResult(agentOutput: OneShotAgentOutput<unknown, string>): MCPToolResult;
+    /**
+     * Format success data for MCP text response
+     */
+    private formatSuccess;
+    /**
+     * Format error for MCP text response
+     */
+    private formatError;
+    /**
+     * Type guard for conversational reply data
+     */
+    private isReplyData;
+}
+//# sourceMappingURL=result-translator.d.ts.map

package/dist/server/result-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-translator.d.ts","sourceRoot":"","sources":["../../src/server/result-translator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,aAAa;IA0B5E;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,WAAW;CAQpB"}

package/dist/server/result-translator.js

@@ -0,0 +1,78 @@
+import { RESULT_SUCCESS } from '@vibe-agent-toolkit/agent-schema';
+/**
+ * Translates VAT agent results to MCP tool results
+ */
+export class ResultTranslator {
+    /**
+     * Convert VAT agent output envelope to MCP tool result
+     */
+    toMCPResult(agentOutput) {
+        const { result } = agentOutput;
+        if (result.status === RESULT_SUCCESS) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: this.formatSuccess(result.data, result.confidence, result.warnings),
+                    },
+                ],
+                isError: false,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: this.formatError(result.error, result.confidence),
+                },
+            ],
+            isError: true,
+        };
+    }
+    /**
+     * Format success data for MCP text response
+     */
+    formatSuccess(data, confidence, warnings) {
+        const lines = [];
+        // If data has a reply field, return that directly (conversational)
+        if (this.isReplyData(data)) {
+            lines.push(data.reply);
+        }
+        else {
+            // Otherwise, return JSON
+            lines.push(JSON.stringify(data, null, 2));
+        }
+        // Add observability metadata if present
+        if (confidence !== undefined) {
+            lines.push(`\nConfidence: ${confidence}`);
+        }
+        if (warnings && warnings.length > 0) {
+            lines.push('\nWarnings:');
+            for (const warning of warnings) {
+                lines.push(`  • ${warning}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format error for MCP text response
+     */
+    formatError(errorType, confidence) {
+        const lines = [];
+        lines.push(`Error: ${errorType}`);
+        if (confidence !== undefined) {
+            lines.push(`Confidence: ${confidence}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Type guard for conversational reply data
+     */
+    isReplyData(data) {
+        return (typeof data === 'object' &&
+            data !== null &&
+            'reply' in data &&
+            typeof data.reply === 'string');
+    }
+}
+//# sourceMappingURL=result-translator.js.map

package/dist/server/result-translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-translator.js","sourceRoot":"","sources":["../../src/server/result-translator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2B,MAAM,kCAAkC,CAAC;AAI3F;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,WAAW,CAAC,WAAgD;QAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;QAE/B,IAAI,MAAM,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YACrC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC;qBAC1E;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;iBACxD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,IAAa,EACb,UAAmB,EACnB,QAAmB;QAEnB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,mEAAmE;QACnE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,wCAAwC;QACxC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,SAAiB,EAAE,UAAmB;QACxD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;QAElC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAa;QAC/B,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,KAAK,IAAI;YACb,OAAO,IAAI,IAAI;YACf,OAAQ,IAA2B,CAAC,KAAK,KAAK,QAAQ,CACvD,CAAC;IACJ,CAAC;CACF"}

package/dist/server/stdio-transport.d.ts

@@ -0,0 +1,16 @@
+import { MCPGateway } from './mcp-gateway.js';
+/**
+ * Stdio transport implementation for Claude Desktop
+ *
+ * Process lifetime = connection lifetime
+ * Single connection per process
+ */
+export declare class StdioMCPGateway extends MCPGateway {
+    private server?;
+    private readonly connectionId;
+    /**
+     * Start the stdio MCP server
+     */
+    start(): Promise<void>;
+}
+//# sourceMappingURL=stdio-transport.d.ts.map

package/dist/server/stdio-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-transport.d.ts","sourceRoot":"","sources":["../../src/server/stdio-transport.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAE7C,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;IAE3E;;OAEG;IACY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkGtC"}

package/dist/server/stdio-transport.js

@@ -0,0 +1,97 @@
+// eslint-disable-next-line sonarjs/deprecation -- Using Server for advanced request handling with stdio transport
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { createConnectionId } from '../types.js';
+import { MCPGateway } from './mcp-gateway.js';
+/**
+ * Stdio transport implementation for Claude Desktop
+ *
+ * Process lifetime = connection lifetime
+ * Single connection per process
+ */
+export class StdioMCPGateway extends MCPGateway {
+    // eslint-disable-next-line sonarjs/deprecation -- Server needed for request handler API
+    server;
+    connectionId = createConnectionId(`stdio-${process.pid}`);
+    /**
+     * Start the stdio MCP server
+     */
+    async start() {
+        this.logger.info('Starting stdio MCP gateway', {
+            connectionId: this.connectionId,
+            toolCount: this.tools.size,
+        });
+        // Create MCP server
+        // eslint-disable-next-line sonarjs/deprecation -- Server provides request handler registration API
+        this.server = new Server({
+            name: 'vat-agents',
+            version: '0.1.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Register tools/list handler
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = this.getToolDefinitions();
+            this.logger.debug('tools/list requested', { toolCount: tools.length });
+            return { tools };
+        });
+        // Register tools/call handler
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            this.logger.debug('Tool call received', {
+                tool: name,
+                connectionId: this.connectionId,
+            });
+            const tracer = this.observability.getTracer();
+            return tracer.startActiveSpan('tool.call', async (span) => {
+                span.setAttribute('tool', name);
+                span.setAttribute('connection', this.connectionId);
+                try {
+                    // Get tool registration
+                    const registration = this.getToolRegistration(name);
+                    // Execute via adapter
+                    const result = await registration.adapter.execute(registration.agent, args ?? {}, this.connectionId);
+                    span.setAttribute('status', result.isError ? 'error' : 'success');
+                    span.end();
+                    this.logger.info('Tool call completed', {
+                        tool: name,
+                        isError: result.isError,
+                    });
+                    // Return result (MCPToolResult is compatible with CallToolResult)
+                    return result;
+                }
+                catch (error) {
+                    span.recordException(error);
+                    span.setStatus({ code: 1 }); // Error status
+                    span.end();
+                    this.logger.error('Tool call failed', error, {
+                        tool: name,
+                        connectionId: this.connectionId,
+                    });
+                    // Return error as MCP result
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Internal error: ${error.message}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            });
+        });
+        // Connect stdio transport
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        this.logger.info('Stdio MCP gateway started', {
+            connectionId: this.connectionId,
+        });
+        // Log to stderr (stdout is reserved for MCP protocol)
+        console.error('[MCP Gateway] Ready - listening on stdio');
+    }
+}
+//# sourceMappingURL=stdio-transport.js.map

package/dist/server/stdio-transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+import type { Agent, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+/**
+ * Brand types for session identity (strong typing)
+ */
+export type ConnectionId = string & {
+    readonly __brand: 'ConnectionId';
+};
+export type ConversationId = string & {
+    readonly __brand: 'ConversationId';
+};
+export type RuntimeSessionId = string & {
+    readonly __brand: 'RuntimeSessionId';
+};
+export type TraceId = string & {
+    readonly __brand: 'TraceId';
+};
+/**
+ * MCP tool definition that will be exposed to MCP clients
+ */
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * MCP tool result (what MCP clients receive)
+ */
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Agent registration entry
+ */
+export interface AgentRegistration<TInput = unknown, TOutput = unknown> {
+    name: string;
+    agent: Agent<TInput, OneShotAgentOutput<TOutput, string>>;
+    adapter?: ArchetypeAdapter;
+}
+/**
+ * Gateway configuration
+ */
+export interface GatewayConfig {
+    agents: AgentRegistration[];
+    transport: 'stdio' | 'http';
+    observability?: ObservabilityProvider;
+}
+/**
+ * Archetype adapter interface (stateless for Phase 1)
+ */
+export interface ArchetypeAdapter {
+    readonly name: string;
+    /**
+     * Converts agent to MCP tool definition
+     */
+    createToolDefinition(agent: Agent<unknown, unknown>): MCPToolDefinition;
+    /**
+     * Executes agent and returns MCP-formatted result
+     */
+    execute(agent: Agent<unknown, unknown>, args: Record<string, unknown>, connectionId: ConnectionId): Promise<MCPToolResult>;
+}
+/**
+ * Observability provider interface (OTel-aligned)
+ */
+export interface ObservabilityProvider {
+    getLogger(): Logger;
+    getTracer(): Tracer;
+    getMeter(): Meter;
+}
+/**
+ * Logger interface (simplified for Phase 1)
+ */
+export interface Logger {
+    info(message: string, context?: Record<string, unknown>): void;
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Tracer interface (no-op for Phase 1, OTel-aligned)
+ */
+export interface Tracer {
+    startActiveSpan<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
+}
+/**
+ * Span interface (no-op for Phase 1, OTel-aligned)
+ */
+export interface Span {
+    setAttribute(key: string, value: string | number | boolean): void;
+    recordException(error: Error): void;
+    setStatus(status: {
+        code: number;
+    }): void;
+    end(): void;
+}
+/**
+ * Meter interface (no-op for Phase 1, OTel-aligned)
+ */
+export interface Meter {
+    createCounter(name: string): Counter;
+    createHistogram(name: string): Histogram;
+}
+/**
+ * Counter interface (no-op for Phase 1)
+ */
+export interface Counter {
+    add(value: number, attributes?: Record<string, string>): void;
+}
+/**
+ * Histogram interface (no-op for Phase 1)
+ */
+export interface Histogram {
+    record(value: number, attributes?: Record<string, string>): void;
+}
+/**
+ * Helper to create branded ConnectionId
+ */
+export declare function createConnectionId(id: string): ConnectionId;
+/**
+ * Helper to create branded ConversationId
+ */
+export declare function createConversationId(id: string): ConversationId;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * Helper to create branded ConnectionId
+ */
+export function createConnectionId(id) {
+    return id;
+}
+/**
+ * Helper to create branded ConversationId
+ */
+export function createConversationId(id) {
+    return id;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkIA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,OAAO,EAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,EAAoB,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@vibe-agent-toolkit/gateway-mcp",
+  "version": "0.1.2-rc.4",
+  "description": "MCP Gateway for exposing VAT agents through Model Context Protocol",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@vibe-agent-toolkit/agent-schema": "0.1.2-rc.4",
+    "@vibe-agent-toolkit/utils": "0.1.2-rc.4",
+    "@vibe-agent-toolkit/vat-example-cat-agents": "0.1.2-rc.4",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@vitest/coverage-v8": "^3.0.5",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agents",
+    "vat"
+  ],
+  "author": "Jeff Dutton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jdutton/vibe-agent-toolkit.git",
+    "directory": "packages/gateway-mcp"
+  }
+}