@llm-dev-ops/agentics-cli 1.4.14 → 1.4.16

package/dist/commands/agents.js

@@ -0,0 +1,378 @@
+/**
+ * Agents Command
+ *
+ * Routes CLI invocations to 27 downstream agent Cloud Functions.
+ * Uses the existing adapter layer (createAdapter + invoke_agent).
+ *
+ * Usage:
+ *   agentics agents list
+ *   agentics agents health <domain>
+ *   agentics agents invoke <domain> <agent> [json-payload]
+ */
+import { loadEndpointConfig } from '../config/endpoints.js';
+import { createAdapter } from '../adapters/base-adapter.js';
+export const AGENT_DOMAINS = {
+    'test-bench': {
+        serviceName: 'test-bench-agents',
+        agents: ['benchmark', 'compare', 'regression', 'quality', 'hallucination', 'faithfulness', 'bias', 'prompt-sensitivity', 'consistency', 'stress', 'red-team', 'adversarial', 'golden-dataset', 'synthetic-data'],
+        phase: 'Phase 1: Evaluation',
+    },
+    'observatory': {
+        serviceName: 'observatory-agents',
+        agents: ['telemetry', 'usage-patterns', 'failures', 'health-check', 'slo', 'post-mortem', 'visualization'],
+        phase: 'Phase 1: Telemetry',
+    },
+    'shield': {
+        serviceName: 'shield-agents',
+        agents: ['prompt-injection', 'pii', 'redaction', 'secrets', 'toxicity', 'safety-boundary', 'moderation', 'abuse', 'credential-exposure'],
+        phase: 'Phase 1: Safety',
+    },
+    'sentinel': {
+        serviceName: 'sentinel-agents',
+        agents: ['anomaly', 'drift', 'alert', 'correlation', 'rca'],
+        phase: 'Phase 2: Operational Intelligence',
+    },
+    'memory-graph': {
+        serviceName: 'memory-graph-agents',
+        agents: ['conversation', 'lineage', 'decisions', 'knowledge-graph', 'retrieval', 'patterns'],
+        phase: 'Phase 2: Operational Intelligence',
+    },
+    'latency-lens': {
+        serviceName: 'latency-lens-agents',
+        agents: ['latency', 'cold-start'],
+        phase: 'Phase 2: Operational Intelligence',
+    },
+    'forge': {
+        serviceName: 'forge-agents',
+        agents: ['sdk', 'cli', 'api-translation', 'version-compat'],
+        phase: 'Phase 2: Operational Intelligence',
+    },
+    'edge': {
+        serviceName: 'edge-agents',
+        agents: ['tool-invoke', 'circuit-breaker', 'failover', 'execution-guard', 'caching'],
+        phase: 'Phase 3: Automation & Resilience',
+    },
+    'auto-optimizer': {
+        serviceName: 'auto-optimizer-agents',
+        agents: ['self-optimize', 'token', 'model-select'],
+        phase: 'Phase 3: Automation & Resilience',
+    },
+    'incident-manager': {
+        serviceName: 'incident-manager-agents',
+        agents: ['escalation', 'post-mortem', 'hitl'],
+        phase: 'Phase 3: Automation & Resilience',
+    },
+    'orchestrator': {
+        serviceName: 'orchestrator-agents',
+        agents: ['workflow', 'scheduler', 'dependencies', 'retry', 'parallel', 'state-machine', 'swarm'],
+        phase: 'Phase 3: Automation & Resilience',
+    },
+    'costops': {
+        serviceName: 'costops-agents',
+        agents: ['attribution', 'forecast', 'budget', 'roi', 'tradeoff'],
+        phase: 'Phase 4: Governance & FinOps',
+    },
+    'governance-dashboard': {
+        serviceName: 'governance-dashboard-agents',
+        agents: ['audit', 'impact', 'oversight'],
+        phase: 'Phase 4: Governance & FinOps',
+    },
+    'policy-engine': {
+        serviceName: 'policy-engine-agents',
+        agents: ['enforce', 'constraints', 'approval'],
+        phase: 'Phase 4: Governance & FinOps',
+    },
+    'registry': {
+        serviceName: 'registry-agents',
+        agents: ['index', 'reputation', 'bootstrap'],
+        phase: 'Phase 5: Ecosystem',
+    },
+    'marketplace': {
+        serviceName: 'marketplace-agents',
+        agents: ['package', 'deprecation'],
+        phase: 'Phase 5: Ecosystem',
+    },
+    'analytics-hub': {
+        serviceName: 'analytics-hub-agents',
+        agents: ['consensus', 'recommendation'],
+        phase: 'Phase 5: Ecosystem',
+    },
+    'config-manager': {
+        serviceName: 'config-manager-agents',
+        agents: ['validate'],
+        phase: 'Phase 6: Core Infrastructure',
+    },
+    'schema-registry': {
+        serviceName: 'schema-registry-agents',
+        agents: ['validate'],
+        phase: 'Phase 6: Core Infrastructure',
+    },
+    'connector-hub': {
+        serviceName: 'connector-hub-agents',
+        agents: ['erp-surface', 'database-query', 'webhook-ingest', 'event-normalize', 'auth-identity'],
+        phase: 'Phase 6: Core Infrastructure',
+    },
+    'copilot': {
+        serviceName: 'copilot-agents',
+        agents: ['planner', 'config', 'decomposer', 'clarifier', 'intent', 'reflection', 'meta-reasoner'],
+        phase: 'Phase 7: Intelligence',
+    },
+    'simulator': {
+        serviceName: 'simulator-agents',
+        agents: ['what-if', 'scenario'],
+        phase: 'Phase 7: Intelligence',
+    },
+    'benchmark-exchange': {
+        serviceName: 'benchmark-exchange-agents',
+        agents: ['publish'],
+        phase: 'Phase 7: Intelligence',
+    },
+    'inference-gateway': {
+        serviceName: 'inference-gateway-agents',
+        agents: ['route'],
+        phase: 'Phase 7: Intelligence',
+    },
+    'data-vault': {
+        serviceName: 'data-vault-agents',
+        agents: ['access-control', 'anonymize'],
+        phase: 'Phase 7: Intelligence',
+    },
+    'research-lab': {
+        serviceName: 'research-lab-agents',
+        agents: ['hypothesis', 'metrics'],
+        phase: 'Phase 7: Intelligence',
+    },
+    'platform': {
+        serviceName: 'platform-agents',
+        agents: ['decision', 'executive-summary', 'decision-memo', 'risk-score'],
+        phase: 'Phase 9: Apex Platform',
+    },
+};
+// ============================================================================
+// Command Implementations
+// ============================================================================
+export async function executeAgentsListCommand(_options) {
+    const start = Date.now();
+    const domains = Object.entries(AGENT_DOMAINS).map(([name, d]) => ({
+        name,
+        serviceName: d.serviceName,
+        agents: d.agents,
+        agentCount: d.agents.length,
+        phase: d.phase,
+    }));
+    const totalAgents = domains.reduce((sum, d) => sum + d.agentCount, 0);
+    return {
+        domains,
+        totalDomains: domains.length,
+        totalAgents,
+        timing: Date.now() - start,
+    };
+}
+export async function executeAgentsHealthCommand(domain, options) {
+    const start = Date.now();
+    const domainConfig = AGENT_DOMAINS[domain];
+    if (!domainConfig) {
+        const validDomains = Object.keys(AGENT_DOMAINS).join(', ');
+        throw new Error(`Unknown domain '${domain}'. Valid domains: ${validDomains}`);
+    }
+    const config = loadEndpointConfig(domainConfig.serviceName);
+    const url = `${config.baseUrl}/health`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), config.timeout);
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'X-Correlation-ID': options.trace_id ?? crypto.randomUUID(),
+            },
+            signal: controller.signal,
+        });
+        const body = await response.json();
+        return {
+            domain,
+            serviceName: domainConfig.serviceName,
+            healthy: response.ok,
+            response: body,
+            timing: Date.now() - start,
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export async function executeAgentsInvokeCommand(domain, agent, payload, options) {
+    const start = Date.now();
+    const domainConfig = AGENT_DOMAINS[domain];
+    if (!domainConfig) {
+        const validDomains = Object.keys(AGENT_DOMAINS).join(', ');
+        throw new Error(`Unknown domain '${domain}'. Valid domains: ${validDomains}`);
+    }
+    if (!domainConfig.agents.includes(agent)) {
+        throw new Error(`Unknown agent '${agent}' in domain '${domain}'. Valid agents: ${domainConfig.agents.join(', ')}`);
+    }
+    const config = loadEndpointConfig(domainConfig.serviceName);
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    const adapter = createAdapter(domainConfig.serviceName, config, correlationId);
+    const response = await adapter.invoke({
+        endpoint: `/v1/${domain}/${agent}`,
+        method: 'POST',
+        headers: {},
+        body: payload,
+    });
+    return {
+        domain,
+        agent,
+        status: response.status,
+        response: response.body,
+        timing: Date.now() - start,
+    };
+}
+// ============================================================================
+// Formatters
+// ============================================================================
+export function formatAgentsListForDisplay(result) {
+    const lines = [];
+    lines.push(`Downstream Agent Services: ${result.totalDomains} domains, ${result.totalAgents} agents`);
+    lines.push('');
+    let currentPhase = '';
+    for (const d of result.domains) {
+        if (d.phase !== currentPhase) {
+            currentPhase = d.phase;
+            lines.push(`  ${currentPhase}`);
+        }
+        const agentList = d.agents.join(', ');
+        lines.push(`    ${d.name.padEnd(24)} [${d.agentCount}] ${agentList}`);
+    }
+    return lines.join('\n');
+}
+export function formatAgentResultForDisplay(result) {
+    const lines = [];
+    lines.push(`Agent: ${result.domain}/${result.agent}`);
+    lines.push(`Status: ${result.status}`);
+    lines.push(`Timing: ${result.timing}ms`);
+    lines.push('');
+    lines.push(JSON.stringify(result.response, null, 2));
+    return lines.join('\n');
+}
+const NL_MINIMUM_CONFIDENCE = 0.2;
+const NL_LOW_CONFIDENCE = 0.5;
+/**
+ * Route a natural language query to the appropriate downstream agent.
+ *
+ * Calls copilot/intent with the query + full domain registry,
+ * validates the classification, then dispatches to the target agent.
+ */
+export async function executeNaturalLanguageRoute(query, options) {
+    const start = Date.now();
+    const correlationId = options.trace_id ?? crypto.randomUUID();
+    // Build domain registry for the intent agent
+    const availableDomains = {};
+    for (const [name, domain] of Object.entries(AGENT_DOMAINS)) {
+        availableDomains[name] = {
+            agents: domain.agents,
+            phase: domain.phase,
+        };
+    }
+    // Call copilot/intent agent
+    const config = loadEndpointConfig('copilot-agents');
+    const adapter = createAdapter('copilot-agents', config, correlationId);
+    let intentResponse;
+    try {
+        intentResponse = await adapter.invoke({
+            endpoint: '/v1/copilot/intent',
+            method: 'POST',
+            headers: {},
+            body: {
+                text: query,
+                agent: 'intent',
+                payload: {
+                    query,
+                    available_domains: availableDomains,
+                },
+                context: {
+                    trace_id: correlationId,
+                    source: 'cli-nl-routing',
+                },
+            },
+        });
+    }
+    catch (adapterError) {
+        throw new Error(`Intent classification failed for: "${query}"\n` +
+            `  The copilot intent agent returned an error.\n` +
+            `  ${adapterError instanceof Error ? adapterError.message : String(adapterError)}\n` +
+            `\n` +
+            `  Use explicit invocation instead:\n` +
+            `    agentics agents list\n` +
+            `    agentics agents invoke <domain> <agent> '<json-payload>'`);
+    }
+    // Parse the intent classification from response
+    const responseBody = intentResponse.body;
+    // The result may be nested inside a `result` envelope
+    const resultBody = (responseBody.result ?? responseBody);
+    const intent = {
+        domain: resultBody.domain ?? '',
+        agent: resultBody.agent ?? '',
+        confidence: resultBody.confidence ?? 0,
+        suggested_payload: resultBody.suggested_payload ?? {},
+        reasoning: resultBody.reasoning,
+        alternatives: resultBody.alternatives,
+    };
+    // Validate confidence threshold
+    if (intent.confidence < NL_MINIMUM_CONFIDENCE || !intent.domain || !intent.agent) {
+        throw new Error(`Could not determine intent from: "${query}"\n` +
+            `  Confidence: ${(intent.confidence * 100).toFixed(0)}% (minimum: ${(NL_MINIMUM_CONFIDENCE * 100)}%)\n` +
+            (intent.reasoning ? `  Reasoning: ${intent.reasoning}\n` : '') +
+            `\n` +
+            `  Try being more specific, or use explicit invocation:\n` +
+            `    agentics agents invoke <domain> <agent> '<json-payload>'\n` +
+            `    agentics agents list   # show available domains and agents`);
+    }
+    // Validate domain/agent against local registry
+    const domainConfig = AGENT_DOMAINS[intent.domain];
+    if (!domainConfig) {
+        throw new Error(`Intent agent returned unknown domain: '${intent.domain}'\n` +
+            `  Valid domains: ${Object.keys(AGENT_DOMAINS).join(', ')}`);
+    }
+    if (!domainConfig.agents.includes(intent.agent)) {
+        throw new Error(`Intent agent returned unknown agent '${intent.agent}' for domain '${intent.domain}'\n` +
+            `  Valid agents: ${domainConfig.agents.join(', ')}`);
+    }
+    // Log classification to stderr
+    const pct = (intent.confidence * 100).toFixed(0);
+    console.error(`Routing to ${intent.domain}/${intent.agent} (${pct}% confidence)`);
+    if (intent.reasoning) {
+        console.error(`  Reason: ${intent.reasoning}`);
+    }
+    // Warn on low confidence
+    if (intent.confidence < NL_LOW_CONFIDENCE) {
+        console.error(`  Warning: Low confidence match. If incorrect, try:\n` +
+            `    agentics agents invoke ${intent.domain} ${intent.agent} '<payload>'`);
+        if (intent.alternatives && intent.alternatives.length > 0) {
+            console.error(`  Other candidates:`);
+            for (const alt of intent.alternatives.slice(0, 3)) {
+                console.error(`    - ${alt.domain}/${alt.agent} (${(alt.confidence * 100).toFixed(0)}%)`);
+            }
+        }
+    }
+    // Dispatch to the target agent
+    const invocation = await executeAgentsInvokeCommand(intent.domain, intent.agent, intent.suggested_payload, options);
+    return {
+        intent,
+        invocation,
+        timing: Date.now() - start,
+    };
+}
+export function formatNaturalLanguageRouteForDisplay(result) {
+    const lines = [];
+    lines.push(`Query routed to: ${result.intent.domain}/${result.intent.agent}`);
+    lines.push(`Confidence: ${(result.intent.confidence * 100).toFixed(0)}%`);
+    if (result.intent.reasoning) {
+        lines.push(`Reasoning: ${result.intent.reasoning}`);
+    }
+    lines.push(`Agent Status: ${result.invocation.status}`);
+    lines.push(`Total Timing: ${result.timing}ms`);
+    lines.push('');
+    lines.push(JSON.stringify(result.invocation.response, null, 2));
+    return lines.join('\n');
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/agents.js.map

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

package/dist/commands/demo.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Demo Command — `agentics demo start <scenario>`
+ *
+ * PURPOSE: Present a guided, read-only walkthrough of the platform's
+ * value for a given simulation scenario. Designed for executive audiences.
+ *
+ * SAFETY GUARANTEES:
+ * - Read-only: reads from decision-readiness artifacts, never writes
+ * - Gate-exempt: does not trigger any of the 7 enforcement gates
+ * - Non-interactive: no subcommands, no branching, no execution paths
+ * - Cannot unlock execution, modify state, or invoke downstream services
+ *
+ * SUBCOMMANDS:
+ * - start <scenario>   Run the guided demo walkthrough
+ */
+export interface DemoResult {
+    output: string;
+    found: boolean;
+    scenario: string;
+    timing: number;
+}
+/**
+ * Execute `agentics demo start <scenario>`.
+ * Loads audited artifacts and renders a guided walkthrough.
+ */
+export declare function executeDemoStartCommand(params: {
+    scenario: string;
+    extraArgs: string[];
+}): Promise<DemoResult>;
+//# sourceMappingURL=demo.d.ts.map

package/dist/commands/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/commands/demo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuGH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAmVD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAChD,OAAO,CAAC,UAAU,CAAC,CA8DrB"}