@theokit/sdk 4.28.0 → 4.30.0

package/dist/internal/persistence/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkQUTUJ6P6_cjs = require('../../chunk-QUTUJ6P6.cjs');
+var chunkHK7ZHSAX_cjs = require('../../chunk-HK7ZHSAX.cjs');
 var chunkPNVDQL5Y_cjs = require('../../chunk-PNVDQL5Y.cjs');
 var chunkOIYQBUW4_cjs = require('../../chunk-OIYQBUW4.cjs');
-var chunkJD74LN7R_cjs = require('../../chunk-JD74LN7R.cjs');
 var chunkC7PICHRF_cjs = require('../../chunk-C7PICHRF.cjs');
+var chunkJD74LN7R_cjs = require('../../chunk-JD74LN7R.cjs');
 var chunkYLQQX5W2_cjs = require('../../chunk-YLQQX5W2.cjs');
 var chunkTIZ4TS5V_cjs = require('../../chunk-TIZ4TS5V.cjs');
 require('../../chunk-A44COQJJ.cjs');
@@ -38,19 +38,19 @@ function casUpdate(db, sql, params, expectedChanges = 1) {
 
 Object.defineProperty(exports, "JsonlParseError", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.JsonlParseError; }
+  get: function () { return chunkHK7ZHSAX_cjs.JsonlParseError; }
 });
 Object.defineProperty(exports, "appendJsonl", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.appendJsonl; }
+  get: function () { return chunkHK7ZHSAX_cjs.appendJsonl; }
 });
 Object.defineProperty(exports, "loadJsonl", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.loadJsonl; }
+  get: function () { return chunkHK7ZHSAX_cjs.loadJsonl; }
 });
 Object.defineProperty(exports, "readJsonlIds", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.readJsonlIds; }
