@sentry/junior 0.198.0 → 0.199.0

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

@@ -1,43 +0,0 @@
-import type { HeartbeatHookContext, PluginRegistration } from "@sentry/junior-plugin-api";
-import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
-import type { SlackDispatchOptions } from "./types";
-/** Build the plugin-scoped heartbeat context that gates durable dispatch access. */
-export declare function createHeartbeatContext(args: {
-    conversationWorkQueue: ConversationWorkQueue;
-    nowMs: number;
-    plugin: string | PluginRegistration;
-}): HeartbeatHookContext;
-/** Create and enqueue one core-owned event task dispatch. */
-export declare function dispatchEventTask(args: {
-    conversationWorkQueue: ConversationWorkQueue;
-    nowMs: number;
-    options: Omit<SlackDispatchOptions, "credentialSubject"> & {
-        credentialSubject?: {
-            allowedWhen: "event-task";
-            taskId: string;
-            type: "user";
-            userId: string;
-        };
-    };
-}): Promise<{
-    id: string;
-    status: "created" | "already_exists";
-}>;
-/** Create and enqueue one core-owned scheduled task dispatch. */
-export declare function dispatchScheduledTask(args: {
-    conversationWorkQueue: ConversationWorkQueue;
-    nowMs: number;
-    options: Omit<SlackDispatchOptions, "credentialSubject"> & {
-        credentialSubject?: {
-            allowedWhen: "scheduled-task";
-            taskId: string;
-            type: "user";
-            userId: string;
-        };
-    };
-}): Promise<{
-    id: string;
-    status: "created" | "already_exists";
-}>;
-/** Read the bounded outcome for one core-owned scheduled task dispatch. */
-export declare function getScheduledTaskDispatch(id: string): Promise<import("./types").DispatchProjection | undefined>;

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

@@ -1,27 +0,0 @@
-import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
-/** Run plugin heartbeat hooks with bounded per-invocation work. */
-export declare function runPluginHeartbeats(args: {
-    conversationWorkQueue: ConversationWorkQueue;
-    limit?: number;
-    nowMs: number;
-}): Promise<void>;
-/**
- * Repair bounded dispatch mailbox appends that crashed before enqueue.
- *
- * This index is only an ingress receipt; conversation work owns execution,
- * leases, retries, and continuation after the mailbox append succeeds.
- */
-export declare function recoverPendingDispatchMailboxAppends(args: {
-    conversationWorkQueue: ConversationWorkQueue;
-    nowMs: number;
-}): Promise<void>;
-/** Repair invocation creation that stopped before its idempotent mailbox append. */
-export declare function recoverPendingAgentInvocationMailboxAppends(args: {
-    conversationWorkQueue: ConversationWorkQueue;
-    nowMs: number;
-}): Promise<void>;
-/** Run the core heartbeat phases. */
-export declare function runHeartbeat(args: {
-    conversationWorkQueue?: ConversationWorkQueue;
-    nowMs: number;
-}): Promise<void>;

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

