@gugacoder/agentic-sdk 0.2.0

package/dist/display-schemas.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+// --- Primitivos reutilizaveis ---
+const MoneySchema = z.object({
+    value: z.number(),
+    currency: z.string().default("BRL"),
+});
+const SourceRefSchema = z.object({
+    name: z.string(),
+    url: z.string().url(),
+    favicon: z.string().url().optional(),
+});
+const ImageItemSchema = z.object({
+    url: z.string().url(),
+    alt: z.string().optional(),
+    caption: z.string().optional(),
+});
+const BadgeSchema = z.object({
+    label: z.string(),
+    variant: z.enum(["default", "success", "warning", "error", "info"]).default("default"),
+});
+// --- Display Tools ---
+// 1. METRICAS E DADOS
+export const DisplayMetricSchema = z.object({
+    label: z.string(),
+    value: z.union([z.string(), z.number()]),
+    unit: z.string().optional(),
+    trend: z.object({
+        direction: z.enum(["up", "down", "neutral"]),
+        value: z.string(),
+    }).optional(),
+    icon: z.string().optional(),
+});
+export const DisplayChartSchema = z.object({
+    type: z.enum(["bar", "line", "pie", "area", "donut"]),
+    title: z.string(),
+    data: z.array(z.object({
+        label: z.string(),
+        value: z.number(),
+        color: z.string().optional(),
+    })),
+    format: z.object({
+        prefix: z.string().optional(),
+        suffix: z.string().optional(),
+        locale: z.string().default("pt-BR"),
+    }).optional(),
+});
+export const DisplayTableSchema = z.object({
+    title: z.string().optional(),
+    columns: z.array(z.object({
+        key: z.string(),
+        label: z.string(),
+        type: z.enum(["text", "number", "money", "image", "link", "badge"]).default("text"),
+        align: z.enum(["left", "center", "right"]).default("left"),
+    })),
+    rows: z.array(z.record(z.unknown())),
+    sortable: z.boolean().default(false),
+});
+export const DisplayProgressSchema = z.object({
+    title: z.string().optional(),
+    steps: z.array(z.object({
+        label: z.string(),
+        status: z.enum(["completed", "current", "pending"]),
+        description: z.string().optional(),
+    })),
+});
+// 2. PRODUTOS E COMERCIO
+export const DisplayProductSchema = z.object({
+    title: z.string(),
+    image: z.string().url().optional(),
+    price: MoneySchema.optional(),
+    originalPrice: MoneySchema.optional(),
+    rating: z.object({
+        score: z.number().min(0).max(5),
+        count: z.number(),
+    }).optional(),
+    source: SourceRefSchema.optional(),
+    badges: z.array(BadgeSchema).optional(),
+    url: z.string().url().optional(),
+    description: z.string().optional(),
+});
+export const DisplayComparisonSchema = z.object({
+    title: z.string().optional(),
+    items: z.array(DisplayProductSchema),
+    attributes: z.array(z.object({
+        key: z.string(),
+        label: z.string(),
+    })).optional(),
+});
+export const DisplayPriceSchema = z.object({
+    value: MoneySchema,
+    label: z.string(),
+    context: z.string().optional(),
+    source: SourceRefSchema.optional(),
+    badge: BadgeSchema.optional(),
+});
+// 3. MIDIA
+export const DisplayImageSchema = z.object({
+    url: z.string().url(),
+    alt: z.string().optional(),
+    caption: z.string().optional(),
+    width: z.number().optional(),
+    height: z.number().optional(),
+});
+export const DisplayGallerySchema = z.object({
+    title: z.string().optional(),
+    images: z.array(ImageItemSchema),
+    layout: z.enum(["grid", "masonry"]).default("grid"),
+    columns: z.number().min(2).max(5).default(3),
+});
+export const DisplayCarouselSchema = z.object({
+    title: z.string().optional(),
+    items: z.array(z.object({
+        image: z.string().url().optional(),
+        title: z.string(),
+        subtitle: z.string().optional(),
+        price: MoneySchema.optional(),
+        url: z.string().url().optional(),
+        badges: z.array(BadgeSchema).optional(),
+    })),
+});
+// 4. REFERENCIAS E NAVEGACAO
+export const DisplaySourcesSchema = z.object({
+    label: z.string().default("Fontes consultadas"),
+    sources: z.array(z.object({
+        title: z.string(),
+        url: z.string().url(),
+        favicon: z.string().url().optional(),
+        snippet: z.string().optional(),
+    })),
+});
+export const DisplayLinkSchema = z.object({
+    url: z.string().url(),
+    title: z.string(),
+    description: z.string().optional(),
+    image: z.string().url().optional(),
+    favicon: z.string().url().optional(),
+    domain: z.string().optional(),
+});
+export const DisplayMapSchema = z.object({
+    title: z.string().optional(),
+    pins: z.array(z.object({
+        lat: z.number(),
+        lng: z.number(),
+        label: z.string().optional(),
+        address: z.string().optional(),
+    })),
+    zoom: z.number().min(1).max(20).default(14),
+});
+// 5. DOCUMENTOS E ARQUIVOS
+export const DisplayFileSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    size: z.number().optional(),
+    url: z.string().url().optional(),
+    preview: z.string().optional(),
+});
+export const DisplayCodeSchema = z.object({
+    language: z.string(),
+    code: z.string(),
+    title: z.string().optional(),
+    lineNumbers: z.boolean().default(true),
+});
+export const DisplaySpreadsheetSchema = z.object({
+    title: z.string().optional(),
+    headers: z.array(z.string()),
+    rows: z.array(z.array(z.union([z.string(), z.number(), z.null()]))),
+    format: z.object({
+        moneyColumns: z.array(z.number()).optional(),
+        percentColumns: z.array(z.number()).optional(),
+    }).optional(),
+});
+// 6. INTERATIVO
+export const DisplayStepsSchema = z.object({
+    title: z.string().optional(),
+    steps: z.array(z.object({
+        title: z.string(),
+        description: z.string().optional(),
+        status: z.enum(["completed", "current", "pending"]).default("pending"),
+    })),
+    orientation: z.enum(["vertical", "horizontal"]).default("vertical"),
+});
+export const DisplayAlertSchema = z.object({
+    variant: z.enum(["info", "warning", "error", "success"]),
+    title: z.string().optional(),
+    message: z.string(),
+    icon: z.string().optional(),
+});
+export const DisplayChoicesSchema = z.object({
+    question: z.string().optional(),
+    choices: z.array(z.object({
+        id: z.string(),
+        label: z.string(),
+        description: z.string().optional(),
+        icon: z.string().optional(),
+    })),
+    layout: z.enum(["buttons", "cards", "list"]).default("buttons"),
+});
+// --- Registry (mapa nome → schema) ---
+export const DisplayToolRegistry = {
+    display_metric: DisplayMetricSchema,
+    display_chart: DisplayChartSchema,
+    display_table: DisplayTableSchema,
+    display_progress: DisplayProgressSchema,
+    display_product: DisplayProductSchema,
+    display_comparison: DisplayComparisonSchema,
+    display_price: DisplayPriceSchema,
+    display_image: DisplayImageSchema,
+    display_gallery: DisplayGallerySchema,
+    display_carousel: DisplayCarouselSchema,
+    display_sources: DisplaySourcesSchema,
+    display_link: DisplayLinkSchema,
+    display_map: DisplayMapSchema,
+    display_file: DisplayFileSchema,
+    display_code: DisplayCodeSchema,
+    display_spreadsheet: DisplaySpreadsheetSchema,
+    display_steps: DisplayStepsSchema,
+    display_alert: DisplayAlertSchema,
+    display_choices: DisplayChoicesSchema,
+};

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+export { runAgent } from "./proxy.js";
+export { AgentRunOptionsSchema, AgentEventSchema, UsageDataSchema } from "./schemas.js";
+export type { AgentEvent, UsageData, AgentRunOptions } from "./schemas.js";
+export { runAiAgent } from "./agent.js";
+export type { AiAgentEvent, AiUsageData, AiAgentOptions, AiTodoItem, McpServerConfig, ContextUsage, PrepareStepContext, PrepareStepResult, AiTelemetryOptions } from "./types.js";
+export { getContextUsage } from "./context/usage.js";
+export type { GetContextUsageOptions } from "./context/usage.js";
+export { compactMessages } from "./context/compaction.js";
+export type { CompactOptions, CompactResult } from "./context/compaction.js";
+export { getSystemPrompt, discoverProjectContext } from "./prompts/assembly.js";
+export { createAskUserTool } from "./tools/ask-user.js";
+export type { AskUserCallback } from "./tools/ask-user.js";
+export { webFetchTool } from "./tools/web-fetch.js";
+export { createWebSearchTool } from "./tools/web-search.js";
+export type { WebSearchProvider, WebSearchResult } from "./tools/web-search.js";
+export { createTaskTool } from "./tools/task.js";
+export type { TaskConfig } from "./tools/task.js";
+export { createBatchTool } from "./tools/batch.js";
+export { applyPatchTool, createApplyPatchTool } from "./tools/apply-patch.js";
+export { createBashTool } from "./tools/bash.js";
+export { createWriteTool } from "./tools/write.js";
+export { createEditTool } from "./tools/edit.js";
+export { createMultiEditTool } from "./tools/multi-edit.js";
+export { createCodeSearchTool } from "./tools/code-search.js";
+export type { CodeSearchProvider, CodeSearchResult } from "./tools/code-search.js";
+export { httpRequestTool } from "./tools/http-request.js";
+export { apiSpecTool } from "./tools/api-spec.js";
+export { aiGenerateObject, aiStreamObject } from "./structured.js";
+export type { AiObjectOptions } from "./structured.js";
+export { createAiProviderRegistry } from "./providers.js";
+export type { AiProviderConfig } from "./providers.js";
+export { createLoggingMiddleware } from "./middleware/logging.js";
+export type { LanguageModelMiddleware } from "ai";
+export { createToolCallRepairHandler } from "./tool-repair.js";
+export type { RepairContext } from "./tool-repair.js";
+export { DisplayToolRegistry, DisplayMetricSchema, DisplayChartSchema, DisplayTableSchema, DisplayProgressSchema, DisplayProductSchema, DisplayComparisonSchema, DisplayPriceSchema, DisplayImageSchema, DisplayGallerySchema, DisplayCarouselSchema, DisplaySourcesSchema, DisplayLinkSchema, DisplayMapSchema, DisplayFileSchema, DisplayCodeSchema, DisplaySpreadsheetSchema, DisplayStepsSchema, DisplayAlertSchema, DisplayChoicesSchema } from "./display-schemas.js";
+export type { DisplayToolName, DisplayMetric, DisplayChart, DisplayTable, DisplayProgress, DisplayProduct, DisplayComparison, DisplayPrice, DisplayImage, DisplayGallery, DisplayCarousel, DisplaySources, DisplayLink, DisplayMap, DisplayFile, DisplayCode, DisplaySpreadsheet, DisplaySteps, DisplayAlert, DisplayChoices } from "./display-schemas.js";
+export { createDisplayTools } from "./tools/display.js";

