@yaklabs-ai/plugin-sdk 0.31.0 → 0.33.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.31.0"
+    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.33.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.31.0" },
+  "compatibility": { "sdk": "^0.33.0" },
   "targets": {
     "kay": {
       "agent": {

package/THIRD-PARTY-INVENTORY.json

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

package/dist/disclosure.d.ts

@@ -2362,8 +2362,17 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * `contributes` names each entry's title, page, shortcut and icon file. It replaces `activityRail` on a
  * UI app, which is stripped from a manifest that still carries it, so that manifest loses only the
  * rail button. A plugin that declares a rail entry declares ^0.31.0.
+ *
+ * 0.32.0 lets an app-data source declare its window store as data (#15891). `store` under
+ * `contributes.dataSources` replaces a `kay.ui` data materializer, and a change too big for a live
+ * update becomes a re-read of the snapshot. A plugin that declares a store declares ^0.32.0.
+ *
+ * 0.33.0 lets a plugin declare a window command with its button and menu item (#15903). `commands`
+ * under `kay.ui` `contributes` names each command's title, icon file, `button`, `menu` and `where`,
+ * and `api.implementCommand(localId, handler)` supplies what it does. `placement` is gone and `icon`
+ * is now a file path: nothing ever read either. A plugin that declares a command declares ^0.33.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.31.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.33.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

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

@@ -2416,8 +2416,17 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * `contributes` names each entry's title, page, shortcut and icon file. It replaces `activityRail` on a
  * UI app, which is stripped from a manifest that still carries it, so that manifest loses only the
  * rail button. A plugin that declares a rail entry declares ^0.31.0.
+ *
+ * 0.32.0 lets an app-data source declare its window store as data (#15891). `store` under
+ * `contributes.dataSources` replaces a `kay.ui` data materializer, and a change too big for a live
+ * update becomes a re-read of the snapshot. A plugin that declares a store declares ^0.32.0.
+ *
+ * 0.33.0 lets a plugin declare a window command with its button and menu item (#15903). `commands`
+ * under `kay.ui` `contributes` names each command's title, icon file, `button`, `menu` and `where`,
+ * and `api.implementCommand(localId, handler)` supplies what it does. `placement` is gone and `icon`
+ * is now a file path: nothing ever read either. A plugin that declares a command declares ^0.33.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.31.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.33.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5577,6 +5586,13 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
                 schema: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
             }, z.core.$strict>;
         }, z.core.$strict>>;
+        store: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            shape: z.ZodLiteral<"rows">;
+            rowsField: z.ZodString;
+            key: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            shape: z.ZodLiteral<"value">;
+        }, z.core.$strict>], "shape">>;
     }, z.core.$strict>>>;
     kayAppWhiteboardTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
         localId: z.ZodString;
@@ -5686,8 +5702,6 @@ declare const ResolvedPluginContractV1: z.ZodObject<{
                 "artifacts.preview": "artifacts.preview";
                 "cost.read": "cost.read";
                 "billing.read": "billing.read";
-                "context.read": "context.read";
-                "usage.read": "usage.read";
                 "self-improvement.read": "self-improvement.read";
                 "automations.read": "automations.read";
                 "shared-artifacts.read": "shared-artifacts.read";

package/dist/kay-agent.d.ts

@@ -2691,8 +2691,17 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * `contributes` names each entry's title, page, shortcut and icon file. It replaces `activityRail` on a
  * UI app, which is stripped from a manifest that still carries it, so that manifest loses only the
  * rail button. A plugin that declares a rail entry declares ^0.31.0.
+ *
+ * 0.32.0 lets an app-data source declare its window store as data (#15891). `store` under
+ * `contributes.dataSources` replaces a `kay.ui` data materializer, and a change too big for a live
+ * update becomes a re-read of the snapshot. A plugin that declares a store declares ^0.32.0.
+ *
+ * 0.33.0 lets a plugin declare a window command with its button and menu item (#15903). `commands`
+ * under `kay.ui` `contributes` names each command's title, icon file, `button`, `menu` and `where`,
+ * and `api.implementCommand(localId, handler)` supplies what it does. `placement` is gone and `icon`
+ * is now a file path: nothing ever read either. A plugin that declares a command declares ^0.33.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.31.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.33.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/dist/kay-app.d.ts

@@ -2646,8 +2646,17 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * `contributes` names each entry's title, page, shortcut and icon file. It replaces `activityRail` on a
  * UI app, which is stripped from a manifest that still carries it, so that manifest loses only the
  * rail button. A plugin that declares a rail entry declares ^0.31.0.
+ *
+ * 0.32.0 lets an app-data source declare its window store as data (#15891). `store` under
+ * `contributes.dataSources` replaces a `kay.ui` data materializer, and a change too big for a live
+ * update becomes a re-read of the snapshot. A plugin that declares a store declares ^0.32.0.
+ *
+ * 0.33.0 lets a plugin declare a window command with its button and menu item (#15903). `commands`
+ * under `kay.ui` `contributes` names each command's title, icon file, `button`, `menu` and `where`,
+ * and `api.implementCommand(localId, handler)` supplies what it does. `placement` is gone and `icon`
+ * is now a file path: nothing ever read either. A plugin that declares a command declares ^0.33.0.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.31.0";
+declare const KAY_PLUGIN_SDK_VERSION: "0.33.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -4791,17 +4800,6 @@ export declare interface KayAppModelSelectionEntry extends TranscriptEntryLike {
     readonly message?: unknown;
 }
 
-/** How a helper's settled result reaches the session. */
-export declare interface KayAppModelSelectionHelperHandBack {
-    /**
-     * Wake the session's own model when the helper fails, or ends its run without stamping its
-     * work completed (it stopped short, or reported itself blocked).
-     */
-    readonly wakeOnFailure: boolean;
-    /** Wake it when the helper's answer starts with this marker (the helper handing the work back). */
-    readonly wakeOnReplyPrefix?: string;
-}
-
 /** What the daemon shows the person when a change lands, as a visible message the model also reads. */
 export declare interface KayAppModelSelectionNotice {
     readonly kind: "tier-up" | "tier-down" | "thinking-down";
@@ -4857,41 +4855,12 @@ export declare interface KayAppModelSelectionResponseFacts extends KayAppModelSe
     readonly contextTokens: number;
 }
 
-export declare type KayAppModelSelectionSendAnswer = {
-    /** The session's own model answers, after `change` when there is one. */
+/** The policy's answer to a follow-up: the session's own model answers, after `change` when there is one. */
+export declare interface KayAppModelSelectionSendAnswer {
     readonly kind: "main";
     readonly change?: KayAppModelSelectionChange;
     readonly records?: readonly KayAppModelSelectionRecord[];
-} | {
-    /** A helper subagent answers instead, and the session's own model does not run. */
-    readonly kind: "helper";
-    readonly tier: Exclude<KayAppModelTierId, "small">;
-    /**
-     * Continue this existing helper of the session (a child the session's earlier hand-offs
-     * spawned) instead of starting a new one: `continueHelper.brief` becomes its next message,
-     * written for a helper that already holds its earlier request, work and answer. The daemon
-     * starts a new helper on the top-level `brief` instead when that child is not this
-     * session's, is still working, or cannot take a message; `continueHelper.brief` is used
-     * only when the child is actually continued.
-     */
-    readonly continueHelper?: {
-        readonly sessionId: string;
-        readonly brief: string;
-    };
-    /**
-     * A new helper's first message, its complete context (the previous reply and the
-     * follow-up). Always present: it is what the daemon sends whenever it starts a new helper,
-     * including when a `continueHelper` cannot be continued.
-     */
-    readonly brief: string;
-    readonly displayName: string;
-    /** Who took the request, for the person's request row ("Quick helper on the medium model"). */
-    readonly caption: string;
-    /** The full line under the helper's reply ("Answered by Quick helper on the medium model"). */
-    readonly replyCaption: string;
-    readonly handBack: KayAppModelSelectionHelperHandBack;
-    readonly records?: readonly KayAppModelSelectionRecord[];
-};
+}
 
 /** A person's plain-text follow-up to an idle session, before its model runs. */
 export declare interface KayAppModelSelectionSendFacts extends KayAppModelSelectionSessionFacts {

package/package.json

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