@measureoneinc/savant 1.0.0

package/README-SDK.md

@@ -0,0 +1,148 @@
+# Savant Orchestration SDK
+
+This package provides the Savant SDK for integrating with the Savant Orchestration service.
+
+## Installation
+
+```bash
+npm install @measureoneinc/savant
+```
+
+## Usage
+
+### Import the SDK
+
+```typescript
+import { SavantSDK } from '@measureoneinc/savant';
+// or
+import { SavantSDK } from '@measureoneinc/savant/sdk';
+```
+
+### Import Types
+
+```typescript
+import type {
+  ChatMessage,
+  Conversation,
+  Knowledge,
+  AgentRequest,
+  PlanDB,
+  PlanStepDB,
+  // ... and all other types
+} from '@measureoneinc/savant';
+// or
+import type { ChatMessage, Conversation } from '@measureoneinc/savant/types';
+```
+
+### Basic Example
+
+```typescript
+import { SavantSDK, StreamingUtils } from 'savant-orchestration-service';
+import type { ChatMessage, Conversation } from 'savant-orchestration-service';
+import { Request, Response } from 'express';
+
+const sdk = new SavantSDK();
+
+// Submit a message to a conversation
+async function submitMessage(
+  req: Request,
+  res: Response,
+  conversation_id: string,
+  message: ChatMessage
+) {
+  const streaming_utils = new StreamingUtils(res, req);
+  
+  await sdk.submit_message(
+    {
+      agent_request_id: 'your-agent-request-id',
+      conversation_id,
+      message,
+    },
+    streaming_utils
+  );
+}
+
+// Upload a file
+async function uploadFile(file: Express.Multer.File) {
+  const result = await sdk.upload_file(
+    file,
+    'your-application-id',
+    'your-requester-id'
+  );
+  return result.file_id;
+}
+
+// Create knowledge from files
+async function createKnowledge(fileIds: string[]) {
+  const result = await sdk.create_knowledge_from_files({
+    application_id: 'your-application-id',
+    requester_id: 'your-requester-id',
+    source_data: fileIds.map(id => ({ id })),
+  });
+  return result;
+}
+```
+
+## Available Types
+
+All types are exported from the main package or from `@measureoneinc/savant/types`:
+
+- `ChatMessage` - Chat message structure
+- `Conversation` - Conversation data structure
+- `Knowledge` - Knowledge entry structure
+- `AgentRequest` - Agent request structure
+- `PlanDB`, `PlanStepDB` - Plan database types
+- `AgentResponse`, `PlannerResponse`, `ExecutorResponse` - Agent response types
+- And many more...
+
+See `src/lib/schemas/index.ts` for the complete list of exported types.
+
+## SDK Methods
+
+### `submit_message(params, streaming_utils)`
+
+Submits a message to a conversation and streams the response.
+
+**Parameters:**
+- `params`: Object containing:
+  - `agent_request_id`: string
+  - `conversation_id`: string
+  - `message`: ChatMessage
+  - `step_id?`: string (optional)
+- `streaming_utils`: StreamingUtils instance
+
+**Returns:** Promise<void>
+
+### `upload_file(file, application_id, requester_id)`
+
+Uploads a file and returns its ID.
+
+**Parameters:**
+- `file`: Express.Multer.File
+- `application_id`: string
+- `requester_id`: string
+
+**Returns:** Promise<{ file_id: string }>
+
+### `create_knowledge_from_files(params)`
+
+Creates a new knowledge entry from a set of file IDs.
+
+**Parameters:**
+- `params`: Object containing:
+  - `application_id`: string
+  - `requester_id`: string
+  - `source_data`: Array<{ id: string }>
+  - `metadata?`: any (optional)
+  - `delivery_details?`: any (optional)
+
+**Returns:** Promise<{ id: string; embeddings_created: number }>
+
+## TypeScript Support
+
+This package includes full TypeScript type definitions. All types are exported and can be imported as shown above.
+
+## License
+
+MIT
+

package/dist/ai/agents/domain-identifier.agent.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Domain Identifier Agent
+ *
+ * Agent for identifying domain from seed content using AI.
+ * Extends DynamicAgent for consistency with other AI interactions.
+ *
+ * @author MeasureOne
+ * @version 1.0.0
+ */
+import { GoogleGenAI } from "@google/genai";
+import { DynamicAgent } from "./dynamic-agent";
+/**
+ * Domain Identifier Agent - Identifies domain from seed content
+ *
+ * Responsibilities:
+ * - Analyze seed content and identify the most appropriate domain
+ * - Return domain name or null if cannot identify
+ * - Maintain consistency with other agent-based AI interactions
+ */
+export declare class DomainIdentifierAgent extends DynamicAgent {
+    constructor(gemini_client: GoogleGenAI, model?: string);
+    /**
+     * Identify domain from seed content
+     *
+     * @param content - The seed content to analyze
+     * @returns Promise resolving to identified domain string or null if identification fails
+     */
+    identify_domain(content: string): Promise<string | null>;
+    /**
+     * Extract structured response from agent execution result
+     */
+    private extract_structured_response;
+}
+//# sourceMappingURL=domain-identifier.agent.d.ts.map

