@sentry/junior 0.198.0 → 0.200.0

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

@@ -1,42 +0,0 @@
-import type { AttachmentStorage } from "@/chat/attachments/storage";
-import type { JuniorSqlDatabase } from "@/db/db";
-/** Parse a public artifact URL or filename into a content-addressed filename. */
-export declare function artifactFilenameFromRef(ref: string): string | null;
-/** Publish validated image bytes as a conversation-owned public artifact. */
-export declare function publishImage(args: {
-    body: Buffer;
-    conversationId: string;
-    db: JuniorSqlDatabase;
-    now?: Date;
-    publicBaseUrl: string;
-    storage: Pick<AttachmentStorage, "put">;
-}): Promise<{
-    bytes: number;
-    contentType: string;
-    url: string;
-}>;
-/**
- * Mark one public artifact unavailable for unauthenticated reads.
- * Only the owning conversation may unpublish it.
- */
-export declare function unpublishArtifact(args: {
-    conversationId: string;
-    db: JuniorSqlDatabase;
-    now?: Date;
-    ref: string;
-}): Promise<{
-    filename: string;
-}>;
-/** Open one public artifact by id when the row allows it. */
-export declare function readPublicArtifact(args: {
-    db: JuniorSqlDatabase;
-    filename: string;
-    storage: Pick<AttachmentStorage, "get">;
-}): Promise<{
-    body: ReadableStream<Uint8Array>;
-    contentType: string;
-} | null>;
-/** Build public response headers for one live public artifact. */
-export declare function publicArtifactHeaders(contentType: string): Headers;
-/** Build short-lived headers for missing or unpublished artifact responses. */
-export declare function unpublishedArtifactHeaders(): Headers;

package/dist/chat/attachments/storage.d.ts

@@ -1,14 +0,0 @@
-/** Bytes and metadata written to attachment object storage. */
-export interface AttachmentWrite {
-    body: Buffer;
-    contentType: string;
-    key: string;
-}
-/** Small object-storage capability used by conversation attachments. */
-export interface AttachmentStorage {
-    readonly provider: string;
-    put(input: AttachmentWrite): Promise<void>;
-    /** Return live object bytes, or null when the key is missing. */
-    get(key: string): Promise<ReadableStream<Uint8Array> | null>;
-    delete(keys: string[]): Promise<void>;
-}

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

@@ -1,68 +0,0 @@
-import type { JuniorSqlDatabase } from "@/db/db";
-import type { SandboxFileUpload } from "@/chat/tools/sandbox/file-uploads";
-import type { AttachmentStorage } from "./storage";
-export interface StoredAttachment {
-    id: string;
-}
-/** Live conversation-owned attachment metadata. */
-export interface AttachmentRecord {
-    bytes: number;
-    contentType: string;
-    conversationId: string;
-    filename: string;
-    id: string;
-    provider: string;
-    storageKey: string;
-}
-export interface AttachmentGarbageCollectionResult {
-    deleted: number;
-}
-/**
- * Persist one conversation-owned file.
- *
- * Identity is content-stable under the conversation. Object storage is written
- * first under a unique key; the SQL row is created only after that write
- * succeeds. A row means the attachment is durable. Retries reuse an existing
- * live row. A purge-marked row is revived by writing a new object and pointing
- * the row at it, unless the conversation is still purged. If the SQL write
- * fails after object storage accepts the bytes, this path deletes that unique
- * object. A process crash between those steps can leave an unreferenced unique
- * object with no SQL row.
- */
-export declare function storeAttachment(args: {
-    conversationId: string;
-    db: JuniorSqlDatabase;
-    file: SandboxFileUpload;
-    nowMs?: number;
-    storage: AttachmentStorage;
-}): Promise<StoredAttachment>;
-/** Load one live attachment owned by a conversation. */
-export declare function readLiveAttachment(args: {
-    attachmentId: string;
-    conversationId: string;
-    db: JuniorSqlDatabase;
-}): Promise<AttachmentRecord | null>;
-/** Persist many conversation-owned files. */
-export declare function storeAttachments(args: {
-    conversationId: string;
-    db: JuniorSqlDatabase;
-    files: SandboxFileUpload[];
-    nowMs?: number;
-    storage: AttachmentStorage;
-}): Promise<StoredAttachment[]>;
-/** Mark attachments unavailable when their conversation content is purged. */
-export declare function requestAttachmentDeletion(db: JuniorSqlDatabase, conversationIds: string[], nowMs: number): Promise<void>;
-/**
- * Delete purged attachments in one bounded batch.
- *
- * Eligible rows are explicitly purge-marked, or owned by a conversation whose
- * transcript is already purged. That second path covers a concurrent store that
- * inserted after purge marked existing rows. Delete object keys first, then
- * remove rows that are still eligible so a failed blob delete remains retryable.
- */
-export declare function collectAttachmentGarbage(args: {
-    db: JuniorSqlDatabase;
-    nowMs: number;
-    storage: AttachmentStorage;
-    limit?: number;
-}): Promise<AttachmentGarbageCollectionResult>;

