@sentry/junior 0.82.0 → 0.84.0

package/dist/{chunk-GUO4EE7L.js → chunk-CWMMGUWM.js}

@@ -1,6 +1,6 @@
 import {
   getStateAdapter
-} from "./chunk-X2FL5ZH5.js";
+} from "./chunk-MJ4E2PK7.js";
 import {
   logException,
   logInfo,

package/dist/{chunk-YA2JCC7G.js → chunk-JUI6XIHU.js}

@@ -1,6 +1,6 @@
 import {
   getConversationStore
-} from "./chunk-PQ2U2AO3.js";
+} from "./chunk-AAD2D7K3.js";
 import {
   SANDBOX_DATA_ROOT,
   SANDBOX_WORKSPACE_ROOT,
@@ -9,15 +9,15 @@ import {
 import {
   getConnectedStateContext,
   getStateAdapter
-} from "./chunk-X2FL5ZH5.js";
+} from "./chunk-MJ4E2PK7.js";
 import {
   parseDestination
-} from "./chunk-4XHCVBXH.js";
+} from "./chunk-BAPRSWNW.js";
 import {
   TURN_CONTEXT_TAG,
   botConfig,
   getChatConfig
-} from "./chunk-ABRNFE3N.js";
+} from "./chunk-ALL7GG6U.js";
 import {
   parseRequester,
   storedSlackRequesterSchema,
@@ -139,6 +139,8 @@ var subagentEndedEntrySchema = z.object({
     z.literal("aborted")
   ]),
   errorCode: z.string().min(1).optional(),
+  transcriptEndMessageIndex: z.number().int().nonnegative().optional(),
+  transcriptStartMessageIndex: z.number().int().nonnegative().optional(),
   createdAtMs: z.number().int().nonnegative()
 });
 var sessionLogEntrySchema = z.discriminatedUnion("type", [
@@ -339,6 +341,8 @@ function subagentEndedEntry(args) {
     subagentInvocationId: args.subagentInvocationId,
     outcome: args.outcome,
     ...args.errorCode ? { errorCode: args.errorCode } : {},
+    ...args.transcriptEndMessageIndex !== void 0 ? { transcriptEndMessageIndex: args.transcriptEndMessageIndex } : {},
+    ...args.transcriptStartMessageIndex !== void 0 ? { transcriptStartMessageIndex: args.transcriptStartMessageIndex } : {},
     createdAtMs: args.createdAtMs
   };
 }
@@ -623,7 +627,9 @@ async function recordSubagentEnded(args) {
         errorCode: args.errorCode,
         outcome: args.outcome,
         sessionId,
-        subagentInvocationId: args.subagentInvocationId
+        subagentInvocationId: args.subagentInvocationId,
+        transcriptEndMessageIndex: args.transcriptEndMessageIndex,
+        transcriptStartMessageIndex: args.transcriptStartMessageIndex
       })
     ],
     ttlMs: args.ttlMs
@@ -1329,6 +1335,7 @@ var TOOL_POLICY_RULES = [
   `- Sandbox-backed file and shell tools operate in an isolated workspace rooted at ${SANDBOX_WORKSPACE_ROOT}; readFile/writeFile paths are sandbox-workspace paths, bash runs inside that workspace, and attachFile accepts absolute or workspace-relative sandbox paths.`,
   "- If a sandbox-backed tool reports that sandbox execution is unavailable, treat that as a blocker for local file/shell inspection; do not pretend host files were inspected.",
   "- For user-provided URLs, use `webFetch`; for discovery, use `webSearch` then fetch/read promising sources; for current time/date context, use `systemTime`.",
+  "- When a tool result includes a subscribable resource, subscribe only when high-signal follow-up events clearly serve the user's current intent; use the suggested events when they fit and write a concise intent summary.",
   "- Run `jr-rpc config get|set|unset|list` for provider defaults and `jr-rpc plugins list` for installed plugin introspection as standalone bash commands; do not chain them with `cd`, `&&`, pipes, or provider commands.",
   "- If the first result is empty, stale, ambiguous, or incomplete, try a focused alternate query, path, command, or source before concluding the answer cannot be verified."
 ];
