@sentry/junior 0.155.0 → 0.157.0

package/dist/app.js

@@ -1,15 +1,15 @@
 import {
   processConversationWork
-} from "./chunk-J7MWZFFP.js";
+} from "./chunk-VIBHFGQC.js";
 import {
   bindSpawnAgent
-} from "./chunk-RQ62VKM7.js";
+} from "./chunk-MXO6VFB3.js";
 import {
   createAgentInvocationWorker,
   enqueueAgentInvocation,
   listPendingAgentInvocationMailboxAppends,
   routeAgentInvocationWork
-} from "./chunk-Y7ZUBP2K.js";
+} from "./chunk-7J65DOBL.js";
 import {
   GET as GET2,
   GET2 as GET3,
@@ -36,22 +36,23 @@ import {
   startSlackProcessingReaction,
   stripLeadingBotMention,
   wakePausedTurn
-} from "./chunk-NKFRRZIT.js";
+} from "./chunk-TA5R6BME.js";
 import "./chunk-FA6POGLH.js";
 import {
   getTurnRequestDeadline,
   runWithTurnRequestDeadline
-} from "./chunk-NWSKFYOH.js";
+} from "./chunk-S4PFOWRA.js";
 import {
   GET,
   conversationVisibilityFromSlackChannelType,
   createApiTurnWorker,
+  createVercelAttachmentStorage,
   lookupSlackUser,
   resolveSlackChannelTypeFromMessage,
   resolveSlackConversationContext,
   routeApiTurnWork
-} from "./chunk-Y6MVGU7L.js";
-import "./chunk-KTVHAHUV.js";
+} from "./chunk-VBKFO65J.js";
+import "./chunk-4M25PSFB.js";
 import {
   CONVERSATION_WORK_STALE_ENQUEUE_MS,
   appendAndEnqueueInboundMessage,
@@ -62,7 +63,7 @@ import {
   isInvalidConversationRecordError,
   listActiveConversationIds,
   removeActiveConversation
-} from "./chunk-ELOTIL5F.js";
+} from "./chunk-BLCVTEE7.js";
 import {
   buildDeliveredTurnStatePatch,
   claimDispatchMailboxAppend,
@@ -93,7 +94,7 @@ import {
   requireTurnFailureEventId,
   resolveTurnSessionRouting,
   scheduleSessionCompletedPluginTasks
-} from "./chunk-UWTXAYBP.js";
+} from "./chunk-PP4UQTH3.js";
 import {
   ConversationTurnLifecycleService,
   coerceThreadConversationState,
@@ -103,7 +104,7 @@ import {
   persistThreadRuntimeState,
   persistThreadState,
   persistThreadStateById
-} from "./chunk-4K5N6HTX.js";
+} from "./chunk-5TIH5GOE.js";
 import "./chunk-UTL3MHPC.js";
 import {
   getVercelConversationWorkQueue,
@@ -122,7 +123,7 @@ import {
 import {
   validatePluginEgressCredentialHooks,
   validatePluginRegistrations
-} from "./chunk-MLBH7J7J.js";
+} from "./chunk-XRERMHPN.js";
 import {
   defineJuniorPlugins,
   pluginCatalogConfigFromEnv,
@@ -154,11 +155,11 @@ import {
   setConfigDefaults,
   shouldEmitDevAgentTrace,
   shouldPropagateSandboxEgressTrace
-} from "./chunk-AENPRXCG.js";
+} from "./chunk-OWASYHHV.js";
 import {
   AuthorizationFlowDisabledError,
   PluginCredentialFailureError
-} from "./chunk-CPQBTTI6.js";
+} from "./chunk-WNNYOPXX.js";
 import "./chunk-DIB4GX3G.js";
 import {
   createAgentRunner,
@@ -166,7 +167,7 @@ import {
   deleteMcpAuthSessionsForUserProvider,
   deleteMcpServerSessionId,
   deleteMcpStoredOAuthCredentials
-} from "./chunk-2AHVM3HK.js";
+} from "./chunk-AFQ47JQ7.js";
 import {
   RetryableDeliveryError
 } from "./chunk-RF6J3DIO.js";