package/dist/chat/attachments/vercel.d.ts

@@ -1,3 +0,0 @@
-import type { AttachmentStorage } from "./storage";
-/** Store private conversation attachments in Vercel Blob. */
-export declare function createVercelAttachmentStorage(): AttachmentStorage;

package/dist/chat/capabilities/factory.d.ts

@@ -1,11 +0,0 @@
-import type { CredentialLease } from "@/chat/credentials/broker";
-import type { CredentialContext } from "@/chat/credentials/context";
-import type { UserTokenStore } from "@/chat/credentials/user-token-store";
-/** Create the user token store used by OAuth-backed credential brokers. */
-export declare function createUserTokenStore(): UserTokenStore;
-/** Issue one provider credential lease for host-side sandbox egress proxying. */
-export declare function issueProviderCredentialLease(input: {
-    context: CredentialContext;
-    provider: string;
-    reason: string;
-}): Promise<CredentialLease>;

package/dist/chat/capabilities/jr-rpc-command.d.ts

@@ -1,26 +0,0 @@
-import type { LocationConfigurationService } from "@/chat/configuration/types";
-import type { Skill } from "@/chat/skills";
-type JrRpcDeps = {
-    activeSkill: Skill | null;
-    locationConfiguration?: LocationConfigurationService;
-    actorId?: string;
-    onConfigurationValueChanged?: (key: string, value: unknown | undefined) => void;
-};
-export declare function maybeExecuteJrRpcCustomCommand(command: string, deps: JrRpcDeps): Promise<{
-    handled: false;
-} | {
-    handled: true;
-    result: {
-        ok: boolean;
-        command: string;
-        cwd: string;
-        exit_code: number;
-        signal: null;
-        timed_out: boolean;
-        stdout: string;
-        stderr: string;
-        stdout_truncated: boolean;
-        stderr_truncated: boolean;
-    };
-}>;
-export {};

package/dist/chat/capabilities/router.d.ts

@@ -1,20 +0,0 @@
-import type { CredentialBroker, CredentialLease } from "@/chat/credentials/broker";
-import type { CredentialContext } from "@/chat/credentials/context";
-export interface CredentialRouter {
-    issue(input: {
-        context: CredentialContext;
-        provider: string;
-        reason: string;
-    }): Promise<CredentialLease>;
-}
-export declare class ProviderCredentialRouter implements CredentialRouter {
-    private readonly brokersByProvider;
-    constructor(input: {
-        brokersByProvider: Record<string, CredentialBroker>;
-    });
-    issue(input: {
-        context: CredentialContext;
-        provider: string;
-        reason: string;
-    }): Promise<CredentialLease>;
-}

package/dist/chat/code/publisher.d.ts

@@ -1,3 +0,0 @@
-import type { CodeChangePublisher } from "@sentry/junior-plugin-api";
-/** Connect a plugin to Junior's code records. */
-export declare function createCodeChangePublisher(provider: string): CodeChangePublisher;

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

