@makaio/framework 1.0.0-dev-1783282710723 → 1.0.0-dev-1783355411417

package/dist/{base-orchestrator-Cw0vpNgB.d.mts → base-orchestrator-BNysGvaM.d.mts}

@@ -176,6 +176,42 @@ interface ImportSegmentLineage {
   /** Message ID where this session diverged from parent (null for root, subagent, and compress). */
   forkPointMessageId: string | null;
 }
+/**
+ * Reconstructed conversation turn within an import segment.
+ *
+ * Importers derive this structure from their turn reconstruction (see
+ * `TurnTracker`) during {@link LogImporter.processLogFile}. The persistence
+ * layer uses it to create real turn rows and link message `turnId`s, so
+ * imported messages participate in the same turn model as live sessions.
+ * @remarks
+ * The `turnAnchorId` is the idempotency anchor for turn upserts: re-parsing
+ * the same file (e.g., after compaction forces a re-read from byte 0) must
+ * yield the same anchor for the same turn, so existing turn rows are matched
+ * instead of duplicated or renumbered. This requirement implies that every
+ * synthesized message an importer emits must carry a DETERMINISTIC
+ * `adapterMessageId` — random IDs would break anchor stability across
+ * re-parses.
+ * @see {@link ImportSegment.turns} - Where these turns are carried
+ * @see {@link ProcessLogFileResult.turns} - Importer output containing turns
+ */
+interface ImportSegmentTurn {
+  /**
+   * `adapterMessageId` (external record uuid) of the turn-start user message —
+   * the idempotency anchor. MUST be stable across re-parses of the same file.
+   */
+  turnAnchorId: string;
+  /**
+   * `adapterMessageId`s of ALL messages belonging to this turn, in transcript
+   * order (user + assistant).
+   */
+  adapterMessageIds: string[];
+  /** Unix ms timestamp of the turn-start record. */
+  startedAt: number;
+  /** Unix ms timestamp of the turn-complete record. */
+  completedAt: number;
+  /** Turn outcome. Defaults to `'completed'` when omitted. */
+  status?: 'completed' | 'error';
+}
 /**
  * Compaction boundary metadata from the external tool's log.
  */
@@ -206,6 +242,18 @@ interface ImportSegment {
   messages: StorageMessagePayload[];
   /** Compaction metadata from the boundary record (absent if not a compress child). */
   compaction?: CompactionMetadata;
+  /**
+   * Reconstructed turns for this segment, in transcript order.
+   * Absent when the importer performs no turn reconstruction.
+   * @see {@link ImportSegmentTurn}
+   */
+  turns?: ImportSegmentTurn[];
+  /**
+   * Per-segment sidechain flag extracted from the tool's log records.
+   * `true` when this segment is a sidechain (e.g., a subagent transcript)
+   * rather than the main conversation thread.
+   */
+  isSidechain?: boolean;
   /** Child segments (compress children, nested compactions). */
   children?: ImportSegment[];
 }
@@ -231,12 +279,26 @@ interface ProcessLogFileResult {
   compressChildren?: ProcessLogFileResult[];
   /** Compaction metadata from the boundary record. */
   compactionMetadata?: CompactionMetadata;
+  /**
+   * Reconstructed turns for this file/segment, in transcript order.
+   * Absent when the importer performs no turn reconstruction.
+   * @see {@link ImportSegmentTurn}
+   */
+  turns?: ImportSegmentTurn[];
+  /**
+   * Per-file/segment sidechain flag extracted from the tool's log records.
+   * `true` when the transcript is a sidechain (e.g., a subagent transcript)
+   * rather than the main conversation thread.
+   */
+  isSidechain?: boolean;
 }
 /**
  * Converts a {@link ProcessLogFileResult} to a canonical {@link ImportSegment}.
  *
  * Strips bus-emission fields (sessionEvent, messageEvents) and recursively
- * converts children, producing the clean structural tree.
+ * converts children, producing the clean structural tree. Structural fields
+ * (`turns`, `isSidechain`) are not bus-emission data and survive the
+ * conversion.
  * @param result - The full import result from an adapter
  * @returns A canonical import segment tree
  */
@@ -273,6 +335,12 @@ interface DiscoveryMetadata {
   kind?: SessionLineageKind;
   /** Unix ms timestamp of when the session started in the external tool. */
   startedAt?: number;
+  /**
+   * Whether the discovered transcript is a sidechain (e.g., a subagent
+   * transcript) rather than the main conversation thread. Extracted from
+   * the tool's log records; `undefined` when the format has no such flag.
+   */
+  isSidechain?: boolean;
 }
 /**
  * Contract for log importers (adapters and extensions).
@@ -769,4 +837,4 @@ declare abstract class BaseLogOrchestrator<TRecord, TState = unknown> {
   protected queueCursorUpdate(filePath: string, bytesRead: number, startOffset: number, mtime: Date, isJsonFormat: boolean, sessionContext?: ImportCursorPosition['sessionContext'], precedingEventPromises?: Promise<void>[]): Promise<void>;
 }
 //#endregion
-export { LogImporterConfig as _, CompactionMetadata as a, StorageMessagePayload as b, ExternalToolIdentifiers as c, ImportMetadata as d, ImportSegment as f, LogImporter as g, LogImportTestConfig as h, LogFileChangeEvent as i, ExternalToolMeta as l, LogImportSessionContext as m, LogOrchestratorConfig as n, DiscoveryMetadata as o, ImportSegmentLineage as p, ParseFileResult as r, ExternalToolIdentifier as s, BaseLogOrchestrator as t, ImportCursorPosition as u, NormalizedEvent as v, toImportSegment as x, ProcessLogFileResult as y };
+export { toImportSegment as S, LogImporter as _, CompactionMetadata as a, ProcessLogFileResult as b, ExternalToolIdentifiers as c, ImportMetadata as d, ImportSegment as f, LogImportTestConfig as g, LogImportSessionContext as h, LogFileChangeEvent as i, ExternalToolMeta as l, ImportSegmentTurn as m, LogOrchestratorConfig as n, DiscoveryMetadata as o, ImportSegmentLineage as p, ParseFileResult as r, ExternalToolIdentifier as s, BaseLogOrchestrator as t, ImportCursorPosition as u, LogImporterConfig as v, StorageMessagePayload as x, NormalizedEvent as y };