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

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

@@ -0,0 +1,186 @@
+"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
+ *   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));
+}
+/**
+ * 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;
+        }
+        try {
+            const routingLayerStart = Date.now();
+            const routeResult = 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 },
+            ];
+            // Build per-agent execution_metadata
+            const agentMeta = {
+                trace_id: traceId,
+                agent: agentSlug,
+                domain: 'copilot',
+                timestamp: new Date().toISOString(),
+            };
+            if (routeResult.pipelineContext) {
+                agentMeta.pipeline_context = routeResult.pipelineContext;
+            }
+            // Wrap the agent result with per-agent execution_metadata
+            const wrappedResult = (0, envelope_1.wrapAgentResult)(routeResult.agentResult, agentMeta);
+            const statusCode = routeResult.agentResult.status === 'success' ? 200 : 422;
+            sendJson(res, statusCode, (0, envelope_1.wrapResponse)(wrappedResult, 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));
+}
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/copilot-agents/dist/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/dist/functions/src/router.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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, PipelineContext } from '../../services/agents/contracts';
+/**
+ * Result of routing a request to an agent.
+ * Includes the AgentResult plus metadata needed for the response envelope.
+ */
+export interface RouteResult {
+    agentResult: AgentResult;
+    agentSlug: string;
+    pipelineContext?: PipelineContext;
+}
+/**
+ * Route a request to the appropriate agent
+ *
+ * @param slug - The agent slug from the URL path
+ * @param body - The parsed JSON request body
+ * @returns RouteResult with agent result and metadata
+ * @throws If the slug is unknown
+ */
+export declare function routeRequest(slug: string, body: unknown): Promise<RouteResult>;

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

@@ -0,0 +1,121 @@
+"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");
+const contracts_1 = require("../../services/agents/contracts");
+// 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 RouteResult with agent result and metadata
+ * @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)();
+    // Extract pipeline_context if present (safe parse — don't fail if malformed)
+    let pipelineContext;
+    if (bodyObj.pipeline_context !== undefined) {
+        const parsed = contracts_1.PipelineContextSchema.safeParse(bodyObj.pipeline_context);
+        if (parsed.success) {
+            pipelineContext = parsed.data;
+        }
+    }
+    // Validate input through the agent's schema
+    const validatedInput = agent.validateInput(body);
+    // Invoke the agent
+    const agentResult = await agent.invoke(validatedInput, executionRef);
+    return {
+        agentResult,
+        agentSlug: slug,
+        pipelineContext,
+    };
+}
+//# sourceMappingURL=router.js.map

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

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

package/dist/bundled-agents/copilot-agents/dist/services/agents/config-validation/config-validation-agent.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Config Validation Agent
+ *
+ * Purpose: Validate configuration artifacts for structural and semantic correctness
+ * Classification: CONFIGURATION_VALIDATION, STATIC_ANALYSIS
+ * decision_type: config_validation
+ *
+ * Scope:
+ * - Validate schemas
+ * - Validate semantic constraints
+ * - Detect missing, conflicting, deprecated, or unsafe values
+ * - Assess configuration readiness
+ *
+ * CONSTITUTION COMPLIANCE:
+ * ✓ Stateless at runtime
+ * ✓ Emits exactly ONE DecisionEvent per invocation
+ * ✓ Persists ONLY via ruvector-service
+ * ✓ NEVER connects directly to databases
+ * ✓ NEVER executes SQL
+ * ✓ NEVER modifies runtime behavior
+ * ✓ NEVER orchestrates other agents
+ * ✓ NEVER enforces policy
+ * ✓ NEVER intercepts execution paths
+ *
+ * Must Never:
+ * - Modify configuration
+ * - Apply defaults
+ * - Auto-fix values
+ * - Enforce policy
+ * - Block execution
+ */
+import { BaseAgent, AgentMetadata, AgentResult, ConfigValidationInput, ConfigValidationOutput } from '../contracts';
+import { RuvectorPersistence } from '../planner/ruvector-persistence';
+import { Telemetry } from '../planner/telemetry';
+/**
+ * Config Validation Agent Implementation
+ *
+ * This agent analyzes configuration artifacts and produces validation reports.
+ * It is purely analytical - it NEVER modifies, applies defaults, or auto-fixes.
+ */
+export declare class ConfigValidationAgent implements BaseAgent<ConfigValidationInput, ConfigValidationOutput> {
+    readonly metadata: AgentMetadata;
+    private readonly persistence;
+    private readonly telemetry;
+    constructor(persistence: RuvectorPersistence, telemetry: Telemetry);
+    /**
+     * Validate input against ConfigValidationInputSchema
+     */
+    validateInput(input: unknown): ConfigValidationInput;
+    /**
+     * Invoke the config validation agent
+     *
+     * DETERMINISTIC: Same input always produces same output structure
+     * STATELESS: No internal state modified
+     * NON-BLOCKING: Fully async
+     */
+    invoke(input: ConfigValidationInput, executionRef: string): Promise<AgentResult>;
+    /**
+     * Perform configuration validation
+     *
+     * This is the core validation logic - purely analytical.
+     * NEVER modifies, applies defaults, or auto-fixes anything.
+     */
+    private validateConfig;
+    /**
+     * Validate against schema if provided
+     */
+    private validateSchema;
+    /**
+     * Recursive schema validation
+     */
+    private validateAgainstSchema;
+    /**
+     * Check semantic constraints
+     */
+    private checkSemanticConstraints;
+    /**
+     * Check port ranges are valid
+     */
+    private checkPortRanges;
+    /**
+     * Check URL formats are valid
+     */
+    private checkUrlFormats;
+    /**
+     * Check timeout values are reasonable
+     */
+    private checkTimeoutValues;
+    /**
+     * Check memory values are reasonable
+     */
+    private checkMemoryValues;
+    /**
+     * Evaluate a custom constraint
+     */
+    private evaluateCustomConstraint;
+    /**
+     * Detect deprecated values
+     */
+    private detectDeprecatedValues;
+    /**
+     * Detect unsafe configurations
+     */
+    private detectUnsafeConfigs;
+    /**
+     * Check if a key/value pair looks like a secret
+     */
+    private looksLikeSecret;
+    /**
+     * Detect configuration conflicts
+     */
+    private detectConflicts;
+    /**
+     * Detect missing required configurations
+     */
+    private detectMissingConfigs;
+    /**
+     * Get value at a JSONPath-like path
+     */
+    private getValueAtPath;
+    /**
+     * Assess overall readiness
+     */
+    private assessReadiness;
+    /**
+     * Generate recommendations (informational only)
+     */
+    private generateRecommendations;
+    /**
+     * Calculate summary statistics
+     */
+    private calculateSummary;
+    /**
+     * Count total paths in config
+     */
+    private countPaths;
+    /**
+     * Determine overall validity
+     */
+    private determineValidity;
+    /**
+     * Hash configuration for tracking
+     */
+    private hashConfig;
+    /**
+     * Calculate confidence based on validation completeness
+     */
+    private calculateConfidence;
+    /**
+     * Get constraints applied during validation
+     */
+    private getAppliedConstraints;
+    /**
+     * Classify error for proper error code
+     */
+    private classifyError;
+}