@@ -1,9 +0,0 @@
-import { type CodeChangeInput } from "@sentry/junior-plugin-api";
-import type { JuniorDatabase } from "@/db/db";
-/** Record the latest details for one code change created by Junior. */
-export declare function recordCodeChange(db: JuniorDatabase, provider: string, input: CodeChangeInput): Promise<void>;
-/** Add conversation links to an existing code change. */
-export declare function associateCodeChangeConversations(db: JuniorDatabase, provider: string, input: {
-    conversationIds: string[];
-    providerId: string;
-}): Promise<void>;

package/dist/chat/coerce.d.ts

@@ -1,6 +0,0 @@
-/** Narrow an unknown value to a non-empty string, or undefined. */
-export declare function toOptionalString(value: unknown): string | undefined;
-/** Narrow an unknown value to a finite number, or undefined. */
-export declare function toOptionalNumber(value: unknown): number | undefined;
-/** Type-guard: true when value is a non-null object (usable as Record). */
-export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/chat/config.d.ts

@@ -1,100 +0,0 @@
-import { type TurnReasoningLevel } from "@/chat/reasoning-level";
-import { type ModelProfileConfig, type ModelProfile, type ModelProfileInput } from "@/chat/model-profile";
-export declare const DEFAULT_SQL_STATEMENT_TIMEOUT_MS = 30000;
-/**
- * Buffer between the Vercel function timeout and the agent turn timeout so
- * Junior can abort, persist, and schedule continuation before host teardown.
- */
-export declare const FUNCTION_TIMEOUT_BUFFER_SECONDS = 20;
-/** Additional buffer that makes conversation work yield before the hard request deadline. */
-export declare const CONVERSATION_WORK_SOFT_YIELD_BUFFER_SECONDS = 40;
-export 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;
-}
-export interface BotConfig {
-    contextWindowTokens: number;
-    crossActorMidRunMode: CrossActorMidRunMode;
-    defaultProfile: ModelProfile;
-    embeddingModelId: string;
-    fastModelId: string;
-    guardianModelId: string;
-    imageGenerationModelId: string;
-    loadingMessages: string[];
-    profiles: Readonly<Record<string, ModelProfileConfig>>;
-    reasoningLevel?: TurnReasoningLevel;
-    visionModelId?: string;
-    maxSlicesPerTurn: number;
-    maxToolCallsPerTurn: number;
-    maxConsecutiveAutomatedTurns: number;
-    turnTimeoutMs: number;
-    userName: string;
-    webSearchModelId: string;
-}
-export type CrossActorMidRunMode = "follow_up" | "steer";
-export type SqlDriver = "neon" | "postgres";
-export interface ChatConfig {
-    bot: BotConfig;
-    functionMaxDurationSeconds: number;
-    conversationWorkEnabled: boolean;
-    conversationWorkSoftYieldAfterMs: number;
-    sql: {
-        databaseUrl: string;
-        driver: SqlDriver;
-        statementTimeoutMs: number | false;
-    };
-    slack: {
-        botToken?: string;
-        clientId?: string;
-        clientSecret?: string;
-        completedReactionEmoji: string;
-        processingReactionEmoji: string;
-        signingSecret?: string;
-        slashCommand: string;
-    };
-    state: {
-        adapter: "memory" | "redis";
-        keyPrefix?: string;
-        redisUrl?: string;
-    };
-}
-/** Parse all chat configuration from environment variables. */
-export declare function readChatConfig(env?: NodeJS.ProcessEnv, functionMaxDurationSeconds?: number): ChatConfig;
-/** Apply the host execution budget injected by juniorNitro(). */
-export declare function configureFunctionMaxDurationSeconds(functionMaxDurationSeconds: number): void;
-/** Return the chat configuration (parsed once at startup). */
-export declare function getChatConfig(): ChatConfig;
-/** Bot configuration derived from environment at module load. */
-export declare const botConfig: BotConfig;
-export declare function getSlackBotToken(): string | undefined;
-export declare function getSlackSigningSecret(): string | undefined;
-export declare function getSlackClientId(): string | undefined;
-export declare function getSlackClientSecret(): string | undefined;
-export declare function hasRedisConfig(): boolean;
-export interface RuntimeMetadata {
-    version?: string;
-}
-/** Return runtime metadata (version from deploy environment). */
-export declare function getRuntimeMetadata(): RuntimeMetadata;
-export interface SlackReactionConfig {
-    completedReactionEmoji: string;
-    processingReactionEmoji: string;
-}
-/** Apply model overrides from createApp(). */
-export declare function setBotModelConfig(config: BotModelConfig): void;
-/** Apply profiles from createApp(). */
-export declare function setProfiles(profiles: Readonly<Record<string, ModelProfileInput>> | undefined, defaultProfile: string | undefined): void;
-/** Return the current Slack reaction emoji config. */
-export declare function getSlackReactionConfig(): SlackReactionConfig;
-/** Apply Slack reaction emoji overrides from createApp() options, validating names. */
-export declare function setSlackReactionConfig(overrides: Partial<SlackReactionConfig>): void;

