@orchestrator-claude/mcp-server 1.4.0

package/.mcp.json.example

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "orchestrator": {
+      "command": "orchestrator-mcp-server",
+      "env": {
+        "MCP_DEBUG": "false",
+        "ORCHESTRATOR_API_URL": "http://localhost:3000"
+      }
+    }
+  }
+}

package/README.md

@@ -0,0 +1,180 @@
+# @orchestrator/mcp-server
+
+> MCP server for Orchestrator - thin client forwarding to REST API
+
+## Overview
+
+This package provides an MCP (Model Context Protocol) server that exposes Orchestrator functionality to Claude Code and other MCP-compatible clients.
+
+**Architecture**: This is a **thin client** that forwards all requests to the Orchestrator REST API. It contains NO business logic, only request transformation and error handling.
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @orchestrator/mcp-server
+```
+
+### Local Installation
+
+```bash
+npm install @orchestrator/mcp-server
+```
+
+## Configuration
+
+### Prerequisites
+
+1. **REST API Server Running**: The MCP server requires the Orchestrator REST API to be running.
+
+   ```bash
+   # Start API server (in main orchestrator project)
+   docker-compose up -d
+   # OR
+   npm start
+   ```
+
+2. **API Key**: Generate an API key using the CLI:
+
+   ```bash
+   orchestrator auth generate
+   ```
+
+   This creates `~/.orchestrator/config.json` with your API key.
+
+### Claude Code Integration
+
+Add to your Claude Code config (`.mcp.json` or Claude settings):
+
+```json
+{
+  "mcpServers": {
+    "orchestrator": {
+      "command": "orchestrator-mcp-server"
+    }
+  }
+}
+```
+
+### Environment Variables
+
+- `MCP_DEBUG=true` - Enable debug logging
+- `ORCHESTRATOR_API_URL` - Override API URL (default: `http://localhost:3000`)
+
+## Available Tools
+
+### Workflow Management
+
+- `getStatus` - Get workflow status
+- `advancePhase` - Advance workflow to next phase
+- `approveAction` - Approve pending action
+- `getContext` (v2) - Get workflow context and available actions
+- `executeAction` (v2) - Execute deterministic action
+
+### Project Management
+
+- `detectWorkflow` - Detect workflow type from prompt
+- `validateArtifact` - Validate generated artifacts
+- `createCheckpoint` - Create git checkpoint
+
+### Ping-Pong Pattern (LIM-001 Solution)
+
+- `getNextAction` - Get next pending action
+- `setPendingAction` - Set pending action for agent invocation
+- `clearPendingAction` - Clear pending action
+- `approveAction` - Approve action requiring human approval
+
+## Architecture
+
+```
+Claude Code
+    ↓
+MCP Server (thin client)
+    ↓
+REST API (business logic)
+    ↓
+Domain/Application/Infrastructure Layers
+```
+
+**Key Principles:**
+
+1. **No Business Logic**: All logic resides in REST API
+2. **Stateless**: No state stored in MCP server
+3. **Simple Transformation**: Request → API Call → Response
+4. **Error Forwarding**: API errors forwarded to Claude
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+### Running Locally
+
+```bash
+# With debug logging
+MCP_DEBUG=true npm start
+```
+
+## Troubleshooting
+
+### "API server unavailable"
+
+1. Check if REST API is running:
+   ```bash
+   curl http://localhost:3000/api/v1/health
+   ```
+
+2. Check if API key is configured:
+   ```bash
+   cat ~/.orchestrator/config.json
+   ```
+
+3. Regenerate API key if needed:
+   ```bash
+   orchestrator auth generate
+   ```
+
+### "API key not configured"
+
+Run:
+```bash
+orchestrator auth generate
+```
+
+### MCP Server Not Found in Claude
+
+1. Ensure global installation:
+   ```bash
+   npm list -g @orchestrator/mcp-server
+   ```
+
+2. Restart Claude Code after installing
+
+3. Check Claude Code logs for MCP connection errors
+
+## Version Compatibility
+
+| MCP Server | Orchestrator CLI | REST API |
+|------------|------------------|----------|
+| 0.9.x      | >= 0.9.0         | >= 0.9.0 |
+| 1.0.x      | >= 1.0.0         | >= 1.0.0 |
+
+## License
+
+MIT
+
+## Support
+
+- [Documentation](https://docs.orchestrator.ai)
+- [GitHub Issues](https://github.com/your-org/orchestrator/issues)
+- [Discord Community](https://discord.gg/orchestrator)

package/dist/client/OrchestratorApiClient.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OrchestratorApiClient
+ *
+ * REST API client that makes HTTP requests to the Orchestrator API.
+ * Implements all 18 MCP tool methods.
+ */
+import type { Config } from '../config.js';
+import type { IOrchestratorApiClient } from './types.js';
+export declare class OrchestratorApiClient implements IOrchestratorApiClient {
+    private config;
+    constructor(config: Config);
+    /**
+     * Makes HTTP request to API
+     */
+    private request;
+    detectWorkflow(prompt: string): Promise<unknown>;
+    startWorkflow(type: string, prompt: string): Promise<unknown>;
+    advancePhase(workflowId: string): Promise<unknown>;
+    getStatus(workflowId?: string): Promise<unknown>;
+    getContext(workflowId?: string): Promise<unknown>;
+    executeAction(workflowId: string, action: string, prompt?: string): Promise<unknown>;
+    canAdvance(workflowId: string, targetPhase: string): Promise<unknown>;
+    evaluateGate(workflowId: string, targetPhase: string): Promise<unknown>;
+    createCheckpoint(workflowId: string, description: string): Promise<unknown>;
+    validateArtifact(artifactId: string): Promise<unknown>;
+    getNextAction(workflowId?: string): Promise<unknown>;
+    setPendingAction(workflowId: string, action: unknown): Promise<unknown>;
+    clearPendingAction(workflowId: string, result?: unknown): Promise<unknown>;
+    approveAction(workflowId: string): Promise<unknown>;
+    getMetrics(workflowId?: string): Promise<unknown>;
+    getInvocations(workflowId?: string, limit?: number): Promise<unknown>;
+    startAgentInvocation(agentName: string, phase: string, workflowId?: string): Promise<unknown>;
+    completeAgentInvocation(invocationId: string, status: string, summary?: string): Promise<unknown>;
+}
+//# sourceMappingURL=OrchestratorApiClient.d.ts.map

package/dist/client/OrchestratorApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorApiClient.d.ts","sourceRoot":"","sources":["../../src/client/OrchestratorApiClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B;;OAEG;YACW,OAAO;IAiCf,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhD,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpF,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASrE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtD,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnD,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjD,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMrE,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;IAQb,uBAAuB,CAC3B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;CAOpB"}

package/dist/client/OrchestratorApiClient.js

@@ -0,0 +1,121 @@
+/**
+ * OrchestratorApiClient
+ *
+ * REST API client that makes HTTP requests to the Orchestrator API.
+ * Implements all 18 MCP tool methods.
+ */
+import { McpApiError } from '../errors/McpApiError.js';
+export class OrchestratorApiClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Makes HTTP request to API
+     */
+    async request(method, path, body) {
+        const url = `${this.config.apiUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.config.apiKey) {
+            headers['X-API-Key'] = this.config.apiKey;
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (!response.ok) {
+            let errorBody = {};
+            try {
+                errorBody = (await response.json());
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+            throw McpApiError.fromHttpResponse(response.status, errorBody);
+        }
+        return response.json();
+    }
+    // Workflow Methods (Part 1)
+    async detectWorkflow(prompt) {
+        return this.request('POST', '/api/v1/workflows/detect', { prompt });
+    }
+    async startWorkflow(type, prompt) {
+        return this.request('POST', '/api/v1/workflows', { type, prompt });
+    }
+    async advancePhase(workflowId) {
+        return this.request('PUT', `/api/v1/workflows/${workflowId}/advance`, {});
+    }
+    async getStatus(workflowId) {
+        if (workflowId) {
+            return this.request('GET', `/api/v1/workflows/${workflowId}/status`);
+        }
+        return this.request('GET', '/api/v1/workflows/status');
+    }
+    async getContext(workflowId) {
+        const id = workflowId || 'active';
+        return this.request('GET', `/api/v1/workflows/${id}/context`);
+    }
+    async executeAction(workflowId, action, prompt) {
+        const body = { action };
+        if (prompt) {
+            body.prompt = prompt;
+        }
+        return this.request('POST', `/api/v1/workflows/${workflowId}/action`, body);
+    }
+    async canAdvance(workflowId, targetPhase) {
+        return this.request('GET', `/api/v1/workflows/${workflowId}/can-advance?targetPhase=${encodeURIComponent(targetPhase)}`);
+    }
+    // Gate & Checkpoint Methods (Part 2)
+    async evaluateGate(workflowId, targetPhase) {
+        return this.request('POST', `/api/v1/workflows/${workflowId}/gate`, { targetPhase });
+    }
+    async createCheckpoint(workflowId, description) {
+        return this.request('POST', `/api/v1/workflows/${workflowId}/checkpoint`, { description });
+    }
+    async validateArtifact(artifactId) {
+        return this.request('POST', `/api/v1/artifacts/${artifactId}/validate`, {});
+    }
+    // Pending Action Methods (Part 2)
+    async getNextAction(workflowId) {
+        const id = workflowId || 'active';
+        return this.request('GET', `/api/v1/workflows/${id}/pending-action`);
+    }
+    async setPendingAction(workflowId, action) {
+        return this.request('POST', `/api/v1/workflows/${workflowId}/pending-action`, action);
+    }
+    async clearPendingAction(workflowId, result) {
+        return this.request('DELETE', `/api/v1/workflows/${workflowId}/pending-action`, result);
+    }
+    async approveAction(workflowId) {
+        return this.request('POST', `/api/v1/workflows/${workflowId}/pending-action/approve`, {});
+    }
+    // Metrics Methods (Part 2)
+    async getMetrics(workflowId) {
+        const id = workflowId || 'active';
+        return this.request('GET', `/api/v1/workflows/${id}/metrics`);
+    }
+    async getInvocations(workflowId, limit) {
+        const id = workflowId || 'active';
+        const query = limit ? `?limit=${limit}` : '';
+        return this.request('GET', `/api/v1/workflows/${id}/invocations${query}`);
+    }
+    async startAgentInvocation(agentName, phase, workflowId) {
+        const body = { agentName, phase };
+        if (workflowId) {
+            body.workflowId = workflowId;
+        }
+        return this.request('POST', '/api/v1/invocations/start', body);
+    }
+    async completeAgentInvocation(invocationId, status, summary) {
+        const body = { status };
+        if (summary) {
+            body.summary = summary;
+        }
+        return this.request('POST', `/api/v1/invocations/${invocationId}/complete`, body);
+    }
+}
+//# sourceMappingURL=OrchestratorApiClient.js.map

package/dist/client/OrchestratorApiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorApiClient.js","sourceRoot":"","sources":["../../src/client/OrchestratorApiClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY,EAAE,IAAc;QACnE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QAE3C,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;SACjD,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,SAAS,GAAuC,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;YACD,MAAM,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;IAED,4BAA4B;IAE5B,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,MAAc;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,UAAU,UAAU,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,UAAmB;QACjC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,UAAU,SAAS,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAmB;QAClC,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,MAAc,EAAE,MAAe;QACrE,MAAM,IAAI,GAAQ,EAAE,MAAM,EAAE,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,UAAU,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,WAAmB;QACtD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,qBAAqB,UAAU,4BAA4B,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAC7F,CAAC;IACJ,CAAC;IAED,qCAAqC;IAErC,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,WAAmB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,UAAU,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,WAAmB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,UAAU,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,UAAU,WAAW,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,kCAAkC;IAElC,KAAK,CAAC,aAAa,CAAC,UAAmB;QACrC,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,MAAe;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,UAAU,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,UAAkB,EAAE,MAAgB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,qBAAqB,UAAU,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAC1F,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,UAAU,yBAAyB,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,2BAA2B;IAE3B,KAAK,CAAC,UAAU,CAAC,UAAmB;QAClC,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAmB,EAAE,KAAc;QACtD,MAAM,EAAE,GAAG,UAAU,IAAI,QAAQ,CAAC;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,EAAE,eAAe,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,SAAiB,EACjB,KAAa,EACb,UAAmB;QAEnB,MAAM,IAAI,GAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACvC,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,YAAoB,EACpB,MAAc,EACd,OAAgB;QAEhB,MAAM,IAAI,GAAQ,EAAE,MAAM,EAAE,CAAC;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,YAAY,WAAW,EAAE,IAAI,CAAC,CAAC;IACpF,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * API Client Module
+ *
+ * Barrel export for OrchestratorApiClient and types.
+ */
+export { OrchestratorApiClient } from './OrchestratorApiClient.js';
+export type { IOrchestratorApiClient } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,7 @@
+/**
+ * API Client Module
+ *
+ * Barrel export for OrchestratorApiClient and types.
+ */
+export { OrchestratorApiClient } from './OrchestratorApiClient.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * API Client Types
+ *
+ * Type definitions for the OrchestratorApiClient interface.
+ */
+export interface IOrchestratorApiClient {
+    detectWorkflow(prompt: string): Promise<unknown>;
+    startWorkflow(type: string, prompt: string): Promise<unknown>;
+    advancePhase(workflowId: string): Promise<unknown>;
+    getStatus(workflowId?: string): Promise<unknown>;
+    getContext(workflowId?: string): Promise<unknown>;
+    executeAction(workflowId: string, action: string, prompt?: string): Promise<unknown>;
+    canAdvance(workflowId: string, targetPhase: string): Promise<unknown>;
+    evaluateGate(workflowId: string, targetPhase: string): Promise<unknown>;
+    createCheckpoint(workflowId: string, description: string): Promise<unknown>;
+    validateArtifact(artifactId: string): Promise<unknown>;
+    getNextAction(workflowId?: string): Promise<unknown>;
+    setPendingAction(workflowId: string, action: unknown): Promise<unknown>;
+    clearPendingAction(workflowId: string, result?: unknown): Promise<unknown>;
+    approveAction(workflowId: string): Promise<unknown>;
+    getMetrics(workflowId?: string): Promise<unknown>;
+    getInvocations(workflowId?: string, limit?: number): Promise<unknown>;
+    startAgentInvocation(agentName: string, phase: string, workflowId?: string): Promise<unknown>;
+    completeAgentInvocation(invocationId: string, status: string, summary?: string): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,sBAAsB;IAErC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGjD,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGtE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGvD,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGpD,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9F,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnG"}

package/dist/client/types.js

@@ -0,0 +1,7 @@
+/**
+ * API Client Types
+ *
+ * Type definitions for the OrchestratorApiClient interface.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration Module
+ *
+ * Loads configuration from environment variables.
+ */
+export interface Config {
+    apiUrl: string;
+    apiKey?: string;
+    timeout: number;
+}
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAYnC"}

package/dist/config.js

@@ -0,0 +1,17 @@
+/**
+ * Configuration Module
+ *
+ * Loads configuration from environment variables.
+ */
+export function loadConfig() {
+    const apiUrl = process.env.ORCHESTRATOR_API_URL;
+    if (!apiUrl) {
+        throw new Error('ORCHESTRATOR_API_URL environment variable is required');
+    }
+    return {
+        apiUrl: apiUrl.replace(/\/+$/, ''), // Remove trailing slashes
+        apiKey: process.env.ORCHESTRATOR_API_KEY,
+        timeout: parseInt(process.env.ORCHESTRATOR_API_TIMEOUT || '30000', 10),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,0BAA0B;QAC9D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACxC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,EAAE,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/errors/McpApiError.d.ts

@@ -0,0 +1,23 @@
+/**
+ * McpApiError
+ *
+ * Custom error class for API errors.
+ * Converts HTTP errors to MCP-compatible format.
+ */
+export declare class McpApiError extends Error {
+    readonly statusCode: number;
+    readonly type?: string | undefined;
+    constructor(statusCode: number, message: string, type?: string | undefined);
+    static fromHttpResponse(status: number, body: {
+        detail?: string;
+        type?: string;
+    }): McpApiError;
+    toMcpError(): {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    };
+}
+//# sourceMappingURL=McpApiError.d.ts.map

package/dist/errors/McpApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpApiError.d.ts","sourceRoot":"","sources":["../../src/errors/McpApiError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,WAAY,SAAQ,KAAK;aAElB,UAAU,EAAE,MAAM;aAElB,IAAI,CAAC,EAAE,MAAM;gBAFb,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;IAM/B,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAK9F,UAAU,IAAI;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE;CAMhF"}

package/dist/errors/McpApiError.js

@@ -0,0 +1,27 @@
+/**
+ * McpApiError
+ *
+ * Custom error class for API errors.
+ * Converts HTTP errors to MCP-compatible format.
+ */
+export class McpApiError extends Error {
+    statusCode;
+    type;
+    constructor(statusCode, message, type) {
+        super(message);
+        this.statusCode = statusCode;
+        this.type = type;
+        this.name = 'McpApiError';
+    }
+    static fromHttpResponse(status, body) {
+        const message = body.detail || `HTTP ${status} error`;
+        return new McpApiError(status, message, body.type);
+    }
+    toMcpError() {
+        return {
+            content: [{ type: 'text', text: `Error (${this.statusCode}): ${this.message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=McpApiError.js.map

package/dist/errors/McpApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpApiError.js","sourceRoot":"","sources":["../../src/errors/McpApiError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IAEA;IAHlB,YACkB,UAAkB,EAClC,OAAe,EACC,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAElB,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,MAAc,EAAE,IAAwC;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,MAAM,QAAQ,CAAC;QACtD,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,UAAU;QACR,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAChF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/handlers/context-handlers.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Context Handlers
+ *
+ * MCP tool handlers for V2 context API:
+ * - getContext
+ * - executeAction
+ * - canAdvance
+ */
+import type { IOrchestratorApiClient } from '../client/types.js';
+/**
+ * Handler for getContext tool
+ */
+export declare function createGetContextHandler(client: IOrchestratorApiClient): (params: {
+    workflowId?: string;
+}) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+/**
+ * Handler for executeAction tool
+ */
+export declare function createExecuteActionHandler(client: IOrchestratorApiClient): (params: {
+    workflowId: string;
+    action: string;
+    prompt?: string;
+}) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+/**
+ * Handler for canAdvance tool
+ */
+export declare function createCanAdvanceHandler(client: IOrchestratorApiClient): (params: {
+    workflowId: string;
+    targetPhase: string;
+}) => Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=context-handlers.d.ts.map

package/dist/handlers/context-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/context-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,IACtD,QAAQ;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;GAa9C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB,IACzD,QAAQ;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;GAiB9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,sBAAsB,IACtD,QAAQ;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;GAalE"}

package/dist/handlers/context-handlers.js

@@ -0,0 +1,67 @@
+/**
+ * Context Handlers
+ *
+ * MCP tool handlers for V2 context API:
+ * - getContext
+ * - executeAction
+ * - canAdvance
+ */
+import { McpApiError } from '../errors/McpApiError.js';
+/**
+ * Handler for getContext tool
+ */
+export function createGetContextHandler(client) {
+    return async (params) => {
+        try {
+            const response = await client.getContext(params.workflowId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof McpApiError) {
+                return error.toMcpError();
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Handler for executeAction tool
+ */
+export function createExecuteActionHandler(client) {
+    return async (params) => {
+        try {
+            const response = await client.executeAction(params.workflowId, params.action, params.prompt);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof McpApiError) {
+                return error.toMcpError();
+            }
+            throw error;
+        }
+    };
+}
+/**
+ * Handler for canAdvance tool
+ */
+export function createCanAdvanceHandler(client) {
+    return async (params) => {
+        try {
+            const response = await client.canAdvance(params.workflowId, params.targetPhase);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        catch (error) {
+            if (error instanceof McpApiError) {
+                return error.toMcpError();
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=context-handlers.js.map