@llm-dev-ops/agentics-cli 1.4.26 → 1.4.27

package/dist/bundled-agents/copilot-agents/lib/services/agents/decomposer/decomposer-agent.js

@@ -0,0 +1,360 @@
+"use strict";
+/**
+ * Decomposer Agent
+ *
+ * Purpose: Decompose complex objectives into manageable sub-objectives
+ * Classification: DECOMPOSITION, STRUCTURAL_SYNTHESIS
+ * decision_type: objective_decomposition
+ *
+ * Scope:
+ * - Break complex objectives into sub-objectives
+ * - Identify sub-objective relationships
+ * - Assess decomposition completeness
+ *
+ * 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:
+ * - Execute sub-objectives
+ * - Assign agents
+ * - Allocate resources
+ * - Schedule execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecomposerAgent = void 0;
+const uuid_1 = require("uuid");
+const contracts_1 = require("../contracts");
+const AGENT_ID = 'decomposer-agent';
+const AGENT_VERSION = '1.0.0';
+const DECISION_TYPE = 'objective_decomposition';
+/**
+ * Decomposer Agent Implementation
+ *
+ * This agent analyzes complex objectives and produces structured sub-objectives.
+ * It is purely analytical - it NEVER executes, assigns, or schedules anything.
+ */
+class DecomposerAgent {
+    metadata = {
+        id: AGENT_ID,
+        name: 'Decomposer Agent',
+        version: AGENT_VERSION,
+        classifications: [
+            contracts_1.AgentClassification.DECOMPOSITION,
+            contracts_1.AgentClassification.STRUCTURAL_SYNTHESIS,
+        ],
+        decision_type: DECISION_TYPE,
+        description: 'Decomposes complex objectives into manageable sub-objectives with relationships and completeness assessment.',
+    };
+    persistence;
+    telemetry;
+    constructor(persistence, telemetry) {
+        this.persistence = persistence;
+        this.telemetry = telemetry;
+    }
+    /**
+     * Validate input against DecomposerInputSchema
+     */
+    validateInput(input) {
+        return contracts_1.DecomposerInputSchema.parse(input);
+    }
+    /**
+     * Invoke the decomposer agent
+     *
+     * DETERMINISTIC: Same input always produces same output structure
+     * STATELESS: No internal state modified
+     * NON-BLOCKING: Fully async
+     */
+    async invoke(input, executionRef) {
+        const startTime = Date.now();
+        try {
+            // Emit telemetry start
+            this.telemetry.recordStart(AGENT_ID, executionRef, input);
+            // Decompose the objective (pure analysis, no side effects)
+            const output = this.decompose(input);
+            // Validate output
+            const validatedOutput = contracts_1.DecomposerOutputSchema.parse(output);
+            // Calculate confidence based on decomposition quality
+            const confidence = this.calculateConfidence(validatedOutput);
+            // Constraints applied during decomposition
+            const constraintsApplied = this.getAppliedConstraints(input);
+            // Create the DecisionEvent
+            const event = (0, contracts_1.createDecisionEvent)(AGENT_ID, AGENT_VERSION, DECISION_TYPE, input, validatedOutput, confidence, constraintsApplied, executionRef);
+            // Persist via ruvector-service (best-effort, non-blocking)
+            let persistence_status;
+            try {
+                await this.persistence.store(event);
+                persistence_status = { status: 'persisted' };
+            }
+            catch (persistError) {
+                const persistMessage = persistError instanceof Error ? persistError.message : 'Unknown persistence error';
+                console.error(`[${AGENT_ID}] RuVector persistence failed (non-blocking): ${persistMessage}`);
+                persistence_status = { status: 'skipped', error: persistMessage };
+            }
+            // Emit telemetry success
+            this.telemetry.recordSuccess(AGENT_ID, executionRef, Date.now() - startTime);
+            return {
+                status: 'success',
+                event,
+                persistence_status,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const errorCode = this.classifyError(error);
+            // Emit telemetry failure
+            this.telemetry.recordFailure(AGENT_ID, executionRef, errorCode, errorMessage);
+            return (0, contracts_1.createErrorResult)(errorCode, errorMessage, executionRef);
+        }
+    }
+    /**
+     * Decompose objective into sub-objectives
+     *
+     * This is the core decomposition logic - purely analytical.
+     * NEVER executes, assigns agents, or schedules anything.
+     */
+    decompose(input) {
+        const decompositionId = (0, uuid_1.v4)();
+        const maxDepth = input.context?.max_depth ?? 3;
+        const maxSubObjectives = input.config?.max_sub_objectives ?? 20;
+        const subObjectives = this.extractSubObjectives(input, maxDepth, maxSubObjectives);
+        const treeStructure = this.buildTreeStructure(subObjectives);
+        const dependencyGraph = this.buildDependencyGraph(subObjectives);
+        const atomicCount = subObjectives.filter(s => s.is_atomic).length;
+        const complexityDist = this.calculateComplexityDistribution(subObjectives);
+        const coverageScore = this.assessCoverage(subObjectives, input);
+        const maxDepthReached = Math.max(0, ...subObjectives.map(s => s.depth));
+        return {
+            decomposition_id: decompositionId,
+            original_objective: this.summarize(input.objective),
+            sub_objectives: subObjectives,
+            tree_structure: treeStructure,
+            dependency_graph: dependencyGraph,
+            analysis: {
+                total_sub_objectives: subObjectives.length,
+                max_depth_reached: maxDepthReached,
+                atomic_count: atomicCount,
+                coverage_score: coverageScore,
+                complexity_distribution: complexityDist,
+                assumptions: this.extractAssumptions(input),
+            },
+            version: '1.0.0',
+        };
+    }
+    /**
+     * Extract sub-objectives from the objective using pattern-based analysis
+     */
+    extractSubObjectives(input, maxDepth, maxCount) {
+        const objective = input.objective.toLowerCase();
+        const subs = [];
+        let counter = 0;
+        const addSub = (title, description, parentId, depth, tags, complexity, isAtomic, deps = [], criteria = []) => {
+            if (subs.length >= maxCount || depth > maxDepth)
+                return '';
+            const id = `sub-${++counter}`;
+            subs.push({
+                sub_objective_id: id,
+                title,
+                description,
+                parent_id: parentId,
+                depth,
+                dependencies: deps,
+                tags,
+                complexity,
+                is_atomic: isAtomic,
+                acceptance_criteria: criteria,
+            });
+            return id;
+        };
+        // Top-level: understand requirements
+        const understandId = addSub('Understand Requirements', 'Analyze and capture all requirements from the objective', null, 0, ['requirements', 'analysis'], 'simple', true, [], ['All requirements identified', 'Ambiguities documented']);
+        // Top-level: design approach
+        const designId = addSub('Design Approach', 'Design the solution approach and architecture', null, 0, ['design', 'architecture'], 'moderate', false, understandId ? [{ depends_on: understandId, type: 'data' }] : [], ['Architecture decisions documented', 'Approach validated']);
+        // Conditional sub-objectives based on objective content
+        if (this.containsAny(objective, ['build', 'create', 'implement', 'develop'])) {
+            const implId = addSub('Implement Core Logic', 'Implement the core functionality described in the objective', null, 0, ['implementation', 'core'], 'complex', false, designId ? [{ depends_on: designId, type: 'blocking' }] : [], ['Core functionality working', 'Unit tests passing']);
+            if (implId && maxDepth >= 1) {
+                addSub('Set Up Project Structure', 'Create the project scaffolding and configuration', implId, 1, ['setup', 'scaffolding'], 'simple', true, [], ['Project structure created', 'Dependencies installed']);
+                addSub('Implement Business Logic', 'Build the primary business logic components', implId, 1, ['business-logic', 'core'], 'complex', true, [], ['Business rules implemented', 'Edge cases handled']);
+            }
+        }
+        if (this.containsAny(objective, ['api', 'service', 'endpoint', 'interface'])) {
+            addSub('Define Interface Contracts', 'Specify API contracts, schemas, and interface boundaries', designId, 1, ['interfaces', 'contracts', 'api'], 'moderate', true, [], ['API contracts defined', 'Schemas validated']);
+        }
+        if (this.containsAny(objective, ['test', 'validate', 'verify', 'quality'])) {
+            addSub('Establish Validation Strategy', 'Define the testing and validation approach', null, 0, ['testing', 'validation'], 'moderate', true, designId ? [{ depends_on: designId, type: 'data' }] : [], ['Test strategy defined', 'Coverage targets set']);
+        }
+        if (this.containsAny(objective, ['deploy', 'release', 'production', 'launch'])) {
+            addSub('Plan Deployment', 'Define the deployment and release strategy', null, 0, ['deployment', 'release'], 'moderate', true, designId ? [{ depends_on: designId, type: 'data' }] : [], ['Deployment pipeline defined', 'Rollback plan documented']);
+        }
+        if (this.containsAny(objective, ['integrate', 'connect', 'migrate'])) {
+            addSub('Plan Integration', 'Define integration points and data flow between systems', null, 0, ['integration', 'connectivity'], 'complex', false, designId ? [{ depends_on: designId, type: 'data' }] : [], ['Integration points mapped', 'Data flow documented']);
+        }
+        // Always add a completion/review sub-objective
+        const allTopLevel = subs.filter(s => s.parent_id === null).map(s => s.sub_objective_id);
+        addSub('Review and Validate Completeness', 'Ensure all sub-objectives adequately cover the original objective', null, 0, ['review', 'completeness'], 'simple', true, allTopLevel.map(id => ({ depends_on: id, type: 'data' })), ['All sub-objectives addressed', 'Coverage verified']);
+        return subs;
+    }
+    /**
+     * Build tree structure (parent -> children) from sub-objectives
+     */
+    buildTreeStructure(subs) {
+        const tree = { root: [] };
+        for (const sub of subs) {
+            if (sub.parent_id === null) {
+                tree.root.push(sub.sub_objective_id);
+            }
+            else {
+                if (!tree[sub.parent_id]) {
+                    tree[sub.parent_id] = [];
+                }
+                tree[sub.parent_id].push(sub.sub_objective_id);
+            }
+        }
+        return tree;
+    }
+    /**
+     * Build dependency graph as adjacency list
+     */
+    buildDependencyGraph(subs) {
+        const graph = {};
+        for (const sub of subs) {
+            graph[sub.sub_objective_id] = sub.dependencies.map(d => d.depends_on);
+        }
+        return graph;
+    }
+    /**
+     * Calculate complexity distribution
+     */
+    calculateComplexityDistribution(subs) {
+        const dist = {
+            trivial: 0, simple: 0, moderate: 0, complex: 0, very_complex: 0,
+        };
+        for (const sub of subs) {
+            dist[sub.complexity]++;
+        }
+        return dist;
+    }
+    /**
+     * Assess how well the sub-objectives cover the original objective
+     */
+    assessCoverage(subs, input) {
+        let score = 0.5; // Base coverage
+        // More sub-objectives generally means better coverage (up to a point)
+        if (subs.length >= 3 && subs.length <= 15)
+            score += 0.15;
+        if (subs.length > 15)
+            score += 0.1;
+        // Atomic sub-objectives are actionable
+        const atomicRatio = subs.filter(s => s.is_atomic).length / subs.length;
+        if (atomicRatio > 0.4)
+            score += 0.1;
+        // Sub-objectives with acceptance criteria
+        const criteriaRatio = subs.filter(s => s.acceptance_criteria.length > 0).length / subs.length;
+        score += criteriaRatio * 0.15;
+        // Multi-depth decomposition
+        const maxDepth = Math.max(0, ...subs.map(s => s.depth));
+        if (maxDepth >= 1)
+            score += 0.1;
+        return Math.min(1.0, Math.max(0.0, score));
+    }
+    /**
+     * Summarize objective for output
+     */
+    summarize(objective) {
+        const cleaned = objective.trim().replace(/\s+/g, ' ');
+        return cleaned.length > 200 ? cleaned.substring(0, 197) + '...' : cleaned;
+    }
+    /**
+     * Extract assumptions made during decomposition
+     */
+    extractAssumptions(input) {
+        const assumptions = [
+            'Objective has been validated for clarity',
+            'Decomposition is based on structural analysis of the objective text',
+        ];
+        if (!input.context?.constraints?.length) {
+            assumptions.push('No explicit constraints provided - using default decomposition strategy');
+        }
+        if (!input.context?.existing_components?.length) {
+            assumptions.push('No existing components specified - decomposing as new work');
+        }
+        if (!input.config?.target_granularity) {
+            assumptions.push('Using medium granularity as default');
+        }
+        return assumptions;
+    }
+    /**
+     * Calculate confidence score based on decomposition quality
+     */
+    calculateConfidence(output) {
+        let confidence = 0.65; // Base confidence
+        // Boost for well-structured decompositions
+        if (output.sub_objectives.length >= 3 && output.sub_objectives.length <= 20) {
+            confidence += 0.1;
+        }
+        // Boost for good coverage
+        if (output.analysis.coverage_score >= 0.7) {
+            confidence += 0.1;
+        }
+        // Boost for multi-depth decomposition
+        if (output.analysis.max_depth_reached >= 1) {
+            confidence += 0.05;
+        }
+        // Boost for atomic sub-objectives
+        if (output.analysis.atomic_count > 0) {
+            confidence += 0.05;
+        }
+        // Reduce for too many sub-objectives (potential over-decomposition)
+        if (output.sub_objectives.length > 25) {
+            confidence -= 0.1;
+        }
+        return Math.min(1.0, Math.max(0.0, confidence));
+    }
+    /**
+     * Get constraints applied during decomposition
+     */
+    getAppliedConstraints(input) {
+        const constraints = [
+            'read_only_analysis',
+            'no_execution',
+            'no_agent_assignment',
+            'no_resource_allocation',
+            'no_scheduling',
+            'deterministic_output',
+        ];
+        if (input.context?.constraints) {
+            constraints.push(...input.context.constraints.map(c => `user_constraint:${c}`));
+        }
+        return constraints;
+    }
+    /**
+     * Classify error for proper error code
+     */
+    classifyError(error) {
+        if (error instanceof Error) {
+            if (error.name === 'ZodError') {
+                return contracts_1.AgentErrorCodes.VALIDATION_FAILED;
+            }
+            if (error.message.includes('persistence') || error.message.includes('ruvector')) {
+                return contracts_1.AgentErrorCodes.PERSISTENCE_ERROR;
+            }
+        }
+        return contracts_1.AgentErrorCodes.PROCESSING_ERROR;
+    }
+    /**
+     * Helper: Check if text contains any of the keywords
+     */
+    containsAny(text, keywords) {
+        return keywords.some(kw => text.includes(kw));
+    }
+}
+exports.DecomposerAgent = DecomposerAgent;
+//# sourceMappingURL=decomposer-agent.js.map

package/dist/bundled-agents/copilot-agents/lib/services/agents/decomposer/decomposer-agent.js.map

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

package/dist/bundled-agents/copilot-agents/lib/services/agents/decomposer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decomposer Agent Module Exports
+ *
+ * Purpose: Decompose complex objectives into manageable sub-objectives
+ * Classification: DECOMPOSITION, STRUCTURAL_SYNTHESIS
+ * decision_type: objective_decomposition
+ */
+export { DecomposerAgent } from './decomposer-agent';
+export { SubObjectiveSchema, DecomposerInputSchema, DecomposerOutputSchema, type SubObjective, type DecomposerInput, type DecomposerOutput, } from '../contracts';

package/dist/bundled-agents/copilot-agents/lib/services/agents/decomposer/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Decomposer Agent Module Exports
+ *
+ * Purpose: Decompose complex objectives into manageable sub-objectives
+ * Classification: DECOMPOSITION, STRUCTURAL_SYNTHESIS
+ * decision_type: objective_decomposition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecomposerOutputSchema = exports.DecomposerInputSchema = exports.SubObjectiveSchema = exports.DecomposerAgent = void 0;
+var decomposer_agent_1 = require("./decomposer-agent");
+Object.defineProperty(exports, "DecomposerAgent", { enumerable: true, get: function () { return decomposer_agent_1.DecomposerAgent; } });
+// Re-export schemas from contracts
+var contracts_1 = require("../contracts");
+Object.defineProperty(exports, "SubObjectiveSchema", { enumerable: true, get: function () { return contracts_1.SubObjectiveSchema; } });
+Object.defineProperty(exports, "DecomposerInputSchema", { enumerable: true, get: function () { return contracts_1.DecomposerInputSchema; } });
+Object.defineProperty(exports, "DecomposerOutputSchema", { enumerable: true, get: function () { return contracts_1.DecomposerOutputSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/copilot-agents/lib/services/agents/decomposer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../services/agents/decomposer/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAExB,mCAAmC;AACnC,0CAOsB;AANpB,+GAAA,kBAAkB,OAAA;AAClB,kHAAA,qBAAqB,OAAA;AACrB,mHAAA,sBAAsB,OAAA"}

package/dist/bundled-agents/copilot-agents/lib/services/agents/intent-classifier/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Intent Classifier Agent Module Exports
+ */
+export { IntentClassifierAgent } from './intent-classifier-agent';

package/dist/bundled-agents/copilot-agents/lib/services/agents/intent-classifier/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Intent Classifier Agent Module Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentClassifierAgent = void 0;
+var intent_classifier_agent_1 = require("./intent-classifier-agent");
+Object.defineProperty(exports, "IntentClassifierAgent", { enumerable: true, get: function () { return intent_classifier_agent_1.IntentClassifierAgent; } });
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/copilot-agents/lib/services/agents/intent-classifier/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../services/agents/intent-classifier/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA"}

package/dist/bundled-agents/copilot-agents/lib/services/agents/intent-classifier/intent-classifier-agent.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Intent Classifier Agent
+ *
+ * Purpose: Classify user or system intent to guide downstream reasoning
+ * Classification: INTENT_ANALYSIS
+ * decision_type: intent_classification
+ *
+ * Scope:
+ * - Classify intent type
+ * - Detect multi-intent states
+ * - Assign confidence scores
+ *
+ * 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:
+ * - Trigger workflows
+ * - Route execution
+ * - Enforce policy
+ */
+import { BaseAgent, AgentMetadata, AgentResult } from '../contracts';
+import { IntentClassifierInput, IntentClassifierOutput } from '../contracts/intent-classifier-schemas';
+import { RuvectorPersistence } from '../planner/ruvector-persistence';
+import { Telemetry } from '../planner/telemetry';
+/**
+ * Intent Classifier Agent Implementation
+ *
+ * This agent analyzes text and classifies user/system intent.
+ * It is purely analytical - it NEVER executes, routes, or enforces anything.
+ */
+export declare class IntentClassifierAgent implements BaseAgent<IntentClassifierInput, IntentClassifierOutput> {
+    readonly metadata: AgentMetadata;
+    private readonly persistence;
+    private readonly telemetry;
+    constructor(persistence: RuvectorPersistence, telemetry: Telemetry);
+    /**
+     * Validate input against IntentClassifierInputSchema
+     */
+    validateInput(input: unknown): IntentClassifierInput;
+    /**
+     * Invoke the intent classifier agent
+     *
+     * DETERMINISTIC: Same input always produces same output structure
+     * STATELESS: No internal state modified
+     * NON-BLOCKING: Fully async
+     */
+    invoke(input: IntentClassifierInput, executionRef: string): Promise<AgentResult>;
+    /**
+     * Classify intent from input text
+     *
+     * This is the core classification logic - purely analytical.
+     * NEVER triggers workflows, routes execution, or enforces policy.
+     */
+    private classifyIntent;
+    /**
+     * Normalize text for analysis
+     */
+    private normalizeText;
+    /**
+     * Detect all potential intents from normalized text
+     */
+    private detectIntents;
+    /**
+     * Extract target from text based on intent
+     */
+    private extractTarget;
+    /**
+     * Extract action from text based on intent
+     */
+    private extractAction;
+    /**
+     * Extract scope from input context
+     */
+    private extractScope;
+    /**
+     * Apply hints to filter intents
+     */
+    private applyHints;
+    /**
+     * Create unknown intent fallback
+     */
+    private createUnknownIntent;
+    /**
+     * Analyze multi-intent state
+     */
+    private analyzeMultiIntentState;
+    /**
+     * Detect relationship between intents
+     */
+    private detectIntentRelationship;
+    /**
+     * Detect ambiguity in classification
+     */
+    private detectAmbiguity;
+    /**
+     * Detect language of input
+     */
+    private detectLanguage;
+    /**
+     * Generate analysis notes
+     */
+    private generateNotes;
+    /**
+     * Calculate overall confidence
+     */
+    private calculateOverallConfidence;
+    /**
+     * Get constraints applied during classification
+     */
+    private getAppliedConstraints;
+    /**
+     * Classify error for proper error code
+     */
+    private classifyError;
+}