@theokit/sdk 4.30.0 → 4.31.0

package/dist/{chunk-2HRYBRD7.cjs → chunk-U447MTG4.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkC7PICHRF_cjs = require('./chunk-C7PICHRF.cjs');
+var chunkWQEQCJTZ_cjs = require('./chunk-WQEQCJTZ.cjs');
 var chunk4SXHEZIV_cjs = require('./chunk-4SXHEZIV.cjs');
 var promises = require('fs/promises');
 var path = require('path');
@@ -19,13 +19,12 @@ var FsSessionStore = class {
     if (records.length === 0) return;
     const path$1 = chunk4SXHEZIV_cjs.transcriptPath(this.#baseDir, this.#cwd, agentId);
     await promises.mkdir(path.dirname(path$1), { recursive: true });
-    await chunkC7PICHRF_cjs.withFileLock(path$1, async () => {
-      const prior = await chunk4SXHEZIV_cjs.readTranscript(path$1);
-      await chunk4SXHEZIV_cjs.writeTranscript(path$1, [...prior, ...records]);
+    await chunkWQEQCJTZ_cjs.withFileLock(path$1, async () => {
+      for (const record of records) chunkWQEQCJTZ_cjs.appendJsonl(path$1, record);
     });
   }
 };
 
 exports.FsSessionStore = FsSessionStore;
-//# sourceMappingURL=chunk-2HRYBRD7.cjs.map
-//# sourceMappingURL=chunk-2HRYBRD7.cjs.map
+//# sourceMappingURL=chunk-U447MTG4.cjs.map
+//# sourceMappingURL=chunk-U447MTG4.cjs.map

package/dist/chunk-U447MTG4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/persistence/fs-session-store.ts"],"names":["readTranscript","transcriptPath","path","mkdir","dirname","withFileLock","appendJsonl"],"mappings":";;;;;;;AA6CO,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;AAgBnC,MAAA,KAAA,MAAW,MAAA,IAAU,OAAA,EAASI,6BAAA,CAAYJ,MAAA,EAAM,MAAM,CAAA;AAAA,IACxD,CAAC,CAAA;AAAA,EACH;AACF","file":"chunk-U447MTG4.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 {\n  readTranscript,\n  type SessionRecord,\n  transcriptPath,\n} 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**: ele é o que serializa dois `appendRecords` concorrentes, e\n      // trocar a operação não pode afrouxar a serialização.\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-UKNMWCPZ.cjs}

@@ -705,7 +705,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-UKNMWCPZ.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");
@@ -1926,6 +1926,60 @@ function abortError(signal) {
   return new Error("AbortError");
 }
 
+// src/internal/llm/retrying-client.ts
+var MAX_TENTATIVAS = 3;
+function ehTransitorio(err) {
+  if (err instanceof chunkA44COQJJ_cjs.AuthenticationError) return false;
+  if (err instanceof chunkA44COQJJ_cjs.RateLimitError) {
+    const status = err.metadata?.statusCode ?? 429;
+    return status !== 402;
+  }
+  return err instanceof Error && !/\b4\d\d\b/.test(err.message);
+}
+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;
+}
+var RetryingLlmClient = class {
+  #inner;
+  #rng;
+  constructor(inner, opts) {
+    this.#inner = inner;
+    this.#rng = opts?.rng;
+  }
+  get name() {
+    return this.#inner.name;
+  }
+  async *stream(request, signal) {
+    let ultimoErro;
+    for (let tentativa = 0; tentativa < MAX_TENTATIVAS; tentativa++) {
+      if (signal.aborted) throw ultimoErro ?? new Error("aborted");
+      try {
+        const gen = this.#inner.stream(request, signal);
+        let passo = await gen.next();
+        while (passo.done !== true) {
+          yield passo.value;
+          passo = await gen.next();
+        }
+        return passo.value;
+      } catch (err) {
+        ultimoErro = err;
+        const ultima = tentativa === MAX_TENTATIVAS - 1;
+        if (ultima || !ehTransitorio(err)) throw err;
+        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);
+      }
+    }
+    throw ultimoErro ?? new Error("retry esgotado sem erro registrado");
+  }
+};
+
 // src/internal/llm/responses.ts
 function messageToInputItems(message) {
   const items = [];
@@ -2202,7 +2256,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-UKNMWCPZ.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 +2436,8 @@ 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 +2463,13 @@ 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) {
@@ -2859,5 +2907,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-UKNMWCPZ.cjs.map
+//# sourceMappingURL=chunk-UKNMWCPZ.cjs.map