package/dist/index.js

@@ -0,0 +1,28 @@
+// Proxy (primary API)
+export { runAgent } from "./proxy.js";
+export { AgentRunOptionsSchema, AgentEventSchema, UsageDataSchema } from "./schemas.js";
+// AI agent (internal, kept for backward compat)
+export { runAiAgent } from "./agent.js";
+export { getContextUsage } from "./context/usage.js";
+export { compactMessages } from "./context/compaction.js";
+export { getSystemPrompt, discoverProjectContext } from "./prompts/assembly.js";
+export { createAskUserTool } from "./tools/ask-user.js";
+export { webFetchTool } from "./tools/web-fetch.js";
+export { createWebSearchTool } from "./tools/web-search.js";
+export { createTaskTool } from "./tools/task.js";
+export { createBatchTool } from "./tools/batch.js";
+export { applyPatchTool, createApplyPatchTool } from "./tools/apply-patch.js";
+export { createBashTool } from "./tools/bash.js";
+export { createWriteTool } from "./tools/write.js";
+export { createEditTool } from "./tools/edit.js";
+export { createMultiEditTool } from "./tools/multi-edit.js";
+export { createCodeSearchTool } from "./tools/code-search.js";
+export { httpRequestTool } from "./tools/http-request.js";
+export { apiSpecTool } from "./tools/api-spec.js";
+export { aiGenerateObject, aiStreamObject } from "./structured.js";
+export { createAiProviderRegistry } from "./providers.js";
+export { createLoggingMiddleware } from "./middleware/logging.js";
+export { createToolCallRepairHandler } from "./tool-repair.js";
+// Display tools
+export { DisplayToolRegistry, DisplayMetricSchema, DisplayChartSchema, DisplayTableSchema, DisplayProgressSchema, DisplayProductSchema, DisplayComparisonSchema, DisplayPriceSchema, DisplayImageSchema, DisplayGallerySchema, DisplayCarouselSchema, DisplaySourcesSchema, DisplayLinkSchema, DisplayMapSchema, DisplayFileSchema, DisplayCodeSchema, DisplaySpreadsheetSchema, DisplayStepsSchema, DisplayAlertSchema, DisplayChoicesSchema } from "./display-schemas.js";
+export { createDisplayTools } from "./tools/display.js";

