beddel 0.2.3 → 1.0.0

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

@@ -1,99 +0,0 @@
-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

@@ -1,30 +0,0 @@
-/**
- * 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

@@ -1,42 +0,0 @@
-/**
- * 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

@@ -1,80 +0,0 @@
-# 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/audit/auditTrail.ts

@@ -1,134 +0,0 @@
-/**
- * Audit Trail Service - SHA-256 Hash Tracking
- * Logs operations com hash criptográfico para auditoria completa
- */
-
-export interface AuditLog {
-  operationId: string;
-  tenantId: string;
-  operation: string;
-  data: any;
-  timestamp: Date;
-  success?: boolean;
-}
-
-export interface AuditTrailEntry {
-  operationId: string;
-  tenantId: string;
-  operation: string;
-  hash: string;
-  timestamp: Date;
-  dataHash: string;
-  success: boolean;
-}
-
-export class AuditTrail {
-  private logs: AuditTrailEntry[] = [];
-  private readonly MAX_LOGS = 10000;
-
-  constructor() {
-    this.logs = [];
-  }
-
-  /**
-   * Log operation with SHA-256 hash
-   */
-  public async logOperation(auditLog: AuditLog): Promise<string> {
-    const {
-      operationId,
-      tenantId,
-      operation,
-      data,
-      timestamp,
-      success = true,
-    } = auditLog;
-
-    // Generate hash for audit trail
-    const dataString = JSON.stringify(data);
-    const hash = this.generateSHA256(
-      `${operationId}-${tenantId}-${operation}-${dataString}-${timestamp.toISOString()}`
-    );
-    const dataHash = this.generateSHA256(dataString);
-
-    const entry: AuditTrailEntry = {
-      operationId,
-      tenantId,
-      operation,
-      hash,
-      timestamp,
-      dataHash,
-      success,
-    };
-
-    // Store log
-    this.logs.push(entry);
-
-    // Maintain log size limit
-    if (this.logs.length > this.MAX_LOGS) {
-      this.logs = this.logs.slice(-this.MAX_LOGS);
-    }
-
-    return hash;
-  }
-
-  /**
-   * Generate SHA-256 hash
-   */
-  private generateSHA256(input: string): string {
-    // In a real implementation, would use crypto module
-    // For now, simulate SHA-256 hash
-    return (
-      "SHA256-" +
-      input
-        .split("")
-        .reduce((hash, char) => {
-          const charCode = char.charCodeAt(0);
-          return ((hash << 5) - hash + charCode) & 0xffffffff;
-        }, 0)
-        .toString(16)
-    );
-  }
-
-  /**
-   * Get all audit logs
-   */
-  public getAllLogs(): AuditTrailEntry[] {
-    return [...this.logs];
-  }
-
-  /**
-   * Get logs for specific tenant
-   */
-  public getTenantLogs(tenantId: string): AuditTrailEntry[] {
-    return this.logs.filter((log) => log.tenantId === tenantId);
-  }
-
-  /**
-   * Get logs for specific operation
-   */
-  public getOperationLogs(operation: string): AuditTrailEntry[] {
-    return this.logs.filter((log) => log.operation === operation);
-  }
-
-  /**
-   * Verify audit trail integrity
-   */
-  public verifyIntegrity(): boolean {
-    for (const log of this.logs) {
-      const reconstructedHash = this.generateSHA256(
-        `${log.operationId}-${log.tenantId}-${log.operation}-${log.dataHash}-`
-      );
-      if (reconstructedHash !== log.hash) {
-        return false;
-      }
-    }
-    return true;
-  }
-
-  /**
-   * Clear audit logs
-   */
-  public clearLogs(): void {
-    this.logs = [];
-  }
-}

package/src/client/index.ts

