@theokit/sdk 4.33.1 → 4.34.0

package/dist/{chunk-F5RLC6ZH.js → chunk-VQ6NY4F5.js}

@@ -1,4 +1,4 @@
-import { acquireSessionWriter } from './chunk-TOVGIP4L.js';
+import { acquireSessionWriter } from './chunk-IPHW3VKP.js';
 import { withFileLock, appendJsonl } from './chunk-UAYYNWYJ.js';
 import { readTranscript, transcriptPath } from './chunk-Q56IYTBZ.js';
 import { mkdir } from 'fs/promises';
@@ -47,13 +47,30 @@ var FsSessionStore = class {
     if (records.length === 0) return;
     const path = transcriptPath(this.#baseDir, this.#cwd, agentId);
     await mkdir(dirname(path), { recursive: true });
-    if (!this.#leases.has(agentId)) {
-      this.#leases.set(agentId, await adquirirCompartilhado(path));
-    }
     await withFileLock(path, async () => {
       for (const record of records) appendJsonl(path, record);
     });
   }
+  /**
+   * Toma o lease de escritor da sessão. Lança `SessionBusyError` quando outro processo a detém.
+   *
+   * **Explícito, e NÃO no `appendRecords`** — a revisão adversarial do M95 mediu por que isso
+   * importa: o contrato de `SessionStore` diz que "an `appendRecords` rejection is logged to
+   * stderr, NOT thrown to the caller (best-effort write)". Adquirir ali fazia o `SessionBusyError`
+   * ser **engolido**, e o resultado era pior que o problema original: em vez de dois escritores
+   * intercalarem linhas, o perdedor **perdia o turno em silêncio** — nada em disco, um aviso em
+   * stderr invisível sob a TUI, e o chamador sem como reagir.
+   *
+   * No init o erro chega a quem pode agir: o `exec` forka para um id novo, que é o que a própria
+   * mensagem do erro prescreve. É a diferença entre falhar onde dá para decidir e falhar onde só
+   * dá para perder.
+   */
+  async acquire(agentId) {
+    if (this.#leases.has(agentId)) return;
+    const path = transcriptPath(this.#baseDir, this.#cwd, agentId);
+    await mkdir(dirname(path), { recursive: true });
+    this.#leases.set(agentId, await adquirirCompartilhado(path));
+  }
   /**
    * Solta todo lease que este store detém.
    *
@@ -69,5 +86,5 @@ var FsSessionStore = class {
 };
 
 export { FsSessionStore };
-//# sourceMappingURL=chunk-F5RLC6ZH.js.map
-//# sourceMappingURL=chunk-F5RLC6ZH.js.map
+//# sourceMappingURL=chunk-VQ6NY4F5.js.map
+//# sourceMappingURL=chunk-VQ6NY4F5.js.map

package/dist/chunk-VQ6NY4F5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/persistence/fs-session-store.ts"],"names":[],"mappings":"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","file":"chunk-VQ6NY4F5.js","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\";\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\";\nimport { acquireSessionWriter, type SessionWriterLease } from \"./session-writer.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 */\n/**\n * Leases compartilhados por caminho, com contagem de referências.\n *\n * `acquireSessionWriter` é ESTRITO de propósito: duas aquisições concorrentes do mesmo caminho, e\n * exatamente uma vence — \"um lease que deixasse as duas passarem seria decorativo\" (o teste do M81\n * diz isso com todas as letras, e está certo). Esse é o contrato do primitivo, e ele não muda.\n *\n * Mas dentro de UM processo é normal existir mais de um store sobre a mesma sessão: os testes\n * golden de compactação e de sends concorrentes fazem exatamente isso, e são registro de\n * comportamento real do runtime. Aplicar o primitivo cru ali transformaria um padrão legítimo em\n * `SessionBusyError`.\n *\n * A conciliação é aqui, no consumidor do primitivo: o processo tira UM lease por caminho e conta\n * quantos stores o usam. O último a soltar libera de fato. Cross-process continua estrito — que é o\n * problema que o M81 enuncia (\"`exec resume --last` pode escrever na sessão viva da TUI\").\n */\nconst compartilhados = new Map<string, { lease: SessionWriterLease; refs: number }>();\n\nasync function adquirirCompartilhado(path: string): Promise<SessionWriterLease> {\n  const existente = compartilhados.get(path);\n  if (existente !== undefined) {\n    existente.refs++;\n    return criarProxy(path);\n  }\n  const lease = await acquireSessionWriter(path);\n  compartilhados.set(path, { lease, refs: 1 });\n  return criarProxy(path);\n}\n\n/** Um handle que decrementa a contagem; o último a soltar libera o lease de verdade. */\nfunction criarProxy(path: string): SessionWriterLease {\n  let solto = false;\n  return {\n    sessionPath: path,\n    release: async (): Promise<void> => {\n      if (solto) return;\n      solto = true;\n      const entrada = compartilhados.get(path);\n      if (entrada === undefined) return;\n      entrada.refs--;\n      if (entrada.refs > 0) return;\n      compartilhados.delete(path);\n      await entrada.lease.release();\n    },\n  };\n}\n\nexport class FsSessionStore implements SessionStore {\n  readonly #baseDir: string;\n  readonly #cwd: string;\n  /** Um lease por `agentId` — um store serve mais de uma sessão ao longo da vida do processo. */\n  readonly #leases = new Map<string, SessionWriterLease>();\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\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  /**\n   * Toma o lease de escritor da sessão. Lança `SessionBusyError` quando outro processo a detém.\n   *\n   * **Explícito, e NÃO no `appendRecords`** — a revisão adversarial do M95 mediu por que isso\n   * importa: o contrato de `SessionStore` diz que \"an `appendRecords` rejection is logged to\n   * stderr, NOT thrown to the caller (best-effort write)\". Adquirir ali fazia o `SessionBusyError`\n   * ser **engolido**, e o resultado era pior que o problema original: em vez de dois escritores\n   * intercalarem linhas, o perdedor **perdia o turno em silêncio** — nada em disco, um aviso em\n   * stderr invisível sob a TUI, e o chamador sem como reagir.\n   *\n   * No init o erro chega a quem pode agir: o `exec` forka para um id novo, que é o que a própria\n   * mensagem do erro prescreve. É a diferença entre falhar onde dá para decidir e falhar onde só\n   * dá para perder.\n   */\n  async acquire(agentId: string): Promise<void> {\n    if (this.#leases.has(agentId)) return;\n    const path = transcriptPath(this.#baseDir, this.#cwd, agentId);\n    await mkdir(dirname(path), { recursive: true });\n    this.#leases.set(agentId, await adquirirCompartilhado(path));\n  }\n\n  /**\n   * Solta todo lease que este store detém.\n   *\n   * Sem isto o `.writer.lock` sobrevive ao processo e a próxima abertura teria de esperar a janela\n   * de heartbeat — recuperável, mas 30 s de espera para um encerramento LIMPO seria um defeito\n   * evitável. Idempotente: chamar duas vezes não é erro.\n   */\n  async dispose(): Promise<void> {\n    const leases = [...this.#leases.values()];\n    this.#leases.clear();\n    for (const lease of leases) await lease.release();\n  }\n}\n"]}

package/dist/{chunk-FTRNHGAD.cjs → chunk-WEHUJ7ZS.cjs}

@@ -4,7 +4,7 @@ var chunkLUSXDZPV_cjs = require('./chunk-LUSXDZPV.cjs');
 var chunkIT3PWBW4_cjs = require('./chunk-IT3PWBW4.cjs');
 var chunk6JSIEDKL_cjs = require('./chunk-6JSIEDKL.cjs');
 var chunk2DYI7MIF_cjs = require('./chunk-2DYI7MIF.cjs');
-var chunkFX2DAR5R_cjs = require('./chunk-FX2DAR5R.cjs');
+var chunkM2PU44HP_cjs = require('./chunk-M2PU44HP.cjs');
 var chunkD42XHI4O_cjs = require('./chunk-D42XHI4O.cjs');
 var chunkA44COQJJ_cjs = require('./chunk-A44COQJJ.cjs');
 var chunkBEURCLDV_cjs = require('./chunk-BEURCLDV.cjs');
@@ -726,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-FTRNHGAD.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-WEHUJ7ZS.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");
@@ -2309,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-FTRNHGAD.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-WEHUJ7ZS.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");
@@ -2828,14 +2828,14 @@ async function compactSessionTranscript(opts) {
       compressible.push({ role: m.role, content: text });
     }
   }
-  const preTokens = chunkFX2DAR5R_cjs.estimateTokens(compressible.map((m) => m.content).join("\n"));
+  const preTokens = chunkM2PU44HP_cjs.estimateTokens(compressible.map((m) => m.content).join("\n"));
   const summaryBody = await opts.summarize(compressible);
   const preserved = [];
   let budget = 0;
   for (let i = compressible.length - 1; i >= 0; i--) {
     const m = compressible[i];
     if (m === void 0 || m.role !== "user" || isCompactSummary(m.content)) continue;
-    const cost = chunkFX2DAR5R_cjs.estimateTokens(m.content);
+    const cost = chunkM2PU44HP_cjs.estimateTokens(m.content);
     if (budget + cost > COMPACT_USER_MESSAGE_MAX_TOKENS) {
       const remaining = COMPACT_USER_MESSAGE_MAX_TOKENS - budget;
       if (remaining > 50) {
@@ -2860,7 +2860,7 @@ ${summaryBody}`;
   const delta = transcript.records().slice(prior.length);
   await opts.store.appendRecords(opts.loc.agentId, delta);
   chunkIT3PWBW4_cjs.invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);
-  const postTokens = chunkFX2DAR5R_cjs.estimateTokens([...preserved, summary].join("\n"));
+  const postTokens = chunkM2PU44HP_cjs.estimateTokens([...preserved, summary].join("\n"));
   return { preTokens, postTokens };
 }
 function resolveSummarizerRoute(opts) {
@@ -2970,5 +2970,5 @@ exports.resolveProviderChain = resolveProviderChain;
 exports.resolveSummarizerRoute = resolveSummarizerRoute;
 exports.shouldAutoCompact = shouldAutoCompact;
 exports.tryFirstEvent = tryFirstEvent;
-//# sourceMappingURL=chunk-FTRNHGAD.cjs.map
-//# sourceMappingURL=chunk-FTRNHGAD.cjs.map
+//# sourceMappingURL=chunk-WEHUJ7ZS.cjs.map
+//# sourceMappingURL=chunk-WEHUJ7ZS.cjs.map