@pasko70/pibo 1.7.2 → 1.7.4

package/README.md

@@ -0,0 +1,183 @@
+# pibo
+
+Pibo is a thin product boundary around Pi Coding Agent. Pi remains the inner engine for model turns, tools, streaming, sessions, and compaction. Pibo adds profiles, plugins, channels, local gateways, web auth, and operator tooling.
+
+The default posture is intentionally powerful: Pibo is built for agentic coding and server operation, not for a restrictive sandbox. Install and run it as the Linux user that should own its state and credentials.
+
+## Supported platforms
+
+Pibo is Linux-first. The supported hosts are:
+
+- **Linux** (any modern distribution) — primary target
+- **macOS** — supported, same code path as Linux
+- **Windows via WSL2** — fully supported; see [docs/guides/pibo-on-windows-via-wsl.md](./docs/guides/pibo-on-windows-via-wsl.md)
+- **Native Windows** — not supported; `pibo setup doctor` and `pibo setup user-host` will print a clear error pointing to the WSL guide
+
+## Install
+
+Pibo is distributed as an npm package:
+
+```bash
+npm install -g @pasko70/pibo
+pibo --help
+```
+
+The current package declares Node.js 24+. Some Linux distributions still ship Node 22 through `apt`, so install a recent Node release first when needed. A user-local Node/npm setup through `nvm`, `fnm`, or a user-writable npm prefix works well.
+
+For a user-local global npm prefix:
+
+```bash
+mkdir -p ~/.local
+npm config set prefix ~/.local
+export PATH="$HOME/.local/bin:$PATH"
+npm install -g @pasko70/pibo
+```
+
+## State and user paths
+
+Pibo stores product-wide state under:
+
+```text
+${PIBO_HOME:-~/.pibo}
+```
+
+That means the executing Linux user owns the installation state:
+
+```text
+alice -> /home/alice/.pibo
+pibo  -> /home/pibo/.pibo
+root  -> /root/.pibo
+```
+
+There is no requirement to run as `root`. If you SSH as root and run Pibo, state naturally lands in `/root/.pibo`. If you create or use a dedicated user, state lands in that user's home. This is the preferred way to keep SSH keys, config, logs, and sessions separated.
+
+Workspace-scoped files are separate and live under the active workspace:
+
+```text
+<workspace>/.pibo
+```
+
+Examples include custom prompts and Pi package registrations.
+
+## Server notes
+
+A fresh server install usually needs only three decisions:
+
+1. Choose the Linux user that should own Pibo.
+2. Install Node.js 24+ for that user or system-wide.
+3. Install Pibo through npm.
+
+Use the setup planner to keep the first run simple:
+
+```bash
+pibo setup doctor --domain pibo.example.com --expected-ip <server-ip>
+pibo setup user-host --domain pibo.example.com --print-files
+pibo setup user-host --domain pibo.example.com --write-to /tmp/pibo-setup
+```
+
+This is the normal user path: one gateway, one `PIBO_HOME`, no required Docker, no dev gateway, and no GitHub App setup. After reviewing staged files, use `--apply --yes` to write the generated systemd/Caddy files.
+
+Developer hosts are opt-in and add production/dev separation plus Docker compute workers:
+
+```bash
+pibo setup developer-host \
+  --origin git@github.com:<your-fork>/pibo.git \
+  --prod-domain pibo.example.com \
+  --dev-domain dev.pibo.example.com \
+  --print-files
+
+pibo setup developer-host \
+  --origin git@github.com:<your-fork>/pibo.git \
+  --prod-domain pibo.example.com \
+  --dev-domain dev.pibo.example.com \
+  --write-to /tmp/pibo-setup
+```
+
+See `docs/ops/install-user-host.md`, `docs/ops/install-developer-host.md`, and `docs/ops/upgrade-user-to-developer-host.md`. Developer-host services are source-pinned so production and dev do not fight over one global `pibo` symlink. Docker and swap are developer-host prerequisites only; verify them with `pibo setup doctor --require-docker --min-swap-gb 8`.
+
+If the agent should be able to perform server administration, give that Linux user the required sudo or Docker permissions explicitly. Pibo does not need a special onboarding user to work correctly; normal Unix ownership is enough.
+
+## Docker notes
+
+Docker is optional. If you run Pibo in a container, avoid hard-coding `/root` unless the container is intentionally root-owned. Prefer mapping the host user's state into the container user's home:
+
+```text
+$HOME/.pibo -> /home/pibo/.pibo
+$HOME/code  -> /workspace/code
+```
+
+Set `HOME` and `PIBO_HOME` consistently inside the container so the same path rule applies:
+
+```text
+HOME=/home/pibo
+PIBO_HOME=/home/pibo/.pibo
+```
+
+## Web gateway auth
+
+`pibo gateway:web` starts the authenticated web runtime. It requires Better Auth configuration before production use. This step is intentionally not automated because you must create/select the Google OAuth client and allowed user list:
+
+```bash
+pibo config set auth.baseURL https://your-host.example
+pibo config set auth.secret <at-least-32-characters>
+pibo config set auth.googleClientId <google-client-id>
+pibo config set auth.googleClientSecret <google-client-secret>
+pibo config set auth.allowedEmails you@example.com
+```
+
+For local loopback testing, `auth.baseURL` can be `http://localhost:4788`.
+
+## Development from source
+
+Use source installs for development, not normal usage:
+
+```bash
+git clone git@github.com:Pascapone-server/pibo.git
+cd pibo
+npm install
+npm run build
+npm run start -- --help
+```
+
+Useful scripts:
+
+```bash
+npm run dev -- --help
+npm run profile -- codex
+npm run tui:routed -- codex
+npm run gateway
+npm run gateway:web
+npm test
+npm run typecheck
+```
+
+## Main CLI areas
+
+```bash
+pibo config       # local config under ${PIBO_HOME:-~/.pibo}/config.json
+pibo mcp          # discover and call configured MCP servers
+pibo tools        # install and inspect curated external CLI tools
+pibo pi-packages  # register Pi Coding Agent packages
+pibo debug        # inspect local Pibo data stores
+pibo setup        # plan user-host installs and developer-host upgrades
+pibo profile      # inspect runtime profiles
+pibo tui          # start the direct Pi TUI
+pibo tui:routed   # start the routed Pibo TUI
+pibo gateway      # local gateway runtime
+pibo gateway:web  # authenticated web gateway runtime
+```
+
+## Further docs
+
+- `docs/architecture.md` describes runtime architecture and boundaries.
+- `docs/mcp.md` documents MCP configuration and commands.
+- `docs/tools.md` documents curated external CLI tools.
+- `docs/pi-packages.md` documents Pi package registration.
+- `docs/chat-rooms-event-log.md` documents Chat Web rooms and durable event storage.
+- `docs/progress.md` is the short implementation status snapshot.
+
+## Philosophy
+
+Keep Pibo thin. Pi Coding Agent should remain the inner engine; Pibo owns only the product boundary: profiles, plugins, channels, routing, auth, policy, and operator tooling.
+
+Optional integrations should stay outside the core package until installed. MCP servers, Python virtual environments, external CLIs, and user skills are configured on demand rather than bundled into every runtime.

