@theokit/sdk 3.5.0 → 3.6.0

package/dist/a2a/index.js

@@ -959,10 +959,10 @@ function buildToolPrompt(prompt) {
 Respond by calling the \`output\` tool with the structured answer that matches the schema.`;
 }
 function setupStructuredOutput(schema, maxRetries) {
-  const z7 = requireZod();
+  const z8 = requireZod();
   const jsonSchema = toJsonSchema(schema, { unrepresentable: "any" });
   return {
-    z: z7,
+    z: z8,
     jsonSchema,
     maxRetries: maxRetries ?? 1,
     initialUsage: { inputTokens: 0, outputTokens: 0 }
@@ -5752,6 +5752,213 @@ var init_subagents_loader = __esm({
     init_yaml_frontmatter();
   }
 });
+function loadJsonrepair() {
+  if (cachedJsonrepair === void 0) {
+    const req = createRequire(import.meta.url);
+    cachedJsonrepair = req("jsonrepair").jsonrepair;
+  }
+  return cachedJsonrepair;
+}
+function isPlainObject(v) {
+  return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+function toFiniteNumber(raw) {
+  if (raw === "") return void 0;
+  const n = Number(raw);
+  return Number.isFinite(n) && String(n) === raw ? n : void 0;
+}
+function tryJson(raw, repair) {
+  const t = raw.trimStart();
+  if (!(t.startsWith("{") || t.startsWith("["))) return void 0;
+  try {
+    return JSON.parse(repair ? loadJsonrepair()(t) : t);
+  } catch {
+    return void 0;
+  }
+}
+function heuristicCoerce(raw, repairJson) {
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  if (raw === "null") return null;
+  const n = toFiniteNumber(raw);
+  if (n !== void 0) return n;
+  const json = tryJson(raw, false) ?? (repairJson ? tryJson(raw, true) : void 0);
+  return json === void 0 ? raw : json;
+}
+function coerceCandidates(raw, repairJson) {
+  const out = [];
+  if (raw === "true") out.push(true);
+  else if (raw === "false") out.push(false);
+  else if (raw === "null") out.push(null);
+  const n = toFiniteNumber(raw);
+  if (n !== void 0) out.push(n);
+  const json = tryJson(raw, false) ?? (repairJson ? tryJson(raw, true) : void 0);
+  if (json !== void 0) out.push(json);
+  out.push(raw);
+  return out;
+}
+function objectShape(schema) {
+  const shape = schema?.shape;
+  return shape !== null && typeof shape === "object" ? shape : void 0;
+}
+var cachedJsonrepair;
+var init_coerce = __esm({
+  "src/sanitize/coerce.ts"() {
+  }
+});
+
+// src/sanitize/sanitize-tool-input.ts
+function applyTrim(key, value, ctx) {
+  const trimmed = value.trim();
+  if (trimmed !== value) ctx.notes.push(`trimmed "${key}"`);
+  return trimmed;
+}
+function applyCoerce(key, raw, ctx) {
+  const field = ctx.shape?.[key];
+  let coerced = raw;
+  if (field) {
+    for (const candidate of coerceCandidates(raw, ctx.repairJson)) {
+      if (field.safeParse(candidate).success) {
+        coerced = candidate;
+        break;
+      }
+    }
+  } else {
+    coerced = heuristicCoerce(raw, ctx.repairJson);
+  }
+  if (coerced !== raw) ctx.notes.push(`coerced "${key}"`);
+  return coerced;
+}
+function applyRepair(key, value, ctx) {
+  const repaired = tryJson(value, true);
+  if (repaired === void 0) return value;
+  ctx.notes.push(`repaired json "${key}"`);
+  return repaired;
+}
+function sanitizeString(key, value, ctx) {
+  let out = ctx.trim ? applyTrim(key, value, ctx) : value;
+  if (ctx.coerce && typeof out === "string") out = applyCoerce(key, out, ctx);
+  if (ctx.repairJson && !ctx.coerce && typeof out === "string") out = applyRepair(key, out, ctx);
+  return out;
+}
+function walk(input, ctx, depth) {
+  const out = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (typeof value === "string") out[key] = sanitizeString(key, value, ctx);
+    else if (ctx.deep && depth < ctx.maxDepth && isPlainObject(value))
+      out[key] = walk(value, ctx, depth + 1);
+    else out[key] = value;
+  }
+  return out;
+}
+function sanitizeToolInput(input, options) {
+  if (!isPlainObject(input)) return { value: input, changed: false, notes: [] };
+  const ctx = {
+    trim: options?.trim ?? true,
+    coerce: options?.coerce ?? false,
+    repairJson: options?.repairJson ?? false,
+    deep: options?.deep ?? false,
+    maxDepth: options?.maxDepth ?? 8,
+    shape: objectShape(options?.schema),
+    notes: []
+  };
+  const value = walk(input, ctx, 0);
+  return { value, changed: ctx.notes.length > 0, notes: ctx.notes };
+}
+var init_sanitize_tool_input = __esm({
+  "src/sanitize/sanitize-tool-input.ts"() {
+    init_coerce();
+  }
+});
+
+// src/define-tool.ts
+async function runValidated(spec, input, ctx) {
+  const raw = spec.sanitize ? sanitizeToolInput(input, {
+    ...spec.sanitize === true ? {} : spec.sanitize,
+    schema: spec.inputSchema
+  }).value : input;
+  const parsed = spec.inputSchema.parse(raw);
+  const out = await spec.handler(parsed, ctx);
+  return spec.outputSchema === void 0 ? out : spec.outputSchema.parse(out);
+}
+function serializeOutput(validated) {
+  return typeof validated === "string" ? validated : JSON.stringify(validated);
+}
+function shapeModelOutput(spec, validated) {
+  if (spec.toModelOutput !== void 0) return spec.toModelOutput(validated);
+  return serializeOutput(validated);
+}
+function defineTool(spec) {
+  const inputSchema = toJsonSchema(spec.inputSchema, {
+    unrepresentable: "any"
+  });
+  const handler = async (input, ctx) => {
+    const validated = await runValidated(spec, input, ctx);
+    return shapeModelOutput(spec, validated);
+  };
+  const tool = { name: spec.name, description: spec.description, inputSchema, handler };
+  if (spec.toModelOutput !== void 0) {
+    const resolver = async (input, ctx) => {
+      const validated = await runValidated(spec, input, ctx);
+      return { model: shapeModelOutput(spec, validated), app: serializeOutput(validated) };
+    };
+    handler[TOOL_SPLIT_RESOLVER] = resolver;
+  }
+  return tool;
+}
+var TOOL_SPLIT_RESOLVER, Tool;
+var init_define_tool = __esm({
+  "src/define-tool.ts"() {
+    init_to_json_schema();
+    init_sanitize_tool_input();
+    TOOL_SPLIT_RESOLVER = /* @__PURE__ */ Symbol("theokit.toolSplitResolver");
+    Tool = class {
+      constructor() {
+      }
+      static create(spec) {
+        return defineTool(spec);
+      }
+    };
+  }
+});
+function createThinkTool() {
+  return Tool.create({
+    name: "think",
+    description: "Scratchpad: reason through ONE step before answering. No side effects \u2014 your private reasoning space. Call it repeatedly before the final answer.",
+    inputSchema: z.object({ thought: z.string().min(1, "think: `thought` must be non-empty.") }),
+    handler: ({ thought }) => thought
+  });
+}
+function isNativeReasoning(model) {
+  if (model === void 0 || typeof model === "string") return false;
+  const params = model.params;
+  if (params === void 0) return false;
+  return params.some((p) => NATIVE_REASONING_PARAM_IDS.has(p.id));
+}
+function warnDoubleReasoningOnce() {
+  if (warned2.has("double-reasoning")) return;
+  warned2.add("double-reasoning");
+  process.stderr.write(
+    "[theokit-sdk] `reasoning: true` skipped \u2014 a native reasoning model is configured (model.params thinking/reasoning); native reasoning wins. Remove one to silence.\n"
+  );
+}
+function reasoningActive(reasoning, model) {
+  if (reasoning !== true) return false;
+  if (isNativeReasoning(model)) {
+    warnDoubleReasoningOnce();
+    return false;
+  }
+  return true;
+}
+var NATIVE_REASONING_PARAM_IDS, REASONING_PREAMBLE, warned2;
+var init_native_reasoning = __esm({
+  "src/internal/runtime/reasoning/native-reasoning.ts"() {
+    init_define_tool();
+    NATIVE_REASONING_PARAM_IDS = /* @__PURE__ */ new Set(["thinking", "reasoning", "reasoning_effort"]);
+    REASONING_PREAMBLE = "Think step by step before answering: use the `think` tool to reason through each step, validate your work, then answer. Reason about magnitude before comparing numbers.";
+    warned2 = /* @__PURE__ */ new Set();
+  }
+});
 
 // src/internal/runtime/skills/skill-frontmatter.ts
 function asString(v) {
@@ -6003,6 +6210,9 @@ async function buildAssemblyContext(inputs, userText, baseSystemPrompt, memoryFa
   if (activeMemorySummary !== void 0 && activeMemorySummary.length > 0) {
     assemblyCtx.activeMemorySummary = activeMemorySummary;
   }
+  if (reasoningActive(inputs.options.reasoning, inputs.model)) {
+    assemblyCtx.reasoning = true;
+  }
   if (inputs.context !== void 0) {
     await inputs.context.applyScope(contextPaths);
     const internal = inputs.context.internalAssemblySnapshot();
@@ -6024,6 +6234,7 @@ async function assembleSystemPromptForSend(inputs, userText, baseSystemPrompt, m
 }
 var init_local_assembly = __esm({
   "src/internal/runtime/system-prompt/local-assembly.ts"() {
+    init_native_reasoning();
     init_skills_manager();
   }
 });
@@ -6159,6 +6370,21 @@ ${lines.join("\n")}
   }
 });
 
+// src/internal/runtime/system-prompt/sources/reasoning-provider.ts
+var ReasoningPromptProvider;
+var init_reasoning_provider = __esm({
+  "src/internal/runtime/system-prompt/sources/reasoning-provider.ts"() {
+    init_native_reasoning();
+    ReasoningPromptProvider = class {
+      id = "reasoning";
+      priority = 1;
+      contribute(ctx) {
+        return Promise.resolve(ctx.reasoning === true ? REASONING_PREAMBLE : void 0);
+      }
+    };
+  }
+});
+
 // src/internal/runtime/skills/skills-block.ts
 function buildSkillsBlock(skills) {
   if (skills.length === 0) return void 0;
@@ -6201,6 +6427,7 @@ var init_pipeline = __esm({
     init_base_provider();
     init_context_provider();
     init_memory_provider();
+    init_reasoning_provider();
     init_skills_provider();
     SystemPromptPipeline = class _SystemPromptPipeline {
       providers;
@@ -6240,6 +6467,7 @@ var init_pipeline = __esm({
        */
       static default() {
         return new _SystemPromptPipeline([
+          new ReasoningPromptProvider(),
           new ActiveMemoryPromptProvider(),
           new ContextPromptProvider(),
           new SkillsPromptProvider(),
@@ -8566,132 +8794,6 @@ var init_repair_middleware = __esm({
     DECIMAL_RE = /^-?\d+(\.\d+)?$/;
   }
 });
-function loadJsonrepair() {
-  if (cachedJsonrepair === void 0) {
-    const req = createRequire(import.meta.url);
-    cachedJsonrepair = req("jsonrepair").jsonrepair;
-  }
-  return cachedJsonrepair;
-}
-function isPlainObject(v) {
-  return v !== null && typeof v === "object" && !Array.isArray(v);
-}
-function toFiniteNumber(raw) {
-  if (raw === "") return void 0;
-  const n = Number(raw);
-  return Number.isFinite(n) && String(n) === raw ? n : void 0;
-}
-function tryJson(raw, repair) {
-  const t = raw.trimStart();
-  if (!(t.startsWith("{") || t.startsWith("["))) return void 0;
-  try {
-    return JSON.parse(repair ? loadJsonrepair()(t) : t);
-  } catch {
-    return void 0;
-  }
-}
-function heuristicCoerce(raw, repairJson) {
-  if (raw === "true") return true;
-  if (raw === "false") return false;
-  if (raw === "null") return null;
-  const n = toFiniteNumber(raw);
-  if (n !== void 0) return n;
-  const json = tryJson(raw, false) ?? (repairJson ? tryJson(raw, true) : void 0);
-  return json === void 0 ? raw : json;
-}
-function coerceCandidates(raw, repairJson) {
-  const out = [];
-  if (raw === "true") out.push(true);
-  else if (raw === "false") out.push(false);
-  else if (raw === "null") out.push(null);
-  const n = toFiniteNumber(raw);
-  if (n !== void 0) out.push(n);
-  const json = tryJson(raw, false) ?? (repairJson ? tryJson(raw, true) : void 0);
-  if (json !== void 0) out.push(json);
-  out.push(raw);
-  return out;
-}
-function objectShape(schema) {
-  const shape = schema?.shape;
-  return shape !== null && typeof shape === "object" ? shape : void 0;
-}
-var cachedJsonrepair;
-var init_coerce = __esm({
-  "src/sanitize/coerce.ts"() {
-  }
-});
-
-// src/sanitize/sanitize-tool-input.ts
-function applyTrim(key, value, ctx) {
-  const trimmed = value.trim();
-  if (trimmed !== value) ctx.notes.push(`trimmed "${key}"`);
-  return trimmed;
-}
-function applyCoerce(key, raw, ctx) {
-  const field = ctx.shape?.[key];
-  let coerced = raw;
-  if (field) {
-    for (const candidate of coerceCandidates(raw, ctx.repairJson)) {
-      if (field.safeParse(candidate).success) {
-        coerced = candidate;
-        break;
-      }
-    }
-  } else {
-    coerced = heuristicCoerce(raw, ctx.repairJson);
-  }
-  if (coerced !== raw) ctx.notes.push(`coerced "${key}"`);
-  return coerced;
-}
-function applyRepair(key, value, ctx) {
-  const repaired = tryJson(value, true);
-  if (repaired === void 0) return value;
-  ctx.notes.push(`repaired json "${key}"`);
-  return repaired;
-}
-function sanitizeString(key, value, ctx) {
-  let out = ctx.trim ? applyTrim(key, value, ctx) : value;
-  if (ctx.coerce && typeof out === "string") out = applyCoerce(key, out, ctx);
-  if (ctx.repairJson && !ctx.coerce && typeof out === "string") out = applyRepair(key, out, ctx);
-  return out;
-}
-function walk(input, ctx, depth) {
-  const out = {};
-  for (const [key, value] of Object.entries(input)) {
-    if (typeof value === "string") out[key] = sanitizeString(key, value, ctx);
-    else if (ctx.deep && depth < ctx.maxDepth && isPlainObject(value))
-      out[key] = walk(value, ctx, depth + 1);
-    else out[key] = value;
-  }
-  return out;
-}
-function sanitizeToolInput(input, options) {
-  if (!isPlainObject(input)) return { value: input, changed: false, notes: [] };
-  const ctx = {
-    trim: options?.trim,
-    coerce: options?.coerce ?? false,
-    repairJson: options?.repairJson ?? false,
-    deep: options?.deep ?? false,
-    maxDepth: options?.maxDepth ?? 8,
-    shape: objectShape(options?.schema),
-    notes: []
-  };
-  const value = walk(input, ctx, 0);
-  return { value, changed: ctx.notes.length > 0, notes: ctx.notes };
-}
-var init_sanitize_tool_input = __esm({
-  "src/sanitize/sanitize-tool-input.ts"() {
-    init_coerce();
-  }
-});
-
-// src/define-tool.ts
-var TOOL_SPLIT_RESOLVER;
-var init_define_tool = __esm({
-  "src/define-tool.ts"() {
-    TOOL_SPLIT_RESOLVER = /* @__PURE__ */ Symbol("theokit.toolSplitResolver");
-  }
-});
 
 // src/tool-error.ts
 function renderToolErrorMessage(content) {
@@ -13129,6 +13231,39 @@ var init_register_plugin_providers = __esm({
   }
 });
 
+// src/internal/runtime/local-agent/real-local-run-provider.ts
+function inferProviderFromApiKey(apiKey) {
+  if (apiKey === void 0 || apiKey.length === 0) return void 0;
+  const byPrefix = [
+    { provider: "openrouter", prefix: "sk-or-" },
+    { provider: "anthropic", prefix: "sk-ant-" },
+    { provider: "openai", prefix: "sk-" }
+  ];
+  for (const { provider, prefix } of byPrefix) {
+    if (apiKey.startsWith(prefix) && getProviderProfile(provider) !== void 0) {
+      return provider;
+    }
+  }
+  return void 0;
+}
+function detectPrimaryProvider() {
+  if (process.env.ANTHROPIC_API_KEY !== void 0 && process.env.ANTHROPIC_API_KEY.length > 0) {
+    return "anthropic";
+  }
+  if (process.env.OPENAI_API_KEY !== void 0 && process.env.OPENAI_API_KEY.length > 0) {
+    return "openai";
+  }
+  if (process.env.OPENROUTER_API_KEY !== void 0 && process.env.OPENROUTER_API_KEY.length > 0) {
+    return "openrouter";
+  }
+  return "openai";
+}
+var init_real_local_run_provider = __esm({
+  "src/internal/runtime/local-agent/real-local-run-provider.ts"() {
+    init_providers();
+  }
+});
+
 // src/internal/tool-registry/personality-filter.ts
 function applyPersonalityFilter(exposedTools, whitelist, opts) {
   if (whitelist === void 0) return exposedTools;
@@ -13184,36 +13319,49 @@ var init_personality_filter = __esm({
   }
 });
 
-// src/internal/runtime/local-agent/real-local-run-provider.ts
-function inferProviderFromApiKey(apiKey) {
-  if (apiKey === void 0 || apiKey.length === 0) return void 0;
-  const byPrefix = [
-    { provider: "openrouter", prefix: "sk-or-" },
-    { provider: "anthropic", prefix: "sk-ant-" },
-    { provider: "openai", prefix: "sk-" }
-  ];
-  for (const { provider, prefix } of byPrefix) {
-    if (apiKey.startsWith(prefix) && getProviderProfile(provider) !== void 0) {
-      return provider;
-    }
-  }
-  return void 0;
+// src/internal/runtime/local-agent/real-local-run-tools.ts
+function declarativeSubagentTools(agents2, parentTools) {
+  if (agents2 === void 0 || Object.keys(agents2).length === 0) return [];
+  return subAgentToolsFromDefinitions(agents2, parentTools);
 }
-function detectPrimaryProvider() {
-  if (process.env.ANTHROPIC_API_KEY !== void 0 && process.env.ANTHROPIC_API_KEY.length > 0) {
-    return "anthropic";
-  }
-  if (process.env.OPENAI_API_KEY !== void 0 && process.env.OPENAI_API_KEY.length > 0) {
-    return "openai";
-  }
-  if (process.env.OPENROUTER_API_KEY !== void 0 && process.env.OPENROUTER_API_KEY.length > 0) {
-    return "openrouter";
+function bindParentCredentials(tools, agentOptions) {
+  const parentPlugins = Array.isArray(agentOptions.plugins) ? agentOptions.plugins : void 0;
+  const credentials = {
+    ...agentOptions.apiKey !== void 0 ? { apiKey: agentOptions.apiKey } : {},
+    ...typeof agentOptions.model === "object" ? { model: agentOptions.model } : {},
+    ...parentPlugins !== void 0 ? { plugins: parentPlugins } : {}
+  };
+  for (const tool of tools) inheritSubAgentCredentials(tool, credentials);
+}
+function buildCustomToolsInput(agentOptions, sendOptions, pluginManager, personalityToolWhitelist, agentId, personalityName, subagents, effectiveModel) {
+  const baseTools = sendOptions?.tools ?? agentOptions.tools ?? [];
+  const agentsForTools = subagents !== void 0 && Object.keys(subagents).length > 0 ? subagents : agentOptions.agents;
+  const subagentTools = declarativeSubagentTools(agentsForTools, baseTools);
+  const pluginTools = pluginManager?.aggregated.tools ?? [];
+  const reasoningTools = reasoningActive(agentOptions.reasoning, effectiveModel) ? [createThinkTool()] : [];
+  if (baseTools.length === 0 && subagentTools.length === 0 && pluginTools.length === 0 && reasoningTools.length === 0) {
+    return {};
   }
-  return "openai";
+  const allTools = [...baseTools, ...subagentTools, ...pluginTools, ...reasoningTools];
+  bindParentCredentials(allTools, agentOptions);
+  const merged = allTools.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    handler: tool.handler
+  }));
+  const customTools = applyPersonalityFilter(merged, personalityToolWhitelist, {
+    agentId,
+    personalityName
+  });
+  if (customTools.length === 0 && personalityToolWhitelist === void 0) return {};
+  return { customTools };
 }
-var init_real_local_run_provider = __esm({
-  "src/internal/runtime/local-agent/real-local-run-provider.ts"() {
-    init_providers();
+var init_real_local_run_tools = __esm({
+  "src/internal/runtime/local-agent/real-local-run-tools.ts"() {
+    init_subagent();
+    init_personality_filter();
+    init_native_reasoning();
   }
 });
 
@@ -13332,7 +13480,8 @@ function buildLoopInputs(options, runId, userText) {
       options.personalityToolWhitelist,
       options.agentId,
       options.personalityName,
-      options.subagents
+      options.subagents,
+      options.model
     ),
     ...options.pluginManager !== void 0 ? { pluginManager: options.pluginManager } : {},
     // D318 — forward SendOptions.signal to the agent loop so streamLlmTurn
@@ -13370,40 +13519,6 @@ function buildLoopInputs(options, runId, userText) {
     ...options.agentOptions.memoryProvider !== void 0 ? { memoryProvider: options.agentOptions.memoryProvider } : {}
   };
 }
-function declarativeSubagentTools(agents2, parentTools) {
-  if (agents2 === void 0 || Object.keys(agents2).length === 0) return [];
-  return subAgentToolsFromDefinitions(agents2, parentTools);
-}
-function bindParentCredentials(tools, agentOptions) {
-  const parentPlugins = Array.isArray(agentOptions.plugins) ? agentOptions.plugins : void 0;
-  const credentials = {
-    ...agentOptions.apiKey !== void 0 ? { apiKey: agentOptions.apiKey } : {},
-    ...typeof agentOptions.model === "object" ? { model: agentOptions.model } : {},
-    ...parentPlugins !== void 0 ? { plugins: parentPlugins } : {}
-  };
-  for (const tool of tools) inheritSubAgentCredentials(tool, credentials);
-}
-function buildCustomToolsInput(agentOptions, sendOptions, pluginManager, personalityToolWhitelist, agentId, personalityName, subagents) {
-  const baseTools = sendOptions?.tools ?? agentOptions.tools ?? [];
-  const agentsForTools = subagents !== void 0 && Object.keys(subagents).length > 0 ? subagents : agentOptions.agents;
-  const subagentTools = declarativeSubagentTools(agentsForTools, baseTools);
-  const pluginTools = pluginManager?.aggregated.tools ?? [];
-  if (baseTools.length === 0 && subagentTools.length === 0 && pluginTools.length === 0) return {};
-  const allTools = [...baseTools, ...subagentTools, ...pluginTools];
-  bindParentCredentials(allTools, agentOptions);
-  const merged = allTools.map((tool) => ({
-    name: tool.name,
-    description: tool.description,
-    inputSchema: tool.inputSchema,
-    handler: tool.handler
-  }));
-  const customTools = applyPersonalityFilter(merged, personalityToolWhitelist, {
-    agentId,
-    personalityName
-  });
-  if (customTools.length === 0 && personalityToolWhitelist === void 0) return {};
-  return { customTools };
-}
 function buildMcpMap(options) {
   const map = /* @__PURE__ */ new Map();
   const inline = options.sendOptions.mcpServers ?? options.agentOptions.mcpServers;
@@ -13416,7 +13531,6 @@ function buildMcpMap(options) {
 var pluginProvidersAnnounced, RealLocalRun;
 var init_real_local_run = __esm({
   "src/internal/runtime/local-agent/real-local-run.ts"() {
-    init_subagent();
     init_errors();
     init_run_events();
     init_loop();
@@ -13429,11 +13543,11 @@ var init_real_local_run = __esm({
     init_providers();
     init_register_plugin_providers();
     init_tracer();
-    init_personality_filter();
     init_async_local_storage();
     init_fixture_run_base();
     init_run_registry();
     init_real_local_run_provider();
+    init_real_local_run_tools();
     pluginProvidersAnnounced = false;
     RealLocalRun = class extends FixtureRunBase {
       buildInputs;