@theokit/agents 2.0.0 → 4.0.0

package/dist/index.js

@@ -1,16 +1,17 @@
 import {
   AGENT_BRAND,
+  AgentBuilder,
   AgentDefinitionError,
   AgentRunner,
   AgentRunnerBuilder,
   BudgetExceededError,
   ConfigurationError,
+  ContextualTool,
   CostBudgetExceededError,
   DEFAULT_KEEP_TOKENS,
   DEFAULT_MAX_ITERATIONS,
   DelegationError,
   GuardrailViolationError,
-  agent,
   agentsPlugin,
   buildModelSelection,
   compactionStrategyConfigSchema,
@@ -22,7 +23,6 @@ import {
   compileSkills,
   compileSkillsSelection,
   compileTools,
-  contextualTool,
   costGuard,
   createAgentExecutionContext,
   createApiErrorHandler,
@@ -70,7 +70,7 @@ import {
   toolRuntimeName,
   translateSdkEvent,
   unicodeNormalizer
-} from "./chunk-K3VX4S65.js";
+} from "./chunk-OKG5LRGV.js";
 import {
   __name
 } from "./chunk-7QVYU63E.js";
@@ -177,66 +177,71 @@ var ToolsCapability = class {
     });
   }
 };
-var skills = /* @__PURE__ */ __name((entries) => {
-  if (!Array.isArray(entries)) {
-    throw new ConfigurationError(`skills: esperava array de nomes, recebi ${describe(entries)}`);
-  }
-  for (const e of entries) {
-    if (typeof e === "string") {
-      if (e.trim().length === 0) {
-        throw new ConfigurationError("skills: nome vazio \u2014 use um nome de skill n\xE3o vazio");
-      }
-      continue;
-    }
-    if (typeof e !== "object" || e === null || Array.isArray(e)) {
-      throw new ConfigurationError(`skills: entrada inv\xE1lida (${describe(e)}) \u2014 use um nome ou um skill inline`);
+var SkillsCapability = class {
+  static {
+    __name(this, "SkillsCapability");
+  }
+  name = "skills";
+  #entries;
+  constructor(entries) {
+    if (!Array.isArray(entries)) {
+      throw new ConfigurationError(`skills: esperava array de nomes, recebi ${describe(entries)}`);
     }
-    for (const field of [
-      "name",
-      "description",
-      "instructions"
-    ]) {
-      const value = e[field];
-      if (typeof value !== "string" || value.trim().length === 0) {
-        throw new ConfigurationError(`skills: skill inline sem \`${field}\` v\xE1lido (${describe(value)}) \u2014 name, description e instructions s\xE3o obrigat\xF3rios`);
+    for (const e of entries) {
+      if (typeof e === "string") {
+        if (e.trim().length === 0) {
+          throw new ConfigurationError("skills: nome vazio \u2014 use um nome de skill n\xE3o vazio");
+        }
+        continue;
+      }
+      if (typeof e !== "object" || e === null || Array.isArray(e)) {
+        throw new ConfigurationError(`skills: entrada inv\xE1lida (${describe(e)}) \u2014 use um nome ou um skill inline`);
+      }
+      for (const field of [
+        "name",
+        "description",
+        "instructions"
+      ]) {
+        const value = e[field];
+        if (typeof value !== "string" || value.trim().length === 0) {
+          throw new ConfigurationError(`skills: skill inline sem \`${field}\` v\xE1lido (${describe(value)}) \u2014 name, description e instructions s\xE3o obrigat\xF3rios`);
+        }
       }
     }
+    this.#entries = entries;
   }
-  return {
-    name: "skills",
-    apply: /* @__PURE__ */ __name((draft) => {
-      const compiled = compileSkillsSelection(entries.slice());
-      if (compiled.skills === void 0) return;
-      const previous = draft.skills;
-      draft.skills = previous === void 0 ? compiled.skills : {
-        // The spread is exhaustive only because `compileSkillsSelection` emits a FIXED 3-key
-        // shape (`enabled`, `autoInject: true`, and `inline` iff non-empty) — `enabled` and
-        // `inline` are both re-derived below, and `autoInject` is the same literal on both
-        // sides. TRAP for the future: if a capability ever authors `autoInject: false`, this
-        // spread would silently normalize it back to `true`. Unreachable today (no capability
-        // and no reference array form can express it) — revisit when one can.
-        ...previous,
-        ...compiled.skills,
-        enabled: [
-          ...previous.enabled ?? [],
-          ...compiled.skills.enabled ?? []
-        ],
-        ...previous.inline !== void 0 || compiled.skills.inline !== void 0 ? {
-          inline: [
-            ...previous.inline ?? [],
-            ...compiled.skills.inline ?? []
-          ]
-        } : {}
-      };
-      draft.provenance.push({
-        capability: "skills",
-        contributed: [
-          "skills"
+  apply(draft) {
+    const compiled = compileSkillsSelection(this.#entries.slice());
+    if (compiled.skills === void 0) return;
+    const previous = draft.skills;
+    draft.skills = previous === void 0 ? compiled.skills : {
+      // The spread is exhaustive only because `compileSkillsSelection` emits a FIXED 3-key
+      // shape (`enabled`, `autoInject: true`, and `inline` iff non-empty) — `enabled` and
+      // `inline` are both re-derived below, and `autoInject` is the same literal on both
+      // sides. TRAP for the future: if a capability ever authors `autoInject: false`, this
+      // spread would silently normalize it back to `true`. Unreachable today (no capability
+      // and no reference array form can express it) — revisit when one can.
+      ...previous,
+      ...compiled.skills,
+      enabled: [
+        ...previous.enabled ?? [],
+        ...compiled.skills.enabled ?? []
+      ],
+      ...previous.inline !== void 0 || compiled.skills.inline !== void 0 ? {
+        inline: [
+          ...previous.inline ?? [],
+          ...compiled.skills.inline ?? []
         ]
-      });
-    }, "apply")
-  };
-}, "skills");
+      } : {}
+    };
+    draft.provenance.push({
+      capability: this.name,
+      contributed: [
+        "skills"
+      ]
+    });
+  }
+};
 
 // src/capability/registry.ts
 var UnknownCapabilityError = class extends Error {
@@ -287,62 +292,147 @@ var CapabilityPreset = class {
 };
 
 // src/capability/agent-capabilities.ts
-function fieldCapability(name, field) {
-  return (value) => ({
-    name,
-    apply: /* @__PURE__ */ __name((draft) => {
-      setOnce(draft, field, value, name);
-    }, "apply")
-  });
-}
-__name(fieldCapability, "fieldCapability");
-var memory = fieldCapability("memory", "memory");
-var contextWindow = /* @__PURE__ */ __name((options) => ({
-  name: "context-window",
-  apply: /* @__PURE__ */ __name((draft) => {
-    setOnce(draft, "context", compileContextWindow(options).context, "context-window");
-  }, "apply")
-}), "contextWindow");
-var projectContext = fieldCapability("project-context", "projectContext");
-var mcpServers = fieldCapability("mcp", "mcpServers");
-var guardrails = fieldCapability("guardrails", "guardrails");
-var checkpoint = /* @__PURE__ */ __name((options) => ({
-  name: "checkpoint",
-  apply: /* @__PURE__ */ __name((draft) => {
-    if (options !== void 0 && options.storage !== "filesystem") {
-      console.warn(`[THEO_AGENT_CHECKPOINT_STORAGE_METADATA_ONLY] checkpoint({ storage: '${options.storage ?? "memory"}' }) does NOT resume across requests \u2014 only 'filesystem' selects the SDK's durable conversation store. Use checkpoint({ storage: 'filesystem' }) for cross-request resume.`);
+var FieldCapability = class {
+  static {
+    __name(this, "FieldCapability");
+  }
+  value;
+  constructor(value) {
+    this.value = value;
+  }
+  apply(draft) {
+    setOnce(draft, this.field, this.value, this.name);
+  }
+};
+var MemoryCapability = class extends FieldCapability {
+  static {
+    __name(this, "MemoryCapability");
+  }
+  name = "memory";
+  field = "memory";
+};
+var ContextWindowCapability = class {
+  static {
+    __name(this, "ContextWindowCapability");
+  }
+  options;
+  name = "context-window";
+  constructor(options) {
+    this.options = options;
+  }
+  apply(draft) {
+    setOnce(draft, "context", compileContextWindow(this.options).context, this.name);
+  }
+};
+var ProjectContextCapability = class extends FieldCapability {
+  static {
+    __name(this, "ProjectContextCapability");
+  }
+  name = "project-context";
+  field = "projectContext";
+};
+var McpServersCapability = class extends FieldCapability {
+  static {
+    __name(this, "McpServersCapability");
+  }
+  name = "mcp";
+  field = "mcpServers";
+};
+var GuardrailsCapability = class extends FieldCapability {
+  static {
+    __name(this, "GuardrailsCapability");
+  }
+  name = "guardrails";
+  field = "guardrails";
+};
+var CheckpointCapability = class {
+  static {
+    __name(this, "CheckpointCapability");
+  }
+  options;
+  name = "checkpoint";
+  constructor(options) {
+    this.options = options;
+  }
+  apply(draft) {
+    if (this.options !== void 0 && this.options.storage !== "filesystem") {
+      console.warn(`[THEO_AGENT_CHECKPOINT_STORAGE_METADATA_ONLY] checkpoint({ storage: '${this.options.storage ?? "memory"}' }) does NOT resume across requests \u2014 only 'filesystem' selects the SDK's durable conversation store. Use checkpoint({ storage: 'filesystem' }) for cross-request resume.`);
     }
-    setOnce(draft, "checkpoint", options, "checkpoint");
-  }, "apply")
-}), "checkpoint");
-var humanInTheLoop = fieldCapability("human-in-the-loop", "hitl");
-var subAgents = /* @__PURE__ */ __name((children) => ({
-  name: "sub-agents",
-  apply: /* @__PURE__ */ __name((draft) => {
-    for (const [name, child] of Object.entries(children)) {
+    setOnce(draft, "checkpoint", this.options, this.name);
+  }
+};
+var HumanInTheLoopCapability = class extends FieldCapability {
+  static {
+    __name(this, "HumanInTheLoopCapability");
+  }
+  name = "human-in-the-loop";
+  field = "hitl";
+};
+var SubAgentsCapability = class {
+  static {
+    __name(this, "SubAgentsCapability");
+  }
+  children;
+  name = "sub-agents";
+  constructor(children) {
+    this.children = children;
+  }
+  apply(draft) {
+    for (const [name, child] of Object.entries(this.children)) {
       if (name in draft.agents && draft.agents[name] !== child) {
         throw new ConfigurationError(`sub-agents: filho "${name}" declarado duas vezes com defini\xE7\xF5es diferentes`);
       }
       draft.agents[name] = child;
     }
     draft.provenance.push({
-      capability: "sub-agents",
+      capability: this.name,
       contributed: [
         "agents"
       ]
     });
-  }, "apply")
-}), "subAgents");
-var skillsOptions = /* @__PURE__ */ __name((options) => ({
-  name: "skills",
-  apply: /* @__PURE__ */ __name((draft) => {
-    setOnce(draft, "skills", compileSkills(options), "skills");
-  }, "apply")
-}), "skillsOptions");
-var settingSources = fieldCapability("setting-sources", "settingSources");
-var plugins = fieldCapability("plugins", "plugins");
-var runContext = fieldCapability("run-context", "runContext");
-var skillsResolver = fieldCapability("skills-resolver", "skillsResolver");
+  }
+};
+var SkillsOptionsCapability = class {
+  static {
+    __name(this, "SkillsOptionsCapability");
+  }
+  options;
+  name = "skills";
+  constructor(options) {
+    this.options = options;
+  }
+  apply(draft) {
+    setOnce(draft, "skills", compileSkills(this.options), this.name);
+  }
+};
+var SettingSourcesCapability = class extends FieldCapability {
+  static {
+    __name(this, "SettingSourcesCapability");
+  }
+  name = "setting-sources";
+  field = "settingSources";
+};
+var PluginsCapability = class extends FieldCapability {
+  static {
+    __name(this, "PluginsCapability");
+  }
+  name = "plugins";
+  field = "plugins";
+};
+var RunContextCapability = class extends FieldCapability {
+  static {
+    __name(this, "RunContextCapability");
+  }
+  name = "run-context";
+  field = "runContext";
+};
+var SkillsResolverCapability = class extends FieldCapability {
+  static {
+    __name(this, "SkillsResolverCapability");
+  }
+  name = "skills-resolver";
+  field = "skillsResolver";
+};
 var AgentConfigCapability = class {
   static {
     __name(this, "AgentConfigCapability");
@@ -773,6 +863,7 @@ export {
   AGENT_BRAND,
   AcpClient,
   AcpMessageDecoder,
+  AgentBuilder,
   AgentConfigCapability,
   AgentDefinitionError,
   AgentRunner,
@@ -781,25 +872,39 @@ export {
   CapabilityConflictError,
   CapabilityPreset,
   CapabilityRegistry,
+  CheckpointCapability,
   ConfigurationError,
+  ContextWindowCapability,
+  ContextualTool,
   CostBudgetExceededError,
   DEFAULT_KEEP_TOKENS,
   DEFAULT_MAX_ITERATIONS,
   DelegationError,
+  FieldCapability,
   GuardrailViolationError,
+  GuardrailsCapability,
+  HumanInTheLoopCapability,
   MCP_PROTOCOL_VERSION,
   MainLoopCapability,
+  McpServersCapability,
+  MemoryCapability,
   ModelCapability,
+  PluginsCapability,
+  ProjectContextCapability,
+  RunContextCapability,
+  SettingSourcesCapability,
+  SkillsCapability,
+  SkillsOptionsCapability,
+  SkillsResolverCapability,
+  SubAgentsCapability,
   ToolboxCapability,
   ToolsCapability,
   UnknownCapabilityError,
-  agent,
   agentsPlugin,
   applyCapabilities,
   buildAgentCard,
   buildMcpToolDescriptors,
   buildModelSelection,
-  checkpoint,
   compactionStrategyConfigSchema,
   compileAgentDefinition,
   compileAgentModule,
@@ -807,8 +912,6 @@ export {
   compileProjectContext,
   compileSkills,
   compileTools,
-  contextWindow,
-  contextualTool,
   costGuard,
   createA2ATool,
   createAgentExecutionContext,
@@ -826,8 +929,6 @@ export {
   extractThinkTagStream,
   generateAgentManifest,
   generateAgentRoutes,
-  guardrails,
-  humanInTheLoop,
   isAgentContext,
   isAgentDefinition,
   isApprovalRequired,
@@ -841,17 +942,13 @@ export {
   loopStrategyConfigSchema,
   mcpRegistry,
   mcpServerInfo,
-  mcpServers,
   mcpToolApprovals,
-  memory,
   moderateOutputStream,
   noopReflectionStrategy,
   outputModeration,
   parseConversationId,
   piiDetector,
-  plugins,
   presentUIMessageStream,
-  projectContext,
   projectContextMetadataOnlyKnobs,
   promptInjectionDetector,
   reflectionStrategyConfigSchema,
@@ -859,18 +956,12 @@ export {
   resolveEnabledSkills,
   resolveLoopStrategy,
   resolveMcpServers,
-  runContext,
   runInputGuards,
   runOutputGuards,
   runWithApiErrorHandling,
   setOnce,
-  settingSources,
-  skills,
-  skillsOptions,
-  skillsResolver,
   streamAgentResponse,
   streamAgentUIMessages,
-  subAgents,
   toAgentFactory,
   tokenBudgetCompactionStrategy,
   translateSdkEvent,