@sentry/junior 0.94.0 → 0.96.0

package/dist/{chat/conversations/sql → db}/schema.d.ts

@@ -1,10 +1,287 @@
+import { juniorAgentSteps } from "./schema/agent-steps";
+import { juniorConversationMessages } from "./schema/conversation-messages";
 import { juniorConversations } from "./schema/conversations";
 import { juniorDestinations } from "./schema/destinations";
 import { juniorIdentities } from "./schema/identities";
 import { juniorSchemaMigrations } from "./schema/migrations";
 import { juniorUsers } from "./schema/users";
-export { juniorConversations, juniorDestinations, juniorIdentities, juniorSchemaMigrations, juniorUsers, };
-export declare const schema: {
+export { juniorAgentSteps, juniorConversationMessages, juniorConversations, juniorDestinations, juniorIdentities, juniorSchemaMigrations, juniorUsers, };
+export declare const juniorSqlSchema: {
+    juniorAgentSteps: import("drizzle-orm/pg-core").PgTableWithColumns<{
+        name: "junior_agent_steps";
+        schema: undefined;
+        columns: {
+            conversationId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "conversation_id";
+                tableName: "junior_agent_steps";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            seq: import("drizzle-orm/pg-core").PgColumn<{
+                name: "seq";
+                tableName: "junior_agent_steps";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            contextEpoch: import("drizzle-orm/pg-core").PgColumn<{
+                name: "context_epoch";
+                tableName: "junior_agent_steps";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            type: import("drizzle-orm/pg-core").PgColumn<{
+                name: "type";
+                tableName: "junior_agent_steps";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            role: import("drizzle-orm/pg-core").PgColumn<{
+                name: "role";
+                tableName: "junior_agent_steps";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            payload: import("drizzle-orm/pg-core").PgColumn<{
+                name: "payload";
+                tableName: "junior_agent_steps";
+                dataType: "json";
+                columnType: "PgJsonb";
+                data: Record<string, unknown>;
+                driverParam: unknown;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                $type: Record<string, unknown>;
+            }>;
+            createdAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: string;
+                tableName: "junior_agent_steps";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "pg";
+    }>;
+    juniorConversationMessages: import("drizzle-orm/pg-core").PgTableWithColumns<{
+        name: "junior_conversation_messages";
+        schema: undefined;
+        columns: {
+            conversationId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "conversation_id";
+                tableName: "junior_conversation_messages";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            messageId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "message_id";
+                tableName: "junior_conversation_messages";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            role: import("drizzle-orm/pg-core").PgColumn<{
+                name: "role";
+                tableName: "junior_conversation_messages";
+                dataType: "string";
+                columnType: "PgText";
+                data: import("../chat/conversations/messages").ConversationMessageRole;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                $type: import("../chat/conversations/messages").ConversationMessageRole;
+            }>;
+            authorIdentityId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "author_identity_id";
+                tableName: "junior_conversation_messages";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            text: import("drizzle-orm/pg-core").PgColumn<{
+                name: "text";
+                tableName: "junior_conversation_messages";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            meta: import("drizzle-orm/pg-core").PgColumn<{
+                name: "meta";
+                tableName: "junior_conversation_messages";
+                dataType: "json";
+                columnType: "PgJsonb";
+                data: Record<string, unknown>;
+                driverParam: unknown;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                $type: Record<string, unknown>;
+            }>;
+            repliedAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: string;
+                tableName: "junior_conversation_messages";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            createdAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: string;
+                tableName: "junior_conversation_messages";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "pg";
+    }>;
     juniorConversations: import("drizzle-orm/pg-core").PgTableWithColumns<{
         name: "junior_conversations";
         schema: undefined;
@@ -48,7 +325,7 @@ export declare const schema: {
                 tableName: "junior_conversations";
                 dataType: "string";
                 columnType: "PgText";
-                data: import("../store").ConversationSource;
+                data: import("../chat/conversations/store").ConversationSource;
                 driverParam: string;
                 notNull: false;
                 hasDefault: false;
@@ -60,7 +337,7 @@ export declare const schema: {
                 identity: undefined;
                 generated: undefined;
             }, {}, {
-                $type: import("../store").ConversationSource;
+                $type: import("../chat/conversations/store").ConversationSource;
             }>;
             originType: import("drizzle-orm/pg-core").PgColumn<{
                 name: "origin_type";
@@ -354,7 +631,7 @@ export declare const schema: {
                 tableName: "junior_conversations";
                 dataType: "string";
                 columnType: "PgText";
-                data: import("../store").ConversationStatus;
+                data: import("../chat/conversations/store").ConversationStatus;
                 driverParam: string;
                 notNull: true;
                 hasDefault: false;
@@ -366,7 +643,7 @@ export declare const schema: {
                 identity: undefined;
                 generated: undefined;
             }, {}, {
-                $type: import("../store").ConversationStatus;
+                $type: import("../chat/conversations/store").ConversationStatus;
             }>;
             runId: import("drizzle-orm/pg-core").PgColumn<{
                 name: "run_id";
@@ -419,6 +696,40 @@ export declare const schema: {
                 identity: undefined;
                 generated: undefined;
             }, {}, {}>;
+            parentConversationId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "parent_conversation_id";
+                tableName: "junior_conversations";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            transcriptPurgedAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: string;
+                tableName: "junior_conversations";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
         };
         dialect: "pg";
     }>;
@@ -646,7 +957,7 @@ export declare const schema: {
                 tableName: "junior_identities";
                 dataType: "string";
                 columnType: "PgText";
-                data: import("../../identities/identity").IdentityKind;
+                data: import("../chat/identities/identity").IdentityKind;
                 driverParam: string;
                 notNull: true;
                 hasDefault: false;
@@ -658,7 +969,7 @@ export declare const schema: {
                 identity: undefined;
                 generated: undefined;
             }, {}, {
-                $type: import("../../identities/identity").IdentityKind;
+                $type: import("../chat/identities/identity").IdentityKind;
             }>;
             provider: import("drizzle-orm/pg-core").PgColumn<{
                 name: "provider";

package/dist/db-2D6RMG67.js

@@ -0,0 +1,24 @@
+import {
+  closeDb,
+  getAgentStepStore,
+  getConversationMessageStore,
+  getConversationStore,
+  getDb,
+  getSqlExecutor
+} from "./chunk-RITD7E5L.js";
+import "./chunk-YDVEH3SB.js";
+import "./chunk-GY34VGP5.js";
+import "./chunk-B7PUBQQM.js";
+import "./chunk-I35CTGPO.js";
+import "./chunk-OB42YVAE.js";
+import "./chunk-6GWA276C.js";
+import "./chunk-7FBGKXPE.js";
+import "./chunk-MLKGABMK.js";
+export {
+  closeDb,
+  getAgentStepStore,
+  getConversationMessageStore,
+  getConversationStore,
+  getDb,
+  getSqlExecutor
+};

package/dist/deployment.d.ts

@@ -1,5 +1,7 @@
 export declare const JUNIOR_HEARTBEAT_ROUTE = "/api/internal/heartbeat";
 export declare const JUNIOR_HEARTBEAT_CRON_SCHEDULE = "* * * * *";
+export declare const JUNIOR_RETENTION_ROUTE = "/api/internal/retention";
+export declare const JUNIOR_RETENTION_CRON_SCHEDULE = "0 4 * * *";
 export declare const JUNIOR_CONVERSATION_WORK_CALLBACK_ROUTE = "/api/internal/agent/continue";
 export declare const JUNIOR_PLUGIN_TASK_CALLBACK_ROUTE = "/api/internal/plugin/tasks";
 export declare const LEGACY_JUNIOR_CONVERSATION_WORK_FUNCTION = "api/internal/agent/continue.ts";

package/dist/handlers/retention.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handle the authenticated internal retention cron. One request runs a single
+ * bounded purge batch and returns its counts. Failures are contained here so
+ * retention can never affect task execution, heartbeat recovery, or delivery.
+ */
+export declare function GET(request: Request): Promise<Response>;

package/dist/instrumentation.js

@@ -1,6 +1,9 @@
+import {
+  consumePrivateTraceResultMarker
+} from "./chunk-CM5EZD5F.js";
 import {
   getCurrentConversationPrivacy
-} from "./chunk-YYBX2BD5.js";
+} from "./chunk-GY34VGP5.js";
 import "./chunk-OB42YVAE.js";
 import {
   getClient,
@@ -8,11 +11,11 @@ import {
   init,
   vercelAIIntegration,
   withStreamedSpan
-} from "./chunk-3DA7X2U3.js";
+} from "./chunk-6GWA276C.js";
 import {
   getDeploymentServiceVersion,
   getDeploymentTelemetryAttributes
-} from "./chunk-LFLTJQVR.js";
+} from "./chunk-7FBGKXPE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/chat/sentry-payload-filter.ts
@@ -41,10 +44,20 @@ function scrubPayloadAttributes(attributes) {
   if (!shouldScrubPayloads(attributes)) {
     return;
   }
+  const preserveProjectedToolResult = consumePrivateTraceResultMarker(attributes);
+  let redacted = false;
   for (const key of PAYLOAD_ATTRIBUTE_KEYS) {
+    if (key === "gen_ai.tool.call.result" && preserveProjectedToolResult) {
+      continue;
+    }
+    if (key in attributes) {
+      redacted = true;
+    }
     delete attributes[key];
   }
-  attributes["app.conversation.payload_redacted"] = true;
+  if (redacted) {
+    attributes["app.conversation.payload_redacted"] = true;
+  }
 }
 function scrubContainer(container) {
   if (!container) {

package/dist/legacy-import-VZ2MEGP7.js

@@ -0,0 +1,17 @@
+import {
+  ensureLegacyConversationImport,
+  importConversationFromLegacy
+} from "./chunk-5C6XTTFI.js";
+import "./chunk-RITD7E5L.js";
+import "./chunk-YDVEH3SB.js";
+import "./chunk-GY34VGP5.js";
+import "./chunk-B7PUBQQM.js";
+import "./chunk-I35CTGPO.js";
+import "./chunk-OB42YVAE.js";
+import "./chunk-6GWA276C.js";
+import "./chunk-7FBGKXPE.js";
+import "./chunk-MLKGABMK.js";
+export {
+  ensureLegacyConversationImport,
+  importConversationFromLegacy
+};

package/dist/nitro.js

@@ -1,6 +1,6 @@
 import {
   resolveConversationWorkQueueTopic
-} from "./chunk-NYWPISSO.js";
+} from "./chunk-2XXEKR44.js";
 import {
   PLUGIN_TASK_QUEUE_TOPIC
 } from "./chunk-KNFROR7R.js";
@@ -12,7 +12,7 @@ import {
   loadPluginSetFromModule,
   resolvePluginModule
 } from "./chunk-Y2CM7HXH.js";
-import "./chunk-GHGPTPBL.js";
+import "./chunk-B7PUBQQM.js";
 import {
   discoverInstalledPluginPackageContent,
   isValidPackageName,
@@ -22,8 +22,10 @@ import {
   JUNIOR_CONVERSATION_WORK_CALLBACK_ROUTE,
   JUNIOR_HEARTBEAT_CRON_SCHEDULE,
   JUNIOR_HEARTBEAT_ROUTE,
-  JUNIOR_PLUGIN_TASK_CALLBACK_ROUTE
-} from "./chunk-LFLTJQVR.js";
+  JUNIOR_PLUGIN_TASK_CALLBACK_ROUTE,
+  JUNIOR_RETENTION_CRON_SCHEDULE,
+  JUNIOR_RETENTION_ROUTE
+} from "./chunk-7FBGKXPE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/nitro.ts
@@ -335,6 +337,14 @@ function configureVercelDeployment(nitro, options) {
       schedule: JUNIOR_HEARTBEAT_CRON_SCHEDULE
     });
   }
+  if (!nitro.options.vercel.config.crons.some(
+    (cron) => cron.path === JUNIOR_RETENTION_ROUTE
+  )) {
+    nitro.options.vercel.config.crons.push({
+      path: JUNIOR_RETENTION_ROUTE,
+      schedule: JUNIOR_RETENTION_CRON_SCHEDULE
+    });
+  }
   nitro.options.vercel.functions ??= {};
   nitro.options.vercel.functions.maxDuration ??= defaultMaxDuration;
   const callbackMaxDuration = nitro.options.vercel.functions.maxDuration ?? defaultMaxDuration;

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

@@ -0,0 +1,40 @@
+import type { AgentStepEntry, StoredAgentStep } from "@/chat/conversations/history";
+import type { PiMessage } from "@/chat/pi/messages";
+import type { ConversationActivityReport, ConversationActivityStatus, ConversationSubagentActivityReport } from "./types";
+/**
+ * Build the current-run activity timeline from durable agent steps.
+ *
+ * Tool executions, subagent starts/ends, and their nesting are derived from the
+ * conversation's `junior_agent_steps` rows instead of the legacy Redis session
+ * log; tool statuses come from the aligned `pi_message` tool results. Redaction
+ * stays byte-compatible with the prior session-log path.
+ */
+export declare function buildConversationActivityFromSteps(args: {
+    canExposePayload: boolean;
+    steps: StoredAgentStep[];
+    messages: PiMessage[];
+}): ConversationActivityReport[];
+export type SubagentStartedStep = StoredAgentStep & {
+    entry: Extract<AgentStepEntry, {
+        type: "subagent_started";
+    }>;
+};
+export type SubagentEndedStep = StoredAgentStep & {
+    entry: Extract<AgentStepEntry, {
+        type: "subagent_ended";
+    }>;
+};
+/** Pair durable subagent start and end steps into one activity report. */
+export declare function subagentActivityFromSteps(start: SubagentStartedStep, end: SubagentEndedStep | undefined, options?: {
+    canExposeTranscript?: boolean;
+    parentStatus?: ConversationActivityStatus;
+}): ConversationSubagentActivityReport;
+/**
+ * Read one child-agent transcript through its parent conversation.
+ *
+ * The parent records `subagent_started`/`subagent_ended` as durable steps that
+ * name the child by `childConversationId`; the transcript is the child
+ * conversation's own projected Pi messages. `runId` is retained for the route
+ * signature but no longer scopes the lookup — subagent steps live on the parent
+ * conversation regardless of the run that produced them.
+ */

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

@@ -0,0 +1,8 @@
+import type { ConversationMessageStore } from "@/chat/conversations/messages";
+import type { ConversationStore } from "@/chat/conversations/store";
+export interface ConversationReaderOptions {
+    messageStore?: ConversationMessageStore;
+    conversationStore?: ConversationStore;
+}
+/** Resolve the conversation store supplied by a reporting consumer. */
+export declare function conversationStore(options?: ConversationReaderOptions): ConversationStore;

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

@@ -0,0 +1,6 @@
+import { type ConversationReaderOptions } from "./context";
+import type { ConversationReport, ConversationSubagentTranscriptReport } from "./types";
+/** 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. */
+export declare function readConversationSubagentTranscriptReport(conversationId: string, _runId: string, subagentId: string, options?: ConversationReaderOptions): Promise<ConversationSubagentTranscriptReport>;

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

@@ -0,0 +1,4 @@
+export { readConversationReport, readConversationSubagentTranscriptReport, } from "./details";
+export { listRecentConversationSummaries, readConversationFeed, } from "./summaries";
+export { readConversationStatsReport } from "./statistics";
+export * from "./types";

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

@@ -0,0 +1,9 @@
+import type { ConversationSummaryReport, ConversationSurface } from "./types";
+/** Parse an ISO report timestamp without leaking invalid numbers downstream. */
+export declare function reportTime(value: string): number | undefined;
+/** Format a Slack destination without exposing private channel names. */
+export declare function slackStatsLocationLabel(input: Pick<ConversationSummaryReport, "channel" | "channelName" | "channelNameRedacted">): string | undefined;
+/** Return the generic display label for a conversation surface. */
+export declare function surfaceFallbackLabel(surface: ConversationSurface): string;
+/** Select the most recently seen run independent of input ordering. */
+export declare function newestRun(runs: ConversationSummaryReport[]): ConversationSummaryReport;

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

@@ -0,0 +1,4 @@
+import { type ConversationReaderOptions } from "./context";
+import type { ConversationStatsReport } from "./types";
+export declare function readConversationStatsReport(options?: ConversationReaderOptions): Promise<ConversationStatsReport>;
+/** List recent conversation summaries for plugin operational reports. */

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

@@ -0,0 +1,20 @@
+import type { AgentTurnSessionSummary } from "@/chat/state/turn-session";
+import type { Conversation as StoredConversation } from "@/chat/conversations/store";
+import { type ConversationReaderOptions } from "./context";
+import type { ConversationFeed, ConversationSummaryReport, ConversationSurface, PluginConversationSummary } from "./types";
+/** Build the privacy-safe title shared by summary and detail reports. */
+export declare function titleFromConversation(args: {
+    conversation: StoredConversation;
+    surface: ConversationSurface;
+}): string;
+/** Project the current stored execution into the public run summary shape. */
+export declare function sessionReportFromConversation(conversation: StoredConversation, nowMs: number): ConversationSummaryReport;
+/** Enrich a durable conversation projection with one complete turn summary. */
+export declare function sessionReportFromTurnSummary(conversation: StoredConversation, summary: AgentTurnSessionSummary, nowMs: number): ConversationSummaryReport;
+/** Read the recent conversation feed for reporting consumers. */
+export declare function readConversationFeed(options?: ConversationReaderOptions): Promise<ConversationFeed>;
+/** List recent conversation summaries for plugin operational reports. */
+export declare function listRecentConversationSummaries(options?: {
+    limit?: number;
+} & ConversationReaderOptions): Promise<PluginConversationSummary[]>;
+/** Build the current run's reportable content from the current context epoch. */

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

@@ -0,0 +1,28 @@
+import type { PiMessage } from "@/chat/pi/messages";
+import type { ConversationSubagentActivityReport, ConversationSubagentTranscriptReport, TranscriptMessage } from "./types";
+/** Normalize one provider transcript message into the reporting contract. */
+export declare function normalizeTranscriptMessage(message: PiMessage, options?: {
+    unwrapAdvisorTask?: boolean;
+}): TranscriptMessage;
+/** Describe a redacted payload without exposing its contents. */
+export declare function redactedPayloadFields(prefix: "input" | "output", value: unknown): {
+    [x: string]: string | number | string[];
+};
+/** Redact transcript payloads while retaining safe structural metadata. */
+export declare function redactTranscriptMessage(message: TranscriptMessage): TranscriptMessage;
+/** Count user-visible conversation messages in a normalized transcript. */
+export declare function countConversationMessages(transcript: TranscriptMessage[]): number;
+/** Read the latest trace identifier carried by a transcript message. */
+export declare function traceIdFromTranscript(transcript: TranscriptMessage[]): string | undefined;
+/** Build a subagent transcript response from its durable activity metadata. */
+export declare function subagentTranscriptReport(activity: ConversationSubagentActivityReport, options?: {
+    subagentConversationId?: string;
+    subagentSentryConversationUrl?: string;
+    transcript?: TranscriptMessage[];
+    transcriptMessageCount?: number;
+    transcriptRedacted?: boolean;
+    transcriptRedactionReason?: "non_public_conversation";
+    transcriptExpired?: boolean;
+    transcriptExpiredAt?: string;
+    unavailableReason?: ConversationSubagentTranscriptReport["unavailableReason"];
+}): ConversationSubagentTranscriptReport;