@sentry/junior 0.133.0 → 0.135.0

package/dist/{agent-hooks-5BUIXVIX.js → agent-hooks-EMXDAD2K.js}

@@ -11,19 +11,19 @@ import {
   getPlugins,
   setPlugins,
   validatePlugins
-} from "./chunk-WHEMUEXT.js";
-import "./chunk-LNYNTR27.js";
-import "./chunk-QWGZ273D.js";
-import "./chunk-TLN54TOQ.js";
-import "./chunk-LDRO4OQ4.js";
+} from "./chunk-ZBQIA5NI.js";
+import "./chunk-VZEKCQLD.js";
+import "./chunk-U37P4IIP.js";
+import "./chunk-TYEDZVRM.js";
+import "./chunk-RMI6OX52.js";
 import "./chunk-VFUK3X5B.js";
-import "./chunk-VL7OYSHD.js";
+import "./chunk-5LD6EBH2.js";
 import "./chunk-HZF5P5UN.js";
 import "./chunk-F3B2YJ76.js";
-import "./chunk-EJRJWBKG.js";
+import "./chunk-QQCEMMVN.js";
 import "./chunk-6GWA276C.js";
-import "./chunk-FX6BLEDP.js";
-import "./chunk-IKO5LFIU.js";
+import "./chunk-HDGTBCQR.js";
+import "./chunk-YPKPXLMS.js";
 import "./chunk-MLKGABMK.js";
 export {
   PluginHookDeniedError,

package/dist/api/schema/task.d.ts

@@ -14,7 +14,11 @@ export declare const scheduledTaskSummarySchema: z.ZodObject<{
     }, z.core.$strict>;
     id: z.ZodString;
     instruction: z.ZodString;
+    lastConversationId: z.ZodOptional<z.ZodString>;
+    lastRunAt: z.ZodOptional<z.ZodString>;
     ownedByViewer: z.ZodBoolean;
+    runsLast7Days: z.ZodNumber;
+    totalRuns: z.ZodNumber;
     kind: z.ZodLiteral<"scheduled">;
     nextRunAt: z.ZodOptional<z.ZodString>;
     schedule: z.ZodString;
@@ -38,7 +42,11 @@ export declare const eventTaskSummarySchema: z.ZodObject<{
     }, z.core.$strict>;
     id: z.ZodString;
     instruction: z.ZodString;
+    lastConversationId: z.ZodOptional<z.ZodString>;
+    lastRunAt: z.ZodOptional<z.ZodString>;
     ownedByViewer: z.ZodBoolean;
+    runsLast7Days: z.ZodNumber;
+    totalRuns: z.ZodNumber;
     events: z.ZodArray<z.ZodString>;
     kind: z.ZodLiteral<"event">;
     resource: z.ZodString;
@@ -60,7 +68,11 @@ export declare const taskSummarySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strict>;
     id: z.ZodString;
     instruction: z.ZodString;
+    lastConversationId: z.ZodOptional<z.ZodString>;
+    lastRunAt: z.ZodOptional<z.ZodString>;
     ownedByViewer: z.ZodBoolean;
+    runsLast7Days: z.ZodNumber;
+    totalRuns: z.ZodNumber;
     kind: z.ZodLiteral<"scheduled">;
     nextRunAt: z.ZodOptional<z.ZodString>;
     schedule: z.ZodString;
@@ -83,14 +95,29 @@ export declare const taskSummarySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strict>;
     id: z.ZodString;
     instruction: z.ZodString;
+    lastConversationId: z.ZodOptional<z.ZodString>;
+    lastRunAt: z.ZodOptional<z.ZodString>;
     ownedByViewer: z.ZodBoolean;
+    runsLast7Days: z.ZodNumber;
+    totalRuns: z.ZodNumber;
     events: z.ZodArray<z.ZodString>;
     kind: z.ZodLiteral<"event">;
     resource: z.ZodString;
     source: z.ZodString;
     triggerAvailable: z.ZodBoolean;
 }, z.core.$strict>], "kind">;
+/** One UTC day of successful task executions stacked by task type. */
+export declare const taskExecutionDaySchema: z.ZodObject<{
+    date: z.ZodString;
+    event: z.ZodNumber;
+    scheduled: z.ZodNumber;
+}, z.core.$strict>;
 export declare const taskListSchema: z.ZodObject<{
+    executionDays: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        event: z.ZodNumber;
+        scheduled: z.ZodNumber;
+    }, z.core.$strict>>;
     tasks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         createdAt: z.ZodString;
         createdBy: z.ZodString;
