@sentry/junior 0.55.0 → 0.57.0

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

@@ -1,6 +1,7 @@
 import type { HeartbeatHookContext } from "@sentry/junior-plugin-api";
 /** Build the plugin-scoped heartbeat context that gates durable dispatch access. */
 export declare function createHeartbeatContext(args: {
+    legacyStatePrefixes?: string[];
     nowMs: number;
     plugin: string;
 }): HeartbeatHookContext;

package/dist/chat/app/services.d.ts

@@ -1,15 +1,18 @@
 import { type ConversationMemoryDeps, type ConversationMemoryService } from "@/chat/services/conversation-memory";
+import { type ContextCompactor, type ContextCompactorDeps } from "@/chat/services/context-compaction";
 import { type SubscribedReplyPolicy, type SubscribedReplyPolicyDeps } from "@/chat/services/subscribed-reply-policy";
 import type { ReplyExecutorServices } from "@/chat/runtime/reply-executor";
 import { type VisionContextDeps, type VisionContextService } from "@/chat/services/vision-context";
 export interface JuniorRuntimeServices {
     conversationMemory: ConversationMemoryService;
+    contextCompactor: ContextCompactor;
     replyExecutor: ReplyExecutorServices;
     subscribedReplyPolicy: SubscribedReplyPolicy;
     visionContext: VisionContextService;
 }
 export interface JuniorRuntimeServiceOverrides {
     conversationMemory?: Partial<ConversationMemoryDeps>;
+    contextCompactor?: Partial<ContextCompactorDeps>;
     replyExecutor?: Partial<Omit<ReplyExecutorServices, "generateThreadTitle">>;
     subscribedReplyPolicy?: Partial<SubscribedReplyPolicyDeps>;
     visionContext?: Partial<VisionContextDeps>;

package/dist/chat/config.d.ts

@@ -5,6 +5,7 @@ export interface BotConfig {
     fastModelId: string;
     loadingMessages: string[];
     modelId: string;
+    modelContextWindowTokens?: number;
     visionModelId?: string;
     turnTimeoutMs: number;
     userName: string;

package/dist/chat/pi/client.d.ts

@@ -23,6 +23,7 @@ export declare function completeText(params: {
     modelId: string;
     system?: string;
     messages: Message[];
+    messageAttributeMode?: "content" | "metadata";
     thinkingLevel?: ThinkingLevel;
     temperature?: number;
     maxTokens?: number;

package/dist/chat/plugins/state.d.ts

@@ -1,3 +1,6 @@
 import type { AgentPluginState } from "@sentry/junior-plugin-api";
+export interface PluginStateOptions {
+    legacyStatePrefixes?: string[];
+}
 /** Create a durable state namespace scoped to one trusted plugin. */
-export declare function createPluginState(plugin: string): AgentPluginState;
+export declare function createPluginState(plugin: string, options?: PluginStateOptions): AgentPluginState;

package/dist/chat/runtime/reply-executor.d.ts

@@ -3,9 +3,11 @@ import type { SlackAdapter } from "@chat-adapter/slack";
 import { generateAssistantReply as generateAssistantReplyImpl } from "@/chat/respond";
 import type { PreparedTurnState } from "@/chat/runtime/turn-preparation";
 import { type ConversationMemoryService } from "@/chat/services/conversation-memory";
+import type { ContextCompactor } from "@/chat/services/context-compaction";
 import { lookupSlackUser } from "@/chat/slack/user";
 import type { TurnContinuationRequest } from "@/chat/services/timeout-resume";
 export interface ReplyExecutorServices {
+    contextCompactor: ContextCompactor;
     generateAssistantReply: typeof generateAssistantReplyImpl;
     generateThreadTitle: ConversationMemoryService["generateThreadTitle"];
     getAwaitingTurnContinuationRequest: (args: {

package/dist/chat/services/context-budget.d.ts

@@ -0,0 +1,14 @@
+export interface ModelContextBudget {
+    contextWindow: number;
+    maxTokens: number;
+}
+/** Estimate text tokens with the shared coarse heuristic used for local budgets. */
+export declare function estimateTextTokens(text: string): number;
+/** Derive the automatic compaction threshold from model context capacity. */
+export declare function calculateContextCompactionTriggerTokens(model: ModelContextBudget): number;
+/** Derive the post-compaction target from the automatic trigger threshold. */
+export declare function calculateContextCompactionTargetTokens(triggerTokens: number): number;
+/** Resolve the automatic compaction threshold for the active agent model. */
+export declare function getAgentContextCompactionTriggerTokens(): number;
+/** Resolve the visible conversation compaction threshold for the auxiliary model. */
+export declare function getConversationContextCompactionTriggerTokens(): number;

package/dist/chat/services/context-compaction.d.ts

@@ -0,0 +1,33 @@
+import type { completeText } from "@/chat/pi/client";
+import type { PiMessage } from "@/chat/pi/messages";
+import type { ThreadConversationState } from "@/chat/state/conversation";
+export interface ContextCompactorDeps {
+    completeText: typeof completeText;
+    autoCompactionTriggerTokens?: number;
+}
+export interface ContextCompactor {
+    maybeCompact: (args: CompactContextArgs) => Promise<CompactContextResult>;
+}
+export interface CompactContextArgs {
+    conversation: ThreadConversationState;
+    conversationContext?: string;
+    conversationId: string;
+    onCompactionStart?: () => void;
+    previousSessionId: string;
+    metadata?: {
+        channelId?: string;
+        requesterId?: string;
+        runId?: string;
+        threadId?: string;
+    };
+}
+export interface CompactContextResult {
+    compacted: boolean;
+    piMessages?: PiMessage[];
+    reason?: "below_threshold" | "missing_context" | "not_completed" | "summary_failed";
+    sessionId?: string;
+}
+/** Build retained user messages for a compacted Pi replacement history. */
+export declare function selectRetainedUserMessages(messages: PiMessage[], maxTokens?: number): PiMessage[];
+/** Build the service that owns local context compaction and checkpoint forks. */
+export declare function createContextCompactor(deps: ContextCompactorDeps): ContextCompactor;

package/dist/chat/slack/assistant-thread/status-scheduler.d.ts

@@ -1,7 +1,7 @@
 import { type AssistantStatusSpec } from "@/chat/slack/assistant-thread/status-render";
 export type TimerHandle = ReturnType<typeof setTimeout>;
 export interface AssistantStatusSession {
-    start: () => void;
+    start: (status?: AssistantStatusSpec) => void;
     stop: () => Promise<void>;
     update: (status: AssistantStatusSpec) => void;
 }

package/dist/{chunk-XI3CFWTA.js → chunk-AA5TIFN5.js}

@@ -54,6 +54,35 @@ function getPiGatewayApiKeyOverride() {
 function extractText(message) {
   return (message.content ?? []).filter((part) => part.type === "text" && typeof part.text === "string").map((part) => part.text ?? "").join("").trim();
 }
+function contentMetadata(content) {
+  if (typeof content === "string") {
+    return [{ type: "text", chars: content.length }];
+  }
+  if (!Array.isArray(content)) {
+    return { type: typeof content };
+  }
+  return content.map((part) => {
+    if (!part || typeof part !== "object") {
+      return { type: typeof part };
+    }
+    const record = part;
+    const type = typeof record.type === "string" ? record.type : "unknown";
+    return {
+      type,
+      ...typeof record.text === "string" ? { chars: record.text.length } : {},
+      ...typeof record.mimeType === "string" ? { mimeType: record.mimeType } : {},
+      ...typeof record.mediaType === "string" ? { mediaType: record.mediaType } : {},
+      ...typeof record.data === "string" ? { dataChars: record.data.length } : {}
+    };
+  });
+}
+function toMessageMetadata(message) {
+  const record = message;
+  return {
+    role: record.role,
+    content: contentMetadata(record.content)
+  };
+}
 function parseJsonCandidate(text) {
   const trimmed = text.trim();
   if (!trimmed) return void 0;
@@ -126,8 +155,13 @@ function resolveGatewayModel(modelId) {
 async function completeText(params) {
   const model = resolveGatewayModel(params.modelId);
   const apiKey = getPiGatewayApiKeyOverride();
-  const requestMessagesAttribute = serializeGenAiAttribute(params.messages);
-  const systemInstructionsAttribute = params.system ? serializeGenAiAttribute([{ type: "text", content: params.system }]) : void 0;
+  const messageAttributeMode = params.messageAttributeMode ?? "content";
+  const requestMessagesAttribute = serializeGenAiAttribute(
+    messageAttributeMode === "metadata" ? params.messages.map(toMessageMetadata) : params.messages
+  );
+  const systemInstructionsAttribute = params.system ? serializeGenAiAttribute(
+    messageAttributeMode === "metadata" ? [{ type: "text", chars: params.system.length }] : [{ type: "text", content: params.system }]
+  ) : void 0;
   const baseAttributes = {
     "gen_ai.provider.name": GEN_AI_PROVIDER_NAME,
     "gen_ai.operation.name": GEN_AI_OPERATION_CHAT,
@@ -161,12 +195,19 @@ async function completeText(params) {
         }
       );
       const outputText = extractText(message);
-      const outputMessagesAttribute = serializeGenAiAttribute([
-        {
-          role: "assistant",
-          content: outputText ? [{ type: "text", text: outputText }] : []
-        }
-      ]);
+      const outputMessagesAttribute = serializeGenAiAttribute(
+        messageAttributeMode === "metadata" ? [
+          {
+            role: "assistant",
+            content: outputText ? [{ type: "text", chars: outputText.length }] : []
+          }
+        ] : [
+          {
+            role: "assistant",
+            content: outputText ? [{ type: "text", text: outputText }] : []
+          }
+        ]
+      );
       const usageAttributes = extractGenAiUsageAttributes(message);
       const endAttributes = {
         ...baseAttributes,
@@ -336,6 +377,17 @@ function parseAdvisorThinkingLevel(rawValue) {
     `AI_ADVISOR_THINKING_LEVEL must be one of: minimal, low, medium, high, xhigh`
   );
 }
+function parseOptionalPositiveInteger(envName, rawValue) {
+  const trimmed = toOptionalTrimmed(rawValue);
+  if (trimmed === void 0) {
+    return void 0;
+  }
+  const value = Number.parseInt(trimmed, 10);
+  if (!Number.isSafeInteger(value) || value <= 0 || String(value) !== trimmed) {
+    throw new Error(`${envName} must be a positive integer`);
+  }
+  return value;
+}
 var DEFAULT_MODEL_ID = getModel("vercel-ai-gateway", "openai/gpt-5.4").id;
 var DEFAULT_FAST_MODEL_ID = getModel(
   "vercel-ai-gateway",
@@ -363,6 +415,10 @@ function readBotConfig(env) {
   return {
     userName: env.JUNIOR_BOT_NAME ?? "junior",
     modelId: validateGatewayModelId(env.AI_MODEL) ?? DEFAULT_MODEL_ID,
+    modelContextWindowTokens: parseOptionalPositiveInteger(
+      "AI_MODEL_CONTEXT_WINDOW_TOKENS",
+      env.AI_MODEL_CONTEXT_WINDOW_TOKENS
+    ),
     fastModelId: validateGatewayModelId(env.AI_FAST_MODEL ?? env.AI_MODEL) ?? DEFAULT_FAST_MODEL_ID,
     loadingMessages: parseLoadingMessages(env.JUNIOR_LOADING_MESSAGES),
     visionModelId: validateGatewayModelId(env.AI_VISION_MODEL),

package/dist/cli/snapshot-warmup.js

@@ -1,7 +1,7 @@
 import {
   disconnectStateAdapter,
   resolveRuntimeDependencySnapshot
-} from "../chunk-XI3CFWTA.js";
+} from "../chunk-AA5TIFN5.js";
 import {
   getPluginProviders,
   getPluginRuntimeDependencies,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior",
-  "version": "0.55.0",
+  "version": "0.57.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -46,7 +46,7 @@
     "node-html-markdown": "^2.0.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.55.0"
+    "@sentry/junior-plugin-api": "0.57.0"
   },
   "peerDependencies": {
     "@sentry/node": ">=10.0.0"
@@ -61,7 +61,8 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vercel": "^54.4.0",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.7",
+    "@sentry/junior-scheduler": "0.57.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",

package/dist/chat/scheduler/cadence.d.ts

@@ -1,24 +0,0 @@
-import type { ScheduledCalendarFrequency, ScheduledTask, ScheduledTaskRecurrence } from "@/chat/scheduler/types";
-/** Parse an ISO timestamp into a finite Unix timestamp in milliseconds. */
-export declare function parseScheduleTimestamp(value: string): number | undefined;
-export interface ZonedDateTimeParts {
-    day: number;
-    hour: number;
-    minute: number;
-    month: number;
-    second: number;
-    weekday: number;
-    year: number;
-}
-/** Resolve a UTC timestamp into calendar parts for a named time zone. */
-export declare function getZonedDateTimeParts(timestampMs: number, timezone: string): ZonedDateTimeParts;
-/** Build a calendar recurrence anchored to an exact first run timestamp. */
-export declare function buildCalendarRecurrence(args: {
-    frequency: ScheduledCalendarFrequency;
-    interval?: number;
-    nextRunAtMs: number;
-    timezone: string;
-    weekdays?: number[];
-}): ScheduledTaskRecurrence;
-/** Return the next fire time after a completed run, when the task recurs. */
-export declare function getNextRunAtMs(task: ScheduledTask, scheduledForMs: number, afterMs?: number): number | undefined;

package/dist/chat/scheduler/plugin.d.ts

@@ -1,2 +0,0 @@
-/** Create Junior's built-in trusted scheduler plugin. */
-export declare function createSchedulerPlugin(): import("@sentry/junior-plugin-api").JuniorPlugin;

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

@@ -1,7 +0,0 @@
-import { type ScheduledRun, type ScheduledTask } from "@/chat/scheduler/types";
-/** Build the marker-delimited user prompt for one scheduled task execution. */
-export declare function buildScheduledTaskRunPrompt(args: {
-    nowMs: number;
-    run: ScheduledRun;
-    task: ScheduledTask;
-}): string;

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

@@ -1,49 +0,0 @@
-import type { StateAdapter } from "chat";
-import type { ScheduledRun, ScheduledTask } from "@/chat/scheduler/types";
-export interface SchedulerStore {
-    claimDueRun(args: {
-        nowMs: number;
-    }): Promise<ScheduledRun | undefined>;
-    getRun(runId: string): Promise<ScheduledRun | undefined>;
-    getTask(taskId: string): Promise<ScheduledTask | undefined>;
-    listIncompleteRuns(): Promise<ScheduledRun[]>;
-    listTasksForTeam(teamId: string): Promise<ScheduledTask[]>;
-    markRunBlocked(args: {
-        completedAtMs: number;
-        errorMessage: string;
-        runId: string;
-        startedAtMs?: number;
-    }): Promise<ScheduledRun | undefined>;
-    markRunCompleted(args: {
-        completedAtMs: number;
-        resultMessageTs?: string;
-        runId: string;
-        startedAtMs: number;
-    }): Promise<ScheduledRun | undefined>;
-    markRunFailed(args: {
-        completedAtMs: number;
-        errorMessage: string;
-        startedAtMs?: number;
-        runId: string;
-    }): Promise<ScheduledRun | undefined>;
-    markRunSkipped(args: {
-        completedAtMs: number;
-        errorMessage: string;
-        runId: string;
-    }): Promise<ScheduledRun | undefined>;
-    markRunDispatched(args: {
-        claimedAtMs: number;
-        dispatchId: string;
-        nowMs: number;
-        runId: string;
-    }): Promise<ScheduledRun | undefined>;
-    saveTask(task: ScheduledTask): Promise<void>;
-    updateTaskAfterRun(args: {
-        errorMessage?: string;
-        nowMs: number;
-        run: ScheduledRun;
-        status: "blocked" | "completed" | "failed";
-    }): Promise<void>;
-}
-/** Create the production scheduler store backed by Junior's state adapter. */
-export declare function createStateSchedulerStore(stateAdapter?: StateAdapter): SchedulerStore;

package/dist/chat/scheduler/types.d.ts

@@ -1,86 +0,0 @@
-export type ScheduledTaskStatus = "active" | "paused" | "blocked" | "deleted";
-export type ScheduledRunStatus = "pending" | "running" | "completed" | "failed" | "blocked" | "skipped";
-export interface ScheduledTaskPrincipal {
-    slackUserId: string;
-    fullName?: string;
-    userName?: string;
-}
-export interface ScheduledTaskExecutionActor {
-    type: "system";
-    id: string;
-}
-export declare const SCHEDULED_TASK_SYSTEM_ACTOR: Readonly<{
-    type: "system";
-    id: string;
-}>;
-export interface ScheduledTaskDestination {
-    platform: "slack";
-    teamId: string;
-    channelId: string;
-}
-export interface ScheduledTaskConversationAccess {
-    audience: "direct" | "group" | "channel";
-    visibility: "private" | "public" | "unknown";
-}
-export interface ScheduledTaskCredentialSubject {
-    type: "user";
-    userId: string;
-    allowedWhen: "private-direct-conversation";
-}
-export type ScheduledCalendarFrequency = "daily" | "weekly" | "monthly" | "yearly";
-export interface ScheduledLocalTime {
-    hour: number;
-    minute: number;
-}
-export interface ScheduledTaskRecurrence {
-    dayOfMonth?: number;
-    frequency: ScheduledCalendarFrequency;
-    interval: number;
-    month?: number;
-    startDate: string;
-    time: ScheduledLocalTime;
-    weekdays?: number[];
-}
-export interface ScheduledTaskSchedule {
-    description: string;
-    timezone: string;
-    kind: "one_off" | "recurring";
-    recurrence?: ScheduledTaskRecurrence;
-}
-export interface ScheduledTaskSpec {
-    text: string;
-}
-export interface ScheduledTask {
-    id: string;
-    createdAtMs: number;
-    createdBy: ScheduledTaskPrincipal;
-    conversationAccess?: ScheduledTaskConversationAccess;
-    credentialSubject?: ScheduledTaskCredentialSubject;
-    destination: ScheduledTaskDestination;
-    executionActor?: ScheduledTaskExecutionActor;
-    lastRunAtMs?: number;
-    nextRunAtMs?: number;
-    originalRequest?: string;
-    runNowAtMs?: number;
-    schedule: ScheduledTaskSchedule;
-    status: ScheduledTaskStatus;
-    statusReason?: string;
-    task: ScheduledTaskSpec;
-    updatedAtMs: number;
-    version: number;
-}
-export interface ScheduledRun {
-    id: string;
-    attempt: number;
-    claimedAtMs: number;
-    completedAtMs?: number;
-    dispatchId?: string;
-    errorMessage?: string;
-    idempotencyKey: string;
-    resultMessageTs?: string;
-    scheduledForMs: number;
-    startedAtMs?: number;
-    status: ScheduledRunStatus;
-    taskId: string;
-    taskVersion: number;
-}

package/dist/chat/tools/slack/schedule-tools.d.ts

@@ -1,29 +0,0 @@
-import type { ToolRuntimeContext } from "@/chat/tools/types";
-/** Create a tool that stores a scheduled task for the active Slack context. */
-export declare function createSlackScheduleCreateTaskTool(context: ToolRuntimeContext): import("@/chat/tools/definition").ToolDefinition<import("@sinclair/typebox").TObject<{
-    task: import("@sinclair/typebox").TString;
-    schedule: import("@sinclair/typebox").TString;
-    timezone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    next_run_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    recurrence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"daily">, import("@sinclair/typebox").TLiteral<"weekly">, import("@sinclair/typebox").TLiteral<"monthly">, import("@sinclair/typebox").TLiteral<"yearly">]>>;
-}>>;
-/** Create a tool that lists scheduled tasks for the active Slack destination. */
-export declare function createSlackScheduleListTasksTool(context: ToolRuntimeContext): import("@/chat/tools/definition").ToolDefinition<import("@sinclair/typebox").TObject<{}>>;
-/** Create a tool that edits a scheduled task in the active Slack destination. */
-export declare function createSlackScheduleUpdateTaskTool(context: ToolRuntimeContext): import("@/chat/tools/definition").ToolDefinition<import("@sinclair/typebox").TObject<{
-    task_id: import("@sinclair/typebox").TString;
-    task: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    schedule: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    timezone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    next_run_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    recurrence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"daily">, import("@sinclair/typebox").TLiteral<"weekly">, import("@sinclair/typebox").TLiteral<"monthly">, import("@sinclair/typebox").TLiteral<"yearly">]>, import("@sinclair/typebox").TNull]>>;
-    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"blocked">]>>;
-}>>;
-/** Create a tool that removes a scheduled task from the active Slack destination. */
-export declare function createSlackScheduleDeleteTaskTool(context: ToolRuntimeContext): import("@/chat/tools/definition").ToolDefinition<import("@sinclair/typebox").TObject<{
-    task_id: import("@sinclair/typebox").TString;
-}>>;
-/** Create a tool that marks an existing scheduled task due immediately. */
-export declare function createSlackScheduleRunTaskNowTool(context: ToolRuntimeContext): import("@/chat/tools/definition").ToolDefinition<import("@sinclair/typebox").TObject<{
-    task_id: import("@sinclair/typebox").TString;
-}>>;