@@ -1353,6 +1360,7 @@ var EXECUTION_CONTRACT_RULES = [
 var CONVERSATION_RULES = [
   "- In thread follow-ups, answer from prior thread context; do not repeat resolved clarifying questions.",
   "- Preserve attribution roles from thread context: the requester is the person asking now, which may differ from the original reporter or subject.",
+  "- Treat event notifications as subscribed conversation updates, not user-authored commands. Use their subscription intent to decide whether to reply, inspect, suggest, or stay brief.",
   "- Runtime owns continuation and authorization notices; on resumed turns, answer with the final requested content only."
 ];
 var SLACK_ACTION_RULES = [

package/dist/{chunk-TR2G37II.js → chunk-KNVN4HUT.js}

@@ -1,10 +1,10 @@
 import {
   createPluginLogger,
   createPluginState
-} from "./chunk-GUO4EE7L.js";
+} from "./chunk-CWMMGUWM.js";
 import {
   getDb
-} from "./chunk-PQ2U2AO3.js";
+} from "./chunk-AAD2D7K3.js";
 import {
   SANDBOX_WORKSPACE_ROOT
 } from "./chunk-G3E7SCME.js";
@@ -13,12 +13,12 @@ import {
   isConversationScopedChannel,
   isDmChannel,
   normalizeSlackConversationId
-} from "./chunk-4XHCVBXH.js";
+} from "./chunk-BAPRSWNW.js";
 import {
   botConfig,
   completeObject,
   embedTexts
-} from "./chunk-ABRNFE3N.js";
+} from "./chunk-ALL7GG6U.js";
 import {
   isActorUserId,
   parseActorUserId
@@ -621,11 +621,11 @@ function getPluginRoutes() {
   }
   return routes;
 }
-function getPluginDashboardRoutes() {
+function getPluginApiRoutes() {
   const routes = [];
   for (const plugin of getPlugins()) {
     const pluginName = plugin.manifest.name;
-    const hook = plugin.hooks?.dashboardRoutes;
+    const hook = plugin.hooks?.apiRoutes;
     if (!hook) {
       continue;
     }
@@ -637,7 +637,7 @@ function getPluginDashboardRoutes() {
     }
     if (!isRecord(app) || typeof app.fetch !== "function") {
       throw new Error(
-        `Plugin dashboardRoutes hook from plugin "${pluginName}" must return a fetch-compatible app`
+        `Plugin apiRoutes hook from plugin "${pluginName}" must return a fetch-compatible app`
       );
     }
     routes.push({ app, pluginName });
@@ -996,7 +996,7 @@ export {
   getPluginUserPromptContributions,
   getPluginTools,
   getPluginRoutes,
-  getPluginDashboardRoutes,
+  getPluginApiRoutes,
   getPluginSlackConversationLink,
   getPluginOperationalReports,
   createPluginHookRunner

package/dist/{chunk-X2FL5ZH5.js → chunk-MJ4E2PK7.js}

@@ -1,6 +1,6 @@
 import {
   getChatConfig
-} from "./chunk-ABRNFE3N.js";
+} from "./chunk-ALL7GG6U.js";
 
 // src/chat/state/adapter.ts
 import { createMemoryState } from "@chat-adapter/state-memory";

package/dist/{chunk-3JKTVW4R.js → chunk-MZ4DUVFD.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-G3E7SCME.js";
 import {
   getStateAdapter
-} from "./chunk-X2FL5ZH5.js";
+} from "./chunk-MJ4E2PK7.js";
 import {
   toOptionalTrimmed
-} from "./chunk-ABRNFE3N.js";
+} from "./chunk-ALL7GG6U.js";
 import {
   pluginCatalogRuntime
 } from "./chunk-TW23AT22.js";

package/dist/{chunk-2AJ4TEKE.js → chunk-S7SC5IUJ.js}

@@ -4,14 +4,14 @@ import {
 import {
   getDefaultRedisStateAdapterFor,
   getStateAdapter
-} from "./chunk-X2FL5ZH5.js";
+} from "./chunk-MJ4E2PK7.js";
 import {
   parseDestination,
   sameDestination
-} from "./chunk-4XHCVBXH.js";
+} from "./chunk-BAPRSWNW.js";
 import {
   getChatConfig
-} from "./chunk-ABRNFE3N.js";
+} from "./chunk-ALL7GG6U.js";
 import {
   parseStoredSlackRequester
 } from "./chunk-ZPCGQRFJ.js";
