@theokit/sdk 5.6.0 → 5.7.0

package/dist/{chunk-GCHZMH42.cjs → chunk-A575WPBL.cjs}

@@ -1,17 +1,18 @@
 'use strict';
 
 var chunkKVSAY6NZ_cjs = require('./chunk-KVSAY6NZ.cjs');
-var chunkDZG77WU7_cjs = require('./chunk-DZG77WU7.cjs');
-var chunkVUHXC74Q_cjs = require('./chunk-VUHXC74Q.cjs');
-var chunk7IZKTQ5G_cjs = require('./chunk-7IZKTQ5G.cjs');
+var chunk3XSWF5AP_cjs = require('./chunk-3XSWF5AP.cjs');
+var chunk33A27NFX_cjs = require('./chunk-33A27NFX.cjs');
+var chunkYYN6BB7R_cjs = require('./chunk-YYN6BB7R.cjs');
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
 var chunkD6POWE7E_cjs = require('./chunk-D6POWE7E.cjs');
 var chunkTMKTSYDS_cjs = require('./chunk-TMKTSYDS.cjs');
-var chunkGFFBXSQT_cjs = require('./chunk-GFFBXSQT.cjs');
+var chunkHNAYCTX4_cjs = require('./chunk-HNAYCTX4.cjs');
 var chunk7FDKWDA2_cjs = require('./chunk-7FDKWDA2.cjs');
