@theokit/sdk 4.30.0 → 4.31.1

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## 4.31.1
+
+### Patch Changes
+
+- M93 — oito correções da revisão adversarial.
+
+  - **O retry deixa de reexecutar um stream já parcialmente consumido.** Uma falha depois do primeiro evento reexecutava o turno inteiro, duplicando texto e blocos `tool_use` — exatamente no cenário que motivou o retry (429 depois de várias tool calls).
+  - **O transcript volta a nascer `0600`.** A troca para append incremental perdeu o modo explícito e, sob `umask 022`, o arquivo — que carrega conteúdo em trânsito — nascia legível por outros.
+  - **Um append sobre arquivo truncado por crash não engole mais o registro novo.**
+  - **Erro transitório passa a ser decidido pelo status estruturado, não pelo texto da mensagem.** A heurística anterior classificava `ECONNREFUSED …:443` como não-transitório porque a porta casava o padrão de "4xx": o retry ficava desligado justamente para falha de rede.
+  - **Falha de socket passa a ser tipada nos transportes Anthropic e OpenAI.** Sem isso, o erro cru escapava e nenhuma política de retry o reconhecia.
+  - **`CredentialPoolExhaustedError` e circuito aberto deixam de ser reexecutados.** O pool já gastou o próprio orçamento; reexecutar por cima triplicava a espera e desfazia o fail-fast do circuit breaker.
+  - Cancelamento (`AbortError`) nunca é confundido com falha de rede.
+
+## 4.31.0
+
+### Minor Changes
+
+- d8412b6: **Um erro transitório de provider deixa de destruir o turno inteiro.**
+
+  Três defeitos que, combinados, tornavam a perda total:
+
+  - **O caminho de chave única não tinha retry.** `buildPoolOrSingle` dava `PoolAwareLlmClient` — circuit
+    breaker, backoff de jitter total, `Retry-After`, rotação — com **≥ 2** chaves, e o transporte **cru**
+    com uma. Um consumidor que resolve exatamente uma credencial (o caso comum) caía sempre no braço sem
+    resiliência. A assimetria não tem justificativa de domínio: **um pool de 1 chave é um pool de tamanho
+    1**. `RetryingLlmClient` é composição — `computeBackoffMs` e `sleepWithAbort` já eram módulos
+    independentes — e aplica-se aos **três** braços (o do pool ambiente também estava de fora).
+
+  - **O caminho de erro não persistia nada.** O `catch` de `run.wait()` chamava `flushSessionWrites()` e
+    retornava; `persistTurnToTranscript` é chamado só depois, e é o único chamador do repositório. O
+    flush drenava um conjunto **vazio**. Agora persiste o **parcial** — user + tool calls concluídas —
+    sem reconstruir o que não aconteceu.
+
+  - **`appendRecords` reescrevia o arquivo inteiro por turno.** O(n) de I/O **e** de parse a cada turno,
+    O(n²) por sessão. Correto porque o formato **já é append-only** (o DAG de `parentUuid` não depende da
+    ordem de linha), e `appendJsonl` **já existia** no pacote com um único chamador. O `withFileLock`
+    permanece — é ele que serializa appends concorrentes.
+
+  Só erro **transitório** reexecuta: 402 (billing) não é, porque cota não se resolve em milissegundos, e
+  401 falha na primeira. Teto de 3 tentativas, ciente de `AbortSignal`.
+
+### Patch Changes
+
+- f76ed61: Corrige o docstring de `Agent.getOrCreate`, que afirmava o oposto do comportamento real.
+
+  Ele dizia: _"Disposed agents are NOT auto-deleted from the registry. To force a fresh agent, call
+  `Agent.delete(agentId)` first."_ Medido, é falso — `dispose()` chama `liveAgentRegistry.forget(id)`,
+  então o próximo `getOrCreate(id)` constrói um handle novo, sem `Agent.delete`.
+
+  A afirmação era sobre o registro **persistente** e foi lida como sendo sobre o **cache vivo**; um
+  consumidor construiu em cima da metade errada. Travado por `tests/m91-getorcreate-apos-dispose.test.ts`.
+
+  O bullet novo também registra o que continua verdadeiro: `close()` marca o handle descartado **sem**
+  evictar a entrada do cache. É interno e sem chamador hoje; se voltar a ser alcançável, o bullet deixa
+  de valer para aquele caminho — e está escrito para que a próxima pessoa não precise redescobrir.
+
 ## 4.17.1
 
 ### Patch Changes

