@theokit/sdk 4.37.2 → 4.39.0

package/dist/{chunk-W52DKZBR.cjs → chunk-INSFS5GT.cjs}

@@ -1,34 +1,35 @@
 'use strict';
 
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
-var chunk6EDQBX7U_cjs = require('./chunk-6EDQBX7U.cjs');
-var chunkH5YVJB4K_cjs = require('./chunk-H5YVJB4K.cjs');
-var chunkITLS5LRF_cjs = require('./chunk-ITLS5LRF.cjs');
-var chunkALU3KC4G_cjs = require('./chunk-ALU3KC4G.cjs');
-var chunk2423XDPT_cjs = require('./chunk-2423XDPT.cjs');
-var chunkFAY3QDGC_cjs = require('./chunk-FAY3QDGC.cjs');
+var chunkN475ETD6_cjs = require('./chunk-N475ETD6.cjs');
+var chunkDCXRHCZJ_cjs = require('./chunk-DCXRHCZJ.cjs');
+var chunk74D7KSBP_cjs = require('./chunk-74D7KSBP.cjs');
+var chunkBPN5ONSW_cjs = require('./chunk-BPN5ONSW.cjs');
+var chunkCN6UX5EV_cjs = require('./chunk-CN6UX5EV.cjs');
+var chunk6LGQECT7_cjs = require('./chunk-6LGQECT7.cjs');
 var chunkWPZTYOUX_cjs = require('./chunk-WPZTYOUX.cjs');
-var chunkD4ZUJTFB_cjs = require('./chunk-D4ZUJTFB.cjs');
+var chunkLALG2K33_cjs = require('./chunk-LALG2K33.cjs');
+var chunk7U2HAAWB_cjs = require('./chunk-7U2HAAWB.cjs');
 var chunk6JSIEDKL_cjs = require('./chunk-6JSIEDKL.cjs');
-var chunkG2F67XUR_cjs = require('./chunk-G2F67XUR.cjs');
+var chunkB4YA6BRS_cjs = require('./chunk-B4YA6BRS.cjs');
 var chunkNINIJCHU_cjs = require('./chunk-NINIJCHU.cjs');
 var chunkYPEPCZHF_cjs = require('./chunk-YPEPCZHF.cjs');
 var chunkVJ26EKGJ_cjs = require('./chunk-VJ26EKGJ.cjs');
-var chunkSWIBQFPH_cjs = require('./chunk-SWIBQFPH.cjs');
-var chunkTQI3KRXZ_cjs = require('./chunk-TQI3KRXZ.cjs');
+var chunk7OLG7VI4_cjs = require('./chunk-7OLG7VI4.cjs');
+var chunkZ2CUEBXV_cjs = require('./chunk-Z2CUEBXV.cjs');
+var chunkDMTZ3FII_cjs = require('./chunk-DMTZ3FII.cjs');
 var chunkYLQQX5W2_cjs = require('./chunk-YLQQX5W2.cjs');
-var chunkIEUDKUPM_cjs = require('./chunk-IEUDKUPM.cjs');
 var chunkWJVHMTKB_cjs = require('./chunk-WJVHMTKB.cjs');
-var chunkICYBIC6N_cjs = require('./chunk-ICYBIC6N.cjs');
-var chunkGM7QDQ24_cjs = require('./chunk-GM7QDQ24.cjs');
-var chunk4YB7B3RP_cjs = require('./chunk-4YB7B3RP.cjs');
+var chunkDGLLVCNB_cjs = require('./chunk-DGLLVCNB.cjs');
+var chunkW4WKVOOQ_cjs = require('./chunk-W4WKVOOQ.cjs');
+var chunkJ6T5LWJ4_cjs = require('./chunk-J6T5LWJ4.cjs');
 var chunkVYHJZVL5_cjs = require('./chunk-VYHJZVL5.cjs');
-var chunk56ZM6P7Z_cjs = require('./chunk-56ZM6P7Z.cjs');
-var chunkQUFSDDNU_cjs = require('./chunk-QUFSDDNU.cjs');
-var chunkYBFDBOUN_cjs = require('./chunk-YBFDBOUN.cjs');
-var chunk7DXLNNKH_cjs = require('./chunk-7DXLNNKH.cjs');
-var chunkMHCKWQR3_cjs = require('./chunk-MHCKWQR3.cjs');
-var chunkLTCOPATU_cjs = require('./chunk-LTCOPATU.cjs');
+var chunkG4XUXSRN_cjs = require('./chunk-G4XUXSRN.cjs');
+var chunkE4IUN3JB_cjs = require('./chunk-E4IUN3JB.cjs');
+var chunk7YBJZS5P_cjs = require('./chunk-7YBJZS5P.cjs');
+var chunkG2Q3ZC6C_cjs = require('./chunk-G2Q3ZC6C.cjs');
+var chunkIHFNRNTJ_cjs = require('./chunk-IHFNRNTJ.cjs');
+var chunkBCQ3E2ZG_cjs = require('./chunk-BCQ3E2ZG.cjs');
 var promises = require('fs/promises');
 var crypto = require('crypto');
 var path = require('path');
