@sentry/junior 0.188.0 → 0.189.0

package/migrations/meta/_journal.json

@@ -260,6 +260,13 @@
       "when": 1787598193137,
       "tag": "0036_complex_rage",
       "breakpoints": true
+    },
+    {
+      "idx": 37,
+      "version": "7",
+      "when": 1787873831749,
+      "tag": "0037_conversation_location",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior",
-  "version": "0.188.0",
+  "version": "0.189.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -85,7 +85,7 @@
     "pg": "^8.16.3",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.188.0"
+    "@sentry/junior-plugin-api": "0.189.0"
   },
   "devDependencies": {
     "@emnapi/core": "^1.10.0",
@@ -104,9 +104,9 @@
     "typescript": "^6.0.3",
     "vercel": "^54.4.0",
     "vitest": "^4.1.7",
-    "@sentry/junior-testing": "0.0.0",
-    "@sentry/junior-memory": "0.188.0",
-    "@sentry/junior-github": "0.188.0"
+    "@sentry/junior-github": "0.189.0",
+    "@sentry/junior-memory": "0.189.0",
+    "@sentry/junior-testing": "0.0.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",

package/dist/chat/api-turns/assistant-message.d.ts

@@ -1,12 +0,0 @@
-import type { AssistantMessage } from "@earendil-works/pi-ai";
-import type { ThreadConversationState } from "@/chat/state/conversation";
-/** 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

@@ -1,24 +0,0 @@
-/** App-scoped control for one active Turn started by the Conversation API. */
-export interface ApiTurnCancellation {
-    begin(conversationId: string): AbortSignal | undefined;
-    cancel(conversationId: string): boolean;
-    disconnect(conversationId: string, signal: AbortSignal): void;
-    finish(conversationId: string, signal: AbortSignal): void;
-    park(conversationId: string, signal: AbortSignal): void;
-    signal(conversationId: string): AbortSignal | undefined;
-}
-/** Create in-process cancellation state for Turns from the Conversation API. */
-export declare function createApiTurnCancellation(): ApiTurnCancellation;
-/** Close one cancelled Turn without a failure reply or retry. */
-export declare function completeCancelledApiTurn(args: {
-    acknowledge(): Promise<void>;
-    cancellation?: ApiTurnCancellation;
-    conversation: ThreadConversationState;
-    conversationId: string;
-    sandboxRef?: SandboxRef;
-    signal?: AbortSignal;
-    turnId: string;
-    userMessageId: string;
-}): Promise<void>;
-import type { SandboxRef } from "@/chat/sandbox/ref";
-import type { ThreadConversationState } from "@/chat/state/conversation";

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

@@ -1,51 +0,0 @@
-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<{
-    authorEmail: z.ZodString;
-    authorFullName: z.ZodOptional<z.ZodString>;
-    authorUserId: z.ZodString;
-    authorUserName: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"api_turn">;
-    messageId: z.ZodString;
-}, z.core.$strict>;
-export type ApiTurnMailboxMetadata = z.output<typeof apiTurnMailboxMetadataSchema>;
-export interface TurnInput {
-    actor: Actor;
-    author: ConversationAuthor;
-    message: InboundMessage;
-    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 new input or a saved Turn.
- *
- * 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: TurnInput[];
-} | {
-    kind: "resume";
-    turnId: string;
-} | undefined>;
-/** Return whether the leased attempt belongs to an API Turn. */
-export declare function isApiTurnWork(context: ConversationWorkerContext): Promise<boolean>;
-export {};

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

@@ -1,99 +0,0 @@
-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 { ConversationStore } from "@/chat/conversations/store";
-import type { AgentRunner } from "@/chat/runtime/agent-runner";
-import { type InboundMessage } from "@/chat/task-execution/store";
-import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
-import type { ConversationWorkerContext, ConversationWorkerResult } from "@/chat/task-execution/worker";
-import { type ApiTurnCancellation } from "@/chat/api-turns/cancellation";
-export { resolveApiTurnWork } from "@/chat/api-turns/routing";
-type EnqueueOptions = {
-    conversationStore?: ConversationStore;
-    nowMs?: number;
-    queue: ConversationWorkQueue;
-    state?: StateAdapter;
-};
-export interface CreateApiConversationInput {
-    actor: WebActor;
-    message: string;
-    /** Client-supplied idempotency key for the first message. */
-    idempotencyKey: string;
-    /** New roots default public. Continues never rewrite visibility. */
-    visibility?: ConversationPrivacy;
-}
-export interface AppendApiConversationMessageInput {
-    actor: WebActor;
-    conversationId: string;
-    message: string;
-    idempotencyKey: string;
-    /** Applied only when this call creates the conversation root. */
-    rootVisibility?: ConversationPrivacy;
-}
-export interface ApiConversationMessageAccepted {
-    conversationId: string;
-    messageId: string;
-    status: "accepted" | "duplicate";
-}
-export type ApiConversationMessageAdmission = ApiConversationMessageAccepted | {
-    conversationId: string;
-    messageId: string;
-    status: "active";
-};
-/**
- * Build a durable API conversation id for one viewer + create key.
- *
- * Retries of POST /api/conversations with the same key must address the same
- * conversation before the mailbox message id is derived.
- */
-export declare function createApiConversationId(args: {
-    actorEmail: string;
-    idempotencyKey: string;
-}): string;
-/** Build the retry-stable Message id used by one API mailbox request. */
-export declare function apiConversationMessageId(args: {
-    conversationId: string;
-    idempotencyKey: string;
-}): string;
-/** Stable turn id for one API mailbox message (matches getTurnUserMessage). */
-export declare function apiTurnIdForMessage(messageId: string): string;
-/** Rebuild the dashboard actor from durable conversation identity. */
-export declare function webActorFromEmail(email: string, profile?: {
-    fullName?: string;
-    userName?: string;
-}): WebActor;
-/** Build one API mailbox entry with conversation-only publish. */
-export declare function buildApiTurnInboundMessage(args: {
-    actor: WebActor;
-    conversationId: string;
-    createdAtMs?: number;
-    /** Existing conversation destination; required when continuing a provider root. */
-    destination?: Destination;
-    message: string;
-    messageId: string;
-    nowMs?: number;
-}): InboundMessage;
-/** Record web activity and materialize a new API Conversation root when needed. */
-export declare function recordApiConversationActivity(args: {
-    actor: WebActor;
-    conversationId: string;
-    conversationStore?: ConversationStore;
-    nowMs: number;
-    /** Applied only when this call creates the conversation root. */
-    rootVisibility?: ConversationPrivacy;
-}): Promise<Destination>;
-/** Create a dashboard root conversation and enqueue its first message. */
-export declare function createAndEnqueueApiConversation(input: CreateApiConversationInput, options: EnqueueOptions): Promise<ApiConversationMessageAccepted>;
-/** Append one Conversation API message and optionally require an idle Conversation. */
-export declare function appendAndEnqueueApiConversationMessage(input: AppendApiConversationMessageInput, options: EnqueueOptions & {
-    exclusive: true;
-}): Promise<ApiConversationMessageAdmission>;
-export declare function appendAndEnqueueApiConversationMessage(input: AppendApiConversationMessageInput, options: EnqueueOptions): Promise<ApiConversationMessageAccepted>;
-/** 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: {
-    apiTurnWorker: (context: ConversationWorkerContext) => Promise<ConversationWorkerResult>;
-    fallbackWorker: (context: ConversationWorkerContext) => Promise<ConversationWorkerResult>;
-}): (context: ConversationWorkerContext) => Promise<ConversationWorkerResult>;

package/dist/chat/task-execution/slack-resource-event.d.ts

@@ -1,55 +0,0 @@
-/**
- * Slack edge helpers for resource-event mailbox wakes.
- *
- * Resource-event ingest stores plain conversation mailbox input. When the
- * conversation destination is Slack, this module builds the Message and Thread
- * the Slack runtime needs for one turn. It does not rewrite mailbox rows.
- *
- * TODO(slack-runtime): Drop this module once Slack turns can start from
- * conversation destination + session source (channel, team, threadTs, text,
- * event metadata) without a synthetic chat Message/Thread. Resource wakes and
- * paused resume should share that entry; handleSubscribedMessage stays for
- * real webhook traffic only.
- */
-import { Message, ThreadImpl, type StateAdapter } from "chat";
-import type { SlackAdapter } from "@chat-adapter/slack";
-import type { Destination, SlackDestination } from "@sentry/junior-plugin-api";
-import type { ConversationStore } from "@/chat/conversations/store";
-import type { InboundMessage } from "@/chat/task-execution/store";
-/** Resolved Slack place for one plain resource-event wake, when a thread exists. */
-export type SlackResourceEventThread = {
-    destination: SlackDestination;
-    threadTs: string;
-};
-/**
- * Load Slack destination and threadTs for a resource-event wake.
- *
- * Returns undefined when the Conversation has no Slack thread. The temporary
- * synthetic Message/Thread bridge cannot invent one; the Slack worker must drop
- * that wake instead of retrying.
- */
-export declare function resolveSlackResourceEventThread(args: {
-    conversationId: string;
-    conversationStore?: ConversationStore;
-    destination?: Destination;
-}): Promise<SlackResourceEventThread | undefined>;
-/** Whether a mailbox row is a plain resource-event wake (no Slack envelope). */
-export declare function isPlainResourceEventRecord(record: InboundMessage): boolean;
-/**
- * Build a Slack Message for one plain resource-event mailbox row.
- *
- * Used only at the Slack worker edge. The mailbox row stays plain.
- */
-export declare function buildResourceEventSlackMessage(args: {
-    channelId: string;
-    record: InboundMessage;
-    threadTs: string;
-}): Message;
-/** Build a ThreadImpl for a resource-event Slack turn. */
-export declare function buildResourceEventSlackThread(args: {
-    adapter: SlackAdapter;
-    message: Message;
-    state: StateAdapter;
-    threadTs: string;
-    channelId: string;
-}): ThreadImpl;

package/dist/chunk-6FGN7ZEG.js

@@ -1,221 +0,0 @@
-import {
-  isExperimentalFeatureEnabled
-} from "./chunk-2LYHWMR4.js";
-
-// src/chat/agent/types.ts
-var RetryableDeliveryError = class extends Error {
-  constructor(cause) {
-    super("Assistant delivery was transient or ambiguous", { cause });
-    this.name = "RetryableDeliveryError";
-  }
-};
-function isAgentRunFeatureDisabled(disabledFeatures, feature) {
-  return disabledFeatures?.includes(feature) ?? false;
-}
-function actorFromRun(run) {
-  if (run.dispatch?.actor) {
-    return run.dispatch.actor;
-  }
-  if (run.actor) {
-    return run.actor;
-  }
-  if (run.credentialContext && !("type" in run.credentialContext.actor)) {
-    return run.credentialContext.actor;
-  }
-  return void 0;
-}
-function assertRunConsistency(run) {
-  const { destination, source } = run;
-  switch (source.platform) {
-    case "slack": {
-      if (destination.platform !== "slack") {
-        throw new TypeError(
-          "Run source and destination platforms do not match"
-        );
-      }
-      if (source.teamId !== destination.teamId) {
-        throw new TypeError("Slack source and destination teams do not match");
-      }
-      break;
-    }
-    case "local": {
-      if (destination.platform !== "local") {
-        throw new TypeError(
-          "Run source and destination platforms do not match"
-        );
-      }
-      if (source.conversationId !== destination.conversationId) {
-        throw new TypeError(
-          "Source and destination conversation IDs do not match"
-        );
-      }
-      if (run.surface !== "internal" && destination.conversationId !== run.conversationId) {
-        throw new TypeError(
-          "Source, destination, and run conversation IDs do not match"
-        );
-      }
-      break;
-    }
-    case "web": {
-      if (run.surface !== "internal" && source.conversationId !== run.conversationId) {
-        throw new TypeError("Web source and run conversation IDs do not match");
-      }
-      switch (destination.platform) {
-        case "local": {
-          if (source.conversationId !== destination.conversationId) {
-            throw new TypeError(
-              "Source and destination conversation IDs do not match"
-            );
-          }
-          if (run.surface !== "internal" && destination.conversationId !== run.conversationId) {
-            throw new TypeError(
-              "Source, destination, and run conversation IDs do not match"
-            );
-          }
-          break;
-        }
-        case "slack": {
-          if (run.publishExternally) {
-            throw new TypeError(
-              "Web turns on Slack destinations must not publish externally"
-            );
-          }
-          break;
-        }
-      }
-      break;
-    }
-  }
-  const actor = run.dispatch?.actor ?? run.actor;
-  if (!actor || actor.platform === "system") {
-    return;
-  }
-  const actorMatchesDestination = (() => {
-    switch (actor.platform) {
-      case "slack":
-        return destination.platform === "slack";
-      case "local":
-        return destination.platform === "local";
-      case "web":
-        return destination.platform === "local" || destination.platform === "slack" && run.publishExternally !== true;
-    }
-  })();
-  if (!actorMatchesDestination) {
-    throw new TypeError(
-      `Actor platform "${actor.platform}" does not match destination platform "${destination.platform}"`
-    );
-  }
-  if (actor.platform === "slack" && destination.platform === "slack" && actor.teamId !== destination.teamId) {
-    throw new TypeError("Slack actor team does not match destination team");
-  }
-}
-function toolInvocationDestination(run) {
-  if (run.destination.platform !== "slack" || !run.toolChannelId) {
-    return run.destination;
-  }
-  return {
-    platform: "slack",
-    teamId: run.destination.teamId,
-    channelId: run.toolChannelId
-  };
-}
-function surfaceFromRun(run) {
-  if (run.surface) {
-    return run.surface;
-  }
-  if (run.source.platform === "slack") {
-    return "slack";
-  }
-  if (run.source.platform === "web") {
-    return "api";
-  }
-  return "internal";
-}
-
-// src/chat/runtime/agent-runner.ts
-var AGENT_ABORT_SETTLE_GRACE_MS = 5e3;
-function createAgentRunner(execute, options) {
-  const attachmentStorage = options?.attachmentStorage;
-  const streamFn = options?.streamFn;
-  const tracePropagation = options?.tracePropagation;
-  const bindSpawnAgent = options?.bindSpawnAgent;
-  const canBindSpawn = Boolean(bindSpawnAgent) && isExperimentalFeatureEnabled("subagents");
-  return {
-    run: async (run) => {
-      const spawnAgent = bindSpawnAgent && canBindSpawn && !isAgentRunFeatureDisabled(run.disabledFeatures, "subagents") ? bindSpawnAgent(run) : void 0;
-      const nextRun = {
-        ...run,
-        environment: {
-          ...run.environment,
-          attachmentStorage: run.environment?.attachmentStorage ?? attachmentStorage,
-          sandboxTracePropagation: run.environment?.sandboxTracePropagation ?? tracePropagation
-        },
-        ...spawnAgent ? {
-          durability: {
-            ...run.durability,
-            spawnAgent
-          }
-        } : void 0
-      };
-      return await execute(nextRun, streamFn);
-    }
-  };
-}
-async function waitForAgentSettlement(runPromise) {
-  let timeoutId;
-  const settleGrace = new Promise((resolve) => {
-    timeoutId = setTimeout(resolve, AGENT_ABORT_SETTLE_GRACE_MS);
-    timeoutId.unref?.();
-  });
-  await Promise.race([
-    runPromise.then(
-      () => void 0,
-      () => void 0
-    ),
-    settleGrace
-  ]);
-  if (timeoutId) {
-    clearTimeout(timeoutId);
-  }
-}
-async function runAgentWithTimeout(agentRunner, run, timeoutMs) {
-  if (typeof timeoutMs !== "number") {
-    return await agentRunner.run(run);
-  }
-  const timeoutError = new Error(
-    `executeAgentRun timed out after ${timeoutMs}ms`
-  );
-  const abortController = new AbortController();
-  const signal = run.signal ? AbortSignal.any([run.signal, abortController.signal]) : abortController.signal;
-  const runPromise = agentRunner.run({ ...run, signal });
-  let timeoutId;
-  const timeoutPromise = new Promise((_, reject) => {
-    timeoutId = setTimeout(() => {
-      abortController.abort(timeoutError);
-      reject(timeoutError);
-    }, timeoutMs);
-  });
-  try {
-    return await Promise.race([runPromise, timeoutPromise]);
-  } catch (error) {
-    if (abortController.signal.aborted) {
-      await waitForAgentSettlement(runPromise);
-    }
-    throw error;
-  } finally {
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-    }
-  }
-}
-
-export {
-  RetryableDeliveryError,
-  isAgentRunFeatureDisabled,
-  actorFromRun,
-  assertRunConsistency,
-  toolInvocationDestination,
-  surfaceFromRun,
-  createAgentRunner,
-  runAgentWithTimeout
-};