@theokit/agents 6.3.0 → 6.4.0

package/dist/{bridge-entry-BlKfMDWb.d.ts → bridge-entry-ok33yXie.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.

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, 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-ok33yXie.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