@sentry/junior 0.105.0 → 0.107.0

package/dist/chat/conversations/history.d.ts

@@ -1,23 +1,145 @@
 /**
- * Durable agent execution history port.
+ * Durable conversation event history port.
  *
- * Steps are appended one row at a time under the conversation lease; context
- * rebuilds (compaction, handoff, rollback) open a new context epoch instead of
- * rewriting history. Each new epoch binds the model profile that owns it and
- * records the exact resolved model id for audit.
- * The step envelope is strictly validated — an unknown type or malformed shape
- * is corrupt state and fails loudly — while `pi_message` content stays
- * permissive because the Pi SDK owns the message shape.
+ * Events append under the conversation lease in stable sequence order.
+ * Compaction and handoff replace the active model history without rewriting
+ * prior events. Unsupported stored events remain readable as opaque facts,
+ * while malformed known events fail loudly. Provider-specific message fields
+ * are validated by the Pi adapter when it restores model context.
  */
 import { z } from "zod";
-declare const piMessageStepSchema: z.ZodObject<{
+/** Store one opaque agent-step payload while Pi owns provider validation. */
+export declare const conversationAgentStepPayloadSchema: z.ZodPipe<z.ZodObject<{
+    role: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<{
+    role: string;
+}, {
+    [x: string]: unknown;
+    role: string;
+}>>;
+/** The opaque Pi history entry carried by an `agent_step` event. */
+export type ConversationAgentStepPayload = z.output<typeof conversationAgentStepPayloadSchema>;
+/** Validate an event that intentionally replaces active model history. */
+export declare const historyReplacementSchema: z.ZodObject<{
+    data: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"handoff">;
+        modelProfile: z.ZodString;
+        modelId: z.ZodString;
+        triggeringToolCallId: z.ZodOptional<z.ZodString>;
+        replacementHistory: z.ZodArray<z.ZodObject<{
+            message: z.ZodPipe<z.ZodObject<{
+                role: z.ZodString;
+            }, z.core.$loose>, z.ZodTransform<{
+                role: string;
+            }, {
+                [x: string]: unknown;
+                role: string;
+            }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
+                actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    platform: z.ZodLiteral<"slack">;
+                    teamId: z.ZodString;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"local">;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"system">;
+                    name: z.ZodString;
+                }, z.core.$strict>], "platform">>;
+            }, z.core.$strict>>;
+            sourceEventSeq: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"compaction">;
+        modelProfile: z.ZodString;
+        modelId: z.ZodString;
+        replacementHistory: z.ZodArray<z.ZodObject<{
+            message: z.ZodPipe<z.ZodObject<{
+                role: z.ZodString;
+            }, z.core.$loose>, z.ZodTransform<{
+                role: string;
+            }, {
+                [x: string]: unknown;
+                role: string;
+            }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
+                actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    platform: z.ZodLiteral<"slack">;
+                    teamId: z.ZodString;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"local">;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"system">;
+                    name: z.ZodString;
+                }, z.core.$strict>], "platform">>;
+            }, z.core.$strict>>;
+            sourceEventSeq: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "type">;
+    createdAtMs: z.ZodNumber;
+}, z.core.$strict>;
+/** One atomically persisted model-history replacement. */
+export type HistoryReplacement = z.output<typeof historyReplacementSchema>;
+export declare const authorizationKindSchema: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
+/** Provider authorization family recorded by conversation events. */
+export type AuthorizationKind = z.output<typeof authorizationKindSchema>;
+/** Product surface that owns a durable conversation turn. */
+export declare const conversationTurnSurfaceSchema: z.ZodEnum<{
+    slack: "slack";
+    api: "api";
+    internal: "internal";
+    scheduler: "scheduler";
+}>;
+/** Stable, privacy-safe classification for a failed turn. */
+export declare const conversationTurnFailureCodeSchema: z.ZodEnum<{
+    agent_run_failed: "agent_run_failed";
+    delivery_failed: "delivery_failed";
+    model_execution_failed: "model_execution_failed";
+    persistence_failed: "persistence_failed";
+}>;
+/** Failure classification persisted without raw provider or exception data. */
+export type ConversationTurnFailureCode = z.output<typeof conversationTurnFailureCodeSchema>;
+/** Strict event-data contract reused by the SQL row codec. */
+export declare const conversationEventDataSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodLiteral<"message">;
+    messageId: z.ZodString;
+    role: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">, z.ZodLiteral<"system">]>;
+    text: z.ZodString;
+    authorIdentityId: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>, z.ZodObject<{
+    messageId: z.ZodString;
+    role: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">, z.ZodLiteral<"system">]>;
+    text: z.ZodString;
+    authorIdentityId: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"message_updated">;
+}, z.core.$strict>, z.ZodObject<{
     message: z.ZodPipe<z.ZodObject<{
         role: z.ZodString;
-    }, z.core.$loose>, z.ZodTransform<import("@earendil-works/pi-ai").AssistantMessage | import("@earendil-works/pi-ai").UserMessage | import("@earendil-works/pi-ai").ToolResultMessage<any> | import("@earendil-works/pi-agent-core").BashExecutionMessage | import("@earendil-works/pi-agent-core").CustomMessage<unknown> | import("@earendil-works/pi-agent-core").BranchSummaryMessage | import("@earendil-works/pi-agent-core").CompactionSummaryMessage, {
+    }, z.core.$loose>, z.ZodTransform<{
+        role: string;
+    }, {
         [x: string]: unknown;
         role: string;
     }>>;
-    createdAtMs: z.ZodNumber;
     provenance: z.ZodOptional<z.ZodObject<{
         authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
         actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -38,20 +160,93 @@ declare const piMessageStepSchema: z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strict>], "platform">>;
     }, z.core.$strict>>;
