@yaklabs-ai/plugin-protocol 0.50.0 → 0.51.0

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -3230,6 +3230,12 @@ declare const canonicalContributionSchemas: {
         panel: z.ZodOptional<z.ZodObject<{
             body: z.ZodString;
         }, z.core.$strict>>;
+        featureFlagVariant: z.ZodOptional<z.ZodObject<{
+            flag: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            icon: z.ZodOptional<z.ZodString>;
+            panel: z.ZodOptional<z.ZodLiteral<false>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     UiToastPreviewContribution: z.ZodObject<{
         rule: z.ZodString;
@@ -4744,8 +4750,10 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  *
  * 0.50.0 adds explicit cross-plugin endpoint calls on both backend targets. The URI-only 0.49.0
  * contract remains served.
+ *
+ * 0.51.0 adds flag-dependent title, icon and panel presence on rail entries.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.50.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.51.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -6721,6 +6729,12 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         panel: z.ZodOptional<z.ZodObject<{
                             body: z.ZodString;
                         }, z.core.$strict>>;
+                        featureFlagVariant: z.ZodOptional<z.ZodObject<{
+                            flag: z.ZodString;
+                            title: z.ZodOptional<z.ZodString>;
+                            icon: z.ZodOptional<z.ZodString>;
+                            panel: z.ZodOptional<z.ZodLiteral<false>>;
+                        }, z.core.$strict>>;
                     }, z.core.$strict>>>;
                     toastPreviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         rule: z.ZodString;
@@ -7902,6 +7916,12 @@ export declare const KayUiTargetManifest: z.ZodObject<{
             panel: z.ZodOptional<z.ZodObject<{
                 body: z.ZodString;
             }, z.core.$strict>>;
+            featureFlagVariant: z.ZodOptional<z.ZodObject<{
+                flag: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                icon: z.ZodOptional<z.ZodString>;
+                panel: z.ZodOptional<z.ZodLiteral<false>>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         toastPreviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
             rule: z.ZodString;
@@ -16072,6 +16092,12 @@ export declare const UiRailEntryContribution: z.ZodObject<{
     panel: z.ZodOptional<z.ZodObject<{
         body: z.ZodString;
     }, z.core.$strict>>;
+    featureFlagVariant: z.ZodOptional<z.ZodObject<{
+        flag: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        panel: z.ZodOptional<z.ZodLiteral<false>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type UiRailEntryContribution = z.infer<typeof UiRailEntryContribution>;

package/dist/index.js

@@ -30,6 +30,12 @@ function declaredUiIconPaths(manifest) {
   const contributes = manifest.targets?.kay?.ui?.contributes;
   return [
     ...(contributes?.railEntries ?? []).flatMap((entry) => entry.icon === void 0 ? [] : [{ label: `kay.ui rail entry '${entry.id}' icon`, path: entry.icon }]),
+    ...(contributes?.railEntries ?? []).flatMap((entry) => entry.featureFlagVariant?.icon === void 0 ? [] : [
+      {
+        label: "kay.ui rail variant icon",
+        path: entry.featureFlagVariant.icon
+      }
+    ]),
     ...(contributes?.pages ?? []).flatMap((page) => page.icon === void 0 ? [] : [{ label: `kay.ui page '${page.id}' icon`, path: page.icon }]),
     ...(contributes?.commands ?? []).flatMap((command) => command.icon === void 0 ? [] : [
       {
@@ -260,8 +266,11 @@ 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.50.0";
-var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = ["0.49.0"];
+var KAY_PLUGIN_SDK_VERSION = "0.51.0";
+var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.50.0",
+  "0.49.0"
+];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
   "kay.app",
@@ -4252,6 +4261,7 @@ function createContributionsSchemas(canonical) {
     // Draws Bonsai's markdown document view in the app's page (`BonsaiMarkdownDocumentView`).
     // It reads and saves nothing: the app supplies the text and keeps the edits.
     "markdown.document-view",
+    "models.complete",
     // Draws links the host resolves and opens (`BonsaiReferencePill`, `BonsaiReferenceRow`,
     // `BonsaiReferenceMarkdown`). A person's click on one can open a session or another plugin's page.
     "references.open",
@@ -4327,7 +4337,13 @@ function createContributionsSchemas(canonical) {
     order: z12.number().finite().optional(),
     section: z12.enum(["primary", "plugins"]).optional(),
     badge: UiRailBadge.optional(),
-    panel: z12.strictObject({ body: LocalContributionId2 }).optional()
+    panel: z12.strictObject({ body: LocalContributionId2 }).optional(),
+    featureFlagVariant: z12.strictObject({
+      flag: NonEmptyString3,
+      title: NonEmptyString3.optional(),
+      icon: PackageAssetPath2.optional(),
+      panel: z12.literal(false).optional()
+    }).optional()
   });
   const UiToastPreviewContribution2 = z12.strictObject({
     rule: LocalContributionId2,
@@ -5193,13 +5209,6 @@ function createManifestSchemas(canonical) {
           message: `rail entry ${entry.id} counts ${entry.badge.source}, which is not one of this plugin's data sources with a rows store`
         });
       }
-      if (manifest.targets?.kay?.ui?.entrypoint === void 0) {
-        ctx.addIssue({
-          code: "custom",
-          path,
-          message: `rail entry ${entry.id} declares a badge, so its plugin needs a kay.ui entrypoint: the window starts a plugin's data sources when it loads that code`
-        });
-      }
     }
     for (const source of declaredAppDataSources) {
       if (materializedAppDataSources.has(source) || declaredAppDataStores.has(source))

package/package.json

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