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

package/dist/bundled-agents/copilot-agents/lib/services/agents/planner/ruvector-persistence.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * RuVector Persistence Layer
+ *
+ * Per Constitution: Agents persist ONLY via ruvector-service.
+ * NEVER connect directly to Google SQL.
+ * NEVER execute SQL.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuvectorPersistence = void 0;
+exports.createRuvectorFromEnv = createRuvectorFromEnv;
+/**
+ * RuVector Persistence Service
+ *
+ * Handles all persistence operations through the ruvector-service.
+ * This is the ONLY allowed persistence mechanism per constitution.
+ */
+class RuvectorPersistence {
+    config;
+    constructor(config) {
+        this.config = {
+            timeout: 30000,
+            ...config,
+        };
+    }
+    /**
+     * Store a DecisionEvent in ruvector
+     */
+    async store(event) {
+        const url = `${this.config.endpoint}/api/v1/events`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(this.config.apiKey && { 'Authorization': `Bearer ${this.config.apiKey}` }),
+                'X-Namespace': this.config.namespace,
+            },
+            body: JSON.stringify({
+                event_type: `agent.${event.decision_type}`,
+                agent_id: event.agent_id,
+                agent_version: event.agent_version,
+                payload: event,
+                timestamp: event.timestamp,
+            }),
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (!response.ok) {
+            throw new Error(`RuVector persistence failed: ${response.status} ${response.statusText}`);
+        }
+        const result = await response.json();
+        return {
+            id: result.id || event.execution_ref,
+            stored: true,
+        };
+    }
+    /**
+     * Retrieve a DecisionEvent by execution reference
+     */
+    async retrieve(executionRef) {
+        const url = `${this.config.endpoint}/api/v1/events/${executionRef}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(this.config.apiKey && { 'Authorization': `Bearer ${this.config.apiKey}` }),
+                'X-Namespace': this.config.namespace,
+            },
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            throw new Error(`RuVector retrieval failed: ${response.status} ${response.statusText}`);
+        }
+        const result = await response.json();
+        return result.payload;
+    }
+    /**
+     * Search for DecisionEvents by agent and decision type
+     */
+    async search(params) {
+        const queryParams = new URLSearchParams();
+        if (params.agentId)
+            queryParams.set('agent_id', params.agentId);
+        if (params.decisionType)
+            queryParams.set('decision_type', params.decisionType);
+        if (params.fromTimestamp)
+            queryParams.set('from', params.fromTimestamp);
+        if (params.toTimestamp)
+            queryParams.set('to', params.toTimestamp);
+        if (params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const url = `${this.config.endpoint}/api/v1/events?${queryParams.toString()}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(this.config.apiKey && { 'Authorization': `Bearer ${this.config.apiKey}` }),
+                'X-Namespace': this.config.namespace,
+            },
+            signal: AbortSignal.timeout(this.config.timeout),
+        });
+        if (!response.ok) {
+            throw new Error(`RuVector search failed: ${response.status} ${response.statusText}`);
+        }
+        const result = await response.json();
+        return (result.events || []).map((e) => e.payload);
+    }
+}
+exports.RuvectorPersistence = RuvectorPersistence;
+/**
+ * Create RuVector persistence from environment
+ */
+function createRuvectorFromEnv() {
+    const endpoint = process.env.RUVECTOR_ENDPOINT || 'http://localhost:8081';
+    const apiKey = process.env.RUVECTOR_API_KEY;
+    const namespace = process.env.RUVECTOR_NAMESPACE || 'agents';
+    return new RuvectorPersistence({
+        endpoint,
+        apiKey,
+        namespace,
+    });
+}
+//# sourceMappingURL=ruvector-persistence.js.map

package/dist/bundled-agents/copilot-agents/lib/services/agents/planner/ruvector-persistence.js.map

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

