beddel 0.1.0

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,IAAI,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAEjG,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/server/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Shared server-side types for the Opal Support App runtime.
+ * These live inside the Beddel package so both the Next.js app and
+ * the npm distribution reference exactly the same contracts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

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

package/dist/types/executionContext.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Project-agnostic execution context contract for declarative runtimes.
+ * Mirrors the shape used inside the Opal Support App but stays self-contained
+ * so the npm package does not depend on repository-local files.
+ */
+export interface ExecutionContext {
+    logs: string[];
+    status: "running" | "success" | "error";
+    output: unknown;
+    error?: string;
+    log: (message: string) => void;
+    setOutput: (output: unknown) => void;
+    setError: (error: string) => void;
+}
+export default ExecutionContext;
+//# sourceMappingURL=executionContext.d.ts.map

package/dist/types/executionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionContext.d.ts","sourceRoot":"","sources":["../../src/types/executionContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/types/executionContext.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=executionContext.js.map

package/dist/types/executionContext.js.map

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

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "beddel",
+  "version": "0.1.0",
+  "description": "Beddel - A secure YAML parser and OpenAPI endpoint manager for Node.js applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "tools"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
+    },
+    "./server/*": {
+      "types": "./dist/server/*.d.ts",
+      "default": "./dist/server/*.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix"
+  },
+  "keywords": [
+    "yaml",
+    "parser",
+    "openapi",
+    "endpoint",
+    "manager",
+    "secure",
+    "nodejs"
+  ],
+  "author": "Beddel Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/botanarede/beddel-alpha.git"
+  },
+  "bugs": {
+    "url": "https://github.com/botanarede/beddel-alpha/issues"
+  },
+  "homepage": "https://github.com/botanarede/beddel-alpha#readme",
+  "dependencies": {
+    "@ai-sdk/google": "^2.0.23",
+    "@upstash/redis": "^1.34.3",
+    "ai": "^5.0.70",
+    "firebase-admin": "12.7.0",
+    "isolated-vm": "5.0.1",
+    "js-yaml": "^4.1.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/jest": "^29.5.12",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/agents/agentRegistry.ts

@@ -0,0 +1,272 @@
+/**
+ * Agent Registry Service
+ * Manages registration and execution of declarative YAML agents
+ */
+
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { declarativeInterpreter } from "../runtime/declarativeAgentRuntime";
+import { ExecutionContext } from "../types/executionContext";
+
+export interface AgentRegistration {
+  id: string;
+  name: string;
+  description: string;
+  protocol: string;
+  route: string;
+  requiredProps: string[];
+  yamlContent: string;
+}
+
+/**
+ * Agent Registry - Manages declarative agent registration and execution
+ */
+export class AgentRegistry {
+  private readonly agents: Map<string, AgentRegistration> = new Map();
+
+  constructor() {
+    // Register built-in agents on initialization
+    this.registerBuiltinAgents();
+  }
+
+  /**
+   * Register an agent
+   */
+  public registerAgent(agent: AgentRegistration): void {
+    // Validate agent
+    this.validateAgent(agent);
+
+    // Register the agent
+    this.agents.set(agent.name, agent);
+    console.log(`Agent registered: ${agent.name} (${agent.protocol})`);
+  }
+
+  /**
+   * Execute registered agent
+   */
+  public async executeAgent(
+    agentName: string,
+    input: Record<string, any>,
+    props: Record<string, string>,
+    context: ExecutionContext
+  ): Promise<any> {
+    // Find agent
+    const agent = this.agents.get(agentName);
+    if (!agent) {
+      throw new Error(`Agent not found: ${agentName}`);
+    }
+
+    // Execute using declarative interpreter
+    const result = await declarativeInterpreter.interpret({
+      yamlContent: agent.yamlContent,
+      input,
+      props,
+      context,
+    });
+
+    return result;
+  }
+
+  /**
+   * Get registered agent
+   */
+  public getAgent(agentName: string): AgentRegistration | undefined {
+    return this.agents.get(agentName);
+  }
+
+  /**
+   * Get all registered agents
+   */
+  public getAllAgents(): AgentRegistration[] {
+    return Array.from(this.agents.values());
+  }
+
+  /**
+   * Register built-in agents
+   */
+  private registerBuiltinAgents(): void {
+    try {
+      // Register Joker Agent
+      this.registerJokerAgent();
+      // Register Translator Agent
+      this.registerTranslatorAgent();
+      // Register Image Generator Agent
+      this.registerImageAgent();
+    } catch (error) {
+      console.error("Failed to register built-in agents:", error);
+    }
+  }
+
+  /**
+   * Register Joker Agent
+   */
+  private registerJokerAgent(): void {
+    try {
+      // Get the Joker Agent YAML content
+      const jokerYamlPath = this.resolveAgentPath("joker-agent.yaml");
+      const yamlContent = readFileSync(jokerYamlPath, "utf-8");
+
+      // Parse YAML to extract metadata
+      const agent = this.parseAgentYaml(yamlContent);
+
+      this.registerAgent({
+        id: agent.agent.id,
+        name: "joker.execute",
+        description: agent.metadata.description,
+        protocol: agent.agent.protocol,
+        route: agent.metadata.route || "/agents/joker",
+        requiredProps: ["gemini_api_key"],
+        yamlContent,
+      });
+    } catch (error) {
+      console.error("Failed to register Joker Agent:", error);
+      throw error;
+    }
+  }
+
+  /**
+   * Register Translator Agent
+   */
+  private registerTranslatorAgent(): void {
+    try {
+      const translatorYamlPath = this.resolveAgentPath("translator-agent.yaml");
+      const yamlContent = readFileSync(translatorYamlPath, "utf-8");
+      const agent = this.parseAgentYaml(yamlContent);
+
+      this.registerAgent({
+        id: agent.agent.id,
+        name: "translator.execute",
+        description: agent.metadata.description,
+        protocol: agent.agent.protocol,
+        route: agent.metadata.route || "/agents/translator",
+        requiredProps: ["gemini_api_key"],
+        yamlContent,
+      });
+    } catch (error) {
+      console.error("Failed to register Translator Agent:", error);
+      throw error;
+    }
+  }
+
+  /**
+   * Register Image Generator Agent
+   */
+  private registerImageAgent(): void {
+    try {
+      const imageYamlPath = this.resolveAgentPath("image-agent.yaml");
+      const yamlContent = readFileSync(imageYamlPath, "utf-8");
+      const agent = this.parseAgentYaml(yamlContent);
+
+      this.registerAgent({
+        id: agent.agent.id,
+        name: "image.generate",
+        description: agent.metadata.description,
+        protocol: agent.agent.protocol,
+        route: agent.metadata.route || "/agents/image",
+        requiredProps: ["gemini_api_key"],
+        yamlContent,
+      });
+    } catch (error) {
+      console.error("Failed to register Image Agent:", error);
+      throw error;
+    }
+  }
+
+  /**
+   * Parse agent YAML content
+   */
+  private parseAgentYaml(yamlContent: string): any {
+    // Simple validation - full parsing will be done by interpreter
+    if (!yamlContent.includes("agent:") || !yamlContent.includes("logic:")) {
+      throw new Error("Invalid agent YAML: missing required sections");
+    }
+
+    // Basic YAML parsing for metadata extraction
+    const lines = yamlContent.split("\n");
+    const metadata: any = {
+      agent: { id: "", protocol: "" },
+      metadata: { description: "", route: "" },
+      schema: { required: [] },
+    };
+
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i].trim();
+
+      if (line.startsWith("id:") && metadata.agent.id === "") {
+        metadata.agent.id = line.split(":")[1].trim();
+      }
+
+      if (line.startsWith("protocol:") && metadata.agent.protocol === "") {
+        metadata.agent.protocol = line.split(":")[1].trim();
+      }
+
+      if (
+        line.startsWith("description:") &&
+        metadata.metadata.description === ""
+      ) {
+        metadata.metadata.description = line
+          .substring(line.indexOf(":") + 1)
+          .trim();
+      }
+
+      if (line.startsWith("route:") && metadata.metadata.route === "") {
+        metadata.metadata.route = line.split(":")[1].trim();
+      }
+
+      if (
+        line.startsWith("required:") &&
+        metadata.schema.required.length === 0
+      ) {
+        // Parse required array
+        const requiredStr = line.substring(line.indexOf(":") + 1).trim();
+        metadata.schema.required = JSON.parse(requiredStr);
+      }
+    }
+
+    return metadata;
+  }
+
+  /**
+   * Validate agent registration
+   */
+  private validateAgent(agent: AgentRegistration): void {
+    if (!agent.id || !agent.name || !agent.protocol) {
+      throw new Error("Invalid agent: missing required fields");
+    }
+
+    if (!agent.yamlContent || agent.yamlContent.length === 0) {
+      throw new Error("Invalid agent: missing YAML content");
+    }
+
+    if (!agent.protocol.startsWith("beddel-declarative-protocol")) {
+      throw new Error(`Unsupported protocol: ${agent.protocol}`);
+    }
+  }
+
+  /**
+   * Resolve agent asset path when running in bundled runtimes
+   */
+  private resolveAgentPath(filename: string): string {
+    const candidatePaths = [
+      join(__dirname, filename),
+      join(process.cwd(), "packages", "beddel", "src", "agents", filename),
+    ];
+
+    for (const path of candidatePaths) {
+      if (existsSync(path)) {
+        return path;
+      }
+    }
+
+    throw new Error(
+      `Unable to locate agent asset '${filename}' in paths: ${candidatePaths.join(
+        ", "
+      )}`
+    );
+  }
+}
+
+// Singleton instance
+export const agentRegistry = new AgentRegistry();
+
+export default AgentRegistry;