@@ -224,7 +225,7 @@ async function agentGenerate(agent, agentModel, agentApiKey, agentLocal, input,
   const { output, maxRetries, errorStrategy, ...sendOptions } = options;
   const run = await agent.send(input, sendOptions);
   const result = await run.wait();
-  const { generateObjectImpl, GenerateObjectError } = await import('./generate-object-5SCEH2EE.cjs');
+  const { generateObjectImpl, GenerateObjectError } = await import('./generate-object-UF6WIZLF.cjs');
   const answer = structurableAnswerOrThrow(result, GenerateObjectError);
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
   const facade = getAgentFacade();
@@ -326,7 +327,7 @@ function normalizeModel(m) {
   if (m === void 0 || typeof m !== "string") return m;
   const id = m.trim();
   if (id.length === 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       'model must be a non-empty "provider/model" id string or a ModelSelection object',
       { code: "invalid_model_selection" }
     );
@@ -462,7 +463,7 @@ function registryPath(cwd) {
   return path.join(cwd, REGISTRY_RELATIVE_PATH);
 }
 async function loadRegistry(cwd) {
-  return chunkD4ZUJTFB_cjs.readVersionedJson({
+  return chunkLALG2K33_cjs.readVersionedJson({
     path: registryPath(cwd),
     currentVersion: SCHEMA_VERSION,
     defaultValue: () => ({}),
@@ -486,7 +487,7 @@ async function saveRegistry(cwd, agents2) {
   }
   const path = registryPath(cwd);
   await chunkYLQQX5W2_cjs.withCwdMutex(`registry:${cwd}`, async () => {
-    await chunkD4ZUJTFB_cjs.writeVersionedJson(path, serialized, SCHEMA_VERSION);
+    await chunkLALG2K33_cjs.writeVersionedJson(path, serialized, SCHEMA_VERSION);
   });
 }
 function toSerialized(agent) {
@@ -553,7 +554,7 @@ function scheduleSaveForCwd(cwd) {
       }
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] registry persist failed (${cwd}): ${msg}
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] registry persist failed (${cwd}): ${msg}
 `);
     } finally {
       pendingSaves.delete(cwd);
@@ -892,14 +893,14 @@ async function readLegacyFacts(jsonPath) {
 }
 async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
-    for (const fact of facts) await chunk2423XDPT_cjs.appendFactToMarkdown(cwd, fact);
+    for (const fact of facts) await chunkCN6UX5EV_cjs.appendFactToMarkdown(cwd, fact);
     await promises.unlink(jsonPath).catch(() => void 0);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
 `);
     return { migrated: true, factCount: facts.length };
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] memory migration failed (readonly fs?): ${message}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] memory migration failed (readonly fs?): ${message}
 `);
     return { migrated: false, factCount: 0, reason: "readonly-fs" };
   }
@@ -909,12 +910,12 @@ 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 = chunk2423XDPT_cjs.legacyMemoryJsonPath(cwd, config);
+  const jsonPath = chunkCN6UX5EV_cjs.legacyMemoryJsonPath(cwd, config);
   if (!await fileExists(jsonPath)) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
-  if (await fileExists(chunk2423XDPT_cjs.memoryMdPath(cwd))) {
-    chunkLTCOPATU_cjs.diag(
+  if (await fileExists(chunkCN6UX5EV_cjs.memoryMdPath(cwd))) {
+    chunkBCQ3E2ZG_cjs.diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
     );
@@ -938,13 +939,13 @@ function extractMemoryFact(message) {
 async function readMemoryFacts(cwd, config) {
   if (!config.enabled) return [];
   await migrateLegacyJson(cwd, config);
-  return chunk2423XDPT_cjs.readFacts(cwd, config);
+  return chunkCN6UX5EV_cjs.readFacts(cwd, config);
 }
 async function appendMemoryFact(cwd, config, fact) {
   if (!config.enabled) return;
   await migrateLegacyJson(cwd, config);
-  const sanitized = { text: chunkLTCOPATU_cjs.redactSecrets(fact.text) };
-  await chunk2423XDPT_cjs.appendFact(cwd, config, sanitized);
+  const sanitized = { text: chunkBCQ3E2ZG_cjs.redactSecrets(fact.text) };
+  await chunkCN6UX5EV_cjs.appendFact(cwd, config, sanitized);
 }
 
 // src/internal/runtime/fixtures/fixture-scripts.ts
@@ -1292,7 +1293,7 @@ function redactScriptSecrets(script) {
 function redactEventSecrets(event) {
   const serialized = JSON.stringify(event);
   const localStripped = serialized.replace(FIXTURE_SENTINEL, "***");
-  const redacted = chunkLTCOPATU_cjs.redactSecrets(localStripped);
+  const redacted = chunkBCQ3E2ZG_cjs.redactSecrets(localStripped);
   if (redacted === serialized) return event;
   return JSON.parse(redacted);
 }
@@ -1323,6 +1324,16 @@ var FixtureRunBase = class {
   resolveTermination;
   terminated = false;
   eventNotifier;
+  /**
+   * theokit#140 - the run's single ordered timeline: structural events and live token/tool deltas,
+   * in the order they actually occurred.
+   *
+   * Kept alongside `script.events` rather than replacing it. `stream()` is the SDKMessage view and
+   * stays byte-identical for every existing consumer; this is the complete view, and a consumer
+   * picks one. Merging them would have changed `stream()`'s element type - a breaking change for
+   * an additive feature.
+   */
+  timeline = [];
   constructor(options) {
     this.id = options.id;
     this.agentId = options.agentId;
@@ -1346,6 +1357,46 @@ var FixtureRunBase = class {
     this.eventNotifier = makeNotifier();
     current.resolve();
   }
+  /**
+   * theokit#140 - every event of this run, in true order, from ONE source.
+   *
+   * ## The defect this replaces
+   *
+   * A consumer that needed tool calls interleaved with tokens had to fuse two surfaces by hand:
+   * `stream()`, which was batched and post-completion, and `SendOptions.onDelta`, which was live.
+   * Neither was complete alone - `onDelta` has no `run_started`/`system`, and `stream()` had no
+   * token granularity - so the entire reconciliation, including its dedup, lived in the consumer.
+   * `@theokit/agents` carried ~200 lines of exactly that, and it is the documented root of its
+   * ordering bug (theokit#47), its namespace-dedup bug (#138) and its missing terminal frame (#142).
+   *
+   * The ordering is not reconstructed here. Both kinds are appended by the loop AS THEY HAPPEN, so
+   * arrival order IS model order - there is nothing to sort, and no timestamp heuristic to get
+   * wrong.
+   *
+   * `callId` is whatever the SDK's own `tool_call` events carry, so a consumer no longer holds two
+   * id namespaces and no longer has to correlate them.
+   */
+  async *events() {
+    let index = 0;
+    while (!this.terminated) {
+      while (index < this.timeline.length) {
+        yield this.timeline[index++];
+      }
+      if (this.terminated) break;
+      await Promise.race([this.eventNotifier.promise, this.terminationPromise]);
+    }
+    while (index < this.timeline.length) {
+      yield this.timeline[index++];
+    }
+    for await (const message of this.terminalErrorEvent()) {
+      yield { kind: "message", message };
+    }
+  }
+  /** theokit#140 - append to the timeline and wake `events()`. */
+  pushTimeline(event) {
+    this.timeline.push(event);
+    this.notifyNewEvents();
+  }
   async *stream() {
     let index = 0;
     while (!this.terminated) {
@@ -1361,22 +1412,22 @@ var FixtureRunBase = class {
     yield* this.terminalErrorEvent();
   }
   /**
-   * theokit#101 — quando o run termina em erro, `stream()` tem de DIZER.
+   * theokit#101 — when the run ends in error, `stream()` has to SAY SO.
    *
-   * O erro sempre existiu: o loop o registra em `ctx.error` e `wait()` devolve
-   * `status: 'error'` com a mensagem. Só o `stream()` não o mencionava — ele drena
-   * `script.events` e para. Uma falha de provider (404 "No endpoints found", auth, timeout)
-   * produzia um turno que parecia bem-sucedido e vazio, em TODA superfície que consome o
+   * The error always existed: the loop records it in `ctx.error` and `wait()` returns
+   * `status: 'error'` with the message. Only `stream()` failed to mention it — it drains
+   * `script.events` and stops. A provider failure (404 "No endpoints found", auth, timeout)
+   * produced a turn that looked successful and empty, on EVERY surface consuming the
    * stream: HTTP web, MCP, stdio, TUI in-process.
    *
-   * Erro silencioso é o pior tipo (Regra Inquebrável 8). E a assimetria era o que o tornava
-   * difícil de diagnosticar: quem depurasse por `wait()` via o erro e não reproduziria o
-   * relato de quem depurava pelo stream.
+   * A silent error is the worst kind (Unbreakable Rule 8). And the asymmetry was what made it
+   * hard to diagnose: anyone debugging via `wait()` saw the error and would not reproduce the
+   * report of anyone debugging via the stream.
    *
-   * Emite `SDKStatusMessage` com `status: "ERROR"` — o tipo JÁ EXISTE na união `SDKMessage`
-   * e já é esperado por quem consome. Um tipo novo seria breaking para todo consumidor que
-   * faz switch exaustivo; este é aditivo, e um consumidor que ignore `status` simplesmente
-   * segue como antes — nunca pior que hoje.
+   * It emits `SDKStatusMessage` with `status: "ERROR"` — the type ALREADY EXISTS in the `SDKMessage` union
+   * and is already expected by consumers. A new type would be breaking for every consumer doing
+   * an exhaustive switch; this one is additive, and a consumer ignoring `status` simply
+   * behaves as before — never worse than today.
    */
   *terminalErrorEvent() {
     if (this.status !== "error") return;
@@ -1386,7 +1437,7 @@ var FixtureRunBase = class {
       agent_id: this.agentId,
       run_id: this.id,
       status: "ERROR",
-      // Sem mensagem, o consumidor sabe QUE falhou e não O QUÊ — que é metade do defeito.
+      // Without a message, the consumer knows THAT it failed and not WHAT — which is half the defect.
       ...detail?.message !== void 0 ? { message: detail.message } : {}
     };
   }
@@ -1565,7 +1616,7 @@ function createRealCloudRun(options) {
     conversation: []
   };
   const apiKey = resolveApiKey(options.agentOptions.apiKey);
-  const baseUrl = chunkALU3KC4G_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkBPN5ONSW_cjs.getConfiguredBaseUrl();
   const handle = new RealCloudRun(
     {
       id,
@@ -1638,7 +1689,7 @@ var RealCloudRun = class extends FixtureRunBase {
     });
     if (!response.ok) {
       const text = await response.text().catch(() => "");
-      throw new chunkMHCKWQR3_cjs.NetworkError(
+      throw new chunkIHFNRNTJ_cjs.NetworkError(
         `Cloud Run endpoint returned ${response.status}: ${text.slice(0, 200)}`,
         { code: "cloud_run_http_error" }
       );
@@ -1648,7 +1699,7 @@ var RealCloudRun = class extends FixtureRunBase {
   async consumeStream(response) {
     let finalStatus = "finished";
     let finalText = "";
-    for await (const record of chunkALU3KC4G_cjs.parseSseStream(response.body, this.controller.signal)) {
+    for await (const record of chunkBPN5ONSW_cjs.parseSseStream(response.body, this.controller.signal)) {
       const parsed = safeParse(record.data);
       if (parsed === void 0) continue;
       const update = this.applyRecord(record.event, parsed);
@@ -1757,7 +1808,7 @@ var CloudAgent = class {
    */
   isFixtureMode() {
     const apiKey = resolveApiKey(this.options.apiKey);
-    return chunkALU3KC4G_cjs.isFixtureApiKey(apiKey) && chunkALU3KC4G_cjs.getConfiguredBaseUrl() === void 0;
+    return chunkBPN5ONSW_cjs.isFixtureApiKey(apiKey) && chunkBPN5ONSW_cjs.getConfiguredBaseUrl() === void 0;
   }
   // SE9 — integrated structured output; delegates to the shared helper.
   generate(message, options) {
@@ -1772,7 +1823,7 @@ var CloudAgent = class {
   }
   async send(message, options = {}) {
     if (options.tools !== void 0 && options.tools.length > 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         "Custom inline tools are local-only in SDK v1.0 \u2014 cloud agents cannot serialize handler functions",
         { code: "cloud_custom_tools_rejected" }
       );
@@ -1808,7 +1859,7 @@ var CloudAgent = class {
     const userText = typeof message === "string" ? message : message.text;
     const systemPrompt = await this.resolveSystemPromptForSend(userText, options);
     const apiKey = resolveApiKey(this.options.apiKey);
-    const useRealRuntime = apiKey !== void 0 && !chunkALU3KC4G_cjs.isFixtureApiKey(apiKey) && chunkALU3KC4G_cjs.getConfiguredBaseUrl() !== void 0;
+    const useRealRuntime = apiKey !== void 0 && !chunkBPN5ONSW_cjs.isFixtureApiKey(apiKey) && chunkBPN5ONSW_cjs.getConfiguredBaseUrl() !== void 0;
     return useRealRuntime ? createRealCloudRun({
       agentId: this.agentId,
       model: this.model ?? { id: DEFAULT_AGENTIC_MODEL_ID },
@@ -1857,7 +1908,7 @@ var CloudAgent = class {
   listArtifacts() {
     if (!this.isFixtureMode()) {
       return Promise.reject(
-        new chunkMHCKWQR3_cjs.ConfigurationError(
+        new chunkIHFNRNTJ_cjs.ConfigurationError(
           "Cloud runtime is pre-release. listArtifacts() will return real artifacts when Theo PaaS ships; today it is only available in fixture mode (theo_test_* keys).",
           { code: "cloud_runtime_pre_release" }
         )
@@ -1867,11 +1918,11 @@ var CloudAgent = class {
   }
   downloadArtifact(path) {
     try {
-      chunkYBFDBOUN_cjs.validateArtifactPath(path);
+      chunk7YBJZS5P_cjs.validateArtifactPath(path);
     } catch (cause) {
-      if (cause instanceof chunkYBFDBOUN_cjs.PathTraversalError) {
+      if (cause instanceof chunk7YBJZS5P_cjs.PathTraversalError) {
         return Promise.reject(
-          new chunkMHCKWQR3_cjs.ConfigurationError(`Artifact path must stay inside the workspace: ${path}`, {
+          new chunkIHFNRNTJ_cjs.ConfigurationError(`Artifact path must stay inside the workspace: ${path}`, {
             code: "artifact_path_traversal",
             cause
           })
@@ -1881,7 +1932,7 @@ var CloudAgent = class {
     }
     if (!this.isFixtureMode()) {
       return Promise.reject(
-        new chunkMHCKWQR3_cjs.ConfigurationError(
+        new chunkIHFNRNTJ_cjs.ConfigurationError(
           "Cloud runtime is pre-release. downloadArtifact() will fetch real PaaS artifacts when the cloud runtime ships; today it is only available in fixture mode (theo_test_* keys).",
           { code: "cloud_runtime_pre_release" }
         )
@@ -1890,7 +1941,7 @@ var CloudAgent = class {
     const match = buildFixtureArtifacts().find((artifact) => artifact.path === path);
     if (match === void 0) {
       return Promise.reject(
-        new chunkMHCKWQR3_cjs.UnknownAgentError(`Artifact ${path} not found`, { code: "unknown_artifact" })
+        new chunkIHFNRNTJ_cjs.UnknownAgentError(`Artifact ${path} not found`, { code: "unknown_artifact" })
       );
     }
     return Promise.resolve(Buffer.from(`fixture artifact content for ${path}
@@ -1904,7 +1955,7 @@ var CloudAgent = class {
    * @public
    */
   runUntil() {
-    throw new chunkMHCKWQR3_cjs.UnsupportedRunOperationError(
+    throw new chunkIHFNRNTJ_cjs.UnsupportedRunOperationError(
       "Agent.runUntil() is not supported on cloud agents. Cloud runtime manages goal loops server-side. Use a local agent for autonomous Ralph loops.",
       "runUntil"
     );
@@ -1915,7 +1966,7 @@ var CloudAgent = class {
    * @public
    */
   fork() {
-    throw new chunkMHCKWQR3_cjs.UnsupportedRunOperationError(
+    throw new chunkIHFNRNTJ_cjs.UnsupportedRunOperationError(
       "Agent.fork() is not supported on cloud agents. Fork inheritance requires local credential + system-prompt access. Use a local agent.",
       "fork"
     );
@@ -1927,7 +1978,7 @@ var CloudAgent = class {
    * @public
    */
   runToCompletion() {
-    throw new chunkMHCKWQR3_cjs.UnsupportedRunOperationError(
+    throw new chunkIHFNRNTJ_cjs.UnsupportedRunOperationError(
       "Agent.runToCompletion() is not supported on cloud agents. Cloud runtime manages continuation server-side. Use a local agent.",
       "runToCompletion"
     );
@@ -1939,7 +1990,7 @@ var CloudAgent = class {
    * @public
    */
   streamToCompletion() {
-    throw new chunkMHCKWQR3_cjs.UnsupportedRunOperationError(
+    throw new chunkIHFNRNTJ_cjs.UnsupportedRunOperationError(
       "Agent.streamToCompletion() is not supported on cloud agents. Cloud runtime manages continuation server-side. Use a local agent.",
       "streamToCompletion"
     );
@@ -1953,7 +2004,7 @@ var CloudAgent = class {
    */
   usePersonality() {
     return Promise.reject(
-      new chunkMHCKWQR3_cjs.UnsupportedRunOperationError(
+      new chunkIHFNRNTJ_cjs.UnsupportedRunOperationError(
         "Agent.usePersonality() is not supported on cloud agents (pre-release). Use a local agent or wait for cloud GA.",
         "usePersonality"
       )
@@ -1981,7 +2032,7 @@ function validateCloudToolParity(options) {
 function rejectProcessors(options) {
   const hasProcessors = (options.inputProcessors?.length ?? 0) > 0 || (options.outputProcessors?.length ?? 0) > 0;
   if (hasProcessors) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Cloud agents can't run guardrail processors \u2014 a Processor carries function handlers that don't survive serialization to PaaS. Run processors on a local agent, or move the guardrail into a server-side gateway in front of TheoCloud.",
       { code: "cloud_incompatible_function_resolver" }
     );
@@ -1989,7 +2040,7 @@ function rejectProcessors(options) {
 }
 function rejectFunctionSystemPrompt(options) {
   if (typeof options.systemPrompt === "function") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Cloud agents require systemPrompt as a serializable string. SystemPromptResolver functions can't run on PaaS \u2014 resolve to a string before Agent.create() or move the dynamic logic into a hook rule.",
       { code: "cloud_incompatible_function_resolver" }
     );
@@ -1997,7 +2048,7 @@ function rejectFunctionSystemPrompt(options) {
 }
 function rejectFunctionSkills(options) {
   if (typeof options.skills === "function") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Cloud agents require skills as a static settings object. SkillsResolver functions can't run on PaaS \u2014 resolve to a SkillsSettings object before Agent.create() or move the dynamic logic into a hook rule.",
       { code: "cloud_incompatible_function_resolver" }
     );
@@ -2009,7 +2060,7 @@ function rejectStdioMcpLocalPaths(options) {
     if (!isStdioCommandConfig(config)) continue;
     const command = config.command ?? "";
     if (isLocalPath(command)) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `MCP server "${name}" uses a local-FS command path (${command}). Cloud agents can't reach local binaries \u2014 use a bare command (npx, uvx, node, \u2026) that the PaaS VM image provides, or switch to an HTTP MCP server.`,
         { code: "cloud_incompatible_mcp_stdio_local" }
       );
@@ -2049,14 +2100,14 @@ async function readState(filePath) {
   try {
     parsed = JSON.parse(raw);
   } catch {
-    chunkFAY3QDGC_cjs.warnOnce(
+    chunk6LGQECT7_cjs.warnOnce(
       "personality-store-json-parse",
       "[theokit-sdk] personality.json is malformed; treating as empty"
     );
     return emptyState();
   }
   if (!isStateV1(parsed)) {
-    chunkFAY3QDGC_cjs.warnOnce(
+    chunk6LGQECT7_cjs.warnOnce(
       "personality-store-bad-version",
       `[theokit-sdk] personality.json has unknown version; treating as empty (file kept untouched)`
     );
@@ -2087,9 +2138,9 @@ var PersonalityStore = class {
       try {
         await this.#persist(agentId, slug);
       } catch (err) {
-        chunkFAY3QDGC_cjs.warnOnce(
+        chunk6LGQECT7_cjs.warnOnce(
           `personality-store-persist-failure-${agentId}`,
-          `[theokit-sdk] personality persist failed for ${chunkLTCOPATU_cjs.redactSecrets(agentId)}: ${chunkLTCOPATU_cjs.redactSecrets(
+          `[theokit-sdk] personality persist failed for ${chunkBCQ3E2ZG_cjs.redactSecrets(agentId)}: ${chunkBCQ3E2ZG_cjs.redactSecrets(
             err.message
           )}`
         );
@@ -2104,9 +2155,9 @@ var PersonalityStore = class {
     try {
       state = await readState(filePath);
     } catch (err) {
-      chunkFAY3QDGC_cjs.warnOnce(
+      chunk6LGQECT7_cjs.warnOnce(
         `personality-store-hydrate-failure-${agentId}`,
-        `[theokit-sdk] personality hydrate failed for ${chunkLTCOPATU_cjs.redactSecrets(agentId)}: ${chunkLTCOPATU_cjs.redactSecrets(
+        `[theokit-sdk] personality hydrate failed for ${chunkBCQ3E2ZG_cjs.redactSecrets(agentId)}: ${chunkBCQ3E2ZG_cjs.redactSecrets(
           err.message
         )}`
       );
@@ -2123,17 +2174,17 @@ var PersonalityStore = class {
   async #persist(agentId, slug) {
     const filePath = this.#filePath();
     await promises.mkdir(path.dirname(filePath), { recursive: true });
-    await chunkTQI3KRXZ_cjs.withFileLock(filePath, async () => {
+    await chunkDMTZ3FII_cjs.withFileLock(filePath, async () => {
       const current = await readState(filePath);
       const nextAgents = { ...current.agents };
       if (slug === void 0) delete nextAgents[agentId];
       else nextAgents[agentId] = slug;
       const next = { version: SCHEMA_VERSION2, agents: nextAgents };
-      await chunkICYBIC6N_cjs.atomicWriteJson(filePath, next);
+      await chunkDGLLVCNB_cjs.atomicWriteJson(filePath, next);
     });
   }
   #filePath() {
-    return path.join(chunkD4ZUJTFB_cjs.getTheokitHome(this.#cwd), FILE_NAME);
+    return path.join(chunkLALG2K33_cjs.getTheokitHome(this.#cwd), FILE_NAME);
   }
 };
 
@@ -2156,7 +2207,7 @@ function createPluginContext() {
     },
     on(hook, handler) {
       if (typeof handler !== "function") {
-        chunkLTCOPATU_cjs.diag(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
+        chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
 `);
         return;
       }
@@ -2209,7 +2260,7 @@ var PluginManager = class {
     const seen = /* @__PURE__ */ new Set();
     for (const plugin of plugins) {
       if (seen.has(plugin.name)) {
-        chunkLTCOPATU_cjs.diag(
+        chunkBCQ3E2ZG_cjs.diag(
           `[theokit-sdk] duplicate plugin name "${plugin.name}" \u2014 both will register independently
 `
         );
@@ -2236,7 +2287,7 @@ var PluginManager = class {
    */
   async register(plugin) {
     if (plugin.kind !== "general") {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `late register supports general plugins only (got "${plugin.kind}" for "${plugin.name}")`,
         { code: "plugin_late_register_kind" }
       );
@@ -2293,7 +2344,7 @@ var PluginManager = class {
           parts.push(result.recalledContext);
         }
       } catch (err) {
-        chunkLTCOPATU_cjs.diag(
+        chunkBCQ3E2ZG_cjs.diag(
           `[theokit-sdk] pre_user_send hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2321,7 +2372,7 @@ var PluginManager = class {
       try {
         await h(ctx);
       } catch (err) {
-        chunkLTCOPATU_cjs.diag(
+        chunkBCQ3E2ZG_cjs.diag(
           `[theokit-sdk] post_assistant_reply hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2337,7 +2388,7 @@ var PluginManager = class {
       try {
         await h(ctx);
       } catch (err) {
-        chunkLTCOPATU_cjs.diag(
+        chunkBCQ3E2ZG_cjs.diag(
           `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2352,7 +2403,7 @@ var PluginManager = class {
         const out = await h(current, ctx);
         if (out !== void 0) current = out;
       } catch (err) {
-        chunkLTCOPATU_cjs.diag(
+        chunkBCQ3E2ZG_cjs.diag(
           `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2494,7 +2545,7 @@ var HooksExecutor = class {
       this.config = {};
       return;
     }
-    this.config = await chunkFAY3QDGC_cjs.loadHookConfig(this.cwd);
+    this.config = await chunk6LGQECT7_cjs.loadHookConfig(this.cwd);
   }
   /** Fire every hook registered for `event` and aggregate the decisions. */
   async run(payload) {
@@ -2600,11 +2651,11 @@ function buildContextBudgetEvent(model, resolved) {
 // src/internal/runtime/lifecycle/post-run-lifecycle.ts
 function resolveWindowForRun(model, contextWindow) {
   const override = contextWindow !== void 0 && contextWindow > 0 ? contextWindow : void 0;
-  return chunk4YB7B3RP_cjs.resolveEffectiveContextWindow({
+  return chunkJ6T5LWJ4_cjs.resolveEffectiveContextWindow({
     ...override !== void 0 ? { override } : {},
-    catalog: chunk56ZM6P7Z_cjs.getCatalogModelInfo(model)?.limit?.context,
-    margin: chunk4YB7B3RP_cjs.CONTEXT_WINDOW_MARGIN,
-    floor: chunk4YB7B3RP_cjs.CONTEXT_WINDOW_FLOOR
+    catalog: chunkG4XUXSRN_cjs.getCatalogModelInfo(model)?.limit?.context,
+    margin: chunkJ6T5LWJ4_cjs.CONTEXT_WINDOW_MARGIN,
+    floor: chunkJ6T5LWJ4_cjs.CONTEXT_WINDOW_FLOOR
   });
 }
 async function runPostRunLifecycle(inputs) {
@@ -2628,32 +2679,32 @@ async function runPostRunLifecycle(inputs) {
     try {
       const parcial = await safeConversation(run);
       if (parcial !== void 0) {
-        chunkH5YVJB4K_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+        chunkDCXRHCZJ_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
           userText,
           conversation: parcial
         });
       }
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
-    await chunkH5YVJB4K_cjs.flushSessionWrites();
+    await chunkDCXRHCZJ_cjs.flushSessionWrites();
     return;
   }
   if (result.result !== void 0) {
-    chunkH5YVJB4K_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
+    chunkDCXRHCZJ_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
   const resolvedWindow = resolveWindowForRun(model, contextWindow);
-  const janelaEfetiva = resolvedWindow.window;
+  const effectiveWindow = resolvedWindow.window;
   const budgetEvent = buildContextBudgetEvent(model, resolvedWindow);
   if (budgetEvent !== void 0 && onRunEvent !== void 0) {
-    chunk6EDQBX7U_cjs.emitRunEvent(onRunEvent, budgetEvent);
+    chunkN475ETD6_cjs.emitRunEvent(onRunEvent, budgetEvent);
   }
   const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
   const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
-  chunkH5YVJB4K_cjs.persistTurnToTranscript(
+  chunkDCXRHCZJ_cjs.persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
     agentId,
@@ -2662,16 +2713,16 @@ async function runPostRunLifecycle(inputs) {
       conversation,
       autoCompact: {
         usageTotal: usageForTrigger,
-        // A janela EFETIVA (após override, clamp e margem) — não a declarada. Trocar por
-        // `contextWindow` aqui orçaria contra um número que o clamp já rejeitou.
-        contextWindow: janelaEfetiva,
-        summarize: chunkALU3KC4G_cjs.buildDefaultSummarizer({
+        // 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: chunkBPN5ONSW_cjs.buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
       }
     },
-    onRunEvent !== void 0 ? () => chunk6EDQBX7U_cjs.emitRunEvent(onRunEvent, { type: "compact_boundary", trigger: "auto" }) : void 0
+    onRunEvent !== void 0 ? () => chunkN475ETD6_cjs.emitRunEvent(onRunEvent, { type: "compact_boundary", trigger: "auto" }) : void 0
   );
   if (result.status === "finished" && result.result !== void 0) {
     const summaryArgs = {
@@ -2687,14 +2738,14 @@ async function runPostRunLifecycle(inputs) {
       if (memoryProvider?.recordSessionSummary !== void 0) {
         await memoryProvider.recordSessionSummary(summaryArgs);
       } else {
-        await chunk2423XDPT_cjs.writeSessionSummary(summaryArgs);
+        await chunkCN6UX5EV_cjs.writeSessionSummary(summaryArgs);
       }
       if (!shouldUsePortMemoryPath()) {
         void memoryGlue.syncIfReady();
       }
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] session summary write failed (${result.id}): ${message}
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] session summary write failed (${result.id}): ${message}
 `);
     }
   }
@@ -2707,7 +2758,7 @@ async function runPostRunLifecycle(inputs) {
     agentId,
     runId: result.id
   });
-  await chunkH5YVJB4K_cjs.flushSessionWrites();
+  await chunkDCXRHCZJ_cjs.flushSessionWrites();
 }
 async function safeConversation(run) {
   try {
@@ -2782,7 +2833,7 @@ var warned = /* @__PURE__ */ new Set();
 function warnDoubleReasoningOnce() {
   if (warned.has("double-reasoning")) return;
   warned.add("double-reasoning");
-  chunkLTCOPATU_cjs.diag(
+  chunkBCQ3E2ZG_cjs.diag(
     "[theokit-sdk] `reasoning: true` skipped \u2014 a native reasoning model is configured (model.params thinking/reasoning); native reasoning wins. Remove one to silence.\n"
   );
 }
@@ -2815,9 +2866,9 @@ var SkillsManager = class {
   }
   async refresh() {
     const skillsRoot = this.skillsDir ?? path.join(this.cwd, ".theokit", "skills");
-    const discovered = await chunkQUFSDDNU_cjs.discoverSkills(skillsRoot, {
+    const discovered = await chunkE4IUN3JB_cjs.discoverSkills(skillsRoot, {
       onInvalidSkill: (info) => {
-        chunkLTCOPATU_cjs.diag(`[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
+        chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
 `);
       }
     });
@@ -2841,7 +2892,7 @@ var SkillsManager = class {
   async get(name) {
     const skill = this.skills.find((s) => s.name === name);
     if (skill === void 0) return void 0;
-    const instructions = typeof skill.instructions === "string" ? skill.instructions : chunkQUFSDDNU_cjs.stripSkillFrontmatter(await promises.readFile(skill.source, "utf8"));
+    const instructions = typeof skill.instructions === "string" ? skill.instructions : chunkE4IUN3JB_cjs.stripSkillFrontmatter(await promises.readFile(skill.source, "utf8"));
     const references = skill.references;
     return {
       name: skill.name,
@@ -2927,7 +2978,7 @@ async function safeCall(fn, fallback, label = "safeCall") {
     return await fn();
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] ${label} failed: ${message}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] ${label} failed: ${message}
 `);
     return fallback;
   }
@@ -2941,7 +2992,7 @@ var ActiveMemoryPromptProvider = class {
     if (ctx.activeMemorySummary === void 0 || ctx.activeMemorySummary.length === 0) {
       return Promise.resolve(void 0);
     }
-    const body = chunkQUFSDDNU_cjs.escapeBlockBody(ctx.activeMemorySummary);
+    const body = chunkE4IUN3JB_cjs.escapeBlockBody(ctx.activeMemorySummary);
     return Promise.resolve(`<active-memory>
 ${body}
 </active-memory>`);
@@ -2994,7 +3045,7 @@ function formatSource(name, tokens) {
   if (tokens.length === 0) {
     return `  <source name="${escapeAttribute(name)}" />`;
   }
-  const body = chunkQUFSDDNU_cjs.escapeBlockBody(tokens.join(" "));
+  const body = chunkE4IUN3JB_cjs.escapeBlockBody(tokens.join(" "));
   return `  <source name="${escapeAttribute(name)}">
     ${body}
   </source>`;
@@ -3010,7 +3061,7 @@ var MemoryPromptProvider = class {
   contribute(ctx) {
     if (ctx.memoryAutoInject === false) return Promise.resolve(void 0);
     if (ctx.memory.length === 0) return Promise.resolve(void 0);
-    const lines = ctx.memory.map((fact) => `  - ${chunkQUFSDDNU_cjs.escapeBlockBody(fact.text)}`);
+    const lines = ctx.memory.map((fact) => `  - ${chunkE4IUN3JB_cjs.escapeBlockBody(fact.text)}`);
     return Promise.resolve(`<memory>
 ${lines.join("\n")}
 </memory>`);
@@ -3032,7 +3083,7 @@ var SkillsPromptProvider = class {
   priority = 20;
   contribute(ctx) {
     if (ctx.skillsAutoInject === false) return Promise.resolve(void 0);
-    return Promise.resolve(chunkQUFSDDNU_cjs.buildSkillsBlock(ctx.skills));
+    return Promise.resolve(chunkE4IUN3JB_cjs.buildSkillsBlock(ctx.skills));
   }
 };
 
@@ -3044,7 +3095,7 @@ var SystemPromptPipeline = class _SystemPromptPipeline {
     for (const p of providers) {
       const key = `${p.priority}:${p.id}`;
       if (seen.has(key)) {
-        throw new chunkMHCKWQR3_cjs.ConfigurationError(`Duplicate system-prompt provider ${key}`, {
+        throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Duplicate system-prompt provider ${key}`, {
           code: "pipeline_duplicate_provider"
         });
       }
@@ -3091,7 +3142,7 @@ function validateAgentOptions(options) {
   ensureRuntimeShape(options);
   if (options.local !== void 0) {
     if (options.model === void 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError("Local agents require a model selection", {
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError("Local agents require a model selection", {
         code: "missing_model"
       });
     }
@@ -3115,7 +3166,7 @@ function validateCredentialPoolShape(options) {
     ([, arr]) => Array.isArray(arr) && arr.some((k) => typeof k === "string" && k.length > 0)
   );
   if (populated.length === 0) return;
-  throw new chunkMHCKWQR3_cjs.ConfigurationError(
+  throw new chunkIHFNRNTJ_cjs.ConfigurationError(
     "Ambiguous credential configuration: use either `apiKey: '...'` (single-key, simplest) OR `apiKeys: { provider: [...] }` (multi-key pool), not both.",
     { code: "credential_pool_ambiguous" }
   );
@@ -3124,7 +3175,7 @@ function validatePlugins(options) {
   const plugins = options.plugins;
   if (plugins?.paths === void 0) return;
   if (options.cloud !== void 0 && plugins.paths.length > 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Cloud agents require committed plugin manifests; local plugin paths are not supported",
       { code: "cloud_plugin_path_rejected" }
     );
@@ -3132,7 +3183,7 @@ function validatePlugins(options) {
 }
 function ensureRuntimeShape(options) {
   if (options.local !== void 0 && options.cloud !== void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Pass either local or cloud \u2014 they are mutually exclusive runtimes",
       { code: "runtime_exclusive" }
     );
@@ -3140,7 +3191,7 @@ function ensureRuntimeShape(options) {
 }
 function rejectProgrammaticHooks(options) {
   if (options.hooks !== void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Programmatic hooks are not supported \u2014 hooks are file-based only (.theokit/hooks.json)",
       { code: "programmatic_hooks_rejected" }
     );
@@ -3150,7 +3201,7 @@ function validateCloud(cloud) {
   if (cloud.envVars !== void 0) {
     for (const key of Object.keys(cloud.envVars)) {
       if (key.startsWith("THEOKIT_")) {
-        throw new chunkMHCKWQR3_cjs.ConfigurationError(
+        throw new chunkIHFNRNTJ_cjs.ConfigurationError(
           `Cloud envVars cannot use the reserved THEOKIT_ prefix (got "${key}")`,
           { code: "reserved_env_prefix" }
         );
@@ -3162,7 +3213,7 @@ function validateMcpServers(options) {
   if (options.mcpServers === void 0) return;
   for (const [name, config] of Object.entries(options.mcpServers)) {
     if (options.cloud !== void 0 && isStdioWithCwd(config)) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `MCP server "${name}" uses stdio with cwd, which is rejected for cloud agents`,
         { code: "cloud_stdio_cwd_rejected" }
       );
@@ -3181,12 +3232,12 @@ function validateSubagents(agents2) {
   if (agents2 === void 0) return;
   for (const [name, definition] of Object.entries(agents2)) {
     if (typeof definition.description !== "string" || definition.description.length === 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty description`, {
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty description`, {
         code: "subagent_missing_description"
       });
     }
     if (typeof definition.prompt !== "string" || definition.prompt.length === 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty prompt`, {
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty prompt`, {
         code: "subagent_missing_prompt"
       });
     }
@@ -3199,7 +3250,7 @@ function validateToolCatalog(tools) {
   for (const tool of tools) {
     validateSingleTool(tool);
     if (seen.has(tool.name)) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(`Duplicate custom tool name "${tool.name}"`, {
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Duplicate custom tool name "${tool.name}"`, {
         code: "duplicate_tool_name"
       });
     }
@@ -3210,7 +3261,7 @@ function validateCustomTools(options) {
   const tools = options.tools;
   if (tools === void 0 || tools.length === 0) return;
   if (options.cloud !== void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Custom inline tools are local-only in SDK v1.0 \u2014 cloud agents cannot serialize handler functions",
       { code: "cloud_custom_tools_rejected" }
     );
@@ -3222,25 +3273,25 @@ function validateSingleTool(tool) {
   validateToolDescription(tool);
   validateToolSchema(tool);
   if (typeof tool.handler !== "function") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a handler function`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a handler function`, {
       code: "tool_missing_handler"
     });
   }
 }
 function validateToolName(tool) {
   if (typeof tool.name !== "string" || tool.name.length === 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError("Custom tool requires a non-empty name", {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError("Custom tool requires a non-empty name", {
       code: "tool_missing_name"
     });
   }
   if (!TOOL_NAME_PATTERN.test(tool.name)) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Custom tool name "${tool.name}" must match /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/`,
       { code: "tool_invalid_name" }
     );
   }
   if (RESERVED_TOOL_NAMES.has(tool.name) || tool.name.startsWith("mcp_")) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Custom tool name "${tool.name}" collides with a reserved SDK tool name`,
       { code: "tool_reserved_name" }
     );
@@ -3248,7 +3299,7 @@ function validateToolName(tool) {
 }
 function validateToolDescription(tool) {
   if (typeof tool.description !== "string" || tool.description.length === 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a non-empty description`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a non-empty description`, {
       code: "tool_missing_description"
     });
   }
@@ -3256,12 +3307,12 @@ function validateToolDescription(tool) {
 function validateToolSchema(tool) {
   const schema = tool.inputSchema;
   if (schema === null || schema === void 0 || typeof schema !== "object") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Custom tool "${tool.name}" requires an inputSchema object`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Custom tool "${tool.name}" requires an inputSchema object`, {
       code: "tool_missing_schema"
     });
   }
   if (schema.type !== "object") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Custom tool "${tool.name}" inputSchema must declare \`type: "object"\``,
       { code: "tool_invalid_schema_type" }
     );
@@ -3272,7 +3323,7 @@ function validateMemory(options) {
   if (memory?.storePath === void 0) return;
   const storePath = memory.storePath;
   if (storePath.includes("..") || storePath.startsWith("/") || /^[A-Z]:/i.test(storePath)) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Memory storePath must stay inside the workspace; got "${storePath}"`,
       { code: "memory_path_traversal" }
     );
@@ -3294,7 +3345,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-W52DKZBR.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-INSFS5GT.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3373,7 +3424,7 @@ var langfuseAdapter = {
       }
     }
     if (lf.LangfuseSpanProcessor === void 0) {
-      chunkLTCOPATU_cjs.diag(
+      chunkBCQ3E2ZG_cjs.diag(
         "[theokit-sdk] @langfuse/node detected but LangfuseSpanProcessor not found (v2?). Use Langfuse v3+ for auto-instrumentation.\n"
       );
       return;
@@ -3502,11 +3553,11 @@ function tryAutoRegisterAdapters(settings) {
     try {
       adapter.register();
       registered.add(adapter.moduleName);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] telemetry: ${adapter.displayName} auto-instrumented.
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] telemetry: ${adapter.displayName} auto-instrumented.
 `);
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(
+      chunkBCQ3E2ZG_cjs.diag(
         `[theokit-sdk] telemetry: ${adapter.displayName} detected but failed to register: ${message}
 `
       );
@@ -3519,7 +3570,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-W52DKZBR.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-INSFS5GT.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -3562,7 +3613,7 @@ function safe(op, fallback) {
     if (!warnedOnce) {
       warnedOnce = true;
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(
+      chunkBCQ3E2ZG_cjs.diag(
         `[theokit-sdk] telemetry exporter error (suppressed; agent.send continues): ${message}
 `
       );
@@ -3576,7 +3627,7 @@ function createTelemetry(settings) {
   if (otel === null) {
     if (!warnedOnce) {
       warnedOnce = true;
-      chunkLTCOPATU_cjs.diag(
+      chunkBCQ3E2ZG_cjs.diag(
         "[theokit-sdk] telemetry.enabled = true but `@opentelemetry/api` is not installed; telemetry is a no-op.\n"
       );
     }
@@ -3670,12 +3721,12 @@ function wrapSpan(span, openSpans) {
 }
 function redactAttrValue(value) {
   if (typeof value !== "string") return value;
-  return chunkLTCOPATU_cjs.redactSecrets(value);
+  return chunkBCQ3E2ZG_cjs.redactSecrets(value);
 }
 function redactAttrs(attrs) {
   const out = {};
   for (const [k, v] of Object.entries(attrs)) {
-    out[k] = typeof v === "string" ? chunkLTCOPATU_cjs.redactSecrets(v) : v;
+    out[k] = typeof v === "string" ? chunkBCQ3E2ZG_cjs.redactSecrets(v) : v;
   }
   return out;
 }
@@ -3757,10 +3808,10 @@ async function loadMarkdownEntities(opts) {
     const raw = await promises.readFile(resolved.source, "utf8").catch(() => null);
     if (raw === null) continue;
     const split = splitFrontmatter(raw, resolved.source, errorCodePrefix);
-    const fields = chunk7DXLNNKH_cjs.parseSimpleYaml(split.frontmatter);
+    const fields = chunkG2Q3ZC6C_cjs.parseSimpleYaml(split.frontmatter);
     const parsed = schema.safeParse(fields);
     if (!parsed.success) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `Invalid frontmatter in ${resolved.source}: ${parsed.error.message}`,
         { code: `${errorCodePrefix}_frontmatter_invalid` }
       );
@@ -3778,13 +3829,13 @@ async function assertFileSizeUnderCap(source, errorCodePrefix) {
   try {
     const info = await promises.stat(source);
     if (info.size > MAX_MD_FILE_BYTES) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `Config file ${source} exceeds 1 MB size limit (${info.size} bytes). Reduce the file or split into multiple entities.`,
         { code: `${errorCodePrefix}_file_too_large` }
       );
     }
   } catch (cause) {
-    if (cause instanceof chunkMHCKWQR3_cjs.ConfigurationError) throw cause;
+    if (cause instanceof chunkIHFNRNTJ_cjs.ConfigurationError) throw cause;
   }
 }
 async function readDirSafe(dir, errorCodePrefix) {
@@ -3793,7 +3844,7 @@ async function readDirSafe(dir, errorCodePrefix) {
   } catch (cause) {
     const code = cause.code;
     if (code === "ENOENT") return null;
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Failed to read ${dir}`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Failed to read ${dir}`, {
       code: `${errorCodePrefix}_dir_read_error`,
       cause
     });
@@ -3810,7 +3861,7 @@ function resolveEntryPath(entry, pattern, dir) {
 function splitFrontmatter(raw, source, errorCodePrefix) {
   const match = /^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/.exec(raw);
   if (match === null) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Missing or malformed frontmatter in ${source} (expected \`---\` delimited block at file head)`,
       { code: `${errorCodePrefix}_missing_frontmatter` }
     );
@@ -4294,7 +4345,7 @@ async function loadContextConfig(cwd) {
   });
   if (mdEntities.length > 0) {
     if (fs.existsSync(jsonPath)) {
-      chunkFAY3QDGC_cjs.warnOnce(
+      chunk6LGQECT7_cjs.warnOnce(
         "context-both-present",
         "[theokit-sdk] both .theokit/context/ and .theokit/context.json detected \u2014 using markdown; remove context.json"
       );
@@ -4304,7 +4355,7 @@ async function loadContextConfig(cwd) {
     };
   }
   if (!fs.existsSync(jsonPath)) return { sources: [] };
-  chunkFAY3QDGC_cjs.warnOnce(
+  chunk6LGQECT7_cjs.warnOnce(
     "context-json-deprecated",
     "[theokit-sdk] .theokit/context.json is deprecated; migrate to .theokit/context/<name>.md via theokit-migrate-config"
   );
@@ -4312,7 +4363,7 @@ async function loadContextConfig(cwd) {
   try {
     raw = await promises.readFile(jsonPath, "utf8");
   } catch (cause) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Failed to read context config: ${jsonPath}`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Failed to read context config: ${jsonPath}`, {
       code: "context_read_error",
       cause
     });
@@ -4324,13 +4375,13 @@ function parseConfig(raw, configPath) {
   try {
     parsed = JSON.parse(raw);
   } catch (cause) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Invalid JSON in context config: ${configPath}`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Invalid JSON in context config: ${configPath}`, {
       code: "context_json_invalid",
       cause
     });
   }
   if (!parsed || typeof parsed !== "object") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Context config must be an object: ${configPath}`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Context config must be an object: ${configPath}`, {
       code: "context_config_shape"
     });
   }
@@ -4345,7 +4396,7 @@ function parseConfig(raw, configPath) {
 }
 function readSources(sourcesRaw, configPath) {
   if (!Array.isArray(sourcesRaw)) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Context config sources must be an array: ${configPath}`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Context config sources must be an array: ${configPath}`, {
       code: "context_sources_shape"
     });
   }
@@ -4443,7 +4494,7 @@ var PluginsManager = class {
   async refresh() {
     this.plugins = [];
     const pluginsRoot = path.join(this.cwd, ".theokit", "plugins");
-    const entries = await chunk7DXLNNKH_cjs.readWorkspaceDir(pluginsRoot, "plugins_read_error", "plugins directory");
+    const entries = await chunkG2Q3ZC6C_cjs.readWorkspaceDir(pluginsRoot, "plugins_read_error", "plugins directory");
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       const folderName = entry.name;
@@ -4451,13 +4502,13 @@ var PluginsManager = class {
       const jsonPath = path.join(pluginsRoot, folderName, "plugin.json");
       const metadata = fs.existsSync(mdPath) ? await loadPluginManifestFromMarkdown(pluginsRoot, folderName) : await loadPluginManifestFromJson(jsonPath, folderName);
       if (fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunkFAY3QDGC_cjs.warnOnce(
+        chunk6LGQECT7_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)) {
-        chunkFAY3QDGC_cjs.warnOnce(
+        chunk6LGQECT7_cjs.warnOnce(
           "plugin-json-deprecated",
           "[theokit-sdk] plugin.json manifests are deprecated; migrate to PLUGIN.md via theokit-migrate-config"
         );
@@ -4475,11 +4526,11 @@ var PluginsManager = class {
     const entry = metadata.entry;
     if (entry === void 0) return;
     const pluginRoot = path.join(this.cwd, ".theokit", "plugins", folderName);
-    const entryPath = chunkYBFDBOUN_cjs.safePathJoin(pluginRoot, entry);
+    const entryPath = chunk7YBJZS5P_cjs.safePathJoin(pluginRoot, entry);
     try {
       await promises.readFile(entryPath, "utf8");
     } catch (cause) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(`Plugin ${metadata.name} entry file is missing: ${entry}`, {
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Plugin ${metadata.name} entry file is missing: ${entry}`, {
         code: "plugin_entry_missing",
         cause
       });
@@ -4488,7 +4539,7 @@ var PluginsManager = class {
   assertCloudRules() {
     if (!this.cloud) return;
     if (this.localPaths !== void 0 && this.localPaths.length > 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         "Cloud agents reject local plugin paths \u2014 plugins must come from committed repo files",
         { code: "cloud_plugin_path_rejected" }
       );
@@ -4500,7 +4551,7 @@ async function loadPluginManifestFromJson(manifestPath, folderName) {
   try {
     raw = await promises.readFile(manifestPath, "utf8");
   } catch (cause) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Plugin ${folderName} is missing plugin.json`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Plugin ${folderName} is missing plugin.json`, {
       code: "plugin_missing_manifest",
       cause
     });
@@ -4509,13 +4560,13 @@ async function loadPluginManifestFromJson(manifestPath, folderName) {
   try {
     parsed = JSON.parse(raw);
   } catch (cause) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Plugin ${folderName} manifest is invalid JSON`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Plugin ${folderName} manifest is invalid JSON`, {
       code: "plugin_manifest_invalid",
       cause
     });
   }
   if (!parsed || typeof parsed !== "object") {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Plugin ${folderName} manifest must be an object`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Plugin ${folderName} manifest must be an object`, {
       code: "plugin_manifest_shape"
     });
   }
@@ -4534,7 +4585,7 @@ async function loadPluginManifestFromMarkdown(pluginsRoot, folderName) {
   try {
     raw = await promises.readFile(mdPath, "utf8");
   } catch (cause) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Plugin ${folderName} is missing PLUGIN.md`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Plugin ${folderName} is missing PLUGIN.md`, {
       code: "plugin_missing_manifest",
       cause
     });
@@ -4549,7 +4600,7 @@ async function loadPluginManifestFromMarkdown(pluginsRoot, folderName) {
   });
   const entity = entities.find((e) => e.slug === "PLUGIN");
   if (entity === void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(`Plugin ${folderName} PLUGIN.md not parseable`, {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(`Plugin ${folderName} PLUGIN.md not parseable`, {
       code: "plugin_missing_manifest"
     });
   }
@@ -4823,7 +4874,7 @@ function assertValidThresholds(soft, hard) {
     ["hardThreshold", hard]
   ]) {
     if (!Number.isInteger(value) || value < 1) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `doomLoop.${label} must be a positive integer (received ${value}).`,
         { code: "invalid_doom_loop_threshold" }
       );
@@ -4942,6 +4993,35 @@ var UsageAccumulator = class {
   }
 };
 
+// src/internal/agent-loop/live-events.ts
+var LiveEventLog = class extends Array {
+  /**
+   * Not readonly, and not a constructor parameter — `Array` subclasses are re-instantiated by
+   * `map`/`filter`/`slice` with a length argument, so a constructor with a different signature
+   * breaks those. The sink is attached after construction instead.
+   */
+  #sink;
+  /** Attach the live subscriber. One sink: the run that owns this loop. */
+  subscribe(sink) {
+    this.#sink = sink;
+  }
+  push(...events) {
+    const length = super.push(...events);
+    for (const event of events) {
+      try {
+        this.#sink?.(event);
+      } catch {
+      }
+    }
+    return length;
+  }
+};
+function createEventLog(seed) {
+  const log = new LiveEventLog();
+  log.push(...seed);
+  return log;
+}
+
 // src/internal/agent-loop/message-builders.ts
 function buildSystemEvent(inputs, toolNames) {
   return {
@@ -4969,7 +5049,7 @@ function buildAssistantEvent(inputs, text) {
     message: { role: "assistant", content: [{ type: "text", text }] }
   };
 }
-function buildThinkingEvent(inputs, text, thinkingDurationMs) {
+function buildThinkingEvent(inputs, text, thinkingDurationMs, signature) {
   const event = {
     type: "thinking",
     agent_id: inputs.agentId,
@@ -4979,10 +5059,12 @@ function buildThinkingEvent(inputs, text, thinkingDurationMs) {
   if (thinkingDurationMs !== void 0 && thinkingDurationMs >= 0) {
     event.thinking_duration_ms = thinkingDurationMs;
   }
+  if (signature !== void 0) event.signature = signature;
   return event;
 }
-function buildAssistantTurn(text, toolCalls) {
+function buildAssistantTurn(text, toolCalls, thinking) {
   const content = [];
+  if (thinking !== void 0) content.push(thinking);
   if (text.length > 0) content.push({ type: "text", text });
   for (const call of toolCalls) content.push(call);
   return { role: "assistant", content };
@@ -5051,13 +5133,14 @@ async function initLoopContext(inputs) {
       });
     }
   }
-  const events = [
+  const events = createEventLog([
     buildSystemEvent(
       inputs,
       tools.map((t) => t.name)
     ),
     buildUserEvent(inputs)
-  ];
+  ]);
+  if (inputs.onLoopEvent !== void 0) events.subscribe(inputs.onLoopEvent);
   const priorMessages = (inputs.priorMessages ?? []).map((msg) => ({
     role: msg.role,
     content: [{ type: "text", text: msg.text }]
@@ -5104,7 +5187,7 @@ async function safeListTools(client, serverName) {
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
     const server = serverName ?? "unknown";
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] mcp listTools failed (server=${server}): ${message}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] mcp listTools failed (server=${server}): ${message}
 `);
     return [];
   }
@@ -5173,7 +5256,7 @@ function emitLlmMetrics(inputs, result, startAt) {
     inputs.telemetry?.recordHistogram(HISTOGRAM_NAMES.LLM_USAGE_MISSING, 1, {
       provider: inputs.llm.name
     });
-    chunkLTCOPATU_cjs.diag(
+    chunkBCQ3E2ZG_cjs.diag(
       `[theokit-sdk] llm usage missing from ${inputs.llm.name} finish \u2014 budget may undercount
 `
     );
@@ -5236,6 +5319,7 @@ async function streamLlmTurn(inputs, ctx) {
   emitLlmMetrics(inputs, result, startAt);
   llmSpan?.end();
   const stripped = stripThinkBlocks(collected.accumulatedText);
+  const thinking = result.thinking ?? collected.thinking;
   return {
     text: stripped.visible,
     toolCalls: result.toolCalls,
@@ -5245,18 +5329,21 @@ async function streamLlmTurn(inputs, ctx) {
     outputTokens: result.outputTokens,
     cacheReadTokens: result.cacheReadTokens,
     cacheWriteTokens: result.cacheWriteTokens,
-    reasoningTokens: result.reasoningTokens
+    reasoningTokens: result.reasoningTokens,
+    ...thinking !== void 0 ? { thinking } : {}
   };
 }
 async function collectLlmEvents(generator, inputs, ctx) {
   let accumulatedText = "";
   let errored = false;
   let finishValue;
+  let thinking;
   try {
     const result = await runCollectorLoop(generator, inputs, ctx);
     accumulatedText = result.accumulatedText;
     errored = result.errored;
     finishValue = result.finishValue;
+    thinking = result.thinking;
   } catch (cause) {
     if (inputs.signal?.aborted === true) {
       ctx.finalText = "[aborted]";
@@ -5267,7 +5354,12 @@ async function collectLlmEvents(generator, inputs, ctx) {
     }
     errored = true;
   }
-  return { accumulatedText, errored, finishValue };
+  return {
+    accumulatedText,
+    errored,
+    finishValue,
+    ...thinking !== void 0 ? { thinking } : {}
+  };
 }
 function registerLoopError(ctx, cause) {
   if (ctx.error !== void 0) return;
@@ -5278,11 +5370,26 @@ function registerLoopError(ctx, cause) {
   const code = typeof metaCode === "string" ? metaCode : typeof rawCode === "string" ? rawCode : void 0;
   ctx.error = code !== void 0 ? { message, code, cause } : { message, cause };
 }
+async function consumeStreamEvent(inputs, reasoning, event) {
+  if (event.type === "text_delta") {
+    const text = event.text ?? "";
+    await emitTextDeltaCallback(inputs, text);
+    return text;
+  }
+  if (event.type === "reasoning_delta") {
+    await consumeReasoningDelta(inputs, reasoning, {
+      text: event.text ?? "",
+      ...event.signature !== void 0 ? { signature: event.signature } : {}
+    });
+  }
+  return "";
+}
 async function runCollectorLoop(generator, inputs, ctx) {
   let accumulatedText = "";
-  const reasoning = { text: "", startedAt: void 0 };
+  const reasoning = { text: "", startedAt: void 0, signature: void 0 };
   let errored = false;
   let finishValue;
+  let thinking;
   try {
     while (true) {
       const next = await generator.next();
@@ -5290,24 +5397,22 @@ async function runCollectorLoop(generator, inputs, ctx) {
         finishValue = next;
         break;
       }
-      if (next.value.type === "text_delta") {
-        accumulatedText += next.value.text;
-        await emitTextDeltaCallback(inputs, next.value.text);
-      }
-      if (next.value.type === "reasoning_delta") {
-        await accumulateReasoning(inputs, reasoning, next.value.text);
-      }
       if (next.value.type === "error") {
         registerLoopError(ctx, next.value);
         ctx.finalText = "";
         errored = true;
         break;
       }
+      accumulatedText += await consumeStreamEvent(inputs, reasoning, next.value);
     }
   } finally {
-    await finalizeReasoning(inputs, ctx, reasoning);
+    thinking = await finalizeReasoning(inputs, ctx, reasoning);
   }
-  return { accumulatedText, errored, finishValue };
+  return { accumulatedText, errored, finishValue, ...thinking !== void 0 ? { thinking } : {} };
+}
+async function consumeReasoningDelta(inputs, reasoning, delta) {
+  if (delta.signature !== void 0) reasoning.signature = delta.signature;
+  await accumulateReasoning(inputs, reasoning, delta.text);
 }
 async function accumulateReasoning(inputs, reasoning, text) {
   if (reasoning.startedAt === void 0) reasoning.startedAt = Date.now();
@@ -5315,10 +5420,17 @@ async function accumulateReasoning(inputs, reasoning, text) {
   await emitReasoningDeltaCallback(inputs, text);
 }
 async function finalizeReasoning(inputs, ctx, reasoning) {
-  if (reasoning.text.length === 0) return;
+  if (reasoning.text.length === 0) return void 0;
   const thinkingDurationMs = reasoning.startedAt === void 0 ? 0 : Date.now() - reasoning.startedAt;
-  ctx.events.push(buildThinkingEvent(inputs, reasoning.text, thinkingDurationMs));
+  ctx.events.push(
+    buildThinkingEvent(inputs, reasoning.text, thinkingDurationMs, reasoning.signature)
+  );
   await emitThinkingCompletedCallback(inputs, thinkingDurationMs);
+  return {
+    type: "thinking",
+    text: reasoning.text,
+    ...reasoning.signature !== void 0 ? { signature: reasoning.signature } : {}
+  };
 }
 async function emitTextDeltaCallback(inputs, text) {
   if (inputs.onDelta === void 0) return;
@@ -5348,6 +5460,24 @@ async function emitThinkingCompletedCallback(inputs, thinkingDurationMs) {
   );
 }
 
+// src/internal/agent-loop/loop-thinking-steps.ts
+function thinkingStep(thinking) {
+  return {
+    type: "thinkingMessage",
+    message: {
+      text: thinking.text,
+      ...thinking.signature !== void 0 ? { signature: thinking.signature } : {}
+    }
+  };
+}
+function recordThinkingOnSilentToolRound(ctx, text, thinking) {
+  if (text.length > 0 || thinking === void 0) return;
+  ctx.conversation.push({
+    type: "agentConversationTurn",
+    turn: { steps: [thinkingStep(thinking)] }
+  });
+}
+
 // src/internal/tool-dispatch/repair-middleware.ts
 var DECIMAL_RE = /^-?\d+(\.\d+)?$/;
 function repairToolCall(raw, registry) {
@@ -5422,7 +5552,7 @@ function coerceArgsToSchema(args, schema) {
 }
 
 // src/tool-error.ts
-var ToolError = class extends chunkMHCKWQR3_cjs.TheokitAgentError {
+var ToolError = class extends chunkIHFNRNTJ_cjs.TheokitAgentError {
   name = "ToolError";
   /** The error content surfaced to the model: a string, or text/image blocks. */
   content;
@@ -5616,7 +5746,7 @@ 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 chunkSWIBQFPH_cjs.mapWithConcurrency(
+  return chunk7OLG7VI4_cjs.mapWithConcurrency(
     toolCalls,
     maxConcurrent,
     (call) => dispatchSingleCall(inputs, tools, call, events, parentSpan)
@@ -5644,7 +5774,7 @@ async function dispatchSingleCall(inputs, tools, call, events, parentSpan) {
     toolSpan?.end();
     return fileVeto;
   }
-  chunk6EDQBX7U_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkN475ETD6_cjs.emitRunEvent(inputs.runEventSink, {
     type: "tool_progress",
     toolName: workingCall.name,
     toolCallId: callId
@@ -5675,7 +5805,7 @@ function applyRepairAndExtractCall(tools, call) {
 function vetoFromForkWhitelist(inputs, call, callId, events) {
   const whitelistDecision = chunkVJ26EKGJ_cjs.checkToolWhitelist(call.name);
   if (whitelistDecision.allowed) return void 0;
-  chunk6EDQBX7U_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkN475ETD6_cjs.emitRunEvent(inputs.runEventSink, {
     type: "permission_denied",
     toolName: call.name,
     toolCallId: callId,
@@ -5720,7 +5850,7 @@ async function vetoFromPluginPreHook(inputs, call, callId, events) {
     ...inputs.permissionMode !== void 0 ? { permissionMode: inputs.permissionMode } : {}
   });
   if (pluginVeto === void 0) return void 0;
-  chunk6EDQBX7U_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkN475ETD6_cjs.emitRunEvent(inputs.runEventSink, {
     type: "permission_denied",
     toolName: call.name,
     toolCallId: callId,
@@ -5749,7 +5879,7 @@ async function vetoFromFileHookPreDecision(inputs, call, callId, events) {
     runId: inputs.runId
   });
   if (!preDecision.blocked) return void 0;
-  chunk6EDQBX7U_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkN475ETD6_cjs.emitRunEvent(inputs.runEventSink, {
     type: "permission_denied",
     toolName: call.name,
     toolCallId: callId,
@@ -5850,7 +5980,7 @@ function finalizeSpanAndPostHook(inputs, call, callId, result, events, toolSpan)
     agentId: inputs.agentId,
     runId: inputs.runId
   }).catch((err) => {
-    chunkLTCOPATU_cjs.diag(
+    chunkBCQ3E2ZG_cjs.diag(
       `[theokit-sdk] postToolUse hook error (swallowed): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -5869,7 +5999,7 @@ async function emitToolLifecycleDelta(inputs, update) {
   try {
     await inputs.onDelta({ update });
   } catch (err) {
-    chunkLTCOPATU_cjs.diag(
+    chunkBCQ3E2ZG_cjs.diag(
       `[theokit-sdk] onDelta tool-lifecycle emit error (swallowed): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -5881,7 +6011,7 @@ async function safeEmitToolHook(callback, event) {
     await callback(event);
   } catch (cause) {
     const msg = cause instanceof Error ? cause.message : String(cause);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] tool lifecycle hook threw: ${msg}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] tool lifecycle hook threw: ${msg}
 `);
   }
 }
@@ -5948,7 +6078,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: chunkALU3KC4G_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
+      p.type === "tool_result" ? { ...p, content: chunkBPN5ONSW_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
     )
   );
 }
@@ -6143,7 +6273,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 = chunk56ZM6P7Z_cjs.getCatalogModelInfo(key);
+    const info = chunkG4XUXSRN_cjs.getCatalogModelInfo(key);
     const cost = info?.cost;
     if (cost === void 0) continue;
     const [prov, ...modelParts] = key.split("/");
@@ -6155,7 +6285,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: chunk56ZM6P7Z_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
+      pricingVersion: chunkG4XUXSRN_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
     };
   }
   return void 0;
@@ -6399,12 +6529,13 @@ async function runAgentLoop(inputs) {
     sendSpan?.end();
   }
 }
-async function emitAssistantTextStep(inputs, ctx, text) {
+async function emitAssistantTextStep(inputs, ctx, text, thinking) {
   ctx.events.push(buildAssistantEvent(inputs, text));
-  ctx.conversation.push({
-    type: "agentConversationTurn",
-    turn: { steps: [{ type: "assistantMessage", message: { text } }] }
-  });
+  const steps = [
+    ...thinking !== void 0 ? [thinkingStep(thinking)] : [],
+    { type: "assistantMessage", message: { text } }
+  ];
+  ctx.conversation.push({ type: "agentConversationTurn", turn: { steps } });
   ctx.finalText = text;
   if (inputs.onStep === void 0) return;
   const cb = inputs.onStep;
@@ -6540,13 +6671,15 @@ async function continueOrTerminate(inputs, ctx, llmOutput) {
   if (llmOutput.errored) return "error";
   const tCtx = { agentId: inputs.agentId, runId: inputs.runId };
   const text = llmOutput.text.length > 0 ? await transformLlmOutputText(inputs, llmOutput.text, tCtx) : llmOutput.text;
+  const thinking = llmOutput.thinking;
   if (text.length > 0) {
-    await emitAssistantTextStep(inputs, ctx, text);
+    await emitAssistantTextStep(inputs, ctx, text, thinking);
   }
   if (llmOutput.stopReason !== "tool_use" || llmOutput.toolCalls.length === 0) {
     return finishOrReflect(inputs, ctx, llmOutput);
   }
-  ctx.messages.push(buildAssistantTurn(text, llmOutput.toolCalls));
+  recordThinkingOnSilentToolRound(ctx, text, thinking);
+  ctx.messages.push(buildAssistantTurn(text, llmOutput.toolCalls, thinking));
   const rawResults = await dispatchTools(
     // SE12 — forward a read-only text projection of the transcript-so-far to tool
     // handlers via `ctx.messages` (consumed by defineSubAgent's messageFilter).
@@ -6582,7 +6715,9 @@ async function inspectDoomLoop(inputs, ctx, toolCalls) {
     await emitAssistantTextStep(
       inputs,
       ctx,
-      verdict.message ?? "Stopped: repeated identical tool calls made no progress."
+      verdict.message ?? "Stopped: repeated identical tool calls made no progress.",
+      // The doom-loop stop message is the SDK's own text, not a model turn — it has no thinking.
+      void 0
     );
     return "stop";
   }
@@ -6603,15 +6738,15 @@ var FallbackLlmClient = class {
     let lastError;
     for (const client of this.clients) {
       if (signal.aborted) throw abortError(signal);
-      const attempt = await chunkALU3KC4G_cjs.tryFirstEvent(client, request, signal, true);
+      const attempt = await chunkBPN5ONSW_cjs.tryFirstEvent(client, request, signal, true);
       if (attempt.kind === "handshake_error") {
         lastError = attempt.error;
         continue;
       }
-      return yield* chunkALU3KC4G_cjs.relayStream(attempt.generator, attempt.firstResult);
+      return yield* chunkBPN5ONSW_cjs.relayStream(attempt.generator, attempt.firstResult);
     }
     if (lastError !== void 0) throw lastError;
-    throw new chunkMHCKWQR3_cjs.NetworkError("FallbackLlmClient has no providers configured", {
+    throw new chunkIHFNRNTJ_cjs.NetworkError("FallbackLlmClient has no providers configured", {
       code: "fallback_empty_chain"
     });
   }
@@ -6634,7 +6769,7 @@ function reconnectDelay(attempt) {
   return ms <= 0 ? Promise.resolve() : new Promise((resolve) => setTimeout(resolve, ms));
 }
 function mcpTimeoutError(name, timeoutMs) {
-  return new chunkMHCKWQR3_cjs.NetworkError(`MCP ${name} request timed out after ${timeoutMs}ms`, {
+  return new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${name} request timed out after ${timeoutMs}ms`, {
     code: "mcp_timeout"
   });
 }
@@ -6717,7 +6852,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     child.stdin.on("error", () => void 0);
     child.on("error", () => {
       this.rejectAllPending(
-        new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} process crashed`, { code: "mcp_crashed" })
+        new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} process crashed`, { code: "mcp_crashed" })
       );
     });
     child.on("exit", () => {
@@ -6725,11 +6860,24 @@ var StdioMcpClient = class extends BaseMcpClient {
       this.child = void 0;
       this.dropped = true;
       this.rejectAllPending(
-        new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
+        new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
       );
     });
   }
+  /**
+   * theokit#155 — idempotent while the child is LIVE.
+   *
+   * Under `mcpLifecycle: 'session'` the pool hands the same client back on the next turn, and
+   * `initializeMcp` runs every turn. An unconditional `spawnChild()` would overwrite `this.child`,
+   * orphaning a healthy process (its `exit` handler is skipped by the `this.child === child` guard)
+   * and paying the ~146 ms spawn + handshake the option exists to avoid.
+   *
+   * This does NOT touch the #59 reconnect path: `reconnect()` calls `spawnChild()` and
+   * `super.initialize()` directly, so it re-spawns exactly as before. After `close()` — or after a
+   * drop, which clears `child` — this method spawns again, as it must.
+   */
   async initialize() {
+    if (this.child !== void 0) return;
     this.spawnChild();
     await super.initialize();
   }
@@ -6740,7 +6888,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     if (this.child !== void 0) return Promise.resolve();
     if (!this.dropped) {
       return Promise.reject(
-        new chunkMHCKWQR3_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
+        new chunkIHFNRNTJ_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
       );
     }
     this.reconnectPromise ??= this.reconnect().finally(() => {
@@ -6761,13 +6909,13 @@ var StdioMcpClient = class extends BaseMcpClient {
         lastErr = err;
       }
     }
-    throw new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} reconnect exhausted`, {
+    throw new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} reconnect exhausted`, {
       code: "mcp_disconnected",
       ...lastErr instanceof Error ? { cause: lastErr } : {}
     });
   }
   async close() {
-    this.rejectAllPending(new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} closed`, { code: "mcp_closed" }));
+    this.rejectAllPending(new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} closed`, { code: "mcp_closed" }));
     const child = this.child;
     this.child = void 0;
     this.dropped = false;
@@ -6786,7 +6934,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     if (this.buffer.length > MAX_STDIO_BUFFER_BYTES) {
       this.buffer = "";
       this.rejectAllPending(
-        new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} exceeded stdout buffer limit`, {
+        new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} exceeded stdout buffer limit`, {
           code: "mcp_buffer_overflow"
         })
       );
@@ -6821,7 +6969,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     if (child !== void 0) return this.send(child, method, params);
     if (this.dropped) return this.reconnectAndRequest(method, params);
     return Promise.reject(
-      new chunkMHCKWQR3_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
+      new chunkIHFNRNTJ_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
     );
   }
   /** M2 #59 — reconnect a dropped client, then send. Separate async path so the
@@ -6830,7 +6978,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     await this.ensureConnected();
     const child = this.child;
     if (child === void 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" });
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" });
     }
     return this.send(child, method, params);
   }
@@ -6847,7 +6995,7 @@ var StdioMcpClient = class extends BaseMcpClient {
         this.child = void 0;
         this.dropped = true;
         this.rejectAllPending(
-          new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
+          new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
         );
       }, this.timeoutMs);
       this.pending.set(id, { resolve, reject, timer });
@@ -6918,14 +7066,14 @@ var HttpMcpClient = class extends BaseMcpClient {
   async readBody(response) {
     const tipo = response.headers.get("content-type") ?? "";
     if (!tipo.includes("text/event-stream")) return await response.json();
-    const texto = await response.text();
-    for (const linha of texto.split(/\r?\n/)) {
-      if (!linha.startsWith("data:")) continue;
-      const carga = linha.slice(5).trim();
-      if (carga === "") continue;
-      return JSON.parse(carga);
-    }
-    throw new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} returned an event stream with no data payload`, {
+    const text = await response.text();
+    for (const line of text.split(/\r?\n/)) {
+      if (!line.startsWith("data:")) continue;
+      const payload = line.slice(5).trim();
+      if (payload === "") continue;
+      return JSON.parse(payload);
+    }
+    throw new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} returned an event stream with no data payload`, {
       code: "mcp_http_error"
     });
   }
@@ -6953,7 +7101,7 @@ var HttpMcpClient = class extends BaseMcpClient {
       throw cause;
     }
     if (!response.ok) {
-      throw new chunkMHCKWQR3_cjs.NetworkError(`MCP ${this.name} returned ${response.status}`, {
+      throw new chunkIHFNRNTJ_cjs.NetworkError(`MCP ${this.name} returned ${response.status}`, {
         code: "mcp_http_error"
       });
     }
@@ -6969,14 +7117,14 @@ var HttpMcpClient = class extends BaseMcpClient {
 function resolveMcpCwd(configCwd) {
   if (configCwd === void 0) return process.cwd();
   if (path.isAbsolute(configCwd)) return configCwd;
-  return chunkYBFDBOUN_cjs.safePathJoin(process.cwd(), configCwd);
+  return chunk7YBJZS5P_cjs.safePathJoin(process.cwd(), configCwd);
 }
 
 // src/internal/providers/register-plugin-providers.ts
 function registerPluginProviderProfiles(entries) {
   let registered2 = 0;
   for (const entry of entries) {
-    chunk56ZM6P7Z_cjs.registerProvider(entry.profile);
+    chunkG4XUXSRN_cjs.registerProvider(entry.profile);
     registered2 += 1;
   }
   return registered2;
@@ -7056,7 +7204,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)`;
-    chunkFAY3QDGC_cjs.warnOnce(
+    chunk6LGQECT7_cjs.warnOnce(
       `personality-tool-missing|${opts?.agentId ?? "?"}|${opts?.personalityName ?? "?"}|${name}`,
       message
     );
@@ -7098,18 +7246,17 @@ function levenshtein(a, b) {
 // src/internal/local-agent/real-local-run-tools.ts
 function declarativeSubagentTools(agents2, parentTools) {
   if (agents2 === void 0 || Object.keys(agents2).length === 0) return [];
-  return chunkG2F67XUR_cjs.subAgentToolsFromDefinitions(agents2, parentTools);
+  return chunkB4YA6BRS_cjs.subAgentToolsFromDefinitions(agents2, parentTools);
 }
-function bindParentCredentials(tools, agentOptions) {
+function resolveInheritedCredentials(agentOptions) {
   const parentPlugins = Array.isArray(agentOptions.plugins) ? agentOptions.plugins : void 0;
   const parentSandbox = agentOptions.local?.sandboxOptions?.enabled;
-  const credentials = {
+  return {
     ...agentOptions.apiKey !== void 0 ? { apiKey: agentOptions.apiKey } : {},
     ...typeof agentOptions.model === "object" ? { model: agentOptions.model } : {},
     ...parentPlugins !== void 0 ? { plugins: parentPlugins } : {},
     ...parentSandbox !== void 0 ? { sandbox: parentSandbox } : {}
   };
-  for (const tool of tools) chunkG2F67XUR_cjs.inheritSubAgentCredentials(tool, credentials);
 }
 function buildCustomToolsInput(agentOptions, sendOptions, pluginManager, personalityToolWhitelist, agentId, personalityName, subagents, effectiveModel) {
   const baseTools = sendOptions?.tools ?? agentOptions.tools ?? [];
@@ -7121,7 +7268,6 @@ function buildCustomToolsInput(agentOptions, sendOptions, pluginManager, persona
     return {};
   }
   const allTools = [...baseTools, ...subagentTools, ...pluginTools, ...reasoningTools];
-  bindParentCredentials(allTools, agentOptions);
   const merged = allTools.map((tool) => ({
     name: tool.name,
     description: tool.description,
@@ -7157,7 +7303,9 @@ function createRealLocalRun(options) {
       supportedOps: supported,
       startTime
     },
-    () => buildLoopInputs(options, id, userText, userImages)
+    () => buildLoopInputs(options, id, userText, userImages),
+    runOwnsMcpClients(options.agentOptions),
+    resolveInheritedCredentials(options.agentOptions)
   );
   handle.bootstrap();
   registerRun(handle);
@@ -7165,25 +7313,25 @@ function createRealLocalRun(options) {
 }
 var pluginProvidersAnnounced = false;
 function resolveRunProvider(options) {
-  chunk56ZM6P7Z_cjs.registerBuiltins();
+  chunkG4XUXSRN_cjs.registerBuiltins();
   const profiles = options.pluginManager?.aggregated.providerProfiles ?? [];
   const registered2 = registerPluginProviderProfiles(profiles);
   if (registered2 > 0 && !pluginProvidersAnnounced) {
     pluginProvidersAnnounced = true;
     const names = profiles.map((e) => e.profile.name).join(", ");
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] registered ${registered2} plugin provider profile(s): ${names}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] registered ${registered2} plugin provider profile(s): ${names}
 `);
   }
   const parsedModel = chunkVYHJZVL5_cjs.parseModelId(options.model?.id);
-  const modelInferredProvider = parsedModel.provider !== void 0 && chunk56ZM6P7Z_cjs.getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
-  const keyInferredProvider = chunkALU3KC4G_cjs.inferProviderFromApiKey(options.agentOptions.apiKey);
-  const primary = options.agentOptions.providers?.routes?.[0]?.provider ?? keyInferredProvider ?? modelInferredProvider ?? chunkALU3KC4G_cjs.detectPrimaryProvider();
+  const modelInferredProvider = parsedModel.provider !== void 0 && chunkG4XUXSRN_cjs.getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
+  const keyInferredProvider = chunkBPN5ONSW_cjs.inferProviderFromApiKey(options.agentOptions.apiKey);
+  const primary = options.agentOptions.providers?.routes?.[0]?.provider ?? keyInferredProvider ?? modelInferredProvider ?? chunkBPN5ONSW_cjs.detectPrimaryProvider();
   const effectiveModelId = modelInferredProvider !== void 0 && modelInferredProvider === primary ? parsedModel.name : options.model?.id ?? "claude-sonnet-4-6";
   return { primary, effectiveModelId };
 }
 function mergeExplicitApiKey(pools, primary, apiKey) {
   if (apiKey === void 0 || apiKey.length === 0) return pools;
-  if (chunkALU3KC4G_cjs.isFixtureApiKey(apiKey) || apiKey === LOCAL_RUNTIME_MOCK_KEY) return pools;
+  if (chunkBPN5ONSW_cjs.isFixtureApiKey(apiKey) || apiKey === LOCAL_RUNTIME_MOCK_KEY) return pools;
   const existing = pools?.[primary];
   if (existing !== void 0 && existing.length > 0) return pools;
   return { ...pools ?? {}, [primary]: [apiKey] };
@@ -7191,7 +7339,7 @@ function mergeExplicitApiKey(pools, primary, apiKey) {
 function buildLoopInputs(options, runId, userText, userImages) {
   const maxIterations = options.sendOptions.maxIterations;
   if (maxIterations !== void 0 && (!Number.isInteger(maxIterations) || maxIterations < 1)) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `SendOptions.maxIterations must be a positive integer, got ${maxIterations}`,
       { code: "invalid_max_iterations" }
     );
@@ -7206,14 +7354,14 @@ function buildLoopInputs(options, runId, userText, userImages) {
   const credentialPoolStrategy = options.agentOptions.providers?.credentialPoolStrategy;
   const extractToolCallsFromContent = options.agentOptions.providers?.routes?.[0]?.extractToolCallsFromContent;
   const rateLimitSink = options.sendOptions.onRunEvent;
-  const chain = chunkALU3KC4G_cjs.resolveProviderChain({
+  const chain = chunkBPN5ONSW_cjs.resolveProviderChain({
     primary,
     ...fallback !== void 0 ? { fallback } : {},
     ...apiKeys !== void 0 ? { apiKeys } : {},
     ...credentialPoolStrategy !== void 0 ? { credentialPoolStrategy } : {},
     ...extractToolCallsFromContent === true ? { extractToolCallsFromContent: true } : {},
     ...rateLimitSink !== void 0 ? {
-      onRateLimit: (info) => chunk6EDQBX7U_cjs.emitRunEvent(rateLimitSink, { type: "rate_limit", ...info })
+      onRateLimit: (info) => chunkN475ETD6_cjs.emitRunEvent(rateLimitSink, { type: "rate_limit", ...info })
     } : {}
   });
   const llm = chain.length === 1 ? chain[0] : new FallbackLlmClient(chain);
@@ -7296,11 +7444,14 @@ function disposeSessionMcpClients(agentId) {
     void client.close();
   });
 }
+function runOwnsMcpClients(agentOptions) {
+  return agentOptions.mcpLifecycle !== "session";
+}
 function buildMcpMap(options) {
   const map = /* @__PURE__ */ new Map();
   const inline = options.sendOptions.mcpServers ?? options.agentOptions.mcpServers;
   if (inline === void 0) return map;
-  const pooled = options.agentOptions.mcpLifecycle === "session";
+  const pooled = !runOwnsMcpClients(options.agentOptions);
   if (pooled) sessionMcpPool.reapIdle((c) => void c.close());
   for (const [name, config] of Object.entries(inline)) {
     map.set(
@@ -7312,9 +7463,15 @@ function buildMcpMap(options) {
 }
 var RealLocalRun = class extends FixtureRunBase {
   buildInputs;
-  constructor(options, buildInputs) {
+  /** theokit#155 — whether this turn releases its MCP clients, or the session pool does. */
+  ownsMcpClients;
+  /** theokit#148 — what a delegated child inherits from this parent, scoped to the loop. */
+  inheritedCredentials;
+  constructor(options, buildInputs, ownsMcpClients, inheritedCredentials) {
     super(options);
     this.buildInputs = buildInputs;
+    this.ownsMcpClients = ownsMcpClients;
+    this.inheritedCredentials = inheritedCredentials;
   }
   bootstrap() {
     setTimeout(() => {
@@ -7354,17 +7511,39 @@ var RealLocalRun = class extends FixtureRunBase {
       }
     }
   }
+  /**
+   * theokit#140 - events already handed to stream() by the live subscriber.
+   *
+   * The loop still RETURNS its full event list, and that batch path is deliberately kept: it is the
+   * fallback if a live event is ever lost, and removing it would make the live channel a single
+   * point of failure for the whole transcript.
+   */
+  liveDelivered = /* @__PURE__ */ new Set();
   async executeAgentLoop(inputs) {
+    inputs.onLoopEvent = (event) => {
+      this.liveDelivered.add(event);
+      this.script.events.push(event);
+      this.pushTimeline({ kind: "message", message: event });
+      this.notifyNewEvents();
+    };
+    const callerOnDelta = inputs.onDelta;
+    inputs.onDelta = (delta) => {
+      callerOnDelta?.(delta);
+      this.pushTimeline({ kind: "delta", update: delta.update });
+    };
     try {
-      const output = inputs.activeTools !== void 0 ? await chunkVJ26EKGJ_cjs.withToolWhitelist(new Set(inputs.activeTools), () => runAgentLoop(inputs)) : await runAgentLoop(inputs);
+      const runLoop = () => inputs.activeTools !== void 0 ? chunkVJ26EKGJ_cjs.withToolWhitelist(new Set(inputs.activeTools), () => runAgentLoop(inputs)) : runAgentLoop(inputs);
+      const output = await chunkB4YA6BRS_cjs.withInheritedSubAgentCredentials(this.inheritedCredentials, runLoop);
       this.applyAgentLoopOutput(output);
       this.transitionTo(output.finalStatus);
     } catch (cause) {
       this.emitErrorEvent(cause, "Agent loop failed", "", "agent_loop_failed");
       this.transitionTo("error");
     } finally {
-      for (const client of inputs.mcp.values()) {
-        await client.close().catch(() => void 0);
+      if (this.ownsMcpClients) {
+        for (const client of inputs.mcp.values()) {
+          await client.close().catch(() => void 0);
+        }
       }
     }
   }
@@ -7377,10 +7556,7 @@ var RealLocalRun = class extends FixtureRunBase {
    * Finding-B fix (sdk-error-packaging v1.1): set-once errorDetail copy.
    */
   applyAgentLoopOutput(output) {
-    for (const event of output.events) {
-      this.script.events.push(event);
-      this.notifyNewEvents();
-    }
+    this.deliverUndeliveredEvents(output.events);
     this.script.conversation.push(...output.conversation);
     if (output.result.length > 0) this.script.result = output.result;
     if (output.usage !== void 0) this.script.usage = output.usage;
@@ -7395,6 +7571,25 @@ var RealLocalRun = class extends FixtureRunBase {
       };
     }
   }
+  /**
+   * theokit#140 - deliver only what the live subscriber has NOT already handed to `stream()`.
+   *
+   * The loop now reports each event as it happens, so this batch is the SAME list, replayed.
+   * Without the guard every event would reach `stream()` twice: once live, once here.
+   *
+   * Identity, not deep equality: these are the very objects the live sink saw, and two genuinely
+   * distinct events can be structurally identical (the same tool called twice with the same args
+   * is not a duplicate).
+   *
+   * Extracted because the guard pushed `applyAgentLoopOutput` past the cognitive-complexity cap.
+   */
+  deliverUndeliveredEvents(events) {
+    for (const event of events) {
+      if (this.liveDelivered.has(event)) continue;
+      this.script.events.push(event);
+      this.notifyNewEvents();
+    }
+  }
   emitErrorEvent(cause, fallback, prefix = "", code) {
     if (this.script.errorDetail === void 0) {
       const message = cause instanceof Error ? cause.message : String(cause);
@@ -7431,7 +7626,7 @@ function buildRealRunOptions(args) {
   };
 }
 async function createFixtureRunHelper(args) {
-  const sessionMessages = chunkH5YVJB4K_cjs.getSessionMessages(args.inputs.agentId);
+  const sessionMessages = chunkDCXRHCZJ_cjs.getSessionMessages(args.inputs.agentId);
   const projectMcpServers = args.inputs.settingSourcesIncludeProject ? await readProjectMcpServers(args.inputs.workspaceCwd) : {};
   return createLocalRun({
     agentId: args.inputs.agentId,
@@ -7450,7 +7645,7 @@ async function createFixtureRunHelper(args) {
 }
 async function dispatchLocalRun(args) {
   const apiKey = resolveApiKey(args.inputs.options.apiKey);
-  if (chunkALU3KC4G_cjs.shouldUseRealLocalRuntime(apiKey)) {
+  if (chunkBPN5ONSW_cjs.shouldUseRealLocalRuntime(apiKey)) {
     return createRealLocalRun(
       buildRealRunOptions({
         inputs: args.inputs,
@@ -7485,20 +7680,20 @@ async function readProjectMcpServers(cwd) {
 
 // src/internal/local-agent/local-agent-invalidate.ts
 async function applyDeferredInvalidation(agentId, pending, refresh) {
-  chunkLTCOPATU_cjs.diag(`[theokit-sdk] applying deferred cache invalidation (${agentId}): ${pending.reason}
+  chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] applying deferred cache invalidation (${agentId}): ${pending.reason}
 `);
   try {
     await refresh();
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] invalidateCache reload failed (continuing): ${msg}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] invalidateCache reload failed (continuing): ${msg}
 `);
   }
 }
 async function invalidateCacheImpl(agentId, reason, options, disposed, dispose, setPending) {
   if (disposed) return;
   if (options.applyNow === true) {
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] invalidateCache applyNow disposing agent (${agentId}): ${reason}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] invalidateCache applyNow disposing agent (${agentId}): ${reason}
 `);
     await dispose();
     return;
@@ -7559,7 +7754,7 @@ var LiveAgentRegistry = class {
     const existing = this.#agents.get(id);
     if (existing !== void 0 && existing.agent !== agent) {
       void existing.agent.dispose().catch(() => {
-        chunkLTCOPATU_cjs.diag(`[theokit-sdk] dispose during overwrite failed (${id})
+        chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] dispose during overwrite failed (${id})
 `);
       });
     }
@@ -7663,7 +7858,7 @@ var LiveAgentRegistry = class {
       await agent.dispose();
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
 `);
     }
     if (this.#onEvict !== void 0) {
@@ -7671,7 +7866,7 @@ var LiveAgentRegistry = class {
         this.#onEvict(id, reason);
       } catch (cause) {
         const msg = cause instanceof Error ? cause.message : String(cause);
-        chunkLTCOPATU_cjs.diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
+        chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
 `);
       }
     }
@@ -7680,20 +7875,20 @@ var LiveAgentRegistry = class {
 var liveAgentRegistry = new LiveAgentRegistry();
 
 // src/internal/local-agent/local-agent-lifecycle.ts
-async function adquirirLeaseSePossivel(store, agentId) {
+async function acquireLeaseIfPossible(store, agentId) {
   const a = store.acquire;
   if (typeof a !== "function") return;
   try {
     await a.call(store, agentId);
   } catch (err) {
     if (err instanceof Error && err.name === "SessionBusyError") throw err;
-    chunkLTCOPATU_cjs.diag(
+    chunkBCQ3E2ZG_cjs.diag(
       `[theokit-sdk] writer lease unavailable for ${agentId} (${err instanceof Error ? err.message : String(err)}) \u2014 proceeding without single-writer protection
 `
     );
   }
 }
-async function soltarLeaseSePossivel(store, agentId) {
+async function releaseLeaseIfPossible(store, agentId) {
   const r = store.release;
   if (typeof r === "function") await r.call(store, agentId);
 }
@@ -7706,16 +7901,16 @@ async function disposeLocalAgentSession(agent) {
   agent.lifecycleAbortController.abort();
   await chunkYLQQX5W2_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
   disposeSessionMcpClients(agent.agentId);
-  await chunkH5YVJB4K_cjs.flushSessionWrites();
+  await chunkDCXRHCZJ_cjs.flushSessionWrites();
   await flushRegistrySaves(agent.workspaceCwd);
   await disposeSessionStore(agent.sessionStore);
-  chunkH5YVJB4K_cjs.descartarSessao(agent.workspaceCwd, agent.agentId);
+  chunkDCXRHCZJ_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 chunkGM7QDQ24_cjs.loadSubagents(
+  return await chunkW4WKVOOQ_cjs.loadSubagents(
     agent.workspaceCwd,
     agent.settingSourcesIncludeProject,
     agent.options.agents
@@ -7723,12 +7918,12 @@ async function reloadLocalAgent(agent) {
 }
 async function persistActiveMemoryTranscript(cwd, transcript) {
   try {
-    const dir = path.join(chunk2423XDPT_cjs.memoryDir(cwd), "transcripts", "active-memory");
+    const dir = path.join(chunkCN6UX5EV_cjs.memoryDir(cwd), "transcripts", "active-memory");
     const file = path.join(dir, `${transcript.runId}.json`);
-    await chunkICYBIC6N_cjs.atomicWriteJson(file, transcript);
+    await chunkDGLLVCNB_cjs.atomicWriteJson(file, transcript);
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] active-memory transcript persist failed: ${message}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] active-memory transcript persist failed: ${message}
 `);
   }
 }
@@ -7849,7 +8044,7 @@ async function searchOnce(args, cfg, query, started) {
     return { summary, durationMs: Date.now() - started, status: "ok", hits };
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunkLTCOPATU_cjs.diag(`[theokit-sdk] active-memory recall failed: ${message}
+    chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] active-memory recall failed: ${message}
 `);
     return { summary: void 0, durationMs: Date.now() - started, status: "error", hits: [] };
   }
@@ -7955,184 +8150,6 @@ function cacheKey(userText, queryMode, ctx) {
   const parts = [queryMode, ctx?.namespace ?? "", ctx?.userId ?? "", ctx?.scope ?? "", userText];
   return crypto.createHash("sha256").update(parts.join("\0")).digest("hex");
 }
-var MAX_BATCH = 100;
-var MAX_RETRIES = 2;
-async function createOpenAiCompatibleRuntime(cfg, options) {
-  const model = options.model ?? cfg.defaultModel;
-  const apiKey = options.apiKey ?? process.env[cfg.apiKeyEnv];
-  if (apiKey === void 0 || apiKey.length === 0) {
-    throw new chunkMHCKWQR3_cjs.AuthenticationError(`${cfg.apiKeyEnv} missing`, {
-      code: "embedding_missing_api_key"
-    });
-  }
-  const envBaseUrl = cfg.baseUrlEnv !== void 0 ? process.env[cfg.baseUrlEnv] : void 0;
-  const baseUrl = options.baseUrl ?? envBaseUrl ?? cfg.defaultBaseUrl;
-  const fetchImpl = options.fetch ?? fetch;
-  const cache = options.cache ?? chunk2423XDPT_cjs.globalEmbeddingCache;
-  const dimension = cfg.dimensionByModel[model];
-  if (dimension === void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
-      `${cfg.id} adapter: model "${model}" is not in the dimension table. Use one of: ${Object.keys(cfg.dimensionByModel).join(", ")}. To add it, update dimensionByModel in the adapter source.`,
-      { code: "embedding_unknown_model" }
-    );
-  }
-  const embeddingsPath = cfg.embeddingsPath ?? "/v1/embeddings";
-  const stats = {
-    cacheHits: 0,
-    cacheMisses: 0,
-    httpCalls: 0,
-    retries: 0
-  };
-  return {
-    id: cfg.id,
-    model,
-    dimension,
-    stats: () => ({ ...stats }),
-    embed: (texts) => embedTexts({
-      texts,
-      cache,
-      stats,
-      model,
-      dimension,
-      apiKey,
-      baseUrl,
-      embeddingsPath,
-      fetchImpl,
-      providerId: cfg.id
-    })
-  };
-}
-async function embedTexts(input) {
-  const { texts, cache, stats, model, dimension } = input;
-  const results = new Array(texts.length);
-  const pending = [];
-  for (let i = 0; i < texts.length; i++) {
-    classifyEntry({
-      index: i,
-      text: texts[i] ?? "",
-      model,
-      dimension,
-      cache,
-      stats,
-      results,
-      pending
-    });
-  }
-  await embedInBoundedBatches(input, pending, results);
-  return results.map((v) => v ?? new Array(dimension).fill(0));
-}
-function classifyEntry(args) {
-  if (args.text.trim().length === 0) {
-    args.results[args.index] = new Array(args.dimension).fill(0);
-    return;
-  }
-  const key = hashKey(args.model, args.text);
-  const cached = args.cache.get(key);
-  if (cached !== void 0) {
-    args.stats.cacheHits += 1;
-    args.results[args.index] = cached;
-    return;
-  }
-  args.stats.cacheMisses += 1;
-  args.pending.push({ index: args.index, text: args.text, key });
-}
-var MAX_CONCURRENT_BATCHES = 3;
-async function embedInBoundedBatches(input, pending, results) {
-  const batches = [];
-  for (let offset = 0; offset < pending.length; offset += MAX_BATCH) {
-    batches.push(pending.slice(offset, offset + MAX_BATCH));
-  }
-  await chunkSWIBQFPH_cjs.mapWithConcurrency(
-    batches,
-    MAX_CONCURRENT_BATCHES,
-    (batch) => processBatch(input, batch, results)
-  );
-}
-async function processBatch(input, batch, results) {
-  const vectors = await embedBatch({
-    apiKey: input.apiKey,
-    baseUrl: input.baseUrl,
-    embeddingsPath: input.embeddingsPath,
-    model: input.model,
-    inputs: batch.map((b) => b.text),
-    fetchImpl: input.fetchImpl,
-    stats: input.stats,
-    providerId: input.providerId
-  });
-  for (let j = 0; j < batch.length; j++) {
-    const slot = batch[j];
-    const vector = vectors[j];
-    if (slot === void 0 || vector === void 0) continue;
-    results[slot.index] = vector;
-    input.cache.set(slot.key, vector);
-  }
-}
-async function embedBatch(opts) {
-  const url = `${opts.baseUrl.replace(/\/$/, "")}${opts.embeddingsPath}`;
-  let attempt = 0;
-  while (true) {
-    opts.stats.httpCalls += 1;
-    const response = await postEmbedRequest(opts, url);
-    if (response.ok)
-      return await parseEmbedResponse(response, opts.providerId, opts.embeddingsPath);
-    if (isRetryable(response.status) && attempt < MAX_RETRIES) {
-      attempt += 1;
-      opts.stats.retries += 1;
-      await sleep(linearBackoffMs(attempt));
-      continue;
-    }
-    const text = await response.text().catch(() => "");
-    let body = text;
-    try {
-      body = JSON.parse(text);
-    } catch {
-    }
-    throw chunkALU3KC4G_cjs.mapOpenAICompatibleError({
-      providerId: opts.providerId,
-      status: response.status,
-      body,
-      headers: response.headers,
-      endpoint: opts.embeddingsPath
-    });
-  }
-}
-async function postEmbedRequest(opts, url) {
-  return opts.fetchImpl(url, {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-      authorization: `Bearer ${opts.apiKey}`
-    },
-    body: JSON.stringify({ model: opts.model, input: opts.inputs })
-  });
-}
-async function parseEmbedResponse(response, providerId, endpoint) {
-  const json = await response.json();
-  if (!Array.isArray(json.data)) {
-    throw new chunkMHCKWQR3_cjs.NetworkError(`${providerId} ${endpoint} returned no data`, {
-      code: "embedding_invalid_response",
-      metadata: {
-        provider: providerId,
-        endpoint,
-        code: "invalid_request",
-        raw: json
-      }
-    });
-  }
-  return json.data.map((d) => d.embedding);
-}
-function isRetryable(status) {
-  return status === 429 || status >= 500 && status < 600;
-}
-function hashKey(model, text) {
-  return crypto.createHash("sha256").update(`${model} ${text}`).digest("hex");
-}
-function linearBackoffMs(attempt) {
-  return 50 * attempt;
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
 
 // src/internal/memory/adapters/azure-openai-embedding.ts
 var DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
@@ -8147,7 +8164,7 @@ var azureOpenAiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "azure-openai",
   autoSelectPriority: 25,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "azure-openai",
       defaultBaseUrl: "https://your-resource.openai.azure.com",
@@ -8155,7 +8172,15 @@ var azureOpenAiMemoryEmbeddingProviderAdapter = {
       baseUrlEnv: "AZURE_OPENAI_ENDPOINT",
       defaultModel: DEFAULT_AZURE_OPENAI_EMBEDDING_MODEL,
       embeddingsPath: "/openai/deployments/{model}/embeddings?api-version=2024-02-01",
-      dimensionByModel: DIMENSION_BY_MODEL
+      dimensionByModel: DIMENSION_BY_MODEL,
+      // theokit#159 — Azure is NOT OpenAI on the wire, despite the name. It authenticates an API
+      // key with the `api-key` header (`Authorization: Bearer` is for Entra ID tokens, not for
+      // AZURE_OPENAI_API_KEY), and the deployment already rides in the path, so `model` has no
+      // place in the body. Sending the OpenAI shape meant every request was rejected.
+      dialect: {
+        authHeaders: (apiKey) => ({ "api-key": apiKey }),
+        body: (_model, inputs) => ({ input: inputs })
+      }
     },
     options
   )
@@ -8175,14 +8200,27 @@ var cohereMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "cohere",
   autoSelectPriority: 30,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "cohere",
       defaultBaseUrl: "https://api.cohere.com",
       apiKeyEnv: "COHERE_API_KEY",
       defaultModel: DEFAULT_COHERE_EMBEDDING_MODEL,
       embeddingsPath: "/v2/embed",
-      dimensionByModel: DIMENSION_BY_MODEL2
+      dimensionByModel: DIMENSION_BY_MODEL2,
+      // theokit#159 — `/v2/embed` diverges in BOTH directions: it names the payload `texts`, requires
+      // `input_type`, and answers `{embeddings:{float:[[...]]}}` rather than `{data:[{embedding}]}`.
+      // `search_document` is the right default here because this runtime embeds material for
+      // storage; a query-side embedder would use `search_query`.
+      dialect: {
+        body: (model, inputs) => ({
+          model,
+          texts: [...inputs],
+          input_type: "search_document",
+          embedding_types: ["float"]
+        }),
+        vectors: (json) => json.embeddings?.float
+      }
     },
     options
   )
@@ -8208,7 +8246,7 @@ var deepinfraMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "deepinfra",
   autoSelectPriority: 13,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "deepinfra",
       defaultBaseUrl: "https://api.deepinfra.com",
@@ -8234,12 +8272,15 @@ var geminiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "gemini",
   autoSelectPriority: 30,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "gemini",
       defaultBaseUrl: "https://generativelanguage.googleapis.com",
       apiKeyEnv: "GEMINI_API_KEY",
       defaultModel: DEFAULT_GEMINI_EMBEDDING_MODEL,
+      // theokit#159 — the compat surface is under `/v1beta/openai/`, not the default
+      // `/v1/embeddings`; the previous path 404'd on every call.
+      embeddingsPath: "/v1beta/openai/embeddings",
       dimensionByModel: DIMENSION_BY_MODEL4
     },
     options
@@ -8259,7 +8300,7 @@ var jinaMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "jina",
   autoSelectPriority: 35,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "jina",
       defaultBaseUrl: "https://api.jina.ai",
@@ -8282,7 +8323,7 @@ var mistralMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "mistral",
   autoSelectPriority: 18,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "mistral",
       defaultBaseUrl: "https://api.mistral.ai",
@@ -8324,7 +8365,7 @@ var ollamaMemoryEmbeddingProviderAdapter = {
   autoSelectPriority: 10,
   create: (options) => {
     const apiKey = options.apiKey ?? process.env.OLLAMA_API_KEY ?? OLLAMA_LOCAL_SENTINEL_KEY;
-    return createOpenAiCompatibleRuntime(
+    return chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
       {
         id: "ollama",
         defaultBaseUrl: "http://localhost:11434",
@@ -8351,7 +8392,7 @@ var openAiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "openai",
   autoSelectPriority: 20,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "openai",
       defaultBaseUrl: "https://api.openai.com",
@@ -8378,7 +8419,7 @@ var openRouterMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "openrouter",
   autoSelectPriority: 15,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "openrouter",
       defaultBaseUrl: "https://openrouter.ai/api",
@@ -8406,7 +8447,7 @@ var voyageMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "voyage",
   autoSelectPriority: 14,
-  create: (options) => createOpenAiCompatibleRuntime(
+  create: (options) => chunk7U2HAAWB_cjs.createOpenAiCompatibleRuntime(
     {
       id: "voyage",
       defaultBaseUrl: "https://api.voyageai.com",
@@ -8507,7 +8548,7 @@ function createMemorySearchTool(opts) {
   };
 }
 function createMemoryGetTool(opts) {
-  const memoryRoot = path.resolve(chunk2423XDPT_cjs.memoryDir(opts.cwd));
+  const memoryRoot = path.resolve(chunkCN6UX5EV_cjs.memoryDir(opts.cwd));
   return {
     name: "memory_get",
     description: GET_DESCRIPTION,
@@ -8518,7 +8559,7 @@ function createMemoryGetTool(opts) {
       const lines = readNumber(input.lines);
       const resolved = path.resolve(memoryRoot, relPath);
       if (!isPathInside(memoryRoot, resolved)) {
-        throw new chunkMHCKWQR3_cjs.ConfigurationError(
+        throw new chunkIHFNRNTJ_cjs.ConfigurationError(
           `memory_get rejected path that escapes memory root: ${relPath}`,
           { code: "memory_path_escapes_root" }
         );
@@ -8538,7 +8579,7 @@ function readString(value, errorIfMissing, allowUndefined = false) {
   if (typeof value === "string") return value;
   if (allowUndefined && (value === void 0 || value === null)) return "";
   if (errorIfMissing !== void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(errorIfMissing, { code: "memory_tool_bad_args" });
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(errorIfMissing, { code: "memory_tool_bad_args" });
   }
   return "";
 }
@@ -8614,7 +8655,7 @@ var LocalAgentMemory = class {
       const openOpts = { cwd: this.workspaceCwd };
       if (embedding !== void 0) openOpts.embedding = embedding;
       if (cfg?.backend !== void 0) openOpts.backend = cfg.backend;
-      this.index = await chunk2423XDPT_cjs.IndexManager.open(openOpts);
+      this.index = await chunkCN6UX5EV_cjs.IndexManager.open(openOpts);
       await this.index.sync();
       this.toolsCache = [
         createMemorySearchTool({ index: this.index }),
@@ -8629,7 +8670,7 @@ var LocalAgentMemory = class {
       const warned2 = g[sym];
       if (!warned2.has(message)) {
         warned2.add(message);
-        chunkLTCOPATU_cjs.diag(`[theokit-sdk] memory tools unavailable: ${message}
+        chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] memory tools unavailable: ${message}
 `);
       }
       return void 0;
@@ -8638,7 +8679,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 chunkALU3KC4G_cjs.CircuitBreaker();
+    if (this.breaker === void 0) this.breaker = new chunkBPN5ONSW_cjs.CircuitBreaker();
     if (this.cache === void 0) this.cache = new ActiveMemoryCache();
     const result = await runActiveMemory({
       userText,
@@ -8688,7 +8729,7 @@ var LocalAgentMemory = class {
       await this.index.sync();
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] session index sync failed: ${message}
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] session index sync failed: ${message}
 `);
     }
   }
@@ -8701,7 +8742,7 @@ var LocalAgentMemory = class {
       return await adapter.create(cfg.model !== void 0 ? { model: cfg.model } : {});
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunkLTCOPATU_cjs.diag(`[theokit-sdk] memory embedding ${cfg.provider} unavailable: ${message}
+      chunkBCQ3E2ZG_cjs.diag(`[theokit-sdk] memory embedding ${cfg.provider} unavailable: ${message}
 `);
       return void 0;
     }
@@ -8737,7 +8778,7 @@ function buildAgentMemory(pluginManager, workspaceCwd, defaultContext) {
       ...partial?.metadata !== void 0 ? { metadata: partial.metadata } : defaultContext?.metadata !== void 0 ? { metadata: defaultContext.metadata } : {}
     };
     if (merged.userId === "") {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         "agent.memory requires a userId \u2014 either set AgentOptions.memoryContext.userId or pass ctx.userId at call time.",
         { code: "memory_context_missing_user_id" }
       );
@@ -8747,7 +8788,7 @@ function buildAgentMemory(pluginManager, workspaceCwd, defaultContext) {
   async function requireAdapters() {
     const r = await ensure();
     if (r.adapters.length === 0) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         "No memory adapter registered. Pass a memory plugin in AgentOptions.plugins (e.g. supermemoryMemory({...})).",
         { code: "no_memory_adapter" }
       );
@@ -8788,7 +8829,7 @@ function buildAgentMemory(pluginManager, workspaceCwd, defaultContext) {
       const prefix = id.split(":", 1)[0] ?? "";
       const target = adapters.find((a) => a.id === prefix);
       if (target === void 0) {
-        throw new chunkMHCKWQR3_cjs.ConfigurationError(
+        throw new chunkIHFNRNTJ_cjs.ConfigurationError(
           `No adapter found for MemoryId prefix "${prefix}" (registered: ${adapters.map((a) => a.id).join(", ")}).`,
           { code: "no_memory_adapter" }
         );
@@ -8861,7 +8902,7 @@ function createLocalAgentMemoryProvider(opts) {
       return { facts: [], systemPromptAdditions: summary };
     },
     async recordSessionSummary(args) {
-      await chunk2423XDPT_cjs.writeSessionSummary(args);
+      await chunkCN6UX5EV_cjs.writeSessionSummary(args);
     },
     async sync(handle) {
       const state = handle[INTERNAL_LAM_KEY];
@@ -8939,19 +8980,19 @@ var PersonalityRegistry = class _PersonalityRegistry {
 function addEntity(byName, entity, origin, collisionMap) {
   const fm = entity.frontmatter;
   if (PersonalityRegistry.isReservedClearSlug(fm.name)) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Personality name "${fm.name}" is reserved (used to clear active preset)`,
       { code: "personality_reserved_name" }
     );
   }
   if (entity.body.trim().length === 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Personality "${fm.name}" has empty body (system prompt required)`,
       { code: "personality_empty_body" }
     );
   }
   if (origin === "project" && collisionMap?.has(fm.name)) {
-    chunkFAY3QDGC_cjs.warnOnce(
+    chunk6LGQECT7_cjs.warnOnce(
       `personality-collision-${fm.name}`,
       `[theokit-sdk] personality "${fm.name}" overridden by project preset`
     );
@@ -8980,7 +9021,7 @@ async function performPersonalitySwitch(args) {
     const preset = args.registry.get(args.requestedName);
     if (preset === void 0) {
       const available = args.registry.all().map((p) => p.name).join(", ") || "(none)";
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `Personality "${args.requestedName}" not found. Available: ${available}`,
         { code: "personality_not_found" }
       );
@@ -9001,14 +9042,14 @@ async function performPersonalitySwitch(args) {
 
 // src/internal/local-agent/local-agent-personality-extensions.ts
 function resolveActivePersonalityPreset(args) {
-  const forkCtx = chunkFAY3QDGC_cjs.currentPersonalityContext();
+  const forkCtx = chunk6LGQECT7_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 = chunkFAY3QDGC_cjs.currentPersonalityContext()?.slug;
+  const forkSlug = chunk6LGQECT7_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);
@@ -9022,8 +9063,8 @@ ${preset.systemPrompt}`;
 }
 async function localAgentUsePersonality(args) {
   if (args.disposed) throw new Error("Agent has been disposed");
-  if (chunkFAY3QDGC_cjs.currentPersonalityContext() !== void 0) {
-    chunkFAY3QDGC_cjs.warnPersonalitySwitchInsideFork(args.agentId);
+  if (chunk6LGQECT7_cjs.currentPersonalityContext() !== void 0) {
+    chunk6LGQECT7_cjs.warnPersonalitySwitchInsideFork(args.agentId);
     return null;
   }
   let registry = args.personalityRegistry;
@@ -9040,8 +9081,8 @@ async function localAgentUsePersonality(args) {
       registry,
       store: args.personalityStore,
       invalidateCache: (reason) => args.invalidateCache(reason),
-      appendSessionMessage: (msg) => chunkH5YVJB4K_cjs.appendSessionMessage(args.agentId, msg),
-      clearSession: () => chunkH5YVJB4K_cjs.clearSession(args.agentId),
+      appendSessionMessage: (msg) => chunkDCXRHCZJ_cjs.appendSessionMessage(args.agentId, msg),
+      clearSession: () => chunkDCXRHCZJ_cjs.clearSession(args.agentId),
       opts: args.opts ?? {}
     })
   );
@@ -9050,9 +9091,9 @@ async function localAgentUsePersonality(args) {
 // src/internal/local-agent/local-agent-runtime-extensions.ts
 function localAgentRunUntil(agent, goal, options) {
   async function* wrap() {
-    const { runUntilImpl } = await import('./run-until-ZZ2JLPJM.cjs');
+    const { runUntilImpl } = await import('./run-until-L5KQD3PV.cjs');
     const buildDeps = async () => {
-      const { judgeCallImpl } = await import('./judge-call-SP3G3X2Y.cjs');
+      const { judgeCallImpl } = await import('./judge-call-U2D33JOW.cjs');
       const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
       const create = getAgentFacade().create;
       return {
@@ -9085,7 +9126,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-Y2IK2RYU.cjs');
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
-  const { withPersonalityContext } = await import('./context-ZV33V4DC.cjs');
+  const { withPersonalityContext } = await import('./context-2FZSC6VQ.cjs');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9145,7 +9186,7 @@ function wrapRunWithCompletionCheck(args) {
       judgeOpts
     );
     const complete = !verdict.parseFailed && verdict.verdict === "done";
-    chunk6EDQBX7U_cjs.emitRunEvent(args.onRunEvent, {
+    chunkN475ETD6_cjs.emitRunEvent(args.onRunEvent, {
       type: "completion_check",
       complete,
       reason: verdict.reason
@@ -9241,6 +9282,9 @@ var SUPPORTED = /* @__PURE__ */ new Set([
   "cancel",
   "conversation"
 ]);
+function emptyTimeline() {
+  return emptyStream();
+}
 function emptyStream() {
   return {
     next: () => Promise.resolve({ done: true, value: void 0 }),
@@ -9265,6 +9309,9 @@ function createTripwireRun(args) {
     status: "cancelled",
     ...args.model !== void 0 ? { model: args.model } : {},
     stream: () => emptyStream(),
+    // theokit#140 - a tripwire run never executed, so its timeline is empty by construction, the
+    // same reason `stream()` is. Both are empty for the same fact, not by coincidence.
+    events: () => emptyTimeline(),
     wait: () => Promise.resolve(result),
     cancel: () => Promise.resolve(),
     conversation: () => Promise.resolve([]),
@@ -9286,7 +9333,7 @@ function wrapRunWithOutputProcessors(args) {
     if (result.status !== "finished" || result.result === void 0) return result;
     const res = await runOutputProcessors(args.processors, result.result, args.agentId);
     if (res.kind === "ok") return { ...result, result: res.value };
-    chunk6EDQBX7U_cjs.emitRunEvent(args.onRunEvent, {
+    chunkN475ETD6_cjs.emitRunEvent(args.onRunEvent, {
       type: "tripwire",
       reason: res.tripwire.reason,
       processorId: res.tripwire.processorId
@@ -9361,7 +9408,7 @@ async function applyInputProcessors(inputs, message, rawUserText, options, sendM
   }
   const res = await runInputProcessors(processors, rawUserText, inputs.agentId);
   if (res.kind === "tripwire") {
-    chunk6EDQBX7U_cjs.emitRunEvent(options.onRunEvent, {
+    chunkN475ETD6_cjs.emitRunEvent(options.onRunEvent, {
       type: "tripwire",
       reason: res.tripwire.reason,
       processorId: res.tripwire.processorId
@@ -9378,7 +9425,7 @@ async function applyInputProcessors(inputs, message, rawUserText, options, sendM
   return { userText: res.value, effectiveMessage };
 }
 async function executeSendLocked(inputs, message, options) {
-  if (inputs.disposed) throw new chunkMHCKWQR3_cjs.AgentDisposedError(inputs.agentId);
+  if (inputs.disposed) throw new chunkIHFNRNTJ_cjs.AgentDisposedError(inputs.agentId);
   await consumePending(inputs.agentId, inputs.invalidationPending, inputs.clearInvalidation, inputs.reload);
   const sendModel = normalizeModel(options.model);
   inputs.applyModelOverride(sendModel);
@@ -9389,7 +9436,7 @@ async function executeSendLocked(inputs, message, options) {
   if (inputs.options.onBeforeSend !== void 0) {
     await inputs.options.onBeforeSend({
       conversationId: inputs.agentId,
-      previousMessageCount: chunkH5YVJB4K_cjs.getSessionMessages(inputs.agentId).length
+      previousMessageCount: chunkDCXRHCZJ_cjs.getSessionMessages(inputs.agentId).length
     });
   }
   await inputs.runPreHook(userText);
@@ -9401,8 +9448,8 @@ async function executeSendLocked(inputs, message, options) {
     userText,
     sendOptions: options
   });
-  const priorMessages = [...chunkH5YVJB4K_cjs.getSessionMessages(inputs.agentId)];
-  chunkH5YVJB4K_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
+  const priorMessages = [...chunkDCXRHCZJ_cjs.getSessionMessages(inputs.agentId)];
+  chunkDCXRHCZJ_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
   await persistMemoryFactIfWritePrompt(inputs.workspaceCwd, inputs.options.memory, userText);
   const memoryFacts = await readMemoryForSend(inputs.workspaceCwd, inputs.options.memory);
   const portPathActive = shouldUsePortMemoryPath();
@@ -9460,7 +9507,7 @@ async function executeSendLocked(inputs, message, options) {
 function buildCompletionCheckDeps() {
   return {
     judge: async (ctx, opts) => {
-      const { judgeCallImpl } = await import('./judge-call-SP3G3X2Y.cjs');
+      const { judgeCallImpl } = await import('./judge-call-U2D33JOW.cjs');
       const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
       return judgeCallImpl(ctx, opts, { create: getAgentFacade().create });
     }
@@ -9480,7 +9527,7 @@ function registerRunAsTask(run, agentId, taskOpt, userText) {
     promptPreview: userText.slice(0, 120),
     ...opts.meta ?? {}
   };
-  void chunk6EDQBX7U_cjs.submit({
+  void chunkN475ETD6_cjs.submit({
     kind: "run",
     work: async (ctx) => {
       ctx.signal.addEventListener(
@@ -9564,7 +9611,7 @@ var LocalAgent = class {
     this.options = options;
     this.workspaceCwd = resolveCwd(options.local?.cwd);
     this.transcriptBaseDir = resolveBaseDir(options.local?.baseDir);
-    this.sessionStore = options.local?.sessionStore ?? new chunkITLS5LRF_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
+    this.sessionStore = options.local?.sessionStore ?? new chunk74D7KSBP_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
     this.settingSourcesIncludeProject = includesSetting(options, "project");
     this.settingSourcesIncludePlugins = includesSetting(options, "plugins");
     const sub = bootstrapSubmanagers({
@@ -9607,17 +9654,17 @@ var LocalAgent = class {
     if (this.pluginsManager !== void 0) await this.pluginsManager.initialize();
     const codePlugins = chunkBV2MWEMV_cjs.extractCodePlugins(this.options.plugins);
     await this.pluginManagerCode.initialize(codePlugins);
-    this.resolvedSubagents = await chunkGM7QDQ24_cjs.loadSubagents(
+    this.resolvedSubagents = await chunkW4WKVOOQ_cjs.loadSubagents(
       this.workspaceCwd,
       this.settingSourcesIncludeProject,
       this.options.agents
     );
-    await adquirirLeaseSePossivel(this.sessionStore, this.agentId);
+    await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
-      await chunkH5YVJB4K_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
+      await chunkDCXRHCZJ_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
       await this.personalityStore.hydrate(this.agentId);
     } catch (err) {
-      await soltarLeaseSePossivel(this.sessionStore, this.agentId);
+      await releaseLeaseIfPossible(this.sessionStore, this.agentId);
       throw err;
     }
   }
@@ -9650,16 +9697,16 @@ var LocalAgent = class {
     });
   }
   /**
-   * A janela de contexto declarada na seleção de modelo, no formato de spread condicional.
+   * The context window declared on the model selection, in conditional-spread form.
    *
-   * M94 — sem isto, o `override` de `resolveEffectiveContextWindow` existia desde o M77 e nenhum
-   * call site de produção o passava: um modelo de 400k sem entrada de catálogo era orçado contra o
-   * piso de 128k. Método próprio porque o spread inline empurrava `runLockedSendCycle` para além do
-   * teto de complexidade cognitiva do projeto.
+   * M94 — without this, `resolveEffectiveContextWindow`'s `override` had existed since M77 and no
+   * production call site passed it: a 400k model with no catalog entry was budgeted against the
+   * 128k floor. Its own method because the inline spread pushed `runLockedSendCycle` past the
+   * project's cognitive-complexity ceiling.
    */
-  #janelaDeclarada() {
-    const declarada = this.model?.contextWindow;
-    return declarada !== void 0 ? { contextWindow: declarada } : {};
+  #declaredWindow() {
+    const declared = this.model?.contextWindow;
+    return declared !== void 0 ? { contextWindow: declared } : {};
   }
   async runLockedSendCycle(message, options, sendSpan, resolve, reject) {
     const userText = typeof message === "string" ? message : message.text;
@@ -9688,7 +9735,7 @@ var LocalAgent = class {
         workspaceCwd: this.workspaceCwd,
         sessionStore: this.sessionStore,
         model: this.model?.id ?? "unknown",
-        ...this.#janelaDeclarada(),
+        ...this.#declaredWindow(),
         // M50 — the auto-compaction summarizer resolves credentials like the run itself.
         ...this.options.apiKey !== void 0 ? { apiKey: this.options.apiKey } : {},
         ...options.onRunEvent !== void 0 ? { onRunEvent: options.onRunEvent } : {},
@@ -9763,7 +9810,7 @@ var LocalAgent = class {
       agentId: this.agentId
     });
     if (preRun.blocked) {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         `preRun hook denied execution: ${preRun.reason ?? "unspecified"}`,
         { code: "hook_denied" }
       );
@@ -9844,7 +9891,7 @@ var LocalAgent = class {
   }
   // biome-ignore format: G8 budget — see listArtifacts.
   downloadArtifact(_path) {
-    return Promise.reject(new chunkMHCKWQR3_cjs.UnsupportedRunOperationError("Artifacts are not supported for local agents", "downloadArtifact"));
+    return Promise.reject(new chunkIHFNRNTJ_cjs.UnsupportedRunOperationError("Artifacts are not supported for local agents", "downloadArtifact"));
   }
   // biome-ignore format: G8 budget — delegates to `local-agent-runtime-extensions.ts`; kept 1-line.
   runUntil(goal, options) {
@@ -9867,7 +9914,7 @@ function resolveCwd(cwd) {
   return (Array.isArray(cwd) ? cwd[0] : cwd) ?? process.cwd();
 }
 function resolveBaseDir(baseDir) {
-  return baseDir === void 0 ? chunkIEUDKUPM_cjs.defaultBaseDir() : chunkIEUDKUPM_cjs.expandTilde(baseDir);
+  return baseDir === void 0 ? chunkZ2CUEBXV_cjs.defaultBaseDir() : chunkZ2CUEBXV_cjs.expandTilde(baseDir);
 }
 function includesSetting(options, source) {
   const sources = options.local?.settingSources;
@@ -9892,7 +9939,7 @@ async function guardAgainstIdCollision(options) {
   const persistenceCwd = resolveAgentPersistenceCwd(options);
   await hydrateRegistryFromDisk(persistenceCwd);
   if (getRegisteredAgent(options.agentId) !== void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       `Agent "${options.agentId}" already exists. Use Agent.resume("${options.agentId}") to reattach, or pick a different agentId.`,
       { code: "agent_id_already_exists" }
     );
@@ -9925,7 +9972,7 @@ async function maybeInjectHandoffTools(options) {
     const spec = "@theokit/sdk-handoff/internal/tool-injector";
     mod = await import(spec);
   } catch (err) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError(
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError(
       "Agent.create({ handoffs: [...] }) requires @theokit/sdk-handoff. Install it: pnpm add @theokit/sdk-handoff. Or migrate to the preferred plugin pattern: plugins: [Handoff.asPlugin({ targets: [...] })] (see docs/migration/1-x-to-2-0.md#handoff).",
       { code: "handoff_package_missing", cause: err }
     );
@@ -9945,9 +9992,9 @@ async function maybeInjectHandoffTools(options) {
 async function createLocalAgent(options) {
   const apiKey = resolveApiKey(options.apiKey);
   if (apiKey === void 0) {
-    throw new chunkMHCKWQR3_cjs.AuthenticationError("Missing API key", { code: "missing_api_key" });
+    throw new chunkIHFNRNTJ_cjs.AuthenticationError("Missing API key", { code: "missing_api_key" });
   }
-  const willFlowToProvider = !chunkALU3KC4G_cjs.isFixtureApiKey(apiKey) && !chunkALU3KC4G_cjs.shouldUseRealLocalRuntime(apiKey);
+  const willFlowToProvider = !chunkBPN5ONSW_cjs.isFixtureApiKey(apiKey) && !chunkBPN5ONSW_cjs.shouldUseRealLocalRuntime(apiKey);
   const shape = validateApiKeyShape(apiKey, {
     strict: willFlowToProvider,
     // `options.model` is already normalized by `runCreateUnderSpan`; `normalizeModel`
@@ -9956,10 +10003,10 @@ async function createLocalAgent(options) {
     ...willFlowToProvider ? { provider: providerFromModelId(normalizeModel(options.model)?.id) } : {}
   });
   if (shape.malformed) {
-    throw new chunkMHCKWQR3_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
+    throw new chunkIHFNRNTJ_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  if (!chunkALU3KC4G_cjs.isFixtureApiKey(apiKey) && chunkALU3KC4G_cjs.getConfiguredBaseUrl() === void 0 && !chunkALU3KC4G_cjs.shouldUseRealLocalRuntime(apiKey)) {
-    throw new chunkMHCKWQR3_cjs.AuthenticationError("Invalid API key", {
+  if (!chunkBPN5ONSW_cjs.isFixtureApiKey(apiKey) && chunkBPN5ONSW_cjs.getConfiguredBaseUrl() === void 0 && !chunkBPN5ONSW_cjs.shouldUseRealLocalRuntime(apiKey)) {
+    throw new chunkIHFNRNTJ_cjs.AuthenticationError("Invalid API key", {
       code: "authentication_error"
     });
   }
@@ -9970,19 +10017,19 @@ async function createLocalAgent(options) {
 async function createCloudAgent(options) {
   const apiKey = resolveApiKey(options.apiKey);
   if (apiKey === void 0) {
-    throw new chunkMHCKWQR3_cjs.ConfigurationError("Missing API key for cloud agent", {
+    throw new chunkIHFNRNTJ_cjs.ConfigurationError("Missing API key for cloud agent", {
       code: "missing_api_key"
     });
   }
   const shape = validateApiKeyShape(apiKey);
   if (shape.malformed) {
-    throw new chunkMHCKWQR3_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
+    throw new chunkIHFNRNTJ_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  const baseUrl = chunkALU3KC4G_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkBPN5ONSW_cjs.getConfiguredBaseUrl();
   if (baseUrl === void 0) {
     return new CloudAgent(options);
   }
-  const response = await chunkALU3KC4G_cjs.httpRequest("/v1/agents", {
+  const response = await chunkBPN5ONSW_cjs.httpRequest("/v1/agents", {
     apiKey,
     method: "POST",
     body: {
@@ -10007,7 +10054,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
-  await chunkALU3KC4G_cjs.discoverProviderPlugins();
+  await chunkBPN5ONSW_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 = {
@@ -10038,7 +10085,7 @@ async function validateRehydratedAgent(agentId, entry) {
       throw new Error(`Workspace path is not a directory: ${candidate}`);
     }
   } catch (cause) {
-    throw new chunkMHCKWQR3_cjs.UnknownAgentError(
+    throw new chunkIHFNRNTJ_cjs.UnknownAgentError(
       `Agent "${agentId}" cannot be rehydrated \u2014 workspace cwd "${candidate}" is missing or inaccessible.`,
       { code: "agent_rehydration_failed", cause }
     );
@@ -10090,7 +10137,7 @@ async function getRegisteredAgentOrThrow(agentId) {
     agent = getRegisteredAgent(agentId);
   }
   if (agent === void 0) {
-    throw new chunkMHCKWQR3_cjs.UnknownAgentError(`Agent ${agentId} not found`, { code: "unknown_agent" });
+    throw new chunkIHFNRNTJ_cjs.UnknownAgentError(`Agent ${agentId} not found`, { code: "unknown_agent" });
   }
   return agent;
 }
@@ -10135,7 +10182,7 @@ var Agent = class _Agent {
       pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
-      await chunkALU3KC4G_cjs.discoverProviderPlugins();
+      await chunkBPN5ONSW_cjs.discoverProviderPlugins();
       const agent = await runCreateUnderSpan(options, span);
       return agent;
     } catch (err) {
@@ -10161,8 +10208,8 @@ var Agent = class _Agent {
       const run = await agent.send(message);
       const result = await run.wait();
       if (options.throwOnError === true && result.status === "error" && result.error !== void 0) {
-        throw new chunkMHCKWQR3_cjs.AgentRunError(result.error.message, {
-          code: chunkMHCKWQR3_cjs.coerceToKnownAgentRunErrorCode(result.error.code),
+        throw new chunkIHFNRNTJ_cjs.AgentRunError(result.error.message, {
+          code: chunkIHFNRNTJ_cjs.coerceToKnownAgentRunErrorCode(result.error.code),
           cause: result.error.cause
         });
       }
@@ -10189,7 +10236,7 @@ var Agent = class _Agent {
     if (existing !== void 0) {
       return await rehydrateExistingAgent(agentId, existing, options);
     }
-    throw new chunkMHCKWQR3_cjs.UnknownAgentError(
+    throw new chunkIHFNRNTJ_cjs.UnknownAgentError(
       `Agent "${agentId}" not found. Use Agent.create({ agentId, ... }) for first-time setup, or catch UnknownAgentError to branch resume-vs-create.`,
       { code: "unknown_agent" }
     );
@@ -10218,7 +10265,7 @@ var Agent = class _Agent {
    * @public
    */
   static async generateObject(options) {
-    const { generateObjectImpl } = await import('./generate-object-5SCEH2EE.cjs');
+    const { generateObjectImpl } = await import('./generate-object-UF6WIZLF.cjs');
     return generateObjectImpl(options, {
       create: (opts) => _Agent.create(opts),
       delete: (agentId) => _Agent.delete(agentId)
@@ -10242,7 +10289,7 @@ var Agent = class _Agent {
       delete: (agentId) => _Agent.delete(agentId)
     };
     async function* wrapper() {
-      streamObjectImport ??= import('./stream-object-Y7YCX3BI.cjs');
+      streamObjectImport ??= import('./stream-object-4FDU76YW.cjs');
       const { streamObjectImpl } = await streamObjectImport;
       yield* streamObjectImpl(options, deps);
     }
@@ -10266,7 +10313,7 @@ var Agent = class _Agent {
    * @public
    */
   static async batch(prompts, options) {
-    const { batchImpl } = await import('./batch-3SEPDXCU.cjs');
+    const { batchImpl } = await import('./batch-X6JKGDPK.cjs');
     return batchImpl(prompts, options, { create: (opts) => _Agent.create(opts) });
   }
   /**
@@ -10290,7 +10337,7 @@ var Agent = class _Agent {
    *
    *   This bullet used to say the opposite ("Disposed agents are NOT auto-deleted...
    *   call `Agent.delete(agentId)` first"). It was measured false in M91:
-   *   `tests/m91-getorcreate-apos-dispose.test.ts` builds an agent, disposes it, and
+   *   `tests/m91-getorcreate-after-dispose.test.ts` builds an agent, disposes it, and
    *   gets a different instance back. The claim was about the PERSISTENT registry and
    *   read as being about the live cache — and consumers built around the wrong half.
    *   The agent-builder's M85 interrupt rotates the session id to work around a
@@ -10346,14 +10393,14 @@ var Agent = class _Agent {
    */
   static async getRun(runId, options = {}) {
     if (options.runtime === "cloud") {
-      throw new chunkMHCKWQR3_cjs.ConfigurationError(
+      throw new chunkIHFNRNTJ_cjs.ConfigurationError(
         "Cloud runtime is pre-release. Theo PaaS endpoints are not wired yet \u2014 getRun({ runtime: 'cloud' }) will be enabled when the PaaS ships.",
         { code: "cloud_runtime_pre_release" }
       );
     }
     const existing = getRun(runId);
     if (existing !== void 0) return existing;
-    throw new chunkMHCKWQR3_cjs.UnknownAgentError(
+    throw new chunkIHFNRNTJ_cjs.UnknownAgentError(
       `Run ${runId} is not in this process's registry. It may have been disposed, persisted in a previous process, or never created.`,
       { code: "run_not_found" }
     );
@@ -10400,13 +10447,13 @@ var Agent = class _Agent {
       reg = getRegisteredAgent(agentId);
     }
     if (reg === void 0 || reg.runtime !== "local") {
-      throw new chunkMHCKWQR3_cjs.UnknownAgentError(
+      throw new chunkIHFNRNTJ_cjs.UnknownAgentError(
         `No local agent "${agentId}" registered \u2014 compact targets local sessions.`
       );
     }
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-H5TKLD55.cjs');
-    const { cwd, model, store } = await abrirStoreLocal(reg);
-    return chunkH5YVJB4K_cjs.enqueueSessionWrite(
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-VVT6IBJG.cjs');
+    const { cwd, model, store } = await openLocalStore(reg);
+    return chunkDCXRHCZJ_cjs.enqueueSessionWrite(
       cwd,
       agentId,
       () => compactSessionTranscript({
@@ -10436,12 +10483,12 @@ var Agent = class _Agent {
       reg = getRegisteredAgent(agentId);
     }
     if (reg === void 0 || reg.runtime !== "local") {
-      throw new chunkMHCKWQR3_cjs.UnknownAgentError(
+      throw new chunkIHFNRNTJ_cjs.UnknownAgentError(
         `No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`
       );
     }
-    const { injectSessionTurn } = await import('./inject-session-DM4SKTZO.cjs');
-    const { cwd, model, store } = await abrirStoreLocal(reg);
+    const { injectSessionTurn } = await import('./inject-session-LFCYVSLJ.cjs');
+    const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
       loc: { cwd, agentId, model },
@@ -10450,6 +10497,86 @@ var Agent = class _Agent {
       assistantText: turn.assistantText
     });
   }
+  /**
+   * theokit#146 — read a LOCAL agent's persisted transcript as STRUCTURE, for rendering.
+   *
+   * A resumed session already replays correctly to the model, but a host had no way to draw it:
+   * the only projection available folded a tool call to the string `[tool call] NAME`, dropping the
+   * call id and every argument. A card UI got prose, so cross-restart resume was worth less than
+   * starting fresh — which is what at least one consumer did.
+   *
+   * Each returned message carries both projections: `text` (unchanged, what the model replay uses)
+   * and `parts` (`text` / `tool_use` / `tool_result` with ids, names, arguments and the
+   * `toolUseId` that correlates a result back to its call).
+   *
+   * Read-only and local-only: it opens the agent's session store and walks the transcript, exactly
+   * as {@link Agent.compact} and {@link Agent.injectSessionTurn} do. It appends nothing.
+   *
+   * @throws UnknownAgentError when `agentId` names no local agent.
+   * @public
+   */
+  static async transcript(agentId) {
+    let reg = getRegisteredAgent(agentId);
+    if (reg === void 0) {
+      await hydrateRegistryFromDisk(process.cwd());
+      reg = getRegisteredAgent(agentId);
+    }
+    if (reg === void 0 || reg.runtime !== "local") {
+      throw new chunkIHFNRNTJ_cjs.UnknownAgentError(
+        `No local agent "${agentId}" registered \u2014 transcript targets local sessions.`
+      );
+    }
+    const { readSessionMessages } = await import('./agent-session-store-N4TVKHBU.cjs');
+    const { store } = await openLocalStore(reg);
+    return readSessionMessages(store, agentId);
+  }
+  /**
+   * theokit#123 — read-only introspection of a registered agent's tools and subagents.
+   *
+   * `Agent.list()` / `Agent.get()` enumerate agents and `agent.skills.list()` covers skills, but
+   * tools and subagents lived only on `RegisteredAgent.options` — an internal contract. A
+   * reflection endpoint (theokit-studio's `theokit dev`) therefore had to report empty lists for
+   * both, and say so with an `unavailable_reason`.
+   *
+   * A PROJECTION, not the options object. Tool handlers and subagent prompts are stripped: a
+   * handler is an executable that cannot cross a process boundary, and a prompt is the agent's
+   * instructions rather than its signature — a reflection endpoint serializes what it is handed.
+   *
+   * @throws UnknownAgentError when `agentId` names no registered agent.
+   * @public
+   */
+  static async describe(agentId) {
+    const agent = await getRegisteredAgentOrThrow(agentId);
+    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-A4W6C3QP.cjs');
+    const settingSources = agent.options.local?.settingSources;
+    const subagents = await loadSubagents2(
+      agent.cwd ?? process.cwd(),
+      settingSources === void 0 || settingSources.includes("project"),
+      agent.options.agents
+    );
+    return {
+      agentId: agent.agentId,
+      runtime: agent.runtime,
+      ...agent.model !== void 0 ? { model: agent.model } : {},
+      // Always arrays, so a caller can tell "this agent has none" from "the SDK did not say".
+      //
+      // Honest limit, stated because the alternative is an implied claim: `tools` is still the
+      // DECLARED catalog. Plugin tools and the reasoning `think` tool are assembled per run by
+      // `buildCustomToolsInput`, so they are not knowable from the registry alone. Documented on
+      // `AgentDescription.tools`.
+      tools: (agent.options.tools ?? []).map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema
+      })),
+      subagents: Object.entries(subagents).map(([name, def]) => ({
+        name,
+        description: def.description,
+        ...def.model !== void 0 ? { model: def.model } : {},
+        ...def.tools !== void 0 ? { tools: def.tools } : {}
+      }))
+    };
+  }
   /**
    * Permanently delete a cloud agent.
    *
@@ -10464,12 +10591,12 @@ async function getOrCreateUncached(agentId, options) {
   try {
     return await Agent.resume(agentId, options);
   } catch (err) {
-    if (!(err instanceof chunkMHCKWQR3_cjs.UnknownAgentError)) throw err;
+    if (!(err instanceof chunkIHFNRNTJ_cjs.UnknownAgentError)) throw err;
   }
   try {
     return await Agent.create({ ...options, agentId });
   } catch (err) {
-    if (err instanceof chunkMHCKWQR3_cjs.ConfigurationError && err.code === "agent_id_already_exists") {
+    if (err instanceof chunkIHFNRNTJ_cjs.ConfigurationError && err.code === "agent_id_already_exists") {
       return await Agent.resume(agentId, options);
     }
     throw err;
@@ -10483,12 +10610,12 @@ chunkNINIJCHU_cjs.setAgentFacade({
   resume: (agentId, options) => Agent.resume(agentId, options),
   batch: (prompts, options) => Agent.batch(prompts, options)
 });
-async function abrirStoreLocal(reg) {
+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-7E7UPLF2.cjs');
-  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-EAKR4D2W.cjs');
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-J5MCFFUM.cjs');
+  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-H7NUFXXM.cjs');
   const baseDir = reg.options.local?.baseDir !== void 0 ? expandTilde2(reg.options.local.baseDir) : defaultBaseDir2();
   return { cwd, model, store: new FsSessionStore2({ baseDir, cwd }) };
 }
@@ -10505,5 +10632,5 @@ exports.generateCronId = generateCronId;
 exports.getPricingEntry = getPricingEntry;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
 exports.resolveApiKey = resolveApiKey;
-//# sourceMappingURL=chunk-W52DKZBR.cjs.map
-//# sourceMappingURL=chunk-W52DKZBR.cjs.map
+//# sourceMappingURL=chunk-INSFS5GT.cjs.map
+//# sourceMappingURL=chunk-INSFS5GT.cjs.map