package/dist/ai/agents/domain-identifier.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-identifier.agent.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/domain-identifier.agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAe/C;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBAE/C,aAAa,EAAE,WAAW,EAC1B,KAAK,GAAE,MAA2B;IAsBtC;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4G9D;;OAEG;IACH,OAAO,CAAC,2BAA2B;CAkCtC"}

package/dist/ai/agents/domain-identifier.agent.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * @fileoverview Domain Identifier Agent
+ *
+ * Agent for identifying domain from seed content using AI.
+ * Extends DynamicAgent for consistency with other AI interactions.
+ *
+ * @author MeasureOne
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainIdentifierAgent = void 0;
+const dynamic_agent_1 = require("./dynamic-agent");
+const domain_identifier_instructions_1 = require("../instructions/domain-identifier.instructions");
+const logger_1 = require("../../lib/utils/logger");
+const schemas_1 = require("../../lib/schemas");
+const response_parser_1 = require("./response-parser");
+const zod_to_json_schema_1 = require("../../lib/utils/zod-to-json-schema");
+const logger = (0, logger_1.create_default_logger)("domain-identifier-agent");
+/**
+ * Domain Identifier Agent - Identifies domain from seed content
+ *
+ * Responsibilities:
+ * - Analyze seed content and identify the most appropriate domain
+ * - Return domain name or null if cannot identify
+ * - Maintain consistency with other agent-based AI interactions
+ */
+class DomainIdentifierAgent extends dynamic_agent_1.DynamicAgent {
+    constructor(gemini_client, model = "gemini-2.5-flash") {
+        super(gemini_client, [], // No MCP servers needed
+        "DomainIdentifierAgent", domain_identifier_instructions_1.DOMAIN_IDENTIFIER_INSTRUCTIONS, [], // No tools needed
+        model, schemas_1.DomainIdentifierResponseSchema, // Pass the Zod schema for structured validation
+        undefined, // No conversation summary needed
+        undefined, // No context summary needed
+        [], // No recent messages needed
+        undefined // No current context needed
+        );
+        logger.info("DomainIdentifierAgent initialized", {
+            model,
+            has_schema: true
+        });
+    }
+    /**
+     * Identify domain from seed content
+     *
+     * @param content - The seed content to analyze
+     * @returns Promise resolving to identified domain string or null if identification fails
+     */
+    async identify_domain(content) {
+        try {
+            if (!content || content.trim().length === 0) {
+                logger.warn('Empty content provided for domain identification');
+                return null;
+            }
+            logger.debug('Identifying domain from content', {
+                content_length: content.length,
+                content_preview: content.substring(0, 200)
+            });
+            // Extract first 2000 characters for domain identification (title and initial content are most important)
+            const content_preview = content.length > 2000
+                ? content.substring(0, 2000) + '\n\n[... content truncated for domain identification ...]'
+                : content;
+            // Create a simple conversation with the content
+            const conversation = [
+                {
+                    role: 'user',
+                    content: `Analyze the following seed content and identify the domain type. Pay special attention to:
+1. The title and headers (they often contain explicit domain indicators)
+2. The primary operations described
+3. The tools and methods mentioned
+
+Content to analyze:
+${content_preview}`
+                }
+            ];
+            // Create chat instance for this one-off call (DomainIdentifierAgent doesn't use conversation service)
+            // Convert ConversationItem[] to Content[] format for chat instance
+            const ai_history = conversation.map((msg) => {
+                const role = msg.role === 'model' ? 'model' : 'user';
+                const content_text = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+                return { role: role, parts: [{ text: content_text }] };
+            });
+            // Create chat instance with the conversation
+            // Note: We need to set up the response schema in the chat config
+            const response_schema = this.response_schema
+                ? (0, zod_to_json_schema_1.convertZodToJsonSchema)(this.response_schema, "domain_identifier_response")
+                : undefined;
+            this.chat_instance = this.client.chats.create({
+                model: this.model,
+                history: ai_history,
+                config: {
+                    systemInstruction: this.system_prompt,
+                    ...(response_schema && {
+                        responseSchema: response_schema,
+                        responseMimeType: 'application/json'
+                    })
+                }
+            });
+            logger.debug('Created chat instance for domain identification', {
+                history_length: ai_history.length,
+                has_schema: !!response_schema
+            });
+            // Execute the agent using execute_single_attempt
+            const result = await this.execute_single_attempt(conversation, false);
+            logger.debug('Domain agent execution completed', {
+                has_result: !!result,
+                has_text: !!result?.text,
+                text_preview: result?.text?.substring(0, 200)
+            });
+            // Extract structured response from result
+            const response = this.extract_structured_response(result);
+            if (!response) {
+                logger.warn('No structured response from domain identifier agent', {
+                    result_text_preview: result?.text?.substring(0, 300)
+                });
+                return null;
+            }
+            const domain_response = response;
+            const domain = domain_response.domain;
+            if (!domain || domain === 'null' || domain.trim().length === 0) {
+                logger.info('Domain identifier returned null', { response: domain_response });
+                return null;
+            }
+            // Clean up domain name (remove punctuation, normalize)
+            const clean_domain = domain.trim().toLowerCase().replace(/[^\w-]/g, '');
+            if (!clean_domain || clean_domain.length === 0) {
+                logger.warn('Could not extract valid domain from response', { domain_response });
+                return null;
+            }
+            logger.info('Domain identified', { domain: clean_domain, original_response: domain });
+            return clean_domain;
+        }
+        catch (error) {
+            logger.error('Failed to identify domain from content via AI agent', {
+                error: error instanceof Error ? error.message : String(error),
+                error_stack: error instanceof Error ? error.stack : undefined
+            });
+            return null;
+        }
+    }
+    /**
+     * Extract structured response from agent execution result
+     */
+    extract_structured_response(result) {
+        try {
+            // DynamicAgent returns GenerateContentResponse with structured output in text property
+            if (!result?.text) {
+                logger.warn('No text in agent response', { result });
+                return null;
+            }
+            const text = result.text;
+            logger.debug('Extracting structured response from text', {
+                text_length: text.length,
+                text_preview: text.substring(0, 200)
+            });
+            // Use parse_agent_response utility which handles markdown code blocks and edge cases
+            const parsed = (0, response_parser_1.parse_agent_response)(text);
+            // Validate against schema
+            const validated = schemas_1.DomainIdentifierResponseSchema.parse(parsed);
+            logger.debug('Successfully extracted and validated domain response', {
+                domain: validated.domain,
+                agent_kind: validated.agent_kind
+            });
+            return validated;
+        }
+        catch (error) {
+            logger.error('Failed to extract structured response', {
+                error: error instanceof Error ? error.message : String(error),
+                result_preview: result?.text?.substring(0, 200)
+            });
+            return null;
+        }
+    }
+}
+exports.DomainIdentifierAgent = DomainIdentifierAgent;
+//# sourceMappingURL=domain-identifier.agent.js.map

