@yaklabs-ai/plugin-protocol 0.33.0 → 0.34.0

package/README.md

@@ -11,7 +11,7 @@ flow.
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.33.0"
+    "@bonsai/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.34.0"
   }
 }
 ```

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -2739,6 +2739,9 @@ declare const canonicalContributionSchemas: {
             primary: "primary";
             plugins: "plugins";
         }>>;
+        panel: z.ZodOptional<z.ZodObject<{
+            body: z.ZodString;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     UiAppContribution: z.ZodObject<{
         localId: z.ZodString;
@@ -4073,8 +4076,12 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 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.
+ *
+ * 0.34.0 lets a rail entry declare a sidebar (#15901). `panel.body` on a `railEntries` entry names
+ * what fills it, either a `contextOnly` app in the plugin or a body the host ships. Additive: a rail
+ * entry with no `panel` still opens its page alone. A plugin that declares a panel declares ^0.34.0.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.33.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.34.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5689,6 +5696,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                             primary: "primary";
                             plugins: "plugins";
                         }>>;
+                        panel: z.ZodOptional<z.ZodObject<{
+                            body: z.ZodString;
+                        }, z.core.$strict>>;
                     }, z.core.$strict>>>;
                     themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
@@ -6783,6 +6793,9 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                 primary: "primary";
                 plugins: "plugins";
             }>>;
+            panel: z.ZodOptional<z.ZodObject<{
+                body: z.ZodString;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
@@ -13843,6 +13856,9 @@ export declare const UiRailEntryContribution: z.ZodObject<{
         primary: "primary";
         plugins: "plugins";
     }>>;
+    panel: z.ZodOptional<z.ZodObject<{
+        body: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type UiRailEntryContribution = z.infer<typeof UiRailEntryContribution>;

package/dist/index.js

@@ -238,7 +238,7 @@ var JsonSchema = z4.record(z4.string(), JsonValue);
 var KAY_PLUGIN_MANIFEST_SIZE_CAP_BYTES = 1024 * 1024;
 var KAY_PLUGIN_PROTOCOL_VERSION = "kay.plugin.v1";
 var KAY_PLUGIN_PROTOCOL_PACKAGE_NAME = "@bonsai/plugin-protocol";
-var KAY_PLUGIN_SDK_VERSION = "0.33.0";
+var KAY_PLUGIN_SDK_VERSION = "0.34.0";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.26.3",
   "0.27.1",
@@ -246,7 +246,8 @@ var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.29.0",
   "0.30.0",
   "0.31.0",
-  "0.32.0"
+  "0.32.0",
+  "0.33.0"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -3729,7 +3730,8 @@ function createContributionsSchemas(canonical) {
     homeLocation: NonEmptyString3.optional(),
     shortcut: NonEmptyString3.optional(),
     order: z12.number().finite().optional(),
-    section: z12.enum(["primary", "plugins"]).optional()
+    section: z12.enum(["primary", "plugins"]).optional(),
+    panel: z12.strictObject({ body: LocalContributionId2 }).optional()
   });
   const UiAppFields = z12.strictObject({
     localId: LocalContributionId2,
@@ -4576,6 +4578,26 @@ function createManifestSchemas(canonical) {
         });
       }
     }
+    for (const [index, entry] of (manifest.targets?.kay?.ui?.contributes?.railEntries ?? []).entries()) {
+      const body = entry.panel?.body;
+      const app = manifest.targets?.kay?.ui?.contributes?.apps?.find((candidate) => candidate.localId === body);
+      if (app !== void 0 && app.contextOnly !== true) {
+        ctx.addIssue({
+          code: "custom",
+          path: [
+            "targets",
+            "kay",
+            "ui",
+            "contributes",
+            "railEntries",
+            index,
+            "panel",
+            "body"
+          ],
+          message: `Rail entry ${entry.id} panel body ${app.localId} must be a contextOnly ui app`
+        });
+      }
+    }
     const subscribedUiEvents = new Set(manifest.targets?.kay?.ui?.contributes?.eventSubscriptions?.map((subscription) => subscription.event) ?? []);
     const invokedUiEndpoints = new Set(manifest.permissions?.byTarget["kay.ui"]?.endpoints?.filter((grant) => grant.operations.includes("invoke")).map((grant) => grant.endpoint) ?? []);
     const uriModuleIds = new Set([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-protocol",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "The Kay plugin manifest schema (`kay.plugin.v1`) — parse and validate a kay-plugin.json.",
   "author": "YakLabs",
   "type": "module",