@vellumai/plugin-api 0.10.5-dev.202607061707.15e4796 → 0.10.5-dev.202607061926.ed098d0

package/index.d.ts

@@ -1011,6 +1011,33 @@ declare interface ContextCompacted {
     summaryHadMemoryEcho?: boolean;
 }
 
+/**
+ * The full `conversation-deleted` context a hook receives — the dispatching
+ * call site's {@link ConversationDeletedInputContext} plus the
+ * pipeline-stamped {@link BaseHookContext} capabilities.
+ */
+export declare interface ConversationDeletedContext extends ConversationDeletedInputContext, BaseHookContext {
+}
+
+/**
+ * Context passed to the `conversation-deleted` hook. Fires once per deleted
+ * conversation — from the shared delete primitives, so every delete caller
+ * (route, retrospective cleanup, GC) dispatches it — after the conversation's
+ * rows are removed.
+ *
+ * The dispatch is fire-and-forget: the delete primitives are synchronous and
+ * do not wait for the chain, so hooks run concurrently with whatever the
+ * caller does after the delete and must not assume any ordering relative to
+ * it. By the time a hook runs, the conversation's rows (messages, segments,
+ * attachments, the conversation itself) are gone — a hook can only key its
+ * cleanup on the id. The default memory plugin contributes a hook here that
+ * fails its own still-pending background jobs referencing the conversation.
+ */
+declare interface ConversationDeletedInputContext {
+    /** ID of the conversation that was deleted. */
+    readonly conversationId: string;
+}
+
 declare type ConversationErrorEvent = z.infer<typeof ConversationErrorEventSchema>;
 
 declare const ConversationErrorEventSchema: z.ZodObject<{
@@ -1905,6 +1932,7 @@ declare const HookEventSchema: z.ZodObject<{
  *   - `post-tool-use` — {@link PostToolUseContext}
  *   - `stop` — {@link StopContext}
  *   - `post-model-call` — {@link PostModelCallContext}
+ *   - `conversation-deleted` — {@link ConversationDeletedContext}
  */
 export declare type HookFunction<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
 
@@ -1942,6 +1970,8 @@ export declare const HOOKS: {
     readonly POST_MODEL_CALL: "post-model-call";
     /** Fires after the loop successfully compacts a conversation mid-turn. */
     readonly POST_COMPACT: "post-compact";
+    /** Fires once per deleted conversation, after its rows are removed. Fire-and-forget cleanup signal — hooks run async with no ordering guarantee relative to the caller. */
+    readonly CONVERSATION_DELETED: "conversation-deleted";
 };
 
 declare interface HostAppControlCancel {
@@ -3637,8 +3667,11 @@ export declare interface ShutdownContext {
  * - `uninstall` — the plugin's directory was removed at runtime.
  * - `disable` — the plugin was disabled at runtime (e.g. a `.disabled`
  *   sentinel was added, or a feature flag turned it off).
+ * - `reload` — a source file inside the plugin directory changed and the
+ *   plugin is being redeployed in place; the old version's `shutdown` runs
+ *   before the new version is imported and its `init` fires.
  */
-declare type ShutdownReason = "shutdown" | "uninstall" | "disable";
+declare type ShutdownReason = "shutdown" | "uninstall" | "disable" | "reload";
 
 declare interface SignBundlePayloadRequest {
     type: "sign_bundle_payload";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.5-dev.202607061707.15e4796",
+  "version": "0.10.5-dev.202607061926.ed098d0",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",