beddel 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [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 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;AAqKnF;;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,143 @@
+"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 KNOWLEDGE_COLLECTION = 'beddel_knowledge';
+/**
+ * Execute simple chat mode - direct LLM with conversation history
+ */
+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: 'rag',
+        action: 'chat',
+        status: 'running',
+        startTime: Date.now(),
+        phase: 'generation',
+    };
+    executionSteps.push(chatStep);
+    const result = await (0, rag_handler_1.executeRagHandler)({ query, history: messages, mode: 'simple' }, 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
+    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 ragResult = hasDocuments
+        ? await (0, rag_handler_1.executeRagHandler)({ query, documents: searchResult.documents, history: messages }, props, context)
+        : await (0, rag_handler_1.executeRagHandler)({ query, documents: 'No specific documentation available. Answer based on general knowledge.', 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"}

package/dist/agents/chat/chat.yaml

@@ -0,0 +1,150 @@
+# Chat Agent - Native Builtin Orchestrator Agent for Beddel Runtime
+# Route: /agents/chat
+# Method: chat.execute
+
+agent:
+  id: chat
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "Q&A Context Chat Agent"
+  description: "Orchestrates RAG pipeline or simple chat based on mode selection"
+  category: "chat"
+  route: "/agents/chat"
+  knowledge_sources:
+    - "gitmcp-agent"
+  tags:
+    - "chat"
+    - "orchestrator"
+    - "rag"
+    - "qa"
+    - "simple"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      messages:
+        type: "array"
+        items:
+          type: "object"
+          properties:
+            role:
+              type: "string"
+              enum: ["user", "assistant", "system"]
+            content:
+              type: "string"
+          required: ["role", "content"]
+        description: "Conversation messages"
+      query:
+        type: "string"
+        description: "Direct query (alternative to messages)"
+      mode:
+        type: "string"
+        enum: ["rag", "simple"]
+        default: "rag"
+        description: "Chat mode: 'rag' for knowledge-based answers, 'simple' for direct LLM chat"
+      knowledge_sources:
+        type: "array"
+        items:
+          type: "string"
+        description: "GitMCP URLs to use as knowledge sources"
+    required: ["messages"]
+
+  output:
+    type: "object"
+    properties:
+      response:
+        type: "string"
+        description: "Generated answer"
+      timestamp:
+        type: "string"
+        description: "ISO timestamp"
+      execution_steps:
+        type: "array"
+        description: "Detailed execution steps for observability"
+      total_duration:
+        type: "number"
+        description: "Total execution time in milliseconds"
+    required: ["response", "timestamp"]
+
+logic:
+  variables:
+    - name: "userQuery"
+      type: "string"
+      init: '""'
+    - name: "allDocuments"
+      type: "string"
+      init: '""'
+
+  workflow:
+    # Step 1: Extract user query from messages
+    - name: "extract-query"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          _extracted: true
+
+    # Step 2: Mode branch - Simple chat or RAG pipeline
+    - name: "mode-check"
+      type: "conditional"
+      condition: "$input.mode == 'simple'"
+      then:
+        # Simple mode: Direct LLM chat with conversation history
+        - name: "simple-chat"
+          type: "rag"
+          action:
+            query: "$input.query"
+            history: "$input.messages"
+            mode: "simple"
+            result: "ragResult"
+      else:
+        # RAG mode: Full pipeline with knowledge base
+        - name: "vectorize-query"
+          type: "gemini-vectorize"
+          action:
+            action: "embedSingle"
+            text: "$input.query"
+            result: "queryVector"
+
+        - name: "check-knowledge"
+          type: "chromadb"
+          action:
+            action: "hasData"
+            collection_name: "beddel_knowledge"
+            min_count: 5
+            result: "hasDataResult"
+
+        - name: "search-knowledge"
+          type: "chromadb"
+          action:
+            action: "search"
+            collection_name: "beddel_knowledge"
+            query_vector: "$queryVector.vector"
+            limit: 5
+            result: "searchResult"
+
+        - name: "generate-answer"
+          type: "rag"
+          action:
+            query: "$input.query"
+            documents: "$searchResult.documents"
+            history: "$input.messages"
+            mode: "rag"
+            result: "ragResult"
+
+    # Step 3: Deliver final response
+    - name: "deliver-response"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          response: "$ragResult.response"
+          timestamp: "$ragResult.timestamp"
+
+output:
+  schema:
+    response: "$ragResult.response"
+    timestamp: "$ragResult.timestamp"

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

@@ -0,0 +1,16 @@
+/**
+ * Chat Agent - Public exports (client-safe)
+ */
+export { ChatInputSchema, ChatOutputSchema } from './chat.schema';
+export type { ChatInput, ChatOutput } from './chat.schema';
+export type { ChatHandlerParams, ChatHandlerResult, ChatMetadata } from './chat.types';
+export declare const chatMetadata: {
+    readonly id: "chat";
+    readonly name: "Q&A Context Chat Agent";
+    readonly description: "Orchestrates RAG pipeline: vectorization, storage, retrieval and answer generation";
+    readonly category: "chat";
+    readonly route: "/agents/chat";
+    readonly knowledge_sources: readonly ["gitmcp-agent"];
+    readonly tags: readonly ["chat", "orchestrator", "rag", "qa"];
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/chat/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3D,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGvF,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC"}