@llm-dev-ops/agentics-cli 1.3.16 → 1.4.1

package/dist/agents/decision-event.d.ts.map

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

package/dist/agents/decision-event.js

@@ -0,0 +1,346 @@
+/**
+ * DecisionEvent Emitter
+ *
+ * CONSTITUTION REFERENCE: PROMPT 0, PROMPT 2
+ *
+ * PURPOSE: Emit CLI UX-level DecisionEvents to ruvector-service.
+ *
+ * EMISSION RULES:
+ * - At most ONE DecisionEvent per agent invocation
+ * - Async, non-blocking emission only
+ * - NEVER persists locally
+ * - MAY fail silently (UX must not depend on emission)
+ *
+ * DATA RULES:
+ * - Only emit UX telemetry and interaction data
+ * - Never emit raw inputs or sensitive data
+ * - Always use hashes for reproducibility
+ */
+import * as crypto from 'node:crypto';
+import { CLI_UX_AGENT_ID, CLI_UX_AGENT_VERSION, } from './types.js';
+/**
+ * Builder for constructing DecisionEvents.
+ * Ensures all required fields are set before emission.
+ */
+export class DecisionEventBuilder {
+    trace_id;
+    command;
+    subcommand;
+    decision_type = 'cli_ux_orchestration';
+    inputs_hash = '';
+    result_type = 'success';
+    artifact_ref;
+    services_invoked = [];
+    confidence = {
+        value: 1.0,
+        basis: 'command_resolution',
+    };
+    constraints = {
+        permissions: [],
+        environment: {
+            is_local: true,
+            is_production: false,
+            execution_gate_enabled: true,
+            auth_present: false,
+        },
+        scope: [],
+    };
+    execution_ref = null;
+    constructor(options) {
+        this.trace_id = options.trace_id;
+        this.command = options.command;
+        this.subcommand = options.subcommand;
+    }
+    /**
+     * Set decision type.
+     */
+    withDecisionType(type) {
+        this.decision_type = type;
+        return this;
+    }
+    /**
+     * Set inputs hash from raw inputs.
+     * Computes hash, never stores raw data.
+     */
+    withInputsHash(inputs) {
+        this.inputs_hash = this.computeHash(inputs);
+        return this;
+    }
+    /**
+     * Set result type.
+     */
+    withResultType(type) {
+        this.result_type = type;
+        return this;
+    }
+    /**
+     * Set artifact reference.
+     */
+    withArtifactRef(ref) {
+        this.artifact_ref = ref;
+        return this;
+    }
+    /**
+     * Add services that were invoked.
+     */
+    withServicesInvoked(services) {
+        this.services_invoked = services;
+        return this;
+    }
+    /**
+     * Set confidence score.
+     */
+    withConfidence(confidence) {
+        this.confidence = confidence;
+        return this;
+    }
+    /**
+     * Set constraints applied.
+     */
+    withConstraints(constraints) {
+        this.constraints = constraints;
+        return this;
+    }
+    /**
+     * Set environment context.
+     */
+    withEnvironment(env) {
+        this.constraints = {
+            ...this.constraints,
+            environment: env,
+        };
+        return this;
+    }
+    /**
+     * Set execution reference from downstream service.
+     */
+    withExecutionRef(ref) {
+        this.execution_ref = ref;
+        return this;
+    }
+    /**
+     * Build the DecisionEvent.
+     */
+    build() {
+        const outputs = {
+            command: this.command,
+            subcommand: this.subcommand,
+            result_type: this.result_type,
+            artifact_ref: this.artifact_ref,
+            services_invoked: this.services_invoked,
+        };
+        return {
+            agent_id: CLI_UX_AGENT_ID,
+            agent_version: CLI_UX_AGENT_VERSION,
+            decision_type: this.decision_type,
+            inputs_hash: this.inputs_hash,
+            outputs,
+            confidence: this.confidence,
+            constraints_applied: this.constraints,
+            execution_ref: this.execution_ref,
+            timestamp: new Date().toISOString(),
+            trace_id: this.trace_id,
+        };
+    }
+    /**
+     * Compute hash of inputs for reproducibility.
+     */
+    computeHash(inputs) {
+        const canonical = JSON.stringify(inputs, this.sortKeys);
+        return crypto.createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+    }
+    sortKeys(_key, value) {
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            return Object.keys(value)
+                .sort()
+                .reduce((sorted, key) => {
+                sorted[key] = value[key];
+                return sorted;
+            }, {});
+        }
+        return value;
+    }
+}
+/**
+ * Emits DecisionEvents to ruvector-service.
+ *
+ * CRITICAL: Emission is async and non-blocking.
+ * Failures are logged but do not affect UX flow.
+ */
+export class DecisionEventEmitter {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            ruvector_url: config.ruvector_url ?? process.env['RUVECTOR_SERVICE_URL'] ?? '',
+            enabled: config.enabled ?? !!config.ruvector_url,
+            timeout: config.timeout ?? 5000,
+            auth_token: config.auth_token ?? '',
+        };
+    }
+    /**
+     * Check if emission is enabled.
+     */
+    isEnabled() {
+        return this.config.enabled && !!this.config.ruvector_url;
+    }
+    /**
+     * Emit a DecisionEvent.
+     *
+     * RULES:
+     * - Async, non-blocking
+     * - Never throws - failures are silent
+     * - Only one event per invocation should be emitted
+     */
+    async emit(event) {
+        if (!this.isEnabled()) {
+            return {
+                success: false,
+                reason: 'emission_disabled',
+            };
+        }
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+            const headers = {
+                'Content-Type': 'application/json',
+                'X-Trace-ID': event.trace_id,
+                'X-Agent-ID': event.agent_id,
+                'X-Agent-Version': event.agent_version,
+            };
+            if (this.config.auth_token) {
+                headers['Authorization'] = `Bearer ${this.config.auth_token}`;
+            }
+            const response = await fetch(`${this.config.ruvector_url}/v1/decision-events`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(event),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                return {
+                    success: false,
+                    reason: 'http_error',
+                    status_code: response.status,
+                };
+            }
+            return {
+                success: true,
+                event_id: event.trace_id,
+            };
+        }
+        catch (error) {
+            // Silent failure - emission must not affect UX
+            return {
+                success: false,
+                reason: error instanceof Error && error.name === 'AbortError' ? 'timeout' : 'network_error',
+            };
+        }
+    }
+    /**
+     * Emit without waiting (fire and forget).
+     * Use when you don't care about the result.
+     */
+    emitAsync(event) {
+        if (!this.isEnabled()) {
+            return;
+        }
+        // Fire and forget - don't await
+        this.emit(event).catch(() => {
+            // Silently ignore emission failures
+        });
+    }
+}
+/**
+ * Emits telemetry events compatible with LLM-Observatory.
+ */
+export class TelemetryEmitter {
+    config;
+    buffer = [];
+    flushTimer = null;
+    constructor(config = {}) {
+        this.config = {
+            enabled: config.enabled ?? false,
+            endpoint: config.endpoint ?? '',
+            batch_size: config.batch_size ?? 10,
+            flush_interval: config.flush_interval ?? 5000,
+        };
+        if (this.config.enabled && this.config.endpoint) {
+            this.startFlushTimer();
+        }
+    }
+    /**
+     * Record a telemetry event.
+     */
+    record(event_type, agent_id, trace_id, data) {
+        if (!this.config.enabled) {
+            return;
+        }
+        const event = {
+            event_type,
+            agent_id,
+            timestamp: new Date().toISOString(),
+            trace_id,
+            data,
+        };
+        this.buffer.push(event);
+        if (this.buffer.length >= this.config.batch_size) {
+            this.flush();
+        }
+    }
+    /**
+     * Flush buffered events.
+     */
+    async flush() {
+        if (this.buffer.length === 0 || !this.config.endpoint) {
+            return;
+        }
+        const events = this.buffer.splice(0, this.buffer.length);
+        try {
+            await fetch(this.config.endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ events }),
+            });
+        }
+        catch {
+            // Silent failure for telemetry
+        }
+    }
+    /**
+     * Stop the flush timer.
+     */
+    stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    startFlushTimer() {
+        this.flushTimer = setInterval(() => {
+            this.flush();
+        }, this.config.flush_interval);
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a DecisionEvent builder.
+ */
+export function createDecisionEventBuilder(options) {
+    return new DecisionEventBuilder(options);
+}
+/**
+ * Create a DecisionEvent emitter.
+ */
+export function createDecisionEventEmitter(config) {
+    return new DecisionEventEmitter(config);
+}
+/**
+ * Create a telemetry emitter.
+ */
+export function createTelemetryEmitter(config) {
+    return new TelemetryEmitter(config);
+}
+//# sourceMappingURL=decision-event.js.map

package/dist/agents/decision-event.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agent Module Exports
+ *
+ * CONSTITUTION REFERENCE: PROMPT 0, PROMPT 3
+ *
+ * This module provides the public API for CLI UX Agent infrastructure.
+ *
+ * ARCHITECTURE:
+ * - types.ts: All type definitions including DecisionEvent schema
+ * - decision-event.ts: DecisionEvent and telemetry emission
+ * - cli-ux-agent.ts: CLI UX Agent implementation
+ */
+export type { AgentClassification, AgentIdentifier, DecisionType, ConfidenceScore, ConfidenceBasis, ConfidenceComponent, ConstraintsApplied, EnvironmentContext, ScopeLimitation, DecisionEvent, DecisionOutputs, ExecutionReference, CLIUXAgentInput, CLIUXAgentOutput, ParsedCommand, AgentContext, OutputFormat, AgentResult, SuccessResult, ErrorResult, GuidanceResult, GuidanceOption, TimingInfo, AgentRegistration, FailureMode, TelemetryEvent, TelemetryEventType, TelemetryData, InvocationTelemetry, CompletionTelemetry, ServiceCallTelemetry, ValidationTelemetry, ErrorTelemetry, } from './types.js';
+export { CLI_UX_AGENT_ID, CLI_UX_AGENT_VERSION, CLI_UX_AGENT_CLASSIFICATION, INVOCABLE_SERVICES, NON_RESPONSIBILITIES, } from './types.js';
+export { isSuccessResult, isErrorResult, isGuidanceResult, } from './types.js';
+export type { DecisionEventBuilderOptions, DecisionEventEmitterConfig, EmissionResult, TelemetryEmitterConfig, } from './decision-event.js';
+export { DecisionEventBuilder, DecisionEventEmitter, TelemetryEmitter, createDecisionEventBuilder, createDecisionEventEmitter, createTelemetryEmitter, } from './decision-event.js';
+export type { ICLIUXAgent, CLIUXAgentConfig, ValidationResult, ValidationError, } from './cli-ux-agent.js';
+export { CLIUXAgent, CLI_UX_AGENT_REGISTRATION, createCLIUXAgent, getCLIUXAgentRegistration, } from './cli-ux-agent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,YAAY,EAEV,mBAAmB,EACnB,eAAe,EAGf,YAAY,EACZ,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,EACf,kBAAkB,EAGlB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,UAAU,EAGV,iBAAiB,EACjB,WAAW,EAGX,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,cAAc,EACd,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,23 @@
+/**
+ * Agent Module Exports
+ *
+ * CONSTITUTION REFERENCE: PROMPT 0, PROMPT 3
+ *
+ * This module provides the public API for CLI UX Agent infrastructure.
+ *
+ * ARCHITECTURE:
+ * - types.ts: All type definitions including DecisionEvent schema
+ * - decision-event.ts: DecisionEvent and telemetry emission
+ * - cli-ux-agent.ts: CLI UX Agent implementation
+ */
+// ============================================================================
+// Constant Exports
+// ============================================================================
+export { CLI_UX_AGENT_ID, CLI_UX_AGENT_VERSION, CLI_UX_AGENT_CLASSIFICATION, INVOCABLE_SERVICES, NON_RESPONSIBILITIES, } from './types.js';
+// ============================================================================
+// Type Guard Exports
+// ============================================================================
+export { isSuccessResult, isErrorResult, isGuidanceResult, } from './types.js';
+export { DecisionEventBuilder, DecisionEventEmitter, TelemetryEmitter, createDecisionEventBuilder, createDecisionEventEmitter, createTelemetryEmitter, } from './decision-event.js';
+export { CLIUXAgent, CLI_UX_AGENT_REGISTRATION, createCLIUXAgent, getCLIUXAgentRegistration, } from './cli-ux-agent.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmDH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAapB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAa7B,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC"}