package/dist/apps/chat/chat-trace-helpers.js

@@ -75,10 +75,12 @@ export function annotateTracePage(trace, events, input) {
         eventLimit: input.pageSize,
         pageSize: input.pageSize,
         beforeSequence: input.beforeSequence,
+        beforeCursor: input.beforeCursor,
         firstEventSequence,
         lastEventSequence,
         nextBeforeSequence: firstEventSequence,
-        hasOlderEvents: firstEventSequence !== undefined ? firstEventSequence > 1 : false,
+        nextBeforeCursor: input.nextBeforeCursor ?? (firstEventSequence !== undefined ? String(firstEventSequence) : undefined),
+        hasOlderEvents: input.hasOlderEvents ?? (firstEventSequence !== undefined ? firstEventSequence > 1 : false),
     };
 }
 export function setTraceCache(cache, key, trace, maxEntries, maxBytes = TRACE_CACHE_MAX_BYTES) {

package/dist/apps/chat/data/session-query-service.js

@@ -1,5 +1,6 @@
 import { chatRoomIdFromMetadata } from "../types/rooms.js";
 import { sessionFromRow, statusFromOutputEvent } from "./chat-data-mappers.js";
+import { rootSessionId } from "../../../data/session-store.js";
 export class ChatSessionQueryService {
     store;
     constructor(store) {
@@ -11,9 +12,17 @@ export class ChatSessionQueryService {
         this.upsertNavigation(session, roomId, status, session.updatedAt);
     }
     upsertSessionsIfChanged(sessions) {
-        for (const session of sessions)
+        let written = 0;
+        let skipped = 0;
+        for (const session of sessions) {
+            if (this.sessionIndexMatches(session)) {
+                skipped++;
+                continue;
+            }
             this.upsertSession(session);
-        return { checked: sessions.length, written: sessions.length, skipped: 0 };
+            written++;
+        }
+        return { checked: sessions.length, written, skipped };
     }
     recordEvent(event, session) {
         if (session)
@@ -44,11 +53,65 @@ export class ChatSessionQueryService {
         return Number(result.changes ?? 0);
     }
     close() { }
+    sessionIndexMatches(session, status = "idle") {
+        const roomId = chatRoomIdFromMetadata(session.metadata) ?? "room_default";
+        const title = session.title || "Untitled Session";
+        const metadataJson = JSON.stringify(session.metadata ?? {});
+        const activeModelJson = session.activeModel ? JSON.stringify(session.activeModel) : null;
+        const row = this.store.db.prepare(`
+			SELECT
+				s.pi_session_id,
+				s.room_id,
+				s.root_session_id,
+				s.parent_id,
+				s.origin_id,
+				s.channel,
+				s.kind,
+				s.profile,
+				s.active_model_json,
+				s.workspace,
+				s.title,
+				s.status,
+				s.metadata_json,
+				s.created_at,
+				s.updated_at,
+				s.last_activity_at,
+				n.status AS navigation_status,
+				n.title AS navigation_title,
+				n.sort_key AS navigation_sort_key,
+				n.updated_at AS navigation_updated_at
+			FROM sessions s
+			LEFT JOIN session_navigation n ON n.session_id = s.id
+			WHERE s.id = ? AND s.deleted_at IS NULL
+		`).get(session.id);
+        if (!row)
+            return false;
+        return row.pi_session_id === session.piSessionId
+            && row.room_id === roomId
+            && row.root_session_id === rootSessionId(session)
+            && row.parent_id === (session.parentId ?? null)
+            && row.origin_id === (session.originId ?? null)
+            && row.channel === session.channel
+            && row.kind === session.kind
+            && row.profile === session.profile
+            && row.active_model_json === activeModelJson
+            && row.workspace === (session.workspace ?? null)
+            && row.title === title
+            && row.status === status
+            && row.metadata_json === metadataJson
+            && row.created_at === session.createdAt
+            && row.updated_at === session.updatedAt
+            && row.last_activity_at === session.updatedAt
+            && row.navigation_status === status
+            && row.navigation_title === title
+            && row.navigation_sort_key === session.updatedAt
+            && row.navigation_updated_at === session.updatedAt;
+    }
     upsertNavigation(session, roomId, status, now) {
         this.store.navigation.upsertSession({
             roomId,
             sessionId: session.id,
-            rootSessionId: session.parentId ? (typeof session.metadata?.rootSessionId === "string" ? session.metadata.rootSessionId : session.parentId) : session.id,
+            rootSessionId: rootSessionId(session),
             parentId: session.parentId,
             originId: session.originId,
             title: session.title || "Untitled Session",

package/dist/apps/chat/data/timeline-query-service.js

@@ -75,8 +75,14 @@ export class ChatTimelineQueryService {
         return rows.map((row) => ({ eventType: row.type, count: Number(row.count) }));
     }
     getLatestEventSequence(piboSessionId) {
-        const row = this.store.db.prepare("SELECT COALESCE(MAX(session_sequence), 0) AS latest_sequence FROM event_log WHERE session_id = ?").get(piboSessionId);
-        return row.latest_sequence;
+        const row = this.store.db.prepare(`
+			SELECT session_sequence AS latest_sequence
+			FROM event_log
+			WHERE session_id = ?
+			ORDER BY session_sequence DESC, stream_id DESC
+			LIMIT 1
+		`).get(piboSessionId);
+        return row?.latest_sequence ?? 0;
     }
     getLatestStreamId(input = {}) {
         const clauses = [];

package/dist/apps/chat/trace-v2.js

@@ -20,6 +20,10 @@ export function traceTimelinePageFromView(input) {
         limit: Math.max(1, Math.min(input.limit, TRACE_V2_MAX_TIMELINE_LIMIT)),
         fromTail: input.fromTail,
     });
+    const transcriptTailCursor = input.fromTail ? input.transcriptTailCursor : undefined;
+    const hasOlder = input.trace.hasOlderEvents === true || transcriptTailCursor !== undefined;
+    const nextBeforeCursor = transcriptTailCursor ?? (hasOlder ? input.trace.nextBeforeCursor : undefined);
+    const nextBeforeSequence = transcriptTailCursor ? undefined : (hasOlder ? input.trace.nextBeforeSequence : undefined);
     let page = {
         piboSessionId: input.trace.piboSessionId,
         piSessionId: input.trace.piSessionId,
@@ -28,9 +32,9 @@ export function traceTimelinePageFromView(input) {
         latestStreamId: input.trace.latestStreamId,
         projectionStatus: "ready",
         cursor: {
-            before: input.trace.nextBeforeSequence !== undefined ? String(input.trace.nextBeforeSequence) : undefined,
+            before: nextBeforeCursor ?? (nextBeforeSequence !== undefined ? String(nextBeforeSequence) : undefined),
             after: input.trace.lastEventSequence !== undefined ? String(input.trace.lastEventSequence) : undefined,
-            hasOlder: input.trace.hasOlderEvents === true,
+            hasOlder,
             hasNewer: false,
         },
         nodes,
@@ -43,8 +47,9 @@ export function traceTimelinePageFromView(input) {
         pageSize: input.trace.pageSize,
         firstEventSequence: input.trace.firstEventSequence,
         lastEventSequence: input.trace.lastEventSequence,
-        nextBeforeSequence: input.trace.nextBeforeSequence,
-        hasOlderEvents: input.trace.hasOlderEvents,
+        nextBeforeSequence,
+        nextBeforeCursor,
+        hasOlderEvents: hasOlder,
     };
     while (Buffer.byteLength(JSON.stringify(page), "utf8") > byteLimit && page.nodes.length > 1) {
         page = {

package/dist/apps/chat/trace.js

@@ -8,10 +8,17 @@ import { isChatWebSessionArchived } from "./session-metadata.js";
 import { workflowSessionKindFromMetadata } from "../../sessions/workflow-session-kind.js";
 export { compareTraceNodes, sortTraceNodes, nestTraceNodes, flattenTraceNodes, mapTraceNodesById, buildTraceViewFromEvents, traceNodesFromEntries, } from "../../shared/trace-engine.js";
 export const TRACE_TRANSCRIPT_TAIL_MAX_BYTES = 2 * 1024 * 1024;
+export const TRACE_TRANSCRIPT_HISTORY_PAGE_MAX_BYTES = 512 * 1024;
+export const TRACE_TRANSCRIPT_HISTORY_SCAN_MAX_BYTES = 16 * 1024 * 1024;
 export async function loadPiSessionMetadata(session, cwd = process.cwd()) {
     const piSession = await findPiSession(session, cwd);
     return metadataFromPiSession(piSession);
 }
+export async function loadPiSessionFastMetadata(session, cwd = process.cwd()) {
+    const piSession = findPiSessionDirectFast(session.piSessionId, cwd)
+        ?? findPiSessionDirect(session.piSessionId, cwd, { fast: true });
+    return metadataFromPiSession(piSession);
+}
 function metadataFromPiSession(piSession) {
     if (!piSession)
         return {};
@@ -133,6 +140,9 @@ export async function buildTraceView(input) {
         includeRawEvents: input.includeRawEvents,
         rawEventsLimit: input.rawEventsLimit,
     });
+    if (input.transcriptOrderOffset && input.transcriptOrderOffset > 0) {
+        offsetTranscriptTraceOrder(view.nodes, input.transcriptOrderOffset);
+    }
     annotateForkableUserMessageNodes(view.nodes, allEntries);
     return {
         ...view,
@@ -191,7 +201,10 @@ export function createTraceViewVersion(input) {
         .digest("hex");
 }
 const PI_SESSION_LIST_CACHE_TTL_MS = 5_000;
+const PI_SESSION_DIRECT_CACHE_TTL_MS = 5_000;
+const PI_SESSION_FAST_HEAD_BYTES = 64 * 1024;
 const piSessionListCache = new Map();
+const piSessionDirectCache = new Map();
 export async function listPiSessions(cwd = process.cwd()) {
     const now = Date.now();
     const cached = piSessionListCache.get(cwd);
@@ -229,7 +242,31 @@ async function findPiSession(piboSession, cwd) {
     return (findPiSessionDirect(piboSession.piSessionId, cwd) ??
         (await listPiSessions(cwd)).find((session) => session.id === piboSession.piSessionId));
 }
-function findPiSessionDirect(piSessionId, cwd) {
+function findPiSessionDirectFast(piSessionId, cwd) {
+    const cacheKey = `${cwd}\0${piSessionId}`;
+    const cached = piSessionDirectCache.get(cacheKey);
+    if (!cached || cached.expiresAt <= Date.now())
+        return undefined;
+    try {
+        const stats = statSync(cached.path);
+        if (stats.size === cached.size && stats.mtimeMs === cached.mtimeMs)
+            return cached.item;
+    }
+    catch {
+        piSessionDirectCache.delete(cacheKey);
+    }
+    return undefined;
+}
+function setPiSessionDirectFastCache(piSessionId, cwd, item, stats) {
+    piSessionDirectCache.set(`${cwd}\0${piSessionId}`, {
+        expiresAt: Date.now() + PI_SESSION_DIRECT_CACHE_TTL_MS,
+        path: item.path,
+        size: stats.size,
+        mtimeMs: stats.mtimeMs,
+        item,
+    });
+}
+function findPiSessionDirect(piSessionId, cwd, options = {}) {
     const sessionDir = defaultPiSessionDir(cwd);
     if (!existsSync(sessionDir))
         return undefined;
@@ -239,7 +276,9 @@ function findPiSessionDirect(piSessionId, cwd) {
             return undefined;
         const sessionPath = join(sessionDir, file);
         const stats = statSync(sessionPath);
-        const entries = parseSessionEntries(readFileSync(sessionPath, "utf8"));
+        const entries = options.fast
+            ? readHeadEntries(sessionPath, stats.size, PI_SESSION_FAST_HEAD_BYTES)
+            : parseSessionEntries(readFileSync(sessionPath, "utf8"));
         const header = entries.find((entry) => entry.type === "session");
         if (header?.id !== piSessionId)
             return undefined;
@@ -256,17 +295,22 @@ function findPiSessionDirect(piSessionId, cwd) {
                 continue;
             firstMessage = extractMessageText(messageContent(entry));
         }
-        return {
+        const item = {
             path: sessionPath,
             id: piSessionId,
             cwd: stringValue(header.cwd) ?? cwd,
             name,
             parentSessionPath: stringValue(header.parentSession),
             created: stringValue(header.timestamp) ?? stats.birthtime.toISOString(),
-            modified: sessionModifiedIso(entries.filter((entry) => entry.type !== "session"), stringValue(header.timestamp), stats.mtime),
+            modified: options.fast
+                ? stats.mtime.toISOString()
+                : sessionModifiedIso(entries.filter((entry) => entry.type !== "session"), stringValue(header.timestamp), stats.mtime),
             messageCount,
             firstMessage: firstMessage || "(no messages)",
         };
+        if (options.fast)
+            setPiSessionDirectFastCache(piSessionId, cwd, item, stats);
+        return item;
     }
     catch {
         return undefined;
@@ -302,6 +346,26 @@ function readEntries(path) {
     const content = readFileSync(path, "utf8");
     return parseSessionEntries(content).filter((entry) => entry.type !== "session");
 }
+function readHeadEntries(path, fileSize, maxBytes) {
+    const length = Math.max(1, Math.min(maxBytes, fileSize));
+    const buffer = Buffer.alloc(length);
+    const fd = openSync(path, "r");
+    try {
+        const bytesRead = readSync(fd, buffer, 0, length, 0);
+        let content = buffer.subarray(0, bytesRead).toString("utf8");
+        if (bytesRead < fileSize && !content.endsWith("\n")) {
+            const lastNewline = content.lastIndexOf("\n");
+            if (lastNewline >= 0)
+                content = content.slice(0, lastNewline + 1);
+        }
+        if (!content.trim())
+            return [];
+        return parseSessionEntries(content.endsWith("\n") ? content : `${content}\n`);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
 export function readTailEntries(path, maxBytes = TRACE_TRANSCRIPT_TAIL_MAX_BYTES) {
     if (!existsSync(path))
         return [];
@@ -324,6 +388,127 @@ export function readTailEntries(path, maxBytes = TRACE_TRANSCRIPT_TAIL_MAX_BYTES
         closeSync(fd);
     }
 }
+export function readTranscriptHistoryPage(path, input = {}) {
+    if (!existsSync(path))
+        return { entries: [], hasOlder: false, scannedBytes: 0, startByte: 0, endByte: 0 };
+    const stats = statSync(path);
+    const fileSize = Math.max(0, stats.size);
+    const initialEnd = input.beforeByte === undefined
+        ? fileSize
+        : Math.max(0, Math.min(input.beforeByte, fileSize));
+    const limit = Math.max(1, Math.min(input.limit ?? 50, 500));
+    const pageBytes = Math.max(1024, Math.min(input.pageBytes ?? TRACE_TRANSCRIPT_HISTORY_PAGE_MAX_BYTES, TRACE_TRANSCRIPT_HISTORY_SCAN_MAX_BYTES));
+    const maxScanBytes = Math.max(pageBytes, Math.min(input.maxScanBytes ?? TRACE_TRANSCRIPT_HISTORY_SCAN_MAX_BYTES, 32 * 1024 * 1024));
+    const beforeTime = input.beforeTimestamp ? Date.parse(input.beforeTimestamp) : undefined;
+    const entries = [];
+    let cursorEnd = initialEnd;
+    let scannedBytes = 0;
+    let nextBeforeByte;
+    while (cursorEnd > 0 && entries.length < limit && scannedBytes < maxScanBytes) {
+        const chunkStart = Math.max(0, cursorEnd - pageBytes);
+        const chunk = readUtf8Range(path, chunkStart, cursorEnd);
+        scannedBytes += cursorEnd - chunkStart;
+        const records = transcriptLineRecords(chunk, chunkStart, cursorEnd);
+        for (let index = records.length - 1; index >= 0; index -= 1) {
+            const record = records[index];
+            const parsed = parseTranscriptLine(record.text);
+            for (let entryIndex = parsed.length - 1; entryIndex >= 0; entryIndex -= 1) {
+                const entry = parsed[entryIndex];
+                if (beforeTime !== undefined && entryTimestampMs(entry) >= beforeTime)
+                    continue;
+                entries.push({ entry, startByte: record.startByte });
+                if (entries.length >= limit) {
+                    nextBeforeByte = record.startByte;
+                    break;
+                }
+            }
+            if (entries.length >= limit)
+                break;
+        }
+        cursorEnd = chunkStart;
+    }
+    if (nextBeforeByte === undefined)
+        nextBeforeByte = cursorEnd > 0 ? cursorEnd : undefined;
+    return {
+        entries: entries.reverse().map((item) => item.entry),
+        nextBeforeByte,
+        hasOlder: nextBeforeByte !== undefined && nextBeforeByte > 0,
+        scannedBytes,
+        startByte: nextBeforeByte ?? 0,
+        endByte: initialEnd,
+    };
+}
+function readUtf8Range(path, start, end) {
+    const length = Math.max(0, end - start);
+    if (length === 0)
+        return "";
+    const buffer = Buffer.alloc(length);
+    const fd = openSync(path, "r");
+    try {
+        const bytesRead = readSync(fd, buffer, 0, length, start);
+        return buffer.subarray(0, bytesRead).toString("utf8");
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function transcriptLineRecords(content, startByte, endByte) {
+    let text = content;
+    let byteOffset = startByte;
+    if (startByte > 0) {
+        const firstNewline = text.indexOf("\n");
+        if (firstNewline < 0)
+            return [];
+        const skipped = text.slice(0, firstNewline + 1);
+        byteOffset += Buffer.byteLength(skipped, "utf8");
+        text = text.slice(firstNewline + 1);
+    }
+    if (endByte > startByte && text && !text.endsWith("\n")) {
+        const lastNewline = text.lastIndexOf("\n");
+        if (lastNewline >= 0)
+            text = text.slice(0, lastNewline + 1);
+    }
+    const records = [];
+    const segments = text.match(/[^\n]*(?:\n|$)/g) ?? [];
+    for (const segment of segments) {
+        if (!segment)
+            continue;
+        const lineStart = byteOffset;
+        byteOffset += Buffer.byteLength(segment, "utf8");
+        const line = segment.replace(/\r?\n$/, "");
+        if (line.trim())
+            records.push({ text: line, startByte: lineStart });
+    }
+    return records;
+}
+function parseTranscriptLine(line) {
+    try {
+        return parseSessionEntries(`${line}\n`).filter((entry) => entry.type !== "session");
+    }
+    catch {
+        return [];
+    }
+}
+function entryTimestampMs(entry) {
+    const timestamp = entry.timestamp;
+    if (typeof timestamp !== "string")
+        return Number.POSITIVE_INFINITY;
+    const parsed = Date.parse(timestamp);
+    return Number.isFinite(parsed) ? parsed : Number.POSITIVE_INFINITY;
+}
+function offsetTranscriptTraceOrder(nodes, offset) {
+    for (const node of nodes) {
+        if (node.source === "transcript" && node.orderKey) {
+            const transcriptIndex = node.orderKey.transcriptIndex;
+            node.orderKey = {
+                ...node.orderKey,
+                turnSeq: node.orderKey.turnSeq + offset,
+                transcriptIndex: transcriptIndex === undefined ? undefined : transcriptIndex + offset,
+            };
+        }
+        offsetTranscriptTraceOrder(node.children, offset);
+    }
+}
 function annotateForkableUserMessageNodes(nodes, entries) {
     const candidates = userMessageForkCandidates(entries);
     if (!candidates.length)