@@ -1,42 +0,0 @@
-import type { BoundDispatchOptions, DispatchCreateResult, DispatchProjection, DispatchRecord, DispatchStatus } from "./types";
-/** Return the durable key for one plugin-facing dispatch projection. */
-export declare function getDispatchStorageKey(id: string): string;
-/** Parse one durable dispatch projection record. */
-export declare function parseDispatchRecord(value: unknown): DispatchRecord | undefined;
-/** Return the isolated durable conversation id for one dispatch. */
-export declare function getDispatchConversationId(dispatch: Pick<DispatchRecord, "id">): string;
-/** Return the stable synthetic input message id for one dispatch turn. */
-export declare function getDispatchInputMessageId(dispatchId: string): string;
-/** Return the stable turn id used by every run of one dispatch. */
-export declare function getDispatchTurnId(dispatchId: string): string;
-/** Gate recovery to dispatches that can still make progress. */
-export declare function isTerminalDispatchStatus(status: DispatchStatus): boolean;
-/** Load dispatch state for conversation work and plugin projections. */
-export declare function getDispatchRecord(id: string): Promise<DispatchRecord | undefined>;
-/** Create a dispatch idempotently within its owner namespace. */
-export declare function createOrGetDispatch(args: {
-    nowMs: number;
-    options: BoundDispatchOptions;
-    plugin: string;
-}): Promise<DispatchCreateResult>;
-/** Mark a dispatch projection as actively running. */
-export declare function markDispatchRunning(id: string): Promise<DispatchRecord | undefined>;
-/** Project a durable awaiting-resume turn state to the plugin API. */
-export declare function markDispatchAwaitingResume(id: string): Promise<DispatchRecord | undefined>;
-/** Project a blocked turn to the plugin API. */
-export declare function markDispatchBlocked(id: string, errorMessage: string, resultMessageTs?: string): Promise<DispatchRecord | undefined>;
-/** Project a completed turn and its accepted Slack message to the plugin API. */
-export declare function markDispatchCompleted(id: string, resultMessageTs?: string): Promise<DispatchRecord | undefined>;
-/** Project a terminal conversation turn failure to the plugin API. */
-export declare function markDispatchFailed(id: string, errorMessage: string, resultMessageTs?: string): Promise<DispatchRecord | undefined>;
-/** Remove a dispatch after its durable mailbox append has succeeded. */
-export declare function confirmDispatchMailboxAppend(id: string): Promise<void>;
-/** List dispatches whose durable mailbox append may not have completed. */
-export declare function listPendingDispatchMailboxAppends(): Promise<string[]>;
-/** Load the dispatch under lock before its mailbox append becomes visible. */
-export declare function claimDispatchMailboxAppend(id: string): Promise<DispatchRecord | undefined>;
-/** Return a plugin-scoped dispatch projection without exposing raw runtime state. */
-export declare function getPluginDispatchProjection(args: {
-    id: string;
-    plugin: string;
-}): Promise<DispatchProjection | undefined>;

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

@@ -1,60 +0,0 @@
-import type { DispatchOptions, DestinationVisibility, EventTaskSource, PluginDispatchSource, ReplyAttribution, ScheduledTaskSource, Source, SlackDestination } from "@sentry/junior-plugin-api";
-import type { CredentialContext, CredentialSubject, CredentialSystemActor } from "@/chat/credentials/context";
-import type { AgentDispatch } from "@/chat/agent/types";
-import type { AgentTurnSurface } from "@/chat/task-execution/checkpoint";
-import type { LocationConfigurationService } from "@/chat/configuration/types";
-export type DispatchStatus = "pending" | "running" | "awaiting_resume" | "completed" | "failed" | "blocked";
-export type SlackDispatchOptions = Omit<DispatchOptions, "destination"> & {
-    destination: SlackDestination;
-};
-export interface BoundDispatchOptions extends Omit<SlackDispatchOptions, "credentialSubject"> {
-    credentialSubject?: CredentialSubject;
-    source: EventTaskSource | PluginDispatchSource | ScheduledTaskSource;
-}
-export interface DispatchRecord {
-    actor: CredentialSystemActor;
-    createdAtMs: number;
-    credentialSubject?: CredentialSubject;
-    destination: SlackDestination;
-    destinationVisibility: DestinationVisibility;
-    errorMessage?: string;
-    id: string;
-    idempotencyKey: string;
-    input: string;
-    metadata?: Record<string, string>;
-    plugin: string;
-    replyAttribution?: ReplyAttribution;
-    resultMessageTs?: string;
-    source: Source;
-    status: DispatchStatus;
-    updatedAtMs: number;
-}
-export interface DispatchProjection {
-    errorMessage?: string;
-    id: string;
-    resultMessageTs?: string;
-    status: DispatchStatus;
-}
-export interface DispatchCreateResult {
-    record: DispatchRecord;
-    status: "created" | "already_exists";
-}
-export type DispatchTurnOutcome = "awaiting_resume" | "blocked" | "completed" | "failed";
-/** Facts returned by one attempt to advance a dispatched turn. */
-export interface DispatchTurnResult {
-    errorMessage?: string;
-    outcome?: DispatchTurnOutcome;
-    resultMessageTs?: string;
-}
-/** Dispatch-owned authority supplied to the shared turn runtime. */
-export interface DispatchTurnContext {
-    disabledFeatures: readonly ["interactive-auth"];
-    locationConfiguration: LocationConfigurationService;
-    credentialContext: CredentialContext;
-    destinationVisibility: DestinationVisibility;
-    dispatch: AgentDispatch;
-    skipProviderDefaultConfig: true;
-    source: Source;
-    surface: Extract<AgentTurnSurface, "api">;
-    turnId: string;
-}

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

