@sentry/junior 0.202.0 → 0.204.0

package/dist/app-B1TOqBI8.d.ts

@@ -0,0 +1,246 @@
+import { t as ConversationStore } from "./store-C5qxF2ac.js";
+import "./history-ClE4toxe.js";
+import { n as JuniorPluginSet } from "./plugins-BI9A1vKA.js";
+import { Hono } from "hono";
+import "@earendil-works/pi-ai/compat";
+import "@earendil-works/pi-ai/api/anthropic-messages";
+import { z } from "zod";
+import { Destination, Source, User } from "@sentry/junior-plugin-api";
+import "@earendil-works/pi-agent-core";
+import "@earendil-works/pi-ai";
+import { Sandbox } from "@vercel/sandbox";
+import { Client } from "@modelcontextprotocol/sdk/client";
+import "@modelcontextprotocol/sdk/client/auth.js";
+import { Message, StateAdapter } from "chat";
+import "@chat-adapter/slack";
+//#region src/chat/reasoning-level.d.ts
+declare const TURN_REASONING_LEVELS: readonly ["none", "low", "medium", "high", "xhigh"];
+type TurnReasoningLevel = (typeof TURN_REASONING_LEVELS)[number];
+//#endregion
+//#region src/chat/model-profile.d.ts
+/** Runtime configuration for one named model profile. */
+interface ModelProfileConfig {
+  /**
+   * Tells models which tasks fit this profile.
+   * Name concrete tasks. Add use and avoid cases when helpful.
+   * Do not use model product names as the selection rule.
+   */
+  description?: string;
+  modelId: string;
+  reasoningLevel?: TurnReasoningLevel;
+}
+/** App-level profile input: a model id string or a full profile config. */
+type ModelProfileInput = string | ModelProfileConfig;
+//#endregion
+//#region src/chat/config.d.ts
+interface BotModelConfig {
+  /** Model used for embeddings. */
+  embeddingModelId?: string;
+  /** Model used for low-cost structured and utility calls. */
+  fastModelId?: string;
+  /** Model used to review sensitive tool calls. */
+  guardianModelId?: string;
+  /** Model used to generate images. */
+  imageGenerationModelId?: string;
+  /** Model used to analyze images. */
+  visionModelId?: string;
+  /** Model used for web search. */
+  webSearchModelId?: string;
+}
+//#endregion
+//#region src/chat/experimental.d.ts
+/**
+ * Known unstable product features that must be opted into explicitly.
+ * Add new keys here as features graduate from private experiments; remove them
+ * once they become stable defaults.
+ */
+declare const EXPERIMENTAL_FEATURES: readonly ["passive-routing", "subagents"];
+/** One known experimental feature name. */
+type ExperimentalFeature = (typeof EXPERIMENTAL_FEATURES)[number];
+/** App-level opt-ins for unstable product features. */
+type ExperimentalFeaturesConfig = Readonly<Partial<Record<ExperimentalFeature, boolean>>>;
+//#endregion
+//#region src/chat/sandbox/resources.d.ts
+interface SandboxResourceConfig {
+  vcpus?: number;
+}
+//#endregion
+//#region src/chat/task-execution/queue.d.ts
+/** Validate the v2 conversation work hint sent through Vercel Queue. */
+declare const conversationQueueMessageSchema: z.ZodObject<{
+  schemaVersion: z.ZodLiteral<2>;
+  conversationId: z.ZodString;
+}, z.core.$strict>;
+/** Conversation work hint accepted by the queue callback and worker. */
+type ConversationQueueMessage = z.output<typeof conversationQueueMessageSchema>;
+interface ConversationQueueSendOptions {
+  delayMs?: number;
+  idempotencyKey?: string;
+}
+interface ConversationQueueSendResult {
+  messageId?: string;
+}
+/**
+ * External transport for wake-up hints. Durable work stays in the mailbox;
+ * transports only need to accept one hint and may return a provider message id.
+ */
+interface ConversationWorkQueue {
+  send(message: ConversationQueueMessage, options?: ConversationQueueSendOptions): Promise<ConversationQueueSendResult | void>;
+}
+//#endregion
+//#region src/chat/task-execution/state.d.ts
+/** Canonical durable mailbox entry owned by task execution. */
+declare const inboundMessageSchema: z.ZodObject<{
+  attemptCount: z.ZodOptional<z.ZodNumber>;
+  conversationId: z.ZodString;
+  createdAtMs: z.ZodNumber;
+  delivery: z.ZodEnum<{
+    defer: "defer";
+    interrupt: "interrupt";
+  }>;
+  destination: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    platform: z.ZodLiteral<"slack">;
+    teamId: z.ZodString;
+    channelId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    platform: z.ZodLiteral<"local">;
+    conversationId: z.ZodString;
+  }, z.core.$strict>], "platform">>;
+  inboundMessageId: z.ZodString;
+  injectedAtMs: z.ZodOptional<z.ZodNumber>;
+  input: z.ZodObject<{
+    attachments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    authorId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    text: z.ZodString;
+  }, z.core.$strict>;
+  receivedAtMs: z.ZodNumber;
+  source: z.ZodEnum<{
+    api: "api";
+    internal: "internal";
+    local: "local";
+    plugin: "plugin";
+    resource_event: "resource_event";
+    scheduler: "scheduler";
+    slack: "slack";
+    web: "web";
+  }>;
+}, z.core.$strict>;
+type InboundMessage = z.output<typeof inboundMessageSchema>;
+//#endregion
+//#region src/chat/task-execution/worker.d.ts
+interface ConversationWorkerContext {
+  attempt: InboxAttempt;
+  checkIn(): Promise<boolean>;
+  conversationId: string;
+  destination?: Destination;
+  /** True when the current execution slice must stop at its next safe boundary. */
+  shouldYield(): boolean;
+  /** Return an AbortSignal backed by the durable Conversation stop request. */
+  stopSignal?(): AbortSignal;
+}
+interface InboxAttempt {
+  ack(): Promise<void>;
+  conversationId: string;
+  destination?: Destination;
+  drain(handle: (messages: InboundMessage[]) => Promise<readonly string[] | void>): Promise<InboundMessage[]>;
+  isFinalAttempt: boolean;
+  messages: InboundMessage[];
+}
+interface ConversationWorkerResult {
+  /** `paused` waits for an external wake but must resume if a stop raced it. */
+  status: "completed" | "deferred" | "lost_lease" | "paused" | "yielded";
+}
+//#endregion
+//#region src/chat/task-execution/vercel-callback.d.ts
+interface ProcessConversationQueueMessageOptions {
+  checkInIntervalMs?: number;
+  conversationStore?: ConversationStore;
+  nowMs?: () => number;
+  queue?: ConversationWorkQueue;
+  run(context: ConversationWorkerContext): Promise<ConversationWorkerResult>;
+  softYieldAfterMs?: number;
+  state?: StateAdapter;
+}
+interface VercelConversationWorkCallbackOptions extends ProcessConversationQueueMessageOptions {
+  topic?: string;
+  visibilityTimeoutSeconds?: number;
+}
+//#endregion
+//#region src/chat/app/conversation-work.d.ts
+type ConversationWorkCallbackOptions = VercelConversationWorkCallbackOptions;
+//#endregion
+//#region src/handlers/types.d.ts
+/** Callback to schedule background work that must finish before the function exits. */
+type WaitUntilFn = (task: Promise<unknown> | (() => Promise<unknown>)) => void;
+//#endregion
+//#region src/app.d.ts
+interface JuniorAppOptions extends BotModelConfig {
+  /** Authenticated dashboard mounted by core when configured. */
+  dashboard?: JuniorDashboardOptions;
+  /**
+   * Opt into unstable product features. Experimental keys may change or be
+   * removed without a stable migration path; leave unset in production unless
+   * you are deliberately dogfooding a pre-stable surface.
+   */
+  experimental?: ExperimentalFeaturesConfig;
+  /** Profile used for new conversations. Configure with `profiles`. */
+  defaultProfile?: string;
+  /**
+   * Named profiles available to the router and `handoff` tool. Configure with
+   * `defaultProfile`. Each value may be a model id string or an object with
+   * `modelId` and optional `description` and `reasoningLevel` settings.
+   */
+  profiles?: Readonly<Record<string, ModelProfileInput>>;
+  /** Slack-specific overrides applied after env parsing. */
+  slack?: {
+    /** Slack emoji shown while Junior is processing. Defaults to `eyes`. */
+    processingReactionEmoji?: string;
+    /** Slack emoji shown after a turn completes. Defaults to `white_check_mark`. */
+    completedReactionEmoji?: string;
+  };
+  /** Install-wide provider defaults. Unregistered `provider.key` entries warn at startup. */
+  configDefaults?: Record<string, unknown>;
+  /** Queue consumer wiring for the durable conversation worker. */
+  conversationWork?: ConversationWorkCallbackOptions;
+  /** Direct plugin set override. Usually omitted when `juniorNitro()` uses a plugin module. */
+  plugins?: JuniorPluginSet;
+  /** Sandbox execution options. */
+  sandbox?: SandboxResourceConfig & {
+    /**
+     * Egress domains allowed to carry Sentry trace propagation headers.
+     * Entries may be exact domains or leading wildcard domains such as
+     * `*.sentry.io`; wildcard entries match subdomains, not the apex domain.
+     */
+    egressTracePropagationDomains?: string[];
+  };
+  waitUntil?: WaitUntilFn;
+}
+interface JuniorDashboardOptions {
+  /** Browser auth route prefix used by Better Auth. */
+  authPath?: string;
+  /** Require a dashboard browser session before serving dashboard pages and APIs. */
+  authRequired?: boolean;
+  /** Exact Google account emails allowed to open the dashboard. */
+  allowedEmails?: string[];
+  /** Google Workspace domains allowed to open the dashboard. */
+  allowedGoogleDomains?: string[];
+  /** Browser route prefix for the dashboard shell. */
+  basePath?: string;
+  /** Public deployment origin used for auth callbacks and external links. */
+  baseURL?: string;
+  /** Expose the config-gated component gallery for local visual QA. */
+  componentGallery?: boolean;
+  /** Disable dashboard route mounting while preserving serializable config shape. */
+  disabled?: boolean;
+  /** Replace Conversation route responses with dashboard visual-QA fixtures. */
+  mockConversations?: boolean;
+  /** Browser session lifetime in seconds. */
+  sessionMaxAgeSeconds?: number;
+  /** Additional trusted origins accepted by Better Auth. */
+  trustedOrigins?: string[];
+}
+/** Create a Hono app with all Junior routes. */
+declare function createApp(options?: JuniorAppOptions): Promise<Hono>;
+//#endregion
+export { ModelProfileInput as i, JuniorDashboardOptions as n, createApp as r, JuniorAppOptions as t };