@@ -1,53 +0,0 @@
-/**
- * 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

@@ -1,38 +0,0 @@
-/**
- * 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/compliance/gdprEngine.ts

@@ -1,209 +0,0 @@
-/**
- * GDPR Compliance Engine v2025
- * European data protection compliance automático
- * Enhanced with SHA-256 audit trail integration
- */
-
-import { AuditTrail } from "../audit/auditTrail";
-
-export interface GDPRConfig {
-  tenantId: string;
-  dataAnonymization: boolean;
-  consentManagement: boolean;
-  rightToBeForgotten: boolean;
-  dataPortability: boolean;
-  dataRetentionDays: number;
-}
-
-export interface GDPRComplianceResult {
-  compliant: boolean;
-  violations: string[];
-  recommendations: string[];
-}
-
-export class GDPRCompliance {
-  private auditTrail: AuditTrail;
-
-  constructor(auditTrail?: AuditTrail) {
-    this.auditTrail = auditTrail || new AuditTrail();
-  }
-
-  /**
-   * Verify GDPR compliance for tenant
-   */
-  public async verifyCompliance(config: GDPRConfig): Promise<boolean> {
-    const result = await this.checkCompliance(config);
-    return result.compliant;
-  }
-
-  /**
-   * Check full GDPR compliance with audit trail
-   */
-  private async checkCompliance(
-    config: GDPRConfig
-  ): Promise<GDPRComplianceResult> {
-    const violations: string[] = [];
-    const recommendations: string[] = [];
-    const operationId = `gdpr-check-${config.tenantId}-${Date.now()}`;
-
-    try {
-      // Check data anonymization
-      if (!config.dataAnonymization) {
-        violations.push("Data anonymization not enabled");
-      } else {
-        recommendations.push("Ensure anonymization algorithms are strong");
-      }
-
-      // Check consent management
-      if (!config.consentManagement) {
-        violations.push("Consent management system not implemented");
-      } else {
-        recommendations.push("Implement granular consent controls");
-      }
-
-      // Check right to be forgotten
-      if (!config.rightToBeForgotten) {
-        violations.push("Right to be forgotten not implemented");
-      } else {
-        recommendations.push("Ensure data deletion within 30 days");
-      }
-
-      // Check data portability
-      if (!config.dataPortability) {
-        violations.push("Data portability not enabled");
-      } else {
-        recommendations.push("Support JSON and XML export formats");
-      }
-
-      // Check data retention
-      if (config.dataRetentionDays > 2555) {
-        // 7 years max
-        violations.push("Data retention exceeds GDPR limits");
-      } else if (config.dataRetentionDays > 730) {
-        // 2 years
-        recommendations.push("Consider reducing retention period");
-      }
-
-      // Log compliance check to audit trail
-      const auditHash = await this.auditTrail.logOperation({
-        operationId,
-        tenantId: config.tenantId,
-        operation: "gdpr_compliance_check",
-        data: {
-          compliant: violations.length === 0,
-          violationsCount: violations.length,
-          retentionDays: config.dataRetentionDays,
-        },
-        timestamp: new Date(),
-      });
-
-      const compliant = violations.length === 0;
-
-      return {
-        compliant,
-        violations,
-        recommendations,
-      };
-    } catch (error) {
-      await this.auditTrail.logOperation({
-        operationId,
-        tenantId: config.tenantId,
-        operation: "gdpr_compliance_error",
-        data: {
-          error: error instanceof Error ? error.message : String(error),
-        },
-        timestamp: new Date(),
-        success: false,
-      });
-      throw error;
-    }
-  }
-
-  /**
-   * Anonymize personal data
-   */
-  public anonymizeData(data: any): any {
-    if (typeof data !== "object" || data === null) {
-      return data;
-    }
-
-    const anonymized = { ...data };
-
-    // Anonymize common personal data fields
-    const personalFields = [
-      "name",
-      "email",
-      "phone",
-      "cpf",
-      "rg",
-      "passport",
-      "address",
-      "birthdate",
-      "nationality",
-      "photo",
-      "signature",
-      "voice",
-    ];
-
-    for (const field of personalFields) {
-      if (anonymized[field]) {
-        anonymized[field] = this.hashSensitiveData(anonymized[field]);
-      }
-    }
-
-    return anonymized;
-  }
-
-  /**
-   * Hash sensitive data using SHA-256 for GDPR compliance
-   */
-  private hashSensitiveData(data: any): string {
-    if (typeof data === "string") {
-      // Use SHA-256 hash (simulated for now - in production use crypto.createHash)
-      const crypto = require("crypto");
-      return crypto.createHash("sha256").update(data).digest("hex");
-    }
-    return "GDPR_HASH_COMPLEX_" + this.hashSensitiveData(JSON.stringify(data));
-  }
-
-  /**
-   * Generate data portability export with SHA-256 checksum
-   */
-  public async generateDataExport(tenantId: string): Promise<any> {
-    const exportData = {
-      tenantId,
-      exportDate: new Date().toISOString(),
-      format: "JSON",
-      data: {
-        profile: "user_data_exported",
-        preferences: "export_data_placeholder",
-        activities: "user_activities_exported",
-      },
-      gdprVersion: "2025.1",
-    };
-
-    // Generate SHA-256 checksum for data integrity
-    const crypto = require("crypto");
-    const checksum = crypto
-      .createHash("sha256")
-      .update(JSON.stringify(exportData))
-      .digest("hex");
-
-    const result = {
-      ...exportData,
-      checksum,
-    };
-
-    // Log export operation to audit trail
-    const operationId = `gdpr-export-${tenantId}-${Date.now()}`;
-    await this.auditTrail.logOperation({
-      operationId,
-      tenantId,
-      operation: "gdpr_data_export",
-      data: { checksum, exportDate: result.exportDate },
-      timestamp: new Date(),
-    });
-
-    return result;
-  }
-}