@sentry/junior 0.94.0 → 0.96.0

package/dist/reporting/conversations/types.d.ts

@@ -0,0 +1,191 @@
+import type { PluginConversationStatus, PluginConversations, PluginConversationSummary } from "@sentry/junior-plugin-api";
+export type { PluginConversationStatus, PluginConversations, PluginConversationSummary, };
+export type ConversationReportStatus = "active" | "completed" | "failed" | "hung" | "superseded";
+export type ConversationSurface = "api" | "internal" | "scheduler" | "slack";
+/** Estimated USD cost breakdown for a conversation run. */
+export interface ConversationCost {
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    total?: number;
+}
+/** Token and estimated USD cost usage for a conversation run. */
+export interface ConversationUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    cachedInputTokens?: number;
+    cacheCreationTokens?: number;
+    reasoningTokens?: number;
+    totalTokens?: number;
+    cost?: ConversationCost;
+}
+export interface ActorIdentity {
+    email?: string;
+    fullName?: string;
+    slackUserId?: string;
+    slackUserName?: string;
+}
+export interface ConversationSummaryReport {
+    /** Always-populated display title, with privacy redaction applied first. */
+    displayTitle: string;
+    cumulativeDurationMs: number;
+    cumulativeUsage?: ConversationUsage;
+    conversationId: string;
+    id: string;
+    status: ConversationReportStatus;
+    startedAt: string;
+    lastSeenAt: string;
+    lastProgressAt: string;
+    completedAt?: string;
+    surface: ConversationSurface;
+    actorIdentity?: ActorIdentity;
+    channel?: string;
+    channelName?: string;
+    channelNameRedacted?: boolean;
+    sentryTraceUrl?: string;
+    traceId?: string;
+}
+export type TranscriptPartType = "text" | "thinking" | "tool_call" | "tool_result" | "unknown";
+export interface TranscriptPart {
+    bytes?: number;
+    chars?: number;
+    id?: string;
+    input?: unknown;
+    inputKeys?: string[];
+    inputSizeBytes?: number;
+    inputSizeChars?: number;
+    inputType?: string;
+    name?: string;
+    output?: unknown;
+    outputKeys?: string[];
+    outputSizeBytes?: number;
+    outputSizeChars?: number;
+    outputType?: string;
+    redacted?: boolean;
+    sourceType?: string;
+    text?: string;
+    type: TranscriptPartType;
+}
+export type TranscriptRole = "assistant" | "system" | "tool" | "toolResult" | "unknown" | "user";
+export interface TranscriptMessage {
+    parts: TranscriptPart[];
+    role: TranscriptRole;
+    timestamp?: number;
+}
+export interface ConversationRunReport extends ConversationSummaryReport {
+    activity?: ConversationActivityReport[];
+    modelId?: string;
+    reasoningLevel?: string;
+    transcriptAvailable: boolean;
+    transcriptMetadata?: TranscriptMessage[];
+    transcriptMessageCount?: number;
+    transcriptRedacted?: boolean;
+    transcriptRedactionReason?: "non_public_conversation";
+    /**
+     * True when retention purged this conversation's content. Expiry under
+     * retention is distinct from privacy redaction: the content aged out and was
+     * deleted, so no metadata is derived from it (see data-redaction-policy.md).
+     */
+    transcriptExpired?: boolean;
+    /** When the content was purged (ISO 8601); present only with `transcriptExpired`. */
+    transcriptExpiredAt?: string;
+    transcript: TranscriptMessage[];
+}
+export type ConversationActivityStatus = "aborted" | "completed" | "error" | "running" | "success";
+export interface ConversationSubagentActivityReport {
+    type: "subagent";
+    createdAt: string;
+    endedAt?: string;
+    id: string;
+    modelId?: string;
+    outcome?: "success" | "error" | "aborted";
+    parentToolCallId?: string;
+    reasoningLevel?: string;
+    status: ConversationActivityStatus;
+    subagentKind: string;
+    transcriptAvailable?: boolean;
+}
+export interface ConversationToolActivityReport {
+    type: "tool_execution";
+    args?: unknown;
+    createdAt: string;
+    id: string;
+    inputKeys?: string[];
+    inputSizeBytes?: number;
+    inputSizeChars?: number;
+    inputType?: string;
+    redacted?: boolean;
+    status: ConversationActivityStatus;
+    subagents: ConversationSubagentActivityReport[];
+    toolCallId: string;
+    toolName: string;
+}
+export type ConversationActivityReport = ConversationToolActivityReport | ConversationSubagentActivityReport;
+export interface ConversationReport {
+    conversationId: string;
+    /** Always-populated display title, computed the same way as per-run reports. */
+    displayTitle: string;
+    generatedAt: string;
+    sentryConversationUrl?: string;
+    runs: ConversationRunReport[];
+}
+export interface ConversationSubagentTranscriptReport {
+    type: "subagent";
+    createdAt: string;
+    endedAt?: string;
+    id: string;
+    modelId?: string;
+    outcome?: "success" | "error" | "aborted";
+    parentToolCallId?: string;
+    reasoningLevel?: string;
+    status: ConversationActivityStatus;
+    subagentConversationId?: string;
+    subagentKind: string;
+    subagentSentryConversationUrl?: string;
+    transcript: TranscriptMessage[];
+    transcriptAvailable: boolean;
+    transcriptMessageCount?: number;
+    transcriptRedacted?: boolean;
+    transcriptRedactionReason?: "non_public_conversation";
+    /** True when retention purged the parent conversation's content. */
+    transcriptExpired?: boolean;
+    /** When the content was purged (ISO 8601); present only with `transcriptExpired`. */
+    transcriptExpiredAt?: string;
+    unavailableReason?: "missing_transcript_range" | "missing_transcript_ref" | "not_found";
+}
+export interface ConversationFeed {
+    conversations: ConversationSummaryReport[];
+    source: "conversation_index";
+    generatedAt: string;
+}
+export interface ConversationStatsItem {
+    active: number;
+    conversations: number;
+    durationMs: number;
+    failed: number;
+    hung: number;
+    label: string;
+    runs: number;
+    costUsd?: number;
+    tokens?: number;
+}
+export interface ConversationStatsReport {
+    active: number;
+    conversations: number;
+    durationMs: number;
+    failed: number;
+    generatedAt: string;
+    hung: number;
+    locations: ConversationStatsItem[];
+    actors: ConversationStatsItem[];
+    sampleLimit: number;
+    sampleSize: number;
+    source: "conversation_index";
+    costUsd?: number;
+    tokens?: number;
+    truncated: boolean;
+    runs: number;
+    windowEnd: string;
+    windowStart: string;
+}

