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

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/objective-clarifier-schemas.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Objective Clarifier Agent Schemas
+ *
+ * Purpose: Clarify ambiguous or incomplete objectives
+ * Classification: INTENT_ANALYSIS, DECOMPOSITION
+ * decision_type: objective_clarification
+ *
+ * Scope:
+ * - Resolve ambiguity
+ * - Normalize goals
+ * - Identify missing constraints
+ *
+ * Must Never:
+ * - Generate plans
+ * - Define solutions
+ * - Execute logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectiveClarifierOutputSchema = exports.ObjectiveClarifierInputSchema = exports.NormalizedGoalSchema = exports.MissingConstraintSchema = exports.AmbiguitySchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Ambiguity detection result
+ */
+exports.AmbiguitySchema = zod_1.z.object({
+    /** Unique identifier for this ambiguity */
+    id: zod_1.z.string().min(1),
+    /** Type of ambiguity detected */
+    type: zod_1.z.enum([
+        'lexical', // Word meaning unclear
+        'syntactic', // Sentence structure unclear
+        'semantic', // Meaning/intent unclear
+        'referential', // Reference unclear (what does "it" refer to)
+        'scope', // Extent/boundaries unclear
+        'temporal', // Timing/sequencing unclear
+        'quantitative', // Amount/scale unclear
+        'conditional', // Conditions/constraints unclear
+    ]),
+    /** The ambiguous portion of the objective */
+    source_text: zod_1.z.string(),
+    /** Description of why this is ambiguous */
+    description: zod_1.z.string(),
+    /** Possible interpretations of the ambiguous element */
+    interpretations: zod_1.z.array(zod_1.z.object({
+        interpretation: zod_1.z.string(),
+        likelihood: zod_1.z.number().min(0).max(1),
+        assumptions: zod_1.z.array(zod_1.z.string()).default([]),
+    })).min(1),
+    /** Severity of the ambiguity (how much it blocks understanding) */
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    /** Suggested clarification question */
+    clarification_prompt: zod_1.z.string(),
+});
+/**
+ * Missing constraint identification
+ */
+exports.MissingConstraintSchema = zod_1.z.object({
+    /** Unique identifier */
+    id: zod_1.z.string().min(1),
+    /** Category of the missing constraint */
+    category: zod_1.z.enum([
+        'temporal', // Timeline, deadlines, duration
+        'resource', // Budget, tools, people, systems
+        'quality', // Standards, acceptance criteria
+        'scope', // Boundaries, inclusions/exclusions
+        'dependency', // Prerequisites, blockers
+        'compliance', // Regulations, policies
+        'technical', // Technology choices, compatibility
+        'performance', // Speed, scalability, limits
+    ]),
+    /** What constraint information is missing */
+    description: zod_1.z.string(),
+    /** Why this constraint matters */
+    impact: zod_1.z.string(),
+    /** Severity if left unspecified */
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    /** Suggested question to elicit this constraint */
+    clarification_prompt: zod_1.z.string(),
+    /** Default assumption if not clarified */
+    default_assumption: zod_1.z.string().optional(),
+});
+/**
+ * Normalized goal representation
+ */
+exports.NormalizedGoalSchema = zod_1.z.object({
+    /** Unique identifier for the goal */
+    goal_id: zod_1.z.string().min(1),
+    /** Normalized statement of the goal */
+    statement: zod_1.z.string().min(1),
+    /** Goal type classification */
+    type: zod_1.z.enum([
+        'functional', // What the system should do
+        'non_functional', // How well it should do it
+        'constraint', // Limitations or boundaries
+        'assumption', // Implicit requirements
+    ]),
+    /** Extracted action verb (normalized) */
+    action: zod_1.z.string(),
+    /** Subject/target of the action */
+    subject: zod_1.z.string(),
+    /** Optional object/output of the action */
+    object: zod_1.z.string().optional(),
+    /** Qualifiers and conditions */
+    qualifiers: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Confidence in this normalization */
+    confidence: zod_1.z.number().min(0).max(1),
+    /** Original text this was derived from */
+    source_text: zod_1.z.string(),
+});
+/**
+ * Objective Clarifier Agent Input Schema
+ */
+exports.ObjectiveClarifierInputSchema = zod_1.z.object({
+    /** The raw objective to clarify */
+    objective: zod_1.z.string().min(1).max(50000),
+    /** Optional context to aid clarification */
+    context: zod_1.z.object({
+        /** Domain/industry context */
+        domain: zod_1.z.string().optional(),
+        /** Known stakeholders */
+        stakeholders: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Existing system/project information */
+        existing_context: zod_1.z.string().optional(),
+        /** Previously established constraints */
+        known_constraints: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Priority hints */
+        priorities: zod_1.z.array(zod_1.z.string()).optional(),
+    }).optional(),
+    /** Configuration for clarification */
+    config: zod_1.z.object({
+        /** Minimum ambiguity severity to report */
+        min_severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']).optional(),
+        /** Maximum number of clarification questions to generate */
+        max_questions: zod_1.z.number().int().positive().max(20).optional(),
+        /** Whether to attempt automatic resolution of low-severity ambiguities */
+        auto_resolve_low_severity: zod_1.z.boolean().optional(),
+        /** Preferred interpretation style */
+        interpretation_style: zod_1.z.enum(['conservative', 'balanced', 'liberal']).optional(),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+});
+/**
+ * Objective Clarifier Agent Output Schema
+ */
+exports.ObjectiveClarifierOutputSchema = zod_1.z.object({
+    /** Unique clarification session identifier */
+    clarification_id: zod_1.z.string().uuid(),
+    /** Original objective (echoed for verification) */
+    original_objective: zod_1.z.string(),
+    /** Clarification status */
+    status: zod_1.z.enum([
+        'clear', // Objective is clear, no issues found
+        'needs_clarification', // Ambiguities or missing constraints found
+        'requires_decomposition', // Too complex, needs breaking down
+        'insufficient', // Not enough information to analyze
+    ]),
+    /** List of detected ambiguities */
+    ambiguities: zod_1.z.array(exports.AmbiguitySchema).default([]),
+    /** List of missing constraints */
+    missing_constraints: zod_1.z.array(exports.MissingConstraintSchema).default([]),
+    /** Normalized goals extracted from the objective */
+    normalized_goals: zod_1.z.array(exports.NormalizedGoalSchema).default([]),
+    /** Clarified/normalized version of the objective */
+    clarified_objective: zod_1.z.object({
+        /** The clarified objective statement */
+        statement: zod_1.z.string(),
+        /** Assumptions made during clarification */
+        assumptions: zod_1.z.array(zod_1.z.string()).default([]),
+        /** Unresolved items that need human input */
+        unresolved: zod_1.z.array(zod_1.z.string()).default([]),
+        /** Confidence in the clarification */
+        confidence: zod_1.z.number().min(0).max(1),
+    }),
+    /** Prioritized clarification questions */
+    clarification_questions: zod_1.z.array(zod_1.z.object({
+        question: zod_1.z.string(),
+        priority: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+        related_ambiguity_id: zod_1.z.string().optional(),
+        related_constraint_id: zod_1.z.string().optional(),
+    })).default([]),
+    /** Analysis metadata */
+    analysis: zod_1.z.object({
+        /** Total ambiguities detected */
+        total_ambiguities: zod_1.z.number().int().nonnegative(),
+        /** Total missing constraints */
+        total_missing_constraints: zod_1.z.number().int().nonnegative(),
+        /** Total goals extracted */
+        total_goals: zod_1.z.number().int().nonnegative(),
+        /** Overall clarity score (0-1) */
+        clarity_score: zod_1.z.number().min(0).max(1),
+        /** Completeness score (0-1) */
+        completeness_score: zod_1.z.number().min(0).max(1),
+        /** Word count of original objective */
+        word_count: zod_1.z.number().int().nonnegative(),
+        /** Complexity assessment */
+        complexity: zod_1.z.enum(['simple', 'moderate', 'complex', 'very_complex']),
+    }),
+    /** Clarification version */
+    version: zod_1.z.string().default('1.0.0'),
+});
+//# sourceMappingURL=objective-clarifier-schemas.js.map

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/objective-clarifier-schemas.js.map

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