@@ -1,5 +0,0 @@
-import type { BoundDispatchOptions, SlackDispatchOptions } from "./types";
-/** Validate plugin-provided dispatch options before core persists them. */
-export declare function validateDispatchOptions(options: unknown): asserts options is SlackDispatchOptions;
-/** Verify runtime-owned access requirements for delegated dispatch credentials. */
-export declare function verifyDispatchCredentialSubjectAccess(options: Pick<BoundDispatchOptions, "credentialSubject" | "destination">, plugin: string): Promise<void>;

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

@@ -1,49 +0,0 @@
-/**
- * Plugin dispatch mailbox adapter.
- *
- * Dispatch metadata selects exact authority and maintains the plugin-facing
- * projection. The shared conversation worker and turn runtime own execution,
- * leases, retries, continuation, delivery, and recovery.
- */
-import type { StateAdapter } from "chat";
-import type { ConversationStore } from "@/chat/conversations/store";
-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 { DispatchRecord, DispatchTurnContext, DispatchTurnResult } from "./types";
-export declare const AGENT_DISPATCH_MAX_AGE_MS: number;
-type DispatchRoutingContext = Pick<DispatchTurnContext, "credentialContext" | "dispatch" | "surface"> & {
-    actor: DispatchRecord["actor"];
-};
-/** Restore the exact actor, credential, and dispatch routing for every slice. */
-export declare function buildDispatchRoutingContext(dispatch: DispatchRecord): DispatchRoutingContext;
-interface EnqueueAgentDispatchOptions {
-    conversationStore?: ConversationStore;
-    nowMs?: number;
-    queue: ConversationWorkQueue;
-    state?: StateAdapter;
-}
-/** Dependencies for dispatch work owned by the conversation worker. */
-export interface AgentDispatchConversationWorkerOptions {
-    resumeTurn: (dispatch: DispatchRecord, hooks: {
-        shouldYield?: () => boolean;
-    }) => Promise<void>;
-    runTurn: (dispatch: DispatchRecord, hooks: {
-        ack: () => Promise<void>;
-        shouldYield?: () => boolean;
-    }) => Promise<DispatchTurnResult>;
-}
-/** Build the stable mailbox work item for one agent dispatch. */
-export declare function buildAgentDispatchInboundMessage(dispatch: DispatchRecord, nowMs?: number): InboundMessage;
-/** Persist dispatch mailbox work before sending its conversation wake-up. */
-export declare function enqueueAgentDispatch(dispatch: DispatchRecord, options: EnqueueAgentDispatchOptions): Promise<void>;
-/**
- * Resolve a dispatch from concrete mailbox metadata or the active turn.
- *
- * Provider source and conversation-id conventions are deliberately not
- * execution routing authority.
- */
-export declare function resolveAgentDispatchId(context: ConversationWorkerContext): Promise<string | undefined>;
-/** Run one dispatch start or resume under the owning conversation lease. */
-export declare function createAgentDispatchConversationWorker(options: AgentDispatchConversationWorkerOptions): (context: ConversationWorkerContext, dispatchId: string) => Promise<ConversationWorkerResult>;
-export {};

package/dist/chat/agent-invocations/errors.d.ts