-var chunkC4ZQPWXJ_cjs = require('./chunk-C4ZQPWXJ.cjs');
+var chunkZLMU5EU3_cjs = require('./chunk-ZLMU5EU3.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
-var chunkEIOMN5VA_cjs = require('./chunk-EIOMN5VA.cjs');
+var chunkEFETPSJZ_cjs = require('./chunk-EFETPSJZ.cjs');
+var chunkGK3UG7YQ_cjs = require('./chunk-GK3UG7YQ.cjs');
 var chunkRQMCOFAI_cjs = require('./chunk-RQMCOFAI.cjs');
 var chunkAA27GEYS_cjs = require('./chunk-AA27GEYS.cjs');
 var chunkYSTXFWQE_cjs = require('./chunk-YSTXFWQE.cjs');
@@ -819,7 +820,7 @@ async function readLegacyFacts(jsonPath) {
 }
 async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
-    for (const fact of facts) await chunkGFFBXSQT_cjs.appendFactToMarkdown(cwd, fact);
+    for (const fact of facts) await chunkHNAYCTX4_cjs.appendFactToMarkdown(cwd, fact);
     await promises.unlink(jsonPath).catch(() => void 0);
     chunk6LHQPOMI_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
 `);
@@ -836,11 +837,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 = chunkGFFBXSQT_cjs.legacyMemoryJsonPath(cwd, config);
+  const jsonPath = chunkHNAYCTX4_cjs.legacyMemoryJsonPath(cwd, config);
   if (!await fileExists(jsonPath)) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
-  if (await fileExists(chunkGFFBXSQT_cjs.memoryMdPath(chunkGFFBXSQT_cjs.resolveMemoryRoot(cwd, config)))) {
+  if (await fileExists(chunkHNAYCTX4_cjs.memoryMdPath(chunkHNAYCTX4_cjs.resolveMemoryRoot(cwd, config)))) {
     chunk6LHQPOMI_cjs.diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
@@ -869,19 +870,19 @@ function unstoredRememberWarning(message) {
   if (isMemoryWritePrompt(message) && extractMemoryFact(message).length > 0) return void 0;
   const trimmed = message.trim();
   const quoted = trimmed.length > QUOTED_MESSAGE_MAX ? `${trimmed.slice(0, QUOTED_MESSAGE_MAX)}\u2026` : trimmed;
-  return `[theokit-sdk] NOTHING WAS STORED \u2014 this message does not match the memory capture pattern: ${JSON.stringify(quoted)}. Supported: "Remember: <fact>" or "Remember (${chunkGFFBXSQT_cjs.MEMORY_KINDS.join("|")}): <fact>". It still reaches the session transcript, so a follow-up may answer from it \u2014 that is search over transcripts, not a durable memory.`;
+  return `[theokit-sdk] NOTHING WAS STORED \u2014 this message does not match the memory capture pattern: ${JSON.stringify(quoted)}. Supported: "Remember: <fact>" or "Remember (${chunkHNAYCTX4_cjs.MEMORY_KINDS.join("|")}): <fact>". It still reaches the session transcript, so a follow-up may answer from it \u2014 that is search over transcripts, not a durable memory.`;
 }
 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 chunkGFFBXSQT_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
+  return chunkHNAYCTX4_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
 }
 async function readMemoryFacts(cwd, config) {
   if (!config.enabled) return [];
   await migrateLegacyJson(cwd, config);
-  return chunkGFFBXSQT_cjs.readFacts(cwd, config);
+  return chunkHNAYCTX4_cjs.readFacts(cwd, config);
 }
 async function appendMemoryFact(cwd, config, fact) {
   if (!config.enabled) return;
@@ -890,7 +891,7 @@ async function appendMemoryFact(cwd, config, fact) {
     text: chunk6LHQPOMI_cjs.redactSecrets(fact.text),
     ...fact.kind === void 0 ? {} : { kind: fact.kind }
   };
-  await chunkGFFBXSQT_cjs.appendFact(cwd, config, sanitized);
+  await chunkHNAYCTX4_cjs.appendFact(cwd, config, sanitized);
 }
 
 // src/internal/runtime/fixtures/fixture-scripts.ts
@@ -1561,7 +1562,7 @@ function createRealCloudRun(options) {
     conversation: []
   };
   const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(options.agentOptions.apiKey);
-  const baseUrl = chunkC4ZQPWXJ_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkZLMU5EU3_cjs.getConfiguredBaseUrl();
   const handle = new RealCloudRun(
     {
       id,
@@ -1644,7 +1645,7 @@ var RealCloudRun = class extends FixtureRunBase {
   async consumeStream(response) {
     let finalStatus = "finished";
     let finalText = "";
-    for await (const record of chunkC4ZQPWXJ_cjs.parseSseStream(response.body, this.controller.signal)) {
+    for await (const record of chunkZLMU5EU3_cjs.parseSseStream(response.body, this.controller.signal)) {
       const parsed = safeParse(record.data);
       if (parsed === void 0) continue;
       const update = this.applyRecord(record.event, parsed);
@@ -1811,7 +1812,7 @@ var CloudAgent = class _CloudAgent {
    */
   isFixtureMode() {
     const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(this.options.apiKey);
-    return chunkC4ZQPWXJ_cjs.isFixtureApiKey(apiKey) && chunkC4ZQPWXJ_cjs.getConfiguredBaseUrl() === void 0;
+    return chunkZLMU5EU3_cjs.isFixtureApiKey(apiKey) && chunkZLMU5EU3_cjs.getConfiguredBaseUrl() === void 0;
   }
   // SE9 — integrated structured output; delegates to the shared helper.
   generate(message, options) {
@@ -1863,7 +1864,7 @@ var CloudAgent = class _CloudAgent {
     const userText = typeof message === "string" ? message : message.text;
     const systemPrompt = await this.resolveSystemPromptForSend(userText, options);
     const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(this.options.apiKey);
-    const useRealRuntime = apiKey !== void 0 && !chunkC4ZQPWXJ_cjs.isFixtureApiKey(apiKey) && chunkC4ZQPWXJ_cjs.getConfiguredBaseUrl() !== void 0;
+    const useRealRuntime = apiKey !== void 0 && !chunkZLMU5EU3_cjs.isFixtureApiKey(apiKey) && chunkZLMU5EU3_cjs.getConfiguredBaseUrl() !== void 0;
     return useRealRuntime ? createRealCloudRun({
       agentId: this.agentId,
       model: this.model ?? { id: DEFAULT_AGENTIC_MODEL_ID },
@@ -2123,14 +2124,14 @@ async function readState(filePath) {
   try {
     parsed = JSON.parse(raw);
   } catch {
-    chunk7IZKTQ5G_cjs.warnOnce(
+    chunkGK3UG7YQ_cjs.warnOnce(
       "personality-store-json-parse",
       "[theokit-sdk] personality.json is malformed; treating as empty"
     );
     return emptyState();
   }
   if (!isStateV1(parsed)) {
-    chunk7IZKTQ5G_cjs.warnOnce(
+    chunkGK3UG7YQ_cjs.warnOnce(
       "personality-store-bad-version",
       `[theokit-sdk] personality.json has unknown version; treating as empty (file kept untouched)`
     );
@@ -2161,7 +2162,7 @@ var PersonalityStore = class {
       try {
         await this.#persist(agentId, slug);
       } catch (err) {
-        chunk7IZKTQ5G_cjs.warnOnce(
+        chunkGK3UG7YQ_cjs.warnOnce(
           `personality-store-persist-failure-${agentId}`,
           `[theokit-sdk] personality persist failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
             err.message
@@ -2178,7 +2179,7 @@ var PersonalityStore = class {
     try {
       state = await readState(filePath);
     } catch (err) {
-      chunk7IZKTQ5G_cjs.warnOnce(
+      chunkGK3UG7YQ_cjs.warnOnce(
         `personality-store-hydrate-failure-${agentId}`,
         `[theokit-sdk] personality hydrate failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
           err.message
@@ -2727,7 +2728,7 @@ var HooksExecutor = class {
   config = {};
   async initialize(settingSourcesIncludeProject) {
     if (readManagedSettings(this.policy.managedSettingsRoot).disableAllHooks === true) {
-      chunk7IZKTQ5G_cjs.warnFailureOnce(
+      chunkGK3UG7YQ_cjs.warnFailureOnce(
         "hooks-disabled-by-policy",
         "[theokit-sdk] hooks: an operator policy (managed-settings.json) declares disableAllHooks \u2014 NO hook will run, including any this project declared."
       );
@@ -2738,7 +2739,7 @@ var HooksExecutor = class {
       this.config = {};
       return;
     }
-    this.config = await chunk7IZKTQ5G_cjs.loadHookConfig(this.cwd, this.compatSources);
+    this.config = await chunkGK3UG7YQ_cjs.loadHookConfig(this.cwd, this.compatSources);
   }
   /** Fire every hook registered for `event` and aggregate the decisions. */
   async run(payload) {
@@ -2928,7 +2929,7 @@ async function runPostRunLifecycle(inputs) {
     try {
       const partial = await safeConversation(run);
       if (partial !== void 0) {
-        chunkDZG77WU7_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+        chunk3XSWF5AP_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
           userText,
           conversation: partial
         });
@@ -2938,11 +2939,11 @@ async function runPostRunLifecycle(inputs) {
       chunk6LHQPOMI_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
-    await chunkDZG77WU7_cjs.flushSessionWrites();
+    await chunk3XSWF5AP_cjs.flushSessionWrites();
     return;
   }
   if (result.result !== void 0) {
-    chunkDZG77WU7_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
+    chunk3XSWF5AP_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
   const resolvedWindow = resolveWindowForRun(model, contextWindow);
@@ -2953,7 +2954,7 @@ async function runPostRunLifecycle(inputs) {
   }
   const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
   const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
-  chunkDZG77WU7_cjs.persistTurnToTranscript(
+  chunk3XSWF5AP_cjs.persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
     agentId,
@@ -2965,7 +2966,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: chunkC4ZQPWXJ_cjs.buildDefaultSummarizer({
+        summarize: chunkZLMU5EU3_cjs.buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
@@ -2978,7 +2979,7 @@ async function runPostRunLifecycle(inputs) {
       cwd: workspaceCwd,
       // Resolved once, here, and handed to both writers. Recomputing it inside either one is how
       // the summary ended up in a directory the indexer never scanned (#463).
-      memoryRoot: chunkGFFBXSQT_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
+      memoryRoot: chunkHNAYCTX4_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
       runId: result.id,
       agentId,
       userText,
@@ -2990,7 +2991,7 @@ async function runPostRunLifecycle(inputs) {
       if (memoryProvider?.recordSessionSummary !== void 0) {
         await memoryProvider.recordSessionSummary(summaryArgs);
       } else {
-        await chunkGFFBXSQT_cjs.writeSessionSummary(summaryArgs);
+        await chunkHNAYCTX4_cjs.writeSessionSummary(summaryArgs);
       }
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
@@ -3007,7 +3008,7 @@ async function runPostRunLifecycle(inputs) {
     agentId,
     runId: result.id
   });
-  await chunkDZG77WU7_cjs.flushSessionWrites();
+  await chunk3XSWF5AP_cjs.flushSessionWrites();
 }
 async function safeConversation(run) {
   try {
@@ -3637,7 +3638,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-GCHZMH42.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-A575WPBL.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3880,7 +3881,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-GCHZMH42.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-A575WPBL.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -4199,7 +4200,7 @@ function applyAggregateCap(sources, maxTotal) {
     }
     const remaining = maxTotal - totalBytes;
     if (remaining > 0) {
-      const { finalContent } = chunkEIOMN5VA_cjs.truncateWithMarker(s.content, remaining);
+      const { finalContent } = chunkEFETPSJZ_cjs.truncateWithMarker(s.content, remaining);
       kept.push({ ...s, content: finalContent, truncated: true });
       totalBytes = maxTotal;
     } else {
@@ -4296,10 +4297,10 @@ var FileContextManager = class {
     this.lastScope = [...touchedFiles];
     const config = await loadContextConfig(this.cwd);
     const legacy = await loadSources(config, this.cwd);
-    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkEIOMN5VA_cjs.DEFAULT_MAX_BYTES_PER_FILE;
+    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkEFETPSJZ_cjs.DEFAULT_MAX_BYTES_PER_FILE;
     const maxBytesTotal = this.settings.maxBytesTotal ?? DEFAULT_MAX_BYTES_TOTAL;
     const granted = this.grantedContextDialects();
-    const discovered = await chunkEIOMN5VA_cjs.runDiscovery({
+    const discovered = await chunkEFETPSJZ_cjs.runDiscovery({
       cwd: this.cwd,
       maxBytesPerFile,
       skipLegacyTheokitContext: true,
@@ -4372,7 +4373,7 @@ async function loadContextConfig(cwd) {
   });
   if (mdEntities.length > 0) {
     if (fs.existsSync(jsonPath)) {
-      chunk7IZKTQ5G_cjs.warnOnce(
+      chunkGK3UG7YQ_cjs.warnOnce(
         "context-both-present",
         "[theokit-sdk] both .theokit/context/ and .theokit/context.json detected \u2014 using markdown; remove context.json"
       );
@@ -4382,7 +4383,7 @@ async function loadContextConfig(cwd) {
     };
   }
   if (!fs.existsSync(jsonPath)) return { sources: [] };
-  chunk7IZKTQ5G_cjs.warnOnce(
+  chunkGK3UG7YQ_cjs.warnOnce(
     "context-json-deprecated",
     // Names no command: `theokit-migrate-config` was unpublished with the `bin` entry, and a warning
     // that tells you to run something the package does not ship is worse than one that tells you
@@ -4545,13 +4546,13 @@ var PluginsManager = class {
       const jsonPath = path.join(pluginsRoot, folderName, "plugin.json");
       const metadata = fs.existsSync(mdPath) ? await loadPluginManifestFromMarkdown(this.cwd, pluginsRoot, folderName) : await loadPluginManifestFromJson(this.cwd, jsonPath, folderName);
       if (fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunk7IZKTQ5G_cjs.warnOnce(
+        chunkGK3UG7YQ_cjs.warnOnce(
           `plugin-${folderName}-both`,
           `[theokit-sdk] both ${folderName}/PLUGIN.md and ${folderName}/plugin.json detected \u2014 using markdown; remove plugin.json`
         );
       }
       if (!fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunk7IZKTQ5G_cjs.warnOnce(
+        chunkGK3UG7YQ_cjs.warnOnce(
           "plugin-json-deprecated",
           // Same reason as the context.json warning: the CLI it used to name is no longer published.
           "[theokit-sdk] plugin.json manifests are deprecated; replace each with a PLUGIN.md"
@@ -6648,7 +6649,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: chunkC4ZQPWXJ_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
+      p.type === "tool_result" ? { ...p, content: chunkZLMU5EU3_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
     )
   );
 }
@@ -6940,13 +6941,13 @@ var FallbackLlmClient = class {
   async *stream(request, signal) {
     let lastError;
     for (const client of this.clients) {
-      if (signal.aborted) throw chunkC4ZQPWXJ_cjs.abortError(signal);
-      const attempt = await chunkC4ZQPWXJ_cjs.tryFirstEvent(client, request, signal, true);
+      if (signal.aborted) throw chunkZLMU5EU3_cjs.abortError(signal);
+      const attempt = await chunkZLMU5EU3_cjs.tryFirstEvent(client, request, signal, true);
       if (attempt.kind === "handshake_error") {
         lastError = attempt.error;
         continue;
       }
-      return yield* chunkC4ZQPWXJ_cjs.relayStream(attempt.generator, attempt.firstResult);
+      return yield* chunkZLMU5EU3_cjs.relayStream(attempt.generator, attempt.firstResult);
     }
     if (lastError !== void 0) throw lastError;
     throw new chunkJ7J7J2GN_cjs.NetworkError("FallbackLlmClient has no providers configured", {
@@ -7446,7 +7447,7 @@ function applyPersonalityFilter(exposedTools, whitelist, opts) {
     if (exposedSet.has(name)) continue;
     const hint = suggestClosest(name, exposedSet);
     const message = hint !== void 0 ? `[theokit-sdk] personality "${opts?.personalityName ?? "?"}" references unknown tool "${name}"; did you mean "${hint}"?` : `[theokit-sdk] personality "${opts?.personalityName ?? "?"}" references unknown tool "${name}" (not exposed)`;
-    chunk7IZKTQ5G_cjs.warnOnce(
+    chunkGK3UG7YQ_cjs.warnOnce(
       `personality-tool-missing|${opts?.agentId ?? "?"}|${opts?.personalityName ?? "?"}|${name}`,
       message
     );
@@ -7582,9 +7583,9 @@ function buildLoopInputs(options, runId, userText, userImages) {
       { code: "invalid_max_iterations" }
     );
   }
-  const { primary, effectiveModelId } = chunkC4ZQPWXJ_cjs.resolveRunProvider(options);
+  const { primary, effectiveModelId } = chunkZLMU5EU3_cjs.resolveRunProvider(options);
   const fallback = options.agentOptions.providers?.fallback;
-  const apiKeys = chunkC4ZQPWXJ_cjs.mergeExplicitApiKey(
+  const apiKeys = chunkZLMU5EU3_cjs.mergeExplicitApiKey(
     options.agentOptions.providers?.apiKeys,
     primary,
     options.agentOptions.apiKey
@@ -7593,7 +7594,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 = chunkC4ZQPWXJ_cjs.resolveProviderChain({
+  const chain = chunkZLMU5EU3_cjs.resolveProviderChain({
     primary,
     ...modelBaseUrl !== void 0 ? { baseUrl: modelBaseUrl } : {},
     ...fallback !== void 0 ? { fallback } : {},
@@ -7853,7 +7854,7 @@ function buildRealRunOptions(args) {
   };
 }
 async function createFixtureRunHelper(args) {
-  const sessionMessages = chunkDZG77WU7_cjs.getSessionMessages(args.inputs.agentId);
+  const sessionMessages = chunk3XSWF5AP_cjs.getSessionMessages(args.inputs.agentId);
   const projectMcpServers = args.inputs.settingSourcesIncludeProject ? await readProjectMcpServers(args.inputs.workspaceCwd) : {};
   return createLocalRun({
     agentId: args.inputs.agentId,
@@ -7872,7 +7873,7 @@ async function createFixtureRunHelper(args) {
 }
 async function dispatchLocalRun(args) {
   const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(args.inputs.options.apiKey);
-  if (chunkC4ZQPWXJ_cjs.shouldUseRealLocalRuntime(apiKey)) {
+  if (chunkZLMU5EU3_cjs.shouldUseRealLocalRuntime(apiKey)) {
     return createRealLocalRun(
       buildRealRunOptions({
         inputs: args.inputs,
@@ -8128,10 +8129,10 @@ async function disposeLocalAgentSession(agent) {
   agent.lifecycleAbortController.abort();
   await chunkZF2LDKQQ_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
   disposeSessionMcpClients(agent.agentId);
-  await chunkDZG77WU7_cjs.flushSessionWrites();
+  await chunk3XSWF5AP_cjs.flushSessionWrites();
   await flushRegistrySaves(agent.workspaceCwd);
   await disposeSessionStore(agent.sessionStore);
-  chunkDZG77WU7_cjs.discardSession(agent.workspaceCwd, agent.agentId);
+  chunk3XSWF5AP_cjs.discardSession(agent.workspaceCwd, agent.agentId);
 }
 async function reloadLocalAgent(agent) {
   if (agent.context !== void 0) await agent.context.refresh();
@@ -8383,7 +8384,7 @@ async function finalize(args, queryMode, result) {
   };
   args.cache?.set(args.userText, queryMode, result, tenantCtx);
   if (args.persistTranscripts === true && args.cwd !== void 0) {
-    await chunkTMKTSYDS_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkGFFBXSQT_cjs.resolveMemoryRoot(args.cwd), {
+    await chunkTMKTSYDS_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkHNAYCTX4_cjs.resolveMemoryRoot(args.cwd), {
       runId: args.runId ?? `run-${Date.now()}`,
       startedAtMs: Date.now() - result.durationMs,
       userText: args.userText,
@@ -8974,7 +8975,7 @@ var LocalAgentMemory = class {
       const openOpts = { cwd: this.workspaceCwd, memoryRoot };
       if (embedding !== void 0) openOpts.embedding = embedding;
       if (cfg?.backend !== void 0) openOpts.backend = cfg.backend;
-      this.index = await chunkVUHXC74Q_cjs.IndexManager.open(openOpts);
+      this.index = await chunk33A27NFX_cjs.IndexManager.open(openOpts);
       await this.index.sync();
       this.toolsCache = [
         createMemorySearchTool({ index: this.index }),
@@ -8995,7 +8996,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 chunkC4ZQPWXJ_cjs.CircuitBreaker();
+    if (this.breaker === void 0) this.breaker = new chunkZLMU5EU3_cjs.CircuitBreaker();
     if (this.cache === void 0) this.cache = new ActiveMemoryCache();
     const result = await runActiveMemory({
       userText,
@@ -9018,7 +9019,7 @@ var LocalAgentMemory = class {
    * and the active-memory transcript writer. Three separate resolutions is how they drifted (#463).
    */
   memoryRoot() {
-    this.memoryRootCache ??= chunkGFFBXSQT_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
+    this.memoryRootCache ??= chunkHNAYCTX4_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
     return this.memoryRootCache;
   }
   buildActiveMemoryOptions(cfg) {
@@ -9133,7 +9134,7 @@ function createLocalAgentMemoryProvider(opts) {
       return { facts: [], systemPromptAdditions: summary };
     },
     async recordSessionSummary(args) {
-      await chunkGFFBXSQT_cjs.writeSessionSummary(args);
+      await chunkHNAYCTX4_cjs.writeSessionSummary(args);
     },
     async sync(handle) {
       const state = handle[INTERNAL_LAM_KEY];
@@ -9223,7 +9224,7 @@ function addEntity(byName, entity, origin, collisionMap) {
     );
   }
   if (origin === "project" && collisionMap?.has(fm.name)) {
-    chunk7IZKTQ5G_cjs.warnOnce(
+    chunkGK3UG7YQ_cjs.warnOnce(
       `personality-collision-${fm.name}`,
       `[theokit-sdk] personality "${fm.name}" overridden by project preset`
     );
@@ -9273,14 +9274,14 @@ async function performPersonalitySwitch(args) {
 
 // src/internal/local-agent/local-agent-personality-extensions.ts
 function resolveActivePersonalityPreset(args) {
-  const forkCtx = chunk7IZKTQ5G_cjs.currentPersonalityContext();
+  const forkCtx = chunkYYN6BB7R_cjs.currentPersonalityContext();
   const slug = forkCtx !== void 0 ? forkCtx.slug : args.personalityStore.active(args.agentId);
   if (slug === void 0) return void 0;
   return args.personalityRegistry?.get(slug);
 }
 async function ensurePersonalityRegistryIfNeeded(args) {
   if (args.personalityRegistry !== void 0) return args.personalityRegistry;
-  const forkSlug = chunk7IZKTQ5G_cjs.currentPersonalityContext()?.slug;
+  const forkSlug = chunkYYN6BB7R_cjs.currentPersonalityContext()?.slug;
   const ownSlug = args.personalityStore.active(args.agentId);
   if (forkSlug === void 0 && ownSlug === void 0) return void 0;
   return await PersonalityRegistry.load(args.workspaceCwd);
@@ -9293,8 +9294,8 @@ function applyPersonalityOverlay(preset, base) {
 ${preset.systemPrompt}`;
 }
 async function localAgentUsePersonality(agent, name, opts) {
-  if (chunk7IZKTQ5G_cjs.currentPersonalityContext() !== void 0) {
-    chunk7IZKTQ5G_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
+  if (chunkYYN6BB7R_cjs.currentPersonalityContext() !== void 0) {
+    chunkYYN6BB7R_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
     return null;
   }
   if (agent.personalityRegistry === void 0) {
@@ -9310,8 +9311,8 @@ async function localAgentUsePersonality(agent, name, opts) {
       registry,
       store: agent.personalityStore,
       invalidateCache: (reason) => agent.invalidateCache(reason),
-      appendSessionMessage: (msg) => chunkDZG77WU7_cjs.appendSessionMessage(agent.agentId, msg),
-      clearSession: () => chunkDZG77WU7_cjs.clearSession(agent.agentId),
+      appendSessionMessage: (msg) => chunk3XSWF5AP_cjs.appendSessionMessage(agent.agentId, msg),
+      clearSession: () => chunk3XSWF5AP_cjs.clearSession(agent.agentId),
       opts: opts ?? {}
     })
   );
@@ -9355,7 +9356,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-WAEQI2DL.cjs');
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
-  const { withPersonalityContext } = await import('./context-HR4KMXMA.cjs');
+  const { withPersonalityContext } = await import('./context-7RP5JXGM.cjs');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9865,7 +9866,7 @@ async function executeSendLocked(inputs, message, options) {
   if (inputs.options.onBeforeSend !== void 0) {
     await inputs.options.onBeforeSend({
       conversationId: inputs.agentId,
-      previousMessageCount: chunkDZG77WU7_cjs.getSessionMessages(inputs.agentId).length
+      previousMessageCount: chunk3XSWF5AP_cjs.getSessionMessages(inputs.agentId).length
     });
   }
   await inputs.runPreHook(userText);
@@ -9877,8 +9878,8 @@ async function executeSendLocked(inputs, message, options) {
     userText,
     sendOptions: options
   });
-  const priorMessages = [...chunkDZG77WU7_cjs.getSessionMessages(inputs.agentId)];
-  chunkDZG77WU7_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
+  const priorMessages = [...chunk3XSWF5AP_cjs.getSessionMessages(inputs.agentId)];
+  chunk3XSWF5AP_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, userText);
   const memoryTools = void 0;
@@ -10184,7 +10185,7 @@ var LocalAgent = class {
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
-      await chunkDZG77WU7_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
+      await chunk3XSWF5AP_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
       await this.personalityStore.hydrate(this.agentId);
     } catch (err) {
       await releaseLeaseIfPossible(this.sessionStore, this.agentId);
@@ -10525,15 +10526,15 @@ async function maybeInjectHandoffTools(options) {
   };
 }
 function keyWillFlowToProvider(apiKey, provider) {
-  if (chunkC4ZQPWXJ_cjs.isFixtureApiKey(apiKey)) return false;
-  if (chunkC4ZQPWXJ_cjs.getConfiguredBaseUrl() !== void 0) return false;
+  if (chunkZLMU5EU3_cjs.isFixtureApiKey(apiKey)) return false;
+  if (chunkZLMU5EU3_cjs.getConfiguredBaseUrl() !== void 0) return false;
   if (provider === void 0) return false;
   const profile = chunkANMJJD6D_cjs.getProviderProfile(provider);
   if (profile === void 0) return false;
   return profile.authType !== "none";
 }
 function missingApiKeyMessage() {
-  const present = chunkC4ZQPWXJ_cjs.presentProviderCredentialEnvVars();
+  const present = chunkZLMU5EU3_cjs.presentProviderCredentialEnvVars();
   const base = `Missing API key \u2014 set ${chunk6LHQPOMI_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]}, ... })\`.`;
@@ -10553,7 +10554,7 @@ async function createLocalAgent(options) {
     }
   } else {
     const willFlowToProvider = keyWillFlowToProvider(apiKey, provider);
-    const shape = chunkC4ZQPWXJ_cjs.validateApiKeyShape(apiKey, {
+    const shape = chunkZLMU5EU3_cjs.validateApiKeyShape(apiKey, {
       strict: willFlowToProvider,
       ...willFlowToProvider ? { provider } : {}
     });
@@ -10572,15 +10573,15 @@ async function createCloudAgent(options) {
       code: "missing_api_key"
     });
   }
-  const shape = chunkC4ZQPWXJ_cjs.validateApiKeyShape(apiKey);
+  const shape = chunkZLMU5EU3_cjs.validateApiKeyShape(apiKey);
   if (shape.malformed) {
     throw new chunkJ7J7J2GN_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  const baseUrl = chunkC4ZQPWXJ_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkZLMU5EU3_cjs.getConfiguredBaseUrl();
   if (baseUrl === void 0) {
     return new CloudAgent(options);
   }
-  const response = await chunkC4ZQPWXJ_cjs.httpRequest("/v1/agents", {
+  const response = await chunkZLMU5EU3_cjs.httpRequest("/v1/agents", {
     apiKey,
     method: "POST",
     body: {
@@ -10605,7 +10606,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
-  await chunkC4ZQPWXJ_cjs.discoverProviderPlugins();
+  await chunkZLMU5EU3_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 = {
@@ -10756,7 +10757,7 @@ var Agent = class _Agent {
       pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
-      await chunkC4ZQPWXJ_cjs.discoverProviderPlugins();
+      await chunkZLMU5EU3_cjs.discoverProviderPlugins();
       const agent = await runCreateUnderSpan(options, span);
       return agent;
     } catch (err) {
@@ -11054,9 +11055,9 @@ var Agent = class _Agent {
    */
   static async compact(agentId, options = {}) {
     const reg = await requireLocalAgent(agentId, "compact");
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-7FMYJXQ7.cjs');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-75KD2FCM.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
-    return chunkDZG77WU7_cjs.enqueueSessionWrite(
+    return chunk3XSWF5AP_cjs.enqueueSessionWrite(
       cwd,
       agentId,
       () => compactSessionTranscript({
@@ -11067,7 +11068,10 @@ var Agent = class _Agent {
         summarize: options.summarize ?? buildDefaultSummarizer2({
           agentModel: model,
           ...reg.options.apiKey !== void 0 ? { apiKey: reg.options.apiKey } : {}
-        })
+        }),
+        ...options.onPreCompact !== void 0 ? { onPreCompact: options.onPreCompact } : {},
+        ...options.onPreCompactError !== void 0 ? { onPreCompactError: options.onPreCompactError } : {},
+        ...options.preCompactTimeoutMs !== void 0 ? { preCompactTimeoutMs: options.preCompactTimeoutMs } : {}
       })
     );
   }
@@ -11081,7 +11085,7 @@ var Agent = class _Agent {
    */
   static async injectSessionTurn(agentId, turn) {
     const reg = await requireLocalAgent(agentId, "injectSessionTurn");
-    const { injectSessionTurn } = await import('./inject-session-PC73TMP2.cjs');
+    const { injectSessionTurn } = await import('./inject-session-L6MIIELT.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
@@ -11252,5 +11256,5 @@ exports.managedSettingsPathFor = managedSettingsPathFor;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
 exports.readManagedSettings = readManagedSettings;
 exports.resolveSessionDir = resolveSessionDir;
-//# sourceMappingURL=chunk-GCHZMH42.cjs.map
-//# sourceMappingURL=chunk-GCHZMH42.cjs.map
+//# sourceMappingURL=chunk-A575WPBL.cjs.map
+//# sourceMappingURL=chunk-A575WPBL.cjs.map