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

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

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * Intent Classifier Agent Schemas
+ *
+ * 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
+ *
+ * Must Never:
+ * - Trigger workflows
+ * - Route execution
+ * - Enforce policy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentClassifierOutputSchema = exports.IntentClassifierInputSchema = exports.MultiIntentStateSchema = exports.ClassifiedIntentSchema = exports.IntentSignalSchema = exports.IntentType = void 0;
+const zod_1 = require("zod");
+/**
+ * Intent Type enum - categories of user/system intent
+ */
+exports.IntentType = {
+    // Information seeking
+    QUERY: 'query', // User seeking information
+    SEARCH: 'search', // User searching for something
+    EXPLAIN: 'explain', // User wants explanation
+    // Action requests
+    CREATE: 'create', // User wants to create something
+    UPDATE: 'update', // User wants to modify something
+    DELETE: 'delete', // User wants to remove something
+    EXECUTE: 'execute', // User wants to run/execute something
+    // Navigation/Flow
+    NAVIGATE: 'navigate', // User wants to go somewhere
+    CANCEL: 'cancel', // User wants to abort operation
+    CONFIRM: 'confirm', // User confirming action
+    UNDO: 'undo', // User wants to reverse action
+    // Conversational
+    GREETING: 'greeting', // User greeting
+    FAREWELL: 'farewell', // User ending conversation
+    FEEDBACK: 'feedback', // User providing feedback
+    HELP: 'help', // User needs assistance
+    // System
+    CONFIGURE: 'configure', // User wants to change settings
+    AUTHENTICATE: 'authenticate', // User authentication intent
+    AUTHORIZE: 'authorize', // User authorization intent
+    // Complex
+    COMPOUND: 'compound', // Multiple intents detected
+    AMBIGUOUS: 'ambiguous', // Intent unclear
+    UNKNOWN: 'unknown', // Cannot determine intent
+};
+/**
+ * Intent Signal - evidence supporting an intent classification
+ */
+exports.IntentSignalSchema = zod_1.z.object({
+    /** Type of signal detected */
+    signal_type: zod_1.z.enum([
+        'keyword', // Direct keyword match
+        'phrase', // Phrase pattern match
+        'structure', // Sentence structure analysis
+        'context', // Contextual inference
+        'entity', // Named entity detection
+        'sentiment', // Sentiment analysis
+        'syntax', // Syntactic pattern
+    ]),
+    /** The matched text or pattern */
+    matched_text: zod_1.z.string(),
+    /** Position in input (character offset) */
+    position: zod_1.z.object({
+        start: zod_1.z.number().int().nonnegative(),
+        end: zod_1.z.number().int().nonnegative(),
+    }),
+    /** Contribution to confidence (0.0-1.0) */
+    weight: zod_1.z.number().min(0).max(1),
+    /** Additional signal metadata */
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+/**
+ * Single classified intent with confidence
+ */
+exports.ClassifiedIntentSchema = zod_1.z.object({
+    /** Intent type */
+    intent_type: zod_1.z.string(),
+    /** Confidence score for this intent (0.0-1.0) */
+    confidence: zod_1.z.number().min(0).max(1),
+    /** Signals supporting this classification */
+    signals: zod_1.z.array(exports.IntentSignalSchema),
+    /** Intent target/object if identified */
+    target: zod_1.z.object({
+        type: zod_1.z.string(),
+        value: zod_1.z.string(),
+        normalized: zod_1.z.string().optional(),
+    }).optional(),
+    /** Intent action if applicable */
+    action: zod_1.z.object({
+        verb: zod_1.z.string(),
+        normalized: zod_1.z.string(),
+        tense: zod_1.z.enum(['present', 'past', 'future', 'imperative']).optional(),
+    }).optional(),
+    /** Intent scope/context */
+    scope: zod_1.z.object({
+        domain: zod_1.z.string().optional(),
+        subject: zod_1.z.string().optional(),
+        qualifiers: zod_1.z.array(zod_1.z.string()).default([]),
+    }).optional(),
+});
+/**
+ * Multi-intent state when multiple intents are detected
+ */
+exports.MultiIntentStateSchema = zod_1.z.object({
+    /** Whether multiple intents were detected */
+    is_multi_intent: zod_1.z.boolean(),
+    /** Relationship between intents */
+    relationship: zod_1.z.enum([
+        'sequential', // Intents are meant to be executed in order
+        'conditional', // One intent depends on another
+        'alternative', // Either/or intents
+        'parallel', // Independent intents
+        'nested', // Intent contains sub-intents
+        'clarification', // Secondary intent clarifies primary
+        'none', // Single intent or no relationship
+    ]),
+    /** Order of intents if sequential */
+    sequence: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Condition between intents if conditional */
+    condition: zod_1.z.object({
+        if_intent: zod_1.z.string(),
+        then_intent: zod_1.z.string(),
+        condition_text: zod_1.z.string(),
+    }).optional(),
+});
+/**
+ * Intent Classifier Input Schema
+ */
+exports.IntentClassifierInputSchema = zod_1.z.object({
+    /** Text to classify (user message or system input) */
+    text: zod_1.z.string().min(1).max(50000),
+    /** Optional conversation context */
+    context: zod_1.z.object({
+        /** Previous messages for context */
+        previous_messages: zod_1.z.array(zod_1.z.object({
+            role: zod_1.z.enum(['user', 'system', 'assistant']),
+            text: zod_1.z.string(),
+        })).optional(),
+        /** Current domain/topic */
+        domain: zod_1.z.string().optional(),
+        /** Known entities in scope */
+        entities: zod_1.z.array(zod_1.z.object({
+            type: zod_1.z.string(),
+            value: zod_1.z.string(),
+        })).optional(),
+        /** Active session state */
+        session_state: zod_1.z.record(zod_1.z.unknown()).optional(),
+    }).optional(),
+    /** Classification hints */
+    hints: zod_1.z.object({
+        /** Expected intent types to prioritize */
+        expected_intents: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Intents to exclude from consideration */
+        excluded_intents: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Minimum confidence threshold */
+        min_confidence: zod_1.z.number().min(0).max(1).optional(),
+        /** Maximum number of intents to return */
+        max_intents: zod_1.z.number().int().positive().max(10).optional(),
+        /** Language hint */
+        language: zod_1.z.string().optional(),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+});
+/**
+ * Intent Classifier Output Schema
+ */
+exports.IntentClassifierOutputSchema = zod_1.z.object({
+    /** Classification ID */
+    classification_id: zod_1.z.string().uuid(),
+    /** Original text (echoed for verification) */
+    original_text: zod_1.z.string(),
+    /** Normalized/cleaned text used for analysis */
+    normalized_text: zod_1.z.string(),
+    /** Primary classified intent */
+    primary_intent: exports.ClassifiedIntentSchema,
+    /** Secondary intents (if multi-intent detected) */
+    secondary_intents: zod_1.z.array(exports.ClassifiedIntentSchema).default([]),
+    /** Multi-intent state analysis */
+    multi_intent_state: exports.MultiIntentStateSchema,
+    /** Overall classification confidence (0.0-1.0) */
+    overall_confidence: zod_1.z.number().min(0).max(1),
+    /** Analysis metadata */
+    analysis: zod_1.z.object({
+        /** Number of intents detected */
+        intent_count: zod_1.z.number().int().nonnegative(),
+        /** Total signals identified */
+        signal_count: zod_1.z.number().int().nonnegative(),
+        /** Processing notes */
+        notes: zod_1.z.array(zod_1.z.string()).default([]),
+        /** Ambiguity indicators */
+        ambiguity: zod_1.z.object({
+            is_ambiguous: zod_1.z.boolean(),
+            ambiguity_type: zod_1.z.enum(['lexical', 'structural', 'contextual', 'none']),
+            clarification_needed: zod_1.z.boolean(),
+            suggested_clarification: zod_1.z.string().optional(),
+        }),
+        /** Language detection */
+        language: zod_1.z.object({
+            detected: zod_1.z.string(),
+            confidence: zod_1.z.number().min(0).max(1),
+        }).optional(),
+    }),
+    /** Version for tracking iterations */
+    version: zod_1.z.string().default('1.0.0'),
+});
+//# sourceMappingURL=intent-classifier-schemas.js.map

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

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