@gobing-ai/ts-llm-jsonl-importer 0.4.41 → 0.4.42

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { HistoryImportError } from './errors';
 export { sha256, stableJson } from './hash';
 export { runJsonlImport } from './importer';
 export { applyHistoryImportSchema, normalizeSourceFilePaths } from './jsonl-importer-dao';
+export { sessionIdFromSourcePath } from './mappers';
 export { type OpenCodeImportOptions, runOpenCodeImport } from './opencode-importer';
 export { DEFAULT_REDACTION_RULES, redactRecord, redactValue } from './redaction';
 export { HISTORY_IMPORT_SCHEMA_SQL } from './schema-sql';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,KAAK,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,cAAc,EACd,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,gBAAgB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,KAAK,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,GAC3B,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,cAAc,EACd,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,gBAAgB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export { HistoryImportError } from './errors.js';
 export { sha256, stableJson } from './hash.js';
 export { runJsonlImport } from './importer.js';
 export { applyHistoryImportSchema, normalizeSourceFilePaths } from './jsonl-importer-dao.js';
+export { sessionIdFromSourcePath } from './mappers.js';
 export { runOpenCodeImport } from './opencode-importer.js';
 export { DEFAULT_REDACTION_RULES, redactRecord, redactValue } from './redaction.js';
 export { HISTORY_IMPORT_SCHEMA_SQL } from './schema-sql.js';

package/dist/mappers.d.ts

@@ -53,11 +53,19 @@ export interface ClaudeToolResultTiming {
  */
 export declare function claudeToolResultTiming(raw: Record<string, unknown>): ClaudeToolResultTiming | null;
 /** Map a Codex JSONL record into one or more ETL split entries. */
-export declare function codexSplit(raw: Record<string, unknown>): readonly SplitEntry[];
+export declare function codexSplit(raw: Record<string, unknown>, context?: TransformContext): readonly SplitEntry[];
 /** Map an Antigravity (AGY) JSONL record into one or more ETL split entries. */
-export declare function agySplit(raw: Record<string, unknown>): readonly SplitEntry[];
+export declare function agySplit(raw: Record<string, unknown>, context?: TransformContext): readonly SplitEntry[];
 /** Map Gemini CLI message, tool, and session-state events into the forensic contract tables. */
 export declare function geminiSplit(raw: Record<string, unknown>, context?: TransformContext): readonly SplitEntry[];
+/**
+ * Pure helper extracting canonical session identity from source transcript paths (task 0638 R4).
+ *
+ * Normalizes POSIX/Windows separators and returns only valid UUID-shaped identifiers:
+ * - agy: segment immediately following `/brain/`
+ * - codex: trailing UUID before `.jsonl` in a filename beginning with `rollout-`
+ */
+export declare function sessionIdFromSourcePath(source: string, sourceFile: string): string | undefined;
 /** Map a Grok JSONL record into one or more ETL split entries. */
 export declare function grokSplit(raw: Record<string, unknown>): readonly SplitEntry[];
 /** Compute a stable field-shape key from a JSON object: sorted, lowercased, +-joined top-level keys. */

package/dist/mappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"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"}

package/dist/mappers.js

