@theokit/sdk 5.14.0 → 5.15.0

package/dist/{chunk-2WY2OFSC.cjs → chunk-64ECM3XM.cjs}

@@ -1,18 +1,19 @@
 'use strict';
 
 var chunkL7JPXZ2C_cjs = require('./chunk-L7JPXZ2C.cjs');
-var chunkLXG6VL6R_cjs = require('./chunk-LXG6VL6R.cjs');
-var chunkCWQPQTUZ_cjs = require('./chunk-CWQPQTUZ.cjs');
+var chunkU7PRI3XM_cjs = require('./chunk-U7PRI3XM.cjs');
+var chunkNEH3BPFD_cjs = require('./chunk-NEH3BPFD.cjs');
 var chunk7YUPSBDV_cjs = require('./chunk-7YUPSBDV.cjs');
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
-var chunkCGH4BCIY_cjs = require('./chunk-CGH4BCIY.cjs');
+var chunkXE3CAY6Z_cjs = require('./chunk-XE3CAY6Z.cjs');
 var chunkRS7YQR4X_cjs = require('./chunk-RS7YQR4X.cjs');
-var chunkSDZ4XDWS_cjs = require('./chunk-SDZ4XDWS.cjs');
-var chunk6OCJWGVD_cjs = require('./chunk-6OCJWGVD.cjs');
-var chunkSNVYOX46_cjs = require('./chunk-SNVYOX46.cjs');
+var chunkVWYFGE27_cjs = require('./chunk-VWYFGE27.cjs');
+var chunkFTXY4D44_cjs = require('./chunk-FTXY4D44.cjs');
+var chunkDJKGDLYZ_cjs = require('./chunk-DJKGDLYZ.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
 var chunkQG4SXZ2A_cjs = require('./chunk-QG4SXZ2A.cjs');
 var chunkUDAKAE4Z_cjs = require('./chunk-UDAKAE4Z.cjs');
+var chunkXOU3CL7S_cjs = require('./chunk-XOU3CL7S.cjs');
 var chunk3HA7N2BB_cjs = require('./chunk-3HA7N2BB.cjs');
 var chunkAA27GEYS_cjs = require('./chunk-AA27GEYS.cjs');
 var chunkYSTXFWQE_cjs = require('./chunk-YSTXFWQE.cjs');
@@ -24,17 +25,17 @@ var chunk3KIUY67P_cjs = require('./chunk-3KIUY67P.cjs');
 var chunkSA6K24NB_cjs = require('./chunk-SA6K24NB.cjs');
 var chunk27V5I2WW_cjs = require('./chunk-27V5I2WW.cjs');
 var chunk3WKWBYPO_cjs = require('./chunk-3WKWBYPO.cjs');
-var chunkG7XBVM3T_cjs = require('./chunk-G7XBVM3T.cjs');
-var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
+var chunkMHUOVS5I_cjs = require('./chunk-MHUOVS5I.cjs');
+var chunkU3DW3WDE_cjs = require('./chunk-U3DW3WDE.cjs');
 var chunkZOFRNNZD_cjs = require('./chunk-ZOFRNNZD.cjs');
-var chunkWDVG5R2Q_cjs = require('./chunk-WDVG5R2Q.cjs');
+var chunkAUH2EVWY_cjs = require('./chunk-AUH2EVWY.cjs');
 var chunkYQ3XC6C2_cjs = require('./chunk-YQ3XC6C2.cjs');
 var chunk6XQLTQB6_cjs = require('./chunk-6XQLTQB6.cjs');
 var chunkKX5QXLBS_cjs = require('./chunk-KX5QXLBS.cjs');
-var chunk4KBI37F3_cjs = require('./chunk-4KBI37F3.cjs');
+var chunkRTDVSHJR_cjs = require('./chunk-RTDVSHJR.cjs');
 var chunk3EE6LVWT_cjs = require('./chunk-3EE6LVWT.cjs');
-var chunkR5UQL2R5_cjs = require('./chunk-R5UQL2R5.cjs');
-var chunk4TEGFMSP_cjs = require('./chunk-4TEGFMSP.cjs');
+var chunkSPEN7RJU_cjs = require('./chunk-SPEN7RJU.cjs');
+var chunkP7QYG4RZ_cjs = require('./chunk-P7QYG4RZ.cjs');
 var chunkNVXXWAU7_cjs = require('./chunk-NVXXWAU7.cjs');
 var chunkEHD25JBZ_cjs = require('./chunk-EHD25JBZ.cjs');
 var chunkCEGU5AVD_cjs = require('./chunk-CEGU5AVD.cjs');
@@ -458,7 +459,7 @@ async function saveRegistry(cwd, agents2) {
     serialized[id] = toSerialized(agent);
   }
   const path = registryPath(cwd);
-  await chunkZF2LDKQQ_cjs.withCwdMutex(`registry:${cwd}`, async () => {
+  await chunkU3DW3WDE_cjs.withCwdMutex(`registry:${cwd}`, async () => {
     await chunk3HA7N2BB_cjs.writeVersionedJson(path, serialized, SCHEMA_VERSION);
   });
 }
@@ -866,7 +867,7 @@ async function readLegacyFacts(jsonPath) {
 }
 async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
-    for (const fact of facts) await chunkSDZ4XDWS_cjs.appendFactToMarkdown(cwd, fact);
+    for (const fact of facts) await chunkVWYFGE27_cjs.appendFactToMarkdown(cwd, fact);
     await promises.unlink(jsonPath).catch(() => void 0);
     chunkRNXXYF22_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
 `);
@@ -883,11 +884,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 = chunkSDZ4XDWS_cjs.legacyMemoryJsonPath(cwd, config);
+  const jsonPath = chunkVWYFGE27_cjs.legacyMemoryJsonPath(cwd, config);
   if (!await fileExists(jsonPath)) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
-  if (await fileExists(chunkSDZ4XDWS_cjs.memoryMdPath(chunkSDZ4XDWS_cjs.resolveMemoryRoot(cwd, config)))) {
+  if (await fileExists(chunkVWYFGE27_cjs.memoryMdPath(chunkVWYFGE27_cjs.resolveMemoryRoot(cwd, config)))) {
     chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
@@ -916,29 +917,29 @@ 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 (${chunkSDZ4XDWS_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 (${chunkVWYFGE27_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 chunkSDZ4XDWS_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
+  return chunkVWYFGE27_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
 }
 async function readMemoryFacts(cwd, config) {
   if (!config.enabled) return [];
   await migrateLegacyJson(cwd, config);
-  return chunkSDZ4XDWS_cjs.readFacts(cwd, config);
+  return chunkVWYFGE27_cjs.readFacts(cwd, config);
 }
 async function appendMemoryFact(cwd, config, fact) {
   if (!config.enabled) return;
-  chunkSDZ4XDWS_cjs.resolveMaxFacts(config.maxFacts);
+  chunkVWYFGE27_cjs.resolveMaxFacts(config.maxFacts);
   await migrateLegacyJson(cwd, config);
   const sanitized = {
     text: chunkRNXXYF22_cjs.redactSecrets(fact.text),
     ...fact.kind === void 0 ? {} : { kind: fact.kind }
   };
-  await chunkSDZ4XDWS_cjs.appendFact(cwd, config, sanitized);
+  await chunkVWYFGE27_cjs.appendFact(cwd, config, sanitized);
 }
 
 // src/internal/runtime/fixtures/fixture-scripts.ts
@@ -1624,7 +1625,7 @@ function createRealCloudRun(options) {
     conversation: []
   };
   const apiKey = chunkRNXXYF22_cjs.resolveApiKey(options.agentOptions.apiKey);
-  const baseUrl = chunkSNVYOX46_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkDJKGDLYZ_cjs.getConfiguredBaseUrl();
   const handle = new RealCloudRun(
     {
       id,
@@ -1676,7 +1677,10 @@ var RealCloudRun = class extends FixtureRunBase {
       await this.consumeStream(response);
     } catch (cause) {
       if (this.terminated) return;
-      this.fail(cause instanceof Error ? cause.message : String(cause));
+      this.fail(
+        cause instanceof Error ? cause.message : String(cause),
+        cause instanceof chunkCEGU5AVD_cjs.TheokitAgentError ? cause : void 0
+      );
     }
   }
   async postRun(apiKey, baseUrl) {
@@ -1707,7 +1711,7 @@ var RealCloudRun = class extends FixtureRunBase {
   async consumeStream(response) {
     let finalStatus = "finished";
     let finalText = "";
-    for await (const record of chunkSNVYOX46_cjs.parseSseStream(response.body, this.controller.signal)) {
+    for await (const record of chunkDJKGDLYZ_cjs.parseSseStream(response.body, this.controller.signal)) {
       const parsed = safeParse(record.data);
       if (parsed === void 0) continue;
       const update = this.applyRecord(record.event, parsed);
@@ -1754,13 +1758,17 @@ var RealCloudRun = class extends FixtureRunBase {
       message: { role: "assistant", content: [{ type: "text", text }] }
     };
   }
-  fail(message, code) {
+  fail(message, cause) {
     const event = this.buildAssistantEvent(message);
     this.script.events.push(event);
     this.notifyNewEvents();
     this.script.result = message;
     if (this.script.errorDetail === void 0) {
-      this.script.errorDetail = { message, ...code !== void 0 ? { code } : {} };
+      this.script.errorDetail = {
+        message,
+        ...cause?.code !== void 0 ? { code: cause.code } : {},
+        ...cause !== void 0 ? { cause } : {}
+      };
     }
     this.transitionTo("error");
   }
@@ -1874,7 +1882,7 @@ var CloudAgent = class _CloudAgent {
    */
   isFixtureMode() {
     const apiKey = chunkRNXXYF22_cjs.resolveApiKey(this.options.apiKey);
-    return chunkSNVYOX46_cjs.isFixtureApiKey(apiKey) && chunkSNVYOX46_cjs.getConfiguredBaseUrl() === void 0;
+    return chunkDJKGDLYZ_cjs.isFixtureApiKey(apiKey) && chunkDJKGDLYZ_cjs.getConfiguredBaseUrl() === void 0;
   }
   // SE9 — integrated structured output; delegates to the shared helper.
   generate(message, options) {
@@ -1900,7 +1908,7 @@ var CloudAgent = class _CloudAgent {
       throw new UnsupportedTaskOperationError("send", { cause: void 0 });
     }
     return new Promise((resolve, reject) => {
-      void chunkZF2LDKQQ_cjs.withCwdMutex(`agent-send:${this.agentId}`, async () => {
+      void chunkU3DW3WDE_cjs.withCwdMutex(`agent-send:${this.agentId}`, async () => {
         let run;
         try {
           run = await this.sendLocked(message, options);
@@ -1929,7 +1937,7 @@ var CloudAgent = class _CloudAgent {
     const userText = typeof message === "string" ? message : message.text;
     const systemPrompt = await this.resolveSystemPromptForSend(userText, options);
     const apiKey = chunkRNXXYF22_cjs.resolveApiKey(this.options.apiKey);
-    const useRealRuntime = apiKey !== void 0 && !chunkSNVYOX46_cjs.isFixtureApiKey(apiKey) && chunkSNVYOX46_cjs.getConfiguredBaseUrl() !== void 0;
+    const useRealRuntime = apiKey !== void 0 && !chunkDJKGDLYZ_cjs.isFixtureApiKey(apiKey) && chunkDJKGDLYZ_cjs.getConfiguredBaseUrl() !== void 0;
     return useRealRuntime ? createRealCloudRun({
       agentId: this.agentId,
       model: this.model ?? { id: DEFAULT_AGENTIC_MODEL_ID },
@@ -2263,7 +2271,7 @@ var PersonalityStore = class {
   async #persist(agentId, slug) {
     const filePath = this.#filePath();
     await promises.mkdir(path.dirname(filePath), { recursive: true });
-    await chunkG7XBVM3T_cjs.withFileLock(filePath, async () => {
+    await chunkMHUOVS5I_cjs.withFileLock(filePath, async () => {
       const current = await readState(filePath);
       const nextAgents = { ...current.agents };
       if (slug === void 0) delete nextAgents[agentId];
@@ -2969,7 +2977,7 @@ function resolveWindowForRun(model, contextWindow) {
   const override = contextWindow !== void 0 && contextWindow > 0 ? contextWindow : void 0;
   return chunkKX5QXLBS_cjs.resolveEffectiveContextWindow({
     ...override !== void 0 ? { override } : {},
-    catalog: chunk4TEGFMSP_cjs.getCatalogModelInfo(model)?.limit?.context,
+    catalog: chunkP7QYG4RZ_cjs.getCatalogModelInfo(model)?.limit?.context,
     margin: chunkKX5QXLBS_cjs.CONTEXT_WINDOW_MARGIN,
     floor: chunkKX5QXLBS_cjs.CONTEXT_WINDOW_FLOOR
   });
@@ -2994,7 +3002,7 @@ async function runPostRunLifecycle(inputs) {
     try {
       const partial = await safeConversation(run);
       if (partial !== void 0) {
-        chunkLXG6VL6R_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+        chunkU7PRI3XM_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
           userText,
           conversation: partial
         });
@@ -3004,11 +3012,11 @@ async function runPostRunLifecycle(inputs) {
       chunkRNXXYF22_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
-    await chunkLXG6VL6R_cjs.flushSessionWrites();
+    await chunkU7PRI3XM_cjs.flushSessionWrites();
     return;
   }
   if (result.result !== void 0) {
-    chunkLXG6VL6R_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
+    chunkU7PRI3XM_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
   const resolvedWindow = resolveWindowForRun(model, contextWindow);
@@ -3019,7 +3027,7 @@ async function runPostRunLifecycle(inputs) {
   }
   const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
   const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
-  chunkLXG6VL6R_cjs.persistTurnToTranscript(
+  chunkU7PRI3XM_cjs.persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
     agentId,
@@ -3031,7 +3039,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: chunkSNVYOX46_cjs.buildDefaultSummarizer({
+        summarize: chunkDJKGDLYZ_cjs.buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
@@ -3044,7 +3052,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: chunkSDZ4XDWS_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
+      memoryRoot: chunkVWYFGE27_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
       runId: result.id,
       agentId,
       userText,
@@ -3056,7 +3064,7 @@ async function runPostRunLifecycle(inputs) {
       if (memoryProvider?.recordSessionSummary !== void 0) {
         await memoryProvider.recordSessionSummary(summaryArgs);
       } else {
-        await chunkSDZ4XDWS_cjs.writeSessionSummary(summaryArgs);
+        await chunkVWYFGE27_cjs.writeSessionSummary(summaryArgs);
       }
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
@@ -3073,7 +3081,7 @@ async function runPostRunLifecycle(inputs) {
     agentId,
     runId: result.id
   });
-  await chunkLXG6VL6R_cjs.flushSessionWrites();
+  await chunkU7PRI3XM_cjs.flushSessionWrites();
 }
 async function safeConversation(run) {
   try {
@@ -3090,12 +3098,12 @@ var WORKSPACE_TRUST = {
   entries: "absolute folder realpaths"
 };
 function workspaceTrustRecordPath() {
-  return path.join(path.dirname(chunkSNVYOX46_cjs.trustFilePath()), "trusted-workspace-plugins.json");
+  return path.join(path.dirname(chunkDJKGDLYZ_cjs.trustFilePath()), "trusted-workspace-plugins.json");
 }
 function readTrustedWorkspaceFolders() {
   const path$1 = workspaceTrustRecordPath();
   const trusted = /* @__PURE__ */ new Set();
-  for (const entry of chunkSNVYOX46_cjs.readTrustArray(path$1, WORKSPACE_TRUST)) {
+  for (const entry of chunkDJKGDLYZ_cjs.readTrustArray(path$1, WORKSPACE_TRUST)) {
     if (path.isAbsolute(entry)) {
       trusted.add(entry);
       continue;
@@ -3166,6 +3174,177 @@ async function importEntry(candidate) {
 function isGeneralPlugin(value) {
   return chunkBV2MWEMV_cjs.isCodePlugin(value) && value.kind === "general" && typeof value.name === "string";
 }
+
+// src/internal/runtime/registry/live-agent-registry.ts
+var DEFAULT_MAX_AGENTS = 100;
+var DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
+var DEFAULT_SWEEP_INTERVAL_MS = 6e4;
+var LiveAgentRegistry = class {
+  #agents = /* @__PURE__ */ new Map();
+  #maxAgents = DEFAULT_MAX_AGENTS;
+  #idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
+  #sweepIntervalMs = DEFAULT_SWEEP_INTERVAL_MS;
+  #onEvict;
+  #sweepTimer;
+  /**
+   * Reconfigure registry behavior. Process-wide singleton (D310) — last
+   * configure call wins for all subsequent operations.
+   */
+  configure(opts) {
+    if (opts.maxAgents !== void 0) this.#maxAgents = Math.max(0, opts.maxAgents);
+    if (opts.idleTimeoutMs !== void 0) this.#idleTimeoutMs = Math.max(0, opts.idleTimeoutMs);
+    if (opts.sweepIntervalMs !== void 0)
+      this.#sweepIntervalMs = Math.max(1e3, opts.sweepIntervalMs);
+    this.#onEvict = opts.onEvict;
+    this.#stopSweep();
+    if (this.#idleTimeoutMs > 0) this.#startSweep();
+  }
+  /**
+   * Lookup a cached agent. `get` is a use — refreshes `lastUsedAt` so the
+   * entry survives LRU eviction.
+   */
+  get(id) {
+    const entry = this.#agents.get(id);
+    if (entry === void 0) return void 0;
+    entry.lastUsedAt = Date.now();
+    return entry.agent;
+  }
+  /**
+   * Insert or overwrite an agent in the cache. Triggers fire-and-forget LRU
+   * eviction when `size > maxAgents`.
+   *
+   * EC-4: when `id` already maps to a DIFFERENT agent instance, dispose the
+   * old one before overwriting (race protection against two `getOrCreate`
+   * calls creating two agents but only the second being cached — the first
+   * would leak file handles + lifecycle controllers).
+   */
+  set(id, agent) {
+    if (this.#maxAgents === 0) return;
+    const existing = this.#agents.get(id);
+    if (existing !== void 0 && existing.agent !== agent) {
+      void existing.agent.dispose().catch(() => {
+        chunkRNXXYF22_cjs.diag(`[theokit-sdk] dispose during overwrite failed (${id})
+`);
+      });
+    }
+    this.#agents.set(id, { agent, lastUsedAt: Date.now() });
+    if (this.#agents.size > this.#maxAgents) void this.#evictLRU();
+  }
+  /**
+   * Remove the entry from the cache WITHOUT calling `dispose()` or
+   * `onEvict`. Used by `LocalAgent.dispose()` itself so the disposed
+   * instance can never be returned by a subsequent `get(id)` (dispose-cache
+   * race fix). Idempotent — calling on an unknown id is a no-op.
+   *
+   * @internal
+   */
+  forget(id) {
+    this.#agents.delete(id);
+  }
+  /**
+   * Explicitly evict an agent by id. Returns `true` when the entry was
+   * present (false = already gone). Calls `agent.dispose()` + `onEvict`
+   * with reason `"explicit"`.
+   */
+  async evict(id) {
+    const entry = this.#agents.get(id);
+    if (entry === void 0) return false;
+    this.#agents.delete(id);
+    await this.#disposeAndNotify(id, entry.agent, "explicit");
+    return true;
+  }
+  /**
+   * Evict every cached agent. Used by graceful shutdown (`process.on('SIGTERM')`)
+   * or end-of-test cleanup.
+   */
+  async evictAll() {
+    const entries = Array.from(this.#agents.entries());
+    this.#agents.clear();
+    this.#stopSweep();
+    for (const [id, entry] of entries) {
+      await this.#disposeAndNotify(id, entry.agent, "explicit");
+    }
+  }
+  /** Number of currently cached agents. */
+  size() {
+    return this.#agents.size;
+  }
+  /** Ids of cached agents, newest first (by lastUsedAt). */
+  ids() {
+    return Array.from(this.#agents.entries()).sort((a, b) => b[1].lastUsedAt - a[1].lastUsedAt).map(([id]) => id);
+  }
+  /**
+   * LRU eviction: drop the entry with the smallest `lastUsedAt`. Runs only
+   * when `size > maxAgents`. Asynchronous because `dispose()` is a Promise;
+   * the hot-path caller (`set`) does not await.
+   *
+   * @internal
+   */
+  async #evictLRU() {
+    if (this.#agents.size <= this.#maxAgents) return;
+    let oldestId;
+    let oldestAt = Infinity;
+    for (const [id, entry2] of this.#agents) {
+      if (entry2.lastUsedAt < oldestAt) {
+        oldestAt = entry2.lastUsedAt;
+        oldestId = id;
+      }
+    }
+    if (oldestId === void 0) return;
+    const entry = this.#agents.get(oldestId);
+    if (entry === void 0) return;
+    this.#agents.delete(oldestId);
+    await this.#disposeAndNotify(oldestId, entry.agent, "lru");
+  }
+  /** Background sweep — drops entries whose `lastUsedAt < now - idleTimeoutMs`. */
+  async #sweepIdle() {
+    if (this.#idleTimeoutMs === 0) return;
+    const threshold = Date.now() - this.#idleTimeoutMs;
+    const toEvict = [];
+    for (const [id, entry] of this.#agents) {
+      if (entry.lastUsedAt < threshold) toEvict.push([id, entry]);
+    }
+    for (const [id, entry] of toEvict) {
+      const current = this.#agents.get(id);
+      if (current === void 0 || current.agent !== entry.agent) continue;
+      this.#agents.delete(id);
+      await this.#disposeAndNotify(id, entry.agent, "idle");
+    }
+  }
+  #startSweep() {
+    this.#sweepTimer = setInterval(() => void this.#sweepIdle(), this.#sweepIntervalMs);
+    this.#sweepTimer.unref?.();
+  }
+  #stopSweep() {
+    if (this.#sweepTimer !== void 0) {
+      clearInterval(this.#sweepTimer);
+      this.#sweepTimer = void 0;
+    }
+  }
+  /** Dispose + notify with errors swallowed (D309). Single chokepoint. */
+  async #disposeAndNotify(id, agent, reason) {
+    try {
+      await agent.dispose();
+    } catch (cause) {
+      const msg = cause instanceof Error ? cause.message : String(cause);
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
+`);
+    }
+    if (this.#onEvict !== void 0) {
+      try {
+        this.#onEvict(id, reason);
+      } catch (cause) {
+        const msg = cause instanceof Error ? cause.message : String(cause);
+        chunkRNXXYF22_cjs.diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
+`);
+      }
+    }
+  }
+};
+var liveAgentRegistry = chunkNVXXWAU7_cjs.globalSingleton(
+  "theokit-sdk.runtime.live-agents",
+  () => new LiveAgentRegistry()
+);
 function executableExtensions() {
   return process.platform === "win32" ? ["", ...(process.env.PATHEXT ?? ".EXE;.CMD").split(";")] : [""];
 }
@@ -3185,8 +3364,9 @@ function binaryOnPath(bin) {
   );
 }
 var SkillsManager = class {
-  constructor(cwd, _enabled, settingSourcesIncludeProject, skillsDir, inline, compatSources = [], bundledDirs = []) {
+  constructor(cwd, enabled, settingSourcesIncludeProject, skillsDir, inline, compatSources = [], bundledDirs = []) {
     this.cwd = cwd;
+    this.enabled = enabled;
     this.settingSourcesIncludeProject = settingSourcesIncludeProject;
     this.skillsDir = skillsDir;
     this.inline = inline;
@@ -3194,6 +3374,7 @@ var SkillsManager = class {
     this.bundledDirs = bundledDirs;
   }
   cwd;
+  enabled;
   settingSourcesIncludeProject;
   skillsDir;
   inline;
@@ -3212,7 +3393,7 @@ var SkillsManager = class {
       ...chunkYQ3XC6C2_cjs.projectConfigRoots(this.cwd, this.compatSources, "skills").map(
         (root) => path.join(root, "skills")
       ),
-      ...(await chunkWDVG5R2Q_cjs.pluginBundleDirs(this.cwd, this.compatSources)).map((b) => path.join(b, "skills"))
+      ...(await chunkAUH2EVWY_cjs.pluginBundleDirs(this.cwd, this.compatSources)).map((b) => path.join(b, "skills"))
     ] : [this.skillsDir];
     this.skills = this.mergeInline(await this.discoverFrom([...ownRoots, ...this.bundledDirs]));
   }
@@ -3239,8 +3420,12 @@ var SkillsManager = class {
     const inlineNames = new Set(this.inline.map((s) => s.name));
     return [...discovered.filter((s) => !inlineNames.has(s.name)), ...this.inline];
   }
+  visible() {
+    const allowed = this.enabled;
+    return allowed === void 0 ? this.skills : this.skills.filter((s) => allowed.includes(s.name));
+  }
   list() {
-    return Promise.resolve(this.skills);
+    return Promise.resolve(this.visible());
   }
   /**
    * SE20 — resolve a skill by name INCLUDING its body. Inline (`createSkill`)
@@ -3249,7 +3434,7 @@ var SkillsManager = class {
    * enabled skill matches (malformed skills were already excluded at discovery).
    */
   async get(name) {
-    const skill = this.skills.find((s) => s.name === name);
+    const skill = this.visible().find((s) => s.name === name);
     if (skill === void 0) return void 0;
     const instructions = typeof skill.instructions === "string" ? skill.instructions : chunk3UMPP553_cjs.stripSkillFrontmatter(await promises.readFile(skill.source, "utf8"));
     const references = skill.references;
@@ -3677,6 +3862,23 @@ function validateMcpServers(options) {
         { code: "cloud_stdio_cwd_rejected" }
       );
     }
+    rejectUnhonourableAuth(name, config, options.cloud !== void 0);
+  }
+}
+function rejectUnhonourableAuth(name, config, cloud) {
+  const auth = config.auth;
+  if (auth === void 0) return;
+  if (auth.oauth === void 0) {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
+      `MCP server "${name}" declares auth without auth.oauth, which the SDK cannot honour; use auth.oauth or set an Authorization header`,
+      { code: "mcp_auth_unsupported" }
+    );
+  }
+  if (cloud) {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
+      `MCP server "${name}" declares auth.oauth, which the SDK cannot run for a cloud agent`,
+      { code: "mcp_auth_unsupported" }
+    );
   }
 }
 function isStdioWithCwd(config) {
@@ -3785,7 +3987,7 @@ function validateToolSchema(tool) {
 }
 function validateMemory(options) {
   const memory = options.memory;
-  chunkSDZ4XDWS_cjs.resolveMaxFacts(memory?.maxFacts);
+  chunkVWYFGE27_cjs.resolveMaxFacts(memory?.maxFacts);
   if (memory?.storePath === void 0) return;
   const storePath = memory.storePath;
   if (storePath.includes("..") || storePath.startsWith("/") || /^[A-Z]:/i.test(storePath)) {
@@ -3811,7 +4013,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-2WY2OFSC.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-64ECM3XM.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -4054,7 +4256,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-2WY2OFSC.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-64ECM3XM.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -4193,8 +4395,13 @@ function wrapSpan(span, openSpans) {
     setAttribute: (k, v) => safe(() => span.setAttribute(k, redactAttrValue(v)), void 0),
     setAttributes: (attrs) => safe(() => span.setAttributes(redactAttrs(attrs)), void 0),
     addEvent: (name, attrs) => safe(() => span.addEvent(name, attrs ? redactAttrs(attrs) : void 0), void 0),
-    setStatus: (status) => safe(() => span.setStatus(status), void 0),
-    recordException: (err) => safe(() => span.recordException(err), void 0),
+    setStatus: (status) => safe(
+      () => span.setStatus(
+        status.message === void 0 ? status : { ...status, message: chunkRNXXYF22_cjs.redactSecrets(status.message) }
+      ),
+      void 0
+    ),
+    recordException: (err) => safe(() => span.recordException(redactException(err)), void 0),
     end: (endTime) => {
       safe(() => span.end(endTime), void 0);
       openSpans.delete(span);
@@ -4203,6 +4410,18 @@ function wrapSpan(span, openSpans) {
     isRecording: () => safe(() => span.isRecording(), false)
   };
 }
+function redactException(err) {
+  if (typeof err === "string") return chunkRNXXYF22_cjs.redactSecrets(err);
+  if (typeof err !== "object" || err === null) return err;
+  const src = err;
+  const out = {};
+  for (const k of ["name", "code", "message", "stack"]) {
+    const v = src[k];
+    if (typeof v === "string") out[k] = chunkRNXXYF22_cjs.redactSecrets(v);
+    else if (typeof v === "number") out[k] = v;
+  }
+  return out;
+}
 function redactAttrValue(value) {
   if (typeof value !== "string") return value;
   return chunkRNXXYF22_cjs.redactSecrets(value);
@@ -5167,7 +5386,9 @@ function evaluateBudgetGate(tracker) {
     return {
       allowed: false,
       reason: "custom",
-      detail: `budget_tracker_check_threw: ${message}`
+      detail: `budget_tracker_check_threw: ${message}`,
+      // Keep the thrown value so the run's error can carry it as its cause.
+      cause: error
     };
   }
 }
@@ -5177,11 +5398,12 @@ function createDoomLoopTracker(option) {
   if (option === false) return void 0;
   return new DoomLoopTracker(option);
 }
-var DEFAULT_CONFIG = { softThreshold: 3, hardThreshold: 5 };
-function assertValidThresholds(soft, hard) {
+var DEFAULT_CONFIG = { softThreshold: 3, hardThreshold: 5, churnThreshold: 6 };
+function assertValidThresholds(soft, hard, churn) {
   for (const [label, value] of [
     ["softThreshold", soft],
-    ["hardThreshold", hard]
+    ["hardThreshold", hard],
+    ["churnThreshold", churn]
   ]) {
     if (!Number.isInteger(value) || value < 1) {
       throw new chunkCEGU5AVD_cjs.ConfigurationError(
@@ -5218,17 +5440,40 @@ var DoomLoopTracker = class {
   #config;
   #lastSignature = "";
   #count = 0;
+  #lastName = "";
+  #lastResult;
+  #churn = 0;
   constructor(config) {
     const softThreshold = config?.softThreshold ?? DEFAULT_CONFIG.softThreshold;
     const hardThreshold = config?.hardThreshold ?? DEFAULT_CONFIG.hardThreshold;
-    assertValidThresholds(softThreshold, hardThreshold);
-    this.#config = { softThreshold, hardThreshold };
+    const churnThreshold = config?.churnThreshold ?? DEFAULT_CONFIG.churnThreshold;
+    assertValidThresholds(softThreshold, hardThreshold, churnThreshold);
+    this.#config = { softThreshold, hardThreshold, churnThreshold };
   }
   inspect(call) {
     const signature = signatureOf(call);
-    this.#count = signature === this.#lastSignature ? this.#count + 1 : 1;
+    const identical = signature === this.#lastSignature;
+    const churning = !identical && call.name === this.#lastName && call.result !== void 0 && call.result === this.#lastResult;
+    this.#churn = churning ? this.#churn + 1 : 1;
+    this.#lastName = call.name;
+    this.#lastResult = call.result;
+    this.#count = identical ? this.#count + 1 : 1;
     this.#lastSignature = signature;
     const count = this.#count;
+    const churn = this.#churn;
+    const churnHard = this.#config.churnThreshold;
+    if (churn >= churnHard) {
+      return {
+        kind: "hard",
+        message: `Detected argument churn: ${churn} consecutive calls to \`${call.name}\` with different arguments and no change in the result; stopping to avoid a loop.`
+      };
+    }
+    if (churn > 1 && churn === Math.max(2, churnHard - 2)) {
+      return {
+        kind: "soft",
+        message: `Detected argument churn: ${churn} consecutive calls to \`${call.name}\` with different arguments and no change in the result; try a different approach.`
+      };
+    }
     if (count >= this.#config.hardThreshold) {
       return {
         kind: "hard",
@@ -5246,6 +5491,9 @@ var DoomLoopTracker = class {
   reset() {
     this.#lastSignature = "";
     this.#count = 0;
+    this.#lastName = "";
+    this.#lastResult = void 0;
+    this.#churn = 0;
   }
 };
 function firstDoomLoopVerdict(tracker, calls) {
@@ -5490,7 +5738,16 @@ async function initLoopContext(inputs) {
     ),
     buildUserEvent(inputs)
   ]);
-  if (inputs.onLoopEvent !== void 0) events.subscribe(inputs.onLoopEvent);
+  if (inputs.onLoopEvent !== void 0) {
+    const sink = inputs.onLoopEvent;
+    for (const seeded of events) {
+      try {
+        sink(seeded);
+      } catch {
+      }
+    }
+    events.subscribe(sink);
+  }
   const priorMessages = replayMessages(inputs.priorMessages ?? []);
   let memorySystemPromptAdditions;
   if (inputs.memoryProvider !== void 0 && memoryProviderHandle !== void 0) {
@@ -5579,7 +5836,8 @@ async function collectTools(mcp, withheld, sink) {
         inputSchema: tool.inputSchema,
         origin: "mcp",
         mcpServerName: serverName,
-        mcpToolName: tool.name
+        mcpToolName: tool.name,
+        ...client.sequential === true ? { mcpSequential: true } : {}
       });
     }
   }
