beddel 0.2.2 → 0.2.3

package/src/agents/translator/translator.handler.ts

@@ -0,0 +1,99 @@
+import 'server-only';
+
+/**
+ * Translator Agent Handler - Server-only execution logic
+ * Translates text between languages using Gemini Flash
+ */
+
+import { generateText } from 'ai';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import type { ExecutionContext } from '../../types/executionContext';
+import type { TranslationHandlerParams, TranslationHandlerResult } from './translator.types';
+
+const GEMINI_MODEL = 'models/gemini-2.5-flash';
+const SUPPORTED_LANGUAGES = ['pt', 'en', 'es', 'fr'];
+
+/**
+ * Execute translation using Gemini Flash
+ */
+export async function executeTranslationHandler(
+  params: TranslationHandlerParams,
+  props: Record<string, string>,
+  context: ExecutionContext
+): Promise<TranslationHandlerResult> {
+  const apiKey = props?.gemini_api_key?.trim();
+  if (!apiKey) {
+    throw new Error('Missing required prop: gemini_api_key');
+  }
+
+  const text = params.text?.trim();
+  const sourceLanguage = params.source_language?.trim().toLowerCase();
+  const targetLanguage = params.target_language?.trim().toLowerCase();
+
+  if (!text || !sourceLanguage || !targetLanguage) {
+    throw new Error('Missing required translation parameters: text, source_language, target_language');
+  }
+
+  // Same language bypass
+  if (sourceLanguage === targetLanguage) {
+    return {
+      translated_text: text,
+      metadata: {
+        model_used: GEMINI_MODEL,
+        processing_time: 0,
+        confidence: 1,
+        supported_languages: SUPPORTED_LANGUAGES,
+        requested_languages: {
+          source: sourceLanguage,
+          target: targetLanguage,
+        },
+        prompt_used: 'Bypass: source and target languages are the same',
+      },
+    };
+  }
+
+  const template = params.promptTemplate?.trim() ||
+    `Translate the text below from {{source_language}} to {{target_language}}.
+Reply only with the translated text without additional comments.
+
+Text:
+{{text}}`;
+
+  const prompt = template
+    .replace(/{{text}}/g, text)
+    .replace(/{{source_language}}/g, sourceLanguage)
+    .replace(/{{target_language}}/g, targetLanguage)
+    .trim();
+
+  const google = createGoogleGenerativeAI({ apiKey });
+  const model = google(GEMINI_MODEL);
+  const startTime = Date.now();
+
+  context.log(`[Translator] Translating from ${sourceLanguage} to ${targetLanguage}`);
+
+  const { text: translatedText } = await generateText({
+    model,
+    prompt,
+    temperature: 0.2,
+  });
+
+  const finalText = translatedText?.trim() || '';
+  if (!finalText) {
+    throw new Error('Gemini Flash translation returned empty response');
+  }
+
+  return {
+    translated_text: finalText,
+    metadata: {
+      model_used: GEMINI_MODEL,
+      processing_time: Date.now() - startTime,
+      confidence: 0.85,
+      supported_languages: SUPPORTED_LANGUAGES,
+      requested_languages: {
+        source: sourceLanguage,
+        target: targetLanguage,
+      },
+      prompt_used: prompt,
+    },
+  };
+}

package/src/agents/translator/translator.schema.ts

@@ -0,0 +1,30 @@
+/**
+ * Translator Agent Schema - Zod validation schemas
+ * Safe for both client and server
+ */
+
+import { z } from 'zod';
+
+export const TranslatorInputSchema = z.object({
+  text: z.string().min(1).max(10000),
+  source_language: z.string().regex(/^[a-z]{2}$/),
+  target_language: z.string().regex(/^[a-z]{2}$/),
+});
+
+export const TranslatorOutputSchema = z.object({
+  translated_text: z.string(),
+  metadata: z.object({
+    model_used: z.string(),
+    processing_time: z.number(),
+    confidence: z.number(),
+    supported_languages: z.array(z.string()),
+    requested_languages: z.object({
+      source: z.string(),
+      target: z.string(),
+    }),
+    prompt_used: z.string(),
+  }),
+});
+
+export type TranslatorInput = z.infer<typeof TranslatorInputSchema>;
+export type TranslatorOutput = z.infer<typeof TranslatorOutputSchema>;

