@ironbee-ai/cli 0.14.1 → 0.16.0

package/dist/import/codex/summary.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * IronBee CLI — Codex Import Dry-Run Summary Estimator
+ *
+ * Pre-pass over each candidate Codex rollout to estimate event counts +
+ * cost + wire bytes. Uses the SAME projection primitives the live + import
+ * pipelines use (`projectCodexDelta` via `runCodexImportAnalytics`), so
+ * displayed numbers are exact (not a heuristic).
+ *
+ * Produces an `ImportSummary` rendered by `commands/import.ts` before the
+ * confirm prompt. Parallel to `src/import/claude/summary.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateCodexImport = estimateCodexImport;
+const fs_1 = require("fs");
+const collector_1 = require("../../lib/collector");
+const config_1 = require("../../lib/config");
+const logger_1 = require("../../lib/logger");
+const types_1 = require("../types");
+const skip_1 = require("../skip");
+const analytics_runner_1 = require("./analytics-runner");
+const api_request_1 = require("../../analytics/codex/api-request");
+const apply_patch_1 = require("../../analytics/codex/apply-patch");
+const clear_verdict_1 = require("../../clients/codex/hooks/clear-verdict");
+function estimateCodexImport(opts) {
+    const counts = (0, types_1.emptyEventCounts)();
+    let costUsdSum = 0;
+    let wireBytesSum = 0;
+    let toImport = 0;
+    let skipped = 0;
+    const perProject = new Map();
+    for (const target of opts.targets) {
+        const key = target.projectDir;
+        let row = perProject.get(key);
+        if (row === undefined) {
+            row = { projectDir: key, found: 0, skipped: 0, toImport: 0 };
+            perProject.set(key, row);
+        }
+        row.found += 1;
+        if ((0, skip_1.shouldSkip)(target.projectDir, target.sessionId, opts.force)) {
+            row.skipped += 1;
+            skipped += 1;
+            continue;
+        }
+        row.toImport += 1;
+        toImport += 1;
+        try {
+            const analyticsEnabled = (0, config_1.isAnalyticsEnabled)(target.projectDir);
+            const per = estimateOne(target, !analyticsEnabled);
+            counts.session_start += per.counts.session_start;
+            counts.session_end += per.counts.session_end;
+            counts.activity_start += per.counts.activity_start;
+            counts.activity_end += per.counts.activity_end;
+            counts.tool_call += per.counts.tool_call;
+            counts.file_change += per.counts.file_change;
+            counts.session_analytics += per.counts.session_analytics;
+            counts.api_request += per.counts.api_request;
+            costUsdSum += per.costUsd;
+            wireBytesSum += per.wireBytes;
+        }
+        catch (e) {
+            logger_1.logger.debug(`codex import summary: estimate failed for ${target.sessionId}: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    const collectorTarget = opts.targets.length > 0
+        ? (0, collector_1.getCollectorTarget)(opts.targets[0].projectDir)
+        : null;
+    return {
+        projects: Array.from(perProject.values()),
+        timeRange: opts.timeRange,
+        toImportCount: toImport,
+        skippedCount: skipped,
+        estimatedEvents: counts,
+        estimatedCostUsd: costUsdSum,
+        estimatedWireBytes: wireBytesSum,
+        concurrency: opts.concurrency,
+        collectorUrl: collectorTarget !== null ? collectorTarget.url : null,
+    };
+}
+function estimateOne(target, skipAnalytics) {
+    const counts = (0, types_1.emptyEventCounts)();
+    counts.session_start = 1;
+    counts.session_end = 1;
+    const raw = (0, fs_1.readFileSync)(target.transcriptPath);
+    const lines = parseLines(raw.toString("utf-8"));
+    // Turn count: one activity per task_started.
+    let turnCount = 0;
+    for (const ln of lines) {
+        if (ln.type === "event_msg" && ln.payload.type === "task_started") {
+            turnCount += 1;
+        }
+    }
+    counts.activity_start = turnCount;
+    counts.activity_end = turnCount;
+    // tool_call + file_change
+    const config = (0, config_1.loadConfig)(target.projectDir);
+    let toolCalls = 0;
+    let fileChanges = 0;
+    for (const ln of lines) {
+        if (ln.type !== "response_item") {
+            continue;
+        }
+        const payload = ln.payload;
+        // Mirror runner.ts: count BOTH function_call and custom_tool_call.
+        // Codex 0.135+ emits apply_patch as custom_tool_call (raw `input`),
+        // not function_call (JSON `arguments`). Without this dual match,
+        // dry-run summary under-counts tool_call + file_change on every
+        // Codex 0.135+ rollout, telling operators the import is smaller
+        // than it actually is.
+        const isFunctionCall = payload.type === "function_call";
+        const isCustomToolCall = payload.type === "custom_tool_call";
+        if (!isFunctionCall && !isCustomToolCall) {
+            continue;
+        }
+        toolCalls += 1;
+        let name;
+        let patchBody;
+        if (isFunctionCall) {
+            const fc = ln.payload;
+            name = fc.name;
+            patchBody = name === "apply_patch" ? (0, apply_patch_1.extractApplyPatchBody)(fc.arguments) : null;
+        }
+        else {
+            const ctc = ln.payload;
+            name = ctc.name;
+            patchBody = name === "apply_patch" && typeof ctc.input === "string" ? ctc.input : null;
+        }
+        if (name === "apply_patch" && patchBody !== null) {
+            let entries = [];
+            try {
+                entries = (0, clear_verdict_1.parseApplyPatchBody)(patchBody);
+            }
+            catch {
+                entries = [];
+            }
+            for (const e of entries) {
+                if ((0, config_1.requiresVerification)(e.path, config)) {
+                    fileChanges += 1;
+                }
+            }
+        }
+    }
+    counts.tool_call = toolCalls;
+    counts.file_change = fileChanges;
+    // api_request (gated)
+    if (!skipAnalytics && (0, config_1.isAnalyticsApiRequestEventsEnabled)(target.projectDir)) {
+        const meta = firstSessionMeta(lines);
+        const ctx = {
+            sessionId: target.sessionId,
+            projectName: target.projectName,
+            defaultModel: (0, api_request_1.defaultModelFromSessionMeta)(meta),
+        };
+        const apiResult = (0, api_request_1.deriveCodexApiRequestEvents)(lines, ctx);
+        counts.api_request = apiResult.events.length;
+    }
+    // session_analytics
+    let costUsd = 0;
+    let analyticsWireBytes = 0;
+    if (!skipAnalytics) {
+        const analytics = (0, analytics_runner_1.runCodexImportAnalytics)({
+            sessionId: target.sessionId,
+            projectName: target.projectName,
+            transcriptPath: target.transcriptPath,
+        });
+        if (analytics.sessionAnalytics !== null) {
+            counts.session_analytics = 1;
+            // analytics is now NESTED under the event (see analytics-runner.ts
+            // shape fix); reach into the body for cost_usd.
+            costUsd = analytics.sessionAnalytics.analytics?.usage?.cost_usd ?? 0;
+            analyticsWireBytes = Buffer.byteLength(JSON.stringify(analytics.sessionAnalytics), "utf-8");
+        }
+    }
+    // Wire-byte rough estimate — non-analytics events average ~256 B each
+    // (same heuristic Claude summary uses).
+    const ESTIMATED_NON_ANALYTICS_EVENT_BYTES = 256;
+    const nonAnalyticsCount = counts.session_start + counts.session_end
+        + counts.activity_start + counts.activity_end
+        + counts.tool_call + counts.file_change
+        + counts.api_request;
+    const wireBytes = analyticsWireBytes + nonAnalyticsCount * ESTIMATED_NON_ANALYTICS_EVENT_BYTES;
+    return { counts, costUsd, wireBytes };
+}
+function parseLines(text) {
+    const out = [];
+    for (const line of text.split("\n")) {
+        if (line.length === 0) {
+            continue;
+        }
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            // skip
+        }
+    }
+    return out;
+}
+function firstSessionMeta(lines) {
+    for (const ln of lines) {
+        if (ln.type === "session_meta") {
+            return ln.payload;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=summary.js.map

package/dist/import/codex/summary.js.map

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

package/dist/import/events/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/import/events/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,MAAM,WAAW,YAAY;IACzB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,GACvB,mBAAmB,CAWrB;AAED,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,GACvB,iBAAiB,CAenB"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/import/events/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,MAAM,WAAW,YAAY;IACzB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,GACvB,mBAAmB,CAmBrB;AAED,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,GACvB,iBAAiB,CAsBnB"}

package/dist/import/events/activity.js

@@ -16,10 +16,18 @@ exports.buildActivityEnd = buildActivityEnd;
 const ids_1 = require("../ids");
 function buildActivityStart(sessionId, projectName, boundary) {
     const activityId = (0, ids_1.deriveActivityId)(sessionId, boundary.turnIndex, boundary.startTime);
+    // Guard the timestamp parse — Claude transcript-walk defaults a missing
+    // turn-start line timestamp to "" (transcript-walk.ts:145); Codex
+    // task_started timestamps come straight from the rollout with no
+    // validation. Without this guard, Date.parse returns NaN which
+    // JSON.stringify serializes as wire `null`, while the matching
+    // `buildActivityEnd` already falls back to startMs (line ~62) — the
+    // start/end pair shipped asymmetric values for the same logical turn.
+    const startMs = Date.parse(boundary.startTime);
     return {
         id: (0, ids_1.deriveActivityStartEventId)(sessionId, boundary.turnIndex),
         type: "activity_start",
-        timestamp: Date.parse(boundary.startTime),
+        timestamp: Number.isFinite(startMs) ? startMs : 0,
         session_id: sessionId,
         project_name: projectName,
         activity_id: activityId,
@@ -31,6 +39,14 @@ function buildActivityEnd(sessionId, projectName, boundary) {
     const startMs = Date.parse(boundary.startTime);
     const endMs = Date.parse(boundary.endTime);
     const durationMs = Number.isFinite(endMs) && Number.isFinite(startMs) ? endMs - startMs : 0;
+    // Omit `reason` — live `endActivity` (hooks/core/activity.ts:60-66)
+    // does NOT set this field, so the import-side `"import"` value used
+    // to OVERWRITE live's omitted/absent field via backend
+    // (session_id, id) latest-wins dedup. Cross-pipeline divergence:
+    // Claude live = omitted, Codex live verify-gate = omitted, Codex live
+    // monitoring = "checkpoint", import = "import" — same wire field
+    // flipping per emit source. Dropping `reason` here aligns import with
+    // the dominant live behavior (omitted) and stops the flip.
     return {
         id: (0, ids_1.deriveActivityEndEventId)(sessionId, boundary.turnIndex),
         type: "activity_end",
@@ -39,7 +55,6 @@ function buildActivityEnd(sessionId, projectName, boundary) {
         project_name: projectName,
         activity_id: activityId,
         duration: durationMs,
-        reason: "import",
     };
 }
 //# sourceMappingURL=activity.js.map

package/dist/import/events/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/import/events/activity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAcH,gDAeC;AAED,4CAmBC;AA/CD,gCAAgG;AAWhG,SAAgB,kBAAkB,CAC9B,SAAiB,EACjB,WAAmB,EACnB,QAAsB;IAEtB,MAAM,UAAU,GAAW,IAAA,sBAAgB,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,OAAO;QACH,EAAE,EAAE,IAAA,gCAA0B,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC7D,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzC,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE,aAAa;KACxB,CAAC;AACN,CAAC;AAED,SAAgB,gBAAgB,CAC5B,SAAiB,EACjB,WAAmB,EACnB,QAAsB;IAEtB,MAAM,UAAU,GAAW,IAAA,sBAAgB,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,UAAU,GAAW,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,OAAO;QACH,EAAE,EAAE,IAAA,8BAAwB,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC3D,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;QACnD,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,QAAQ;KACnB,CAAC;AACN,CAAC"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/import/events/activity.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAcH,gDAuBC;AAED,4CA0BC;AA9DD,gCAAgG;AAWhG,SAAgB,kBAAkB,CAC9B,SAAiB,EACjB,WAAmB,EACnB,QAAsB;IAEtB,MAAM,UAAU,GAAW,IAAA,sBAAgB,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,wEAAwE;IACxE,kEAAkE;IAClE,iEAAiE;IACjE,+DAA+D;IAC/D,+DAA+D;IAC/D,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,OAAO,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvD,OAAO;QACH,EAAE,EAAE,IAAA,gCAA0B,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC7D,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjD,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE,aAAa;KACxB,CAAC;AACN,CAAC;AAED,SAAgB,gBAAgB,CAC5B,SAAiB,EACjB,WAAmB,EACnB,QAAsB;IAEtB,MAAM,UAAU,GAAW,IAAA,sBAAgB,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,UAAU,GAAW,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,oEAAoE;IACpE,oEAAoE;IACpE,uDAAuD;IACvD,iEAAiE;IACjE,sEAAsE;IACtE,iEAAiE;IACjE,sEAAsE;IACtE,2DAA2D;IAC3D,OAAO;QACH,EAAE,EAAE,IAAA,8BAAwB,EAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC3D,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;QACnD,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,WAAW;QACzB,WAAW,EAAE,UAAU;QACvB,QAAQ,EAAE,UAAU;KACvB,CAAC;AACN,CAAC"}

package/dist/import/events/session.d.ts

@@ -19,6 +19,16 @@ export declare function buildSessionStart(target: ImportTarget, client: string):
 /**
  * Build a `session_end` event. `endTimestampMs` and `endReason` come from
  * the transcript tail (last-line timestamp and summary line if present).
+ *
+ * `endReason` is OPTIONAL — when the transcript carries no derivable
+ * end-reason (no `summary` tail line on Claude), pass `undefined` so the
+ * field is OMITTED from the wire payload via JSON.stringify. Don't fall
+ * back to a placeholder string like `"unknown"` — `session_end.id` is
+ * deterministic per session, so the backend dedups live ↔ import on
+ * `(session_id, id)` and a placeholder would overwrite live's real
+ * reason (`"clear"` / `"logout"` / `"prompt_input_exit"` / …) with junk.
+ * JSON.stringify drops `undefined` keys; live's value wins via
+ * latest-wins UPSERT.
  */
-export declare function buildSessionEnd(target: ImportTarget, endTimestampMs: number, endReason: string): SessionEndAction;
+export declare function buildSessionEnd(target: ImportTarget, endTimestampMs: number, endReason: string | undefined): SessionEndAction;
 //# sourceMappingURL=session.d.ts.map

package/dist/import/events/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/import/events/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAU1F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAClB,gBAAgB,CAUlB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/import/events/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAkB1F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC9B,gBAAgB,CAUlB"}

package/dist/import/events/session.js

@@ -19,6 +19,15 @@ const ids_1 = require("../ids");
  * this stays generic.
  */
 function buildSessionStart(target, client) {
+    // Omit `source`. Live mode emits a meaningful host value
+    // (`"startup"` / `"resume"` / `"clear"` on Claude; `"startup"` /
+    // `"resume"` on Codex) which downstream analytics use to distinguish
+    // a real session resume from a fresh boot. `session_start.id` is
+    // deterministic per session, so backend `(session_id, id)` latest-wins
+    // dedup would otherwise overwrite live's real `source` with the
+    // import-time literal `"import"` on every re-import. JSON.stringify
+    // drops undefined keys → live's value survives. Mirror of the
+    // `session_end.reason` precedent below.
     return {
         id: (0, ids_1.deriveSessionStartEventId)(target.sessionId),
         type: "session_start",
@@ -26,12 +35,21 @@ function buildSessionStart(target, client) {
         session_id: target.sessionId,
         project_name: target.projectName,
         client,
-        source: "import",
     };
 }
 /**
  * Build a `session_end` event. `endTimestampMs` and `endReason` come from
  * the transcript tail (last-line timestamp and summary line if present).
+ *
+ * `endReason` is OPTIONAL — when the transcript carries no derivable
+ * end-reason (no `summary` tail line on Claude), pass `undefined` so the
+ * field is OMITTED from the wire payload via JSON.stringify. Don't fall
+ * back to a placeholder string like `"unknown"` — `session_end.id` is
+ * deterministic per session, so the backend dedups live ↔ import on
+ * `(session_id, id)` and a placeholder would overwrite live's real
+ * reason (`"clear"` / `"logout"` / `"prompt_input_exit"` / …) with junk.
+ * JSON.stringify drops `undefined` keys; live's value wins via
+ * latest-wins UPSERT.
  */
 function buildSessionEnd(target, endTimestampMs, endReason) {
     return {

package/dist/import/events/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/import/events/session.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAaH,8CAUC;AAMD,0CAcC;AAvCD,gCAA4E;AAE5E;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,MAAoB,EAAE,MAAc;IAClE,OAAO;QACH,EAAE,EAAE,IAAA,+BAAyB,EAAC,MAAM,CAAC,SAAS,CAAC;QAC/C,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,MAAM,CAAC,cAAc;QAChC,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,MAAM;QACN,MAAM,EAAE,QAAQ;KACnB,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC3B,MAAoB,EACpB,cAAsB,EACtB,SAAiB;IAEjB,OAAO;QACH,EAAE,EAAE,IAAA,6BAAuB,EAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,cAAc;KACnD,CAAC;AACN,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/import/events/session.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAaH,8CAkBC;AAgBD,0CAcC;AAzDD,gCAA4E;AAE5E;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,MAAoB,EAAE,MAAc;IAClE,yDAAyD;IACzD,iEAAiE;IACjE,qEAAqE;IACrE,iEAAiE;IACjE,uEAAuE;IACvE,gEAAgE;IAChE,oEAAoE;IACpE,8DAA8D;IAC9D,wCAAwC;IACxC,OAAO;QACH,EAAE,EAAE,IAAA,+BAAyB,EAAC,MAAM,CAAC,SAAS,CAAC;QAC/C,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,MAAM,CAAC,cAAc;QAChC,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,MAAM;KACT,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAC3B,MAAoB,EACpB,cAAsB,EACtB,SAA6B;IAE7B,OAAO;QACH,EAAE,EAAE,IAAA,6BAAuB,EAAC,MAAM,CAAC,SAAS,CAAC;QAC7C,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,cAAc;KACnD,CAAC;AACN,CAAC"}

package/dist/import/ids.js

@@ -27,11 +27,11 @@ exports.deriveActivityId = deriveActivityId;
 exports.deriveToolCallEventIdFromToolUseId = deriveToolCallEventIdFromToolUseId;
 exports.deriveFileChangeEventId = deriveFileChangeEventId;
 const crypto_1 = require("crypto");
-const projection_1 = require("../analytics/projection");
+const event_1 = require("../lib/event");
 /** SHA-256 the input and format the first 32 hex chars as a UUID. */
 function sha256Uuid(input) {
     const hex32 = (0, crypto_1.createHash)("sha256").update(input).digest("hex").slice(0, 32);
-    return (0, projection_1.formatHexAsUuid)(hex32);
+    return (0, event_1.formatHexAsUuid)(hex32);
 }
 function deriveSessionStartEventId(sessionId) {
     return sha256Uuid(`session_start:${sessionId}`);
@@ -68,7 +68,7 @@ function deriveActivityEndEventId(sessionId, turnIndex) {
  */
 function deriveActivityId(sessionId, turnIndex, startTime) {
     const hex32 = (0, crypto_1.createHash)("sha256").update(`${sessionId}|${turnIndex}|${startTime}`).digest("hex").slice(0, 32);
-    return (0, projection_1.formatHexAsUuid)(hex32);
+    return (0, event_1.formatHexAsUuid)(hex32);
 }
 /**
  * Default tool_call event id when `_metadata.toolCallId` is absent (transcript

package/dist/import/ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/import/ids.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAWH,8DAEC;AAED,0DAEC;AAQD,gEAEC;AAED,4DAEC;AAiBD,4CAGC;AAUD,gFAEC;AAED,0DAEC;AAjED,mCAAoC;AACpC,wDAA0D;AAE1D,qEAAqE;AACrE,SAAS,UAAU,CAAC,KAAa;IAC7B,MAAM,KAAK,GAAW,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpF,OAAO,IAAA,4BAAe,EAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,SAAgB,yBAAyB,CAAC,SAAiB;IACvD,OAAO,UAAU,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,uBAAuB,CAAC,SAAiB;IACrD,OAAO,UAAU,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,SAAiB,EAAE,SAAiB;IAC3E,OAAO,UAAU,CAAC,kBAAkB,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,wBAAwB,CAAC,SAAiB,EAAE,SAAiB;IACzE,OAAO,UAAU,CAAC,gBAAgB,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,SAAiB,EAAE,SAAiB;IACpF,MAAM,KAAK,GAAW,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvH,OAAO,IAAA,4BAAe,EAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kCAAkC,CAAC,SAAiB,EAAE,SAAiB;IACnF,OAAO,UAAU,CAAC,aAAa,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,uBAAuB,CAAC,SAAiB,EAAE,SAAiB;IACxE,OAAO,UAAU,CAAC,eAAe,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/import/ids.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAWH,8DAEC;AAED,0DAEC;AAQD,gEAEC;AAED,4DAEC;AAiBD,4CAGC;AAUD,gFAEC;AAED,0DAEC;AAjED,mCAAoC;AACpC,wCAA+C;AAE/C,qEAAqE;AACrE,SAAS,UAAU,CAAC,KAAa;IAC7B,MAAM,KAAK,GAAW,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpF,OAAO,IAAA,uBAAe,EAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,SAAgB,yBAAyB,CAAC,SAAiB;IACvD,OAAO,UAAU,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,uBAAuB,CAAC,SAAiB;IACrD,OAAO,UAAU,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,SAAiB,EAAE,SAAiB;IAC3E,OAAO,UAAU,CAAC,kBAAkB,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,wBAAwB,CAAC,SAAiB,EAAE,SAAiB;IACzE,OAAO,UAAU,CAAC,gBAAgB,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,gBAAgB,CAAC,SAAiB,EAAE,SAAiB,EAAE,SAAiB;IACpF,MAAM,KAAK,GAAW,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvH,OAAO,IAAA,uBAAe,EAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kCAAkC,CAAC,SAAiB,EAAE,SAAiB;IACnF,OAAO,UAAU,CAAC,aAAa,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,uBAAuB,CAAC,SAAiB,EAAE,SAAiB;IACxE,OAAO,UAAU,CAAC,eAAe,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/import/pipeline.d.ts

@@ -1,16 +1,16 @@
 /**
  * IronBee CLI — Import Module Generic Pipeline Dispatcher
  *
- * The single point that knows about client-specific runners. v1 only
- * ships Claude; when Cursor support lands, every function here gains a
- * branch on `scope.client` (or per-target discriminator) that dispatches
- * to `cursor/{discovery,summary,runner}` — but no other file in the
- * import tree changes. This is the contract that lets `commands/import.ts`
- * stay client-agnostic.
+ * The single point that knows about client-specific runners. Dispatches
+ * across Claude AND Codex by default: discovery scans both stores +
+ * unions the results; each `ImportTarget` carries a `client`
+ * discriminator so per-session runner / estimator routing is automatic.
+ * New clients plug in by adding a `discovery` / `summary` / `runner`
+ * triple here and one branch in each dispatch function.
  *
- * Isolation principle: Claude/Cursor logic stays separated
- * by file. The CLI command depends on this dispatcher, NOT on any
- * `claude/*` module directly.
+ * Isolation principle: per-client logic stays separated by file. The CLI
+ * command depends on this dispatcher, NOT on any `<client>/*` module
+ * directly.
  */
 import { ImportResult, ImportScope, ImportSummary, ImportTarget, ImportTimeRange } from "./types";
 export interface ImportSessionOpts {
@@ -26,16 +26,23 @@ export interface EstimateOpts {
     force: boolean;
 }
 /**
- * Discover candidate transcripts on disk. v1 always routes through Claude;
- * when Cursor lands, this branches on `scope` (or a separate `--client`
- * flag) and dispatches to `cursor/discovery`.
+ * Discover candidate transcripts on disk across every supported client.
+ * Each `ImportTarget` carries its own `client` field so downstream
+ * dispatch (estimateImport / importSession) routes automatically.
+ *
+ * `transcript` scope is single-file. Routing is filename-based: Codex
+ * rollouts match `rollout-<ISO>-<UUID>.jsonl`, everything else goes to
+ * Claude. Without this guard, Claude's `singleTranscriptToTarget` would
+ * accept any `.jsonl` with a top-level `timestamp` field — which Codex
+ * rollouts happen to have — producing a spurious mis-typed Claude target
+ * alongside the correct Codex one.
  */
 export declare function findTranscripts(scope: ImportScope): ImportTarget[];
 /**
- * Pre-pass estimate for the dry-run summary. Same dispatch shape as
- * `findTranscripts` — currently Claude-only.
+ * Pre-pass estimate for the dry-run summary. Splits the target list by
+ * client, calls each client's estimator, then merges the summaries.
  */
 export declare function estimateImport(opts: EstimateOpts): ImportSummary;
-/** Per-session entry point. */
+/** Per-session entry point — dispatches on `target.client`. */
 export declare function importSession(opts: ImportSessionOpts): Promise<ImportResult>;
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/import/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/import/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKlG,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,EAAE,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAOhE;AAED,+BAA+B;AAC/B,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAElF"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/import/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAyD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAoB,MAAM,SAAS,CAAC;AAW3K,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,EAAE,CAWlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAehE;AAED,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKlF"}

package/dist/import/pipeline.js

@@ -2,46 +2,127 @@
 /**
  * IronBee CLI — Import Module Generic Pipeline Dispatcher
  *
- * The single point that knows about client-specific runners. v1 only
- * ships Claude; when Cursor support lands, every function here gains a
- * branch on `scope.client` (or per-target discriminator) that dispatches
- * to `cursor/{discovery,summary,runner}` — but no other file in the
- * import tree changes. This is the contract that lets `commands/import.ts`
- * stay client-agnostic.
+ * The single point that knows about client-specific runners. Dispatches
+ * across Claude AND Codex by default: discovery scans both stores +
+ * unions the results; each `ImportTarget` carries a `client`
+ * discriminator so per-session runner / estimator routing is automatic.
+ * New clients plug in by adding a `discovery` / `summary` / `runner`
+ * triple here and one branch in each dispatch function.
  *
- * Isolation principle: Claude/Cursor logic stays separated
- * by file. The CLI command depends on this dispatcher, NOT on any
- * `claude/*` module directly.
+ * Isolation principle: per-client logic stays separated by file. The CLI
+ * command depends on this dispatcher, NOT on any `<client>/*` module
+ * directly.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findTranscripts = findTranscripts;
 exports.estimateImport = estimateImport;
 exports.importSession = importSession;
+const path_1 = require("path");
+const types_1 = require("./types");
 const discovery_1 = require("./claude/discovery");
 const summary_1 = require("./claude/summary");
 const runner_1 = require("./claude/runner");
+const discovery_2 = require("./codex/discovery");
+const summary_2 = require("./codex/summary");
+const runner_2 = require("./codex/runner");
+/** Codex rollout filenames: `rollout-<ISO>-<UUID>.jsonl`. Mirror of the regex in `analytics/codex/transcript.ts:sessionIdFromRolloutPath`. */
+const CODEX_ROLLOUT_FILENAME = /^rollout-.+-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.jsonl$/i;
 /**
- * Discover candidate transcripts on disk. v1 always routes through Claude;
- * when Cursor lands, this branches on `scope` (or a separate `--client`
- * flag) and dispatches to `cursor/discovery`.
+ * Discover candidate transcripts on disk across every supported client.
+ * Each `ImportTarget` carries its own `client` field so downstream
+ * dispatch (estimateImport / importSession) routes automatically.
+ *
+ * `transcript` scope is single-file. Routing is filename-based: Codex
+ * rollouts match `rollout-<ISO>-<UUID>.jsonl`, everything else goes to
+ * Claude. Without this guard, Claude's `singleTranscriptToTarget` would
+ * accept any `.jsonl` with a top-level `timestamp` field — which Codex
+ * rollouts happen to have — producing a spurious mis-typed Claude target
+ * alongside the correct Codex one.
  */
 function findTranscripts(scope) {
-    return (0, discovery_1.findClaudeTranscripts)(scope);
+    if (scope.kind === "transcript") {
+        if (CODEX_ROLLOUT_FILENAME.test((0, path_1.basename)(scope.path))) {
+            return (0, discovery_2.findCodexTranscripts)(scope);
+        }
+        return (0, discovery_1.findClaudeTranscripts)(scope);
+    }
+    const out = [];
+    out.push(...(0, discovery_1.findClaudeTranscripts)(scope));
+    out.push(...(0, discovery_2.findCodexTranscripts)(scope));
+    return out;
 }
 /**
- * Pre-pass estimate for the dry-run summary. Same dispatch shape as
- * `findTranscripts` — currently Claude-only.
+ * Pre-pass estimate for the dry-run summary. Splits the target list by
+ * client, calls each client's estimator, then merges the summaries.
  */
 function estimateImport(opts) {
-    return (0, summary_1.estimateClaudeImport)({
-        targets: opts.targets,
+    const split = partitionByClient(opts.targets);
+    const claudeSummary = (0, summary_1.estimateClaudeImport)({
+        targets: split.claude,
+        timeRange: opts.timeRange,
+        concurrency: opts.concurrency,
+        force: opts.force,
+    });
+    const codexSummary = (0, summary_2.estimateCodexImport)({
+        targets: split.codex,
         timeRange: opts.timeRange,
         concurrency: opts.concurrency,
         force: opts.force,
     });
+    return mergeSummaries(claudeSummary, codexSummary, opts);
 }
-/** Per-session entry point. */
+/** Per-session entry point — dispatches on `target.client`. */
 async function importSession(opts) {
+    if (opts.target.client === "codex") {
+        return (0, runner_2.importCodexSession)({ target: opts.target, force: opts.force, batchSize: opts.batchSize ?? null });
+    }
     return (0, runner_1.importClaudeSession)({ target: opts.target, force: opts.force, batchSize: opts.batchSize ?? null });
 }
+function partitionByClient(targets) {
+    const out = { claude: [], codex: [] };
+    for (const t of targets) {
+        out[t.client].push(t);
+    }
+    return out;
+}
+function mergeSummaries(a, b, opts) {
+    const counts = (0, types_1.emptyEventCounts)();
+    for (const key of Object.keys(counts)) {
+        counts[key] = a.estimatedEvents[key] + b.estimatedEvents[key];
+    }
+    return {
+        // Dedupe per-projectDir. Without this, a project with sessions
+        // from BOTH Claude AND Codex shows up TWICE in the dry-run table
+        // (one row from each per-client summary's own per-project Map),
+        // inflating "N project(s) found" and confusing the operator.
+        projects: dedupeProjectsByDir([...a.projects, ...b.projects]),
+        timeRange: opts.timeRange,
+        toImportCount: a.toImportCount + b.toImportCount,
+        skippedCount: a.skippedCount + b.skippedCount,
+        estimatedEvents: counts,
+        estimatedCostUsd: a.estimatedCostUsd + b.estimatedCostUsd,
+        estimatedWireBytes: a.estimatedWireBytes + b.estimatedWireBytes,
+        concurrency: opts.concurrency,
+        // Both summaries' collectorUrl is derived from the FIRST target's
+        // project config; when both are present they should be the same
+        // (a single collector per machine is the common case). Prefer the
+        // non-null one if they diverge — claude first.
+        collectorUrl: a.collectorUrl ?? b.collectorUrl,
+    };
+}
+/** Merge rows that share a `projectDir`, summing their counts. */
+function dedupeProjectsByDir(rows) {
+    const merged = new Map();
+    for (const row of rows) {
+        const existing = merged.get(row.projectDir);
+        if (existing === undefined) {
+            merged.set(row.projectDir, { ...row });
+            continue;
+        }
+        existing.found += row.found;
+        existing.skipped += row.skipped;
+        existing.toImport += row.toImport;
+    }
+    return Array.from(merged.values());
+}
 //# sourceMappingURL=pipeline.js.map

package/dist/import/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/import/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AA0BH,0CAEC;AAMD,wCAOC;AAGD,sCAEC;AA3CD,kDAA6E;AAC7E,8CAAwD;AACxD,4CAAsD;AAgBtD;;;;GAIG;AACH,SAAgB,eAAe,CAAC,KAAkB;IAC9C,OAAO,IAAA,iCAAc,EAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAkB;IAC7C,OAAO,IAAA,8BAAoB,EAAC;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;KACpB,CAAC,CAAC;AACP,CAAC;AAED,+BAA+B;AACxB,KAAK,UAAU,aAAa,CAAC,IAAuB;IACvD,OAAO,IAAA,4BAAmB,EAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;AAC9G,CAAC"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/import/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/import/types.d.ts

@@ -48,7 +48,11 @@ export interface ImportOptions {
     batchSize: number | null;
 }
 /** A single session that survived discovery + filtering, ready for import. */
+/** Which agent produced the transcript — drives per-client runner dispatch. */
+export type ImportClient = "claude" | "codex";
 export interface ImportTarget {
+    /** Source agent — picks the runner / event-builder pipeline. */
+    client: ImportClient;
     sessionId: string;
     transcriptPath: string;
     /** Best-effort decoded project directory. May not exist on disk. */