package/src/agents/image-agent.yaml

@@ -0,0 +1,86 @@
+# Image Generator Agent - Declarative Genkit workflow
+# Route: /agents/image
+# Method: image.generate
+
+agent:
+  id: image
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "Image Generator Agent"
+  description: "Gera imagens usando Gemini Flash com estilos curados"
+  category: "creative"
+  route: "/agents/image"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      descricao:
+        type: "string"
+        minLength: 5
+        maxLength: 500
+        description: "Descrição textual detalhada da cena"
+      estilo:
+        type: "string"
+        enum: ["watercolor", "neon", "sketch"]
+        description: "Estilo visual desejado"
+      resolucao:
+        type: "string"
+        pattern: "^[0-9]{3,4}x[0-9]{3,4}$"
+        description: "Resolução no formato LARGURAxALTURA (ex: 1024x1024)"
+    required: ["descricao", "estilo", "resolucao"]
+
+  output:
+    type: "object"
+    properties:
+      image_url:
+        type: "string"
+      image_base64:
+        type: "string"
+      media_type:
+        type: "string"
+      prompt_utilizado:
+        type: "string"
+      metadados:
+        type: "object"
+        properties:
+          modelo_utilizado:
+            type: "string"
+          tempo_processamento:
+            type: "number"
+          estilo:
+            type: "string"
+          resolucao:
+            type: "string"
+        required: ["modelo_utilizado", "tempo_processamento", "estilo", "resolucao"]
+    required: ["image_url", "prompt_utilizado", "metadados"]
+
+logic:
+  workflow:
+    - name: "generate-image"
+      type: "genkit-image"
+      action:
+        type: "image"
+        result: "imageResult"
+        promptTemplate: "Crie uma imagem em estilo {{estilo}} com foco em: {{descricao}}"
+
+    - name: "deliver-image"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          image_url: "$imageResult.image_url"
+          image_base64: "$imageResult.image_base64"
+          media_type: "$imageResult.media_type"
+          prompt_utilizado: "$imageResult.prompt_utilizado"
+          metadados: "$imageResult.metadados"
+
+output:
+  schema:
+    image_url: "$imageResult.image_url"
+    image_base64: "$imageResult.image_base64"
+    media_type: "$imageResult.media_type"
+    prompt_utilizado: "$imageResult.prompt_utilizado"
+    metadados: "$imageResult.metadados"

