@code-yeongyu/senpi-agent-core 2026.9.12 → 2026.9.13

package/dist/harness/session/jsonl/codec.js

@@ -1,230 +1,45 @@
 import { err, ok } from "../../types.js";
-import { JsonlDecodeError } from "./errors.js";
-const ENTRY_TYPES = new Set([
-    "message",
-    "model_change",
-    "thinking_level_change",
-    "configuration_update",
-    "active_tools_change",
-    "compaction",
-    "branch_summary",
-    "custom",
-]);
-const RECORD_TYPES = new Set([
-    "operation_started",
-    "abort_requested",
-    "operation_finished",
-    "step_attempt",
-    "tool_started",
-    "queue_enqueued",
-    "queue_cancelled",
-    "write_deferred",
-    "usage",
-]);
-const OPERATION_KINDS = new Set(["run", "compaction", "navigation"]);
-function isObject(value) {
+import { JSONL_FORMAT_VERSION } from "./types.js";
+function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function parseObject(line) {
+function isSafeIntegerAtLeast(value, minimum) {
+    return Number.isSafeInteger(value) && value >= minimum;
+}
+export function isLegacyV3SessionHeader(value) {
+    return (isRecord(value) &&
+        value.type === "session" &&
+        value.version === 3 &&
+        typeof value.id === "string" &&
+        typeof value.cwd === "string" &&
+        typeof value.timestamp === "string" &&
+        Number.isFinite(Date.parse(value.timestamp)) &&
+        (value.parentSession === undefined || typeof value.parentSession === "string"));
+}
+export function isJsonlStorageHeader(value) {
+    return (isRecord(value) &&
+        value.kind === "header" &&
+        value.v === JSONL_FORMAT_VERSION &&
+        typeof value.id === "string" &&
+        typeof value.cwd === "string" &&
+        isSafeIntegerAtLeast(value.storageVersion, 1) &&
+        isSafeIntegerAtLeast(value.createdAt, 0) &&
+        (value.nextSeq === undefined || isSafeIntegerAtLeast(value.nextSeq, 1)) &&
+        (value.parentSessionId === undefined || typeof value.parentSessionId === "string") &&
+        (value.legacyParentSessionPath === undefined || typeof value.legacyParentSessionPath === "string"));
+}
+export function parseJsonlSessionHeader(line) {
     let value;
     try {
         value = JSON.parse(line);
     }
     catch (error) {
-        throw new JsonlDecodeError("syntax", "is not valid JSON", error instanceof Error ? error : undefined);
-    }
-    if (!isObject(value))
-        throw new JsonlDecodeError("schema", "is not a JSON object");
-    return value;
-}
-function requireString(value, field) {
-    if (typeof value !== "string")
-        throw new JsonlDecodeError("schema", `has invalid ${field}`);
-    return value;
-}
-function requireSequence(value) {
-    if (!Number.isSafeInteger(value) || value <= 0) {
-        throw new JsonlDecodeError("schema", "has invalid seq");
-    }
-    return value;
-}
-function requireTimestamp(value) {
-    if (!Number.isSafeInteger(value) || value < 0) {
-        throw new JsonlDecodeError("schema", "has invalid timestamp");
-    }
-    return value;
-}
-function requireNullableId(value, field) {
-    if (value !== null && typeof value !== "string") {
-        throw new JsonlDecodeError("schema", `has invalid ${field}`);
-    }
-    return value;
-}
-function decodeHeader(line) {
-    const value = parseObject(line);
-    if (value.kind !== "header")
-        throw new JsonlDecodeError("schema", "is not a header");
-    if (value.version !== 4)
-        throw new JsonlDecodeError("schema", "has unsupported session version");
-    const parentSessionId = value.parentSessionId;
-    if (parentSessionId !== undefined && typeof parentSessionId !== "string") {
-        throw new JsonlDecodeError("schema", "has invalid parentSessionId");
-    }
-    const legacyParentSessionPath = value.legacyParentSessionPath;
-    if (legacyParentSessionPath !== undefined && typeof legacyParentSessionPath !== "string") {
-        throw new JsonlDecodeError("schema", "has invalid legacyParentSessionPath");
-    }
-    if (parentSessionId !== undefined && legacyParentSessionPath !== undefined) {
-        throw new JsonlDecodeError("schema", "has both parentSessionId and legacyParentSessionPath");
-    }
-    const metadataValue = value.metadata;
-    if (metadataValue !== undefined && !isObject(metadataValue)) {
-        throw new JsonlDecodeError("schema", "has invalid metadata");
-    }
-    const metadata = metadataValue;
-    return {
-        kind: "header",
-        version: 4,
-        id: requireString(value.id, "id"),
-        createdAt: requireTimestamp(value.createdAt),
-        cwd: requireString(value.cwd, "cwd"),
-        parentSessionId,
-        legacyParentSessionPath,
-        metadata,
-    };
-}
-export function parseHeader(line) {
-    try {
-        return ok(decodeHeader(line));
-    }
-    catch (error) {
-        if (error instanceof JsonlDecodeError)
-            return err(error);
-        throw error;
-    }
-}
-export function encodeHeader(header) {
-    return `${JSON.stringify(header)}\n`;
-}
-export function metadataFromHeader(header, path, modifiedAt) {
-    return {
-        id: header.id,
-        createdAt: header.createdAt,
-        cwd: header.cwd,
-        path,
-        modifiedAt,
-        sourceFormat: 4,
-        ...(header.parentSessionId === undefined ? {} : { parentSessionId: header.parentSessionId }),
-        ...(header.legacyParentSessionPath === undefined
-            ? {}
-            : { legacyParentSessionPath: header.legacyParentSessionPath }),
-        ...(header.metadata === undefined ? {} : { metadata: header.metadata }),
-    };
-}
-function parseEntryMutation(value, seq) {
-    const lane = value.lane === undefined ? undefined : requireString(value.lane, "lane");
-    const id = requireString(value.id, "id");
-    const type = requireString(value.type, "entry type");
-    if (!ENTRY_TYPES.has(type)) {
-        throw new JsonlDecodeError("schema", `has unknown entry type ${type}`);
-    }
-    const parentId = requireNullableId(value.parentId, "parentId");
-    const timestamp = requireTimestamp(value.timestamp);
-    if (type === "custom")
-        requireString(value.customType, "customType");
-    const { kind: _kind, lane: _lane, ...entryFields } = value;
-    const entry = { ...entryFields, id, type, parentId, seq, timestamp };
-    return lane === undefined ? { kind: "entry", entry } : { kind: "entry", lane, entry };
-}
-function parseRecordMutation(value, seq) {
-    const id = requireString(value.id, "id");
-    const lane = requireString(value.lane, "lane");
-    const type = requireString(value.type, "record type");
-    if (!RECORD_TYPES.has(type)) {
-        throw new JsonlDecodeError("schema", `has unknown record type ${type}`);
-    }
-    const timestamp = requireTimestamp(value.timestamp);
-    if (type === "operation_started") {
-        if (!isObject(value.intent))
-            throw new JsonlDecodeError("schema", "has invalid intent");
-        const operationKind = requireString(value.intent.kind, "operation kind");
-        if (!OPERATION_KINDS.has(operationKind)) {
-            throw new JsonlDecodeError("schema", `has unknown operation kind ${operationKind}`);
-        }
-    }
-    if (type === "operation_finished")
-        requireString(value.runId, "runId");
-    const { kind: _kind, ...recordFields } = value;
-    return {
-        kind: "record",
-        record: { ...recordFields, id, lane, type, seq, timestamp },
-    };
-}
-function parseLaneMutation(value, seq) {
-    return {
-        kind: "lane",
-        seq,
-        lane: requireString(value.lane, "lane"),
-        leafId: requireNullableId(value.leafId, "leafId"),
-    };
-}
-function parseFactMutation(value, seq) {
-    if (value.fact === "name") {
-        if (value.name !== undefined && typeof value.name !== "string") {
-            throw new JsonlDecodeError("schema", "has invalid name");
-        }
-        return { kind: "fact", seq, fact: "name", name: value.name };
-    }
-    if (value.fact === "label") {
-        if (value.label !== undefined && typeof value.label !== "string") {
-            throw new JsonlDecodeError("schema", "has invalid label");
-        }
-        return {
-            kind: "fact",
-            seq,
-            fact: "label",
-            targetId: requireString(value.targetId, "targetId"),
-            label: value.label,
-        };
-    }
-    throw new JsonlDecodeError("schema", "has unknown fact type");
-}
-function decodeMutation(line) {
-    const value = parseObject(line);
-    const seq = requireSequence(value.seq);
-    switch (value.kind) {
-        case "entry":
-            return parseEntryMutation(value, seq);
-        case "record":
-            return parseRecordMutation(value, seq);
-        case "lane":
-            return parseLaneMutation(value, seq);
-        case "fact":
-            return parseFactMutation(value, seq);
-        default:
-            throw new JsonlDecodeError("schema", "has unknown mutation kind");
-    }
-}
-export function parseMutation(line) {
-    try {
-        return ok(decodeMutation(line));
-    }
-    catch (error) {
-        if (error instanceof JsonlDecodeError)
-            return err(error);
-        throw error;
-    }
-}
-export function encodeMutation(mutation) {
-    switch (mutation.kind) {
-        case "entry":
-            return `${JSON.stringify({ kind: "entry", lane: mutation.lane, ...mutation.entry })}\n`;
-        case "record":
-            return `${JSON.stringify({ kind: "record", ...mutation.record })}\n`;
-        case "lane":
-            return `${JSON.stringify(mutation)}\n`;
-        case "fact":
-            return `${JSON.stringify(mutation)}\n`;
+        return err(new Error("Invalid JSONL session header: not valid JSON", { cause: error }));
     }
+    if (isJsonlStorageHeader(value))
+        return ok({ format: "v4", header: value });
+    if (isLegacyV3SessionHeader(value))
+        return ok({ format: "v3-legacy", header: value });
+    return err(new Error("Unsupported JSONL session header"));
 }
 //# sourceMappingURL=codec.js.map

package/dist/harness/session/jsonl/codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../../../src/harness/session/jsonl/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAgB;IAC1C,SAAS;IACT,cAAc;IACd,uBAAuB;IACvB,sBAAsB;IACtB,qBAAqB;IACrB,YAAY;IACZ,gBAAgB;IAChB,QAAQ;CACR,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAqB;IAChD,mBAAmB;IACnB,iBAAiB;IACjB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,OAAO;CACP,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;AAErE,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAChC,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,eAAe,KAAK,EAAE,CAAC,CAAC;IAC5F,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACtC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAe,CAAC;AACxB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAe,CAAC;AACxB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,KAAa;IACvD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,eAAe,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAsB,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC;IACjG,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,IAAI,eAAe,KAAK,SAAS,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC1E,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,uBAAuB,GAAG,KAAK,CAAC,uBAAuB,CAAC;IAC9D,IAAI,uBAAuB,KAAK,SAAS,IAAI,OAAO,uBAAuB,KAAK,QAAQ,EAAE,CAAC;QAC1F,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,qCAAqC,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,eAAe,KAAK,SAAS,IAAI,uBAAuB,KAAK,SAAS,EAAE,CAAC;QAC5E,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,sDAAsD,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC;IACrC,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,QAAQ,GAAG,aAA0C,CAAC;IAC5D,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC;QACV,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC;QACjC,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5C,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC;QACpC,eAAe;QACf,uBAAuB;QACvB,QAAQ;KACR,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,IAAI,CAAC;QACJ,OAAO,EAAE,CAAkC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,gBAAgB;YAAE,OAAO,GAAG,CAAkC,KAAK,CAAC,CAAC;QAC1F,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB;IACjD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAqB,EAAE,IAAY,EAAE,UAAkB;IACzF,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI;QACJ,UAAU;QACV,YAAY,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5F,GAAG,CAAC,MAAM,CAAC,uBAAuB,KAAK,SAAS;YAC/C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,uBAAuB,EAAE,MAAM,CAAC,uBAAuB,EAAE,CAAC;QAC/D,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;KACvE,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA8B,EAAE,GAAW;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtF,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAqB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,QAAQ;QAAE,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACrE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC;IAC3D,MAAM,KAAK,GAAG,EAAE,GAAG,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAsB,CAAC;IACzF,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,mBAAmB,CAC3B,KAA8B,EAC9B,GAAW;IAEX,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAA0B,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,2BAA2B,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QACxF,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACzE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,8BAA8B,aAAa,EAAE,CAAC,CAAC;QACrF,CAAC;IACF,CAAC;IACD,IAAI,IAAI,KAAK,oBAAoB;QAAE,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC;IAC/C,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,EAAE,GAAG,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAA2B;KACpF,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA8B,EAAE,GAAW;IACrE,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,GAAG;QACH,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;QACvC,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;KACjD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA8B,EAAE,GAAW;IACrE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO;YACN,IAAI,EAAE,MAAM;YACZ,GAAG;YACH,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;YACnD,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACX,OAAO,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvC,KAAK,QAAQ;YACZ,OAAO,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,KAAK,MAAM;YACV,OAAO,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtC,KAAK,MAAM;YACV,OAAO,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtC;YACC,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;IACpE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,IAAI,CAAC;QACJ,OAAO,EAAE,CAAoC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,gBAAgB;YAAE,OAAO,GAAG,CAAoC,KAAK,CAAC,CAAC;QAC5F,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAyB;IACvD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,OAAO;YACX,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC;QACzF,KAAK,QAAQ;YACZ,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QACtE,KAAK,MAAM;YACV,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QACxC,KAAK,MAAM;YACV,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;IACzC,CAAC;AACF,CAAC","sourcesContent":["import { err, ok, type Result } from \"../../types.ts\";\nimport type { SessionMutation } from \"../state.ts\";\nimport type { Entry, LaneRecord } from \"../types.ts\";\nimport { JsonlDecodeError } from \"./errors.ts\";\nimport type { JsonlSessionMetadata, JsonlV4Header } from \"./types.ts\";\n\nconst ENTRY_TYPES = new Set<Entry[\"type\"]>([\n\t\"message\",\n\t\"model_change\",\n\t\"thinking_level_change\",\n\t\"configuration_update\",\n\t\"active_tools_change\",\n\t\"compaction\",\n\t\"branch_summary\",\n\t\"custom\",\n]);\nconst RECORD_TYPES = new Set<LaneRecord[\"type\"]>([\n\t\"operation_started\",\n\t\"abort_requested\",\n\t\"operation_finished\",\n\t\"step_attempt\",\n\t\"tool_started\",\n\t\"queue_enqueued\",\n\t\"queue_cancelled\",\n\t\"write_deferred\",\n\t\"usage\",\n]);\nconst OPERATION_KINDS = new Set([\"run\", \"compaction\", \"navigation\"]);\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction parseObject(line: string): Record<string, unknown> {\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(line);\n\t} catch (error) {\n\t\tthrow new JsonlDecodeError(\"syntax\", \"is not valid JSON\", error instanceof Error ? error : undefined);\n\t}\n\tif (!isObject(value)) throw new JsonlDecodeError(\"schema\", \"is not a JSON object\");\n\treturn value;\n}\n\nfunction requireString(value: unknown, field: string): string {\n\tif (typeof value !== \"string\") throw new JsonlDecodeError(\"schema\", `has invalid ${field}`);\n\treturn value;\n}\n\nfunction requireSequence(value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) <= 0) {\n\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid seq\");\n\t}\n\treturn value as number;\n}\n\nfunction requireTimestamp(value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid timestamp\");\n\t}\n\treturn value as number;\n}\n\nfunction requireNullableId(value: unknown, field: string): string | null {\n\tif (value !== null && typeof value !== \"string\") {\n\t\tthrow new JsonlDecodeError(\"schema\", `has invalid ${field}`);\n\t}\n\treturn value as string | null;\n}\n\nfunction decodeHeader(line: string): JsonlV4Header {\n\tconst value = parseObject(line);\n\tif (value.kind !== \"header\") throw new JsonlDecodeError(\"schema\", \"is not a header\");\n\tif (value.version !== 4) throw new JsonlDecodeError(\"schema\", \"has unsupported session version\");\n\tconst parentSessionId = value.parentSessionId;\n\tif (parentSessionId !== undefined && typeof parentSessionId !== \"string\") {\n\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid parentSessionId\");\n\t}\n\tconst legacyParentSessionPath = value.legacyParentSessionPath;\n\tif (legacyParentSessionPath !== undefined && typeof legacyParentSessionPath !== \"string\") {\n\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid legacyParentSessionPath\");\n\t}\n\tif (parentSessionId !== undefined && legacyParentSessionPath !== undefined) {\n\t\tthrow new JsonlDecodeError(\"schema\", \"has both parentSessionId and legacyParentSessionPath\");\n\t}\n\tconst metadataValue = value.metadata;\n\tif (metadataValue !== undefined && !isObject(metadataValue)) {\n\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid metadata\");\n\t}\n\tconst metadata = metadataValue as JsonlV4Header[\"metadata\"];\n\treturn {\n\t\tkind: \"header\",\n\t\tversion: 4,\n\t\tid: requireString(value.id, \"id\"),\n\t\tcreatedAt: requireTimestamp(value.createdAt),\n\t\tcwd: requireString(value.cwd, \"cwd\"),\n\t\tparentSessionId,\n\t\tlegacyParentSessionPath,\n\t\tmetadata,\n\t};\n}\n\nexport function parseHeader(line: string): Result<JsonlV4Header, JsonlDecodeError> {\n\ttry {\n\t\treturn ok<JsonlV4Header, JsonlDecodeError>(decodeHeader(line));\n\t} catch (error) {\n\t\tif (error instanceof JsonlDecodeError) return err<JsonlV4Header, JsonlDecodeError>(error);\n\t\tthrow error;\n\t}\n}\n\nexport function encodeHeader(header: JsonlV4Header): string {\n\treturn `${JSON.stringify(header)}\\n`;\n}\n\nexport function metadataFromHeader(header: JsonlV4Header, path: string, modifiedAt: number): JsonlSessionMetadata {\n\treturn {\n\t\tid: header.id,\n\t\tcreatedAt: header.createdAt,\n\t\tcwd: header.cwd,\n\t\tpath,\n\t\tmodifiedAt,\n\t\tsourceFormat: 4,\n\t\t...(header.parentSessionId === undefined ? {} : { parentSessionId: header.parentSessionId }),\n\t\t...(header.legacyParentSessionPath === undefined\n\t\t\t? {}\n\t\t\t: { legacyParentSessionPath: header.legacyParentSessionPath }),\n\t\t...(header.metadata === undefined ? {} : { metadata: header.metadata }),\n\t};\n}\n\nfunction parseEntryMutation(value: Record<string, unknown>, seq: number): Extract<SessionMutation, { kind: \"entry\" }> {\n\tconst lane = value.lane === undefined ? undefined : requireString(value.lane, \"lane\");\n\tconst id = requireString(value.id, \"id\");\n\tconst type = requireString(value.type, \"entry type\");\n\tif (!ENTRY_TYPES.has(type as Entry[\"type\"])) {\n\t\tthrow new JsonlDecodeError(\"schema\", `has unknown entry type ${type}`);\n\t}\n\tconst parentId = requireNullableId(value.parentId, \"parentId\");\n\tconst timestamp = requireTimestamp(value.timestamp);\n\tif (type === \"custom\") requireString(value.customType, \"customType\");\n\tconst { kind: _kind, lane: _lane, ...entryFields } = value;\n\tconst entry = { ...entryFields, id, type, parentId, seq, timestamp } as unknown as Entry;\n\treturn lane === undefined ? { kind: \"entry\", entry } : { kind: \"entry\", lane, entry };\n}\n\nfunction parseRecordMutation(\n\tvalue: Record<string, unknown>,\n\tseq: number,\n): Extract<SessionMutation, { kind: \"record\" }> {\n\tconst id = requireString(value.id, \"id\");\n\tconst lane = requireString(value.lane, \"lane\");\n\tconst type = requireString(value.type, \"record type\");\n\tif (!RECORD_TYPES.has(type as LaneRecord[\"type\"])) {\n\t\tthrow new JsonlDecodeError(\"schema\", `has unknown record type ${type}`);\n\t}\n\tconst timestamp = requireTimestamp(value.timestamp);\n\tif (type === \"operation_started\") {\n\t\tif (!isObject(value.intent)) throw new JsonlDecodeError(\"schema\", \"has invalid intent\");\n\t\tconst operationKind = requireString(value.intent.kind, \"operation kind\");\n\t\tif (!OPERATION_KINDS.has(operationKind)) {\n\t\t\tthrow new JsonlDecodeError(\"schema\", `has unknown operation kind ${operationKind}`);\n\t\t}\n\t}\n\tif (type === \"operation_finished\") requireString(value.runId, \"runId\");\n\tconst { kind: _kind, ...recordFields } = value;\n\treturn {\n\t\tkind: \"record\",\n\t\trecord: { ...recordFields, id, lane, type, seq, timestamp } as unknown as LaneRecord,\n\t};\n}\n\nfunction parseLaneMutation(value: Record<string, unknown>, seq: number): Extract<SessionMutation, { kind: \"lane\" }> {\n\treturn {\n\t\tkind: \"lane\",\n\t\tseq,\n\t\tlane: requireString(value.lane, \"lane\"),\n\t\tleafId: requireNullableId(value.leafId, \"leafId\"),\n\t};\n}\n\nfunction parseFactMutation(value: Record<string, unknown>, seq: number): Extract<SessionMutation, { kind: \"fact\" }> {\n\tif (value.fact === \"name\") {\n\t\tif (value.name !== undefined && typeof value.name !== \"string\") {\n\t\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid name\");\n\t\t}\n\t\treturn { kind: \"fact\", seq, fact: \"name\", name: value.name };\n\t}\n\tif (value.fact === \"label\") {\n\t\tif (value.label !== undefined && typeof value.label !== \"string\") {\n\t\t\tthrow new JsonlDecodeError(\"schema\", \"has invalid label\");\n\t\t}\n\t\treturn {\n\t\t\tkind: \"fact\",\n\t\t\tseq,\n\t\t\tfact: \"label\",\n\t\t\ttargetId: requireString(value.targetId, \"targetId\"),\n\t\t\tlabel: value.label,\n\t\t};\n\t}\n\tthrow new JsonlDecodeError(\"schema\", \"has unknown fact type\");\n}\n\nfunction decodeMutation(line: string): SessionMutation {\n\tconst value = parseObject(line);\n\tconst seq = requireSequence(value.seq);\n\tswitch (value.kind) {\n\t\tcase \"entry\":\n\t\t\treturn parseEntryMutation(value, seq);\n\t\tcase \"record\":\n\t\t\treturn parseRecordMutation(value, seq);\n\t\tcase \"lane\":\n\t\t\treturn parseLaneMutation(value, seq);\n\t\tcase \"fact\":\n\t\t\treturn parseFactMutation(value, seq);\n\t\tdefault:\n\t\t\tthrow new JsonlDecodeError(\"schema\", \"has unknown mutation kind\");\n\t}\n}\n\nexport function parseMutation(line: string): Result<SessionMutation, JsonlDecodeError> {\n\ttry {\n\t\treturn ok<SessionMutation, JsonlDecodeError>(decodeMutation(line));\n\t} catch (error) {\n\t\tif (error instanceof JsonlDecodeError) return err<SessionMutation, JsonlDecodeError>(error);\n\t\tthrow error;\n\t}\n}\n\nexport function encodeMutation(mutation: SessionMutation): string {\n\tswitch (mutation.kind) {\n\t\tcase \"entry\":\n\t\t\treturn `${JSON.stringify({ kind: \"entry\", lane: mutation.lane, ...mutation.entry })}\\n`;\n\t\tcase \"record\":\n\t\t\treturn `${JSON.stringify({ kind: \"record\", ...mutation.record })}\\n`;\n\t\tcase \"lane\":\n\t\t\treturn `${JSON.stringify(mutation)}\\n`;\n\t\tcase \"fact\":\n\t\t\treturn `${JSON.stringify(mutation)}\\n`;\n\t}\n}\n"]}
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../../../src/harness/session/jsonl/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AAW3E,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,OAAe;IAC5D,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,OAAO,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,OAAO,CACN,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,IAAI,KAAK,SAAS;QACxB,KAAK,CAAC,OAAO,KAAK,CAAC;QACnB,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAC9E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAClD,OAAO,CACN,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,IAAI,KAAK,QAAQ;QACvB,KAAK,CAAC,CAAC,KAAK,oBAAoB;QAChC,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,oBAAoB,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;QAC7C,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC;QAClF,CAAC,KAAK,CAAC,uBAAuB,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,uBAAuB,KAAK,QAAQ,CAAC,CAClG,CAAC;AACH,CAAC;AAMD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACJ,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,8CAA8C,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,oBAAoB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,IAAI,uBAAuB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { err, ok, type Result } from \"../../types.ts\";\nimport { JSONL_FORMAT_VERSION, type JsonlStorageHeader } from \"./types.ts\";\n\nexport interface LegacyV3SessionHeader {\n\ttype: \"session\";\n\tversion: 3;\n\tid: string;\n\ttimestamp: string;\n\tcwd: string;\n\tparentSession?: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isSafeIntegerAtLeast(value: unknown, minimum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= minimum;\n}\n\nexport function isLegacyV3SessionHeader(value: unknown): value is LegacyV3SessionHeader {\n\treturn (\n\t\tisRecord(value) &&\n\t\tvalue.type === \"session\" &&\n\t\tvalue.version === 3 &&\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.cwd === \"string\" &&\n\t\ttypeof value.timestamp === \"string\" &&\n\t\tNumber.isFinite(Date.parse(value.timestamp)) &&\n\t\t(value.parentSession === undefined || typeof value.parentSession === \"string\")\n\t);\n}\n\nexport function isJsonlStorageHeader(value: unknown): value is JsonlStorageHeader {\n\treturn (\n\t\tisRecord(value) &&\n\t\tvalue.kind === \"header\" &&\n\t\tvalue.v === JSONL_FORMAT_VERSION &&\n\t\ttypeof value.id === \"string\" &&\n\t\ttypeof value.cwd === \"string\" &&\n\t\tisSafeIntegerAtLeast(value.storageVersion, 1) &&\n\t\tisSafeIntegerAtLeast(value.createdAt, 0) &&\n\t\t(value.nextSeq === undefined || isSafeIntegerAtLeast(value.nextSeq, 1)) &&\n\t\t(value.parentSessionId === undefined || typeof value.parentSessionId === \"string\") &&\n\t\t(value.legacyParentSessionPath === undefined || typeof value.legacyParentSessionPath === \"string\")\n\t);\n}\n\nexport type JsonlParsedSessionHeader =\n\t| { format: \"v4\"; header: JsonlStorageHeader }\n\t| { format: \"v3-legacy\"; header: LegacyV3SessionHeader };\n\nexport function parseJsonlSessionHeader(line: string): Result<JsonlParsedSessionHeader, Error> {\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(line);\n\t} catch (error) {\n\t\treturn err(new Error(\"Invalid JSONL session header: not valid JSON\", { cause: error }));\n\t}\n\tif (isJsonlStorageHeader(value)) return ok({ format: \"v4\", header: value });\n\tif (isLegacyV3SessionHeader(value)) return ok({ format: \"v3-legacy\", header: value });\n\treturn err(new Error(\"Unsupported JSONL session header\"));\n}\n"]}

