beddel 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## [0.3.0] - 2025-12-22
+
+### Added
+- **New LLM Agent**: Direct LLM interaction without document context
+  - `llm.execute` method for simple chat with conversation history
+  - `llm` workflow step type for declarative workflows
+  - Full TypeScript types: `LlmHandlerParams`, `LlmHandlerResult`, `LlmMetadata`
+  - Zod schemas: `LlmInputSchema`, `LlmOutputSchema`
+
+### Changed
+- **Refactored Agent Architecture**: Fixed responsibility leak between chat and rag agents
+  - RAG agent now ALWAYS requires document context (removed `mode` parameter)
+  - Chat agent uses LLM agent for `mode='simple'` (previously used RAG with mode)
+  - Clear separation: LLM = direct chat, RAG = document-augmented generation
+- **Updated Documentation**: 
+  - Added GraphQL API Integration section with complete examples
+  - Updated agent architecture diagram
+  - Added LLM agent to built-in agents catalog
+  - Updated workflow step types table
+
+### Removed
+- `RagMode` type from RAG agent (was semantically incorrect)
+- `buildSimpleChatPrompt` function from RAG handler (moved to LLM agent)
+- `mode` parameter from RAG agent (RAG always requires documents)
+
+### Migration Guide
+If you were using `rag.execute` with `mode: 'simple'`:
+```typescript
+// Before (v0.2.x)
+await executeRagHandler({ query, history, mode: 'simple' }, props, context);
+
+// After (v0.3.0)
+await executeLlmHandler({ query, history }, props, context);
+```
+
+## [0.2.3] - 2025-12-20
+
+### Added
+- **Client-Safe Type Exports**: Exposed shared types for frontend consumption
+  - `AgentMetadata`, `AgentResponse`, `ExecutionStep` from shared agent types
+  - `WorkflowStepType`, `AgentCategory` for workflow typing
+  - `ChatHandlerParams`, `ChatHandlerResult`, `ChatMetadata` for chat agent
+  - `ConversationMessage` from RAG types
+  - `chatMetadata` constant for chat agent metadata
+
+### Purpose
+- Enable frontend applications to import types directly from `beddel` package
+- Support type-safe chat UI development without duplicating type definitions
+- All exported types are client-safe (no server-only dependencies)
+
 ## [0.2.2] - 2025-12-19
 
 ### Changed

package/README.md

@@ -132,10 +132,29 @@ your-app/
 │   └── translator-custom/
 │       └── translator-custom.yaml   # Override built-in
 │