package/src/agents/joker-agent.yaml

@@ -0,0 +1,47 @@
+# Joker Agent - Simple Response Agent for Beddel Runtime
+# Route: /agents/joker
+# Method: joker.execute
+
+agent:
+  id: joker
+  version: 1.0.0
+  protocol: beddel-declarative-protocol/v2.0
+
+metadata:
+  name: "Joker Agent"
+  description: "Conta piadas usando Gemini Flash"
+  category: "utility"
+  route: "/agents/joker"
+
+schema:
+  input:
+    type: "object"
+    properties: {}
+    required: []
+
+  output:
+    type: "object"
+    properties:
+      response:
+        type: "string"
+    required: ["response"]
+
+logic:
+  workflow:
+    - name: "generate-joke"
+      type: "genkit-joke"
+      action:
+        type: "joke"
+        prompt: "Conte uma piada curta e original que funcione para qualquer público."
+        result: "jokerResult"
+
+    - name: "deliver-response"
+      type: "output-generator"
+      action:
+        type: "generate"
+        output:
+          response: "$jokerResult.texto"
+
+output:
+  schema:
+    response: "$jokerResult.texto"

package/src/agents/translator-agent.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: "Traduz textos entre idiomas usando Gemini Flash via Genkit"
+  category: "public"
+  route: "/agents/translator"
+
+schema:
+  input:
+    type: "object"
+    properties:
+      texto:
+        type: "string"
+        minLength: 1
+        maxLength: 10000
+        description: "Texto original a ser traduzido"
+      idioma_origem:
+        type: "string"
+        pattern: "^[a-z]{2}$"
+        description: "Idioma de origem (ISO-639-1, ex: pt, en)"
+      idioma_destino:
+        type: "string"
+        pattern: "^[a-z]{2}$"
+        description: "Idioma de destino (ISO-639-1, ex: en, es)"
+    required: ["texto", "idioma_origem", "idioma_destino"]
+
+  output:
+    type: "object"
+    properties:
+      texto_traduzido:
+        type: "string"
+      metadados:
+        type: "object"
+        properties:
+          modelo_utilizado:
+            type: "string"
+          tempo_processamento:
+            type: "number"
+          confianca:
+            type: "number"
+          idiomas_suportados:
+            type: "array"
+            items:
+              type: "string"
+          idiomas_solicitados:
+            type: "object"
+            properties:
+              origem:
+                type: "string"
+              destino:
+                type: "string"
+            required: ["origem", "destino"]
+          prompt_utilizado:
+            type: "string"
+        required:
+          [
+            "modelo_utilizado",
+            "tempo_processamento",
+            "confianca",
+            "idiomas_suportados",
+            "idiomas_solicitados",
+            "prompt_utilizado",
+          ]
+    required: ["texto_traduzido", "metadados"]
+
+logic:
+  workflow:
+    - name: "translate"
+      type: "genkit-translation"
+      action:
+        type: "translate"
+        result: "translationResult"