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

package/dist/agents/cli-ux-agent.js

@@ -0,0 +1,488 @@
+/**
+ * CLI UX Agent Implementation
+ *
+ * CONSTITUTION REFERENCE: PROMPT 0, PROMPT 1, PROMPT 2
+ *
+ * AGENT NAME: CLI UX Agent
+ * CLASSIFICATION: CLI_UX_ORCHESTRATION
+ *
+ * PURPOSE:
+ * Provide a consistent, guided, and contract-validated command-line user
+ * experience for interacting with the Agentics Dev platform.
+ *
+ * SCOPE:
+ * - Parse and validate CLI commands
+ * - Guide users through workflows
+ * - Orchestrate calls to Agentics services
+ * - Normalize and present outputs
+ * - Emit UX-level interaction signals
+ *
+ * NON-RESPONSIBILITIES (EXPLICIT):
+ * - Execute inference
+ * - Execute workflows
+ * - Modify upstream state directly
+ * - Apply optimizations
+ * - Enforce governance or policy decisions
+ * - Trigger retries or automation implicitly
+ * - Persist business state
+ * - Connect directly to databases
+ */
+import * as crypto from 'node:crypto';
+import { CLI_UX_AGENT_ID, CLI_UX_AGENT_VERSION, CLI_UX_AGENT_CLASSIFICATION, INVOCABLE_SERVICES, NON_RESPONSIBILITIES, } from './types.js';
+import { DecisionEventBuilder, createDecisionEventEmitter, createTelemetryEmitter, } from './decision-event.js';
+// ============================================================================
+// Agent Registration (PROMPT 1 Requirement)
+// ============================================================================
+/**
+ * CLI UX Agent registration metadata.
+ * Defines the complete contract for this agent.
+ */
+export const CLI_UX_AGENT_REGISTRATION = {
+    identifier: {
+        agent_id: CLI_UX_AGENT_ID,
+        agent_version: CLI_UX_AGENT_VERSION,
+        agent_name: 'CLI UX Agent',
+        classification: CLI_UX_AGENT_CLASSIFICATION,
+    },
+    purpose: 'Provide a consistent, guided, and contract-validated command-line user ' +
+        'experience for interacting with the Agentics Dev platform.',
+    inputs_schema_ref: 'agentics-contracts/cli-ux-agent-input/v1',
+    outputs_schema_ref: 'agentics-contracts/cli-ux-agent-output/v1',
+    decision_event_schema_ref: 'agentics-contracts/decision-event/v1',
+    invocable_services: [...INVOCABLE_SERVICES],
+    non_responsibilities: [...NON_RESPONSIBILITIES],
+    failure_modes: [
+        {
+            code: 'ECLI-AGENT-001',
+            description: 'Command validation failed',
+            exit_code: 100,
+            recoverable: false,
+        },
+        {
+            code: 'ECLI-AGENT-002',
+            description: 'Service routing failed',
+            exit_code: 140,
+            recoverable: false,
+        },
+        {
+            code: 'ECLI-AGENT-003',
+            description: 'Output formatting failed',
+            exit_code: 150,
+            recoverable: true,
+        },
+        {
+            code: 'ECLI-AGENT-004',
+            description: 'Authentication required',
+            exit_code: 130,
+            recoverable: true,
+        },
+        {
+            code: 'ECLI-AGENT-005',
+            description: 'Execution gate blocked',
+            exit_code: 77,
+            recoverable: false,
+        },
+    ],
+};
+// ============================================================================
+// CLI UX Agent Implementation
+// ============================================================================
+export class CLIUXAgent {
+    config;
+    decisionEmitter;
+    telemetryEmitter;
+    constructor(config = {}) {
+        this.config = {
+            emit_decisions: config.emit_decisions ?? false,
+            emit_telemetry: config.emit_telemetry ?? false,
+            ruvector_url: config.ruvector_url ?? process.env['RUVECTOR_SERVICE_URL'] ?? '',
+            telemetry_endpoint: config.telemetry_endpoint ?? '',
+            default_output_format: config.default_output_format ?? 'json',
+            default_timeout: config.default_timeout ?? 30000,
+        };
+        this.decisionEmitter = createDecisionEventEmitter({
+            ruvector_url: this.config.ruvector_url,
+            enabled: this.config.emit_decisions,
+        });
+        this.telemetryEmitter = createTelemetryEmitter({
+            enabled: this.config.emit_telemetry,
+            endpoint: this.config.telemetry_endpoint,
+        });
+    }
+    /**
+     * Get agent identifier.
+     */
+    getIdentifier() {
+        return CLI_UX_AGENT_REGISTRATION.identifier;
+    }
+    /**
+     * Get agent registration.
+     */
+    getRegistration() {
+        return CLI_UX_AGENT_REGISTRATION;
+    }
+    /**
+     * Process a CLI command.
+     *
+     * EXECUTION FLOW:
+     * 1. Record invocation telemetry
+     * 2. Validate command
+     * 3. Resolve execution context
+     * 4. Calculate confidence
+     * 5. Build result
+     * 6. Emit DecisionEvent (async, non-blocking)
+     * 7. Record completion telemetry
+     * 8. Return output
+     *
+     * CONFIRMS:
+     * - This agent does NOT execute inference
+     * - This agent does NOT modify platform state
+     * - This agent does NOT enforce policies
+     * - This agent does NOT trigger automation implicitly
+     */
+    async process(input) {
+        const startTime = Date.now();
+        const startedAt = new Date().toISOString();
+        // Record invocation telemetry
+        this.telemetryEmitter.record('agent_invocation', CLI_UX_AGENT_ID, input.trace_id, {
+            type: 'invocation',
+            command: input.command.command,
+            subcommand: input.command.subcommand,
+            input_hash: this.computeInputHash(input),
+        });
+        try {
+            // Step 1: Validate command
+            const validation = this.validateCommand(input.command);
+            if (!validation.valid) {
+                const result = this.buildErrorResult(validation.errors);
+                return this.buildOutput(false, result, input, startTime, startedAt);
+            }
+            // Step 2: Check for guidance scenarios
+            const guidance = this.checkForGuidance(input);
+            if (guidance) {
+                return this.buildOutput(true, guidance, input, startTime, startedAt);
+            }
+            // Step 3: Build success result (orchestration happens in CLI command handlers)
+            const result = this.buildSuccessResult(input);
+            return this.buildOutput(true, result, input, startTime, startedAt);
+        }
+        catch (error) {
+            const result = {
+                type: 'error',
+                code: 'ECLI-AGENT-999',
+                message: error instanceof Error ? error.message : 'Unknown error',
+                recoverable: false,
+            };
+            return this.buildOutput(false, result, input, startTime, startedAt);
+        }
+    }
+    /**
+     * Validate command syntax and structure.
+     */
+    validateCommand(command) {
+        const errors = [];
+        // Validate command name
+        if (!command.command || command.command.trim() === '') {
+            errors.push({
+                field: 'command',
+                message: 'Command name is required',
+                code: 'ECLI-VAL-001',
+            });
+        }
+        // Validate command is known
+        const knownCommands = [
+            'login', 'logout', 'whoami',
+            'plan', 'simulate', 'inspect', 'quantify',
+            'deploy', 'export', 'erp', 'diligence',
+            'usage', 'policy', 'audit',
+            'help', 'version',
+        ];
+        if (command.command && !knownCommands.includes(command.command)) {
+            errors.push({
+                field: 'command',
+                message: `Unknown command: ${command.command}. Run 'agentics help' for available commands.`,
+                code: 'ECLI-VAL-002',
+            });
+        }
+        // Validate subcommands for commands that require them
+        const commandsRequiringSubcommand = ['plan', 'simulate', 'erp', 'diligence'];
+        if (command.command &&
+            commandsRequiringSubcommand.includes(command.command) &&
+            !command.subcommand) {
+            errors.push({
+                field: 'subcommand',
+                message: `Command '${command.command}' requires a subcommand. Run 'agentics ${command.command} help' for options.`,
+                code: 'ECLI-VAL-003',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Resolve environment context from arguments.
+     */
+    resolveContext(args) {
+        const flags = this.parseFlags(args);
+        const options = this.parseOptions(args);
+        return {
+            cwd: process.cwd(),
+            authenticated: this.checkAuthentication(),
+            execution_gate_enabled: this.checkExecutionGate(),
+            output_format: options['format'] ?? this.config.default_output_format,
+            verbose: flags['verbose'] || flags['v'] || false,
+            timeout: parseInt(options['timeout'] ?? String(this.config.default_timeout), 10),
+        };
+    }
+    /**
+     * Calculate confidence score for a decision.
+     */
+    calculateConfidence(input, result) {
+        const components = [];
+        // Command resolution confidence
+        const commandConfidence = this.calculateCommandConfidence(input.command);
+        components.push({
+            name: 'command_resolution',
+            value: commandConfidence,
+            weight: 0.4,
+        });
+        // Input validation confidence
+        const validationConfidence = result.type === 'error' ? 0.0 : 1.0;
+        components.push({
+            name: 'input_validation',
+            value: validationConfidence,
+            weight: 0.3,
+        });
+        // Context confidence
+        const contextConfidence = input.context.authenticated ? 1.0 : 0.5;
+        components.push({
+            name: 'context_resolution',
+            value: contextConfidence,
+            weight: 0.3,
+        });
+        // Calculate weighted average
+        const totalWeight = components.reduce((sum, c) => sum + c.weight, 0);
+        const weightedSum = components.reduce((sum, c) => sum + c.value * c.weight, 0);
+        const value = weightedSum / totalWeight;
+        return {
+            value,
+            basis: 'command_resolution',
+            components,
+        };
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    buildOutput(success, result, input, startTime, startedAt) {
+        const completedAt = new Date().toISOString();
+        const totalMs = Date.now() - startTime;
+        const timing = {
+            total_ms: totalMs,
+            breakdown: {
+                validation: Math.min(10, totalMs * 0.1),
+                processing: totalMs * 0.9,
+            },
+            started_at: startedAt,
+            completed_at: completedAt,
+        };
+        // Calculate confidence
+        const confidence = this.calculateConfidence(input, result);
+        // Build and emit DecisionEvent (async, non-blocking)
+        const decisionEvent = this.buildDecisionEvent(input, result, confidence);
+        if (this.config.emit_decisions) {
+            this.decisionEmitter.emitAsync(decisionEvent);
+        }
+        // Record completion telemetry
+        this.telemetryEmitter.record('agent_completion', CLI_UX_AGENT_ID, input.trace_id, {
+            type: 'completion',
+            success,
+            duration_ms: totalMs,
+            services_invoked: result.type === 'success' ? result.services_invoked : [],
+        });
+        return {
+            success,
+            result,
+            decision_event: decisionEvent,
+            timing,
+        };
+    }
+    buildDecisionEvent(input, result, confidence) {
+        const builder = new DecisionEventBuilder({
+            trace_id: input.trace_id,
+            command: input.command.command,
+            subcommand: input.command.subcommand,
+        });
+        const decisionType = this.determineDecisionType(input, result);
+        const constraints = this.buildConstraints(input);
+        builder
+            .withDecisionType(decisionType)
+            .withInputsHash(input)
+            .withResultType(result.type)
+            .withConfidence(confidence)
+            .withConstraints(constraints);
+        if (result.type === 'success') {
+            const successResult = result;
+            if (successResult.artifact_ref) {
+                builder.withArtifactRef(successResult.artifact_ref);
+            }
+            builder.withServicesInvoked(successResult.services_invoked);
+        }
+        return builder.build();
+    }
+    determineDecisionType(input, result) {
+        if (result.type === 'error') {
+            return 'error_presentation';
+        }
+        if (result.type === 'guidance') {
+            return 'workflow_guidance';
+        }
+        // Determine based on command
+        const { command } = input.command;
+        if (['help', 'version'].includes(command)) {
+            return 'workflow_guidance';
+        }
+        if (['plan', 'simulate', 'inspect', 'quantify', 'deploy', 'export', 'erp', 'diligence'].includes(command)) {
+            return 'service_routing';
+        }
+        return 'cli_ux_orchestration';
+    }
+    buildConstraints(input) {
+        const environment = {
+            is_local: !process.env['AGENTICS_PRODUCTION'],
+            is_production: !!process.env['AGENTICS_PRODUCTION'],
+            execution_gate_enabled: input.context.execution_gate_enabled,
+            auth_present: input.context.authenticated,
+        };
+        return {
+            permissions: input.context.authenticated ? ['authenticated'] : ['anonymous'],
+            environment,
+            scope: [],
+        };
+    }
+    buildSuccessResult(input) {
+        return {
+            type: 'success',
+            data: {
+                command: input.command.command,
+                subcommand: input.command.subcommand,
+                processed: true,
+            },
+            services_invoked: [],
+        };
+    }
+    buildErrorResult(errors) {
+        return {
+            type: 'error',
+            code: errors[0]?.code ?? 'ECLI-AGENT-001',
+            message: errors.map(e => e.message).join('; '),
+            details: { errors },
+            recoverable: false,
+        };
+    }
+    checkForGuidance(input) {
+        const { command } = input.command;
+        // Help command
+        if (command === 'help' || input.command.flags['help'] || input.command.flags['h']) {
+            return {
+                type: 'guidance',
+                message: 'Available commands and options',
+                options: [
+                    { label: 'plan', command: 'agentics plan', description: 'Create simulation plans' },
+                    { label: 'simulate', command: 'agentics simulate', description: 'Run simulations' },
+                    { label: 'inspect', command: 'agentics inspect', description: 'Query simulation results' },
+                    { label: 'quantify', command: 'agentics quantify', description: 'Generate ROI analysis' },
+                    { label: 'deploy', command: 'agentics deploy', description: 'Resolve deployment intent' },
+                    { label: 'export', command: 'agentics export', description: 'Generate IaC artifacts' },
+                ],
+                next_steps: [
+                    'Run "agentics <command> help" for command-specific help',
+                    'Run "agentics login" to authenticate',
+                ],
+            };
+        }
+        // No guidance needed
+        return null;
+    }
+    calculateCommandConfidence(command) {
+        // Known commands have high confidence
+        const knownCommands = [
+            'login', 'logout', 'whoami',
+            'plan', 'simulate', 'inspect', 'quantify',
+            'deploy', 'export', 'erp', 'diligence',
+            'usage', 'policy', 'audit',
+            'help', 'version',
+        ];
+        if (!command.command) {
+            return 0.0;
+        }
+        if (knownCommands.includes(command.command)) {
+            return 1.0;
+        }
+        // Partial match
+        const partialMatch = knownCommands.some(c => c.startsWith(command.command));
+        if (partialMatch) {
+            return 0.5;
+        }
+        return 0.1;
+    }
+    parseFlags(args) {
+        const flags = {};
+        for (const arg of args) {
+            if (arg.startsWith('--') && !arg.includes('=')) {
+                flags[arg.slice(2)] = true;
+            }
+            else if (arg.startsWith('-') && !arg.startsWith('--')) {
+                flags[arg.slice(1)] = true;
+            }
+        }
+        return flags;
+    }
+    parseOptions(args) {
+        const options = {};
+        for (let i = 0; i < args.length; i++) {
+            const arg = args[i];
+            if (arg?.startsWith('--') && arg.includes('=')) {
+                const [key, value] = arg.slice(2).split('=');
+                if (key && value) {
+                    options[key] = value;
+                }
+            }
+            else if (arg?.startsWith('--') && args[i + 1] && !args[i + 1]?.startsWith('-')) {
+                options[arg.slice(2)] = args[i + 1];
+                i++;
+            }
+        }
+        return options;
+    }
+    checkAuthentication() {
+        // Check for auth token in environment
+        return !!process.env['AGENTICS_API_KEY'] || !!process.env['AGENTICS_AUTH_TOKEN'];
+    }
+    checkExecutionGate() {
+        return process.env['AGENTICS_EXECUTION_ENABLED'] !== 'false';
+    }
+    computeInputHash(input) {
+        const canonical = JSON.stringify({
+            command: input.command,
+            args: input.args,
+        });
+        return crypto.createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a CLI UX Agent instance.
+ */
+export function createCLIUXAgent(config) {
+    return new CLIUXAgent(config);
+}
+/**
+ * Get the CLI UX Agent registration.
+ */
+export function getCLIUXAgentRegistration() {
+    return CLI_UX_AGENT_REGISTRATION;
+}
+//# sourceMappingURL=cli-ux-agent.js.map

package/dist/agents/cli-ux-agent.js.map

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

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

@@ -0,0 +1,177 @@
+/**
+ * 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 type { DecisionEvent, DecisionType, ConfidenceScore, ConstraintsApplied, ExecutionReference, EnvironmentContext, TelemetryEventType, TelemetryData } from './types.js';
+export interface DecisionEventBuilderOptions {
+    trace_id: string;
+    command: string;
+    subcommand?: string;
+}
+/**
+ * Builder for constructing DecisionEvents.
+ * Ensures all required fields are set before emission.
+ */
+export declare class DecisionEventBuilder {
+    private readonly trace_id;
+    private readonly command;
+    private readonly subcommand?;
+    private decision_type;
+    private inputs_hash;
+    private result_type;
+    private artifact_ref?;
+    private services_invoked;
+    private confidence;
+    private constraints;
+    private execution_ref;
+    constructor(options: DecisionEventBuilderOptions);
+    /**
+     * Set decision type.
+     */
+    withDecisionType(type: DecisionType): this;
+    /**
+     * Set inputs hash from raw inputs.
+     * Computes hash, never stores raw data.
+     */
+    withInputsHash(inputs: unknown): this;
+    /**
+     * Set result type.
+     */
+    withResultType(type: 'success' | 'error' | 'guidance'): this;
+    /**
+     * Set artifact reference.
+     */
+    withArtifactRef(ref: string): this;
+    /**
+     * Add services that were invoked.
+     */
+    withServicesInvoked(services: string[]): this;
+    /**
+     * Set confidence score.
+     */
+    withConfidence(confidence: ConfidenceScore): this;
+    /**
+     * Set constraints applied.
+     */
+    withConstraints(constraints: ConstraintsApplied): this;
+    /**
+     * Set environment context.
+     */
+    withEnvironment(env: EnvironmentContext): this;
+    /**
+     * Set execution reference from downstream service.
+     */
+    withExecutionRef(ref: ExecutionReference): this;
+    /**
+     * Build the DecisionEvent.
+     */
+    build(): DecisionEvent;
+    /**
+     * Compute hash of inputs for reproducibility.
+     */
+    private computeHash;
+    private sortKeys;
+}
+export interface DecisionEventEmitterConfig {
+    /** RuVector service URL */
+    ruvector_url?: string;
+    /** Enable emission (default: true if ruvector_url set) */
+    enabled?: boolean;
+    /** Timeout for emission in ms */
+    timeout?: number;
+    /** Auth token for ruvector-service */
+    auth_token?: string;
+}
+/**
+ * Emits DecisionEvents to ruvector-service.
+ *
+ * CRITICAL: Emission is async and non-blocking.
+ * Failures are logged but do not affect UX flow.
+ */
+export declare class DecisionEventEmitter {
+    private readonly config;
+    constructor(config?: DecisionEventEmitterConfig);
+    /**
+     * Check if emission is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Emit a DecisionEvent.
+     *
+     * RULES:
+     * - Async, non-blocking
+     * - Never throws - failures are silent
+     * - Only one event per invocation should be emitted
+     */
+    emit(event: DecisionEvent): Promise<EmissionResult>;
+    /**
+     * Emit without waiting (fire and forget).
+     * Use when you don't care about the result.
+     */
+    emitAsync(event: DecisionEvent): void;
+}
+export interface EmissionResult {
+    success: boolean;
+    event_id?: string;
+    reason?: 'emission_disabled' | 'http_error' | 'timeout' | 'network_error';
+    status_code?: number;
+}
+export interface TelemetryEmitterConfig {
+    /** Enable telemetry emission */
+    enabled?: boolean;
+    /** Telemetry endpoint */
+    endpoint?: string;
+    /** Batch size before flush */
+    batch_size?: number;
+    /** Flush interval in ms */
+    flush_interval?: number;
+}
+/**
+ * Emits telemetry events compatible with LLM-Observatory.
+ */
+export declare class TelemetryEmitter {
+    private readonly config;
+    private readonly buffer;
+    private flushTimer;
+    constructor(config?: TelemetryEmitterConfig);
+    /**
+     * Record a telemetry event.
+     */
+    record(event_type: TelemetryEventType, agent_id: string, trace_id: string, data: TelemetryData): void;
+    /**
+     * Flush buffered events.
+     */
+    flush(): Promise<void>;
+    /**
+     * Stop the flush timer.
+     */
+    stop(): void;
+    private startFlushTimer;
+}
+/**
+ * Create a DecisionEvent builder.
+ */
+export declare function createDecisionEventBuilder(options: DecisionEventBuilderOptions): DecisionEventBuilder;
+/**
+ * Create a DecisionEvent emitter.
+ */
+export declare function createDecisionEventEmitter(config?: DecisionEventEmitterConfig): DecisionEventEmitter;
+/**
+ * Create a telemetry emitter.
+ */
+export declare function createTelemetryEmitter(config?: TelemetryEmitterConfig): TelemetryEmitter;
+//# sourceMappingURL=decision-event.d.ts.map