lark-remote 0.1.6 → 0.1.7

package/dist/runner/resolve-agent-choices.js

@@ -1,6 +1,7 @@
+import { choiceFieldsFor } from './agent-choices-common.js';
 export function resolveAgentChoices(config) {
-    const choices = config.agentChoices;
     const agent = config.defaultAgent;
+    const choices = config.agentChoices;
     if (!choices || !agent) {
         return config;
     }
@@ -9,67 +10,25 @@ export function resolveAgentChoices(config) {
         return config;
     }
     const agentChoices = choices[agent];
-    if (!agentChoices) {
+    const fields = choiceFieldsFor(agent);
+    if (!agentChoices || !fields) {
         return config;
     }
     // Clone to avoid mutation
-    const resolved = JSON.parse(JSON.stringify(config));
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const resolvedAny = resolved;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const agentChoicesAny = agentChoices;
-    switch (agent) {
-        case 'codex':
-            if (!resolvedAny.agents)
-                resolvedAny.agents = {};
-            if (!resolvedAny.agents.codex)
-                resolvedAny.agents.codex = {};
-            if (!resolvedAny.agents.codex.model && agentChoicesAny.model) {
-                resolvedAny.agents.codex.model = agentChoicesAny.model;
-            }
-            if (!resolvedAny.agents.codex.modelProvider && agentChoicesAny.modelProvider) {
-                resolvedAny.agents.codex.modelProvider = agentChoicesAny.modelProvider;
-            }
-            break;
-        case 'pi':
-            if (!resolvedAny.agents)
-                resolvedAny.agents = {};
-            if (!resolvedAny.agents.pi)
-                resolvedAny.agents.pi = {};
-            if (!resolvedAny.agents.pi.model && agentChoicesAny.model) {
-                resolvedAny.agents.pi.model = agentChoicesAny.model;
-            }
-            if (!resolvedAny.agents.pi.provider && agentChoicesAny.provider) {
-                resolvedAny.agents.pi.provider = agentChoicesAny.provider;
-            }
-            if (!resolvedAny.agents.pi.thinking && agentChoicesAny.thinking) {
-                resolvedAny.agents.pi.thinking = agentChoicesAny.thinking;
-            }
-            break;
-        case 'opencode':
-            if (!resolvedAny.agents)
-                resolvedAny.agents = {};
-            if (!resolvedAny.agents.opencode)
-                resolvedAny.agents.opencode = {};
-            if (!resolvedAny.agents.opencode.modelID && agentChoicesAny.modelID) {
-                resolvedAny.agents.opencode.modelID = agentChoicesAny.modelID;
-            }
-            if (!resolvedAny.agents.opencode.providerID && agentChoicesAny.providerID) {
-                resolvedAny.agents.opencode.providerID = agentChoicesAny.providerID;
-            }
-            break;
-        case 'kimi':
-            if (!resolvedAny.agents)
-                resolvedAny.agents = {};
-            if (!resolvedAny.agents.kimi)
-                resolvedAny.agents.kimi = {};
-            if (!resolvedAny.agents.kimi.model && agentChoicesAny.model) {
-                resolvedAny.agents.kimi.model = agentChoicesAny.model;
-            }
-            if (!resolvedAny.agents.kimi.thinkingEffort && agentChoicesAny.thinkingEffort) {
-                resolvedAny.agents.kimi.thinkingEffort = agentChoicesAny.thinkingEffort;
-            }
-            break;
+    const resolved = structuredClone(config);
+    // agents.codex 在 schema 中必填（带默认值），此处按旧语义补空对象；
+    // 运行时只往 [agent] 槽位写字段，不依赖 codex 默认值。
+    if (!resolved.agents) {
+        resolved.agents = {};
+    }
+    const agents = resolved.agents;
+    const target = (agents[agent] ??= {});
+    const source = agentChoices;
+    for (const { configKey, choicesKey } of fields) {
+        const value = source[choicesKey];
+        if (!target[configKey] && value) {
+            target[configKey] = value;
+        }
     }
     return resolved;
 }

package/dist/runner/sync-agent-choices.js

@@ -1,72 +1,21 @@
+import { choiceFieldsFor } from './agent-choices-common.js';
 export function syncAgentChoices(config, agent) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const configAny = config;
-    const agents = configAny.agents || {};
-    const agentCfg = agents[agent];
-    // claude reads from top-level config.claude, not agents.claude
-    if (agent !== 'claude' && !agentCfg) {
+    // claude 的配置在顶层 config.claude，不在 agents 下，无需同步
+    const fields = choiceFieldsFor(agent);
+    if (!fields)
         return config;
-    }
-    const updated = JSON.parse(JSON.stringify(config));
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const updatedAny = updated;
-    if (!updatedAny.agentChoices) {
-        updatedAny.agentChoices = {};
-    }
-    switch (agent) {
-        case 'codex':
-            if (agentCfg.model) {
-                if (!updatedAny.agentChoices.codex)
-                    updatedAny.agentChoices.codex = {};
-                updatedAny.agentChoices.codex.model = agentCfg.model;
-            }
-            if (agentCfg.modelProvider) {
-                if (!updatedAny.agentChoices.codex)
-                    updatedAny.agentChoices.codex = {};
-                updatedAny.agentChoices.codex.modelProvider = agentCfg.modelProvider;
-            }
-            break;
-        case 'pi':
-            if (agentCfg.model) {
-                if (!updatedAny.agentChoices.pi)
-                    updatedAny.agentChoices.pi = {};
-                updatedAny.agentChoices.pi.model = agentCfg.model;
-            }
-            if (agentCfg.provider) {
-                if (!updatedAny.agentChoices.pi)
-                    updatedAny.agentChoices.pi = {};
-                updatedAny.agentChoices.pi.provider = agentCfg.provider;
-            }
-            if (agentCfg.thinking) {
-                if (!updatedAny.agentChoices.pi)
-                    updatedAny.agentChoices.pi = {};
-                updatedAny.agentChoices.pi.thinking = agentCfg.thinking;
-            }
-            break;
-        case 'opencode':
-            if (agentCfg.modelID) {
-                if (!updatedAny.agentChoices.opencode)
-                    updatedAny.agentChoices.opencode = {};
-                updatedAny.agentChoices.opencode.modelID = agentCfg.modelID;
-            }
-            if (agentCfg.providerID) {
-                if (!updatedAny.agentChoices.opencode)
-                    updatedAny.agentChoices.opencode = {};
-                updatedAny.agentChoices.opencode.providerID = agentCfg.providerID;
-            }
-            break;
-        case 'kimi':
-            if (agentCfg.model) {
-                if (!updatedAny.agentChoices.kimi)
-                    updatedAny.agentChoices.kimi = {};
-                updatedAny.agentChoices.kimi.model = agentCfg.model;
-            }
-            if (agentCfg.thinkingEffort) {
-                if (!updatedAny.agentChoices.kimi)
-                    updatedAny.agentChoices.kimi = {};
-                updatedAny.agentChoices.kimi.thinkingEffort = agentCfg.thinkingEffort;
-            }
-            break;
+    const agents = config.agents;
+    const agentCfg = agents?.[agent];
+    if (!agentCfg)
+        return config;
+    const updated = structuredClone(config);
+    const choices = (updated.agentChoices ??= {});
+    const agentChoices = (choices[agent] ??= {});
+    const source = agentCfg;
+    for (const { configKey, choicesKey } of fields) {
+        const value = source[configKey];
+        if (value)
+            agentChoices[choicesKey] = value;
     }
     return updated;
 }

package/dist/runner/types.d.ts

@@ -25,7 +25,7 @@ export interface ApprovalRequestedEvent {
     type: 'approval_requested';
     /** JSON-RPC id of the server request. Wire type is string | integer — keep raw. */
     requestId: number | string;
-    kind: 'command' | 'file' | 'permissions';
+    kind: 'command' | 'file' | 'permissions' | 'question';
     threadId: string;
     turnId: string;
     itemId: string;
@@ -51,13 +51,49 @@ export interface ApprovalExpiredEvent {
     requestId: number | string;
     timestamp?: string;
 }
+/** 审批决策（bridge ApprovalCoordinator → runner.respondApproval 的响应载荷）。 */
+export type ApprovalAction = {
+    action: 'accept';
+} | {
+    action: 'accept_for_session';
+} | {
+    action: 'accept_with_execpolicy_amendment';
+}
+/** Claude：允许当前请求 + 本会话后续所有权限请求自动放行（允许所有）。 */
+ | {
+    action: 'accept_all';
+} | {
+    action: 'decline';
+} | {
+    action: 'cancel';
+}
+/** Claude AskUserQuestion 答案（question → label 或 label[]）。 */
+ | {
+    action: 'answer';
+    answers: Record<string, string | string[]>;
+};
+/** Claude Code AskUserQuestion 的单个选项（control_request input.questions[].options[]）。 */
+export interface ClaudeUserQuestionOption {
+    label: string;
+    description?: string;
+}
+/** Claude Code AskUserQuestion 的单个问题（control_request input.questions[]）。 */
+export interface ClaudeUserQuestion {
+    question: string;
+    header?: string;
+    multiSelect?: boolean;
+    options: ClaudeUserQuestionOption[];
+    /**
+     * 当前已选选项 label（卡片渲染与多选切换用；单选在协调器内即时提交）。
+     * 与 permissions.items.selected 同模式：协调器原地更新后以
+     * approval_view_updated 重新渲染。
+     */
+    selected?: string[];
+}
 export interface ApprovalView {
     requestId: number | string;
-    kind: 'command' | 'file' | 'permissions';
+    kind: 'command' | 'file' | 'permissions' | 'question';
     reason?: string;
-    threadShort: string;
-    turnShort: string;
-    workspace: string;
     command?: string;
     commandCwd?: string;
     fileChanges?: Array<{
@@ -65,14 +101,7 @@ export interface ApprovalView {
         kind: 'add' | 'update' | 'delete';
         diff?: string;
     }>;
-    network?: {
-        host: string;
-        protocol: string;
-    };
     permissions?: {
-        networkEnabled?: boolean;
-        fileSystemRead?: string[];
-        fileSystemWrite?: string[];
         items: Array<{
             id: string;
             label: string;
@@ -85,10 +114,11 @@ export interface ApprovalView {
             selected: boolean;
         }>;
     };
+    /** Claude AskUserQuestion 问题列表（kind === 'question' 时存在）。 */
+    questions?: ClaudeUserQuestion[];
     availableDecisions: string[];
     /** Raw payloads for structured decisions (e.g. acceptWithExecpolicyAmendment). */
     decisionPayloads?: Record<string, unknown>;
-    pendingTotal: number;
 }
 interface ThinkingContent {
     type: 'thinking';

package/dist/session/claude/session-index.js

@@ -2,7 +2,6 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { scanJsonlLines } from '../common/jsonl.js';
 import { extractContentBlocks } from '../common/content-blocks.js';
-import { truncate } from '../../card/card-shared.js';
 import { getLogger } from '../../logger/index.js';
 // ─── Claude content block mapping (shared with sessions.ts) ─
 /** Claude-specific field-name mapping for content block extraction. */
@@ -224,7 +223,7 @@ export class SessionIndex {
                     path: p,
                     fingerprint: currentFp,
                     mtimeMs: Number(st.mtimeMs),
-                    summary: truncate(parsed.summary, 60, { normalizeWhitespace: true }),
+                    summary: parsed.summary.replace(/\s+/g, ' ').trim(),
                     cwdSet: parsed.cwdSet,
                 };
                 this.updateEntry(p, updated);
@@ -302,7 +301,7 @@ export class SessionIndex {
                         path: fullPath,
                         fingerprint: fpAfter,
                         mtimeMs: Number(fileStat.mtimeMs),
-                        summary: truncate(parsed.summary, 60, { normalizeWhitespace: true }),
+                        summary: parsed.summary.replace(/\s+/g, ' ').trim(),
                         cwdSet: parsed.cwdSet,
                     };
                     this.updateEntry(fullPath, newEntry);

package/dist/session/claude/session-reader.js

@@ -1,3 +1,4 @@
+import { paginate } from '../common/pagination.js';
 import { listClaudeSessions, getNewestSession, readSessionContent, isClaudeSessionActive, } from '../../session/claude/sessions.js';
 /**
  * Adapter that exposes Claude Code's session-reading functions through the
@@ -22,12 +23,8 @@ export class ClaudeSessionReader {
         // 先拿全集（不传 limit → listClaudeSessions 不切片），total 用全集长度，
         // 再由 reader 按 [offset, offset+limit) 切片。
         const all = listClaudeSessions(cwd, this.readerOpts());
-        const offset = Math.max(0, opts?.offset ?? 0);
-        const limit = opts?.limit;
-        return {
-            sessions: limit === undefined ? all.slice(offset) : all.slice(offset, offset + limit),
-            total: all.length,
-        };
+        const { items, total } = paginate(all, opts ?? {});
+        return { sessions: items, total };
     }
     getNewestSession(cwd) {
         const session = getNewestSession(cwd, this.readerOpts());

package/dist/session/claude/sessions.js

@@ -3,9 +3,9 @@ import path from 'node:path';
 import os from 'node:os';
 import { findJsonlLine, readLastJsonlLine, scanJsonlLines, readJsonlLinesFromOffset, } from '../common/jsonl.js';
 import { STALE_MS } from '../common/constants.js';
+import { capEvents } from '../common/pagination.js';
 import { extractContentBlocks } from '../common/content-blocks.js';
 import { UsageAccumulator } from '../common/usage-accumulator.js';
-import { truncate } from '../../card/card-shared.js';
 import { SessionIndex, extractText, isTaskNotificationText, CLAUDE_MAPPING, } from './session-index.js';
 /**
  * Directory Claude Code uses to store session transcripts for a given cwd.
@@ -262,7 +262,7 @@ function scalarScan(filePath) {
                 lastPostTokens = cm.postTokens;
             }
         }
-        // --- last user message offset (was findLastUserIndex) ---
+        // --- last user message offset ---
         // Record the byte offset where the tail should start: the beginning of
         // the NEXT line after this user message. We compute it as this line's
         // start offset + its byte length + 1 (the trailing '\n').
@@ -382,12 +382,7 @@ function extractEventsFromTail(tailLines, maxEvents) {
             events.push({ type: role, content: `(${role} event)`, timestamp });
         }
     }
-    if (maxEvents !== undefined) {
-        if (maxEvents <= 0)
-            return [];
-        return events.slice(-maxEvents);
-    }
-    return events;
+    return capEvents(events, maxEvents);
 }
 export function readSessionContent(sessionId, cwd, opts = {}) {
     const { maxEvents } = opts;
@@ -447,11 +442,9 @@ export function readSessionContent(sessionId, cwd, opts = {}) {
     // show.
     const tailLines = readJsonlLinesFromOffset(filePath, scan.tailOffset >= 0 ? scan.tailOffset : 0);
     const events = extractEventsFromTail(tailLines, maxEvents);
-    // Use aiTitle if available, otherwise fallback to last user message (truncated to 200 chars)
-    const displayTitle = scan.aiTitle ??
-        (scan.lastUserMessage
-            ? truncate(scan.lastUserMessage, 200, { normalizeWhitespace: true })
-            : undefined);
+    // Use aiTitle if available, otherwise fallback to last user message.
+    // Truncation is deferred to the consumer (router card building).
+    const displayTitle = scan.aiTitle ?? scan.lastUserMessage ?? undefined;
     return {
         events,
         usage,

package/dist/session/codex/rollout-reader.d.ts

@@ -11,8 +11,7 @@
  * ```
  *
  * Note: This handles the **rollout file format** (historical logging), NOT the
- * `codex exec --json` stdout format. Those are two different JSONL formats
- * (see design doc appendix B vs C).
+ * `codex exec --json` stdout format（已随 exec 模式移除）。
  */
 import type { AgentSessionContentEvent, SessionContent, AgentSessionUsage } from '../../runner/index.js';
 interface CodexRolloutEntry {
@@ -83,6 +82,7 @@ export declare function readCodexSessionContent(sessionId: string, opts?: {
 export declare function isCodexSessionActive(sessionId: string, opts?: {
     codexHome?: string;
     activeThresholdMs?: number;
+    cwd?: string;
 }): boolean;
 /** Clear the session index cache. Exposed for tests. */
 export declare function clearSessionIndexCache(): void;

package/dist/session/codex/rollout-reader.js

@@ -11,12 +11,13 @@
  * ```
  *
  * Note: This handles the **rollout file format** (historical logging), NOT the
- * `codex exec --json` stdout format. Those are two different JSONL formats
- * (see design doc appendix B vs C).
+ * `codex exec --json` stdout format（已随 exec 模式移除）。
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import { readJsonlLines, findJsonlLine } from '../common/jsonl.js';
+import { STALE_MS } from '../common/constants.js';
+import { paginate, capEvents } from '../common/pagination.js';
 import { getLogger } from '../../logger/index.js';
 import { isRecord, stringValue } from '../../common/guards.js';
 import { resolveCodexHome } from '../../config/codex-config.js';
@@ -243,8 +244,6 @@ export function readCodexRollout(filePath) {
  */
 export function listCodexRollouts(opts = {}) {
     const codexHome = resolveCodexHome(opts.codexHome);
-    const limit = opts.limit ?? 20;
-    const offset = Math.max(0, opts.offset ?? 0);
     const filterCwd = opts.cwd;
     // Full index: every rollout file's session_meta + mtime, no early break.
     const index = getSessionIndex(codexHome);
@@ -263,8 +262,7 @@ export function listCodexRollouts(opts = {}) {
     // Same-mtime ties use filePath as a deterministic secondary key so index
     // rebuilds / walk order changes never reorder the page.
     matched.sort((a, b) => b.mtimeMs - a.mtimeMs || a.filePath.localeCompare(b.filePath));
-    const total = matched.length;
-    const page = matched.slice(offset, offset + limit);
+    const { items: page, total } = paginate(matched, { limit: opts.limit, offset: opts.offset });
     // Full-parse only the page being returned (summary/usage).
     const entries = [];
     for (const item of page) {
@@ -317,22 +315,14 @@ export function readCodexSessionContent(sessionId, opts = {}) {
     }
     // Apply maxEvents cap: keep the LAST N events (most recent).
     // See function docstring for rationale.
-    // P2-7: maxEvents <= 0 returns [] — guards the `slice(-0) === slice(0)`
-    // full-array trap (no caller passes 0 today, but the contract must hold).
-    const events = opts.maxEvents !== undefined && opts.maxEvents > 0 && rollout.events.length > opts.maxEvents
-        ? rollout.events.slice(-opts.maxEvents)
-        : opts.maxEvents !== undefined && opts.maxEvents <= 0
-            ? []
-            : rollout.events;
+    const events = capEvents(rollout.events, opts.maxEvents);
     return {
         events,
         // displayTitle = LAST real user message (matches the
         // "最近输入" label). recap is undefined: codex has no
         // compact-summary concept, so never fake one from a user
         // message (was: firstUserMessage = injected project rules).
-        displayTitle: rollout.lastRealUserMessage
-            ? rollout.lastRealUserMessage.slice(0, 50)
-            : undefined,
+        displayTitle: rollout.lastRealUserMessage || undefined,
         recap: undefined,
         usage: rollout.usage,
     };
@@ -347,7 +337,9 @@ export function readCodexSessionContent(sessionId, opts = {}) {
  */
 export function isCodexSessionActive(sessionId, opts = {}) {
     const codexHome = resolveCodexHome(opts.codexHome);
-    const threshold = opts.activeThresholdMs ?? 10 * 60 * 1000; // 10 minutes default
+    // Unify with the other readers' 1-hour stale window (claude/pi/opencode/kimi
+    // all use STALE_MS). Previously codex used a divergent 10-minute default.
+    const threshold = opts.activeThresholdMs ?? STALE_MS;
     // P2-4: Use session index for direct file lookup + mtime check
     let index = getSessionIndex(codexHome);
     let entry = index.get(sessionId);
@@ -366,6 +358,11 @@ export function isCodexSessionActive(sessionId, opts = {}) {
     if (entry.isSubagent) {
         return false;
     }
+    // Cwd guard: when a cwd is provided, the session's working directory must
+    // match (align with claude/pi/opencode which validate cwd).
+    if (opts.cwd && entry.cwd !== opts.cwd) {
+        return false;
+    }
     // Re-stat to get fresh mtime (index may be up to INDEX_TTL_MS stale)
     try {
         const stat = fs.statSync(entry.filePath);

package/dist/session/codex/sessions.d.ts

@@ -16,6 +16,6 @@ export declare class CodexSessionReader implements AgentSessionReader {
     readSessionContent(sessionId: string, cwd: string, opts?: {
         maxEvents?: number;
     }): SessionContent;
-    isSessionActive(sessionId: string, _cwd: string): boolean;
+    isSessionActive(sessionId: string, cwd: string): boolean;
 }
 export {};

package/dist/session/codex/sessions.js

@@ -34,8 +34,8 @@ export class CodexSessionReader {
             cwd,
         });
     }
-    isSessionActive(sessionId, _cwd) {
-        return isCodexSessionActive(sessionId, { codexHome: this.codexHome });
+    isSessionActive(sessionId, cwd) {
+        return isCodexSessionActive(sessionId, { codexHome: this.codexHome, cwd });
     }
 }
 //# sourceMappingURL=sessions.js.map

package/dist/session/common/content-blocks.d.ts

@@ -10,6 +10,13 @@ interface ContentBlock {
     type: 'text' | 'thinking' | 'tool_use' | 'tool_result';
     content: string;
 }
+/**
+ * Truncate a serialized tool-input string to 200 chars, collapsing newlines.
+ * Shared by content-block extraction and standalone wire-event readers (kimi
+ * tool.call) so the resume card never exceeds its 28KB budget on pathological
+ * args (e.g. whole-file writes / long prompts).
+ */
+export declare function truncateToolInput(inputStr: string): string;
 /** Maps agent-specific field names to the generic extraction logic. */
 export interface ContentBlockMapping {
     /** The `type` value that identifies a tool-use block (e.g. 'tool_use' or 'toolCall'). */

package/dist/session/common/content-blocks.js

@@ -5,6 +5,17 @@
  * tool_result blocks. The {@link ContentBlockMapping} type captures those
  * differences so a single implementation can serve all readers.
  */
+/**
+ * Truncate a serialized tool-input string to 200 chars, collapsing newlines.
+ * Shared by content-block extraction and standalone wire-event readers (kimi
+ * tool.call) so the resume card never exceeds its 28KB budget on pathological
+ * args (e.g. whole-file writes / long prompts).
+ */
+export function truncateToolInput(inputStr) {
+    if (inputStr.length <= 200)
+        return inputStr;
+    return inputStr.replace(/\n/g, ' ').slice(0, 197) + '...';
+}
 /**
  * Extract content blocks from a message content array.
  *
@@ -34,16 +45,9 @@ export function extractContentBlocks(content, mapping) {
         // tool_use block (parameterized type name + input field)
         if (p.type === mapping.toolUseType && typeof p.name === 'string') {
             const rawInput = p[mapping.toolInputField] ?? {};
-            const inputStr = JSON.stringify(rawInput, null, 2);
+            const inputStr = truncateToolInput(JSON.stringify(rawInput, null, 2));
             const label = `🔧 ${p.name}`;
-            let body;
-            if (inputStr.length > 200) {
-                body = inputStr.replace(/\n/g, ' ').slice(0, 197) + '...';
-            }
-            else {
-                body = inputStr;
-            }
-            blocks.push({ type: 'tool_use', content: `${label}: ${body}` });
+            blocks.push({ type: 'tool_use', content: `${label}: ${inputStr}` });
         }
         // tool_result block (parameterized type name + error field)
         if (p.type === mapping.toolResultType) {

package/dist/session/common/jsonl.d.ts

@@ -18,14 +18,7 @@ export declare function readLastJsonlLine(filePath: string): string | null;
  * Read the last N non-empty lines from a JSONL file using streaming reads.
  *
  * Unlike `readJsonlLines` (which materializes the entire file into a `string[]`),
- * this only retains the last `n` lines — memory is O(n), not O(whole file). The
- * file is still read front-to-back in chunks (no reverse seek), but earlier
- * lines are discarded as soon as the buffer exceeds `n`, so a multi-MB file
- * costs only ~`n` line strings of resident memory.
- *
- * Used by tail-only read paths (P2-5) such as `isSessionActive`, which only
- * need to inspect the file's tail (e.g. the last ~20 loop events) but were
- * previously full-slurping the whole wire log.
+ * this only retains the last `n` lines — memory is O(n), not O(whole file).
  *
  * @param filePath  Absolute path to a `.jsonl` file.
  * @param n         Maximum number of trailing non-empty lines to retain.
@@ -37,32 +30,23 @@ export declare function readLastNJsonlLines(filePath: string, n: number): string
  * Stream-scan a JSONL file once, invoking `onLine` for each non-empty line
  * with the line's raw string and its **starting byte offset** within the file.
  *
- * Unlike `readJsonlLines` this retains NOTHING — memory is O(chunk), not
- * O(whole file). The callback receives the byte offset so callers can record
- * where a line of interest (e.g. the last user message) begins, then re-read
- * only the tail from that offset via `readJsonlLinesFromOffset` (P2-5
- * byte-offset two-pass: full-file scalar scan without materializing a
- * `string[]`, then tail-only re-parse for events).
+ * Memory is O(chunk), not O(whole file). The callback receives the byte offset
+ * so callers can record where a line of interest begins, then re-read only the
+ * tail from that offset via `readJsonlLinesFromOffset`.
  *
  * @param filePath Absolute path to a `.jsonl` file.
- * @param onLine   Called for each non-empty line with `(line, offset)` where
- *                 `offset` is the byte offset of the line's first character.
+ * @param onLine   Called for each non-empty line with `(line, offset)`.
  * @returns `true` if the file was opened and scanned, `false` on open error.
  */
 export declare function scanJsonlLines(filePath: string, onLine: (line: string, offset: number) => void): boolean;
 /**
  * Read all non-empty lines starting from a byte `offset` in a JSONL file.
  *
- * Companion to `scanJsonlLines` for the P2-5 byte-offset two-pass pattern:
- * pass 1 records the offset where the tail begins (e.g. the byte right after
- * the last user message); pass 2 seeks there and reads/parses only the tail,
- * so raw line-string memory is O(tail) instead of O(whole file).
+ * Companion to `scanJsonlLines` for the byte-offset two-pass pattern.
  *
  * @param filePath Absolute path to a `.jsonl` file.
  * @param offset   Byte offset to seek to before reading. **Must fall on a line
- *                 boundary** (e.g. 0, or the start of the line after the last
- *                 user message as recorded by `scanJsonlLines`); a mid-line
- *                 offset will include a leading partial line.
+ *                 boundary**; a mid-line offset will include a leading partial line.
  * @returns Array of raw line strings from `offset` to EOF (empty lines
  *          excluded). Empty array on open/seek error or `offset` past EOF.
  */
@@ -71,7 +55,6 @@ export declare function readJsonlLinesFromOffset(filePath: string, offset: numbe
  * Read all non-empty lines from a JSONL file using streaming reads.
  *
  * @param filePath  Absolute path to a `.jsonl` file.
- * @param chunkSize Buffer size for each `fs.readSync` call (default 65536).
  * @returns Array of raw line strings (empty lines excluded).
  */
-export declare function readJsonlLines(filePath: string, chunkSize?: number): string[];
+export declare function readJsonlLines(filePath: string): string[];