@theokit/agents 1.0.1 → 2.0.0

package/dist/bridge.js

@@ -43,7 +43,7 @@ import {
   streamAgentUIMessages,
   toAgentFactory,
   translateSdkEvent
-} from "./chunk-PTHRG25K.js";
+} from "./chunk-K3VX4S65.js";
 import "./chunk-7QVYU63E.js";
 export {
   AGENT_BRAND,

package/dist/{chunk-PTHRG25K.js → chunk-K3VX4S65.js}

@@ -2,6 +2,14 @@ import {
   __name
 } from "./chunk-7QVYU63E.js";
 
+// src/errors.ts
+var ConfigurationError = class extends Error {
+  static {
+    __name(this, "ConfigurationError");
+  }
+  name = "ConfigurationError";
+};
+
 // src/bridge/define-agent.ts
 var AGENT_BRAND = /* @__PURE__ */ Symbol.for("theokit.agent.definition");
 function defineAgent(config) {
@@ -175,21 +183,57 @@ __name(compileSkills, "compileSkills");
 
 // src/bridge/agent-compiler.ts
 var SDK_TOOL_NAME = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
+var SDK_TOOL_NAME_MAX_LENGTH = 64;
+var SDK_TOOL_NAME_CHARSET = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+var SDK_RESERVED_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "shell",
+  "memory_search",
+  "memory_get"
+]);
+var SDK_RESERVED_TOOL_PREFIX = "mcp_";
 function toolRuntimeName(namespace, toolName) {
-  return namespace ? `${namespace}_${toolName}` : toolName;
+  if (toolName.trim().length === 0) {
+    const where = namespace ? ` no namespace "${namespace}"` : "";
+    throw new ConfigurationError(`tool: nome vazio${where} \u2014 declare um nome n\xE3o vazio para a tool`);
+  }
+  const name = namespace ? `${namespace}_${toolName}` : toolName;
+  if (!SDK_TOOL_NAME.test(name)) {
+    if (SDK_TOOL_NAME_CHARSET.test(name)) {
+      throw new ConfigurationError(`tool: nome "${name}" tem comprimento ${name.length} \u2014 a composi\xE7\xE3o namespace + "_" + tool excede o m\xE1ximo de ${SDK_TOOL_NAME_MAX_LENGTH} que o SDK aceita`);
+    }
+    throw new ConfigurationError(`tool: nome inv\xE1lido "${name}" \u2014 deve casar ${String(SDK_TOOL_NAME)} (o SDK rejeita o resto; verifique o namespace e o nome da tool)`);
+  }
+  if (SDK_RESERVED_TOOL_NAMES.has(name) || name.startsWith(SDK_RESERVED_TOOL_PREFIX)) {
+    throw new ConfigurationError(`tool: nome reservado "${name}" \u2014 o SDK reserva ${[
+      ...SDK_RESERVED_TOOL_NAMES
+    ].join(", ")} e o prefixo "${SDK_RESERVED_TOOL_PREFIX}"`);
+  }
+  return name;
 }
 __name(toolRuntimeName, "toolRuntimeName");
+function compileHitlGates(toolboxes) {
+  const gates = /* @__PURE__ */ new Map();
+  for (const tb of toolboxes) {
+    for (const tool of tb.tools) {
+      if (tool.hitl) {
+        gates.set(toolRuntimeName(tb.namespace, tool.config.name), tool.hitl);
+      }
+    }
+  }
+  return gates;
+}
+__name(compileHitlGates, "compileHitlGates");
 function compileTools(toolboxes, toolboxInstances) {
   const tools = [];
   for (const tb of toolboxes) {
     const instance = toolboxInstances.get(tb.class);
     if (!instance) {
-      throw new Error(`[@theokit/agents] Toolbox ${tb.class.name} not instantiated \u2014 add to providers or pass instances.`);
+      throw new ConfigurationError(`toolbox: ${tb.class.name} n\xE3o foi instanciado \u2014 passe a inst\xE2ncia em \`toolboxInstances\``);
     }
     for (const tool of tb.tools) {
       const handler = instance[tool.propertyKey];
       if (typeof handler !== "function") {
-        throw new Error(`[@theokit/agents] Toolbox ${tb.class.name}: '${String(tool.propertyKey)}' is not a function.`);
+        throw new ConfigurationError(`toolbox: ${tb.class.name}.${String(tool.propertyKey)} n\xE3o \xE9 um m\xE9todo (tool "${tool.config.name}")`);
       }
       const name = toolRuntimeName(tb.namespace, tool.config.name);
       tools.push({
@@ -3308,14 +3352,15 @@ function matchRoute(routes, method, pathname) {
 __name(matchRoute, "matchRoute");
 
 export {
+  ConfigurationError,
   AGENT_BRAND,
   isAgentDefinition,
   compileAgentDefinition,
   compileSkillsSelection,
   compileContextWindow,
   compileSkills,
-  SDK_TOOL_NAME,
   toolRuntimeName,
+  compileHitlGates,
   compileTools,
   createAgentExecutionContext,
   isAgentContext,
@@ -3379,4 +3424,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-PTHRG25K.js.map
+//# sourceMappingURL=chunk-K3VX4S65.js.map