@theokit/sdk 4.30.0 → 4.31.1

package/dist/chunk-IOOSAZZH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/persistence/fs-session-store.ts"],"names":["readTranscript","transcriptPath","path","mkdir","dirname","withFileLock","appendJsonl"],"mappings":";;;;;;;AAyCO,IAAM,iBAAN,MAA6C;AAAA,EACzC,QAAA;AAAA,EACA,IAAA;AAAA,EAET,YAAY,OAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,OAAA;AACxB,IAAA,IAAA,CAAK,OAAO,OAAA,CAAQ,GAAA;AAAA,EACtB;AAAA,EAEA,MAAM,YAAY,OAAA,EAA2C;AAC3D,IAAA,OAAOA,iCAAeC,gCAAA,CAAe,IAAA,CAAK,UAAU,IAAA,CAAK,IAAA,EAAM,OAAO,CAAC,CAAA;AAAA,EACzE;AAAA,EAEA,MAAM,aAAA,CAAc,OAAA,EAAiB,OAAA,EAAkD;AAErF,IAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAC1B,IAAA,MAAMC,SAAOD,gCAAA,CAAe,IAAA,CAAK,QAAA,EAAU,IAAA,CAAK,MAAM,OAAO,CAAA;AAE7D,IAAA,MAAME,eAAMC,YAAA,CAAQF,MAAI,GAAG,EAAE,SAAA,EAAW,MAAM,CAAA;AAC9C,IAAA,MAAMG,8BAAA,CAAaH,QAAM,YAAY;AAyBnC,MAAA,KAAA,MAAW,MAAA,IAAU,OAAA,EAASI,6BAAA,CAAYJ,MAAA,EAAM,MAAM,CAAA;AAAA,IACxD,CAAC,CAAA;AAAA,EACH;AACF","file":"chunk-IOOSAZZH.cjs","sourcesContent":["/**\n * SE41 — `FsSessionStore`, the DEFAULT reference implementation of the pluggable\n * {@link SessionStore} seam. It reads and append-writes the native Claude-shaped\n * `.jsonl` transcript at `<baseDir>/projects/<encoded-cwd>/<agentId>.jsonl` — the\n * exact on-disk format SE40 introduced (the file the Claude Code CLI can\n * `--continue`). Omitting `local.sessionStore` resolves to this store, so the\n * default persistence path is byte-identical to SE40 behavior.\n *\n * `readRecords` is `readTranscript(transcriptPath(...))` (a missing session →\n * `[]`, not an error — a fresh agent has no history). `appendRecords` is a TRUE\n * append: it reads the prior records, concatenates the new-turn delta, and\n * rewrites the whole line set atomically under the SE40 cross-process file lock\n * (`writeTranscript` never shrinks — the native format is an append-only\n * `parentUuid` DAG). The parent dir is created BEFORE acquiring the lock because\n * the lock's companion `<path>.lock` file needs an existing parent dir (the SE40\n * `mkdir(dirname)`-before-lock fix).\n *\n * @internal\n */\n\nimport { mkdir } from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\n\nimport type { SessionStore } from \"../../types/session-store.js\";\nimport { withFileLock } from \"./file-lock.js\";\nimport { appendJsonl } from \"./jsonl.js\";\nimport { readTranscript, type SessionRecord, transcriptPath } from \"./session-transcript.js\";\n\n/** Options identifying the on-disk transcript location for the FS default store. */\nexport interface FsSessionStoreOptions {\n  /** Transcript base dir (`~/.theokit` default, `~/.claude` for CLI interop) — already `~`-expanded. */\n  baseDir: string;\n  /** The workspace cwd whose encoded form is the transcript project dir. */\n  cwd: string;\n}\n\n/**\n * The default `SessionStore` — reads/append-writes the native `.jsonl` transcript.\n *\n * @internal\n */\nexport class FsSessionStore implements SessionStore {\n  readonly #baseDir: string;\n  readonly #cwd: string;\n\n  constructor(options: FsSessionStoreOptions) {\n    this.#baseDir = options.baseDir;\n    this.#cwd = options.cwd;\n  }\n\n  async readRecords(agentId: string): Promise<SessionRecord[]> {\n    return readTranscript(transcriptPath(this.#baseDir, this.#cwd, agentId));\n  }\n\n  async appendRecords(agentId: string, records: readonly SessionRecord[]): Promise<void> {\n    // Empty delta → nothing to persist (avoids an unnecessary lock + rewrite).\n    if (records.length === 0) return;\n    const path = transcriptPath(this.#baseDir, this.#cwd, agentId);\n    // mkdir BEFORE the lock: withFileLock's companion `<path>.lock` needs the parent dir.\n    await mkdir(dirname(path), { recursive: true });\n    await withFileLock(path, async () => {\n      // M93 — acrescenta o DELTA em vez de reescrever o arquivo inteiro.\n      //\n      // Antes: `readTranscript` + `writeTranscript` de tudo, por turno. O(n) de I/O **e** de parse a\n      // cada turno, O(n²) por sessão — a nota do consumidor em `agents/lib/session/backtrack.ts`\n      // registra 1,4 MB / 3000 linhas em 200 turnos.\n      //\n      // Correto porque o formato **já é append-only**: o DAG de `parentUuid` não depende da ordem de\n      // linha, e cada registro carrega o próprio pai. `appendJsonl` **já existia no pacote** e tinha um\n      // único chamador (`eval/runner.ts`) — a primitiva estava lá, o store é que a ignorava (rung 4).\n      //\n      // O `withFileLock` permanece — mas a afirmação anterior de que \"ele é o que serializa dois\n      // `appendRecords` concorrentes\" era forte demais, e a revisão adversarial do M93 mediu isso:\n      // removê-lo não reprova nenhum teste. A razão é o próprio parágrafo acima — o DAG de\n      // `parentUuid` não depende da ordem de linha, então dois lotes intercalados reconstroem igual.\n      // O trabalho que o lock fazia (proteger um read-modify-write) sumiu junto com o rewrite.\n      //\n      // O que ele ainda cobre é a janela TOCTOU de `precisaDeQuebraAntes` (ler o último byte, depois\n      // escrever): sem ele, dois processos podem ambos concluir \"falta \\n\" e produzir uma linha em\n      // branco — que o leitor descarta, isto é, benigno. Fica como **defesa declarada, não\n      // mecanizada** (a disciplina de `error-handling.md § 4`: enumerar o resíduo em vez de deixar a\n      // ausência de teste passar por cobertura).\n      //\n      // `writeTranscript` continua existindo para **compactação**, a única operação que legitimamente\n      // reescreve o arquivo.\n      for (const record of records) appendJsonl(path, record);\n    });\n  }\n}\n"]}