package/src/agents/translator/translator.types.ts

@@ -0,0 +1,42 @@
+/**
+ * Translator Agent Types - Shared between client and server
+ */
+
+/**
+ * Parameters for translation
+ */
+export interface TranslationHandlerParams {
+  text: string;
+  source_language: string;
+  target_language: string;
+  promptTemplate?: string;
+}
+
+/**
+ * Result from translation
+ */
+export interface TranslationHandlerResult {
+  translated_text: string;
+  metadata: {
+    model_used: string;
+    processing_time: number;
+    confidence: number;
+    supported_languages: string[];
+    requested_languages: {
+      source: string;
+      target: string;
+    };
+    prompt_used: string;
+  };
+}
+
+/**
+ * Translator agent metadata
+ */
+export interface TranslatorMetadata {
+  id: 'translator';
+  name: string;
+  description: string;
+  category: 'translation';
+  route: '/agents/translator';
+}

package/src/agents/translator/translator.yaml

@@ -0,0 +1,80 @@
+# Translator Agent - Declarative Genkit-powered translation workflow
+# Route: /agents/translator
+# Method: translator.execute
+
+agent:
+  id: translator
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "Translator Agent"
+  description: "Translates text between languages using Gemini Flash via Genkit"
+  category: "translation"
+  route: "/agents/translator"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      text:
+        type: "string"
+        minLength: 1
+        maxLength: 10000
+        description: "Original text to be translated"
+      source_language:
+        type: "string"
+        pattern: "^[a-z]{2}$"
+        description: "Source language (ISO-639-1, e.g., pt, en)"
+      target_language:
+        type: "string"
+        pattern: "^[a-z]{2}$"
+        description: "Target language (ISO-639-1, e.g., en, es)"
+    required: ["text", "source_language", "target_language"]
+
+  output:
+    type: "object"
+    properties:
+      translated_text:
+        type: "string"
+      metadata:
+        type: "object"
+        properties:
+          model_used:
+            type: "string"
+          processing_time:
+            type: "number"
+          confidence:
+            type: "number"
+          supported_languages:
+            type: "array"
+            items:
+              type: "string"
+          requested_languages:
+            type: "object"
+            properties:
+              source:
+                type: "string"
+              target:
+                type: "string"
+            required: ["source", "target"]
+          prompt_used:
+            type: "string"
+        required:
+          [
+            "model_used",
+            "processing_time",
+            "confidence",
+            "supported_languages",
+            "requested_languages",
+            "prompt_used",
+          ]
+    required: ["translated_text", "metadata"]
+
+logic:
+  workflow:
+    - name: "translate"
+      type: "genkit-translation"
+      action:
+        type: "translate"
+        result: "translationResult"

package/src/client/index.ts