package/dist/chat/configuration/defaults.d.ts

@@ -1,4 +0,0 @@
-/** Store install-wide configuration defaults. */
-export declare function setConfigDefaults(defaults: unknown): void;
-/** Return the install-wide configuration defaults (empty object when none set). */
-export declare function getConfigDefaults(): Record<string, unknown>;

package/dist/chat/configuration/service.d.ts

@@ -1,5 +0,0 @@
-import type { ConfigEntry, LocationConfigurationService, LocationConfigurationStorage } from "@/chat/configuration/types";
-/** Coerce legacy persisted configuration into current Location entries. */
-export declare function coerceLegacyLocationConfig(raw: unknown): ConfigEntry[];
-/** Create a Location configuration service over entry-level storage. */
-export declare function createLocationConfigurationService(storage: LocationConfigurationStorage): LocationConfigurationService;

package/dist/chat/configuration/sql.d.ts

@@ -1,9 +0,0 @@
-import type { SlackDestination } from "@sentry/junior-plugin-api";
-import type { JuniorDatabase } from "@/db/db";
-import type { LocationConfigurationService } from "@/chat/configuration/types";
-/** Resolve SQL-owned Location configuration and copy live legacy entries once. */
-export declare function createDurableLocationConfigurationService(args: {
-    destination: SlackDestination;
-    db: JuniorDatabase;
-    loadLegacy: () => Promise<unknown>;
-}): LocationConfigurationService;

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

@@ -1,41 +0,0 @@
-import { z } from "zod";
-/** JSON value accepted by Location configuration. */
-export declare const configValueSchema: z.ZodJSONSchema;
-export type ConfigValue = z.output<typeof configValueSchema>;
-/** One user-authored configuration value scoped to a Location. */
-export interface ConfigEntry {
-    key: string;
-    value: ConfigValue;
-    scope: "location";
-    updatedAt: string;
-    updatedBy?: string;
-    source?: string;
-    expiresAt?: string;
-}
-/** Entry-level persistence used by Location configuration. */
-export interface LocationConfigurationStorage {
-    get: (key: string) => Promise<ConfigEntry | undefined>;
-    list: () => Promise<ConfigEntry[]>;
-    set: (entry: ConfigEntry) => Promise<void>;
-    unset: (key: string) => Promise<boolean>;
-}
-/** Read and update user-authored configuration for one Location. */
-export interface LocationConfigurationService {
-    get: (key: string) => Promise<ConfigEntry | undefined>;
-    set: (input: {
-        key: string;
-        value: unknown;
-        updatedBy?: string;
-        source?: string;
-        expiresAt?: string;
-    }) => Promise<ConfigEntry>;
-    unset: (key: string) => Promise<boolean>;
-    list: (options?: {
-        prefix?: string;
-    }) => Promise<ConfigEntry[]>;
-    resolve: (key: string) => Promise<ConfigValue | undefined>;
-    resolveValues: (options?: {
-        keys?: string[];
-        prefix?: string;
-    }) => Promise<Record<string, ConfigValue>>;
-}

