@theokit/sdk 4.54.0 → 4.55.0

package/dist/{chunk-UFAO4T7Z.cjs → chunk-F5WMX4EA.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk5BJV5UPY_cjs = require('./chunk-5BJV5UPY.cjs');
+var chunkV2UUGUY4_cjs = require('./chunk-V2UUGUY4.cjs');
 var chunk5UOVYM3P_cjs = require('./chunk-5UOVYM3P.cjs');
 var chunk53CBTBWO_cjs = require('./chunk-53CBTBWO.cjs');
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
 var chunkNGESVVJN_cjs = require('./chunk-NGESVVJN.cjs');
 var chunkEI2Q7SJ5_cjs = require('./chunk-EI2Q7SJ5.cjs');
 var chunkYPJ5NH5N_cjs = require('./chunk-YPJ5NH5N.cjs');
-var chunkUNDROG5N_cjs = require('./chunk-UNDROG5N.cjs');
+var chunkHLPSLDGL_cjs = require('./chunk-HLPSLDGL.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
 var chunkQ47R5E2X_cjs = require('./chunk-Q47R5E2X.cjs');
 var chunkU2AC6JUP_cjs = require('./chunk-U2AC6JUP.cjs');
@@ -28,8 +28,8 @@ var chunkHJBMA5MB_cjs = require('./chunk-HJBMA5MB.cjs');
 var chunkIWBGCBR6_cjs = require('./chunk-IWBGCBR6.cjs');
 var chunkXSX2UU6Y_cjs = require('./chunk-XSX2UU6Y.cjs');
 var chunk3EE6LVWT_cjs = require('./chunk-3EE6LVWT.cjs');
-var chunk3KGLRRFC_cjs = require('./chunk-3KGLRRFC.cjs');
-var chunkRM7Y65IG_cjs = require('./chunk-RM7Y65IG.cjs');
+var chunk6HTXPPHK_cjs = require('./chunk-6HTXPPHK.cjs');
+var chunkNIRE5CNO_cjs = require('./chunk-NIRE5CNO.cjs');
 var chunkK3FW2XZD_cjs = require('./chunk-K3FW2XZD.cjs');
 var chunkJTB5Q42C_cjs = require('./chunk-JTB5Q42C.cjs');
 var chunkNUKRL3I6_cjs = require('./chunk-NUKRL3I6.cjs');
@@ -1607,7 +1607,7 @@ function createRealCloudRun(options) {
     conversation: []
   };
   const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(options.agentOptions.apiKey);
-  const baseUrl = chunkUNDROG5N_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkHLPSLDGL_cjs.getConfiguredBaseUrl();
   const handle = new RealCloudRun(
     {
       id,
@@ -1690,7 +1690,7 @@ var RealCloudRun = class extends FixtureRunBase {
   async consumeStream(response) {
     let finalStatus = "finished";
     let finalText = "";
-    for await (const record of chunkUNDROG5N_cjs.parseSseStream(response.body, this.controller.signal)) {
+    for await (const record of chunkHLPSLDGL_cjs.parseSseStream(response.body, this.controller.signal)) {
       const parsed = safeParse(record.data);
       if (parsed === void 0) continue;
       const update = this.applyRecord(record.event, parsed);
@@ -1836,7 +1836,7 @@ var CloudAgent = class {
    */
   isFixtureMode() {
     const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(this.options.apiKey);
-    return chunkUNDROG5N_cjs.isFixtureApiKey(apiKey) && chunkUNDROG5N_cjs.getConfiguredBaseUrl() === void 0;
+    return chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey) && chunkHLPSLDGL_cjs.getConfiguredBaseUrl() === void 0;
   }
   // SE9 — integrated structured output; delegates to the shared helper.
   generate(message, options) {
@@ -1888,7 +1888,7 @@ var CloudAgent = class {
     const userText = typeof message === "string" ? message : message.text;
     const systemPrompt = await this.resolveSystemPromptForSend(userText, options);
     const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(this.options.apiKey);
-    const useRealRuntime = apiKey !== void 0 && !chunkUNDROG5N_cjs.isFixtureApiKey(apiKey) && chunkUNDROG5N_cjs.getConfiguredBaseUrl() !== void 0;
+    const useRealRuntime = apiKey !== void 0 && !chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey) && chunkHLPSLDGL_cjs.getConfiguredBaseUrl() !== void 0;
     return useRealRuntime ? createRealCloudRun({
       agentId: this.agentId,
       model: this.model ?? { id: DEFAULT_AGENTIC_MODEL_ID },
@@ -2697,11 +2697,14 @@ function buildContextBudgetEvent(model, resolved) {
 }
 
 // src/internal/runtime/lifecycle/post-run-lifecycle.ts
+function sessionTranscriptAllowed(memory) {
+  return memory?.enabled !== false;
+}
 function resolveWindowForRun(model, contextWindow) {
   const override = contextWindow !== void 0 && contextWindow > 0 ? contextWindow : void 0;
   return chunkXSX2UU6Y_cjs.resolveEffectiveContextWindow({
     ...override !== void 0 ? { override } : {},
-    catalog: chunkRM7Y65IG_cjs.getCatalogModelInfo(model)?.limit?.context,
+    catalog: chunkNIRE5CNO_cjs.getCatalogModelInfo(model)?.limit?.context,
     margin: chunkXSX2UU6Y_cjs.CONTEXT_WINDOW_MARGIN,
     floor: chunkXSX2UU6Y_cjs.CONTEXT_WINDOW_FLOOR
   });
@@ -2727,7 +2730,7 @@ async function runPostRunLifecycle(inputs) {
     try {
       const partial = await safeConversation(run);
       if (partial !== void 0) {
-        chunk5BJV5UPY_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+        chunkV2UUGUY4_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
           userText,
           conversation: partial
         });
@@ -2737,11 +2740,11 @@ async function runPostRunLifecycle(inputs) {
       chunkNUKRL3I6_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
-    await chunk5BJV5UPY_cjs.flushSessionWrites();
+    await chunkV2UUGUY4_cjs.flushSessionWrites();
     return;
   }
   if (result.result !== void 0) {
-    chunk5BJV5UPY_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
+    chunkV2UUGUY4_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
   const resolvedWindow = resolveWindowForRun(model, contextWindow);
@@ -2752,7 +2755,7 @@ async function runPostRunLifecycle(inputs) {
   }
   const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
   const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
-  chunk5BJV5UPY_cjs.persistTurnToTranscript(
+  chunkV2UUGUY4_cjs.persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
     agentId,
@@ -2764,7 +2767,7 @@ async function runPostRunLifecycle(inputs) {
         // The EFFECTIVE window (after override, clamp and margin) — not the declared one. Swapping for
         // `contextWindow` here would budget against a number the clamp already rejected.
         contextWindow: effectiveWindow,
-        summarize: chunkUNDROG5N_cjs.buildDefaultSummarizer({
+        summarize: chunkHLPSLDGL_cjs.buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
@@ -2772,7 +2775,7 @@ async function runPostRunLifecycle(inputs) {
     },
     onRunEvent !== void 0 ? () => chunkNGESVVJN_cjs.emitRunEvent(onRunEvent, { type: "compact_boundary", trigger: "auto" }) : void 0
   );
-  if (result.status === "finished" && result.result !== void 0) {
+  if (result.status === "finished" && result.result !== void 0 && sessionTranscriptAllowed(inputs.memory)) {
     const summaryArgs = {
       cwd: workspaceCwd,
       runId: result.id,
@@ -2806,7 +2809,7 @@ async function runPostRunLifecycle(inputs) {
     agentId,
     runId: result.id
   });
-  await chunk5BJV5UPY_cjs.flushSessionWrites();
+  await chunkV2UUGUY4_cjs.flushSessionWrites();
 }
 async function safeConversation(run) {
   try {
@@ -3292,11 +3295,17 @@ function validateSubagents(agents2) {
   }
 }
 var TOOL_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
-var RESERVED_TOOL_NAMES = /* @__PURE__ */ new Set(["shell", "memory_search", "memory_get"]);
-function validateToolCatalog(tools) {
+var BUILTIN_TOOL_NAMES = ["shell", "memory_search", "memory_get"];
+var RESERVED_TOOL_NAMES = new Set(BUILTIN_TOOL_NAMES);
+function reservedNamesFor(withheld) {
+  if (withheld === void 0 || withheld.length === 0) return RESERVED_TOOL_NAMES;
+  return new Set(BUILTIN_TOOL_NAMES.filter((name) => !withheld.includes(name)));
+}
+function validateToolCatalog(tools, withheldBuiltins) {
+  const reserved = reservedNamesFor(withheldBuiltins);
   const seen = /* @__PURE__ */ new Set();
   for (const tool of tools) {
-    validateSingleTool(tool);
+    validateSingleTool(tool, reserved);
     if (seen.has(tool.name)) {
       throw new chunkK3FW2XZD_cjs.ConfigurationError(`Duplicate custom tool name "${tool.name}"`, {
         code: "duplicate_tool_name"
@@ -3314,10 +3323,10 @@ function validateCustomTools(options) {
       { code: "cloud_custom_tools_rejected" }
     );
   }
-  validateToolCatalog(tools);
+  validateToolCatalog(tools, options.withheldBuiltinTools);
 }
-function validateSingleTool(tool) {
-  validateToolName(tool);
+function validateSingleTool(tool, reserved) {
+  validateToolName(tool, reserved);
   validateToolDescription(tool);
   validateToolSchema(tool);
   if (typeof tool.handler !== "function") {
@@ -3326,7 +3335,7 @@ function validateSingleTool(tool) {
     });
   }
 }
-function validateToolName(tool) {
+function validateToolName(tool, reserved) {
   if (typeof tool.name !== "string" || tool.name.length === 0) {
     throw new chunkK3FW2XZD_cjs.ConfigurationError("Custom tool requires a non-empty name", {
       code: "tool_missing_name"
@@ -3338,7 +3347,7 @@ function validateToolName(tool) {
       { code: "tool_invalid_name" }
     );
   }
-  if (RESERVED_TOOL_NAMES.has(tool.name) || tool.name.startsWith("mcp_")) {
+  if (reserved.has(tool.name) || tool.name.startsWith("mcp_")) {
     throw new chunkK3FW2XZD_cjs.ConfigurationError(
       `Custom tool name "${tool.name}" collides with a reserved SDK tool name`,
       { code: "tool_reserved_name" }
@@ -3393,7 +3402,7 @@ var HISTOGRAM_NAMES = {
 };
 function safeRequire(moduleName) {
   try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-UFAO4T7Z.cjs', document.baseURI).href)));
+    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-F5WMX4EA.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3621,7 +3630,7 @@ var cachedOtel;
 function loadOtel() {
   if (cachedOtel === void 0) {
     try {
-      const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-UFAO4T7Z.cjs', document.baseURI).href)));
+      const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-F5WMX4EA.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -4851,8 +4860,10 @@ async function initLoopContext(inputs) {
       memoryProviderHandle = void 0;
     }
   }
-  const tools = await collectTools(inputs.mcp, inputs.runEventSink);
+  const withheld = new Set(inputs.withheldBuiltinTools ?? []);
+  const tools = await collectTools(inputs.mcp, withheld, inputs.runEventSink);
   for (const memTool of inputs.memoryTools ?? []) {
+    if (withheld.has(memTool.name)) continue;
     tools.push({
       name: memTool.name,
       description: memTool.description,
@@ -4878,6 +4889,7 @@ async function initLoopContext(inputs) {
       providerTools = [];
     }
     for (const providerTool of providerTools) {
+      if (withheld.has(providerTool.name)) continue;
       tools.push({
         name: providerTool.name,
         description: providerTool.description,
@@ -4953,8 +4965,9 @@ async function safeListTools(client, serverName, sink) {
     return [];
   }
 }
-async function collectTools(mcp, sink) {
-  const tools = [
+function shellToolDescriptor(withheld) {
+  if (withheld.has("shell")) return [];
+  return [
     {
       name: "shell",
       description: "Run a shell command in the workspace and return stdout/stderr.",
@@ -4966,6 +4979,9 @@ async function collectTools(mcp, sink) {
       origin: "shell"
     }
   ];
+}
+async function collectTools(mcp, withheld, sink) {
+  const tools = shellToolDescriptor(withheld);
   for (const [serverName, client] of mcp.entries()) {
     const mcpTools = await safeListTools(client, serverName, sink);
     for (const tool of mcpTools) {
@@ -4984,6 +5000,13 @@ async function collectTools(mcp, sink) {
 function sanitize(name) {
   return name.replace(/[^a-zA-Z0-9-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "");
 }
+var KEY_PREFIX = "theokit-";
+var KEY_HEX_LENGTH = 32;
+function derivePromptCacheKey(sessionId) {
+  if (sessionId === void 0 || sessionId.trim().length === 0) return void 0;
+  const digest = crypto.createHash("sha256").update(sessionId, "utf8").digest("hex");
+  return `${KEY_PREFIX}${digest.slice(0, KEY_HEX_LENGTH)}`;
+}
 
 // src/internal/tool-dispatch/strip-think.ts
 var THINK_PATTERN = /<think>[\s\S]*?<\/think>\s*/g;
@@ -5055,6 +5078,16 @@ async function streamLlmTurn(inputs, ctx) {
       // Step-cap force-close: forward the per-run tool gate (`"none"` on a ceiling round forces a
       // text close even though tools are advertised). Absent ⇒ provider default (auto).
       ...inputs.toolChoice !== void 0 ? { toolChoice: inputs.toolChoice } : {},
+      // usetheokit/theokit-sdk#383 — the prompt-cache key, derived HERE and from `inputs.agentId`
+      // because this is the one place that sees the session identity on every round. `agentId` is
+      // the run's session identity (`Agent.getOrCreate(sessionId)`), so the derived key is identical
+      // on round 1 and round 12 of a turn, identical on turn 2 of the same session, and different
+      // for a different session. Deriving it per round from a stable input is what makes it a cache
+      // key; minting one anywhere that runs more than once per session would not be.
+      ...(() => {
+        const key = derivePromptCacheKey(inputs.agentId);
+        return key !== void 0 ? { promptCacheKey: key } : {};
+      })(),
       messages: ctx.messages,
       tools: ctx.tools.map(toLlmTool)
     },
@@ -5839,7 +5872,7 @@ function applyToolResultGuard(parts, opts) {
     (p) => (
       // SE7 — guard the TEXT of a tool result (string or the text blocks of a
       // structured content); image blocks pass through untouched.
-      p.type === "tool_result" ? { ...p, content: chunkUNDROG5N_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
+      p.type === "tool_result" ? { ...p, content: chunkHLPSLDGL_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
     )
   );
 }
@@ -6034,7 +6067,7 @@ function catalogCostFallback(provider, cleanedModel) {
   const candidates = [`${provider}/${cleanedModel}`, cleanedModel];
   if (stripped !== cleanedModel) candidates.push(`${provider}/${stripped}`, stripped);
   for (const key of candidates) {
-    const info = chunkRM7Y65IG_cjs.getCatalogModelInfo(key);
+    const info = chunkNIRE5CNO_cjs.getCatalogModelInfo(key);
     const cost = info?.cost;
     if (cost === void 0) continue;
     const [prov, ...modelParts] = key.split("/");
@@ -6046,7 +6079,7 @@ function catalogCostFallback(provider, cleanedModel) {
       ...cost.cache_read !== void 0 ? { cacheReadCostPerMillion: cost.cache_read } : {},
       ...cost.cache_write !== void 0 ? { cacheWriteCostPerMillion: cost.cache_write } : {},
       // M44 M5 fix — honest provenance: a key patched by the LIVE models-dev source is not "vendored".
-      pricingVersion: chunkRM7Y65IG_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
+      pricingVersion: chunkNIRE5CNO_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
     };
   }
   return void 0;
@@ -6505,12 +6538,12 @@ var FallbackLlmClient = class {
     let lastError;
     for (const client of this.clients) {
       if (signal.aborted) throw abortError(signal);
-      const attempt = await chunkUNDROG5N_cjs.tryFirstEvent(client, request, signal, true);
+      const attempt = await chunkHLPSLDGL_cjs.tryFirstEvent(client, request, signal, true);
       if (attempt.kind === "handshake_error") {
         lastError = attempt.error;
         continue;
       }
-      return yield* chunkUNDROG5N_cjs.relayStream(attempt.generator, attempt.firstResult);
+      return yield* chunkHLPSLDGL_cjs.relayStream(attempt.generator, attempt.firstResult);
     }
     if (lastError !== void 0) throw lastError;
     throw new chunkK3FW2XZD_cjs.NetworkError("FallbackLlmClient has no providers configured", {
@@ -6891,7 +6924,7 @@ function resolveMcpCwd(configCwd) {
 function registerPluginProviderProfiles(entries) {
   let registered2 = 0;
   for (const entry of entries) {
-    chunkRM7Y65IG_cjs.registerProvider(entry.profile);
+    chunkNIRE5CNO_cjs.registerProvider(entry.profile);
     registered2 += 1;
   }
   return registered2;
@@ -7025,14 +7058,20 @@ function resolveInheritedCredentials(agentOptions) {
     ...parentSandbox !== void 0 ? { sandbox: parentSandbox } : {}
   };
 }
-function buildCustomToolsInput(agentOptions, sendOptions, pluginManager, personalityToolWhitelist, agentId, personalityName, subagents, effectiveModel) {
+function withheldBuiltinsInput(agentOptions) {
+  const withheld = agentOptions.withheldBuiltinTools;
+  if (withheld === void 0 || withheld.length === 0) return {};
+  return { withheldBuiltinTools: withheld };
+}
+function buildRunToolCatalogInput(agentOptions, sendOptions, pluginManager, personalityToolWhitelist, agentId, personalityName, subagents, effectiveModel) {
+  const builtins = withheldBuiltinsInput(agentOptions);
   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 builtins;
   }
   const allTools = [...baseTools, ...subagentTools, ...pluginTools, ...reasoningTools];
   const merged = allTools.map((tool) => ({
@@ -7045,8 +7084,8 @@ function buildCustomToolsInput(agentOptions, sendOptions, pluginManager, persona
     agentId,
     personalityName
   });
-  if (customTools.length === 0 && personalityToolWhitelist === void 0) return {};
-  return { customTools };
+  if (customTools.length === 0 && personalityToolWhitelist === void 0) return builtins;
+  return { customTools, ...builtins };
 }
 
 // src/internal/local-agent/real-local-run.ts
@@ -7080,7 +7119,7 @@ function createRealLocalRun(options) {
 }
 var pluginProvidersAnnounced = false;
 function resolveRunProvider(options) {
-  chunkRM7Y65IG_cjs.registerBuiltins();
+  chunkNIRE5CNO_cjs.registerBuiltins();
   const profiles = options.pluginManager?.aggregated.providerProfiles ?? [];
   const registered2 = registerPluginProviderProfiles(profiles);
   if (registered2 > 0 && !pluginProvidersAnnounced) {
@@ -7090,16 +7129,16 @@ function resolveRunProvider(options) {
 `);
   }
   const parsedModel = chunk3EE6LVWT_cjs.parseModelId(options.model?.id);
-  const modelInferredProvider = parsedModel.provider !== void 0 && chunkRM7Y65IG_cjs.getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
-  const keyInferredProvider = chunkUNDROG5N_cjs.inferProviderFromApiKey(options.agentOptions.apiKey);
-  const primary = options.agentOptions.providers?.routes?.[0]?.provider ?? keyInferredProvider ?? modelInferredProvider ?? chunkUNDROG5N_cjs.detectPrimaryProvider();
-  chunkUNDROG5N_cjs.warnProviderPrecedenceOnce(modelInferredProvider, primary);
+  const modelInferredProvider = parsedModel.provider !== void 0 && chunkNIRE5CNO_cjs.getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
+  const keyInferredProvider = chunkHLPSLDGL_cjs.inferProviderFromApiKey(options.agentOptions.apiKey);
+  const primary = options.agentOptions.providers?.routes?.[0]?.provider ?? keyInferredProvider ?? modelInferredProvider ?? chunkHLPSLDGL_cjs.detectPrimaryProvider();
+  chunkHLPSLDGL_cjs.warnProviderPrecedenceOnce(modelInferredProvider, primary);
   const effectiveModelId = modelInferredProvider !== void 0 && modelInferredProvider === primary ? parsedModel.name : options.model?.id ?? "claude-sonnet-4-6";
   return { primary, effectiveModelId };
 }
 function mergeExplicitApiKey(pools, primary, apiKey) {
   if (apiKey === void 0 || apiKey.length === 0) return pools;
-  if (chunkUNDROG5N_cjs.isFixtureApiKey(apiKey) || apiKey === LOCAL_RUNTIME_MOCK_KEY) return pools;
+  if (chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey) || apiKey === LOCAL_RUNTIME_MOCK_KEY) return pools;
   const existing = pools?.[primary];
   if (existing !== void 0 && existing.length > 0) return pools;
   return { ...pools ?? {}, [primary]: [apiKey] };
@@ -7123,7 +7162,7 @@ function buildLoopInputs(options, runId, userText, userImages) {
   const extractToolCallsFromContent = options.agentOptions.providers?.routes?.[0]?.extractToolCallsFromContent;
   const rateLimitSink = options.sendOptions.onRunEvent;
   const modelBaseUrl = options.model?.url;
-  const chain = chunkUNDROG5N_cjs.resolveProviderChain({
+  const chain = chunkHLPSLDGL_cjs.resolveProviderChain({
     primary,
     ...modelBaseUrl !== void 0 ? { baseUrl: modelBaseUrl } : {},
     ...fallback !== void 0 ? { fallback } : {},
@@ -7162,7 +7201,7 @@ function buildLoopInputs(options, runId, userText, userImages) {
     } : {},
     ...options.priorMessages !== void 0 ? { priorMessages: options.priorMessages } : {},
     ...options.memoryTools !== void 0 && options.memoryTools.length > 0 ? { memoryTools: options.memoryTools } : {},
-    ...buildCustomToolsInput(
+    ...buildRunToolCatalogInput(
       options.agentOptions,
       options.sendOptions,
       options.pluginManager,
@@ -7406,7 +7445,7 @@ function buildRealRunOptions(args) {
   };
 }
 async function createFixtureRunHelper(args) {
-  const sessionMessages = chunk5BJV5UPY_cjs.getSessionMessages(args.inputs.agentId);
+  const sessionMessages = chunkV2UUGUY4_cjs.getSessionMessages(args.inputs.agentId);
   const projectMcpServers = args.inputs.settingSourcesIncludeProject ? await readProjectMcpServers(args.inputs.workspaceCwd) : {};
   return createLocalRun({
     agentId: args.inputs.agentId,
@@ -7425,7 +7464,7 @@ async function createFixtureRunHelper(args) {
 }
 async function dispatchLocalRun(args) {
   const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(args.inputs.options.apiKey);
-  if (chunkUNDROG5N_cjs.shouldUseRealLocalRuntime(apiKey)) {
+  if (chunkHLPSLDGL_cjs.shouldUseRealLocalRuntime(apiKey)) {
     return createRealLocalRun(
       buildRealRunOptions({
         inputs: args.inputs,
@@ -7681,10 +7720,10 @@ async function disposeLocalAgentSession(agent) {
   agent.lifecycleAbortController.abort();
   await chunkZF2LDKQQ_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
   disposeSessionMcpClients(agent.agentId);
-  await chunk5BJV5UPY_cjs.flushSessionWrites();
+  await chunkV2UUGUY4_cjs.flushSessionWrites();
   await flushRegistrySaves(agent.workspaceCwd);
   await disposeSessionStore(agent.sessionStore);
-  chunk5BJV5UPY_cjs.discardSession(agent.workspaceCwd, agent.agentId);
+  chunkV2UUGUY4_cjs.discardSession(agent.workspaceCwd, agent.agentId);
 }
 async function reloadLocalAgent(agent) {
   if (agent.context !== void 0) await agent.context.refresh();
@@ -8458,7 +8497,7 @@ var LocalAgentMemory = class {
   async runActiveMemoryIfEnabled(userText, priorMessages, telemetry) {
     const cfg = this.options.memory?.activeRecall;
     if (cfg?.enabled !== true || this.index === void 0) return void 0;
-    if (this.breaker === void 0) this.breaker = new chunkUNDROG5N_cjs.CircuitBreaker();
+    if (this.breaker === void 0) this.breaker = new chunkHLPSLDGL_cjs.CircuitBreaker();
     if (this.cache === void 0) this.cache = new ActiveMemoryCache();
     const result = await runActiveMemory({
       userText,
@@ -8871,8 +8910,8 @@ async function localAgentUsePersonality(args) {
       registry,
       store: args.personalityStore,
       invalidateCache: (reason) => args.invalidateCache(reason),
-      appendSessionMessage: (msg) => chunk5BJV5UPY_cjs.appendSessionMessage(args.agentId, msg),
-      clearSession: () => chunk5BJV5UPY_cjs.clearSession(args.agentId),
+      appendSessionMessage: (msg) => chunkV2UUGUY4_cjs.appendSessionMessage(args.agentId, msg),
+      clearSession: () => chunkV2UUGUY4_cjs.clearSession(args.agentId),
       opts: args.opts ?? {}
     })
   );
@@ -9241,7 +9280,7 @@ async function executeSendLocked(inputs, message, options) {
   if (inputs.options.onBeforeSend !== void 0) {
     await inputs.options.onBeforeSend({
       conversationId: inputs.agentId,
-      previousMessageCount: chunk5BJV5UPY_cjs.getSessionMessages(inputs.agentId).length
+      previousMessageCount: chunkV2UUGUY4_cjs.getSessionMessages(inputs.agentId).length
     });
   }
   await inputs.runPreHook(userText);
@@ -9253,8 +9292,8 @@ async function executeSendLocked(inputs, message, options) {
     userText,
     sendOptions: options
   });
-  const priorMessages = [...chunk5BJV5UPY_cjs.getSessionMessages(inputs.agentId)];
-  chunk5BJV5UPY_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
+  const priorMessages = [...chunkV2UUGUY4_cjs.getSessionMessages(inputs.agentId)];
+  chunkV2UUGUY4_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
   await persistMemoryFactIfWritePrompt(inputs.workspaceCwd, inputs.options.memory, userText);
   const memoryFacts = await readMemoryForSend(inputs.workspaceCwd, inputs.options.memory);
   const portPathActive = shouldUsePortMemoryPath();
@@ -9467,7 +9506,7 @@ var LocalAgent = class {
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
-      await chunk5BJV5UPY_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
+      await chunkV2UUGUY4_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
       await this.personalityStore.hydrate(this.agentId);
     } catch (err) {
       await releaseLeaseIfPossible(this.sessionStore, this.agentId);
@@ -9489,7 +9528,7 @@ var LocalAgent = class {
   }
   async send(message, options = {}) {
     if (options.tools !== void 0 && options.tools.length > 0) {
-      validateToolCatalog(options.tools);
+      validateToolCatalog(options.tools, this.options.withheldBuiltinTools);
     }
     const sendSpan = this._telemetry.startSpan(SPAN_NAMES.AGENT_SEND, {
       agentId: this.agentId,
@@ -9547,6 +9586,8 @@ var LocalAgent = class {
         ...options.onRunEvent !== void 0 ? { onRunEvent: options.onRunEvent } : {},
         hooksExecutor: this.hooksExecutor,
         memoryGlue: this.memoryGlue,
+        // usetheokit/theokit-sdk#382 — the transcript write reads this and nothing else.
+        memory: this.options.memory,
         ...postRunProvider !== void 0 ? { memoryProvider: postRunProvider } : {}
       });
     } finally {
@@ -9793,15 +9834,15 @@ async function maybeInjectHandoffTools(options) {
   };
 }
 function keyWillFlowToProvider(apiKey, provider) {
-  if (chunkUNDROG5N_cjs.isFixtureApiKey(apiKey)) return false;
-  if (chunkUNDROG5N_cjs.getConfiguredBaseUrl() !== void 0) return false;
+  if (chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey)) return false;
+  if (chunkHLPSLDGL_cjs.getConfiguredBaseUrl() !== void 0) return false;
   if (provider === void 0) return false;
-  const profile = chunk3KGLRRFC_cjs.getProviderProfile(provider);
+  const profile = chunk6HTXPPHK_cjs.getProviderProfile(provider);
   if (profile === void 0) return false;
   return profile.authType !== "none";
 }
 function missingApiKeyMessage() {
-  const present = chunkUNDROG5N_cjs.presentProviderCredentialEnvVars();
+  const present = chunkHLPSLDGL_cjs.presentProviderCredentialEnvVars();
   const base = `Missing API key \u2014 set ${chunkJTB5Q42C_cjs.API_KEY_ENV_VAR}, or pass \`apiKey\` to Agent.create()`;
   if (present.length === 0) return `${base}.`;
   return `${base}. ${present.join(" and ")} ${present.length === 1 ? "is" : "are"} set, but a provider credential is not read from the environment automatically \u2014 pass it explicitly, e.g. \`Agent.create({ apiKey: process.env.${present[0]}, ... })\`.`;
@@ -9838,11 +9879,11 @@ async function createCloudAgent(options) {
   if (shape.malformed) {
     throw new chunkK3FW2XZD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  const baseUrl = chunkUNDROG5N_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkHLPSLDGL_cjs.getConfiguredBaseUrl();
   if (baseUrl === void 0) {
     return new CloudAgent(options);
   }
-  const response = await chunkUNDROG5N_cjs.httpRequest("/v1/agents", {
+  const response = await chunkHLPSLDGL_cjs.httpRequest("/v1/agents", {
     apiKey,
     method: "POST",
     body: {
@@ -9867,7 +9908,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
-  await chunkUNDROG5N_cjs.discoverProviderPlugins();
+  await chunkHLPSLDGL_cjs.discoverProviderPlugins();
   await validateRehydratedAgent(agentId, existing);
   const mergedLocal = options.local !== void 0 && existing.options.local !== void 0 ? { ...existing.options.local, ...options.local } : options.local ?? existing.options.local;
   const mergedOptions = {
@@ -10011,7 +10052,7 @@ var Agent = class _Agent {
       pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
-      await chunkUNDROG5N_cjs.discoverProviderPlugins();
+      await chunkHLPSLDGL_cjs.discoverProviderPlugins();
       const agent = await runCreateUnderSpan(options, span);
       return agent;
     } catch (err) {
@@ -10318,9 +10359,9 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 compact targets local sessions.`
       );
     }
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-YCT6JMBX.cjs');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-LEWF554G.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
-    return chunk5BJV5UPY_cjs.enqueueSessionWrite(
+    return chunkV2UUGUY4_cjs.enqueueSessionWrite(
       cwd,
       agentId,
       () => compactSessionTranscript({
@@ -10354,7 +10395,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`
       );
     }
-    const { injectSessionTurn } = await import('./inject-session-XLO3KTBM.cjs');
+    const { injectSessionTurn } = await import('./inject-session-WQGGMCQY.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
@@ -10429,7 +10470,7 @@ var Agent = class _Agent {
       //
       // Honest limit, stated because the alternative is an implied claim: `tools` is still the
       // DECLARED catalog. Plugin tools and the reasoning `think` tool are assembled per run by
-      // `buildCustomToolsInput`, so they are not knowable from the registry alone. Documented on
+      // `buildRunToolCatalogInput`, so they are not knowable from the registry alone. Documented on
       // `AgentDescription.tools`.
       tools: (agent.options.tools ?? []).map((tool) => ({
         name: tool.name,
@@ -10499,5 +10540,5 @@ exports.computeCost = computeCost;
 exports.generateCronId = generateCronId;
 exports.getPricingEntry = getPricingEntry;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
-//# sourceMappingURL=chunk-UFAO4T7Z.cjs.map
-//# sourceMappingURL=chunk-UFAO4T7Z.cjs.map
+//# sourceMappingURL=chunk-F5WMX4EA.cjs.map
+//# sourceMappingURL=chunk-F5WMX4EA.cjs.map