@@ -0,0 +1,53 @@
+/**
+ * Client Module - Safe exports for client-side usage
+ *
+ * This module exports only types and metadata that are safe for client-side usage.
+ * It does NOT export any handlers, runtime logic, or server-only code.
+ *
+ * IMPORTANT: Never import from '../agents' index as it includes server-only registry!
+ * Import directly from individual agent folders instead.
+ */
+
+// Re-export all shared types and utilities
+export * from '../shared';
+
+// Re-export client-specific types
+export * from './types';
+
+// Agent metadata exports (client-safe) - import directly from agent folders
+export { jokerMetadata } from '../agents/joker';
+export { translatorMetadata } from '../agents/translator';
+export { imageMetadata } from '../agents/image';
+export { mcpToolMetadata } from '../agents/mcp-tool';
+export { geminiVectorizeMetadata } from '../agents/gemini-vectorize';
+export { chromadbMetadata } from '../agents/chromadb';
+export { gitmcpMetadata } from '../agents/gitmcp';
+export { ragMetadata } from '../agents/rag';
+export { chatMetadata } from '../agents/chat';
+
+// Schema exports (client-safe - for validation)
+export { JokerInputSchema, JokerOutputSchema } from '../agents/joker';
+export { TranslatorInputSchema, TranslatorOutputSchema } from '../agents/translator';
+export { ImageInputSchema, ImageOutputSchema } from '../agents/image';
+export { McpToolInputSchema, McpToolOutputSchema } from '../agents/mcp-tool';
+export { GeminiVectorizeInputSchema, GeminiVectorizeOutputSchema } from '../agents/gemini-vectorize';
+export { ChromaDBInputSchema, ChromaDBOutputSchema } from '../agents/chromadb';
+export { GitMcpInputSchema, GitMcpOutputSchema } from '../agents/gitmcp';
+export { RagInputSchema, RagOutputSchema } from '../agents/rag';
+export { ChatInputSchema, ChatOutputSchema } from '../agents/chat';
+
+/**
+ * All agent metadata for UI display
+ * Defined here to avoid importing from agents/index.ts which includes server-only registry
+ */
+export const allAgentMetadata = [
+  { id: 'joker', name: 'Joker Agent', description: 'Tells jokes using Gemini Flash', category: 'utility', route: '/agents/joker' },
+  { id: 'translator', name: 'Translator Agent', description: 'Translates text between languages using Gemini Flash via Genkit', category: 'translation', route: '/agents/translator' },
+  { id: 'image', name: 'Image Generator Agent', description: 'Generates images using Gemini Flash with curated styles', category: 'creative', route: '/agents/image' },
+  { id: 'mcp-tool', name: 'MCP Tool Agent', description: 'Generic agent for calling MCP server tools via SSE transport', category: 'integration', route: '/agents/mcp-tool' },
+  { id: 'gemini-vectorize', name: 'Gemini Vectorize Agent', description: "Generates text embeddings using Google's Gemini text-embedding-004 model", category: 'ai-service', route: '/agents/gemini-vectorize' },
+  { id: 'chromadb', name: 'ChromaDB Agent', description: 'Vector storage and retrieval using ChromaDB. Supports local and cloud deployments.', category: 'database', route: '/agents/chromadb' },
+  { id: 'gitmcp', name: 'GitMCP Documentation Agent', description: 'Fetches and chunks GitHub repository documentation via gitmcp.io MCP servers', category: 'integration', route: '/agents/gitmcp' },
+  { id: 'rag', name: 'RAG Intelligence Agent', description: 'Generates natural language answers based on provided context using Gemini', category: 'intelligence', route: '/agents/rag' },
+  { id: 'chat', name: 'Q&A Context Chat Agent', description: 'Orchestrates RAG pipeline: vectorization, storage, retrieval and answer generation', category: 'chat', route: '/agents/chat' },
+] as const;

package/src/client/types.ts

