Expand kitchen sink plugin demos

packages/plugins/sdk/src/ui/hooks.ts

@@ -1,4 +1,10 @@
-import type { PluginDataResult, PluginActionFn, PluginHostContext, PluginStreamResult } from "./types.js";
+import type {
+  PluginDataResult,
+  PluginActionFn,
+  PluginHostContext,
+  PluginStreamResult,
+  PluginToastFn,
+} from "./types.js";
 import { getSdkUiRuntimeValue } from "./runtime.js";
 
 // ---------------------------------------------------------------------------
@@ -151,3 +157,18 @@ export function usePluginStream<T = unknown>(
   >("usePluginStream");
   return impl(channel, options);
 }
+
+// ---------------------------------------------------------------------------
+// usePluginToast
+// ---------------------------------------------------------------------------
+
+/**
+ * Trigger a host toast notification from plugin UI.
+ *
+ * This lets plugin pages and widgets surface user-facing feedback through the
+ * same toast system as the host app without reaching into host internals.
+ */
+export function usePluginToast(): PluginToastFn {
+  const impl = getSdkUiRuntimeValue<() => PluginToastFn>("usePluginToast");
+  return impl();
+}

packages/plugins/sdk/src/ui/index.ts

@@ -56,6 +56,7 @@ export {
   usePluginAction,
   useHostContext,
   usePluginStream,
+  usePluginToast,
 } from "./hooks.js";
 
 // Bridge error and host context types
@@ -73,6 +74,10 @@ export type {
   PluginDataResult,
   PluginActionFn,
   PluginStreamResult,
+  PluginToastTone,
+  PluginToastAction,
+  PluginToastInput,
+  PluginToastFn,
 } from "./types.js";
 
 // Slot component prop interfaces

packages/plugins/sdk/src/ui/types.ts

@@ -300,6 +300,29 @@ export interface PluginDataResult<T = unknown> {
   refresh(): void;
 }
 
+// ---------------------------------------------------------------------------
+// usePluginToast hook types
+// ---------------------------------------------------------------------------
+
+export type PluginToastTone = "info" | "success" | "warn" | "error";
+
+export interface PluginToastAction {
+  label: string;
+  href: string;
+}
+
+export interface PluginToastInput {
+  id?: string;
+  dedupeKey?: string;
+  title: string;
+  body?: string;
+  tone?: PluginToastTone;
+  ttlMs?: number;
+  action?: PluginToastAction;
+}
+
+export type PluginToastFn = (input: PluginToastInput) => string | null;
+
 // ---------------------------------------------------------------------------
 // usePluginAction hook return type
 // ---------------------------------------------------------------------------