package/dist/chat/configuration/validation.d.ts

@@ -1,2 +0,0 @@
-export declare function validateConfigKey(key: string): string | undefined;
-export declare function validateConfigValue(value: unknown): string | undefined;

package/dist/chat/conversation-privacy.d.ts

@@ -1,39 +0,0 @@
-import type { AssistantMessage, Message } from "@earendil-works/pi-ai";
-export type ConversationPrivacy = "public" | "private";
-type TraceAttributeValue = string | number | boolean | string[];
-/**
- * Resolve whether a Conversation may expose full transcript and tool data.
- *
- * Read visibility from the stored Conversation. If it is missing, warn and
- * treat the Conversation as private. Do not infer visibility from identifiers.
- */
-export declare function resolveConversationPrivacy(input: {
-    /** Stored Conversation visibility, when known. */
-    visibility?: ConversationPrivacy | "direct" | "unknown";
-}): ConversationPrivacy;
-/** Return whether a public Conversation may expose transcript and tool data. */
-export declare function canExposeConversationPayload(input: {
-    /** Conversation visibility, when known. */
-    visibility?: ConversationPrivacy | "direct" | "unknown";
-}): boolean;
-/** Return privacy for the current agent Turn. */
-export declare function getCurrentConversationPrivacy(): ConversationPrivacy | undefined;
-/** Bind one conversation privacy mode to all async work in a turn. */
-export declare function runWithConversationPrivacy<T>(privacy: ConversationPrivacy, callback: () => T): T;
-/** Convert an arbitrary payload into safe structured metadata for trace data fields. */
-export declare function toGenAiPayloadMetadata(payload: unknown): Record<string, unknown>;
-/** Convert an arbitrary payload into safe flattened trace attributes. */
-export declare function toGenAiPayloadTraceAttributes(prefix: "gen_ai.tool.call.arguments" | "gen_ai.tool.call.result", payload: unknown): Record<string, TraceAttributeValue>;
-/**
- * Map a pi-ai AssistantMessage to the canonical gen_ai.output.messages shape:
- * `{ role, parts: [...], finish_reason }` — drops provider noise fields.
- */
-export declare function toCanonicalOutputMessage(message: AssistantMessage): Record<string, unknown>;
-/**
- * Map a pi-ai Message (user/assistant/toolResult) to the canonical
- * gen_ai.input.messages shape: `{ role, parts: [...] }`.
- */
-export declare function toCanonicalInputMessage(message: Message): Record<string, unknown>;
-/** Summarize a message list without exposing raw message content. */
-export declare function toGenAiMessagesTraceAttributes(prefix: "gen_ai.input" | "gen_ai.output", messages: unknown[]): Record<string, TraceAttributeValue>;
-export {};

package/dist/chat/conversations/destination-visibility.d.ts

@@ -1,7 +0,0 @@
-import type { Destination } from "@sentry/junior-plugin-api";
-import type { ConversationPrivacy } from "@/chat/conversation-privacy";
-/** Read confirmed visibility from the current signal or persisted destination. */
-export declare function resolveDestinationVisibility(args: {
-    destination: Destination;
-    visibility?: ConversationPrivacy;
-}): Promise<ConversationPrivacy | undefined>;

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

@@ -1,12 +0,0 @@
-import { type Destination } from "@sentry/junior-plugin-api";
-/**
- * Keep a stored Destination, or create the temporary local Destination.
- *
- * TODO(dcramer): Delete this module after Conversation and AgentRun use
- * Location, and web and resource-event Turns no longer need a local
- * Destination.
- */
-export declare function resolveConversationDestination(args: {
-    conversationId: string;
-    existing?: Destination;
-}): Destination;