@sentry/junior 0.186.0 → 0.187.0

package/dist/chat/api-turns/{accepted-reply.d.ts → assistant-message.d.ts}

@@ -1,11 +1,12 @@
 import type { AssistantMessage } from "@earendil-works/pi-ai";
 import type { ThreadConversationState } from "@/chat/state/conversation";
-/** Record a web-accepted assistant reply with agent history before the visible message. */
-export declare function commitWebAcceptedReply(args: {
+/** Store one assistant Message and its Agent history. */
+export declare function commitAssistantMessage(args: {
     agentMessage?: AssistantMessage;
     conversation: ThreadConversationState;
     conversationId: string;
     sessionId: string;
+    source?: "web";
     text: string;
     userMessageId: string;
 }): Promise<void>;

package/dist/chat/api-turns/cancellation.d.ts

@@ -12,7 +12,6 @@ export declare function createApiTurnCancellation(): ApiTurnCancellation;
 /** Close one cancelled Turn without a failure reply or retry. */
 export declare function completeCancelledApiTurn(args: {
     acknowledge(): Promise<void>;
-    actorId: string;
     cancellation?: ApiTurnCancellation;
     conversation: ThreadConversationState;
     conversationId: string;

package/dist/chat/api-turns/mailbox-input.d.ts

@@ -1,7 +1,4 @@
 /** Shared mailbox helpers for conversation-only turns. */
-import type { LocalActor } from "@/chat/actor";
 import type { InboundMessage } from "@/chat/task-execution/store";
 /** Join non-empty mailbox texts for one conversation-only turn. */
 export declare function joinMailboxText(messages: readonly InboundMessage[]): string;
-/** Local actor stamped on resource-event conversation-only turns. */
-export declare function localResourceEventActor(): LocalActor;

package/dist/chat/api-turns/routing.d.ts

@@ -1,4 +1,8 @@
 import { z } from "zod";
+import { type Source } from "@sentry/junior-plugin-api";
+import { type Actor } from "@/chat/actor";
+import type { ConversationPrivacy } from "@/chat/conversation-privacy";
+import type { ConversationAuthor, ConversationMessage } from "@/chat/state/conversation";
 import type { InboundMessage } from "@/chat/task-execution/store";
 import type { ConversationWorkerContext } from "@/chat/task-execution/worker";
 declare const apiTurnMailboxMetadataSchema: z.ZodObject<{
@@ -10,37 +14,34 @@ declare const apiTurnMailboxMetadataSchema: z.ZodObject<{
     messageId: z.ZodString;
 }, z.core.$strict>;
 export type ApiTurnMailboxMetadata = z.output<typeof apiTurnMailboxMetadataSchema>;
-/**
- * Local destination resource-event mailbox rows share the conversation-only runner.
- *
- * TODO(resource-events): Remove the dedicated `resource_event` work kind once
- * local/web destinations run plain mailbox system wakes the same way as any
- * other deferred conversation turn (no special batch/actor fork).
- */
-export type LocalResourceEventMailboxEntry = {
+export interface TurnInput {
+    actor: Actor;
+    author: ConversationAuthor;
     message: InboundMessage;
-    kind: "resource_event";
-};
+    source: "resource_event" | "web";
+}
+export type TurnIdentity = Pick<TurnInput, "actor" | "author" | "source">;
+/** Restore normalized Turn identity from one saved Message. */
+export declare function turnIdentityFromConversationMessage(message: ConversationMessage): TurnIdentity | undefined;
+/** Build the AgentRun Source for one Turn input. */
+export declare function sourceFromTurnInput(args: {
+    conversationId: string;
+    source: TurnInput["source"];
+    visibility?: ConversationPrivacy;
+}): Source;
 /** Return the active root API Turn for one Conversation, if it has one. */
 export declare function getActiveApiTurnId(conversationId: string): Promise<string | undefined>;
 /** Return the idle auth-paused root API Turn for one Conversation. */
 export declare function getAuthPausedApiTurnId(conversationId: string): Promise<string | undefined>;
 /**
- * Resolve conversation-only work from mailbox metadata or an active checkpoint.
+ * Resolve conversation-only work from new input or a saved Turn.
  *
- * Covers dashboard API turns and local destination resource-event wakes. Empty
- * resume wakes after yield carry no mailbox rows; durable active Turn state keeps
- * those wakes on this runner instead of falling through to Slack.
+ * User messages from the Conversation API run here. Resource events with a
+ * local Destination run here too. Saved state identifies a resumed Turn.
  */
 export declare function resolveApiTurnWork(context: ConversationWorkerContext): Promise<{
     kind: "mailbox";
-    batch: Array<{
-        message: InboundMessage;
-        metadata: ApiTurnMailboxMetadata;
-    }>;
-} | {
-    kind: "resource_event";
-    batch: LocalResourceEventMailboxEntry[];
+    batch: TurnInput[];
 } | {
     kind: "resume";
     turnId: string;

package/dist/chat/api-turns/work.d.ts

@@ -1,7 +1,7 @@
 import type { StateAdapter } from "chat";
 import { type Destination } from "@sentry/junior-plugin-api";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
-import type { WebActor } from "@/chat/actor";
+import { type WebActor } from "@/chat/actor";
 import type { ConversationStore } from "@/chat/conversations/store";
 import type { AgentRunner } from "@/chat/runtime/agent-runner";
 import { type InboundMessage } from "@/chat/task-execution/store";
@@ -90,7 +90,7 @@ export declare function appendAndEnqueueApiConversationMessage(input: AppendApiC
     exclusive: true;
 }): Promise<ApiConversationMessageAdmission>;
 export declare function appendAndEnqueueApiConversationMessage(input: AppendApiConversationMessageInput, options: EnqueueOptions): Promise<ApiConversationMessageAccepted>;
-/** Create the worker for messages from the Conversation API. */
+/** Create the worker for Turns that need no provider delivery. */
 export declare function createApiTurnWorker(agentRunner: AgentRunner, cancellation?: ApiTurnCancellation): (context: ConversationWorkerContext) => Promise<ConversationWorkerResult>;
 /** Route Conversation API work before other work. */
 export declare function routeApiTurnWork(options: {

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

@@ -1,10 +1,10 @@
 import { z } from "zod";
-/** Provider-neutral container associated with a conversation. */
+/** One place outside Junior where a Conversation can be delivered. */
 export declare const locationSchema: z.ZodObject<{
     id: z.ZodString;
     provider: z.ZodString;
     tenantId: z.ZodOptional<z.ZodString>;
     providerId: z.ZodString;
 }, z.core.$strict>;
-/** Validated provider location associated with a conversation. */
+/** Validated Location associated with a Conversation. */
 export type Location = z.output<typeof locationSchema>;

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

@@ -17,6 +17,18 @@ export interface ConversationExecution {
 export interface ConversationLineage {
     parentConversationId: string;
 }
+/**
+ * Durable Conversation owned by Junior.
+ *
+ * The final interface stores zero or one complete Location here. No Location
+ * means the Conversation stays in Junior's API and UI. A Location names the
+ * outside place where a provider can deliver the Conversation. Source may also
+ * contain this Location so the agent can use it. Delivery contains it when
+ * output may be sent there. Only Delivery allows output to be sent.
+ *
+ * `destination` and `sessionSource` temporarily duplicate parts of that model.
+ * Their field TODOs state when each legacy copy can be removed.
+ */
 export interface Conversation {
     channelName?: string;
     conversationId: string;
@@ -30,6 +42,7 @@ export interface Conversation {
     };
     lastActivityAtMs: number;
     lineage?: ConversationLineage;
+    /** Optional provider coordinates associated with this Conversation. */
     location?: Location;
     actor?: StoredSlackActor;
     schemaVersion: 1;

package/dist/chat/resource-events/actor.d.ts

@@ -5,6 +5,13 @@
  * same system input for resource-event turns.
  */
 export declare const RESOURCE_EVENT_AUTHOR_ID = "UJRNEVENT";
+/** Synthetic Message author for resource-event input. */
+export declare const RESOURCE_EVENT_MESSAGE_AUTHOR: {
+    readonly fullName: "Junior event";
+    readonly isBot: true;
+    readonly userId: "UJRNEVENT";
+    readonly userName: "junior-event";
+};
 /** System execution actor for every resource-event turn. */
 export declare const RESOURCE_EVENT_SYSTEM_ACTOR: {
     readonly platform: "system";

package/dist/chat/services/turn-session-routing.d.ts

@@ -1,5 +1,5 @@
 /**
- * Load destination and session source from the conversation record.
+ * Load Location, Destination, and session Source from the Conversation record.
  *
  * Destination is set once on the root conversation. Child conversations
  * inherit through parent lineage. Later turns and mailbox wakes use that
@@ -7,18 +7,19 @@
  */
 import type { Destination, Source } from "@sentry/junior-plugin-api";
 import type { ConversationStore } from "@/chat/conversations/store";
+import type { Location } from "@/chat/conversations/location";
 export interface TurnSessionRouting {
     destination: Destination;
-    locationId?: string;
+    location?: Location;
     /** Present when the conversation already stores a session source. */
     source?: Source;
 }
-/** Full turn routing: destination plus a completed session source. */
+/** Conversation data with a required Destination and Source. */
 export type RequiredTurnSessionRouting = TurnSessionRouting & {
     source: Source;
 };
 /**
- * Resolve the conversation's destination and session source.
+ * Resolve the Conversation's Location, Destination, and session Source.
  *
  * Walks parent lineage when the conversation has no destination of its own.
  */
@@ -26,7 +27,7 @@ export declare function resolveConversationRouting(args: {
     conversationId: string;
     conversationStore?: ConversationStore;
 }): Promise<TurnSessionRouting | undefined>;
-/** Require conversation destination and session source from SQL. */
+/** Require the Conversation Destination and Source from SQL. */
 export declare function resolveTurnSessionRouting(args: {
     conversationId: string;
     conversationStore?: ConversationStore;

package/dist/chat/task-input.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Render agent input for a task run.
+ *
+ * Section order and required prose live in `chat/README.md` under Task agent
+ * input. Empty optional fields are omitted.
+ */
+export declare function renderTaskInput(args: {
+    /** Stored task instruction, or subscription intent. */
+    instructions: string;
+    /** Human label for the matched resource, when present. */
+    about?: string;
+    /** Plugin guidance scoped under the instructions. */
+    guidance?: string;
+    /** Trusted one-line summary, when available. */
+    trustedSummary?: string;
+    /** Structured verified fields, when available. */
+    verifiedDetails?: Record<string, unknown>;
+    /** Untrusted provider text; never treated as instructions. */
+    externalText?: string;
+    externalTextMaxLength?: number;
+    trustedSummaryMaxLength?: number;
+}): string;

package/dist/{chunk-CM6RTYSO.js → chunk-27T5HZHO.js}

@@ -1,18 +1,18 @@
 import {
   persistConversationMessages
-} from "./chunk-H7X2G2KS.js";
+} from "./chunk-D5BWM37G.js";
 import {
   JUNIOR_THREAD_STATE_TTL_MS
 } from "./chunk-3Y47VMHV.js";
 import {
   getDb
-} from "./chunk-43LODHJM.js";
+} from "./chunk-WKIS4VRK.js";
 import {
   juniorLocationConfigurations
-} from "./chunk-VXL2LBPK.js";
+} from "./chunk-HXR3FHTE.js";
 import {
   getStateAdapter
-} from "./chunk-DOP3FIQC.js";
+} from "./chunk-U6ZQHRIP.js";
 import {
   juniorDestinations
 } from "./chunk-VFUK3X5B.js";
@@ -20,7 +20,7 @@ import {
   isRecord,
   toOptionalNumber,
   toOptionalString
-} from "./chunk-3CVEE6LA.js";
+} from "./chunk-6YCIYOVA.js";
 
 // src/chat/state/conversation.ts
 function defaultConversationState() {
@@ -372,7 +372,10 @@ function createSqlLocationConfigurationStorage(db, destination) {
   };
 }
 function createDurableLocationConfigurationService(args) {
-  const storage = createSqlLocationConfigurationStorage(args.db, args.destination);
+  const storage = createSqlLocationConfigurationStorage(
+    args.db,
+    args.destination
+  );
   let cutover;
   const ensureCutover = () => cutover ??= (async () => {
     if ((await storage.list()).length > 0) {
@@ -504,6 +507,85 @@ function getLocationConfigurationService(destination) {
   });
 }
 
+// src/chat/services/turn-session-routing.ts
+async function loadConversationChain(conversationId, conversationStore) {
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set();
+  let cursor = conversationId;
+  while (cursor && !seen.has(cursor)) {
+    seen.add(cursor);
+    const conversation = await conversationStore.get({
+      conversationId: cursor
+    });
+    if (!conversation) {
+      break;
+    }
+    chain.push(conversation);
+    cursor = conversation.lineage?.parentConversationId;
+  }
+  return chain;
+}
+function slackSourceForDestination(args) {
+  if (args.source?.platform !== "slack" || args.source.channelId !== args.destination.channelId) {
+    return void 0;
+  }
+  const threadTs = args.source.threadTs?.trim();
+  return {
+    platform: "slack",
+    visibility: args.source.visibility ?? "public",
+    teamId: args.source.teamId?.trim() || args.destination.teamId,
+    channelId: args.source.channelId,
+    ...threadTs ? { threadTs } : void 0
+  };
+}
+async function resolveConversationRouting(args) {
+  const conversationStore = args.conversationStore ?? (await import("./db-FBHAWVXU.js")).getConversationStore();
+  const chain = await loadConversationChain(
+    args.conversationId,
+    conversationStore
+  );
+  let destination;
+  let source;
+  let location;
+  for (const conversation of chain) {
+    destination ??= conversation.destination;
+    source ??= conversation.sessionSource;
+    location ??= conversation.location;
+    if (destination && source) {
+      break;
+    }
+  }
+  if (!destination) {
+    return void 0;
+  }
+  if (destination.platform === "slack") {
+    const slackSource = slackSourceForDestination({ destination, source });
+    return {
+      destination,
+      ...location ? { location } : void 0,
+      ...slackSource ? { source: slackSource } : void 0
+    };
+  }
+  return {
+    destination,
+    ...location ? { location } : void 0,
+    ...source ? { source } : void 0
+  };
+}
+async function resolveTurnSessionRouting(args) {
+  const routing = await resolveConversationRouting(args);
+  if (!routing?.destination || !routing.source) {
+    throw new Error(
+      `Conversation ${args.conversationId} is missing durable routing metadata`
+    );
+  }
+  return {
+    destination: routing.destination,
+    source: routing.source,
+    ...routing.location ? { location: routing.location } : void 0
+  };
+}
+
 export {
   configValueSchema,
   coerceThreadConversationState,
@@ -512,5 +594,7 @@ export {
   persistThreadRuntimeState,
   getPersistedThreadState,
   persistThreadStateById,
-  getLocationConfigurationService
+  getLocationConfigurationService,
+  resolveConversationRouting,
+  resolveTurnSessionRouting
 };

package/dist/{chunk-QBL2AVFF.js → chunk-2VUDJGB6.js}

@@ -1,10 +1,10 @@
 import {
   createAndEnqueueAgentInvocation
-} from "./chunk-EWRPUXE3.js";
+} from "./chunk-KRYJ5VOD.js";
 import {
   actorFromRun,
   toolInvocationDestination
-} from "./chunk-INQHUE72.js";
+} from "./chunk-6FGN7ZEG.js";
 
 // src/chat/agent-invocations/spawn.ts
 function bindSpawnAgent(run, options) {

package/dist/{chunk-7EOWT62G.js → chunk-4A2R3AQB.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-N7TMSOZH.js";
 import {
   toOptionalString
-} from "./chunk-3CVEE6LA.js";
+} from "./chunk-6YCIYOVA.js";
 
 // src/chat/slack/context.ts
 import { z } from "zod";