@@ -549,16 +549,25 @@ export function claudeToolResultTiming(raw) {
 // Codex mapper
 // ---------------------------------------------------------------------------
 /** Map a Codex JSONL record into one or more ETL split entries. */
-export function codexSplit(raw) {
+export function codexSplit(raw, context) {
     const entries = [];
     const payload = (raw.payload ?? raw);
-    const sessionId = s(raw.session_id, o(raw.session_meta).id, raw.id) ?? 'unknown';
     const seq = typeof raw.seq === 'number' ? raw.seq : 0;
     const ts = timestampOf(raw.timestamp, raw.ts, payload.ts);
     const recordType = String(raw.type ?? '');
     const payloadType = String(payload.type ?? '');
+    const isShortFormat = recordType === '' && raw.id !== undefined && raw.timestamp !== undefined && raw.instructions !== undefined;
+    let explicitSessionId = s(raw.session_id, o(raw.session_meta).id);
+    if (explicitSessionId === undefined && recordType === 'session_meta') {
+        explicitSessionId = s(payload.id, o(raw.payload).id);
+    }
+    if (explicitSessionId === undefined && isShortFormat) {
+        explicitSessionId = s(raw.id);
+    }
+    const pathSessionId = context?.sourceFile ? sessionIdFromSourcePath('codex', context.sourceFile) : undefined;
+    const sessionId = explicitSessionId ?? pathSessionId ?? 'unknown';
     // Check for older short format
-    if (recordType === '' && raw.id && raw.timestamp && raw.instructions) {
+    if (isShortFormat) {
         return [
             {
                 targetTable: 'history_message',
@@ -711,10 +720,12 @@ export function codexSplit(raw) {
 // AGY mapper (Antigravity CLI)
 // ---------------------------------------------------------------------------
 /** Map an Antigravity (AGY) JSONL record into one or more ETL split entries. */
-export function agySplit(raw) {
+export function agySplit(raw, context) {
     const entries = [];
     const recordType = String(raw.type ?? '');
-    const sessionId = s(raw.session_id, raw.conversation_id) ?? 'unknown';
+    const explicitSessionId = s(raw.session_id, raw.conversation_id);
+    const pathSessionId = context?.sourceFile ? sessionIdFromSourcePath('agy', context.sourceFile) : undefined;
+    const sessionId = explicitSessionId ?? pathSessionId ?? 'unknown';
     const seq = typeof raw.seq === 'number' ? raw.seq : typeof raw.step_index === 'number' ? raw.step_index : 0;
     const ts = timestampOf(raw.created_at, raw.timestamp, raw.ts);
     let role;
@@ -902,6 +913,33 @@ export function geminiSplit(raw, context) {
     }
     return entries;
 }
+const UUID_PATTERN = '[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}';
+const AGY_BRAIN_REGEX = new RegExp(`(?:^|\\/)brain\\/(${UUID_PATTERN})(?:\\/|$)`, 'i');
+const CODEX_ROLLOUT_REGEX = new RegExp(`(?:^|-|_)(${UUID_PATTERN})$`, 'i');
+/**
+ * Pure helper extracting canonical session identity from source transcript paths (task 0638 R4).
+ *
+ * Normalizes POSIX/Windows separators and returns only valid UUID-shaped identifiers:
+ * - agy: segment immediately following `/brain/`
+ * - codex: trailing UUID before `.jsonl` in a filename beginning with `rollout-`
+ */
+export function sessionIdFromSourcePath(source, sourceFile) {
+    const normalized = sourceFile.replace(/\\/g, '/');
+    const sLower = source.toLowerCase();
+    if (sLower === 'agy' || sLower === 'antigravity') {
+        const match = normalized.match(AGY_BRAIN_REGEX);
+        return match?.[1];
+    }
+    if (sLower === 'codex') {
+        const basename = normalized.split('/').at(-1) ?? '';
+        if (basename.startsWith('rollout-') && basename.endsWith('.jsonl')) {
+            const stem = basename.slice(0, -6);
+            const match = stem.match(CODEX_ROLLOUT_REGEX);
+            return match?.[1];
+        }
+    }
+    return undefined;
+}
 function sessionIdFromContext(context, raw) {
     if (context !== undefined) {
         const file = context.sourceFile.split('/').at(-1);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-llm-jsonl-importer",
-    "version": "0.4.41",
+    "version": "0.4.42",
     "description": "@gobing-ai/ts-llm-jsonl-importer — Generic JSONL importer for LLM agent history files.",
     "keywords": [
         "typescript",
@@ -47,9 +47,9 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-llm-jsonl-importer-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-db": "^0.4.41",
-        "@gobing-ai/ts-runtime": "^0.4.41",
-        "@gobing-ai/ts-utils": "^0.4.41",
+        "@gobing-ai/ts-db": "^0.4.42",
+        "@gobing-ai/ts-runtime": "^0.4.42",
+        "@gobing-ai/ts-utils": "^0.4.42",
         "zod": "^4.1.0"
     },
     "devDependencies": {

package/src/index.ts

@@ -2,6 +2,7 @@ export { HistoryImportError } from './errors';
 export { sha256, stableJson } from './hash';
 export { runJsonlImport } from './importer';
 export { applyHistoryImportSchema, normalizeSourceFilePaths } from './jsonl-importer-dao';
+export { sessionIdFromSourcePath } from './mappers';
 export { type OpenCodeImportOptions, runOpenCodeImport } from './opencode-importer';
 export { DEFAULT_REDACTION_RULES, redactRecord, redactValue } from './redaction';
 export { HISTORY_IMPORT_SCHEMA_SQL } from './schema-sql';

package/src/mappers.ts

@@ -605,18 +605,30 @@ export function claudeToolResultTiming(raw: Record<string, unknown>): ClaudeTool
 // ---------------------------------------------------------------------------
 
 /** Map a Codex JSONL record into one or more ETL split entries. */
-export function codexSplit(raw: Record<string, unknown>): readonly SplitEntry[] {
+export function codexSplit(raw: Record<string, unknown>, context?: TransformContext): readonly SplitEntry[] {
     const entries: SplitEntry[] = [];
 
     const payload = (raw.payload ?? raw) as Record<string, unknown>;
-    const sessionId = s(raw.session_id, o(raw.session_meta).id, raw.id) ?? 'unknown';
     const seq = typeof raw.seq === 'number' ? raw.seq : 0;
     const ts = timestampOf(raw.timestamp, raw.ts, payload.ts);
     const recordType = String(raw.type ?? '');
     const payloadType = String(payload.type ?? '');
 
+    const isShortFormat =
+        recordType === '' && raw.id !== undefined && raw.timestamp !== undefined && raw.instructions !== undefined;
+
+    let explicitSessionId = s(raw.session_id, o(raw.session_meta).id);
+    if (explicitSessionId === undefined && recordType === 'session_meta') {
+        explicitSessionId = s(payload.id, o(raw.payload).id);
+    }
+    if (explicitSessionId === undefined && isShortFormat) {
+        explicitSessionId = s(raw.id);
+    }
+    const pathSessionId = context?.sourceFile ? sessionIdFromSourcePath('codex', context.sourceFile) : undefined;
+    const sessionId = explicitSessionId ?? pathSessionId ?? 'unknown';
+
     // Check for older short format
-    if (recordType === '' && raw.id && raw.timestamp && raw.instructions) {
+    if (isShortFormat) {
         return [
             {
                 targetTable: 'history_message',
@@ -776,10 +788,12 @@ export function codexSplit(raw: Record<string, unknown>): readonly SplitEntry[]
 // ---------------------------------------------------------------------------
 
 /** Map an Antigravity (AGY) JSONL record into one or more ETL split entries. */
-export function agySplit(raw: Record<string, unknown>): readonly SplitEntry[] {
+export function agySplit(raw: Record<string, unknown>, context?: TransformContext): readonly SplitEntry[] {
     const entries: SplitEntry[] = [];
     const recordType = String(raw.type ?? '');
-    const sessionId = s(raw.session_id, raw.conversation_id) ?? 'unknown';
+    const explicitSessionId = s(raw.session_id, raw.conversation_id);
+    const pathSessionId = context?.sourceFile ? sessionIdFromSourcePath('agy', context.sourceFile) : undefined;
+    const sessionId = explicitSessionId ?? pathSessionId ?? 'unknown';
     const seq = typeof raw.seq === 'number' ? raw.seq : typeof raw.step_index === 'number' ? raw.step_index : 0;
     const ts = timestampOf(raw.created_at, raw.timestamp, raw.ts);
 
@@ -979,6 +993,35 @@ export function geminiSplit(raw: Record<string, unknown>, context?: TransformCon
     return entries;
 }
 
+const UUID_PATTERN = '[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}';
+const AGY_BRAIN_REGEX = new RegExp(`(?:^|\\/)brain\\/(${UUID_PATTERN})(?:\\/|$)`, 'i');
+const CODEX_ROLLOUT_REGEX = new RegExp(`(?:^|-|_)(${UUID_PATTERN})$`, 'i');
+
+/**
+ * Pure helper extracting canonical session identity from source transcript paths (task 0638 R4).
+ *
+ * Normalizes POSIX/Windows separators and returns only valid UUID-shaped identifiers:
+ * - agy: segment immediately following `/brain/`
+ * - codex: trailing UUID before `.jsonl` in a filename beginning with `rollout-`
+ */
+export function sessionIdFromSourcePath(source: string, sourceFile: string): string | undefined {
+    const normalized = sourceFile.replace(/\\/g, '/');
+    const sLower = source.toLowerCase();
+    if (sLower === 'agy' || sLower === 'antigravity') {
+        const match = normalized.match(AGY_BRAIN_REGEX);
+        return match?.[1];
+    }
+    if (sLower === 'codex') {
+        const basename = normalized.split('/').at(-1) ?? '';
+        if (basename.startsWith('rollout-') && basename.endsWith('.jsonl')) {
+            const stem = basename.slice(0, -6);
+            const match = stem.match(CODEX_ROLLOUT_REGEX);
+            return match?.[1];
+        }
+    }
+    return undefined;
+}
+
 function sessionIdFromContext(context: TransformContext | undefined, raw: Record<string, unknown>): string {
     if (context !== undefined) {
         const file = context.sourceFile.split('/').at(-1);