@llm-dev-ops/agentics-cli 1.4.25 → 1.4.27

package/dist/bundled-agents/copilot-agents/lib/functions/src/cors.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * CORS Middleware for Cloud Functions
+ *
+ * Handles preflight requests and sets CORS headers on all responses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCorsHeaders = setCorsHeaders;
+exports.handlePreflight = handlePreflight;
+const ALLOWED_ORIGINS = [
+    'https://agentics.dev',
+    'https://console.agentics.dev',
+    'https://us-central1-agentics-dev.cloudfunctions.net',
+];
+const ALLOWED_METHODS = 'GET, POST, OPTIONS';
+const ALLOWED_HEADERS = 'Content-Type, Authorization, X-Correlation-Id, X-Request-Id';
+const MAX_AGE = '3600';
+/**
+ * Set CORS headers on the response
+ */
+function setCorsHeaders(res) {
+    // Allow any origin for now (can be restricted via ALLOWED_ORIGINS in production)
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', ALLOWED_METHODS);
+    res.setHeader('Access-Control-Allow-Headers', ALLOWED_HEADERS);
+    res.setHeader('Access-Control-Max-Age', MAX_AGE);
+}
+/**
+ * Handle CORS preflight (OPTIONS) request
+ */
+function handlePreflight(res) {
+    res.writeHead(204);
+    res.end();
+}
+//# sourceMappingURL=cors.js.map

package/dist/bundled-agents/copilot-agents/lib/functions/src/cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../../src/cors.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAiBH,wCAMC;AAKD,0CAGC;AA3BD,MAAM,eAAe,GAAG;IACtB,sBAAsB;IACtB,8BAA8B;IAC9B,qDAAqD;CACtD,CAAC;AAEF,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,MAAM,eAAe,GAAG,6DAA6D,CAAC;AACtF,MAAM,OAAO,GAAG,MAAM,CAAC;AAEvB;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAe;IAC5C,iFAAiF;IACjF,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,eAAe,CAAC,CAAC;IAC/D,GAAG,CAAC,SAAS,CAAC,8BAA8B,EAAE,eAAe,CAAC,CAAC;IAC/D,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAe;IAC7C,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACnB,GAAG,CAAC,GAAG,EAAE,CAAC;AACZ,CAAC"}

package/dist/bundled-agents/copilot-agents/lib/functions/src/envelope.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Response Envelope
+ *
+ * Every response from copilot-agents MUST include:
+ * - execution_metadata (trace_id, timestamp, service, execution_id)
+ * - layers_executed (routing + agent layer with status and duration)
+ */
+export interface ExecutionMetadata {
+    trace_id: string;
+    timestamp: string;
+    service: 'copilot-agents';
+    execution_id: string;
+}
+export interface LayerExecuted {
+    layer: string;
+    status: 'completed' | 'error';
+    duration_ms?: number;
+}
+export interface EnvelopedResponse {
+    data: unknown;
+    execution_metadata: ExecutionMetadata;
+    layers_executed: LayerExecuted[];
+}
+/**
+ * Wrap any response payload with execution_metadata and layers_executed
+ */
+export declare function wrapResponse(data: unknown, executionMetadata: ExecutionMetadata, layersExecuted: LayerExecuted[]): EnvelopedResponse;