package/dist/{agent-Ekv8y7_c.d.ts → agent-BJbGi8-R.d.ts}

@@ -1,4 +1,4 @@
-import { M as ModelSelection, ac as SDKUserMessage, ae as SendOptions, b as Run, G as GenerateOptions, n as GenerateRunResult, _ as RunToCompletionOptions, $ as RunToCompletionResult, S as SDKMessage, al as StreamToCompletionResult, C as CustomTool, c as PermissionMode, a as McpServerConfig, P as Processor } from './run-OJbGyweZ.js';
+import { M as ModelSelection, ac as SDKUserMessage, ae as SendOptions, b as Run, G as GenerateOptions, n as GenerateRunResult, _ as RunToCompletionOptions, $ as RunToCompletionResult, S as SDKMessage, al as StreamToCompletionResult, C as CustomTool, c as PermissionMode, a as McpServerConfig, P as Processor } from './run-CwEJtLPE.js';
 import * as zod from 'zod';
 
 /**

package/dist/{agent-LD76RI74.cjs → agent-BKNJIOEY.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkGWMQ5CS3_cjs = require('./chunk-GWMQ5CS3.cjs');
+var chunkS6F3FKFR_cjs = require('./chunk-S6F3FKFR.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-MZ5ZRORA.cjs');
-require('./chunk-YU6KON2I.cjs');
+require('./chunk-E2YEDATX.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-2HRYBRD7.cjs');
-require('./chunk-2MF3IE2D.cjs');
+require('./chunk-IOOSAZZH.cjs');
+require('./chunk-NZCFLEHO.cjs');
 require('./chunk-LUSXDZPV.cjs');
 require('./chunk-IT3PWBW4.cjs');
 require('./chunk-JLMXKTBX.cjs');
@@ -21,10 +21,10 @@ require('./chunk-YPEPCZHF.cjs');
 require('./chunk-VJ26EKGJ.cjs');
 require('./chunk-GIW4L6HY.cjs');
 require('./chunk-7S7KKUO6.cjs');
-require('./chunk-C7PICHRF.cjs');
+require('./chunk-CJVMDRQB.cjs');
 require('./chunk-JD74LN7R.cjs');
 require('./chunk-YLQQX5W2.cjs');
-require('./chunk-4SXHEZIV.cjs');
+require('./chunk-U2FO3MRG.cjs');
 require('./chunk-ANIZEWTU.cjs');
 require('./chunk-WJVHMTKB.cjs');
 require('./chunk-TIZ4TS5V.cjs');
@@ -44,7 +44,7 @@ require('./chunk-BEURCLDV.cjs');
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkGWMQ5CS3_cjs.Agent; }
+  get: function () { return chunkS6F3FKFR_cjs.Agent; }
 });
-//# sourceMappingURL=agent-LD76RI74.cjs.map
-//# sourceMappingURL=agent-LD76RI74.cjs.map
+//# sourceMappingURL=agent-BKNJIOEY.cjs.map
+//# sourceMappingURL=agent-BKNJIOEY.cjs.map

package/dist/{agent-LD76RI74.cjs.map → agent-BKNJIOEY.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-LD76RI74.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-BKNJIOEY.cjs"}

package/dist/{agent-Bzg2_uGr.d.cts → agent-CbZPGFfM.d.cts}

@@ -1,4 +1,4 @@
-import { M as ModelSelection, ac as SDKUserMessage, ae as SendOptions, b as Run, G as GenerateOptions, n as GenerateRunResult, _ as RunToCompletionOptions, $ as RunToCompletionResult, S as SDKMessage, al as StreamToCompletionResult, C as CustomTool, c as PermissionMode, a as McpServerConfig, P as Processor } from './run-OJbGyweZ.cjs';
+import { M as ModelSelection, ac as SDKUserMessage, ae as SendOptions, b as Run, G as GenerateOptions, n as GenerateRunResult, _ as RunToCompletionOptions, $ as RunToCompletionResult, S as SDKMessage, al as StreamToCompletionResult, C as CustomTool, c as PermissionMode, a as McpServerConfig, P as Processor } from './run-CwEJtLPE.cjs';
 import * as zod from 'zod';
 
 /**

package/dist/{agent-7YUGJJTU.js → agent-HW7OY2W3.js}

@@ -1,10 +1,10 @@
-export { Agent } from './chunk-ISZ3MBUD.js';
+export { Agent } from './chunk-CCRWSZ2F.js';
 import './chunk-2SFBB54R.js';
 import './chunk-HRA3CPGG.js';
-import './chunk-SQLZ7ONU.js';
+import './chunk-SJLOIZ4Z.js';
 import './chunk-K2BQQ445.js';
-import './chunk-U6QGZHPN.js';
-import './chunk-NRSH7RJY.js';
+import './chunk-RPKTXBPK.js';
+import './chunk-XDNGF5BY.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
 import './chunk-XAUBQMQU.js';
@@ -19,10 +19,10 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-HZQEDNF6.js';
+import './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';
 import './chunk-2XLKLVVR.js';
-import './chunk-ZZWTY3RX.js';
+import './chunk-VGUOUAM2.js';
 import './chunk-BXV2QUIC.js';
 import './chunk-4VPXM6UU.js';
 import './chunk-S2BBRVQX.js';
@@ -37,5 +37,5 @@ import './chunk-POQT2OIF.js';
 import './chunk-FKCC2MED.js';
 import './chunk-WLKFWQSJ.js';
 import './chunk-JTFYYKDT.js';
-//# sourceMappingURL=agent-7YUGJJTU.js.map
-//# sourceMappingURL=agent-7YUGJJTU.js.map
+//# sourceMappingURL=agent-HW7OY2W3.js.map
+//# sourceMappingURL=agent-HW7OY2W3.js.map

package/dist/{agent-7YUGJJTU.js.map → agent-HW7OY2W3.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-7YUGJJTU.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"agent-HW7OY2W3.js"}

package/dist/agent.d.ts

@@ -124,8 +124,21 @@ export declare class Agent {
      * Caveats:
      * - The function-level `agentId` always wins over `options.agentId`.
      * - Options differ between calls? Last-call-wins for this handle (matches `Agent.resume`).
-     * - Disposed agents are NOT auto-deleted from the registry. To force a fresh
-     *   agent, call `Agent.delete(agentId)` first.
+     * - A DISPOSED agent is replaced automatically. `dispose()` evicts the id from the
+     *   live cache (`liveAgentRegistry.forget`), so the next `getOrCreate(id)` builds a
+     *   fresh handle — no `Agent.delete(agentId)` needed.
+     *
+     *   This bullet used to say the opposite ("Disposed agents are NOT auto-deleted...
+     *   call `Agent.delete(agentId)` first"). It was measured false in M91:
+     *   `tests/m91-getorcreate-apos-dispose.test.ts` builds an agent, disposes it, and
+     *   gets a different instance back. The claim was about the PERSISTENT registry and
+     *   read as being about the live cache — and consumers built around the wrong half.
+     *   The agent-builder's M85 interrupt rotates the session id to work around a
+     *   constraint that does not exist.
+     *
+     * - `close()` marks the handle disposed WITHOUT evicting the cache entry. It is
+     *   internal and unused today; if it becomes reachable, this bullet stops being true
+     *   for that path.
      *
      * @public
      */

