@yaklabs-ai/plugin-sdk 0.36.0 → 0.37.0

package/README.md

@@ -13,7 +13,7 @@ it under the name your plugin code actually imports:
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.36.0"
+    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.37.0"
   }
 }
 ```
@@ -62,7 +62,7 @@ Every tool the entrypoint registers is declared in the manifest too:
   "description": "Greets people by name.",
   "version": "0.1.0",
   "namespace": "widgets",
-  "compatibility": { "sdk": "^0.36.0" },
+  "compatibility": { "sdk": "^0.37.0" },
   "targets": {
     "kay": {
       "agent": {

package/THIRD-PARTY-INVENTORY.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@yaklabs-ai/plugin-sdk",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "target": "npm",
   "firstPartyLicense": "MIT",
   "bundled": [

package/dist/disclosure.d.ts

@@ -2390,8 +2390,13 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * under `kay.ui` `contributes` names each page's title, icon file, companion status and opened
  * event. A reference presentation that opens a page gains `scheme` and `addresses`, and may leave
  * out `uriModule` when another layer serves the address. A plugin using these declares ^0.36.0.
+ *
+ * 0.37.0 lets a notification rule's toast declare a preview (#15904). `toastPreviews` under `kay.ui`
+ * `contributes` names the `rule`, the `body` that fills the preview, either a `contextOnly` app in
+ * the plugin or a body the host ships, and the `address` it is about. Additive. A plugin that
+ * declares a preview declares ^0.37.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.36.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.37.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/dist/kay-agent-testing.d.ts

@@ -2444,8 +2444,13 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * under `kay.ui` `contributes` names each page's title, icon file, companion status and opened
  * event. A reference presentation that opens a page gains `scheme` and `addresses`, and may leave
  * out `uriModule` when another layer serves the address. A plugin using these declares ^0.36.0.
+ *
+ * 0.37.0 lets a notification rule's toast declare a preview (#15904). `toastPreviews` under `kay.ui`
+ * `contributes` names the `rule`, the `body` that fills the preview, either a `contextOnly` app in
+ * the plugin or a body the host ships, and the `address` it is about. Additive. A plugin that
+ * declares a preview declares ^0.37.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.36.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.37.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/dist/kay-agent.d.ts

@@ -2719,8 +2719,13 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * under `kay.ui` `contributes` names each page's title, icon file, companion status and opened
  * event. A reference presentation that opens a page gains `scheme` and `addresses`, and may leave
  * out `uriModule` when another layer serves the address. A plugin using these declares ^0.36.0.
+ *
+ * 0.37.0 lets a notification rule's toast declare a preview (#15904). `toastPreviews` under `kay.ui`
+ * `contributes` names the `rule`, the `body` that fills the preview, either a `contextOnly` app in
+ * the plugin or a body the host ships, and the `address` it is about. Additive. A plugin that
+ * declares a preview declares ^0.37.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.36.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.37.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/dist/kay-app.d.ts

@@ -2681,8 +2681,13 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * under `kay.ui` `contributes` names each page's title, icon file, companion status and opened
  * event. A reference presentation that opens a page gains `scheme` and `addresses`, and may leave
  * out `uriModule` when another layer serves the address. A plugin using these declares ^0.36.0.
+ *
+ * 0.37.0 lets a notification rule's toast declare a preview (#15904). `toastPreviews` under `kay.ui`
+ * `contributes` names the `rule`, the `body` that fills the preview, either a `contextOnly` app in
+ * the plugin or a body the host ships, and the `address` it is about. Additive. A plugin that
+ * declares a preview declares ^0.37.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.36.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.37.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-sdk",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "The Kay plugin SDK — types and helpers for authoring a Kay directory plugin.",
   "author": "YakLabs",
   "type": "module",

package/skills/directory-plugin-authoring/SKILL.md

@@ -131,7 +131,10 @@ activity-rail button when the manifest declares it: `railEntries` under `targets
 with `id`, `title` and `page`, and optionally `icon`, `shortcut`, `order` and `section`. That
 declaration works with no `ui.tsx` at all. To give the entry a sidebar, add `panel: { body }` naming
 an app in the same manifest with `contextOnly: true`. The sidebar is always there once declared, so
-the app shows its own empty state.
+the app shows its own empty state. To give a notification rule's toast a "Show changes" preview, add
+a `toastPreviews` entry under `targets.kay.ui.contributes` with `rule` (the rule's `localId`), `body`
+(a `contextOnly` app) and `address` (for example `${navigateTarget}/@diff/${revision}`). The app reads
+the address with `useKayAppReference()`, and the toast's "Open history" opens the same address.
 
 **Icons: declare one plugin icon, override only where you mean it.** Set the manifest `icon` (a
 package-relative SVG) and every surface the plugin contributes inherits it: reference pills, its