+  get: function () { return chunkHK7ZHSAX_cjs.readJsonlIds; }
 });
 Object.defineProperty(exports, "PersistenceSchema", {
   enumerable: true,
@@ -80,6 +80,10 @@ Object.defineProperty(exports, "writeVersionedJson", {
   enumerable: true,
   get: function () { return chunkOIYQBUW4_cjs.writeVersionedJson; }
 });
+Object.defineProperty(exports, "withFileLock", {
+  enumerable: true,
+  get: function () { return chunkC7PICHRF_cjs.withFileLock; }
+});
 Object.defineProperty(exports, "applyWalWithFallback", {
   enumerable: true,
   get: function () { return chunkJD74LN7R_cjs.applyWalWithFallback; }
@@ -100,10 +104,6 @@ Object.defineProperty(exports, "sanitizeFts5Query", {
   enumerable: true,
   get: function () { return chunkJD74LN7R_cjs.sanitizeFts5Query; }
 });
-Object.defineProperty(exports, "withFileLock", {
-  enumerable: true,
-  get: function () { return chunkC7PICHRF_cjs.withFileLock; }
-});
 Object.defineProperty(exports, "withCwdMutex", {
   enumerable: true,
   get: function () { return chunkYLQQX5W2_cjs.withCwdMutex; }

package/dist/internal/persistence/index.js

@@ -1,8 +1,8 @@
-export { JsonlParseError, appendJsonl, loadJsonl, readJsonlIds } from '../../chunk-DUK5WMKJ.js';
+export { JsonlParseError, appendJsonl, loadJsonl, readJsonlIds } from '../../chunk-R6ZP6KNB.js';
 export { PersistenceSchema } from '../../chunk-CAH3G4IS.js';
 export { displayTheokitHome, getProfilesRoot, getTheokitHome, migrateSchema, readVersionedJson, writeVersionedJson } from '../../chunk-DGRZNMTU.js';
-export { applyWalWithFallback, containsCjk, isCorruptionError, openSqliteResilient, sanitizeFts5Query } from '../../chunk-77FOZCOT.js';
 export { withFileLock } from '../../chunk-HZQEDNF6.js';
+export { applyWalWithFallback, containsCjk, isCorruptionError, openSqliteResilient, sanitizeFts5Query } from '../../chunk-77FOZCOT.js';
 export { withCwdMutex } from '../../chunk-2XLKLVVR.js';
 export { atomicWriteJson, atomicWriteText, replaceFileAtomic } from '../../chunk-S2BBRVQX.js';
 import '../../chunk-WLKFWQSJ.js';

package/dist/internal/persistence/jsonl.d.cts

@@ -11,6 +11,13 @@ export declare class JsonlParseError extends Error {
  */
 export declare function loadJsonl<T = Record<string, unknown>>(path: string, opts?: {
     map?: (raw: Record<string, unknown>, lineNumber: number) => T;
+    /**
+     * M81 — tolerate a truncated LAST line (a crash artifact: the process died mid-write).
+     *
+     * Opt-in on purpose. As a default it would also swallow corruption in the MIDDLE of the file,
+     * turning loud data loss into silent data loss — the wrong trade for a session store.
+     */
+    tolerateTrailingPartialLine?: boolean;
 }): T[];
 /**
  * Append one record as a whole `\n`-terminated JSON line. Creates the parent dir

package/dist/internal/persistence/jsonl.d.ts

@@ -11,6 +11,13 @@ export declare class JsonlParseError extends Error {
  */
 export declare function loadJsonl<T = Record<string, unknown>>(path: string, opts?: {
     map?: (raw: Record<string, unknown>, lineNumber: number) => T;
+    /**
+     * M81 — tolerate a truncated LAST line (a crash artifact: the process died mid-write).
+     *
+     * Opt-in on purpose. As a default it would also swallow corruption in the MIDDLE of the file,
+     * turning loud data loss into silent data loss — the wrong trade for a session store.
+     */
+    tolerateTrailingPartialLine?: boolean;
 }): T[];
 /**
  * Append one record as a whole `\n`-terminated JSON line. Creates the parent dir

package/dist/internal/persistence/session-writer.d.cts

@@ -0,0 +1,56 @@
+/**
+ * M81 — single-writer lease for a session transcript.
+ *
+ * ## The problem
+ *
+ * Nothing stops two processes appending to the same JSONL transcript. The concrete case: `exec
+ * resume --last` can write into the TUI's live session. Two interleaved appends to an append-only
+ * file produce lines that are each individually valid and whose SEQUENCE is fiction — and nothing
+ * reports it, because every line parses.
+ *
+ * ## Why an exclusive lockfile rather than `withFileLock`
+ *
+ * The plan's ADR D2 said to compose `withFileLock`, and that was the right instinct — do not build a
+ * second lock mechanism. It turned out not to fit the SHAPE: `withFileLock(path, fn)` is
+ * scope-based — it holds the lock for the duration of a callback. A session lease is **held across
+ * turns**, for as long as the process owns the session, with an explicit `release()`. Wrapping the
+ * whole session lifetime in a callback would invert control of the entire agent loop.
+ *
+ * So this uses the same underlying primitive `withFileLock` uses (an exclusive-create lockfile,
+ * `wx`) with lease semantics on top. That keeps the mechanism single — the file-existence lock —
+ * while giving it the lifetime the caller needs. The deviation from D2 is recorded here because the
+ * plan's rationale (no second mechanism) still holds; only its shape assumption did not.
+ *
+ * ## Fail fast, never wait
+ *
+ * A second writer that WAITED would block `exec` behind a TUI session that can last hours. The typed
+ * error lets the caller choose: fork to a new id, or give up with a real diagnosis.
+ *
+ * @internal
+ */
+import { TheokitAgentError } from "../../errors.js";
+/**
+ * M81 — another process already holds the writer lease for this session.
+ *
+ * Carries `sessionPath` because knowing WHICH session is busy is what lets the caller decide between
+ * forking and waiting for the user to close the TUI (`rules/error-handling.md § 2` — context enough
+ * to act on).
+ */
+export declare class SessionBusyError extends TheokitAgentError {
+    readonly sessionPath: string;
+    readonly name = "SessionBusyError";
+    constructor(sessionPath: string);
+}
+/** A held writer lease. `release()` is idempotent. */
+export interface SessionWriterLease {
+    readonly sessionPath: string;
+    release(): Promise<void>;
+}
+/**
+ * Take the exclusive writer lease for `sessionPath`, or reject with {@link SessionBusyError}.
+ *
+ * The lock is a sibling `.lock` file created with `wx` — the same file-existence primitive the
+ * SDK's `withFileLock` builds on. Exclusivity comes from the filesystem, so it holds across
+ * processes, not just across async tasks in one process.
+ */
+export declare function acquireSessionWriter(sessionPath: string): Promise<SessionWriterLease>;

package/dist/internal/persistence/session-writer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * M81 — single-writer lease for a session transcript.
+ *
+ * ## The problem
+ *
+ * Nothing stops two processes appending to the same JSONL transcript. The concrete case: `exec
+ * resume --last` can write into the TUI's live session. Two interleaved appends to an append-only
+ * file produce lines that are each individually valid and whose SEQUENCE is fiction — and nothing
+ * reports it, because every line parses.
+ *
+ * ## Why an exclusive lockfile rather than `withFileLock`
+ *
+ * The plan's ADR D2 said to compose `withFileLock`, and that was the right instinct — do not build a
+ * second lock mechanism. It turned out not to fit the SHAPE: `withFileLock(path, fn)` is
+ * scope-based — it holds the lock for the duration of a callback. A session lease is **held across
+ * turns**, for as long as the process owns the session, with an explicit `release()`. Wrapping the
+ * whole session lifetime in a callback would invert control of the entire agent loop.
+ *
+ * So this uses the same underlying primitive `withFileLock` uses (an exclusive-create lockfile,
+ * `wx`) with lease semantics on top. That keeps the mechanism single — the file-existence lock —
+ * while giving it the lifetime the caller needs. The deviation from D2 is recorded here because the
+ * plan's rationale (no second mechanism) still holds; only its shape assumption did not.
+ *
+ * ## Fail fast, never wait
+ *
+ * A second writer that WAITED would block `exec` behind a TUI session that can last hours. The typed
+ * error lets the caller choose: fork to a new id, or give up with a real diagnosis.
+ *
+ * @internal
+ */
+import { TheokitAgentError } from "../../errors.js";
+/**
+ * M81 — another process already holds the writer lease for this session.
+ *
+ * Carries `sessionPath` because knowing WHICH session is busy is what lets the caller decide between
+ * forking and waiting for the user to close the TUI (`rules/error-handling.md § 2` — context enough
+ * to act on).
+ */
+export declare class SessionBusyError extends TheokitAgentError {
+    readonly sessionPath: string;
+    readonly name = "SessionBusyError";
+    constructor(sessionPath: string);
+}
+/** A held writer lease. `release()` is idempotent. */
+export interface SessionWriterLease {
+    readonly sessionPath: string;
+    release(): Promise<void>;
+}
+/**
+ * Take the exclusive writer lease for `sessionPath`, or reject with {@link SessionBusyError}.
+ *
+ * The lock is a sibling `.lock` file created with `wx` — the same file-existence primitive the
+ * SDK's `withFileLock` builds on. Exclusivity comes from the filesystem, so it holds across
+ * processes, not just across async tasks in one process.
+ */
+export declare function acquireSessionWriter(sessionPath: string): Promise<SessionWriterLease>;

package/dist/internal/persistence/transcript-ops.d.cts

@@ -0,0 +1,71 @@
+/**
+ * M81 — transcript operations the consumer was doing by hand INSIDE the framework's own store.
+ *
+ * ## What this replaces
+ *
+ * `agents/lib/session/backtrack.ts:188` (agent-builder) wrote straight into the session store with a
+ * bare `writeFileSync` — no atomicity, no lock, no API. 243 lines re-implementing parse, cut and
+ * write for a format the framework owns. The consumer is not at fault: nothing here was reachable.
+ *
+ * ## The rule that travels WITH the operation
+ *
+ * `rules/audit-trail-rotation.md § Session transcripts (M60)` defines a NEVER-delete list — the live
+ * pointer, the most recent transcript, and any active registry entry. That rule lived in the
+ * CONSUMER. Moving the operation here without moving the rule would ship an API able to destroy
+ * exactly what the rule protects — the same shape of defect as M80's `reconcileUpdateGoalStatus`:
+ * critical knowledge outside the module that needs it, applied by convention.
+ *
+ * So `forkTranscript` takes `liveSessionPaths` and refuses, with a TYPED error, to write over any of
+ * them. The caller supplies the list because only the caller knows which session is live; the
+ * enforcement lives here because that is where the write happens.
+ *
+ * @internal
+ */
+import { TheokitAgentError } from "../../errors.js";
+/**
+ * M81 — the target is a protected session (live pointer / most-recent transcript / active entry).
+ *
+ * Typed rather than a bare `Error` because the caller must distinguish "this session is protected"
+ * from "the disk is full": the first is a correct refusal, the second is an incident.
+ */
+export declare class LiveSessionError extends TheokitAgentError {
+    readonly path: string;
+    readonly name = "LiveSessionError";
+    constructor(path: string);
+}
+/** Options for {@link forkTranscript}. */
+export interface ForkTranscriptOptions {
+    /** Keep records `[0, beforeRecordIndex)`. Omit to copy the whole transcript. */
+    readonly beforeRecordIndex?: number;
+    /**
+     * Paths that must never be written over — the live pointer, the most recent transcript, any active
+     * registry entry. The caller supplies them because only the caller knows which session is live.
+     */
+    readonly liveSessionPaths?: readonly string[];
+}
+/**
+ * Copy `src` into `dst`, keeping the first `beforeRecordIndex` records. The SOURCE is never touched.
+ *
+ * Atomicity comes from `wx` (exclusive create): two concurrent forks to the same destination cannot
+ * both succeed — the loser gets `EEXIST` rather than writing over a half-written file. That is also
+ * why an existing destination is a refusal, not a silent overwrite: losing a transcript without an
+ * error is the worst failure mode for an operation that touches user sessions.
+ */
+export declare function forkTranscript(src: string, dst: string, options?: ForkTranscriptOptions): void;
+/** Options for {@link readJsonlTail}. */
+export interface ReadJsonlTailOptions {
+    /** Maximum records to return, counted from the END. */
+    readonly maxRecords?: number;
+    /** Stop once a line contains this marker (exclusive). */
+    readonly sinceMarker?: string;
+    /** Test-only: also report how many bytes were read, to prove the read is not whole-file. */
+    readonly _stats?: boolean;
+}
+/**
+ * Read the LAST records of a JSONL file without loading the whole thing.
+ *
+ * Reads fixed-size chunks backwards from EOF until enough newlines have been seen. A session
+ * transcript grows without bound; loading megabytes to show the last three turns is the cost this
+ * exists to avoid — and a `slice` over a full read would be that same cost with a better name.
+ */
+export declare function readJsonlTail<T = Record<string, unknown>>(path: string, options?: ReadJsonlTailOptions): T[];

package/dist/internal/persistence/transcript-ops.d.ts

@@ -0,0 +1,71 @@
+/**
+ * M81 — transcript operations the consumer was doing by hand INSIDE the framework's own store.
+ *
+ * ## What this replaces
+ *
+ * `agents/lib/session/backtrack.ts:188` (agent-builder) wrote straight into the session store with a
+ * bare `writeFileSync` — no atomicity, no lock, no API. 243 lines re-implementing parse, cut and
+ * write for a format the framework owns. The consumer is not at fault: nothing here was reachable.
+ *
+ * ## The rule that travels WITH the operation
+ *
+ * `rules/audit-trail-rotation.md § Session transcripts (M60)` defines a NEVER-delete list — the live
+ * pointer, the most recent transcript, and any active registry entry. That rule lived in the
+ * CONSUMER. Moving the operation here without moving the rule would ship an API able to destroy
+ * exactly what the rule protects — the same shape of defect as M80's `reconcileUpdateGoalStatus`:
+ * critical knowledge outside the module that needs it, applied by convention.
+ *
+ * So `forkTranscript` takes `liveSessionPaths` and refuses, with a TYPED error, to write over any of
+ * them. The caller supplies the list because only the caller knows which session is live; the
+ * enforcement lives here because that is where the write happens.
+ *
+ * @internal
+ */
+import { TheokitAgentError } from "../../errors.js";
+/**
+ * M81 — the target is a protected session (live pointer / most-recent transcript / active entry).
+ *
+ * Typed rather than a bare `Error` because the caller must distinguish "this session is protected"
+ * from "the disk is full": the first is a correct refusal, the second is an incident.
+ */
+export declare class LiveSessionError extends TheokitAgentError {
+    readonly path: string;
+    readonly name = "LiveSessionError";
+    constructor(path: string);
+}
+/** Options for {@link forkTranscript}. */
+export interface ForkTranscriptOptions {
+    /** Keep records `[0, beforeRecordIndex)`. Omit to copy the whole transcript. */
+    readonly beforeRecordIndex?: number;
+    /**
+     * Paths that must never be written over — the live pointer, the most recent transcript, any active
+     * registry entry. The caller supplies them because only the caller knows which session is live.
+     */
+    readonly liveSessionPaths?: readonly string[];
+}
+/**
+ * Copy `src` into `dst`, keeping the first `beforeRecordIndex` records. The SOURCE is never touched.
+ *
+ * Atomicity comes from `wx` (exclusive create): two concurrent forks to the same destination cannot
+ * both succeed — the loser gets `EEXIST` rather than writing over a half-written file. That is also
+ * why an existing destination is a refusal, not a silent overwrite: losing a transcript without an
+ * error is the worst failure mode for an operation that touches user sessions.
+ */
+export declare function forkTranscript(src: string, dst: string, options?: ForkTranscriptOptions): void;
+/** Options for {@link readJsonlTail}. */
+export interface ReadJsonlTailOptions {
+    /** Maximum records to return, counted from the END. */
+    readonly maxRecords?: number;
+    /** Stop once a line contains this marker (exclusive). */
+    readonly sinceMarker?: string;
+    /** Test-only: also report how many bytes were read, to prove the read is not whole-file. */
+    readonly _stats?: boolean;
+}
+/**
+ * Read the LAST records of a JSONL file without loading the whole thing.
+ *
+ * Reads fixed-size chunks backwards from EOF until enough newlines have been seen. A session
+ * transcript grows without bound; loading megabytes to show the last three turns is the cost this
+ * exists to avoid — and a `slice` over a full read would be that same cost with a better name.
+ */
+export declare function readJsonlTail<T = Record<string, unknown>>(path: string, options?: ReadJsonlTailOptions): T[];

package/dist/internal/plugins/types.d.cts

@@ -11,7 +11,7 @@
  * @public
  */
 import type { Plugin as PluginType } from "../../types/plugin.js";
-export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolContext, TransformContext, } from "../../types/plugin.js";
+export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolCallSummary, ToolContext, ToolResultTransformContext, TransformContext, } from "../../types/plugin.js";
 export type Plugin = PluginType;
 /**
  * Identity helper for plugin authors. TS-only convenience — preserves

package/dist/internal/plugins/types.d.ts

@@ -11,7 +11,7 @@
  * @public
  */
 import type { Plugin as PluginType } from "../../types/plugin.js";
-export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolContext, TransformContext, } from "../../types/plugin.js";
+export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolCallSummary, ToolContext, ToolResultTransformContext, TransformContext, } from "../../types/plugin.js";
 export type Plugin = PluginType;
 /**
  * Identity helper for plugin authors. TS-only convenience — preserves

package/dist/persistence.cjs

@@ -1,37 +1,139 @@
 'use strict';
 
-var chunkQUTUJ6P6_cjs = require('./chunk-QUTUJ6P6.cjs');
+var chunkHK7ZHSAX_cjs = require('./chunk-HK7ZHSAX.cjs');
 var chunkPNVDQL5Y_cjs = require('./chunk-PNVDQL5Y.cjs');
-var chunkJD74LN7R_cjs = require('./chunk-JD74LN7R.cjs');
 var chunkC7PICHRF_cjs = require('./chunk-C7PICHRF.cjs');
+var chunkJD74LN7R_cjs = require('./chunk-JD74LN7R.cjs');
 var chunkYLQQX5W2_cjs = require('./chunk-YLQQX5W2.cjs');
 var chunk4SXHEZIV_cjs = require('./chunk-4SXHEZIV.cjs');
 var chunkTIZ4TS5V_cjs = require('./chunk-TIZ4TS5V.cjs');
-require('./chunk-A44COQJJ.cjs');
+var chunkA44COQJJ_cjs = require('./chunk-A44COQJJ.cjs');
 require('./chunk-BEURCLDV.cjs');
+var fs = require('fs');
 
-
+var SessionBusyError = class extends chunkA44COQJJ_cjs.TheokitAgentError {
+  constructor(sessionPath) {
+    super(
+      `another process is already writing this session: ${sessionPath}. Fork it to a new id instead of appending \u2014 two writers interleave lines into a sequence that parses but is not what either process wrote.`,
+      { code: "session_busy", isRetryable: false }
+    );
+    this.sessionPath = sessionPath;
+  }
+  sessionPath;
+  name = "SessionBusyError";
+};
+async function acquireSessionWriter(sessionPath) {
+  const lockPath = `${sessionPath}.lock`;
+  let fd;
+  try {
+    fd = fs.openSync(lockPath, "wx");
+  } catch (err) {
+    if (err.code === "EEXIST") {
+      throw new SessionBusyError(sessionPath);
+    }
+    throw err;
+  }
+  fs.closeSync(fd);
+  let released = false;
+  return {
+    sessionPath,
+    release: async () => {
+      if (released) return;
+      released = true;
+      fs.rmSync(lockPath, { force: true });
+    }
+  };
+}
+var LiveSessionError = class extends chunkA44COQJJ_cjs.TheokitAgentError {
+  constructor(path) {
+    super(
+      `refusing to write over a live session transcript: ${path}. Fork to a new id instead \u2014 the live pointer, the most recent transcript and any active registry entry are never overwritten (audit-trail rotation, M60).`,
+      { code: "live_session_protected", isRetryable: false }
+    );
+    this.path = path;
+  }
+  path;
+  name = "LiveSessionError";
+};
+function forkTranscript(src, dst, options = {}) {
+  for (const live of options.liveSessionPaths ?? []) {
+    if (live === dst) throw new LiveSessionError(dst);
+  }
+  const lines = fs.readFileSync(src, "utf8").split("\n").filter((l) => l.trim().length > 0);
+  const kept = options.beforeRecordIndex === void 0 ? lines : lines.slice(0, options.beforeRecordIndex);
+  const body = kept.length > 0 ? `${kept.join("\n")}
+` : "";
+  const fd = fs.openSync(dst, "wx");
+  try {
+    fs.writeSync(fd, body);
+  } finally {
+    fs.closeSync(fd);
+  }
+}
+var TAIL_CHUNK = 64 * 1024;
+function lerCaudaBruta(path, want) {
+  const size = fs.statSync(path).size;
+  const fd = fs.openSync(path, "r");
+  let bytesRead = 0;
+  let tail = "";
+  let pos = size;
+  try {
+    while (pos > 0) {
+      const len = Math.min(TAIL_CHUNK, pos);
+      pos -= len;
+      const buf = Buffer.alloc(len);
+      fs.readSync(fd, buf, 0, len, pos);
+      bytesRead += len;
+      tail = buf.toString("utf8") + tail;
+      if (naoVazias(tail).length > want) break;
+    }
+  } finally {
+    fs.closeSync(fd);
+  }
+  const linhas = naoVazias(tail);
+  return { linhas: pos > 0 ? linhas.slice(1) : linhas, bytesRead };
+}
+function naoVazias(texto) {
+  return texto.split("\n").filter((l) => l.trim().length > 0);
+}
+function readJsonlTail(path, options = {}) {
+  const want = options.maxRecords ?? Number.POSITIVE_INFINITY;
+  const { linhas, bytesRead } = lerCaudaBruta(path, want);
+  let sel = linhas;
+  if (options.sinceMarker !== void 0) {
+    const marcador = options.sinceMarker;
+    const idx = sel.findLastIndex((l) => l.includes(marcador));
+    if (idx >= 0) sel = sel.slice(idx + 1);
+  }
+  if (Number.isFinite(want)) sel = sel.slice(-want);
+  const out = sel.map((l) => JSON.parse(l));
+  return options._stats === true ? Object.assign(out, { bytesRead }) : out;
+}
 
 Object.defineProperty(exports, "JsonlParseError", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.JsonlParseError; }
+  get: function () { return chunkHK7ZHSAX_cjs.JsonlParseError; }
 });
 Object.defineProperty(exports, "appendJsonl", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.appendJsonl; }
+  get: function () { return chunkHK7ZHSAX_cjs.appendJsonl; }
 });
 Object.defineProperty(exports, "loadJsonl", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.loadJsonl; }
+  get: function () { return chunkHK7ZHSAX_cjs.loadJsonl; }
 });
 Object.defineProperty(exports, "readJsonlIds", {
   enumerable: true,
-  get: function () { return chunkQUTUJ6P6_cjs.readJsonlIds; }
+  get: function () { return chunkHK7ZHSAX_cjs.readJsonlIds; }
 });
 Object.defineProperty(exports, "PersistenceSchema", {
   enumerable: true,
   get: function () { return chunkPNVDQL5Y_cjs.PersistenceSchema; }
 });
+Object.defineProperty(exports, "withFileLock", {
+  enumerable: true,
+  get: function () { return chunkC7PICHRF_cjs.withFileLock; }
+});
 Object.defineProperty(exports, "applyWalWithFallback", {
   enumerable: true,
   get: function () { return chunkJD74LN7R_cjs.applyWalWithFallback; }
@@ -48,10 +150,6 @@ Object.defineProperty(exports, "sanitizeFts5Query", {
   enumerable: true,
   get: function () { return chunkJD74LN7R_cjs.sanitizeFts5Query; }
 });
-Object.defineProperty(exports, "withFileLock", {
-  enumerable: true,
-  get: function () { return chunkC7PICHRF_cjs.withFileLock; }
-});
 Object.defineProperty(exports, "withCwdMutex", {
   enumerable: true,
   get: function () { return chunkYLQQX5W2_cjs.withCwdMutex; }
@@ -76,5 +174,10 @@ Object.defineProperty(exports, "replaceFileAtomic", {
   enumerable: true,
   get: function () { return chunkTIZ4TS5V_cjs.replaceFileAtomic; }
 });
+exports.LiveSessionError = LiveSessionError;
+exports.SessionBusyError = SessionBusyError;
+exports.acquireSessionWriter = acquireSessionWriter;
+exports.forkTranscript = forkTranscript;
+exports.readJsonlTail = readJsonlTail;
 //# sourceMappingURL=persistence.cjs.map
 //# sourceMappingURL=persistence.cjs.map

package/dist/persistence.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"persistence.cjs"}
+{"version":3,"sources":["../src/internal/persistence/session-writer.ts","../src/internal/persistence/transcript-ops.ts"],"names":["TheokitAgentError","openSync","closeSync","rmSync","readFileSync","writeSync","statSync","readSync"],"mappings":"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","file":"persistence.cjs","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, rmSync } from \"node:fs\";\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 */\nexport async function acquireSessionWriter(sessionPath: string): Promise<SessionWriterLease> {\n  const lockPath = `${sessionPath}.lock`;\n  let fd: number;\n  try {\n    fd = openSync(lockPath, \"wx\");\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === \"EEXIST\") {\n      throw new SessionBusyError(sessionPath);\n    }\n    throw err;\n  }\n  closeSync(fd);\n\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","/**\n * M81 — transcript operations the consumer was doing by hand INSIDE the framework's own store.\n *\n * ## What this replaces\n *\n * `agents/lib/session/backtrack.ts:188` (agent-builder) wrote straight into the session store with a\n * bare `writeFileSync` — no atomicity, no lock, no API. 243 lines re-implementing parse, cut and\n * write for a format the framework owns. The consumer is not at fault: nothing here was reachable.\n *\n * ## The rule that travels WITH the operation\n *\n * `rules/audit-trail-rotation.md § Session transcripts (M60)` defines a NEVER-delete list — the live\n * pointer, the most recent transcript, and any active registry entry. That rule lived in the\n * CONSUMER. Moving the operation here without moving the rule would ship an API able to destroy\n * exactly what the rule protects — the same shape of defect as M80's `reconcileUpdateGoalStatus`:\n * critical knowledge outside the module that needs it, applied by convention.\n *\n * So `forkTranscript` takes `liveSessionPaths` and refuses, with a TYPED error, to write over any of\n * them. The caller supplies the list because only the caller knows which session is live; the\n * enforcement lives here because that is where the write happens.\n *\n * @internal\n */\n\nimport { closeSync, openSync, readFileSync, readSync, statSync, writeSync } from \"node:fs\";\n\nimport { TheokitAgentError } from \"../../errors.js\";\n\n/**\n * M81 — the target is a protected session (live pointer / most-recent transcript / active entry).\n *\n * Typed rather than a bare `Error` because the caller must distinguish \"this session is protected\"\n * from \"the disk is full\": the first is a correct refusal, the second is an incident.\n */\nexport class LiveSessionError extends TheokitAgentError {\n  override readonly name = \"LiveSessionError\";\n\n  constructor(readonly path: string) {\n    super(\n      `refusing to write over a live session transcript: ${path}. ` +\n        \"Fork to a new id instead — the live pointer, the most recent transcript and any active \" +\n        \"registry entry are never overwritten (audit-trail rotation, M60).\",\n      { code: \"live_session_protected\", isRetryable: false },\n    );\n  }\n}\n\n/** Options for {@link forkTranscript}. */\nexport interface ForkTranscriptOptions {\n  /** Keep records `[0, beforeRecordIndex)`. Omit to copy the whole transcript. */\n  readonly beforeRecordIndex?: number;\n  /**\n   * Paths that must never be written over — the live pointer, the most recent transcript, any active\n   * registry entry. The caller supplies them because only the caller knows which session is live.\n   */\n  readonly liveSessionPaths?: readonly string[];\n}\n\n/**\n * Copy `src` into `dst`, keeping the first `beforeRecordIndex` records. The SOURCE is never touched.\n *\n * Atomicity comes from `wx` (exclusive create): two concurrent forks to the same destination cannot\n * both succeed — the loser gets `EEXIST` rather than writing over a half-written file. That is also\n * why an existing destination is a refusal, not a silent overwrite: losing a transcript without an\n * error is the worst failure mode for an operation that touches user sessions.\n */\nexport function forkTranscript(\n  src: string,\n  dst: string,\n  options: ForkTranscriptOptions = {},\n): void {\n  for (const live of options.liveSessionPaths ?? []) {\n    if (live === dst) throw new LiveSessionError(dst);\n  }\n\n  const lines = readFileSync(src, \"utf8\")\n    .split(\"\\n\")\n    .filter((l) => l.trim().length > 0);\n  const kept =\n    options.beforeRecordIndex === undefined ? lines : lines.slice(0, options.beforeRecordIndex);\n  const body = kept.length > 0 ? `${kept.join(\"\\n\")}\\n` : \"\";\n\n  // `wx` — fails with EEXIST instead of truncating. The exclusivity IS the concurrency guarantee.\n  const fd = openSync(dst, \"wx\");\n  try {\n    writeSync(fd, body);\n  } finally {\n    closeSync(fd);\n  }\n}\n\n/** Options for {@link readJsonlTail}. */\nexport interface ReadJsonlTailOptions {\n  /** Maximum records to return, counted from the END. */\n  readonly maxRecords?: number;\n  /** Stop once a line contains this marker (exclusive). */\n  readonly sinceMarker?: string;\n  /** Test-only: also report how many bytes were read, to prove the read is not whole-file. */\n  readonly _stats?: boolean;\n}\n\nconst TAIL_CHUNK = 64 * 1024;\n\n/**\n * Lê chunks de trás para frente até acumular linhas completas suficientes.\n *\n * Extraído de `readJsonlTail` porque o laço de leitura e a seleção de registros são duas\n * responsabilidades — e juntas passavam do teto de complexidade. A primeira linha do buffer pode\n * estar cortada ao meio quando a leitura parou antes do início do arquivo; por isso ela é descartada.\n */\nfunction lerCaudaBruta(path: string, want: number): { linhas: string[]; bytesRead: number } {\n  const size = statSync(path).size;\n  const fd = openSync(path, \"r\");\n  let bytesRead = 0;\n  let tail = \"\";\n  let pos = size;\n  try {\n    while (pos > 0) {\n      const len = Math.min(TAIL_CHUNK, pos);\n      pos -= len;\n      const buf = Buffer.alloc(len);\n      readSync(fd, buf, 0, len, pos);\n      bytesRead += len;\n      tail = buf.toString(\"utf8\") + tail;\n      if (naoVazias(tail).length > want) break;\n    }\n  } finally {\n    closeSync(fd);\n  }\n  const linhas = naoVazias(tail);\n  return { linhas: pos > 0 ? linhas.slice(1) : linhas, bytesRead };\n}\n\n/** Linhas com conteúdo, na ordem do arquivo. */\nfunction naoVazias(texto: string): string[] {\n  return texto.split(\"\\n\").filter((l) => l.trim().length > 0);\n}\n\n/**\n * Read the LAST records of a JSONL file without loading the whole thing.\n *\n * Reads fixed-size chunks backwards from EOF until enough newlines have been seen. A session\n * transcript grows without bound; loading megabytes to show the last three turns is the cost this\n * exists to avoid — and a `slice` over a full read would be that same cost with a better name.\n */\nexport function readJsonlTail<T = Record<string, unknown>>(\n  path: string,\n  options: ReadJsonlTailOptions = {},\n): T[] {\n  const want = options.maxRecords ?? Number.POSITIVE_INFINITY;\n  const { linhas, bytesRead } = lerCaudaBruta(path, want);\n\n  let sel = linhas;\n  if (options.sinceMarker !== undefined) {\n    const marcador = options.sinceMarker;\n    const idx = sel.findLastIndex((l) => l.includes(marcador));\n    if (idx >= 0) sel = sel.slice(idx + 1);\n  }\n  if (Number.isFinite(want)) sel = sel.slice(-want);\n\n  const out = sel.map((l) => JSON.parse(l) as T);\n  return options._stats === true ? (Object.assign(out, { bytesRead }) as T[]) : out;\n}\n"]}

package/dist/persistence.d.cts

@@ -22,7 +22,9 @@ export { sanitizeFts5Query } from "./internal/persistence/fts5-sanitize.js";
 export { appendJsonl, JsonlParseError, loadJsonl, readJsonlIds, } from "./internal/persistence/jsonl.js";
 export { PersistenceSchema } from "./internal/persistence/persistence-schema.js";
 export { encodeProjectDir, transcriptPath, } from "./internal/persistence/session-transcript.js";
+export { acquireSessionWriter, SessionBusyError, type SessionWriterLease, } from "./internal/persistence/session-writer.js";
 export type { OpenSqliteResilientOptions, ResilientSqliteDb, } from "./internal/persistence/sqlite-open.js";
 export { isCorruptionError, openSqliteResilient } from "./internal/persistence/sqlite-open.js";
 export type { WalApplyResult } from "./internal/persistence/sqlite-wal.js";
 export { applyWalWithFallback } from "./internal/persistence/sqlite-wal.js";
+export { type ForkTranscriptOptions, forkTranscript, LiveSessionError, type ReadJsonlTailOptions, readJsonlTail, } from "./internal/persistence/transcript-ops.js";

package/dist/persistence.d.ts

@@ -22,7 +22,9 @@ export { sanitizeFts5Query } from "./internal/persistence/fts5-sanitize.js";
 export { appendJsonl, JsonlParseError, loadJsonl, readJsonlIds, } from "./internal/persistence/jsonl.js";
 export { PersistenceSchema } from "./internal/persistence/persistence-schema.js";
 export { encodeProjectDir, transcriptPath, } from "./internal/persistence/session-transcript.js";
+export { acquireSessionWriter, SessionBusyError, type SessionWriterLease, } from "./internal/persistence/session-writer.js";
 export type { OpenSqliteResilientOptions, ResilientSqliteDb, } from "./internal/persistence/sqlite-open.js";
 export { isCorruptionError, openSqliteResilient } from "./internal/persistence/sqlite-open.js";
 export type { WalApplyResult } from "./internal/persistence/sqlite-wal.js";
 export { applyWalWithFallback } from "./internal/persistence/sqlite-wal.js";
+export { type ForkTranscriptOptions, forkTranscript, LiveSessionError, type ReadJsonlTailOptions, readJsonlTail, } from "./internal/persistence/transcript-ops.js";