@@ -1,8 +0,0 @@
-/** Named child cannot accept another invocation until its active work ends. */
-export declare class AgentInvocationBusyError extends Error {
-    constructor(name: string);
-}
-/** Parent already has the maximum number of non-terminal child invocations. */
-export declare class AgentInvocationLimitError extends Error {
-    constructor(limit: number);
-}

package/dist/chat/agent-invocations/spawn.d.ts

@@ -1,12 +0,0 @@
-import type { StateAdapter } from "chat";
-import type { ConversationStore } from "@/chat/conversations/store";
-import type { AgentRun, SpawnAgent } from "@/chat/agent/types";
-import type { ConversationWorkQueue } from "@/chat/task-execution/queue";
-type SpawnOptions = {
-    conversationStore?: ConversationStore;
-    queue: ConversationWorkQueue | (() => ConversationWorkQueue);
-    state?: StateAdapter;
-};
-/** Bind a Run's Actor and credentials to new Agent invocations. */
-export declare function bindSpawnAgent(run: AgentRun, options: SpawnOptions): SpawnAgent | undefined;
-export {};

package/dist/chat/agent-invocations/store.d.ts

@@ -1,46 +0,0 @@
-import { type AgentInvocation, type CreateAgentInvocationInput } from "./types";
-/** Cap concurrent non-terminal children one parent can keep in flight. */
-export declare const MAX_ACTIVE_AGENT_INVOCATIONS_PER_PARENT = 8;
-/** Return the stable identity for one retry-safe delegated task. */
-export declare function getAgentInvocationId(parentConversationId: string, idempotencyKey: string): string;
-/** Return the stable child identity for one invocation without a named binding. */
-export declare function getUnnamedAgentConversationId(invocationId: string): string;
-/** Return the stable child identity for one named binding. */
-export declare function getNamedAgentConversationId(parentConversationId: string, name: string): string;
-/** Return the stable turn identity advanced by one agent invocation. */
-export declare function getAgentInvocationTurnId(invocationId: string): string;
-/** Return the stable mailbox identity for one agent invocation. */
-export declare function getAgentInvocationMessageId(invocationId: string): string;
-/** Read one durable agent invocation. */
-export declare function getAgentInvocation(invocationId: string): Promise<AgentInvocation | undefined>;
-/** Resolve the single invocation that may resume for one child conversation. */
-export declare function getActiveAgentInvocationForConversation(childConversationId: string): Promise<AgentInvocation | undefined>;
-/**
- * Create or replay one invocation, reusing named child conversations and
- * keeping unnamed child identities scoped to the invocation.
- */
-export declare function createAgentInvocation(rawInput: CreateAgentInvocationInput, nowMs?: number): Promise<AgentInvocation>;
-/** List bounded invocation records whose mailbox append still needs repair. */
-export declare function listPendingAgentInvocationMailboxAppends(limit?: number): Promise<AgentInvocation[]>;
-/** Record that the invocation's idempotent mailbox append completed. */
-export declare function markAgentInvocationMailboxAppended(invocationId: string, nowMs?: number): Promise<void>;
-/** Mark one non-terminal invocation as actively executing. */
-export declare function markAgentInvocationRunning(invocationId: string, nowMs?: number): Promise<AgentInvocation | undefined>;
-/** Mark one invocation as waiting for another shared execution slice. */
-export declare function markAgentInvocationAwaitingResume(invocationId: string, nowMs?: number): Promise<void>;
-/** Persist one terminal invocation result without overwriting an earlier result. */
-export declare function completeAgentInvocation(args: {
-    invocationId: string;
-    result: string;
-    status: "completed";
-    nowMs?: number;
-} | {
-    errorMessage: string;
-    invocationId: string;
-    status: "blocked" | "failed";
-    nowMs?: number;
-}): Promise<AgentInvocation | undefined>;
-/** Return whether an agent invocation has finished. */
-export declare function isTerminalAgentInvocation(invocation: AgentInvocation): invocation is Extract<AgentInvocation, {
-    status: "blocked" | "completed" | "failed";
-}>;