@makaio/framework 1.0.0-dev-1782480236258 → 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 };

package/dist/bus/index.d.mts

@@ -2676,6 +2676,16 @@ declare class CorrelationTracker {
    * @param error - Optional cancellation error
    */
   cancel(correlationId: string, error?: Error): void;
+  /**
+   * Reject all pending requests with the given error.
+   *
+   * Clears all timeouts, removes abort listeners, rejects every pending
+   * promise, and empties the map. New entries can still be tracked after
+   * this call — use this for connection-loss scenarios where the transport
+   * will reconnect.
+   * @param error - Error to reject all pending requests with
+   */
+  rejectAll(error: Error): void;
   /**
    * Clean up all pending requests.
    *
@@ -3066,6 +3076,34 @@ declare class ChannelOnlyError extends BusError {
   constructor(subject: string);
 }
 //#endregion
+//#region core/bus-core/src/errors/connection-lost-error.d.ts
+/**
+ * Stable error code for connection-lost failures.
+ *
+ * Distinguishes transport disconnection from "no handler registered"
+ * ({@link NoHandlerError}) so callers can decide whether to retry.
+ */
+declare const CONNECTION_LOST_ERROR_CODE: "CONNECTION_LOST";
+/**
+ * Error thrown when a pending request is abandoned because the underlying
+ * transport connection was lost before a response arrived.
+ *
+ * Unlike {@link NoHandlerError}, this error indicates that a handler may
+ * well exist — the connection dropped before the response could be
+ * delivered. Callers should treat this as retryable.
+ */
+declare class ConnectionLostError extends BusError {
+  readonly code: "CONNECTION_LOST";
+  /**
+   * Whether the operation is safe to retry after reconnection.
+   */
+  readonly retryable = true;
+  /**
+   * @param transportName - Name of the transport whose connection was lost
+   */
+  constructor(transportName: string);
+}
+//#endregion
 //#region core/bus-core/src/errors/local-subject-error.d.ts
 /**
  * Thrown when a remote peer attempts to invoke a local-only subject over a
@@ -3992,4 +4030,4 @@ interface ProjectedTelemetryTransportOptions {
  */
 declare function createProjectedTelemetryTransport(options: ProjectedTelemetryTransportOptions): BusTransport;
 //#endregion
-export { type BroadcastContext, type BroadcastResult, type BusBroadcastMessage, type BusBroadcastResponseMessage, BusError, type BusEventMessage, type BusHeartbeatMessage, BusLifecycle, type BusMessage, type BusMessageObserver, type BusNamespace, type BusReceiveHandler, type BusRequestMessage, type BusResponseMessage, type BusSubscribeMessage, type BusSubscribeSyncCompleteMessage, type BusSubscriptionAckMessage, type BusTransport, type BusTransportError, type BusTransportKeys, type BusTransportRegistry, type BusUnsubscribeMessage, type BusUrlConfig, type BusValidationMode, ChannelAuthError, ChannelClosedError, type ChannelEndpoint, type ChannelEndpointOptions, ChannelOnlyError, type ConnectOptions, type ConnectedPayload, CorrelationTracker, DEFAULT_REQUEST_TIMEOUT_MS, type DefinedSubjectExtension, type DisconnectedPayload, type EventSubjectExtension, type ExtendedSubjectDefinition, type ExtensionNamespace, type ExtensionNamespaceConfig, type ExtensionNamespaceExtensions, type ExtensionNamespaceFromConfig, type IDirectChannel, type IFilteredBus, type IMakaioBus, type InterceptorContext, LOCAL_ORIGIN, LocalSubjectError, MakaioBus, type MakaioBusContext, NO_HANDLER_ERROR_CODE, type NamespaceRegistrationOptions, NoHandlerError, type ObservedBusMessage, type OnOptions, OnceAbortError, type OptionalResult, type ProjectableBusMessage, type ProjectedTelemetryTransportOptions, REMOTE_ORIGIN, RequestError, type RequestSubjectExtension, type SchemaViolationCallback, type SchemaViolationReport, type ScopedBus, type ScopedBusFor, type SubjectExtension, type SubjectTelemetryAttributes, type SubjectTelemetryProjectionInput, type SubjectTelemetryProjector, type SubjectTelemetryProjectorInput, type SubjectTelemetryProjectorRegistry, type SubscriptionEntry, SystemChannelSchemas, TimeoutError, type TransportRegistration, ValidationError, __resetWarnedSubjects, buildSubscribeMessage, buildUnsubscribeMessage, channelSubject, collectorOnlySubject, createBusContext, createBusInstance, createChannelEndpoint, createExtensionNamespace, createFilteredBus, createProjectedTelemetryTransport, createSubjectTelemetryProjectorRegistry, defaultTransports, defineSubjectExtension, deserializeTransportError, extendSubjectImpl as extendSubject, getFullSubjectForSubjectDefinition, getPath, getSubjectFromBusMessage, handleCorrelationResponse, isNoHandlerErrorForSubject, isRequestSchema, localSubject, matchesAnySubscription, matchesFilter, matchesSubscription, mergeFilters, openChannel, parseBusUrl, projectSubjectTelemetryFacts, serializeTransportError, shouldReceiveMessage, trackMessageCorrelation, waitForSubscriptionPropagation };
+export { type BroadcastContext, type BroadcastResult, type BusBroadcastMessage, type BusBroadcastResponseMessage, BusError, type BusEventMessage, type BusHeartbeatMessage, BusLifecycle, type BusMessage, type BusMessageObserver, type BusNamespace, type BusReceiveHandler, type BusRequestMessage, type BusResponseMessage, type BusSubscribeMessage, type BusSubscribeSyncCompleteMessage, type BusSubscriptionAckMessage, type BusTransport, type BusTransportError, type BusTransportKeys, type BusTransportRegistry, type BusUnsubscribeMessage, type BusUrlConfig, type BusValidationMode, CONNECTION_LOST_ERROR_CODE, ChannelAuthError, ChannelClosedError, type ChannelEndpoint, type ChannelEndpointOptions, ChannelOnlyError, type ConnectOptions, type ConnectedPayload, ConnectionLostError, CorrelationTracker, DEFAULT_REQUEST_TIMEOUT_MS, type DefinedSubjectExtension, type DisconnectedPayload, type EventSubjectExtension, type ExtendedSubjectDefinition, type ExtensionNamespace, type ExtensionNamespaceConfig, type ExtensionNamespaceExtensions, type ExtensionNamespaceFromConfig, type IDirectChannel, type IFilteredBus, type IMakaioBus, type InterceptorContext, LOCAL_ORIGIN, LocalSubjectError, MakaioBus, type MakaioBusContext, NO_HANDLER_ERROR_CODE, type NamespaceRegistrationOptions, NoHandlerError, type ObservedBusMessage, type OnOptions, OnceAbortError, type OptionalResult, type ProjectableBusMessage, type ProjectedTelemetryTransportOptions, REMOTE_ORIGIN, RequestError, type RequestSubjectExtension, type SchemaViolationCallback, type SchemaViolationReport, type ScopedBus, type ScopedBusFor, type SubjectExtension, type SubjectTelemetryAttributes, type SubjectTelemetryProjectionInput, type SubjectTelemetryProjector, type SubjectTelemetryProjectorInput, type SubjectTelemetryProjectorRegistry, type SubscriptionEntry, SystemChannelSchemas, TimeoutError, type TransportRegistration, ValidationError, __resetWarnedSubjects, buildSubscribeMessage, buildUnsubscribeMessage, channelSubject, collectorOnlySubject, createBusContext, createBusInstance, createChannelEndpoint, createExtensionNamespace, createFilteredBus, createProjectedTelemetryTransport, createSubjectTelemetryProjectorRegistry, defaultTransports, defineSubjectExtension, deserializeTransportError, extendSubjectImpl as extendSubject, getFullSubjectForSubjectDefinition, getPath, getSubjectFromBusMessage, handleCorrelationResponse, isNoHandlerErrorForSubject, isRequestSchema, localSubject, matchesAnySubscription, matchesFilter, matchesSubscription, mergeFilters, openChannel, parseBusUrl, projectSubjectTelemetryFacts, serializeTransportError, shouldReceiveMessage, trackMessageCorrelation, waitForSubscriptionPropagation };