package/dist/harness/session/jsonl/fork.d.ts

@@ -0,0 +1,38 @@
+import type { Context } from "../../context.ts";
+import type { FileSystem } from "../../types.ts";
+import type { ForkOptions } from "../types.ts";
+import type { LegacyV3Source } from "./legacy-v3.ts";
+import { type JsonlStorageHeader } from "./types.ts";
+interface JsonlForkSourceMetadata {
+    id: string;
+    cwd: string;
+    path: string;
+}
+/** Prepared fork input: format-4 file metadata or an already-normalized legacy source. */
+export type JsonlForkInput = {
+    kind: "open";
+    metadata: JsonlForkSourceMetadata;
+    nextSeq: number;
+} | {
+    kind: "closed";
+    metadata: JsonlForkSourceMetadata;
+} | {
+    kind: "legacy-v3";
+    normalized: LegacyV3Source;
+};
+/**
+ * Index the source, validate the requested fork, and stream selected entries and current state
+ * into an atomically published format-4 destination without modifying the source.
+ * Preserve copied sequences and the source's nextSeq while excluding usage and open-operation state.
+ * Source files must not be replaced or edited between passes; later append-only writes are excluded
+ * by the captured sequence boundary or legacy record count. Does not open the destination Session.
+ */
+export declare function runJsonlFork(options: {
+    input: JsonlForkInput;
+    fileSystem: FileSystem;
+    destinationPath: string;
+    destinationHeader: Omit<JsonlStorageHeader, "nextSeq">;
+    fork: ForkOptions;
+}, context: Context): Promise<void>;
+export {};
+//# sourceMappingURL=fork.d.ts.map