@@ -106,7 +133,11 @@ export declare const taskListSchema: z.ZodObject<{
         }, z.core.$strict>;
         id: z.ZodString;
         instruction: z.ZodString;
+        lastConversationId: z.ZodOptional<z.ZodString>;
+        lastRunAt: z.ZodOptional<z.ZodString>;
         ownedByViewer: z.ZodBoolean;
+        runsLast7Days: z.ZodNumber;
+        totalRuns: z.ZodNumber;
         kind: z.ZodLiteral<"scheduled">;
         nextRunAt: z.ZodOptional<z.ZodString>;
         schedule: z.ZodString;
@@ -129,7 +160,11 @@ export declare const taskListSchema: z.ZodObject<{
         }, z.core.$strict>;
         id: z.ZodString;
         instruction: z.ZodString;
+        lastConversationId: z.ZodOptional<z.ZodString>;
+        lastRunAt: z.ZodOptional<z.ZodString>;
         ownedByViewer: z.ZodBoolean;
+        runsLast7Days: z.ZodNumber;
+        totalRuns: z.ZodNumber;
         events: z.ZodArray<z.ZodString>;
         kind: z.ZodLiteral<"event">;
         resource: z.ZodString;
@@ -145,5 +180,6 @@ export declare const taskParamsSchema: z.ZodObject<{
         scheduled: "scheduled";
     }>;
 }, z.core.$strict>;
+export type TaskExecutionDay = z.output<typeof taskExecutionDaySchema>;
 export type TaskSummary = z.output<typeof taskSummarySchema>;
 export type TaskList = z.output<typeof taskListSchema>;

package/dist/api/schema.d.ts

@@ -11,7 +11,7 @@ export type { ApiError } from "./schema/common";
 export { createPersonalTokenBodySchema, createdPersonalTokenSchema, personalTokenListSchema, personalTokenMetadataSchema, personalTokenParamsSchema, revokePersonalTokenResponseSchema, } from "./schema/personal-token";
 export type { PersonalTokenMetadata } from "./schema/personal-token";
 export { eventTaskSummarySchema, scheduledTaskSummarySchema, taskListSchema, taskParamsSchema, taskSummarySchema, } from "./schema/task";
-export type { TaskList, TaskSummary } from "./schema/task";
+export type { TaskExecutionDay, TaskList, TaskSummary } from "./schema/task";
 export { statSchema, statsReportSchema } from "./schema/stats";
 export type { StatReport, StatsReport } from "./schema/stats";
 export { healthReportSchema, pluginOperationalReportFeedSchema, pluginOperationalReportSchema, pluginPackageContentItemReportSchema, pluginPackageContentReportSchema, pluginSchema, pluginsSchema, runtimeInfoReportSchema, skillReportSchema, skillReportsSchema, } from "../reporting-schema";

package/dist/api/schema.js

@@ -37,7 +37,7 @@ import {
   taskListSchema,
   taskParamsSchema,
   taskSummarySchema
-} from "../chunk-QVEXYYFM.js";
+} from "../chunk-TRZSM67C.js";
 import {
   healthReportSchema,
   pluginOperationalReportFeedSchema,

package/dist/api.js

@@ -27,12 +27,14 @@ import {
   statsReportSchema,
   taskListSchema,
   taskParamsSchema
-} from "./chunk-QVEXYYFM.js";
+} from "./chunk-TRZSM67C.js";
 import {
   formatSlackConversationRedactedLabel,
   readHealthReport,
+  readTaskExecutionDays,
+  readTaskExecutionSummaries,
   resolveSlackConversationContextFromThreadId
-} from "./chunk-V365UVCU.js";
+} from "./chunk-Z67KVHMJ.js";
 import {
   buildSentryConversationUrl
 } from "./chunk-4CODA7P5.js";