package/dist/middleware/logging.d.ts

@@ -0,0 +1,2 @@
+import type { LanguageModelMiddleware } from "ai";
+export declare function createLoggingMiddleware(logger?: (msg: string, data?: Record<string, unknown>) => void): LanguageModelMiddleware;

package/dist/middleware/logging.js

@@ -0,0 +1,32 @@
+export function createLoggingMiddleware(logger = console.log) {
+    return {
+        specificationVersion: "v3",
+        transformParams: async (options) => {
+            const { params } = options;
+            const tools = params.mode?.type === "regular" ? params.mode.tools?.length ?? 0 : 0;
+            logger("[ai:llm] request", {
+                tools,
+                messages: params.prompt?.length ?? 0,
+            });
+            return params;
+        },
+        wrapGenerate: async (options) => {
+            const { doGenerate } = options;
+            const startMs = Date.now();
+            const result = await doGenerate();
+            logger("[ai:llm] generate", {
+                durationMs: Date.now() - startMs,
+                finishReason: result.finishReason,
+                usage: result.usage,
+            });
+            return result;
+        },
+        wrapStream: async (options) => {
+            const { doStream } = options;
+            const startMs = Date.now();
+            const result = await doStream();
+            logger("[ai:llm] stream started", { durationMs: Date.now() - startMs });
+            return result;
+        },
+    };
+}

