agentx-sdk 0.6.1 → 0.6.3

package/README.md

@@ -66,7 +66,7 @@ import { Agent, builtinTools } from 'agentx-sdk';
 const agent = Agent.create({ apiKey: '...' });
 
 // Register all (except askUser which needs a callback)
-builtinTools.all().forEach(t => agent.addTool(t));
+builtinTools.all().forEach((t) => agent.addTool(t));
 
 // Or register individually
 agent.addTool(builtinTools.fileRead());
@@ -78,27 +78,29 @@ agent.addTool(builtinTools.bash());
 agent.addTool(builtinTools.webFetch());
 
 // askUser needs a callback — you implement the interaction
-agent.addTool(builtinTools.askUser({
-  onAsk: async (question, options) => {
-    // Your logic (readline, UI, API, etc.)
-    return readline.question(question);
-  },
-}));
+agent.addTool(
+  builtinTools.askUser({
+    onAsk: async (question, options) => {
+      // Your logic (readline, UI, API, etc.)
+      return readline.question(question);
+    },
+  }),
+);
 
 // Shortcut: file ops only (read + write + edit + glob + grep)
-builtinTools.fileOps().forEach(t => agent.addTool(t));
+builtinTools.fileOps().forEach((t) => agent.addTool(t));
 ```
 
-| Tool | Name | Description |
-|------|------|-------------|
-| `builtinTools.fileRead()` | Read | Read files with line numbers and offset/limit |
-| `builtinTools.fileWrite()` | Write | Write/create files (creates dirs automatically) |
-| `builtinTools.fileEdit()` | Edit | Exact find/replace in files |
-| `builtinTools.glob()` | Glob | Search files by pattern (`**/*.ts`) |
-| `builtinTools.grep()` | Grep | Search content via regex in files |
-| `builtinTools.bash()` | Bash | Execute shell commands with timeout |
-| `builtinTools.webFetch()` | WebFetch | Fetch content from URL (HTML → text) |
-| `builtinTools.askUser()` | AskUser | Ask the user a question (callback pattern) |
+| Tool                       | Name     | Description                                     |
+| -------------------------- | -------- | ----------------------------------------------- |
+| `builtinTools.fileRead()`  | Read     | Read files with line numbers and offset/limit   |
+| `builtinTools.fileWrite()` | Write    | Write/create files (creates dirs automatically) |
+| `builtinTools.fileEdit()`  | Edit     | Exact find/replace in files                     |
+| `builtinTools.glob()`      | Glob     | Search files by pattern (`**/*.ts`)             |
+| `builtinTools.grep()`      | Grep     | Search content via regex in files               |
+| `builtinTools.bash()`      | Bash     | Execute shell commands with timeout             |
+| `builtinTools.webFetch()`  | WebFetch | Fetch content from URL (HTML → text)            |
+| `builtinTools.askUser()`   | AskUser  | Ask the user a question (callback pattern)      |
 
 ## Skills
 
@@ -265,31 +267,31 @@ agent.addSkill({
 
 ### Frontmatter reference (SKILL.md)
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | string | Unique skill name |
-| `description` | string | Short description |
-| `whenToUse` | string | Usage scenarios (for model discovery) |
-| `triggerPrefix` | string | Activation prefix (e.g. `/review`) |
-| `aliases` | string[] | Alternative names |
-| `argNames` | string[] | Argument names for substitution |
-| `allowedTools` | string[] | Tools the skill can use |
-| `model` | string | Model override |
-| `context` | `inline` \| `fork` | Execution mode |
-| `paths` | string[] | Globs for conditional activation |
-| `effort` | number | Computational effort hint (1-10) |
-| `exclusive` | boolean | Blocks other skills |
-| `priority` | number | Priority (higher wins) |
-| `modelInvocable` | boolean | Whether the model can invoke (default: true) |
+| Field            | Type               | Description                                  |
+| ---------------- | ------------------ | -------------------------------------------- |
+| `name`           | string             | Unique skill name                            |
+| `description`    | string             | Short description                            |
+| `whenToUse`      | string             | Usage scenarios (for model discovery)        |
+| `triggerPrefix`  | string             | Activation prefix (e.g. `/review`)           |
+| `aliases`        | string[]           | Alternative names                            |
+| `argNames`       | string[]           | Argument names for substitution              |
+| `allowedTools`   | string[]           | Tools the skill can use                      |
+| `model`          | string             | Model override                               |
+| `context`        | `inline` \| `fork` | Execution mode                               |
+| `paths`          | string[]           | Globs for conditional activation             |
+| `effort`         | number             | Computational effort hint (1-10)             |
+| `exclusive`      | boolean            | Blocks other skills                          |
+| `priority`       | number             | Priority (higher wins)                       |
+| `modelInvocable` | boolean            | Whether the model can invoke (default: true) |
 
 ### Skills API
 
 ```typescript