@@ -174,7 +175,7 @@ import {
   formatProviderLabel,
   postSlackMessage,
   startOAuthFlow
-} from "./chunk-KBT2I5ER.js";
+} from "./chunk-VDAEXEBB.js";
 import "./chunk-7MA4HV4W.js";
 import {
   getExperimentalFeatures,
@@ -183,16 +184,18 @@ import {
 import {
   getSandboxResourceConfig,
   setSandboxResourceConfig
-} from "./chunk-37G5HJ2X.js";
+} from "./chunk-GO2W3VZY.js";
 import {
+  collectAttachmentGarbage,
   createSchedulerSqlStore,
   findMatchingEventTasks,
   logScheduledTaskRunSkipped,
+  requestAttachmentDeletion,
   scheduledTaskRunAttributes
-} from "./chunk-LQT3SWFA.js";
+} from "./chunk-HJ3EZHIX.js";
 import {
   parseSlackThreadId
-} from "./chunk-APHDJYN7.js";
+} from "./chunk-VYDM7HUF.js";
 import {
   ConversationTurnBoundaryError,
   CooperativeTurnYieldError,
@@ -242,7 +245,7 @@ import {
   trimTrailingAssistantMessages,
   turnHasReply,
   upsertConversationMessage
-} from "./chunk-J2SYI36O.js";
+} from "./chunk-GEY6IFXH.js";
 import "./chunk-3Y47VMHV.js";
 import "./chunk-PDO5BLNM.js";
 import "./chunk-UIE3R5XU.js";
@@ -262,7 +265,7 @@ import {
   verifyEventTaskCredentialSubject,
   verifyScheduledTaskCredentialSubject,
   verifySlackDirectCredentialSubject
-} from "./chunk-V57LZDHN.js";
+} from "./chunk-MGJW3SW4.js";
 import {
   SlackActionError,
   downloadPrivateSlackFile,
@@ -272,7 +275,7 @@ import {
   normalizeSlackConversationId,
   runWithSlackInstallationToken,
   runWithWorkspaceTeamId
-} from "./chunk-TKJ7277U.js";
+} from "./chunk-MDZQ62PB.js";
 import {
   contextProvenance,
   createSlackDestination,
@@ -285,19 +288,19 @@ import {
   requireSlackDestination,
   withConversationEventLock,
   withConversationMutationLock
-} from "./chunk-JJX77MB7.js";
+} from "./chunk-G2FN3I66.js";
 import {
   juniorAgentBindings,
   juniorAgentInvocations,
   juniorConversationEvents,
   juniorConversations
-} from "./chunk-773XC7P4.js";
+} from "./chunk-3GS7O66Z.js";
 import "./chunk-EM225ITJ.js";
 import {
   acquireActiveLock,
   getStateAdapter,
   withActiveLock
-} from "./chunk-SDRJ2LE3.js";
+} from "./chunk-I3OQVVMV.js";
 import {
   STANDARD_MODEL_PROFILE,
   botConfig,
@@ -315,16 +318,16 @@ import {
   modelIdForProfile,
   setSlackReactionConfig,
   standardModelId
-} from "./chunk-XFZLQANQ.js";
+} from "./chunk-UJYA75N5.js";
 import {
   juniorDestinations
 } from "./chunk-VFUK3X5B.js";
-import "./chunk-2WLJDM23.js";
-import "./chunk-JIC33O5L.js";
+import "./chunk-D7BNWRYL.js";
+import "./chunk-RQBRGPUF.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-TVXAN43I.js";
-import "./chunk-RN3AWYEP.js";
+} from "./chunk-6MI43QZO.js";
+import "./chunk-77QB5FNI.js";
 import {
   credentialContextForActor
 } from "./chunk-BDUENQD3.js";
@@ -356,7 +359,7 @@ import {
   withContext,
   withLogContext,
   withSpan
-} from "./chunk-7NYEB2TM.js";
+} from "./chunk-MKA3T2R6.js";
 import {
   continueTrace
 } from "./chunk-6GWA276C.js";
@@ -364,10 +367,10 @@ import "./chunk-OOUNJNMR.js";
 import "./chunk-H4HBKISO.js";
 import {
   JUNIOR_PLUGIN_TASK_CALLBACK_ROUTE
-} from "./chunk-EORR34UB.js";
+} from "./chunk-F7VOY4VQ.js";
 import {
   JUNIOR_VERSION
-} from "./chunk-JFZBGFNX.js";
+} from "./chunk-46ADYIPE.js";
 import "./chunk-MLKGABMK.js";
 
 // src/app.ts
