@sentry/junior 0.77.0 → 0.79.0

package/dist/{agent-hooks-7P2WSR4R.js → agent-hooks-OFDNZJB2.js}

@@ -1,6 +1,7 @@
 import {
   PluginHookDeniedError,
   createPluginHookRunner,
+  getPluginDashboardRoutes,
   getPluginOperationalReports,
   getPluginRoutes,
   getPluginSlackConversationLink,
@@ -10,9 +11,9 @@ import {
   getPlugins,
   setPlugins,
   validatePlugins
-} from "./chunk-WBSGTHNO.js";
+} from "./chunk-SSWBYEFH.js";
 import "./chunk-RARSKPVT.js";
-import "./chunk-NYKJ3KON.js";
+import "./chunk-237T7XAN.js";
 import "./chunk-G3E7SCME.js";
 import "./chunk-LXTPBU4K.js";
 import "./chunk-Q6XFTRV5.js";
@@ -25,6 +26,7 @@ import "./chunk-MLKGABMK.js";
 export {
   PluginHookDeniedError,
   createPluginHookRunner,
+  getPluginDashboardRoutes,
   getPluginOperationalReports,
   getPluginRoutes,
   getPluginSlackConversationLink,

package/dist/api-reference.d.ts

@@ -1,13 +1,13 @@
 export { createApp } from "./app";
-export type { JuniorAppOptions } from "./app";
+export type { JuniorAppOptions, JuniorDashboardOptions } from "./app";
 export { initSentry } from "./instrumentation";
 export { juniorNitro } from "./nitro";
-export type { JuniorNitroOptions } from "./nitro";
+export type { JuniorNitroDashboardOptions, JuniorNitroOptions } from "./nitro";
 export { defineJuniorPlugins } from "./plugins";
 export type { JuniorPluginInput, JuniorPluginSet, JuniorPluginSetOptions, } from "./plugins";
 export type { PluginRunContext, PluginRunTranscriptEntry, PluginTaskContext, PluginTaskDefinition, PluginTasks, } from "@sentry/junior-plugin-api";
 export { pluginRunContextSchema, pluginRunTranscriptEntrySchema, } from "@sentry/junior-plugin-api";
 export { createJuniorReporting } from "./reporting";
-export type { PluginConversationStatus, PluginConversations, PluginConversationSummary, ConversationFeed, ConversationReport, ConversationReportStatus, ConversationRunReport, ConversationStatsItem, ConversationStatsReport, ConversationSummaryReport, ConversationSurface, ConversationUsage, HealthReport, JuniorReporting, PluginOperationalReport, PluginOperationalReportFeed, PluginPackageContentItemReport, PluginPackageContentReport, PluginReport, RequesterIdentity, RuntimeInfoReport, SkillReport, TranscriptMessage, TranscriptPart, TranscriptPartType, TranscriptRole, } from "./reporting";
+export type { PluginConversationStatus, PluginConversations, PluginConversationSummary, ConversationActivityReport, ConversationActivityStatus, ConversationFeed, ConversationReport, ConversationReportStatus, ConversationRunReport, ConversationSubagentActivityReport, ConversationStatsItem, ConversationStatsReport, ConversationSummaryReport, ConversationSurface, ConversationToolActivityReport, ConversationUsage, HealthReport, JuniorReporting, PluginOperationalReport, PluginOperationalReportFeed, PluginPackageContentItemReport, PluginPackageContentReport, PluginReport, RequesterIdentity, RuntimeInfoReport, SkillReport, TranscriptMessage, TranscriptPart, TranscriptPartType, TranscriptRole, } from "./reporting";
 export { juniorVercelConfig } from "./vercel";
 export type { JuniorVercelConfigOptions } from "./vercel";

package/dist/app.d.ts

@@ -1,10 +1,13 @@
 import { Hono } from "hono";
+import type { JuniorReporting } from "./reporting";
 import { type JuniorPluginSet } from "./plugins";
 import { type VercelConversationWorkCallbackOptions } from "@/chat/task-execution/vercel-callback";
 import type { WaitUntilFn } from "@/handlers/types";
 export { defineJuniorPlugins } from "./plugins";
 export type { JuniorPluginInput, JuniorPluginSet, JuniorPluginSetOptions, } from "./plugins";
 export interface JuniorAppOptions {
+    /** Authenticated dashboard mounted by core when configured. */
+    dashboard?: JuniorDashboardOptions;
     /** Slack-specific overrides applied after env parsing. */
     slack?: {
         /** Slack emoji shown while Junior is processing. Defaults to `eyes`. */
@@ -29,5 +32,29 @@ export interface JuniorAppOptions {
     };
     waitUntil?: WaitUntilFn;
 }
+export interface JuniorDashboardOptions {
+    /** Browser auth route prefix used by Better Auth. */
+    authPath?: string;
+    /** Require a dashboard browser session before serving dashboard pages and APIs. */
+    authRequired?: boolean;
+    /** Exact Google account emails allowed to open the dashboard. */
+    allowedEmails?: string[];
+    /** Google Workspace domains allowed to open the dashboard. */
+    allowedGoogleDomains?: string[];
+    /** Browser route prefix for the dashboard shell. */
+    basePath?: string;
+    /** Public deployment origin used for auth callbacks and external links. */
+    baseURL?: string;
+    /** Disable dashboard route mounting while preserving serializable config shape. */
+    disabled?: boolean;
+    /** Overlay dashboard visual-QA fixture conversations onto real reporting data. */
+    mockConversations?: boolean;
+    /** Reporting implementation used by dashboard APIs. Defaults to core reporting. */
+    reporting?: JuniorReporting;
+    /** Browser session lifetime in seconds. */
+    sessionMaxAgeSeconds?: number;
+    /** Additional trusted origins accepted by Better Auth. */
+    trustedOrigins?: string[];
+}
 /** Create a Hono app with all Junior routes. */
 export declare function createApp(options?: JuniorAppOptions): Promise<Hono>;

package/dist/app.js

@@ -71,7 +71,7 @@ import {
   updateConversationStats,
   uploadFilesToThread,
   upsertConversationMessage
-} from "./chunk-W36B5PT4.js";
+} from "./chunk-NNM7YQLL.js";
 import {
   CONVERSATION_WORK_CHECK_IN_INTERVAL_MS,
   CONVERSATION_WORK_STALE_ENQUEUE_MS,
@@ -90,7 +90,7 @@ import {
   requestConversationContinuation,
   requestConversationWork,
   startConversationWork
-} from "./chunk-KPL4WJWA.js";
+} from "./chunk-LUNMJQ7D.js";
 import {
   JUNIOR_THREAD_STATE_TTL_MS,
   coerceThreadConversationState
@@ -129,7 +129,7 @@ import {
   recordAuthorizationCompleted,
   splitSlackReplyText,
   truncateStatusText
-} from "./chunk-TO3UAY2M.js";
+} from "./chunk-R5T7QY3P.js";
 import {
   validatePluginEgressCredentialHooks,
   validatePluginRegistrations
@@ -142,13 +142,14 @@ import {
 } from "./chunk-SG5WAA7H.js";
 import {
   bindSlackDirectCredentialSubject,
+  getPluginDashboardRoutes,
   getPluginRoutes,
   getPluginSlackConversationLink,
   getPlugins,
   setPlugins,
   validatePlugins,
   verifySlackDirectCredentialSubject
-} from "./chunk-WBSGTHNO.js";
+} from "./chunk-SSWBYEFH.js";
 import {
   createPluginLogger,
   createPluginState
@@ -156,7 +157,7 @@ import {
 import {
   getConversationStore,
   getDb
-} from "./chunk-NYKJ3KON.js";
+} from "./chunk-237T7XAN.js";
 import "./chunk-G3E7SCME.js";
 import {
   acquireActiveLock,
@@ -247,8 +248,60 @@ import {
 import "./chunk-MLKGABMK.js";
 
 // src/app.ts
+import { createRequire } from "module";
+import { pathToFileURL } from "url";
 import { Hono } from "hono";
 
+// src/chat/slack/dashboard-link.ts
+var dashboardConversationLinkOptions;
+function withHttps(host) {
+  return /^https?:\/\//.test(host) ? host : `https://${host}`;
+}
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 1 && value.charCodeAt(end - 1) === 47) {
+    end -= 1;
+  }
+  return end === value.length ? value : value.slice(0, end);
+}
+function normalizeDashboardPath(path2, fallback) {
+  const value = path2?.trim() || fallback;
+  const withSlash = value.startsWith("/") ? value : `/${value}`;
+  return stripTrailingSlashes(withSlash);
+}
+function resolveDashboardBaseURL(config) {
+  const explicit = config.baseURL ?? process.env.BETTER_AUTH_URL ?? process.env.JUNIOR_BASE_URL;
+  if (explicit?.trim()) {
+    return stripTrailingSlashes(withHttps(explicit.trim()));
+  }
+  const vercelProd = process.env.VERCEL_PROJECT_PRODUCTION_URL?.trim();
+  if (vercelProd) {
+    return stripTrailingSlashes(withHttps(vercelProd));
+  }
+  const vercelUrl = process.env.VERCEL_URL?.trim();
+  if (vercelUrl) {
+    return stripTrailingSlashes(withHttps(vercelUrl));
+  }
+  return "http://localhost:3000";
+}
+function setDashboardConversationLinkOptions(options) {
+  const previous = dashboardConversationLinkOptions;
+  dashboardConversationLinkOptions = options?.disabled ? void 0 : options;
+  return previous;
+}
+function getDashboardConversationLink(conversationId) {
+  if (!dashboardConversationLinkOptions) {
+    return void 0;
+  }
+  const baseURL = resolveDashboardBaseURL(dashboardConversationLinkOptions);
+  const basePath = normalizeDashboardPath(
+    dashboardConversationLinkOptions.basePath,
+    "/"
+  );
+  const path2 = basePath === "/" ? `/conversations/${encodeURIComponent(conversationId)}` : `${basePath}/conversations/${encodeURIComponent(conversationId)}`;
+  return `${baseURL}${path2}`;
+}
+
 // src/chat/slack/reply.ts
 import { Buffer as Buffer2 } from "buffer";
 
@@ -267,7 +320,7 @@ function buildSlackReplyFooter(args) {
       label: "ID",
       value: conversationId
     };
-    const conversationUrl = getPluginSlackConversationLink(conversationId)?.url ?? buildSentryConversationUrl(conversationId);
+    const conversationUrl = getPluginSlackConversationLink(conversationId)?.url ?? getDashboardConversationLink(conversationId) ?? buildSentryConversationUrl(conversationId);
     if (conversationUrl) {
       idItem.url = conversationUrl;
     }
@@ -11158,6 +11211,7 @@ function createProductionConversationWorkOptions(options) {
 }
 
 // src/app.ts
+var DASHBOARD_PACKAGE_NAME = "@sentry/junior-dashboard";
 async function defaultWaitUntil() {
   try {
     const { waitUntil } = await import("@vercel/functions");
@@ -11176,6 +11230,8 @@ async function resolveVirtualConfig() {
   try {
     const mod = await import("#junior/config");
     return {
+      createDashboardApp: mod.createDashboardApp,
+      dashboard: mod.dashboard,
       pluginSet: mod.pluginSet,
       plugins: mod.plugins,
       pluginRuntimeRegistrations: mod.pluginRuntimeRegistrations ?? []
@@ -11238,7 +11294,161 @@ function validateBuildIncludesPluginRuntimeRegistrations(runtimeRegistrations, v
     `createApp() is missing plugin registration(s) with runtime code bundled by juniorNitro(): ${missing.join(", ")}. Pass a runtime-safe plugin module to juniorNitro({ plugins: "./plugins" }) or pass the same defineJuniorPlugins(...) set to createApp({ plugins }).`
   );
 }
-function mountPluginRoutes(app, routes) {
+async function createDashboardRouteRegistrations(args) {
+  if (!args.dashboard || args.dashboard.disabled) {
+    return [];
+  }
+  const createDashboardApp = args.createDashboardApp ?? await loadDashboardAppFactory();
+  return dashboardRouteRegistrations({
+    dashboard: args.dashboard,
+    createDashboardApp,
+    pluginRoutes: args.pluginRoutes
+  });
+}
+async function loadDashboardAppFactory() {
+  try {
+    const appRequire = createRequire(`${process.cwd()}/package.json`);
+    const mod = await import(pathToFileURL(appRequire.resolve(DASHBOARD_PACKAGE_NAME)).href);
+    return dashboardAppFactoryFromModule(mod);
+  } catch (error) {
+    if (isMissingDashboardPackage(error)) {
+      throw new Error(
+        'createApp({ dashboard }) requires installing "@sentry/junior-dashboard"',
+        { cause: error }
+      );
+    }
+    throw error;
+  }
+}
+function dashboardAppFactoryFromModule(mod) {
+  if (!mod || typeof mod !== "object" || typeof mod.createDashboardApp !== "function") {
+    throw new Error(
+      '@sentry/junior-dashboard must export a "createDashboardApp" function'
+    );
+  }
+  return mod.createDashboardApp;
+}
+function isMissingDashboardPackage(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  const code = error.code;
+  return (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") && error.message.includes("@sentry/junior-dashboard");
+}
+function stripTrailingSlashes2(value) {
+  let end = value.length;
+  while (end > 1 && value.charCodeAt(end - 1) === 47) {
+    end -= 1;
+  }
+  return end === value.length ? value : value.slice(0, end);
+}
+function normalizeDashboardPath2(path2, fallback) {
+  const value = path2?.trim() || fallback;
+  const withSlash = value.startsWith("/") ? value : `/${value}`;
+  return stripTrailingSlashes2(withSlash);
+}
+function dashboardHostRoutePaths(dashboard) {
+  const basePath = normalizeDashboardPath2(dashboard.basePath, "/");
+  const authPath = normalizeDashboardPath2(dashboard.authPath, "/api/auth");
+  const pagePaths = basePath === "/" ? [
+    "/",
+    "/conversations",
+    "/conversations/*",
+    "/plugins",
+    "/plugins/*",
+    "/sessions",
+    "/sessions/*"
+  ] : [basePath, `${basePath}/*`];
+  return [
+    ...pagePaths,
+    "/favicon.ico",
+    "/api/dashboard",
+    "/api/dashboard/*",
+    authPath,
+    `${authPath}/*`
+  ];
+}
+function routePrefixCoversPath(routePrefix, path2) {
+  return routePrefix === "/" || path2 === routePrefix || path2.startsWith(`${routePrefix}/`);
+}
+function routeSegments(path2) {
+  return normalizeDashboardPath2(path2, "/").split("/").filter(Boolean);
+}
+function routeSegmentMatches(pattern, value) {
+  return pattern === value || pattern === "*" || pattern.startsWith(":");
+}
+function routePatternMatchesConcretePath(pattern, concretePath) {
+  const patternSegments = routeSegments(pattern);
+  const pathSegments = routeSegments(concretePath);
+  for (let index = 0; index < patternSegments.length; index += 1) {
+    const segment = patternSegments[index];
+    if (segment === "**" || segment === "*") {
+      return true;
+    }
+    const value = pathSegments[index];
+    if (!value || !routeSegmentMatches(segment, value)) {
+      return false;
+    }
+  }
+  return patternSegments.length === pathSegments.length;
+}
+function routePatternExamples(routePath) {
+  const normalized = normalizeDashboardPath2(routePath, "/");
+  if (!normalized.endsWith("/*") && !normalized.endsWith("/**")) {
+    return [normalized];
+  }
+  const prefix = normalizeDashboardPath2(
+    normalized.endsWith("/*") ? normalized.slice(0, -2) : normalized.slice(0, -3),
+    "/"
+  );
+  return [
+    prefix,
+    prefix === "/" ? "/__dashboard__" : `${prefix}/__dashboard__`
+  ];
+}
+function routePatternOverlaps(ownedPath, routePath) {
+  if (ownedPath.endsWith("/*") && routePrefixCoversPath(ownedPath.slice(0, -2), routePath)) {
+    return true;
+  }
+  return routePatternExamples(ownedPath).some(
+    (example) => routePatternMatchesConcretePath(routePath, example)
+  );
+}
+function dashboardOwnedRoutePath(routePath, dashboard) {
+  return dashboardHostRoutePaths(dashboard).some(
+    (path2) => routePatternOverlaps(path2, routePath)
+  );
+}
+function dashboardRouteRegistrations(args) {
+  let app;
+  const fetch2 = (request) => {
+    app ??= args.createDashboardApp({
+      ...args.dashboard,
+      pluginRoutes: args.pluginRoutes
+    });
+    if (!app || typeof app.fetch !== "function") {
+      throw new Error("createDashboardApp() must return an app with fetch()");
+    }
+    return app.fetch(request);
+  };
+  return dashboardHostRoutePaths(args.dashboard).map((path2) => ({
+    handler: fetch2,
+    path: path2
+  }));
+}
+function validateDashboardRouteOwnership(args) {
+  if (!args.dashboard || args.dashboard.disabled) {
+    return;
+  }
+  for (const route of args.routes) {
+    if (dashboardOwnedRoutePath(route.path, args.dashboard)) {
+      throw new Error(
+        `Plugin "${route.pluginName}" route "${route.path}" conflicts with core dashboard routes`
+      );
+    }
+  }
+}
+function mountRoutes(app, routes) {
   for (const route of routes) {
     const handler = (c) => route.handler(c.req.raw);
     const methods = Array.isArray(route.method) ? route.method : [route.method ?? "ALL"];
@@ -11254,6 +11464,7 @@ function mountPluginRoutes(app, routes) {
 }
 async function createApp(options) {
   const virtualConfig = await resolveVirtualConfig();
+  const dashboard = options?.dashboard ?? virtualConfig?.dashboard;
   const configuredPlugins = options?.plugins ?? virtualConfig?.pluginSet;
   const plugins = pluginRuntimeRegistrationsFromPluginSet(configuredPlugins);
   const pluginConfig = configuredPlugins ? pluginCatalogConfigFromPluginSet(configuredPlugins) : virtualConfig?.plugins ?? pluginCatalogConfigFromEnv();
@@ -11268,7 +11479,9 @@ async function createApp(options) {
   const previousPlugins = setPlugins(plugins);
   const previousConfigDefaults = getConfigDefaults();
   const previousSlackReactionConfig = getSlackReactionConfig();
+  const previousDashboardLinkOptions = setDashboardConversationLinkOptions(dashboard);
   let pluginRoutes = [];
+  let pluginDashboardRoutes = [];
   let sandboxEgressTracePropagationDomains = [];
   try {
     sandboxEgressTracePropagationDomains = normalizeSandboxEgressTracePropagationDomains(
@@ -11286,11 +11499,16 @@ async function createApp(options) {
       );
     }
     pluginRoutes = getPluginRoutes();
+    validateDashboardRouteOwnership({ dashboard, routes: pluginRoutes });
+    if (dashboard && !dashboard.disabled) {
+      pluginDashboardRoutes = getPluginDashboardRoutes();
+    }
   } catch (error) {
     setPluginCatalogConfig(previousPluginCatalogConfig);
     setPlugins(previousPlugins);
     setConfigDefaults(previousConfigDefaults);
     setSlackReactionConfig(previousSlackReactionConfig);
+    setDashboardConversationLinkOptions(previousDashboardLinkOptions);
     throw error;
   }
   const waitUntil = options?.waitUntil ?? await defaultWaitUntil();
@@ -11318,7 +11536,15 @@ async function createApp(options) {
       next
     );
   });
-  mountPluginRoutes(app, pluginRoutes);
+  mountRoutes(app, pluginRoutes);
+  mountRoutes(
+    app,
+    await createDashboardRouteRegistrations({
+      dashboard,
+      createDashboardApp: virtualConfig?.createDashboardApp,
+      pluginRoutes: pluginDashboardRoutes
+    })
+  );
   app.get("/", () => GET());
   app.get("/health", () => GET());
   app.get("/api/oauth/callback/mcp/:provider", (c) => {

package/dist/build/copy-build-content.d.ts

@@ -1,4 +1,6 @@
 /** Copy app and declared plugin package content into the server output. */
 export declare function copyAppAndPluginContent(cwd: string, serverRoot: string, packageNames?: unknown): void;
+/** Copy dashboard browser assets when core dashboard routes are enabled. */
+export declare function copyDashboardAssets(cwd: string, serverRoot: string): void;
 /** Copy extra file patterns into server output for files the bundler cannot trace. */
 export declare function copyIncludedFiles(cwd: string, serverRoot: string, patterns?: unknown): void;

package/dist/build/virtual-config.d.ts

@@ -1,5 +1,6 @@
 import type { Nitro } from "nitro/types";
 import type { PluginCatalogConfig } from "@/chat/plugins/types";
+import type { JuniorDashboardOptions } from "@/app";
 import { type JuniorPluginSet } from "@/plugins";
 export interface RuntimePluginModule {
     exportName: string;
@@ -7,6 +8,7 @@ export interface RuntimePluginModule {
 }
 /** Render the virtual config module consumed by createApp(). */
 export declare function renderVirtualConfig(options: {
+    dashboard?: Omit<JuniorDashboardOptions, "reporting">;
     plugins?: PluginCatalogConfig;
     pluginModule?: RuntimePluginModule;
     pluginRuntimeRegistrations?: string[];
@@ -17,4 +19,5 @@ export declare function injectVirtualConfig(nitro: Nitro, options?: {
     pluginModule?: RuntimePluginModule;
     plugins?: PluginCatalogConfig;
     pluginRuntimeRegistrations?: string[];
+    dashboard?: Omit<JuniorDashboardOptions, "reporting">;
 }): void;

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

@@ -1,7 +1,7 @@
 import type { Destination } from "@sentry/junior-plugin-api";
 import type { StoredSlackRequester } from "@/chat/requester";
 export type ConversationSource = "api" | "internal" | "local" | "plugin" | "scheduler" | "slack";
-export type ConversationStatus = "awaiting_resume" | "idle" | "pending" | "running";
+export type ConversationStatus = "awaiting_resume" | "failed" | "idle" | "pending" | "running";
 export interface ConversationExecution {
     lastCheckpointAtMs?: number;
     lastEnqueuedAtMs?: number;

package/dist/chat/plugins/agent-hooks.d.ts

@@ -1,4 +1,4 @@
-import type { PluginConversations, PluginRoute, PluginOperationalReport, SlackConversationLink, PluginRegistration } from "@sentry/junior-plugin-api";
+import type { PluginConversations, PluginRoute, PluginOperationalReport, PluginRouteApp, SlackConversationLink, PluginRegistration } from "@sentry/junior-plugin-api";
 import type { PluginPromptContributionContext } from "@/chat/plugins/prompt";
 import type { ToolDefinition } from "@/chat/tools/definition";
 import type { ToolRuntimeContext } from "@/chat/tools/types";
@@ -19,6 +19,10 @@ export interface ToolHookResult {
 export interface PluginRouteRegistration extends PluginRoute {
     pluginName: string;
 }
+export interface PluginDashboardRouteRegistration {
+    app: PluginRouteApp;
+    pluginName: string;
+}
 export interface PluginHookRunner {
     beforeToolExecute(input: ToolHookInput): Promise<ToolHookResult>;
     prepareSandbox(sandbox: SandboxInstance): Promise<void>;
@@ -39,6 +43,8 @@ export declare function getPluginUserPromptContributions(args: {
 export declare function getPluginTools(context: ToolRuntimeContext): Record<string, ToolDefinition<any>>;
 /** Collect route handlers exposed by plugins for app-level mounting. */
 export declare function getPluginRoutes(): PluginRouteRegistration[];
+/** Collect dashboard-scoped route apps exposed by plugins. */
+export declare function getPluginDashboardRoutes(): PluginDashboardRouteRegistration[];
 /** Resolve the first plugin conversation URL for finalized Slack footers. */
 export declare function getPluginSlackConversationLink(conversationId: string): SlackConversationLink | undefined;
 /** Collect read-only operational summaries exposed by plugins. */

package/dist/chat/slack/dashboard-link.d.ts

@@ -0,0 +1,9 @@
+export interface DashboardConversationLinkOptions {
+    basePath?: string;
+    baseURL?: string;
+    disabled?: boolean;
+}
+/** Configure core dashboard links used in Slack footers. */
+export declare function setDashboardConversationLinkOptions(options: DashboardConversationLinkOptions | undefined): DashboardConversationLinkOptions | undefined;
+/** Build the dashboard conversation URL when the core dashboard is enabled. */
+export declare function getDashboardConversationLink(conversationId: string): string | undefined;

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

@@ -2,6 +2,11 @@ import { z } from "zod";
 import type { PiMessage } from "@/chat/pi/messages";
 import { type StoredSlackRequester } from "@/chat/requester";
 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.ZodLiteral<1>;
     type: z.ZodLiteral<"pi_message">;
@@ -74,10 +79,50 @@ declare const sessionLogEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     provider: z.ZodString;
     requesterId: z.ZodString;
     authorizationId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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.ZodLiteral<1>;
+    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">;
+    createdAtMs: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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>;
+    createdAtMs: z.ZodNumber;
 }, z.core.$strip>], "type">;
 /** Requester 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;
 }
@@ -94,6 +139,11 @@ export interface SessionProjection {
     messages: PiMessage[];
     requester?: StoredSlackRequester;
 }
+/** 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;
@@ -142,6 +192,40 @@ export declare function recordAuthorizationCompleted(args: Scope & {
     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";
+    parentConversationId: string;
+    parentSessionId?: string;
+    parentToolCallId?: 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;
+    ttlMs: number;
+}): Promise<void>;
 /**
  * Append conversation-log entries and advance the current Pi projection.
  *

package/dist/chat/task-execution/state.d.ts

@@ -7,7 +7,7 @@ export declare const CONVERSATION_WORK_LEASE_TTL_MS = 90000;
 export declare const CONVERSATION_WORK_CHECK_IN_INTERVAL_MS = 15000;
 export declare const CONVERSATION_WORK_STALE_ENQUEUE_MS = 60000;
 export type Source = "api" | "internal" | "local" | "plugin" | "scheduler" | "slack";
-export type ExecutionStatus = "awaiting_resume" | "idle" | "pending" | "running";
+export type ExecutionStatus = "awaiting_resume" | "failed" | "idle" | "pending" | "running";
 export interface AgentInput {
     attachments?: unknown[];
     authorId?: string;
@@ -127,6 +127,26 @@ export declare function recordConversationActivity(args: {
     state?: StateAdapter;
     title?: string;
 }): Promise<void>;
+/** Store task-execution metadata for local/no-SQL reporting. */
+export declare function recordConversationExecution(args: {
+    channelName?: string;
+    conversationId: string;
+    createdAtMs: number;
+    destination?: Destination;
+    execution: {
+        lastCheckpointAtMs?: number;
+        lastEnqueuedAtMs?: number;
+        runId?: string;
+        status: ExecutionStatus;
+        updatedAtMs?: number;
+    };
+    lastActivityAtMs: number;
+    requester?: StoredSlackRequester;
+    source?: Source;
+    state?: StateAdapter;
+    title?: string;
+    updatedAtMs: number;
+}): Promise<void>;
 /** Record that a wake-up nudge was accepted for the conversation. */
 export declare function markConversationWorkEnqueued(args: {
     conversationId: string;

package/dist/chat/tools/advisor/tool.d.ts

@@ -23,6 +23,7 @@ export interface AdvisorToolRuntimeContext {
     conversationPrivacy?: ConversationPrivacy;
     getTools: () => AgentTool[];
     logContext?: LogContext;
+    parentSessionId?: string;
     store?: AdvisorSessionStore;
     streamFn?: StreamFn;
 }