@sentry/junior 0.106.0 → 0.107.1

package/dist/chat/state/session-log.d.ts

@@ -1,384 +0,0 @@
-import { z } from "zod";
-import { type Actor } from "@sentry/junior-plugin-api";
-import { type PiMessage } from "@/chat/pi/messages";
-import { type StoredSlackActor } from "@/chat/actor";
-declare const piMessageAuthoritySchema: z.ZodUnion<readonly [z.ZodLiteral<"instruction">, z.ZodLiteral<"context">]>;
-/** Per-message provenance payload reused by the SQL agent-step envelope. */
-export declare const piMessageProvenanceSchema: 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>;
-/** Whether a user-role Pi message is a durable instruction or ambient context. */
-export type PiMessageAuthority = z.output<typeof piMessageAuthoritySchema>;
-/** Per-message record of the actor a Pi message came from and its authority weight. */
-export type PiMessageProvenance = z.output<typeof piMessageProvenanceSchema>;
-/**
- * Recover per-message provenance from a legacy v1 pi_message. A stored Slack
- * actor on the entry meant that user message was the turn instruction, so it
- * decodes to an authored instruction when the identity is intact; anything
- * missing or malformed fails closed to unauthored context.
- */
-export declare function legacyActorProvenance(actor: StoredSlackActor): PiMessageProvenance;
-declare const authorizationKindSchema: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
-declare const transcriptRefSchema: z.ZodObject<{
-    type: z.ZodLiteral<"advisor_session">;
-    parentConversationId: z.ZodString;
-    key: z.ZodString;
-}, z.core.$strip>;
-declare const sessionLogEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"pi_message">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    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>>;
-    actor: z.ZodOptional<z.ZodObject<{
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        platform: z.ZodOptional<z.ZodLiteral<"slack">>;
-        slackUserId: z.ZodOptional<z.ZodString>;
-        slackUserName: z.ZodOptional<z.ZodString>;
-        teamId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"projection_reset">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    messages: z.ZodArray<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.ZodArray<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>>>;
-    actor: z.ZodOptional<z.ZodObject<{
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        platform: z.ZodOptional<z.ZodLiteral<"slack">>;
-        slackUserId: z.ZodOptional<z.ZodString>;
-        slackUserName: z.ZodOptional<z.ZodString>;
-        teamId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"actor_recorded">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    actor: z.ZodObject<{
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        platform: z.ZodOptional<z.ZodLiteral<"slack">>;
-        slackUserId: z.ZodOptional<z.ZodString>;
-        slackUserName: z.ZodOptional<z.ZodString>;
-        teamId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"mcp_provider_connected">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    provider: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"authorization_requested">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    createdAtMs: z.ZodNumber;
-    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<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"authorization_completed">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    createdAtMs: z.ZodNumber;
-    kind: z.ZodUnion<readonly [z.ZodLiteral<"plugin">, z.ZodLiteral<"mcp">]>;
-    provider: z.ZodString;
-    actorId: z.ZodString;
-    authorizationId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"tool_execution_started">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    createdAtMs: z.ZodNumber;
-    toolCallId: z.ZodString;
-    toolName: z.ZodString;
-    args: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"subagent_started">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    subagentInvocationId: z.ZodString;
-    subagentKind: z.ZodString;
-    parentToolCallId: z.ZodOptional<z.ZodString>;
-    parentConversationId: z.ZodString;
-    parentSessionId: z.ZodOptional<z.ZodString>;
-    transcriptRef: z.ZodObject<{
-        type: z.ZodLiteral<"advisor_session">;
-        parentConversationId: z.ZodString;
-        key: z.ZodString;
-    }, z.core.$strip>;
-    historyMode: z.ZodLiteral<"shared">;
-    modelId: z.ZodOptional<z.ZodString>;
-    reasoningLevel: z.ZodOptional<z.ZodString>;
-    createdAtMs: z.ZodNumber;
-}, z.core.$strip>, z.ZodObject<{
-    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
-    type: z.ZodLiteral<"subagent_ended">;
-    sessionId: z.ZodDefault<z.ZodString>;
-    subagentInvocationId: z.ZodString;
-    outcome: z.ZodUnion<readonly [z.ZodLiteral<"success">, z.ZodLiteral<"error">, z.ZodLiteral<"aborted">]>;
-    errorCode: z.ZodOptional<z.ZodString>;
-    transcriptEndMessageIndex: z.ZodOptional<z.ZodNumber>;
-    transcriptStartMessageIndex: z.ZodOptional<z.ZodNumber>;
-    createdAtMs: z.ZodNumber;
-}, z.core.$strip>], "type">;
-/** Actor identity stored with turn-start messages for durable continuation. */
-export type SessionLogEntry = z.infer<typeof sessionLogEntrySchema>;
-export type AuthorizationKind = z.infer<typeof authorizationKindSchema>;
-export type TranscriptRef = z.infer<typeof transcriptRefSchema>;
-export type SessionActivityEntry = Extract<SessionLogEntry, {
-    type: "tool_execution_started";
-}> | Extract<SessionLogEntry, {
-    type: "subagent_started";
-}> | Extract<SessionLogEntry, {
-    type: "subagent_ended";
-}>;
-interface Scope {
-    conversationId: string;
-}
-interface AppendArgs {
-    entries: SessionLogEntry[];
-    scope: Scope;
-    ttlMs: number;
-}
-export interface SessionLogStore {
-    append(args: AppendArgs): Promise<void>;
-    read(scope: Scope): Promise<SessionLogEntry[]>;
-}
-/** Aligned Pi-message projection: `provenance[i]` describes `messages[i]`. */
-export interface SessionProjection {
-    messages: PiMessage[];
-    provenance: PiMessageProvenance[];
-}
-/**
- * All distinct actors annotated on instruction-authority messages, in
- * first-seen order — the run's actors. This is attribution, never
- * authority: it exists so provenance consumers know which actors
- * contributed instructions to a run. It must never feed credential
- * issuance, credential-subject selection, or scope ownership.
- * Unattributable instructions (no resolvable actor) never join;
- * distinctness is by identity ids only, never display fields.
- */
-export declare function instructionActors(provenance: PiMessageProvenance[]): Actor[];
-/**
- * Read the raw decoded legacy session-log entries for one conversation.
- *
- * The single read source for the one-time Redis→SQL history import; it returns
- * every entry in list order (no projection collapsing) so the importer can
- * translate `sessionId` markers into context epochs.
- */
-export declare function readSessionLogEntries(args: Scope & {
-    store?: SessionLogStore;
-}): Promise<SessionLogEntry[]>;
-/** Load chronological host-only runtime activity entries for reporting. */
-export declare function loadActivityEntries(args: Scope & {
-    store?: SessionLogStore;
-    sessionId?: string;
-}): Promise<SessionActivityEntry[]>;
-/** Load the committed Pi-message projection for a conversation. */
-export declare function loadMessages(args: Scope & {
-    store?: SessionLogStore;
-    messageCount: number;
-    sessionId?: string;
-}): Promise<PiMessage[] | undefined>;
-/** Load the committed Pi-message projection with aligned per-message provenance. */
-export declare function loadMessagesWithProvenance(args: Scope & {
-    store?: SessionLogStore;
-    messageCount: number;
-    sessionId?: string;
-}): Promise<SessionProjection | undefined>;
-/** Load the full current Pi-message projection for a conversation. */
-export declare function loadProjection(args: Scope & {
-    store?: SessionLogStore;
-    sessionId?: string;
-}): Promise<PiMessage[]>;
-/**
- * Load the Pi-message projection with aligned per-message provenance in one
- * read. Used at continuation boundaries to avoid a second log scan.
- */
-export declare function loadProjectionWithProvenance(args: Scope & {
-    store?: SessionLogStore;
-    sessionId?: string;
-}): Promise<SessionProjection>;
-/**
- * Load the projection with the latest instruction actor as a stored Slack
- * actor. Retained for callers that still key on a single latest actor; it
- * derives the actor from per-message provenance rather than a latest-wins
- * field.
- */
-export declare function loadProjectionWithActor(args: Scope & {
-    store?: SessionLogStore;
-    sessionId?: string;
-}): Promise<{
-    messages: PiMessage[];
-    actor?: StoredSlackActor;
-}>;
-/** Load MCP providers that were durably connected in this conversation. */
-export declare function loadConnectedMcpProviders(args: Scope & {
-    store?: SessionLogStore;
-}): Promise<string[]>;
-/** Record a successful MCP provider connection without duplicating the fact. */
-export declare function recordMcpProviderConnected(args: Scope & {
-    store?: SessionLogStore;
-    provider: string;
-    ttlMs: number;
-}): Promise<void>;
-/** Record that an OAuth/MCP authorization link was delivered or reused. */
-export declare function recordAuthorizationRequested(args: Scope & {
-    store?: SessionLogStore;
-    kind: AuthorizationKind;
-    provider: string;
-    actorId: string;
-    authorizationId: string;
-    delivery: "private_link_sent" | "private_link_reused";
-    ttlMs: number;
-}): Promise<void>;
-/** Record completed authorization as a chronological host observation for Pi. */
-export declare function recordAuthorizationCompleted(args: Scope & {
-    store?: SessionLogStore;
-    kind: AuthorizationKind;
-    provider: string;
-    actorId: string;
-    authorizationId: string;
-    ttlMs: number;
-}): Promise<void>;
-/** Record a host-observed parent tool start without adding it to Pi replay. */
-export declare function recordToolExecutionStarted(args: Scope & {
-    args?: unknown;
-    createdAtMs?: number;
-    sessionId?: string;
-    store?: SessionLogStore;
-    toolCallId: string;
-    toolName: string;
-    ttlMs: number;
-}): Promise<void>;
-/** Record that a child agent execution became visible from this parent run. */
-export declare function recordSubagentStarted(args: Scope & {
-    createdAtMs?: number;
-    historyMode: "shared";
-    modelId?: string;
-    parentConversationId: string;
-    parentSessionId?: string;
-    parentToolCallId?: string;
-    reasoningLevel?: string;
-    sessionId?: string;
-    store?: SessionLogStore;
-    subagentInvocationId: string;
-    subagentKind: string;
-    transcriptRef: TranscriptRef;
-    ttlMs: number;
-}): Promise<void>;
-/** Record the terminal state for a previously-started child agent execution. */
-export declare function recordSubagentEnded(args: Scope & {
-    createdAtMs?: number;
-    errorCode?: string;
-    outcome: "success" | "error" | "aborted";
-    sessionId?: string;
-    store?: SessionLogStore;
-    subagentInvocationId: string;
-    transcriptEndMessageIndex?: number;
-    transcriptStartMessageIndex?: number;
-    ttlMs: number;
-}): Promise<void>;
-/**
- * Append conversation-log entries and advance the current Pi projection.
- *
- * Normal commits append new Pi messages. If the runtime rolls back to an
- * earlier safe boundary, the log records that projection reset as an explicit
- * event instead of rewriting prior history.
- */
-export declare function commitMessages(args: Scope & {
-    store?: SessionLogStore;
-    messages: PiMessage[];
-    ttlMs: number;
-    /** Explicit per-message provenance aligned one-to-one with `messages`. */
-    provenance?: PiMessageProvenance[];
-    /** Explicit provenance for the trailing newly committed messages. */
-    trailingMessageProvenance?: PiMessageProvenance[];
-    /** Default applied to the last new user message when no explicit array. */
-    newMessageProvenance?: PiMessageProvenance;
-}): Promise<{
-    sessionId: string;
-    provenance: PiMessageProvenance[];
-}>;
-/** Build an instruction-provenance record for the given actor. */
-export declare function instructionProvenanceFor(actor: Actor | undefined): PiMessageProvenance;
-/** Unattributed ambient-context provenance for non-instruction Pi messages. */
-export declare const contextProvenance: PiMessageProvenance;
-/**
- * Parse durably-stored message provenance, failing closed on misalignment.
- *
- * A missing field is a legacy record: it materializes as unauthored context of
- * the expected length. A present-but-malformed or wrong-length value returns
- * undefined so callers reject the record rather than zip a mismatched array.
- */
-export declare function parseStoredMessageProvenance(value: unknown, expectedLength: number): PiMessageProvenance[] | undefined;
-export {};