beddel 0.2.2 → 0.3.0

package/dist/agents/mcp-tool/mcp-tool.handler.js

@@ -0,0 +1,116 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeMcpToolHandler = executeMcpToolHandler;
+require("server-only");
+// MCP imports (lazy loaded to avoid issues if not installed)
+let mcpClient = null;
+let mcpSSETransport = null;
+/**
+ * Execute MCP tool invocation
+ */
+async function executeMcpToolHandler(params, _props, context) {
+    const serverUrl = params.server_url;
+    const toolName = params.tool_name;
+    const toolArguments = params.tool_arguments || {};
+    if (!serverUrl) {
+        throw new Error('Missing required MCP input: server_url');
+    }
+    if (!toolName) {
+        throw new Error('Missing required MCP input: tool_name');
+    }
+    context.log(`[MCP Tool] Connecting to ${serverUrl}...`);
+    context.log(`[MCP Tool] Tool: ${toolName}`);
+    try {
+        // Lazy load MCP SDK
+        if (!mcpClient) {
+            const { Client } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/client/index.js')));
+            const { SSEClientTransport } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/client/sse.js')));
+            mcpClient = Client;
+            mcpSSETransport = SSEClientTransport;
+            // Setup EventSource for Node.js
+            const eventsourceModule = await Promise.resolve().then(() => __importStar(require('eventsource')));
+            const EventSourceClass = eventsourceModule.default || eventsourceModule;
+            if (!global.EventSource) {
+                global.EventSource = EventSourceClass;
+            }
+        }
+        const transport = new mcpSSETransport(new URL(serverUrl));
+        const client = new mcpClient({ name: 'beddel-mcp-client', version: '1.0.0' }, { capabilities: {} });
+        await client.connect(transport);
+        context.log('[MCP Tool] Connected!');
+        // List available tools
+        const tools = await client.listTools();
+        const availableToolNames = tools.tools.map((t) => t.name);
+        context.log(`[MCP Tool] Available tools: ${availableToolNames.join(', ')}`);
+        // Handle list_tools special case
+        if (toolName === 'list_tools') {
+            await client.close();
+            return {
+                success: true,
+                data: JSON.stringify(tools.tools),
+                tool_names: availableToolNames,
+            };
+        }
+        // Validate tool exists
+        if (!availableToolNames.includes(toolName)) {
+            await client.close();
+            return {
+                success: false,
+                error: `Tool '${toolName}' not found. Available tools: ${availableToolNames.join(', ')}`,
+            };
+        }
+        // Call the tool with timeout
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('MCP Tool Timeout (30s)')), 30000));
+        const callPromise = client.callTool({
+            name: toolName,
+            arguments: toolArguments,
+        });
+        const callResult = await Promise.race([callPromise, timeoutPromise]);
+        await client.close();
+        // Parse result content
+        const textContent = callResult.content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('\n') || 'No text content returned';
+        return { success: true, data: textContent };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        context.log(`[MCP Tool] Error: ${message}`);
+        return { success: false, error: message };
+    }
+}
+//# sourceMappingURL=mcp-tool.handler.js.map