package/dist/{chunk-ISZ3MBUD.js → chunk-CCRWSZ2F.js}

@@ -1,8 +1,8 @@
 import { extractCodePlugins } from './chunk-2SFBB54R.js';
 import { submit, emitRunEvent } from './chunk-HRA3CPGG.js';
-import { enqueueSessionWrite, hydrateSession, flushSessionWrites, appendSessionMessage, persistTurnToTranscript, getSessionMessages, clearSession } from './chunk-SQLZ7ONU.js';
-import { FsSessionStore } from './chunk-U6QGZHPN.js';
-import { discoverProviderPlugins, CircuitBreaker, buildDefaultSummarizer, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, tryFirstEvent, relayStream, mapOpenAICompatibleError, renderToolResultContentText } from './chunk-NRSH7RJY.js';
+import { enqueueSessionWrite, hydrateSession, flushSessionWrites, persistTurnToTranscript, appendSessionMessage, getSessionMessages, clearSession } from './chunk-SJLOIZ4Z.js';
+import { FsSessionStore } from './chunk-RPKTXBPK.js';
+import { discoverProviderPlugins, CircuitBreaker, buildDefaultSummarizer, parseSseStream, resolveProviderChain, inferProviderFromApiKey, detectPrimaryProvider, tryFirstEvent, relayStream, mapOpenAICompatibleError, renderToolResultContentText } from './chunk-XDNGF5BY.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 { resolveChildEnv } from './chunk-7GFX45DD.js';
@@ -13,9 +13,9 @@ 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-HZQEDNF6.js';
+import { withFileLock } from './chunk-UAYYNWYJ.js';
 import { withCwdMutex } from './chunk-2XLKLVVR.js';