-└── packages/beddel/src/agents/      # Built-in agents (package)
-    ├── joker-agent.yaml
-    ├── translator-agent.yaml
-    └── image-agent.yaml
+└── packages/beddel/src/agents/      # Built-in agents (sharded structure)
+    ├── joker/
+    │   ├── joker.yaml               # Agent definition
+    │   ├── joker.handler.ts         # Server-only handler
+    │   ├── joker.schema.ts          # Zod validation
+    │   ├── joker.types.ts           # TypeScript types
+    │   └── index.ts                 # Public exports
+    ├── translator/
+    │   └── ...
+    ├── image/
+    │   └── ...
+    ├── mcp-tool/
+    │   └── ...
+    ├── gemini-vectorize/
+    │   └── ...
+    ├── chromadb/
+    │   └── ...
+    ├── gitmcp/
+    │   └── ...
+    ├── rag/
+    │   └── ...
+    └── chat/
+        └── ...
 ```
 
 ### Agent Loading Flow
@@ -409,7 +428,7 @@ const result = await agentRegistry.executeAgent(
 | **Security** | `SecurityScanner`, `ThreatDetectionEngine` | Static scanning, scoring |
 | **Compliance** | `GDPRCompliance`, `LGPDCompliance` | Audit, anonymization |
 | **Performance** | `PerformanceMonitor`, `AutoScaler` | Metrics, scaling |
-| **Multi-tenancy** | `MultiTenantFirebaseManager` | Firebase tenant isolation |
+| **Multi-tenancy** | `TenantManager`, `ITenantProvider` | Provider-agnostic tenant isolation |
 
 ### Secure YAML Parsing
 
@@ -495,6 +514,65 @@ Supported types: `string`, `number`, `boolean`, `object`, `array`
 
 ---
 
+## Multi-Tenant Architecture
+
+Beddel provides a provider-agnostic multi-tenant system with a dynamic registry for external providers.
+
+### Built-in Providers
+
+| Provider | Type | Use Case |
+|----------|------|----------|
+| `InMemoryTenantProvider` | `memory` | Testing, development |
+
+### External Providers
+
+Provider implementations that handle credentials (Firebase, Supabase, etc.) should be implemented in the consuming application. Use `ProviderRegistry` to register custom providers:
+
+```typescript
+import { ProviderRegistry } from "beddel";
+import { FirebaseTenantProvider } from "./providers/FirebaseTenantProvider";
+
+// Register during application bootstrap
+ProviderRegistry.register('firebase', () => new FirebaseTenantProvider());
+```
+
+### Quick Start
+
+```typescript
+import { TenantManager } from "beddel";
+
+const manager = TenantManager.getInstance();
+
+// Initialize tenant
+const result = await manager.initializeTenant({
+  tenantId: "tenant-123",
+  securityProfile: "tenant-isolated",
+  dataRetentionDays: 365,
+  lgpdEnabled: true,
+  gdprEnabled: true,
+  provider: "memory", // or registered external provider like "firebase"
+  providerConfig: {}
+});
+
+// Execute in tenant context
+await manager.executeInTenant("tenant-123", "operation", data, async () => {
+  const app = manager.getTenantApp("tenant-123");
+  const db = app.getDatabase();
+  await db.collection("users").add({ name: "Alice" });
+});
+```
+
+### Core Interfaces
+
+- `ITenantProvider` — Abstract provider for tenant management
+- `ITenantApp` — Isolated tenant instance
+- `ITenantDatabase` — Database operations
+- `ITenantCollection` — Collection operations
+- `ITenantDocument` — Document CRUD
+- `ProviderRegistry` — Dynamic provider registration
+
+---
+
 ## Security
 
 ### Multi-Layer Security Model
@@ -520,20 +598,45 @@ const result = await runtime.execute({
 
 ```
 src/
-├── agents/                  # Agent registry and built-in agents
-│   ├── agentRegistry.ts     # Agent management
-│   ├── joker-agent.yaml     # Built-in: Joker
-│   ├── translator-agent.yaml
-│   └── image-agent.yaml
-├── parser/                  # Secure YAML parsing
+├── agents/                  # Agent registry and sharded agent modules
+│   ├── registry/            # Agent registry
+│   │   ├── agentRegistry.ts
+│   │   └── index.ts
+│   ├── joker/               # Joker agent
+│   │   ├── joker.yaml
+│   │   ├── joker.handler.ts
+│   │   ├── joker.schema.ts
+│   │   ├── joker.types.ts
+│   │   └── index.ts
+│   ├── translator/          # Translator agent
+│   ├── image/               # Image generator agent
+│   ├── mcp-tool/            # MCP tool agent
+│   ├── gemini-vectorize/    # Embeddings agent
+│   ├── chromadb/            # Vector storage agent
+│   ├── gitmcp/              # GitHub docs agent
+│   ├── rag/                 # RAG agent
+│   ├── chat/                # Chat orchestrator agent
+│   └── index.ts             # Public exports
 ├── runtime/                 # Execution environments
-│   ├── isolatedRuntime.ts
 │   ├── declarativeAgentRuntime.ts
-│   └── schemaCompiler.ts
+│   ├── workflowExecutor.ts  # Workflow step execution
+│   ├── schemaCompiler.ts
+│   └── index.ts
+├── shared/                  # Client-safe types and utilities
+│   ├── types/
+│   └── utils/
+├── client/                  # Client-safe exports
+├── parser/                  # Secure YAML parsing
 ├── security/                # Scanning and threat detection
 ├── compliance/              # GDPR/LGPD utilities
 ├── performance/             # Monitoring and autoscaling
