@vellumai/plugin-api 0.10.3-dev.202606301343.ebf8f0b → 0.10.3-dev.202606301500.9739193

package/index.d.ts

@@ -3646,22 +3646,34 @@ declare interface ShowPlatformLogin {
 }
 
 /**
- * Context passed to the `shutdown` hook during daemon teardown. Kept
- * intentionally narrower than {@link InitContext} — most teardown
- * paths only need to know which assistant version they're shutting
- * down against (e.g. for version-conditional cleanup of state files
- * written by a previous boot).
+ * Context passed to the `shutdown` hook. Kept intentionally narrower than
+ * {@link InitContext} — teardown paths only need to know which assistant
+ * version they're shutting down against (e.g. for version-conditional cleanup
+ * of state files written by a previous boot) and {@link ShutdownReason why}
+ * they're being torn down (so a plugin can, e.g., delete its state on
+ * `uninstall` but preserve it across a plain `shutdown`).
  *
- * Additional fields may be added as concrete plugin needs surface; the
- * `assistantVersion` field mirrors the init context's so plugins that
- * stash a version stamp at init can compare against the same name on
- * tear-down without keeping their own copy.
+ * The `assistantVersion` field mirrors the init context's so plugins that stash
+ * a version stamp at init can compare against the same name on tear-down
+ * without keeping their own copy.
  */
 export declare interface ShutdownContext {
     /** Assistant semver for compatibility checks inside the plugin. */
     assistantVersion: string;
+    /** Why the plugin is shutting down. */
+    reason: ShutdownReason;
 }
 
+/**
+ * Why a plugin's `shutdown` hook is firing.
+ *
+ * - `shutdown` — the daemon is tearing down (process exit).
+ * - `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).
+ */
+declare type ShutdownReason = "shutdown" | "uninstall" | "disable";
+
 declare interface SignBundlePayloadRequest {
     type: "sign_bundle_payload";
     requestId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.3-dev.202606301343.ebf8f0b",
+  "version": "0.10.3-dev.202606301500.9739193",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",