@earendil-works/pi-agent-core 0.85.1 → 0.86.1

package/dist/harness/session/jsonl/legacy-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-v3.d.ts","sourceRoot":"","sources":["../../../../src/harness/session/jsonl/legacy-v3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAA+C,cAAc,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,EAAE,KAAK,qBAAqB,EAA2B,MAAM,YAAY,CAAC;AACjF,OAAO,EAGN,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,MAAM,YAAY,CAAC;AAmGpB,MAAM,WAAW,yBAAyB;IACzC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa,EAAE,KAAK,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,wBAAwB,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;AAalF,wBAAsB,0BAA0B,CAC/C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,wBAAwB,CAAC,CAanC;AAED,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAkWD,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,yBAAyB,CAoBlG","sourcesContent":["import type { ImageContent, TextContent, Usage } from \"@earendil-works/pi-ai\";\nimport { uuidv7 } from \"@earendil-works/pi-ai/utils/uuid\";\nimport type { AgentMessage, ThinkingLevel } from \"../../../types.ts\";\nimport type { Context } from \"../../context.ts\";\nimport { createBranchSummaryMessage, createCompactionSummaryMessage } from \"../../messages.ts\";\nimport type { FileSystem } from \"../../types.ts\";\nimport { addUsage, emptyUsage } from \"../../utils/usage.ts\";\nimport type { CommittedEntryWrite, CommittedValueSetWrite, CommittedWrite } from \"../commit.ts\";\nimport type { JsonValue, LaneConfiguration } from \"../types.ts\";\nimport { branchTip, entryLabel, laneConfig, laneState, sessionName } from \"../values.ts\";\nimport { type LegacyV3SessionHeader, parseJsonlSessionHeader } from \"./codec.ts\";\nimport {\n\tJSONL_FORMAT_VERSION,\n\tJSONL_STORAGE_VERSION,\n\ttype JsonlSessionMetadata,\n\ttype JsonlStorageHeader,\n} from \"./types.ts\";\n\ninterface LegacyV3EntryBase {\n\ttype: string;\n\tid: string;\n\tparentId: string | null;\n\ttimestamp: string;\n}\n\ninterface LegacyV3MessageEntry extends LegacyV3EntryBase {\n\ttype: \"message\";\n\tmessage: AgentMessage;\n}\n\ninterface LegacyV3CustomEntry extends LegacyV3EntryBase {\n\ttype: \"custom\";\n\tcustomType: string;\n\tdata?: JsonValue;\n}\n\ninterface LegacyV3CustomMessageEntry extends LegacyV3EntryBase {\n\ttype: \"custom_message\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdetails?: unknown;\n\tdisplay: boolean;\n}\n\ninterface LegacyV3BranchSummaryEntry extends LegacyV3EntryBase {\n\ttype: \"branch_summary\";\n\tfromId: string;\n\tsummary: string;\n\tdetails?: JsonValue;\n\tusage?: Usage;\n\tfromHook?: boolean;\n}\n\ninterface LegacyV3CompactionEntry extends LegacyV3EntryBase {\n\ttype: \"compaction\";\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\tdetails?: JsonValue;\n\tusage?: Usage;\n\tfromHook?: boolean;\n}\n\ninterface LegacyV3ModelChangeEntry extends LegacyV3EntryBase {\n\ttype: \"model_change\";\n\tprovider: string;\n\tmodelId: string;\n}\n\ninterface LegacyV3ThinkingLevelChangeEntry extends LegacyV3EntryBase {\n\ttype: \"thinking_level_change\";\n\tthinkingLevel: string;\n}\n\ninterface LegacyV3ActiveToolsChangeEntry extends LegacyV3EntryBase {\n\ttype: \"active_tools_change\";\n\tactiveToolNames: string[];\n}\n\ninterface LegacyV3SessionInfoEntry extends LegacyV3EntryBase {\n\ttype: \"session_info\";\n\tname?: string;\n}\n\ninterface LegacyV3LabelEntry extends LegacyV3EntryBase {\n\ttype: \"label\";\n\ttargetId: string;\n\tlabel?: string;\n}\n\ninterface ImportedCustomMessage {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdetails?: unknown;\n\tdisplay: boolean;\n\ttimestamp: number;\n}\n\ntype RetainedLegacyV3Entry =\n\t| LegacyV3MessageEntry\n\t| LegacyV3CustomEntry\n\t| LegacyV3CustomMessageEntry\n\t| LegacyV3BranchSummaryEntry\n\t| LegacyV3CompactionEntry;\n\ntype DiscardedLegacyV3Entry =\n\t| LegacyV3ModelChangeEntry\n\t| LegacyV3ThinkingLevelChangeEntry\n\t| LegacyV3ActiveToolsChangeEntry\n\t| LegacyV3SessionInfoEntry\n\t| LegacyV3LabelEntry;\n\ntype LegacyV3Entry = RetainedLegacyV3Entry | DiscardedLegacyV3Entry;\n\nexport interface NormalizedLegacyV3Records {\n\twrites: CommittedWrite[];\n\timportedUsage: Usage;\n\tnextSeq: number;\n}\n\ntype JsonlSessionMetadataBase = Omit<JsonlSessionMetadata, \"path\" | \"modifiedAt\">;\n\nasync function resolveLegacyV3ParentSessionId(\n\tfileSystem: FileSystem,\n\tparentSessionPath: string,\n\tcontext: Context,\n): Promise<string | undefined> {\n\tconst lines = await fileSystem.readTextLines(parentSessionPath, { maxLines: 1 }, context);\n\tif (!lines.ok || lines.value[0] === undefined) return undefined;\n\tconst parsed = parseJsonlSessionHeader(lines.value[0]);\n\treturn parsed.ok ? parsed.value.header.id : undefined;\n}\n\nexport async function metadataFromLegacyV3Header(\n\tfileSystem: FileSystem,\n\theader: LegacyV3SessionHeader,\n\tcontext: Context,\n): Promise<JsonlSessionMetadataBase> {\n\tconst metadata: JsonlSessionMetadataBase = {\n\t\tid: header.id,\n\t\tcreatedAt: Date.parse(header.timestamp),\n\t\tstorageVersion: JSONL_STORAGE_VERSION,\n\t\tcwd: header.cwd,\n\t};\n\tif (header.parentSession !== undefined) {\n\t\tconst parentSessionId = await resolveLegacyV3ParentSessionId(fileSystem, header.parentSession, context);\n\t\tif (parentSessionId !== undefined) metadata.parentSessionId = parentSessionId;\n\t\telse metadata.legacyParentSessionPath = header.parentSession;\n\t}\n\treturn metadata;\n}\n\nexport async function normalizeLegacyV3Header(\n\tfileSystem: FileSystem,\n\theader: LegacyV3SessionHeader,\n\tcontext: Context,\n): Promise<JsonlStorageHeader> {\n\treturn {\n\t\tv: JSONL_FORMAT_VERSION,\n\t\tkind: \"header\",\n\t\t...(await metadataFromLegacyV3Header(fileSystem, header, context)),\n\t};\n}\n\nfunction parseLegacyV3Entry(line: string, lineNumber: number): LegacyV3Entry {\n\tlet entry: LegacyV3Entry;\n\ttry {\n\t\tentry = JSON.parse(line) as LegacyV3Entry;\n\t} catch (error) {\n\t\tthrow new Error(`Invalid legacy v3 JSONL record at line ${lineNumber}: not valid JSON`, { cause: error });\n\t}\n\tconst recordType: unknown = entry.type;\n\tif (\n\t\trecordType !== \"message\" &&\n\t\trecordType !== \"custom\" &&\n\t\trecordType !== \"custom_message\" &&\n\t\trecordType !== \"branch_summary\" &&\n\t\trecordType !== \"compaction\" &&\n\t\trecordType !== \"model_change\" &&\n\t\trecordType !== \"thinking_level_change\" &&\n\t\trecordType !== \"active_tools_change\" &&\n\t\trecordType !== \"session_info\" &&\n\t\trecordType !== \"label\"\n\t) {\n\t\tthrow new Error(`Unsupported legacy v3 record type at line ${lineNumber}: ${String(recordType)}`);\n\t}\n\treturn entry;\n}\n\nfunction importedCustomMessage(entry: LegacyV3CustomMessageEntry): AgentMessage {\n\tconst message: ImportedCustomMessage = {\n\t\trole: \"custom\",\n\t\tcustomType: entry.customType,\n\t\tcontent: entry.content,\n\t\tdetails: entry.details,\n\t\tdisplay: entry.display,\n\t\ttimestamp: Date.parse(entry.timestamp),\n\t};\n\t// The coding-agent CustomAgentMessages declaration merge is not visible in this package.\n\treturn message as unknown as AgentMessage;\n}\n\nfunction isRetainedEntry(entry: LegacyV3Entry): entry is RetainedLegacyV3Entry {\n\treturn (\n\t\tentry.type !== \"model_change\" &&\n\t\tentry.type !== \"thinking_level_change\" &&\n\t\tentry.type !== \"active_tools_change\" &&\n\t\tentry.type !== \"session_info\" &&\n\t\tentry.type !== \"label\"\n\t);\n}\n\nclass RetainedIdResolver {\n\t/** Caches the reminted ID of each discarded legacy node's nearest retained ancestor, or null. */\n\tprivate resolvedIds = new Map<string, string | null>();\n\tprivate entriesById: Map<string, LegacyV3Entry>;\n\tprivate remintedIds: Map<string, string>;\n\n\t/**\n\t * @param entriesById Complete inventory of legacy physical nodes, including discarded nodes.\n\t * @param remintedIds Legacy-to-current ID map containing retained nodes only.\n\t */\n\tconstructor(entriesById: Map<string, LegacyV3Entry>, remintedIds: Map<string, string>) {\n\t\tthis.entriesById = entriesById;\n\t\tthis.remintedIds = remintedIds;\n\t}\n\n\t/**\n\t * Resolve a legacy node to its reminted ID, or to its nearest retained ancestor when discarded.\n\t * Returns null when the reference is null or no retained ancestor exists.\n\t */\n\tresolve(legacyId: string | null): string | null {\n\t\tconst traversedIds: string[] = [];\n\t\tconst visitedIds = new Set<string>();\n\t\tlet currentId = legacyId;\n\t\tlet resolvedId: string | null = null;\n\n\t\twhile (currentId !== null) {\n\t\t\tconst remintedId = this.remintedIds.get(currentId);\n\t\t\tif (remintedId !== undefined) {\n\t\t\t\tresolvedId = remintedId;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (this.resolvedIds.has(currentId)) {\n\t\t\t\tresolvedId = this.resolvedIds.get(currentId) ?? null;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (visitedIds.has(currentId)) throw new Error(`Cycle in legacy v3 parent chain at entry: ${currentId}`);\n\t\t\tvisitedIds.add(currentId);\n\t\t\tconst entry = this.entriesById.get(currentId);\n\t\t\tif (entry === undefined) throw new Error(`Missing legacy v3 entry reference: ${currentId}`);\n\t\t\ttraversedIds.push(currentId);\n\t\t\tcurrentId = entry.parentId;\n\t\t}\n\n\t\tfor (const traversedId of traversedIds) this.resolvedIds.set(traversedId, resolvedId);\n\t\treturn resolvedId;\n\t}\n}\n\nfunction requireRetainedId(resolver: RetainedIdResolver, legacyId: string): string {\n\tconst importedId = resolver.resolve(legacyId);\n\tif (importedId === null) throw new Error(`Legacy v3 entry reference has no retained ancestor: ${legacyId}`);\n\treturn importedId;\n}\n\nfunction resolveBranchSummaryFromId(resolver: RetainedIdResolver, legacyFromId: string): string | null {\n\t// Legacy branchWithSummary() encoded a root source as the \"root\" sentinel instead of null.\n\treturn legacyFromId === \"root\" ? null : resolver.resolve(legacyFromId);\n}\n\nfunction projectContextMessages(entry: LegacyV3Entry, resolver: RetainedIdResolver): AgentMessage[] {\n\tswitch (entry.type) {\n\t\tcase \"message\":\n\t\t\treturn [entry.message];\n\t\tcase \"custom_message\":\n\t\t\treturn [importedCustomMessage(entry)];\n\t\tcase \"branch_summary\":\n\t\t\treturn entry.summary\n\t\t\t\t? [\n\t\t\t\t\t\tcreateBranchSummaryMessage(\n\t\t\t\t\t\t\tentry.summary,\n\t\t\t\t\t\t\tresolveBranchSummaryFromId(resolver, entry.fromId),\n\t\t\t\t\t\t\tentry.timestamp,\n\t\t\t\t\t\t),\n\t\t\t\t\t]\n\t\t\t\t: [];\n\t\tcase \"compaction\":\n\t\t\treturn [createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp)];\n\t\tcase \"custom\":\n\t\tcase \"model_change\":\n\t\tcase \"thinking_level_change\":\n\t\tcase \"active_tools_change\":\n\t\tcase \"session_info\":\n\t\tcase \"label\":\n\t\t\treturn [];\n\t}\n}\n\nfunction materializeRetainedTail(\n\tcompaction: LegacyV3CompactionEntry,\n\tentriesById: ReadonlyMap<string, LegacyV3Entry>,\n\tresolver: RetainedIdResolver,\n): AgentMessage[] {\n\tconst reversedTail: LegacyV3Entry[] = [];\n\tconst visited = new Set<string>();\n\tlet currentId = compaction.parentId;\n\twhile (currentId !== null) {\n\t\tif (visited.has(currentId)) throw new Error(`Cycle in legacy v3 parent chain at entry: ${currentId}`);\n\t\tvisited.add(currentId);\n\t\tconst entry = entriesById.get(currentId);\n\t\tif (entry === undefined) throw new Error(`Missing legacy v3 parent entry: ${currentId}`);\n\t\treversedTail.push(entry);\n\t\tif (currentId === compaction.firstKeptEntryId) {\n\t\t\treturn reversedTail.reverse().flatMap((tailEntry) => projectContextMessages(tailEntry, resolver));\n\t\t}\n\t\tcurrentId = entry.parentId;\n\t}\n\tthrow new Error(\n\t\t`Legacy v3 compaction ${compaction.id} firstKeptEntryId is not on its parent branch: ${compaction.firstKeptEntryId}`,\n\t);\n}\n\nfunction normalizeRetainedEntry(\n\tentry: RetainedLegacyV3Entry,\n\tseq: number,\n\tentriesById: ReadonlyMap<string, LegacyV3Entry>,\n\tresolver: RetainedIdResolver,\n): CommittedEntryWrite {\n\tconst committedBase = {\n\t\tkind: \"entry\" as const,\n\t\tid: requireRetainedId(resolver, entry.id),\n\t\tparentId: resolver.resolve(entry.parentId),\n\t\tseq,\n\t\ttimestamp: Date.parse(entry.timestamp),\n\t};\n\tif (entry.type === \"message\") {\n\t\treturn { ...committedBase, type: \"message\", message: entry.message };\n\t}\n\tif (entry.type === \"custom_message\") {\n\t\treturn {\n\t\t\t...committedBase,\n\t\t\ttype: \"message\",\n\t\t\tmessage: importedCustomMessage(entry),\n\t\t};\n\t}\n\tif (entry.type === \"branch_summary\") {\n\t\treturn {\n\t\t\t...committedBase,\n\t\t\ttype: \"branch_summary\",\n\t\t\tfromId: resolveBranchSummaryFromId(resolver, entry.fromId),\n\t\t\tsummary: entry.summary,\n\t\t\tdetails: entry.details,\n\t\t\tusage: entry.usage,\n\t\t\tfromHook: entry.fromHook ?? false,\n\t\t};\n\t}\n\tif (entry.type === \"compaction\") {\n\t\treturn {\n\t\t\t...committedBase,\n\t\t\ttype: \"compaction\",\n\t\t\tsummary: entry.summary,\n\t\t\tretainedTail: materializeRetainedTail(entry, entriesById, resolver),\n\t\t\ttokensBefore: entry.tokensBefore,\n\t\t\tdetails: entry.details,\n\t\t\tusage: entry.usage,\n\t\t\tfromHook: entry.fromHook ?? false,\n\t\t};\n\t}\n\treturn {\n\t\t...committedBase,\n\t\ttype: \"custom\",\n\t\tcustomType: entry.customType,\n\t\tdata: entry.data,\n\t};\n}\n\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"]);\n\nfunction selectedConfiguration(\n\tentriesById: ReadonlyMap<string, LegacyV3Entry>,\n\tselectedId: string | null,\n): LaneConfiguration | undefined {\n\tlet model: LaneConfiguration[\"model\"] | undefined;\n\tlet thinkingLevel: ThinkingLevel | undefined;\n\tlet activeToolNames: string[] | undefined;\n\tlet sawModel = false;\n\tlet sawThinkingLevel = false;\n\tlet sawActiveToolNames = false;\n\tconst visited = new Set<string>();\n\tlet currentId = selectedId;\n\twhile (currentId !== null && (!sawModel || !sawThinkingLevel || !sawActiveToolNames)) {\n\t\tif (visited.has(currentId)) throw new Error(`Cycle in legacy v3 parent chain at entry: ${currentId}`);\n\t\tvisited.add(currentId);\n\t\tconst entry = entriesById.get(currentId);\n\t\tif (entry === undefined) throw new Error(`Missing legacy v3 entry reference: ${currentId}`);\n\t\tif (entry.type === \"model_change\" && !sawModel) {\n\t\t\tsawModel = true;\n\t\t\tif (\n\t\t\t\ttypeof entry.provider === \"string\" &&\n\t\t\t\tentry.provider.length !== 0 &&\n\t\t\t\ttypeof entry.modelId === \"string\" &&\n\t\t\t\tentry.modelId.length !== 0\n\t\t\t) {\n\t\t\t\tmodel = { provider: entry.provider, modelId: entry.modelId };\n\t\t\t}\n\t\t} else if (entry.type === \"thinking_level_change\" && !sawThinkingLevel) {\n\t\t\tsawThinkingLevel = true;\n\t\t\tif (typeof entry.thinkingLevel === \"string\" && THINKING_LEVELS.has(entry.thinkingLevel as ThinkingLevel)) {\n\t\t\t\tthinkingLevel = entry.thinkingLevel as ThinkingLevel;\n\t\t\t}\n\t\t} else if (entry.type === \"active_tools_change\" && !sawActiveToolNames) {\n\t\t\tsawActiveToolNames = true;\n\t\t\tif (Array.isArray(entry.activeToolNames) && entry.activeToolNames.every((name) => typeof name === \"string\")) {\n\t\t\t\tactiveToolNames = [...entry.activeToolNames];\n\t\t\t}\n\t\t}\n\t\tcurrentId = entry.parentId;\n\t}\n\tif (model === undefined || thinkingLevel === undefined) return undefined;\n\treturn { model, thinkingLevel, activeToolNames: activeToolNames ?? [] };\n}\n\nfunction normalizeLegacyV3Values(\n\tentries: readonly LegacyV3Entry[],\n\tentriesById: ReadonlyMap<string, LegacyV3Entry>,\n\tresolver: RetainedIdResolver,\n\tfirstSeq: number,\n): CommittedValueSetWrite[] {\n\tconst writes: CommittedValueSetWrite[] = [];\n\tlet latestSessionInfo: LegacyV3SessionInfoEntry | undefined;\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session_info\") latestSessionInfo = entry;\n\t}\n\tif (latestSessionInfo?.name) {\n\t\twrites.push({\n\t\t\tkind: \"value\",\n\t\t\top: \"set\",\n\t\t\tseq: firstSeq + writes.length,\n\t\t\tnamespace: sessionName.namespace,\n\t\t\tkey: sessionName.key,\n\t\t\tvalue: latestSessionInfo.name,\n\t\t});\n\t}\n\n\tconst labels = new Map<string, string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"label\") continue;\n\t\tconst targetId = resolver.resolve(entry.targetId);\n\t\t// Labels have no current address when their target has no retained ancestor.\n\t\tif (targetId === null) continue;\n\t\t// Legacy v3 treated both undefined and the empty string as clearing a label.\n\t\tif (entry.label) labels.set(targetId, entry.label);\n\t\telse labels.delete(targetId);\n\t}\n\tfor (const [targetId, label] of labels) {\n\t\tconst address = entryLabel(targetId);\n\t\twrites.push({\n\t\t\tkind: \"value\",\n\t\t\top: \"set\",\n\t\t\tseq: firstSeq + writes.length,\n\t\t\tnamespace: address.namespace,\n\t\t\tkey: address.key,\n\t\t\tvalue: label,\n\t\t});\n\t}\n\n\tconst finalEntry = entries.at(-1);\n\tconst tipAddress = branchTip(\"main\");\n\twrites.push({\n\t\tkind: \"value\",\n\t\top: \"set\",\n\t\tseq: firstSeq + writes.length,\n\t\tnamespace: tipAddress.namespace,\n\t\tkey: tipAddress.key,\n\t\tvalue: finalEntry === undefined ? null : resolver.resolve(finalEntry.id),\n\t});\n\tconst configuration = selectedConfiguration(entriesById, finalEntry?.id ?? null);\n\tif (configuration !== undefined) {\n\t\tconst configAddress = laneConfig(\"main\");\n\t\twrites.push({\n\t\t\tkind: \"value\",\n\t\t\top: \"set\",\n\t\t\tseq: firstSeq + writes.length,\n\t\t\tnamespace: configAddress.namespace,\n\t\t\tkey: configAddress.key,\n\t\t\tvalue: configuration,\n\t\t});\n\t\tconst stateAddress = laneState(\"main\");\n\t\twrites.push({\n\t\t\tkind: \"value\",\n\t\t\top: \"set\",\n\t\t\tseq: firstSeq + writes.length,\n\t\t\tnamespace: stateAddress.namespace,\n\t\t\tkey: stateAddress.key,\n\t\t\tvalue: { currentOperationId: null, lastOperationId: null, inbox: [] },\n\t\t});\n\t}\n\treturn writes;\n}\n\nfunction aggregateImportedUsage(entries: readonly LegacyV3Entry[]): Usage {\n\tlet aggregate = emptyUsage();\n\tfor (const entry of entries) {\n\t\tlet usage: Usage | undefined;\n\t\tif (entry.type === \"message\") {\n\t\t\tif (entry.message.role === \"assistant\") usage = entry.message.usage;\n\t\t\telse if (entry.message.role === \"toolResult\") usage = entry.message.usage;\n\t\t} else if (entry.type === \"compaction\" || entry.type === \"branch_summary\") {\n\t\t\tusage = entry.usage;\n\t\t}\n\t\tif (usage !== undefined) aggregate = addUsage(aggregate, usage);\n\t}\n\treturn aggregate;\n}\n\n/** Normalize the currently supported v3 records without touching their source file. */\nexport function normalizeLegacyV3Records(recordLines: readonly string[]): NormalizedLegacyV3Records {\n\tconst entries = recordLines.map((line, index) => parseLegacyV3Entry(line, index + 2));\n\tconst entriesById = new Map<string, LegacyV3Entry>();\n\tfor (const entry of entries) {\n\t\tif (entriesById.has(entry.id)) throw new Error(`Duplicate legacy v3 entry id: ${entry.id}`);\n\t\tentriesById.set(entry.id, entry);\n\t}\n\tconst retainedEntries = entries.filter(isRetainedEntry);\n\tconst remintedIds = new Map(retainedEntries.map((entry) => [entry.id, uuidv7(Date.parse(entry.timestamp))]));\n\tconst resolver = new RetainedIdResolver(entriesById, remintedIds);\n\tconst entryWrites = retainedEntries.map((entry, index) =>\n\t\tnormalizeRetainedEntry(entry, index + 1, entriesById, resolver),\n\t);\n\tconst valueWrites = normalizeLegacyV3Values(entries, entriesById, resolver, entryWrites.length + 1);\n\tconst writes: CommittedWrite[] = [...entryWrites, ...valueWrites];\n\treturn {\n\t\twrites,\n\t\timportedUsage: aggregateImportedUsage(entries),\n\t\tnextSeq: writes.length + 1,\n\t};\n}\n"]}
+{"version":3,"file":"legacy-v3.d.ts","sourceRoot":"","sources":["../../../../src/harness/session/jsonl/legacy-v3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGhF,OAAO,EAAE,KAAK,qBAAqB,EAA2B,MAAM,YAAY,CAAC;AAEjF,OAAO,EAGN,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,MAAM,YAAY,CAAC;AAsIpB,KAAK,wBAAwB,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;AAalF,wBAAsB,0BAA0B,CAC/C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,wBAAwB,CAAC,CAanC;AAED,wBAAsB,uBAAuB,CAC5C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAyUD;;;;GAIG;AACH,qBAAa,cAAc;IAC1B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAElD,OAAO,eAiBN;IAED;;;;;OAKG;IACH,OAAa,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAwBjG;IAEA,eAAe,IAAI,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC,CAKjF;IAED,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK7C;IAED,OAAO,CAAC,6BAA6B;IAgBrC;;;OAGG;IACI,MAAM,CACZ,OAAO,EAAE,OAAO,EAChB,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GACvC,aAAa,CAAC,mBAAmB,GAAG,sBAAsB,CAAC,CAsB7D;YAGc,mBAAmB;CA8BlC","sourcesContent":["import type { ImageContent, TextContent, Usage } from \"@earendil-works/pi-ai\";\nimport { uuidv7 } from \"@earendil-works/pi-ai/utils/uuid\";\nimport type { AgentMessage, ThinkingLevel } from \"../../../types.ts\";\nimport type { Context } from \"../../context.ts\";\nimport { createBranchSummaryMessage, createCompactionSummaryMessage } from \"../../messages.ts\";\nimport type { FileSystem, TextLineReader } from \"../../types.ts\";\nimport { addUsage, emptyUsage } from \"../../utils/usage.ts\";\nimport type { CommittedEntryWrite, CommittedValueSetWrite } from \"../commit.ts\";\nimport type { JsonValue, LaneConfiguration } from \"../types.ts\";\nimport { branchTip, entryLabel, laneConfig, laneState, sessionName, setValue } from \"../values.ts\";\nimport { type LegacyV3SessionHeader, parseJsonlSessionHeader } from \"./codec.ts\";\nimport { fileValue, readJsonlHeader } from \"./io.ts\";\nimport {\n\tJSONL_FORMAT_VERSION,\n\tJSONL_STORAGE_VERSION,\n\ttype JsonlSessionMetadata,\n\ttype JsonlStorageHeader,\n} from \"./types.ts\";\n\ninterface LegacyV3EntryBase {\n\ttype: string;\n\tid: string;\n\tparentId: string | null;\n\ttimestamp: string;\n}\n\ninterface LegacyV3MessageEntry extends LegacyV3EntryBase {\n\ttype: \"message\";\n\tmessage: AgentMessage;\n}\n\ninterface LegacyV3CustomEntry extends LegacyV3EntryBase {\n\ttype: \"custom\";\n\tcustomType: string;\n\tdata?: JsonValue;\n}\n\ninterface LegacyV3CustomMessageEntry extends LegacyV3EntryBase {\n\ttype: \"custom_message\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdetails?: unknown;\n\tdisplay: boolean;\n}\n\ninterface LegacyV3BranchSummaryEntry extends LegacyV3EntryBase {\n\ttype: \"branch_summary\";\n\tfromId: string;\n\tsummary: string;\n\tdetails?: JsonValue;\n\tusage?: Usage;\n\tfromHook?: boolean;\n}\n\ninterface LegacyV3CompactionEntry extends LegacyV3EntryBase {\n\ttype: \"compaction\";\n\tsummary: string;\n\tfirstKeptEntryId: string;\n\ttokensBefore: number;\n\tdetails?: JsonValue;\n\tusage?: Usage;\n\tfromHook?: boolean;\n}\n\ninterface LegacyV3ModelChangeEntry extends LegacyV3EntryBase {\n\ttype: \"model_change\";\n\tprovider: string;\n\tmodelId: string;\n}\n\ninterface LegacyV3ThinkingLevelChangeEntry extends LegacyV3EntryBase {\n\ttype: \"thinking_level_change\";\n\tthinkingLevel: ThinkingLevel;\n}\n\ninterface LegacyV3ActiveToolsChangeEntry extends LegacyV3EntryBase {\n\ttype: \"active_tools_change\";\n\tactiveToolNames: string[];\n}\n\ninterface LegacyV3SessionInfoEntry extends LegacyV3EntryBase {\n\ttype: \"session_info\";\n\tname?: string;\n}\n\ninterface LegacyV3LabelEntry extends LegacyV3EntryBase {\n\ttype: \"label\";\n\ttargetId: string;\n\tlabel?: string;\n}\n\ninterface ImportedCustomMessage {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdetails?: unknown;\n\tdisplay: boolean;\n\ttimestamp: number;\n}\n\ntype RetainedLegacyV3Entry =\n\t| LegacyV3MessageEntry\n\t| LegacyV3CustomEntry\n\t| LegacyV3CustomMessageEntry\n\t| LegacyV3BranchSummaryEntry\n\t| LegacyV3CompactionEntry;\n\ntype DiscardedLegacyV3Entry =\n\t| LegacyV3ModelChangeEntry\n\t| LegacyV3ThinkingLevelChangeEntry\n\t| LegacyV3ActiveToolsChangeEntry\n\t| LegacyV3SessionInfoEntry\n\t| LegacyV3LabelEntry;\n\ntype LegacyV3Entry = RetainedLegacyV3Entry | DiscardedLegacyV3Entry;\n\ninterface LegacyV3IndexBase {\n\tid: string;\n\tparentId: string | null;\n\t/** This node's new ID, or its parent's mapped ID when the node is discarded. */\n\tmappedId: string | null;\n}\n\ntype RetainedLegacyV3IndexEntry = LegacyV3IndexBase & { mappedId: string; seq: number } & (\n\t\t| { type: \"message\" | \"custom\" | \"custom_message\" }\n\t\t| { type: \"branch_summary\"; fromId: string }\n\t\t| { type: \"compaction\"; firstKeptEntryId: string }\n\t);\n\n/** Keep structure, labels, and configuration changes, but not conversation payloads. */\ntype LegacyV3IndexEntry =\n\t| RetainedLegacyV3IndexEntry\n\t| (LegacyV3IndexBase &\n\t\t\t(\n\t\t\t\t| Pick<LegacyV3LabelEntry, \"type\" | \"targetId\" | \"label\">\n\t\t\t\t| Pick<LegacyV3ModelChangeEntry, \"type\" | \"provider\" | \"modelId\">\n\t\t\t\t| Pick<LegacyV3ThinkingLevelChangeEntry, \"type\" | \"thinkingLevel\">\n\t\t\t\t| Pick<LegacyV3ActiveToolsChangeEntry, \"type\" | \"activeToolNames\">\n\t\t\t\t| { type: \"session_info\" }\n\t\t\t));\n\ntype LegacyV3CompactionIndexEntry = Extract<RetainedLegacyV3IndexEntry, { type: \"compaction\" }>;\n\ninterface LegacyV3Inventory {\n\tentries: ReadonlyMap<string, LegacyV3IndexEntry>;\n\timportedUsage: Usage;\n\tname: string | undefined;\n\tfinalId: string | null;\n\tnextSeq: number;\n}\n\ntype JsonlSessionMetadataBase = Omit<JsonlSessionMetadata, \"path\" | \"modifiedAt\">;\n\nasync function resolveLegacyV3ParentSessionId(\n\tfileSystem: FileSystem,\n\tparentSessionPath: string,\n\tcontext: Context,\n): Promise<string | undefined> {\n\tconst lines = await fileSystem.readTextLines(parentSessionPath, { maxLines: 1 }, context);\n\tif (!lines.ok || lines.value[0] === undefined) return undefined;\n\tconst parsed = parseJsonlSessionHeader(lines.value[0]);\n\treturn parsed.ok ? parsed.value.header.id : undefined;\n}\n\nexport async function metadataFromLegacyV3Header(\n\tfileSystem: FileSystem,\n\theader: LegacyV3SessionHeader,\n\tcontext: Context,\n): Promise<JsonlSessionMetadataBase> {\n\tconst metadata: JsonlSessionMetadataBase = {\n\t\tid: header.id,\n\t\tcreatedAt: Date.parse(header.timestamp),\n\t\tstorageVersion: JSONL_STORAGE_VERSION,\n\t\tcwd: header.cwd,\n\t};\n\tif (header.parentSession !== undefined) {\n\t\tconst parentSessionId = await resolveLegacyV3ParentSessionId(fileSystem, header.parentSession, context);\n\t\tif (parentSessionId !== undefined) metadata.parentSessionId = parentSessionId;\n\t\telse metadata.legacyParentSessionPath = header.parentSession;\n\t}\n\treturn metadata;\n}\n\nexport async function normalizeLegacyV3Header(\n\tfileSystem: FileSystem,\n\theader: LegacyV3SessionHeader,\n\tcontext: Context,\n): Promise<JsonlStorageHeader> {\n\treturn {\n\t\tv: JSONL_FORMAT_VERSION,\n\t\tkind: \"header\",\n\t\t...(await metadataFromLegacyV3Header(fileSystem, header, context)),\n\t};\n}\n\nfunction parseLegacyV3Entry(line: string): LegacyV3Entry {\n\tlet entry: LegacyV3Entry;\n\ttry {\n\t\tentry = JSON.parse(line) as LegacyV3Entry;\n\t} catch (error) {\n\t\tthrow new Error(\"Invalid legacy v3 JSONL record: not valid JSON\", { cause: error });\n\t}\n\tconst recordType: unknown = entry?.type;\n\tif (\n\t\trecordType !== \"message\" &&\n\t\trecordType !== \"custom\" &&\n\t\trecordType !== \"custom_message\" &&\n\t\trecordType !== \"branch_summary\" &&\n\t\trecordType !== \"compaction\" &&\n\t\trecordType !== \"model_change\" &&\n\t\trecordType !== \"thinking_level_change\" &&\n\t\trecordType !== \"active_tools_change\" &&\n\t\trecordType !== \"session_info\" &&\n\t\trecordType !== \"label\"\n\t) {\n\t\tthrow new Error(`Unsupported legacy v3 record type: ${String(recordType)}`);\n\t}\n\treturn entry;\n}\n\nfunction importedCustomMessage(entry: LegacyV3CustomMessageEntry): AgentMessage {\n\tconst message: ImportedCustomMessage = {\n\t\trole: \"custom\",\n\t\tcustomType: entry.customType,\n\t\tcontent: entry.content,\n\t\tdetails: entry.details,\n\t\tdisplay: entry.display,\n\t\ttimestamp: Date.parse(entry.timestamp),\n\t};\n\t// The coding-agent CustomAgentMessages declaration merge is not visible in this package.\n\treturn message as unknown as AgentMessage;\n}\n\nfunction isRetainedEntry<T extends LegacyV3Entry | LegacyV3IndexEntry>(\n\tentry: T,\n): entry is Extract<T, { type: RetainedLegacyV3Entry[\"type\"] }> {\n\treturn (\n\t\tentry.type !== \"model_change\" &&\n\t\tentry.type !== \"thinking_level_change\" &&\n\t\tentry.type !== \"active_tools_change\" &&\n\t\tentry.type !== \"session_info\" &&\n\t\tentry.type !== \"label\"\n\t);\n}\n\n/**\n * Resolve a legacy ID to its imported ID. Discarded records resolve to the minted ID of their\n * nearest retained ancestor.\n */\ntype ResolveLegacyId = (legacyId: string | null) => string | null;\n\n/** Parent mappings are already folded during the scan; later references need only a lookup. */\nfunction createLegacyIdResolver(entries: ReadonlyMap<string, LegacyV3IndexEntry>): ResolveLegacyId {\n\treturn (legacyId) => {\n\t\tif (legacyId === null) return null;\n\t\tconst mappedId = entries.get(legacyId)?.mappedId;\n\t\tif (mappedId === undefined) throw new Error(`Missing legacy v3 entry reference: ${legacyId}`);\n\t\treturn mappedId;\n\t};\n}\n\nfunction resolveBranchSummaryFromId(resolveLegacyId: ResolveLegacyId, legacyFromId: string): string | null {\n\t// Legacy branchWithSummary() encoded a root source as the \"root\" sentinel instead of null.\n\treturn legacyFromId === \"root\" ? null : resolveLegacyId(legacyFromId);\n}\n\nfunction projectContextMessage(entry: LegacyV3Entry, resolveLegacyId: ResolveLegacyId): AgentMessage | undefined {\n\tswitch (entry.type) {\n\t\tcase \"message\":\n\t\t\treturn entry.message;\n\t\tcase \"custom_message\":\n\t\t\treturn importedCustomMessage(entry);\n\t\tcase \"branch_summary\":\n\t\t\treturn entry.summary\n\t\t\t\t? createBranchSummaryMessage(\n\t\t\t\t\t\tentry.summary,\n\t\t\t\t\t\tresolveBranchSummaryFromId(resolveLegacyId, entry.fromId),\n\t\t\t\t\t\tentry.timestamp,\n\t\t\t\t\t)\n\t\t\t\t: undefined;\n\t\tcase \"compaction\":\n\t\t\treturn createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp);\n\t\tcase \"custom\":\n\t\tcase \"model_change\":\n\t\tcase \"thinking_level_change\":\n\t\tcase \"active_tools_change\":\n\t\tcase \"session_info\":\n\t\tcase \"label\":\n\t\t\treturn undefined;\n\t}\n}\n\n/** Walk physical ancestry, including discarded nodes and the exact kept boundary. */\nfunction* retainedTailStructure(\n\tcompaction: LegacyV3CompactionIndexEntry,\n\tentriesById: ReadonlyMap<string, LegacyV3IndexEntry>,\n): Iterable<LegacyV3IndexEntry> {\n\tlet currentId = compaction.parentId;\n\twhile (currentId !== null) {\n\t\t// The scan guarantees that every parent exists earlier in the file, so cycles are impossible.\n\t\tconst entry = entriesById.get(currentId)!;\n\t\tyield entry;\n\t\tif (currentId === compaction.firstKeptEntryId) return;\n\t\tcurrentId = entry.parentId;\n\t}\n\tthrow new Error(\n\t\t`Legacy v3 compaction ${compaction.id} firstKeptEntryId is not on its parent branch: ${compaction.firstKeptEntryId}`,\n\t);\n}\n\nfunction normalizeRetainedEntry(\n\tentry: RetainedLegacyV3Entry,\n\tindexed: RetainedLegacyV3IndexEntry,\n\tretainedTail: AgentMessage[],\n\tresolveLegacyId: ResolveLegacyId,\n): CommittedEntryWrite {\n\tconst committedBase = {\n\t\tkind: \"entry\" as const,\n\t\tid: indexed.mappedId,\n\t\tparentId: resolveLegacyId(indexed.parentId),\n\t\tseq: indexed.seq,\n\t\ttimestamp: Date.parse(entry.timestamp),\n\t};\n\tif (entry.type === \"message\") {\n\t\treturn { ...committedBase, type: \"message\", message: entry.message };\n\t}\n\tif (entry.type === \"custom_message\") {\n\t\treturn {\n\t\t\t...committedBase,\n\t\t\ttype: \"message\",\n\t\t\tmessage: importedCustomMessage(entry),\n\t\t};\n\t}\n\tif (entry.type === \"branch_summary\") {\n\t\treturn {\n\t\t\t...committedBase,\n\t\t\ttype: \"branch_summary\",\n\t\t\tfromId: resolveBranchSummaryFromId(resolveLegacyId, entry.fromId),\n\t\t\tsummary: entry.summary,\n\t\t\tdetails: entry.details,\n\t\t\tusage: entry.usage,\n\t\t\tfromHook: entry.fromHook ?? false,\n\t\t};\n\t}\n\tif (entry.type === \"compaction\") {\n\t\treturn {\n\t\t\t...committedBase,\n\t\t\ttype: \"compaction\",\n\t\t\tsummary: entry.summary,\n\t\t\tretainedTail,\n\t\t\ttokensBefore: entry.tokensBefore,\n\t\t\tdetails: entry.details,\n\t\t\tusage: entry.usage,\n\t\t\tfromHook: entry.fromHook ?? false,\n\t\t};\n\t}\n\treturn {\n\t\t...committedBase,\n\t\ttype: \"custom\",\n\t\tcustomType: entry.customType,\n\t\tdata: entry.data,\n\t};\n}\n\nfunction selectedConfiguration(\n\tentriesById: ReadonlyMap<string, LegacyV3IndexEntry>,\n\tselectedId: string | null,\n): LaneConfiguration | undefined {\n\tconst remaining = new Set<LegacyV3IndexEntry[\"type\"]>([\n\t\t\"model_change\",\n\t\t\"thinking_level_change\",\n\t\t\"active_tools_change\",\n\t]);\n\tlet model: LaneConfiguration[\"model\"] | undefined;\n\tlet thinkingLevel: ThinkingLevel | undefined;\n\tlet activeToolNames: string[] | undefined;\n\tlet currentId = selectedId;\n\twhile (currentId !== null && remaining.size !== 0) {\n\t\tconst entry = entriesById.get(currentId)!;\n\t\t// Consume the nearest change even when invalid: older values must not become fallbacks.\n\t\tif (remaining.delete(entry.type)) {\n\t\t\tswitch (entry.type) {\n\t\t\t\tcase \"model_change\":\n\t\t\t\t\tmodel = { provider: entry.provider, modelId: entry.modelId };\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"thinking_level_change\":\n\t\t\t\t\tthinkingLevel = entry.thinkingLevel;\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"active_tools_change\":\n\t\t\t\t\tactiveToolNames = [...entry.activeToolNames];\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tcurrentId = entry.parentId;\n\t}\n\tif (model === undefined || thinkingLevel === undefined) return undefined;\n\treturn { model, thinkingLevel, activeToolNames: activeToolNames ?? [] };\n}\n\nfunction indexLegacyV3Entry(\n\tentry: LegacyV3Entry,\n\tlineNumber: number,\n\tseq: number,\n\tentries: ReadonlyMap<string, LegacyV3IndexEntry>,\n): LegacyV3IndexEntry {\n\t// SessionManager appends after an existing leaf and writes extracted branches in parent order.\n\tconst mappedParentId = entry.parentId === null ? null : entries.get(entry.parentId)?.mappedId;\n\tif (mappedParentId === undefined) {\n\t\tthrow new Error(\n\t\t\t`Legacy v3 entry ${entry.id} has a missing or forward parent at line ${lineNumber}: ${entry.parentId}`,\n\t\t);\n\t}\n\tconst structure: LegacyV3IndexBase = {\n\t\tid: entry.id,\n\t\tparentId: entry.parentId,\n\t\tmappedId: mappedParentId,\n\t};\n\tif (!isRetainedEntry(entry)) {\n\t\tswitch (entry.type) {\n\t\t\tcase \"label\":\n\t\t\t\treturn { ...structure, type: entry.type, targetId: entry.targetId, label: entry.label };\n\t\t\tcase \"model_change\":\n\t\t\t\treturn { ...structure, type: entry.type, provider: entry.provider, modelId: entry.modelId };\n\t\t\tcase \"thinking_level_change\":\n\t\t\t\treturn { ...structure, type: entry.type, thinkingLevel: entry.thinkingLevel };\n\t\t\tcase \"active_tools_change\":\n\t\t\t\treturn { ...structure, type: entry.type, activeToolNames: entry.activeToolNames };\n\t\t\tcase \"session_info\":\n\t\t\t\treturn { ...structure, type: entry.type };\n\t\t}\n\t}\n\t// Null denotes the root, not a retained node identity that can be reminted.\n\tif (entry.id === null) throw new Error(\"Legacy v3 entry reference has no retained ancestor: null\");\n\tconst retained = {\n\t\t...structure,\n\t\tmappedId: uuidv7(Date.parse(entry.timestamp)),\n\t\tseq,\n\t};\n\tswitch (entry.type) {\n\t\tcase \"branch_summary\":\n\t\t\treturn { ...retained, type: entry.type, fromId: entry.fromId };\n\t\tcase \"compaction\":\n\t\t\treturn { ...retained, type: entry.type, firstKeptEntryId: entry.firstKeptEntryId };\n\t\tdefault:\n\t\t\treturn { ...retained, type: entry.type };\n\t}\n}\n\nfunction legacyEntryUsage(entry: LegacyV3Entry): Usage | undefined {\n\tswitch (entry.type) {\n\t\tcase \"message\":\n\t\t\treturn entry.message.role === \"assistant\" || entry.message.role === \"toolResult\"\n\t\t\t\t? entry.message.usage\n\t\t\t\t: undefined;\n\t\tcase \"compaction\":\n\t\tcase \"branch_summary\":\n\t\t\treturn entry.usage;\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nasync function readLegacyV3Inventory(reader: TextLineReader, context: Context): Promise<LegacyV3Inventory> {\n\tconst entries = new Map<string, LegacyV3IndexEntry>();\n\tlet nextSeq = 1;\n\tlet importedUsage = emptyUsage();\n\tlet name: string | undefined;\n\tlet finalId: string | null = null;\n\twhile (true) {\n\t\tconst line = fileValue(await reader.readLine(context), \"Failed to read legacy v3 source\");\n\t\tif (line === undefined || !line.terminated) break;\n\t\tconst lineNumber = entries.size + 2;\n\t\tconst entry = parseLegacyV3Entry(line.text);\n\t\tif (entries.has(entry.id)) throw new Error(`Duplicate legacy v3 entry id: ${entry.id}`);\n\t\tconst indexed = indexLegacyV3Entry(entry, lineNumber, nextSeq, entries);\n\t\tentries.set(entry.id, indexed);\n\t\tif (isRetainedEntry(indexed)) nextSeq++;\n\t\tfinalId = entry.id;\n\t\tif (entry.type === \"session_info\") name = entry.name;\n\t\tconst usage = legacyEntryUsage(entry);\n\t\tif (usage !== undefined) importedUsage = addUsage(importedUsage, usage);\n\t}\n\treturn { entries, nextSeq, importedUsage, name, finalId };\n}\n\nfunction normalizeLegacyV3Values(inventory: LegacyV3Inventory): CommittedValueSetWrite[] {\n\tconst { entries, name, finalId } = inventory;\n\tconst resolveLegacyId = createLegacyIdResolver(entries);\n\tlet nextSeq = inventory.nextSeq;\n\tconst values: CommittedValueSetWrite[] = [];\n\n\t// session name\n\tif (name) values.push({ ...setValue(sessionName, name), seq: nextSeq++ });\n\n\t// labels\n\tconst labels = new Map<string, string>();\n\tfor (const entry of entries.values()) {\n\t\tif (entry.type !== \"label\") continue;\n\t\tconst targetId = resolveLegacyId(entry.targetId);\n\t\tif (targetId === null) continue;\n\t\tif (entry.label) labels.set(targetId, entry.label);\n\t\telse labels.delete(targetId);\n\t}\n\tfor (const [targetId, label] of labels) {\n\t\tvalues.push({ ...setValue(entryLabel(targetId), label), seq: nextSeq++ });\n\t}\n\n\t// branch tip\n\tvalues.push({ ...setValue(branchTip(\"main\"), resolveLegacyId(finalId)), seq: nextSeq++ });\n\n\t// configuration\n\tconst configuration = selectedConfiguration(entries, finalId);\n\tif (configuration !== undefined) {\n\t\tvalues.push({ ...setValue(laneConfig(\"main\"), configuration), seq: nextSeq++ });\n\t\tvalues.push({\n\t\t\t...setValue(laneState(\"main\"), { currentOperationId: null, lastOperationId: null, inbox: [] }),\n\t\t\tseq: nextSeq++,\n\t\t});\n\t}\n\treturn values;\n}\n\n/**\n * A captured legacy file exposed as repeatable logical v4 writes.\n * Each pass reopens the path; callers must not replace or edit the source between passes.\n * Structural indexes, label/configuration metadata, and derived current values survive between scans.\n */\nexport class LegacyV3Source {\n\treadonly header: JsonlStorageHeader;\n\treadonly importedUsage: Usage;\n\treadonly nextSeq: number;\n\treadonly values: readonly CommittedValueSetWrite[];\n\tprivate readonly fileSystem: FileSystem;\n\tprivate readonly path: string;\n\tprivate readonly entries: ReadonlyMap<string, LegacyV3IndexEntry>;\n\tprivate readonly resolveLegacyId: ResolveLegacyId;\n\n\tprivate constructor(\n\t\tfileSystem: FileSystem,\n\t\tpath: string,\n\t\theader: JsonlStorageHeader,\n\t\tentries: ReadonlyMap<string, LegacyV3IndexEntry>,\n\t\timportedUsage: Usage,\n\t\tvalues: readonly CommittedValueSetWrite[],\n\t\tnextSeq: number,\n\t) {\n\t\tthis.fileSystem = fileSystem;\n\t\tthis.path = path;\n\t\tthis.header = header;\n\t\tthis.entries = entries;\n\t\tthis.resolveLegacyId = createLegacyIdResolver(entries);\n\t\tthis.importedUsage = importedUsage;\n\t\tthis.values = values;\n\t\tthis.nextSeq = nextSeq;\n\t}\n\n\t/**\n\t * Scan complete v3 records without modifying the file, ignoring an unterminated final line.\n\t * Build parent mappings, assign IDs stable for this source instance, and derive current values\n\t * and imported usage. Retain metadata, not conversation payloads or an open reader. writes()\n\t * reopens the path to materialize captured records and resolve their payload-specific references.\n\t */\n\tstatic async read(fileSystem: FileSystem, path: string, context: Context): Promise<LegacyV3Source> {\n\t\tconst reader = fileValue(\n\t\t\tawait fileSystem.openTextLineReader(path, context),\n\t\t\t`Failed to open legacy v3 source ${path}`,\n\t\t);\n\t\ttry {\n\t\t\tconst parsed = await readJsonlHeader(reader, path, context);\n\t\t\tif (parsed.format !== \"v3-legacy\") {\n\t\t\t\tthrow new Error(`Invalid legacy v3 JSONL storage ${path}: expected format 3 header`);\n\t\t\t}\n\t\t\tconst inventory = await readLegacyV3Inventory(reader, context);\n\t\t\tconst values = normalizeLegacyV3Values(inventory);\n\t\t\treturn new LegacyV3Source(\n\t\t\t\tfileSystem,\n\t\t\t\tpath,\n\t\t\t\tawait normalizeLegacyV3Header(fileSystem, parsed.header, context),\n\t\t\t\tinventory.entries,\n\t\t\t\tinventory.importedUsage,\n\t\t\t\tvalues,\n\t\t\t\tinventory.nextSeq + values.length,\n\t\t\t);\n\t\t} finally {\n\t\t\tawait reader.close(context);\n\t\t}\n\t}\n\n\t*entryStructures(): Iterable<Pick<CommittedEntryWrite, \"id\" | \"parentId\" | \"seq\">> {\n\t\tfor (const entry of this.entries.values()) {\n\t\t\tif (!isRetainedEntry(entry)) continue;\n\t\t\tyield { id: entry.mappedId, parentId: this.resolveLegacyId(entry.parentId), seq: entry.seq };\n\t\t}\n\t}\n\n\ttranslateForkEntryId(legacyId: string): string {\n\t\tconst entry = this.entries.get(legacyId);\n\t\tif (entry === undefined) throw new Error(`Legacy v3 fork entry does not exist: ${legacyId}`);\n\t\tif (!isRetainedEntry(entry)) throw new Error(`Legacy v3 fork entry is not a retained entry: ${legacyId}`);\n\t\treturn entry.mappedId;\n\t}\n\n\tprivate collectRequiredTailMessageIds(isEntrySelected?: (id: string) => boolean): Set<string> {\n\t\tconst requiredIds = new Set<string>();\n\t\tfor (const entry of this.entries.values()) {\n\t\t\tif (entry.type !== \"compaction\") continue;\n\t\t\tconst compactionIsSelected = isEntrySelected === undefined || isEntrySelected(entry.mappedId);\n\t\t\tif (!compactionIsSelected) continue;\n\n\t\t\t// Walk from the compaction's parent through firstKeptEntryId, inclusive.\n\t\t\tfor (const tailEntry of retainedTailStructure(entry, this.entries)) {\n\t\t\t\tconst canProduceContextMessage = isRetainedEntry(tailEntry) && tailEntry.type !== \"custom\";\n\t\t\t\tif (canProduceContextMessage) requiredIds.add(tailEntry.id);\n\t\t\t}\n\t\t}\n\t\treturn requiredIds;\n\t}\n\n\t/**\n\t * Stream normalized v4 entries, optionally filtered by reminted ID, followed by derived current values.\n\t * Each pass owns its reader and message cache, sharing only the captured IDs and metadata.\n\t */\n\tasync *writes(\n\t\tcontext: Context,\n\t\tisEntrySelected?: (id: string) => boolean,\n\t): AsyncIterable<CommittedEntryWrite | CommittedValueSetWrite> {\n\t\tconst requiredTailMessageIds = this.collectRequiredTailMessageIds(isEntrySelected);\n\t\t// Keep needed context messages for this entire pass; tails may revisit old or shared branches.\n\t\tconst tailMessagesByLegacyId = new Map<string, AgentMessage>();\n\t\tfor await (const { entry, indexed } of this.readCapturedEntries(context)) {\n\t\t\tif (requiredTailMessageIds.has(entry.id)) {\n\t\t\t\tconst message = projectContextMessage(entry, this.resolveLegacyId);\n\t\t\t\tif (message !== undefined) tailMessagesByLegacyId.set(entry.id, message);\n\t\t\t}\n\t\t\tif (!isRetainedEntry(indexed) || !isRetainedEntry(entry)) continue;\n\t\t\tif (isEntrySelected !== undefined && !isEntrySelected(indexed.mappedId)) continue;\n\t\t\tconst retainedTail: AgentMessage[] = [];\n\t\t\tif (indexed.type === \"compaction\") {\n\t\t\t\tfor (const ancestor of retainedTailStructure(indexed, this.entries)) {\n\t\t\t\t\tconst message = tailMessagesByLegacyId.get(ancestor.id);\n\t\t\t\t\tif (message !== undefined) retainedTail.push(message);\n\t\t\t\t}\n\t\t\t\tretainedTail.reverse();\n\t\t\t}\n\t\t\tyield normalizeRetainedEntry(entry, indexed, retainedTail, this.resolveLegacyId);\n\t\t}\n\t\tyield* this.values;\n\t}\n\n\t/** Replay only the captured prefix and verify its physical identities before materialization. */\n\tprivate async *readCapturedEntries(\n\t\tcontext: Context,\n\t): AsyncIterable<{ entry: LegacyV3Entry; indexed: LegacyV3IndexEntry }> {\n\t\tconst reader = fileValue(\n\t\t\tawait this.fileSystem.openTextLineReader(this.path, context),\n\t\t\t`Failed to reopen legacy v3 source ${this.path}`,\n\t\t);\n\t\ttry {\n\t\t\tconst parsed = await readJsonlHeader(reader, this.path, context);\n\t\t\tif (\n\t\t\t\tparsed.format !== \"v3-legacy\" ||\n\t\t\t\tparsed.header.id !== this.header.id ||\n\t\t\t\tparsed.header.cwd !== this.header.cwd\n\t\t\t) {\n\t\t\t\tthrow new Error(\"Legacy v3 source header changed\");\n\t\t\t}\n\t\t\tfor (const indexed of this.entries.values()) {\n\t\t\t\tconst line = fileValue(await reader.readLine(context), \"Failed to reread legacy v3 source\");\n\t\t\t\tif (line === undefined || !line.terminated)\n\t\t\t\t\tthrow new Error(\"Legacy v3 source ended before captured entries\");\n\t\t\t\tconst entry = parseLegacyV3Entry(line.text);\n\t\t\t\tif (entry.id !== indexed.id || entry.type !== indexed.type) {\n\t\t\t\t\tthrow new Error(\"Legacy v3 source changed\");\n\t\t\t\t}\n\t\t\t\tyield { entry, indexed };\n\t\t\t}\n\t\t} finally {\n\t\t\tawait reader.close(context);\n\t\t}\n\t}\n}\n"]}