@theokit/sdk 4.34.0 → 4.34.2

package/dist/{chunk-IPHW3VKP.js → chunk-QWP3ZQ75.js}

@@ -1,5 +1,5 @@
 import { TheokitAgentError } from './chunk-WLKFWQSJ.js';
-import { openSync, closeSync, rmSync, readFileSync, writeSync } from 'fs';
+import { openSync, closeSync, rmSync, readFileSync, writeSync, fchmodSync } from 'fs';
 import { hostname } from 'os';
 
 var SessionBusyError = class extends TheokitAgentError {
@@ -18,6 +18,7 @@ function gravarDono(lockPath, dono) {
   const fd = openSync(lockPath, "w", 384);
   try {
     writeSync(fd, JSON.stringify(dono));
+    fchmodSync(fd, 384);
   } finally {
     closeSync(fd);
   }
@@ -26,8 +27,11 @@ function lerDono(lockPath) {
   let bruto;
   try {
     bruto = readFileSync(lockPath, "utf8");
-  } catch {
-    return void 0;
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT") return void 0;
+    if (code === "EISDIR") return void 0;
+    throw new SessionBusyError(lockPath.replace(/\.writer\.lock$/, ""));
   }
   try {
     const d = JSON.parse(bruto);
@@ -83,5 +87,5 @@ function criarLease(sessionPath, lockPath) {
 }
 
 export { SessionBusyError, acquireSessionWriter };
-//# sourceMappingURL=chunk-IPHW3VKP.js.map
-//# sourceMappingURL=chunk-IPHW3VKP.js.map
+//# sourceMappingURL=chunk-QWP3ZQ75.js.map
+//# sourceMappingURL=chunk-QWP3ZQ75.js.map

package/dist/chunk-QWP3ZQ75.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/persistence/session-writer.ts"],"names":[],"mappings":"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","file":"chunk-QWP3ZQ75.js","sourcesContent":["/**\n * M81 — single-writer lease for a session transcript.\n *\n * ## The problem\n *\n * Nothing stops two processes appending to the same JSONL transcript. The concrete case: `exec\n * resume --last` can write into the TUI's live session. Two interleaved appends to an append-only\n * file produce lines that are each individually valid and whose SEQUENCE is fiction — and nothing\n * reports it, because every line parses.\n *\n * ## Why an exclusive lockfile rather than `withFileLock`\n *\n * The plan's ADR D2 said to compose `withFileLock`, and that was the right instinct — do not build a\n * second lock mechanism. It turned out not to fit the SHAPE: `withFileLock(path, fn)` is\n * scope-based — it holds the lock for the duration of a callback. A session lease is **held across\n * turns**, for as long as the process owns the session, with an explicit `release()`. Wrapping the\n * whole session lifetime in a callback would invert control of the entire agent loop.\n *\n * So this uses the same underlying primitive `withFileLock` uses (an exclusive-create lockfile,\n * `wx`) with lease semantics on top. That keeps the mechanism single — the file-existence lock —\n * while giving it the lifetime the caller needs. The deviation from D2 is recorded here because the\n * plan's rationale (no second mechanism) still holds; only its shape assumption did not.\n *\n * ## Fail fast, never wait\n *\n * A second writer that WAITED would block `exec` behind a TUI session that can last hours. The typed\n * error lets the caller choose: fork to a new id, or give up with a real diagnosis.\n *\n * @internal\n */\n\nimport { closeSync, fchmodSync, openSync, readFileSync, rmSync, writeSync } from \"node:fs\";\nimport { hostname } from \"node:os\";\n\nimport { TheokitAgentError } from \"../../errors.js\";\n\n/**\n * M81 — another process already holds the writer lease for this session.\n *\n * Carries `sessionPath` because knowing WHICH session is busy is what lets the caller decide between\n * forking and waiting for the user to close the TUI (`rules/error-handling.md § 2` — context enough\n * to act on).\n */\nexport class SessionBusyError extends TheokitAgentError {\n  override readonly name = \"SessionBusyError\";\n\n  constructor(readonly sessionPath: string) {\n    super(\n      `another process is already writing this session: ${sessionPath}. ` +\n        \"Fork it to a new id instead of appending — two writers interleave lines into a sequence \" +\n        \"that parses but is not what either process wrote.\",\n      { code: \"session_busy\", isRetryable: false },\n    );\n  }\n}\n\n/** A held writer lease. `release()` is idempotent. */\nexport interface SessionWriterLease {\n  readonly sessionPath: string;\n  release(): Promise<void>;\n}\n\n/**\n * Take the exclusive writer lease for `sessionPath`, or reject with {@link SessionBusyError}.\n *\n * The lock is a sibling `.lock` file created with `wx` — the same file-existence primitive the\n * SDK's `withFileLock` builds on. Exclusivity comes from the filesystem, so it holds across\n * processes, not just across async tasks in one process.\n */\n/**\n * Janela de obsolescência **entre máquinas** — e só entre elas.\n *\n * 30 s a partir da AQUISIÇÃO. O nome \"heartbeat\" seria mentira: o registro é gravado uma vez, na\n * tomada do lease, e **não** é renovado a cada escrita. A versão anterior deste comentário dizia\n * \"o dono toca o arquivo a cada aquisição, então um processo ativo nunca cruza a janela\" — falso\n * duas vezes, e a revisão adversarial mediu as duas.\n *\n * No **mesmo host** isso não importa: `reclamavel` decide pelo `pid`, que é exato, e a idade não\n * entra na conta. Entre hosts, importa e é um limite real: um dono remoto **vivo** perde o lease\n * depois de 30 s, porque não há como perguntar a outra máquina se o processo dela existe.\n *\n * **Resíduo declarado, não mecanizado** (a disciplina de `error-handling.md § 4`): renovar o\n * registro a cada append fecharia essa janela, ao custo de um `write` por turno num arquivo que\n * hoje é escrito uma vez por sessão. Não foi feito, e o caso multi-host não é o que motiva este\n * milestone — o enunciado é `exec` e TUI na mesma máquina.\n */\nexport const JANELA_DE_HEARTBEAT_MS = 30_000;\n\n/** Quem detém o lock. Gravado como JSON no `.writer.lock`. */\ninterface DonoDoLock {\n  pid: number;\n  hostname: string;\n  mtime: number;\n}\n\n/**\n * Grava o dono com permissão restrita ao usuário.\n *\n * `0600` porque o lock é uma afirmação de POSSE: com o `0664` que o umask usual produz, outro\n * usuário do mesmo grupo pode sobrescrever o arquivo e forjar a posse da sessão — e a partir daí o\n * dono legítimo é quem passa a receber `SessionBusyError`. O conteúdo (`pid`, `hostname`) é de\n * baixa sensibilidade; o que a permissão protege é a **integridade** do sinal, não o sigilo dele.\n */\nfunction gravarDono(lockPath: string, dono: DonoDoLock): void {\n  const fd = openSync(lockPath, \"w\", 0o600);\n  try {\n    writeSync(fd, JSON.stringify(dono));\n    // O `mode` do `open` só vale na CRIAÇÃO. Um `.writer.lock` herdado de uma versão anterior — ou\n    // deixado por um processo com umask diferente — continuaria `0664` depois de reclamado, e a\n    // janela de forja que o modo fecha para locks novos seguiria aberta para os antigos.\n    fchmodSync(fd, 0o600);\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/** Lê o dono do lock. `undefined` quando o arquivo sumiu ou o conteúdo é ilegível. */\nfunction lerDono(lockPath: string): DonoDoLock | undefined {\n  let bruto: string;\n  try {\n    bruto = readFileSync(lockPath, \"utf8\");\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException).code;\n    // `ENOENT` — sumiu entre o `EEXIST` e a leitura. Corrida benigna: o lock não existe mais.\n    if (code === \"ENOENT\") return undefined;\n    // `EISDIR` — o caminho do lock é um DIRETÓRIO. Nenhum processo desta biblioteca cria um; é\n    // lixo de outra coisa, e nunca vai virar um lock legível. Fail-closed aqui trancaria a sessão\n    // para sempre, sem recuperação — o oposto do que este milestone existe para garantir.\n    if (code === \"EISDIR\") return undefined;\n    // Qualquer outra falha de leitura (`EACCES` num diretório compartilhado, `EIO`) é diferente em\n    // espécie: o lock **existe** e nós é que não conseguimos ler o dono. Tratar como livre faria\n    // dois escritores conviverem — precisamente o que o lease existe para impedir —, e o `0600`\n    // que protege o lock contra forja AMPLIA essa superfície: num diretório compartilhado, o lock\n    // do outro usuário é ilegível por desenho.\n    //\n    // Não saber quem é o dono não é o mesmo que não haver dono. Fail-closed.\n    throw new SessionBusyError(lockPath.replace(/\\.writer\\.lock$/, \"\"));\n  }\n  try {\n    const d = JSON.parse(bruto) as Partial<DonoDoLock>;\n    if (\n      typeof d.pid !== \"number\" ||\n      typeof d.hostname !== \"string\" ||\n      typeof d.mtime !== \"number\"\n    ) {\n      return undefined;\n    }\n    return { pid: d.pid, hostname: d.hostname, mtime: d.mtime };\n  } catch {\n    // JSON ilegível: um lock que ninguém consegue interpretar não pode trancar a sessão para\n    // sempre. Tratar como obsoleto é a escolha recuperável; o custo é o mesmo de um lock velho.\n    return undefined;\n  }\n}\n\n/** O processo existe? `signal 0` não envia nada — só consulta permissão/existência. */\nfunction processoVivo(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (err) {\n    // EPERM significa que ele EXISTE e é de outro usuário.\n    return (err as NodeJS.ErrnoException).code === \"EPERM\";\n  }\n}\n\n/**\n * O lock pode ser tomado de quem o detém?\n *\n * ADR-2 do plano: reclamar por `pid` sozinho tem falso positivo entre máquinas — o mesmo número\n * existe noutro host, apontando para um processo sem relação. Então:\n *\n * - **mesmo host:** o `pid` é autoritativo, e **só** ele. Processo morto ⇒ reclamável na hora;\n *   processo vivo ⇒ nunca, por mais velho que o lock esteja.\n * - **outro host:** o `pid` não diz nada aqui. Só a janela de heartbeat vale, porque é o único\n *   sinal que não mente entre máquinas.\n *\n * ## Por que a idade NÃO conta no mesmo host\n *\n * A primeira versão fazia `velho || !processoVivo(pid)`, e isso era um defeito grave: o `mtime` é\n * gravado na **aquisição** e não é tocado a cada append, então qualquer sessão que durasse mais que\n * a janela — isto é, **toda sessão real** — passava a ser roubável por outro processo. Dois\n * escritores no mesmo transcript é exatamente o que o lease existe para impedir.\n *\n * No mesmo host a pergunta \"o dono ainda existe?\" tem resposta exata, e a idade não acrescenta\n * informação nenhuma a ela — só um modo de errar. Manter a janela ali seria heurística por cima de\n * um fato.\n */\nfunction reclamavel(dono: DonoDoLock | undefined): boolean {\n  if (dono === undefined) return true; // ilegível ou sumido\n  if (dono.hostname !== hostname()) {\n    return Date.now() - dono.mtime > JANELA_DE_HEARTBEAT_MS;\n  }\n  return !processoVivo(dono.pid);\n}\n\nexport async function acquireSessionWriter(sessionPath: string): Promise<SessionWriterLease> {\n  // M95 — `.writer.lock`, NÃO `.lock`.\n  //\n  // `withFileLock(path, fn)` já usa `<path>.lock` como companheiro. Enquanto o lease não era\n  // chamado de lugar nenhum (o defeito que este milestone corrige) a colisão era teórica; ligá-lo\n  // ao mesmo arquivo faria o lease de vida longa bloquear toda seção crítica curta do mesmo path.\n  //\n  // Dois arquivos porque são duas coisas: `withFileLock` protege uma seção com início e fim; o\n  // lease é POSSE, mantida através de turnos, com `release()` explícito — a distinção que o\n  // docstring do M81 acima já explica.\n  const lockPath = `${sessionPath}.writer.lock`;\n  const meu: DonoDoLock = { pid: process.pid, hostname: hostname(), mtime: Date.now() };\n  let fd: number;\n  try {\n    // O modo vale na CRIAÇÃO — o `w` de `gravarDono` não altera arquivo existente.\n    fd = openSync(lockPath, \"wx\", 0o600);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"EEXIST\") throw err;\n    // M95 — o lock existe. Até aqui isso bastava para recusar, e era o defeito: uma TUI morta por\n    // SIGKILL trancava o usuário para fora da própria sessão PERMANENTEMENTE, sem caminho de\n    // recuperação documentado. Agora o lock diz quem é o dono, e um dono morto cede o lugar.\n    if (!reclamavel(lerDono(lockPath))) throw new SessionBusyError(sessionPath);\n    gravarDono(lockPath, meu);\n    return criarLease(sessionPath, lockPath);\n  }\n  closeSync(fd);\n  gravarDono(lockPath, meu);\n\n  return criarLease(sessionPath, lockPath);\n}\n\n/** O lease em si — `release()` idempotente. Extraído porque a aquisição tem dois caminhos de saída. */\nfunction criarLease(sessionPath: string, lockPath: string): SessionWriterLease {\n  let released = false;\n  return {\n    sessionPath,\n    release: async (): Promise<void> => {\n      if (released) return;\n      released = true;\n      rmSync(lockPath, { force: true });\n    },\n  };\n}\n"]}

package/dist/{chunk-IAZX7RZM.cjs → chunk-RMRBHTA3.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkJYMBHNNU_cjs = require('./chunk-JYMBHNNU.cjs');
+var chunkAFOLLMVQ_cjs = require('./chunk-AFOLLMVQ.cjs');
 var chunkCJVMDRQB_cjs = require('./chunk-CJVMDRQB.cjs');
 var chunk2DYI7MIF_cjs = require('./chunk-2DYI7MIF.cjs');
 var promises = require('fs/promises');
@@ -13,7 +13,7 @@ async function adquirirCompartilhado(path) {
     existente.refs++;
     return criarProxy(path);
   }
-  const lease = await chunkJYMBHNNU_cjs.acquireSessionWriter(path);
+  const lease = await chunkAFOLLMVQ_cjs.acquireSessionWriter(path);
   compartilhados.set(path, { lease, refs: 1 });
   return criarProxy(path);
 }
@@ -73,6 +73,19 @@ var FsSessionStore = class {
     await promises.mkdir(path.dirname(path$1), { recursive: true });
     this.#leases.set(agentId, await adquirirCompartilhado(path$1));
   }
+  /**
+   * Solta o lease de UM agente.
+   *
+   * Existe porque `dispose()` solta **todos** os leases do store, e um store injetado pelo
+   * consumidor pode servir vários agentes: um init que falha para o agente B não pode liberar o
+   * lease do agente A, que segue vivo e escrevendo.
+   */
+  async release(agentId) {
+    const lease = this.#leases.get(agentId);
+    if (lease === void 0) return;
+    this.#leases.delete(agentId);
+    await lease.release();
+  }
   /**
    * Solta todo lease que este store detém.
    *
@@ -88,5 +101,5 @@ var FsSessionStore = class {
 };
 
 exports.FsSessionStore = FsSessionStore;
-//# sourceMappingURL=chunk-IAZX7RZM.cjs.map
-//# sourceMappingURL=chunk-IAZX7RZM.cjs.map
+//# sourceMappingURL=chunk-RMRBHTA3.cjs.map
+//# sourceMappingURL=chunk-RMRBHTA3.cjs.map

package/dist/chunk-RMRBHTA3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/persistence/fs-session-store.ts"],"names":["acquireSessionWriter","readTranscript","transcriptPath","path","mkdir","dirname","withFileLock","appendJsonl"],"mappings":"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","file":"chunk-RMRBHTA3.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\";\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 o lease de UM agente.\n   *\n   * Existe porque `dispose()` solta **todos** os leases do store, e um store injetado pelo\n   * consumidor pode servir vários agentes: um init que falha para o agente B não pode liberar o\n   * lease do agente A, que segue vivo e escrevendo.\n   */\n  async release(agentId: string): Promise<void> {\n    const lease = this.#leases.get(agentId);\n    if (lease === undefined) return;\n    this.#leases.delete(agentId);\n    await lease.release();\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/cron.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkIZFZ6RHA_cjs = require('./chunk-IZFZ6RHA.cjs');
-require('./chunk-TS6IPRME.cjs');
+var chunkBOTI6ZOX_cjs = require('./chunk-BOTI6ZOX.cjs');
+require('./chunk-P7SIIQIS.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-MZ5ZRORA.cjs');
 require('./chunk-G4WI3VW2.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-IAZX7RZM.cjs');
+require('./chunk-RMRBHTA3.cjs');
 require('./chunk-WEHUJ7ZS.cjs');
 require('./chunk-LUSXDZPV.cjs');
 require('./chunk-IT3PWBW4.cjs');
@@ -22,7 +22,7 @@ require('./chunk-YPEPCZHF.cjs');
 require('./chunk-VJ26EKGJ.cjs');
 require('./chunk-GIW4L6HY.cjs');
 require('./chunk-7S7KKUO6.cjs');
-require('./chunk-JYMBHNNU.cjs');
+require('./chunk-AFOLLMVQ.cjs');
 require('./chunk-CJVMDRQB.cjs');
 require('./chunk-JD74LN7R.cjs');
 require('./chunk-YLQQX5W2.cjs');
@@ -46,7 +46,7 @@ require('./chunk-BEURCLDV.cjs');
 
 Object.defineProperty(exports, "Cron", {
   enumerable: true,
-  get: function () { return chunkIZFZ6RHA_cjs.Cron; }
+  get: function () { return chunkBOTI6ZOX_cjs.Cron; }
 });
 //# sourceMappingURL=cron.cjs.map
 //# sourceMappingURL=cron.cjs.map

package/dist/cron.js

@@ -1,10 +1,10 @@
-export { Cron } from './chunk-5QMXYX3X.js';
-import './chunk-TPTHVSIG.js';
+export { Cron } from './chunk-MNLBNL7T.js';
+import './chunk-JZSBSUFT.js';
 import './chunk-2SFBB54R.js';
 import './chunk-HRA3CPGG.js';
 import './chunk-7BTE3RXJ.js';
 import './chunk-K2BQQ445.js';
-import './chunk-VQ6NY4F5.js';
+import './chunk-4NU7GXH2.js';
 import './chunk-IX2LKBCD.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
@@ -20,7 +20,7 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-IPHW3VKP.js';
+import './chunk-QWP3ZQ75.js';
 import './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';
 import './chunk-2XLKLVVR.js';

package/dist/eval.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
 var chunkS7OEXQMI_cjs = require('./chunk-S7OEXQMI.cjs');
-var chunkTS6IPRME_cjs = require('./chunk-TS6IPRME.cjs');
+var chunkP7SIIQIS_cjs = require('./chunk-P7SIIQIS.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-MZ5ZRORA.cjs');
 require('./chunk-G4WI3VW2.cjs');
 var chunkBUUUWQMB_cjs = require('./chunk-BUUUWQMB.cjs');
-require('./chunk-IAZX7RZM.cjs');
+require('./chunk-RMRBHTA3.cjs');
 require('./chunk-WEHUJ7ZS.cjs');
 require('./chunk-LUSXDZPV.cjs');
 require('./chunk-IT3PWBW4.cjs');
@@ -22,7 +22,7 @@ require('./chunk-YPEPCZHF.cjs');
 require('./chunk-VJ26EKGJ.cjs');
 require('./chunk-GIW4L6HY.cjs');
 require('./chunk-7S7KKUO6.cjs');
-require('./chunk-JYMBHNNU.cjs');
+require('./chunk-AFOLLMVQ.cjs');
 var chunkCJVMDRQB_cjs = require('./chunk-CJVMDRQB.cjs');
 require('./chunk-JD74LN7R.cjs');
 require('./chunk-YLQQX5W2.cjs');
@@ -768,7 +768,7 @@ function makeDefaultEmbedder(opts) {
   let runtime;
   return (texts) => {
     if (runtime === void 0) {
-      runtime = chunkTS6IPRME_cjs.openRouterMemoryEmbeddingProviderAdapter.create(embedderCreateOptions(opts));
+      runtime = chunkP7SIIQIS_cjs.openRouterMemoryEmbeddingProviderAdapter.create(embedderCreateOptions(opts));
     }
     return runtime.then((rt) => rt.embed(texts));
   };

package/dist/eval.js

@@ -1,10 +1,10 @@
 import { shellEscapePosix, LocalSandbox } from './chunk-SKWVAQAY.js';
-import { openRouterMemoryEmbeddingProviderAdapter } from './chunk-TPTHVSIG.js';
+import { openRouterMemoryEmbeddingProviderAdapter } from './chunk-JZSBSUFT.js';
 import './chunk-2SFBB54R.js';
 import './chunk-HRA3CPGG.js';
 import './chunk-7BTE3RXJ.js';
 import { getTracer } from './chunk-K2BQQ445.js';
-import './chunk-VQ6NY4F5.js';
+import './chunk-4NU7GXH2.js';
 import './chunk-IX2LKBCD.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
@@ -20,7 +20,7 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-IPHW3VKP.js';
+import './chunk-QWP3ZQ75.js';
 import { readJsonlIds, appendJsonl } from './chunk-UAYYNWYJ.js';
 export { JsonlParseError, loadJsonl } from './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';

package/dist/{fs-session-store-QS763E3Y.cjs → fs-session-store-2G4O63PO.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkIAZX7RZM_cjs = require('./chunk-IAZX7RZM.cjs');
-require('./chunk-JYMBHNNU.cjs');
+var chunkRMRBHTA3_cjs = require('./chunk-RMRBHTA3.cjs');
+require('./chunk-AFOLLMVQ.cjs');
 require('./chunk-CJVMDRQB.cjs');
 require('./chunk-YLQQX5W2.cjs');
 require('./chunk-2DYI7MIF.cjs');
@@ -13,7 +13,7 @@ require('./chunk-BEURCLDV.cjs');
 
 Object.defineProperty(exports, "FsSessionStore", {
   enumerable: true,
-  get: function () { return chunkIAZX7RZM_cjs.FsSessionStore; }
+  get: function () { return chunkRMRBHTA3_cjs.FsSessionStore; }
 });
-//# sourceMappingURL=fs-session-store-QS763E3Y.cjs.map
-//# sourceMappingURL=fs-session-store-QS763E3Y.cjs.map
+//# sourceMappingURL=fs-session-store-2G4O63PO.cjs.map
+//# sourceMappingURL=fs-session-store-2G4O63PO.cjs.map

package/dist/{fs-session-store-QS763E3Y.cjs.map → fs-session-store-2G4O63PO.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-QS763E3Y.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-2G4O63PO.cjs"}

package/dist/fs-session-store-Q3E5S7MC.js

@@ -0,0 +1,10 @@
+export { FsSessionStore } from './chunk-4NU7GXH2.js';
+import './chunk-QWP3ZQ75.js';
+import './chunk-UAYYNWYJ.js';
+import './chunk-2XLKLVVR.js';
+import './chunk-Q56IYTBZ.js';
+import './chunk-S2BBRVQX.js';
+import './chunk-WLKFWQSJ.js';
+import './chunk-JTFYYKDT.js';
+//# sourceMappingURL=fs-session-store-Q3E5S7MC.js.map
+//# sourceMappingURL=fs-session-store-Q3E5S7MC.js.map

package/dist/{fs-session-store-SJ3RA5I2.js.map → fs-session-store-Q3E5S7MC.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-SJ3RA5I2.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-Q3E5S7MC.js"}

package/dist/index.cjs

@@ -8,13 +8,13 @@ require('./chunk-EPYZOCOL.cjs');
 var chunkZ2OC3UIW_cjs = require('./chunk-Z2OC3UIW.cjs');
 require('./chunk-BWT67BI4.cjs');
 require('./chunk-PNVDQL5Y.cjs');
-var chunkIZFZ6RHA_cjs = require('./chunk-IZFZ6RHA.cjs');
-var chunkTS6IPRME_cjs = require('./chunk-TS6IPRME.cjs');
+var chunkBOTI6ZOX_cjs = require('./chunk-BOTI6ZOX.cjs');
+var chunkP7SIIQIS_cjs = require('./chunk-P7SIIQIS.cjs');
 require('./chunk-BV2MWEMV.cjs');
 var chunkMZ5ZRORA_cjs = require('./chunk-MZ5ZRORA.cjs');
 require('./chunk-G4WI3VW2.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-IAZX7RZM.cjs');
+require('./chunk-RMRBHTA3.cjs');
 var chunkWEHUJ7ZS_cjs = require('./chunk-WEHUJ7ZS.cjs');
 require('./chunk-LUSXDZPV.cjs');
 require('./chunk-IT3PWBW4.cjs');
@@ -30,7 +30,7 @@ require('./chunk-YPEPCZHF.cjs');
 require('./chunk-VJ26EKGJ.cjs');
 require('./chunk-GIW4L6HY.cjs');
 require('./chunk-7S7KKUO6.cjs');
-require('./chunk-JYMBHNNU.cjs');
+require('./chunk-AFOLLMVQ.cjs');
 require('./chunk-CJVMDRQB.cjs');
 require('./chunk-JD74LN7R.cjs');
 var chunkYLQQX5W2_cjs = require('./chunk-YLQQX5W2.cjs');
@@ -58,8 +58,8 @@ var fs = require('fs');
 // src/agent-factory.ts
 function createAgentFactory(common) {
   return {
-    forSession: (agentId, overrides) => chunkTS6IPRME_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
-    getOrCreate: (agentId, overrides) => chunkTS6IPRME_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
+    forSession: (agentId, overrides) => chunkP7SIIQIS_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
+    getOrCreate: (agentId, overrides) => chunkP7SIIQIS_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
   };
 }
 function mergeAgentOptions(common, overrides, agentId) {
@@ -1165,7 +1165,7 @@ var Memory = {
       return await peer.IndexManager.open(openArgs);
     }
     const { IndexManager } = await import('./index-manager-H7HUMW52.cjs');
-    openArgs.embedding = await resolveEmbedding(opts.embedding, chunkTS6IPRME_cjs.MEMORY_EMBEDDING_ADAPTERS);
+    openArgs.embedding = await resolveEmbedding(opts.embedding, chunkP7SIIQIS_cjs.MEMORY_EMBEDDING_ADAPTERS);
     return await IndexManager.open(openArgs);
   },
   /**
@@ -1176,7 +1176,7 @@ var Memory = {
    */
   async runDreamingSweep(opts) {
     const peer = await tryLoadSdkMemoryPeer();
-    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunkTS6IPRME_cjs.MEMORY_EMBEDDING_ADAPTERS;
+    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunkP7SIIQIS_cjs.MEMORY_EMBEDDING_ADAPTERS;
     const sweepArgs = await buildDreamingSweepArgs(opts, catalog);
     const result = peer !== null ? (
       // biome-ignore lint/suspicious/noExplicitAny: peer is dynamically loaded — structural compat ensured by sdk-memory
@@ -1598,7 +1598,7 @@ function ehAgenteConstruido(m) {
   return typeof m.send === "function";
 }
 async function materializar(def, indice) {
-  const { Agent: Agent2 } = await import('./agent-W6NI3HY4.cjs');
+  const { Agent: Agent2 } = await import('./agent-IJUQN6RK.cjs');
   return Agent2.create({
     // `AgentDefinition.model` admite o sentinel `'inherit'`, que não é um id de modelo. Herdar
     // aqui significa "não declare nada e deixe o default valer" — passar o literal adiante criaria
@@ -1740,7 +1740,7 @@ var FIXTURE_USER = {
 };
 var FIXTURE_MODELS = [
   {
-    id: chunkTS6IPRME_cjs.DEFAULT_AGENTIC_MODEL_ID,
+    id: chunkP7SIIQIS_cjs.DEFAULT_AGENTIC_MODEL_ID,
     name: "Gemini 2.0 Flash",
     displayName: "Gemini 2.0 Flash",
     parameters: [
@@ -1948,7 +1948,7 @@ var Theokit = class {
         envVars: p.envVars
       }));
     },
-    embeddingAdapters: () => Object.entries(chunkTS6IPRME_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
+    embeddingAdapters: () => Object.entries(chunkP7SIIQIS_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
       id,
       transport: adapter.transport,
       defaultModel: adapter.defaultModel
@@ -1980,17 +1980,17 @@ function resolveLocalProviderBaseUrl(providerName, fallback) {
   return fallback;
 }
 async function executeCatalogRequest(request) {
-  const apiKey = chunkTS6IPRME_cjs.resolveApiKey(request.apiKey);
+  const apiKey = chunkP7SIIQIS_cjs.resolveApiKey(request.apiKey);
   if (apiKey === void 0) {
     throw new chunkA44COQJJ_cjs.AuthenticationError("Missing API key", { code: "missing_api_key" });
   }
-  if (chunkTS6IPRME_cjs.shouldUseFixtureMode(apiKey)) {
+  if (chunkP7SIIQIS_cjs.shouldUseFixtureMode(apiKey)) {
     return request.fixture;
   }
-  if (!chunkTS6IPRME_cjs.isFixtureApiKey(apiKey) && process.env.THEOKIT_API_BASE_URL === void 0) {
+  if (!chunkP7SIIQIS_cjs.isFixtureApiKey(apiKey) && process.env.THEOKIT_API_BASE_URL === void 0) {
     throw new chunkA44COQJJ_cjs.AuthenticationError("Invalid API key", { code: "authentication_error" });
   }
-  return chunkTS6IPRME_cjs.httpRequest(request.path, { apiKey });
+  return chunkP7SIIQIS_cjs.httpRequest(request.path, { apiKey });
 }
 
 // src/trajectory-helpers.ts
@@ -2106,35 +2106,35 @@ Object.defineProperty(exports, "GenerateObjectError", {
 });
 Object.defineProperty(exports, "Cron", {
   enumerable: true,
-  get: function () { return chunkIZFZ6RHA_cjs.Cron; }
+  get: function () { return chunkBOTI6ZOX_cjs.Cron; }
 });
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.Agent; }
+  get: function () { return chunkP7SIIQIS_cjs.Agent; }
 });
 Object.defineProperty(exports, "AgentBuilder", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.AgentBuilder; }
+  get: function () { return chunkP7SIIQIS_cjs.AgentBuilder; }
 });
 Object.defineProperty(exports, "Tool", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.Tool; }
+  get: function () { return chunkP7SIIQIS_cjs.Tool; }
 });
 Object.defineProperty(exports, "ToolError", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.ToolError; }
+  get: function () { return chunkP7SIIQIS_cjs.ToolError; }
 });
 Object.defineProperty(exports, "UsageAccumulator", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.UsageAccumulator; }
+  get: function () { return chunkP7SIIQIS_cjs.UsageAccumulator; }
 });
 Object.defineProperty(exports, "computeCost", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.computeCost; }
+  get: function () { return chunkP7SIIQIS_cjs.computeCost; }
 });
 Object.defineProperty(exports, "getPricingEntry", {
   enumerable: true,
-  get: function () { return chunkTS6IPRME_cjs.getPricingEntry; }
+  get: function () { return chunkP7SIIQIS_cjs.getPricingEntry; }
 });
 Object.defineProperty(exports, "emitRunEvent", {
   enumerable: true,

package/dist/index.js

@@ -6,15 +6,15 @@ import './chunk-GJAGKFTR.js';
 import { Workflow, agentStep } from './chunk-BFWPZMG7.js';
 import './chunk-UVNG67DG.js';
 import './chunk-CAH3G4IS.js';
-export { Cron } from './chunk-5QMXYX3X.js';
-import { MEMORY_EMBEDDING_ADAPTERS, resolveApiKey, shouldUseFixtureMode, isFixtureApiKey, httpRequest, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-TPTHVSIG.js';
-export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-TPTHVSIG.js';
+export { Cron } from './chunk-MNLBNL7T.js';
+import { MEMORY_EMBEDDING_ADAPTERS, resolveApiKey, shouldUseFixtureMode, isFixtureApiKey, httpRequest, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-JZSBSUFT.js';
+export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-JZSBSUFT.js';
 import './chunk-2SFBB54R.js';
 import { configure, submit, list, get, cancel, subscribe } from './chunk-HRA3CPGG.js';
 export { emitRunEvent } from './chunk-HRA3CPGG.js';
 import './chunk-7BTE3RXJ.js';
 import './chunk-K2BQQ445.js';
-import './chunk-VQ6NY4F5.js';
+import './chunk-4NU7GXH2.js';
 import { discoverProviderPlugins, mapOllamaTransportError, mapOllamaHttpError } from './chunk-IX2LKBCD.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
@@ -30,7 +30,7 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-IPHW3VKP.js';
+import './chunk-QWP3ZQ75.js';
 import './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';
 import { withCwdMutex } from './chunk-2XLKLVVR.js';
@@ -1600,7 +1600,7 @@ function ehAgenteConstruido(m) {
   return typeof m.send === "function";
 }
 async function materializar(def, indice) {
-  const { Agent: Agent2 } = await import('./agent-EQQA5VGX.js');
+  const { Agent: Agent2 } = await import('./agent-F77TRYGM.js');
   return Agent2.create({
     // `AgentDefinition.model` admite o sentinel `'inherit'`, que não é um id de modelo. Herdar
     // aqui significa "não declare nada e deixe o default valer" — passar o literal adiante criaria

package/dist/internal/persistence/fs-session-store.d.cts

@@ -46,6 +46,14 @@ export declare class FsSessionStore implements SessionStore {
      * dá para perder.
      */
     acquire(agentId: string): Promise<void>;
+    /**
+     * Solta o lease de UM agente.
+     *
+     * Existe porque `dispose()` solta **todos** os leases do store, e um store injetado pelo
+     * consumidor pode servir vários agentes: um init que falha para o agente B não pode liberar o
+     * lease do agente A, que segue vivo e escrevendo.
+     */
+    release(agentId: string): Promise<void>;
     /**
      * Solta todo lease que este store detém.
      *

package/dist/internal/persistence/fs-session-store.d.ts

@@ -46,6 +46,14 @@ export declare class FsSessionStore implements SessionStore {
      * dá para perder.
      */
     acquire(agentId: string): Promise<void>;
+    /**
+     * Solta o lease de UM agente.
+     *
+     * Existe porque `dispose()` solta **todos** os leases do store, e um store injetado pelo
+     * consumidor pode servir vários agentes: um init que falha para o agente B não pode liberar o
+     * lease do agente A, que segue vivo e escrevendo.
+     */
+    release(agentId: string): Promise<void>;
     /**
      * Solta todo lease que este store detém.
      *

package/dist/persistence.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkPNVDQL5Y_cjs = require('./chunk-PNVDQL5Y.cjs');
-var chunkJYMBHNNU_cjs = require('./chunk-JYMBHNNU.cjs');
+var chunkAFOLLMVQ_cjs = require('./chunk-AFOLLMVQ.cjs');
 var chunkCJVMDRQB_cjs = require('./chunk-CJVMDRQB.cjs');
 var chunkJD74LN7R_cjs = require('./chunk-JD74LN7R.cjs');
 var chunkYLQQX5W2_cjs = require('./chunk-YLQQX5W2.cjs');
@@ -83,11 +83,11 @@ Object.defineProperty(exports, "PersistenceSchema", {
 });
 Object.defineProperty(exports, "SessionBusyError", {
   enumerable: true,
-  get: function () { return chunkJYMBHNNU_cjs.SessionBusyError; }
+  get: function () { return chunkAFOLLMVQ_cjs.SessionBusyError; }
 });
 Object.defineProperty(exports, "acquireSessionWriter", {
   enumerable: true,
-  get: function () { return chunkJYMBHNNU_cjs.acquireSessionWriter; }
+  get: function () { return chunkAFOLLMVQ_cjs.acquireSessionWriter; }
 });
 Object.defineProperty(exports, "JsonlParseError", {
   enumerable: true,

package/dist/persistence.js

@@ -1,5 +1,5 @@
 export { PersistenceSchema } from './chunk-CAH3G4IS.js';
-export { SessionBusyError, acquireSessionWriter } from './chunk-IPHW3VKP.js';
+export { SessionBusyError, acquireSessionWriter } from './chunk-QWP3ZQ75.js';
 export { JsonlParseError, appendJsonl, loadJsonl, readJsonlIds, withFileLock } from './chunk-UAYYNWYJ.js';
 export { applyWalWithFallback, isCorruptionError, openSqliteResilient, sanitizeFts5Query } from './chunk-77FOZCOT.js';
 export { withCwdMutex } from './chunk-2XLKLVVR.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.34.0",
+  "version": "4.34.2",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheodev/theokit-sdk#readme",

package/dist/chunk-IAZX7RZM.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/internal/persistence/fs-session-store.ts"],"names":["acquireSessionWriter","readTranscript","transcriptPath","path","mkdir","dirname","withFileLock","appendJsonl"],"mappings":"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","file":"chunk-IAZX7RZM.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\";\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-IPHW3VKP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/internal/persistence/session-writer.ts"],"names":[],"mappings":"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","file":"chunk-IPHW3VKP.js","sourcesContent":["/**\n * M81 — single-writer lease for a session transcript.\n *\n * ## The problem\n *\n * Nothing stops two processes appending to the same JSONL transcript. The concrete case: `exec\n * resume --last` can write into the TUI's live session. Two interleaved appends to an append-only\n * file produce lines that are each individually valid and whose SEQUENCE is fiction — and nothing\n * reports it, because every line parses.\n *\n * ## Why an exclusive lockfile rather than `withFileLock`\n *\n * The plan's ADR D2 said to compose `withFileLock`, and that was the right instinct — do not build a\n * second lock mechanism. It turned out not to fit the SHAPE: `withFileLock(path, fn)` is\n * scope-based — it holds the lock for the duration of a callback. A session lease is **held across\n * turns**, for as long as the process owns the session, with an explicit `release()`. Wrapping the\n * whole session lifetime in a callback would invert control of the entire agent loop.\n *\n * So this uses the same underlying primitive `withFileLock` uses (an exclusive-create lockfile,\n * `wx`) with lease semantics on top. That keeps the mechanism single — the file-existence lock —\n * while giving it the lifetime the caller needs. The deviation from D2 is recorded here because the\n * plan's rationale (no second mechanism) still holds; only its shape assumption did not.\n *\n * ## Fail fast, never wait\n *\n * A second writer that WAITED would block `exec` behind a TUI session that can last hours. The typed\n * error lets the caller choose: fork to a new id, or give up with a real diagnosis.\n *\n * @internal\n */\n\nimport { closeSync, openSync, readFileSync, rmSync, writeSync } from \"node:fs\";\nimport { hostname } from \"node:os\";\n\nimport { TheokitAgentError } from \"../../errors.js\";\n\n/**\n * M81 — another process already holds the writer lease for this session.\n *\n * Carries `sessionPath` because knowing WHICH session is busy is what lets the caller decide between\n * forking and waiting for the user to close the TUI (`rules/error-handling.md § 2` — context enough\n * to act on).\n */\nexport class SessionBusyError extends TheokitAgentError {\n  override readonly name = \"SessionBusyError\";\n\n  constructor(readonly sessionPath: string) {\n    super(\n      `another process is already writing this session: ${sessionPath}. ` +\n        \"Fork it to a new id instead of appending — two writers interleave lines into a sequence \" +\n        \"that parses but is not what either process wrote.\",\n      { code: \"session_busy\", isRetryable: false },\n    );\n  }\n}\n\n/** A held writer lease. `release()` is idempotent. */\nexport interface SessionWriterLease {\n  readonly sessionPath: string;\n  release(): Promise<void>;\n}\n\n/**\n * Take the exclusive writer lease for `sessionPath`, or reject with {@link SessionBusyError}.\n *\n * The lock is a sibling `.lock` file created with `wx` — the same file-existence primitive the\n * SDK's `withFileLock` builds on. Exclusivity comes from the filesystem, so it holds across\n * processes, not just across async tasks in one process.\n */\n/**\n * Janela de obsolescência **entre máquinas** — e só entre elas.\n *\n * 30 s a partir da AQUISIÇÃO. O nome \"heartbeat\" seria mentira: o registro é gravado uma vez, na\n * tomada do lease, e **não** é renovado a cada escrita. A versão anterior deste comentário dizia\n * \"o dono toca o arquivo a cada aquisição, então um processo ativo nunca cruza a janela\" — falso\n * duas vezes, e a revisão adversarial mediu as duas.\n *\n * No **mesmo host** isso não importa: `reclamavel` decide pelo `pid`, que é exato, e a idade não\n * entra na conta. Entre hosts, importa e é um limite real: um dono remoto **vivo** perde o lease\n * depois de 30 s, porque não há como perguntar a outra máquina se o processo dela existe.\n *\n * **Resíduo declarado, não mecanizado** (a disciplina de `error-handling.md § 4`): renovar o\n * registro a cada append fecharia essa janela, ao custo de um `write` por turno num arquivo que\n * hoje é escrito uma vez por sessão. Não foi feito, e o caso multi-host não é o que motiva este\n * milestone — o enunciado é `exec` e TUI na mesma máquina.\n */\nexport const JANELA_DE_HEARTBEAT_MS = 30_000;\n\n/** Quem detém o lock. Gravado como JSON no `.writer.lock`. */\ninterface DonoDoLock {\n  pid: number;\n  hostname: string;\n  mtime: number;\n}\n\n/**\n * Grava o dono com permissão restrita ao usuário.\n *\n * `0600` porque o lock é uma afirmação de POSSE: com o `0664` que o umask usual produz, outro\n * usuário do mesmo grupo pode sobrescrever o arquivo e forjar a posse da sessão — e a partir daí o\n * dono legítimo é quem passa a receber `SessionBusyError`. O conteúdo (`pid`, `hostname`) é de\n * baixa sensibilidade; o que a permissão protege é a **integridade** do sinal, não o sigilo dele.\n */\nfunction gravarDono(lockPath: string, dono: DonoDoLock): void {\n  const fd = openSync(lockPath, \"w\", 0o600);\n  try {\n    writeSync(fd, JSON.stringify(dono));\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/** Lê o dono do lock. `undefined` quando o arquivo sumiu ou o conteúdo é ilegível. */\nfunction lerDono(lockPath: string): DonoDoLock | undefined {\n  let bruto: string;\n  try {\n    bruto = readFileSync(lockPath, \"utf8\");\n  } catch {\n    return undefined; // sumiu entre o EEXIST e a leitura — corrida benigna, trate como livre\n  }\n  try {\n    const d = JSON.parse(bruto) as Partial<DonoDoLock>;\n    if (\n      typeof d.pid !== \"number\" ||\n      typeof d.hostname !== \"string\" ||\n      typeof d.mtime !== \"number\"\n    ) {\n      return undefined;\n    }\n    return { pid: d.pid, hostname: d.hostname, mtime: d.mtime };\n  } catch {\n    // JSON ilegível: um lock que ninguém consegue interpretar não pode trancar a sessão para\n    // sempre. Tratar como obsoleto é a escolha recuperável; o custo é o mesmo de um lock velho.\n    return undefined;\n  }\n}\n\n/** O processo existe? `signal 0` não envia nada — só consulta permissão/existência. */\nfunction processoVivo(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (err) {\n    // EPERM significa que ele EXISTE e é de outro usuário.\n    return (err as NodeJS.ErrnoException).code === \"EPERM\";\n  }\n}\n\n/**\n * O lock pode ser tomado de quem o detém?\n *\n * ADR-2 do plano: reclamar por `pid` sozinho tem falso positivo entre máquinas — o mesmo número\n * existe noutro host, apontando para um processo sem relação. Então:\n *\n * - **mesmo host:** o `pid` é autoritativo, e **só** ele. Processo morto ⇒ reclamável na hora;\n *   processo vivo ⇒ nunca, por mais velho que o lock esteja.\n * - **outro host:** o `pid` não diz nada aqui. Só a janela de heartbeat vale, porque é o único\n *   sinal que não mente entre máquinas.\n *\n * ## Por que a idade NÃO conta no mesmo host\n *\n * A primeira versão fazia `velho || !processoVivo(pid)`, e isso era um defeito grave: o `mtime` é\n * gravado na **aquisição** e não é tocado a cada append, então qualquer sessão que durasse mais que\n * a janela — isto é, **toda sessão real** — passava a ser roubável por outro processo. Dois\n * escritores no mesmo transcript é exatamente o que o lease existe para impedir.\n *\n * No mesmo host a pergunta \"o dono ainda existe?\" tem resposta exata, e a idade não acrescenta\n * informação nenhuma a ela — só um modo de errar. Manter a janela ali seria heurística por cima de\n * um fato.\n */\nfunction reclamavel(dono: DonoDoLock | undefined): boolean {\n  if (dono === undefined) return true; // ilegível ou sumido\n  if (dono.hostname !== hostname()) {\n    return Date.now() - dono.mtime > JANELA_DE_HEARTBEAT_MS;\n  }\n  return !processoVivo(dono.pid);\n}\n\nexport async function acquireSessionWriter(sessionPath: string): Promise<SessionWriterLease> {\n  // M95 — `.writer.lock`, NÃO `.lock`.\n  //\n  // `withFileLock(path, fn)` já usa `<path>.lock` como companheiro. Enquanto o lease não era\n  // chamado de lugar nenhum (o defeito que este milestone corrige) a colisão era teórica; ligá-lo\n  // ao mesmo arquivo faria o lease de vida longa bloquear toda seção crítica curta do mesmo path.\n  //\n  // Dois arquivos porque são duas coisas: `withFileLock` protege uma seção com início e fim; o\n  // lease é POSSE, mantida através de turnos, com `release()` explícito — a distinção que o\n  // docstring do M81 acima já explica.\n  const lockPath = `${sessionPath}.writer.lock`;\n  const meu: DonoDoLock = { pid: process.pid, hostname: hostname(), mtime: Date.now() };\n  let fd: number;\n  try {\n    // O modo vale na CRIAÇÃO — o `w` de `gravarDono` não altera arquivo existente.\n    fd = openSync(lockPath, \"wx\", 0o600);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"EEXIST\") throw err;\n    // M95 — o lock existe. Até aqui isso bastava para recusar, e era o defeito: uma TUI morta por\n    // SIGKILL trancava o usuário para fora da própria sessão PERMANENTEMENTE, sem caminho de\n    // recuperação documentado. Agora o lock diz quem é o dono, e um dono morto cede o lugar.\n    if (!reclamavel(lerDono(lockPath))) throw new SessionBusyError(sessionPath);\n    gravarDono(lockPath, meu);\n    return criarLease(sessionPath, lockPath);\n  }\n  closeSync(fd);\n  gravarDono(lockPath, meu);\n\n  return criarLease(sessionPath, lockPath);\n}\n\n/** O lease em si — `release()` idempotente. Extraído porque a aquisição tem dois caminhos de saída. */\nfunction criarLease(sessionPath: string, lockPath: string): SessionWriterLease {\n  let released = false;\n  return {\n    sessionPath,\n    release: async (): Promise<void> => {\n      if (released) return;\n      released = true;\n      rmSync(lockPath, { force: true });\n    },\n  };\n}\n"]}