@theokit/agents 6.3.1 → 6.4.1

package/dist/{bridge-entry-BlKfMDWb.d.ts → bridge-entry-C_jckCIk.d.ts}

@@ -1,5 +1,5 @@
 import { ExecutionContext } from '@theokit/http';
-import { SystemPromptResolver, InlineSkill, SettingSource, MemorySettings, SkillsSettings, ContextSettings, PreToolCallContext, PreToolCallDecision, PostToolCallContext, ToolResultTransformContext, TransformContext, SessionLifecycleContext, PreUserSendContext, PreUserSendResult, PostAssistantReplyContext, CustomTool, ModelSelection, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker } from '@theokit/sdk';
+import { McpServerConfig, SystemPromptResolver, InlineSkill, SettingSource, MemorySettings, SkillsSettings, ContextSettings, PreToolCallContext, PreToolCallDecision, PostToolCallContext, ToolResultTransformContext, TransformContext, SessionLifecycleContext, PreUserSendContext, PreUserSendResult, PostAssistantReplyContext, CustomTool, ModelSelection, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker } from '@theokit/sdk';
 import { z } from 'zod';
 import { UIMessageChunk } from 'ai';
 import { RetryOptions } from '@theokit/sdk/retry';
@@ -128,17 +128,7 @@ interface HumanInTheLoopOptions {
      */
     payloadSchema?: Record<string, unknown>;
 }
-/** M53 — moved from the `@MCP` decorator being deleted; consumed by the bridge and the adapter. */
-interface McpServerConfig {
-    /** Command to start the MCP server. */
-    command: string;
-    /** Arguments passed to the command. */
-    args?: string[];
-    /** Environment variables for the server process. */
-    env?: Record<string, string>;
-    /** Working directory for the server process. */
-    cwd?: string;
-}
+
 type McpServersMap = Record<string, McpServerConfig>;
 /** M53 — moved from the `@ProjectContext` decorator being deleted; read by the compiler. */
 type IndexStrategy = 'tree-sitter' | 'regex' | 'none';
@@ -2092,6 +2082,10 @@ type McpApprovalSpec = HumanInTheLoopOptions | string;
  */
 declare function mcpToolApprovals(specs: Record<string, McpApprovalSpec>): Record<string, HumanInTheLoopOptions>;
 
+/** Canal por onde uma entrada omitida é NOMEADA. Sem ele, estreitar o raio viraria fail-open. */
+interface LoadMcpJsonOptions {
+    onWarn?: (aviso: string) => void;
+}
 /**
  * Raised when `<cwd>/.mcp.json` exists but cannot be read, is not valid JSON, or does not match the
  * expected shape — never swallowed.
@@ -2114,7 +2108,7 @@ declare class McpFileError extends TheokitAgentError {
  *
  * Reading is explicit — this module has no import-time side effect.
  */