package/dist/reporting/conversations.d.ts

@@ -1,178 +1 @@
-import type { PluginConversationStatus, PluginConversations, PluginConversationSummary } from "@sentry/junior-plugin-api";
-import type { ConversationStore } from "@/chat/conversations/store";
-export type { PluginConversationStatus, PluginConversations, PluginConversationSummary, };
-interface ConversationReaderOptions {
-    conversationStore?: ConversationStore;
-}
-export type ConversationReportStatus = "active" | "completed" | "failed" | "hung" | "superseded";
-export type ConversationSurface = "api" | "internal" | "scheduler" | "slack";
-export interface ConversationUsage {
-    inputTokens?: number;
-    outputTokens?: number;
-    cachedInputTokens?: number;
-    cacheCreationTokens?: number;
-    totalTokens?: number;
-}
-export interface ActorIdentity {
-    email?: string;
-    fullName?: string;
-    slackUserId?: string;
-    slackUserName?: string;
-}
-export interface ConversationSummaryReport {
-    /** Always-populated display title, with privacy redaction applied first. */
-    displayTitle: string;
-    cumulativeDurationMs: number;
-    cumulativeUsage?: ConversationUsage;
-    conversationId: string;
-    id: string;
-    status: ConversationReportStatus;
-    startedAt: string;
-    lastSeenAt: string;
-    lastProgressAt: string;
-    completedAt?: string;
-    surface: ConversationSurface;
-    actorIdentity?: ActorIdentity;
-    channel?: string;
-    channelName?: string;
-    channelNameRedacted?: boolean;
-    sentryTraceUrl?: string;
-    traceId?: string;
-}
-export type TranscriptPartType = "text" | "thinking" | "tool_call" | "tool_result" | "unknown";
-export interface TranscriptPart {
-    bytes?: number;
-    chars?: number;
-    id?: string;
-    input?: unknown;
-    inputKeys?: string[];
-    inputSizeBytes?: number;
-    inputSizeChars?: number;
-    inputType?: string;
-    name?: string;
-    output?: unknown;
-    outputKeys?: string[];
-    outputSizeBytes?: number;
-    outputSizeChars?: number;
-    outputType?: string;
-    redacted?: boolean;
-    sourceType?: string;
-    text?: string;
-    type: TranscriptPartType;
-}
-export type TranscriptRole = "assistant" | "system" | "tool" | "toolResult" | "unknown" | "user";
-export interface TranscriptMessage {
-    parts: TranscriptPart[];
-    role: TranscriptRole;
-    timestamp?: number;
-}
-export interface ConversationRunReport extends ConversationSummaryReport {
-    activity?: ConversationActivityReport[];
-    transcriptAvailable: boolean;
-    transcriptMetadata?: TranscriptMessage[];
-    transcriptMessageCount?: number;
-    transcriptRedacted?: boolean;
-    transcriptRedactionReason?: "non_public_conversation";
-    transcript: TranscriptMessage[];
-}
-export type ConversationActivityStatus = "aborted" | "completed" | "error" | "running" | "success";
-interface ActivityPayloadMetadata {
-    inputKeys?: string[];
-    inputSizeBytes?: number;
-    inputSizeChars?: number;
-    inputType?: string;
-}
-export interface ConversationSubagentActivityReport {
-    type: "subagent";
-    createdAt: string;
-    endedAt?: string;
-    id: string;
-    outcome?: "success" | "error" | "aborted";
-    parentToolCallId?: string;
-    status: ConversationActivityStatus;
-    subagentKind: string;
-    transcriptAvailable?: boolean;
-}
-export interface ConversationToolActivityReport extends ActivityPayloadMetadata {
-    type: "tool_execution";
-    args?: unknown;
-    createdAt: string;
-    id: string;
-    redacted?: boolean;
-    status: ConversationActivityStatus;
-    subagents: ConversationSubagentActivityReport[];
-    toolCallId: string;
-    toolName: string;
-}
-export type ConversationActivityReport = ConversationToolActivityReport | ConversationSubagentActivityReport;
-export interface ConversationReport {
-    conversationId: string;
-    /** Always-populated display title, computed the same way as per-run reports. */
-    displayTitle: string;
-    generatedAt: string;
-    sentryConversationUrl?: string;
-    runs: ConversationRunReport[];
-}
-export interface ConversationSubagentTranscriptReport {
-    type: "subagent";
-    createdAt: string;
-    endedAt?: string;
-    id: string;
-    outcome?: "success" | "error" | "aborted";
-    parentToolCallId?: string;
-    status: ConversationActivityStatus;
-    subagentConversationId?: string;
-    subagentKind: string;
-    subagentSentryConversationUrl?: string;
-    transcript: TranscriptMessage[];
-    transcriptAvailable: boolean;
-    transcriptMessageCount?: number;
-    transcriptRedacted?: boolean;
-    transcriptRedactionReason?: "non_public_conversation";
-    unavailableReason?: "missing_transcript_range" | "missing_transcript_ref" | "not_found";
-}
-export interface ConversationFeed {
-    conversations: ConversationSummaryReport[];
-    source: "conversation_index";
-    generatedAt: string;
-}
-export interface ConversationStatsItem {
-    active: number;
-    conversations: number;
-    durationMs: number;
-    failed: number;
-    hung: number;
-    label: string;
-    runs: number;
-    tokens?: number;
-}
-export interface ConversationStatsReport {
-    active: number;
-    conversations: number;
-    durationMs: number;
-    failed: number;
-    generatedAt: string;
-    hung: number;
-    locations: ConversationStatsItem[];
-    actors: ConversationStatsItem[];
-    sampleLimit: number;
-    sampleSize: number;
-    source: "conversation_index";
-    tokens?: number;
-    truncated: boolean;
-    runs: number;
-    windowEnd: string;
-    windowStart: string;
-}
-/** Read the recent conversation feed for reporting consumers. */
-export declare function readConversationFeed(options?: ConversationReaderOptions): Promise<ConversationFeed>;
-/** Read aggregate conversation statistics for reporting consumers. */
-export declare function readConversationStatsReport(options?: ConversationReaderOptions): Promise<ConversationStatsReport>;
-/** List recent conversation summaries for plugin operational reports. */
-export declare function listRecentConversationSummaries(options?: {
-    limit?: number;
-} & ConversationReaderOptions): Promise<PluginConversationSummary[]>;
-/** Read one conversation transcript for reporting consumers. */
-export declare function readConversationReport(conversationId: string, options?: ConversationReaderOptions): Promise<ConversationReport>;
-/** Read one child-agent transcript through its parent conversation run. */
-export declare function readConversationSubagentTranscriptReport(conversationId: string, runId: string, subagentId: string, options?: ConversationReaderOptions): Promise<ConversationSubagentTranscriptReport>;
+export * from "./conversations/index";

