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

package/dist/bundled-agents/copilot-agents/functions/dist/services/agents/contracts/reflection-schemas.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Reflection Agent Schemas
+ *
+ * Purpose: Analyze DecisionEvents to extract learning and quality signals
+ * Classification: POST_EXECUTION_ANALYSIS, QUALITY_ASSESSMENT
+ * decision_type: reflection_analysis
+ *
+ * Scope:
+ * - Evaluate outcomes
+ * - Identify gaps and inefficiencies
+ * - Produce improvement insights
+ *
+ * Must Never:
+ * - Modify behavior
+ * - Trigger retries
+ * - Apply optimizations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReflectionOutputSchema = exports.ReflectionInputSchema = exports.OutcomeEvaluationSchema = exports.GapAnalysisSchema = exports.LearningSignalSchema = exports.QualitySignalSchema = void 0;
+const zod_1 = require("zod");
+const pipeline_schemas_1 = require("./pipeline-schemas");
+const decision_event_1 = require("./decision-event");
+/**
+ * Quality Signal - extracted quality indicators
+ */
+exports.QualitySignalSchema = zod_1.z.object({
+    /** Unique identifier for this signal */
+    signal_id: zod_1.z.string().min(1),
+    /** Type of quality signal */
+    type: zod_1.z.enum([
+        'performance', // Execution performance signal
+        'accuracy', // Accuracy/correctness signal
+        'completeness', // Completeness of output signal
+        'consistency', // Consistency with prior decisions
+        'efficiency', // Resource efficiency signal
+        'reliability', // Reliability/stability signal
+    ]),
+    /** Signal value (0.0 - 1.0 normalized score) */
+    value: zod_1.z.number().min(0).max(1),
+    /** Human-readable description of the signal */
+    description: zod_1.z.string().min(1),
+    /** Evidence supporting this signal */
+    evidence: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Severity level for negative signals */
+    severity: zod_1.z.enum(['info', 'warning', 'error', 'critical']).optional(),
+});
+/**
+ * Learning Signal - extracted learning opportunities
+ */
+exports.LearningSignalSchema = zod_1.z.object({
+    /** Unique identifier for this learning */
+    learning_id: zod_1.z.string().min(1),
+    /** Category of learning */
+    category: zod_1.z.enum([
+        'pattern', // Identified pattern to replicate
+        'anti_pattern', // Pattern to avoid
+        'optimization', // Optimization opportunity
+        'edge_case', // Edge case discovered
+        'dependency', // Dependency relationship learned
+        'constraint', // Constraint discovered
+    ]),
+    /** Brief title for the learning */
+    title: zod_1.z.string().min(1).max(200),
+    /** Detailed description of the learning */
+    description: zod_1.z.string().min(1),
+    /** Confidence in this learning (0.0 - 1.0) */
+    confidence: zod_1.z.number().min(0).max(1),
+    /** Affected agents or components */
+    affected_agents: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Recommendations for applying this learning (informational only) */
+    recommendations: zod_1.z.array(zod_1.z.string()).default([]),
+});
+/**
+ * Gap Analysis - identified gaps or inefficiencies
+ */
+exports.GapAnalysisSchema = zod_1.z.object({
+    /** Unique identifier for this gap */
+    gap_id: zod_1.z.string().min(1),
+    /** Type of gap */
+    type: zod_1.z.enum([
+        'coverage', // Missing coverage
+        'capability', // Missing capability
+        'data', // Data quality or availability gap
+        'process', // Process gap
+        'integration', // Integration gap
+        'documentation', // Documentation gap
+    ]),
+    /** Brief title for the gap */
+    title: zod_1.z.string().min(1).max(200),
+    /** Detailed description of the gap */
+    description: zod_1.z.string().min(1),
+    /** Impact assessment */
+    impact: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    /** Steps involved where gap was identified */
+    affected_steps: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Evidence supporting gap identification */
+    evidence: zod_1.z.array(zod_1.z.string()).default([]),
+});
+/**
+ * Outcome Evaluation - assessment of decision outcomes
+ */
+exports.OutcomeEvaluationSchema = zod_1.z.object({
+    /** Original decision event being evaluated */
+    decision_ref: zod_1.z.string().uuid(),
+    /** Agent that produced the decision */
+    agent_id: zod_1.z.string().min(1),
+    /** Decision type being evaluated */
+    decision_type: zod_1.z.string().min(1),
+    /** Overall outcome score (0.0 - 1.0) */
+    outcome_score: zod_1.z.number().min(0).max(1),
+    /** Assessment summary */
+    summary: zod_1.z.string().min(1),
+    /** Breakdown of outcome by dimension */
+    dimensions: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        score: zod_1.z.number().min(0).max(1),
+        notes: zod_1.z.string().optional(),
+    })).default([]),
+    /** Was the outcome as expected? */
+    met_expectations: zod_1.z.boolean(),
+    /** Deviation from expected outcome if any */
+    deviation_notes: zod_1.z.string().optional(),
+});
+/**
+ * Reflection Agent Input Schema
+ */
+exports.ReflectionInputSchema = zod_1.z.object({
+    /** DecisionEvents to analyze (1-100 events) */
+    decision_events: zod_1.z.array(decision_event_1.DecisionEventSchema).min(1).max(100),
+    /** Optional context about the analysis scope */
+    context: zod_1.z.object({
+        /** Focus areas for analysis */
+        focus_areas: zod_1.z.array(zod_1.z.enum([
+            'quality',
+            'learning',
+            'gaps',
+            'outcomes',
+            'all',
+        ])).default(['all']),
+        /** Time range context */
+        time_range: zod_1.z.object({
+            from: zod_1.z.string().datetime().optional(),
+            to: zod_1.z.string().datetime().optional(),
+        }).optional(),
+        /** Specific agents to focus on */
+        target_agents: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Prior reflections to build upon */
+        prior_reflection_refs: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+        /** Domain-specific context */
+        domain_context: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    }).optional(),
+    /** Analysis preferences */
+    preferences: zod_1.z.object({
+        /** Minimum confidence threshold for signals (0.0 - 1.0) */
+        min_confidence: zod_1.z.number().min(0).max(1).default(0.5),
+        /** Maximum number of signals to return per category */
+        max_signals_per_category: zod_1.z.number().int().positive().max(50).default(10),
+        /** Include detailed evidence */
+        include_evidence: zod_1.z.boolean().default(true),
+        /** Generate cross-event correlations */
+        correlate_events: zod_1.z.boolean().default(true),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+    /** Optional pipeline context for multi-agent orchestration */
+    pipeline_context: pipeline_schemas_1.PipelineContextSchema.optional(),
+});
+/**
+ * Reflection Agent Output Schema
+ */
+exports.ReflectionOutputSchema = zod_1.z.object({
+    /** Unique reflection identifier */
+    reflection_id: zod_1.z.string().uuid(),
+    /** Number of events analyzed */
+    events_analyzed: zod_1.z.number().int().nonnegative(),
+    /** Agents covered in analysis */
+    agents_analyzed: zod_1.z.array(zod_1.z.string()),
+    /** Time range of analyzed events */
+    analysis_time_range: zod_1.z.object({
+        earliest: zod_1.z.string().datetime(),
+        latest: zod_1.z.string().datetime(),
+    }),
+    /** Outcome evaluations for each analyzed event */
+    outcome_evaluations: zod_1.z.array(exports.OutcomeEvaluationSchema),
+    /** Extracted quality signals */
+    quality_signals: zod_1.z.array(exports.QualitySignalSchema),
+    /** Extracted learning signals */
+    learning_signals: zod_1.z.array(exports.LearningSignalSchema),
+    /** Identified gaps */
+    gap_analysis: zod_1.z.array(exports.GapAnalysisSchema),
+    /** Cross-event correlations found */
+    correlations: zod_1.z.array(zod_1.z.object({
+        /** Correlation identifier */
+        correlation_id: zod_1.z.string(),
+        /** Type of correlation */
+        type: zod_1.z.enum(['causal', 'temporal', 'similarity', 'dependency']),
+        /** Events involved */
+        event_refs: zod_1.z.array(zod_1.z.string().uuid()),
+        /** Description of the correlation */
+        description: zod_1.z.string(),
+        /** Correlation strength (0.0 - 1.0) */
+        strength: zod_1.z.number().min(0).max(1),
+    })).default([]),
+    /** Summary statistics */
+    summary: zod_1.z.object({
+        /** Overall quality score across all events (0.0 - 1.0) */
+        overall_quality_score: zod_1.z.number().min(0).max(1),
+        /** Total quality signals extracted */
+        total_quality_signals: zod_1.z.number().int().nonnegative(),
+        /** Total learning signals extracted */
+        total_learning_signals: zod_1.z.number().int().nonnegative(),
+        /** Total gaps identified */
+        total_gaps: zod_1.z.number().int().nonnegative(),
+        /** Events meeting expectations percentage */
+        expectations_met_rate: zod_1.z.number().min(0).max(1),
+        /** Key findings (informational summaries) */
+        key_findings: zod_1.z.array(zod_1.z.string()),
+        /** Improvement suggestions (informational only - NOT actionable by this agent) */
+        improvement_suggestions: zod_1.z.array(zod_1.z.string()),
+    }),
+    /** Reflection metadata */
+    version: zod_1.z.string().default('1.0.0'),
+});
+//# sourceMappingURL=reflection-schemas.js.map

package/dist/bundled-agents/copilot-agents/functions/dist/services/agents/contracts/reflection-schemas.js.map

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

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

@@ -0,0 +1,120 @@
+/**
+ * Decomposer Agent
+ *
+ * Purpose: Decompose complex objectives into manageable sub-objectives
+ *          and produce structured pipeline execution plans.
+ * Classification: DECOMPOSITION, STRUCTURAL_SYNTHESIS
+ * decision_type: objective_decomposition
+ *
+ * Scope:
+ * - Break complex objectives into sub-objectives
+ * - Identify sub-objective relationships
+ * - Assess decomposition completeness
+ * - Produce a pipeline spec (DAG) routing to agents across the 27-domain registry
+ *
+ * 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
+ */
+import { BaseAgent, AgentMetadata, AgentResult, DecomposerInput, DecomposerOutput } from '../contracts';
+import { RuvectorPersistence } from '../planner/ruvector-persistence';
+import { Telemetry } from '../planner/telemetry';
+/**
+ * Decomposer Agent Implementation
+ *
+ * This agent analyzes complex objectives and produces:
+ * 1. Structured sub-objectives (legacy output, always produced)
+ * 2. A pipeline_spec — a DAG of steps routed across the 27-domain registry
+ *
+ * It is purely analytical - it NEVER executes, assigns, or schedules anything.
+ */
+export declare class DecomposerAgent implements BaseAgent<DecomposerInput, DecomposerOutput> {
+    readonly metadata: AgentMetadata;
+    private readonly persistence;
+    private readonly telemetry;
+    constructor(persistence: RuvectorPersistence, telemetry: Telemetry);
+    /**
+     * Validate input against DecomposerInputSchema
+     */
+    validateInput(input: unknown): DecomposerInput;
+    /**
+     * Invoke the decomposer agent
+     *
+     * DETERMINISTIC: Same input always produces same output structure
+     * STATELESS: No internal state modified
+     * NON-BLOCKING: Fully async
+     */
+    invoke(input: DecomposerInput, executionRef: string): Promise<AgentResult>;
+    /**
+     * Build a structured pipeline spec (DAG) from the objective.
+     *
+     * Analyses the query text to select domains and agents from the
+     * 27-domain registry. Produces an ordered list of steps where
+     * `input_from` expresses data-flow dependencies.
+     */
+    private buildPipelineSpec;
+    /**
+     * Decompose objective into sub-objectives
+     *
+     * This is the core decomposition logic - purely analytical.
+     * NEVER executes, assigns agents, or schedules anything.
+     */
+    private decompose;
+    /**
+     * Extract sub-objectives from the objective using pattern-based analysis
+     */
+    private extractSubObjectives;
+    /**
+     * Build tree structure (parent -> children) from sub-objectives
+     */
+    private buildTreeStructure;
+    /**
+     * Build dependency graph as adjacency list
+     */
+    private buildDependencyGraph;
+    /**
+     * Calculate complexity distribution
+     */
+    private calculateComplexityDistribution;
+    /**
+     * Assess how well the sub-objectives cover the original objective
+     */
+    private assessCoverage;
+    /**
+     * Summarize objective for output
+     */
+    private summarize;
+    /**
+     * Extract assumptions made during decomposition
+     */
+    private extractAssumptions;
+    /**
+     * Calculate confidence score based on decomposition quality
+     */
+    private calculateConfidence;
+    /**
+     * Get constraints applied during decomposition
+     */
+    private getAppliedConstraints;
+    /**
+     * Classify error for proper error code
+     */
+    private classifyError;
+    /**
+     * Helper: Check if text contains any of the keywords
+     */
+    private containsAny;
+}