package/dist/bundled-agents/copilot-agents/lib/functions/src/envelope.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Response Envelope
+ *
+ * Every response from copilot-agents MUST include:
+ * - execution_metadata (trace_id, timestamp, service, execution_id)
+ * - layers_executed (routing + agent layer with status and duration)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapResponse = wrapResponse;
+/**
+ * Wrap any response payload with execution_metadata and layers_executed
+ */
+function wrapResponse(data, executionMetadata, layersExecuted) {
+    return {
+        data,
+        execution_metadata: executionMetadata,
+        layers_executed: layersExecuted,
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/bundled-agents/copilot-agents/lib/functions/src/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/envelope.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAwBH,oCAUC;AAbD;;GAEG;AACH,SAAgB,YAAY,CAC1B,IAAa,EACb,iBAAoC,EACpC,cAA+B;IAE/B,OAAO;QACL,IAAI;QACJ,kBAAkB,EAAE,iBAAiB;QACrC,eAAe,EAAE,cAAc;KAChC,CAAC;AACJ,CAAC"}

package/dist/bundled-agents/copilot-agents/lib/functions/src/health.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Health Check Handler
+ *
+ * Returns the status of all 7 copilot agents.
+ * Agents: planner, config, decomposer, clarifier, intent, reflection, meta-reasoner
+ */
+export interface AgentHealthStatus {
+    agent: string;
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    version: string;
+}
+export interface HealthResponse {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    service: string;
+    version: string;
+    agents: AgentHealthStatus[];
+    uptime_seconds: number;
+}
+/**
+ * Build health check response for all agents
+ */
+export declare function handleHealth(): HealthResponse;

package/dist/bundled-agents/copilot-agents/lib/functions/src/health.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Health Check Handler
+ *
+ * Returns the status of all 7 copilot agents.
+ * Agents: planner, config, decomposer, clarifier, intent, reflection, meta-reasoner
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHealth = handleHealth;
+const SERVICE_START_TIME = Date.now();
+const AGENT_REGISTRY = [
+    { name: 'planner', version: '1.0.0' },
+    { name: 'config', version: '1.0.0' },
+    { name: 'decomposer', version: '1.0.0' },
+    { name: 'clarifier', version: '1.0.0' },
+    { name: 'intent', version: '1.0.0' },
+    { name: 'reflection', version: '1.0.0' },
+    { name: 'meta-reasoner', version: '1.0.0' },
+];
+/**
+ * Build health check response for all agents
+ */
+function handleHealth() {
+    const agents = AGENT_REGISTRY.map(agent => ({
+        agent: agent.name,
+        status: 'healthy',
+        version: agent.version,
+    }));
+    const allHealthy = agents.every(a => a.status === 'healthy');
+    return {
+        status: allHealthy ? 'healthy' : 'degraded',
+        service: 'copilot-agents',
+        version: '1.0.0',
+        agents,
+        uptime_seconds: Math.floor((Date.now() - SERVICE_START_TIME) / 1000),
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/bundled-agents/copilot-agents/lib/functions/src/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/health.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA+BH,oCAgBC;AA/BD,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAEtC,MAAM,cAAc,GAA6C;IAC/D,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE;IACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;IACpC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE;IACxC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE;IACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;IACpC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE;IACxC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE;CAC5C,CAAC;AAEF;;GAEG;AACH,SAAgB,YAAY;IAC1B,MAAM,MAAM,GAAwB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/D,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,MAAM,EAAE,SAAkB;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC;IAEJ,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;QAC3C,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,OAAO;QAChB,MAAM;QACN,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,kBAAkB,CAAC,GAAG,IAAI,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/bundled-agents/copilot-agents/lib/functions/src/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Cloud Function Entry Point: copilot-agents
+ *
+ * Unified HTTP handler for all 7 copilot agents.
+ * Deploy: gcloud functions deploy copilot-agents --runtime nodejs20 --trigger-http
+ *         --region us-central1 --project agentics-dev --entry-point handler
+ *         --memory 512MB --timeout 120s --no-allow-unauthenticated
+ *
+ * Routes:
+ *   POST /v1/copilot/planner       → Planner Agent
+ *   POST /v1/copilot/config        → Config Validation Agent
+ *   POST /v1/copilot/decomposer    → Decomposer Agent
+ *   POST /v1/copilot/clarifier     → Objective Clarifier Agent
+ *   POST /v1/copilot/intent        → Intent Classifier Agent
+ *   POST /v1/copilot/reflection    → Reflection Agent
+ *   POST /v1/copilot/meta-reasoner → Meta-Reasoner Agent
+ *   GET  /health                    → Health check
+ */
+import { IncomingMessage, ServerResponse } from 'http';
+export interface CfRequest extends IncomingMessage {
+    body?: unknown;
+    rawBody?: Buffer;
+}
+export interface CfResponse extends ServerResponse {
+    status?: (code: number) => CfResponse;
+    json?: (data: unknown) => void;
+    send?: (data: string | Buffer) => void;
+}
+/**
+ * Main Cloud Function handler
+ *
+ * Entry point name: handler
+ */
+export declare function handler(req: CfRequest, res: CfResponse): Promise<void>;

package/dist/bundled-agents/copilot-agents/lib/functions/src/index.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * Cloud Function Entry Point: copilot-agents
+ *
+ * Unified HTTP handler for all 7 copilot agents.
+ * Deploy: gcloud functions deploy copilot-agents --runtime nodejs20 --trigger-http
+ *         --region us-central1 --project agentics-dev --entry-point handler
+ *         --memory 512MB --timeout 120s --no-allow-unauthenticated
+ *
+ * Routes:
+ *   POST /v1/copilot/planner       → Planner Agent
+ *   POST /v1/copilot/config        → Config Validation Agent
+ *   POST /v1/copilot/decomposer    → Decomposer Agent
+ *   POST /v1/copilot/clarifier     → Objective Clarifier Agent
+ *   POST /v1/copilot/intent        → Intent Classifier Agent (LLM-based)
+ *   POST /v1/copilot/reflection    → Reflection Agent
+ *   POST /v1/copilot/meta-reasoner → Meta-Reasoner Agent
+ *   GET  /health                    → Health check
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = handler;
+const crypto = __importStar(require("crypto"));
+const router_1 = require("./router");
+const health_1 = require("./health");
+const cors_1 = require("./cors");
+const envelope_1 = require("./envelope");
+/**
+ * Parse JSON body from request
+ */
+function parseBody(req) {
+    // Cloud Functions automatically parse JSON bodies into req.body
+    if (req.body !== undefined) {
+        return req.body;
+    }
+    return undefined;
+}
+/**
+ * Send JSON response
+ */
+function sendJson(res, statusCode, data) {
+    res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(data));
+}
+/**
+ * LLM-based intent classification using the end-user's Anthropic API key.
+ * Calls claude-3-haiku with the domain registry to classify the user query
+ * into a specific domain/agent pair.
+ */
+async function classifyIntentWithLLM(apiKey, body) {
+    const query = body.text || (body.payload && body.payload.query) || '';
+    const availableDomains = (body.payload && body.payload.available_domains) || {};
+
+    // Build a concise domain/agent listing for the system prompt
+    const domainLines = [];
+    for (const [domain, info] of Object.entries(availableDomains)) {
+        const agents = info.agents || [];
+        domainLines.push(`  ${domain}: [${agents.join(', ')}] (${info.phase || ''})`);
+    }
+
+    const systemPrompt = `You are an intent classifier for the Agentics AI agent platform. Given a user's natural language query, determine which domain and agent should handle it.
+
+Available domains and their agents:
+${domainLines.join('\n')}
+
+Domain descriptions for context:
+- test-bench: Evaluation, benchmarking, quality testing, hallucination detection, red-teaming, adversarial testing
+- observatory: Telemetry, usage patterns, failure analysis, health checks, SLO monitoring, post-mortems
+- shield: Security - prompt injection detection, PII detection, redaction, secrets scanning, toxicity, safety, moderation, abuse detection, credential exposure
+- sentinel: Anomaly detection, drift detection, alerting, correlation analysis, root cause analysis
+- memory-graph: Conversation memory, lineage tracking, decision logging, knowledge graphs, retrieval, pattern detection
+- latency-lens: Latency analysis, cold-start optimization
+- forge: SDK generation, CLI tooling, API translation, version compatibility
+- edge: Tool invocation, circuit breaking, failover, execution guards, caching
+- auto-optimizer: Self-optimization, token usage optimization, model selection
+- incident-manager: Escalation, post-mortems, human-in-the-loop
+- orchestrator: Workflow orchestration, DAG execution, parallel pipelines, scheduling
+- compliance: Audit trails, data residency, consent management, regulation checking
+- cost-tracker: Budget tracking, cost forecasting, chargeback, usage metering
+- gateway: Rate limiting, load balancing, API key management, request transformation
+- federation: Multi-provider routing, consensus, provider health, model routing
+- versioning: A/B testing, canary deployment, rollback, feature flags, traffic splitting
+- context-engine: Context window management, summarization, chunking, compression, priority
+- feedback-loop: User feedback, RLHF, annotation, preference learning, active learning
+- plugin-marketplace: Plugin search, installation, validation, dependency management, sandboxing
+- migration: Schema migration, data migration, rollback, state verification, compatibility
+- deployment: Blue-green deployment, canary release, rollback, health monitoring, traffic management
+- copilot: Planning, config validation, decomposition, clarification, intent classification, reflection, meta-reasoning
+
+Respond with ONLY a valid JSON object. No markdown fences, no explanation outside the JSON:
+{
+  "domain": "<domain-name>",
+  "agent": "<agent-name>",
+  "confidence": <number between 0.0 and 1.0>,
+  "suggested_payload": { "query": "<the user's original query>" },
+  "reasoning": "<one sentence explaining the classification>"
+}
+
+Rules:
+- Pick the single best domain/agent match from the available list
+- confidence 0.8-1.0 for clear, unambiguous matches
+- confidence 0.5-0.8 for reasonable but uncertain matches
+- confidence below 0.3 if no domain/agent is a good match (set domain and agent to empty strings)
+- The agent value MUST be one of the agents listed for the chosen domain`;
+
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+            model: 'claude-3-haiku-20240307',
+            max_tokens: 300,
+            system: systemPrompt,
+            messages: [{ role: 'user', content: query }],
+        }),
+    });
+
+    if (!response.ok) {
+        const errText = await response.text();
+        throw new Error(`Anthropic API ${response.status}: ${errText}`);
+    }
+
+    const apiResult = await response.json();
+    const text = apiResult.content && apiResult.content[0] && apiResult.content[0].text;
+    if (!text) {
+        throw new Error('Empty response from Anthropic API');
+    }
+
+    // Extract JSON from the response (handle potential markdown fences)
+    const jsonMatch = text.match(/\{[\s\S]*\}/);
+    if (!jsonMatch) {
+        throw new Error('LLM response did not contain valid JSON');
+    }
+
+    const parsed = JSON.parse(jsonMatch[0]);
+
+    // Ensure required fields exist with defaults
+    return {
+        domain: parsed.domain || '',
+        agent: parsed.agent || '',
+        confidence: typeof parsed.confidence === 'number' ? parsed.confidence : 0,
+        suggested_payload: parsed.suggested_payload || { query },
+        reasoning: parsed.reasoning || '',
+    };
+}
+/**
+ * Main Cloud Function handler
+ *
+ * Entry point name: handler
+ */
+async function handler(req, res) {
+    const startTime = Date.now();
+    // CORS headers on every response
+    (0, cors_1.setCorsHeaders)(res);
+    // Handle CORS preflight
+    if (req.method === 'OPTIONS') {
+        (0, cors_1.handlePreflight)(res);
+        return;
+    }
+    const url = new URL(req.url || '/', `https://${req.headers.host || 'localhost'}`);
+    const pathname = url.pathname;
+    // Build execution metadata
+    const traceId = req.headers['x-correlation-id'] || crypto.randomUUID();
+    const executionId = crypto.randomUUID();
+    const executionMetadata = {
+        trace_id: traceId,
+        timestamp: new Date().toISOString(),
+        service: 'copilot-agents',
+        execution_id: executionId,
+    };
+    // Health endpoint
+    if (pathname === '/health' && (req.method === 'GET' || req.method === 'HEAD')) {
+        const healthResult = (0, health_1.handleHealth)();
+        const layers = [
+            { layer: 'AGENT_ROUTING', status: 'completed' },
+            { layer: 'HEALTH_CHECK', status: 'completed', duration_ms: Date.now() - startTime },
+        ];
+        sendJson(res, 200, (0, envelope_1.wrapResponse)(healthResult, executionMetadata, layers));
+        return;
+    }
+    // Agent routes: POST /v1/copilot/{agent}
+    if (req.method === 'POST' && pathname.startsWith('/v1/copilot/')) {
+        // Require end-user Anthropic API key via header
+        const anthropicApiKey = req.headers['x-anthropic-api-key'];
+        if (!anthropicApiKey) {
+            const layers = [
+                { layer: 'AGENT_ROUTING', status: 'error' },
+            ];
+            sendJson(res, 400, (0, envelope_1.wrapResponse)({ error: 'Missing Anthropic API key. Set it via `agentics login` or the ANTHROPIC_API_KEY environment variable.' }, executionMetadata, layers));
+            return;
+        }
+        const agentSlug = pathname.replace('/v1/copilot/', '').replace(/\/$/, '');
+        const body = parseBody(req);
+        if (!body || typeof body !== 'object') {
+            const layers = [
+                { layer: 'AGENT_ROUTING', status: 'completed' },
+            ];
+            sendJson(res, 400, (0, envelope_1.wrapResponse)({ error: 'Request body must be a JSON object' }, executionMetadata, layers));
+            return;
+        }
+        // ─── LLM-based intent classification ───────────────────────────
+        // For the intent route, call the Anthropic API using the end-user's
+        // forwarded key to classify the query against the 27-domain registry.
+        // This replaces the rule-based keyword classifier.
+        if (agentSlug === 'intent') {
+            const llmStart = Date.now();
+            try {
+                const classification = await classifyIntentWithLLM(anthropicApiKey, body);
+                const llmDuration = Date.now() - llmStart;
+                const layers = [
+                    { layer: 'AGENT_ROUTING', status: 'completed' },
+                    { layer: 'COPILOT_INTENT_LLM', status: 'completed', duration_ms: llmDuration },
+                ];
+                // Build response with `result` at top level so CLI can parse
+                // responseBody.result.domain / .agent / .confidence etc.
+                const envelope = (0, envelope_1.wrapResponse)({
+                    status: 'success',
+                    classifier: 'llm',
+                    model: 'claude-3-haiku-20240307',
+                    classification,
+                }, executionMetadata, layers);
+                // Add `result` at envelope top level for CLI compatibility
+                envelope.result = classification;
+                sendJson(res, 200, envelope);
+                return;
+            }
+            catch (llmErr) {
+                // If LLM classification fails, return the error directly
+                // (don't fall back to keyword classifier which has no domain knowledge)
+                const llmDuration = Date.now() - llmStart;
+                const layers = [
+                    { layer: 'AGENT_ROUTING', status: 'completed' },
+                    { layer: 'COPILOT_INTENT_LLM', status: 'error', duration_ms: llmDuration },
+                ];
+                const errorMessage = llmErr instanceof Error ? llmErr.message : 'LLM classification failed';
+                sendJson(res, 502, (0, envelope_1.wrapResponse)({
+                    status: 'error',
+                    error: errorMessage,
+                    classifier: 'llm',
+                }, executionMetadata, layers));
+                return;
+            }
+        }
+        // ─── All other agents: existing keyword/rule-based routing ─────
+        try {
+            const routingLayerStart = Date.now();
+            const agentResult = await (0, router_1.routeRequest)(agentSlug, body);
+            const routingDuration = Date.now() - routingLayerStart;
+            const agentName = agentSlug.toUpperCase().replace(/-/g, '_');
+            const layers = [
+                { layer: 'AGENT_ROUTING', status: 'completed' },
+                { layer: `COPILOT_${agentName}`, status: 'completed', duration_ms: routingDuration },
+            ];
+            const statusCode = agentResult.status === 'success' ? 200 : 422;
+            sendJson(res, statusCode, (0, envelope_1.wrapResponse)(agentResult, executionMetadata, layers));
+            return;
+        }
+        catch (err) {
+            const agentName = agentSlug.toUpperCase().replace(/-/g, '_');
+            const layers = [
+                { layer: 'AGENT_ROUTING', status: 'completed' },
+                { layer: `COPILOT_${agentName}`, status: 'error', duration_ms: Date.now() - startTime },
+            ];
+            const errorMessage = err instanceof Error ? err.message : 'Internal server error';
+            sendJson(res, 500, (0, envelope_1.wrapResponse)({ error: errorMessage }, executionMetadata, layers));
+            return;
+        }
+    }
+    // 404 for unmatched routes
+    const layers = [
+        { layer: 'AGENT_ROUTING', status: 'error' },
+    ];
+    sendJson(res, 404, (0, envelope_1.wrapResponse)({
+        error: 'Not found',
+        available_routes: [
+            'POST /v1/copilot/planner',
+            'POST /v1/copilot/config',
+            'POST /v1/copilot/decomposer',
+            'POST /v1/copilot/clarifier',
+            'POST /v1/copilot/intent',
+            'POST /v1/copilot/reflection',
+            'POST /v1/copilot/meta-reasoner',
+            'GET /health',
+        ],
+    }, executionMetadata, layers));
+}