package/dist/{chunk-2MF3IE2D.cjs → chunk-NZCFLEHO.cjs}

@@ -3,7 +3,7 @@
 var chunkLUSXDZPV_cjs = require('./chunk-LUSXDZPV.cjs');
 var chunkIT3PWBW4_cjs = require('./chunk-IT3PWBW4.cjs');
 var chunk6JSIEDKL_cjs = require('./chunk-6JSIEDKL.cjs');
-var chunk4SXHEZIV_cjs = require('./chunk-4SXHEZIV.cjs');
+var chunkU2FO3MRG_cjs = require('./chunk-U2FO3MRG.cjs');
 var chunkEVADEGM7_cjs = require('./chunk-EVADEGM7.cjs');
 var chunkD42XHI4O_cjs = require('./chunk-D42XHI4O.cjs');
 var chunkA44COQJJ_cjs = require('./chunk-A44COQJJ.cjs');
@@ -475,6 +475,22 @@ function releaseReader(reader) {
   }
 }
 
+// src/internal/llm/transport-error.ts
+function ehAbort(err) {
+  if (typeof err !== "object" || err === null) return false;
+  const nome = err.name;
+  return nome === "AbortError" || nome === "TimeoutError";
+}
+function wrapTransportError(err, ctx) {
+  if (ehAbort(err)) return err;
+  if (err instanceof chunkA44COQJJ_cjs.NetworkError) return err;
+  const detalhe = err instanceof Error ? err.message : String(err);
+  return new chunkA44COQJJ_cjs.NetworkError(`${ctx.providerId} transport failure on ${ctx.endpoint}: ${detalhe}`, {
+    code: "transport_failure",
+    cause: err
+  });
+}
+
 // src/internal/llm/anthropic.ts
 var AnthropicClient = class {
   constructor(options) {
@@ -495,12 +511,17 @@ var AnthropicClient = class {
       "anthropic-version": this.options.version ?? "2023-06-01"
     };
     if (this.options.extraHeaders !== void 0) Object.assign(headers, this.options.extraHeaders);
-    const response = await this.fetchImpl(`${this.baseUrl}/v1/messages`, {
-      method: "POST",
-      signal,
-      headers,
-      body: JSON.stringify(body)
-    });
+    let response;
+    try {
+      response = await this.fetchImpl(`${this.baseUrl}/v1/messages`, {
+        method: "POST",
+        signal,
+        headers,
+        body: JSON.stringify(body)
+      });
+    } catch (fetchErr) {
+      throw wrapTransportError(fetchErr, { providerId: this.name, endpoint: "/v1/messages" });
+    }
     if (!response.ok) {
       const text = await response.text().catch(() => "");
       let body2 = text;
@@ -705,7 +726,7 @@ async function resolveBedrockToken(region) {
     return cachedToken.value;
   }
   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-2MF3IE2D.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-NZCFLEHO.cjs', document.baseURI).href)));
     const gen = r("@aws/bedrock-token-generator");
     if (typeof gen.getToken !== "function") return void 0;
     const providers = r("@aws-sdk/credential-providers");
@@ -1465,7 +1486,7 @@ var OpenAIClient = class {
         endpoint: "/v1/chat/completions"
       });
       if (mapped !== void 0) throw mapped;
-      throw fetchErr;
+      throw wrapTransportError(fetchErr, { providerId, endpoint: "/v1/chat/completions" });
     }
     if (!response.ok) {
       const text = await response.text().catch(() => "");
@@ -2121,6 +2142,92 @@ var ResponsesApiClient = class {
   }
 };
 
+// src/internal/llm/abort-error.ts
+function abortError2(signal) {
+  if (signal.reason instanceof Error) return signal.reason;
+  return new Error(signal.reason !== void 0 ? String(signal.reason) : "aborted");
+}
+
+// src/internal/llm/retrying-client.ts
+var MAX_TENTATIVAS = 3;
+function ehTransitorio(err) {
+  if (!chunkA44COQJJ_cjs.isTransientError(err)) return false;
+  if (err instanceof chunkA44COQJJ_cjs.CredentialPoolExhaustedError) return false;
+  if (err instanceof chunkA44COQJJ_cjs.TheokitAgentError && err.code === "circuit_open") return false;
+  if (err instanceof chunkA44COQJJ_cjs.RateLimitError && err.metadata?.statusCode === 402) return false;
+  return true;
+}
+function dicaDeRetryAfterMs(err) {
+  if (!(err instanceof chunkA44COQJJ_cjs.RateLimitError)) return void 0;
+  const segundos = err.metadata?.retryAfter;
+  return typeof segundos === "number" && segundos > 0 ? segundos * 1e3 : void 0;
+}
+async function* consumir(gen, estado) {
+  let passo = await gen.next();
+  while (passo.done !== true) {
+    estado.emitiu = true;
+    yield passo.value;
+    passo = await gen.next();
+  }
+  return passo.value;
+}
+function podeReexecutar(err, emitiu, tentativa) {
+  if (emitiu) return false;
+  if (tentativa === MAX_TENTATIVAS - 1) return false;
+  return ehTransitorio(err);
+}
+var RetryingLlmClient = class {
+  #inner;
+  #rng;
+  constructor(inner, opts) {
+    this.#inner = inner;
+    this.#rng = opts?.rng;
+  }
+  /**
+   * O cliente decorado. Público pela mesma convenção de `FaultInjectingLlmClient.inner`: os testes
+   * de fiação do router afirmam `instanceof PoolAwareLlmClient` e precisam enxergar através dos
+   * decorators. Sem isto, adicionar um decorator quebra testes cuja intenção continua válida — que
+   * foi exatamente o que o M93 fez com 4 testes pré-existentes.
+   */
+  get inner() {
+    return this.#inner;
+  }
+  get name() {
+    return this.#inner.name;
+  }
+  /**
+   * Espera o backoff da tentativa `n`, honrando o `Retry-After` do provider quando ele veio.
+   *
+   * Método próprio porque o `stream` é um gerador com laço aninhado, e embutir aqui a montagem
+   * condicional das opções levava a complexidade cognitiva a 19 (teto do projeto: 10). O corpo do
+   * `stream` fica sendo só a máquina de tentativas.
+   */
+  async #esperarBackoff(err, tentativa, signal) {
+    const dica = dicaDeRetryAfterMs(err);
+    const ms = chunkLUSXDZPV_cjs.computeBackoffMs({
+      attempt: tentativa,
+      ...dica !== void 0 ? { retryAfterMs: dica } : {},
+      ...this.#rng !== void 0 ? { rng: this.#rng } : {}
+    });
+    await chunkLUSXDZPV_cjs.sleepWithAbort(ms, signal);
+  }
+  async *stream(request, signal) {
+    let ultimoErro;
+    for (let tentativa = 0; tentativa < MAX_TENTATIVAS; tentativa++) {
+      if (signal.aborted) throw ultimoErro ?? abortError2(signal);
+      const estado = { emitiu: false };
+      try {
+        return yield* consumir(this.#inner.stream(request, signal), estado);
+      } catch (err) {
+        ultimoErro = err;
+        if (!podeReexecutar(err, estado.emitiu, tentativa)) throw err;
+        await this.#esperarBackoff(err, tentativa, signal);
+      }
+    }
+    throw ultimoErro ?? new Error("retry esgotado sem erro registrado");
+  }
+};
+
 // src/internal/error-mappers/vertex.ts
 var VERTEX_RULES = [
   { test: (s, e) => s === 429 || e === "RESOURCE_EXHAUSTED", code: "rate_limit" },
@@ -2202,7 +2309,7 @@ async function resolveVertexAccessToken() {
 async function getAuthClientOrThrow() {
   let mod;
   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-2MF3IE2D.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-NZCFLEHO.cjs', document.baseURI).href)));
     mod = r("google-auth-library");
   } catch (err) {
     const isModuleMissing = err instanceof Error && (err.message.includes("Cannot find module") || err.code === "MODULE_NOT_FOUND");
@@ -2382,11 +2489,13 @@ function buildClient(name, routerOptions) {
   const resilience = routerOptions.onRateLimit !== void 0 ? { onRateLimit: routerOptions.onRateLimit } : {};
   const ambient = chunkLUSXDZPV_cjs.currentCredentialPool(name);
   if (ambient !== void 0) {
-    return new PoolAwareLlmClient(
-      ambient,
-      (apiKey) => selectTransport(profile, apiKey),
-      void 0,
-      resilience
+    return new RetryingLlmClient(
+      new PoolAwareLlmClient(
+        ambient,
+        (apiKey) => selectTransport(profile, apiKey),
+        void 0,
+        resilience
+      )
     );
   }
   const poolKeys = filterPoolKeys(routerOptions.apiKeys?.[name]);
@@ -2412,16 +2521,18 @@ function buildPoolOrSingle(args) {
     );
     const pool = new chunkLUSXDZPV_cjs.CredentialPool(name, entries, strategy);
     const resilience = routerOptions.onRateLimit !== void 0 ? { onRateLimit: routerOptions.onRateLimit } : {};
-    return new PoolAwareLlmClient(
-      pool,
-      (apiKey2) => selectTransport(profile, apiKey2),
-      void 0,
-      resilience
+    return new RetryingLlmClient(
+      new PoolAwareLlmClient(
+        pool,
+        (apiKey2) => selectTransport(profile, apiKey2),
+        void 0,
+        resilience
+      )
     );
   }
   const apiKey = poolKeys?.[0] ?? resolveApiKey(profile.envVars) ?? sentinelForNoAuth(profile) ?? sentinelForLazyAuth(profile);
   if (apiKey === void 0) return void 0;
-  return selectTransport(profile, apiKey);
+  return new RetryingLlmClient(selectTransport(profile, apiKey));
 }
 function resolveBaseUrlEnvOverride(providerName) {
   switch (providerName) {
@@ -2709,7 +2820,7 @@ function plainText(content) {
 }
 async function compactSessionTranscript(opts) {
   const prior = await opts.store.readRecords(opts.loc.agentId);
-  const history = chunk4SXHEZIV_cjs.reconstructMessages(prior);
+  const history = chunkU2FO3MRG_cjs.reconstructMessages(prior);
   const compressible = [];
   for (const m of history) {
     const text = plainText(m.content);
@@ -2738,7 +2849,7 @@ async function compactSessionTranscript(opts) {
   }
   const summary = `${COMPACT_SUMMARY_MARKER}
 ${summaryBody}`;
-  const transcript = chunk4SXHEZIV_cjs.SessionTranscript.fromRecords(prior, {
+  const transcript = chunkU2FO3MRG_cjs.SessionTranscript.fromRecords(prior, {
     cwd: opts.loc.cwd,
     sessionId: opts.sessionId,
     model: opts.loc.model ?? "unknown"
@@ -2859,5 +2970,5 @@ exports.resolveProviderChain = resolveProviderChain;
 exports.resolveSummarizerRoute = resolveSummarizerRoute;
 exports.shouldAutoCompact = shouldAutoCompact;
 exports.tryFirstEvent = tryFirstEvent;
-//# sourceMappingURL=chunk-2MF3IE2D.cjs.map
-//# sourceMappingURL=chunk-2MF3IE2D.cjs.map
+//# sourceMappingURL=chunk-NZCFLEHO.cjs.map
+//# sourceMappingURL=chunk-NZCFLEHO.cjs.map