@theokit/sdk 4.56.0 → 4.57.0

package/dist/{chunk-LQYQHXIW.cjs → chunk-M2JWHKO6.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkV2UUGUY4_cjs = require('./chunk-V2UUGUY4.cjs');
-var chunk6VLKVX7O_cjs = require('./chunk-6VLKVX7O.cjs');
+var chunkKKK3FZ4A_cjs = require('./chunk-KKK3FZ4A.cjs');
+var chunkE7JHD6QJ_cjs = require('./chunk-E7JHD6QJ.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 chunkHLPSLDGL_cjs = require('./chunk-HLPSLDGL.cjs');
+var chunkQI7WE46I_cjs = require('./chunk-QI7WE46I.cjs');
+var chunk43GFJ5SD_cjs = require('./chunk-43GFJ5SD.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
 var chunkE3WZ6Y4H_cjs = require('./chunk-E3WZ6Y4H.cjs');
 var chunkU2AC6JUP_cjs = require('./chunk-U2AC6JUP.cjs');
@@ -20,7 +20,7 @@ var chunkVJ26EKGJ_cjs = require('./chunk-VJ26EKGJ.cjs');
 var chunkR3UPQFKK_cjs = require('./chunk-R3UPQFKK.cjs');
 var chunkVKJ7V7EB_cjs = require('./chunk-VKJ7V7EB.cjs');
 var chunkILCGLTSA_cjs = require('./chunk-ILCGLTSA.cjs');
-var chunkJHPGF3FP_cjs = require('./chunk-JHPGF3FP.cjs');
+var chunkBUIK7GUA_cjs = require('./chunk-BUIK7GUA.cjs');
 var chunk2ADR2GSO_cjs = require('./chunk-2ADR2GSO.cjs');
 var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
 var chunkI6TGFUCO_cjs = require('./chunk-I6TGFUCO.cjs');
@@ -884,7 +884,7 @@ async function readLegacyFacts(jsonPath) {
 }
 async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
-    for (const fact of facts) await chunk6VLKVX7O_cjs.appendFactToMarkdown(cwd, fact);
+    for (const fact of facts) await chunkE7JHD6QJ_cjs.appendFactToMarkdown(cwd, fact);
     await promises.unlink(jsonPath).catch(() => void 0);
     chunkNUKRL3I6_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
 `);
@@ -901,11 +901,11 @@ async function migrateLegacyJson(cwd, config) {
   const key = `${cwd}::${config.namespace ?? "default"}::${config.scope ?? "agent"}::${config.userId ?? "default"}`;
   if (migrationRun.has(key)) return { migrated: false, factCount: 0, reason: "already-migrated" };
   migrationRun.add(key);
-  const jsonPath = chunk6VLKVX7O_cjs.legacyMemoryJsonPath(cwd, config);
+  const jsonPath = chunkE7JHD6QJ_cjs.legacyMemoryJsonPath(cwd, config);
   if (!await fileExists(jsonPath)) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
-  if (await fileExists(chunk6VLKVX7O_cjs.memoryMdPath(cwd))) {
+  if (await fileExists(chunkE7JHD6QJ_cjs.memoryMdPath(cwd))) {
     chunkNUKRL3I6_cjs.diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
@@ -918,25 +918,35 @@ async function migrateLegacyJson(cwd, config) {
 }
 
 // src/internal/runtime/memory/memory-store.ts
-var REMEMBER_PATTERN = /^\s*Remember(?:\s+this\s+durable\s+preference)?\s*:\s*(.+)$/i;
+var REMEMBER_PATTERN = /^\s*Remember(?:\s+this\s+durable\s+preference)?\s*(?:\((user|feedback|project|reference)\))?\s*:\s*(.+)$/i;
 function isMemoryWritePrompt(message) {
   return REMEMBER_PATTERN.test(message) || message.includes("Remember this durable");
 }
 function extractMemoryFact(message) {
   const match = REMEMBER_PATTERN.exec(message);
-  if (match === null || match[1] === void 0) return "";
-  return match[1].trim().replace(/\.$/, "");
+  if (match === null || match[2] === void 0) return "";
+  return match[2].trim().replace(/\.$/, "");
+}
+function extractMemoryKind(message) {
+  const match = REMEMBER_PATTERN.exec(message);
+  const declared = match?.[1];
+  if (declared === void 0) return void 0;
+  const lowered = declared.toLowerCase();
+  return chunkE7JHD6QJ_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
 }
 async function readMemoryFacts(cwd, config) {
   if (!config.enabled) return [];
   await migrateLegacyJson(cwd, config);
-  return chunk6VLKVX7O_cjs.readFacts(cwd, config);
+  return chunkE7JHD6QJ_cjs.readFacts(cwd, config);
 }
 async function appendMemoryFact(cwd, config, fact) {
   if (!config.enabled) return;
   await migrateLegacyJson(cwd, config);
-  const sanitized = { text: chunkJTB5Q42C_cjs.redactSecrets(fact.text) };
-  await chunk6VLKVX7O_cjs.appendFact(cwd, config, sanitized);
+  const sanitized = {
+    text: chunkJTB5Q42C_cjs.redactSecrets(fact.text),
+    ...fact.kind === void 0 ? {} : { kind: fact.kind }
+  };
+  await chunkE7JHD6QJ_cjs.appendFact(cwd, config, sanitized);
 }
 
 // src/internal/runtime/fixtures/fixture-scripts.ts
@@ -1607,7 +1617,7 @@ function createRealCloudRun(options) {
     conversation: []
   };
   const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(options.agentOptions.apiKey);
-  const baseUrl = chunkHLPSLDGL_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunk43GFJ5SD_cjs.getConfiguredBaseUrl();
   const handle = new RealCloudRun(
     {
       id,
@@ -1690,7 +1700,7 @@ var RealCloudRun = class extends FixtureRunBase {
   async consumeStream(response) {
     let finalStatus = "finished";
     let finalText = "";
-    for await (const record of chunkHLPSLDGL_cjs.parseSseStream(response.body, this.controller.signal)) {
+    for await (const record of chunk43GFJ5SD_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 +1846,7 @@ var CloudAgent = class {
    */
   isFixtureMode() {
     const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(this.options.apiKey);
-    return chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey) && chunkHLPSLDGL_cjs.getConfiguredBaseUrl() === void 0;
+    return chunk43GFJ5SD_cjs.isFixtureApiKey(apiKey) && chunk43GFJ5SD_cjs.getConfiguredBaseUrl() === void 0;
   }
   // SE9 — integrated structured output; delegates to the shared helper.
   generate(message, options) {
@@ -1888,7 +1898,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 && !chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey) && chunkHLPSLDGL_cjs.getConfiguredBaseUrl() !== void 0;
+    const useRealRuntime = apiKey !== void 0 && !chunk43GFJ5SD_cjs.isFixtureApiKey(apiKey) && chunk43GFJ5SD_cjs.getConfiguredBaseUrl() !== void 0;
     return useRealRuntime ? createRealCloudRun({
       agentId: this.agentId,
       model: this.model ?? { id: DEFAULT_AGENTIC_MODEL_ID },
@@ -2113,15 +2123,15 @@ function resolveSessionDir(local) {
         "[theokit-sdk] local.sessionDir and local.baseDir are both set; using sessionDir. baseDir is the deprecated name for the same option (#301)."
       );
     }
-    return chunkJHPGF3FP_cjs.expandTilde(local.sessionDir);
+    return chunkBUIK7GUA_cjs.expandTilde(local.sessionDir);
   }
   if (local?.baseDir !== void 0) {
     chunkNUKRL3I6_cjs.diag(
       "[theokit-sdk] local.baseDir is deprecated; rename it to local.sessionDir (#301). It is the directory for session transcripts, not the working directory \u2014 that is local.cwd."
     );
-    return chunkJHPGF3FP_cjs.expandTilde(local.baseDir);
+    return chunkBUIK7GUA_cjs.expandTilde(local.baseDir);
   }
-  return chunkJHPGF3FP_cjs.defaultBaseDir();
+  return chunkBUIK7GUA_cjs.defaultBaseDir();
 }
 var SCHEMA_VERSION2 = 1;
 var FILE_NAME = "personality.json";
@@ -2730,7 +2740,7 @@ async function runPostRunLifecycle(inputs) {
     try {
       const partial = await safeConversation(run);
       if (partial !== void 0) {
-        chunkV2UUGUY4_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+        chunkKKK3FZ4A_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
           userText,
           conversation: partial
         });
@@ -2740,11 +2750,11 @@ async function runPostRunLifecycle(inputs) {
       chunkNUKRL3I6_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
-    await chunkV2UUGUY4_cjs.flushSessionWrites();
+    await chunkKKK3FZ4A_cjs.flushSessionWrites();
     return;
   }
   if (result.result !== void 0) {
-    chunkV2UUGUY4_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
+    chunkKKK3FZ4A_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
   const resolvedWindow = resolveWindowForRun(model, contextWindow);
@@ -2755,7 +2765,7 @@ async function runPostRunLifecycle(inputs) {
   }
   const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
   const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
-  chunkV2UUGUY4_cjs.persistTurnToTranscript(
+  chunkKKK3FZ4A_cjs.persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
     agentId,
@@ -2767,7 +2777,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: chunkHLPSLDGL_cjs.buildDefaultSummarizer({
+        summarize: chunk43GFJ5SD_cjs.buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
@@ -2789,7 +2799,7 @@ async function runPostRunLifecycle(inputs) {
       if (memoryProvider?.recordSessionSummary !== void 0) {
         await memoryProvider.recordSessionSummary(summaryArgs);
       } else {
-        await chunk6VLKVX7O_cjs.writeSessionSummary(summaryArgs);
+        await chunkE7JHD6QJ_cjs.writeSessionSummary(summaryArgs);
       }
       if (!shouldUsePortMemoryPath()) {
         void memoryGlue.syncIfReady();
@@ -2809,7 +2819,7 @@ async function runPostRunLifecycle(inputs) {
     agentId,
     runId: result.id
   });
-  await chunkV2UUGUY4_cjs.flushSessionWrites();
+  await chunkKKK3FZ4A_cjs.flushSessionWrites();
 }
 async function safeConversation(run) {
   try {
@@ -3402,7 +3412,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-LQYQHXIW.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-M2JWHKO6.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3630,7 +3640,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-LQYQHXIW.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-M2JWHKO6.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -5872,7 +5882,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: chunkHLPSLDGL_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
+      p.type === "tool_result" ? { ...p, content: chunk43GFJ5SD_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
     )
   );
 }
@@ -6538,12 +6548,12 @@ var FallbackLlmClient = class {
     let lastError;
     for (const client of this.clients) {
       if (signal.aborted) throw abortError(signal);
-      const attempt = await chunkHLPSLDGL_cjs.tryFirstEvent(client, request, signal, true);
+      const attempt = await chunk43GFJ5SD_cjs.tryFirstEvent(client, request, signal, true);
       if (attempt.kind === "handshake_error") {
         lastError = attempt.error;
         continue;
       }
-      return yield* chunkHLPSLDGL_cjs.relayStream(attempt.generator, attempt.firstResult);
+      return yield* chunk43GFJ5SD_cjs.relayStream(attempt.generator, attempt.firstResult);
     }
     if (lastError !== void 0) throw lastError;
     throw new chunkK3FW2XZD_cjs.NetworkError("FallbackLlmClient has no providers configured", {
@@ -7130,15 +7140,15 @@ function resolveRunProvider(options) {
   }
   const parsedModel = chunk3EE6LVWT_cjs.parseModelId(options.model?.id);
   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 keyInferredProvider = chunk43GFJ5SD_cjs.inferProviderFromApiKey(options.agentOptions.apiKey);
+  const primary = options.agentOptions.providers?.routes?.[0]?.provider ?? keyInferredProvider ?? modelInferredProvider ?? chunk43GFJ5SD_cjs.detectPrimaryProvider();
+  chunk43GFJ5SD_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 (chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey) || apiKey === LOCAL_RUNTIME_MOCK_KEY) return pools;
+  if (chunk43GFJ5SD_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] };
@@ -7162,7 +7172,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 = chunkHLPSLDGL_cjs.resolveProviderChain({
+  const chain = chunk43GFJ5SD_cjs.resolveProviderChain({
     primary,
     ...modelBaseUrl !== void 0 ? { baseUrl: modelBaseUrl } : {},
     ...fallback !== void 0 ? { fallback } : {},
@@ -7445,7 +7455,7 @@ function buildRealRunOptions(args) {
   };
 }
 async function createFixtureRunHelper(args) {
-  const sessionMessages = chunkV2UUGUY4_cjs.getSessionMessages(args.inputs.agentId);
+  const sessionMessages = chunkKKK3FZ4A_cjs.getSessionMessages(args.inputs.agentId);
   const projectMcpServers = args.inputs.settingSourcesIncludeProject ? await readProjectMcpServers(args.inputs.workspaceCwd) : {};
   return createLocalRun({
     agentId: args.inputs.agentId,
@@ -7464,7 +7474,7 @@ async function createFixtureRunHelper(args) {
 }
 async function dispatchLocalRun(args) {
   const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(args.inputs.options.apiKey);
-  if (chunkHLPSLDGL_cjs.shouldUseRealLocalRuntime(apiKey)) {
+  if (chunk43GFJ5SD_cjs.shouldUseRealLocalRuntime(apiKey)) {
     return createRealLocalRun(
       buildRealRunOptions({
         inputs: args.inputs,
@@ -7720,10 +7730,10 @@ async function disposeLocalAgentSession(agent) {
   agent.lifecycleAbortController.abort();
   await chunkZF2LDKQQ_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
   disposeSessionMcpClients(agent.agentId);
-  await chunkV2UUGUY4_cjs.flushSessionWrites();
+  await chunkKKK3FZ4A_cjs.flushSessionWrites();
   await flushRegistrySaves(agent.workspaceCwd);
   await disposeSessionStore(agent.sessionStore);
-  chunkV2UUGUY4_cjs.discardSession(agent.workspaceCwd, agent.agentId);
+  chunkKKK3FZ4A_cjs.discardSession(agent.workspaceCwd, agent.agentId);
 }
 async function reloadLocalAgent(agent) {
   if (agent.context !== void 0) await agent.context.refresh();
@@ -7737,7 +7747,7 @@ async function reloadLocalAgent(agent) {
 }
 async function persistActiveMemoryTranscript(cwd, transcript) {
   try {
-    const dir = path.join(chunk6VLKVX7O_cjs.memoryDir(cwd), "transcripts", "active-memory");
+    const dir = path.join(chunkE7JHD6QJ_cjs.memoryDir(cwd), "transcripts", "active-memory");
     const file = path.join(dir, `${transcript.runId}.json`);
     await chunkI6TGFUCO_cjs.atomicWriteJson(file, transcript);
   } catch (cause) {
@@ -8367,7 +8377,7 @@ function createMemorySearchTool(opts) {
   };
 }
 function createMemoryGetTool(opts) {
-  const memoryRoot = path.resolve(chunk6VLKVX7O_cjs.memoryDir(opts.cwd));
+  const memoryRoot = path.resolve(chunkE7JHD6QJ_cjs.memoryDir(opts.cwd));
   return {
     name: "memory_get",
     description: GET_DESCRIPTION,
@@ -8473,7 +8483,7 @@ var LocalAgentMemory = class {
       const openOpts = { cwd: this.workspaceCwd };
       if (embedding !== void 0) openOpts.embedding = embedding;
       if (cfg?.backend !== void 0) openOpts.backend = cfg.backend;
-      this.index = await chunk6VLKVX7O_cjs.IndexManager.open(openOpts);
+      this.index = await chunkE7JHD6QJ_cjs.IndexManager.open(openOpts);
       await this.index.sync();
       this.toolsCache = [
         createMemorySearchTool({ index: this.index }),
@@ -8497,7 +8507,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 chunkHLPSLDGL_cjs.CircuitBreaker();
+    if (this.breaker === void 0) this.breaker = new chunk43GFJ5SD_cjs.CircuitBreaker();
     if (this.cache === void 0) this.cache = new ActiveMemoryCache();
     const result = await runActiveMemory({
       userText,
@@ -8731,7 +8741,7 @@ function createLocalAgentMemoryProvider(opts) {
       return { facts: [], systemPromptAdditions: summary };
     },
     async recordSessionSummary(args) {
-      await chunk6VLKVX7O_cjs.writeSessionSummary(args);
+      await chunkE7JHD6QJ_cjs.writeSessionSummary(args);
     },
     async sync(handle) {
       const state = handle[INTERNAL_LAM_KEY];
@@ -8910,8 +8920,8 @@ async function localAgentUsePersonality(args) {
       registry,
       store: args.personalityStore,
       invalidateCache: (reason) => args.invalidateCache(reason),
-      appendSessionMessage: (msg) => chunkV2UUGUY4_cjs.appendSessionMessage(args.agentId, msg),
-      clearSession: () => chunkV2UUGUY4_cjs.clearSession(args.agentId),
+      appendSessionMessage: (msg) => chunkKKK3FZ4A_cjs.appendSessionMessage(args.agentId, msg),
+      clearSession: () => chunkKKK3FZ4A_cjs.clearSession(args.agentId),
       opts: args.opts ?? {}
     })
   );
@@ -8967,8 +8977,12 @@ async function persistMemoryFactIfWritePrompt(workspaceCwd, memoryConfig, userTe
   if (!isMemoryWritePrompt(userText)) return;
   const fact = extractMemoryFact(userText);
   if (fact.length === 0) return;
+  const kind = extractMemoryKind(userText);
   await safeCall(
-    () => appendMemoryFact(workspaceCwd, memoryConfig, { text: fact }),
+    () => appendMemoryFact(workspaceCwd, memoryConfig, {
+      text: fact,
+      ...kind === void 0 ? {} : { kind }
+    }),
     void 0,
     "memory write"
   );
@@ -9280,7 +9294,7 @@ async function executeSendLocked(inputs, message, options) {
   if (inputs.options.onBeforeSend !== void 0) {
     await inputs.options.onBeforeSend({
       conversationId: inputs.agentId,
-      previousMessageCount: chunkV2UUGUY4_cjs.getSessionMessages(inputs.agentId).length
+      previousMessageCount: chunkKKK3FZ4A_cjs.getSessionMessages(inputs.agentId).length
     });
   }
   await inputs.runPreHook(userText);
@@ -9292,8 +9306,8 @@ async function executeSendLocked(inputs, message, options) {
     userText,
     sendOptions: options
   });
-  const priorMessages = [...chunkV2UUGUY4_cjs.getSessionMessages(inputs.agentId)];
-  chunkV2UUGUY4_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
+  const priorMessages = [...chunkKKK3FZ4A_cjs.getSessionMessages(inputs.agentId)];
+  chunkKKK3FZ4A_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();
@@ -9456,7 +9470,7 @@ var LocalAgent = class {
     this.options = options;
     this.workspaceCwd = resolveCwd(options.local?.cwd);
     this.transcriptBaseDir = resolveSessionDir(options.local);
-    this.sessionStore = options.local?.sessionStore ?? new chunkYPJ5NH5N_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
+    this.sessionStore = options.local?.sessionStore ?? new chunkQI7WE46I_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
     this.settingSourcesIncludeProject = includesSetting(options, "project");
     this.settingSourcesIncludePlugins = includesSetting(options, "plugins");
     const sub = bootstrapSubmanagers({
@@ -9506,7 +9520,7 @@ var LocalAgent = class {
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
-      await chunkV2UUGUY4_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
+      await chunkKKK3FZ4A_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
       await this.personalityStore.hydrate(this.agentId);
     } catch (err) {
       await releaseLeaseIfPossible(this.sessionStore, this.agentId);
@@ -9834,35 +9848,41 @@ async function maybeInjectHandoffTools(options) {
   };
 }
 function keyWillFlowToProvider(apiKey, provider) {
-  if (chunkHLPSLDGL_cjs.isFixtureApiKey(apiKey)) return false;
-  if (chunkHLPSLDGL_cjs.getConfiguredBaseUrl() !== void 0) return false;
+  if (chunk43GFJ5SD_cjs.isFixtureApiKey(apiKey)) return false;
+  if (chunk43GFJ5SD_cjs.getConfiguredBaseUrl() !== void 0) return false;
   if (provider === void 0) return false;
   const profile = chunk6HTXPPHK_cjs.getProviderProfile(provider);
   if (profile === void 0) return false;
   return profile.authType !== "none";
 }
 function missingApiKeyMessage() {
-  const present = chunkHLPSLDGL_cjs.presentProviderCredentialEnvVars();
+  const present = chunk43GFJ5SD_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]}, ... })\`.`;
 }
+function providerNeedsCallerKey(provider) {
+  if (provider === void 0) return true;
+  const profile = chunk6HTXPPHK_cjs.getProviderProfile(provider);
+  if (profile === void 0) return true;
+  return profile.authType === "api_key";
+}
 async function createLocalAgent(options) {
+  const provider = providerFromModelId(normalizeModel(options.model)?.id);
   const apiKey = chunkJTB5Q42C_cjs.resolveApiKey(options.apiKey);
   if (apiKey === void 0) {
-    throw new chunkK3FW2XZD_cjs.AuthenticationError(missingApiKeyMessage(), { code: "missing_api_key" });
-  }
-  const provider = providerFromModelId(normalizeModel(options.model)?.id);
-  const willFlowToProvider = keyWillFlowToProvider(apiKey, provider);
-  const shape = validateApiKeyShape(apiKey, {
-    strict: willFlowToProvider,
-    // `options.model` is already normalized by `runCreateUnderSpan`; `normalizeModel`
-    // here is the idempotent narrowing of the widened public type (`{id}` passes
-    // through by reference) — cleaner than an `as` cast.
-    ...willFlowToProvider ? { provider } : {}
-  });
-  if (shape.malformed) {
-    throw new chunkK3FW2XZD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
+    if (providerNeedsCallerKey(provider)) {
+      throw new chunkK3FW2XZD_cjs.AuthenticationError(missingApiKeyMessage(), { code: "missing_api_key" });
+    }
+  } else {
+    const willFlowToProvider = keyWillFlowToProvider(apiKey, provider);
+    const shape = validateApiKeyShape(apiKey, {
+      strict: willFlowToProvider,
+      ...willFlowToProvider ? { provider } : {}
+    });
+    if (shape.malformed) {
+      throw new chunkK3FW2XZD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
+    }
   }
   const agent = new LocalAgent(options);
   await agent.initialize();
@@ -9879,11 +9899,11 @@ async function createCloudAgent(options) {
   if (shape.malformed) {
     throw new chunkK3FW2XZD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  const baseUrl = chunkHLPSLDGL_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunk43GFJ5SD_cjs.getConfiguredBaseUrl();
   if (baseUrl === void 0) {
     return new CloudAgent(options);
   }
-  const response = await chunkHLPSLDGL_cjs.httpRequest("/v1/agents", {
+  const response = await chunk43GFJ5SD_cjs.httpRequest("/v1/agents", {
     apiKey,
     method: "POST",
     body: {
@@ -9908,7 +9928,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
-  await chunkHLPSLDGL_cjs.discoverProviderPlugins();
+  await chunk43GFJ5SD_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 = {
@@ -10052,7 +10072,7 @@ var Agent = class _Agent {
       pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
-      await chunkHLPSLDGL_cjs.discoverProviderPlugins();
+      await chunk43GFJ5SD_cjs.discoverProviderPlugins();
       const agent = await runCreateUnderSpan(options, span);
       return agent;
     } catch (err) {
@@ -10359,9 +10379,9 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 compact targets local sessions.`
       );
     }
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-LEWF554G.cjs');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-YHFQIXV5.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
-    return chunkV2UUGUY4_cjs.enqueueSessionWrite(
+    return chunkKKK3FZ4A_cjs.enqueueSessionWrite(
       cwd,
       agentId,
       () => compactSessionTranscript({
@@ -10395,7 +10415,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`
       );
     }
-    const { injectSessionTurn } = await import('./inject-session-WQGGMCQY.cjs');
+    const { injectSessionTurn } = await import('./inject-session-MLCJMYDG.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
@@ -10434,7 +10454,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 transcript targets local sessions.`
       );
     }
-    const { readSessionMessages } = await import('./agent-session-store-ZJ3JSRS4.cjs');
+    const { readSessionMessages } = await import('./agent-session-store-WAKLOKWK.cjs');
     const { store } = await openLocalStore(reg);
     return readSessionMessages(store, agentId);
   }
@@ -10522,8 +10542,8 @@ async function openLocalStore(reg) {
   const cwd = reg.cwd ?? process.cwd();
   const optModel = reg.options.model;
   const model = reg.model?.id ?? (typeof optModel === "string" ? optModel : optModel?.id) ?? "unknown";
-  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-3MOJQGP2.cjs');
-  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-JXHFTB7G.cjs');
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-XZ7ZTB3A.cjs');
+  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-HF5GEU5M.cjs');
   const configuredSessionDir = reg.options.local?.sessionDir ?? reg.options.local?.baseDir;
   const baseDir = configuredSessionDir !== void 0 ? expandTilde2(configuredSessionDir) : defaultBaseDir2();
   return { cwd, model, store: new FsSessionStore2({ baseDir, cwd }) };
@@ -10540,5 +10560,5 @@ exports.computeCost = computeCost;
 exports.generateCronId = generateCronId;
 exports.getPricingEntry = getPricingEntry;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
-//# sourceMappingURL=chunk-LQYQHXIW.cjs.map
-//# sourceMappingURL=chunk-LQYQHXIW.cjs.map
+//# sourceMappingURL=chunk-M2JWHKO6.cjs.map
+//# sourceMappingURL=chunk-M2JWHKO6.cjs.map