@@ -68,7 +68,7 @@ function uniqueStrings(values) {
   return [...new Set(values)];
 }
 function normalizeSource(value) {
-  if (value === "api" || value === "internal" || value === "local" || value === "plugin" || value === "scheduler" || value === "slack") {
+  if (value === "api" || value === "internal" || value === "local" || value === "plugin" || value === "resource_event" || value === "scheduler" || value === "slack") {
     return value;
   }
   return void 0;
@@ -801,6 +801,27 @@ async function markConversationWorkEnqueued(args) {
     );
   });
 }
+async function clearConsumedConversationWake(args) {
+  const nowMs = args.nowMs ?? now();
+  return await withConversationMutation(args, async (state) => {
+    const current = await readConversation(state, args.conversationId);
+    if (!current || hasRunnableWork(current) || current.execution.lastEnqueuedAtMs === void 0) {
+      return false;
+    }
+    await writeConversation(
+      state,
+      withExecutionUpdate(
+        current,
+        {
+          ...current.execution,
+          lastEnqueuedAtMs: void 0
+        },
+        nowMs
+      )
+    );
+    return true;
+  });
+}
 async function startConversationWork(args) {
   const nowMs = args.nowMs ?? now();
   return await withConversationMutation(args, async (state) => {
@@ -1108,6 +1129,7 @@ export {
   recordConversationActivity,
   recordConversationExecution,
   markConversationWorkEnqueued,
+  clearConsumedConversationWake,
   startConversationWork,
   checkInConversationWork,
   drainConversationMailbox,

package/dist/{chunk-IOBSRZK5.js → chunk-SBYMRDH7.js}

@@ -4,7 +4,7 @@ import {
 import {
   destinationKey,
   parseDestination
-} from "./chunk-4XHCVBXH.js";
+} from "./chunk-BAPRSWNW.js";
 
 // src/chat/task-execution/queue-signing.ts
 import { createHmac, timingSafeEqual } from "crypto";

package/dist/{chunk-LX5GBMEP.js → chunk-ZPD5YQFZ.js}

@@ -1,9 +1,9 @@
 import {
   getStateAdapter
-} from "./chunk-X2FL5ZH5.js";
+} from "./chunk-MJ4E2PK7.js";
 import {
   normalizeSlackConversationId
-} from "./chunk-4XHCVBXH.js";
+} from "./chunk-BAPRSWNW.js";
 import {
   parseSlackThreadId
 } from "./chunk-DR75T7J3.js";

package/dist/cli/chat.js

@@ -130,10 +130,10 @@ async function configureLocalChatPlugins(pluginSet) {
     databaseModule
   ] = await Promise.all([
     import("../plugins-PZMDS7AT.js"),
-    import("../agent-hooks-5ZRILRC3.js"),
+    import("../agent-hooks-XDS5DIVS.js"),
     import("../catalog-runtime-IVWRAPSI.js"),
     import("../validation-TN6HMZAD.js"),
-    import("../db-GQJKBX5W.js")
+    import("../db-7RRWCYF3.js")
   ]);
   const resolvedPluginSet = pluginSet === void 0 ? await loadLocalPluginSet() : pluginSet ?? void 0;
   const plugins = pluginsModule.pluginRuntimeRegistrationsFromPluginSet(resolvedPluginSet);
@@ -195,7 +195,7 @@ async function runPrompt(options, io, pluginSet) {
   defaultStateAdapterForLocalChat();
   await configureLocalChatPlugins(pluginSet);
   const conversationId = newRunConversationId();
-  const { runLocalAgentTurn } = await import("../runner-VRFJLG2M.js");
+  const { runLocalAgentTurn } = await import("../runner-CJL5IKFO.js");
   const result = await runLocalAgentTurn(
     {
       conversationId,
@@ -219,7 +219,7 @@ async function runInteractive(io, pluginSet) {
   defaultStateAdapterForLocalChat();
   await configureLocalChatPlugins(pluginSet);
   const conversationId = newRunConversationId();
-  const { runLocalAgentTurn } = await import("../runner-VRFJLG2M.js");
+  const { runLocalAgentTurn } = await import("../runner-CJL5IKFO.js");
   const rl = readline.createInterface({
     input: io.input,
     output: io.output,

package/dist/cli/plugins.js

@@ -10,17 +10,17 @@ import {
 import {
   setPlugins,
   validatePlugins
-} from "../chunk-TR2G37II.js";
+} from "../chunk-KNVN4HUT.js";
 import {
   createPluginLogger
-} from "../chunk-GUO4EE7L.js";
+} from "../chunk-CWMMGUWM.js";
 import {
   getDb
-} from "../chunk-PQ2U2AO3.js";
+} from "../chunk-AAD2D7K3.js";
 import "../chunk-G3E7SCME.js";
-import "../chunk-X2FL5ZH5.js";
-import "../chunk-4XHCVBXH.js";
-import "../chunk-ABRNFE3N.js";
+import "../chunk-MJ4E2PK7.js";
+import "../chunk-BAPRSWNW.js";
+import "../chunk-ALL7GG6U.js";
 import "../chunk-DR75T7J3.js";
 import {
   loadAppPluginSet

package/dist/cli/snapshot-warmup.js

@@ -1,11 +1,11 @@
 import {
   resolveRuntimeDependencySnapshot
-} from "../chunk-3JKTVW4R.js";
+} from "../chunk-MZ4DUVFD.js";
 import "../chunk-G3E7SCME.js";
 import {
   disconnectStateAdapter
-} from "../chunk-X2FL5ZH5.js";
-import "../chunk-ABRNFE3N.js";
+} from "../chunk-MJ4E2PK7.js";
+import "../chunk-ALL7GG6U.js";
 import "../chunk-DR75T7J3.js";
 import {
   pluginCatalogRuntime

package/dist/cli/upgrade.js

@@ -4,7 +4,7 @@ import {
   recordConversationActivity,
   recordConversationExecution,
   requestConversationWork
-} from "../chunk-2AJ4TEKE.js";
+} from "../chunk-S7SC5IUJ.js";
 import {
   JUNIOR_THREAD_STATE_TTL_MS,
   coerceThreadConversationState
@@ -18,23 +18,23 @@ import {
 import {
   createPluginLogger,
   createPluginState
-} from "../chunk-GUO4EE7L.js";
+} from "../chunk-CWMMGUWM.js";
 import {
   createJuniorSqlExecutor,
   createSqlStore,
   getDb
-} from "../chunk-PQ2U2AO3.js";
+} from "../chunk-AAD2D7K3.js";
 import {
   disconnectStateAdapter,
   getConnectedStateContext
-} from "../chunk-X2FL5ZH5.js";
+} from "../chunk-MJ4E2PK7.js";
 import {
   parseDestination,
   sameDestination
-} from "../chunk-4XHCVBXH.js";
+} from "../chunk-BAPRSWNW.js";
 import {
   getChatConfig
-} from "../chunk-ABRNFE3N.js";
+} from "../chunk-ALL7GG6U.js";
 import "../chunk-DR75T7J3.js";
 import {
   loadAppPluginSet
@@ -83,23 +83,15 @@ function createStateConversationStore(state) {
 
 // src/cli/upgrade/migrations/conversations-sql.ts
 var CONVERSATION_BACKFILL_LIMIT = 1e4;
-var REQUIRED_SQL_DATABASE_URL_MESSAGE = "Junior SQL database URL is required for conversation metadata upgrade. Set JUNIOR_DATABASE_URL or DATABASE_URL.";
-function requireConversationSqlDatabaseUrl(context) {
-  const databaseUrl = context.sqlDatabaseUrl ?? getChatConfig().sql.databaseUrl;
-  if (!databaseUrl) {
-    throw new Error(REQUIRED_SQL_DATABASE_URL_MESSAGE);
-  }
-  return databaseUrl;
-}
 async function migrateConversationsToSql(context, options = {}) {
   const source = createStateConversationStore(context.stateAdapter);
   let target = options.target;
   let closeTarget;
   if (!target) {
-    const databaseUrl = requireConversationSqlDatabaseUrl(context);
+    const { sql } = getChatConfig();
     const executor = createJuniorSqlExecutor({
-      connectionString: databaseUrl,
-      driver: context.sqlDriver ?? getChatConfig().sql.driver
+      connectionString: sql.databaseUrl,
+      driver: sql.driver
     });
     target = createSqlStore(executor);
     closeTarget = () => executor.close();
@@ -219,9 +211,10 @@ async function runPluginStorageMigrations(context) {
     return emptyResult();
   }
   const previousConfig = pluginCatalogRuntime.setConfig(pluginCatalogConfig);
-  const ownedExecutor = context.db || !context.sqlDatabaseUrl ? void 0 : createJuniorSqlExecutor({
-    connectionString: context.sqlDatabaseUrl,
-    driver: context.sqlDriver ?? getChatConfig().sql.driver
+  const sql = getChatConfig().sql;
+  const ownedExecutor = context.db ? void 0 : createJuniorSqlExecutor({
+    connectionString: sql.databaseUrl,
+    driver: sql.driver
   });
   const sqlUrlDb = ownedExecutor ? ownedExecutor.db() : void 0;
   try {
@@ -377,21 +370,13 @@ async function migratePluginSchemas(executor, migrations) {
 }
 
 // src/cli/upgrade/migrations/plugin-sql.ts
-var REQUIRED_SQL_DATABASE_URL_MESSAGE2 = "Junior SQL database URL is required for plugin schema migration. Set JUNIOR_DATABASE_URL or DATABASE_URL.";
-function requirePluginSqlDatabaseUrl(context) {
-  const databaseUrl = context.sqlDatabaseUrl ?? getChatConfig().sql.databaseUrl;
-  if (!databaseUrl) {
-    throw new Error(REQUIRED_SQL_DATABASE_URL_MESSAGE2);
-  }
-  return databaseUrl;
-}
 async function migratePluginsToSql(context) {
-  const databaseUrl = requirePluginSqlDatabaseUrl(context);
+  const { sql } = getChatConfig();
   const { pluginCatalogConfig } = await resolveUpgradePlugins(context);
   const previousConfig = pluginCatalogRuntime.setConfig(pluginCatalogConfig);
   const executor = createJuniorSqlExecutor({
-    connectionString: databaseUrl,
-    driver: context.sqlDriver ?? getChatConfig().sql.driver
+    connectionString: sql.databaseUrl,
+    driver: sql.driver
   });
   try {
     const migrations = pluginCatalogRuntime.getMigrationRoots().flatMap((root) => readPluginMigrations(root));
@@ -991,7 +976,6 @@ function formatMigrationResult(result) {
 async function runUpgradeMigrations(context) {
   const plugins = await resolveUpgradePlugins(context);
   const migrationContext = { ...context, ...plugins };
-  migrationContext.sqlDatabaseUrl ??= requireConversationSqlDatabaseUrl(migrationContext);
   const results = [];
   for (const migration of MIGRATIONS) {
     migrationContext.io.info(`Running migration ${migration.name}...`);

package/dist/{db-GQJKBX5W.js → db-7RRWCYF3.js}

@@ -2,9 +2,9 @@ import {
   closeDb,
   getConversationStore,
   getDb
-} from "./chunk-PQ2U2AO3.js";
-import "./chunk-4XHCVBXH.js";
-import "./chunk-ABRNFE3N.js";
+} from "./chunk-AAD2D7K3.js";
+import "./chunk-BAPRSWNW.js";
+import "./chunk-ALL7GG6U.js";
 import "./chunk-DR75T7J3.js";
 import "./chunk-ZPCGQRFJ.js";
 import "./chunk-KF7522P3.js";

package/dist/handlers/github-webhook/check-suite.d.ts

@@ -0,0 +1,3 @@
+import type { IngestResourceEventInput } from "@/chat/resource-events/ingest";
+/** Normalize GitHub `check_suite` webhooks for subscribed PR check outcomes. */
+export declare function normalizeGitHubCheckSuiteEvents(deliveryId: string, body: unknown): IngestResourceEventInput[];

package/dist/handlers/github-webhook/pull-request-review.d.ts

@@ -0,0 +1,3 @@
+import type { IngestResourceEventInput } from "@/chat/resource-events/ingest";
+/** Normalize GitHub `pull_request_review` webhooks for subscribed review outcomes. */
+export declare function normalizeGitHubPullRequestReviewEvent(deliveryId: string, body: unknown): IngestResourceEventInput | undefined;

package/dist/handlers/github-webhook/pull-request.d.ts

@@ -0,0 +1,3 @@
+import type { IngestResourceEventInput } from "@/chat/resource-events/ingest";
+/** Normalize GitHub `pull_request` webhooks for subscribed PR state changes. */
+export declare function normalizeGitHubPullRequestEvent(deliveryId: string, body: unknown): IngestResourceEventInput | undefined;

package/dist/handlers/github-webhook/resource.d.ts

@@ -0,0 +1,10 @@
+/** Build the normalized resource identity for a GitHub pull request. */
+export declare function gitHubPullRequestResource(input: {
+    pullRequestNumber: number;
+    repositoryFullName: string;
+}): {
+    label: string;
+    resourceRef: string;
+};
+/** Build a stable provider retry key for one normalized GitHub event. */
+export declare function gitHubEventKey(deliveryId: string, eventType: string): string;

package/dist/handlers/github-webhook.d.ts

@@ -0,0 +1,15 @@
+import type { StateAdapter } from "chat";
+import { type IngestResourceEventInput } from "@/chat/resource-events/ingest";
+import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
+export interface GitHubWebhookHandlerOptions {
+    queue: ConversationWorkQueue | (() => ConversationWorkQueue);
+    state?: StateAdapter | (() => StateAdapter | undefined);
+}
+/** Normalize a verified GitHub webhook delivery into resource events. */
+export declare function normalizeGitHubResourceEvents(args: {
+    body: unknown;
+    deliveryId: string;
+    eventName: string;
+}): IngestResourceEventInput[];
+/** Handle signed GitHub webhooks for resource event subscriptions. */
+export declare function POST(request: Request, options: GitHubWebhookHandlerOptions): Promise<Response>;

package/dist/nitro.js

@@ -1,6 +1,6 @@
 import {
   resolveConversationWorkQueueTopic
-} from "./chunk-IOBSRZK5.js";
+} from "./chunk-SBYMRDH7.js";
 import {
   PLUGIN_TASK_QUEUE_TOPIC
 } from "./chunk-KNFROR7R.js";
@@ -8,8 +8,8 @@ import {
   pluginCatalogConfigFromPluginSet,
   pluginRuntimeRegistrationsFromPluginSet
 } from "./chunk-SG5WAA7H.js";
-import "./chunk-4XHCVBXH.js";
-import "./chunk-ABRNFE3N.js";
+import "./chunk-BAPRSWNW.js";
+import "./chunk-ALL7GG6U.js";
 import "./chunk-DR75T7J3.js";
 import {
   loadPluginSetFromModule,

package/dist/reporting/conversations.d.ts

@@ -35,7 +35,6 @@ export interface ConversationSummaryReport {
     requesterIdentity?: RequesterIdentity;
     channel?: string;
     channelName?: string;
-    sentryConversationUrl?: string;
     sentryTraceUrl?: string;
     traceId?: string;
 }
@@ -91,6 +90,7 @@ export interface ConversationSubagentActivityReport {
     parentToolCallId?: string;
     status: ConversationActivityStatus;
     subagentKind: string;
+    transcriptAvailable?: boolean;
 }
 export interface ConversationToolActivityReport extends ActivityPayloadMetadata {
     type: "tool_execution";
@@ -109,10 +109,29 @@ export interface ConversationReport {
     /** 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 {
-    sessions: ConversationSummaryReport[];
+    conversations: ConversationSummaryReport[];
     source: "conversation_index";
     generatedAt: string;
 }
@@ -144,6 +163,62 @@ export interface ConversationStatsReport {
     windowEnd: string;
     windowStart: string;
 }
+export interface RequesterActivityDayReport {
+    active: number;
+    conversations: number;
+    date: string;
+    durationMs: number;
+    failed: number;
+    hung: number;
+    runs: number;
+    tokens?: number;
+}
+export interface RequesterTotalsReport {
+    active: number;
+    activeDays: number;
+    conversations: number;
+    durationMs: number;
+    failed: number;
+    hung: number;
+    runs: number;
+    tokens?: number;
+}
+export interface RequesterSummaryReport extends RequesterTotalsReport {
+    firstSeenAt: string;
+    lastSeenAt: string;
+    requester: RequesterIdentity & {
+        email: string;
+    };
+}
+export interface RequesterDirectoryReport {
+    generatedAt: string;
+    people: RequesterSummaryReport[];
+    sampleLimit: number;
+    sampleSize: number;
+    source: "conversation_index";
+    truncated: boolean;
+}
+export interface RequesterProfileReport {
+    activityDays: RequesterActivityDayReport[];
+    generatedAt: string;
+    locations: ConversationStatsItem[];
+    recentConversations: ConversationSummaryReport[];
+    requester: RequesterIdentity & {
+        email: string;
+    };
+    sampleLimit: number;
+    sampleSize: number;
+    source: "conversation_index";
+    surfaces: ConversationStatsItem[];
+    totals: RequesterTotalsReport;
+    truncated: boolean;
+    windowEnd: string;
+    windowStart: string;
+}
+/** Read the requester directory from durable conversation metadata. */
+export declare function readRequesterDirectoryReport(options?: ConversationReaderOptions): Promise<RequesterDirectoryReport>;
+/** Read one requester profile without exposing transcript payloads. */
+export declare function readRequesterProfileReport(email: string, options?: ConversationReaderOptions): Promise<RequesterProfileReport>;
 /** Read the recent conversation feed for reporting consumers. */
 export declare function readConversationFeed(options?: ConversationReaderOptions): Promise<ConversationFeed>;
 /** Read aggregate conversation statistics for reporting consumers. */
@@ -154,3 +229,5 @@ export declare function listRecentConversationSummaries(options?: {
 } & 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): Promise<ConversationSubagentTranscriptReport>;