package/dist/bundled-agents/copilot-agents/lib/services/agents/planner/telemetry.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Telemetry for LLM-Observatory
+ *
+ * Per Constitution: All agents MUST emit telemetry compatible with LLM-Observatory.
+ */
+export interface TelemetryConfig {
+    endpoint?: string;
+    serviceName: string;
+    serviceVersion: string;
+    enabled: boolean;
+}
+export interface TelemetrySpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    status: 'ok' | 'error';
+    attributes: Record<string, string | number | boolean>;
+}
+/**
+ * Telemetry Service for LLM-Observatory compatibility
+ */
+export declare class Telemetry {
+    private readonly config;
+    private spans;
+    constructor(config: TelemetryConfig);
+    /**
+     * Record agent invocation start
+     */
+    recordStart(agentId: string, executionRef: string, input: unknown): void;
+    /**
+     * Record successful completion
+     */
+    recordSuccess(agentId: string, executionRef: string, durationMs: number): void;
+    /**
+     * Record failure
+     */
+    recordFailure(agentId: string, executionRef: string, errorCode: string, errorMessage: string): void;
+    /**
+     * Emit a custom event
+     */
+    emitEvent(eventType: string, data: Record<string, unknown>): void;
+    /**
+     * Find span by execution ref
+     */
+    private findSpan;
+    /**
+     * Generate span ID
+     */
+    private generateSpanId;
+    /**
+     * Hash input for telemetry (no sensitive data)
+     */
+    private hashInput;
+    /**
+     * Emit span to observatory
+     */
+    private emitSpan;
+    /**
+     * Emit metric to observatory
+     */
+    private emitMetric;
+    /**
+     * Send data to LLM-Observatory endpoint
+     */
+    private sendToObservatory;
+}
+/**
+ * Create telemetry from environment
+ */
+export declare function createTelemetryFromEnv(): Telemetry;

