@vellumai/plugin-api 0.11.10-dev.202609100918.0821a35 → 0.11.10-dev.202609101415.05cbbf9

package/index.d.ts

@@ -4849,6 +4849,7 @@ export declare type HookBroadcast = (detail: Record<string, unknown>) => void;
  *   - `post-model-call` — {@link PostModelCallContext}
  *   - `conversation-deleted` — {@link ConversationDeletedContext}
  *   - `conversations-cleared` — {@link ConversationsClearedContext}
+ *   - `message-deleted`: {@link MessageDeletedContext}
  */
 export declare type HookFunction<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
 
@@ -4890,6 +4891,8 @@ export declare const HOOKS: {
     readonly CONVERSATION_DELETED: "conversation-deleted";
     /** Fires once when every conversation is wiped at once (the clear-all reset), after the main tables are cleared. Carries no `conversationId`; cleanup hooks wipe their own per-conversation state wholesale. */
     readonly CONVERSATIONS_CLEARED: "conversations-cleared";
+    /** Fires once per deleted message row, after the row is removed, carrying the row's `(createdAt, id)` so a hook can settle state that pointed at it. Fire-and-forget cleanup signal, like `conversation-deleted`; whole-conversation deletes dispatch that hook instead. */
+    readonly MESSAGE_DELETED: "message-deleted";
 };
 
 /**
@@ -5535,6 +5538,37 @@ export declare interface Message {
     content: ContentBlock[];
 }
 
+/**
+ * The full `message-deleted` context a hook receives: the dispatching call
+ * site's {@link MessageDeletedInputContext} plus the pipeline-stamped
+ * {@link BaseHookContext} capabilities.
+ */
+export declare interface MessageDeletedContext extends MessageDeletedInputContext, BaseHookContext {
+}
+
+/**
+ * Context passed to the `message-deleted` hook. Fires once per deleted
+ * message row, from the shared single-message delete primitive, after the row
+ * is removed. Whole-conversation deletes dispatch `conversation-deleted`
+ * instead.
+ *
+ * Fire-and-forget like `conversation-deleted`: the primitive is synchronous
+ * and does not wait for the chain. The row is gone by the time a hook runs,
+ * so the context carries the row's `createdAt` alongside its id. Together
+ * they are the `(createdAt, id)` position the row held, which is what a hook
+ * keeping a cursor on that row needs to record once the row can no longer be
+ * looked up. The default memory plugin contributes a hook here that stamps
+ * its retrospective cursor.
+ */
+declare interface MessageDeletedInputContext {
+    /** ID of the conversation that owned the row. */
+    readonly conversationId: string;
+    /** ID of the deleted message row. */
+    readonly messageId: string;
+    /** The deleted row's `createdAt`. */
+    readonly createdAt: number;
+}
+
 declare type MessageLexicalSearchResult = Awaited<ReturnType<searchMessageIdsLexical_2>>[number];
 
 declare interface MessageLexicalSearchResult_2 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.10-dev.202609100918.0821a35",
+  "version": "0.11.10-dev.202609101415.05cbbf9",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",