@llm-dev-ops/agentics-cli 1.4.26 → 1.4.29

package/dist/bundled-agents/auto-optimizer-agents/dist/server.js

@@ -0,0 +1,459 @@
+"use strict";
+/**
+ * LLM-Auto-Optimizer Unified Service
+ *
+ * Single entry point for all optimization agents deployed as Google Cloud Run.
+ * This service is STATELESS - all persistence goes through ruvector-service.
+ *
+ * AGENTICS INSTRUMENTATION:
+ * This service is a Foundational Execution Unit within the Agentics execution
+ * system. All agent routes MUST carry an ExecutionContext (execution_id +
+ * parent_span_id) and produce hierarchical execution spans.
+ *
+ * Endpoints:
+ * - /health                                    - Service health check
+ * - /ready                                     - Readiness probe
+ * - /agents                                    - List available agents
+ * - /agents/self-optimizing-agent/*            - Self-Optimizing Agent
+ * - /agents/token-optimization-agent/*         - Token Optimization Agent
+ * - /agents/model-selection-agent/*            - Model Selection Agent
+ * - POST /api/v1/optimize                     - Automation-core event ingestion
+ *
+ * @module server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.server = void 0;
+const http_1 = require("http");
+const url_1 = require("url");
+// Agent handlers
+const handler_1 = require("./agents/self-optimizing-agent/handler");
+const handler_2 = require("./agents/token-optimization-agent/handler");
+const handler_3 = require("./agents/model-selection-agent/handler");
+const agents_1 = require("./agents");
+const ruvector_client_1 = require("./services/ruvector-client");
+// Agentics execution instrumentation
+const agentics_1 = require("./agentics");
+// ============================================================================
+// Configuration
+// ============================================================================
+const PORT = parseInt(process.env.PORT || '8080', 10);
+const SERVICE_NAME = process.env.SERVICE_NAME || 'llm-auto-optimizer';
+const SERVICE_VERSION = process.env.SERVICE_VERSION || '1.0.0';
+const PLATFORM_ENV = process.env.PLATFORM_ENV || 'production';
+// ============================================================================
+// Initialization
+// ============================================================================
+// Initialize agent handlers (lazy, singleton pattern)
+let selfOptimizingHandler = null;
+let tokenOptimizationHandler = null;
+let modelSelectionHandler = null;
+function getSelfOptimizingHandler() {
+    if (!selfOptimizingHandler) {
+        selfOptimizingHandler = new handler_1.SelfOptimizingAgentHandler();
+    }
+    return selfOptimizingHandler;
+}
+function getTokenOptimizationHandler() {
+    if (!tokenOptimizationHandler) {
+        tokenOptimizationHandler = new handler_2.TokenOptimizationAgentHandler();
+    }
+    return tokenOptimizationHandler;
+}
+function getModelSelectionHandler() {
+    if (!modelSelectionHandler) {
+        modelSelectionHandler = new handler_3.ModelSelectionAgentHandler();
+    }
+    return modelSelectionHandler;
+}
+async function parseRequest(req) {
+    const url = new url_1.URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+    const headers = {};
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (typeof value === 'string') {
+            headers[key] = value;
+        }
+    }
+    const query = {};
+    url.searchParams.forEach((value, key) => {
+        query[key] = value;
+    });
+    let body = undefined;
+    if (req.method === 'POST' || req.method === 'PUT') {
+        body = await new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => {
+                const raw = Buffer.concat(chunks).toString('utf-8');
+                try {
+                    resolve(raw ? JSON.parse(raw) : undefined);
+                }
+                catch {
+                    resolve(raw);
+                }
+            });
+            req.on('error', reject);
+        });
+    }
+    return {
+        method: req.method || 'GET',
+        path: url.pathname,
+        headers,
+        body,
+        query,
+    };
+}
+function sendJson(res, status, data) {
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'X-Service-Name': SERVICE_NAME,
+        'X-Service-Version': SERVICE_VERSION,
+    });
+    res.end(JSON.stringify(data));
+}
+function sendError(res, status, code, message) {
+    sendJson(res, status, {
+        error: { code, message },
+        service: SERVICE_NAME,
+        timestamp: new Date().toISOString(),
+    });
+}
+// ============================================================================
+// Route Handlers
+// ============================================================================
+async function handleHealth(res) {
+    // Check ruvector-service connectivity with a short timeout (3s, no retries)
+    // so health checks respond quickly even when ruvector is down
+    let ruvectorStatus = 'unknown';
+    try {
+        const client = (0, ruvector_client_1.createRuVectorClient)({ timeout: 3000, enableRetry: false });
+        const health = await client.checkHealth();
+        ruvectorStatus = health.status;
+    }
+    catch {
+        ruvectorStatus = 'unreachable';
+    }
+    const status = ruvectorStatus === 'healthy' ? 'healthy' : 'degraded';
+    // Always return 200 so Cloud Run routes traffic; report degraded status in body
+    sendJson(res, 200, {
+        status,
+        service: SERVICE_NAME,
+        version: SERVICE_VERSION,
+        environment: PLATFORM_ENV,
+        timestamp: new Date().toISOString(),
+        checks: {
+            ruvector_service: ruvectorStatus,
+        },
+    });
+}
+async function handleReady(res) {
+    // Lightweight readiness check
+    sendJson(res, 200, {
+        status: 'ready',
+        service: SERVICE_NAME,
+        version: SERVICE_VERSION,
+        timestamp: new Date().toISOString(),
+    });
+}
+async function handleOptimizeEvent(parsed, res) {
+    const body = parsed.body;
+    if (!body || typeof body.source !== 'string' || typeof body.event_type !== 'string' || typeof body.execution_id !== 'string') {
+        sendError(res, 400, 'INVALID_REQUEST', 'Missing required fields: source, event_type, execution_id');
+        return;
+    }
+    console.log(JSON.stringify({
+        level: 'info',
+        message: 'optimize_event_received',
+        source: body.source,
+        event_type: body.event_type,
+        execution_id: body.execution_id,
+        timestamp: body.timestamp || new Date().toISOString(),
+    }));
+    sendJson(res, 202, {
+        status: 'accepted',
+        execution_id: body.execution_id,
+    });
+}
+async function handleListAgents(res) {
+    sendJson(res, 200, {
+        service: SERVICE_NAME,
+        version: SERVICE_VERSION,
+        agents: (0, agents_1.listAgents)(),
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Route to agent with full Agentics execution span instrumentation.
+ *
+ * ENFORCEMENT:
+ * - Extracts ExecutionContext from headers/body (rejects if parent_span_id missing)
+ * - Creates repo-level span
+ * - Creates agent-level span for the invoked agent
+ * - Attaches artifacts to agent span
+ * - Returns hierarchical span structure alongside agent response
+ */
+async function routeToAgent(parsed, res) {
+    const pathParts = parsed.path.split('/').filter(Boolean);
+    // Expected: /agents/{agent-id}/{action}
+    if (pathParts.length < 2 || pathParts[0] !== 'agents') {
+        sendError(res, 404, 'NOT_FOUND', 'Invalid agent path');
+        return;
+    }
+    const agentId = pathParts[1];
+    const action = pathParts[2] || 'health';
+    // ---- AGENTICS: Extract execution context ----
+    // Health checks are exempt from execution context requirement
+    if (action === 'health') {
+        const agentRequest = {
+            method: parsed.method,
+            path: `/${action}`,
+            headers: parsed.headers,
+            body: parsed.body,
+            query: parsed.query,
+        };
+        let response;
+        switch (agentId) {
+            case 'self-optimizing-agent':
+                response = await getSelfOptimizingHandler().handle(agentRequest);
+                break;
+            case 'token-optimization-agent':
+                response = await getTokenOptimizationHandler().handle(agentRequest);
+                break;
+            case 'model-selection-agent':
+                response = await getModelSelectionHandler().handle(agentRequest);
+                break;
+            default:
+                sendError(res, 404, 'AGENT_NOT_FOUND', `Unknown agent: ${agentId}`);
+                return;
+        }
+        res.writeHead(response.status, {
+            'Content-Type': 'application/json',
+            'X-Service-Name': SERVICE_NAME,
+            'X-Agent-Id': agentId,
+            ...response.headers,
+        });
+        res.end(response.body);
+        return;
+    }
+    // Non-health agent routes REQUIRE execution context
+    let executionContext;
+    try {
+        executionContext = (0, agentics_1.extractExecutionContext)(parsed.headers, parsed.body);
+    }
+    catch (error) {
+        if (error instanceof agentics_1.ExecutionContextError) {
+            sendJson(res, 400, {
+                error: {
+                    code: error.code,
+                    message: error.message,
+                },
+                service: SERVICE_NAME,
+                timestamp: new Date().toISOString(),
+            });
+            return;
+        }
+        throw error;
+    }
+    // ---- AGENTICS: Create SpanManager with repo-level span ----
+    const spanManager = new agentics_1.SpanManager(executionContext);
+    // ---- AGENTICS: Start agent-level span ----
+    const agentSpanId = spanManager.startAgentSpan(agentId);
+    // Build agent request
+    const agentRequest = {
+        method: parsed.method,
+        path: `/${action}`,
+        headers: parsed.headers,
+        body: parsed.body,
+        query: parsed.query,
+    };
+    let response;
+    try {
+        switch (agentId) {
+            case 'self-optimizing-agent':
+                response = await getSelfOptimizingHandler().handle(agentRequest);
+                break;
+            case 'token-optimization-agent':
+                response = await getTokenOptimizationHandler().handle(agentRequest);
+                break;
+            case 'model-selection-agent':
+                response = await getModelSelectionHandler().handle(agentRequest);
+                break;
+            default:
+                spanManager.failAgentSpan(agentSpanId, [`Unknown agent: ${agentId}`]);
+                const failedResult = spanManager.finalize();
+                sendJson(res, 404, {
+                    error: { code: 'AGENT_NOT_FOUND', message: `Unknown agent: ${agentId}` },
+                    execution: failedResult,
+                    service: SERVICE_NAME,
+                    timestamp: new Date().toISOString(),
+                });
+                return;
+        }
+        // ---- AGENTICS: Attach agent response as artifact ----
+        const agentOutput = safeParseJson(response.body);
+        // Attach the decision event / agent output as an artifact
+        const artifactRef = String(agentOutput?.output_id || agentOutput?.execution_ref || `${agentId}-${action}-${Date.now()}`);
+        spanManager.attachArtifact(agentSpanId, {
+            type: 'decision_event',
+            reference: artifactRef,
+            metadata: {
+                agent_id: agentId,
+                action,
+                status: response.status,
+            },
+        });
+        // Attach evidence: response hash for verifiability
+        const responseHash = simpleHash(response.body);
+        spanManager.attachEvidence(agentSpanId, {
+            type: 'hash',
+            value: responseHash,
+            description: `SHA-256 hash of ${agentId} ${action} response body`,
+        });
+        if (response.status >= 200 && response.status < 400) {
+            spanManager.completeAgentSpan(agentSpanId);
+        }
+        else {
+            const errorObj = agentOutput?.error;
+            spanManager.failAgentSpan(agentSpanId, [
+                `Agent returned HTTP ${response.status}`,
+                String(errorObj?.message || 'Unknown agent error'),
+            ]);
+        }
+    }
+    catch (error) {
+        // ---- AGENTICS: Record failure in span ----
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spanManager.failAgentSpan(agentSpanId, [errorMessage]);
+        const failedResult = spanManager.finalize();
+        sendJson(res, 500, {
+            error: {
+                code: 'AGENT_EXECUTION_FAILED',
+                message: errorMessage,
+            },
+            execution: failedResult,
+            service: SERVICE_NAME,
+            timestamp: new Date().toISOString(),
+        });
+        return;
+    }
+    // ---- AGENTICS: Finalize and return with execution spans ----
+    const executionResult = spanManager.finalize();
+    // Enrich response with execution spans
+    const enrichedResponse = {
+        data: safeParseJson(response.body),
+        execution: executionResult,
+    };
+    res.writeHead(response.status, {
+        'Content-Type': 'application/json',
+        'X-Service-Name': SERVICE_NAME,
+        'X-Agent-Id': agentId,
+        'X-Execution-Id': executionContext.execution_id,
+        'X-Repo-Span-Id': spanManager.repoSpanId,
+        'X-Agent-Span-Id': agentSpanId,
+        ...response.headers,
+    });
+    res.end(JSON.stringify(enrichedResponse));
+}
+// ============================================================================
+// Main Request Handler
+// ============================================================================
+async function handleRequest(req, res) {
+    const startTime = Date.now();
+    try {
+        const parsed = await parseRequest(req);
+        // CORS headers for all responses
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Execution-Id, X-Parent-Span-Id');
+        // Handle preflight
+        if (parsed.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // Route request
+        switch (true) {
+            case parsed.path === '/health':
+                await handleHealth(res);
+                break;
+            case parsed.path === '/ready':
+                await handleReady(res);
+                break;
+            case parsed.path === '/agents' && parsed.method === 'GET':
+                await handleListAgents(res);
+                break;
+            case parsed.path.startsWith('/agents/'):
+                await routeToAgent(parsed, res);
+                break;
+            case parsed.path === '/api/v1/optimize' && parsed.method === 'POST':
+                await handleOptimizeEvent(parsed, res);
+                break;
+            default:
+                sendError(res, 404, 'NOT_FOUND', `Path not found: ${parsed.path}`);
+        }
+    }
+    catch (error) {
+        console.error('Request error:', error);
+        sendError(res, 500, 'INTERNAL_ERROR', 'Internal server error');
+    }
+    finally {
+        const duration = Date.now() - startTime;
+        console.log(JSON.stringify({
+            level: 'info',
+            message: 'request_completed',
+            method: req.method,
+            path: req.url,
+            duration_ms: duration,
+            timestamp: new Date().toISOString(),
+        }));
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+function safeParseJson(str) {
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        return null;
+    }
+}
+function simpleHash(input) {
+    const crypto = require('crypto');
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+// ============================================================================
+// Server Startup
+// ============================================================================
+const server = (0, http_1.createServer)(handleRequest);
+exports.server = server;
+server.listen(PORT, '0.0.0.0', () => {
+    console.log(JSON.stringify({
+        level: 'info',
+        message: 'server_started',
+        service: SERVICE_NAME,
+        version: SERVICE_VERSION,
+        port: PORT,
+        environment: PLATFORM_ENV,
+        agentics_instrumented: true,
+        repo_name: 'llm-auto-optimizer',
+        timestamp: new Date().toISOString(),
+    }));
+});
+// Graceful shutdown
+process.on('SIGTERM', () => {
+    console.log(JSON.stringify({
+        level: 'info',
+        message: 'shutdown_initiated',
+        timestamp: new Date().toISOString(),
+    }));
+    server.close(() => {
+        console.log(JSON.stringify({
+            level: 'info',
+            message: 'shutdown_complete',
+            timestamp: new Date().toISOString(),
+        }));
+        process.exit(0);
+    });
+});
+//# sourceMappingURL=server.js.map

package/dist/bundled-agents/auto-optimizer-agents/dist/server.js.map

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

package/dist/bundled-agents/auto-optimizer-agents/dist/services/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Services Index - LLM-Auto-Optimizer
+ *
+ * Central exports for all service clients used by agents.
+ *
+ * @module services
+ */
+export { RuVectorClient, createRuVectorClient, getDefaultRuVectorClient, } from './ruvector-client';
+export type { RuVectorClientConfig, PersistResult, QueryOptions, QueryResult, StoredDecisionEvent, HealthStatus, } from './ruvector-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/auto-optimizer-agents/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/dist/bundled-agents/auto-optimizer-agents/dist/services/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Services Index - LLM-Auto-Optimizer
+ *
+ * Central exports for all service clients used by agents.
+ *
+ * @module services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultRuVectorClient = exports.createRuVectorClient = exports.RuVectorClient = void 0;
+// RuVector Service Client
+var ruvector_client_1 = require("./ruvector-client");
+Object.defineProperty(exports, "RuVectorClient", { enumerable: true, get: function () { return ruvector_client_1.RuVectorClient; } });
+Object.defineProperty(exports, "createRuVectorClient", { enumerable: true, get: function () { return ruvector_client_1.createRuVectorClient; } });
+Object.defineProperty(exports, "getDefaultRuVectorClient", { enumerable: true, get: function () { return ruvector_client_1.getDefaultRuVectorClient; } });
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/auto-optimizer-agents/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,0BAA0B;AAC1B,qDAI2B;AAHzB,iHAAA,cAAc,OAAA;AACd,uHAAA,oBAAoB,OAAA;AACpB,2HAAA,wBAAwB,OAAA"}

package/dist/bundled-agents/auto-optimizer-agents/dist/services/ruvector-client.d.ts

@@ -0,0 +1,149 @@
+/**
+ * RuVector Service Client
+ *
+ * Thin client for persisting DecisionEvents to ruvector-service.
+ * LLM-Auto-Optimizer NEVER connects directly to Google SQL.
+ * ALL persistence occurs via this client ONLY.
+ *
+ * @module services/ruvector-client
+ */
+import { DecisionEvent } from '../contracts';
+export interface RuVectorClientConfig {
+    /** RuVector service base URL */
+    baseUrl: string;
+    /** Authentication API key */
+    apiKey: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Enable retry on transient failures */
+    enableRetry?: boolean;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Environment identifier */
+    environment?: string;
+}
+export interface PersistResult {
+    /** Whether persistence was successful */
+    success: boolean;
+    /** Record ID in ruvector-service */
+    record_id: string;
+    /** Timestamp of persistence */
+    persisted_at: string;
+    /** Any warnings (non-fatal) */
+    warnings?: string[];
+}
+export interface QueryOptions {
+    /** Filter by agent ID */
+    agent_id?: string;
+    /** Filter by decision type */
+    decision_type?: string;
+    /** Time range start (ISO 8601) */
+    since?: string;
+    /** Time range end (ISO 8601) */
+    until?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort order */
+    sort?: 'asc' | 'desc';
+}
+export interface QueryResult {
+    /** Retrieved decision events */
+    events: StoredDecisionEvent[];
+    /** Total count (for pagination) */
+    total_count: number;
+    /** Whether more results exist */
+    has_more: boolean;
+}
+export interface StoredDecisionEvent extends DecisionEvent {
+    /** Storage record ID */
+    record_id: string;
+    /** When persisted */
+    persisted_at: string;
+    /** Storage version */
+    storage_version: number;
+}
+export interface HealthStatus {
+    /** Service health */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** Last health check */
+    last_check: string;
+    /** Backend status */
+    backend: {
+        postgres: 'up' | 'down' | 'degraded';
+        cache: 'up' | 'down' | 'degraded';
+    };
+    /** Latency metrics */
+    latency_ms: number;
+}
+/**
+ * Client for interacting with ruvector-service.
+ * All persistence operations for LLM-Auto-Optimizer go through this client.
+ */
+export declare class RuVectorClient {
+    private config;
+    constructor(config: RuVectorClientConfig);
+    /**
+     * Persist a DecisionEvent to ruvector-service.
+     * This is the ONLY way DecisionEvents should be stored.
+     *
+     * @param event - The DecisionEvent to persist
+     * @returns PersistResult with record ID
+     * @throws Error if persistence fails after retries
+     */
+    persistDecisionEvent(event: DecisionEvent): Promise<PersistResult>;
+    /**
+     * Persist multiple DecisionEvents in a single batch.
+     * More efficient for bulk operations.
+     *
+     * @param events - Array of DecisionEvents to persist
+     * @returns Array of PersistResults
+     */
+    persistDecisionEventBatch(events: DecisionEvent[]): Promise<PersistResult[]>;
+    /**
+     * Query stored DecisionEvents.
+     * Used by governance and audit consumers.
+     *
+     * @param options - Query filter options
+     * @returns QueryResult with matching events
+     */
+    queryDecisionEvents(options?: QueryOptions): Promise<QueryResult>;
+    /**
+     * Get a specific DecisionEvent by record ID.
+     *
+     * @param recordId - The storage record ID
+     * @returns The stored DecisionEvent
+     */
+    getDecisionEvent(recordId: string): Promise<StoredDecisionEvent>;
+    /**
+     * Get aggregate statistics for DecisionEvents.
+     * Used for dashboards and monitoring.
+     */
+    getDecisionStats(options?: {
+        agent_id?: string;
+        since?: string;
+        until?: string;
+    }): Promise<{
+        total_decisions: number;
+        by_type: Record<string, number>;
+        by_agent: Record<string, number>;
+        avg_confidence: number;
+        success_rate: number;
+    }>;
+    /**
+     * Check ruvector-service health.
+     */
+    checkHealth(): Promise<HealthStatus>;
+    private validateDecisionEvent;
+    private makeRequest;
+    private isRetryable;
+    private calculateBackoff;
+    private sleep;
+}
+/**
+ * Create a RuVector client from environment variables.
+ */
+export declare function createRuVectorClient(config?: Partial<RuVectorClientConfig>): RuVectorClient;
+export declare function getDefaultRuVectorClient(): RuVectorClient;
+//# sourceMappingURL=ruvector-client.d.ts.map

package/dist/bundled-agents/auto-optimizer-agents/dist/services/ruvector-client.d.ts.map

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