@@ -54,15 +56,15 @@ import {
   listPublicEventTasksForTeams,
   listPublicScheduledTasksForTeams,
   readStats
-} from "./chunk-XTQGVNM3.js";
+} from "./chunk-45DPXMI3.js";
 import {
   parseSlackThreadId
-} from "./chunk-AH5HTUYX.js";
+} from "./chunk-IRTIVX42.js";
 import {
   agentTurnUsageSchema,
   hasAgentTurnUsage,
   renderJuniorNativeConversationEvent
-} from "./chunk-HX236W2U.js";
+} from "./chunk-CDQ4YIZM.js";
 import "./chunk-PDO5BLNM.js";
 import {
   createPluginLogger,
@@ -70,38 +72,38 @@ import {
   listConversationAnnotations,
   renderPluginConversationEvent,
   resolveViewerUser
-} from "./chunk-WHEMUEXT.js";
+} from "./chunk-ZBQIA5NI.js";
 import {
   decodeStoredConversationEvent,
   getDb,
   getSqlExecutor,
   locationFromRow,
   parseSessionSource
-} from "./chunk-LNYNTR27.js";
+} from "./chunk-VZEKCQLD.js";
 import {
   juniorApiTokens,
   juniorConversationEvents,
   juniorConversations,
   juniorIdentities,
   juniorUsers
-} from "./chunk-QWGZ273D.js";
-import "./chunk-TLN54TOQ.js";
-import "./chunk-LDRO4OQ4.js";
+} from "./chunk-U37P4IIP.js";
+import "./chunk-TYEDZVRM.js";
+import "./chunk-RMI6OX52.js";
 import {
   juniorDestinations
 } from "./chunk-VFUK3X5B.js";
 import {
   canExposeConversationPayload
-} from "./chunk-VL7OYSHD.js";
+} from "./chunk-5LD6EBH2.js";
 import "./chunk-HZF5P5UN.js";
 import {
   parseSlackChannelId,
   parseSlackTeamId
 } from "./chunk-F3B2YJ76.js";
-import "./chunk-EJRJWBKG.js";
+import "./chunk-QQCEMMVN.js";
 import "./chunk-6GWA276C.js";
-import "./chunk-FX6BLEDP.js";
-import "./chunk-IKO5LFIU.js";
+import "./chunk-HDGTBCQR.js";
+import "./chunk-YPKPXLMS.js";
 import "./chunk-MLKGABMK.js";
 
 // src/api.ts