@@ -1938,6 +1941,7 @@ async function purgeConversationTree(executor, args) {
               inArray(juniorAgentBindings.childConversationId, ids)
             )
           );
+          await requestAttachmentDeletion(executor, ids, args.nowMs);
           await executor.db().update(juniorConversations).set({
             transcriptPurgedAt: new Date(args.nowMs),
             ...(args.retention ? !isPublic : resolvedScrubMetadata) ? { title: null, channelName: null, actor: null } : {}
@@ -1989,14 +1993,26 @@ async function runRetentionPurge(executor, args) {
       }
     });
   }
+  const attachmentResult = args.attachmentStorage ? await collectAttachmentGarbage({
+    db: executor,
+    nowMs: args.nowMs,
+    storage: args.attachmentStorage
+  }) : { deleted: 0 };
   logInfo("retention.purge.completed", {
+    "app.retention.attachments": attachmentResult.deleted,
     "app.retention.scanned": roots.length,
     "app.retention.purged": purged,
     "app.retention.failed": failed,
     "app.retention.conversations": conversations,
     "app.retention.duration_ms": Date.now() - startedAtMs
   });
-  return { scanned: roots.length, purged, failed, conversations };
+  return {
+    scanned: roots.length,
+    purged,
+    failed,
+    conversations,
+    attachments: attachmentResult.deleted
+  };
 }
 
 // src/handlers/retention.ts
@@ -2016,12 +2032,13 @@ function verifyRetentionRequest(request) {
   const expected = Buffer.from(secret);
   return actual.length === expected.length && timingSafeEqual3(actual, expected);
 }