-declare function loadMcpJson(cwd: string): McpServersMap;
+declare function loadMcpJson(cwd: string, opts?: LoadMcpJsonOptions): McpServersMap;
 
 /**
  * Agent manifest generator — build-time JSON describing all agents, tools, guards, policies.
@@ -2261,4 +2255,4 @@ declare function agentsPlugin(opts: AgentsPluginOptions): {
     register(app: PluginApp): void;
 };
 
-export { type DelegateOptions as $, type ApprovalOptions as A, type ApiErrorDecision as B, type CompiledAgentOptions as C, type DelegationResult as D, type ApiErrorPolicy as E, type ApprovalRequiredEvent as F, type Guardrail as G, type HumanInTheLoopOptions as H, type ArtifactChunkEvent as I, type ArtifactStartEvent as J, type BackgroundDelegation as K, type LoopStrategy as L, type MainLoopMeta as M, type BeforeToolCallContext as N, BudgetExceededError as O, type BudgetOptions as P, type CheckpointSavedEvent as Q, type ReflectionStrategy as R, type StreamEvent as S, type ToolOptions as T, type CompiledContextWindow as U, ContextualTool as V, CostBudgetExceededError as W, DEFAULT_MAX_ITERATIONS as X, type DefineAgentConfig as Y, type DefinicaoOuThunk as Z, type DelegateFn as _, type CompiledTool as a, createThinkTagExtractor as a$, DelegationBudgetExceededError as a0, DelegationError as a1, type DoneEvent as a2, type ErrorEvent as a3, type FileEditEvent as a4, type GuardrailAction as a5, type GuardrailPhase as a6, type GuardrailResult as a7, GuardrailViolationError as a8, type HookHandlers as a9, type SdkTurnHandle as aA, type Segment as aB, type SkillsRequestContext as aC, type SkillsSelection as aD, type StateUpdateEvent as aE, type TextDeltaEvent as aF, type ThinkingEvent as aG, type TimeoutAction as aH, type ToolCallEvent as aI, type ToolCallVeto as aJ, type ToolHooks as aK, type ToolHooksPlugin as aL, type ToolResultEvent as aM, type ToolWalkResult as aN, type ToolboxOptions as aO, type ToolboxWalkResult as aP, agentsPlugin as aQ, buildModelSelection as aR, compileAgentDefinition as aS, compileAgentModule as aT, compileContextWindow as aU, compileProjectContext as aV, compileSkills as aW, compileTools as aX, createAgentExecutionContext as aY, createApiErrorHandler as aZ, createSdkAgentStream as a_, type InferAgentInput as aa, type InferAgentToolNames as ab, type IterationEvent as ac, type LLMCallContext as ad, type LoopFinishReason as ae, type LoopOutcome as af, type LoopStrategyConfig as ag, type MainLoopOptions as ah, type McpApprovalSpec as ai, McpFileError as aj, type McpRegistryConfig as ak, type McpRequestContext as al, type McpSelection as am, type PartialToolCallEvent as an, type PolicyHandler as ao, type ProcessInputContext as ap, type ReflectionContext as aq, type ReflectionResult as ar, type ReflectionStrategyConfig as as, type RunStartedEvent as at, type ScoreVerdict as au, type ScoredDelegation as av, type Scorer as aw, type SdkAgentHandle as ax, type SdkMessage as ay, type SdkSendOptions as az, type ReasoningEffort as b, createToolHooksPlugin as b0, delegate as b1, delegateBackground as b2, delegateWithScoring as b3, extractThinkTagStream as b4, generateAgentManifest as b5, generateAgentRoutes as b6, isAgentContext as b7, isAgentDefinition as b8, isApprovalRequired as b9, isDone as ba, isError as bb, isPartialToolCall as bc, isTextDelta as bd, isToolCall as be, isToolResult as bf, ladderReflectionStrategy as bg, loadMcpJson as bh, loopStrategyConfigSchema as bi, mcpRegistry as bj, mcpToolApprovals as bk, noopReflectionStrategy as bl, presentUIMessageStream as bm, projectContextMetadataOnlyKnobs as bn, reasoningEffortOf as bo, reflectionStrategyConfigSchema as bp, resolveEnabledSkills as bq, resolveLoopStrategy as br, resolveMcpServers as bs, runWithApiErrorHandling as bt, streamAgentResponse as bu, toAgentFactory as bv, translateSdkEvent as bw, type RoundStreamFactory as c, type ContextWindowOptions as d, type SkillsOptions as e, type AgentManifestEntry as f, type HitlDecision as g, type ApprovalPosture as h, AGENT_BRAND as i, type AfterToolCallContext as j, AgentBuilder as k, type AgentDefinition as l, AgentDefinitionError as m, type AgentExecutionContext as n, type AgentManifest as o, type AgentManifestSource as p, type AgentManifestTool as q, type AgentOptions as r, streamAgentUIMessages as s, type AgentRoute as t, type AgentRouteContext as u, type AgentRunInfo as v, type AgentStreamEvent as w, type AgentTurnMetadata as x, type AgentsPluginOptions as y, type ApiErrorContext as z };
+export { type DelegateOptions as $, type ApprovalOptions as A, type ApiErrorDecision as B, type CompiledAgentOptions as C, type DelegationResult as D, type ApiErrorPolicy as E, type ApprovalRequiredEvent as F, type Guardrail as G, type HumanInTheLoopOptions as H, type ArtifactChunkEvent as I, type ArtifactStartEvent as J, type BackgroundDelegation as K, type LoopStrategy as L, type MainLoopMeta as M, type BeforeToolCallContext as N, BudgetExceededError as O, type BudgetOptions as P, type CheckpointSavedEvent as Q, type ReflectionStrategy as R, type StreamEvent as S, type ToolOptions as T, type CompiledContextWindow as U, ContextualTool as V, CostBudgetExceededError as W, DEFAULT_MAX_ITERATIONS as X, type DefineAgentConfig as Y, type DefinicaoOuThunk as Z, type DelegateFn as _, type CompiledTool as a, createSdkAgentStream as a$, DelegationBudgetExceededError as a0, DelegationError as a1, type DoneEvent as a2, type ErrorEvent as a3, type FileEditEvent as a4, type GuardrailAction as a5, type GuardrailPhase as a6, type GuardrailResult as a7, GuardrailViolationError as a8, type HookHandlers as a9, type SdkSendOptions as aA, type SdkTurnHandle as aB, type Segment as aC, type SkillsRequestContext as aD, type SkillsSelection as aE, type StateUpdateEvent as aF, type TextDeltaEvent as aG, type ThinkingEvent as aH, type TimeoutAction as aI, type ToolCallEvent as aJ, type ToolCallVeto as aK, type ToolHooks as aL, type ToolHooksPlugin as aM, type ToolResultEvent as aN, type ToolWalkResult as aO, type ToolboxOptions as aP, type ToolboxWalkResult as aQ, agentsPlugin as aR, buildModelSelection as aS, compileAgentDefinition as aT, compileAgentModule as aU, compileContextWindow as aV, compileProjectContext as aW, compileSkills as aX, compileTools as aY, createAgentExecutionContext as aZ, createApiErrorHandler as a_, type InferAgentInput as aa, type InferAgentToolNames as ab, type IterationEvent as ac, type LLMCallContext as ad, type LoopFinishReason as ae, type LoopOutcome as af, type LoopStrategyConfig as ag, type MainLoopOptions as ah, type McpApprovalSpec as ai, McpFileError as aj, type McpRegistryConfig as ak, type McpRequestContext as al, type McpSelection as am, type McpServersMap as an, type PartialToolCallEvent as ao, type PolicyHandler as ap, type ProcessInputContext as aq, type ReflectionContext as ar, type ReflectionResult as as, type ReflectionStrategyConfig as at, type RunStartedEvent as au, type ScoreVerdict as av, type ScoredDelegation as aw, type Scorer as ax, type SdkAgentHandle as ay, type SdkMessage as az, type ReasoningEffort as b, createThinkTagExtractor as b0, createToolHooksPlugin as b1, delegate as b2, delegateBackground as b3, delegateWithScoring as b4, extractThinkTagStream as b5, generateAgentManifest as b6, generateAgentRoutes as b7, isAgentContext as b8, isAgentDefinition as b9, isApprovalRequired as ba, isDone as bb, isError as bc, isPartialToolCall as bd, isTextDelta as be, isToolCall as bf, isToolResult as bg, ladderReflectionStrategy as bh, loadMcpJson as bi, loopStrategyConfigSchema as bj, mcpRegistry as bk, mcpToolApprovals as bl, noopReflectionStrategy as bm, presentUIMessageStream as bn, projectContextMetadataOnlyKnobs as bo, reasoningEffortOf as bp, reflectionStrategyConfigSchema as bq, resolveEnabledSkills as br, resolveLoopStrategy as bs, resolveMcpServers as bt, runWithApiErrorHandling as bu, streamAgentResponse as bv, toAgentFactory as bw, translateSdkEvent as bx, type RoundStreamFactory as c, type ContextWindowOptions as d, type SkillsOptions as e, type AgentManifestEntry as f, type HitlDecision as g, type ApprovalPosture as h, AGENT_BRAND as i, type AfterToolCallContext as j, AgentBuilder as k, type AgentDefinition as l, AgentDefinitionError as m, type AgentExecutionContext as n, type AgentManifest as o, type AgentManifestSource as p, type AgentManifestTool as q, type AgentOptions as r, streamAgentUIMessages as s, type AgentRoute as t, type AgentRouteContext as u, type AgentRunInfo as v, type AgentStreamEvent as w, type AgentTurnMetadata as x, type AgentsPluginOptions as y, type ApiErrorContext as z };

package/dist/bridge.d.ts

@@ -1,4 +1,4 @@
-export { i as AGENT_BRAND, j as AfterToolCallContext, k as AgentBuilder, l as AgentDefinition, m as AgentDefinitionError, n as AgentExecutionContext, o as AgentManifest, f as AgentManifestEntry, p as AgentManifestSource, q as AgentManifestTool, t as AgentRoute, u as AgentRouteContext, v as AgentRunInfo, w as AgentStreamEvent, x as AgentTurnMetadata, y as AgentsPluginOptions, z as ApiErrorContext, B as ApiErrorDecision, E as ApiErrorPolicy, h as ApprovalPosture, F as ApprovalRequiredEvent, I as ArtifactChunkEvent, J as ArtifactStartEvent, K as BackgroundDelegation, N as BeforeToolCallContext, O as BudgetExceededError, Q as CheckpointSavedEvent, C as CompiledAgentOptions, U as CompiledContextWindow, a as CompiledTool, V as ContextualTool, Y as DefineAgentConfig, Z as DefinicaoOuThunk, _ as DelegateFn, $ as DelegateOptions, a0 as DelegationBudgetExceededError, a1 as DelegationError, D as DelegationResult, a2 as DoneEvent, a3 as ErrorEvent, a4 as FileEditEvent, aa as InferAgentInput, ab as InferAgentToolNames, ac as IterationEvent, ad as LLMCallContext, ai as McpApprovalSpec, aj as McpFileError, ak as McpRegistryConfig, al as McpRequestContext, am as McpSelection, an as PartialToolCallEvent, ap as ProcessInputContext, at as RunStartedEvent, au as ScoreVerdict, av as ScoredDelegation, aw as Scorer, ax as SdkAgentHandle, ay as SdkMessage, az as SdkSendOptions, aA as SdkTurnHandle, aB as Segment, aE as StateUpdateEvent, S as StreamEvent, aF as TextDeltaEvent, aG as ThinkingEvent, aI as ToolCallEvent, aJ as ToolCallVeto, aK as ToolHooks, aL as ToolHooksPlugin, aM as ToolResultEvent, aN as ToolWalkResult, aP as ToolboxWalkResult, aQ as agentsPlugin, aR as buildModelSelection, aS as compileAgentDefinition, aT as compileAgentModule, aU as compileContextWindow, aV as compileProjectContext, aW as compileSkills, aX as compileTools, aY as createAgentExecutionContext, aZ as createApiErrorHandler, a_ as createSdkAgentStream, a$ as createThinkTagExtractor, b0 as createToolHooksPlugin, b1 as delegate, b2 as delegateBackground, b3 as delegateWithScoring, b4 as extractThinkTagStream, b5 as generateAgentManifest, b6 as generateAgentRoutes, b7 as isAgentContext, b8 as isAgentDefinition, b9 as isApprovalRequired, ba as isDone, bb as isError, bc as isPartialToolCall, bd as isTextDelta, be as isToolCall, bf as isToolResult, bh as loadMcpJson, bj as mcpRegistry, bk as mcpToolApprovals, bm as presentUIMessageStream, bn as projectContextMetadataOnlyKnobs, bo as reasoningEffortOf, bs as resolveMcpServers, bt as runWithApiErrorHandling, bu as streamAgentResponse, s as streamAgentUIMessages, bv as toAgentFactory, bw as translateSdkEvent } from './bridge-entry-BlKfMDWb.js';
+export { i as AGENT_BRAND, j as AfterToolCallContext, k as AgentBuilder, l as AgentDefinition, m as AgentDefinitionError, n as AgentExecutionContext, o as AgentManifest, f as AgentManifestEntry, p as AgentManifestSource, q as AgentManifestTool, t as AgentRoute, u as AgentRouteContext, v as AgentRunInfo, w as AgentStreamEvent, x as AgentTurnMetadata, y as AgentsPluginOptions, z as ApiErrorContext, B as ApiErrorDecision, E as ApiErrorPolicy, h as ApprovalPosture, F as ApprovalRequiredEvent, I as ArtifactChunkEvent, J as ArtifactStartEvent, K as BackgroundDelegation, N as BeforeToolCallContext, O as BudgetExceededError, Q as CheckpointSavedEvent, C as CompiledAgentOptions, U as CompiledContextWindow, a as CompiledTool, V as ContextualTool, Y as DefineAgentConfig, Z as DefinicaoOuThunk, _ as DelegateFn, $ as DelegateOptions, a0 as DelegationBudgetExceededError, a1 as DelegationError, D as DelegationResult, a2 as DoneEvent, a3 as ErrorEvent, a4 as FileEditEvent, aa as InferAgentInput, ab as InferAgentToolNames, ac as IterationEvent, ad as LLMCallContext, ai as McpApprovalSpec, aj as McpFileError, ak as McpRegistryConfig, al as McpRequestContext, am as McpSelection, ao as PartialToolCallEvent, aq as ProcessInputContext, au as RunStartedEvent, av as ScoreVerdict, aw as ScoredDelegation, ax as Scorer, ay as SdkAgentHandle, az as SdkMessage, aA as SdkSendOptions, aB as SdkTurnHandle, aC as Segment, aF as StateUpdateEvent, S as StreamEvent, aG as TextDeltaEvent, aH as ThinkingEvent, aJ as ToolCallEvent, aK as ToolCallVeto, aL as ToolHooks, aM as ToolHooksPlugin, aN as ToolResultEvent, aO as ToolWalkResult, aQ as ToolboxWalkResult, aR as agentsPlugin, aS as buildModelSelection, aT as compileAgentDefinition, aU as compileAgentModule, aV as compileContextWindow, aW as compileProjectContext, aX as compileSkills, aY as compileTools, aZ as createAgentExecutionContext, a_ as createApiErrorHandler, a$ as createSdkAgentStream, b0 as createThinkTagExtractor, b1 as createToolHooksPlugin, b2 as delegate, b3 as delegateBackground, b4 as delegateWithScoring, b5 as extractThinkTagStream, b6 as generateAgentManifest, b7 as generateAgentRoutes, b8 as isAgentContext, b9 as isAgentDefinition, ba as isApprovalRequired, bb as isDone, bc as isError, bd as isPartialToolCall, be as isTextDelta, bf as isToolCall, bg as isToolResult, bi as loadMcpJson, bk as mcpRegistry, bl as mcpToolApprovals, bn as presentUIMessageStream, bo as projectContextMetadataOnlyKnobs, bp as reasoningEffortOf, bt as resolveMcpServers, bu as runWithApiErrorHandling, bv as streamAgentResponse, s as streamAgentUIMessages, bw as toAgentFactory, bx as translateSdkEvent } from './bridge-entry-C_jckCIk.js';
 import '@theokit/http';
 import '@theokit/sdk';
 import 'zod';

package/dist/bridge.js

@@ -47,7 +47,7 @@ import {
   streamAgentUIMessages,
   toAgentFactory,
   translateSdkEvent
-} from "./chunk-MDFEPVAN.js";
+} from "./chunk-C5RUE4DB.js";
 import "./chunk-7QVYU63E.js";
 export {
   AGENT_BRAND,

package/dist/{chunk-MDFEPVAN.js → chunk-C5RUE4DB.js}

@@ -3425,7 +3425,7 @@ var McpFileError = class extends TheokitAgentError {
   }
 };
 var MCP_FILENAME = ".mcp.json";
-function loadMcpJson(cwd) {
+function loadMcpJson(cwd, opts = {}) {
   const path = join(cwd, MCP_FILENAME);
   if (!existsSync(path)) return {};
   let text;
@@ -3440,10 +3440,10 @@ function loadMcpJson(cwd) {
   } catch (err) {
     throw new McpFileError(`${path} is not valid JSON: ${descrever(err)}`);
   }
-  return parseMcpJson(parsed, path);
+  return parseMcpJson(parsed, path, opts.onWarn);
 }
 __name(loadMcpJson, "loadMcpJson");
-function parseMcpJson(raw, source) {
+function parseMcpJson(raw, source, onWarn) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
     throw new McpFileError(`${source}: root must be a JSON object with an "mcpServers" key.`);
   }
@@ -3454,37 +3454,59 @@ function parseMcpJson(raw, source) {
   }
   const out = {};
   for (const [name, entryRaw] of Object.entries(serversRaw)) {
-    out[name] = parseServerEntry(name, entryRaw, source);
+    const motivo = validarEntrada(name, entryRaw);
+    if (motivo !== void 0) {
+      onWarn?.(`${source}: server "${name}" ignorado \u2014 ${motivo}`);
+      continue;
+    }
+    out[name] = entryRaw;
   }
   return out;
 }
 __name(parseMcpJson, "parseMcpJson");
-function parseServerEntry(name, entryRaw, source) {
+function validarEntrada(name, entryRaw) {
   if (typeof entryRaw !== "object" || entryRaw === null || Array.isArray(entryRaw)) {
-    throw new McpFileError(`${source}: server "${name}" must be an object.`);
+    return "a entrada deve ser um objeto.";
   }
   const entry = entryRaw;
+  const temUrl = entry.url !== void 0;
+  const temCommand = entry.command !== void 0;
+  if (temUrl && temCommand) return 'declara "command" e "url" ao mesmo tempo \u2014 escolha um transporte.';
+  if (!temUrl && !temCommand) return 'requer "command" (stdio) ou "url" (http/sse).';
+  return temUrl ? validarRemoto(entry) : validarStdio(entry);
+}
+__name(validarEntrada, "validarEntrada");
+function validarStdio(entry) {
   if (typeof entry.command !== "string" || entry.command.length === 0) {
-    throw new McpFileError(`${source}: server "${name}" requires a non-empty "command" string.`);
+    return 'campo "command" deve ser uma string n\xE3o vazia.';
+  }
+  if (entry.args !== void 0 && !isStringArray(entry.args)) return 'campo "args" deve ser array de strings.';
+  if (entry.env !== void 0 && !isStringRecord(entry.env)) return 'campo "env" deve ser um mapa de strings.';
+  if (entry.cwd !== void 0 && typeof entry.cwd !== "string") return 'campo "cwd" deve ser string.';
+  return void 0;
+}
+__name(validarStdio, "validarStdio");
+function validarRemoto(entry) {
+  if (typeof entry.url !== "string" || entry.url.length === 0) {
+    return 'campo "url" deve ser uma string n\xE3o vazia.';
   }
-  if (entry.args !== void 0 && !isStringArray(entry.args)) {
-    throw new McpFileError(`${source}: server "${name}" field "args" must be a string array.`);
+  try {
+    new URL(entry.url);
+  } catch {
+    return 'campo "url" n\xE3o \xE9 uma URL v\xE1lida.';
   }
-  if (entry.env !== void 0 && !isStringRecord(entry.env)) {
-    throw new McpFileError(`${source}: server "${name}" field "env" must be a string map.`);
+  if (entry.type !== void 0 && entry.type !== "http" && entry.type !== "sse") {
+    return 'campo "type" deve ser "http" ou "sse".';
   }
-  if (entry.cwd !== void 0 && typeof entry.cwd !== "string") {
-    throw new McpFileError(`${source}: server "${name}" field "cwd" must be a string.`);
+  if (entry.headers !== void 0 && !isStringRecord(entry.headers)) {
+    return 'campo "headers" deve ser um mapa de strings.';
   }
-  const built = {
-    command: entry.command
-  };
-  if (entry.args !== void 0) built.args = entry.args;
-  if (entry.env !== void 0) built.env = entry.env;
-  if (entry.cwd !== void 0) built.cwd = entry.cwd;
-  return built;
+  if (entry.requestTimeoutMs !== void 0 && typeof entry.requestTimeoutMs !== "number") {
+    return 'campo "requestTimeoutMs" deve ser n\xFAmero.';
+  }
+  return void 0;
 }
-__name(parseServerEntry, "parseServerEntry");
+__name(validarRemoto, "validarRemoto");
 function descrever(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -3710,4 +3732,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-MDFEPVAN.js.map
+//# sourceMappingURL=chunk-C5RUE4DB.js.map