@tangle-network/harness-sessions 0.1.5 → 0.1.6

package/dist/input.d.ts

@@ -11,6 +11,12 @@ export interface SessionInputInit {
     parentNativeSessionId?: string | null;
     /** Names the source in integrity records (a path, a blob ref). */
     label?: string;
+    /**
+     * The file line `input` starts on, when it continues a longer file (records appended since a
+     * previous read). A record without an id of its own is named by its line, so the same record
+     * gets the same id whichever way the file is read. Default 1.
+     */
+    firstLine?: number;
 }
 /** Read a JSONL-format session (Claude Code, Codex, Pi, Kimi) from text or parsed records, synchronously. */
 export declare function readSessionInput(harness: string, input: SessionInput, init?: SessionInputInit, options?: Pick<ReadOptions, 'corruption'>): HarnessSession;

package/dist/input.js

@@ -31,7 +31,10 @@ function foldInput(harness, input, init, mode, options) {
         parentNativeSessionId: init.parentNativeSessionId ?? null,
     };
     const fold = create(ref, mode, stats);
-    const records = 'text' in input ? textRecordsSync(input.text, stats, { strict: options.corruption === 'strict' }) : arrayRecordsSync(input.records, stats);
+    const firstLine = init.firstLine ?? 1;
+    const records = 'text' in input
+        ? textRecordsSync(input.text, stats, { strict: options.corruption === 'strict', firstLine })
+        : arrayRecordsSync(input.records, stats, firstLine);
     for (const record of records)
         fold.observe(record);
     return fold.finish();

package/dist/source.d.ts

@@ -40,12 +40,16 @@ export declare function fileRecords(path: string, options?: {
 }): RecordSource;
 /** Stats for bytes already in memory. */
 export declare function memoryStats(label: string, text?: string): SourceStats;
-/** The records of JSONL text already in memory (a retained copy, a blob), read synchronously. */
+/**
+ * The records of JSONL text already in memory (a retained copy, a blob), read synchronously.
+ * `firstLine` numbers the text's first line, for text that continues a longer file.
+ */
 export declare function textRecordsSync(text: string, stats: SourceStats, options?: {
     strict?: boolean;
+    firstLine?: number;
 }): Generator<Record<string, unknown>>;
-/** Records a caller already parsed (one per line, in order). Non-objects count as unparsed. */
-export declare function arrayRecordsSync(values: readonly unknown[], stats: SourceStats): Generator<Record<string, unknown>>;
+/** Records a caller already parsed (one per line, in order, the first on line `firstLine`). Non-objects count as unparsed. */
+export declare function arrayRecordsSync(values: readonly unknown[], stats: SourceStats, firstLine?: number): Generator<Record<string, unknown>>;
 /**
  * Run `use` against a SQLite store opened read-only in place ({@link openSqlite}). A store SQLite
  * cannot open in place is read from a private copy instead: a write-ahead log with no `-shm` in a

package/dist/source.js

@@ -116,10 +116,15 @@ export function memoryStats(label, text) {
     const bytes = Buffer.from(text, 'utf8');
     return { path: label, sha256: `sha256:${createHash('sha256').update(bytes).digest('hex')}`, bytes: bytes.length, unparsed: 0, tornTail: false, line: 0 };
 }
-/** The records of JSONL text already in memory (a retained copy, a blob), read synchronously. */
+/**
+ * The records of JSONL text already in memory (a retained copy, a blob), read synchronously.
+ * `firstLine` numbers the text's first line, for text that continues a longer file.
+ */
 export function* textRecordsSync(text, stats, options = {}) {
     const lines = text.split('\n');
-    for (const [index, raw] of lines.entries()) {
+    const first = options.firstLine ?? 1;
+    for (const [position, raw] of lines.entries()) {
+        const index = first - 1 + position;
         const line = raw.replace(/\r$/u, '');
         if (line.trim().length === 0)
             continue;
@@ -128,7 +133,7 @@ export function* textRecordsSync(text, stats, options = {}) {
             value = JSON.parse(line);
         }
         catch {
-            if (index === lines.length - 1) {
+            if (position === lines.length - 1) {
                 stats.tornTail = true;
                 continue;
             }
@@ -147,9 +152,10 @@ export function* textRecordsSync(text, stats, options = {}) {
         yield value;
     }
 }
-/** Records a caller already parsed (one per line, in order). Non-objects count as unparsed. */
-export function* arrayRecordsSync(values, stats) {
-    for (const [index, value] of values.entries()) {
+/** Records a caller already parsed (one per line, in order, the first on line `firstLine`). Non-objects count as unparsed. */
+export function* arrayRecordsSync(values, stats, firstLine = 1) {
+    for (const [position, value] of values.entries()) {
+        const index = firstLine - 1 + position;
         if (value === null || typeof value !== 'object' || Array.isArray(value)) {
             noteUnparsed(stats, index + 1);
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/harness-sessions",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "One reader for every coding-agent harness's native session (Claude Code, Codex, OpenCode, Pi): store layouts, a normalized session with messages, tool calls, served models, usage and ending errors, and projections to chat messages, OTLP spans and turns",
   "type": "module",
   "sideEffects": false,