@llm-dev-ops/agentics-cli 1.4.53 → 1.4.54

package/dist/bundled-agents/copilot-agents/functions/dist/functions/src/router.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Agent Router
+ *
+ * Maps URL slugs to agent invocations.
+ * Does NOT create new agents or modify business logic.
+ * Instantiates existing agents with persistence/telemetry from env
+ * and routes HTTP bodies to agent.invoke().
+ *
+ * Routes:
+ *   planner       → PlannerAgent
+ *   config        → ConfigValidationAgent
+ *   decomposer    → DecomposerAgent
+ *   clarifier     → ObjectiveClarifierAgent
+ *   intent        → IntentClassifierAgent
+ *   reflection    → ReflectionAgent
+ *   meta-reasoner → MetaReasonerAgent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeRequest = routeRequest;
+const uuid_1 = require("uuid");
+const contracts_1 = require("../../services/agents/contracts");
+// Agent imports
+const planner_1 = require("../../services/agents/planner");
+const config_validation_1 = require("../../services/agents/config-validation");
+const decomposer_1 = require("../../services/agents/decomposer");
+const objective_clarifier_1 = require("../../services/agents/objective-clarifier");
+const intent_classifier_1 = require("../../services/agents/intent-classifier");
+const reflection_1 = require("../../services/agents/reflection");
+const meta_reasoner_1 = require("../../services/agents/meta-reasoner");
+// Each agent uses its own persistence/telemetry module (they have identical APIs
+// but TypeScript treats separate class declarations as distinct types)
+const ruvector_persistence_1 = require("../../services/agents/planner/ruvector-persistence");
+const telemetry_1 = require("../../services/agents/planner/telemetry");
+const ruvector_persistence_2 = require("../../services/agents/objective-clarifier/ruvector-persistence");
+const telemetry_2 = require("../../services/agents/objective-clarifier/telemetry");
+const ruvector_persistence_3 = require("../../services/agents/reflection/ruvector-persistence");
+const telemetry_3 = require("../../services/agents/reflection/telemetry");
+/**
+ * Agent factory: instantiate the correct agent for the given slug
+ */
+function createAgent(slug) {
+    switch (slug) {
+        case 'planner': {
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new planner_1.PlannerAgent(p, t);
+        }
+        case 'config': {
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new config_validation_1.ConfigValidationAgent(p, t);
+        }
+        case 'decomposer': {
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new decomposer_1.DecomposerAgent(p, t);
+        }
+        case 'clarifier': {
+            const p = (0, ruvector_persistence_2.createRuvectorFromEnv)();
+            const t = (0, telemetry_2.createTelemetryFromEnv)();
+            return new objective_clarifier_1.ObjectiveClarifierAgent(p, t);
+        }
+        case 'intent': {
+            // IntentClassifier imports from planner persistence/telemetry
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new intent_classifier_1.IntentClassifierAgent(p, t);
+        }
+        case 'reflection': {
+            const p = (0, ruvector_persistence_3.createRuvectorFromEnv)();
+            const t = (0, telemetry_3.createTelemetryFromEnv)();
+            return new reflection_1.ReflectionAgent(p, t);
+        }
+        case 'meta-reasoner': {
+            // MetaReasoner imports from planner persistence/telemetry
+            const p = (0, ruvector_persistence_1.createRuvectorFromEnv)();
+            const t = (0, telemetry_1.createTelemetryFromEnv)();
+            return new meta_reasoner_1.MetaReasonerAgent(p, t);
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Route a request to the appropriate agent
+ *
+ * @param slug - The agent slug from the URL path
+ * @param body - The parsed JSON request body
+ * @returns RouteResult with agent result and metadata
+ * @throws If the slug is unknown
+ */
+async function routeRequest(slug, body) {
+    const agent = createAgent(slug);
+    if (!agent) {
+        throw new Error(`Unknown agent: "${slug}". Valid agents: planner, config, decomposer, clarifier, intent, reflection, meta-reasoner`);
+    }
+    // Extract execution_ref from body or generate one
+    const bodyObj = body;
+    const executionRef = (typeof bodyObj.execution_ref === 'string' && bodyObj.execution_ref)
+        ? bodyObj.execution_ref
+        : (0, uuid_1.v4)();
+    // Extract pipeline_context if present (safe parse — don't fail if malformed)
+    let pipelineContext;
+    if (bodyObj.pipeline_context !== undefined) {
+        const parsed = contracts_1.PipelineContextSchema.safeParse(bodyObj.pipeline_context);
+        if (parsed.success) {
+            pipelineContext = parsed.data;
+        }
+    }
+    // Validate input through the agent's schema
+    const validatedInput = agent.validateInput(body);
+    // Invoke the agent
+    const agentResult = await agent.invoke(validatedInput, executionRef);
+    return {
+        agentResult,
+        agentSlug: slug,
+        pipelineContext,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/bundled-agents/copilot-agents/functions/dist/functions/src/router.js.map

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

package/dist/bundled-agents/copilot-agents/functions/dist/services/agents/config-validation/config-validation-agent.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Config Validation Agent
+ *
+ * Purpose: Validate configuration artifacts for structural and semantic correctness
+ * Classification: CONFIGURATION_VALIDATION, STATIC_ANALYSIS
+ * decision_type: config_validation
+ *
+ * Scope:
+ * - Validate schemas
+ * - Validate semantic constraints
+ * - Detect missing, conflicting, deprecated, or unsafe values
+ * - Assess configuration readiness
+ *
+ * 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 configuration
+ * - Apply defaults
+ * - Auto-fix values
+ * - Enforce policy
+ * - Block execution
+ */
+import { BaseAgent, AgentMetadata, AgentResult, ConfigValidationInput, ConfigValidationOutput } from '../contracts';
+import { RuvectorPersistence } from '../planner/ruvector-persistence';
+import { Telemetry } from '../planner/telemetry';
+/**
+ * Config Validation Agent Implementation
+ *
+ * This agent analyzes configuration artifacts and produces validation reports.
+ * It is purely analytical - it NEVER modifies, applies defaults, or auto-fixes.
+ */
+export declare class ConfigValidationAgent implements BaseAgent<ConfigValidationInput, ConfigValidationOutput> {
+    readonly metadata: AgentMetadata;
+    private readonly persistence;
+    private readonly telemetry;
+    constructor(persistence: RuvectorPersistence, telemetry: Telemetry);
+    /**
+     * Validate input against ConfigValidationInputSchema
+     */
+    validateInput(input: unknown): ConfigValidationInput;
+    /**
+     * Invoke the config validation agent
+     *
+     * DETERMINISTIC: Same input always produces same output structure
+     * STATELESS: No internal state modified
+     * NON-BLOCKING: Fully async
+     */
+    invoke(input: ConfigValidationInput, executionRef: string): Promise<AgentResult>;
+    /**
+     * Perform configuration validation
+     *
+     * This is the core validation logic - purely analytical.
+     * NEVER modifies, applies defaults, or auto-fixes anything.
+     */
+    private validateConfig;
+    /**
+     * Validate against schema if provided
+     */
+    private validateSchema;
+    /**
+     * Recursive schema validation
+     */
+    private validateAgainstSchema;
+    /**
+     * Check semantic constraints
+     */
+    private checkSemanticConstraints;
+    /**
+     * Check port ranges are valid
+     */
+    private checkPortRanges;
+    /**
+     * Check URL formats are valid
+     */
+    private checkUrlFormats;
+    /**
+     * Check timeout values are reasonable
+     */
+    private checkTimeoutValues;
+    /**
+     * Check memory values are reasonable
+     */
+    private checkMemoryValues;
+    /**
+     * Evaluate a custom constraint
+     */
+    private evaluateCustomConstraint;
+    /**
+     * Detect deprecated values
+     */
+    private detectDeprecatedValues;
+    /**
+     * Detect unsafe configurations
+     */
+    private detectUnsafeConfigs;
+    /**
+     * Check if a key/value pair looks like a secret
+     */
+    private looksLikeSecret;
+    /**
+     * Detect configuration conflicts
+     */
+    private detectConflicts;
+    /**
+     * Detect missing required configurations
+     */
+    private detectMissingConfigs;
+    /**
+     * Get value at a JSONPath-like path
+     */
+    private getValueAtPath;
+    /**
+     * Assess overall readiness
+     */
+    private assessReadiness;
+    /**
+     * Generate recommendations (informational only)
+     */
+    private generateRecommendations;
+    /**
+     * Calculate summary statistics
+     */
+    private calculateSummary;
+    /**
+     * Count total paths in config
+     */
+    private countPaths;
+    /**
+     * Determine overall validity
+     */
+    private determineValidity;
+    /**
+     * Hash configuration for tracking
+     */
+    private hashConfig;
+    /**
+     * Calculate confidence based on validation completeness
+     */
+    private calculateConfidence;
+    /**
+     * Get constraints applied during validation
+     */
+    private getAppliedConstraints;
+    /**
+     * Classify error for proper error code
+     */
+    private classifyError;
+}