package/dist/ai/agents/domain-identifier.agent.js.map

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

package/dist/ai/agents/dynamic-agent.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Dynamic Agent - Chat Completions Implementation
+ *
+ * This module provides a streamlined agent implementation using OpenAI chat completions
+ * instead of the agent framework for faster execution without handoffs.
+ *
+ * Key Features:
+ * - Direct OpenAI chat completions API usage
+ * - MCP server str
+ * - Streaming support
+ * - Retry mechanisms
+ * - Type-safe agent responses
+ *
+ * @author MeasureOne
+ * @version 2.0.0
+ */
+import { GoogleGenAI, GenerateContentResponse } from "@google/genai";
+import { AgentResponse } from "../../lib/schemas";
+import { z } from "zod";
+import { ChatMessage } from "../../lib/schemas";
+import { Logger } from "../../lib/utils/logger";
+import { StreamingUtils } from "../../lib/streaming-utils";
+import { CallGeminiOnceOptions, HistoryStrategy } from "../../lib/schemas/ai-responses.schema";
+export type CallGeminiOnceResult = GenerateContentResponse;
+/**
+ * Default execution options for agents.
+ *
+ * max_attempts: Number of times to retry if ENTIRE execution crashes (catastrophic failures)
+ * retry_delay_ms: Delay between retry attempts
+ * streaming: Enable real-time NDJSON streaming
+ *
+ * Note: max_iterations (inside execute_single_attempt) controls the OpenAI tool calling loop
+ */
+export declare const DEFAULT_AGENT_OPTIONS: {
+    max_attempts: number;
+    retry_delay_ms: number;
+    streaming: boolean;
+};
+/**
+ * Dynamic Agent class - streamlined implementation using Google Gemini Chat API.
+ * Provides common functionality and execution patterns without agent framework overhead.
+ */
+export declare class DynamicAgent {
+    protected client: GoogleGenAI;
+    protected mcp_servers: any[];
+    private debug_logged;
+    protected verbose_reasoning: boolean;
+    protected logger: Logger;
+    protected response_schema?: z.ZodType<AgentResponse>;
+    name: string;
+    instructions: string;
+    model: string;
+    protected system_prompt: string;
+    protected chat_instance: any;
+    /**
+     * Creates a new dynamic agent instance.
+     *
+     * @param client - Google Gemini client instance
+     * @param mcp_servers - Array of MCP server instances
+     * @param agent_name - Name of the agent for identification
+     * @param instructions - Agent instructions for behavior
+     * @param tools - Array of tools available to the agent
+     * @param model - Model to use (e.g., "gemini-2.5-flash", "gemini-2.5-flash")
+     * @param response_schema - Optional Zod schema for structured response validation
+     * @param conversation_summary - Optional LLM-generated summary of conversation messages
+     * @param context_summary - Optional LLM-generated summary of execution context
+     * @param recent_messages - Optional recent messages for immediate context (last 3 messages)
+     * @param current_context - Optional current context object (plan_id, current_step, tool_results, etc.)
+     */
+    constructor(client: GoogleGenAI, mcp_servers: any[] | undefined, agent_name: string, instructions: string, tools?: any[], model?: string, response_schema?: z.ZodType<AgentResponse>, conversation_summary?: string | null, context_summary?: string | null, recent_messages?: ChatMessage[], current_context?: any, history_strategy?: HistoryStrategy);
+    /**
+     * Executes the agent with a single attempt using Google Gemini Chat API.
+     *
+     * @param input - Input data for the agent (conversation history)
+     * @param streaming - Whether to use streaming output
+     * @param streaming_utils - Optional callback function for streaming chunks
+     * @returns Promise<GenerateContentResponse> - Gemini SDK response (contains AgentResponse in text property)
+     */
+    execute_single_attempt(input: ChatMessage[], streaming?: boolean, streaming_utils?: StreamingUtils): Promise<GenerateContentResponse>;
+    /**
+     * Executes the agent with retry mechanism for improved reliability.
+     * SIMPLIFIED: Just retries on exceptions, returns raw Gemini Response.
+     * All response handling is done by the service layer.
+     *
+     * @param input - Input data for the agent (conversation history)
+     * @param options - Execution options
+     * @param streaming_utils - Optional callback function for streaming chunks
+     * @returns Promise<GenerateContentResponse> - Raw AI Response (contains AgentResponse in output_text)
+     */
+    execute_with_retries(input: ChatMessage[], options: {}, streaming_utils?: StreamingUtils): Promise<GenerateContentResponse>;
+    /**
+     * Utility method to create a delay.
+     *
+     * @param ms - Delay duration in milliseconds
+     */
+    private delay;
+    /**
+     * Gets the MCP servers used by this agent.
+     *
+     * @returns Array of MCP servers
+     */
+    get_mcp_servers(): any[];
+    call_gemini_once(client: GoogleGenAI, options: CallGeminiOnceOptions): Promise<CallGeminiOnceResult>;
+}
+//# sourceMappingURL=dynamic-agent.d.ts.map

package/dist/ai/agents/dynamic-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-agent.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/dynamic-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAmD,uBAAuB,EAAkD,MAAM,eAAe,CAAC;AACtK,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAShD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAO3D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAO/F,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAI3D;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAIrG,CAAC;AAEF;;;GAGG;AACH,qBAAa,YAAY;IACxB,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC;IAC7B,OAAO,CAAC,YAAY,CAAU;IAC9B,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAGrC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAG9C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC;IAG7B;;;;;;;;;;;;;;OAcG;gBAEF,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,GAAG,EAAE,YAAK,EACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,GAAG,EAAO,EACjB,KAAK,GAAE,MAA2B,EAClC,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAC1C,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,EACpC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,eAAe,CAAC,EAAE,WAAW,EAAE,EAC/B,eAAe,CAAC,EAAE,GAAG,EACrB,gBAAgB,GAAE,eAA2B;IA0E9C;;;;;;;OAOG;IACU,sBAAsB,CAClC,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,GAAE,OAAc,EACzB,eAAe,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAmEnC;;;;;;;;;OASG;IACU,oBAAoB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,EAAE,EACX,eAAe,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAuDnC;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;OAIG;IACI,eAAe,IAAI,GAAG,EAAE;IAUzB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAgT1G"}