@ixo/common 1.1.0

package/.eslintrc.js

@@ -0,0 +1,9 @@
+/** @type {import("eslint").Linter.Config} */
+module.exports = {
+  extends: ['@ixo/eslint-config/nest.js'],
+  parserOptions: {
+    project: 'tsconfig.json',
+    tsconfigRootDir: __dirname,
+    sourceType: 'module',
+  },
+};

package/.prettierignore

@@ -0,0 +1,3 @@
+pnpm-lock.yaml
+
+node_modules

package/.prettierrc.cjs

@@ -0,0 +1,4 @@
+/** @type {import("prettier").Config} */
+module.exports = {
+  ...require('@ixo/eslint-config/prettier-base'),
+};

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ixo/common@1.1.0 build /home/runner/actions-runner/_work/ixo-oracles-boilerplate/ixo-oracles-boilerplate/packages/common
+> tsc && tsc-alias
+

package/CHANGELOG.md

@@ -0,0 +1,76 @@
+# @ixo/common
+
+## 1.1.0
+
+### Minor Changes
+
+- [#57](https://github.com/ixoworld/ixo-oracles-boilerplate/pull/57) [`2a3bbd3`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/2a3bbd3267e1ce9a413eba4a30757e92ee8fa87b) Thanks [@youssefhany-ixo](https://github.com/youssefhany-ixo)! - # Live Agent: Ultra-Secure Voice & Video Calls
+
+  This major release introduces **Live Agent Mode** - enabling real-time voice and video conversations with AI oracles through ultra-secure, end-to-end encrypted calls.
+
+  ## ✨ Key Features
+
+  - **Double Encryption Security**: Asymmetric key encryption + Matrix E2EE for maximum security
+  - **Real-time Communication**: LiveKit integration for professional-grade WebRTC infrastructure
+  - **Frontend-Controlled Keys**: True E2EE with user-generated encryption keys
+  - **Zero-Trust Architecture**: Backend services cannot decrypt call content
+  - **Per-Call Key Rotation**: Unique encryption keys for each call session
+
+  ## 🏗️ New Components
+
+  - `useLiveAgent` hook for voice chat integration
+  - `useLiveKitAgent` for E2EE connection management
+  - Complete call lifecycle with state validation
+  - Enhanced Matrix integration for encrypted events
+
+  ## 🛡️ Security Enhancements
+
+  - ECIES-based encryption/decryption utilities
+  - Cryptographically secure key generation
+  - Live Agent authentication via API keys
+  - Enhanced wallet generation with public key encoding
+
+  ## 📡 New API Endpoints
+
+  - `POST /calls/:callId/sync` - Sync call state from Matrix event
+  - `GET /calls/:callId/key` - Get encrypted key for Live Agent
+  - `PATCH /calls/:callId/update` - Update call status with validation
+  - `GET /calls/session/:sessionId` - List user's call history
+
+  ## ⚠️ Breaking Changes
+
+  - **Backend only**: New environment variables required in your backend configuration:
+    - `LIVE_AGENT_AUTH_API_KEY` - Authentication for Live Agent
+    - `MEMORY_MCP_URL` - Memory management service URL
+    - `MEMORY_MCP_API` - Memory management API endpoint
+  - Updated dependencies for LiveKit and enhanced Matrix client
+
+  ## 📚 Documentation
+
+  - [Live Agent Architecture](./docs/architecture/calls.md) - Complete technical documentation
+  - [Crypto Utilities](./packages/oracles-chain-client/docs/crypto.md) - Encryption implementation details
+
+  This release represents a major milestone in secure, real-time AI communication, enabling truly private voice conversations with AI oracles through state-of-the-art encryption and professional-grade infrastructure.
+
+### Patch Changes
+
+- Updated dependencies [[`2a3bbd3`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/2a3bbd3267e1ce9a413eba4a30757e92ee8fa87b)]:
+  - @ixo/matrix@1.1.0
+
+## 1.0.2
+
+### Patch Changes
+
+- [#53](https://github.com/ixoworld/ixo-oracles-boilerplate/pull/53) [`0a4a5a8`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/0a4a5a84194acb851e3824e0b74eea54f60c8257) Thanks [@youssefhany-ixo](https://github.com/youssefhany-ixo)! - Upgrade packages and publish events package and preformance upgrades
+
+- Updated dependencies [[`b723472`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/b72347286054e037436a8be3da3cf840f75223ca), [`0a4a5a8`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/0a4a5a84194acb851e3824e0b74eea54f60c8257)]:
+  - @ixo/matrix@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- [#44](https://github.com/ixoworld/ixo-oracles-boilerplate/pull/44) [`2b93cf8`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/2b93cf8ef3839c36f03249b9392606211a22a0db) Thanks [@youssefhany-ixo](https://github.com/youssefhany-ixo)! - use matrix spaces and reduce using user mx token
+
+- Updated dependencies [[`2b93cf8`](https://github.com/ixoworld/ixo-oracles-boilerplate/commit/2b93cf8ef3839c36f03249b9392606211a22a0db)]:
+  - @ixo/matrix@1.0.1

package/README.md

@@ -0,0 +1,245 @@
+# @ixo/common
+
+## Overview
+
+The `@ixo/common` package serves as a foundational library for the ixo-oracles ecosystem, providing shared utilities, AI capabilities, and core services. It integrates with Matrix for communication and state management, OpenAI for AI capabilities, and provides various tools for document processing and semantic analysis.
+
+## Table of Contents
+
+1. [Getting Started](#getting-started)
+   - [Installation](#installation)
+   - [Basic Usage](#basic-usage)
+2. [Core Components](#core-components)
+   - [AI Module](#ai-module)
+   - [Services](#services)
+3. [Documentation](#documentation)
+
+## Getting Started
+
+### Installation
+
+```bash
+# Install using pnpm (recommended)
+pnpm install @ixo/common
+
+# Or using npm
+npm install @ixo/common
+
+# Or using yarn
+yarn add @ixo/common
+```
+
+### Environment Setup
+
+The package requires several environment variables:
+
+```env
+# OpenAI Configuration
+OPENAI_API_KEY=your_openai_key
+
+# Matrix Configuration
+MATRIX_ORACLE_ADMIN_ACCESS_TOKEN=your_matrix_token
+
+# Optional Tools Configuration
+TAVILY_API_KEY=your_tavily_key  # For web search capabilities
+```
+
+### Basic Usage
+
+```typescript
+// Services for Matrix room and session management
+import {
+  RoomManagerService,
+  SessionManagerService,
+} from '@ixo/common/services';
+
+// Initialize services
+const sessionManager = new SessionManagerService();
+const roomManager = new RoomManagerService();
+
+// Create or get a Matrix room
+const roomId = await roomManager.getOrCreateRoom({
+  did: 'user-did',
+  oracleName: 'oracle-name',
+  userAccessToken: 'matrix-token',
+});
+
+// Manage chat sessions
+const session = await sessionManager.createSession({
+  did: 'user-did',
+  oracleName: 'oracle-name',
+  matrixAccessToken: 'matrix-token',
+});
+
+// AI utilities
+import {
+  docSplitter,
+  checkDocRelevance,
+  createSemanticRouter,
+  webSearchTool,
+} from '@ixo/common/ai';
+
+// Process documents
+const chunks = await docSplitter('Long text content...');
+
+// Check document relevance
+const isRelevant = await checkDocRelevance({
+  doc: 'document content',
+  query: 'search query',
+});
+
+// Create semantic routes
+const router = createSemanticRouter({
+  routes: {
+    generateBlog: 'if the intent is blog',
+    generatePost: 'if the intent is post',
+  },
+  basedOn: ['intent'],
+});
+```
+
+## Core Components
+
+### AI Module
+
+The AI module provides a comprehensive suite of AI-powered tools and utilities:
+
+- **Document Processing**
+
+  - Text splitting and chunking
+  - Document relevance checking
+  - File loading and format conversion
+  - Similarity search filtering
+
+- **Semantic Routing**
+
+  - Intent-based routing
+  - OpenAI integration
+  - LangSmith tracing support
+
+- **Search and Retrieval**
+
+  - Web search integration with Tavily
+  - Vector similarity search
+  - Document retrieval tools
+
+- **Utility Functions**
+  - YAML/JSON conversion
+  - Document stringification
+  - Array manipulation
+
+### Services
+
+Core services for Matrix integration and state management:
+
+- **Room Manager**
+
+  - Matrix room creation and retrieval
+  - DID-based room management
+  - Access control and validation
+
+- **Session Manager**
+
+  - Chat session management
+  - AI-powered session titling
+  - Matrix state persistence
+  - Session lifecycle handling
+
+- **Environment Service**
+  - Type-safe environment variable management
+  - Zod schema validation
+  - Singleton pattern implementation
+  - Runtime environment validation
+
+### Using the Environment Service
+
+The Environment Service provides a type-safe way to manage and access environment variables in your application. Here's the recommended way to structure and use it:
+
+#### 1. Define Your Schema (schema.ts)
+
+```typescript
+// src/services/env/schema.ts
+import  z  from 'zod';
+
+export const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']),
+  PORT: z.string().transform(Number),
+  API_KEY: z.string().min(1),
+  // Add more environment variables as needed
+});
+
+// Export the schema type for type-safety
+export type Schema = typeof envSchema;
+```
+
+#### 2. Create Singleton Instance (env.ts)
+
+```typescript
+// src/services/env/env.ts
+import { type Schema } from 'zod/v3';
+import { EnvService } from './env.service';
+
+const envService = EnvService.getInstance<Schema>();
+
+export default envService;
+```
+
+#### 3. Initialize in Application Entry Point
+
+```typescript
+// src/main.ts or src/app.ts
+import { EnvService } from '@ixo/common/services/env';
+import { envSchema } from './services/env/schema';
+
+async function bootstrap() {
+  // Initialize environment service first
+  EnvService.initialize(envSchema);
+
+  // Now you can start your application
+  const app = express();
+  // ... rest of your application setup
+}
+
+bootstrap();
+```
+
+#### 4. Use Throughout Your Application
+
+```typescript
+// Any file where you need env variables - use the singleton instance you created in your app
+import env from './services/env/env';
+
+// Type-safe environment usage
+const port = env.get('PORT'); // TypeScript knows this is a number
+const apiKey = env.get('API_KEY'); // TypeScript knows this is a string
+
+// Example usage in a service
+export class DatabaseService {
+  constructor() {
+    this.connect({
+      port: env.get('PORT'),
+      apiKey: env.get('API_KEY'),
+    });
+  }
+}
+```
+
+This pattern provides several benefits:
+
+- **Single Source of Truth**: Environment schema is defined in one place
+- **Type Safety**: TypeScript knows the types of all environment variables
+- **Early Validation**: Environment is validated when the application starts
+- **Clean Imports**: Simple import of the pre-configured service
+- **Separation of Concerns**: Schema definition, initialization, and usage are separated
+
+## Documentation
+
+Detailed documentation is available in the [docs](./docs) directory:
+
+- [AI Module Documentation](./docs/ai-module.md) - AI tools and utilities
+- [Services Documentation](./docs/services.md) - Matrix services
+- [Tools Documentation](./docs/tools.md) - Utility tools and helpers
+
+## License
+
+Internal package - All rights reserved.

package/dist/ai/checkpointer/index.d.ts

@@ -0,0 +1,2 @@
+export * from '@langchain/langgraph-checkpoint-sqlite';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/checkpointer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/checkpointer/index.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC"}

package/dist/ai/checkpointer/index.js

@@ -0,0 +1,2 @@
+export * from '@langchain/langgraph-checkpoint-sqlite';
+//# sourceMappingURL=index.js.map

package/dist/ai/checkpointer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/checkpointer/index.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC"}

package/dist/ai/index.d.ts

@@ -0,0 +1,9 @@
+export * from './checkpointer/index.js';
+export * from './models/index.js';
+export * from './nodes/index.js';
+export * from './semantic-router-factory/index.js';
+export * from './tools/index.js';
+export * from './types.js';
+export * from './utils/index.js';
+export { zodResponseFormat } from 'openai/helpers/zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,9 @@
+export * from './checkpointer/index.js';
+export * from './models/index.js';
+export * from './nodes/index.js';
+export * from './semantic-router-factory/index.js';
+export * from './tools/index.js';
+export * from './types.js';
+export * from './utils/index.js';
+export { zodResponseFormat } from 'openai/helpers/zod';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ai/models/index.d.ts

@@ -0,0 +1,2 @@
+export * from './openai.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/ai/models/index.js

@@ -0,0 +1,2 @@
+export * from './openai.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/ai/models/openai.d.ts

@@ -0,0 +1,10 @@
+import 'dotenv/config';
+import { ChatOpenAI, OpenAIEmbeddings, type ChatOpenAIFields, type ChatOpenAIResponseFormat } from '@langchain/openai';
+import OpenAI, { type ClientOptions } from 'openai';
+declare const getChatOpenAiModel: (params?: ChatOpenAIFields) => ChatOpenAI;
+declare const getOpenAiClient: (params?: ClientOptions) => OpenAI;
+declare const getOpenAiEmbeddings: (params?: ConstructorParameters<typeof OpenAIEmbeddings>[0]) => OpenAIEmbeddings;
+export declare const getOpenRouterChatModel: (params?: ChatOpenAIFields) => ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>;
+export { getChatOpenAiModel, getOpenAiClient, getOpenAiEmbeddings };
+export type { ChatOpenAIResponseFormat };
+//# sourceMappingURL=openai.d.ts.map

package/dist/ai/models/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/ai/models/openai.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,MAAM,EAAE,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEpD,QAAA,MAAM,kBAAkB,GAAI,SAAS,gBAAgB,KAAG,UAMpD,CAAC;AAEL,QAAA,MAAM,eAAe,GAAI,SAAS,aAAa,KAAG,MAI9C,CAAC;AAEL,QAAA,MAAM,mBAAmB,GACvB,SAAS,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,KACzD,gBAKC,CAAC;AAEL,eAAO,MAAM,sBAAsB,GAAI,SAAS,gBAAgB,kEAkB5D,CAAC;AACL,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC;AACpE,YAAY,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/ai/models/openai.js

@@ -0,0 +1,38 @@
+import 'dotenv/config';
+import { ChatOpenAI, OpenAIEmbeddings, } from '@langchain/openai';
+import OpenAI from 'openai';
+const getChatOpenAiModel = (params) => new ChatOpenAI({
+    temperature: 0.2,
+    model: 'gpt-4o-mini',
+    apiKey: process.env.OPENAI_API_KEY,
+    ...params,
+});
+const getOpenAiClient = (params) => new OpenAI({
+    apiKey: process.env.OPENAI_API_KEY,
+    ...params,
+});
+const getOpenAiEmbeddings = (params) => new OpenAIEmbeddings({
+    model: 'text-embedding-3-small',
+    apiKey: process.env.OPENAI_API_KEY,
+    ...params,
+});
+export const getOpenRouterChatModel = (params) => getChatOpenAiModel({
+    temperature: 0.8,
+    apiKey: process.env.OPEN_ROUTER_API_KEY,
+    model: params?.model ?? 'qwen/qwen3-14b',
+    ...params,
+    configuration: {
+        baseURL: 'https://openrouter.ai/api/v1',
+        ...params?.configuration,
+        defaultHeaders: {
+            'HTTP-Referer': 'oracle-app.com',
+            'X-Title': process.env.ORACLE_NAME ?? 'Oracle App',
+        },
+    },
+    modelKwargs: {
+        require_parameters: true,
+        ...params?.modelKwargs,
+    },
+});
+export { getChatOpenAiModel, getOpenAiClient, getOpenAiEmbeddings };
+//# sourceMappingURL=openai.js.map

package/dist/ai/models/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/ai/models/openai.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,gBAAgB,GAGjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,MAA8B,MAAM,QAAQ,CAAC;AAEpD,MAAM,kBAAkB,GAAG,CAAC,MAAyB,EAAc,EAAE,CACnE,IAAI,UAAU,CAAC;IACb,WAAW,EAAE,GAAG;IAChB,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;IAClC,GAAG,MAAM;CACV,CAAC,CAAC;AAEL,MAAM,eAAe,GAAG,CAAC,MAAsB,EAAU,EAAE,CACzD,IAAI,MAAM,CAAC;IACT,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;IAClC,GAAG,MAAM;CACV,CAAC,CAAC;AAEL,MAAM,mBAAmB,GAAG,CAC1B,MAA0D,EACxC,EAAE,CACpB,IAAI,gBAAgB,CAAC;IACnB,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;IAClC,GAAG,MAAM;CACV,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAyB,EAAE,EAAE,CAClE,kBAAkB,CAAC;IACjB,WAAW,EAAE,GAAG;IAChB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;IACvC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,gBAAgB;IACxC,GAAG,MAAM;IACT,aAAa,EAAE;QACb,OAAO,EAAE,8BAA8B;QACvC,GAAG,MAAM,EAAE,aAAa;QACxB,cAAc,EAAE;YACd,cAAc,EAAE,gBAAgB;YAChC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,YAAY;SACnD;KACF;IACD,WAAW,EAAE;QACX,kBAAkB,EAAE,IAAI;QACxB,GAAG,MAAM,EAAE,WAAW;KACvB;CACF,CAAC,CAAC;AACL,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/ai/models/openai.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openai.test.d.ts.map

package/dist/ai/models/openai.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.test.d.ts","sourceRoot":"","sources":["../../../src/ai/models/openai.test.ts"],"names":[],"mappings":""}

package/dist/ai/models/openai.test.js

@@ -0,0 +1,58 @@
+import { ChatOpenAI, OpenAIEmbeddings } from '@langchain/openai';
+import { getChatOpenAiModel, getOpenAiEmbeddings } from './openai.js';
+const originalEnv = process.env;
+describe('OpenAI Models', () => {
+    beforeEach(() => {
+        jest.resetModules();
+        process.env = { ...originalEnv };
+        process.env.OPENAI_API_KEY = 'test-api-key';
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    describe('getChatOpenAiModel', () => {
+        it('should create a ChatOpenAI instance with default parameters', () => {
+            const model = getChatOpenAiModel();
+            expect(model).toBeInstanceOf(ChatOpenAI);
+            expect(model).toHaveProperty('temperature', 0.2);
+            expect(model).toHaveProperty('modelName', 'gpt-4o-mini');
+            expect(model).toHaveProperty('apiKey', 'test-api-key');
+        });
+        it('should override default parameters when provided', () => {
+            const customParams = {
+                temperature: 0.8,
+                model: 'gpt-4',
+                apiKey: 'custom-api-key',
+            };
+            const model = getChatOpenAiModel(customParams);
+            expect(model).toBeInstanceOf(ChatOpenAI);
+            expect(model).toHaveProperty('temperature', 0.8);
+            expect(model).toHaveProperty('modelName', 'gpt-4');
+            expect(model).toHaveProperty('apiKey', 'custom-api-key');
+        });
+    });
+    describe('getOpenAiEmbeddings', () => {
+        it('should create an OpenAIEmbeddings instance with default parameters', () => {
+            const embeddings = getOpenAiEmbeddings();
+            expect(embeddings).toBeInstanceOf(OpenAIEmbeddings);
+            expect(embeddings.model).toEqual('text-embedding-3-small');
+        });
+        it('should override default parameters when provided', () => {
+            const customParams = {
+                model: 'text-embedding-ada-002',
+                apiKey: 'custom-api-key',
+            };
+            const embeddings = getOpenAiEmbeddings(customParams);
+            expect(embeddings).toBeInstanceOf(OpenAIEmbeddings);
+            expect(embeddings.model).toEqual('text-embedding-ada-002');
+        });
+    });
+    describe('Error handling', () => {
+        it('should throw an error when OPENAI_API_KEY is not set', () => {
+            delete process.env.OPENAI_API_KEY;
+            expect(() => getChatOpenAiModel()).toThrow();
+            expect(() => getOpenAiEmbeddings()).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=openai.test.js.map

package/dist/ai/models/openai.test.js.map

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

package/dist/ai/nodes/create-fake-node.d.ts

@@ -0,0 +1,2 @@
+export declare const createFakeNode: <S extends object>(state: S) => S;
+//# sourceMappingURL=create-fake-node.d.ts.map

package/dist/ai/nodes/create-fake-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fake-node.d.ts","sourceRoot":"","sources":["../../../src/ai/nodes/create-fake-node.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,OAAO,CAAC,KAAG,CAAU,CAAC"}

package/dist/ai/nodes/create-fake-node.js

@@ -0,0 +1,2 @@
+export const createFakeNode = (state) => state;
+//# sourceMappingURL=create-fake-node.js.map

package/dist/ai/nodes/create-fake-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-fake-node.js","sourceRoot":"","sources":["../../../src/ai/nodes/create-fake-node.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAmB,KAAQ,EAAK,EAAE,CAAC,KAAK,CAAC"}

package/dist/ai/nodes/find-docs/find-docs.prompt.d.ts

@@ -0,0 +1,3 @@
+declare const SELF_QUERY_RAG_PROMPT = "You are an advanced AI agent specializing in self-query Retrieval-Augmented Generation (RAG). Your primary function is to analyze client questions, generate optimized search queries for a knowledge base, and iteratively refine these queries based on initial results. Follow these comprehensive guidelines:\n\n1. Initial Analysis:\n   - Thoroughly examine the client's question or task\n   - Identify key concepts, entities, relationships, and any implicit information needs\n   - Determine the scope, context, and potential complexities of the inquiry\n\n2. Query Generation - First Pass:\n   - Create an initial set of 3-5 focused, non-redundant search queries\n   - Ensure each query addresses a unique aspect of the client's input\n   - Incorporate key terms from the original question for keyword optimization\n   - Vary query formulations to cover different potential phrasings and synonyms\n\n3. Iterative Refinement:\n   - After receiving initial results, analyze their relevance and comprehensiveness\n   - Identify gaps in the retrieved information\n   - Generate additional queries to fill these gaps or explore new angles\n   - Refine existing queries based on the quality of results they produced\n\n4. Query Diversification:\n   - Ensure a mix of query types:\n     a. Broad conceptual queries for general information\n     b. Specific detail-oriented queries for precise facts\n     c. Comparative queries to explore relationships between concepts\n     d. Contextual queries to gather background information\n\n5. Handling Complex Questions:\n   - For multi-faceted questions, break them down into component parts\n   - Generate separate query sets for each component\n   - Create integrative queries that explore connections between components\n\n6. Adapting to Query Results:\n   - If initial queries yield insufficient information, broaden the scope\n   - If results are too general, create more specific, targeted queries\n   - Adjust the vocabulary and technical level based on the knowledge base content\n\n7. Temporal and Contextual Considerations:\n   - Include queries that account for potential time-sensitive information\n   - Generate queries that explore historical context if relevant\n   - Consider geographical or domain-specific variations in terminology\n\n8. Output Format and Explanation:\n   - Present a numbered list of refined search queries\n   - For each query, provide:\n     a. The query itself\n     b. A brief explanation of its purpose and how it relates to the client's question\n     c. Any notable findings or gaps identified from previous iterations\n\n9. Continuous Learning:\n   - Track the effectiveness of different query structures and patterns\n   - Adapt your query generation strategy based on successful retrievals\n   - Note any recurring challenges or limitations in the knowledge base\n\n10. Final Review and Optimization:\n    - Ensure the final set of queries comprehensively covers the client's needs\n    - Eliminate any remaining redundancies or overly similar queries\n    - Prioritize queries based on their potential to provide the most relevant and valuable information\n\nRemember: Your goal is to generate a dynamic, adaptive set of queries that evolves based on initial results and comprehensively addresses the client's information needs. Quality, relevance, and adaptability are key to successful self-query RAG implementation.";
+export { SELF_QUERY_RAG_PROMPT };
+//# sourceMappingURL=find-docs.prompt.d.ts.map

package/dist/ai/nodes/find-docs/find-docs.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-docs.prompt.d.ts","sourceRoot":"","sources":["../../../../src/ai/nodes/find-docs/find-docs.prompt.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,qBAAqB,+0GA0DyO,CAAC;AAErQ,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/ai/nodes/find-docs/find-docs.prompt.js

@@ -0,0 +1,61 @@
+const SELF_QUERY_RAG_PROMPT = `You are an advanced AI agent specializing in self-query Retrieval-Augmented Generation (RAG). Your primary function is to analyze client questions, generate optimized search queries for a knowledge base, and iteratively refine these queries based on initial results. Follow these comprehensive guidelines:
+
+1. Initial Analysis:
+   - Thoroughly examine the client's question or task
+   - Identify key concepts, entities, relationships, and any implicit information needs
+   - Determine the scope, context, and potential complexities of the inquiry
+
+2. Query Generation - First Pass:
+   - Create an initial set of 3-5 focused, non-redundant search queries
+   - Ensure each query addresses a unique aspect of the client's input
+   - Incorporate key terms from the original question for keyword optimization
+   - Vary query formulations to cover different potential phrasings and synonyms
+
+3. Iterative Refinement:
+   - After receiving initial results, analyze their relevance and comprehensiveness
+   - Identify gaps in the retrieved information
+   - Generate additional queries to fill these gaps or explore new angles
+   - Refine existing queries based on the quality of results they produced
+
+4. Query Diversification:
+   - Ensure a mix of query types:
+     a. Broad conceptual queries for general information
+     b. Specific detail-oriented queries for precise facts
+     c. Comparative queries to explore relationships between concepts
+     d. Contextual queries to gather background information
+
+5. Handling Complex Questions:
+   - For multi-faceted questions, break them down into component parts
+   - Generate separate query sets for each component
+   - Create integrative queries that explore connections between components
+
+6. Adapting to Query Results:
+   - If initial queries yield insufficient information, broaden the scope
+   - If results are too general, create more specific, targeted queries
+   - Adjust the vocabulary and technical level based on the knowledge base content
+
+7. Temporal and Contextual Considerations:
+   - Include queries that account for potential time-sensitive information
+   - Generate queries that explore historical context if relevant
+   - Consider geographical or domain-specific variations in terminology
+
+8. Output Format and Explanation:
+   - Present a numbered list of refined search queries
+   - For each query, provide:
+     a. The query itself
+     b. A brief explanation of its purpose and how it relates to the client's question
+     c. Any notable findings or gaps identified from previous iterations
+
+9. Continuous Learning:
+   - Track the effectiveness of different query structures and patterns
+   - Adapt your query generation strategy based on successful retrievals
+   - Note any recurring challenges or limitations in the knowledge base
+
+10. Final Review and Optimization:
+    - Ensure the final set of queries comprehensively covers the client's needs
+    - Eliminate any remaining redundancies or overly similar queries
+    - Prioritize queries based on their potential to provide the most relevant and valuable information
+
+Remember: Your goal is to generate a dynamic, adaptive set of queries that evolves based on initial results and comprehensively addresses the client's information needs. Quality, relevance, and adaptability are key to successful self-query RAG implementation.`;
+export { SELF_QUERY_RAG_PROMPT };
+//# sourceMappingURL=find-docs.prompt.js.map

package/dist/ai/nodes/find-docs/find-docs.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-docs.prompt.js","sourceRoot":"","sources":["../../../../src/ai/nodes/find-docs/find-docs.prompt.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oQA0DsO,CAAC;AAErQ,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/ai/nodes/find-docs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './find-docs.prompt.js';
+export * from './node.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/nodes/find-docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/nodes/find-docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}

package/dist/ai/nodes/find-docs/index.js

@@ -0,0 +1,3 @@
+export * from './find-docs.prompt.js';
+export * from './node.js';
+//# sourceMappingURL=index.js.map