package/dist/bundled-agents/copilot-agents/lib/services/agents/planner/telemetry.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Telemetry for LLM-Observatory
+ *
+ * Per Constitution: All agents MUST emit telemetry compatible with LLM-Observatory.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Telemetry = void 0;
+exports.createTelemetryFromEnv = createTelemetryFromEnv;
+/**
+ * Telemetry Service for LLM-Observatory compatibility
+ */
+class Telemetry {
+    config;
+    spans = [];
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Record agent invocation start
+     */
+    recordStart(agentId, executionRef, input) {
+        if (!this.config.enabled)
+            return;
+        const span = {
+            traceId: executionRef,
+            spanId: this.generateSpanId(),
+            name: `agent.${agentId}.invoke`,
+            startTime: Date.now(),
+            status: 'ok',
+            attributes: {
+                'agent.id': agentId,
+                'agent.version': this.config.serviceVersion,
+                'service.name': this.config.serviceName,
+                'execution.ref': executionRef,
+                'input.hash': this.hashInput(input),
+            },
+        };
+        this.spans.push(span);
+        this.emitSpan(span, 'start');
+    }
+    /**
+     * Record successful completion
+     */
+    recordSuccess(agentId, executionRef, durationMs) {
+        if (!this.config.enabled)
+            return;
+        const span = this.findSpan(executionRef);
+        if (span) {
+            span.endTime = Date.now();
+            span.status = 'ok';
+            span.attributes['duration.ms'] = durationMs;
+            this.emitSpan(span, 'end');
+        }
+        this.emitMetric({
+            name: 'agent.invocation.duration',
+            value: durationMs,
+            unit: 'ms',
+            tags: {
+                agent_id: agentId,
+                status: 'success',
+            },
+        });
+        this.emitMetric({
+            name: 'agent.invocation.count',
+            value: 1,
+            unit: 'count',
+            tags: {
+                agent_id: agentId,
+                status: 'success',
+            },
+        });
+    }
+    /**
+     * Record failure
+     */
+    recordFailure(agentId, executionRef, errorCode, errorMessage) {
+        if (!this.config.enabled)
+            return;
+        const span = this.findSpan(executionRef);
+        if (span) {
+            span.endTime = Date.now();
+            span.status = 'error';
+            span.attributes['error.code'] = errorCode;
+            span.attributes['error.message'] = errorMessage.substring(0, 256);
+            this.emitSpan(span, 'end');
+        }
+        this.emitMetric({
+            name: 'agent.invocation.count',
+            value: 1,
+            unit: 'count',
+            tags: {
+                agent_id: agentId,
+                status: 'error',
+                error_code: errorCode,
+            },
+        });
+    }
+    /**
+     * Emit a custom event
+     */
+    emitEvent(eventType, data) {
+        if (!this.config.enabled)
+            return;
+        const event = {
+            type: eventType,
+            timestamp: new Date().toISOString(),
+            service: this.config.serviceName,
+            version: this.config.serviceVersion,
+            data,
+        };
+        this.sendToObservatory('events', event);
+    }
+    /**
+     * Find span by execution ref
+     */
+    findSpan(executionRef) {
+        return this.spans.find(s => s.traceId === executionRef);
+    }
+    /**
+     * Generate span ID
+     */
+    generateSpanId() {
+        return Array.from({ length: 16 }, () => Math.floor(Math.random() * 16).toString(16)).join('');
+    }
+    /**
+     * Hash input for telemetry (no sensitive data)
+     */
+    hashInput(input) {
+        const str = JSON.stringify(input);
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash).toString(16);
+    }
+    /**
+     * Emit span to observatory
+     */
+    emitSpan(span, phase) {
+        this.sendToObservatory('spans', { ...span, phase });
+    }
+    /**
+     * Emit metric to observatory
+     */
+    emitMetric(metric) {
+        this.sendToObservatory('metrics', {
+            ...metric,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Send data to LLM-Observatory endpoint
+     */
+    async sendToObservatory(type, data) {
+        if (!this.config.endpoint) {
+            // Log to console if no endpoint configured
+            console.log(`[TELEMETRY:${type}]`, JSON.stringify(data));
+            return;
+        }
+        try {
+            await fetch(`${this.config.endpoint}/api/v1/${type}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Service-Name': this.config.serviceName,
+                    'X-Service-Version': this.config.serviceVersion,
+                },
+                body: JSON.stringify(data),
+            });
+        }
+        catch {
+            // Telemetry failures should not break agent operation
+            console.error(`Telemetry send failed for ${type}`);
+        }
+    }
+}
+exports.Telemetry = Telemetry;
+/**
+ * Create telemetry from environment
+ */
+function createTelemetryFromEnv() {
+    return new Telemetry({
+        endpoint: process.env.LLM_OBSERVATORY_ENDPOINT,
+        serviceName: 'planner-agent',
+        serviceVersion: '1.0.0',
+        enabled: process.env.TELEMETRY_ENABLED !== 'false',
+    });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/bundled-agents/copilot-agents/lib/services/agents/planner/telemetry.js.map

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

package/dist/bundled-agents/copilot-agents/lib/services/agents/reflection/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reflection Agent Module Exports
+ *
+ * Purpose: Analyze DecisionEvents to extract learning and quality signals
+ * Classification: POST_EXECUTION_ANALYSIS, QUALITY_ASSESSMENT
+ * decision_type: reflection_analysis
+ */
+export { ReflectionAgent } from './reflection-agent';
+export { RuvectorPersistence, createRuvectorFromEnv } from './ruvector-persistence';
+export { Telemetry, createTelemetryFromEnv } from './telemetry';
+export { ReflectionInputSchema, ReflectionOutputSchema, QualitySignalSchema, LearningSignalSchema, GapAnalysisSchema, OutcomeEvaluationSchema, type ReflectionInput, type ReflectionOutput, type QualitySignal, type LearningSignal, type GapAnalysis, type OutcomeEvaluation, } from '../contracts';

package/dist/bundled-agents/copilot-agents/lib/services/agents/reflection/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Reflection Agent Module Exports
+ *
+ * Purpose: Analyze DecisionEvents to extract learning and quality signals
+ * Classification: POST_EXECUTION_ANALYSIS, QUALITY_ASSESSMENT
+ * decision_type: reflection_analysis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutcomeEvaluationSchema = exports.GapAnalysisSchema = exports.LearningSignalSchema = exports.QualitySignalSchema = exports.ReflectionOutputSchema = exports.ReflectionInputSchema = exports.createTelemetryFromEnv = exports.Telemetry = exports.createRuvectorFromEnv = exports.RuvectorPersistence = exports.ReflectionAgent = void 0;
+var reflection_agent_1 = require("./reflection-agent");
+Object.defineProperty(exports, "ReflectionAgent", { enumerable: true, get: function () { return reflection_agent_1.ReflectionAgent; } });
+var ruvector_persistence_1 = require("./ruvector-persistence");
+Object.defineProperty(exports, "RuvectorPersistence", { enumerable: true, get: function () { return ruvector_persistence_1.RuvectorPersistence; } });
+Object.defineProperty(exports, "createRuvectorFromEnv", { enumerable: true, get: function () { return ruvector_persistence_1.createRuvectorFromEnv; } });
+var telemetry_1 = require("./telemetry");
+Object.defineProperty(exports, "Telemetry", { enumerable: true, get: function () { return telemetry_1.Telemetry; } });
+Object.defineProperty(exports, "createTelemetryFromEnv", { enumerable: true, get: function () { return telemetry_1.createTelemetryFromEnv; } });
+// Re-export schemas from contracts
+var contracts_1 = require("../contracts");
+Object.defineProperty(exports, "ReflectionInputSchema", { enumerable: true, get: function () { return contracts_1.ReflectionInputSchema; } });
+Object.defineProperty(exports, "ReflectionOutputSchema", { enumerable: true, get: function () { return contracts_1.ReflectionOutputSchema; } });
+Object.defineProperty(exports, "QualitySignalSchema", { enumerable: true, get: function () { return contracts_1.QualitySignalSchema; } });
+Object.defineProperty(exports, "LearningSignalSchema", { enumerable: true, get: function () { return contracts_1.LearningSignalSchema; } });
+Object.defineProperty(exports, "GapAnalysisSchema", { enumerable: true, get: function () { return contracts_1.GapAnalysisSchema; } });
+Object.defineProperty(exports, "OutcomeEvaluationSchema", { enumerable: true, get: function () { return contracts_1.OutcomeEvaluationSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/copilot-agents/lib/services/agents/reflection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../services/agents/reflection/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,+DAAoF;AAA3E,2HAAA,mBAAmB,OAAA;AAAE,6HAAA,qBAAqB,OAAA;AACnD,yCAAgE;AAAvD,sGAAA,SAAS,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAE1C,mCAAmC;AACnC,0CAasB;AAZpB,kHAAA,qBAAqB,OAAA;AACrB,mHAAA,sBAAsB,OAAA;AACtB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AACpB,8GAAA,iBAAiB,OAAA;AACjB,oHAAA,uBAAuB,OAAA"}

package/dist/bundled-agents/copilot-agents/lib/services/agents/reflection/reflection-agent.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Reflection Agent
+ *
+ * Purpose: Analyze DecisionEvents to extract learning and quality signals
+ * Classification: POST_EXECUTION_ANALYSIS, QUALITY_ASSESSMENT
+ * decision_type: reflection_analysis
+ *
+ * Scope:
+ * - Evaluate outcomes
+ * - Identify gaps and inefficiencies
+ * - Produce improvement insights
+ *
+ * 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 behavior
+ * - Trigger retries
+ * - Apply optimizations
+ */
+import { BaseAgent, AgentMetadata, AgentResult, ReflectionInput, ReflectionOutput } from '../contracts';
+import { RuvectorPersistence } from './ruvector-persistence';
+import { Telemetry } from './telemetry';
+/**
+ * Reflection Agent Implementation
+ *
+ * This agent analyzes DecisionEvents and produces quality/learning signals.
+ * It is purely analytical - it NEVER modifies behavior, triggers retries, or applies optimizations.
+ */
+export declare class ReflectionAgent implements BaseAgent<ReflectionInput, ReflectionOutput> {
+    readonly metadata: AgentMetadata;
+    private readonly persistence;
+    private readonly telemetry;
+    constructor(persistence: RuvectorPersistence, telemetry: Telemetry);
+    /**
+     * Validate input against ReflectionInputSchema
+     */
+    validateInput(input: unknown): ReflectionInput;
+    /**
+     * Invoke the reflection agent
+     *
+     * DETERMINISTIC: Same input always produces same output structure
+     * STATELESS: No internal state modified
+     * NON-BLOCKING: Fully async
+     */
+    invoke(input: ReflectionInput, executionRef: string): Promise<AgentResult>;
+    /**
+     * Analyze DecisionEvents and produce reflection output
+     *
+     * This is the core reflection logic - purely analytical.
+     * NEVER modifies behavior, triggers retries, or applies optimizations.
+     */
+    private analyzeDecisionEvents;
+    /**
+     * Evaluate outcomes for each decision event
+     */
+    private evaluateOutcomes;
+    /**
+     * Assess quality dimensions for a decision event
+     */
+    private assessDimensions;
+    /**
+     * Assess quality of event outputs
+     */
+    private assessOutputQuality;
+    /**
+     * Generate outcome summary
+     */
+    private generateOutcomeSummary;
+    /**
+     * Generate deviation notes
+     */
+    private generateDeviationNotes;
+    /**
+     * Extract quality signals from events
+     */
+    private extractQualitySignals;
+    /**
+     * Extract learning signals from events
+     */
+    private extractLearningSignals;
+    /**
+     * Analyze constraint usage patterns
+     */
+    private analyzeConstraintPatterns;
+    /**
+     * Detect outlier events
+     */
+    private detectOutliers;
+    /**
+     * Identify gaps in the analyzed events
+     */
+    private identifyGaps;
+    /**
+     * Find correlations between events
+     */
+    private findCorrelations;
+    /**
+     * Generate summary statistics
+     */
+    private generateSummary;
+    /**
+     * Calculate confidence score for reflection analysis
+     */
+    private calculateConfidence;
+    /**
+     * Get constraints applied during reflection
+     */
+    private getAppliedConstraints;
+    /**
+     * Classify error for proper error code
+     */
+    private classifyError;
+}