@@ -0,0 +1,38 @@
+/**
+ * Client Types - Safe type re-exports for client-side usage
+ * These types contain no sensitive data or server-only logic
+ */
+
+// Re-export all shared types
+export type {
+  AgentMetadata,
+  AgentResponse,
+  ExecutionStep,
+  WorkflowStepType,
+  AgentCategory,
+} from '../shared/types/agent.types';
+
+export type {
+  ExecutionResult,
+  ExecutionStatus,
+  ExecutionSummary,
+  ExecutionLogEntry,
+} from '../shared/types/execution.types';
+
+export type {
+  SchemaProperty,
+  AgentSchemaDefinition,
+  ValidationResult,
+  ValidationError,
+} from '../shared/types/schema.types';
+
+// Agent-specific type exports (client-safe)
+export type { JokerInput, JokerOutput, JokeHandlerParams, JokeHandlerResult } from '../agents/joker';
+export type { TranslatorInput, TranslatorOutput, TranslationHandlerParams, TranslationHandlerResult } from '../agents/translator';
+export type { ImageInput, ImageOutput, ImageStyle, ImageHandlerParams, ImageHandlerResult } from '../agents/image';
+export type { McpToolInput, McpToolOutput, McpToolHandlerParams, McpToolHandlerResult } from '../agents/mcp-tool';
+export type { GeminiVectorizeInput, GeminiVectorizeOutput, VectorizeHandlerParams, VectorizeHandlerResult } from '../agents/gemini-vectorize';
+export type { ChromaDBInput, ChromaDBOutput, ChromaDBHandlerParams, ChromaDBHandlerResult, ChromaDBSearchResult } from '../agents/chromadb';
+export type { GitMcpInput, GitMcpOutput, GitMcpHandlerParams, GitMcpHandlerResult } from '../agents/gitmcp';
+export type { RagInput, RagOutput, RagHandlerParams, RagHandlerResult, ConversationMessage } from '../agents/rag';
+export type { ChatInput, ChatOutput, ChatHandlerParams, ChatHandlerResult } from '../agents/chat';

package/src/index.ts

@@ -51,8 +51,8 @@ export {
 } from "./runtime/schemaCompiler";
 
 // Agent registry exports
-export { AgentRegistry, agentRegistry } from "./agents/agentRegistry";
-export type { AgentRegistration } from "./agents/agentRegistry";
+export { AgentRegistry, agentRegistry } from "./agents/registry";
+export type { AgentRegistration } from "./agents/registry";
 
 // Configuration exports
 export {
@@ -102,12 +102,35 @@ export { AuditService } from "./runtime/audit";
 export { PerformanceMonitor } from "./performance/monitor";
 export { default as AutoScaler } from "./performance/autoscaling";
 
-// Multi-Tenant Firebase exports
-export { MultiTenantFirebaseManager } from "./firebase/tenantManager";
+// Agnostic Multi-Tenant exports
+export {
+  TenantManager,
+  ProviderRegistry,
+  createProvider,
+  isValidProviderType,
+  isBuiltInProviderType,
+  getSupportedProviders,
+  getBuiltInProviders,
+  InMemoryTenantProvider,
+  TenantError,
+  ValidationError,
+  NotFoundError,
+  NotSupportedError,
+  TenantAlreadyExistsError,
+} from "./tenant";
 export type {
   TenantConfig,
   TenantIsolationResult,
-} from "./firebase/tenantManager";
+  ProviderType,
+  BuiltInProviderType,
+  FirebaseProviderConfig,
+  MemoryProviderConfig,
+  ITenantProvider,
+  ITenantApp,
+  ITenantDatabase,
+  ITenantCollection,
+  ITenantDocument,
+} from "./tenant";
 
 // Compliance exports
 export { GDPRCompliance } from "./compliance/gdprEngine";
@@ -121,5 +144,25 @@ export { SecureYamlRuntime } from "./integration/secure-yaml-runtime";
 // Shared types
 export type { ExecutionContext } from "./types/executionContext";
 
+// Shared agent types (client-safe)
+export type {
+  AgentMetadata,
+  AgentResponse,
+  ExecutionStep,
+  WorkflowStepType,
+  AgentCategory,
+} from "./shared/types/agent.types";
+
+// Chat agent exports (client-safe)
+export type {
+  ChatHandlerParams,
+  ChatHandlerResult,
+  ChatMetadata,
+} from "./agents/chat/chat.types";
+export { chatMetadata } from "./agents/chat";
+
+// RAG types (client-safe)
+export type { ConversationMessage } from "./agents/rag/rag.types";
+
 // Server/runtime exports
 export * as Server from "./server";