@theokit/sdk 4.36.0 → 4.37.0

package/dist/{chunk-EKFA76N4.js → chunk-F3X7Q4BF.js}

@@ -1,39 +1,39 @@
 import { extractCodePlugins } from './chunk-2SFBB54R.js';
-import { submit, emitRunEvent } from './chunk-HRA3CPGG.js';
-import { enqueueSessionWrite, hydrateSession, flushSessionWrites, descartarSessao, persistTurnToTranscript, appendSessionMessage, getSessionMessages, clearSession } from './chunk-7BTE3RXJ.js';
-import { FsSessionStore } from './chunk-OKXUMCGM.js';
-import { discoverProviderPlugins, CircuitBreaker, buildDefaultSummarizer, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, tryFirstEvent, relayStream, mapOpenAICompatibleError, renderToolResultContentText } from './chunk-IX2LKBCD.js';
-import { IndexManager, writeSessionSummary, memoryDir, globalEmbeddingCache, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-XAUBQMQU.js';
-import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-XIG2IE3L.js';
+import { submit, emitRunEvent } from './chunk-HEN5WXXI.js';
+import { enqueueSessionWrite, hydrateSession, persistTurnToTranscript, flushSessionWrites, appendSessionMessage, getSessionMessages, descartarSessao, clearSession } from './chunk-5SB4V74H.js';
+import { FsSessionStore } from './chunk-YVTNFKZO.js';
+import { discoverProviderPlugins, getConfiguredBaseUrl, httpRequest, isFixtureApiKey, shouldUseRealLocalRuntime, CircuitBreaker, buildDefaultSummarizer, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, tryFirstEvent, relayStream, mapOpenAICompatibleError, renderToolResultContentText } from './chunk-GL7CFBVC.js';
+import { IndexManager, writeSessionSummary, memoryDir, globalEmbeddingCache, appendFact, readFacts, legacyMemoryJsonPath, memoryMdPath, appendFactToMarkdown } from './chunk-DCJ5MCJ3.js';
+import { loadHookConfig, warnOnce, currentPersonalityContext, warnPersonalitySwitchInsideFork } from './chunk-F6Y4IEQM.js';
 import { resolveChildEnv } from './chunk-7GFX45DD.js';
-import { readVersionedJson, getTheokitHome, writeVersionedJson } from './chunk-XV2RBL6D.js';
+import { readVersionedJson, getTheokitHome, writeVersionedJson } from './chunk-ZW345YOI.js';
 import { sanitizeToolInput } from './chunk-U54XCYG3.js';
 import { subAgentToolsFromDefinitions, inheritSubAgentCredentials } from './chunk-FV3YEMQ7.js';
 import { setAgentFacade } from './chunk-6X6ID4MO.js';
 import { findGitRoot, DEFAULT_DISCOVERY_SPECS, walkUpForFile, walkUpForGlob } from './chunk-UJ7IQJAG.js';
 import { withToolWhitelist, checkToolWhitelist } from './chunk-7AD3ZTZL.js';
-import { mapWithConcurrency } from './chunk-V4XRLPEF.js';
-import { withFileLock } from './chunk-UAYYNWYJ.js';
+import { mapWithConcurrency } from './chunk-QGDKZDPN.js';
+import { withFileLock } from './chunk-YHZXBDAW.js';
 import { withCwdMutex } from './chunk-2XLKLVVR.js';
-import { defaultBaseDir, expandTilde } from './chunk-Q56IYTBZ.js';
+import { defaultBaseDir, expandTilde } from './chunk-XAEAMI5H.js';
 import { toJsonSchema } from './chunk-4VPXM6UU.js';
-import { atomicWriteJson } from './chunk-S2BBRVQX.js';
-import { loadSubagents } from './chunk-BNIFFFH3.js';
-import { resolveEffectiveContextWindow, CONTEXT_WINDOW_FLOOR, CONTEXT_WINDOW_MARGIN } from './chunk-RKG6QFCJ.js';
+import { atomicWriteJson } from './chunk-56OXYUZE.js';
+import { loadSubagents } from './chunk-YCXMSDSP.js';
+import { resolveEffectiveContextWindow, CONTEXT_WINDOW_FLOOR, CONTEXT_WINDOW_MARGIN } from './chunk-6VP3XGEK.js';
 import { parseModelId } from './chunk-X2FR4OIT.js';
-import { getCatalogModelInfo, registerBuiltins, getProviderProfile, registerProvider, isPatchedModelKey } from './chunk-KAP4GJHO.js';
-import { escapeBlockBody, buildSkillsBlock, discoverSkills, stripSkillFrontmatter } from './chunk-5IB2UKSN.js';
-import { validateArtifactPath, PathTraversalError, safePathJoin } from './chunk-POQT2OIF.js';
-import { readWorkspaceDir, parseSimpleYaml } from './chunk-FKCC2MED.js';
-import { AgentRunError, coerceToKnownAgentRunErrorCode, UnknownAgentError, ConfigurationError, AuthenticationError, UnsupportedRunOperationError, AgentDisposedError, NetworkError, IntegrationNotConnectedError, RateLimitError, TheokitAgentError } from './chunk-WLKFWQSJ.js';
-import { redactSecrets } from './chunk-JTFYYKDT.js';
+import { getCatalogModelInfo, registerBuiltins, getProviderProfile, registerProvider, isPatchedModelKey } from './chunk-77WHPVXE.js';
+import { escapeBlockBody, buildSkillsBlock, discoverSkills, stripSkillFrontmatter } from './chunk-2WFB5ZOX.js';
+import { validateArtifactPath, PathTraversalError, safePathJoin } from './chunk-WDGCZDRG.js';
+import { readWorkspaceDir, parseSimpleYaml } from './chunk-UQPDFW4E.js';
+import { AgentRunError, coerceToKnownAgentRunErrorCode, UnknownAgentError, ConfigurationError, AuthenticationError, UnsupportedRunOperationError, AgentDisposedError, NetworkError, TheokitAgentError } from './chunk-CD73YHEH.js';
+import { diag, redactSecrets } from './chunk-TAPQWDW2.js';
 import { stat, mkdir, readFile, readdir, access, unlink } from 'fs/promises';
 import { randomUUID, createHash } from 'crypto';
-import { existsSync } from 'fs';
 import { join, dirname, resolve, relative, isAbsolute } from 'path';
 import { spawn } from 'child_process';
 import { z } from 'zod';
 import { createRequire } from 'module';
+import { existsSync } from 'fs';
 import { homedir } from 'os';
 
 // src/agent-builder.ts
@@ -221,7 +221,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-YJPDV5BS.js');
+  const { generateObjectImpl, GenerateObjectError } = await import('./generate-object-I7UD4NWN.js');
   const answer = structurableAnswerOrThrow(result, GenerateObjectError);
   const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
   const facade = getAgentFacade();
@@ -317,58 +317,6 @@ function generateRequestId() {
 function isLocalAgentId(id) {
   return id.startsWith(PREFIX.localAgent);
 }
-var FIXTURE_API_KEY_PREFIX = "theo_test_";
-function isFixtureApiKey(apiKey) {
-  if (apiKey === void 0) return false;
-  return apiKey.startsWith(FIXTURE_API_KEY_PREFIX);
-}
-function getConfiguredBaseUrl() {
-  const value = process.env.THEOKIT_API_BASE_URL;
-  if (value === void 0 || value.length === 0) return void 0;
-  return value;
-}
-function shouldUseFixtureMode(apiKey) {
-  if (getConfiguredBaseUrl() !== void 0) return false;
-  return isFixtureApiKey(apiKey);
-}
-function shouldUseRealLocalRuntime(apiKey) {
-  if (isFixtureApiKey(apiKey)) return false;
-  if (apiKey === void 0 || apiKey.length === 0) return false;
-  return typeof process.env.ANTHROPIC_API_KEY === "string" && process.env.ANTHROPIC_API_KEY.length > 0 || typeof process.env.OPENAI_API_KEY === "string" && process.env.OPENAI_API_KEY.length > 0 || typeof process.env.OPENROUTER_API_KEY === "string" && process.env.OPENROUTER_API_KEY.length > 0 || isAwsBedrockAuthAvailable() || isGcpVertexAuthAvailable() || isLocalNoAuthProviderAvailable();
-}
-function isAwsBedrockAuthAvailable() {
-  if (typeof process.env.AWS_BEARER_TOKEN_BEDROCK === "string" && process.env.AWS_BEARER_TOKEN_BEDROCK.length > 0) {
-    return true;
-  }
-  if (typeof process.env.AWS_ACCESS_KEY_ID === "string" && process.env.AWS_ACCESS_KEY_ID.length > 0) {
-    return true;
-  }
-  if (typeof process.env.AWS_PROFILE === "string" && process.env.AWS_PROFILE.length > 0) {
-    return true;
-  }
-  return awsCredentialsFileExists();
-}
-function awsCredentialsFileExists() {
-  try {
-    const home = process.env.HOME ?? process.env.USERPROFILE;
-    if (home === void 0 || home.length === 0) return false;
-    return existsSync(`${home}/.aws/credentials`) || existsSync(`${home}/.aws/config`);
-  } catch {
-    return false;
-  }
-}
-function isGcpVertexAuthAvailable() {
-  if (typeof process.env.GOOGLE_APPLICATION_CREDENTIALS === "string" && process.env.GOOGLE_APPLICATION_CREDENTIALS.length > 0) {
-    return true;
-  }
-  if (typeof process.env.GOOGLE_CLOUD_PROJECT === "string" && process.env.GOOGLE_CLOUD_PROJECT.length > 0) {
-    return true;
-  }
-  return false;
-}
-function isLocalNoAuthProviderAvailable() {
-  return true;
-}
 
 // src/internal/runtime/model-selection.ts
 function normalizeModel(m) {
@@ -574,7 +522,7 @@ function fromSerialized(entry) {
 
 // src/internal/runtime/registry/agent-registry.ts
 var agents = /* @__PURE__ */ new Map();
-var hydratedCwds = /* @__PURE__ */ new Set();
+var hydrations = /* @__PURE__ */ new Map();
 var pendingSaves = /* @__PURE__ */ new Map();
 var dirtyCwds = /* @__PURE__ */ new Set();
 function resolveRegistryCwd(agent) {
@@ -602,7 +550,7 @@ function scheduleSaveForCwd(cwd) {
       }
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(`[theokit-sdk] registry persist failed (${cwd}): ${msg}
+      diag(`[theokit-sdk] registry persist failed (${cwd}): ${msg}
 `);
     } finally {
       pendingSaves.delete(cwd);
@@ -618,10 +566,11 @@ function registerAgent(agent) {
 function getRegisteredAgent(agentId) {
   return agents.get(agentId);
 }
-function listRegisteredAgents(runtime) {
-  const all = Array.from(agents.values());
-  if (runtime === void 0) return all;
-  return all.filter((agent) => agent.runtime === runtime);
+function listRegisteredAgents(runtime, cwd) {
+  let out = Array.from(agents.values());
+  if (runtime !== void 0) out = out.filter((agent) => agent.runtime === runtime);
+  if (cwd !== void 0) out = out.filter((agent) => resolveRegistryCwd(agent) === cwd);
+  return out;
 }
 function updateRegisteredAgent(agentId, update) {
   const existing = agents.get(agentId);
@@ -644,14 +593,21 @@ function removeRegisteredAgent(agentId) {
   return removed;
 }
 async function hydrateRegistryFromDisk(cwd) {
-  if (hydratedCwds.has(cwd)) return;
-  hydratedCwds.add(cwd);
-  const persisted = await loadRegistry(cwd);
-  for (const [id, entry] of Object.entries(persisted)) {
-    if (!agents.has(id)) {
-      agents.set(id, fromSerialized(entry));
+  const emAndamento = hydrations.get(cwd);
+  if (emAndamento !== void 0) return emAndamento;
+  const hidratacao = (async () => {
+    const persisted = await loadRegistry(cwd);
+    for (const [id, entry] of Object.entries(persisted)) {
+      if (!agents.has(id)) {
+        agents.set(id, fromSerialized(entry));
+      }
     }
-  }
+  })().catch((cause) => {
+    hydrations.delete(cwd);
+    throw cause;
+  });
+  hydrations.set(cwd, hidratacao);
+  return hidratacao;
 }
 async function flushRegistrySaves(cwd) {
   if (cwd !== void 0) {
@@ -935,14 +891,12 @@ async function writeMigratedFacts(cwd, jsonPath, facts) {
   try {
     for (const fact of facts) await appendFactToMarkdown(cwd, fact);
     await unlink(jsonPath).catch(() => void 0);
-    process.stderr.write(
-      `[theokit-sdk] migrated ${facts.length} fact(s) from ${jsonPath} to MEMORY.md
-`
-    );
+    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);
-    process.stderr.write(`[theokit-sdk] memory migration failed (readonly fs?): ${message}
+    diag(`[theokit-sdk] memory migration failed (readonly fs?): ${message}
 `);
     return { migrated: false, factCount: 0, reason: "readonly-fs" };
   }
@@ -957,7 +911,7 @@ async function migrateLegacyJson(cwd, config) {
     return { migrated: false, factCount: 0, reason: "no-legacy-json" };
   }
   if (await fileExists(memoryMdPath(cwd))) {
-    process.stderr.write(
+    diag(
       `[theokit-sdk] memory migration skipped: both MEMORY.md and legacy JSON exist at ${jsonPath}; leaving both intact
 `
     );
@@ -1401,6 +1355,37 @@ var FixtureRunBase = class {
     while (index < this.script.events.length) {
       yield this.script.events[index++];
     }
+    yield* this.terminalErrorEvent();
+  }
+  /**
+   * theokit#101 — quando o run termina em erro, `stream()` tem de DIZER.
+   *
+   * O erro sempre existiu: o loop o registra em `ctx.error` e `wait()` devolve
+   * `status: 'error'` com a mensagem. Só o `stream()` não o mencionava — ele drena
+   * `script.events` e para. Uma falha de provider (404 "No endpoints found", auth, timeout)
+   * produzia um turno que parecia bem-sucedido e vazio, em TODA superfície que consome o
+   * stream: HTTP web, MCP, stdio, TUI in-process.
+   *
+   * Erro silencioso é o pior tipo (Regra Inquebrável 8). E a assimetria era o que o tornava
+   * difícil de diagnosticar: quem depurasse por `wait()` via o erro e não reproduziria o
+   * relato de quem depurava pelo stream.
+   *
+   * Emite `SDKStatusMessage` com `status: "ERROR"` — o tipo JÁ EXISTE na união `SDKMessage`
+   * e já é esperado por quem consome. Um tipo novo seria breaking para todo consumidor que
+   * faz switch exaustivo; este é aditivo, e um consumidor que ignore `status` simplesmente
+   * segue como antes — nunca pior que hoje.
+   */
+  *terminalErrorEvent() {
+    if (this.status !== "error") return;
+    const detail = this.script.errorDetail;
+    yield {
+      type: "status",
+      agent_id: this.agentId,
+      run_id: this.id,
+      status: "ERROR",
+      // Sem mensagem, o consumidor sabe QUE falhou e não O QUÊ — que é metade do defeito.
+      ...detail?.message !== void 0 ? { message: detail.message } : {}
+    };
   }
   wait() {
     return this.terminationPromise;
@@ -2036,96 +2021,6 @@ function isStdioCommandConfig(config) {
 function isLocalPath(command) {
   return command.startsWith("/") || command.startsWith("~/") || command.startsWith("./") || command.startsWith("../");
 }
-
-// src/internal/http.ts
-var DEFAULT_BASE_URL = "https://api.usetheo.dev";
-function resolveBaseUrl() {
-  return getConfiguredBaseUrl() ?? DEFAULT_BASE_URL;
-}
-async function httpRequest(path, options) {
-  const url = `${resolveBaseUrl()}${path}`;
-  const fetchFn = options.fetchFn ?? globalThis.fetch;
-  const headers = {
-    "content-type": "application/json",
-    authorization: `Bearer ${options.apiKey}`,
-    ...options.headers ?? {}
-  };
-  const body = options.body !== void 0 ? JSON.stringify(options.body) : void 0;
-  const response = await safeFetch(fetchFn, url, {
-    method: options.method ?? "GET",
-    headers,
-    body
-  });
-  if (!response.ok) {
-    const parsed = await safeParseJsonResponse(response);
-    throw mapHttpStatusToError(response.status, parsed);
-  }
-  return await safeParseJsonResponse(response);
-}
-async function safeFetch(fetchFn, url, init) {
-  try {
-    return await fetchFn(url, init);
-  } catch (cause) {
-    throw new NetworkError("HTTP request failed", { code: "network_error", cause });
-  }
-}
-async function safeParseJsonResponse(response) {
-  try {
-    return await response.json();
-  } catch {
-    return void 0;
-  }
-}
-function mapHttpStatusToError(status, body) {
-  const envelope = extractErrorEnvelope(body);
-  const message = envelope.message ?? `HTTP ${status}`;
-  const errorOptions = {
-    code: envelope.code,
-    protoErrorCode: envelope.protoErrorCode,
-    cause: body
-  };
-  if (envelope.code === "integration_not_connected") {
-    return new IntegrationNotConnectedError(message, {
-      provider: envelope.provider ?? "unknown",
-      helpUrl: envelope.helpUrl ?? "",
-      code: envelope.code,
-      cause: body
-    });
-  }
-  if (status === 401 || status === 403) {
-    return new AuthenticationError(message, errorOptions);
-  }
-  if (status === 429) {
-    return new RateLimitError(message, errorOptions);
-  }
-  if (status >= 400 && status < 500) {
-    return new ConfigurationError(message, errorOptions);
-  }
-  if (status >= 500) {
-    return new NetworkError(message, errorOptions);
-  }
-  return new UnknownAgentError(message, errorOptions);
-}
-function extractErrorEnvelope(body) {
-  if (!body || typeof body !== "object") return {};
-  const record = body;
-  const inner = record.error;
-  const source = inner && typeof inner === "object" ? inner : record;
-  return readEnvelopeFields(source);
-}
-function readEnvelopeFields(record) {
-  return {
-    code: pickString(record, "code"),
-    message: pickString(record, "message"),
-    protoErrorCode: pickString(record, "protoErrorCode"),
-    provider: pickString(record, "provider"),
-    helpUrl: pickString(record, "helpUrl")
-  };
-}
-function pickString(record, key) {
-  const value = record[key];
-  return typeof value === "string" ? value : void 0;
-}
 var SCHEMA_VERSION2 = 1;
 var FILE_NAME = "personality.json";
 function emptyState() {
@@ -2258,7 +2153,7 @@ function createPluginContext() {
     },
     on(hook, handler) {
       if (typeof handler !== "function") {
-        process.stderr.write(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
+        diag(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
 `);
         return;
       }
@@ -2311,7 +2206,7 @@ var PluginManager = class {
     const seen = /* @__PURE__ */ new Set();
     for (const plugin of plugins) {
       if (seen.has(plugin.name)) {
-        process.stderr.write(
+        diag(
           `[theokit-sdk] duplicate plugin name "${plugin.name}" \u2014 both will register independently
 `
         );
@@ -2395,7 +2290,7 @@ var PluginManager = class {
           parts.push(result.recalledContext);
         }
       } catch (err) {
-        process.stderr.write(
+        diag(
           `[theokit-sdk] pre_user_send hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2423,7 +2318,7 @@ var PluginManager = class {
       try {
         await h(ctx);
       } catch (err) {
-        process.stderr.write(
+        diag(
           `[theokit-sdk] post_assistant_reply hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2439,7 +2334,7 @@ var PluginManager = class {
       try {
         await h(ctx);
       } catch (err) {
-        process.stderr.write(
+        diag(
           `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2454,7 +2349,7 @@ var PluginManager = class {
         const out = await h(current, ctx);
         if (out !== void 0) current = out;
       } catch (err) {
-        process.stderr.write(
+        diag(
           `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
 `
         );
@@ -2737,7 +2632,7 @@ async function runPostRunLifecycle(inputs) {
       }
     } catch (cause) {
       const msg = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
+      diag(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
 `);
     }
     await flushSessionWrites();
@@ -2796,10 +2691,8 @@ async function runPostRunLifecycle(inputs) {
       }
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(
-        `[theokit-sdk] session summary write failed (${result.id}): ${message}
-`
-      );
+      diag(`[theokit-sdk] session summary write failed (${result.id}): ${message}
+`);
     }
   }
   await hooksExecutor.run({
@@ -2821,174 +2714,6 @@ async function safeConversation(run) {
   }
 }
 
-// src/internal/runtime/registry/live-agent-registry.ts
-var DEFAULT_MAX_AGENTS = 100;
-var DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
-var DEFAULT_SWEEP_INTERVAL_MS = 6e4;
-var LiveAgentRegistry = class {
-  #agents = /* @__PURE__ */ new Map();
-  #maxAgents = DEFAULT_MAX_AGENTS;
-  #idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
-  #sweepIntervalMs = DEFAULT_SWEEP_INTERVAL_MS;
-  #onEvict;
-  #sweepTimer;
-  /**
-   * Reconfigure registry behavior. Process-wide singleton (D310) — last
-   * configure call wins for all subsequent operations.
-   */
-  configure(opts) {
-    if (opts.maxAgents !== void 0) this.#maxAgents = Math.max(0, opts.maxAgents);
-    if (opts.idleTimeoutMs !== void 0) this.#idleTimeoutMs = Math.max(0, opts.idleTimeoutMs);
-    if (opts.sweepIntervalMs !== void 0)
-      this.#sweepIntervalMs = Math.max(1e3, opts.sweepIntervalMs);
-    this.#onEvict = opts.onEvict;
-    this.#stopSweep();
-    if (this.#idleTimeoutMs > 0) this.#startSweep();
-  }
-  /**
-   * Lookup a cached agent. `get` is a use — refreshes `lastUsedAt` so the
-   * entry survives LRU eviction.
-   */
-  get(id) {
-    const entry = this.#agents.get(id);
-    if (entry === void 0) return void 0;
-    entry.lastUsedAt = Date.now();
-    return entry.agent;
-  }
-  /**
-   * Insert or overwrite an agent in the cache. Triggers fire-and-forget LRU
-   * eviction when `size > maxAgents`.
-   *
-   * EC-4: when `id` already maps to a DIFFERENT agent instance, dispose the
-   * old one before overwriting (race protection against two `getOrCreate`
-   * calls creating two agents but only the second being cached — the first
-   * would leak file handles + lifecycle controllers).
-   */
-  set(id, agent) {
-    if (this.#maxAgents === 0) return;
-    const existing = this.#agents.get(id);
-    if (existing !== void 0 && existing.agent !== agent) {
-      void existing.agent.dispose().catch(() => {
-        process.stderr.write(`[theokit-sdk] dispose during overwrite failed (${id})
-`);
-      });
-    }
-    this.#agents.set(id, { agent, lastUsedAt: Date.now() });
-    if (this.#agents.size > this.#maxAgents) void this.#evictLRU();
-  }
-  /**
-   * Remove the entry from the cache WITHOUT calling `dispose()` or
-   * `onEvict`. Used by `LocalAgent.dispose()` itself so the disposed
-   * instance can never be returned by a subsequent `get(id)` (dispose-cache
-   * race fix). Idempotent — calling on an unknown id is a no-op.
-   *
-   * @internal
-   */
-  forget(id) {
-    this.#agents.delete(id);
-  }
-  /**
-   * Explicitly evict an agent by id. Returns `true` when the entry was
-   * present (false = already gone). Calls `agent.dispose()` + `onEvict`
-   * with reason `"explicit"`.
-   */
-  async evict(id) {
-    const entry = this.#agents.get(id);
-    if (entry === void 0) return false;
-    this.#agents.delete(id);
-    await this.#disposeAndNotify(id, entry.agent, "explicit");
-    return true;
-  }
-  /**
-   * Evict every cached agent. Used by graceful shutdown (`process.on('SIGTERM')`)
-   * or end-of-test cleanup.
-   */
-  async evictAll() {
-    const entries = Array.from(this.#agents.entries());
-    this.#agents.clear();
-    this.#stopSweep();
-    for (const [id, entry] of entries) {
-      await this.#disposeAndNotify(id, entry.agent, "explicit");
-    }
-  }
-  /** Number of currently cached agents. */
-  size() {
-    return this.#agents.size;
-  }
-  /** Ids of cached agents, newest first (by lastUsedAt). */
-  ids() {
-    return Array.from(this.#agents.entries()).sort((a, b) => b[1].lastUsedAt - a[1].lastUsedAt).map(([id]) => id);
-  }
-  /**
-   * LRU eviction: drop the entry with the smallest `lastUsedAt`. Runs only
-   * when `size > maxAgents`. Asynchronous because `dispose()` is a Promise;
-   * the hot-path caller (`set`) does not await.
-   *
-   * @internal
-   */
-  async #evictLRU() {
-    if (this.#agents.size <= this.#maxAgents) return;
-    let oldestId;
-    let oldestAt = Infinity;
-    for (const [id, entry2] of this.#agents) {
-      if (entry2.lastUsedAt < oldestAt) {
-        oldestAt = entry2.lastUsedAt;
-        oldestId = id;
-      }
-    }
-    if (oldestId === void 0) return;
-    const entry = this.#agents.get(oldestId);
-    if (entry === void 0) return;
-    this.#agents.delete(oldestId);
-    await this.#disposeAndNotify(oldestId, entry.agent, "lru");
-  }
-  /** Background sweep — drops entries whose `lastUsedAt < now - idleTimeoutMs`. */
-  async #sweepIdle() {
-    if (this.#idleTimeoutMs === 0) return;
-    const threshold = Date.now() - this.#idleTimeoutMs;
-    const toEvict = [];
-    for (const [id, entry] of this.#agents) {
-      if (entry.lastUsedAt < threshold) toEvict.push([id, entry]);
-    }
-    for (const [id, entry] of toEvict) {
-      const current = this.#agents.get(id);
-      if (current === void 0 || current.agent !== entry.agent) continue;
-      this.#agents.delete(id);
-      await this.#disposeAndNotify(id, entry.agent, "idle");
-    }
-  }
-  #startSweep() {
-    this.#sweepTimer = setInterval(() => void this.#sweepIdle(), this.#sweepIntervalMs);
-    this.#sweepTimer.unref?.();
-  }
-  #stopSweep() {
-    if (this.#sweepTimer !== void 0) {
-      clearInterval(this.#sweepTimer);
-      this.#sweepTimer = void 0;
-    }
-  }
-  /** Dispose + notify with errors swallowed (D309). Single chokepoint. */
-  async #disposeAndNotify(id, agent, reason) {
-    try {
-      await agent.dispose();
-    } catch (cause) {
-      const msg = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
-`);
-    }
-    if (this.#onEvict !== void 0) {
-      try {
-        this.#onEvict(id, reason);
-      } catch (cause) {
-        const msg = cause instanceof Error ? cause.message : String(cause);
-        process.stderr.write(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
-`);
-      }
-    }
-  }
-};
-var liveAgentRegistry = new LiveAgentRegistry();
-
 // src/define-tool.ts
 var TOOL_SPLIT_RESOLVER = /* @__PURE__ */ Symbol("theokit.toolSplitResolver");
 async function runValidated(spec, input, ctx) {
@@ -3054,7 +2779,7 @@ var warned = /* @__PURE__ */ new Set();
 function warnDoubleReasoningOnce() {
   if (warned.has("double-reasoning")) return;
   warned.add("double-reasoning");
-  process.stderr.write(
+  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"
   );
 }
@@ -3089,10 +2814,8 @@ var SkillsManager = class {
     const skillsRoot = this.skillsDir ?? join(this.cwd, ".theokit", "skills");
     const discovered = await discoverSkills(skillsRoot, {
       onInvalidSkill: (info) => {
-        process.stderr.write(
-          `[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
-`
-        );
+        diag(`[theokit-sdk] skill ${info.name} skipped (${info.code}): ${info.message}
+`);
       }
     });
     this.skills = this.mergeInline(discovered);
@@ -3201,7 +2924,7 @@ async function safeCall(fn, fallback, label = "safeCall") {
     return await fn();
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    process.stderr.write(`[theokit-sdk] ${label} failed: ${message}
+    diag(`[theokit-sdk] ${label} failed: ${message}
 `);
     return fallback;
   }
@@ -3647,7 +3370,7 @@ var langfuseAdapter = {
       }
     }
     if (lf.LangfuseSpanProcessor === void 0) {
-      process.stderr.write(
+      diag(
         "[theokit-sdk] @langfuse/node detected but LangfuseSpanProcessor not found (v2?). Use Langfuse v3+ for auto-instrumentation.\n"
       );
       return;
@@ -3776,11 +3499,11 @@ function tryAutoRegisterAdapters(settings) {
     try {
       adapter.register();
       registered.add(adapter.moduleName);
-      process.stderr.write(`[theokit-sdk] telemetry: ${adapter.displayName} auto-instrumented.
+      diag(`[theokit-sdk] telemetry: ${adapter.displayName} auto-instrumented.
 `);
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(
+      diag(
         `[theokit-sdk] telemetry: ${adapter.displayName} detected but failed to register: ${message}
 `
       );
@@ -3836,7 +3559,7 @@ function safe(op, fallback) {
     if (!warnedOnce) {
       warnedOnce = true;
       const message = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(
+      diag(
         `[theokit-sdk] telemetry exporter error (suppressed; agent.send continues): ${message}
 `
       );
@@ -3850,7 +3573,7 @@ function createTelemetry(settings) {
   if (otel === null) {
     if (!warnedOnce) {
       warnedOnce = true;
-      process.stderr.write(
+      diag(
         "[theokit-sdk] telemetry.enabled = true but `@opentelemetry/api` is not installed; telemetry is a no-op.\n"
       );
     }
@@ -5378,7 +5101,7 @@ async function safeListTools(client, serverName) {
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
     const server = serverName ?? "unknown";
-    process.stderr.write(`[theokit-sdk] mcp listTools failed (server=${server}): ${message}
+    diag(`[theokit-sdk] mcp listTools failed (server=${server}): ${message}
 `);
     return [];
   }
@@ -5447,7 +5170,7 @@ function emitLlmMetrics(inputs, result, startAt) {
     inputs.telemetry?.recordHistogram(HISTOGRAM_NAMES.LLM_USAGE_MISSING, 1, {
       provider: inputs.llm.name
     });
-    process.stderr.write(
+    diag(
       `[theokit-sdk] llm usage missing from ${inputs.llm.name} finish \u2014 budget may undercount
 `
     );
@@ -6124,7 +5847,7 @@ function finalizeSpanAndPostHook(inputs, call, callId, result, events, toolSpan)
     agentId: inputs.agentId,
     runId: inputs.runId
   }).catch((err) => {
-    process.stderr.write(
+    diag(
       `[theokit-sdk] postToolUse hook error (swallowed): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -6143,7 +5866,7 @@ async function emitToolLifecycleDelta(inputs, update) {
   try {
     await inputs.onDelta({ update });
   } catch (err) {
-    process.stderr.write(
+    diag(
       `[theokit-sdk] onDelta tool-lifecycle emit error (swallowed): ${err instanceof Error ? err.message : String(err)}
 `
     );
@@ -6155,7 +5878,7 @@ async function safeEmitToolHook(callback, event) {
     await callback(event);
   } catch (cause) {
     const msg = cause instanceof Error ? cause.message : String(cause);
-    process.stderr.write(`[theokit-sdk] tool lifecycle hook threw: ${msg}
+    diag(`[theokit-sdk] tool lifecycle hook threw: ${msg}
 `);
   }
 }
@@ -7382,10 +7105,8 @@ function resolveRunProvider(options) {
   if (registered2 > 0 && !pluginProvidersAnnounced) {
     pluginProvidersAnnounced = true;
     const names = profiles.map((e) => e.profile.name).join(", ");
-    process.stderr.write(
-      `[theokit-sdk] registered ${registered2} plugin provider profile(s): ${names}
-`
-    );
+    diag(`[theokit-sdk] registered ${registered2} plugin provider profile(s): ${names}
+`);
   }
   const parsedModel = parseModelId(options.model?.id);
   const modelInferredProvider = parsedModel.provider !== void 0 && getProviderProfile(parsedModel.provider) !== void 0 ? parsedModel.provider : void 0;
@@ -7698,25 +7419,21 @@ async function readProjectMcpServers(cwd) {
 
 // src/internal/local-agent/local-agent-invalidate.ts
 async function applyDeferredInvalidation(agentId, pending, refresh) {
-  process.stderr.write(
-    `[theokit-sdk] applying deferred cache invalidation (${agentId}): ${pending.reason}
-`
-  );
+  diag(`[theokit-sdk] applying deferred cache invalidation (${agentId}): ${pending.reason}
+`);
   try {
     await refresh();
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`[theokit-sdk] invalidateCache reload failed (continuing): ${msg}
+    diag(`[theokit-sdk] invalidateCache reload failed (continuing): ${msg}
 `);
   }
 }
 async function invalidateCacheImpl(agentId, reason, options, disposed, dispose, setPending) {
   if (disposed) return;
   if (options.applyNow === true) {
-    process.stderr.write(
-      `[theokit-sdk] invalidateCache applyNow disposing agent (${agentId}): ${reason}
-`
-    );
+    diag(`[theokit-sdk] invalidateCache applyNow disposing agent (${agentId}): ${reason}
+`);
     await dispose();
     return;
   }
@@ -7727,6 +7444,217 @@ async function consumePending(agentId, pending, clear, refresh) {
   clear();
   await applyDeferredInvalidation(agentId, pending, refresh);
 }
+
+// src/internal/runtime/registry/live-agent-registry.ts
+var DEFAULT_MAX_AGENTS = 100;
+var DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1e3;
+var DEFAULT_SWEEP_INTERVAL_MS = 6e4;
+var LiveAgentRegistry = class {
+  #agents = /* @__PURE__ */ new Map();
+  #maxAgents = DEFAULT_MAX_AGENTS;
+  #idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
+  #sweepIntervalMs = DEFAULT_SWEEP_INTERVAL_MS;
+  #onEvict;
+  #sweepTimer;
+  /**
+   * Reconfigure registry behavior. Process-wide singleton (D310) — last
+   * configure call wins for all subsequent operations.
+   */
+  configure(opts) {
+    if (opts.maxAgents !== void 0) this.#maxAgents = Math.max(0, opts.maxAgents);
+    if (opts.idleTimeoutMs !== void 0) this.#idleTimeoutMs = Math.max(0, opts.idleTimeoutMs);
+    if (opts.sweepIntervalMs !== void 0)
+      this.#sweepIntervalMs = Math.max(1e3, opts.sweepIntervalMs);
+    this.#onEvict = opts.onEvict;
+    this.#stopSweep();
+    if (this.#idleTimeoutMs > 0) this.#startSweep();
+  }
+  /**
+   * Lookup a cached agent. `get` is a use — refreshes `lastUsedAt` so the
+   * entry survives LRU eviction.
+   */
+  get(id) {
+    const entry = this.#agents.get(id);
+    if (entry === void 0) return void 0;
+    entry.lastUsedAt = Date.now();
+    return entry.agent;
+  }
+  /**
+   * Insert or overwrite an agent in the cache. Triggers fire-and-forget LRU
+   * eviction when `size > maxAgents`.
+   *
+   * EC-4: when `id` already maps to a DIFFERENT agent instance, dispose the
+   * old one before overwriting (race protection against two `getOrCreate`
+   * calls creating two agents but only the second being cached — the first
+   * would leak file handles + lifecycle controllers).
+   */
+  set(id, agent) {
+    if (this.#maxAgents === 0) return;
+    const existing = this.#agents.get(id);
+    if (existing !== void 0 && existing.agent !== agent) {
+      void existing.agent.dispose().catch(() => {
+        diag(`[theokit-sdk] dispose during overwrite failed (${id})
+`);
+      });
+    }
+    this.#agents.set(id, { agent, lastUsedAt: Date.now() });
+    if (this.#agents.size > this.#maxAgents) void this.#evictLRU();
+  }
+  /**
+   * Remove the entry from the cache WITHOUT calling `dispose()` or
+   * `onEvict`. Used by `LocalAgent.dispose()` itself so the disposed
+   * instance can never be returned by a subsequent `get(id)` (dispose-cache
+   * race fix). Idempotent — calling on an unknown id is a no-op.
+   *
+   * @internal
+   */
+  forget(id) {
+    this.#agents.delete(id);
+  }
+  /**
+   * Explicitly evict an agent by id. Returns `true` when the entry was
+   * present (false = already gone). Calls `agent.dispose()` + `onEvict`
+   * with reason `"explicit"`.
+   */
+  async evict(id) {
+    const entry = this.#agents.get(id);
+    if (entry === void 0) return false;
+    this.#agents.delete(id);
+    await this.#disposeAndNotify(id, entry.agent, "explicit");
+    return true;
+  }
+  /**
+   * Evict every cached agent. Used by graceful shutdown (`process.on('SIGTERM')`)
+   * or end-of-test cleanup.
+   */
+  async evictAll() {
+    const entries = Array.from(this.#agents.entries());
+    this.#agents.clear();
+    this.#stopSweep();
+    for (const [id, entry] of entries) {
+      await this.#disposeAndNotify(id, entry.agent, "explicit");
+    }
+  }
+  /** Number of currently cached agents. */
+  size() {
+    return this.#agents.size;
+  }
+  /** Ids of cached agents, newest first (by lastUsedAt). */
+  ids() {
+    return Array.from(this.#agents.entries()).sort((a, b) => b[1].lastUsedAt - a[1].lastUsedAt).map(([id]) => id);
+  }
+  /**
+   * LRU eviction: drop the entry with the smallest `lastUsedAt`. Runs only
+   * when `size > maxAgents`. Asynchronous because `dispose()` is a Promise;
+   * the hot-path caller (`set`) does not await.
+   *
+   * @internal
+   */
+  async #evictLRU() {
+    if (this.#agents.size <= this.#maxAgents) return;
+    let oldestId;
+    let oldestAt = Infinity;
+    for (const [id, entry2] of this.#agents) {
+      if (entry2.lastUsedAt < oldestAt) {
+        oldestAt = entry2.lastUsedAt;
+        oldestId = id;
+      }
+    }
+    if (oldestId === void 0) return;
+    const entry = this.#agents.get(oldestId);
+    if (entry === void 0) return;
+    this.#agents.delete(oldestId);
+    await this.#disposeAndNotify(oldestId, entry.agent, "lru");
+  }
+  /** Background sweep — drops entries whose `lastUsedAt < now - idleTimeoutMs`. */
+  async #sweepIdle() {
+    if (this.#idleTimeoutMs === 0) return;
+    const threshold = Date.now() - this.#idleTimeoutMs;
+    const toEvict = [];
+    for (const [id, entry] of this.#agents) {
+      if (entry.lastUsedAt < threshold) toEvict.push([id, entry]);
+    }
+    for (const [id, entry] of toEvict) {
+      const current = this.#agents.get(id);
+      if (current === void 0 || current.agent !== entry.agent) continue;
+      this.#agents.delete(id);
+      await this.#disposeAndNotify(id, entry.agent, "idle");
+    }
+  }
+  #startSweep() {
+    this.#sweepTimer = setInterval(() => void this.#sweepIdle(), this.#sweepIntervalMs);
+    this.#sweepTimer.unref?.();
+  }
+  #stopSweep() {
+    if (this.#sweepTimer !== void 0) {
+      clearInterval(this.#sweepTimer);
+      this.#sweepTimer = void 0;
+    }
+  }
+  /** Dispose + notify with errors swallowed (D309). Single chokepoint. */
+  async #disposeAndNotify(id, agent, reason) {
+    try {
+      await agent.dispose();
+    } catch (cause) {
+      const msg = cause instanceof Error ? cause.message : String(cause);
+      diag(`[theokit-sdk] dispose during eviction failed (${id}): ${msg}
+`);
+    }
+    if (this.#onEvict !== void 0) {
+      try {
+        this.#onEvict(id, reason);
+      } catch (cause) {
+        const msg = cause instanceof Error ? cause.message : String(cause);
+        diag(`[theokit-sdk] onEvict listener threw (${id}): ${msg}
+`);
+      }
+    }
+  }
+};
+var liveAgentRegistry = new LiveAgentRegistry();
+
+// src/internal/local-agent/local-agent-lifecycle.ts
+async function adquirirLeaseSePossivel(store, agentId) {
+  const a = store.acquire;
+  if (typeof a !== "function") return;
+  try {
+    await a.call(store, agentId);
+  } catch (err) {
+    if (err instanceof Error && err.name === "SessionBusyError") throw err;
+    diag(
+      `[theokit-sdk] writer lease unavailable for ${agentId} (${err instanceof Error ? err.message : String(err)}) \u2014 proceeding without single-writer protection
+`
+    );
+  }
+}
+async function soltarLeaseSePossivel(store, agentId) {
+  const r = store.release;
+  if (typeof r === "function") await r.call(store, agentId);
+}
+async function disposeSessionStore(store) {
+  const d = store.dispose;
+  if (typeof d === "function") await d.call(store);
+}
+async function disposeLocalAgentSession(agent) {
+  liveAgentRegistry.forget(agent.agentId);
+  agent.lifecycleAbortController.abort();
+  await withCwdMutex(`agent-send:${agent.agentId}`, () => Promise.resolve());
+  disposeSessionMcpClients(agent.agentId);
+  await flushSessionWrites();
+  await flushRegistrySaves(agent.workspaceCwd);
+  await disposeSessionStore(agent.sessionStore);
+  descartarSessao(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 loadSubagents(
+    agent.workspaceCwd,
+    agent.settingSourcesIncludeProject,
+    agent.options.agents
+  );
+}
 async function persistActiveMemoryTranscript(cwd, transcript) {
   try {
     const dir = join(memoryDir(cwd), "transcripts", "active-memory");
@@ -7734,7 +7662,7 @@ async function persistActiveMemoryTranscript(cwd, transcript) {
     await atomicWriteJson(file, transcript);
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
-    process.stderr.write(`[theokit-sdk] active-memory transcript persist failed: ${message}
+    diag(`[theokit-sdk] active-memory transcript persist failed: ${message}
 `);
   }
 }
@@ -7855,7 +7783,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);
-    process.stderr.write(`[theokit-sdk] active-memory recall failed: ${message}
+    diag(`[theokit-sdk] active-memory recall failed: ${message}
 `);
     return { summary: void 0, durationMs: Date.now() - started, status: "error", hits: [] };
   }
@@ -8635,7 +8563,7 @@ var LocalAgentMemory = class {
       const warned2 = g[sym];
       if (!warned2.has(message)) {
         warned2.add(message);
-        process.stderr.write(`[theokit-sdk] memory tools unavailable: ${message}
+        diag(`[theokit-sdk] memory tools unavailable: ${message}
 `);
       }
       return void 0;
@@ -8694,7 +8622,7 @@ var LocalAgentMemory = class {
       await this.index.sync();
     } catch (cause) {
       const message = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(`[theokit-sdk] session index sync failed: ${message}
+      diag(`[theokit-sdk] session index sync failed: ${message}
 `);
     }
   }
@@ -8707,10 +8635,8 @@ 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);
-      process.stderr.write(
-        `[theokit-sdk] memory embedding ${cfg.provider} unavailable: ${message}
-`
-      );
+      diag(`[theokit-sdk] memory embedding ${cfg.provider} unavailable: ${message}
+`);
       return void 0;
     }
   }
@@ -9060,7 +8986,7 @@ function localAgentRunUntil(agent, goal, options) {
   async function* wrap() {
     const { runUntilImpl } = await import('./run-until-YZ2ODWOF.js');
     const buildDeps = async () => {
-      const { judgeCallImpl } = await import('./judge-call-D7R3ZTZS.js');
+      const { judgeCallImpl } = await import('./judge-call-TAEIXMYG.js');
       const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
       const create = getAgentFacade().create;
       return {
@@ -9093,7 +9019,7 @@ async function* localAgentStreamToCompletion(agent, message, options) {
 async function localAgentFork(parent, options) {
   const { forkAgentImpl } = await import('./fork-agent-RSV4E3EA.js');
   const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
-  const { withPersonalityContext } = await import('./context-GWANQLX4.js');
+  const { withPersonalityContext } = await import('./context-VAYLPT4O.js');
   const create = getAgentFacade().create;
   return withPersonalityContext(
     { slug: parent.personalitySlugSnapshot, isFork: true },
@@ -9468,7 +9394,7 @@ async function executeSendLocked(inputs, message, options) {
 function buildCompletionCheckDeps() {
   return {
     judge: async (ctx, opts) => {
-      const { judgeCallImpl } = await import('./judge-call-D7R3ZTZS.js');
+      const { judgeCallImpl } = await import('./judge-call-TAEIXMYG.js');
       const { getAgentFacade } = await import('./agent-factory-registry-ZVTABLEY.js');
       return judgeCallImpl(ctx, opts, { create: getAgentFacade().create });
     }
@@ -9509,27 +9435,6 @@ function registerRunAsTask(run, agentId, taskOpt, userText) {
 }
 
 // src/internal/local-agent/local-agent.ts
-async function adquirirLeaseSePossivel(store, agentId) {
-  const a = store.acquire;
-  if (typeof a !== "function") return;
-  try {
-    await a.call(store, agentId);
-  } catch (err) {
-    if (err instanceof Error && err.name === "SessionBusyError") throw err;
-    process.stderr.write(
-      `[theokit-sdk] writer lease unavailable for ${agentId} (${err instanceof Error ? err.message : String(err)}) \u2014 proceeding without single-writer protection
-`
-    );
-  }
-}
-async function soltarLeaseSePossivel(store, agentId) {
-  const r = store.release;
-  if (typeof r === "function") await r.call(store, agentId);
-}
-async function disposeSessionStore(store) {
-  const d = store.dispose;
-  if (typeof d === "function") await d.call(store);
-}
 var LocalAgent = class {
   agentId;
   model;
@@ -9824,26 +9729,12 @@ var LocalAgent = class {
     this.disposed = true;
   }
   async reload() {
-    if (this.context !== void 0) await this.context.refresh();
-    if (this.skillsManager !== void 0) await this.skillsManager.refresh();
-    if (this.pluginsManager !== void 0) await this.pluginsManager.refresh();
-    this.resolvedSubagents = await loadSubagents(
-      this.workspaceCwd,
-      this.settingSourcesIncludeProject,
-      this.options.agents
-    );
+    this.resolvedSubagents = await reloadLocalAgent(this);
   }
   async dispose() {
     if (this.disposed) return;
     this.disposed = true;
-    liveAgentRegistry.forget(this.agentId);
-    this.lifecycleAbortController.abort();
-    await withCwdMutex(`agent-send:${this.agentId}`, () => Promise.resolve());
-    disposeSessionMcpClients(this.agentId);
-    await flushSessionWrites();
-    await flushRegistrySaves(this.workspaceCwd);
-    await disposeSessionStore(this.sessionStore);
-    descartarSessao(this.workspaceCwd, this.agentId);
+    await disposeLocalAgentSession(this);
   }
   [Symbol.asyncDispose]() {
     return this.dispose();
@@ -10261,7 +10152,7 @@ var Agent = class _Agent {
    * @public
    */
   static async generateObject(options) {
-    const { generateObjectImpl } = await import('./generate-object-YJPDV5BS.js');
+    const { generateObjectImpl } = await import('./generate-object-I7UD4NWN.js');
     return generateObjectImpl(options, {
       create: (opts) => _Agent.create(opts),
       delete: (agentId) => _Agent.delete(agentId)
@@ -10285,7 +10176,7 @@ var Agent = class _Agent {
       delete: (agentId) => _Agent.delete(agentId)
     };
     async function* wrapper() {
-      streamObjectImport ??= import('./stream-object-WUQSSRY2.js');
+      streamObjectImport ??= import('./stream-object-OFM66VUT.js');
       const { streamObjectImpl } = await streamObjectImport;
       yield* streamObjectImpl(options, deps);
     }
@@ -10309,7 +10200,7 @@ var Agent = class _Agent {
    * @public
    */
   static async batch(prompts, options) {
-    const { batchImpl } = await import('./batch-MR2HKYMS.js');
+    const { batchImpl } = await import('./batch-SY5GZLFD.js');
     return batchImpl(prompts, options, { create: (opts) => _Agent.create(opts) });
   }
   /**
@@ -10353,15 +10244,15 @@ var Agent = class _Agent {
     return fresh;
   }
   /**
-   * List agents (local or cloud).
+   * List agents (local or cloud). M107 — `cwd` is READ now, not ignored;
+   * `limit`/`cursor` still are not (see `tests/agent-list-cwd.test.ts`).
    *
    * @public
    */
   static async list(options = {}) {
-    await hydrateRegistryFromDisk(process.cwd());
-    const runtime = options.runtime;
-    const all = listRegisteredAgents(runtime);
-    const items = all.map((agent) => toAgentInfo(agent));
+    const cwd = ("cwd" in options ? options.cwd : void 0) ?? process.cwd();
+    await hydrateRegistryFromDisk(cwd);
+    const items = listRegisteredAgents(options.runtime, cwd).map((agent) => toAgentInfo(agent));
     return { items };
   }
   /**
@@ -10447,7 +10338,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 compact targets local sessions.`
       );
     }
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-5BDD4HIB.js');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-WNKKIIDW.js');
     const { cwd, model, store } = await abrirStoreLocal(reg);
     return enqueueSessionWrite(
       cwd,
@@ -10483,7 +10374,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`
       );
     }
-    const { injectSessionTurn } = await import('./inject-session-V5FTK72N.js');
+    const { injectSessionTurn } = await import('./inject-session-UXNJQTZ6.js');
     const { cwd, model, store } = await abrirStoreLocal(reg);
     await injectSessionTurn({
       store,
@@ -10530,12 +10421,12 @@ async function abrirStoreLocal(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-4ALCDU3K.js');
-  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-F2ANTA2M.js');
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-6MY7PNI2.js');
+  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-6WKLYIN4.js');
   const baseDir = reg.options.local?.baseDir !== void 0 ? expandTilde2(reg.options.local.baseDir) : defaultBaseDir2();
   return { cwd, model, store: new FsSessionStore2({ baseDir, cwd }) };
 }
 
-export { Agent, AgentBuilder, DEFAULT_AGENTIC_MODEL_ID, MEMORY_EMBEDDING_ADAPTERS, Tool, ToolError, UsageAccumulator, computeCost, generateCronId, getPricingEntry, httpRequest, isFixtureApiKey, openRouterMemoryEmbeddingProviderAdapter, resolveApiKey, shouldUseFixtureMode };
-//# sourceMappingURL=chunk-EKFA76N4.js.map
-//# sourceMappingURL=chunk-EKFA76N4.js.map
+export { Agent, AgentBuilder, DEFAULT_AGENTIC_MODEL_ID, MEMORY_EMBEDDING_ADAPTERS, Tool, ToolError, UsageAccumulator, computeCost, generateCronId, getPricingEntry, openRouterMemoryEmbeddingProviderAdapter, resolveApiKey };
+//# sourceMappingURL=chunk-F3X7Q4BF.js.map
+//# sourceMappingURL=chunk-F3X7Q4BF.js.map