-├── firebase/                # Multi-tenant management
+├── tenant/                  # Provider-agnostic multi-tenant management
+│   ├── TenantManager.ts     # Singleton tenant orchestrator
+│   ├── interfaces.ts        # ITenantProvider, ITenantApp, etc.
+│   ├── providerFactory.ts   # Provider instantiation
+│   ├── providerRegistry.ts  # Dynamic provider registration
+│   └── providers/           # Built-in provider implementations
+│       └── InMemoryTenantProvider.ts
 └── index.ts                 # Public exports
 ```
 

package/dist/agents/chat/chat.handler.d.ts

@@ -0,0 +1,12 @@
+import 'server-only';
+/**
+ * Chat Agent Handler - Server-only execution logic
+ * Orchestrates RAG pipeline or simple LLM chat based on mode
+ */
+import type { ExecutionContext } from '../../types/executionContext';
+import type { ChatHandlerParams, ChatHandlerResult } from './chat.types';
+/**
+ * Execute chat orchestration
+ */
+export declare function executeChatHandler(params: ChatHandlerParams, props: Record<string, string>, context: ExecutionContext): Promise<ChatHandlerResult>;
+//# sourceMappingURL=chat.handler.d.ts.map

package/dist/agents/chat/chat.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.handler.d.ts","sourceRoot":"","sources":["../../../src/agents/chat/chat.handler.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAY,MAAM,cAAc,CAAC;AAuKnF;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}

package/dist/agents/chat/chat.handler.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeChatHandler = executeChatHandler;
+require("server-only");
+const gemini_vectorize_handler_1 = require("../gemini-vectorize/gemini-vectorize.handler");
+const chromadb_handler_1 = require("../chromadb/chromadb.handler");
+const rag_handler_1 = require("../rag/rag.handler");
+const llm_handler_1 = require("../llm/llm.handler");
+const KNOWLEDGE_COLLECTION = 'beddel_knowledge';
+/**
+ * Execute simple chat mode - direct LLM with conversation history (no documents)
+ */
+async function executeSimpleChat(query, messages, props, context, executionSteps) {
+    const startTime = Date.now();
+    context.log(`[Chat:Simple] Processing query: "${query.substring(0, 50)}..."`);
+    const chatStep = {
+        agent: 'llm',
+        action: 'chat',
+        status: 'running',
+        startTime: Date.now(),
+        phase: 'generation',
+    };
+    executionSteps.push(chatStep);
+    const result = await (0, llm_handler_1.executeLlmHandler)({ query, history: messages }, props, context);
+    chatStep.status = result.error ? 'error' : 'success';
+    chatStep.endTime = Date.now();
+    chatStep.duration = chatStep.endTime - chatStep.startTime;
+    if (result.error)
+        chatStep.error = result.error;
+    return {
+        response: result.response,
+        timestamp: result.timestamp,
+        execution_steps: executionSteps,
+        total_duration: Date.now() - startTime,
+    };
+}
+/**
+ * Execute RAG chat mode - full pipeline with knowledge base
+ */
+async function executeRagChat(query, messages, props, context, executionSteps) {
+    const startTime = Date.now();
+    context.log(`[Chat:RAG] Processing query: "${query.substring(0, 50)}..."`);
+    // Step 1: Vectorize user query
+    const vectorizeStep = {
+        agent: 'gemini-vectorize',
+        action: 'embedSingle',
+        status: 'running',
+        startTime: Date.now(),
+        phase: 'vectorization',
+    };
+    executionSteps.push(vectorizeStep);
+    const vectorResult = await (0, gemini_vectorize_handler_1.executeVectorizeHandler)({ action: 'embedSingle', text: query }, props, context);
+    vectorizeStep.status = vectorResult.success ? 'success' : 'error';
+    vectorizeStep.endTime = Date.now();
+    vectorizeStep.duration = vectorizeStep.endTime - vectorizeStep.startTime;
+    if (!vectorResult.success || !vectorResult.vector) {
+        throw new Error(`Vectorization failed: ${vectorResult.error}`);
+    }
+    // Step 2: Check if knowledge base has data
+    const checkStep = {
+        agent: 'chromadb',
+        action: 'hasData',
+        status: 'running',
+        startTime: Date.now(),
+        phase: 'retrieval',
+    };
+    executionSteps.push(checkStep);
+    const hasDataResult = await (0, chromadb_handler_1.executeChromaDBHandler)({ action: 'hasData', collection_name: KNOWLEDGE_COLLECTION, min_count: 5 }, props, context);
+    checkStep.status = hasDataResult.success ? 'success' : 'error';
+    checkStep.endTime = Date.now();
+    checkStep.duration = checkStep.endTime - checkStep.startTime;
+    // Step 3: Search knowledge base
+    const searchStep = {
+        agent: 'chromadb',
+        action: 'search',
+        status: 'running',
+        startTime: Date.now(),
+        phase: 'retrieval',
+    };
+    executionSteps.push(searchStep);
+    const searchResult = await (0, chromadb_handler_1.executeChromaDBHandler)({
+        action: 'search',
+        collection_name: KNOWLEDGE_COLLECTION,
+        query_vector: vectorResult.vector,
+        limit: 5,
+    }, props, context);
+    searchStep.status = searchResult.success ? 'success' : 'error';
+    searchStep.endTime = Date.now();
+    searchStep.duration = searchStep.endTime - searchStep.startTime;
+    // Step 4: Generate answer using RAG
+    const ragStep = {
+        agent: 'rag',
+        action: 'generate',
+        status: 'running',
+        startTime: Date.now(),
+        phase: 'generation',
+    };
+    executionSteps.push(ragStep);
+    const hasDocuments = searchResult.documents && searchResult.documents.trim().length > 0;
+    const documents = hasDocuments
+        ? searchResult.documents
+        : 'No specific documentation available. Answer based on general knowledge.';
+    const ragResult = await (0, rag_handler_1.executeRagHandler)({ query, documents, history: messages }, props, context);
+    ragStep.status = ragResult.error ? 'error' : 'success';
+    ragStep.endTime = Date.now();
+    ragStep.duration = ragStep.endTime - ragStep.startTime;
+    if (ragResult.error)
+        ragStep.error = ragResult.error;
+    return {
+        response: ragResult.response,
+        timestamp: ragResult.timestamp,
+        execution_steps: executionSteps,
+        total_duration: Date.now() - startTime,
+    };
+}
+/**
+ * Execute chat orchestration
+ */
+async function executeChatHandler(params, props, context) {
+    const executionSteps = [];
+    const messages = params.messages || [];
+    const lastUserMessage = [...messages].reverse().find((m) => m.role === 'user');
+    const query = params.query || lastUserMessage?.content || '';
+    const mode = params.mode || 'rag';
+    if (!query) {
+        throw new Error('No query found in messages or query parameter');
+    }
+    try {
+        return mode === 'simple'
+            ? await executeSimpleChat(query, messages, props, context, executionSteps)
+            : await executeRagChat(query, messages, props, context, executionSteps);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        context.log(`[Chat] Error: ${message}`);
+        context.setError(message);
+        return {
+            response: `Error processing your request: ${message}`,
+            timestamp: new Date().toISOString(),
+            execution_steps: executionSteps,
+            total_duration: 0,
+        };
+    }
+}
+//# sourceMappingURL=chat.handler.js.map

package/dist/agents/chat/chat.handler.js.map

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

package/dist/agents/chat/chat.schema.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Chat Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+import { z } from 'zod';
+export declare const ChatInputSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+            system: "system";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+    query: z.ZodOptional<z.ZodString>;
+    knowledge_sources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ChatOutputSchema: z.ZodObject<{
+    response: z.ZodString;
+    timestamp: z.ZodString;
+    execution_steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        action: z.ZodString;
+        status: z.ZodEnum<{
+            error: "error";
+            success: "success";
+            running: "running";
+        }>;
+        startTime: z.ZodNumber;
+        endTime: z.ZodOptional<z.ZodNumber>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    total_duration: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ChatInput = z.infer<typeof ChatInputSchema>;
+export type ChatOutput = z.infer<typeof ChatOutputSchema>;
+//# sourceMappingURL=chat.schema.d.ts.map

package/dist/agents/chat/chat.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.schema.d.ts","sourceRoot":"","sources":["../../../src/agents/chat/chat.schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;;iBAO1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAa3B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/agents/chat/chat.schema.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Chat Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatOutputSchema = exports.ChatInputSchema = void 0;
+const zod_1 = require("zod");
+exports.ChatInputSchema = zod_1.z.object({
+    messages: zod_1.z.array(zod_1.z.object({
+        role: zod_1.z.enum(['user', 'assistant', 'system']),
+        content: zod_1.z.string(),
+    })),
+    query: zod_1.z.string().optional(),
+    knowledge_sources: zod_1.z.array(zod_1.z.string()).optional(),
+});
+exports.ChatOutputSchema = zod_1.z.object({
+    response: zod_1.z.string(),
+    timestamp: zod_1.z.string(),
+    execution_steps: zod_1.z.array(zod_1.z.object({
+        agent: zod_1.z.string(),
+        action: zod_1.z.string(),
+        status: zod_1.z.enum(['running', 'success', 'error']),
+        startTime: zod_1.z.number(),
+        endTime: zod_1.z.number().optional(),
+        duration: zod_1.z.number().optional(),
+        error: zod_1.z.string().optional(),
+    })).optional(),
+    total_duration: zod_1.z.number().optional(),
+});
+//# sourceMappingURL=chat.schema.js.map

package/dist/agents/chat/chat.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.schema.js","sourceRoot":"","sources":["../../../src/agents/chat/chat.schema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAwB;AAEX,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QACzB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;KACpB,CAAC,CAAC;IACH,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,iBAAiB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,eAAe,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;QACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC,CAAC,CAAC,QAAQ,EAAE;IACd,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}

package/dist/agents/chat/chat.types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Chat Agent Types - Shared between client and server
+ */
+import type { ConversationMessage } from '../rag/rag.types';
+import type { ExecutionStep } from '../../shared/types/agent.types';
+/**
+ * Chat mode determines the execution flow
+ * - 'rag': Full RAG pipeline with knowledge base (default)
+ * - 'simple': Direct LLM chat maintaining conversation context only
+ */
+export type ChatMode = 'rag' | 'simple';
+/**
+ * Parameters for chat orchestration
+ */
+export interface ChatHandlerParams {
+    messages: ConversationMessage[];
+    query?: string;
+    mode?: ChatMode;
+    knowledge_sources?: string[];
+}
+/**
+ * Result from chat orchestration
+ */
+export interface ChatHandlerResult {
+    response: string;
+    timestamp: string;
+    execution_steps?: ExecutionStep[];
+    total_duration?: number;
+}
+/**
+ * Chat agent metadata
+ */
+export interface ChatMetadata {
+    id: 'chat';
+    name: string;
+    description: string;
+    category: 'chat';
+    route: '/agents/chat';
+    knowledge_sources: string[];
+    tags: string[];
+}
+//# sourceMappingURL=chat.types.d.ts.map

package/dist/agents/chat/chat.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../src/agents/chat/chat.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB"}

package/dist/agents/chat/chat.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Chat Agent Types - Shared between client and server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chat.types.js.map

package/dist/agents/chat/chat.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.types.js","sourceRoot":"","sources":["../../../src/agents/chat/chat.types.ts"],"names":[],"mappings":";AAAA;;GAEG"}