-}, z.core.$strict>;
-/** Validate one atomically persisted context epoch. */
-export declare const contextEpochStartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    reason: z.ZodLiteral<"initial">;
-    modelProfile: z.ZodLiteral<"standard">;
+    type: z.ZodLiteral<"agent_step">;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"mcp_provider_connected">;
+    provider: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"authorization_requested">;
+    kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
+    provider: z.ZodString;
+    actorId: z.ZodString;
+    authorizationId: z.ZodString;
+    delivery: z.ZodUnion<readonly [z.ZodLiteral<"private_link_sent">, z.ZodLiteral<"private_link_reused">]>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"authorization_completed">;
+    kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
+    provider: z.ZodString;
+    actorId: z.ZodString;
+    authorizationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_execution_started">;
+    toolCallId: z.ZodString;
+    toolName: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"message_handled">;
+    messageId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"messages_summarized">;
+    historyFromSeq: z.ZodNumber;
+    compactions: z.ZodArray<z.ZodObject<{
+        coveredMessageCount: z.ZodNumber;
+        createdAtMs: z.ZodNumber;
+        id: z.ZodString;
+        summary: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"turn_started">;
+    turnId: z.ZodString;
+    inputMessageIds: z.ZodArray<z.ZodString>;
+    surface: z.ZodEnum<{
+        slack: "slack";
+        api: "api";
+        internal: "internal";
+        scheduler: "scheduler";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"turn_completed">;
+    turnId: z.ZodString;
+    outcome: z.ZodEnum<{
+        success: "success";
+        no_reply: "no_reply";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"turn_failed">;
+    turnId: z.ZodString;
+    failureCode: z.ZodEnum<{
+        agent_run_failed: "agent_run_failed";
+        delivery_failed: "delivery_failed";
+        model_execution_failed: "model_execution_failed";
+        persistence_failed: "persistence_failed";
+    }>;
+    eventId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_started">;
+    subagentInvocationId: z.ZodString;
+    subagentKind: z.ZodString;
+    modelId: z.ZodOptional<z.ZodString>;
+    parentToolCallId: z.ZodOptional<z.ZodString>;
+    reasoningLevel: z.ZodOptional<z.ZodString>;
+    childConversationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_ended">;
+    subagentInvocationId: z.ZodString;
+    outcome: z.ZodUnion<readonly [z.ZodLiteral<"success">, z.ZodLiteral<"error">, z.ZodLiteral<"aborted">]>;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"handoff">;
+    modelProfile: z.ZodString;
     modelId: z.ZodString;
-    messages: z.ZodArray<z.ZodObject<{
+    triggeringToolCallId: z.ZodOptional<z.ZodString>;
+    replacementHistory: z.ZodArray<z.ZodObject<{
         message: z.ZodPipe<z.ZodObject<{
             role: z.ZodString;
-        }, z.core.$loose>, z.ZodTransform<import("@earendil-works/pi-ai").AssistantMessage | import("@earendil-works/pi-ai").UserMessage | import("@earendil-works/pi-ai").ToolResultMessage<any> | import("@earendil-works/pi-agent-core").BashExecutionMessage | import("@earendil-works/pi-agent-core").CustomMessage<unknown> | import("@earendil-works/pi-agent-core").BranchSummaryMessage | import("@earendil-works/pi-agent-core").CompactionSummaryMessage, {
+        }, z.core.$loose>, z.ZodTransform<{
+            role: string;
+        }, {
             [x: string]: unknown;
             role: string;
         }>>;
-        createdAtMs: z.ZodNumber;
         provenance: z.ZodOptional<z.ZodObject<{
             authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
             actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -72,19 +267,21 @@ export declare const contextEpochStartSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 name: z.ZodString;
             }, z.core.$strict>], "platform">>;
         }, z.core.$strict>>;
+        sourceEventSeq: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
-    reason: z.ZodLiteral<"handoff">;
+    type: z.ZodLiteral<"compaction">;
     modelProfile: z.ZodString;
     modelId: z.ZodString;
-    messages: z.ZodArray<z.ZodObject<{
+    replacementHistory: z.ZodArray<z.ZodObject<{
         message: z.ZodPipe<z.ZodObject<{
             role: z.ZodString;
-        }, z.core.$loose>, z.ZodTransform<import("@earendil-works/pi-ai").AssistantMessage | import("@earendil-works/pi-ai").UserMessage | import("@earendil-works/pi-ai").ToolResultMessage<any> | import("@earendil-works/pi-agent-core").BashExecutionMessage | import("@earendil-works/pi-agent-core").CustomMessage<unknown> | import("@earendil-works/pi-agent-core").BranchSummaryMessage | import("@earendil-works/pi-agent-core").CompactionSummaryMessage, {
+        }, z.core.$loose>, z.ZodTransform<{
+            role: string;
+        }, {
             [x: string]: unknown;
             role: string;
         }>>;
-        createdAtMs: z.ZodNumber;
         provenance: z.ZodOptional<z.ZodObject<{
             authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
             actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -105,19 +302,21 @@ export declare const contextEpochStartSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 name: z.ZodString;
             }, z.core.$strict>], "platform">>;
         }, z.core.$strict>>;
+        sourceEventSeq: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-}, z.core.$strict>, z.ZodObject<{
-    reason: z.ZodUnion<readonly [z.ZodLiteral<"compaction">, z.ZodLiteral<"rollback">]>;
+}, z.core.$strict>], "type">, z.ZodObject<{
+    type: z.ZodLiteral<"rollback">;
     modelProfile: z.ZodString;
     modelId: z.ZodString;
-    messages: z.ZodArray<z.ZodObject<{
+    replacementHistory: z.ZodArray<z.ZodObject<{
         message: z.ZodPipe<z.ZodObject<{
             role: z.ZodString;
-        }, z.core.$loose>, z.ZodTransform<import("@earendil-works/pi-ai").AssistantMessage | import("@earendil-works/pi-ai").UserMessage | import("@earendil-works/pi-ai").ToolResultMessage<any> | import("@earendil-works/pi-agent-core").BashExecutionMessage | import("@earendil-works/pi-agent-core").CustomMessage<unknown> | import("@earendil-works/pi-agent-core").BranchSummaryMessage | import("@earendil-works/pi-agent-core").CompactionSummaryMessage, {
+        }, z.core.$loose>, z.ZodTransform<{
+            role: string;
+        }, {
             [x: string]: unknown;
             role: string;
         }>>;
-        createdAtMs: z.ZodNumber;
         provenance: z.ZodOptional<z.ZodObject<{
             authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
             actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -138,121 +337,303 @@ export declare const contextEpochStartSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 name: z.ZodString;
             }, z.core.$strict>], "platform">>;
         }, z.core.$strict>>;
+        sourceEventSeq: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-}, z.core.$strict>], "reason">;
-/** One atomically persisted context epoch and its model binding. */
-export type ContextEpochStart = z.output<typeof contextEpochStartSchema>;
-/** Strict step envelope reused by the SQL row codec; unknown types fail loudly. */
-export declare const agentStepEntrySchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
-    type: z.ZodLiteral<"pi_message">;
-    schemaVersion: z.ZodOptional<z.ZodNumber>;
-    message: z.ZodPipe<z.ZodObject<{
-        role: z.ZodString;
-    }, z.core.$loose>, z.ZodTransform<import("@earendil-works/pi-ai").AssistantMessage | import("@earendil-works/pi-ai").UserMessage | import("@earendil-works/pi-ai").ToolResultMessage<any> | import("@earendil-works/pi-agent-core").BashExecutionMessage | import("@earendil-works/pi-agent-core").CustomMessage<unknown> | import("@earendil-works/pi-agent-core").BranchSummaryMessage | import("@earendil-works/pi-agent-core").CompactionSummaryMessage, {
-        [x: string]: unknown;
-        role: string;
-    }>>;
-    provenance: z.ZodOptional<z.ZodObject<{
-        authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
-        actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            platform: z.ZodLiteral<"slack">;
-            teamId: z.ZodString;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"local">;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"system">;
-            name: z.ZodString;
-        }, z.core.$strict>], "platform">>;
-    }, z.core.$strict>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"mcp_provider_connected">;
-    provider: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"authorization_requested">;
-    kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
-    provider: z.ZodString;
-    actorId: z.ZodString;
-    authorizationId: z.ZodString;
-    delivery: z.ZodUnion<readonly [z.ZodLiteral<"private_link_sent">, z.ZodLiteral<"private_link_reused">]>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"authorization_completed">;
-    kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
-    provider: z.ZodString;
-    actorId: z.ZodString;
-    authorizationId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"tool_execution_started">;
-    toolCallId: z.ZodString;
-    toolName: z.ZodString;
-    args: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"visible_context_compacted">;
-    compactions: z.ZodArray<z.ZodObject<{
-        coveredMessageIds: z.ZodArray<z.ZodString>;
-        createdAtMs: z.ZodNumber;
-        id: z.ZodString;
-        summary: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"subagent_started">;
-    subagentInvocationId: z.ZodString;
-    subagentKind: z.ZodString;
-    modelId: z.ZodOptional<z.ZodString>;
-    parentToolCallId: z.ZodOptional<z.ZodString>;
-    reasoningLevel: z.ZodOptional<z.ZodString>;
-    childConversationId: z.ZodString;
-    historyMode: z.ZodUnion<readonly [z.ZodLiteral<"isolated">, z.ZodLiteral<"shared">]>;
-}, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"subagent_ended">;
-    subagentInvocationId: z.ZodString;
-    outcome: z.ZodUnion<readonly [z.ZodLiteral<"success">, z.ZodLiteral<"error">, z.ZodLiteral<"aborted">]>;
-    errorCode: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>]>, z.ZodUnion<readonly [z.ZodObject<{
-    type: z.ZodLiteral<"context_epoch_started">;
-    reason: z.ZodLiteral<"initial">;
-    modelProfile: z.ZodLiteral<"standard">;
-    modelId: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"context_epoch_started">;
-    reason: z.ZodLiteral<"handoff">;
-    modelProfile: z.ZodString;
-    modelId: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"context_epoch_started">;
-    reason: z.ZodUnion<readonly [z.ZodLiteral<"compaction">, z.ZodLiteral<"rollback">]>;
-    modelProfile: z.ZodOptional<z.ZodUndefined>;
-    modelId: z.ZodOptional<z.ZodUndefined>;
+}, z.core.$strict>]>;
+/** One durable conversation event's validated data. */
+export type ConversationEventData = z.output<typeof conversationEventDataSchema>;
+declare const unknownConversationEventDataSchema: z.ZodObject<{
+    type: z.ZodLiteral<"unknown">;
+    originalType: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strict>;
+/** Opaque data from a stored event this Junior version cannot interpret. */
+export type UnknownConversationEventData = z.output<typeof unknownConversationEventDataSchema>;
+/**
+ * Canonical ordered envelope for the durable conversation log.
+ * `schemaVersion` is persisted with every physical event row.
+ */
+export declare const conversationEventSchema: z.ZodUnion<readonly [z.ZodObject<{
+    seq: z.ZodNumber;
+    historyVersion: z.ZodNumber;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    createdAtMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    data: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        messageId: z.ZodString;
+        role: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">, z.ZodLiteral<"system">]>;
+        text: z.ZodString;
+        authorIdentityId: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        messageId: z.ZodString;
+        role: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">, z.ZodLiteral<"system">]>;
+        text: z.ZodString;
+        authorIdentityId: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"message_updated">;
+    }, z.core.$strict>, z.ZodObject<{
+        message: z.ZodPipe<z.ZodObject<{
+            role: z.ZodString;
+        }, z.core.$loose>, z.ZodTransform<{
+            role: string;
+        }, {
+            [x: string]: unknown;
+            role: string;
+        }>>;
+        provenance: z.ZodOptional<z.ZodObject<{
+            authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
+            actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                platform: z.ZodLiteral<"slack">;
+                teamId: z.ZodString;
+                email: z.ZodOptional<z.ZodString>;
+                fullName: z.ZodOptional<z.ZodString>;
+                userId: z.ZodString;
+                userName: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                platform: z.ZodLiteral<"local">;
+                email: z.ZodOptional<z.ZodString>;
+                fullName: z.ZodOptional<z.ZodString>;
+                userId: z.ZodString;
+                userName: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                platform: z.ZodLiteral<"system">;
+                name: z.ZodString;
+            }, z.core.$strict>], "platform">>;
+        }, z.core.$strict>>;
+        type: z.ZodLiteral<"agent_step">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"mcp_provider_connected">;
+        provider: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"authorization_requested">;
+        kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
+        provider: z.ZodString;
+        actorId: z.ZodString;
+        authorizationId: z.ZodString;
+        delivery: z.ZodUnion<readonly [z.ZodLiteral<"private_link_sent">, z.ZodLiteral<"private_link_reused">]>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"authorization_completed">;
+        kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
+        provider: z.ZodString;
+        actorId: z.ZodString;
+        authorizationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_execution_started">;
+        toolCallId: z.ZodString;
+        toolName: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"message_handled">;
+        messageId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"messages_summarized">;
+        historyFromSeq: z.ZodNumber;
+        compactions: z.ZodArray<z.ZodObject<{
+            coveredMessageCount: z.ZodNumber;
+            createdAtMs: z.ZodNumber;
+            id: z.ZodString;
+            summary: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_started">;
+        turnId: z.ZodString;
+        inputMessageIds: z.ZodArray<z.ZodString>;
+        surface: z.ZodEnum<{
+            slack: "slack";
+            api: "api";
+            internal: "internal";
+            scheduler: "scheduler";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_completed">;
+        turnId: z.ZodString;
+        outcome: z.ZodEnum<{
+            success: "success";
+            no_reply: "no_reply";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_failed">;
+        turnId: z.ZodString;
+        failureCode: z.ZodEnum<{
+            agent_run_failed: "agent_run_failed";
+            delivery_failed: "delivery_failed";
+            model_execution_failed: "model_execution_failed";
+            persistence_failed: "persistence_failed";
+        }>;
+        eventId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"subagent_started">;
+        subagentInvocationId: z.ZodString;
+        subagentKind: z.ZodString;
+        modelId: z.ZodOptional<z.ZodString>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+        reasoningLevel: z.ZodOptional<z.ZodString>;
+        childConversationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"subagent_ended">;
+        subagentInvocationId: z.ZodString;
+        outcome: z.ZodUnion<readonly [z.ZodLiteral<"success">, z.ZodLiteral<"error">, z.ZodLiteral<"aborted">]>;
+        errorCode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"handoff">;
+        modelProfile: z.ZodString;
+        modelId: z.ZodString;
+        triggeringToolCallId: z.ZodOptional<z.ZodString>;
+        replacementHistory: z.ZodArray<z.ZodObject<{
+            message: z.ZodPipe<z.ZodObject<{
+                role: z.ZodString;
+            }, z.core.$loose>, z.ZodTransform<{
+                role: string;
+            }, {
+                [x: string]: unknown;
+                role: string;
+            }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
+                actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    platform: z.ZodLiteral<"slack">;
+                    teamId: z.ZodString;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"local">;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"system">;
+                    name: z.ZodString;
+                }, z.core.$strict>], "platform">>;
+            }, z.core.$strict>>;
+            sourceEventSeq: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"compaction">;
+        modelProfile: z.ZodString;
+        modelId: z.ZodString;
+        replacementHistory: z.ZodArray<z.ZodObject<{
+            message: z.ZodPipe<z.ZodObject<{
+                role: z.ZodString;
+            }, z.core.$loose>, z.ZodTransform<{
+                role: string;
+            }, {
+                [x: string]: unknown;
+                role: string;
+            }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
+                actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    platform: z.ZodLiteral<"slack">;
+                    teamId: z.ZodString;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"local">;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"system">;
+                    name: z.ZodString;
+                }, z.core.$strict>], "platform">>;
+            }, z.core.$strict>>;
+            sourceEventSeq: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "type">, z.ZodObject<{
+        type: z.ZodLiteral<"rollback">;
+        modelProfile: z.ZodString;
+        modelId: z.ZodString;
+        replacementHistory: z.ZodArray<z.ZodObject<{
+            message: z.ZodPipe<z.ZodObject<{
+                role: z.ZodString;
+            }, z.core.$loose>, z.ZodTransform<{
+                role: string;
+            }, {
+                [x: string]: unknown;
+                role: string;
+            }>>;
+            provenance: z.ZodOptional<z.ZodObject<{
+                authority: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
+                actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    platform: z.ZodLiteral<"slack">;
+                    teamId: z.ZodString;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"local">;
+                    email: z.ZodOptional<z.ZodString>;
+                    fullName: z.ZodOptional<z.ZodString>;
+                    userId: z.ZodString;
+                    userName: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    platform: z.ZodLiteral<"system">;
+                    name: z.ZodString;
+                }, z.core.$strict>], "platform">>;
+            }, z.core.$strict>>;
+            sourceEventSeq: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>;
 }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"context_epoch_started">;