package/dist/agents/mcp-tool/mcp-tool.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.handler.js","sourceRoot":"","sources":["../../../src/agents/mcp-tool/mcp-tool.handler.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBA,sDA8FC;AA/GD,uBAAqB;AAUrB,6DAA6D;AAC7D,IAAI,SAAS,GAAQ,IAAI,CAAC;AAC1B,IAAI,eAAe,GAAQ,IAAI,CAAC;AAEhC;;GAEG;AACI,KAAK,UAAU,qBAAqB,CACzC,MAA4B,EAC5B,MAA8B,EAC9B,OAAyB;IAEzB,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC;IAClC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAElD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,4BAA4B,SAAS,KAAK,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,oBAAoB;QACpB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,GAAG,wDAAa,2CAA2C,GAAC,CAAC;YAC7E,MAAM,EAAE,kBAAkB,EAAE,GAAG,wDAAa,yCAAyC,GAAC,CAAC;YACvF,SAAS,GAAG,MAAM,CAAC;YACnB,eAAe,GAAG,kBAAkB,CAAC;YAErC,gCAAgC;YAChC,MAAM,iBAAiB,GAAG,wDAAa,aAAa,GAAC,CAAC;YACtD,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,IAAI,iBAAiB,CAAC;YACxE,IAAI,CAAE,MAAc,CAAC,WAAW,EAAE,CAAC;gBAChC,MAAc,CAAC,WAAW,GAAG,gBAAgB,CAAC;YACjD,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC/C,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;QAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAErC,uBAAuB;QACvB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,kBAAkB,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,+BAA+B,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE5E,iCAAiC;QACjC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;gBACjC,UAAU,EAAE,kBAAkB;aAC/B,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,SAAS,QAAQ,iCAAiC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACzF,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,EAAE,KAAK,CAAC,CACrE,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC;YAClC,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,aAAa;SACzB,CAAC,CAAC;QAEH,MAAM,UAAU,GAAQ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,uBAAuB;QACvB,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO;aACnC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aACrC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACvB,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAE9C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/agents/mcp-tool/mcp-tool.schema.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP Tool Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+import { z } from 'zod';
+export declare const McpToolInputSchema: z.ZodObject<{
+    server_url: z.ZodString;
+    tool_name: z.ZodString;
+    tool_arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const McpToolOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodString>;
+    tool_names: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type McpToolInput = z.infer<typeof McpToolInputSchema>;
+export type McpToolOutput = z.infer<typeof McpToolOutputSchema>;
+//# sourceMappingURL=mcp-tool.schema.d.ts.map

package/dist/agents/mcp-tool/mcp-tool.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.schema.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp-tool/mcp-tool.schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/agents/mcp-tool/mcp-tool.schema.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * MCP Tool Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolOutputSchema = exports.McpToolInputSchema = void 0;
+const zod_1 = require("zod");
+exports.McpToolInputSchema = zod_1.z.object({
+    server_url: zod_1.z.string().url(),
+    tool_name: zod_1.z.string().min(1),
+    tool_arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+exports.McpToolOutputSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    data: zod_1.z.string().optional(),
+    tool_names: zod_1.z.array(zod_1.z.string()).optional(),
+    error: zod_1.z.string().optional(),
+});
+//# sourceMappingURL=mcp-tool.schema.js.map

package/dist/agents/mcp-tool/mcp-tool.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.schema.js","sourceRoot":"","sources":["../../../src/agents/mcp-tool/mcp-tool.schema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAwB;AAEX,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC;AAEU,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/dist/agents/mcp-tool/mcp-tool.types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP Tool Agent Types - Shared between client and server
+ */
+/**
+ * Parameters for MCP tool invocation
+ */
+export interface McpToolHandlerParams {
+    server_url: string;
+    tool_name: string;
+    tool_arguments?: Record<string, unknown>;
+}
+/**
+ * Result from MCP tool invocation
+ */
+export interface McpToolHandlerResult {
+    success: boolean;
+    data?: string;
+    tool_names?: string[];
+    error?: string;
+}
+/**
+ * MCP Tool agent metadata
+ */
+export interface McpToolMetadata {
+    id: 'mcp-tool';
+    name: string;
+    description: string;
+    category: 'integration';
+    route: '/agents/mcp-tool';
+}
+//# sourceMappingURL=mcp-tool.types.d.ts.map

package/dist/agents/mcp-tool/mcp-tool.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.types.d.ts","sourceRoot":"","sources":["../../../src/agents/mcp-tool/mcp-tool.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;CAC3B"}

package/dist/agents/mcp-tool/mcp-tool.types.js

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

package/dist/agents/mcp-tool/mcp-tool.types.js.map

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

package/dist/agents/mcp-tool/mcp-tool.yaml

@@ -0,0 +1,71 @@
+# MCP Tool Agent - Native Builtin Agent for Beddel Runtime
+# Route: /agents/mcp-tool
+# Method: mcp-tool.execute
+
+agent:
+  id: mcp-tool
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "MCP Tool Agent"
+  description: "Generic agent for calling MCP server tools via SSE transport"
+  category: "integration"
+  route: "/agents/mcp-tool"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      server_url:
+        type: "string"
+        description: "MCP server SSE endpoint URL"
+      tool_name:
+        type: "string"
+        description: "Name of the MCP tool to invoke (use 'list_tools' to discover available tools)"
+      tool_arguments:
+        type: "object"
+        description: "Arguments to pass to the tool"
+    required: ["server_url", "tool_name"]
+
+  output:
+    type: "object"
+    properties:
+      success:
+        type: "boolean"
+      data:
+        type: "string"
+      tool_names:
+        type: "array"
+        items:
+          type: "string"
+      error:
+        type: "string"
+    required: ["success"]
+
+logic:
+  workflow:
+    - name: "call-mcp-tool"
+      type: "mcp-tool"
+      action:
+        server_url: "$input.server_url"
+        tool_name: "$input.tool_name"
+        tool_arguments: "$input.tool_arguments"
+        result: "mcpResult"
+
+    - name: "deliver-response"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          success: "$mcpResult.success"
+          data: "$mcpResult.data"
+          tool_names: "$mcpResult.toolNames"
+          error: "$mcpResult.error"
+
+output:
+  schema:
+    success: "$mcpResult.success"
+    data: "$mcpResult.data"
+    tool_names: "$mcpResult.toolNames"
+    error: "$mcpResult.error"

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

@@ -0,0 +1,15 @@
+/**
+ * RAG Agent - Public exports (client-safe)
+ */
+export { RagInputSchema, RagOutputSchema } from './rag.schema';
+export type { RagInput, RagOutput } from './rag.schema';
+export type { RagHandlerParams, RagHandlerResult, ConversationMessage, RagMetadata } from './rag.types';
+export declare const ragMetadata: {
+    readonly id: "rag";
+    readonly name: "RAG Intelligence Agent";
+    readonly description: "Generates natural language answers based on provided context using Gemini";
+    readonly category: "intelligence";
+    readonly route: "/agents/rag";
+    readonly tags: readonly ["rag", "gemini", "qa", "generation"];
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/rag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGxD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGxG,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC"}

package/dist/agents/rag/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * RAG Agent - Public exports (client-safe)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ragMetadata = exports.RagOutputSchema = exports.RagInputSchema = void 0;
+// Schema exports (client-safe)
+var rag_schema_1 = require("./rag.schema");
+Object.defineProperty(exports, "RagInputSchema", { enumerable: true, get: function () { return rag_schema_1.RagInputSchema; } });
+Object.defineProperty(exports, "RagOutputSchema", { enumerable: true, get: function () { return rag_schema_1.RagOutputSchema; } });
+// Metadata (client-safe)
+exports.ragMetadata = {
+    id: 'rag',
+    name: 'RAG Intelligence Agent',
+    description: 'Generates natural language answers based on provided context using Gemini',
+    category: 'intelligence',
+    route: '/agents/rag',
+    tags: ['rag', 'gemini', 'qa', 'generation'],
+};
+//# sourceMappingURL=index.js.map

package/dist/agents/rag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/rag/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+BAA+B;AAC/B,2CAA+D;AAAtD,4GAAA,cAAc,OAAA;AAAE,6GAAA,eAAe,OAAA;AAMxC,yBAAyB;AACZ,QAAA,WAAW,GAAG;IACzB,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,2EAA2E;IACxF,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC;CACnC,CAAC"}

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

@@ -0,0 +1,9 @@
+import 'server-only';
+import type { ExecutionContext } from '../../types/executionContext';
+import type { RagHandlerParams, RagHandlerResult } from './rag.types';
+/**
+ * Execute RAG answer generation
+ * Requires document context - for direct LLM chat, use the LLM agent
+ */
+export declare function executeRagHandler(params: RagHandlerParams, props: Record<string, string>, context: ExecutionContext): Promise<RagHandlerResult>;
+//# sourceMappingURL=rag.handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.handler.d.ts","sourceRoot":"","sources":["../../../src/agents/rag/rag.handler.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAarB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAuB,MAAM,aAAa,CAAC;AA+B3F;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAyC3B"}

package/dist/agents/rag/rag.handler.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeRagHandler = executeRagHandler;
+require("server-only");
+/**
+ * RAG Agent Handler - Server-only execution logic
+ * Generates natural language answers based on provided document context using LLM
+ *
+ * Note: RAG = Retrieval-Augmented Generation
+ * This agent ALWAYS requires document context. For direct LLM chat without
+ * documents, use the LLM agent instead.
+ */
+const ai_1 = require("ai");
+const llmProviderFactory_1 = require("../../runtime/llmProviderFactory");
+/**
+ * Build prompt for RAG mode (with documents)
+ */
+function buildRagPrompt(query, ragContext, history) {
+    const conversationContext = history?.length
+        ? `CONVERSATION HISTORY:\n${history.map((m) => `${m.role.toUpperCase()}: ${m.content}`).join('\n')}\n\n`
+        : '';
+    return `You are a helpful and expert assistant for the Beddel Protocol.
+
+${conversationContext}CONTEXT INFORMATION:
+${ragContext}
+
+USER QUESTION:
+${query}
+
+INSTRUCTIONS:
+1. Answer the user's question based on the CONTEXT INFORMATION provided above.
+2. Consider the CONVERSATION HISTORY for context continuity if available.
+3. If the context does not contain the answer, politely state that you don't have enough information in the documentation to answer.
+4. Be concise but comprehensive.
+
+ANSWER:`;
+}
+/**
+ * Execute RAG answer generation
+ * Requires document context - for direct LLM chat, use the LLM agent
+ */
+async function executeRagHandler(params, props, context) {
+    const providerConfig = (0, llmProviderFactory_1.extractProviderConfig)(props, 'google');
+    const model = llmProviderFactory_1.LLMProviderFactory.createLanguageModel(providerConfig);
+    const { query, history } = params;
+    const ragContext = params.context || params.documents;
+    if (!query) {
+        throw new Error('Missing required RAG input: query');
+    }
+    if (!ragContext) {
+        throw new Error('Missing required RAG input: context or documents. For direct LLM chat without documents, use the LLM agent instead.');
+    }
+    const prompt = buildRagPrompt(query, ragContext, history);
+    try {
+        context.log(`[RAG] Generating answer for: "${query.substring(0, 50)}..."`);
+        const { text } = await (0, ai_1.generateText)({
+            model,
+            prompt,
+            temperature: 0.3,
+        });
+        return {
+            response: text,
+            answer: text,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        context.log(`[RAG] Error: ${message}`);
+        return {
+            response: '',
+            answer: '',
+            timestamp: new Date().toISOString(),
+            error: message,
+        };
+    }
+}
+//# sourceMappingURL=rag.handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.handler.js","sourceRoot":"","sources":["../../../src/agents/rag/rag.handler.ts"],"names":[],"mappings":";;AAiDA,8CA6CC;AA9FD,uBAAqB;AAErB;;;;;;;GAOG;AAEH,2BAAkC;AAClC,yEAA6F;AAI7F;;GAEG;AACH,SAAS,cAAc,CACrB,KAAa,EACb,UAAkB,EAClB,OAA+B;IAE/B,MAAM,mBAAmB,GAAG,OAAO,EAAE,MAAM;QACzC,CAAC,CAAC,0BAA0B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;QACxG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;EAEP,mBAAmB;EACnB,UAAU;;;EAGV,KAAK;;;;;;;;QAQC,CAAC;AACT,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAAwB,EACxB,KAA6B,EAC7B,OAAyB;IAEzB,MAAM,cAAc,GAAG,IAAA,0CAAqB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,uCAAkB,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAErE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC;IAEtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,qHAAqH,CAAC,CAAC;IACzI,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QAE3E,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,iBAAY,EAAC;YAClC,KAAK;YACL,MAAM;YACN,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;QACvC,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,OAAO;SACf,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * RAG Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+import { z } from 'zod';
+export declare const RagInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    documents: z.ZodOptional<z.ZodString>;
+    history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+            system: "system";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const RagOutputSchema: z.ZodObject<{
+    response: z.ZodString;
+    answer: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RagInput = z.infer<typeof RagInputSchema>;
+export type RagOutput = z.infer<typeof RagOutputSchema>;
+//# sourceMappingURL=rag.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.schema.d.ts","sourceRoot":"","sources":["../../../src/agents/rag/rag.schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAQzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/agents/rag/rag.schema.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * RAG Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RagOutputSchema = exports.RagInputSchema = void 0;
+const zod_1 = require("zod");
+exports.RagInputSchema = zod_1.z.object({
+    query: zod_1.z.string().min(1),
+    context: zod_1.z.string().optional(),
+    documents: zod_1.z.string().optional(),
+    history: zod_1.z.array(zod_1.z.object({
+        role: zod_1.z.enum(['user', 'assistant', 'system']),
+        content: zod_1.z.string(),
+    })).optional(),
+});
+exports.RagOutputSchema = zod_1.z.object({
+    response: zod_1.z.string(),
+    answer: zod_1.z.string().optional(),
+    timestamp: zod_1.z.string().optional(),
+    error: zod_1.z.string().optional(),
+});
+//# sourceMappingURL=rag.schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.schema.js","sourceRoot":"","sources":["../../../src/agents/rag/rag.schema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAwB;AAEX,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;KACpB,CAAC,CAAC,CAAC,QAAQ,EAAE;CACf,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * RAG Agent Types - Shared between client and server
+ * RAG = Retrieval-Augmented Generation (always requires document context)
+ */
+/**
+ * Conversation message
+ */
+export interface ConversationMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/**
+ * Parameters for RAG answer generation
+ * Note: context or documents is REQUIRED - RAG always needs document context
+ */
+export interface RagHandlerParams {
+    query: string;
+    context?: string;
+    documents?: string;
+    history?: ConversationMessage[];
+}
+/**
+ * Result from RAG answer generation
+ */
+export interface RagHandlerResult {
+    response: string;
+    answer: string;
+    timestamp: string;
+    error?: string;
+}
+/**
+ * RAG agent metadata
+ */
+export interface RagMetadata {
+    id: 'rag';
+    name: string;
+    description: string;
+    category: 'intelligence';
+    route: '/agents/rag';
+    tags: string[];
+}
+//# sourceMappingURL=rag.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.types.d.ts","sourceRoot":"","sources":["../../../src/agents/rag/rag.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB"}

package/dist/agents/rag/rag.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * RAG Agent Types - Shared between client and server
+ * RAG = Retrieval-Augmented Generation (always requires document context)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rag.types.js.map

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

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

package/dist/agents/rag/rag.yaml

@@ -0,0 +1,89 @@
+# RAG Agent - Native Builtin Agent for Beddel Runtime
+# Route: /agents/rag
+# Method: rag.execute
+
+agent:
+  id: rag
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "RAG Intelligence Agent"
+  description: "Generates natural language answers based on provided context using Gemini"
+  category: "intelligence"
+  route: "/agents/rag"
+  tags:
+    - "rag"
+    - "gemini"
+    - "qa"
+    - "generation"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      query:
+        type: "string"
+        description: "User question to answer"
+      context:
+        type: "string"
+        description: "Retrieved documentation or context for answering"
+      documents:
+        type: "string"
+        description: "Alternative to context - retrieved documents"
+      history:
+        type: "array"
+        items:
+          type: "object"
+          properties:
+            role:
+              type: "string"
+              enum: ["user", "assistant", "system"]
+            content:
+              type: "string"
+        description: "Conversation history for context continuity"
+    required: ["query"]
+
+  output:
+    type: "object"
+    properties:
+      response:
+        type: "string"
+        description: "Generated answer"
+      answer:
+        type: "string"
+        description: "Alias for response"
+      timestamp:
+        type: "string"
+        description: "ISO timestamp of generation"
+      error:
+        type: "string"
+    required: ["response"]
+
+logic:
+  workflow:
+    - name: "generate-answer"
+      type: "rag"
+      action:
+        query: "$input.query"
+        context: "$input.context"
+        documents: "$input.documents"
+        history: "$input.history"
+        result: "ragResult"
+
+    - name: "deliver-response"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          response: "$ragResult.response"
+          answer: "$ragResult.answer"
+          timestamp: "$ragResult.timestamp"
+          error: "$ragResult.error"
+
+output:
+  schema:
+    response: "$ragResult.response"
+    answer: "$ragResult.answer"
+    timestamp: "$ragResult.timestamp"
+    error: "$ragResult.error"