@measureoneinc/savant 1.0.0

package/dist/lib/schemas/ai-responses.schema.d.ts

@@ -0,0 +1,617 @@
+/**
+ * @fileoverview AI Responses Schema
+ *
+ * Unified Zod validation schemas for AI agent protocols, responses, and stream events.
+ * Merged from agent-protocol.schema.ts, agent-response.schemas.ts, and agent-stream-event.schema.ts.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+import { StreamingUtils } from '../streaming-utils';
+export declare const AgentTypeSchema: z.ZodEnum<{
+    ORCHESTRATOR: "ORCHESTRATOR";
+    PLANNER: "PLANNER";
+    KNOWLEDGE: "KNOWLEDGE";
+    EXECUTOR: "EXECUTOR";
+}>;
+export declare const IntentTypeSchema: z.ZodEnum<{
+    GREETING_OR_SMALLTALK: "GREETING_OR_SMALLTALK";
+    CLARIFICATION_NEEDED: "CLARIFICATION_NEEDED";
+    TASK_REQUEST: "TASK_REQUEST";
+    KNOWLEDGE_QUESTION: "KNOWLEDGE_QUESTION";
+}>;
+export declare const ResponseTypeSchema: z.ZodEnum<{
+    DIRECT_RESPONSE: "DIRECT_RESPONSE";
+    PLAN_READY: "PLAN_READY";
+    EXECUTE_PLAN: "EXECUTE_PLAN";
+    EXECUTION_REPORT: "EXECUTION_REPORT";
+    STEP_COMPLETE: "STEP_COMPLETE";
+    STEP_READY: "STEP_READY";
+    TOOL_CALL_READY: "TOOL_CALL_READY";
+    KNOWLEDGE_ANSWER: "KNOWLEDGE_ANSWER";
+    HANDOFF_REQUEST: "HANDOFF_REQUEST";
+    REQUEST_INPUT: "REQUEST_INPUT";
+    REQUEST_PLAN: "REQUEST_PLAN";
+    NO_DOMAIN: "NO_DOMAIN";
+    ERROR: "ERROR";
+}>;
+export declare const PlanStepStatusSchema: z.ZodEnum<{
+    PENDING: "PENDING";
+    IN_PROGRESS: "IN_PROGRESS";
+    COMPLETED: "COMPLETED";
+    FAILED: "FAILED";
+    SKIPPED: "SKIPPED";
+}>;
+export declare const EvidenceOffsetSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DomainContextSchema: z.ZodObject<{
+    domain_card: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    page_type: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    known_selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fallback_strategies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ErrorResponseSchema: z.ZodObject<{
+    message_type: z.ZodEnum<{
+        ERROR: "ERROR";
+    }>;
+    error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    blocked_step: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    remediation: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const PlanStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    tool: z.ZodNullable<z.ZodString>;
+    operation: z.ZodString;
+    params: z.ZodString;
+    depends_on: z.ZodArray<z.ZodString>;
+    success_check: z.ZodString;
+    suggestions_on_failure: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    domain_context: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        domain_card: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        page_type: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        known_selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fallback_strategies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const DomainInfoSchema: z.ZodObject<{
+    domain_card: z.ZodString;
+    confidence: z.ZodNumber;
+    citations: z.ZodArray<z.ZodString>;
+    snapshots_analyzed: z.ZodDefault<z.ZodNumber>;
+    catalog_cards_reviewed: z.ZodDefault<z.ZodNumber>;
+    research_summary: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const PlannerResponseSchema: z.ZodObject<{
+    agent_kind: z.ZodLiteral<"planner">;
+    message_type: z.ZodEnum<{
+        PLAN_READY: "PLAN_READY";
+        NO_DOMAIN: "NO_DOMAIN";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    message: z.ZodString;
+    plan: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        tool: z.ZodNullable<z.ZodString>;
+        operation: z.ZodString;
+        params: z.ZodString;
+        depends_on: z.ZodArray<z.ZodString>;
+        success_check: z.ZodString;
+        suggestions_on_failure: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        domain_context: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            domain_card: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            page_type: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            known_selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            fallback_strategies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
+    domain_info: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        domain_card: z.ZodString;
+        confidence: z.ZodNumber;
+        citations: z.ZodArray<z.ZodString>;
+        snapshots_analyzed: z.ZodDefault<z.ZodNumber>;
+        catalog_cards_reviewed: z.ZodDefault<z.ZodNumber>;
+        research_summary: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    context: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>;
+export declare const ToolCallSpecSchema: z.ZodObject<{
+    step_id: z.ZodString;
+    step_index: z.ZodNumber;
+    tool_name: z.ZodString;
+    tool_params: z.ZodString;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export declare const StepResultSchema: z.ZodObject<{
+    step_id: z.ZodString;
+    step_index: z.ZodNumber;
+    total_steps: z.ZodNumber;
+    success: z.ZodBoolean;
+    result: z.ZodString;
+    next_step_ready: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ExecutionSummarySchema: z.ZodObject<{
+    completed_steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        ok: z.ZodBoolean;
+        result: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    failed_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+    summary: z.ZodString;
+    outputs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ExecutorResponseSchema: z.ZodObject<{
+    agent_kind: z.ZodLiteral<"executor">;
+    message_type: z.ZodEnum<{
+        EXECUTION_REPORT: "EXECUTION_REPORT";
+        STEP_COMPLETE: "STEP_COMPLETE";
+        TOOL_CALL_READY: "TOOL_CALL_READY";
+        REQUEST_INPUT: "REQUEST_INPUT";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    message: z.ZodString;
+    content: z.ZodObject<{
+        message: z.ZodString;
+        tool_call: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            step_id: z.ZodString;
+            step_index: z.ZodNumber;
+            tool_name: z.ZodString;
+            tool_params: z.ZodString;
+            reasoning: z.ZodString;
+        }, z.core.$strip>>>;
+        step_result: z.ZodDefault<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+            step_id: z.ZodString;
+            step_index: z.ZodNumber;
+            total_steps: z.ZodNumber;
+            success: z.ZodBoolean;
+            result: z.ZodString;
+            next_step_ready: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            step_id: z.ZodString;
+            step_index: z.ZodNumber;
+            total_steps: z.ZodNumber;
+            success: z.ZodBoolean;
+            result: z.ZodString;
+            next_step_ready: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>]>>>;
+        context: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+        execution: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            completed_steps: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                ok: z.ZodBoolean;
+                result: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            failed_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                error: z.ZodString;
+            }, z.core.$strip>>>;
+            summary: z.ZodString;
+            outputs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        blocked_step: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        remediation: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        requested_inputs: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                secret: "secret";
+            }>;
+            required: z.ZodBoolean;
+        }, z.core.$strip>>>>;
+        learned_patterns: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+        }, z.core.$catchall<z.ZodAny>>>>>;
+        learnings: z.ZodDefault<z.ZodNullable<z.ZodAny>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const DomainIdentifierResponseSchema: z.ZodObject<{
+    agent_kind: z.ZodLiteral<"domain-identifier">;
+    domain: z.ZodNullable<z.ZodString>;
+    role: z.ZodLiteral<"assistant">;
+}, z.core.$strip>;
+export type DomainIdentifierResponse = z.infer<typeof DomainIdentifierResponseSchema>;
+export declare const OrchestratorResponseSchema: z.ZodObject<{
+    agent_kind: z.ZodLiteral<"orchestrator">;
+    message_type: z.ZodEnum<{
+        CLARIFICATION_NEEDED: "CLARIFICATION_NEEDED";
+        DIRECT_RESPONSE: "DIRECT_RESPONSE";
+        KNOWLEDGE_ANSWER: "KNOWLEDGE_ANSWER";
+        REQUEST_PLAN: "REQUEST_PLAN";
+        NO_DOMAIN: "NO_DOMAIN";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    role: z.ZodLiteral<"assistant">;
+    domain: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    content: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        requested_inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                secret: "secret";
+            }>;
+            required: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const KnowledgeResponseSchema: z.ZodObject<{
+    agent_kind: z.ZodLiteral<"knowledge">;
+    message_type: z.ZodEnum<{
+        KNOWLEDGE_ANSWER: "KNOWLEDGE_ANSWER";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    role: z.ZodEnum<{
+        tool: "tool";
+        assistant: "assistant";
+        user: "user";
+        mcp_approval_request: "mcp_approval_request";
+    }>;
+    message: z.ZodString;
+    content: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        answer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        evidence_log: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            note: z.ZodString;
+            citations: z.ZodArray<z.ZodString>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const DirectResponseSchema: z.ZodObject<{
+    message_type: z.ZodEnum<{
+        DIRECT_RESPONSE: "DIRECT_RESPONSE";
+    }>;
+    role: z.ZodLiteral<"assistant">;
+    content: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const AgentResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    agent_kind: z.ZodLiteral<"planner">;
+    message_type: z.ZodEnum<{
+        PLAN_READY: "PLAN_READY";
+        NO_DOMAIN: "NO_DOMAIN";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    message: z.ZodString;
+    plan: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        tool: z.ZodNullable<z.ZodString>;
+        operation: z.ZodString;
+        params: z.ZodString;
+        depends_on: z.ZodArray<z.ZodString>;
+        success_check: z.ZodString;
+        suggestions_on_failure: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        domain_context: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            domain_card: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            page_type: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            known_selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            fallback_strategies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
+    domain_info: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        domain_card: z.ZodString;
+        confidence: z.ZodNumber;
+        citations: z.ZodArray<z.ZodString>;
+        snapshots_analyzed: z.ZodDefault<z.ZodNumber>;
+        catalog_cards_reviewed: z.ZodDefault<z.ZodNumber>;
+        research_summary: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    context: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>, z.ZodObject<{
+    agent_kind: z.ZodLiteral<"executor">;
+    message_type: z.ZodEnum<{
+        EXECUTION_REPORT: "EXECUTION_REPORT";
+        STEP_COMPLETE: "STEP_COMPLETE";
+        TOOL_CALL_READY: "TOOL_CALL_READY";
+        REQUEST_INPUT: "REQUEST_INPUT";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    message: z.ZodString;
+    content: z.ZodObject<{
+        message: z.ZodString;
+        tool_call: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            step_id: z.ZodString;
+            step_index: z.ZodNumber;
+            tool_name: z.ZodString;
+            tool_params: z.ZodString;
+            reasoning: z.ZodString;
+        }, z.core.$strip>>>;
+        step_result: z.ZodDefault<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+            step_id: z.ZodString;
+            step_index: z.ZodNumber;
+            total_steps: z.ZodNumber;
+            success: z.ZodBoolean;
+            result: z.ZodString;
+            next_step_ready: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+            step_id: z.ZodString;
+            step_index: z.ZodNumber;
+            total_steps: z.ZodNumber;
+            success: z.ZodBoolean;
+            result: z.ZodString;
+            next_step_ready: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>]>>>;
+        context: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+        execution: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            completed_steps: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                ok: z.ZodBoolean;
+                result: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            failed_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                error: z.ZodString;
+            }, z.core.$strip>>>;
+            summary: z.ZodString;
+            outputs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        blocked_step: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        remediation: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        requested_inputs: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                secret: "secret";
+            }>;
+            required: z.ZodBoolean;
+        }, z.core.$strip>>>>;
+        learned_patterns: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+        }, z.core.$catchall<z.ZodAny>>>>>;
+        learnings: z.ZodDefault<z.ZodNullable<z.ZodAny>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    agent_kind: z.ZodLiteral<"orchestrator">;
+    message_type: z.ZodEnum<{
+        CLARIFICATION_NEEDED: "CLARIFICATION_NEEDED";
+        DIRECT_RESPONSE: "DIRECT_RESPONSE";
+        KNOWLEDGE_ANSWER: "KNOWLEDGE_ANSWER";
+        REQUEST_PLAN: "REQUEST_PLAN";
+        NO_DOMAIN: "NO_DOMAIN";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    role: z.ZodLiteral<"assistant">;
+    domain: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    content: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        requested_inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                secret: "secret";
+            }>;
+            required: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    agent_kind: z.ZodLiteral<"knowledge">;
+    message_type: z.ZodEnum<{
+        KNOWLEDGE_ANSWER: "KNOWLEDGE_ANSWER";
+        ERROR: "ERROR";
+    }>;
+    intent: z.ZodString;
+    role: z.ZodEnum<{
+        tool: "tool";
+        assistant: "assistant";
+        user: "user";
+        mcp_approval_request: "mcp_approval_request";
+    }>;
+    message: z.ZodString;
+    content: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+        answer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        evidence_log: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            note: z.ZodString;
+            citations: z.ZodArray<z.ZodString>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    message_type: z.ZodEnum<{
+        ERROR: "ERROR";
+    }>;
+    error_code: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    blocked_step: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    suggestions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    remediation: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    message_type: z.ZodEnum<{
+        DIRECT_RESPONSE: "DIRECT_RESPONSE";
+    }>;
+    role: z.ZodLiteral<"assistant">;
+    content: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>]>;
+export declare const AgentStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"content">;
+    data: z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    data: z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    data: z.ZodObject<{
+        server: z.ZodString;
+        tool: z.ZodString;
+        params: z.ZodAny;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    data: z.ZodObject<{
+        server: z.ZodString;
+        tool: z.ZodString;
+        result: z.ZodAny;
+        ok: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"handoff_start">;
+    data: z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"handoff_complete">;
+    data: z.ZodObject<{
+        to: z.ZodString;
+        ok: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"status">;
+    data: z.ZodAny;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    data: z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"final_response">;
+    data: z.ZodObject<{
+        role: z.ZodString;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"end">;
+    data: z.ZodObject<{
+        ok: z.ZodOptional<z.ZodBoolean>;
+        cancelled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+/**
+ * Defines the strategy for how an agent's conversation history is constructed.
+ */
+export declare const HistoryStrategySchema: z.ZodEnum<{
+    FULL: "FULL";
+    SUMMARY: "SUMMARY";
+    RECENT_ONLY: "RECENT_ONLY";
+}>;
+export type HistoryStrategy = z.infer<typeof HistoryStrategySchema>;
+/**
+ * Options for a single call to the Gemini API within the DynamicAgent.
+ */
+export declare const CallGeminiOnceOptionsSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    instructions: z.ZodString;
+    history: z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>;
+    }, z.core.$strip>>;
+    new_message: z.ZodObject<{
+        role: z.ZodString;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodAny>]>;
+    }, z.core.$strip>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    chat: z.ZodOptional<z.ZodAny>;
+    tool_choice: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+    }>>;
+    streaming: z.ZodOptional<z.ZodBoolean>;
+    streaming_utils: z.ZodOptional<z.ZodCustom<StreamingUtils, StreamingUtils>>;
+    response_schema: z.ZodOptional<z.ZodAny>;
+    mcp_servers: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+}, z.core.$strip>;
+export type CallGeminiOnceOptions = z.infer<typeof CallGeminiOnceOptionsSchema>;
+/**
+ * Generic content item structure, often used in agent responses.
+ */
+export declare const ContentItemSchema: z.ZodObject<{
+    type: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodAny>>;
+export type ContentItem = z.infer<typeof ContentItemSchema>;
+/**
+ * Internal schema for cached embeddings in EmbeddingService.
+ */
+export declare const CachedEmbeddingSchema: z.ZodObject<{
+    embedding: z.ZodArray<z.ZodNumber>;
+    embedding_norm: z.ZodNumber;
+    timestamp: z.ZodNumber;
+    original_text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CachedEmbedding = z.infer<typeof CachedEmbeddingSchema>;
+/**
+ * Internal schema for Faiss index data in EmbeddingService.
+ */
+export declare const FaissIndexDataSchema: z.ZodObject<{
+    index: z.ZodAny;
+    metadata: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        score: z.ZodOptional<z.ZodNumber>;
+        knowledge_id: z.ZodString;
+        knowledge_revision_id: z.ZodString;
+        source_data_id: z.ZodOptional<z.ZodString>;
+        chunk_index: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FaissIndexData = z.infer<typeof FaissIndexDataSchema>;
+//# sourceMappingURL=ai-responses.schema.d.ts.map

package/dist/lib/schemas/ai-responses.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-responses.schema.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/ai-responses.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpD,eAAO,MAAM,eAAe;;;;;EAK1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;EAc7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAC;AAMH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAMH,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAQ9B,CAAC;AAMH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;iBAUzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYhC,CAAC;AAMH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAgBjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCjC,CAAC;AAMH,eAAO,MAAM,8BAA8B;;;;iBAIzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAMtF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBrC,CAAC;AAMH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;iBAM/B,CAAC;AAMH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAO9B,CAAC;AAMH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA4DjC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;EAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;iBAYtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;8BAGV,CAAC;AACrB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}