package/dist/reporting.d.ts

@@ -1,6 +1,6 @@
 import type { PluginOperationalReport } from "@sentry/junior-plugin-api";
 import { type ConversationFeed, type PluginConversationSummary, type ConversationReport, type ConversationSubagentTranscriptReport, type ConversationStatsReport } from "./reporting/conversations";
-export type { PluginConversationStatus, PluginConversations, PluginConversationSummary, ConversationActivityReport, ConversationActivityStatus, ConversationFeed, ConversationReport, ConversationReportStatus, ConversationRunReport, ConversationSubagentActivityReport, ConversationSubagentTranscriptReport, ConversationStatsItem, ConversationStatsReport, ConversationSummaryReport, ConversationSurface, ConversationToolActivityReport, ConversationUsage, ActorIdentity, TranscriptMessage, TranscriptPart, TranscriptPartType, TranscriptRole, } from "./reporting/conversations";
+export type { PluginConversationStatus, PluginConversations, PluginConversationSummary, ConversationActivityReport, ConversationActivityStatus, ConversationCost, ConversationFeed, ConversationReport, ConversationReportStatus, ConversationRunReport, ConversationSubagentActivityReport, ConversationSubagentTranscriptReport, ConversationStatsItem, ConversationStatsReport, ConversationSummaryReport, ConversationSurface, ConversationToolActivityReport, ConversationUsage, ActorIdentity, TranscriptMessage, TranscriptPart, TranscriptPartType, TranscriptRole, } from "./reporting/conversations";
 export interface HealthReport {
     status: "ok";
     service: string;
@@ -62,9 +62,10 @@ export interface JuniorReporting {
     /**
      * Read one conversation transcript for reporting consumers.
      *
-     * The current implementation joins turn-session records with expiring session
-     * logs, but the API should stay compatible with a future Sentry trace-history
-     * source. Avoid adding fields that require Redis-only transcript internals.
+     * Transcript messages and activity steps come from SQL (`junior_agent_steps`
+     * / `junior_conversation_messages`); the API should stay compatible with a
+     * future Sentry trace-history source, so avoid fields that require store
+     * internals.
      */
     getConversation(conversationId: string): Promise<ConversationReport>;
     /** Load a child-agent transcript only when an operator opens that subagent. */