@@ -5779,7 +6037,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 = chunk4TEGFMSP_cjs.getCatalogModelInfo(key);
+    const info = chunkP7QYG4RZ_cjs.getCatalogModelInfo(key);
     const cost = info?.cost;
     if (cost === void 0) continue;
     const [prov, ...modelParts] = key.split("/");
@@ -5791,7 +6049,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: chunk4TEGFMSP_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
+      pricingVersion: chunkP7QYG4RZ_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
     };
   }
   return void 0;
@@ -6045,7 +6303,7 @@ ${chunk3UMPP553_cjs.escapeBlockBody(additions)}
 </active-memory>`;
 }
 function buildLoopSystem(systemPrompt, additions, modelId) {
-  if (!chunk4KBI37F3_cjs.isAnthropicFamilyModel(modelId) || systemPrompt === void 0 || systemPrompt.length === 0) {
+  if (!chunkRTDVSHJR_cjs.isAnthropicFamilyModel(modelId) || systemPrompt === void 0 || systemPrompt.length === 0) {
     return resolveSystemPromptWithMemoryAdditions(systemPrompt, additions);
   }
   const blocks = [{ text: systemPrompt, cacheable: true }];
@@ -6566,11 +6824,35 @@ function raceToolExecution(exec, opts) {
 // src/internal/agent-loop/tool-dispatch.ts
 async function dispatchTools(inputs, tools, toolCalls, events, parentSpan) {
   const maxConcurrent = inputs.maxConcurrentTools ?? 4;
-  return chunk27V5I2WW_cjs.mapWithConcurrency(
-    toolCalls,
-    maxConcurrent,
-    (call) => dispatchSingleCall(inputs, tools, call, events, parentSpan)
-  );
+  const units = [];
+  const bySequentialServer = /* @__PURE__ */ new Map();
+  toolCalls.forEach((call, index) => {
+    const tool = tools.find((t) => t.name === call.name);
+    if (tool?.mcpSequential === true && tool.mcpServerName !== void 0) {
+      let unit = bySequentialServer.get(tool.mcpServerName);
+      if (unit === void 0) {
+        unit = { indexes: [] };
+        bySequentialServer.set(tool.mcpServerName, unit);
+        units.push(unit);
+      }
+      unit.indexes.push(index);
+    } else {
+      units.push({ indexes: [index] });
+    }
+  });
+  const results = new Array(toolCalls.length);
+  await chunk27V5I2WW_cjs.mapWithConcurrency(units, maxConcurrent, async (unit) => {
+    for (const index of unit.indexes) {
+      results[index] = await dispatchSingleCall(
+        inputs,
+        tools,
+        toolCalls[index],
+        events,
+        parentSpan
+      );
+    }
+  });
+  return results;
 }
 async function dispatchSingleCall(inputs, tools, call, events, parentSpan) {
   const { call: workingCall, repairs } = applyRepairAndExtractCall(tools, call);
@@ -6910,7 +7192,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: chunkSNVYOX46_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
+      p.type === "tool_result" ? { ...p, content: chunkDJKGDLYZ_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
     )
   );
 }
@@ -6947,12 +7229,17 @@ async function runAgentLoop(inputs) {
     const budget = inputs.budget ?? new IterationBudget({ maxIterations: inputs.maxIterations ?? 8 });
     let lastTurnDecision;
     while (budget.shouldContinue()) {
+      injectSteered(ctx, inputs.steerQueue?.drain());
       if (inputs.budgetTracker !== void 0) {
         const decision2 = evaluateBudgetGate(inputs.budgetTracker);
         if (decision2.allowed === false) {
           ctx.finalStatus = "error";
           if (decision2.detail !== void 0) {
-            ctx.error = { message: decision2.detail, code: decision2.reason ?? "budget" };
+            ctx.error = {
+              message: decision2.detail,
+              code: decision2.reason ?? "budget",
+              ...decision2.cause !== void 0 ? { cause: decision2.cause } : {}
+            };
           }
           if (decision2.reason === "iteration_limit") {
             ctx.stoppedAtIterationLimit = true;
@@ -6964,7 +7251,13 @@ async function runAgentLoop(inputs) {
       if (usingGrace) budget.useGraceCall();
       const decision = await runIteration(inputs, ctx);
       lastTurnDecision = decision;
-      if (decision === "done") break;
+      if (decision === "done") {
+        const late = inputs.steerQueue?.drainOrClose() ?? [];
+        if (late.length === 0) break;
+        injectSteered(ctx, late);
+        budget.consume();
+        continue;
+      }
       if (decision === "error") {
         ctx.finalStatus = "error";
         break;
@@ -7092,6 +7385,10 @@ async function finishOrReflect(inputs, ctx, llmOutput) {
   ctx.finalStatus = "finished";
   return "done";
 }
+function injectSteered(ctx, texts) {
+  if (texts === void 0) return;
+  for (const text of texts) ctx.messages.push({ role: "user", content: [{ type: "text", text }] });
+}
 async function runIteration(inputs, ctx) {
   const hookCtx = { agentId: inputs.agentId, runId: inputs.runId };
   await inputs.pluginManager?.runPreLlmCallHooks(hookCtx);
@@ -7105,12 +7402,11 @@ function trackTurnUsage(inputs, llmOutput) {
   const tracker = inputs.budgetTracker;
   if (tracker === void 0) return;
   const model = inputs.model.id ?? "auto";
-  trackEvent(tracker, { tokens: promptTokens(llmOutput), model, type: "input" });
+  trackEvent(tracker, { tokens: llmOutput.inputTokens ?? 0, model, type: "input" });
+  trackEvent(tracker, { tokens: llmOutput.cacheReadTokens ?? 0, model, type: "cache_read" });
+  trackEvent(tracker, { tokens: llmOutput.cacheWriteTokens ?? 0, model, type: "cache_write" });
   trackEvent(tracker, { tokens: llmOutput.outputTokens ?? 0, model, type: "output" });
 }
-function promptTokens(llmOutput) {
-  return (llmOutput.inputTokens ?? 0) + (llmOutput.cacheReadTokens ?? 0) + (llmOutput.cacheWriteTokens ?? 0);
-}
 function trackEvent(tracker, event) {
   if (event.tokens <= 0) return;
   try {
@@ -7169,12 +7465,22 @@ async function continueOrTerminate(inputs, ctx, llmOutput) {
     }
   }
   pushToolConversationSteps(ctx, llmOutput.toolCalls, toolResults);
-  if (await inspectDoomLoop(inputs, ctx, llmOutput.toolCalls) === "stop") return "done";
+  if (await inspectDoomLoop(inputs, ctx, llmOutput.toolCalls, toolResults) === "stop")
+    return "done";
   return handleToolErrorContinuation(inputs, ctx, toolResults);
 }
-async function inspectDoomLoop(inputs, ctx, toolCalls) {
+async function inspectDoomLoop(inputs, ctx, toolCalls, toolResults) {
   if (ctx.doomLoop === void 0) return "continue";
-  const verdict = firstDoomLoopVerdict(ctx.doomLoop, toolCalls);
+  const resultById = /* @__PURE__ */ new Map();
+  for (const part of toolResults) {
+    if (part.type === "tool_result") {
+      resultById.set(part.toolUseId, JSON.stringify([part.content, part.isError === true]));
+    }
+  }
+  const verdict = firstDoomLoopVerdict(
+    ctx.doomLoop,
+    toolCalls.map((c) => ({ name: c.name, input: c.input, result: resultById.get(c.id) }))
+  );
   if (verdict.kind === "hard") {
     ctx.stoppedByDoomLoop = true;
     await emitAssistantTextStep(
@@ -7228,13 +7534,13 @@ var FallbackLlmClient = class {
   async *stream(request, signal) {
     let lastError;
     for (const client of this.clients) {
-      if (signal.aborted) throw chunkSNVYOX46_cjs.abortError(signal);
-      const attempt = await chunkSNVYOX46_cjs.tryFirstEvent(client, request, signal, true);
+      if (signal.aborted) throw chunkDJKGDLYZ_cjs.abortError(signal);
+      const attempt = await chunkDJKGDLYZ_cjs.tryFirstEvent(client, request, signal, true);
       if (attempt.kind === "handshake_error") {
         lastError = attempt.error;
         continue;
       }
-      return yield* chunkSNVYOX46_cjs.relayStream(attempt.generator, attempt.firstResult);
+      return yield* chunkDJKGDLYZ_cjs.relayStream(attempt.generator, attempt.firstResult);
     }
     if (lastError !== void 0) throw lastError;
     throw new chunkCEGU5AVD_cjs.NetworkError("FallbackLlmClient has no providers configured", {
@@ -7251,6 +7557,34 @@ function handshakeAwareTimeout(input) {
   return isReconnectHandshake ? Math.max(input.requestTimeoutMs, HANDSHAKE_FLOOR_MS) : input.requestTimeoutMs;
 }
 
+// src/internal/mcp/oauth-bearer.ts
+var EXPIRY_SKEW_MS = 3e4;
+async function obtain(serverName, clientId, scopes, oauth) {
+  const stored = await chunkXOU3CL7S_cjs.getTokens(serverName);
+  if (stored?.accessToken !== void 0 && stored.expiresAt - EXPIRY_SKEW_MS > Date.now()) {
+    return stored;
+  }
+  const refreshToken = stored?.refreshToken;
+  if (refreshToken !== void 0) {
+    try {
+      return await chunkXOU3CL7S_cjs.lockedRefresh(
+        serverName,
+        () => chunkXOU3CL7S_cjs.refreshAccessToken(serverName, clientId, refreshToken, oauth)
+      );
+    } catch {
+    }
+  }
+  const fresh = await chunkXOU3CL7S_cjs.runPkceFlow(serverName, clientId, scopes, oauth);
+  await chunkXOU3CL7S_cjs.setTokens(serverName, fresh);
+  return fresh;
+}
+async function resolveBearer(serverName, auth) {
+  if (auth.oauth === void 0)
+    throw new Error(`MCP server "${serverName}" declares no auth.oauth`);
+  const tokens = await obtain(serverName, auth.CLIENT_ID, auth.scopes, auth.oauth);
+  return `Bearer ${tokens.accessToken}`;
+}
+
 // src/internal/mcp/client.ts
 function createMcpClient(name, config, fetchImpl = fetch) {
   if (isStdio(config)) return new StdioMcpClient(name, config);
@@ -7331,6 +7665,9 @@ var StdioMcpClient = class extends BaseMcpClient {
   reconnectPromise;
   /** True only while `reconnect()`'s handshake is in flight — see `timeoutFor`. */
   reconnecting = false;
+  get sequential() {
+    return this.config.sequential === true;
+  }
   get timeoutMs() {
     return this.config.requestTimeoutMs ?? DEFAULT_MCP_TIMEOUT_MS;
   }
@@ -7537,6 +7874,9 @@ var HttpMcpClient = class extends BaseMcpClient {
    */
   sessionId;
   fetchImpl;
+  get sequential() {
+    return this.config.sequential === true;
+  }
   close() {
     return Promise.resolve();
   }
@@ -7549,7 +7889,9 @@ var HttpMcpClient = class extends BaseMcpClient {
    * override contract predates this change and is the only escape a user has while a server
    * misbehaves.
    */
-  buildHeaders() {
+  async buildHeaders() {
+    const auth = this.config.auth;
+    const bearer = auth?.oauth !== void 0 ? await resolveBearer(this.name, auth) : void 0;
     return {
       "content-type": "application/json",
       // Streamable HTTP asks for BOTH media types. Declaring only `application/json` makes a
@@ -7558,6 +7900,7 @@ var HttpMcpClient = class extends BaseMcpClient {
       // Present only for a STATEFUL server. For a stateless one nothing is sent — inventing a
       // header would trade one broken transport for another.
       ...this.sessionId !== void 0 ? { "mcp-session-id": this.sessionId } : {},
+      ...bearer !== void 0 ? { authorization: bearer } : {},
       ...this.config.headers ?? {}
     };
   }
@@ -7600,7 +7943,7 @@ var HttpMcpClient = class extends BaseMcpClient {
   async request(method, params) {
     const id = this.nextId++;
     const payload = { jsonrpc: "2.0", id, method, params };
-    const headers = this.buildHeaders();
+    const headers = await this.buildHeaders();
     const timeoutMs = this.config.requestTimeoutMs ?? DEFAULT_MCP_TIMEOUT_MS;
     let response;
     try {
@@ -7878,9 +8221,9 @@ function buildLoopInputs(options, runId, userText, userImages) {
     );
   }
   validatePruneToolResults(options.sendOptions.pruneToolResults);
-  const { primary, effectiveModelId } = chunkSNVYOX46_cjs.resolveRunProvider(options);
+  const { primary, effectiveModelId } = chunkDJKGDLYZ_cjs.resolveRunProvider(options);
   const fallback = options.agentOptions.providers?.fallback;
-  const apiKeys = chunkSNVYOX46_cjs.mergeExplicitApiKey(
+  const apiKeys = chunkDJKGDLYZ_cjs.mergeExplicitApiKey(
     options.agentOptions.providers?.apiKeys,
     primary,
     options.agentOptions.apiKey
@@ -7889,7 +8232,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 = chunkSNVYOX46_cjs.resolveProviderChain({
+  const chain = chunkDJKGDLYZ_cjs.resolveProviderChain({
     primary,
     ...modelBaseUrl !== void 0 ? { baseUrl: modelBaseUrl } : {},
     ...fallback !== void 0 ? { fallback } : {},
@@ -7947,6 +8290,7 @@ function buildLoopInputs(options, runId, userText, userImages) {
     ...options.sendOptions.context !== void 0 ? { context: options.sendOptions.context } : {},
     // SE2 — forward the opt-in typed runtime-event sink to the loop.
     ...options.sendOptions.onRunEvent !== void 0 ? { runEventSink: options.sendOptions.onRunEvent } : {},
+    ...options.steerQueue !== void 0 ? { steerQueue: options.steerQueue } : {},
     ...toolResultPolicyInputs(options.sendOptions),
     // M1-2: per-send iteration ceiling (validated above). The loop reads
     // inputs.maxIterations (default 8 when unset).
@@ -8168,11 +8512,12 @@ function buildRealRunOptions(args) {
     ...args.priorMessages.length > 0 ? { priorMessages: args.priorMessages } : {},
     ...args.memoryTools !== void 0 && args.memoryTools.length > 0 ? { memoryTools: args.memoryTools } : {},
     ...args.personalityToolWhitelist !== void 0 ? { personalityToolWhitelist: args.personalityToolWhitelist } : {},
-    ...args.personalityName !== void 0 ? { personalityName: args.personalityName } : {}
+    ...args.personalityName !== void 0 ? { personalityName: args.personalityName } : {},
+    ...args.steerQueue !== void 0 ? { steerQueue: args.steerQueue } : {}
   };
 }
 async function createFixtureRunHelper(args) {
-  const sessionMessages = chunkLXG6VL6R_cjs.getSessionMessages(args.inputs.agentId);
+  const sessionMessages = chunkU7PRI3XM_cjs.getSessionMessages(args.inputs.agentId);
   const projectMcpServers = args.inputs.settingSourcesIncludeProject ? await readProjectMcpServers(args.inputs.workspaceCwd) : {};
   return createLocalRun({
     agentId: args.inputs.agentId,
@@ -8191,7 +8536,7 @@ async function createFixtureRunHelper(args) {
 }
 async function dispatchLocalRun(args) {
   const apiKey = chunkRNXXYF22_cjs.resolveApiKey(args.inputs.options.apiKey);
-  if (chunkSNVYOX46_cjs.shouldUseRealLocalRuntime(apiKey)) {
+  if (chunkDJKGDLYZ_cjs.shouldUseRealLocalRuntime(apiKey)) {
     return createRealLocalRun(
       buildRealRunOptions({
         inputs: args.inputs,
@@ -8200,6 +8545,7 @@ async function dispatchLocalRun(args) {
         systemPrompt: args.systemPrompt,
         priorMessages: args.priorMessages,
         memoryTools: args.memoryTools,
+        ...args.steerQueue !== void 0 ? { steerQueue: args.steerQueue } : {},
         ...args.activePreset?.tools !== void 0 ? { personalityToolWhitelist: args.activePreset.tools } : {},
         ...args.activePreset !== void 0 ? { personalityName: args.activePreset.name } : {}
       })
@@ -8252,177 +8598,6 @@ async function consumePending(agentId, pending, clear, refresh) {
   await applyDeferredInvalidation(agentId, pending, refresh);
 }
 
-// src/internal/runtime/registry/live-agent-registry.ts
-var DEFAULT_MAX_AGENTS = 100;
-var DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
-var DEFAULT_SWEEP_INTERVAL_MS = 6e4;
-var LiveAgentRegistry = class {
-  #agents = /* @__PURE__ */ new Map();
-  #maxAgents = DEFAULT_MAX_AGENTS;
-  #idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
-  #sweepIntervalMs = DEFAULT_SWEEP_INTERVAL_MS;
-  #onEvict;
-  #sweepTimer;
-  /**
-   * Reconfigure registry behavior. Process-wide singleton (D310) — last
-   * configure call wins for all subsequent operations.
-   */
-  configure(opts) {
-    if (opts.maxAgents !== void 0) this.#maxAgents = Math.max(0, opts.maxAgents);
-    if (opts.idleTimeoutMs !== void 0) this.#idleTimeoutMs = Math.max(0, opts.idleTimeoutMs);
-    if (opts.sweepIntervalMs !== void 0)
-      this.#sweepIntervalMs = Math.max(1e3, opts.sweepIntervalMs);
-    this.#onEvict = opts.onEvict;
-    this.#stopSweep();
-    if (this.#idleTimeoutMs > 0) this.#startSweep();
-  }
-  /**
-   * Lookup a cached agent. `get` is a use — refreshes `lastUsedAt` so the
-   * entry survives LRU eviction.
-   */
-  get(id) {
-    const entry = this.#agents.get(id);
-    if (entry === void 0) return void 0;
-    entry.lastUsedAt = Date.now();
-    return entry.agent;
-  }
-  /**
-   * Insert or overwrite an agent in the cache. Triggers fire-and-forget LRU
-   * eviction when `size > maxAgents`.
-   *
-   * EC-4: when `id` already maps to a DIFFERENT agent instance, dispose the
-   * old one before overwriting (race protection against two `getOrCreate`
-   * calls creating two agents but only the second being cached — the first
-   * would leak file handles + lifecycle controllers).
-   */
-  set(id, agent) {
-    if (this.#maxAgents === 0) return;
-    const existing = this.#agents.get(id);
-    if (existing !== void 0 && existing.agent !== agent) {
-      void existing.agent.dispose().catch(() => {
-        chunkRNXXYF22_cjs.diag(`[theokit-sdk] dispose during overwrite failed (${id})
-`);
-      });
-    }
-    this.#agents.set(id, { agent, lastUsedAt: Date.now() });
-    if (this.#agents.size > this.#maxAgents) void this.#evictLRU();
-  }
-  /**
-   * Remove the entry from the cache WITHOUT calling `dispose()` or
-   * `onEvict`. Used by `LocalAgent.dispose()` itself so the disposed
-   * instance can never be returned by a subsequent `get(id)` (dispose-cache
-   * race fix). Idempotent — calling on an unknown id is a no-op.
-   *
-   * @internal
-   */
-  forget(id) {
-    this.#agents.delete(id);
-  }
-  /**
-   * Explicitly evict an agent by id. Returns `true` when the entry was
-   * present (false = already gone). Calls `agent.dispose()` + `onEvict`
-   * with reason `"explicit"`.
-   */
-  async evict(id) {
-    const entry = this.#agents.get(id);
-    if (entry === void 0) return false;
-    this.#agents.delete(id);
-    await this.#disposeAndNotify(id, entry.agent, "explicit");
-    return true;
-  }
-  /**
-   * Evict every cached agent. Used by graceful shutdown (`process.on('SIGTERM')`)
-   * or end-of-test cleanup.
-   */
-  async evictAll() {
-    const entries = Array.from(this.#agents.entries());
-    this.#agents.clear();
-    this.#stopSweep();
-    for (const [id, entry] of entries) {
-      await this.#disposeAndNotify(id, entry.agent, "explicit");
-    }
-  }
-  /** Number of currently cached agents. */
-  size() {
-    return this.#agents.size;
-  }
-  /** Ids of cached agents, newest first (by lastUsedAt). */
-  ids() {
-    return Array.from(this.#agents.entries()).sort((a, b) => b[1].lastUsedAt - a[1].lastUsedAt).map(([id]) => id);
-  }
-  /**
-   * LRU eviction: drop the entry with the smallest `lastUsedAt`. Runs only
-   * when `size > maxAgents`. Asynchronous because `dispose()` is a Promise;
-   * the hot-path caller (`set`) does not await.
-   *
-   * @internal
-   */
-  async #evictLRU() {
-    if (this.#agents.size <= this.#maxAgents) return;
-    let oldestId;
-    let oldestAt = Infinity;
-    for (const [id, entry2] of this.#agents) {
-      if (entry2.lastUsedAt < oldestAt) {
-        oldestAt = entry2.lastUsedAt;
-        oldestId = id;
-      }
-    }
-    if (oldestId === void 0) return;
-    const entry = this.#agents.get(oldestId);
-    if (entry === void 0) return;
-    this.#agents.delete(oldestId);
-    await this.#disposeAndNotify(oldestId, entry.agent, "lru");
-  }
-  /** Background sweep — drops entries whose `lastUsedAt < now - idleTimeoutMs`. */
-  async #sweepIdle() {
-    if (this.#idleTimeoutMs === 0) return;
-    const threshold = Date.now() - this.#idleTimeoutMs;
-    const toEvict = [];
-    for (const [id, entry] of this.#agents) {
-      if (entry.lastUsedAt < threshold) toEvict.push([id, entry]);
-    }
-    for (const [id, entry] of toEvict) {
-      const current = this.#agents.get(id);
-      if (current === void 0 || current.agent !== entry.agent) continue;
-      this.#agents.delete(id);
-      await this.#disposeAndNotify(id, entry.agent, "idle");
-    }
-  }
-  #startSweep() {
-    this.#sweepTimer = setInterval(() => void this.#sweepIdle(), this.#sweepIntervalMs);
-    this.#sweepTimer.unref?.();
-  }
-  #stopSweep() {
-    if (this.#sweepTimer !== void 0) {
-      clearInterval(this.#sweepTimer);
-      this.#sweepTimer = void 0;
-    }
-  }
-  /** Dispose + notify with errors swallowed (D309). Single chokepoint. */
-  async #disposeAndNotify(id, agent, reason) {
-    try {
-      await agent.dispose();
-    } catch (cause) {
-      const msg = cause instanceof Error ? cause.message : String(cause);
-      chunkRNXXYF22_cjs.diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
-`);
-    }
-    if (this.#onEvict !== void 0) {
-      try {
-        this.#onEvict(id, reason);
-      } catch (cause) {
-        const msg = cause instanceof Error ? cause.message : String(cause);
-        chunkRNXXYF22_cjs.diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
-`);
-      }
-    }
-  }
-};
-var liveAgentRegistry = chunkNVXXWAU7_cjs.globalSingleton(
-  "theokit-sdk.runtime.live-agents",
-  () => new LiveAgentRegistry()
-);
-
 // src/internal/local-agent/local-agent-lifecycle.ts
 async function acquireLeaseIfPossible(store, agentId) {
   if (typeof store.acquire !== "function") return;
@@ -8445,18 +8620,18 @@ async function disposeSessionStore(store) {
 async function disposeLocalAgentSession(agent) {
   liveAgentRegistry.forget(agent.agentId);
   agent.lifecycleAbortController.abort();
-  await chunkZF2LDKQQ_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
+  await chunkU3DW3WDE_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
   disposeSessionMcpClients(agent.agentId);
-  await chunkLXG6VL6R_cjs.flushSessionWrites();
+  await chunkU7PRI3XM_cjs.flushSessionWrites();
   await flushRegistrySaves(agent.workspaceCwd);
   await disposeSessionStore(agent.sessionStore);
-  chunkLXG6VL6R_cjs.discardSession(agent.workspaceCwd, agent.agentId);
+  chunkU7PRI3XM_cjs.discardSession(agent.workspaceCwd, agent.agentId);
 }
 async function reloadLocalAgent(agent) {
   if (agent.context !== void 0) await agent.context.refresh();
   if (agent.skillsManager !== void 0) await agent.skillsManager.refresh();
   if (agent.pluginsManager !== void 0) await agent.pluginsManager.refresh();
-  return await chunkWDVG5R2Q_cjs.loadSubagents(
+  return await chunkAUH2EVWY_cjs.loadSubagents(
     agent.workspaceCwd,
     agent.settingSourcesIncludeProject,
     agent.options.agents
@@ -8702,7 +8877,7 @@ async function finalize(args, queryMode, result) {
   };
   args.cache?.set(args.userText, queryMode, result, tenantCtx);
   if (args.persistTranscripts === true && args.cwd !== void 0) {
-    await chunkRS7YQR4X_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkSDZ4XDWS_cjs.resolveMemoryRoot(args.cwd), {
+    await chunkRS7YQR4X_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkVWYFGE27_cjs.resolveMemoryRoot(args.cwd), {
       runId: args.runId ?? `run-${Date.now()}`,
       startedAtMs: Date.now() - result.durationMs,
       userText: args.userText,
@@ -8805,7 +8980,7 @@ var openAiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "openai",
   autoSelectPriority: 20,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "openai",
       defaultBaseUrl: "https://api.openai.com",
@@ -8827,7 +9002,7 @@ var azureOpenAiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "azure-openai",
   autoSelectPriority: 25,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "azure-openai",
       defaultBaseUrl: "https://your-resource.openai.azure.com",
@@ -8863,7 +9038,7 @@ var cohereMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "cohere",
   autoSelectPriority: 30,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "cohere",
       defaultBaseUrl: "https://api.cohere.com",
@@ -8909,7 +9084,7 @@ var deepinfraMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "deepinfra",
   autoSelectPriority: 13,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "deepinfra",
       defaultBaseUrl: "https://api.deepinfra.com",
@@ -8935,7 +9110,7 @@ var geminiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "gemini",
   autoSelectPriority: 30,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "gemini",
       defaultBaseUrl: "https://generativelanguage.googleapis.com",
@@ -8963,7 +9138,7 @@ var jinaMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "jina",
   autoSelectPriority: 35,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "jina",
       defaultBaseUrl: "https://api.jina.ai",
@@ -8986,7 +9161,7 @@ var mistralMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "mistral",
   autoSelectPriority: 18,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "mistral",
       defaultBaseUrl: "https://api.mistral.ai",
@@ -9028,7 +9203,7 @@ var ollamaMemoryEmbeddingProviderAdapter = {
   autoSelectPriority: 10,
   create: (options) => {
     const apiKey = options.apiKey ?? process.env.OLLAMA_API_KEY ?? OLLAMA_LOCAL_SENTINEL_KEY;
-    return chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+    return chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
       {
         id: "ollama",
         defaultBaseUrl: "http://localhost:11434",
@@ -9056,7 +9231,7 @@ var openRouterMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "openrouter",
   autoSelectPriority: 15,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "openrouter",
       defaultBaseUrl: "https://openrouter.ai/api",
@@ -9084,7 +9259,7 @@ var voyageMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "voyage",
   autoSelectPriority: 14,
-  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkXE3CAY6Z_cjs.createOpenAiCompatibleRuntime(
     {
       id: "voyage",
       defaultBaseUrl: "https://api.voyageai.com",
@@ -9293,7 +9468,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 chunkCWQPQTUZ_cjs.IndexManager.open(openOpts);
+      this.index = await chunkNEH3BPFD_cjs.IndexManager.open(openOpts);
       await this.index.sync();
       this.toolsCache = [
         createMemorySearchTool({ index: this.index }),
@@ -9314,7 +9489,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 chunkSNVYOX46_cjs.CircuitBreaker();
+    if (this.breaker === void 0) this.breaker = new chunkDJKGDLYZ_cjs.CircuitBreaker();
     if (this.cache === void 0) this.cache = new ActiveMemoryCache();
     const result = await runActiveMemory({
       userText,
@@ -9337,7 +9512,7 @@ var LocalAgentMemory = class {
    * and the active-memory transcript writer. Three separate resolutions is how they drifted (#463).
    */
   memoryRoot() {
-    this.memoryRootCache ??= chunkSDZ4XDWS_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
+    this.memoryRootCache ??= chunkVWYFGE27_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
     return this.memoryRootCache;
   }
   buildActiveMemoryOptions(cfg) {
@@ -9452,7 +9627,7 @@ function createLocalAgentMemoryProvider(opts) {
       return { facts: [], systemPromptAdditions: summary };
     },
     async recordSessionSummary(args) {
-      await chunkSDZ4XDWS_cjs.writeSessionSummary(args);
+      await chunkVWYFGE27_cjs.writeSessionSummary(args);
     },
     async sync(handle) {
       const state = handle[INTERNAL_LAM_KEY];
@@ -9620,7 +9795,7 @@ async function localAgentUsePersonality(agent, name, opts) {
     agent.personalityRegistry = await PersonalityRegistry.load(agent.workspaceCwd);
   }
   const registry = agent.personalityRegistry;
-  return chunkZF2LDKQQ_cjs.withCwdMutex(
+  return chunkU3DW3WDE_cjs.withCwdMutex(
     `agent-send:${agent.agentId}`,
     () => performPersonalitySwitch({
       agentId: agent.agentId,
@@ -9629,8 +9804,8 @@ async function localAgentUsePersonality(agent, name, opts) {
       registry,
       store: agent.personalityStore,
       invalidateCache: (reason) => agent.invalidateCache(reason),
-      appendSessionMessage: (msg) => chunkLXG6VL6R_cjs.appendSessionMessage(agent.agentId, msg),
-      clearSession: () => chunkLXG6VL6R_cjs.clearSession(agent.agentId),
+      appendSessionMessage: (msg) => chunkU7PRI3XM_cjs.appendSessionMessage(agent.agentId, msg),
+      clearSession: () => chunkU7PRI3XM_cjs.clearSession(agent.agentId),
       opts: opts ?? {}
     })
   );
@@ -10141,6 +10316,14 @@ async function applyInputProcessors(inputs, message, rawUserText, options, sendM
   const effectiveMessage = typeof message === "string" ? res.value : { ...message, text: res.value };
   return { userText: res.value, effectiveMessage };
 }
+var lastSendAt = /* @__PURE__ */ new Map();
+function applyIdleReset(agentId, minutes) {
+  const now = Date.now();
+  const previous = lastSendAt.get(agentId);
+  lastSendAt.set(agentId, now);
+  if (minutes === void 0 || !Number.isFinite(minutes) || minutes <= 0) return;
+  if (previous !== void 0 && now - previous > minutes * 6e4) chunkU7PRI3XM_cjs.clearSession(agentId);
+}
 async function executeSendLocked(inputs, message, options) {
   if (inputs.disposed) throw new chunkCEGU5AVD_cjs.AgentDisposedError(inputs.agentId);
   await consumePending(
@@ -10155,10 +10338,11 @@ async function executeSendLocked(inputs, message, options) {
   const gated = await applyInputProcessors(inputs, message, rawUserText, options, sendModel);
   if ("tripwireRun" in gated) return gated.tripwireRun;
   const { userText, effectiveMessage } = gated;
+  applyIdleReset(inputs.agentId, inputs.options.sessionIdleResetMinutes);
   if (inputs.options.onBeforeSend !== void 0) {
     await inputs.options.onBeforeSend({
       conversationId: inputs.agentId,
-      previousMessageCount: chunkLXG6VL6R_cjs.getSessionMessages(inputs.agentId).length
+      previousMessageCount: chunkU7PRI3XM_cjs.getSessionMessages(inputs.agentId).length
     });
   }
   await inputs.runPreHook(userText);
@@ -10170,8 +10354,8 @@ async function executeSendLocked(inputs, message, options) {
     userText,
     sendOptions: options
   });
-  const priorMessages = [...chunkLXG6VL6R_cjs.getSessionMessages(inputs.agentId)];
-  chunkLXG6VL6R_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
+  const priorMessages = [...chunkU7PRI3XM_cjs.getSessionMessages(inputs.agentId)];
+  chunkU7PRI3XM_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;
@@ -10340,6 +10524,43 @@ function reportUnknownLocalOptions(local) {
   }
 }
 
+// src/internal/local-agent/send-queue.ts
+var TurnSteerQueue = class {
+  pending = [];
+  closed = false;
+  /** @returns false when the turn can no longer pick the message up. */
+  push(text) {
+    if (this.closed) return false;
+    this.pending.push(text);
+    return true;
+  }
+  drain() {
+    const taken = this.pending;
+    this.pending = [];
+    return taken;
+  }
+  drainOrClose() {
+    const taken = this.drain();
+    if (taken.length === 0) this.closed = true;
+    return taken;
+  }
+  /** Stop accepting and hand back what no loop iteration picked up. */
+  closeAndTake() {
+    this.closed = true;
+    return this.drain();
+  }
+};
+function joinCollected(messages) {
+  if (messages.length === 1) return messages[0];
+  const texts = messages.map((m) => typeof m === "string" ? m : m.text);
+  const images = messages.flatMap((m) => typeof m === "string" ? [] : m.images ?? []);
+  const text = texts.join("\n\n");
+  return images.length > 0 ? { text, images } : text;
+}
+function hasImages(message) {
+  return typeof message !== "string" && (message.images?.length ?? 0) > 0;
+}
+
 // src/internal/local-agent/local-agent.ts
 var LocalAgent = class {
   /**
@@ -10388,6 +10609,9 @@ var LocalAgent = class {
   settingSourcesIncludePlugins;
   resolvedSubagents = {};
   disposed = false;
+  activeTurn;
+  inflight = 0;
+  collectBatch;
   invalidationPending;
   skillsManager;
   pluginsManager;
@@ -10424,7 +10648,7 @@ var LocalAgent = class {
     this.options = options;
     this.workspaceCwd = resolveCwd(options.local?.cwd);
     this.transcriptBaseDir = resolveSessionDir(options.local);
-    this.sessionStore = options.local?.sessionStore ?? new chunk6OCJWGVD_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
+    this.sessionStore = options.local?.sessionStore ?? new chunkFTXY4D44_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
     this.settingSourcesIncludeProject = includesSetting(options, "project");
     this.settingSourcesIncludePlugins = includesSetting(options, "plugins");
     const sub = bootstrapSubmanagers({
@@ -10476,7 +10700,7 @@ var LocalAgent = class {
     const codePlugins = chunkBV2MWEMV_cjs.extractCodePlugins(this.options.plugins);
     const manifestPlugins = await this.importManifestPlugins();
     await this.pluginManagerCode.initialize([...codePlugins, ...manifestPlugins]);
-    this.resolvedSubagents = await chunkWDVG5R2Q_cjs.loadSubagents(
+    this.resolvedSubagents = await chunkAUH2EVWY_cjs.loadSubagents(
       this.workspaceCwd,
       this.settingSourcesIncludeProject,
       this.options.agents,
@@ -10484,7 +10708,7 @@ var LocalAgent = class {
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
-      await chunkLXG6VL6R_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
+      await chunkU7PRI3XM_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
       await this.personalityStore.hydrate(this.agentId);
     } catch (err) {
       await releaseLeaseIfPossible(this.sessionStore, this.agentId);
@@ -10512,10 +10736,48 @@ var LocalAgent = class {
       agentId: this.agentId,
       ...this.model?.id !== void 0 ? { model: this.model.id } : {}
     });
+    return this.enqueueSend(message, options, sendSpan);
+  }
+  /** Queue one send behind the lock, or fold it into the running turn / pending batch. */
+  enqueueSend(message, options, sendSpan) {
+    const mode = options.queueMode ?? "followup";
+    const text = typeof message === "string" ? message : message.text;
+    const active = this.activeTurn;
+    if (mode === "steer" && active !== void 0 && !hasImages(message) && active.steer.push(text)) {
+      sendSpan.end();
+      return active.run;
+    }
+    if (mode === "collect" && this.collectBatch !== void 0) {
+      this.collectBatch.messages.push(message);
+      sendSpan.end();
+      return this.collectBatch.run;
+    }
+    const key = `agent-send:${this.agentId}`;
+    this.inflight += 1;
+    const release = () => {
+      this.inflight -= 1;
+    };
+    if (mode === "collect" && this.inflight > 1) {
+      const messages = [message];
+      const run = new Promise((resolve, reject) => {
+        void chunkU3DW3WDE_cjs.withCwdMutex(key, () => {
+          this.collectBatch = void 0;
+          return this.runLockedSendCycle(
+            joinCollected(messages),
+            options,
+            sendSpan,
+            resolve,
+            reject
+          ).finally(release);
+        });
+      });
+      this.collectBatch = { messages, run };
+      return run;
+    }
     return new Promise((resolve, reject) => {
-      void chunkZF2LDKQQ_cjs.withCwdMutex(
-        `agent-send:${this.agentId}`,
-        () => this.runLockedSendCycle(message, options, sendSpan, resolve, reject)
+      void chunkU3DW3WDE_cjs.withCwdMutex(
+        key,
+        () => this.runLockedSendCycle(message, options, sendSpan, resolve, reject).finally(release)
       );
     });
   }
@@ -10531,20 +10793,40 @@ var LocalAgent = class {
     const declared = this.model?.contextWindow;
     return declared !== void 0 ? { contextWindow: declared } : {};
   }
+  /** A steered message the loop never picked up (run errored, was cancelled) still gets answered. */
+  followUpUnsteered(leftover) {
+    if (leftover.length === 0) return;
+    this.send(leftover.join("\n\n")).catch(
+      (err) => chunkRNXXYF22_cjs.diagFailure(`[theokit-sdk] steered message followup failed: ${String(err)}`)
+    );
+  }
   async runLockedSendCycle(message, options, sendSpan, resolve, reject) {
     const userText = typeof message === "string" ? message : message.text;
     let run;
+    const steer = new TurnSteerQueue();
+    let res = () => void 0;
+    let rej = () => void 0;
+    const turnRun = new Promise((a, b) => {
+      res = a;
+      rej = b;
+    });
+    turnRun.catch(() => void 0);
+    this.activeTurn = { steer, run: turnRun };
     try {
       run = await this.sendLocked(message, options);
     } catch (err) {
       sendSpan.recordException(err);
       sendSpan.setStatus({ code: 2, message: err instanceof Error ? err.message : String(err) });
       sendSpan.end();
+      this.activeTurn = void 0;
+      rej(err);
       reject(err);
       return;
     }
     if (options.task !== void 0) registerRunAsTask(run, this.agentId, options.task, userText);
-    resolve(callerView(run, this.options.throwOnError));
+    const view = callerView(run, this.options.throwOnError);
+    res(view);
+    resolve(view);
     try {
       await runPostRunLifecycle({
         run,
@@ -10568,6 +10850,8 @@ var LocalAgent = class {
       });
     } finally {
       sendSpan.end();
+      this.activeTurn = void 0;
+      this.followUpUnsteered(steer.closeAndTake());
     }
   }
   async sendLocked(message, options) {
@@ -10675,11 +10959,13 @@ var LocalAgent = class {
       memoryFacts,
       priorMessages,
       memoryTools,
-      activePreset: this.activePreset()
+      activePreset: this.activePreset(),
+      ...this.activeTurn !== void 0 ? { steerQueue: this.activeTurn.steer } : {}
     });
   }
   close() {
     this.disposed = true;
+    liveAgentRegistry.forget(this.agentId);
   }
   async reload() {
     this.resolvedSubagents = await reloadLocalAgent(this);
@@ -10828,22 +11114,22 @@ async function maybeInjectHandoffTools(options) {
   };
 }
 function keyWillFlowToProvider(apiKey, provider) {
-  if (chunkSNVYOX46_cjs.isFixtureApiKey(apiKey)) return false;
-  if (chunkSNVYOX46_cjs.getConfiguredBaseUrl() !== void 0) return false;
+  if (chunkDJKGDLYZ_cjs.isFixtureApiKey(apiKey)) return false;
+  if (chunkDJKGDLYZ_cjs.getConfiguredBaseUrl() !== void 0) return false;
   if (provider === void 0) return false;
-  const profile = chunkR5UQL2R5_cjs.getProviderProfile(provider);
+  const profile = chunkSPEN7RJU_cjs.getProviderProfile(provider);
   if (profile === void 0) return false;
   return profile.authType !== "none";
 }
 function missingApiKeyMessage() {
-  const present = chunkSNVYOX46_cjs.presentProviderCredentialEnvVars();
+  const present = chunkDJKGDLYZ_cjs.presentProviderCredentialEnvVars();
   const base = `Missing API key \u2014 set ${chunkRNXXYF22_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 = chunkR5UQL2R5_cjs.getProviderProfile(provider);
+  const profile = chunkSPEN7RJU_cjs.getProviderProfile(provider);
   if (profile === void 0) return true;
   return profile.authType === "api_key";
 }
@@ -10856,7 +11142,7 @@ async function createLocalAgent(options) {
     }
   } else {
     const willFlowToProvider = keyWillFlowToProvider(apiKey, provider);
-    const shape = chunkSNVYOX46_cjs.validateApiKeyShape(apiKey, {
+    const shape = chunkDJKGDLYZ_cjs.validateApiKeyShape(apiKey, {
       strict: willFlowToProvider,
       ...willFlowToProvider ? { provider } : {}
     });
@@ -10875,15 +11161,15 @@ async function createCloudAgent(options) {
       code: "missing_api_key"
     });
   }
-  const shape = chunkSNVYOX46_cjs.validateApiKeyShape(apiKey);
+  const shape = chunkDJKGDLYZ_cjs.validateApiKeyShape(apiKey);
   if (shape.malformed) {
     throw new chunkCEGU5AVD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  const baseUrl = chunkSNVYOX46_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkDJKGDLYZ_cjs.getConfiguredBaseUrl();
   if (baseUrl === void 0) {
     return new CloudAgent(options);
   }
-  const response = await chunkSNVYOX46_cjs.httpRequest("/v1/agents", {
+  const response = await chunkDJKGDLYZ_cjs.httpRequest("/v1/agents", {
     apiKey,
     method: "POST",
     body: {
@@ -10908,7 +11194,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
-  await chunkSNVYOX46_cjs.discoverProviderPlugins();
+  await chunkDJKGDLYZ_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 mergedMemory = mergeResumedMemory(existing.options.memory, options.memory);
@@ -10924,7 +11210,7 @@ async function rehydrateExistingAgent(agentId, existing, options) {
     mcpServers: void 0,
     agentId
   };
-  chunkSDZ4XDWS_cjs.resolveMaxFacts(mergedOptions.memory?.maxFacts);
+  chunkVWYFGE27_cjs.resolveMaxFacts(mergedOptions.memory?.maxFacts);
   if (existing.runtime === "cloud") {
     return new CloudAgent(mergedOptions, agentId);
   }
@@ -11030,6 +11316,7 @@ function paginateByKey(all, keyOf, limit, cursor, sortByKey) {
 
 // src/agent.ts
 var streamObjectImport;
+var getOrCreateInFlight = /* @__PURE__ */ new Map();
 var Agent = class _Agent {
   constructor() {
   }
@@ -11068,7 +11355,7 @@ var Agent = class _Agent {
       pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
-      await chunkSNVYOX46_cjs.discoverProviderPlugins();
+      await chunkDJKGDLYZ_cjs.discoverProviderPlugins();
       const agent = await runCreateUnderSpan(options, span);
       return agent;
     } catch (err) {
@@ -11214,7 +11501,7 @@ var Agent = class _Agent {
    * @public
    */
   static async batch(prompts, options) {
-    const { batchImpl } = await import('./batch-IZ5EDKJ5.cjs');
+    const { batchImpl } = await import('./batch-VFR2MAUE.cjs');
     return batchImpl(prompts, options, { create: (opts) => _Agent.create(opts) });
   }
   /**
@@ -11244,18 +11531,27 @@ var Agent = class _Agent {
    *   The agent-builder's M85 interrupt rotates the session id to work around a
    *   constraint that does not exist.
    *
-   * - `close()` marks the handle disposed WITHOUT evicting the cache entry. It is
-   *   internal and unused today; if it becomes reachable, this bullet stops being true
-   *   for that path.
+   * - `close()` marks the handle disposed AND drops its cache entry, so the next call
+   *   builds a fresh handle.
    *
    * @public
    */
   static async getOrCreate(agentId, options) {
     const cached = _Agent.registry.get(agentId);
     if (cached !== void 0) return cached;
-    const fresh = await getOrCreateUncached(agentId, options);
-    _Agent.registry.set(agentId, fresh);
-    return fresh;
+    const inFlight = getOrCreateInFlight.get(agentId);
+    if (inFlight !== void 0) return inFlight;
+    const build = (async () => {
+      const fresh = await getOrCreateUncached(agentId, options);
+      _Agent.registry.set(agentId, fresh);
+      return fresh;
+    })();
+    getOrCreateInFlight.set(agentId, build);
+    try {
+      return await build;
+    } finally {
+      if (getOrCreateInFlight.get(agentId) === build) getOrCreateInFlight.delete(agentId);
+    }
   }
   /**
    * List agents (local or cloud). M107 — `cwd` is READ, not ignored. B-115 (2026-08-19) —
@@ -11366,9 +11662,9 @@ var Agent = class _Agent {
    */
   static async compact(agentId, options = {}) {
     const reg = await requireLocalAgent(agentId, "compact");
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-D2MQDB6G.cjs');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-NX7HUNTB.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
-    return chunkLXG6VL6R_cjs.enqueueSessionWrite(
+    return chunkU7PRI3XM_cjs.enqueueSessionWrite(
       cwd,
       agentId,
       () => compactSessionTranscript({
@@ -11396,7 +11692,7 @@ var Agent = class _Agent {
    */
   static async injectSessionTurn(agentId, turn) {
     const reg = await requireLocalAgent(agentId, "injectSessionTurn");
-    const { injectSessionTurn } = await import('./inject-session-3ICZIJ2N.cjs');
+    const { injectSessionTurn } = await import('./inject-session-AWKDCGHV.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
@@ -11447,7 +11743,7 @@ var Agent = class _Agent {
    */
   static async describe(agentId) {
     const agent = await getRegisteredAgentOrThrow(agentId);
-    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-TXOA5EJJ.cjs');
+    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-KLWF4QPD.cjs');
     const settingSources = agent.options.local?.settingSources;
     const subagents = await loadSubagents2(
       agent.cwd ?? process.cwd(),
@@ -11546,7 +11842,9 @@ 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-S2AXVJIX.cjs');
+  const injected = reg.options.local?.sessionStore;
+  if (injected !== void 0) return { cwd, model, store: injected };
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-CYNTEPJZ.cjs');
   const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-7TZ6HXSX.cjs');
   const configuredSessionDir = reg.options.local?.sessionDir ?? reg.options.local?.baseDir;
   const baseDir = configuredSessionDir !== void 0 ? expandTilde2(configuredSessionDir) : defaultBaseDir2();
@@ -11567,5 +11865,5 @@ exports.managedSettingsPathFor = managedSettingsPathFor;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
 exports.readManagedSettings = readManagedSettings;
 exports.resolveSessionDir = resolveSessionDir;
-//# sourceMappingURL=chunk-2WY2OFSC.cjs.map
-//# sourceMappingURL=chunk-2WY2OFSC.cjs.map
+//# sourceMappingURL=chunk-64ECM3XM.cjs.map
+//# sourceMappingURL=chunk-64ECM3XM.cjs.map