-async function GET5(request) {
+async function GET5(request, options = {}) {
   if (!verifyRetentionRequest(request)) {
     return new Response("Unauthorized", { status: 401 });
   }
   try {
     const result = await runRetentionPurge(getSqlExecutor(), {
+      attachmentStorage: options.attachmentStorage ?? createVercelAttachmentStorage(),
       nowMs: Date.now()
     });
     return Response.json(result, { status: 200 });
@@ -3209,6 +3226,71 @@ function buildSlackInboundMessage(args) {
   };
 }
 
+// src/chat/ingress/bot-mention.ts
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function stripInlineCode(line) {
+  return line.replace(/(`+)(?:(?!\1)[^\n])*\1/g, " ");
+}
+function fenceMarkerLength(trimmed) {
+  let n = 0;
+  while (trimmed[n] === "`") {
+    n += 1;
+  }
+  return n;
+}
+function singleLineFenceSuffix(trimmed) {
+  const openLen = fenceMarkerLength(trimmed);
+  if (openLen < 3) {
+    return void 0;
+  }
+  const afterOpen = trimmed.slice(openLen);
+  const closeRel = afterOpen.indexOf("`".repeat(openLen));
+  if (closeRel === -1) {
+    return void 0;
+  }
+  return afterOpen.slice(closeRel + openLen);
+}
+function textOutsideCode(text) {
+  const lines = text.split("\n");
+  const out = [];
+  let inFence = false;
+  for (const line of lines) {
+    const trimmed = line.trimStart();
+    if (trimmed.startsWith("```")) {
+      if (inFence) {
+        inFence = false;
+        const suffix2 = trimmed.slice(fenceMarkerLength(trimmed));
+        if (suffix2.length > 0) {
+          out.push(stripInlineCode(suffix2));
+        }
+        continue;
+      }
+      const suffix = singleLineFenceSuffix(trimmed);
+      if (suffix !== void 0) {
+        out.push(stripInlineCode(suffix));
+        continue;
+      }
+      inFence = true;
+      continue;
+    }
+    if (inFence) {
+      continue;
+    }
+    out.push(stripInlineCode(line));
+  }
+  return out.join("\n");
+}
+function textMentionsBot(text, botUserId) {
+  if (!botUserId || !text) {
+    return false;
+  }
+  const outside = textOutsideCode(text);
+  const id = escapeRegExp(botUserId);
+  return new RegExp(`<@${id}(?:\\|[^>]+)?>`).test(outside);
+}
+
 // src/chat/ingress/message-changed.ts
 import { Message as Message2 } from "chat";
 function getEditedMentionMessageId(messageTs) {
@@ -3222,9 +3304,6 @@ function isMessageChangedEnvelope(value) {
   if (!event || typeof event !== "object") return false;
   return event.type === "message" && event.subtype === "message_changed" && typeof event.channel === "string" && typeof event.message === "object" && event.message !== null && typeof event.previous_message === "object" && event.previous_message !== null;
 }
-function textMentionsBot(text, botUserId) {
-  return text.includes(`<@${botUserId}>`);
-}
 function getAttachmentType(mimeType) {
   if (mimeType?.startsWith("image/")) {
     return "image";
@@ -3507,9 +3586,6 @@ function installationFromEnvelope(body) {
 function isDmEvent(event) {
   return event.channel_type === "im" || event.channel?.startsWith("D") === true;
 }
-function textMentionsBot2(event, botUserId) {
-  return Boolean(botUserId && event.text?.includes(`<@${botUserId}>`));
-}
 function shouldIgnoreMessageSubtype(event) {
   return Boolean(event.subtype && IGNORED_MESSAGE_SUBTYPES.has(event.subtype));
 }
@@ -3591,7 +3667,10 @@ async function routeParsedMessage(args) {
     conversationStore: args.conversationStore,
     installation: args.installation
   });
-  const isMention = args.event.type === "app_mention" || textMentionsBot2(args.event, args.adapter.botUserId);
+  const botUserId = args.adapter.botUserId;
+  const isMention = Boolean(
+    botUserId && textMentionsBot(args.event.text ?? "", botUserId)
+  );
   if (isMention) {
     args.message.isMention = true;
   }
@@ -4281,11 +4360,11 @@ var THREAD_OPTOUT_PATTERNS = [
 var ACKNOWLEDGMENT_ONLY_RE = /^(?:thanks(?: you)?|thank you|thx|ty|got it|sounds good|sgtm|lgtm|ok(?:ay)?|cool|nice|perfect|awesome|great|makes sense|understood|roger|yep|yup|kk|on it|will do)(?:[.!]+)?$/i;
 var DIRECTED_FOLLOW_UP_CUE_RE = /\b(?:you said|you just said|your last response|your last answer|what did you just say|what do you mean|what did you mean|explain(?: that| this| it| more)?|clarify(?: that| this| it)?|expand(?: on)?(?: that| this| it)?|elaborate(?: on)?(?: that| this| it)?|say more)\b/i;
 var TERSE_CLARIFICATION_RE = /^(?:which one|which ones|why|how so|what do you mean|what did you mean|say more|explain that|clarify that|expand on that|elaborate on that)\??$/i;
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function containsAssistantInvocation(text, botUserName) {
-  const escapedUserName = escapeRegExp(botUserName);
+  const escapedUserName = escapeRegExp2(botUserName);
   const plainNameMentionRe = new RegExp(`(^|\\s)@${escapedUserName}\\b`, "i");
   const labeledEntityMentionRe = new RegExp(
     `<@[^>|]+\\|${escapedUserName}>`,
@@ -6529,7 +6608,8 @@ function createReplyToThread(deps) {
               isBot: true
             },
             meta: {
-              replied: true
+              replied: true,
+              source: "slack"
             }
           });
           await persistThreadState(thread, {
@@ -6717,6 +6797,7 @@ function createReplyToThread(deps) {
           const recordedMessageId = recordDeliveredAssistantMessage({
             conversation: preparedState.conversation,
             sessionId: turnId,
+            source: "slack",
             text,
             userMessageId: preparedState.userMessageId
           });
@@ -7372,6 +7453,7 @@ function toConversationMessage(args) {
       explicitMention: args.explicitMention,
       imageAttachmentCount: imageAttachmentCount > 0 ? imageAttachmentCount : void 0,
       imagesHydrated: !messageHasPotentialImageAttachment,
+      source: "slack",
       ...slackTs ? { slackTs } : {}
     }
   };
@@ -9060,7 +9142,9 @@ async function createApp(options) {
   const waitUntil = options?.waitUntil ?? await defaultWaitUntil();
   const tracePropagation = { domains: sandboxEgressTracePropagationDomains };
   const conversationWorkQueue = getVercelConversationWorkQueue();
+  const attachmentStorage = createVercelAttachmentStorage();
   const agentRunner = createAgentRunner(executeAgentRun, {
+    attachmentStorage,
     bindSpawnAgent: (request) => bindSpawnAgent(request, { queue: conversationWorkQueue }),
     tracePropagation
   });

package/dist/{catalog-runtime-V6YD6KH5.js → catalog-runtime-HUGHAFUN.js}

@@ -1,15 +1,15 @@
 import {
   pluginCatalogRuntime
-} from "./chunk-TVXAN43I.js";
-import "./chunk-RN3AWYEP.js";
+} from "./chunk-6MI43QZO.js";
+import "./chunk-77QB5FNI.js";
 import "./chunk-BDUENQD3.js";
 import "./chunk-V7YE4WCP.js";
-import "./chunk-7NYEB2TM.js";
+import "./chunk-MKA3T2R6.js";
 import "./chunk-6GWA276C.js";
 import "./chunk-OOUNJNMR.js";
 import "./chunk-H4HBKISO.js";
-import "./chunk-EORR34UB.js";
-import "./chunk-JFZBGFNX.js";
+import "./chunk-F7VOY4VQ.js";
+import "./chunk-46ADYIPE.js";
 import "./chunk-MLKGABMK.js";
 export {
   pluginCatalogRuntime

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

@@ -24,6 +24,7 @@ import type { SlackActionToken } from "@/chat/slack/action-token";
 import type { TurnReasoningLevel } from "@/chat/reasoning-level";
 import type { ImageGenerateToolDeps, ViewImageToolDeps, WebFetchToolDeps, WebSearchToolDeps } from "@/chat/tools/types";
 import type { AssistantMessage } from "@earendil-works/pi-ai";
+import type { AttachmentStorage } from "@/chat/attachments/storage";
 /** One attachment the model may see for the current instruction. */
 export type AgentAttachment = {
     data?: Buffer;
@@ -136,6 +137,7 @@ export type AgentEvent = {
 };
 /** Resolved environment and optional per-run tool test overrides. */
 export type AgentEnvironment = {
+    attachmentStorage?: AttachmentStorage;
     configuration?: Record<string, unknown>;
     locationConfiguration?: LocationConfigurationService;
     skillDirs?: string[];

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

@@ -86,8 +86,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
     destinationVisibility: z.ZodOptional<z.ZodEnum<{
-        public: "public";
         private: "private";
+        public: "public";
     }>>;
     input: z.ZodString;
     invocationId: z.ZodString;
@@ -108,8 +108,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         teamId: z.ZodString;
         channelId: z.ZodString;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         messageTs: z.ZodOptional<z.ZodString>;
         threadTs: z.ZodOptional<z.ZodString>;
@@ -120,8 +120,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"web">;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
@@ -211,8 +211,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
     destinationVisibility: z.ZodOptional<z.ZodEnum<{
-        public: "public";
         private: "private";
+        public: "public";
     }>>;
     input: z.ZodString;
     invocationId: z.ZodString;
@@ -233,8 +233,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         teamId: z.ZodString;
         channelId: z.ZodString;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         messageTs: z.ZodOptional<z.ZodString>;
         threadTs: z.ZodOptional<z.ZodString>;
@@ -245,8 +245,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"web">;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
@@ -334,8 +334,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
     destinationVisibility: z.ZodOptional<z.ZodEnum<{
-        public: "public";
         private: "private";
+        public: "public";
     }>>;
     input: z.ZodString;
     invocationId: z.ZodString;
@@ -356,8 +356,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         teamId: z.ZodString;
         channelId: z.ZodString;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         messageTs: z.ZodOptional<z.ZodString>;
         threadTs: z.ZodOptional<z.ZodString>;
@@ -368,8 +368,8 @@ export declare const agentInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"web">;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
@@ -459,8 +459,8 @@ export declare const createAgentInvocationSchema: z.ZodObject<{
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;
     destinationVisibility: z.ZodOptional<z.ZodEnum<{
-        public: "public";
         private: "private";
+        public: "public";
     }>>;
     idempotencyKey: z.ZodString;
     input: z.ZodString;
@@ -477,8 +477,8 @@ export declare const createAgentInvocationSchema: z.ZodObject<{
         teamId: z.ZodString;
         channelId: z.ZodString;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         messageTs: z.ZodOptional<z.ZodString>;
         threadTs: z.ZodOptional<z.ZodString>;
@@ -489,8 +489,8 @@ export declare const createAgentInvocationSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         platform: z.ZodLiteral<"web">;
         visibility: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
         conversationId: z.ZodString;
     }, z.core.$strict>], "platform">;

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

@@ -0,0 +1,14 @@
+/** 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

@@ -0,0 +1,68 @@
+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

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