@theokit/sdk 5.11.0 → 5.12.0

package/dist/{chunk-5OHB5HJF.cjs → chunk-Q6WT5535.cjs}

@@ -1,44 +1,44 @@
 'use strict';
 
-var chunkJ6GXS5A2_cjs = require('./chunk-J6GXS5A2.cjs');
-var chunkN7ZIPW2N_cjs = require('./chunk-N7ZIPW2N.cjs');
-var chunkL3C6CCBG_cjs = require('./chunk-L3C6CCBG.cjs');
-var chunkKIKKTW5O_cjs = require('./chunk-KIKKTW5O.cjs');
+var chunkL7JPXZ2C_cjs = require('./chunk-L7JPXZ2C.cjs');
+var chunkYOVZMN4P_cjs = require('./chunk-YOVZMN4P.cjs');
+var chunkCWQPQTUZ_cjs = require('./chunk-CWQPQTUZ.cjs');
+var chunk7YUPSBDV_cjs = require('./chunk-7YUPSBDV.cjs');
 var chunkBV2MWEMV_cjs = require('./chunk-BV2MWEMV.cjs');
-var chunkYEHQ3SIC_cjs = require('./chunk-YEHQ3SIC.cjs');
-var chunkTMKTSYDS_cjs = require('./chunk-TMKTSYDS.cjs');
-var chunkZD66GFH5_cjs = require('./chunk-ZD66GFH5.cjs');
-var chunkNQVWSSX2_cjs = require('./chunk-NQVWSSX2.cjs');
-var chunkBZKF7TXX_cjs = require('./chunk-BZKF7TXX.cjs');
+var chunkCGH4BCIY_cjs = require('./chunk-CGH4BCIY.cjs');
+var chunkRS7YQR4X_cjs = require('./chunk-RS7YQR4X.cjs');
+var chunkSDZ4XDWS_cjs = require('./chunk-SDZ4XDWS.cjs');
+var chunk6OCJWGVD_cjs = require('./chunk-6OCJWGVD.cjs');
+var chunkLSWHDOCL_cjs = require('./chunk-LSWHDOCL.cjs');
 var chunk2ZPEDVLM_cjs = require('./chunk-2ZPEDVLM.cjs');
-var chunkXKZFIP7Z_cjs = require('./chunk-XKZFIP7Z.cjs');
-var chunkN6OEX5TN_cjs = require('./chunk-N6OEX5TN.cjs');
-var chunkRQMCOFAI_cjs = require('./chunk-RQMCOFAI.cjs');
+var chunkQG4SXZ2A_cjs = require('./chunk-QG4SXZ2A.cjs');
+var chunkUDAKAE4Z_cjs = require('./chunk-UDAKAE4Z.cjs');
+var chunk3HA7N2BB_cjs = require('./chunk-3HA7N2BB.cjs');
 var chunkAA27GEYS_cjs = require('./chunk-AA27GEYS.cjs');
 var chunkYSTXFWQE_cjs = require('./chunk-YSTXFWQE.cjs');
-var chunkJW3GVLM6_cjs = require('./chunk-JW3GVLM6.cjs');
+var chunkH7HD6RXO_cjs = require('./chunk-H7HD6RXO.cjs');
 var chunkNINIJCHU_cjs = require('./chunk-NINIJCHU.cjs');
-var chunkHG5LKFG7_cjs = require('./chunk-HG5LKFG7.cjs');
+var chunk7WARNHWW_cjs = require('./chunk-7WARNHWW.cjs');
 var chunkIJ7M6GOG_cjs = require('./chunk-IJ7M6GOG.cjs');
-var chunkGM54F4FE_cjs = require('./chunk-GM54F4FE.cjs');
+var chunk3KIUY67P_cjs = require('./chunk-3KIUY67P.cjs');
 var chunkSA6K24NB_cjs = require('./chunk-SA6K24NB.cjs');
-var chunkIIYJMXYW_cjs = require('./chunk-IIYJMXYW.cjs');
-var chunkZWACQM5U_cjs = require('./chunk-ZWACQM5U.cjs');
-var chunkASK2OQM5_cjs = require('./chunk-ASK2OQM5.cjs');
+var chunk27V5I2WW_cjs = require('./chunk-27V5I2WW.cjs');
+var chunk3WKWBYPO_cjs = require('./chunk-3WKWBYPO.cjs');
+var chunkG7XBVM3T_cjs = require('./chunk-G7XBVM3T.cjs');
 var chunkZF2LDKQQ_cjs = require('./chunk-ZF2LDKQQ.cjs');
-var chunkJLRLCBJ4_cjs = require('./chunk-JLRLCBJ4.cjs');
-var chunkC7GKRGKN_cjs = require('./chunk-C7GKRGKN.cjs');
-var chunkTY56BKSK_cjs = require('./chunk-TY56BKSK.cjs');
-var chunkMPR2ISL2_cjs = require('./chunk-MPR2ISL2.cjs');
-var chunkJ5623RIV_cjs = require('./chunk-J5623RIV.cjs');
-var chunkNWS2CS3Y_cjs = require('./chunk-NWS2CS3Y.cjs');
+var chunkZOFRNNZD_cjs = require('./chunk-ZOFRNNZD.cjs');
+var chunkWDVG5R2Q_cjs = require('./chunk-WDVG5R2Q.cjs');
+var chunkYQ3XC6C2_cjs = require('./chunk-YQ3XC6C2.cjs');
+var chunk6XQLTQB6_cjs = require('./chunk-6XQLTQB6.cjs');
+var chunkKX5QXLBS_cjs = require('./chunk-KX5QXLBS.cjs');
+var chunkNWWTYBD3_cjs = require('./chunk-NWWTYBD3.cjs');
 var chunk3EE6LVWT_cjs = require('./chunk-3EE6LVWT.cjs');
-var chunkSGC7LSHF_cjs = require('./chunk-SGC7LSHF.cjs');
-var chunkHU666T3Q_cjs = require('./chunk-HU666T3Q.cjs');
+var chunkLO6LIUZ6_cjs = require('./chunk-LO6LIUZ6.cjs');
+var chunkS46WJTDL_cjs = require('./chunk-S46WJTDL.cjs');
 var chunkNVXXWAU7_cjs = require('./chunk-NVXXWAU7.cjs');
 var chunkEHD25JBZ_cjs = require('./chunk-EHD25JBZ.cjs');
-var chunkUNFBHV46_cjs = require('./chunk-UNFBHV46.cjs');
-var chunk6LHQPOMI_cjs = require('./chunk-6LHQPOMI.cjs');
+var chunkCEGU5AVD_cjs = require('./chunk-CEGU5AVD.cjs');
+var chunkRNXXYF22_cjs = require('./chunk-RNXXYF22.cjs');
 var promises = require('fs/promises');
 var crypto = require('crypto');
 var path = require('path');
@@ -164,7 +164,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-YHTWG5DB.cjs');
+  const { generateObjectImpl, GenerateObjectError } = await import('./generate-object-XBWD2PU7.cjs');
   const answer = structurableAnswerOrThrow(result, GenerateObjectError);
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
   const facade = getAgentFacade();
@@ -248,18 +248,59 @@ function isLocalAgentId(id) {
   return id.startsWith(PREFIX.localAgent);
 }
 