@@ -2027,7 +2029,7 @@ function readDescriptionText(home) {
   }
 }
 async function readSkillReports() {
-  const { discoverSkills } = await import("./skills-P7Q6Z6PN.js");
+  const { discoverSkills } = await import("./skills-KJVS753I.js");
   const skills = await discoverSkills();
   return skillReportsSchema.parse(
     skills.map((skill) => ({
@@ -2037,7 +2039,7 @@ async function readSkillReports() {
   );
 }
 async function readPlugins() {
-  const { pluginCatalogRuntime } = await import("./catalog-runtime-VGB3DWXZ.js");
+  const { pluginCatalogRuntime } = await import("./catalog-runtime-NVPT6HA5.js");
   return pluginsSchema.parse(
     pluginCatalogRuntime.getProviders().map((plugin) => ({
       configKeys: plugin.manifest.configKeys ?? [],
@@ -2050,7 +2052,7 @@ async function readPlugins() {
 async function readRuntimeInfoReport() {
   const [{ homeDir }, { pluginCatalogRuntime }, plugins, skills] = await Promise.all([
     import("./discovery-GUFTFBTL.js"),
-    import("./catalog-runtime-VGB3DWXZ.js"),
+    import("./catalog-runtime-NVPT6HA5.js"),
     readPlugins(),
     readSkillReports()
   ]);
@@ -2066,7 +2068,7 @@ async function readRuntimeInfoReport() {
 }
 async function readPluginOperationalReportFeed() {
   const nowMs = Date.now();
-  const { getPluginOperationalReports } = await import("./agent-hooks-5BUIXVIX.js");
+  const { getPluginOperationalReports } = await import("./agent-hooks-EMXDAD2K.js");
   return pluginOperationalReportFeedSchema.parse({
     source: "plugins",
     generatedAt: new Date(nowMs).toISOString(),
@@ -3522,7 +3524,15 @@ async function destinationDetails(destinations) {
     })
   );
 }
-function scheduledTaskSummary(task, ownedByViewer, destination) {
+function executionSummaryFields(stats) {
+  return {
+    ...stats?.lastConversationId ? { lastConversationId: stats.lastConversationId } : {},
+    ...stats?.lastExecutedAtMs ? { lastRunAt: new Date(stats.lastExecutedAtMs).toISOString() } : {},
+    runsLast7Days: stats?.runsLast7Days ?? 0,
+    totalRuns: stats?.totalRuns ?? 0
+  };
+}
+function scheduledTaskSummary(task, ownedByViewer, destination, stats) {
   if (task.status === "deleted") {
     throw new Error("Deleted scheduled tasks cannot enter the Tasks view");
   }
@@ -3539,6 +3549,7 @@ function scheduledTaskSummary(task, ownedByViewer, destination) {
     id: task.id,
     instruction: displayText(task.task.text, "Untitled scheduled task"),
     kind: "scheduled",
+    ...executionSummaryFields(stats),
     ...nextRunAtMs !== void 0 ? { nextRunAt: new Date(nextRunAtMs).toISOString() } : {},
     ownedByViewer,
     schedule: displayText(task.schedule.description, "Schedule unavailable"),
@@ -3605,6 +3616,11 @@ async function readViewerTasks(user) {
   const visible = selected.filter(
     (candidate) => candidate.ownedByViewer || destinations.get(destinationKey(candidate.task.destination))?.visibility === "public"
   );
+  const [executionDays, scheduledStats, eventStats] = await Promise.all([
+    readTaskExecutionDays(),
+    readTaskExecutionSummaries("scheduled", "junior"),
+    readTaskExecutionSummaries("event", "junior")
+  ]);
   const tasks = visible.map((candidate) => {
     const destination = destinations.get(
       destinationKey(candidate.task.destination)
@@ -3622,7 +3638,8 @@ async function readViewerTasks(user) {
       const summary = scheduledTaskSummary(
         candidate.task,
         candidate.ownedByViewer,
-        destination
+        destination,
+        scheduledStats.get(candidate.task.id)
       );
       return {
         ...summary,
@@ -3644,6 +3661,7 @@ async function readViewerTasks(user) {
       id: task.id,
       instruction: task.task.text,
       kind: "event",
+      ...executionSummaryFields(eventStats.get(task.id)),
       ownedByViewer: candidate.ownedByViewer,
       resource: `${task.trigger.label} \xB7 ${task.trigger.identifier}`,
       source: task.trigger.namespace,
@@ -3651,6 +3669,7 @@ async function readViewerTasks(user) {
     };
   });
   return {
+    executionDays,
     tasks,
     truncated: ownedCandidates.length > TASK_LIST_LIMIT || publicCandidates.length > TASK_LIST_LIMIT
   };

package/dist/app.js

@@ -50,7 +50,7 @@ import {
   startConversationWork,
   startSlackProcessingReaction,
   stripLeadingBotMention
-} from "./chunk-TU7P77FI.js";
+} from "./chunk-5EX36ZCD.js";
 import "./chunk-FA6POGLH.js";
 import {
   ConversationTurnLifecycleService,
@@ -65,13 +65,14 @@ import {
   processPluginTask,
   requireTurnFailureEventId,
   scheduleSessionCompletedPluginTasks
-} from "./chunk-VQA25AL4.js";
+} from "./chunk-EJT7EPP3.js";
 import {
   GET,
   conversationVisibilityFromSlackChannelType,
+  recordTaskExecution,
   resolveSlackChannelTypeFromMessage,
   resolveSlackConversationContext
-} from "./chunk-V365UVCU.js";
+} from "./chunk-Z67KVHMJ.js";
 import "./chunk-4CODA7P5.js";
 import "./chunk-UTL3MHPC.js";
 import {
@@ -90,7 +91,7 @@ import {
 import {
   validatePluginEgressCredentialHooks,
   validatePluginRegistrations
-} from "./chunk-5ZAZHLIW.js";
+} from "./chunk-EBRB6ZBF.js";
 import {
   defineJuniorPlugins,
   pluginCatalogConfigFromEnv,
@@ -125,7 +126,7 @@ import {
   setConfigDefaults,
   shouldEmitDevAgentTrace,
   shouldPropagateSandboxEgressTrace
-} from "./chunk-T5FPIBU2.js";
+} from "./chunk-Y6627MTY.js";
 import "./chunk-DIB4GX3G.js";
 import {
   RetryableDeliveryError,
@@ -136,7 +137,7 @@ import {
   formatProviderLabel,
   postSlackMessage,
   startOAuthFlow
-} from "./chunk-HTGXUNEC.js";
+} from "./chunk-P2D7IW57.js";
 import {
   ConversationTurnBoundaryError,
   CooperativeTurnYieldError,
@@ -192,20 +193,20 @@ import {
   trimTrailingAssistantMessages,
   updateConversationStats,
   upsertConversationMessage
-} from "./chunk-ECUILEUX.js";
+} from "./chunk-NGX2V4WY.js";
 import "./chunk-EPBBYMNE.js";
 import {
   getSandboxResourceConfig,
   setSandboxResourceConfig
-} from "./chunk-TBVS7GBE.js";
+} from "./chunk-OSCF2BDE.js";
 import {
   createSchedulerSqlStore,
   findMatchingEventTasks
-} from "./chunk-XTQGVNM3.js";
+} from "./chunk-45DPXMI3.js";
 import {
   parseSlackThreadId
-} from "./chunk-AH5HTUYX.js";
-import "./chunk-HX236W2U.js";
+} from "./chunk-IRTIVX42.js";
+import "./chunk-CDQ4YIZM.js";
 import "./chunk-PDO5BLNM.js";
 import "./chunk-UIE3R5XU.js";
 import {
@@ -232,7 +233,7 @@ import {
   verifyEventTaskCredentialSubject,
   verifyScheduledTaskCredentialSubject,
   verifySlackDirectCredentialSubject
-} from "./chunk-WHEMUEXT.js";
+} from "./chunk-ZBQIA5NI.js";
 import {
   contextProvenance,
   createSlackDestination,
@@ -243,16 +244,16 @@ import {
   instructionProvenanceFor,
   requireSlackDestination,
   withConversationEventLock
-} from "./chunk-LNYNTR27.js";
+} from "./chunk-VZEKCQLD.js";
 import {
   juniorConversationEvents,
   juniorConversations
-} from "./chunk-QWGZ273D.js";
+} from "./chunk-U37P4IIP.js";
 import {
   acquireActiveLock,
   getStateAdapter,
   sleep
-} from "./chunk-TLN54TOQ.js";
+} from "./chunk-TYEDZVRM.js";
 import {
   STANDARD_MODEL_PROFILE,
   botConfig,
@@ -270,16 +271,16 @@ import {
   modelIdForProfile,
   setSlackReactionConfig,
   standardModelId
-} from "./chunk-LDRO4OQ4.js";
+} from "./chunk-RMI6OX52.js";
 import {
   juniorDestinations
 } from "./chunk-VFUK3X5B.js";
-import "./chunk-VL7OYSHD.js";
-import "./chunk-IVTHTAVK.js";
+import "./chunk-5LD6EBH2.js";
+import "./chunk-AGAHACF7.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-JLN4XSPR.js";
-import "./chunk-HJ4KDO4N.js";
+} from "./chunk-UXYZPEWP.js";
+import "./chunk-6UNZ5DHG.js";
 import {
   credentialSubjectSchema
 } from "./chunk-77VDLF3Z.js";
@@ -311,7 +312,7 @@ import {
   withContext,
   withLogContext,
   withSpan
-} from "./chunk-EJRJWBKG.js";
+} from "./chunk-QQCEMMVN.js";
 import {
   continueTrace
 } from "./chunk-6GWA276C.js";
@@ -319,10 +320,10 @@ import "./chunk-OOUNJNMR.js";
 import "./chunk-H4HBKISO.js";
 import {
   JUNIOR_PLUGIN_TASK_CALLBACK_ROUTE
-} from "./chunk-FX6BLEDP.js";
+} from "./chunk-HDGTBCQR.js";
 import {
   JUNIOR_VERSION
-} from "./chunk-IKO5LFIU.js";
+} from "./chunk-YPKPXLMS.js";
 import "./chunk-MLKGABMK.js";
 
 // src/app.ts
@@ -697,7 +698,8 @@ async function markDispatchBlocked(id, errorMessage, resultMessageTs) {
   );
 }
 async function markDispatchCompleted(id, resultMessageTs) {
-  return await transitionDispatch(
+  const previous = await getDispatchRecord(id);
+  const next = await transitionDispatch(
     id,
     (record) => isTerminalDispatchStatus(record.status) ? record : {
       ...record,
@@ -706,6 +708,17 @@ async function markDispatchCompleted(id, resultMessageTs) {
       status: "completed"
     }
   );
+  if (next?.status === "completed" && previous?.status !== "completed" && next.plugin === "junior") {
+    const eventTaskId = next.metadata?.eventTaskId;
+    if (eventTaskId) {
+      await recordTaskExecution("event", eventTaskId, {
+        conversationId: getDispatchConversationId(next),
+        executionId: next.id,
+        nowMs: next.updatedAtMs
+      });
+    }
+  }
+  return next;
 }
 async function markDispatchFailed(id, errorMessage, resultMessageTs) {
   return await transitionDispatch(
@@ -1583,6 +1596,14 @@ async function applyDispatchResult(args) {
       run: args.run,
       status: "completed"
     });
+    const dispatchId = args.run.dispatchId;
+    if (dispatchId) {
+      await recordTaskExecution("scheduled", args.run.taskId, {
+        conversationId: getDispatchConversationId({ id: dispatchId }),
+        executionId: args.run.id,
+        nowMs: args.nowMs
+      });
+    }
     return true;
   }
   if (args.dispatch.status === "blocked") {
@@ -9355,6 +9376,7 @@ async function ingestEventTasks(input, options) {
           destination: task.destination,
           destinationVisibility: task.destinationVisibility,
           input: eventInput(task, event),
+          metadata: { eventTaskId: task.id },
           replyAttribution: replyAttribution2(task, event),
           source: createSlackSource3({
             teamId: task.destination.teamId,

package/dist/{catalog-runtime-VGB3DWXZ.js → catalog-runtime-NVPT6HA5.js}

@@ -1,16 +1,16 @@
 import {
   pluginCatalogRuntime
-} from "./chunk-JLN4XSPR.js";
-import "./chunk-HJ4KDO4N.js";
+} from "./chunk-UXYZPEWP.js";
+import "./chunk-6UNZ5DHG.js";
 import "./chunk-77VDLF3Z.js";
 import "./chunk-HZF5P5UN.js";
 import "./chunk-F3B2YJ76.js";
-import "./chunk-EJRJWBKG.js";
+import "./chunk-QQCEMMVN.js";
 import "./chunk-6GWA276C.js";
 import "./chunk-OOUNJNMR.js";
 import "./chunk-H4HBKISO.js";
-import "./chunk-FX6BLEDP.js";
-import "./chunk-IKO5LFIU.js";
+import "./chunk-HDGTBCQR.js";
+import "./chunk-YPKPXLMS.js";
 import "./chunk-MLKGABMK.js";
 export {
   pluginCatalogRuntime

package/dist/chat/agent/prompt.d.ts

@@ -19,26 +19,27 @@ export type UserContentPart = {
 };
 /** User-turn content parts plus the plain-text blocks used for routing decisions. */
 export interface PromptInput {
+    contextContentParts: UserContentPart[];
     routerBlocks: string[];
     userContentParts: UserContentPart[];
 }
 /** Fully assembled prompt state for one run slice. */
 export interface PromptAssembly {
     baseInstructions: string;
+    contextContentParts: UserContentPart[];
     inputMessages: Array<{
         role: string;
         content: Record<string, unknown>[];
     }>;
     inputMessagesAttribute: string | undefined;
-    promptContentParts: UserContentPart[];
+    promptTimestamp?: number;
     promptHistoryMessages: PiMessage[];
     shouldPromptAgent: boolean;
     turnContexts: PluginTurnContext[];
+    userContentParts: UserContentPart[];
 }
-/**
- * Keep thread text separate from the canonical active task boundary.
- */
-export declare function buildUserTurnText(userInput: string, conversationContext?: string, actor?: AgentRunInstructionActor): string;
+/** Render the current actor's instruction without host-owned thread context. */
+export declare function buildUserTurnText(userInput: string, actor?: AgentRunInstructionActor): string;
 /** Render an explicitly selected skill as instructions for the current turn. */
 export declare function renderExplicitSkillInstructions(skill: Skill): string;
 /** Encode a non-image attachment as base64 XML for the prompt. */
@@ -64,6 +65,7 @@ export declare function assemblePrompt(args: {
     artifactState?: ThreadArtifactsState;
     availableSkills: SkillMetadata[];
     configurationValues: Record<string, unknown>;
+    contextContentParts: UserContentPart[];
     conversationPrivacy?: ConversationPrivacy;
     existingSessionPiMessages?: PiMessage[];
     existingTurnStartMessageIndex?: number;

package/dist/chat/agent/repository-context.d.ts

@@ -0,0 +1,20 @@
+import type { AgentContext, AgentLoopTurnUpdate } from "@earendil-works/pi-agent-core";
+import type { ConversationMessageProvenance } from "@/chat/conversations/provenance";
+import type { UserContentPart } from "@/chat/agent/prompt";
+import type { PiMessage } from "@/chat/pi/messages";
+import { type RepositoryInstructions } from "@/chat/repository-instructions";
+type RepositoryInstructionsContextOptions = {
+    capture(): Promise<RepositoryInstructions | undefined>;
+    hasSandbox(): boolean;
+    initialInstructions?: RepositoryInstructions;
+    restoredMessages?: PiMessage[];
+    restoredProvenance?: ConversationMessageProvenance[];
+    promptContextContentParts: UserContentPart[];
+    setMessages(messages: PiMessage[]): void;
+    shouldPromptAgent: boolean;
+};
+/** Track model-visible AGENTS.md state and append updates before later samples. */
+export declare function createRepositoryInstructionsContext(options: RepositoryInstructionsContextOptions): {
+    applyUpdate(currentUpdate: AgentLoopTurnUpdate | undefined, currentContext: AgentContext): Promise<AgentLoopTurnUpdate | undefined>;
+};
+export {};

package/dist/chat/agent/sandbox.d.ts

@@ -6,6 +6,7 @@
  * routing, and generated-artifact materialization.
  */
 import type { FileUpload } from "chat";
+import type { PluginSandbox } from "@sentry/junior-plugin-api";
 import { type Actor } from "@/chat/actor";
 import type { ChannelConfigurationService } from "@/chat/configuration/types";
 import type { CredentialContext } from "@/chat/credentials/context";
@@ -13,6 +14,7 @@ import type { LogContext } from "@/chat/logging";
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress/tracing";
 import type { SandboxEgressSignalTransport } from "@/chat/sandbox/egress/signals";
 import type { SandboxRef } from "@/chat/sandbox/ref";
+import type { RepositoryInstructions } from "@/chat/repository-instructions";
 import { type SandboxTools } from "@/chat/sandbox/sandbox";
 import type { SandboxWorkspace } from "@/chat/sandbox/workspace";
 import type { Skill, SkillMetadata } from "@/chat/skills";
@@ -33,11 +35,17 @@ export interface AgentSandboxOptions {
     persistSandboxRef?(sandboxRef: SandboxRef): void | Promise<void>;
 }
 export interface AgentSandbox {
+    /** Resolve the AGENTS.md bundle for the selected repository directory. */
+    captureRepositoryInstructions(): Promise<RepositoryInstructions | undefined>;
     readonly tools: SandboxTools;
     readonly workspace: SandboxWorkspace;
     sandboxRef(): SandboxRef | undefined;
     close(): void;
     writeGeneratedArtifacts(files: FileUpload[]): Promise<GeneratedArtifactFileRef[]>;
 }
+/** Adapt agent sandbox execution for plugin-owned workspace tools. */
+export declare function createPluginToolSandbox(sandbox: Pick<AgentSandbox, "tools" | "workspace">, options: {
+    handleAuthSignal(details: unknown): Promise<void>;
+}): PluginSandbox;
 /** Create run-scoped sandbox capabilities adapted to the current agent context. */
 export declare function createAgentSandbox(options: AgentSandboxOptions): AgentSandbox;

package/dist/chat/agent/tools.d.ts

@@ -17,6 +17,7 @@ import type { AnyToolDefinition } from "@/chat/tools/definition";
 import type { ToolRuntimeContext } from "@/chat/tools/types";
 import { type ActiveMcpCatalogSummary } from "@/chat/tool-support/skill/mcp-tool-summary";
 import type { SandboxRef } from "@/chat/sandbox/ref";
+import type { RepositoryInstructions } from "@/chat/repository-instructions";
 import type { PiMessage } from "@/chat/pi/messages";
 import type { LogContext } from "@/chat/logging";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
@@ -81,6 +82,8 @@ export interface ToolWiring {
         isError?: boolean;
     }>(toolCallId: string, result: TResult): TResult;
     getSandboxRef: () => SandboxRef | undefined;
+    /** Resolve the AGENTS.md bundle selected by the sandbox workspace. */
+    captureRepositoryInstructions: () => Promise<RepositoryInstructions | undefined>;
     close(): Promise<void>;
     toolGuidance: Array<{
         name: string;