package/dist/harness/session/jsonl/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../../../src/harness/session/jsonl/fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAQjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5E,UAAU,uBAAuB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AA4LD,0FAA0F;AAC1F,MAAM,MAAM,cAAc,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,uBAAuB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,cAAc,CAAA;CAAE,CAAC;AA6ErD;;;;;;GAMG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE;IACR,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,EAAE,WAAW,CAAC;CAClB,EACD,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/harness/session/jsonl/fork.js

@@ -0,0 +1,266 @@
+import { projectForkCurrentStateWrite, selectBranchFork } from "../fork-policy.js";
+import { fileValue, parseJsonlTransaction, publishJsonl, readJsonlHeader } from "./io.js";
+import { JSONL_STORAGE_VERSION } from "./types.js";
+function physicalKey(namespace, key) {
+    return `${namespace}\u0000${key}`;
+}
+async function readJsonlForkHeader(reader, source, context) {
+    const parsed = await readJsonlHeader(reader, source.path, context);
+    if (parsed.format !== "v4") {
+        throw new Error(`Invalid JSONL storage ${source.path}: expected format 4 header`);
+    }
+    const header = parsed.header;
+    if (header.id !== source.id || header.cwd !== source.cwd) {
+        throw new Error(`Session identity does not match header: ${source.id}`);
+    }
+    if (header.storageVersion !== JSONL_STORAGE_VERSION) {
+        throw new Error(`Session ${source.id} uses unsupported storage version ${header.storageVersion}`);
+    }
+    return header;
+}
+function reachesForkBoundary(writes, stopBeforeSeq) {
+    if (stopBeforeSeq === undefined || writes.length === 0)
+        return false;
+    const first = writes[0];
+    const last = writes.at(-1);
+    if (first.seq >= stopBeforeSeq)
+        return true;
+    if (last.seq >= stopBeforeSeq) {
+        throw new Error(`JSONL transaction crosses fork sequence boundary ${stopBeforeSeq}`);
+    }
+    return false;
+}
+/** Read complete transactions after the header, never splitting a transaction at the sequence boundary. */
+async function* readJsonlForkTransactions(reader, path, stopBeforeSeq, context) {
+    while (true) {
+        const line = fileValue(await reader.readLine(context), `Failed to read JSONL fork source ${path}`);
+        if (line === undefined || !line.terminated)
+            break;
+        const writes = parseJsonlTransaction(line.text);
+        if (reachesForkBoundary(writes, stopBeforeSeq))
+            break;
+        yield writes;
+    }
+}
+class JsonlForkIndex {
+    constructor() {
+        this.currentScalarSeqs = new Map();
+        this.branchTips = new Map();
+        this.firstSurvivingListSeqs = new Map();
+        this.entryParents = new Map();
+        this.copiedEntryIds = new Set();
+        this.laneConfigs = new Set();
+        this.laneStates = new Set();
+    }
+    applyEntry(id, parentId) {
+        this.entryParents.set(id, parentId);
+    }
+    applyWrites(writes) {
+        for (const write of writes) {
+            switch (write.kind) {
+                case "entry":
+                    this.applyEntry(write.id, write.parentId);
+                    break;
+                case "value": {
+                    const key = physicalKey(write.namespace, write.key);
+                    if (write.op === "delete") {
+                        this.currentScalarSeqs.delete(key);
+                    }
+                    else {
+                        this.currentScalarSeqs.set(key, write.seq);
+                    }
+                    this.applyLaneValue(write);
+                    break;
+                }
+                case "list": {
+                    const key = physicalKey(write.namespace, write.key);
+                    if (write.op === "delete")
+                        this.firstSurvivingListSeqs.delete(key);
+                    else if (!this.firstSurvivingListSeqs.has(key))
+                        this.firstSurvivingListSeqs.set(key, write.seq);
+                    break;
+                }
+                case "usage":
+                    break;
+            }
+        }
+    }
+    applyLaneValue(write) {
+        const present = write.op === "set";
+        switch (write.namespace) {
+            case "pi.branch.tip":
+                if (present)
+                    this.branchTips.set(write.key, write.value);
+                else
+                    this.branchTips.delete(write.key);
+                break;
+            case "pi.lane.config":
+                if (present)
+                    this.laneConfigs.add(write.key);
+                else
+                    this.laneConfigs.delete(write.key);
+                break;
+            case "pi.lane.state":
+                if (present)
+                    this.laneStates.add(write.key);
+                else
+                    this.laneStates.delete(write.key);
+                break;
+        }
+    }
+    getBranchTip(branch) {
+        return this.branchTips.get(branch);
+    }
+    hasCompleteLane(branch) {
+        return this.laneConfigs.has(branch) && this.laneStates.has(branch);
+    }
+    getCurrentScalarSeq(namespace, key) {
+        return this.currentScalarSeqs.get(physicalKey(namespace, key));
+    }
+    isSurvivingListElement(namespace, key, seq) {
+        const firstSeq = this.firstSurvivingListSeqs.get(physicalKey(namespace, key));
+        return firstSeq !== undefined && seq >= firstSeq;
+    }
+    getParent(entryId) {
+        return this.entryParents.get(entryId);
+    }
+    selectEntry(entryId) {
+        this.copiedEntryIds.add(entryId);
+    }
+    isEntrySelected(entryId) {
+        return this.copiedEntryIds.has(entryId);
+    }
+}
+/**
+ * Validate the source lanes and return the fork plan.
+ *
+ * Branch scope updates JsonlForkIndex's selected entries via index.selectEntry(): it selects the
+ * destination tip and its ancestors after validating entryId and applying "at"/"before". The plan
+ * records the branch name and destination tip; the copy pass uses the index to filter entries and labels.
+ *
+ * Tree scope leaves the index's selected entries unchanged because the copy pass keeps every entry.
+ * Both formats use the same indexed metadata; this function performs no file I/O.
+ */
+function selectJsonlFork(index, options) {
+    if (options.scope === "tree")
+        return { scope: "tree" };
+    const plan = selectBranchFork(options, {
+        tip: index.getBranchTip(options.branch),
+        getParent: (entryId) => index.getParent(entryId),
+        selectEntry: (entryId) => index.selectEntry(entryId),
+    });
+    if (!index.hasCompleteLane(options.branch)) {
+        throw new Error(`Source branch ${JSON.stringify(options.branch)} is not a configured AgentLane`);
+    }
+    return plan;
+}
+function projectJsonlForkWrite(write, index, plan, isEntryCopied) {
+    switch (write.kind) {
+        case "entry":
+            return isEntryCopied(write.id) ? write : undefined;
+        case "value":
+            if (write.op !== "set")
+                return undefined;
+            if (index.getCurrentScalarSeq(write.namespace, write.key) !== write.seq)
+                return undefined;
+            return projectForkCurrentStateWrite(write, plan, isEntryCopied);
+        case "list":
+            if (write.op !== "append")
+                return undefined;
+            if (!index.isSurvivingListElement(write.namespace, write.key, write.seq))
+                return undefined;
+            return projectForkCurrentStateWrite(write, plan, isEntryCopied);
+        case "usage":
+            return undefined;
+    }
+}
+/**
+ * Build the index used to select branch ancestry and identify current scalar/list writes.
+ * Retains entry parent links, current-row sequences, and lane inventory, not entry payloads.
+ * Returns the index and the source's nextSeq high-water mark; no destination writes occur here.
+ *
+ * V3: LegacyV3Source already scanned the file and assigned normalized IDs/sequences. Copy its
+ * in-memory entry structures and derived values without reopening the file or calling writes(),
+ * which would unnecessarily parse payloads and reconstruct compaction tails before fork selection.
+ *
+ * V4: Open the source file and fold complete transactions into the index. For an open source,
+ * stop at the captured commit-queue sequence boundary. For a closed source, scan to EOF or a torn
+ * final line and derive nextSeq from the header and highest complete write sequence.
+ * The later copy pass reopens the source file in both formats and emits only selected writes.
+ */
+async function indexForkInput(input, fileSystem, context) {
+    const index = new JsonlForkIndex();
+    if (input.kind === "legacy-v3") {
+        for (const entry of input.normalized.entryStructures())
+            index.applyEntry(entry.id, entry.parentId);
+        index.applyWrites(input.normalized.values);
+        return { index, nextSeq: input.normalized.nextSeq };
+    }
+    const reader = fileValue(await fileSystem.openTextLineReader(input.metadata.path, context), `Failed to open JSONL fork source ${input.metadata.path}`);
+    try {
+        const header = await readJsonlForkHeader(reader, input.metadata, context);
+        const stopBeforeSeq = input.kind === "open" ? input.nextSeq : undefined;
+        let highestCompleteSeq = 0;
+        for await (const writes of readJsonlForkTransactions(reader, input.metadata.path, stopBeforeSeq, context)) {
+            index.applyWrites(writes);
+            if (writes.length !== 0)
+                highestCompleteSeq = writes.at(-1).seq;
+        }
+        return {
+            index,
+            nextSeq: input.kind === "open" ? input.nextSeq : Math.max(header.nextSeq ?? 1, highestCompleteSeq + 1),
+        };
+    }
+    finally {
+        await reader.close(context);
+    }
+}
+/** Yield source writes; the caller owns final projection and filtering. */
+async function* streamForkWrites(input, fileSystem, stopBeforeSeq, isEntryCopied, context) {
+    if (input.kind === "legacy-v3") {
+        // V3 filters early to avoid rereading messages and reconstructing unselected compaction tails.
+        // V4 already stores complete payloads, so it streams all captured writes below.
+        // Both formats still pass through projectJsonlForkWrite() for final filtering and transformation.
+        yield* input.normalized.writes(context, isEntryCopied);
+        return;
+    }
+    const reader = fileValue(await fileSystem.openTextLineReader(input.metadata.path, context), `Failed to open JSONL fork source ${input.metadata.path}`);
+    try {
+        await readJsonlForkHeader(reader, input.metadata, context);
+        for await (const writes of readJsonlForkTransactions(reader, input.metadata.path, stopBeforeSeq, context)) {
+            yield* writes;
+        }
+    }
+    finally {
+        await reader.close(context);
+    }
+}
+/**
+ * Index the source, validate the requested fork, and stream selected entries and current state
+ * into an atomically published format-4 destination without modifying the source.
+ * Preserve copied sequences and the source's nextSeq while excluding usage and open-operation state.
+ * Source files must not be replaced or edited between passes; later append-only writes are excluded
+ * by the captured sequence boundary or legacy record count. Does not open the destination Session.
+ */
+export async function runJsonlFork(options, context) {
+    const { index, nextSeq } = await indexForkInput(options.input, options.fileSystem, context);
+    let fork = options.fork;
+    if (options.input.kind === "legacy-v3" && fork.scope === "branch" && fork.entryId !== undefined) {
+        fork = { ...fork, entryId: options.input.normalized.translateForkEntryId(fork.entryId) };
+    }
+    const plan = selectJsonlFork(index, fork);
+    const isEntryCopied = (entryId) => {
+        if (plan.scope === "tree")
+            return true;
+        return index.isEntrySelected(entryId);
+    };
+    await publishJsonl(options.fileSystem, options.destinationPath, { ...options.destinationHeader, nextSeq }, context, async (append) => {
+        const sourceWrites = streamForkWrites(options.input, options.fileSystem, nextSeq, isEntryCopied, context);
+        for await (const write of sourceWrites) {
+            const projected = projectJsonlForkWrite(write, index, plan, isEntryCopied);
+            if (projected !== undefined)
+                await append([projected]);
+        }
+    });
+}
+//# sourceMappingURL=fork.js.map