@llm-dev-ops/agentics-cli 1.4.59 → 1.4.68

package/README.md

@@ -268,4 +268,4 @@ For API key management and interactive workflows, visit:
 
 ## License
 
-MIT
+This software requires a paid usage license from **Global Business Advisors**. All rights reserved. Unauthorized use, reproduction, or distribution is prohibited. Contact [Global Business Advisors](https://globalbusinessadvisors.com) for licensing information.

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

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

package/dist/commands/agents.js

@@ -3652,6 +3652,173 @@ function buildDomainPayload(domain, agent, query, correlationId) {
 export async function executeNaturalLanguageRoute(query, options) {
     const start = Date.now();
     const correlationId = options.trace_id ?? crypto.randomUUID();
+    // ========================================================================
+    // ADR-030: Capability Graph Routing
+    //
+    // Before dispatching ALL 109 agents, attempt targeted routing via the
+    // ecosystem capability graph. If the graph matches capabilities, dispatch
+    // only the relevant 5-15 agents instead of the full fleet.
+    //
+    // Falls back to full-fleet dispatch if:
+    //   - No capabilities match the query
+    //   - The graph file is missing or invalid
+    //   - AGENTICS_FULL_FLEET=true is set (force full-fleet mode)
+    // ========================================================================
+    const forceFullFleet = process.env['AGENTICS_FULL_FLEET'] === 'true';
+    if (!forceFullFleet) {
+        try {
+            const { routeQuery } = await import('../routing/index.js');
+            const graphResult = routeQuery(query);
+            if (graphResult.matched && graphResult.agents.length > 0) {
+                console.error(`Capability graph routing — ${graphResult.routing.totalAgents} agents across ${graphResult.routing.totalRepos} repos (from ${graphResult.routing.resolvedCapabilities.length} capabilities)`);
+                console.error(graphResult.routing.explanation);
+                // Run ruvector simulation first (same as full-fleet path, ADR-016)
+                console.error('  [RUVECTOR] Running simulation before graph-routed dispatch (ADR-016)...');
+                const simResult = await (async () => {
+                    const MAX_RETRIES = 3;
+                    let lastErr;
+                    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+                        try {
+                            if (attempt > 0) {
+                                const backoffMs = 10000 * Math.pow(2, attempt - 1);
+                                console.error(`  [RUVECTOR] Retry ${attempt}/${MAX_RETRIES} after ${(backoffMs / 1000).toFixed(0)}s backoff...`);
+                                await new Promise(resolve => setTimeout(resolve, backoffMs));
+                            }
+                            const result = await executeSimulateCommand({ planRef: { type: 'natural-language', description: query } }, { ...options, trace_id: correlationId });
+                            console.error('  [RUVECTOR] Simulation succeeded');
+                            return { kind: 'simulation', domain: 'simulator', agent: 'enterprise', status: 200, response: result };
+                        }
+                        catch (err) {
+                            lastErr = err instanceof Error ? err : new Error(String(err));
+                            const msg = lastErr.message.toLowerCase();
+                            const isRetryable = msg.includes('unavailable')
+                                || msg.includes('timeout')
+                                || msg.includes('rate exceeded')
+                                || msg.includes('econnreset')
+                                || msg.includes('econnrefused')
+                                || msg.includes('network error')
+                                || msg.includes('aborterror');
+                            if (!isRetryable) {
+                                console.error(`  [RUVECTOR] Non-retryable error: ${lastErr.message}`);
+                                break;
+                            }
+                            console.error(`  [RUVECTOR] Attempt ${attempt + 1}/${MAX_RETRIES + 1} failed: ${lastErr.message.slice(0, 150)}`);
+                        }
+                    }
+                    console.error(`  [RUVECTOR] Simulation failed after ${MAX_RETRIES + 1} attempts: ${lastErr?.message ?? 'unknown error'}`);
+                    return { kind: 'simulation', domain: 'simulator', agent: 'enterprise', status: 502, response: { error: lastErr?.message ?? 'Enterprise simulation failed after retries' } };
+                })();
+                // Dispatch graph-selected agents in parallel
+                const REPO_LOCAL_DOMAINS = new Set(['copilot']);
+                const prevLocalAgents = process.env['AGENTICS_LOCAL_AGENTS'];
+                console.error(`  Dispatching ${graphResult.agents.length} graph-routed agents...`);
+                const agentPromises = [];
+                for (const ref of graphResult.agents) {
+                    agentPromises.push((async () => {
+                        try {
+                            if (!REPO_LOCAL_DOMAINS.has(ref.domain)) {
+                                process.env['AGENTICS_LOCAL_AGENTS'] = 'false';
+                            }
+                            else if (prevLocalAgents !== undefined) {
+                                process.env['AGENTICS_LOCAL_AGENTS'] = prevLocalAgents;
+                            }
+                            else {
+                                delete process.env['AGENTICS_LOCAL_AGENTS'];
+                            }
+                            const payload = buildDomainPayload(ref.domain, ref.agent, query, correlationId);
+                            const result = await executeAgentsInvokeCommand(ref.domain, ref.agent, payload, options);
+                            return { kind: 'agent', domain: ref.domain, agent: ref.agent, status: result.status ?? 200, response: result.response };
+                        }
+                        catch (err) {
+                            return { kind: 'agent', domain: ref.domain, agent: ref.agent, status: 502, response: { error: err instanceof Error ? err.message : String(err) } };
+                        }
+                    })());
+                }
+                const allResults = await Promise.allSettled([Promise.resolve(simResult), ...agentPromises]);
+                const elapsed = Date.now() - start;
+                // Restore repo-local mode
+                if (prevLocalAgents !== undefined) {
+                    process.env['AGENTICS_LOCAL_AGENTS'] = prevLocalAgents;
+                }
+                else {
+                    delete process.env['AGENTICS_LOCAL_AGENTS'];
+                }
+                // Build multi-result response
+                const intents = [];
+                const invocations = [];
+                for (const settled of allResults) {
+                    if (settled.status === 'fulfilled') {
+                        const val = settled.value;
+                        const intent = {
+                            domain: val.domain,
+                            agent: val.agent,
+                            confidence: 1.0,
+                            suggested_payload: {},
+                            reasoning: val.kind === 'simulation'
+                                ? 'Graph-routed: ruvector hyperbolic simulation'
+                                : `Graph-routed: ${val.domain}/${val.agent}`,
+                        };
+                        intents.push(intent);
+                        const respObj = val.response && typeof val.response === 'object' ? val.response : undefined;
+                        const hasExecMeta = respObj && 'execution_metadata' in respObj;
+                        if ((val.status >= 200 && val.status < 300) || hasExecMeta) {
+                            invocations.push({ intent, result: { domain: val.domain, agent: val.agent, status: val.status, response: val.response, timing: elapsed } });
+                        }
+                        else {
+                            const errMsg = respObj && 'error' in respObj
+                                ? String(respObj.error)
+                                : `HTTP ${val.status}`;
+                            invocations.push({ intent, result: { error: errMsg } });
+                        }
+                    }
+                }
+                // Non-fatal: generate artifacts
+                try {
+                    const { generateSimulationArtifacts } = await import('../synthesis/simulation-artifact-generator.js');
+                    const simSettled = allResults[0];
+                    const simVal = simSettled?.status === 'fulfilled' ? simSettled.value : undefined;
+                    const agentResults = allResults.slice(1)
+                        .filter((r) => r.status === 'fulfilled')
+                        .map(r => r.value);
+                    const simResponse = (simVal && simVal.status >= 200 && simVal.status < 300)
+                        ? simVal.response
+                        : undefined;
+                    const simulationData = simResponse?.['simulationData'] ?? simResponse;
+                    const artifacts = generateSimulationArtifacts({
+                        executionId: correlationId,
+                        query,
+                        simulationResult: simulationData,
+                        platformAnalysis: agentResults.map(p => ({ domain: p.domain, agent: p.agent, status: p.status, response: p.response })),
+                        correlationId,
+                        timing: elapsed,
+                    });
+                    console.error(`Graph-routed artifacts: ${artifacts.runDir}`);
+                }
+                catch (artifactErr) {
+                    const artMsg = artifactErr instanceof Error ? artifactErr.message : String(artifactErr);
+                    console.error(`[WARN] Graph-routed artifact generation failed: ${artMsg}`);
+                }
+                return {
+                    kind: 'multi',
+                    result: {
+                        query,
+                        intents,
+                        invocations,
+                        timing: elapsed,
+                    },
+                };
+            }
+            // No capabilities matched — fall through to full-fleet dispatch
+            if (graphResult.routing.totalAgents === 0) {
+                console.error('Capability graph: no capabilities matched query. Falling back to full-fleet dispatch.');
+            }
+        }
+        catch (graphErr) {
+            // Graph loading/routing failed — fall through to full-fleet dispatch
+            const msg = graphErr instanceof Error ? graphErr.message : String(graphErr);
+            console.error(`[WARN] Capability graph routing failed: ${msg}. Falling back to full-fleet dispatch.`);
+        }
+    }
     // Full-Fleet Pipeline — ALL 109 agents across ALL 27 domains, EVERY query. No detection gate.
     // Every agent in every domain fires in parallel + ruvector simulation = 110 parallel dispatches.
     // Every agent triggers its repo. Every repo contributes data.