-agent.addSkill(skill)                          // register
-agent.removeSkill('name')                      // remove
-agent.listSkills()                             // list
-await agent.loadSkillsDir('./skills')          // load from directory
-agent.activateSkillsForPaths(['file.ts'])      // activate conditionals
+agent.addSkill(skill); // register
+agent.removeSkill('name'); // remove
+agent.listSkills(); // list
+await agent.loadSkillsDir('./skills'); // load from directory
+agent.activateSkillsForPaths(['file.ts']); // activate conditionals
 ```
 
 ### Matching hierarchy
@@ -370,7 +372,7 @@ await agent.connectMCP({
   name: 'remote-sse',
   transport: 'sse',
   url: 'https://mcp.example.com/sse',
-  headers: { 'Authorization': 'Bearer sk-...' },
+  headers: { Authorization: 'Bearer sk-...' },
 });
 
 // HTTP — Streamable HTTP (modern servers, bidirectional)
@@ -378,7 +380,7 @@ await agent.connectMCP({
   name: 'remote-http',
   transport: 'http',
   url: 'https://mcp.example.com/v1',
-  headers: { 'Authorization': 'Bearer sk-...' },
+  headers: { Authorization: 'Bearer sk-...' },
 });
 ```
 
@@ -386,10 +388,10 @@ await agent.connectMCP({
 
 MCP servers that declare `readOnlyHint` or `destructiveHint` in tools are automatically mapped to AgentTool flags:
 
-| MCP Annotation | AgentTool Flag | Effect |
-|---|---|---|
-| `readOnlyHint: true` | `isReadOnly: true` + `isConcurrencySafe: true` | Tools run in parallel, no warning |
-| `destructiveHint: true` | `isDestructive: true` | Model receives caution warning |
+| MCP Annotation          | AgentTool Flag                                 | Effect                            |
+| ----------------------- | ---------------------------------------------- | --------------------------------- |
+| `readOnlyHint: true`    | `isReadOnly: true` + `isConcurrencySafe: true` | Tools run in parallel, no warning |
+| `destructiveHint: true` | `isDestructive: true`                          | Model receives caution warning    |
 
 ### Server instructions
 
@@ -427,15 +429,15 @@ const content = await agent.mcpAdapter.readResource('github', 'repo://owner/proj
 ```typescript
 await agent.connectMCP({
   name: 'my-server',
-  transport: 'stdio',           // 'stdio' | 'sse' | 'http'
-  command: 'npx',               // for stdio
+  transport: 'stdio', // 'stdio' | 'sse' | 'http'
+  command: 'npx', // for stdio
   args: ['-y', 'my-mcp-server'],
   // url: 'https://...',        // for sse/http
   // headers: { ... },          // for sse/http
-  timeout: 30_000,              // timeout per tool call (ms)
-  maxRetries: 3,                // reconnection attempts
-  healthCheckInterval: 60_000,  // periodic health check (ms)
-  isolateErrors: true,          // errors don't propagate (default: true)
+  timeout: 30_000, // timeout per tool call (ms)
+  maxRetries: 3, // reconnection attempts
+  healthCheckInterval: 60_000, // periodic health check (ms)
+  isolateErrors: true, // errors don't propagate (default: true)
 });
 ```
 
@@ -471,20 +473,20 @@ await agent.chat('Create a GitHub issue with labels bug and urgent');
 ```typescript
 for await (const event of agent.stream('Build a TODO app')) {
   switch (event.type) {
-    case 'agent_start':      // Execution started
-    case 'skill_activated':  // Skill activated (event.skillName)
-    case 'text_delta':       // Text chunk (event.content)
-    case 'text_done':        // Full text complete
-    case 'tool_call_start':  // Tool called
-    case 'tool_call_end':    // Tool result
-    case 'turn_start':       // Loop iteration started
-    case 'turn_end':         // Loop iteration ended
-    case 'agent_end':        // Finished (event.usage, event.duration)
-    case 'error':            // Error (event.recoverable)
-    case 'warning':          // Warning
-    case 'compaction':       // Context compacted
-    case 'recovery':         // Automatic recovery
-    case 'model_fallback':   // Model fallback
+    case 'agent_start': // Execution started
+    case 'skill_activated': // Skill activated (event.skillName)
+    case 'text_delta': // Text chunk (event.content)
+    case 'text_done': // Full text complete
+    case 'tool_call_start': // Tool called
+    case 'tool_call_end': // Tool result
+    case 'turn_start': // Loop iteration started
+    case 'turn_end': // Loop iteration ended
+    case 'agent_end': // Finished (event.usage, event.duration)
+    case 'error': // Error (event.recoverable)
+    case 'warning': // Warning
+    case 'compaction': // Context compacted
+    case 'recovery': // Automatic recovery
+    case 'model_fallback': // Model fallback
   }
 }
 ```
@@ -494,7 +496,7 @@ for await (const event of agent.stream('Build a TODO app')) {
 ```typescript
 const agent = Agent.create({
   apiKey: 'sk-...',
-  baseUrl: 'https://api.openai.com/v1',   // optional — any OpenAI-compatible URL
+  baseUrl: 'https://api.openai.com/v1', // optional — any OpenAI-compatible URL
   model: 'gpt-4o',
   systemPrompt: 'You are a helpful assistant.',
 
@@ -507,9 +509,9 @@ const agent = Agent.create({
 
   // Skills
   skills: {
-    skillsDir: './.skills',     // Auto-load skills from directory
-    maxActiveSkills: 3,         // Max simultaneous skills
-    modelDiscovery: true,       // List skills for model context
+    skillsDir: './.skills', // Auto-load skills from directory
+    maxActiveSkills: 3, // Max simultaneous skills
+    modelDiscovery: true, // List skills for model context
   },
 
   // Memory
@@ -517,8 +519,8 @@ const agent = Agent.create({
     enabled: true,
     memoryDir: '.agentx/memory/',
     extractionEnabled: true,
-    samplingRate: 0.3,          // 30% chance per turn
-    extractionInterval: 10,     // Force every 10 turns
+    samplingRate: 0.3, // 30% chance per turn
+    extractionInterval: 10, // Force every 10 turns
   },
 
   // Knowledge
@@ -531,7 +533,7 @@ const agent = Agent.create({
 
   // Behavior
   maxIterations: 10,
-  onToolError: 'continue',     // 'continue' | 'stop' | 'retry'
+  onToolError: 'continue', // 'continue' | 'stop' | 'retry'
 
   // Cost control
   costPolicy: {
@@ -570,14 +572,14 @@ Interfaces: `ConversationStore`, `VectorStore` — implement to use any backend.
 
 ## Stack
 
-| Layer | Technology |
-|-------|-----------|
-| Language | TypeScript 5.x |
-| Runtime | Node.js 22+ |
-| Validation | Zod 3.x |
-| Persistence | better-sqlite3 + SQLite |
-| Tools schema | zod-to-json-schema |
-| LLM | Any OpenAI-compatible API (native fetch) |
+| Layer        | Technology                               |
+| ------------ | ---------------------------------------- |
+| Language     | TypeScript 5.x                           |
+| Runtime      | Node.js 22+                              |
+| Validation   | Zod 3.x                                  |
+| Persistence  | better-sqlite3 + SQLite                  |
+| Tools schema | zod-to-json-schema                       |
+| LLM          | Any OpenAI-compatible API (native fetch) |
 
 **<= 4 direct dependencies.** Zero AI frameworks. No vendor lock-in.
 
@@ -647,7 +649,7 @@ import { Agent, builtinTools } from 'agentx-sdk';
 const agent = Agent.create({ apiKey: '...' });
 
 // Registrar todas (exceto askUser que precisa de callback)
-builtinTools.all().forEach(t => agent.addTool(t));
+builtinTools.all().forEach((t) => agent.addTool(t));
 
 // Ou registrar individualmente
 agent.addTool(builtinTools.fileRead());
@@ -659,27 +661,29 @@ agent.addTool(builtinTools.bash());
 agent.addTool(builtinTools.webFetch());
 
 // askUser precisa de callback — voce implementa a interacao
-agent.addTool(builtinTools.askUser({
-  onAsk: async (question, options) => {
-    // Sua logica (readline, UI, API, etc.)
-    return readline.question(question);
-  },
-}));
+agent.addTool(
+  builtinTools.askUser({
+    onAsk: async (question, options) => {
+      // Sua logica (readline, UI, API, etc.)
+      return readline.question(question);
+    },
+  }),
+);
 
 // Atalho: so file ops (read + write + edit + glob + grep)
-builtinTools.fileOps().forEach(t => agent.addTool(t));
+builtinTools.fileOps().forEach((t) => agent.addTool(t));
 ```
 
-| Tool | Nome | Descricao |
-|------|------|-----------|
-| `builtinTools.fileRead()` | Read | Ler arquivos com line numbers e offset/limit |
-| `builtinTools.fileWrite()` | Write | Escrever/criar arquivos (cria dirs automaticamente) |
-| `builtinTools.fileEdit()` | Edit | Find/replace exato em arquivos |
-| `builtinTools.glob()` | Glob | Buscar arquivos por pattern (`**/*.ts`) |
-| `builtinTools.grep()` | Grep | Buscar conteudo via regex em arquivos |
-| `builtinTools.bash()` | Bash | Executar comandos shell com timeout |
-| `builtinTools.webFetch()` | WebFetch | Buscar conteudo de URL (HTML → texto) |
-| `builtinTools.askUser()` | AskUser | Perguntar ao usuario (callback pattern) |
+| Tool                       | Nome     | Descricao                                           |
+| -------------------------- | -------- | --------------------------------------------------- |
+| `builtinTools.fileRead()`  | Read     | Ler arquivos com line numbers e offset/limit        |
+| `builtinTools.fileWrite()` | Write    | Escrever/criar arquivos (cria dirs automaticamente) |
+| `builtinTools.fileEdit()`  | Edit     | Find/replace exato em arquivos                      |
+| `builtinTools.glob()`      | Glob     | Buscar arquivos por pattern (`**/*.ts`)             |
+| `builtinTools.grep()`      | Grep     | Buscar conteudo via regex em arquivos               |
+| `builtinTools.bash()`      | Bash     | Executar comandos shell com timeout                 |
+| `builtinTools.webFetch()`  | WebFetch | Buscar conteudo de URL (HTML → texto)               |
+| `builtinTools.askUser()`   | AskUser  | Perguntar ao usuario (callback pattern)             |
 
 ## Skills
 
@@ -846,31 +850,31 @@ agent.addSkill({
 
 ### Referencia de frontmatter (SKILL.md)
 
-| Campo | Tipo | Descricao |
-|-------|------|-----------|
-| `name` | string | Nome unico da skill |
-| `description` | string | Descricao curta |
-| `whenToUse` | string | Cenarios de uso (para model discovery) |
-| `triggerPrefix` | string | Prefixo para ativacao (ex: `/review`) |
-| `aliases` | string[] | Nomes alternativos |
-| `argNames` | string[] | Nomes dos argumentos para substituicao |
-| `allowedTools` | string[] | Tools que a skill pode usar |
-| `model` | string | Override de modelo |
-| `context` | `inline` \| `fork` | Modo de execucao |
-| `paths` | string[] | Globs para ativacao condicional |
-| `effort` | number | Hint de esforco computacional (1-10) |
-| `exclusive` | boolean | Bloqueia outras skills |
-| `priority` | number | Prioridade (maior vence) |
-| `modelInvocable` | boolean | Se o modelo pode invocar (default: true) |
+| Campo            | Tipo               | Descricao                                |
+| ---------------- | ------------------ | ---------------------------------------- |
+| `name`           | string             | Nome unico da skill                      |
+| `description`    | string             | Descricao curta                          |
+| `whenToUse`      | string             | Cenarios de uso (para model discovery)   |
+| `triggerPrefix`  | string             | Prefixo para ativacao (ex: `/review`)    |
+| `aliases`        | string[]           | Nomes alternativos                       |
+| `argNames`       | string[]           | Nomes dos argumentos para substituicao   |
+| `allowedTools`   | string[]           | Tools que a skill pode usar              |
+| `model`          | string             | Override de modelo                       |
+| `context`        | `inline` \| `fork` | Modo de execucao                         |
+| `paths`          | string[]           | Globs para ativacao condicional          |
+| `effort`         | number             | Hint de esforco computacional (1-10)     |
+| `exclusive`      | boolean            | Bloqueia outras skills                   |
+| `priority`       | number             | Prioridade (maior vence)                 |
+| `modelInvocable` | boolean            | Se o modelo pode invocar (default: true) |
 
 ### API de Skills
 
 ```typescript
-agent.addSkill(skill)                          // registrar
-agent.removeSkill('name')                      // remover
-agent.listSkills()                             // listar
-await agent.loadSkillsDir('./skills')          // carregar de diretorio
-agent.activateSkillsForPaths(['file.ts'])      // ativar condicionais
+agent.addSkill(skill); // registrar
+agent.removeSkill('name'); // remover
+agent.listSkills(); // listar
+await agent.loadSkillsDir('./skills'); // carregar de diretorio
+agent.activateSkillsForPaths(['file.ts']); // ativar condicionais
 ```
 
 ### Hierarquia de matching
@@ -951,7 +955,7 @@ await agent.connectMCP({
   name: 'remote-sse',
   transport: 'sse',
   url: 'https://mcp.example.com/sse',
-  headers: { 'Authorization': 'Bearer sk-...' },
+  headers: { Authorization: 'Bearer sk-...' },
 });
 
 // HTTP — Streamable HTTP (servers modernos, bidirecional)
@@ -959,7 +963,7 @@ await agent.connectMCP({
   name: 'remote-http',
   transport: 'http',
   url: 'https://mcp.example.com/v1',
-  headers: { 'Authorization': 'Bearer sk-...' },
+  headers: { Authorization: 'Bearer sk-...' },
 });
 ```
 
@@ -967,10 +971,10 @@ await agent.connectMCP({
 
 MCP servers que declaram `readOnlyHint` ou `destructiveHint` nas tools sao mapeados automaticamente para os flags do AgentTool:
 
-| Anotacao MCP | Flag AgentTool | Efeito |
-|---|---|---|
-| `readOnlyHint: true` | `isReadOnly: true` + `isConcurrencySafe: true` | Tools executam em paralelo, sem warning |
-| `destructiveHint: true` | `isDestructive: true` | Modelo recebe aviso de cautela |
+| Anotacao MCP            | Flag AgentTool                                 | Efeito                                  |
+| ----------------------- | ---------------------------------------------- | --------------------------------------- |
+| `readOnlyHint: true`    | `isReadOnly: true` + `isConcurrencySafe: true` | Tools executam em paralelo, sem warning |
+| `destructiveHint: true` | `isDestructive: true`                          | Modelo recebe aviso de cautela          |
 
 ### Instrucoes do server
 
@@ -1008,15 +1012,15 @@ const content = await agent.mcpAdapter.readResource('github', 'repo://owner/proj
 ```typescript
 await agent.connectMCP({
   name: 'my-server',
-  transport: 'stdio',           // 'stdio' | 'sse' | 'http'
-  command: 'npx',               // para stdio
+  transport: 'stdio', // 'stdio' | 'sse' | 'http'
+  command: 'npx', // para stdio
   args: ['-y', 'my-mcp-server'],
   // url: 'https://...',        // para sse/http
   // headers: { ... },          // para sse/http
-  timeout: 30_000,              // timeout por tool call (ms)
-  maxRetries: 3,                // tentativas de reconexao
-  healthCheckInterval: 60_000,  // health check periodico (ms)
-  isolateErrors: true,          // erros nao propagam (default: true)
+  timeout: 30_000, // timeout por tool call (ms)
+  maxRetries: 3, // tentativas de reconexao
+  healthCheckInterval: 60_000, // health check periodico (ms)
+  isolateErrors: true, // erros nao propagam (default: true)
 });
 ```
 
@@ -1052,20 +1056,20 @@ await agent.chat('Crie uma issue no GitHub com labels bug e urgent');
 ```typescript
 for await (const event of agent.stream('Build a TODO app')) {
   switch (event.type) {
-    case 'agent_start':      // Inicio da execucao
-    case 'skill_activated':  // Skill ativada (event.skillName)
-    case 'text_delta':       // Chunk de texto (event.content)
-    case 'text_done':        // Texto completo
-    case 'tool_call_start':  // Tool chamada
-    case 'tool_call_end':    // Tool resultado
-    case 'turn_start':       // Inicio de iteracao do loop
-    case 'turn_end':         // Fim de iteracao
-    case 'agent_end':        // Fim (event.usage, event.duration)
-    case 'error':            // Erro (event.recoverable)
-    case 'warning':          // Aviso
-    case 'compaction':       // Contexto compactado
-    case 'recovery':         // Recovery automatico
-    case 'model_fallback':   // Fallback de modelo
+    case 'agent_start': // Inicio da execucao
+    case 'skill_activated': // Skill ativada (event.skillName)
+    case 'text_delta': // Chunk de texto (event.content)
+    case 'text_done': // Texto completo
+    case 'tool_call_start': // Tool chamada
+    case 'tool_call_end': // Tool resultado
+    case 'turn_start': // Inicio de iteracao do loop
+    case 'turn_end': // Fim de iteracao
+    case 'agent_end': // Fim (event.usage, event.duration)
+    case 'error': // Erro (event.recoverable)
+    case 'warning': // Aviso
+    case 'compaction': // Contexto compactado
+    case 'recovery': // Recovery automatico
+    case 'model_fallback': // Fallback de modelo
   }
 }
 ```
@@ -1075,7 +1079,7 @@ for await (const event of agent.stream('Build a TODO app')) {
 ```typescript
 const agent = Agent.create({
   apiKey: 'sk-...',
-  baseUrl: 'https://api.openai.com/v1',   // optional — any OpenAI-compatible URL
+  baseUrl: 'https://api.openai.com/v1', // optional — any OpenAI-compatible URL
   model: 'gpt-4o',
   systemPrompt: 'You are a helpful assistant.',
 
@@ -1088,9 +1092,9 @@ const agent = Agent.create({
 
   // Skills
   skills: {
-    skillsDir: './.skills',     // Auto-load de skills do diretorio
-    maxActiveSkills: 3,         // Max skills simultaneas
-    modelDiscovery: true,       // Listar skills no contexto do modelo
+    skillsDir: './.skills', // Auto-load de skills do diretorio
+    maxActiveSkills: 3, // Max skills simultaneas
+    modelDiscovery: true, // Listar skills no contexto do modelo
   },
 
   // Memory
@@ -1098,8 +1102,8 @@ const agent = Agent.create({
     enabled: true,
     memoryDir: '.agentx/memory/',
     extractionEnabled: true,
-    samplingRate: 0.3,          // 30% de chance por turn
-    extractionInterval: 10,     // Forcar a cada 10 turns
+    samplingRate: 0.3, // 30% de chance por turn
+    extractionInterval: 10, // Forcar a cada 10 turns
   },
 
   // Knowledge
@@ -1112,7 +1116,7 @@ const agent = Agent.create({
 
   // Comportamento
   maxIterations: 10,
-  onToolError: 'continue',     // 'continue' | 'stop' | 'retry'
+  onToolError: 'continue', // 'continue' | 'stop' | 'retry'
 
   // Controle de custo
   costPolicy: {
@@ -1151,14 +1155,14 @@ Interfaces: `ConversationStore`, `VectorStore` — implemente para usar qualquer
 
 ## Stack
 
-| Camada | Tecnologia |
-|--------|-----------|
-| Linguagem | TypeScript 5.x |
-| Runtime | Node.js 22+ |
-| Validacao | Zod 3.x |
-| Persistencia | better-sqlite3 + SQLite |
-| Tools schema | zod-to-json-schema |
-| LLM | Qualquer API OpenAI-compatible (fetch nativo) |
+| Camada       | Tecnologia                                    |
+| ------------ | --------------------------------------------- |
+| Linguagem    | TypeScript 5.x                                |
+| Runtime      | Node.js 22+                                   |
+| Validacao    | Zod 3.x                                       |
+| Persistencia | better-sqlite3 + SQLite                       |
+| Tools schema | zod-to-json-schema                            |
+| LLM          | Qualquer API OpenAI-compatible (fetch nativo) |
 
 **<= 4 dependencias diretas.** Zero frameworks de IA. Sem vendor lock-in.
 

package/dist/agent.d.ts

@@ -2,9 +2,11 @@ import type { AgentConfigInput, MCPConnectionConfigInput } from './config/config
 import type { AgentEvent } from './contracts/entities/agent-event.js';
 import type { AgentTool } from './contracts/entities/agent-tool.js';
 import type { AgentSkill } from './contracts/entities/agent-skill.js';
+import type { ChatMessage } from './contracts/entities/chat-message.js';
 import type { KnowledgeDocument, RetrievedKnowledge } from './contracts/entities/knowledge.js';
 import type { TokenUsage } from './contracts/entities/token-usage.js';
 import type { ContentPart } from './contracts/entities/content-part.js';
+import type { MemoryFile } from './memory/memory-types.js';
 import { type MCPHealthStatus } from './tools/mcp-adapter.js';
 import { type TurnEndHook } from './core/turn-end-hooks.js';
 export interface ChatOptions {
@@ -72,19 +74,19 @@ export declare class Agent {
         systemPrompt?: string;
         model?: string;
         /** Tools available to the forked agent. If omitted, fork has no tools. */
-        tools?: import('./contracts/entities/agent-tool.js').AgentTool[];
+        tools?: AgentTool[];
         /** If true, runs in background and returns a Promise (fire-and-forget). Default: false (blocking). */
         background?: boolean;
     }): Promise<string>;
     /** Get effective context window for the current model. */
     getEffectiveContextWindow(): number;
-    getHistory(threadId?: string): import('./contracts/entities/chat-message.js').ChatMessage[];
+    getHistory(threadId?: string): ChatMessage[];
     clearHistory(threadId?: string): void;
     connectMCP(config: MCPConnectionConfigInput): Promise<void>;
     disconnectMCP(name: string): Promise<void>;
     getHealth(): MCPHealthStatus;
     remember(content: string, type?: 'user' | 'feedback' | 'project' | 'reference', threadId?: string): Promise<string>;
-    recall(query: string, threadId?: string): Promise<import('./memory/memory-types.js').MemoryFile[]>;
+    recall(query: string, threadId?: string): Promise<MemoryFile[]>;
     ingestKnowledge(document: KnowledgeDocument): Promise<void>;
     searchKnowledge(query: string): Promise<RetrievedKnowledge[]>;
     getUsage(): TokenUsage;

package/dist/agent.d.ts.map

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