package/dist/prompts/assembly.d.ts

@@ -0,0 +1,13 @@
+export declare function getSystemPrompt(activeTools: string[]): string;
+/**
+ * Discovers project context files (AGENTS.md, CLAUDE.md) by walking up the
+ * directory tree from `cwd` to the project root (.git) or filesystem root.
+ *
+ * Files are concatenated in root → cwd order (lowest → highest precedence).
+ * Empty files are skipped. Total context is truncated to 4000 tokens by
+ * removing the most distant files (lowest precedence) first.
+ *
+ * @param cwd - Starting directory for the walk-up search.
+ * @returns Concatenated context string, or empty string if nothing found.
+ */
+export declare function discoverProjectContext(cwd: string): Promise<string>;

package/dist/prompts/assembly.js

@@ -0,0 +1,229 @@
+// System prompt assembler — all .md content embedded as strings (build-time, no fs reads)
+import { readFile, access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { countTokens } from "../context/tokenizer.js";
+// --- Base modules ---
+const IDENTITY = `# Identity
+
+You are AI, an autonomous agent. You operate exclusively through tools.
+
+## Principles
+
+- Be concise and technical. Skip filler and pleasantries.
+- Respond in the user's language.
+- Show your work through tool calls, not lengthy explanations.
+- When uncertain, investigate before assuming.`;
+const TOOL_GUIDE = `# Tool Usage
+
+## Core Rules
+
+- **Always read before editing.** Use the Read tool to see current content before any Edit or Write.
+- **Prefer dedicated tools over Bash.** Use Read instead of \`cat\`, Grep instead of \`grep\`, Glob instead of \`find\`. Reserve Bash for git, npm, build, and system commands.
+- **Verify after modifying.** After editing a file, read it back or run a build/test to confirm correctness.
+- **Never repeat a failed action identically.** If a tool call fails, change your approach — different parameters, different tool, or investigate the error first.
+- **Parallelize when possible.** If multiple tool calls are independent, make them together instead of sequentially.`;
+const PATTERNS = `# Working Patterns
+
+1. **Explore before acting** — Use Glob and Grep to understand the codebase structure before making changes.
+2. **Read before editing** — Always Read a file before using Edit. This ensures your \`old_string\` matches exactly.
+3. **Validate after modifying** — Run the build or tests after changes to catch errors early.
+4. **Failed? Change approach** — Do not retry the same action that failed. Diagnose the error, then try a different strategy.
+5. **Incremental progress** — Make one change at a time, verify it works, then proceed to the next.`;
+const SAFETY = `# Safety
+
+- Do not run destructive commands (\`rm -rf\`, \`drop table\`, \`git push --force\`) without explicit user confirmation.
+- Do not modify files outside the scope of the current task.
+- Do not fabricate file contents — always read first.
+- Do not hardcode secrets, passwords, or API keys in source files.
+- When uncertain about the right action, stop and ask the user (if AskUser is available).`;
+// --- Tool-specific modules ---
+const TOOL_PROMPTS = {
+    Read: `## Read
+
+**Use para:** Reading file contents, verifying edits, inspecting configuration.
+
+**NAO use para:** Listing directory contents — use Bash \`ls\` or Glob instead.
+
+**Dica:** Always Read a file before editing it so your \`old_string\` matches exactly.`,
+    Write: `## Write
+
+**Use para:** Creating new files, rewriting an entire file when most content changes.
+
+**NAO use para:** Editing specific sections of an existing file — use Edit instead.
+
+**Dica:** Prefer Edit for targeted changes. Write replaces the whole file and can lose surrounding code.`,
+    Edit: `## Edit
+
+**Use para:** Replacing specific sections of an existing file with exact string matching.
+
+**NAO use para:** Rewriting an entire file (use Write), or editing a file you haven't read yet.
+
+**Dica:** Copy the exact \`old_string\` from Read output — do not type it from memory.`,
+    Bash: `## Bash
+
+**Use para:** Git operations, npm/build commands, running tests, system commands.
+
+**NAO use para:** Reading files (use Read), searching file contents (use Grep), finding files (use Glob).
+
+**Dica:** Always quote file paths with spaces. Check command exit codes before proceeding.`,
+    Glob: `## Glob
+
+**Use para:** Finding files by name pattern (e.g., \`**/*.ts\`, \`src/**/index.*\`).
+
+**NAO use para:** Searching content inside files — use Grep instead.
+
+**Dica:** Use Glob to explore project structure before modifying code. Know what files exist first.`,
+    Grep: `## Grep
+
+**Use para:** Searching content inside files by regex (function names, imports, error messages).
+
+**NAO use para:** Finding files by name or pattern — use Glob instead.
+
+**Dica:** Use Grep to locate all references before renaming or refactoring.`,
+    HttpRequest: `## HttpRequest
+
+**Use para:** Making HTTP requests to REST APIs (GET, POST, PUT, PATCH, DELETE). Interacting with external services, APIs, and webhooks.
+
+**NAO use para:** Fetching web pages for reading — use WebFetch instead. Downloading large files.
+
+**Dica:** Use ApiSpec first to understand an API's endpoints and auth requirements, then use HttpRequest to interact with it. Always include Authorization headers when required.`,
+    ApiSpec: `## ApiSpec
+
+**Use para:** Fetching and parsing OpenAPI/Swagger specs to understand available API endpoints, parameters, and authentication.
+
+**NAO use para:** Making actual API calls — use HttpRequest for that.
+
+**Dica:** Fetch the spec first, study the endpoints, then use HttpRequest to interact with the API.`,
+};
+/**
+ * Assembles the AI system prompt from embedded markdown modules.
+ *
+ * @param activeTools - Tool names to include (e.g. ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]).
+ *                      Unknown names are silently ignored.
+ * @returns The assembled system prompt string.
+ */
+function currentTimestamp() {
+    const tz = process.env.TIMEZONE || "UTC";
+    const now = new Date();
+    const date = now.toLocaleDateString("en-US", {
+        timeZone: tz,
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+    });
+    const time = now.toLocaleTimeString("en-US", {
+        timeZone: tz,
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+    return `It is now ${date} (${tz}) at ${time}`;
+}
+export function getSystemPrompt(activeTools) {
+    const sections = [currentTimestamp(), IDENTITY, TOOL_GUIDE];
+    for (const name of activeTools) {
+        const prompt = TOOL_PROMPTS[name];
+        if (prompt) {
+            sections.push(prompt);
+        }
+    }
+    sections.push(PATTERNS, SAFETY);
+    return sections.join("\n\n");
+}
+// --- Project context discovery ---
+const CONTEXT_FILENAMES = ["AGENTS.md", "CLAUDE.md"];
+const MAX_CONTEXT_TOKENS = 4000;
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isGitRoot(dir) {
+    return fileExists(join(dir, ".git"));
+}
+/**
+ * Discovers project context files (AGENTS.md, CLAUDE.md) by walking up the
+ * directory tree from `cwd` to the project root (.git) or filesystem root.
+ *
+ * Files are concatenated in root → cwd order (lowest → highest precedence).
+ * Empty files are skipped. Total context is truncated to 4000 tokens by
+ * removing the most distant files (lowest precedence) first.
+ *
+ * @param cwd - Starting directory for the walk-up search.
+ * @returns Concatenated context string, or empty string if nothing found.
+ */
+export async function discoverProjectContext(cwd) {
+    // Collect per-directory groups (cwd → root order)
+    const dirGroups = [];
+    let current = resolve(cwd);
+    // Walk up the directory tree collecting context files
+    while (true) {
+        const group = [];
+        for (const filename of CONTEXT_FILENAMES) {
+            const filePath = join(current, filename);
+            if (await fileExists(filePath)) {
+                try {
+                    const content = await readFile(filePath, "utf-8");
+                    if (content.trim().length > 0) {
+                        group.push({ path: filePath, content: content.trim() });
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+        if (group.length > 0) {
+            dirGroups.push(group);
+        }
+        // Stop if we've reached a .git root
+        if (await isGitRoot(current))
+            break;
+        // Move to parent directory
+        const parent = dirname(current);
+        // Stop at filesystem root (dirname returns same path)
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    if (dirGroups.length === 0)
+        return "";
+    // Reverse groups to get root → cwd order, then flatten
+    // Within each group, AGENTS.md comes before CLAUDE.md (as collected)
+    dirGroups.reverse();
+    const collected = dirGroups.flat();
+    // Apply token budget — remove most distant (first items = lowest precedence) if over budget
+    let totalTokens = 0;
+    const formatted = [];
+    // Calculate total tokens for all files
+    const entries = collected.map((file) => {
+        const block = `--- project context: ${file.path} ---\n${file.content}`;
+        return { block, tokens: countTokens(block) };
+    });
+    // Sum total tokens
+    totalTokens = entries.reduce((sum, e) => sum + e.tokens, 0);
+    if (totalTokens <= MAX_CONTEXT_TOKENS) {
+        // Everything fits
+        for (const entry of entries) {
+            formatted.push(entry.block);
+        }
+    }
+    else {
+        // Truncate: remove from the beginning (most distant = lowest precedence)
+        let remaining = totalTokens;
+        let startIndex = 0;
+        while (remaining > MAX_CONTEXT_TOKENS && startIndex < entries.length) {
+            remaining -= entries[startIndex].tokens;
+            startIndex++;
+        }
+        for (let i = startIndex; i < entries.length; i++) {
+            formatted.push(entries[i].block);
+        }
+    }
+    return formatted.join("\n\n");
+}

package/dist/providers.d.ts

@@ -0,0 +1,19 @@
+export interface AiProviderConfig {
+    /** Default API key (used for openrouter) */
+    apiKey: string;
+    /** Aliases de modelo: nome amigavel → model ID completo */
+    aliases?: Record<string, string>;
+    /** Additional providers by name (e.g. groq) */
+    providers?: Record<string, {
+        baseURL: string;
+        apiKey: string;
+    }>;
+}
+export declare function createAiProviderRegistry(config: AiProviderConfig): {
+    /** Resolve modelo por ID ou alias, opcionalmente de um provider especifico */
+    model(nameOrAlias: string, provider?: string): import("@ai-sdk/provider").LanguageModelV3;
+    /** Aliases registrados */
+    aliases: {
+        [x: string]: string;
+    };
+};

package/dist/providers.js

@@ -0,0 +1,44 @@
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { createGroq } from "@ai-sdk/groq";
+const DEFAULT_ALIASES = {
+    "fast": "anthropic/claude-haiku-4.5",
+    "balanced": "anthropic/claude-sonnet-4",
+    "strong": "anthropic/claude-opus-4.6",
+};
+export function createAiProviderRegistry(config) {
+    const aliases = { ...DEFAULT_ALIASES, ...config.aliases };
+    const instances = new Map();
+    function getProvider(name) {
+        const cached = instances.get(name);
+        if (cached)
+            return cached;
+        const extra = config.providers?.[name];
+        if (extra) {
+            if (name === "groq") {
+                const p = createGroq({ apiKey: extra.apiKey });
+                instances.set(name, p);
+                return p;
+            }
+            const p = createOpenAICompatible({ name, baseURL: extra.baseURL, apiKey: extra.apiKey });
+            instances.set(name, p);
+            return p;
+        }
+        // Default: openrouter
+        const p = createOpenAICompatible({
+            name: "openrouter",
+            baseURL: "https://openrouter.ai/api/v1",
+            apiKey: config.apiKey,
+        });
+        instances.set(name, p);
+        return p;
+    }
+    return {
+        /** Resolve modelo por ID ou alias, opcionalmente de um provider especifico */
+        model(nameOrAlias, provider) {
+            const resolved = aliases[nameOrAlias] ?? nameOrAlias;
+            return getProvider(provider ?? "openrouter")(resolved);
+        },
+        /** Aliases registrados */
+        aliases,
+    };
+}

package/dist/proxy.d.ts

@@ -0,0 +1,2 @@
+import { type AgentEvent } from "./schemas.js";
+export declare function runAgent(raw: unknown): AsyncGenerator<AgentEvent>;