beddel 0.2.3 → 1.0.0

package/src/agents/mcp-tool/mcp-tool.types.ts

@@ -1,33 +0,0 @@
-/**
- * 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';
-}

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

@@ -1,71 +0,0 @@
-# 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/src/agents/rag/index.ts

@@ -1,20 +0,0 @@
-/**
- * RAG Agent - Public exports (client-safe)
- */
-
-// Schema exports (client-safe)
-export { RagInputSchema, RagOutputSchema } from './rag.schema';
-export type { RagInput, RagOutput } from './rag.schema';
-
-// Type exports (client-safe)
-export type { RagHandlerParams, RagHandlerResult, ConversationMessage, RagMetadata } from './rag.types';
-
-// Metadata (client-safe)
-export const 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'],
-} as const;

package/src/agents/rag/rag.handler.ts

@@ -1,119 +0,0 @@
-import 'server-only';
-
-/**
- * RAG Agent Handler - Server-only execution logic
- * Generates natural language answers based on provided context using Gemini
- * Supports both RAG mode (with documents) and simple chat mode (conversation only)
- */
-
-import { generateText } from 'ai';
-import { createGoogleGenerativeAI } from '@ai-sdk/google';
-import type { ExecutionContext } from '../../types/executionContext';
-import type { RagHandlerParams, RagHandlerResult, ConversationMessage } from './rag.types';
-
-const GEMINI_RAG_MODEL = 'models/gemini-2.0-flash-exp';
-
-/**
- * Build prompt for simple chat mode (no documents)
- */
-function buildSimpleChatPrompt(query: string, history?: ConversationMessage[]): string {
-  const conversationContext = history?.length
-    ? `CONVERSATION HISTORY:\n${history.map((m) => `${m.role.toUpperCase()}: ${m.content}`).join('\n')}\n\n`
-    : '';
-
-  return `You are a helpful, friendly assistant.
-
-${conversationContext}USER MESSAGE:
-${query}
-
-INSTRUCTIONS:
-1. Respond naturally to the user's message.
-2. Consider the conversation history for context continuity if available.
-3. Be concise but helpful.
-
-RESPONSE:`;
-}
-
-/**
- * Build prompt for RAG mode (with documents)
- */
-function buildRagPrompt(query: string, ragContext: string, history?: ConversationMessage[]): string {
-  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
- */
-export async function executeRagHandler(
-  params: RagHandlerParams,
-  props: Record<string, string>,
-  context: ExecutionContext
-): Promise<RagHandlerResult> {
-  const apiKey = props?.gemini_api_key?.trim();
-  if (!apiKey) {
-    throw new Error('Missing required prop: gemini_api_key');
-  }
-
-  const { query, history, mode = 'rag' } = params;
-  const ragContext = params.context || params.documents;
-
-  if (!query) {
-    throw new Error('Missing required RAG input: query');
-  }
-
-  // Simple mode doesn't require documents
-  if (mode === 'rag' && !ragContext) {
-    throw new Error('Missing required RAG input: context or documents');
-  }
-
-  const google = createGoogleGenerativeAI({ apiKey });
-  const model = google(GEMINI_RAG_MODEL);
-
-  const prompt = mode === 'simple'
-    ? buildSimpleChatPrompt(query, history)
-    : buildRagPrompt(query, ragContext!, history);
-
-  try {
-    context.log(`[RAG:${mode}] Generating answer for: "${query.substring(0, 50)}..."`);
-
-    const { text } = await generateText({
-      model,
-      prompt,
-      temperature: mode === 'simple' ? 0.7 : 0.3,
-    });
-
-    return {
-      response: text,
-      answer: text,
-      timestamp: new Date().toISOString(),
-    };
-
-  } catch (error: unknown) {
-    const message = error instanceof Error ? error.message : String(error);
-    context.log(`[RAG] Error: ${message}`);
-    return {
-      response: '',
-      answer: '',
-      timestamp: new Date().toISOString(),
-      error: message,
-    };
-  }
-}

package/src/agents/rag/rag.schema.ts

@@ -1,26 +0,0 @@
-/**
- * RAG Agent Schema - Zod validation schemas
- * Safe for both client and server
- */
-
-import { z } from 'zod';
-
-export const RagInputSchema = z.object({
-  query: z.string().min(1),
-  context: z.string().optional(),
-  documents: z.string().optional(),
-  history: z.array(z.object({
-    role: z.enum(['user', 'assistant', 'system']),
-    content: z.string(),
-  })).optional(),
-});
-
-export const RagOutputSchema = z.object({
-  response: z.string(),
-  answer: z.string().optional(),
-  timestamp: z.string().optional(),
-  error: z.string().optional(),
-});
-
-export type RagInput = z.infer<typeof RagInputSchema>;
-export type RagOutput = z.infer<typeof RagOutputSchema>;

package/src/agents/rag/rag.types.ts

@@ -1,51 +0,0 @@
-/**
- * RAG Agent Types - Shared between client and server
- */
-
-/**
- * Conversation message
- */
-export interface ConversationMessage {
-  role: 'user' | 'assistant' | 'system';
-  content: string;
-}
-
-/**
- * RAG execution mode
- * - 'rag': Uses provided documents/context for answer generation
- * - 'simple': Direct LLM chat without document context
- */
-export type RagMode = 'rag' | 'simple';
-
-/**
- * Parameters for RAG answer generation
- */
-export interface RagHandlerParams {
-  query: string;
-  context?: string;
-  documents?: string;
-  history?: ConversationMessage[];
-  mode?: RagMode;
-}
-
-/**
- * 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[];
-}

package/src/agents/rag/rag.yaml

@@ -1,89 +0,0 @@
-# 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"