-import { defaultBaseDir, expandTilde } from './chunk-ZZWTY3RX.js';
+import { defaultBaseDir, expandTilde } from './chunk-VGUOUAM2.js';
 import { toJsonSchema } from './chunk-4VPXM6UU.js';
 import { atomicWriteJson } from './chunk-S2BBRVQX.js';
 import { loadSubagents } from './chunk-BNIFFFH3.js';
@@ -2700,6 +2700,15 @@ function buildContextBudgetEvent(model, resolved) {
 }
 
 // src/internal/runtime/lifecycle/post-run-lifecycle.ts
+function resolveWindowForRun(model, contextWindow) {
+  const override = contextWindow !== void 0 && contextWindow > 0 ? contextWindow : void 0;
+  return resolveEffectiveContextWindow({
+    ...override !== void 0 ? { override } : {},
+    catalog: getCatalogModelInfo(model)?.limit?.context,
+    margin: CONTEXT_WINDOW_MARGIN,
+    floor: CONTEXT_WINDOW_FLOOR
+  });
+}
 async function runPostRunLifecycle(inputs) {
   const {
     run,
@@ -2708,6 +2717,7 @@ async function runPostRunLifecycle(inputs) {
     workspaceCwd,
     sessionStore,
     model,
+    contextWindow,
     onRunEvent,
     hooksExecutor,
     memoryGlue,
@@ -2717,6 +2727,19 @@ async function runPostRunLifecycle(inputs) {
   try {
     result = await run.wait();
   } catch {
+    try {
+      const parcial = await safeConversation(run);
+      if (parcial !== void 0) {
+        persistTurnToTranscript(sessionStore, { cwd: workspaceCwd, agentId, model }, agentId, {
+          userText,
+          conversation: parcial
+        });
+      }
+    } catch (cause) {
+      const msg = cause instanceof Error ? cause.message : String(cause);
+      process.stderr.write(`[theokit-sdk] partial transcript write failed (${agentId}): ${msg}
+`);
+    }
     await flushSessionWrites();
     return;
   }
@@ -2724,12 +2747,8 @@ async function runPostRunLifecycle(inputs) {
     appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
-  const resolvedWindow = resolveEffectiveContextWindow({
-    catalog: getCatalogModelInfo(model)?.limit?.context,
-    margin: CONTEXT_WINDOW_MARGIN,
-    floor: CONTEXT_WINDOW_FLOOR
-  });
-  const contextWindow = resolvedWindow.window;
+  const resolvedWindow = resolveWindowForRun(model, contextWindow);
+  const janelaEfetiva = resolvedWindow.window;
   const budgetEvent = buildContextBudgetEvent(model, resolvedWindow);
   if (budgetEvent !== void 0 && onRunEvent !== void 0) {
     emitRunEvent(onRunEvent, budgetEvent);
@@ -2745,7 +2764,9 @@ async function runPostRunLifecycle(inputs) {
       conversation,
       autoCompact: {
         usageTotal: usageForTrigger,
-        contextWindow,
+        // A janela EFETIVA (após override, clamp e margem) — não a declarada. Trocar por
+        // `contextWindow` aqui orçaria contra um número que o clamp já rejeitou.
+        contextWindow: janelaEfetiva,
         summarize: buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
@@ -9657,6 +9678,9 @@ var LocalAgent = class {
         workspaceCwd: this.workspaceCwd,
         sessionStore: this.sessionStore,
         model: this.model?.id ?? "unknown",
+        // M94 — a janela declarada atravessa até o orçamento. Sem isto o `override` do resolvedor
+        // existia desde o M77 e nenhum call site de produção o passava.
+        ...this.model?.contextWindow !== void 0 ? { contextWindow: this.model.contextWindow } : {},
         // M50 — the auto-compaction summarizer resolves credentials like the run itself.
         ...this.options.apiKey !== void 0 ? { apiKey: this.options.apiKey } : {},
         ...options.onRunEvent !== void 0 ? { onRunEvent: options.onRunEvent } : {},
@@ -10264,8 +10288,21 @@ var Agent = class _Agent {
    * Caveats:
    * - The function-level `agentId` always wins over `options.agentId`.
    * - Options differ between calls? Last-call-wins for this handle (matches `Agent.resume`).
-   * - Disposed agents are NOT auto-deleted from the registry. To force a fresh
-   *   agent, call `Agent.delete(agentId)` first.
+   * - A DISPOSED agent is replaced automatically. `dispose()` evicts the id from the
+   *   live cache (`liveAgentRegistry.forget`), so the next `getOrCreate(id)` builds a
+   *   fresh handle — no `Agent.delete(agentId)` needed.
+   *
+   *   This bullet used to say the opposite ("Disposed agents are NOT auto-deleted...
+   *   call `Agent.delete(agentId)` first"). It was measured false in M91:
+   *   `tests/m91-getorcreate-apos-dispose.test.ts` builds an agent, disposes it, and
+   *   gets a different instance back. The claim was about the PERSISTENT registry and
+   *   read as being about the live cache — and consumers built around the wrong half.
+   *   The agent-builder's M85 interrupt rotates the session id to work around a
+   *   constraint that does not exist.
+   *
+   * - `close()` marks the handle disposed WITHOUT evicting the cache entry. It is
+   *   internal and unused today; if it becomes reachable, this bullet stops being true
+   *   for that path.
    *
    * @public
    */
@@ -10371,7 +10408,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 compact targets local sessions.`
       );
     }
-    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-OO2GD76G.js');
+    const { compactSessionTranscript, buildDefaultSummarizer: buildDefaultSummarizer2 } = await import('./compact-session-QMBOCFVQ.js');
     const { cwd, model, store } = await abrirStoreLocal(reg);
     return enqueueSessionWrite(
       cwd,
@@ -10407,7 +10444,7 @@ var Agent = class _Agent {
         `No local agent "${agentId}" registered \u2014 injectSessionTurn targets local sessions.`
       );
     }
-    const { injectSessionTurn } = await import('./inject-session-KOFHS5K3.js');
+    const { injectSessionTurn } = await import('./inject-session-YA3GQE4G.js');
     const { cwd, model, store } = await abrirStoreLocal(reg);
     await injectSessionTurn({
       store,
@@ -10454,12 +10491,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-ZKB5NN37.js');
-  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-T7LGJUGW.js');
+  const { FsSessionStore: FsSessionStore2 } = await import('./fs-session-store-T7YPW5A4.js');
+  const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await import('./session-transcript-5VZUWEJ5.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-ISZ3MBUD.js.map
-//# sourceMappingURL=chunk-ISZ3MBUD.js.map
+//# sourceMappingURL=chunk-CCRWSZ2F.js.map
+//# sourceMappingURL=chunk-CCRWSZ2F.js.map