package/dist/bundled-agents/copilot-agents/lib/functions/src/index.js.map

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

package/dist/bundled-agents/copilot-agents/lib/functions/src/router.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Agent Router
+ *
+ * Maps URL slugs to agent invocations.
+ * Does NOT create new agents or modify business logic.
+ * Instantiates existing agents with persistence/telemetry from env
+ * and routes HTTP bodies to agent.invoke().
+ *
+ * Routes:
+ *   planner       → PlannerAgent
+ *   config        → ConfigValidationAgent
+ *   decomposer    → DecomposerAgent
+ *   clarifier     → ObjectiveClarifierAgent
+ *   intent        → IntentClassifierAgent
+ *   reflection    → ReflectionAgent
+ *   meta-reasoner → MetaReasonerAgent
+ */
+import { AgentResult } from '../../services/agents/contracts';
+/**
+ * Route a request to the appropriate agent
+ *
+ * @param slug - The agent slug from the URL path
+ * @param body - The parsed JSON request body
+ * @returns The agent result (success or error)
+ * @throws If the slug is unknown
+ */
+export declare function routeRequest(slug: string, body: unknown): Promise<AgentResult>;

package/dist/bundled-agents/copilot-agents/lib/functions/src/router.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Agent Router
+ *
+ * Maps URL slugs to agent invocations.
+ * Does NOT create new agents or modify business logic.
+ * Instantiates existing agents with persistence/telemetry from env
+ * and routes HTTP bodies to agent.invoke().
+ *
+ * Routes:
+ *   planner       → PlannerAgent
+ *   config        → ConfigValidationAgent
+ *   decomposer    → DecomposerAgent
+ *   clarifier     → ObjectiveClarifierAgent
+ *   intent        → IntentClassifierAgent
+ *   reflection    → ReflectionAgent
+ *   meta-reasoner → MetaReasonerAgent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeRequest = routeRequest;
+const uuid_1 = require("uuid");
+// Agent imports
+const planner_1 = require("../../services/agents/planner");
+const config_validation_1 = require("../../services/agents/config-validation");
+const decomposer_1 = require("../../services/agents/decomposer");
+const objective_clarifier_1 = require("../../services/agents/objective-clarifier");
+const intent_classifier_1 = require("../../services/agents/intent-classifier");
+const reflection_1 = require("../../services/agents/reflection");
+const meta_reasoner_1 = require("../../services/agents/meta-reasoner");
+// Each agent uses its own persistence/telemetry module (they have identical APIs
+// but TypeScript treats separate class declarations as distinct types)
+const ruvector_persistence_1 = require("../../services/agents/planner/ruvector-persistence");
+const telemetry_1 = require("../../services/agents/planner/telemetry");
+const ruvector_persistence_2 = require("../../services/agents/objective-clarifier/ruvector-persistence");
+const telemetry_2 = require("../../services/agents/objective-clarifier/telemetry");
+const ruvector_persistence_3 = require("../../services/agents/reflection/ruvector-persistence");
+const telemetry_3 = require("../../services/agents/reflection/telemetry");
+/**
+ * Agent factory: instantiate the correct agent for the given slug
+ */
+function createAgent(slug) {
+    switch (slug) {
+        case 'planner': {
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new planner_1.PlannerAgent(p, t);
+        }
+        case 'config': {
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new config_validation_1.ConfigValidationAgent(p, t);
+        }
+        case 'decomposer': {
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new decomposer_1.DecomposerAgent(p, t);
+        }
+        case 'clarifier': {
+            const p = (0, ruvector_persistence_2.createRuvectorFromEnv)();
+            const t = (0, telemetry_2.createTelemetryFromEnv)();
+            return new objective_clarifier_1.ObjectiveClarifierAgent(p, t);
+        }
+        case 'intent': {
+            // IntentClassifier imports from planner persistence/telemetry
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new intent_classifier_1.IntentClassifierAgent(p, t);
+        }
+        case 'reflection': {
+            const p = (0, ruvector_persistence_3.createRuvectorFromEnv)();
+            const t = (0, telemetry_3.createTelemetryFromEnv)();
+            return new reflection_1.ReflectionAgent(p, t);
+        }
+        case 'meta-reasoner': {
+            // MetaReasoner imports from planner persistence/telemetry
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new meta_reasoner_1.MetaReasonerAgent(p, t);
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Route a request to the appropriate agent
+ *
+ * @param slug - The agent slug from the URL path
+ * @param body - The parsed JSON request body
+ * @returns The agent result (success or error)
+ * @throws If the slug is unknown
+ */
+async function routeRequest(slug, body) {
+    const agent = createAgent(slug);
+    if (!agent) {
+        throw new Error(`Unknown agent: "${slug}". Valid agents: planner, config, decomposer, clarifier, intent, reflection, meta-reasoner`);
+    }
+    // Extract execution_ref from body or generate one
+    const bodyObj = body;
+    const executionRef = (typeof bodyObj.execution_ref === 'string' && bodyObj.execution_ref)
+        ? bodyObj.execution_ref
+        : (0, uuid_1.v4)();
+    // Validate input through the agent's schema
+    const validatedInput = agent.validateInput(body);
+    // Invoke the agent
+    return agent.invoke(validatedInput, executionRef);
+}
+//# sourceMappingURL=router.js.map