beddel 0.1.0

package/README.md

@@ -0,0 +1,297 @@
+# Beddel: Secure, Declarative, and Extensible Agent Runtimes
+
+[![NPM Version](https://img.shields.io/npm/v/beddel.svg)](https://www.npmjs.com/package/beddel)
+[![License](https://img.shields.io/npm/l/beddel.svg)](https://github.com/botanarede/beddel-alpha/blob/main/LICENSE)
+
+**Repos:** código-fonte em `https://github.com/botanarede/beddel-alpha` e app de exemplo Next.js em `https://github.com/botanarede/beddel-alpha-example`.
+
+## Usage Exemplo
+
+> Declaração YAML + interpretação segura para que quem visita o perfil do pacote no npm entenda o fluxo em poucos segundos.
+
+```yaml
+# joker-agent.yaml
+agent:
+  id: joker
+  protocol: beddel-declarative-protocol/v2.0
+metadata:
+  name: Joker Agent
+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"
+```
+
+```typescript
+import {
+  SecureYamlParser,
+  DeclarativeAgentInterpreter,
+  SecureYamlRuntime,
+  IsolatedRuntimeManager,
+  type ExecutionContext,
+} from "beddel";
+import { readFileSync } from "node:fs";
+
+const yamlManifest = readFileSync("joker-agent.yaml", "utf8");
+
+const parser = new SecureYamlParser({ filename: "joker-agent.yaml" });
+const manifest = parser.parseSecure(yamlManifest); // FAILSAFE_SCHEMA + depth/size limits
+
+const context: ExecutionContext = {
+  logs: [],
+  status: "running",
+  output: null,
+  log: console.log,
+  setOutput: (output) => (context.output = output),
+  setError: (err) => console.error(err),
+};
+
+const interpreter = new DeclarativeAgentInterpreter();
+const agentResult = await interpreter.interpret({
+  yamlContent: yamlManifest,
+  input: {},
+  props: {
+    gemini_api_key: process.env.GEMINI_API_KEY ?? "",
+  },
+  context,
+});
+
+const secureRuntime = new SecureYamlRuntime(new IsolatedRuntimeManager());
+const execution = await secureRuntime.parseYamlSecureRuntime(yamlManifest, {
+  tenantId: "tenant-42",
+  securityProfile: "tenant-isolated",
+  validateSecurity: true,
+});
+```
+
+- `SecureYamlParser` garante o parsing estritamente FAILSAFE com validação de profundidade, tamanho e UTF-8.
+- `DeclarativeAgentInterpreter` executa apenas steps declarativos (`output-generator`, `genkit-joke`, `genkit-translation`, `genkit-image`) e mantém toda a validação em Zod (sem `eval`/`Function`).
+- `SecureYamlRuntime` conecta parser, scanner e `isolated-vm` para entregar auditoria, limites de tempo/memória e perfis multi-tenant.
+
+Beddel is a security-first toolkit that combines:
+
+- A hardened YAML parser that only exposes the YAML FAILSAFE schema.
+- Multiple execution strategies powered by `isolated-vm`.
+- Declarative agent utilities, compliance helpers, performance monitors, and Firebase multi-tenant orchestration.
+
+### Declarative agents shipped with Gemini Flash helpers
+
+The declarative runtime now exposes three Genkit-based helpers—`callGeminiFlashText`, `callGeminiFlashTranslation`, and `callGeminiFlashImage`—which proxy `generateText`/`generateImage` calls to `google("models/gemini-flash-latest")`. Each helper validates the presence of `props.gemini_api_key`, builds friendly prompts, and returns consistent metadata (`modelo_utilizado`, `tempo_processamento`, etc.).
+
+| Agent | Method | Description | Inputs | Outputs | Required props |
+| --- | --- | --- | --- | --- | --- |
+| Joker Agent | `joker.execute` | Gera uma piada curta e original usando Gemini Flash. | — | `response` | `gemini_api_key` |
+| Translator Agent | `translator.execute` | Traduz textos via Gemini Flash com Genkit. | `texto`, `idioma_origem`, `idioma_destino` | `texto_traduzido`, `metadados` | `gemini_api_key` |
+| Image Generator Agent | `image.generate` | Cria imagens nos estilos `watercolor`, `neon` ou `sketch`. | `descricao`, `estilo`, `resolucao` | `image_url`, `image_base64`, `media_type`, `prompt_utilizado`, `metadados` | `gemini_api_key` |
+
+> ⚠️ Todos os agentes embutidos dependem da prop `gemini_api_key`. Sem ela o runtime aborta a execução com uma mensagem amigável.
+
+The code that backs this README lives under `packages/beddel/src` and is what the npm package exposes.
+
+## Package map
+
+| Capability | Entry point / module | Notes |
+| --- | --- | --- |
+| Secure YAML parsing | `SecureYamlParser` (`src/parser/secure-yaml-parser.ts`) | FAILSAFE schema, depth/size limits, UTF-8 validation, sync + async helpers. |
+| Sandboxed execution | `IsolatedRuntimeManager`, `SimpleIsolatedRuntimeManager` (`src/runtime`) | Uses `isolated-vm` with configurable security profiles, pool management, metrics. |
+| Declarative YAML interpretation | `DeclarativeAgentInterpreter`, `AgentRegistry` (`src/runtime/declarativeAgentRuntime.ts`, `src/agents/agentRegistry.ts`) | Executes YAML agents with variables plus `output-generator`, `genkit-joke`, `genkit-translation` e `genkit-image` steps (Gemini Flash). |
+| Security posture | `SecurityScanner`, `ThreatDetectionEngine`, validation utilities (`src/security`) | Static scanning, scoring, and threat inference the rest of the package consumes. |
+| Compliance & audit | `GDPRCompliance`, `LGPDCompliance`, `AuditTrail`, `AuditService` (`src/compliance`, `src/audit`, `src/runtime/audit.ts`) | Hash-based logging, anonymization helpers, compliance verification. |
+| Performance & autoscaling | `PerformanceMonitor`, `AutoScaler`, benchmarking helpers (`src/performance`) | Track execution time/memory, raise violations, recommend scaling actions. |
+| Firebase multi-tenancy | `MultiTenantFirebaseManager` (`src/firebase/tenantManager.ts`) | Per-tenant app bootstrap, isolation policies, audit logging hooks. |
+
+Everything is re-exported via `src/index.ts`, so you can import from `beddel` directly.
+
+## Installation
+
+```bash
+npm install beddel
+```
+
+Ensure Node.js 18+ (per `package.json`) and install optional peer dependencies you plan to use (e.g., `firebase-admin` is already included).
+
+## Project-agnostic guarantees
+
+- No upstream app files are required—the npm tarball only ships `dist/` and the audited TypeScript sources exported through `beddel`.
+- `ExecutionContext` and every runtime type live inside the package, de-coupling consumers from any upstream monorepo or example app internals.
+- No secrets, API tokens, or environment-specific constants are embedded in the code or build output; everything is configured via your own runtime props.
+- Optional tools (Firebase, Upstash, benchmarking scripts) are defensive helpers; you decide which ones to instantiate depending on project size.
+
+## Usage examples
+
+### Parse YAML with strict fail-safes
+
+```typescript
+import { SecureYamlParser } from "beddel";
+
+const parser = new SecureYamlParser({
+  maxDepth: 200,
+  filename: "agent-manifest",
+});
+
+const manifest = parser.parseSecure(`
+agent:
+  id: joker
+schema:
+  input: {}
+  output: {}
+logic:
+  workflow:
+    - name: noop
+      type: output-generator
+      action:
+        type: generate
+        output:
+          response: "lol"
+`);
+
+console.log(manifest.agent.id); // joker
+```
+
+Behind the scenes, `SecureYamlParser` enforces depth, size, UTF-8, and allowed primitive types before returning the parsed object.
+
+### Execute JavaScript in an isolate
+
+```typescript
+import { IsolatedRuntimeManager } from "beddel";
+
+const runtimeManager = new IsolatedRuntimeManager();
+
+const result = await runtimeManager.execute({
+  code: `
+    const secret = "sandboxed";
+    ({ success: true, value: secret.length });
+  `,
+  securityProfile: "ultra-secure",
+  timeout: 2000,
+});
+
+if (!result.success) {
+  throw result.error;
+}
+
+console.log(result.result); // { success: true, value: 9 }
+```
+
+The manager bootstraps `isolated-vm` contexts, strips dangerous globals (`require`, `eval`, timers), enforces memory/time limits, records metrics, and can emit audit/security signals.
+
+### Interpret a declarative YAML agent
+
+```typescript
+import { DeclarativeAgentInterpreter } from "beddel";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+const interpreter = new DeclarativeAgentInterpreter();
+const yamlContent = readFileSync(join(process.cwd(), "joker-agent.yaml"), "utf8");
+
+const result = await interpreter.interpret({
+  yamlContent,
+  input: {},
+  props: {},
+  context: {
+    log: console.log,
+    setError: console.error,
+  },
+});
+
+console.log(result.response); // lol
+```
+
+Current interpreter capabilities:
+
+- Validates protocol (`beddel-declarative-protocol/v2.0`), schema presence, workflow size.
+- Supports string/number/boolean/object variables and literal/variable references.
+- Executes `output-generator` workflow steps that map variables to response objects.
+
+For projects that want auto-registration, instantiate `AgentRegistry` (bundled with the `joker` agent) and call `executeAgent("joker.execute", …)`.
+
+### Automatic schema validation
+
+Every declarative agent must now declare `schema.input` and `schema.output` blocks that map directly to Zod primitives (`string`, `number`, `boolean`), objects (with `properties` + `required` arrays), and arrays (via `items`). The runtime compiles those YAML definitions into Zod schemas through the `DeclarativeSchemaCompiler`, caches the result per manifest, and runs validation twice per execution:
+
+- **Before workflow execution** – payloads that are missing required fields, contain unexpected properties (objects are `strict` by default), or provide the wrong primitive types raise a `DeclarativeSchemaValidationError` and call `ExecutionContext.setError`.
+- **Before returning output** – the workflow result must match `schema.output`; mismatches are rejected, the error propagates through the same structured exception, and oversize payloads (>1 MB) are blocked.
+
+Authors can opt into arrays by adding `type: "array"` + an `items` definition, mark optional fields by omitting them from `required`, and set `additionalProperties: true` only when extra keys should be allowed. Errors surface in GraphQL responses (and logs) as `Input validation failed: …` or `Output validation failed: …`, making it obvious which path failed.
+
+### Parse + execute inside the secure runtime
+
+Combine the parser, security scanner, and isolate manager through `SecureYamlRuntime`:
+
+```typescript
+import { SecureYamlRuntime, IsolatedRuntimeManager } from "beddel";
+
+const runtime = new SecureYamlRuntime(new IsolatedRuntimeManager());
+const { success, result } = await runtime.parseYamlSecureRuntime(someYamlString, {
+  tenantId: "tenant-123",
+  securityProfile: "tenant-isolated",
+  validateSecurity: true,
+});
+```
+
+The helper performs pre-scan checks, runs within the requested profile, enforces performance targets, and produces audit hashes you can persist.
+
+## Architectural reference
+
+- `src/parser`: Secure YAML parsing primitives.
+- `src/runtime`: `IsolatedRuntimeManager`, `SimpleIsolatedRuntimeManager`, auditing utilities, declarative interpreter, monitoring, and security hooks.
+- `src/security`: Validation, scoring, threat detection, dashboards.
+- `src/compliance`: GDPR/LGPD tooling, anonymization, export helpers.
+- `src/performance`: Monitoring, autoscaling, streaming metrics.
+- `src/firebase`: Tenant isolation via Firebase Admin SDK.
+- `src/agents`: Registry helpers and sample `joker-agent.yaml`.
+- `src/integration`: Glue code that wires parsing + runtime + scanner.
+
+Every module is documented inline with TypeScript types to make IDE discovery straightforward.
+
+## Development workflow
+
+```bash
+# Build the package
+pnpm --filter beddel build
+
+# Lint and test
+pnpm --filter beddel lint
+pnpm --filter beddel test
+```
+
+When contributing, keep README + `AGENTS.md` synchronized with any new exports or behavioral changes in `src`.
+
+## Docs/beddel roadmap coverage
+
+The product briefs under `docs/beddel` describe a richer future-state language/runtime. The current package intentionally ships a smaller, auditable subset. Notable gaps you will still find only in documentation:
+
+- **Advanced declarative language constructs** (`map-filter-reduce` pipelines, state machines, rule engines, temporal conditions, and loop semantics) are not implemented yet—the interpreter only supports literal variables and `output-generator` steps.
+- **Behavior marketplace & registry extensibility** (behaviors with versions, capabilities, restrictions, and monetization hooks) are not available. Only the bundled `joker` agent is registered by default.
+- **Automatic behavioral integrations and external API pipelines** (`integrations`, `decisions`, `behaviors` blocks described in `docs/beddel/brief.md`) have no runtime support.
+- **Marketplace/compliance automation flows** mentioned in the PRD (pre-built business behaviors, Firebase deployment recipes, global consent orchestration) are still roadmap items, even though compliance helpers exist as standalone utilities.
+- **High-level orchestration features** like parallel execution controls, resource policies (per-step concurrency, retry semantics), and auto-generated documentation have not been wired into the runtime.
+
+Use this section as a living checklist whenever you pull features from `docs/beddel` into the actual codebase.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

package/dist/agents/agentRegistry.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agent Registry Service
+ * Manages registration and execution of declarative YAML agents
+ */
+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 declare class AgentRegistry {
+    private readonly agents;
+    constructor();
+    /**
+     * Register an agent
+     */
+    registerAgent(agent: AgentRegistration): void;
+    /**
+     * Execute registered agent
+     */
+    executeAgent(agentName: string, input: Record<string, any>, props: Record<string, string>, context: ExecutionContext): Promise<any>;
+    /**
+     * Get registered agent
+     */
+    getAgent(agentName: string): AgentRegistration | undefined;
+    /**
+     * Get all registered agents
+     */
+    getAllAgents(): AgentRegistration[];
+    /**
+     * Register built-in agents
+     */
+    private registerBuiltinAgents;
+    /**
+     * Register Joker Agent
+     */
+    private registerJokerAgent;
+    /**
+     * Register Translator Agent
+     */
+    private registerTranslatorAgent;
+    /**
+     * Register Image Generator Agent
+     */
+    private registerImageAgent;
+    /**
+     * Parse agent YAML content
+     */
+    private parseAgentYaml;
+    /**
+     * Validate agent registration
+     */
+    private validateAgent;
+    /**
+     * Resolve agent asset path when running in bundled runtimes
+     */
+    private resolveAgentPath;
+}
+export declare const agentRegistry: AgentRegistry;
+export default AgentRegistry;
+//# sourceMappingURL=agentRegistry.d.ts.map

package/dist/agents/agentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRegistry.d.ts","sourceRoot":"","sources":["../../src/agents/agentRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;;IAOpE;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IASpD;;OAEG;IACU,YAAY,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,GAAG,CAAC;IAkBf;;OAEG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIjE;;OAEG;IACI,YAAY,IAAI,iBAAiB,EAAE;IAI1C;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmDtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkBzB;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,eAAe,aAAa,CAAC"}

package/dist/agents/agentRegistry.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Agent Registry Service
+ * Manages registration and execution of declarative YAML agents
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentRegistry = exports.AgentRegistry = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const declarativeAgentRuntime_1 = require("../runtime/declarativeAgentRuntime");
+/**
+ * Agent Registry - Manages declarative agent registration and execution
+ */
+class AgentRegistry {
+    constructor() {
+        this.agents = new Map();
+        // Register built-in agents on initialization
+        this.registerBuiltinAgents();
+    }
+    /**
+     * Register an agent
+     */
+    registerAgent(agent) {
+        // 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
+     */
+    async executeAgent(agentName, input, props, context) {
+        // Find agent
+        const agent = this.agents.get(agentName);
+        if (!agent) {
+            throw new Error(`Agent not found: ${agentName}`);
+        }
+        // Execute using declarative interpreter
+        const result = await declarativeAgentRuntime_1.declarativeInterpreter.interpret({
+            yamlContent: agent.yamlContent,
+            input,
+            props,
+            context,
+        });
+        return result;
+    }
+    /**
+     * Get registered agent
+     */
+    getAgent(agentName) {
+        return this.agents.get(agentName);
+    }
+    /**
+     * Get all registered agents
+     */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Register built-in agents
+     */
+    registerBuiltinAgents() {
+        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
+     */
+    registerJokerAgent() {
+        try {
+            // Get the Joker Agent YAML content
+            const jokerYamlPath = this.resolveAgentPath("joker-agent.yaml");
+            const yamlContent = (0, fs_1.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
+     */
+    registerTranslatorAgent() {
+        try {
+            const translatorYamlPath = this.resolveAgentPath("translator-agent.yaml");
+            const yamlContent = (0, fs_1.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
+     */
+    registerImageAgent() {
+        try {
+            const imageYamlPath = this.resolveAgentPath("image-agent.yaml");
+            const yamlContent = (0, fs_1.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
+     */
+    parseAgentYaml(yamlContent) {
+        // 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 = {
+            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
+     */
+    validateAgent(agent) {
+        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
+     */
+    resolveAgentPath(filename) {
+        const candidatePaths = [
+            (0, path_1.join)(__dirname, filename),
+            (0, path_1.join)(process.cwd(), "packages", "beddel", "src", "agents", filename),
+        ];
+        for (const path of candidatePaths) {
+            if ((0, fs_1.existsSync)(path)) {
+                return path;
+            }
+        }
+        throw new Error(`Unable to locate agent asset '${filename}' in paths: ${candidatePaths.join(", ")}`);
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+// Singleton instance
+exports.agentRegistry = new AgentRegistry();
+exports.default = AgentRegistry;
+//# sourceMappingURL=agentRegistry.js.map

package/dist/agents/agentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRegistry.js","sourceRoot":"","sources":["../../src/agents/agentRegistry.ts"],"names":[],"mappings":"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"}

package/dist/agents/formatter-agent.d.ts

@@ -0,0 +1,10 @@
+import { TranslationResponse } from "./types/translation.types";
+/**
+ * FormatterAgent para formatação e validação de saída
+ */
+export default class FormatterAgent {
+    private static readonly OUTPUT_SCHEMA;
+    static formatOutput(data: TranslationResponse): TranslationResponse;
+}
+export { FormatterAgent };
+//# sourceMappingURL=formatter-agent.d.ts.map

package/dist/agents/formatter-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter-agent.d.ts","sourceRoot":"","sources":["../../src/agents/formatter-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAQlC;IAEH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB;CA+BpE;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/agents/formatter-agent.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormatterAgent = void 0;
+const zod_1 = require("zod");
+/**
+ * FormatterAgent para formatação e validação de saída
+ */
+class FormatterAgent {
+    static formatOutput(data) {
+        try {
+            // Validação contra schema de saída
+            const validated = this.OUTPUT_SCHEMA.parse(data);
+            // Enriquecimento dos metadados
+            const metadadosEnriquecidos = {
+                ...validated.metadados,
+                idiomas_suportados: validated.metadados.idiomas_suportados || [
+                    "pt",
+                    "en",
+                    "es",
+                    "fr",
+                ],
+                timestamp: new Date().toISOString(),
+                versao_agent: "1.0.0",
+            };
+            return {
+                texto_traduzido: validated.texto_traduzido,
+                metadados: metadadosEnriquecidos,
+            };
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                throw new Error(`Formato de saída inválido: ${error.issues[0]?.message}`);
+            }
+            throw error;
+        }
+    }
+}
+exports.FormatterAgent = FormatterAgent;
+FormatterAgent.OUTPUT_SCHEMA = zod_1.z.object({
+    texto_traduzido: zod_1.z.string(),
+    metadados: zod_1.z.object({
+        modelo_utilizado: zod_1.z.string(),
+        tempo_processamento: zod_1.z.number().min(0),
+        confianca: zod_1.z.number().min(0).max(1),
+        idiomas_suportados: zod_1.z.array(zod_1.z.string()).optional(),
+    }),
+});
+exports.default = FormatterAgent;
+//# sourceMappingURL=formatter-agent.js.map

package/dist/agents/formatter-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter-agent.js","sourceRoot":"","sources":["../../src/agents/formatter-agent.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAGxB;;GAEG;AACH,MAAqB,cAAc;IAWjC,MAAM,CAAC,YAAY,CAAC,IAAyB;QAC3C,IAAI,CAAC;YACH,mCAAmC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjD,+BAA+B;YAC/B,MAAM,qBAAqB,GAAG;gBAC5B,GAAG,SAAS,CAAC,SAAS;gBACtB,kBAAkB,EAAE,SAAS,CAAC,SAAS,CAAC,kBAAkB,IAAI;oBAC5D,IAAI;oBACJ,IAAI;oBACJ,IAAI;oBACJ,IAAI;iBACL;gBACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,YAAY,EAAE,OAAO;aACtB,CAAC;YAEF,OAAO;gBACL,eAAe,EAAE,SAAS,CAAC,eAAe;gBAC1C,SAAS,EAAE,qBAAqB;aACjC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,8BAA+B,KAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAClE,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;;AAIM,wCAAc;AA5CG,4BAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE;IAC3B,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC;QAClB,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;QAC5B,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,kBAAkB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACnD,CAAC;CACH,CAAC,CAAC;kBATgB,cAAc"}