+// src/internal/runtime/lifecycle/throw-on-error-run.ts
+var innerRuns = /* @__PURE__ */ new WeakMap();
+function wrapRunWithThrowOnError(run) {
+  let settled;
+  const rejectingWait = () => {
+    settled ??= run.wait().then(rejectOnTypedFailure);
+    return settled;
+  };
+  const view = new Proxy(run, {
+    get(target, prop, receiver) {
+      if (prop === "wait") return rejectingWait;
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+  innerRuns.set(view, run);
+  return view;
+}
+function readRunResolving(run) {
+  return (innerRuns.get(run) ?? run).wait();
+}
+function rejectOnTypedFailure(result) {
+  const cause = result.status === "error" ? result.error?.cause : void 0;
+  if (cause !== void 0) throw cause;
+  return result;
+}
+
 // src/internal/runtime/model-selection.ts
 function normalizeModel(m) {
-  if (m === void 0 || typeof m !== "string") return m;
+  if (m === void 0) return m;
+  if (typeof m !== "string") {
+    refuseEmptyThinkingParam(m);
+    return m;
+  }
   const id = m.trim();
   if (id.length === 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       'model must be a non-empty "provider/model" id string or a ModelSelection object',
       { code: "invalid_model_selection" }
     );
   }
   return { id };
 }
+function refuseEmptyThinkingParam(selection) {
+  for (const param of selection.params ?? []) {
+    const value = param.value;
+    if (param.id === "thinking" && (typeof value !== "string" || value.trim().length === 0)) {
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
+        'model.params "thinking" needs a non-empty reasoning effort (for example "low" or "high"); leave the param out to request no reasoning',
+        { code: "invalid_model_param" }
+      );
+    }
+  }
+}
 
 // src/internal/plugins/enabled-names.ts
 function isPluginArray(plugins) {
@@ -389,11 +430,11 @@ function serializeAgents(agents2) {
   return out;
 }
 function registryPath(cwd) {
-  return path.join(chunkTY56BKSK_cjs.theokitConfigRoot(cwd), REGISTRY_RELATIVE_SUFFIX);
+  return path.join(chunkYQ3XC6C2_cjs.theokitConfigRoot(cwd), REGISTRY_RELATIVE_SUFFIX);
 }
 async function loadRegistry(cwd) {
-  void chunkJLRLCBJ4_cjs.sweepStaleAtomicTemps(registryPath(cwd)).catch(() => void 0);
-  return chunkRQMCOFAI_cjs.readVersionedJson({
+  void chunkZOFRNNZD_cjs.sweepStaleAtomicTemps(registryPath(cwd)).catch(() => void 0);
+  return chunk3HA7N2BB_cjs.readVersionedJson({
     path: registryPath(cwd),
     currentVersion: SCHEMA_VERSION,
     defaultValue: () => ({}),
@@ -417,7 +458,7 @@ async function saveRegistry(cwd, agents2) {
   }
   const path = registryPath(cwd);
   await chunkZF2LDKQQ_cjs.withCwdMutex(`registry:${cwd}`, async () => {
-    await chunkRQMCOFAI_cjs.writeVersionedJson(path, serialized, SCHEMA_VERSION);
+    await chunk3HA7N2BB_cjs.writeVersionedJson(path, serialized, SCHEMA_VERSION);
   });
 }
 function toSerialized(agent) {
@@ -484,7 +525,7 @@ function scheduleSaveForCwd(cwd) {
       }
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      chunk6LHQPOMI_cjs.diag(`[theokit-sdk] registry persist failed (${cwd}): ${msg}
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] registry persist failed (${cwd}): ${msg}
 `);
     } finally {
       pendingSaves.delete(cwd);
@@ -824,14 +865,14 @@ async function readLegacyFacts(jsonPath) {
 }
 async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
-    for (const fact of facts) await chunkZD66GFH5_cjs.appendFactToMarkdown(cwd, fact);
+    for (const fact of facts) await chunkSDZ4XDWS_cjs.appendFactToMarkdown(cwd, fact);
     await promises.unlink(jsonPath).catch(() => void 0);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
+    chunkRNXXYF22_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);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] memory migration failed (readonly fs?): ${message}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] memory migration failed (readonly fs?): ${message}
 `);
     return { migrated: false, factCount: 0, reason: "readonly-fs" };
   }
@@ -841,12 +882,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 = chunkZD66GFH5_cjs.legacyMemoryJsonPath(cwd, config);
+  const jsonPath = chunkSDZ4XDWS_cjs.legacyMemoryJsonPath(cwd, config);
   if (!await fileExists(jsonPath)) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
-  if (await fileExists(chunkZD66GFH5_cjs.memoryMdPath(chunkZD66GFH5_cjs.resolveMemoryRoot(cwd, config)))) {
-    chunk6LHQPOMI_cjs.diag(
+  if (await fileExists(chunkSDZ4XDWS_cjs.memoryMdPath(chunkSDZ4XDWS_cjs.resolveMemoryRoot(cwd, config)))) {
+    chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
     );
@@ -874,29 +915,29 @@ function unstoredRememberWarning(message) {
   if (isMemoryWritePrompt(message) && extractMemoryFact(message).length > 0) return void 0;
   const trimmed = message.trim();
   const quoted = trimmed.length > QUOTED_MESSAGE_MAX ? `${trimmed.slice(0, QUOTED_MESSAGE_MAX)}\u2026` : trimmed;
-  return `[theokit-sdk] NOTHING WAS STORED \u2014 this message does not match the memory capture pattern: ${JSON.stringify(quoted)}. Supported: "Remember: <fact>" or "Remember (${chunkZD66GFH5_cjs.MEMORY_KINDS.join("|")}): <fact>". It still reaches the session transcript, so a follow-up may answer from it \u2014 that is search over transcripts, not a durable memory.`;
+  return `[theokit-sdk] NOTHING WAS STORED \u2014 this message does not match the memory capture pattern: ${JSON.stringify(quoted)}. Supported: "Remember: <fact>" or "Remember (${chunkSDZ4XDWS_cjs.MEMORY_KINDS.join("|")}): <fact>". It still reaches the session transcript, so a follow-up may answer from it \u2014 that is search over transcripts, not a durable memory.`;
 }
 function extractMemoryKind(message) {
   const match = REMEMBER_PATTERN.exec(message);
   const declared = match?.[1];
   if (declared === void 0) return void 0;
   const lowered = declared.toLowerCase();
-  return chunkZD66GFH5_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
+  return chunkSDZ4XDWS_cjs.MEMORY_KINDS.includes(lowered) ? lowered : void 0;
 }
 async function readMemoryFacts(cwd, config) {
   if (!config.enabled) return [];
   await migrateLegacyJson(cwd, config);
-  return chunkZD66GFH5_cjs.readFacts(cwd, config);
+  return chunkSDZ4XDWS_cjs.readFacts(cwd, config);
 }
 async function appendMemoryFact(cwd, config, fact) {
   if (!config.enabled) return;
-  chunkZD66GFH5_cjs.resolveMaxFacts(config.maxFacts);
+  chunkSDZ4XDWS_cjs.resolveMaxFacts(config.maxFacts);
   await migrateLegacyJson(cwd, config);
   const sanitized = {
-    text: chunk6LHQPOMI_cjs.redactSecrets(fact.text),
+    text: chunkRNXXYF22_cjs.redactSecrets(fact.text),
     ...fact.kind === void 0 ? {} : { kind: fact.kind }
   };
-  await chunkZD66GFH5_cjs.appendFact(cwd, config, sanitized);
+  await chunkSDZ4XDWS_cjs.appendFact(cwd, config, sanitized);
 }
 
 // src/internal/runtime/fixtures/fixture-scripts.ts
@@ -1244,7 +1285,7 @@ function redactScriptSecrets(script) {
 function redactEventSecrets(event) {
   const serialized = JSON.stringify(event);
   const localStripped = serialized.replace(FIXTURE_SENTINEL, "***");
-  const redacted = chunk6LHQPOMI_cjs.redactSecrets(localStripped);
+  const redacted = chunkRNXXYF22_cjs.redactSecrets(localStripped);
   if (redacted === serialized) return event;
   return JSON.parse(redacted);
 }
@@ -1253,6 +1294,21 @@ function applyExtraRunFields(base, script) {
   return { ...base, ...script.extraRunFields };
 }
 
+// src/internal/runtime/typed-run-error.ts
+function toTypedRunErrorDetail(detail) {
+  if (detail === void 0) return void 0;
+  if (hasTypedCause(detail)) return detail;
+  const { cause } = detail;
+  const wrapped = new chunkCEGU5AVD_cjs.UnknownAgentError(detail.message, {
+    ...detail.code !== void 0 ? { code: detail.code } : {},
+    ...cause !== void 0 ? { cause } : {}
+  });
+  return { ...detail, cause: wrapped };
+}
+function hasTypedCause(detail) {
+  return detail.cause instanceof chunkCEGU5AVD_cjs.TheokitAgentError;
+}
+
 // src/internal/runtime/fixtures/fixture-run-base.ts
 function prepareRunContext(message) {
   const userText = typeof message === "string" ? message : message.text;
@@ -1439,7 +1495,7 @@ var FixtureRunBase = class {
       base.result = this.script.result;
     }
     if (status === "error" && this.script.errorDetail !== void 0) {
-      base.error = this.script.errorDetail;
+      base.error = toTypedRunErrorDetail(this.script.errorDetail);
     }
     applyScriptMetrics(base, this.script);
     return this.extendRunResult(applyExtraRunFields(base, this.script));
@@ -1566,8 +1622,8 @@ function createRealCloudRun(options) {
     cancellable: false,
     conversation: []
   };
-  const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(options.agentOptions.apiKey);
-  const baseUrl = chunkBZKF7TXX_cjs.getConfiguredBaseUrl();
+  const apiKey = chunkRNXXYF22_cjs.resolveApiKey(options.agentOptions.apiKey);
+  const baseUrl = chunkLSWHDOCL_cjs.getConfiguredBaseUrl();
   const handle = new RealCloudRun(
     {
       id,
@@ -1640,7 +1696,7 @@ var RealCloudRun = class extends FixtureRunBase {
     });
     if (!response.ok) {
       const text = await response.text().catch(() => "");
-      throw new chunkUNFBHV46_cjs.NetworkError(
+      throw new chunkCEGU5AVD_cjs.NetworkError(
         `Cloud Run endpoint returned ${response.status}: ${text.slice(0, 200)}`,
         { code: "cloud_run_http_error" }
       );
@@ -1650,7 +1706,7 @@ var RealCloudRun = class extends FixtureRunBase {
   async consumeStream(response) {
     let finalStatus = "finished";
     let finalText = "";
-    for await (const record of chunkBZKF7TXX_cjs.parseSseStream(response.body, this.controller.signal)) {
+    for await (const record of chunkLSWHDOCL_cjs.parseSseStream(response.body, this.controller.signal)) {
       const parsed = safeParse(record.data);
       if (parsed === void 0) continue;
       const update = this.applyRecord(record.event, parsed);
@@ -1730,7 +1786,7 @@ function toWireStatus(token) {
     const match = WIRE_STATUSES.find((candidate) => candidate === upper);
     if (match !== void 0) return match;
   }
-  throw new chunkUNFBHV46_cjs.NetworkError(
+  throw new chunkCEGU5AVD_cjs.NetworkError(
     `Cloud Run stream reported an unrecognised status ${JSON.stringify(token)}; expected one of ${WIRE_STATUSES.join(", ")} (case-insensitive)`,
     { code: "cloud_run_unknown_status" }
   );
@@ -1740,7 +1796,7 @@ function toRunStatus(token) {
     const mapped = SERVER_STATUS_TO_RUN_STATUS[token.toLowerCase()];
     if (mapped !== void 0) return mapped;
   }
-  throw new chunkUNFBHV46_cjs.NetworkError(
+  throw new chunkCEGU5AVD_cjs.NetworkError(
     `Cloud Run stream reported an unrecognised status ${JSON.stringify(token)}; expected one of ${Object.keys(SERVER_STATUS_TO_RUN_STATUS).join(", ")} (case-insensitive)`,
     { code: "cloud_run_unknown_status" }
   );
@@ -1816,8 +1872,8 @@ var CloudAgent = class _CloudAgent {
    * cloud operations are pre-release and must surface explicit errors.
    */
   isFixtureMode() {
-    const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(this.options.apiKey);
-    return chunkBZKF7TXX_cjs.isFixtureApiKey(apiKey) && chunkBZKF7TXX_cjs.getConfiguredBaseUrl() === void 0;
+    const apiKey = chunkRNXXYF22_cjs.resolveApiKey(this.options.apiKey);
+    return chunkLSWHDOCL_cjs.isFixtureApiKey(apiKey) && chunkLSWHDOCL_cjs.getConfiguredBaseUrl() === void 0;
   }
   // SE9 — integrated structured output; delegates to the shared helper.
   generate(message, options) {
@@ -1831,9 +1887,9 @@ var CloudAgent = class _CloudAgent {
     );
   }
   async send(message, options = {}) {
-    if (this.disposed) throw new chunkUNFBHV46_cjs.AgentDisposedError(this.agentId);
+    if (this.disposed) throw new chunkCEGU5AVD_cjs.AgentDisposedError(this.agentId);
     if (options.tools !== void 0 && options.tools.length > 0) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         "Custom inline tools are local-only in SDK v1.0 \u2014 cloud agents cannot serialize handler functions",
         { code: "cloud_custom_tools_rejected" }
       );
@@ -1851,10 +1907,13 @@ var CloudAgent = class _CloudAgent {
           reject(err);
           return;
         }
-        resolve(run);
+        resolve(this.options.throwOnError === true ? wrapRunWithThrowOnError(run) : run);
         const mutexTimeoutMs = Number(process.env.THEOKIT_CLOUD_SEND_MUTEX_TIMEOUT_MS) || 3e5;
         try {
-          await Promise.race([run.wait(), new Promise((r) => setTimeout(r, mutexTimeoutMs))]);
+          await Promise.race([
+            readRunResolving(run),
+            new Promise((r) => setTimeout(r, mutexTimeoutMs))
+          ]);
         } catch {
         }
       });
@@ -1868,8 +1927,8 @@ var CloudAgent = class _CloudAgent {
     }
     const userText = typeof message === "string" ? message : message.text;
     const systemPrompt = await this.resolveSystemPromptForSend(userText, options);
-    const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(this.options.apiKey);
-    const useRealRuntime = apiKey !== void 0 && !chunkBZKF7TXX_cjs.isFixtureApiKey(apiKey) && chunkBZKF7TXX_cjs.getConfiguredBaseUrl() !== void 0;
+    const apiKey = chunkRNXXYF22_cjs.resolveApiKey(this.options.apiKey);
+    const useRealRuntime = apiKey !== void 0 && !chunkLSWHDOCL_cjs.isFixtureApiKey(apiKey) && chunkLSWHDOCL_cjs.getConfiguredBaseUrl() !== void 0;
     return useRealRuntime ? createRealCloudRun({
       agentId: this.agentId,
       model: this.model ?? { id: DEFAULT_AGENTIC_MODEL_ID },
@@ -1918,7 +1977,7 @@ var CloudAgent = class _CloudAgent {
   listArtifacts() {
     if (!this.isFixtureMode()) {
       return Promise.reject(
-        new chunkUNFBHV46_cjs.ConfigurationError(
+        new chunkCEGU5AVD_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" }
         )
@@ -1928,11 +1987,11 @@ var CloudAgent = class _CloudAgent {
   }
   downloadArtifact(path) {
     try {
-      chunkGM54F4FE_cjs.validateArtifactPath(path);
+      chunk3KIUY67P_cjs.validateArtifactPath(path);
     } catch (cause) {
-      if (cause instanceof chunkGM54F4FE_cjs.PathTraversalError) {
+      if (cause instanceof chunk3KIUY67P_cjs.PathTraversalError) {
         return Promise.reject(
-          new chunkUNFBHV46_cjs.ConfigurationError(`Artifact path must stay inside the workspace: ${path}`, {
+          new chunkCEGU5AVD_cjs.ConfigurationError(`Artifact path must stay inside the workspace: ${path}`, {
             code: "artifact_path_traversal",
             cause
           })
@@ -1942,7 +2001,7 @@ var CloudAgent = class _CloudAgent {
     }
     if (!this.isFixtureMode()) {
       return Promise.reject(
-        new chunkUNFBHV46_cjs.ConfigurationError(
+        new chunkCEGU5AVD_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" }
         )
@@ -1951,7 +2010,7 @@ var CloudAgent = class _CloudAgent {
     const match = buildFixtureArtifacts().find((artifact) => artifact.path === path);
     if (match === void 0) {
       return Promise.reject(
-        new chunkUNFBHV46_cjs.UnknownAgentError(`Artifact ${path} not found`, { code: "unknown_artifact" })
+        new chunkCEGU5AVD_cjs.UnknownAgentError(`Artifact ${path} not found`, { code: "unknown_artifact" })
       );
     }
     return Promise.resolve(Buffer.from(`fixture artifact content for ${path}
@@ -1965,7 +2024,7 @@ var CloudAgent = class _CloudAgent {
    * @public
    */
   runUntil() {
-    throw new chunkUNFBHV46_cjs.UnsupportedRunOperationError(
+    throw new chunkCEGU5AVD_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"
     );
@@ -1976,7 +2035,7 @@ var CloudAgent = class _CloudAgent {
    * @public
    */
   fork() {
-    throw new chunkUNFBHV46_cjs.UnsupportedRunOperationError(
+    throw new chunkCEGU5AVD_cjs.UnsupportedRunOperationError(
       "Agent.fork() is not supported on cloud agents. Fork inheritance requires local credential + system-prompt access. Use a local agent.",
       "fork"
     );
@@ -1988,7 +2047,7 @@ var CloudAgent = class _CloudAgent {
    * @public
    */
   runToCompletion() {
-    throw new chunkUNFBHV46_cjs.UnsupportedRunOperationError(
+    throw new chunkCEGU5AVD_cjs.UnsupportedRunOperationError(
       "Agent.runToCompletion() is not supported on cloud agents. Cloud runtime manages continuation server-side. Use a local agent.",
       "runToCompletion"
     );
@@ -2000,7 +2059,7 @@ var CloudAgent = class _CloudAgent {
    * @public
    */
   streamToCompletion() {
-    throw new chunkUNFBHV46_cjs.UnsupportedRunOperationError(
+    throw new chunkCEGU5AVD_cjs.UnsupportedRunOperationError(
       "Agent.streamToCompletion() is not supported on cloud agents. Cloud runtime manages continuation server-side. Use a local agent.",
       "streamToCompletion"
     );
@@ -2014,7 +2073,7 @@ var CloudAgent = class _CloudAgent {
    */
   usePersonality() {
     return Promise.reject(
-      new chunkUNFBHV46_cjs.UnsupportedRunOperationError(
+      new chunkCEGU5AVD_cjs.UnsupportedRunOperationError(
         "Agent.usePersonality() is not supported on cloud agents (pre-release). Use a local agent or wait for cloud GA.",
         "usePersonality"
       )
@@ -2042,7 +2101,7 @@ function validateCloudToolParity(options) {
 function rejectProcessors(options) {
   const hasProcessors = (options.inputProcessors?.length ?? 0) > 0 || (options.outputProcessors?.length ?? 0) > 0;
   if (hasProcessors) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_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" }
     );
@@ -2050,7 +2109,7 @@ function rejectProcessors(options) {
 }
 function rejectFunctionSystemPrompt(options) {
   if (typeof options.systemPrompt === "function") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_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" }
     );
@@ -2058,7 +2117,7 @@ function rejectFunctionSystemPrompt(options) {
 }
 function rejectFunctionSkills(options) {
   if (typeof options.skills === "function") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_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" }
     );
@@ -2070,7 +2129,7 @@ function rejectStdioMcpLocalPaths(options) {
     if (!isStdioCommandConfig(config)) continue;
     const command = config.command ?? "";
     if (isLocalPath(command)) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_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" }
       );
@@ -2090,19 +2149,19 @@ function isLocalPath(command) {
 function resolveSessionDir(local) {
   if (local?.sessionDir !== void 0) {
     if (local.baseDir !== void 0) {
-      chunk6LHQPOMI_cjs.diag(
+      chunkRNXXYF22_cjs.diag(
         "[theokit-sdk] local.sessionDir and local.baseDir are both set; using sessionDir. baseDir is the deprecated name for the same option (#301)."
       );
     }
-    return chunkZWACQM5U_cjs.expandTilde(local.sessionDir);
+    return chunk3WKWBYPO_cjs.expandTilde(local.sessionDir);
   }
   if (local?.baseDir !== void 0) {
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       "[theokit-sdk] local.baseDir is deprecated; rename it to local.sessionDir (#301). It is the directory for session transcripts, not the working directory \u2014 that is local.cwd."
     );
-    return chunkZWACQM5U_cjs.expandTilde(local.baseDir);
+    return chunk3WKWBYPO_cjs.expandTilde(local.baseDir);
   }
-  return chunkZWACQM5U_cjs.defaultBaseDir();
+  return chunk3WKWBYPO_cjs.defaultBaseDir();
 }
 var SCHEMA_VERSION2 = 1;
 var FILE_NAME = "personality.json";
@@ -2129,14 +2188,14 @@ async function readState(filePath) {
   try {
     parsed = JSON.parse(raw);
   } catch {
-    chunkN6OEX5TN_cjs.warnOnce(
+    chunkUDAKAE4Z_cjs.warnOnce(
       "personality-store-json-parse",
       "[theokit-sdk] personality.json is malformed; treating as empty"
     );
     return emptyState();
   }
   if (!isStateV1(parsed)) {
-    chunkN6OEX5TN_cjs.warnOnce(
+    chunkUDAKAE4Z_cjs.warnOnce(
       "personality-store-bad-version",
       `[theokit-sdk] personality.json has unknown version; treating as empty (file kept untouched)`
     );
@@ -2167,9 +2226,9 @@ var PersonalityStore = class {
       try {
         await this.#persist(agentId, slug);
       } catch (err) {
-        chunkN6OEX5TN_cjs.warnOnce(
+        chunkUDAKAE4Z_cjs.warnOnce(
           `personality-store-persist-failure-${agentId}`,
-          `[theokit-sdk] personality persist failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
+          `[theokit-sdk] personality persist failed for ${chunkRNXXYF22_cjs.redactSecrets(agentId)}: ${chunkRNXXYF22_cjs.redactSecrets(
             err.message
           )}`
         );
@@ -2184,9 +2243,9 @@ var PersonalityStore = class {
     try {
       state = await readState(filePath);
     } catch (err) {
-      chunkN6OEX5TN_cjs.warnOnce(
+      chunkUDAKAE4Z_cjs.warnOnce(
         `personality-store-hydrate-failure-${agentId}`,
-        `[theokit-sdk] personality hydrate failed for ${chunk6LHQPOMI_cjs.redactSecrets(agentId)}: ${chunk6LHQPOMI_cjs.redactSecrets(
+        `[theokit-sdk] personality hydrate failed for ${chunkRNXXYF22_cjs.redactSecrets(agentId)}: ${chunkRNXXYF22_cjs.redactSecrets(
           err.message
         )}`
       );
@@ -2203,17 +2262,17 @@ var PersonalityStore = class {
   async #persist(agentId, slug) {
     const filePath = this.#filePath();
     await promises.mkdir(path.dirname(filePath), { recursive: true });
-    await chunkASK2OQM5_cjs.withFileLock(filePath, async () => {
+    await chunkG7XBVM3T_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 chunkJLRLCBJ4_cjs.atomicWriteJson(filePath, next);
+      await chunkZOFRNNZD_cjs.atomicWriteJson(filePath, next);
     });
   }
   #filePath() {
-    return path.join(chunkTY56BKSK_cjs.getTheokitHome(this.#cwd), FILE_NAME);
+    return path.join(chunkYQ3XC6C2_cjs.getTheokitHome(this.#cwd), FILE_NAME);
   }
 };
 
@@ -2248,7 +2307,7 @@ function createPluginContext() {
     },
     on(hook, handler) {
       if (typeof handler !== "function") {
-        chunk6LHQPOMI_cjs.diag(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
+        chunkRNXXYF22_cjs.diag(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
 `);
         return () => void 0;
       }
@@ -2302,7 +2361,7 @@ var PluginManager = class {
     const seen = /* @__PURE__ */ new Set();
     for (const plugin of plugins) {
       if (seen.has(plugin.name)) {
-        chunk6LHQPOMI_cjs.diag(
+        chunkRNXXYF22_cjs.diag(
           `[theokit-sdk] duplicate plugin name "${plugin.name}" \u2014 both will register independently
 `
         );
@@ -2329,7 +2388,7 @@ var PluginManager = class {
    */
   async register(plugin) {
     if (plugin.kind !== "general") {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         `late register supports general plugins only (got "${plugin.kind}" for "${plugin.name}")`,
         { code: "plugin_late_register_kind" }
       );
@@ -2386,7 +2445,7 @@ var PluginManager = class {
           parts.push(result.recalledContext);
         }
       } catch (err) {
-        chunk6LHQPOMI_cjs.diag(
+        chunkRNXXYF22_cjs.diag(
           `[theokit-sdk] pre_user_send hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2414,7 +2473,7 @@ var PluginManager = class {
       try {
         await h(ctx);
       } catch (err) {
-        chunk6LHQPOMI_cjs.diag(
+        chunkRNXXYF22_cjs.diag(
           `[theokit-sdk] post_assistant_reply hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2430,7 +2489,7 @@ var PluginManager = class {
       try {
         await h(ctx);
       } catch (err) {
-        chunk6LHQPOMI_cjs.diag(
+        chunkRNXXYF22_cjs.diag(
           `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2445,7 +2504,7 @@ var PluginManager = class {
         const out = await h(current, ctx);
         if (out !== void 0) current = out;
       } catch (err) {
-        chunk6LHQPOMI_cjs.diag(
+        chunkRNXXYF22_cjs.diag(
           `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2530,7 +2589,7 @@ function removeAll(arr, toRemove) {
   }
 }
 function readCompatConfigFile(cwd) {
-  const path$1 = path.join(chunkTY56BKSK_cjs.theokitConfigRoot(cwd), "config.json");
+  const path$1 = path.join(chunkYQ3XC6C2_cjs.theokitConfigRoot(cwd), "config.json");
   if (!fs.existsSync(path$1)) return [];
   let raw;
   try {
@@ -2542,7 +2601,7 @@ function readCompatConfigFile(cwd) {
   try {
     parsed = JSON.parse(raw);
   } catch (cause) {
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit] ${path$1} is not valid JSON \u2014 ignoring its "compat.adapters" (${cause.message}).
 `
     );
@@ -2551,7 +2610,7 @@ function readCompatConfigFile(cwd) {
   const adapters = parsed.compat?.adapters;
   if (adapters === void 0) return [];
   if (!Array.isArray(adapters)) {
-    chunk6LHQPOMI_cjs.diag(`[theokit] ${path$1}: "compat.adapters" must be an array \u2014 ignoring it.
+    chunkRNXXYF22_cjs.diag(`[theokit] ${path$1}: "compat.adapters" must be an array \u2014 ignoring it.
 `);
     return [];
   }
@@ -2593,7 +2652,7 @@ function readPolicyDocument(path) {
   try {
     raw = fs.readFileSync(path, "utf8");
   } catch (cause) {
-    chunk6LHQPOMI_cjs.diagFailure(
+    chunkRNXXYF22_cjs.diagFailure(
       `[theokit-sdk] ${path} exists and could not be read (${cause.message}) \u2014 NO operator policy is being applied. Fix the permissions or remove the file.
 `
     );
@@ -2603,14 +2662,14 @@ function readPolicyDocument(path) {
   try {
     parsed = JSON.parse(raw);
   } catch (cause) {
-    chunk6LHQPOMI_cjs.diagFailure(
+    chunkRNXXYF22_cjs.diagFailure(
       `[theokit-sdk] ${path} is not valid JSON (${cause.message}) \u2014 NO operator policy is being applied.
 `
     );
     return void 0;
   }
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    chunk6LHQPOMI_cjs.diagFailure(
+    chunkRNXXYF22_cjs.diagFailure(
       `[theokit-sdk] ${path} is not a JSON object \u2014 NO operator policy is being applied.
 `
     );
@@ -2640,7 +2699,7 @@ function applyPolicyKey(out, key, value, path) {
   if (key === "disableSkillShellExecution") out.disableSkillShellExecution = flag;
 }
 function decline(path, key, reason) {
-  chunk6LHQPOMI_cjs.diagFailure(`[theokit-sdk] ${path} declares "${key}" \u2014 ${reason}. It is NOT being applied.
+  chunkRNXXYF22_cjs.diagFailure(`[theokit-sdk] ${path} declares "${key}" \u2014 ${reason}. It is NOT being applied.
 `);
 }
 function readMode(value, path) {
@@ -2733,7 +2792,7 @@ var HooksExecutor = class {
   config = {};
   async initialize(settingSourcesIncludeProject) {
     if (readManagedSettings(this.policy.managedSettingsRoot).disableAllHooks === true) {
-      chunkN6OEX5TN_cjs.warnFailureOnce(
+      chunkUDAKAE4Z_cjs.warnFailureOnce(
         "hooks-disabled-by-policy",
         "[theokit-sdk] hooks: an operator policy (managed-settings.json) declares disableAllHooks \u2014 NO hook will run, including any this project declared."
       );
@@ -2744,7 +2803,7 @@ var HooksExecutor = class {
       this.config = {};
       return;
     }
-    this.config = await chunkN6OEX5TN_cjs.loadHookConfig(this.cwd, this.compatSources);
+    this.config = await chunkUDAKAE4Z_cjs.loadHookConfig(this.cwd, this.compatSources);
   }
   /** Fire every hook registered for `event` and aggregate the decisions. */
   async run(payload) {
@@ -2839,7 +2898,7 @@ var HooksExecutor = class {
     if (result.exitCode === 0) return void 0;
     const stderr = result.stderr.trim();
     const base = stderr.length > 0 ? stderr : `Hook exited with code ${result.exitCode}`;
-    const missing = chunkTY56BKSK_cjs.undefinedVariablesIn(command.command, env);
+    const missing = chunkYQ3XC6C2_cjs.undefinedVariablesIn(command.command, env);
     if (missing.length === 0) return { decision: "deny", reason: base };
     return {
       decision: "deny",
@@ -2859,7 +2918,7 @@ function stdinPayloadFor(payload, command, cwd) {
 }
 function runtimeEnvFor(sourcePath, cwd) {
   if (sourcePath === void 0) return {};
-  return chunkTY56BKSK_cjs.adapterForConfigPath(sourcePath)?.runtimeEnv(cwd) ?? {};
+  return chunkYQ3XC6C2_cjs.adapterForConfigPath(sourcePath)?.runtimeEnv(cwd) ?? {};
 }
 function parseDecisionFromStdout(stdout) {
   const trimmed = stdout.trim();
@@ -2907,11 +2966,11 @@ function sessionTranscriptAllowed(memory) {
 }
 function resolveWindowForRun(model, contextWindow) {
   const override = contextWindow !== void 0 && contextWindow > 0 ? contextWindow : void 0;
-  return chunkJ5623RIV_cjs.resolveEffectiveContextWindow({
+  return chunkKX5QXLBS_cjs.resolveEffectiveContextWindow({
     ...override !== void 0 ? { override } : {},
-    catalog: chunkHU666T3Q_cjs.getCatalogModelInfo(model)?.limit?.context,
-    margin: chunkJ5623RIV_cjs.CONTEXT_WINDOW_MARGIN,
-    floor: chunkJ5623RIV_cjs.CONTEXT_WINDOW_FLOOR
+    catalog: chunkS46WJTDL_cjs.getCatalogModelInfo(model)?.limit?.context,
+    margin: chunkKX5QXLBS_cjs.CONTEXT_WINDOW_MARGIN,
+    floor: chunkKX5QXLBS_cjs.CONTEXT_WINDOW_FLOOR
   });
 }
 async function runPostRunLifecycle(inputs) {
@@ -2929,37 +2988,37 @@ async function runPostRunLifecycle(inputs) {
   } = inputs;
   let result;
   try {
-    result = await run.wait();
+    result = await readRunResolving(run);
   } catch {
     try {
       const partial = await safeConversation(run);
       if (partial !== void 0) {
-        chunkN7ZIPW2N_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+        chunkYOVZMN4P_cjs.persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
           userText,
           conversation: partial
         });
       }
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      chunk6LHQPOMI_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
-    await chunkN7ZIPW2N_cjs.flushSessionWrites();
+    await chunkYOVZMN4P_cjs.flushSessionWrites();
     return;
   }
   if (result.result !== void 0) {
-    chunkN7ZIPW2N_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
+    chunkYOVZMN4P_cjs.appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
   const resolvedWindow = resolveWindowForRun(model, contextWindow);
   const effectiveWindow = resolvedWindow.window;
   const budgetEvent = buildContextBudgetEvent(model, resolvedWindow);
   if (budgetEvent !== void 0 && onRunEvent !== void 0) {
-    chunkJ6GXS5A2_cjs.emitRunEvent(onRunEvent, budgetEvent);
+    chunkL7JPXZ2C_cjs.emitRunEvent(onRunEvent, budgetEvent);
   }
   const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
   const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
-  chunkN7ZIPW2N_cjs.persistTurnToTranscript(
+  chunkYOVZMN4P_cjs.persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
     agentId,
@@ -2971,20 +3030,20 @@ async function runPostRunLifecycle(inputs) {
         // The EFFECTIVE window (after override, clamp and margin) — not the declared one. Swapping for
         // `contextWindow` here would budget against a number the clamp already rejected.
         contextWindow: effectiveWindow,
-        summarize: chunkBZKF7TXX_cjs.buildDefaultSummarizer({
+        summarize: chunkLSWHDOCL_cjs.buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
       }
     },
-    onRunEvent !== void 0 ? () => chunkJ6GXS5A2_cjs.emitRunEvent(onRunEvent, { type: "compact_boundary", trigger: "auto" }) : void 0
+    onRunEvent !== void 0 ? () => chunkL7JPXZ2C_cjs.emitRunEvent(onRunEvent, { type: "compact_boundary", trigger: "auto" }) : void 0
   );
   if (result.status === "finished" && result.result !== void 0 && sessionTranscriptAllowed(inputs.memory)) {
     const summaryArgs = {
       cwd: workspaceCwd,
       // Resolved once, here, and handed to both writers. Recomputing it inside either one is how
       // the summary ended up in a directory the indexer never scanned (#463).
-      memoryRoot: chunkZD66GFH5_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
+      memoryRoot: chunkSDZ4XDWS_cjs.resolveMemoryRoot(workspaceCwd, inputs.memory),
       runId: result.id,
       agentId,
       userText,
@@ -2996,11 +3055,11 @@ async function runPostRunLifecycle(inputs) {
       if (memoryProvider?.recordSessionSummary !== void 0) {
         await memoryProvider.recordSessionSummary(summaryArgs);
       } else {
-        await chunkZD66GFH5_cjs.writeSessionSummary(summaryArgs);
+        await chunkSDZ4XDWS_cjs.writeSessionSummary(summaryArgs);
       }
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunk6LHQPOMI_cjs.diag(`[theokit-sdk] session summary write failed (${result.id}): ${message}
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] session summary write failed (${result.id}): ${message}
 `);
     }
   }
@@ -3013,14 +3072,14 @@ async function runPostRunLifecycle(inputs) {
     agentId,
     runId: result.id
   });
-  await chunkN7ZIPW2N_cjs.flushSessionWrites();
+  await chunkYOVZMN4P_cjs.flushSessionWrites();
 }
 async function safeConversation(run) {
   try {
     return await run.conversation();
   } catch (cause) {
     const msg = cause instanceof Error ? cause.message : String(cause);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] conversation() failed; persisting the user turn only: ${msg}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] conversation() failed; persisting the user turn only: ${msg}
 `);
     return [];
   }
@@ -3048,17 +3107,17 @@ var SkillsManager = class {
   }
   async refresh() {
     const roots = this.skillsDir === void 0 ? [
-      ...chunkTY56BKSK_cjs.projectConfigRoots(this.cwd, this.compatSources, "skills").map(
+      ...chunkYQ3XC6C2_cjs.projectConfigRoots(this.cwd, this.compatSources, "skills").map(
         (root) => path.join(root, "skills")
       ),
-      ...(await chunkC7GKRGKN_cjs.pluginBundleDirs(this.cwd, this.compatSources)).map((b) => path.join(b, "skills"))
+      ...(await chunkWDVG5R2Q_cjs.pluginBundleDirs(this.cwd, this.compatSources)).map((b) => path.join(b, "skills"))
     ] : [this.skillsDir];
     const discovered = [];
     const seen = /* @__PURE__ */ new Set();
     for (const root of roots) {
-      for (const skill of await chunkHG5LKFG7_cjs.discoverSkills(root, {
+      for (const skill of await chunk7WARNHWW_cjs.discoverSkills(root, {
         onInvalidSkill: (info) => {
-          chunk6LHQPOMI_cjs.diag(`[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
+          chunkRNXXYF22_cjs.diag(`[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
 `);
         }
       })) {
@@ -3087,7 +3146,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 : chunkHG5LKFG7_cjs.stripSkillFrontmatter(await promises.readFile(skill.source, "utf8"));
+    const instructions = typeof skill.instructions === "string" ? skill.instructions : chunk7WARNHWW_cjs.stripSkillFrontmatter(await promises.readFile(skill.source, "utf8"));
     const references = skill.references;
     return {
       name: skill.name,
@@ -3143,7 +3202,7 @@ function defineTool(spec) {
 }
 
 // src/internal/runtime/system-prompt/native-reasoning.ts
-var NATIVE_REASONING_PARAM_IDS = /* @__PURE__ */ new Set(["thinking", "reasoning", "reasoning_effort"]);
+var NATIVE_REASONING_PARAM_IDS = /* @__PURE__ */ new Set(["thinking"]);
 var REASONING_PREAMBLE = "Think step by step before answering: use the `think` tool to reason through each step, validate your work, then answer. Reason about magnitude before comparing numbers.";
 function createThinkTool() {
   return Tool.create({
@@ -3163,8 +3222,8 @@ var warned = /* @__PURE__ */ new Set();
 function warnDoubleReasoningOnce() {
   if (warned.has("double-reasoning")) return;
   warned.add("double-reasoning");
-  chunk6LHQPOMI_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"
+  chunkRNXXYF22_cjs.diag(
+    "[theokit-sdk] `reasoning: true` skipped \u2014 a native reasoning model is configured (model.params thinking); native reasoning wins. Remove one to silence.\n"
   );
 }
 function reasoningActive(reasoning, model) {
@@ -3260,7 +3319,7 @@ async function safeCall(fn, fallback, label = "safeCall") {
     return await fn();
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] ${label} failed: ${message}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] ${label} failed: ${message}
 `);
     return fallback;
   }
@@ -3274,7 +3333,7 @@ var ActiveMemoryPromptProvider = class {
     if (ctx.activeMemorySummary === void 0 || ctx.activeMemorySummary.length === 0) {
       return Promise.resolve(void 0);
     }
-    const body = chunkHG5LKFG7_cjs.escapeBlockBody(ctx.activeMemorySummary);
+    const body = chunk7WARNHWW_cjs.escapeBlockBody(ctx.activeMemorySummary);
     return Promise.resolve(`<active-memory>
 ${body}
 </active-memory>`);
@@ -3327,7 +3386,7 @@ function formatSource(name, tokens) {
   if (tokens.length === 0) {
     return `  <source name="${escapeAttribute(name)}" />`;
   }
-  const body = chunkHG5LKFG7_cjs.escapeBlockBody(tokens.join(" "));
+  const body = chunk7WARNHWW_cjs.escapeBlockBody(tokens.join(" "));
   return `  <source name="${escapeAttribute(name)}">
     ${body}
   </source>`;
@@ -3351,7 +3410,7 @@ var MemoryPromptProvider = class {
     if (ctx.memory.length === 0) return Promise.resolve(void 0);
     const lines = ctx.memory.map((fact) => {
       const tag = fact.observations === 1 ? "[unconfirmed] " : "";
-      return `  - ${tag}${chunkHG5LKFG7_cjs.escapeBlockBody(fact.text)}`;
+      return `  - ${tag}${chunk7WARNHWW_cjs.escapeBlockBody(fact.text)}`;
     });
     return Promise.resolve(`${MEMORY_GUIDANCE}
 <memory>
@@ -3375,7 +3434,7 @@ var SkillsPromptProvider = class {
   priority = 20;
   contribute(ctx) {
     if (ctx.skillsAutoInject === false) return Promise.resolve(void 0);
-    return Promise.resolve(chunkHG5LKFG7_cjs.buildSkillsBlock(ctx.skills));
+    return Promise.resolve(chunk7WARNHWW_cjs.buildSkillsBlock(ctx.skills));
   }
 };
 
@@ -3387,7 +3446,7 @@ var SystemPromptPipeline = class _SystemPromptPipeline {
     for (const p of providers) {
       const key = `${p.priority}:${p.id}`;
       if (seen.has(key)) {
-        throw new chunkUNFBHV46_cjs.ConfigurationError(`Duplicate system-prompt provider ${key}`, {
+        throw new chunkCEGU5AVD_cjs.ConfigurationError(`Duplicate system-prompt provider ${key}`, {
           code: "pipeline_duplicate_provider"
         });
       }
@@ -3434,7 +3493,7 @@ function validateAgentOptions(options) {
   ensureRuntimeShape(options);
   if (options.local !== void 0) {
     if (options.model === void 0) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError("Local agents require a model selection", {
+      throw new chunkCEGU5AVD_cjs.ConfigurationError("Local agents require a model selection", {
         code: "missing_model"
       });
     }
@@ -3458,7 +3517,7 @@ function validateCredentialPoolShape(options) {
     ([, arr]) => Array.isArray(arr) && arr.some((k) => typeof k === "string" && k.length > 0)
   );
   if (populated.length === 0) return;
-  throw new chunkUNFBHV46_cjs.ConfigurationError(
+  throw new chunkCEGU5AVD_cjs.ConfigurationError(
     "Ambiguous credential configuration: use either `apiKey: '...'` (single-key, simplest) OR `apiKeys: { provider: [...] }` (multi-key pool), not both.",
     { code: "credential_pool_ambiguous" }
   );
@@ -3467,7 +3526,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 chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       "Cloud agents require committed plugin manifests; local plugin paths are not supported",
       { code: "cloud_plugin_path_rejected" }
     );
@@ -3475,7 +3534,7 @@ function validatePlugins(options) {
 }
 function ensureRuntimeShape(options) {
   if (options.local !== void 0 && options.cloud !== void 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       "Pass either local or cloud \u2014 they are mutually exclusive runtimes",
       { code: "runtime_exclusive" }
     );
@@ -3483,7 +3542,7 @@ function ensureRuntimeShape(options) {
 }
 function rejectProgrammaticHooks(options) {
   if (options.hooks !== void 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       "Programmatic hooks are not supported \u2014 hooks are file-based only (.theokit/hooks.json)",
       { code: "programmatic_hooks_rejected" }
     );
@@ -3493,7 +3552,7 @@ function validateCloud(cloud) {
   if (cloud.envVars !== void 0) {
     for (const key of Object.keys(cloud.envVars)) {
       if (key.startsWith("THEOKIT_")) {
-        throw new chunkUNFBHV46_cjs.ConfigurationError(
+        throw new chunkCEGU5AVD_cjs.ConfigurationError(
           `Cloud envVars cannot use the reserved THEOKIT_ prefix (got "${key}")`,
           { code: "reserved_env_prefix" }
         );
@@ -3505,7 +3564,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 chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         `MCP server "${name}" uses stdio with cwd, which is rejected for cloud agents`,
         { code: "cloud_stdio_cwd_rejected" }
       );
@@ -3524,12 +3583,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 chunkUNFBHV46_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty description`, {
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty description`, {
         code: "subagent_missing_description"
       });
     }
     if (typeof definition.prompt !== "string" || definition.prompt.length === 0) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty prompt`, {
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(`Subagent "${name}" requires a non-empty prompt`, {
         code: "subagent_missing_prompt"
       });
     }
@@ -3548,7 +3607,7 @@ function validateToolCatalog(tools, withheldBuiltins) {
   for (const tool of tools) {
     validateSingleTool(tool, reserved);
     if (seen.has(tool.name)) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(`Duplicate custom tool name "${tool.name}"`, {
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(`Duplicate custom tool name "${tool.name}"`, {
         code: "duplicate_tool_name"
       });
     }
@@ -3559,7 +3618,7 @@ function validateCustomTools(options) {
   const tools = options.tools;
   if (tools === void 0 || tools.length === 0) return;
   if (options.cloud !== void 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       "Custom inline tools are local-only in SDK v1.0 \u2014 cloud agents cannot serialize handler functions",
       { code: "cloud_custom_tools_rejected" }
     );
@@ -3571,25 +3630,25 @@ function validateSingleTool(tool, reserved) {
   validateToolDescription(tool);
   validateToolSchema(tool);
   if (typeof tool.handler !== "function") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a handler function`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a handler function`, {
       code: "tool_missing_handler"
     });
   }
 }
 function validateToolName(tool, reserved) {
   if (typeof tool.name !== "string" || tool.name.length === 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError("Custom tool requires a non-empty name", {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError("Custom tool requires a non-empty name", {
       code: "tool_missing_name"
     });
   }
   if (!TOOL_NAME_PATTERN.test(tool.name)) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Custom tool name "${tool.name}" must match /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/`,
       { code: "tool_invalid_name" }
     );
   }
   if (reserved.has(tool.name) || tool.name.startsWith("mcp_")) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Custom tool name "${tool.name}" collides with a reserved SDK tool name`,
       { code: "tool_reserved_name" }
     );
@@ -3597,7 +3656,7 @@ function validateToolName(tool, reserved) {
 }
 function validateToolDescription(tool) {
   if (typeof tool.description !== "string" || tool.description.length === 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a non-empty description`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Custom tool "${tool.name}" requires a non-empty description`, {
       code: "tool_missing_description"
     });
   }
@@ -3605,12 +3664,12 @@ function validateToolDescription(tool) {
 function validateToolSchema(tool) {
   const schema = tool.inputSchema;
   if (schema === null || schema === void 0 || typeof schema !== "object") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Custom tool "${tool.name}" requires an inputSchema object`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Custom tool "${tool.name}" requires an inputSchema object`, {
       code: "tool_missing_schema"
     });
   }
   if (schema.type !== "object") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Custom tool "${tool.name}" inputSchema must declare \`type: "object"\``,
       { code: "tool_invalid_schema_type" }
     );
@@ -3618,11 +3677,11 @@ function validateToolSchema(tool) {
 }
 function validateMemory(options) {
   const memory = options.memory;
-  chunkZD66GFH5_cjs.resolveMaxFacts(memory?.maxFacts);
+  chunkSDZ4XDWS_cjs.resolveMaxFacts(memory?.maxFacts);
   if (memory?.storePath === void 0) return;
   const storePath = memory.storePath;
   if (storePath.includes("..") || storePath.startsWith("/") || /^[A-Z]:/i.test(storePath)) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Memory storePath must stay inside the workspace; got "${storePath}"`,
       { code: "memory_path_traversal" }
     );
@@ -3644,7 +3703,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-5OHB5HJF.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-Q6WT5535.cjs', document.baseURI).href)));
     return r(moduleName);
   } catch {
     return void 0;
@@ -3726,7 +3785,7 @@ var langfuseAdapter = {
       }
     }
     if (lf.LangfuseSpanProcessor === void 0) {
-      chunk6LHQPOMI_cjs.diag(
+      chunkRNXXYF22_cjs.diag(
         "[theokit-sdk] @langfuse/node detected but LangfuseSpanProcessor not found (v2?). Use Langfuse v3+ for auto-instrumentation.\n"
       );
       return "not-wired";
@@ -3871,11 +3930,11 @@ function registerOne(adapter) {
   try {
     const wiring = adapter.register();
     registered.set(adapter.moduleName, wiring);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] telemetry: ${adapter.displayName} ${WIRING_PROSE[wiring]}.
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] telemetry: ${adapter.displayName} ${WIRING_PROSE[wiring]}.
 `);
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] telemetry: ${adapter.displayName} detected but failed to register: ${message}
 `
     );
@@ -3887,7 +3946,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-5OHB5HJF.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-Q6WT5535.cjs', document.baseURI).href)));
       const mod = r("@opentelemetry/api");
       cachedOtel = mod;
     } catch {
@@ -3930,7 +3989,7 @@ function safe(op, fallback) {
     if (!warnedOnce) {
       warnedOnce = true;
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunk6LHQPOMI_cjs.diag(
+      chunkRNXXYF22_cjs.diag(
         `[theokit-sdk] telemetry exporter error (suppressed; agent.send continues): ${message}
 `
       );
@@ -3944,7 +4003,7 @@ function createTelemetry(settings) {
   if (otel === null) {
     if (!warnedOnce) {
       warnedOnce = true;
-      chunk6LHQPOMI_cjs.diag(
+      chunkRNXXYF22_cjs.diag(
         "[theokit-sdk] telemetry.enabled = true but `@opentelemetry/api` is not installed; telemetry is a no-op.\n"
       );
     }
@@ -4038,12 +4097,12 @@ function wrapSpan(span, openSpans) {
 }
 function redactAttrValue(value) {
   if (typeof value !== "string") return value;
-  return chunk6LHQPOMI_cjs.redactSecrets(value);
+  return chunkRNXXYF22_cjs.redactSecrets(value);
 }
 function redactAttrs(attrs) {
   const out = {};
   for (const [k, v] of Object.entries(attrs)) {
-    out[k] = typeof v === "string" ? chunk6LHQPOMI_cjs.redactSecrets(v) : v;
+    out[k] = typeof v === "string" ? chunkRNXXYF22_cjs.redactSecrets(v) : v;
   }
   return out;
 }
@@ -4124,10 +4183,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 = chunkMPR2ISL2_cjs.parseSimpleYaml(split.frontmatter);
+    const fields = chunk6XQLTQB6_cjs.parseSimpleYaml(split.frontmatter);
     const parsed = schema.safeParse(fields);
     if (!parsed.success) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         `Invalid frontmatter in ${resolved.source}: ${parsed.error.message}`,
         { code: `${errorCodePrefix}_frontmatter_invalid` }
       );
@@ -4145,13 +4204,13 @@ async function assertFileSizeUnderCap(source, errorCodePrefix) {
   try {
     const info = await promises.stat(source);
     if (info.size > MAX_MD_FILE_BYTES) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_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 chunkUNFBHV46_cjs.ConfigurationError) throw cause;
+    if (cause instanceof chunkCEGU5AVD_cjs.ConfigurationError) throw cause;
   }
 }
 async function readDirSafe(dir, errorCodePrefix) {
@@ -4160,7 +4219,7 @@ async function readDirSafe(dir, errorCodePrefix) {
   } catch (cause) {
     const code = cause.code;
     if (code === "ENOENT") return null;
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Failed to read ${dir}`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Failed to read ${dir}`, {
       code: `${errorCodePrefix}_dir_read_error`,
       cause
     });
@@ -4177,7 +4236,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 chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Missing or malformed frontmatter in ${source} (expected \`---\` delimited block at file head)`,
       { code: `${errorCodePrefix}_missing_frontmatter` }
     );
@@ -4206,7 +4265,7 @@ function applyAggregateCap(sources, maxTotal) {
     }
     const remaining = maxTotal - totalBytes;
     if (remaining > 0) {
-      const { finalContent } = chunkXKZFIP7Z_cjs.truncateWithMarker(s.content, remaining);
+      const { finalContent } = chunkQG4SXZ2A_cjs.truncateWithMarker(s.content, remaining);
       kept.push({ ...s, content: finalContent, truncated: true });
       totalBytes = maxTotal;
     } else {
@@ -4276,7 +4335,7 @@ var FileContextManager = class {
    */
   grantedContextDialects() {
     if (this.compatSources === void 0) return void 0;
-    return chunkTY56BKSK_cjs.adaptersForSurface(this.compatSources, "context").map((a) => a.kind);
+    return chunkYQ3XC6C2_cjs.adaptersForSurface(this.compatSources, "context").map((a) => a.kind);
   }
   async initialize() {
     if (!this.settingSourcesIncludeProject && this.settings.manager !== "file") {
@@ -4303,10 +4362,10 @@ var FileContextManager = class {
     this.lastScope = [...touchedFiles];
     const config = await loadContextConfig(this.cwd);
     const legacy = await loadSources(config, this.cwd);
-    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkXKZFIP7Z_cjs.DEFAULT_MAX_BYTES_PER_FILE;
+    const maxBytesPerFile = this.settings.maxBytesPerFile ?? chunkQG4SXZ2A_cjs.DEFAULT_MAX_BYTES_PER_FILE;
     const maxBytesTotal = this.settings.maxBytesTotal ?? DEFAULT_MAX_BYTES_TOTAL;
     const granted = this.grantedContextDialects();
-    const discovered = await chunkXKZFIP7Z_cjs.runDiscovery({
+    const discovered = await chunkQG4SXZ2A_cjs.runDiscovery({
       cwd: this.cwd,
       maxBytesPerFile,
       skipLegacyTheokitContext: true,
@@ -4369,8 +4428,8 @@ var FileContextManager = class {
   }
 };
 async function loadContextConfig(cwd) {
-  const mdDir = path.join(chunkTY56BKSK_cjs.theokitConfigRoot(cwd), "context");
-  const jsonPath = path.join(chunkTY56BKSK_cjs.theokitConfigRoot(cwd), "context.json");
+  const mdDir = path.join(chunkYQ3XC6C2_cjs.theokitConfigRoot(cwd), "context");
+  const jsonPath = path.join(chunkYQ3XC6C2_cjs.theokitConfigRoot(cwd), "context.json");
   const mdEntities = await loadMarkdownEntities({
     dir: mdDir,
     schema: ContextSourceFrontmatterSchema,
@@ -4379,7 +4438,7 @@ async function loadContextConfig(cwd) {
   });
   if (mdEntities.length > 0) {
     if (fs.existsSync(jsonPath)) {
-      chunkN6OEX5TN_cjs.warnOnce(
+      chunkUDAKAE4Z_cjs.warnOnce(
         "context-both-present",
         "[theokit-sdk] both .theokit/context/ and .theokit/context.json detected \u2014 using markdown; remove context.json"
       );
@@ -4389,7 +4448,7 @@ async function loadContextConfig(cwd) {
     };
   }
   if (!fs.existsSync(jsonPath)) return { sources: [] };
-  chunkN6OEX5TN_cjs.warnOnce(
+  chunkUDAKAE4Z_cjs.warnOnce(
     "context-json-deprecated",
     // Names no command: `theokit-migrate-config` was unpublished with the `bin` entry, and a warning
     // that tells you to run something the package does not ship is worse than one that tells you
@@ -4400,7 +4459,7 @@ async function loadContextConfig(cwd) {
   try {
     raw = await promises.readFile(jsonPath, "utf8");
   } catch (cause) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Failed to read context config: ${jsonPath}`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Failed to read context config: ${jsonPath}`, {
       code: "context_read_error",
       cause
     });
@@ -4412,13 +4471,13 @@ function parseConfig(raw, configPath) {
   try {
     parsed = JSON.parse(raw);
   } catch (cause) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Invalid JSON in context config: ${configPath}`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Invalid JSON in context config: ${configPath}`, {
       code: "context_json_invalid",
       cause
     });
   }
   if (!parsed || typeof parsed !== "object") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Context config must be an object: ${configPath}`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Context config must be an object: ${configPath}`, {
       code: "context_config_shape"
     });
   }
@@ -4433,7 +4492,7 @@ function parseConfig(raw, configPath) {
 }
 function readSources(sourcesRaw, configPath) {
   if (!Array.isArray(sourcesRaw)) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Context config sources must be an array: ${configPath}`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Context config sources must be an array: ${configPath}`, {
       code: "context_sources_shape"
     });
   }
@@ -4530,13 +4589,13 @@ var PluginsManager = class {
   }
   async refresh() {
     this.plugins = [];
-    for (const pluginsRoot of chunkTY56BKSK_cjs.pluginBundleRoots(this.cwd, this.compatSources)) {
+    for (const pluginsRoot of chunkYQ3XC6C2_cjs.pluginBundleRoots(this.cwd, this.compatSources)) {
       await this.refreshRoot(pluginsRoot);
     }
   }
   // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: MD-first + JSON fallback + CLI location + both-present detection per plugin folder — branch table is clearer inlined.
   async refreshRoot(pluginsRoot) {
-    const entries = await chunkMPR2ISL2_cjs.readWorkspaceDir(pluginsRoot, "plugins_read_error", "plugins directory");
+    const entries = await chunk6XQLTQB6_cjs.readWorkspaceDir(pluginsRoot, "plugins_read_error", "plugins directory");
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       const folderName = entry.name;
@@ -4552,13 +4611,13 @@ var PluginsManager = class {
       const jsonPath = path.join(pluginsRoot, folderName, "plugin.json");
       const metadata = fs.existsSync(mdPath) ? await loadPluginManifestFromMarkdown(this.cwd, pluginsRoot, folderName) : await loadPluginManifestFromJson(this.cwd, jsonPath, folderName);
       if (fs.existsSync(mdPath) && fs.existsSync(jsonPath)) {
-        chunkN6OEX5TN_cjs.warnOnce(
+        chunkUDAKAE4Z_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)) {
-        chunkN6OEX5TN_cjs.warnOnce(
+        chunkUDAKAE4Z_cjs.warnOnce(
           "plugin-json-deprecated",
           // Same reason as the context.json warning: the CLI it used to name is no longer published.
           "[theokit-sdk] plugin.json manifests are deprecated; replace each with a PLUGIN.md"
@@ -4577,11 +4636,11 @@ var PluginsManager = class {
     const entry = metadata.entry;
     if (entry === void 0) return;
     const pluginRoot = path.join(pluginsRoot, folderName);
-    const entryPath = chunkGM54F4FE_cjs.safePathJoin(pluginRoot, entry);
+    const entryPath = chunk3KIUY67P_cjs.safePathJoin(pluginRoot, entry);
     try {
       await promises.readFile(entryPath, "utf8");
     } catch (cause) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(`Plugin ${metadata.name} entry file is missing: ${entry}`, {
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(`Plugin ${metadata.name} entry file is missing: ${entry}`, {
         code: "plugin_entry_missing",
         cause
       });
@@ -4605,7 +4664,7 @@ var PluginsManager = class {
   assertCloudRules() {
     if (!this.cloud) return;
     if (this.localPaths !== void 0 && this.localPaths.length > 0) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         "Cloud agents reject local plugin paths \u2014 plugins must come from committed repo files",
         { code: "cloud_plugin_path_rejected" }
       );
@@ -4617,7 +4676,7 @@ async function loadPluginManifestFromJson(cwd, manifestPath, folderName) {
   try {
     raw = await promises.readFile(manifestPath, "utf8");
   } catch (cause) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Plugin ${folderName} is missing plugin.json`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Plugin ${folderName} is missing plugin.json`, {
       code: "plugin_missing_manifest",
       cause
     });
@@ -4626,13 +4685,13 @@ async function loadPluginManifestFromJson(cwd, manifestPath, folderName) {
   try {
     parsed = JSON.parse(raw);
   } catch (cause) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Plugin ${folderName} manifest is invalid JSON`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Plugin ${folderName} manifest is invalid JSON`, {
       code: "plugin_manifest_invalid",
       cause
     });
   }
   if (!parsed || typeof parsed !== "object") {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Plugin ${folderName} manifest must be an object`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Plugin ${folderName} manifest must be an object`, {
       code: "plugin_manifest_shape"
     });
   }
@@ -4651,7 +4710,7 @@ async function loadPluginManifestFromMarkdown(cwd, pluginsRoot, folderName) {
   try {
     raw = await promises.readFile(mdPath, "utf8");
   } catch (cause) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Plugin ${folderName} is missing PLUGIN.md`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Plugin ${folderName} is missing PLUGIN.md`, {
       code: "plugin_missing_manifest",
       cause
     });
@@ -4666,7 +4725,7 @@ async function loadPluginManifestFromMarkdown(cwd, pluginsRoot, folderName) {
   });
   const entity = entities.find((e) => e.slug === "PLUGIN");
   if (entity === void 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(`Plugin ${folderName} PLUGIN.md not parseable`, {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(`Plugin ${folderName} PLUGIN.md not parseable`, {
       code: "plugin_missing_manifest"
     });
   }
@@ -4792,7 +4851,7 @@ function localAgentListArtifacts() {
 }
 function localAgentDownloadArtifact() {
   return Promise.reject(
-    new chunkUNFBHV46_cjs.UnsupportedRunOperationError(
+    new chunkCEGU5AVD_cjs.UnsupportedRunOperationError(
       "Artifacts are not supported for local agents",
       "downloadArtifact"
     )
@@ -4995,7 +5054,7 @@ function assertValidThresholds(soft, hard) {
     ["hardThreshold", hard]
   ]) {
     if (!Number.isInteger(value) || value < 1) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         `doomLoop.${label} must be a positive integer (received ${value}).`,
         { code: "invalid_doom_loop_threshold" }
       );
@@ -5342,14 +5401,14 @@ async function initLoopContext(inputs) {
 }
 function reportMemoryDegraded(stage, cause, sink) {
   const message = cause instanceof Error ? cause.message : String(cause);
-  chunk6LHQPOMI_cjs.diag(`[theokit-sdk] memory ${stage} failed \u2014 continuing without it: ${message}
+  chunkRNXXYF22_cjs.diag(`[theokit-sdk] memory ${stage} failed \u2014 continuing without it: ${message}
 `);
-  chunkJ6GXS5A2_cjs.emitRunEvent(sink, { type: "memory_degraded", stage, message });
+  chunkL7JPXZ2C_cjs.emitRunEvent(sink, { type: "memory_degraded", stage, message });
 }
 async function safeListTools(client, serverName, sink) {
   try {
     const listed = await client.listTools();
-    chunkJ6GXS5A2_cjs.emitRunEvent(sink, {
+    chunkL7JPXZ2C_cjs.emitRunEvent(sink, {
       type: "mcp_server_ready",
       serverName: serverName ?? "unknown",
       tools: listed.map((tool) => tool.name)
@@ -5358,9 +5417,9 @@ async function safeListTools(client, serverName, sink) {
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
     const server = serverName ?? "unknown";
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] mcp listTools failed (server=${server}): ${message}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] mcp listTools failed (server=${server}): ${message}
 `);
-    chunkJ6GXS5A2_cjs.emitRunEvent(sink, { type: "mcp_server_failed", serverName: server, message });
+    chunkL7JPXZ2C_cjs.emitRunEvent(sink, { type: "mcp_server_failed", serverName: server, message });
     return [];
   }
 }
@@ -5590,7 +5649,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 = chunkHU666T3Q_cjs.getCatalogModelInfo(key);
+    const info = chunkS46WJTDL_cjs.getCatalogModelInfo(key);
     const cost = info?.cost;
     if (cost === void 0) continue;
     const [prov, ...modelParts] = key.split("/");
@@ -5602,7 +5661,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: chunkHU666T3Q_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
+      pricingVersion: chunkS46WJTDL_cjs.isPatchedModelKey(key) ? "catalog-models-dev" : "catalog-vendored"
     };
   }
   return void 0;
@@ -5816,11 +5875,11 @@ ${systemPrompt}`;
 }
 function activeMemoryBlock(additions) {
   return `<active-memory>
-${chunkHG5LKFG7_cjs.escapeBlockBody(additions)}
+${chunk7WARNHWW_cjs.escapeBlockBody(additions)}
 </active-memory>`;
 }
 function buildLoopSystem(systemPrompt, additions, modelId) {
-  if (!chunkNWS2CS3Y_cjs.isAnthropicFamilyModel(modelId) || systemPrompt === void 0 || systemPrompt.length === 0) {
+  if (!chunkNWWTYBD3_cjs.isAnthropicFamilyModel(modelId) || systemPrompt === void 0 || systemPrompt.length === 0) {
     return resolveSystemPromptWithMemoryAdditions(systemPrompt, additions);
   }
   const blocks = [{ text: systemPrompt, cacheable: true }];
@@ -5844,7 +5903,7 @@ function emitLlmMetrics(inputs, result, startAt) {
     inputs.telemetry?.recordHistogram(HISTOGRAM_NAMES.LLM_USAGE_MISSING, 1, {
       provider: inputs.llm.name
     });
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] llm usage missing from ${inputs.llm.name} finish \u2014 budget may undercount
 `
     );
@@ -5973,6 +6032,7 @@ function registerLoopError(ctx, cause) {
 async function consumeStreamEvent(inputs, reasoning, event) {
   if (event.type === "text_delta") {
     const text = event.text ?? "";
+    if (text.length > 0) await closeReasoningOnce(inputs, reasoning);
     await emitTextDeltaCallback(inputs, text);
     return text;
   }
@@ -5985,7 +6045,14 @@ async function consumeStreamEvent(inputs, reasoning, event) {
   return "";
 }
 async function runCollectorLoop(generator, inputs, ctx, partial) {
-  const reasoning = { text: "", startedAt: void 0, signature: void 0 };
+  const reasoning = {
+    text: "",
+    startedAt: void 0,
+    lastAt: void 0,
+    signature: void 0,
+    closed: false,
+    durationMs: 0
+  };
   let errored = false;
   let finishValue;
   let thinking;
@@ -6014,17 +6081,24 @@ async function consumeReasoningDelta(inputs, reasoning, delta) {
   await accumulateReasoning(inputs, reasoning, delta.text);
 }
 async function accumulateReasoning(inputs, reasoning, text) {
-  if (reasoning.startedAt === void 0) reasoning.startedAt = Date.now();
+  const now = Date.now();
+  if (reasoning.startedAt === void 0) reasoning.startedAt = now;
+  if (!reasoning.closed) reasoning.lastAt = now;
   reasoning.text += text;
   await emitReasoningDeltaCallback(inputs, text);
 }
+async function closeReasoningOnce(inputs, reasoning) {
+  if (reasoning.closed || reasoning.text.length === 0) return;
+  reasoning.closed = true;
+  reasoning.durationMs = (reasoning.lastAt ?? 0) - (reasoning.startedAt ?? 0);
+  await emitThinkingCompletedCallback(inputs, reasoning.durationMs);
+}
 async function finalizeReasoning(inputs, ctx, reasoning) {
   if (reasoning.text.length === 0) return void 0;
-  const thinkingDurationMs = reasoning.startedAt === void 0 ? 0 : Date.now() - reasoning.startedAt;
+  await closeReasoningOnce(inputs, reasoning);
   ctx.events.push(
-    buildThinkingEvent(inputs, reasoning.text, thinkingDurationMs, reasoning.signature)
+    buildThinkingEvent(inputs, reasoning.text, reasoning.durationMs, reasoning.signature)
   );
-  await emitThinkingCompletedCallback(inputs, thinkingDurationMs);
   return {
     type: "thinking",
     text: reasoning.text,
@@ -6151,7 +6225,7 @@ function coerceArgsToSchema(args, schema) {
 }
 
 // src/tool-error.ts
-var ToolError = class extends chunkUNFBHV46_cjs.TheokitAgentError {
+var ToolError = class extends chunkCEGU5AVD_cjs.TheokitAgentError {
   name = "ToolError";
   /** The error content surfaced to the model: a string, or text/image blocks. */
   content;
@@ -6325,7 +6399,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 chunkIIYJMXYW_cjs.mapWithConcurrency(
+  return chunk27V5I2WW_cjs.mapWithConcurrency(
     toolCalls,
     maxConcurrent,
     (call) => dispatchSingleCall(inputs, tools, call, events, parentSpan)
@@ -6359,7 +6433,7 @@ async function dispatchSingleCall(inputs, tools, call, events, parentSpan) {
     toolSpan?.end();
     return fileVeto;
   }
-  chunkJ6GXS5A2_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkL7JPXZ2C_cjs.emitRunEvent(inputs.runEventSink, {
     type: "tool_progress",
     toolName: workingCall.name,
     toolCallId: dc.callId
@@ -6391,7 +6465,7 @@ function vetoFromForkWhitelist(dc) {
   const { inputs, call, callId, events } = dc;
   const whitelistDecision = chunkIJ7M6GOG_cjs.checkToolWhitelist(call.name);
   if (whitelistDecision.allowed) return void 0;
-  chunkJ6GXS5A2_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkL7JPXZ2C_cjs.emitRunEvent(inputs.runEventSink, {
     type: "permission_denied",
     toolName: call.name,
     toolCallId: callId,
@@ -6438,7 +6512,7 @@ async function vetoFromPluginPreHook(dc) {
     ...inputs.permissionMode !== void 0 ? { permissionMode: inputs.permissionMode } : {}
   });
   if (pluginVeto === void 0) return void 0;
-  chunkJ6GXS5A2_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkL7JPXZ2C_cjs.emitRunEvent(inputs.runEventSink, {
     type: "permission_denied",
     toolName: call.name,
     toolCallId: callId,
@@ -6468,7 +6542,7 @@ async function vetoFromFileHookPreDecision(dc) {
     runId: inputs.runId
   });
   if (!preDecision.blocked) return void 0;
-  chunkJ6GXS5A2_cjs.emitRunEvent(inputs.runEventSink, {
+  chunkL7JPXZ2C_cjs.emitRunEvent(inputs.runEventSink, {
     type: "permission_denied",
     toolName: call.name,
     toolCallId: callId,
@@ -6571,7 +6645,7 @@ function finalizeSpanAndPostHook(dc, result, toolSpan) {
     agentId: inputs.agentId,
     runId: inputs.runId
   }).catch((err) => {
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] postToolUse hook error (swallowed): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -6590,7 +6664,7 @@ async function emitToolLifecycleDelta(inputs, update) {
   try {
     await inputs.onDelta({ update });
   } catch (err) {
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] onDelta tool-lifecycle emit error (swallowed): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -6602,7 +6676,7 @@ async function safeEmitToolHook(callback, event) {
     await callback(event);
   } catch (cause) {
     const msg = cause instanceof Error ? cause.message : String(cause);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] tool lifecycle hook threw: ${msg}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] tool lifecycle hook threw: ${msg}
 `);
   }
 }
@@ -6669,7 +6743,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: chunkBZKF7TXX_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
+      p.type === "tool_result" ? { ...p, content: chunkLSWHDOCL_cjs.renderToolResultContentText(p.content, (t) => guardText(t, opts)) } : p
     )
   );
 }
@@ -6863,25 +6937,22 @@ async function runIteration(inputs, ctx) {
 function trackTurnUsage(inputs, llmOutput) {
   const tracker = inputs.budgetTracker;
   if (tracker === void 0) return;
-  const modelId = inputs.model.id ?? "auto";
-  const inputT = (llmOutput.inputTokens ?? 0) + (llmOutput.cacheReadTokens ?? 0) + (llmOutput.cacheWriteTokens ?? 0);
-  const outputT = llmOutput.outputTokens ?? 0;
+  const model = inputs.model.id ?? "auto";
+  trackEvent(tracker, { tokens: promptTokens(llmOutput), model, type: "input" });
+  trackEvent(tracker, { tokens: llmOutput.outputTokens ?? 0, model, type: "output" });
+}
+function promptTokens(llmOutput) {
+  return (llmOutput.inputTokens ?? 0) + (llmOutput.cacheReadTokens ?? 0) + (llmOutput.cacheWriteTokens ?? 0);
+}
+function trackEvent(tracker, event) {
+  if (event.tokens <= 0) return;
   try {
-    if (inputT > 0) {
-      tracker.track({
-        tokens: inputT,
-        model: modelId,
-        type: "input"
-      });
-    }
-    if (outputT > 0) {
-      tracker.track({
-        tokens: outputT,
-        model: modelId,
-        type: "output"
-      });
-    }
-  } catch {
+    tracker.track(event);
+  } catch (err) {
+    const why = err instanceof Error ? err.message : String(err);
+    chunkRNXXYF22_cjs.diagFailure(
+      `[theokit-sdk] BudgetTracker.track threw (type=${event.type}, model=${event.model}, tokens=${event.tokens}): ${why}`
+    );
   }
 }
 async function transformLlmOutputText(inputs, text, ctx) {
@@ -6954,6 +7025,32 @@ async function inspectDoomLoop(inputs, ctx, toolCalls) {
   return "continue";
 }
 
+// src/internal/concurrency/abort-utils.ts
+function anySignal(signals) {
+  const filtered = signals.filter((s) => s !== void 0);
+  if (filtered.length === 0) {
+    return new AbortController().signal;
+  }
+  if (filtered.length === 1) {
+    return filtered[0];
+  }
+  if (typeof AbortSignal.any === "function") {
+    return AbortSignal.any(filtered);
+  }
+  return ponyfillAny(filtered);
+}
+function ponyfillAny(signals) {
+  const ctrl = new AbortController();
+  for (const s of signals) {
+    if (s.aborted) {
+      ctrl.abort(s.reason);
+      return ctrl.signal;
+    }
+    s.addEventListener("abort", () => ctrl.abort(s.reason), { once: true });
+  }
+  return ctrl.signal;
+}
+
 // src/internal/llm/fallback-client.ts
 var FallbackLlmClient = class {
   constructor(clients) {
@@ -6964,16 +7061,16 @@ var FallbackLlmClient = class {
   async *stream(request, signal) {
     let lastError;
     for (const client of this.clients) {
-      if (signal.aborted) throw chunkBZKF7TXX_cjs.abortError(signal);
-      const attempt = await chunkBZKF7TXX_cjs.tryFirstEvent(client, request, signal, true);
+      if (signal.aborted) throw chunkLSWHDOCL_cjs.abortError(signal);
+      const attempt = await chunkLSWHDOCL_cjs.tryFirstEvent(client, request, signal, true);
       if (attempt.kind === "handshake_error") {
         lastError = attempt.error;
         continue;
       }
-      return yield* chunkBZKF7TXX_cjs.relayStream(attempt.generator, attempt.firstResult);
+      return yield* chunkLSWHDOCL_cjs.relayStream(attempt.generator, attempt.firstResult);
     }
     if (lastError !== void 0) throw lastError;
-    throw new chunkUNFBHV46_cjs.NetworkError("FallbackLlmClient has no providers configured", {
+    throw new chunkCEGU5AVD_cjs.NetworkError("FallbackLlmClient has no providers configured", {
       code: "fallback_empty_chain"
     });
   }
@@ -7001,7 +7098,7 @@ function reconnectDelay(attempt) {
   return ms <= 0 ? Promise.resolve() : new Promise((resolve) => setTimeout(resolve, ms));
 }
 function mcpTimeoutError(name, timeoutMs) {
-  return new chunkUNFBHV46_cjs.NetworkError(`MCP ${name} request timed out after ${timeoutMs}ms`, {
+  return new chunkCEGU5AVD_cjs.NetworkError(`MCP ${name} request timed out after ${timeoutMs}ms`, {
     code: "mcp_timeout"
   });
 }
@@ -7099,7 +7196,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     child.stdin.on("error", () => void 0);
     child.on("error", () => {
       this.rejectAllPending(
-        new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} process crashed`, { code: "mcp_crashed" })
+        new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} process crashed`, { code: "mcp_crashed" })
       );
     });
     child.on("exit", () => {
@@ -7107,7 +7204,7 @@ var StdioMcpClient = class extends BaseMcpClient {
       this.child = void 0;
       this.dropped = true;
       this.rejectAllPending(
-        new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
+        new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
       );
     });
   }
@@ -7135,7 +7232,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     if (this.child !== void 0) return Promise.resolve();
     if (!this.dropped) {
       return Promise.reject(
-        new chunkUNFBHV46_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
+        new chunkCEGU5AVD_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
       );
     }
     this.reconnectPromise ??= this.reconnect().finally(() => {
@@ -7159,13 +7256,13 @@ var StdioMcpClient = class extends BaseMcpClient {
         this.reconnecting = false;
       }
     }
-    throw new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} reconnect exhausted`, {
+    throw new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} reconnect exhausted`, {
       code: "mcp_disconnected",
       ...lastErr instanceof Error ? { cause: lastErr } : {}
     });
   }
   async close() {
-    this.rejectAllPending(new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} closed`, { code: "mcp_closed" }));
+    this.rejectAllPending(new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} closed`, { code: "mcp_closed" }));
     const child = this.child;
     this.child = void 0;
     this.dropped = false;
@@ -7184,7 +7281,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     if (this.buffer.length > MAX_STDIO_BUFFER_BYTES) {
       this.buffer = "";
       this.rejectAllPending(
-        new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} exceeded stdout buffer limit`, {
+        new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} exceeded stdout buffer limit`, {
           code: "mcp_buffer_overflow"
         })
       );
@@ -7219,7 +7316,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 chunkUNFBHV46_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" })
+      new chunkCEGU5AVD_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
@@ -7228,7 +7325,7 @@ var StdioMcpClient = class extends BaseMcpClient {
     await this.ensureConnected();
     const child = this.child;
     if (child === void 0) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" });
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(`MCP ${this.name} is not initialized`, { code: "mcp_not_init" });
     }
     return this.send(child, method, params);
   }
@@ -7246,7 +7343,7 @@ var StdioMcpClient = class extends BaseMcpClient {
         this.child = void 0;
         this.dropped = true;
         this.rejectAllPending(
-          new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
+          new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} disconnected`, { code: "mcp_disconnected" })
         );
       }, budget);
       this.pending.set(id, { resolve, reject, timer });
@@ -7318,7 +7415,7 @@ var HttpMcpClient = class extends BaseMcpClient {
       if (payload === "") continue;
       return JSON.parse(payload);
     }
-    throw new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} returned an event stream with no data payload`, {
+    throw new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} returned an event stream with no data payload`, {
       code: "mcp_http_error"
     });
   }
@@ -7352,7 +7449,7 @@ var HttpMcpClient = class extends BaseMcpClient {
       throw cause;
     }
     if (!response.ok) {
-      throw new chunkUNFBHV46_cjs.NetworkError(`MCP ${this.name} returned ${response.status}`, {
+      throw new chunkCEGU5AVD_cjs.NetworkError(`MCP ${this.name} returned ${response.status}`, {
         code: "mcp_http_error"
       });
     }
@@ -7368,7 +7465,7 @@ var HttpMcpClient = class extends BaseMcpClient {
 function resolveMcpCwd(configCwd) {
   if (configCwd === void 0) return process.cwd();
   if (path.isAbsolute(configCwd)) return configCwd;
-  return chunkGM54F4FE_cjs.safePathJoin(process.cwd(), configCwd);
+  return chunk3KIUY67P_cjs.safePathJoin(process.cwd(), configCwd);
 }
 
 // src/internal/local-agent/mcp-pool.ts
@@ -7470,7 +7567,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)`;
-    chunkN6OEX5TN_cjs.warnOnce(
+    chunkUDAKAE4Z_cjs.warnOnce(
       `personality-tool-missing|${opts?.agentId ?? "?"}|${opts?.personalityName ?? "?"}|${name}`,
       message
     );
@@ -7512,7 +7609,7 @@ 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 chunkJW3GVLM6_cjs.subAgentToolsFromDefinitions(agents2, parentTools);
+  return chunkH7HD6RXO_cjs.subAgentToolsFromDefinitions(agents2, parentTools);
 }
 function resolveInheritedCredentials(agentOptions) {
   const parentPlugins = Array.isArray(agentOptions.plugins) ? agentOptions.plugins : void 0;
@@ -7601,14 +7698,14 @@ function createRealLocalRun(options) {
 function buildLoopInputs(options, runId, userText, userImages) {
   const maxIterations = options.sendOptions.maxIterations;
   if (maxIterations !== void 0 && (!Number.isInteger(maxIterations) || maxIterations < 1)) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `SendOptions.maxIterations must be a positive integer, got ${maxIterations}`,
       { code: "invalid_max_iterations" }
     );
   }
-  const { primary, effectiveModelId } = chunkBZKF7TXX_cjs.resolveRunProvider(options);
+  const { primary, effectiveModelId } = chunkLSWHDOCL_cjs.resolveRunProvider(options);
   const fallback = options.agentOptions.providers?.fallback;
-  const apiKeys = chunkBZKF7TXX_cjs.mergeExplicitApiKey(
+  const apiKeys = chunkLSWHDOCL_cjs.mergeExplicitApiKey(
     options.agentOptions.providers?.apiKeys,
     primary,
     options.agentOptions.apiKey
@@ -7617,7 +7714,7 @@ function buildLoopInputs(options, runId, userText, userImages) {
   const extractToolCallsFromContent = options.agentOptions.providers?.routes?.[0]?.extractToolCallsFromContent;
   const rateLimitSink = options.sendOptions.onRunEvent;
   const modelBaseUrl = options.model?.url;
-  const chain = chunkBZKF7TXX_cjs.resolveProviderChain({
+  const chain = chunkLSWHDOCL_cjs.resolveProviderChain({
     primary,
     ...modelBaseUrl !== void 0 ? { baseUrl: modelBaseUrl } : {},
     ...fallback !== void 0 ? { fallback } : {},
@@ -7625,7 +7722,7 @@ function buildLoopInputs(options, runId, userText, userImages) {
     ...credentialPoolStrategy !== void 0 ? { credentialPoolStrategy } : {},
     ...extractToolCallsFromContent === true ? { extractToolCallsFromContent: true } : {},
     ...rateLimitSink !== void 0 ? {
-      onRateLimit: (info) => chunkJ6GXS5A2_cjs.emitRunEvent(rateLimitSink, { type: "rate_limit", ...info })
+      onRateLimit: (info) => chunkL7JPXZ2C_cjs.emitRunEvent(rateLimitSink, { type: "rate_limit", ...info })
     } : {}
   });
   const llm = chain.length === 1 ? chain[0] : new FallbackLlmClient(chain);
@@ -7708,6 +7805,13 @@ var RealLocalRun = class extends FixtureRunBase {
   ownsMcpClients;
   /** theokit#148 — what a delegated child inherits from this parent, scoped to the loop. */
   inheritedCredentials;
+  /**
+   * B-495 — the run's own abort, composed into the signal the loop hands to the LLM fetch and the
+   * tool executors, so `cancel()` stops the request and not only the status. A TypeScript `private`
+   * field, never a JS `#private` one: the run wrappers are Proxies that call `cancel()` with `this`
+   * bound to the Proxy, where reading a `#private` field throws.
+   */
+  cancelController = new AbortController();
   constructor(options, buildInputs, ownsMcpClients, inheritedCredentials) {
     super(options);
     this.buildInputs = buildInputs;
@@ -7719,6 +7823,11 @@ var RealLocalRun = class extends FixtureRunBase {
       void this.driveLoop();
     }, 0);
   }
+  cancel() {
+    if (this.terminated) return Promise.resolve();
+    this.cancelController.abort();
+    return super.cancel();
+  }
   notifyImmediately() {
     return true;
   }
@@ -7762,7 +7871,9 @@ var RealLocalRun = class extends FixtureRunBase {
   liveDelivered = /* @__PURE__ */ new Set();
   async executeAgentLoop(inputs) {
     let textStreamedSinceLastMessage = false;
+    inputs.signal = anySignal([inputs.signal, this.cancelController.signal]);
     inputs.onLoopEvent = (event) => {
+      if (this.terminated) return;
       this.liveDelivered.add(event);
       this.script.events.push(event);
       const carriesText = event.type === "assistant" && event.message.content.some((b) => b.type === "text");
@@ -7778,24 +7889,22 @@ var RealLocalRun = class extends FixtureRunBase {
     };
     const callerOnDelta = inputs.onDelta;
     inputs.onDelta = (delta) => {
+      if (this.terminated) return;
       callerOnDelta?.(delta);
       if (delta.update.type === "text-delta") textStreamedSinceLastMessage = true;
       this.pushTimeline({ kind: "delta", update: delta.update });
     };
     try {
+      if (this.terminated) return;
       const runLoop = () => inputs.activeTools !== void 0 ? chunkIJ7M6GOG_cjs.withToolWhitelist(new Set(inputs.activeTools), () => runAgentLoop(inputs)) : runAgentLoop(inputs);
-      const output = await chunkJW3GVLM6_cjs.withInheritedSubAgentCredentials(this.inheritedCredentials, runLoop);
+      const output = await chunkH7HD6RXO_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 {
-      if (this.ownsMcpClients) {
-        for (const client of inputs.mcp.values()) {
-          await client.close().catch(() => void 0);
-        }
-      }
+      if (this.ownsMcpClients) await closeOwnedMcpClients(inputs);
     }
   }
   /**
@@ -7807,6 +7916,7 @@ var RealLocalRun = class extends FixtureRunBase {
    * Finding-B fix (sdk-error-packaging v1.1): set-once errorDetail copy.
    */
   applyAgentLoopOutput(output) {
+    if (this.terminated) return;
     this.deliverUndeliveredEvents(output.events);
     this.script.conversation.push(...output.conversation);
     if (output.result.length > 0) this.script.result = output.result;
@@ -7854,6 +7964,18 @@ var RealLocalRun = class extends FixtureRunBase {
     this.notifyNewEvents();
   }
 };
+async function closeOwnedMcpClients(inputs) {
+  for (const [name, client] of inputs.mcp.entries()) {
+    try {
+      await client.close();
+    } catch (cause) {
+      const why = cause instanceof Error ? cause.message : String(cause);
+      chunkRNXXYF22_cjs.diagFailure(
+        `[theokit-sdk] MCP server ${name} failed to close; its process may still be running: ${why}`
+      );
+    }
+  }
+}
 
 // src/internal/local-agent/local-agent-dispatch.ts
 function buildRealRunOptions(args) {
@@ -7877,7 +7999,7 @@ function buildRealRunOptions(args) {
   };
 }
 async function createFixtureRunHelper(args) {
-  const sessionMessages = chunkN7ZIPW2N_cjs.getSessionMessages(args.inputs.agentId);
+  const sessionMessages = chunkYOVZMN4P_cjs.getSessionMessages(args.inputs.agentId);
   const projectMcpServers = args.inputs.settingSourcesIncludeProject ? await readProjectMcpServers(args.inputs.workspaceCwd) : {};
   return createLocalRun({
     agentId: args.inputs.agentId,
@@ -7895,8 +8017,8 @@ async function createFixtureRunHelper(args) {
   });
 }
 async function dispatchLocalRun(args) {
-  const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(args.inputs.options.apiKey);
-  if (chunkBZKF7TXX_cjs.shouldUseRealLocalRuntime(apiKey)) {
+  const apiKey = chunkRNXXYF22_cjs.resolveApiKey(args.inputs.options.apiKey);
+  if (chunkLSWHDOCL_cjs.shouldUseRealLocalRuntime(apiKey)) {
     return createRealLocalRun(
       buildRealRunOptions({
         inputs: args.inputs,
@@ -7919,7 +8041,7 @@ async function dispatchLocalRun(args) {
   });
 }
 async function readProjectMcpServers(cwd) {
-  const path$1 = path.join(chunkTY56BKSK_cjs.theokitConfigRoot(cwd), "mcp.json");
+  const path$1 = path.join(chunkYQ3XC6C2_cjs.theokitConfigRoot(cwd), "mcp.json");
   try {
     const raw = await promises.readFile(path$1, "utf8");
     const parsed = JSON.parse(raw);
@@ -7931,20 +8053,20 @@ async function readProjectMcpServers(cwd) {
 
 // src/internal/local-agent/local-agent-invalidate.ts
 async function applyDeferredInvalidation(agentId, pending, refresh) {
-  chunk6LHQPOMI_cjs.diag(`[theokit-sdk] applying deferred cache invalidation (${agentId}): ${pending.reason}
+  chunkRNXXYF22_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);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] invalidateCache reload failed (continuing): ${msg}
+    chunkRNXXYF22_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) {
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] invalidateCache applyNow disposing agent (${agentId}): ${reason}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] invalidateCache applyNow disposing agent (${agentId}): ${reason}
 `);
     await dispose();
     return;
@@ -8005,7 +8127,7 @@ var LiveAgentRegistry = class {
     const existing = this.#agents.get(id);
     if (existing !== void 0 && existing.agent !== agent) {
       void existing.agent.dispose().catch(() => {
-        chunk6LHQPOMI_cjs.diag(`[theokit-sdk] dispose during overwrite failed (${id})
+        chunkRNXXYF22_cjs.diag(`[theokit-sdk] dispose during overwrite failed (${id})
 `);
       });
     }
@@ -8109,7 +8231,7 @@ var LiveAgentRegistry = class {
       await agent.dispose();
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      chunk6LHQPOMI_cjs.diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
 `);
     }
     if (this.#onEvict !== void 0) {
@@ -8117,7 +8239,7 @@ var LiveAgentRegistry = class {
         this.#onEvict(id, reason);
       } catch (cause) {
         const msg = cause instanceof Error ? cause.message : String(cause);
-        chunk6LHQPOMI_cjs.diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
+        chunkRNXXYF22_cjs.diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
 `);
       }
     }
@@ -8135,7 +8257,7 @@ async function acquireLeaseIfPossible(store, agentId) {
     await store.acquire(agentId);
   } catch (err) {
     if (err instanceof Error && err.name === "SessionBusyError") throw err;
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit-sdk] writer lease unavailable for ${agentId} (${err instanceof Error ? err.message : String(err)}) \u2014 proceeding without single-writer protection
 `
     );
@@ -8152,16 +8274,16 @@ async function disposeLocalAgentSession(agent) {
   agent.lifecycleAbortController.abort();
   await chunkZF2LDKQQ_cjs.withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
   disposeSessionMcpClients(agent.agentId);
-  await chunkN7ZIPW2N_cjs.flushSessionWrites();
+  await chunkYOVZMN4P_cjs.flushSessionWrites();
   await flushRegistrySaves(agent.workspaceCwd);
   await disposeSessionStore(agent.sessionStore);
-  chunkN7ZIPW2N_cjs.discardSession(agent.workspaceCwd, agent.agentId);
+  chunkYOVZMN4P_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 chunkC7GKRGKN_cjs.loadSubagents(
+  return await chunkWDVG5R2Q_cjs.loadSubagents(
     agent.workspaceCwd,
     agent.settingSourcesIncludeProject,
     agent.options.agents
@@ -8174,7 +8296,7 @@ async function createAvailableAdapters(entries, workspaceCwd) {
   for (const entry of entries) {
     const instance = await entry.createProvider(workspaceCwd);
     if (instance.isAvailable() === false) {
-      chunk6LHQPOMI_cjs.diag(
+      chunkRNXXYF22_cjs.diag(
         `[theokit-sdk] memory adapter "${instance.id}" reports itself unavailable (plugin "${entry.pluginName}") \u2014 skipping it. Check its credentials.
 `
       );
@@ -8208,7 +8330,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 chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_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" }
       );
@@ -8218,7 +8340,7 @@ function buildAgentMemory(pluginManager, workspaceCwd, defaultContext) {
   async function requireAdapters() {
     const r = await ensure();
     if (r.adapters.length === 0) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         r.registered === 0 ? "No memory adapter registered. Pass a memory plugin in AgentOptions.plugins (e.g. supermemoryMemory({...}))." : `All ${r.registered} registered memory adapter(s) reported themselves unavailable \u2014 see the warnings naming each one. Check their credentials.`,
         { code: "no_memory_adapter" }
       );
@@ -8259,7 +8381,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 chunkUNFBHV46_cjs.ConfigurationError(
+        throw new chunkCEGU5AVD_cjs.ConfigurationError(
           `No adapter found for MemoryId prefix "${prefix}" (registered: ${adapters.map((a) => a.id).join(", ")}).`,
           { code: "no_memory_adapter" }
         );
@@ -8389,7 +8511,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);
-    chunk6LHQPOMI_cjs.diag(`[theokit-sdk] active-memory recall failed: ${message}
+    chunkRNXXYF22_cjs.diag(`[theokit-sdk] active-memory recall failed: ${message}
 `);
     return { summary: void 0, durationMs: Date.now() - started, status: "error", hits: [] };
   }
@@ -8407,7 +8529,7 @@ async function finalize(args, queryMode, result) {
   };
   args.cache?.set(args.userText, queryMode, result, tenantCtx);
   if (args.persistTranscripts === true && args.cwd !== void 0) {
-    await chunkTMKTSYDS_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkZD66GFH5_cjs.resolveMemoryRoot(args.cwd), {
+    await chunkRS7YQR4X_cjs.persistActiveMemoryTranscript(args.memoryRoot ?? chunkSDZ4XDWS_cjs.resolveMemoryRoot(args.cwd), {
       runId: args.runId ?? `run-${Date.now()}`,
       startedAtMs: Date.now() - result.durationMs,
       userText: args.userText,
@@ -8510,7 +8632,7 @@ var openAiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "openai",
   autoSelectPriority: 20,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "openai",
       defaultBaseUrl: "https://api.openai.com",
@@ -8532,7 +8654,7 @@ var azureOpenAiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "azure-openai",
   autoSelectPriority: 25,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "azure-openai",
       defaultBaseUrl: "https://your-resource.openai.azure.com",
@@ -8568,7 +8690,7 @@ var cohereMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "cohere",
   autoSelectPriority: 30,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "cohere",
       defaultBaseUrl: "https://api.cohere.com",
@@ -8614,7 +8736,7 @@ var deepinfraMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "deepinfra",
   autoSelectPriority: 13,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "deepinfra",
       defaultBaseUrl: "https://api.deepinfra.com",
@@ -8640,7 +8762,7 @@ var geminiMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "gemini",
   autoSelectPriority: 30,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "gemini",
       defaultBaseUrl: "https://generativelanguage.googleapis.com",
@@ -8668,7 +8790,7 @@ var jinaMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "jina",
   autoSelectPriority: 35,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "jina",
       defaultBaseUrl: "https://api.jina.ai",
@@ -8691,7 +8813,7 @@ var mistralMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "mistral",
   autoSelectPriority: 18,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "mistral",
       defaultBaseUrl: "https://api.mistral.ai",
@@ -8733,7 +8855,7 @@ var ollamaMemoryEmbeddingProviderAdapter = {
   autoSelectPriority: 10,
   create: (options) => {
     const apiKey = options.apiKey ?? process.env.OLLAMA_API_KEY ?? OLLAMA_LOCAL_SENTINEL_KEY;
-    return chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+    return chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
       {
         id: "ollama",
         defaultBaseUrl: "http://localhost:11434",
@@ -8761,7 +8883,7 @@ var openRouterMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "openrouter",
   autoSelectPriority: 15,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "openrouter",
       defaultBaseUrl: "https://openrouter.ai/api",
@@ -8789,7 +8911,7 @@ var voyageMemoryEmbeddingProviderAdapter = {
   transport: "remote",
   authProviderId: "voyage",
   autoSelectPriority: 14,
-  create: (options) => chunkYEHQ3SIC_cjs.createOpenAiCompatibleRuntime(
+  create: (options) => chunkCGH4BCIY_cjs.createOpenAiCompatibleRuntime(
     {
       id: "voyage",
       defaultBaseUrl: "https://api.voyageai.com",
@@ -8901,7 +9023,7 @@ function createMemoryGetTool(opts) {
       const lines = readNumber(input.lines);
       const resolved = path.resolve(memoryRoot, relPath);
       if (!isPathInside(memoryRoot, resolved)) {
-        throw new chunkUNFBHV46_cjs.ConfigurationError(
+        throw new chunkCEGU5AVD_cjs.ConfigurationError(
           `memory_get rejected path that escapes memory root: ${relPath}`,
           { code: "memory_path_escapes_root" }
         );
@@ -8921,7 +9043,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 chunkUNFBHV46_cjs.ConfigurationError(errorIfMissing, { code: "memory_tool_bad_args" });
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(errorIfMissing, { code: "memory_tool_bad_args" });
   }
   return "";
 }
@@ -8998,7 +9120,7 @@ var LocalAgentMemory = class {
       const openOpts = { cwd: this.workspaceCwd, memoryRoot };
       if (embedding !== void 0) openOpts.embedding = embedding;
       if (cfg?.backend !== void 0) openOpts.backend = cfg.backend;
-      this.index = await chunkL3C6CCBG_cjs.IndexManager.open(openOpts);
+      this.index = await chunkCWQPQTUZ_cjs.IndexManager.open(openOpts);
       await this.index.sync();
       this.toolsCache = [
         createMemorySearchTool({ index: this.index }),
@@ -9010,7 +9132,7 @@ var LocalAgentMemory = class {
       const warned2 = chunkNVXXWAU7_cjs.globalSingleton("theokit-sdk.memory.warned", () => /* @__PURE__ */ new Set());
       if (!warned2.has(message)) {
         warned2.add(message);
-        chunk6LHQPOMI_cjs.diag(`[theokit-sdk] memory tools unavailable: ${message}
+        chunkRNXXYF22_cjs.diag(`[theokit-sdk] memory tools unavailable: ${message}
 `);
       }
       return void 0;
@@ -9019,7 +9141,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 chunkBZKF7TXX_cjs.CircuitBreaker();
+    if (this.breaker === void 0) this.breaker = new chunkLSWHDOCL_cjs.CircuitBreaker();
     if (this.cache === void 0) this.cache = new ActiveMemoryCache();
     const result = await runActiveMemory({
       userText,
@@ -9042,7 +9164,7 @@ var LocalAgentMemory = class {
    * and the active-memory transcript writer. Three separate resolutions is how they drifted (#463).
    */
   memoryRoot() {
-    this.memoryRootCache ??= chunkZD66GFH5_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
+    this.memoryRootCache ??= chunkSDZ4XDWS_cjs.resolveMemoryRoot(this.workspaceCwd, this.options.memory);
     return this.memoryRootCache;
   }
   buildActiveMemoryOptions(cfg) {
@@ -9078,7 +9200,7 @@ var LocalAgentMemory = class {
       await this.index.sync();
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      chunk6LHQPOMI_cjs.diag(`[theokit-sdk] session index sync failed: ${message}
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] session index sync failed: ${message}
 `);
     }
   }
@@ -9091,7 +9213,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);
-      chunk6LHQPOMI_cjs.diag(`[theokit-sdk] memory embedding ${cfg.provider} unavailable: ${message}
+      chunkRNXXYF22_cjs.diag(`[theokit-sdk] memory embedding ${cfg.provider} unavailable: ${message}
 `);
       return void 0;
     }
@@ -9157,7 +9279,7 @@ function createLocalAgentMemoryProvider(opts) {
       return { facts: [], systemPromptAdditions: summary };
     },
     async recordSessionSummary(args) {
-      await chunkZD66GFH5_cjs.writeSessionSummary(args);
+      await chunkSDZ4XDWS_cjs.writeSessionSummary(args);
     },
     async sync(handle) {
       const state = handle[INTERNAL_LAM_KEY];
@@ -9195,7 +9317,7 @@ var PersonalityRegistry = class _PersonalityRegistry {
    * @internal
    */
   static async load(cwd) {
-    const projectDir = path.join(chunkTY56BKSK_cjs.theokitConfigRoot(cwd), PERSONALITIES_SUFFIX);
+    const projectDir = path.join(chunkYQ3XC6C2_cjs.theokitConfigRoot(cwd), PERSONALITIES_SUFFIX);
     const userDir = path.join(os.homedir(), USER_SUBDIR);
     const [userEntities, projectEntities] = await Promise.all([
       loadMarkdownEntities({
@@ -9235,19 +9357,19 @@ var PersonalityRegistry = class _PersonalityRegistry {
 function addEntity(byName, entity, origin, collisionMap) {
   const fm = entity.frontmatter;
   if (PersonalityRegistry.isReservedClearSlug(fm.name)) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_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 chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Personality "${fm.name}" has empty body (system prompt required)`,
       { code: "personality_empty_body" }
     );
   }
   if (origin === "project" && collisionMap?.has(fm.name)) {
-    chunkN6OEX5TN_cjs.warnOnce(
+    chunkUDAKAE4Z_cjs.warnOnce(
       `personality-collision-${fm.name}`,
       `[theokit-sdk] personality "${fm.name}" overridden by project preset`
     );
@@ -9276,7 +9398,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 chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         `Personality "${args.requestedName}" not found. Available: ${available}`,
         { code: "personality_not_found" }
       );
@@ -9297,14 +9419,14 @@ async function performPersonalitySwitch(args) {
 
 // src/internal/local-agent/local-agent-personality-extensions.ts
 function resolveActivePersonalityPreset(args) {
-  const forkCtx = chunkKIKKTW5O_cjs.currentPersonalityContext();
+  const forkCtx = chunk7YUPSBDV_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 = chunkKIKKTW5O_cjs.currentPersonalityContext()?.slug;
+  const forkSlug = chunk7YUPSBDV_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);
@@ -9317,8 +9439,8 @@ function applyPersonalityOverlay(preset, base) {
 ${preset.systemPrompt}`;
 }
 async function localAgentUsePersonality(agent, name, opts) {
-  if (chunkKIKKTW5O_cjs.currentPersonalityContext() !== void 0) {
-    chunkKIKKTW5O_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
+  if (chunk7YUPSBDV_cjs.currentPersonalityContext() !== void 0) {
+    chunk7YUPSBDV_cjs.warnPersonalitySwitchInsideFork(agent.agentId);
     return null;
   }
   if (agent.personalityRegistry === void 0) {
@@ -9334,8 +9456,8 @@ async function localAgentUsePersonality(agent, name, opts) {
       registry,
       store: agent.personalityStore,
       invalidateCache: (reason) => agent.invalidateCache(reason),
-      appendSessionMessage: (msg) => chunkN7ZIPW2N_cjs.appendSessionMessage(agent.agentId, msg),
-      clearSession: () => chunkN7ZIPW2N_cjs.clearSession(agent.agentId),
+      appendSessionMessage: (msg) => chunkYOVZMN4P_cjs.appendSessionMessage(agent.agentId, msg),
+      clearSession: () => chunkYOVZMN4P_cjs.clearSession(agent.agentId),
       opts: opts ?? {}
     })
   );
@@ -9344,9 +9466,9 @@ async function localAgentUsePersonality(agent, name, opts) {
 // src/internal/local-agent/local-agent-runtime-extensions.ts
 function localAgentRunUntil(agent, goal, options) {
   async function* wrap() {
-    const { runUntilImpl } = await import('./run-until-DG2KXWB2.cjs');
+    const { runUntilImpl } = await import('./run-until-4KHVF7YC.cjs');
     const buildDeps = async () => {
-      const { judgeCallImpl } = await import('./judge-call-AQQYK6VT.cjs');
+      const { judgeCallImpl } = await import('./judge-call-ZTUQMQRL.cjs');
       const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
       const create = getAgentFacade().create;
       return {
@@ -9379,7 +9501,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-WAEQI2DL.cjs');
   const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
-  const { withPersonalityContext } = await import('./context-B5J4GX2F.cjs');
+  const { withPersonalityContext } = await import('./context-4RSI3AXT.cjs');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9390,7 +9512,7 @@ async function persistMemoryFactIfWritePrompt(workspaceCwd, memoryConfig, userTe
   if (memoryConfig?.enabled !== true) return;
   const unstored = unstoredRememberWarning(userText);
   if (unstored !== void 0) {
-    chunk6LHQPOMI_cjs.diagFailure(unstored);
+    chunkRNXXYF22_cjs.diagFailure(unstored);
     return;
   }
   if (!isMemoryWritePrompt(userText)) return;
@@ -9404,36 +9526,10 @@ async function persistMemoryFactIfWritePrompt(workspaceCwd, memoryConfig, userTe
     });
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    chunk6LHQPOMI_cjs.diagFailure(`[theokit-sdk] memory write failed, nothing was stored: ${message}`);
+    chunkRNXXYF22_cjs.diagFailure(`[theokit-sdk] memory write failed, nothing was stored: ${message}`);
   }
 }
 
-// src/internal/concurrency/abort-utils.ts
-function anySignal(signals) {
-  const filtered = signals.filter((s) => s !== void 0);
-  if (filtered.length === 0) {
-    return new AbortController().signal;
-  }
-  if (filtered.length === 1) {
-    return filtered[0];
-  }
-  if (typeof AbortSignal.any === "function") {
-    return AbortSignal.any(filtered);
-  }
-  return ponyfillAny(filtered);
-}
-function ponyfillAny(signals) {
-  const ctrl = new AbortController();
-  for (const s of signals) {
-    if (s.aborted) {
-      ctrl.abort(s.reason);
-      return ctrl.signal;
-    }
-    s.addEventListener("abort", () => ctrl.abort(s.reason), { once: true });
-  }
-  return ctrl.signal;
-}
-
 // src/internal/runtime/lifecycle/wrap-completion-check-run.ts
 function wrapRunWithCompletionCheck(args) {
   const check = args.completionCheck;
@@ -9449,7 +9545,7 @@ function wrapRunWithCompletionCheck(args) {
       judgeOpts
     );
     const complete = !verdict.parseFailed && verdict.verdict === "done";
-    chunkJ6GXS5A2_cjs.emitRunEvent(args.onRunEvent, {
+    chunkL7JPXZ2C_cjs.emitRunEvent(args.onRunEvent, {
       type: "completion_check",
       complete,
       reason: verdict.reason
@@ -9766,7 +9862,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 };
-    chunkJ6GXS5A2_cjs.emitRunEvent(args.onRunEvent, {
+    chunkL7JPXZ2C_cjs.emitRunEvent(args.onRunEvent, {
       type: "tripwire",
       reason: res.tripwire.reason,
       processorId: res.tripwire.processorId
@@ -9856,7 +9952,7 @@ async function applyInputProcessors(inputs, message, rawUserText, options, sendM
   }
   const res = await runInputProcessors(processors, rawUserText, inputs.agentId);
   if (res.kind === "tripwire") {
-    chunkJ6GXS5A2_cjs.emitRunEvent(options.onRunEvent, {
+    chunkL7JPXZ2C_cjs.emitRunEvent(options.onRunEvent, {
       type: "tripwire",
       reason: res.tripwire.reason,
       processorId: res.tripwire.processorId
@@ -9873,7 +9969,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 chunkUNFBHV46_cjs.AgentDisposedError(inputs.agentId);
+  if (inputs.disposed) throw new chunkCEGU5AVD_cjs.AgentDisposedError(inputs.agentId);
   await consumePending(
     inputs.agentId,
     inputs.invalidationPending,
@@ -9889,7 +9985,7 @@ async function executeSendLocked(inputs, message, options) {
   if (inputs.options.onBeforeSend !== void 0) {
     await inputs.options.onBeforeSend({
       conversationId: inputs.agentId,
-      previousMessageCount: chunkN7ZIPW2N_cjs.getSessionMessages(inputs.agentId).length
+      previousMessageCount: chunkYOVZMN4P_cjs.getSessionMessages(inputs.agentId).length
     });
   }
   await inputs.runPreHook(userText);
@@ -9901,8 +9997,8 @@ async function executeSendLocked(inputs, message, options) {
     userText,
     sendOptions: options
   });
-  const priorMessages = [...chunkN7ZIPW2N_cjs.getSessionMessages(inputs.agentId)];
-  chunkN7ZIPW2N_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
+  const priorMessages = [...chunkYOVZMN4P_cjs.getSessionMessages(inputs.agentId)];
+  chunkYOVZMN4P_cjs.appendSessionMessage(inputs.agentId, { role: "user", text: userText });
   await persistMemoryFactIfWritePrompt(inputs.workspaceCwd, inputs.options.memory, userText);
   const memoryFacts = await readMemoryForSend(inputs.workspaceCwd, inputs.options.memory, userText);
   const memoryTools = void 0;
@@ -9953,7 +10049,7 @@ async function executeSendLocked(inputs, message, options) {
 function buildCompletionCheckDeps() {
   return {
     judge: async (ctx, opts) => {
-      const { judgeCallImpl } = await import('./judge-call-AQQYK6VT.cjs');
+      const { judgeCallImpl } = await import('./judge-call-ZTUQMQRL.cjs');
       const { getAgentFacade } = await import('./agent-factory-registry-UU46BUMU.cjs');
       return judgeCallImpl(ctx, opts, { create: getAgentFacade().create });
     }
@@ -9964,7 +10060,7 @@ function reportRefusedMemoryDirectoryOnce(workspaceCwd, directory, message) {
   const key = `${workspaceCwd}\0${directory ?? ""}`;
   if (reportedRefusedDirectories.has(key)) return;
   reportedRefusedDirectories.add(key);
-  chunk6LHQPOMI_cjs.diagFailure(
+  chunkRNXXYF22_cjs.diagFailure(
     `[theokit-sdk] memory is enabled but its directory was refused, so recall is empty on every turn and nothing is stored: ${message}`
   );
 }
@@ -9977,7 +10073,7 @@ function readMemoryForSend(workspaceCwd, memoryConfig, query) {
           ...query === void 0 ? {} : { query }
         });
       } catch (cause) {
-        if (!(cause instanceof chunkUNFBHV46_cjs.ConfigurationError)) throw cause;
+        if (!(cause instanceof chunkCEGU5AVD_cjs.ConfigurationError)) throw cause;
         reportRefusedMemoryDirectoryOnce(workspaceCwd, memoryConfig?.directory, cause.message);
         return [];
       }
@@ -9996,7 +10092,7 @@ function registerRunAsTask(run, agentId, taskOpt, userText) {
     promptPreview: userText.slice(0, 120),
     ...opts.meta ?? {}
   };
-  void chunkJ6GXS5A2_cjs.submit({
+  void chunkL7JPXZ2C_cjs.submit({
     kind: "run",
     work: async (ctx) => {
       ctx.signal.addEventListener(
@@ -10007,7 +10103,7 @@ function registerRunAsTask(run, agentId, taskOpt, userText) {
         },
         { once: true }
       );
-      const result = await run.wait();
+      const result = await readRunResolving(run);
       ctx.emit({ status: result.status, runId: run.id });
       return { status: result.status, result: result.result };
     },
@@ -10064,7 +10160,7 @@ function reportUnknownLocalOptions(local) {
     reported.add(key);
     const guess = nearest(key);
     const hint = guess === void 0 ? "" : ` Did you mean \`${guess}\`?`;
-    chunk6LHQPOMI_cjs.diag(
+    chunkRNXXYF22_cjs.diag(
       `[theokit] \`local.${key}\` is not an option this SDK version knows, so it was ignored.${hint}
 `
     );
@@ -10155,7 +10251,7 @@ var LocalAgent = class {
     this.options = options;
     this.workspaceCwd = resolveCwd(options.local?.cwd);
     this.transcriptBaseDir = resolveSessionDir(options.local);
-    this.sessionStore = options.local?.sessionStore ?? new chunkNQVWSSX2_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
+    this.sessionStore = options.local?.sessionStore ?? new chunk6OCJWGVD_cjs.FsSessionStore({ baseDir: this.transcriptBaseDir, cwd: this.workspaceCwd });
     this.settingSourcesIncludeProject = includesSetting(options, "project");
     this.settingSourcesIncludePlugins = includesSetting(options, "plugins");
     const sub = bootstrapSubmanagers({
@@ -10172,7 +10268,7 @@ var LocalAgent = class {
     if (sub.plugins !== void 0) this.plugins = sub.plugins;
     reportUnknownLocalOptions(options.local);
     const compatSources = resolveCompatSources(options, this.workspaceCwd);
-    chunkTY56BKSK_cjs.reportUndeclaredSources(this.workspaceCwd, compatSources);
+    chunkYQ3XC6C2_cjs.reportUndeclaredSources(this.workspaceCwd, compatSources);
     this.hooksExecutor = new HooksExecutor(this.workspaceCwd, compatSources, options.local?.hooks);
     this.defaultMemoryProviderForLoop = createLocalAgentMemoryProvider({
       agentOptions: options,
@@ -10200,7 +10296,7 @@ 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 chunkC7GKRGKN_cjs.loadSubagents(
+    this.resolvedSubagents = await chunkWDVG5R2Q_cjs.loadSubagents(
       this.workspaceCwd,
       this.settingSourcesIncludeProject,
       this.options.agents,
@@ -10208,7 +10304,7 @@ var LocalAgent = class {
     );
     await acquireLeaseIfPossible(this.sessionStore, this.agentId);
     try {
-      await chunkN7ZIPW2N_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
+      await chunkYOVZMN4P_cjs.hydrateSession(this.agentId, { store: this.sessionStore, cwd: this.workspaceCwd });
       await this.personalityStore.hydrate(this.agentId);
     } catch (err) {
       await releaseLeaseIfPossible(this.sessionStore, this.agentId);
@@ -10268,7 +10364,7 @@ var LocalAgent = class {
       return;
     }
     if (options.task !== void 0) registerRunAsTask(run, this.agentId, options.task, userText);
-    resolve(run);
+    resolve(callerView(run, this.options.throwOnError));
     try {
       await runPostRunLifecycle({
         run,
@@ -10366,7 +10462,7 @@ var LocalAgent = class {
       agentId: this.agentId
     });
     if (preRun.blocked) {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_cjs.ConfigurationError(
         `preRun hook denied execution: ${preRun.reason ?? "unspecified"}`,
         { code: "hook_denied" }
       );
@@ -10472,6 +10568,9 @@ var LocalAgent = class {
     return localAgentStreamToCompletion(this, message, options);
   }
 };
+function callerView(run, throwOnError) {
+  return throwOnError === true ? wrapRunWithThrowOnError(run) : run;
+}
 function resolveCwd(cwd) {
   return (Array.isArray(cwd) ? cwd[0] : cwd) ?? process.cwd();
 }
@@ -10498,7 +10597,7 @@ async function guardAgainstIdCollision(options) {
   const persistenceCwd = resolveAgentPersistenceCwd(options);
   await hydrateRegistryFromDisk(persistenceCwd);
   if (getRegisteredAgent(options.agentId) !== void 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_cjs.ConfigurationError(
       `Agent "${options.agentId}" already exists. Use Agent.resume("${options.agentId}") to reattach, or pick a different agentId.`,
       { code: "agent_id_already_exists" }
     );
@@ -10531,7 +10630,7 @@ async function maybeInjectHandoffTools(options) {
     const spec = "@theokit/sdk-handoff/internal/tool-injector";
     mod = await import(spec);
   } catch (err) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError(
+    throw new chunkCEGU5AVD_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 }
     );
@@ -10549,40 +10648,40 @@ async function maybeInjectHandoffTools(options) {
   };
 }
 function keyWillFlowToProvider(apiKey, provider) {
-  if (chunkBZKF7TXX_cjs.isFixtureApiKey(apiKey)) return false;
-  if (chunkBZKF7TXX_cjs.getConfiguredBaseUrl() !== void 0) return false;
+  if (chunkLSWHDOCL_cjs.isFixtureApiKey(apiKey)) return false;
+  if (chunkLSWHDOCL_cjs.getConfiguredBaseUrl() !== void 0) return false;
   if (provider === void 0) return false;
-  const profile = chunkSGC7LSHF_cjs.getProviderProfile(provider);
+  const profile = chunkLO6LIUZ6_cjs.getProviderProfile(provider);
   if (profile === void 0) return false;
   return profile.authType !== "none";
 }
 function missingApiKeyMessage() {
-  const present = chunkBZKF7TXX_cjs.presentProviderCredentialEnvVars();
-  const base = `Missing API key \u2014 set ${chunk6LHQPOMI_cjs.API_KEY_ENV_VAR}, or pass \`apiKey\` to Agent.create()`;
+  const present = chunkLSWHDOCL_cjs.presentProviderCredentialEnvVars();
+  const base = `Missing API key \u2014 set ${chunkRNXXYF22_cjs.API_KEY_ENV_VAR}, or pass \`apiKey\` to Agent.create()`;
   if (present.length === 0) return `${base}.`;
   return `${base}. ${present.join(" and ")} ${present.length === 1 ? "is" : "are"} set, but a provider credential is not read from the environment automatically \u2014 pass it explicitly, e.g. \`Agent.create({ apiKey: process.env.${present[0]}, ... })\`.`;
 }
 function providerNeedsCallerKey(provider) {
   if (provider === void 0) return true;
-  const profile = chunkSGC7LSHF_cjs.getProviderProfile(provider);
+  const profile = chunkLO6LIUZ6_cjs.getProviderProfile(provider);
   if (profile === void 0) return true;
   return profile.authType === "api_key";
 }
 async function createLocalAgent(options) {
   const provider = providerFromModelId(normalizeModel(options.model)?.id);
-  const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(options.apiKey);
+  const apiKey = chunkRNXXYF22_cjs.resolveApiKey(options.apiKey);
   if (apiKey === void 0) {
     if (providerNeedsCallerKey(provider)) {
-      throw new chunkUNFBHV46_cjs.AuthenticationError(missingApiKeyMessage(), { code: "missing_api_key" });
+      throw new chunkCEGU5AVD_cjs.AuthenticationError(missingApiKeyMessage(), { code: "missing_api_key" });
     }
   } else {
     const willFlowToProvider = keyWillFlowToProvider(apiKey, provider);
-    const shape = chunkBZKF7TXX_cjs.validateApiKeyShape(apiKey, {
+    const shape = chunkLSWHDOCL_cjs.validateApiKeyShape(apiKey, {
       strict: willFlowToProvider,
       ...willFlowToProvider ? { provider } : {}
     });
     if (shape.malformed) {
-      throw new chunkUNFBHV46_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
+      throw new chunkCEGU5AVD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
     }
   }
   const agent = new LocalAgent(options);
@@ -10590,21 +10689,21 @@ async function createLocalAgent(options) {
   return agent;
 }
 async function createCloudAgent(options) {
-  const apiKey = chunk6LHQPOMI_cjs.resolveApiKey(options.apiKey);
+  const apiKey = chunkRNXXYF22_cjs.resolveApiKey(options.apiKey);
   if (apiKey === void 0) {
-    throw new chunkUNFBHV46_cjs.ConfigurationError("Missing API key for cloud agent", {
+    throw new chunkCEGU5AVD_cjs.ConfigurationError("Missing API key for cloud agent", {
       code: "missing_api_key"
     });
   }
-  const shape = chunkBZKF7TXX_cjs.validateApiKeyShape(apiKey);
+  const shape = chunkLSWHDOCL_cjs.validateApiKeyShape(apiKey);
   if (shape.malformed) {
-    throw new chunkUNFBHV46_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
+    throw new chunkCEGU5AVD_cjs.AuthenticationError(shape.message, { code: "malformed_api_key" });
   }
-  const baseUrl = chunkBZKF7TXX_cjs.getConfiguredBaseUrl();
+  const baseUrl = chunkLSWHDOCL_cjs.getConfiguredBaseUrl();
   if (baseUrl === void 0) {
     return new CloudAgent(options);
   }
-  const response = await chunkBZKF7TXX_cjs.httpRequest("/v1/agents", {
+  const response = await chunkLSWHDOCL_cjs.httpRequest("/v1/agents", {
     apiKey,
     method: "POST",
     body: {
@@ -10629,7 +10728,7 @@ function resolveAgentPersistenceCwd(options) {
   return process.cwd();
 }
 async function rehydrateExistingAgent(agentId, existing, options) {
-  await chunkBZKF7TXX_cjs.discoverProviderPlugins();
+  await chunkLSWHDOCL_cjs.discoverProviderPlugins();
   await validateRehydratedAgent(agentId, existing);
   const mergedLocal = options.local !== void 0 && existing.options.local !== void 0 ? { ...existing.options.local, ...options.local } : options.local ?? existing.options.local;
   const mergedMemory = mergeResumedMemory(existing.options.memory, options.memory);
@@ -10645,7 +10744,7 @@ async function rehydrateExistingAgent(agentId, existing, options) {
     mcpServers: void 0,
     agentId
   };
-  chunkZD66GFH5_cjs.resolveMaxFacts(mergedOptions.memory?.maxFacts);
+  chunkSDZ4XDWS_cjs.resolveMaxFacts(mergedOptions.memory?.maxFacts);
   if (existing.runtime === "cloud") {
     return new CloudAgent(mergedOptions, agentId);
   }
@@ -10667,13 +10766,13 @@ async function validateRehydratedAgent(agentId, entry) {
   try {
     info = await promises.stat(candidate);
   } catch (cause) {
-    throw new chunkUNFBHV46_cjs.UnknownAgentError(
+    throw new chunkCEGU5AVD_cjs.UnknownAgentError(
       `Agent "${agentId}" cannot be rehydrated \u2014 workspace cwd "${candidate}" is missing or inaccessible.`,
       { code: "agent_rehydration_failed", cause }
     );
   }
   if (!info.isDirectory()) {
-    throw new chunkUNFBHV46_cjs.UnknownAgentError(
+    throw new chunkCEGU5AVD_cjs.UnknownAgentError(
       `Agent "${agentId}" cannot be rehydrated \u2014 workspace cwd "${candidate}" exists but is not a directory.`,
       { code: "agent_rehydration_failed" }
     );
@@ -10728,7 +10827,7 @@ async function getRegisteredAgentOrThrow(agentId, cwd = process.cwd()) {
     agent = getRegisteredAgent(agentId);
   }
   if (agent === void 0) {
-    throw new chunkUNFBHV46_cjs.UnknownAgentError(`Agent ${agentId} not found`, { code: "unknown_agent" });
+    throw new chunkCEGU5AVD_cjs.UnknownAgentError(`Agent ${agentId} not found`, { code: "unknown_agent" });
   }
   return agent;
 }
@@ -10789,7 +10888,7 @@ var Agent = class _Agent {
       pluginCount: enabledPluginNames(options.plugins).length
     });
     try {
-      await chunkBZKF7TXX_cjs.discoverProviderPlugins();
+      await chunkLSWHDOCL_cjs.discoverProviderPlugins();
       const agent = await runCreateUnderSpan(options, span);
       return agent;
     } catch (err) {
@@ -10825,13 +10924,13 @@ var Agent = class _Agent {
    * @public
    */
   static async prompt(message, options) {
-    const agent = await _Agent.create(options);
+    const agent = await _Agent.create({ ...options, throwOnError: false });
     try {
       const run = await agent.send(message);
       const result = await run.wait();
       if (options.throwOnError === true && result.status === "error" && result.error !== void 0) {
-        throw new chunkUNFBHV46_cjs.AgentRunError(result.error.message, {
-          code: chunkUNFBHV46_cjs.coerceToKnownAgentRunErrorCode(result.error.code),
+        throw new chunkCEGU5AVD_cjs.AgentRunError(result.error.message, {
+          code: chunkCEGU5AVD_cjs.coerceToKnownAgentRunErrorCode(result.error.code),
           cause: result.error.cause
         });
       }
@@ -10858,7 +10957,7 @@ var Agent = class _Agent {
     if (existing !== void 0) {
       return await rehydrateExistingAgent(agentId, existing, options);
     }
-    throw new chunkUNFBHV46_cjs.UnknownAgentError(
+    throw new chunkCEGU5AVD_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" }
     );
@@ -10887,7 +10986,7 @@ var Agent = class _Agent {
    * @public
    */
   static async generateObject(options) {
-    const { generateObjectImpl } = await import('./generate-object-YHTWG5DB.cjs');
+    const { generateObjectImpl } = await import('./generate-object-XBWD2PU7.cjs');
     return generateObjectImpl(options, {
       create: (opts) => _Agent.create(opts),
       delete: (agentId) => _Agent.delete(agentId)
@@ -10911,7 +11010,7 @@ var Agent = class _Agent {
       delete: (agentId) => _Agent.delete(agentId)
     };
     async function* wrapper() {
-      streamObjectImport ??= import('./stream-object-TKVGGA54.cjs');
+      streamObjectImport ??= import('./stream-object-TEEK3CAX.cjs');
       const { streamObjectImpl } = await streamObjectImport;
       yield* streamObjectImpl(options, deps);
     }
@@ -10935,7 +11034,7 @@ var Agent = class _Agent {
    * @public
    */
   static async batch(prompts, options) {
-    const { batchImpl } = await import('./batch-U4SO4RLX.cjs');
+    const { batchImpl } = await import('./batch-IZ5EDKJ5.cjs');
     return batchImpl(prompts, options, { create: (opts) => _Agent.create(opts) });
   }
   /**
@@ -11038,14 +11137,14 @@ var Agent = class _Agent {
    */
   static async getRun(runId, options = {}) {
     if (options.runtime === "cloud") {
-      throw new chunkUNFBHV46_cjs.ConfigurationError(
+      throw new chunkCEGU5AVD_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 chunkUNFBHV46_cjs.UnknownAgentError(
+    throw new chunkCEGU5AVD_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" }
     );
@@ -11087,9 +11186,9 @@ var Agent = class _Agent {
    */
   static async compact(agentId, options = {}) {
     const reg = await requireLocalAgent(agentId, "compact");
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-2AETONOS.cjs');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-NM56BREJ.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
-    return chunkN7ZIPW2N_cjs.enqueueSessionWrite(
+    return chunkYOVZMN4P_cjs.enqueueSessionWrite(
       cwd,
       agentId,
       () => compactSessionTranscript({
@@ -11117,7 +11216,7 @@ var Agent = class _Agent {
    */
   static async injectSessionTurn(agentId, turn) {
     const reg = await requireLocalAgent(agentId, "injectSessionTurn");
-    const { injectSessionTurn } = await import('./inject-session-W4UKACYJ.cjs');
+    const { injectSessionTurn } = await import('./inject-session-JVTZNQF6.cjs');
     const { cwd, model, store } = await openLocalStore(reg);
     await injectSessionTurn({
       store,
@@ -11147,7 +11246,7 @@ var Agent = class _Agent {
    */
   static async transcript(agentId) {
     const reg = await requireLocalAgent(agentId, "transcript");
-    const { readSessionMessages } = await import('./agent-session-store-SVEJHSUA.cjs');
+    const { readSessionMessages } = await import('./agent-session-store-WP6NGDVX.cjs');
     const { store } = await openLocalStore(reg);
     return readSessionMessages(store, agentId);
   }
@@ -11168,7 +11267,7 @@ var Agent = class _Agent {
    */
   static async describe(agentId) {
     const agent = await getRegisteredAgentOrThrow(agentId);
-    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-5TZCAIYQ.cjs');
+    const { loadSubagents: loadSubagents2 } = await import('./subagents-loader-TXOA5EJJ.cjs');
     const settingSources = agent.options.local?.settingSources;
     const subagents = await loadSubagents2(
       agent.cwd ?? process.cwd(),
@@ -11231,12 +11330,12 @@ async function getOrCreateUncached(agentId, options) {
   try {
     return await Agent.resume(agentId, options);
   } catch (err) {
-    if (!(err instanceof chunkUNFBHV46_cjs.UnknownAgentError)) throw err;
+    if (!(err instanceof chunkCEGU5AVD_cjs.UnknownAgentError)) throw err;
   }
   try {
     return await Agent.create({ ...options, agentId });
   } catch (err) {
-    if (err instanceof chunkUNFBHV46_cjs.ConfigurationError && err.code === "agent_id_already_exists") {
+    if (err instanceof chunkCEGU5AVD_cjs.ConfigurationError && err.code === "agent_id_already_exists") {
       return await Agent.resume(agentId, options);
     }
     throw err;
@@ -11257,7 +11356,7 @@ async function requireLocalAgent(agentId, operation) {
     reg = getRegisteredAgent(agentId);
   }
   if (reg === void 0 || reg.runtime !== "local") {
-    throw new chunkUNFBHV46_cjs.UnknownAgentError(
+    throw new chunkCEGU5AVD_cjs.UnknownAgentError(
       `No local agent "${agentId}" registered \u2014 ${operation} targets local sessions.`
     );
   }
@@ -11267,8 +11366,8 @@ async function openLocalStore(reg) {
   const cwd = reg.cwd ?? process.cwd();
   const optModel = reg.options.model;
   const model = reg.model?.id ?? (typeof optModel === "string" ? optModel : optModel?.id) ?? "unknown";
-  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-IQ6PEHYF.cjs');
-  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-RACG7BK2.cjs');
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-S2AXVJIX.cjs');
+  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-7TZ6HXSX.cjs');
   const configuredSessionDir = reg.options.local?.sessionDir ?? reg.options.local?.baseDir;
   const baseDir = configuredSessionDir !== void 0 ? expandTilde2(configuredSessionDir) : defaultBaseDir2();
   return { cwd, model, store: new FsSessionStore2({ baseDir, cwd }) };
@@ -11288,5 +11387,5 @@ exports.managedSettingsPathFor = managedSettingsPathFor;
 exports.openRouterMemoryEmbeddingProviderAdapter = openRouterMemoryEmbeddingProviderAdapter;
 exports.readManagedSettings = readManagedSettings;
 exports.resolveSessionDir = resolveSessionDir;
-//# sourceMappingURL=chunk-5OHB5HJF.cjs.map
-//# sourceMappingURL=chunk-5OHB5HJF.cjs.map
+//# sourceMappingURL=chunk-Q6WT5535.cjs.map
+//# sourceMappingURL=chunk-Q6WT5535.cjs.map