-    reason: z.ZodUnion<readonly [z.ZodLiteral<"compaction">, z.ZodLiteral<"rollback">]>;
-    modelProfile: z.ZodString;
-    modelId: z.ZodString;
-}, z.core.$strict>]>]>;
-/** One durable execution step's validated payload (sessionId lifted to epoch). */
-export type AgentStepEntry = z.infer<typeof agentStepEntrySchema>;
-/** A step read back from storage with its assigned order and epoch. */
-export interface StoredAgentStep {
-    seq: number;
-    contextEpoch: number;
-    createdAtMs: number;
-    entry: AgentStepEntry;
-}
-/** Validate a current-epoch append without permitting epoch markers. */
-export declare const newAgentStepSchema: z.ZodObject<{
-    entry: z.ZodUnion<readonly [z.ZodObject<{
-        type: z.ZodLiteral<"pi_message">;
-        schemaVersion: z.ZodOptional<z.ZodNumber>;
+    schemaVersion: z.ZodNumber;
+    seq: z.ZodNumber;
+    historyVersion: z.ZodNumber;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    createdAtMs: z.ZodNumber;
+    data: z.ZodObject<{
+        type: z.ZodLiteral<"unknown">;
+        originalType: z.ZodString;
+        payload: z.ZodUnknown;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+/** One versioned event read from the durable conversation log. */
+export type ConversationEvent = z.output<typeof conversationEventSchema>;
+declare const storedConversationEventSchema: z.ZodObject<{
+    schemaVersion: z.ZodNumber;
+    seq: z.ZodNumber;
+    historyVersion: z.ZodNumber;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    createdAtMs: z.ZodNumber;
+    type: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strict>;
+/**
+ * Decode a physical event row without making old or future event types
+ * unreadable. Unsupported rows stay opaque until an upgrade migration defines
+ * their semantics; known version-one events remain strict so corrupt canonical
+ * data cannot be mistaken for compatibility data.
+ */
+export declare function decodeStoredConversationEvent(value: z.input<typeof storedConversationEventSchema>): ConversationEvent;
+/** Validate an append without permitting model-history replacement events. */
+export declare const newConversationEventSchema: z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        messageId: z.ZodString;
+        role: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">, z.ZodLiteral<"system">]>;
+        text: z.ZodString;
+        authorIdentityId: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        messageId: z.ZodString;
+        role: z.ZodUnion<readonly [z.ZodLiteral<"user">, z.ZodLiteral<"assistant">, z.ZodLiteral<"system">]>;
+        text: z.ZodString;
+        authorIdentityId: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"message_updated">;
+    }, z.core.$strict>, z.ZodObject<{
         message: z.ZodPipe<z.ZodObject<{
             role: z.ZodString;
-        }, z.core.$loose>, z.ZodTransform<import("@earendil-works/pi-ai").AssistantMessage | import("@earendil-works/pi-ai").UserMessage | import("@earendil-works/pi-ai").ToolResultMessage<any> | import("@earendil-works/pi-agent-core").BashExecutionMessage | import("@earendil-works/pi-agent-core").CustomMessage<unknown> | import("@earendil-works/pi-agent-core").BranchSummaryMessage | import("@earendil-works/pi-agent-core").CompactionSummaryMessage, {
+        }, z.core.$loose>, z.ZodTransform<{
+            role: string;
+        }, {
             [x: string]: unknown;
             role: string;
         }>>;
@@ -276,36 +657,67 @@ export declare const newAgentStepSchema: z.ZodObject<{
                 name: z.ZodString;
             }, z.core.$strict>], "platform">>;
         }, z.core.$strict>>;
-    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"agent_step">;
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"mcp_provider_connected">;
         provider: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"authorization_requested">;
         kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
         provider: z.ZodString;
         actorId: z.ZodString;
         authorizationId: z.ZodString;
         delivery: z.ZodUnion<readonly [z.ZodLiteral<"private_link_sent">, z.ZodLiteral<"private_link_reused">]>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"authorization_completed">;
         kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
         provider: z.ZodString;
         actorId: z.ZodString;
         authorizationId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"tool_execution_started">;
         toolCallId: z.ZodString;
         toolName: z.ZodString;
-        args: z.ZodOptional<z.ZodUnknown>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"visible_context_compacted">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"message_handled">;
+        messageId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"messages_summarized">;
+        historyFromSeq: z.ZodNumber;
         compactions: z.ZodArray<z.ZodObject<{
-            coveredMessageIds: z.ZodArray<z.ZodString>;
+            coveredMessageCount: z.ZodNumber;
             createdAtMs: z.ZodNumber;
             id: z.ZodString;
             summary: z.ZodString;
-        }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_started">;
+        turnId: z.ZodString;
+        inputMessageIds: z.ZodArray<z.ZodString>;
+        surface: z.ZodEnum<{
+            slack: "slack";
+            api: "api";
+            internal: "internal";
+            scheduler: "scheduler";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_completed">;
+        turnId: z.ZodString;
+        outcome: z.ZodEnum<{
+            success: "success";
+            no_reply: "no_reply";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_failed">;
+        turnId: z.ZodString;
+        failureCode: z.ZodEnum<{
+            agent_run_failed: "agent_run_failed";
+            delivery_failed: "delivery_failed";
+            model_execution_failed: "model_execution_failed";
+            persistence_failed: "persistence_failed";
+        }>;
+        eventId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"subagent_started">;
         subagentInvocationId: z.ZodString;
         subagentKind: z.ZodString;
@@ -313,30 +725,33 @@ export declare const newAgentStepSchema: z.ZodObject<{
         parentToolCallId: z.ZodOptional<z.ZodString>;
         reasoningLevel: z.ZodOptional<z.ZodString>;
         childConversationId: z.ZodString;
-        historyMode: z.ZodUnion<readonly [z.ZodLiteral<"isolated">, z.ZodLiteral<"shared">]>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"subagent_ended">;
         subagentInvocationId: z.ZodString;
         outcome: z.ZodUnion<readonly [z.ZodLiteral<"success">, z.ZodLiteral<"error">, z.ZodLiteral<"aborted">]>;
         errorCode: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>]>;
+    }, z.core.$strict>]>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
     createdAtMs: z.ZodNumber;
 }, z.core.$strict>;
-/** A step to append; the store assigns `seq` and the current `context_epoch`. */
-export type NewAgentStep = z.output<typeof newAgentStepSchema>;
-/** A replacement Pi message written into a freshly opened epoch. */
-export type PiMessageStep = z.output<typeof piMessageStepSchema>;
-/** Persist and read the durable per-conversation agent execution history. */
-export interface AgentStepStore {
-    /** Append steps in one transaction, assigning `seq = max+1` under the lease. */
-    append(conversationId: string, steps: NewAgentStep[]): Promise<void>;
-    /**
-     * Open initial epoch 0 or the next replacement epoch in one transaction.
-     */
-    startEpoch(conversationId: string, opts: ContextEpochStart): Promise<void>;
-    /** Steps of the highest epoch in `seq` order (all types; caller filters). */
-    loadCurrentEpoch(conversationId: string): Promise<StoredAgentStep[]>;
-    /** All steps across all epochs in `seq` order, for audit and reporting. */
-    loadHistory(conversationId: string): Promise<StoredAgentStep[]>;
+/** An event to append; the store assigns `seq` and current history version. */
+export type NewConversationEvent = z.output<typeof newConversationEventSchema>;
+/** Persist and read the canonical per-conversation event log. */
+export interface ConversationEventStore {
+    /** Append events atomically, assigning `seq = max+1` under the lease. */
+    append(conversationId: string, events: NewConversationEvent[]): Promise<void>;
+    /** Replace active model history with a compaction or handoff event. */
+    replaceHistory(conversationId: string, replacement: HistoryReplacement): Promise<void>;
+    /** Events of the current history version in `seq` order. */
+    loadCurrentHistory(conversationId: string): Promise<ConversationEvent[]>;
+    /** Events in the history version containing `seq`, when it exists. */
+    loadHistoryContaining(conversationId: string, seq: number, throughSeq?: number): Promise<ConversationEvent[] | undefined>;
+    /** Current source/destination messages and their latest summary snapshot. */
+    loadMessageHistory(conversationId: string): Promise<{
+        events: ConversationEvent[];
+        compaction: ConversationEvent | undefined;
+    }>;
+    /** All events across every history version in `seq` order. */
+    loadHistory(conversationId: string): Promise<ConversationEvent[]>;
 }
 export {};