@yaklabs-ai/plugin-protocol 0.30.0 → 0.31.0

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -1661,7 +1661,7 @@ declare namespace authoringContributionSchemas {
         RichViewContribution,
         KayUiAppHostCapability,
         UiAppCapabilities,
-        UiAppActivityRail,
+        UiRailEntryContribution,
         UiAppContribution,
         ThemeContribution,
         CommandHandler,
@@ -2711,15 +2711,18 @@ declare const canonicalContributionSchemas: {
             "workspace.arrange": "workspace.arrange";
         }>>>;
     }, z.core.$strict>;
-    UiAppActivityRail: z.ZodObject<{
+    UiRailEntryContribution: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        page: z.ZodString;
+        homeLocation: z.ZodOptional<z.ZodString>;
+        shortcut: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodNumber>;
         section: z.ZodOptional<z.ZodEnum<{
             primary: "primary";
             plugins: "plugins";
         }>>;
-        order: z.ZodOptional<z.ZodNumber>;
-        icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            svg: z.ZodString;
-        }, z.core.$strict>]>>;
     }, z.core.$strict>;
     UiAppContribution: z.ZodObject<{
         localId: z.ZodString;
@@ -2759,17 +2762,45 @@ declare const canonicalContributionSchemas: {
                 "workspace.arrange": "workspace.arrange";
             }>>>;
         }, z.core.$strict>>;
-        activityRail: z.ZodOptional<z.ZodObject<{
-            section: z.ZodOptional<z.ZodEnum<{
-                primary: "primary";
-                plugins: "plugins";
-            }>>;
-            order: z.ZodOptional<z.ZodNumber>;
-            icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                svg: z.ZodString;
-            }, z.core.$strict>]>>;
+    }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
+        localId: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodLiteral<"kay.react-app.v1">;
+        contextOnly: z.ZodOptional<z.ZodLiteral<true>>;
+        sdk: z.ZodObject<{
+            range: z.ZodString;
+        }, z.core.$strict>;
+        entrypoint: z.ZodObject<{
+            module: z.ZodString;
+            export: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        capabilities: z.ZodOptional<z.ZodObject<{
+            endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "sessions.create": "sessions.create";
+                "memory.read": "memory.read";
+                "skills.read": "skills.read";
+                "automations.run": "automations.run";
+                "artifacts.read": "artifacts.read";
+                "navigation.open-session": "navigation.open-session";
+                "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";
+                "workspace.place-pane": "workspace.place-pane";
+                "workspace.pane-header": "workspace.pane-header";
+                "workspace.arrange": "workspace.arrange";
+            }>>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>;
+    }, z.core.$strict>, unknown>;
     ThemeContribution: z.ZodObject<{
         localId: z.ZodString;
         displayName: z.ZodString;
@@ -3107,6 +3138,18 @@ export declare const DeclaredSkillSourceEnvelope: z.ZodDiscriminatedUnion<[z.Zod
 
 export declare type DeclaredSkillSourceEnvelope = z.infer<typeof DeclaredSkillSourceEnvelope>;
 
+declare interface DeclaredUiIconPath {
+    readonly label: string;
+    readonly path: string;
+}
+
+/**
+ * Every icon file a manifest's `kay.ui` section declares. The directory scan reads them, the
+ * containment check covers them, and a compiled plugin supplies their contents, so a new kind with
+ * an icon adds one line here and all three follow.
+ */
+export declare function declaredUiIconPaths(manifest: KayPluginManifestV1): readonly DeclaredUiIconPath[];
+
 /** Drop repeats under {@link sameClaim}, preserving first-seen order (a sort settles the rest). */
 export declare function dedupeClaims(claims: readonly PluginCapabilityClaimV1[]): PluginCapabilityClaimV1[];
 
@@ -3943,8 +3986,13 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * supplies what a run does: each run is handed the workflow's accounts and tokens, so the code
  * runs the same in the daemon and in the plugin host. Additive: `app.workflows.define` stays, and
  * a plugin that declares a workflow declares ^0.30.0.
+ *
+ * 0.31.0 lets a plugin declare its rail entries as data (#15896). `railEntries` under `kay.ui`
+ * `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.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.30.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.31.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5492,16 +5540,57 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "workspace.arrange": "workspace.arrange";
                             }>>>;
                         }, z.core.$strict>>;
-                        activityRail: z.ZodOptional<z.ZodObject<{
-                            section: z.ZodOptional<z.ZodEnum<{
-                                primary: "primary";
-                                plugins: "plugins";
-                            }>>;
-                            order: z.ZodOptional<z.ZodNumber>;
-                            icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                                svg: z.ZodString;
-                            }, z.core.$strict>]>>;
+                    }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
+                        localId: z.ZodString;
+                        displayName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        icon: z.ZodOptional<z.ZodString>;
+                        runtime: z.ZodLiteral<"kay.react-app.v1">;
+                        contextOnly: z.ZodOptional<z.ZodLiteral<true>>;
+                        sdk: z.ZodObject<{
+                            range: z.ZodString;
+                        }, z.core.$strict>;
+                        entrypoint: z.ZodObject<{
+                            module: z.ZodString;
+                            export: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strict>;
+                        styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        capabilities: z.ZodOptional<z.ZodObject<{
+                            endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                                "sessions.create": "sessions.create";
+                                "memory.read": "memory.read";
+                                "skills.read": "skills.read";
+                                "automations.run": "automations.run";
+                                "artifacts.read": "artifacts.read";
+                                "navigation.open-session": "navigation.open-session";
+                                "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";
+                                "workspace.place-pane": "workspace.place-pane";
+                                "workspace.pane-header": "workspace.pane-header";
+                                "workspace.arrange": "workspace.arrange";
+                            }>>>;
                         }, z.core.$strict>>;
+                    }, z.core.$strict>, unknown>>>;
+                    railEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        title: z.ZodString;
+                        icon: z.ZodOptional<z.ZodString>;
+                        page: z.ZodString;
+                        homeLocation: z.ZodOptional<z.ZodString>;
+                        shortcut: z.ZodOptional<z.ZodString>;
+                        order: z.ZodOptional<z.ZodNumber>;
+                        section: z.ZodOptional<z.ZodEnum<{
+                            primary: "primary";
+                            plugins: "plugins";
+                        }>>;
                     }, z.core.$strict>>>;
                     themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
@@ -6545,16 +6634,57 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "workspace.arrange": "workspace.arrange";
                 }>>>;
             }, z.core.$strict>>;
-            activityRail: z.ZodOptional<z.ZodObject<{
-                section: z.ZodOptional<z.ZodEnum<{
-                    primary: "primary";
-                    plugins: "plugins";
-                }>>;
-                order: z.ZodOptional<z.ZodNumber>;
-                icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                    svg: z.ZodString;
-                }, z.core.$strict>]>>;
+        }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
+            localId: z.ZodString;
+            displayName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            icon: z.ZodOptional<z.ZodString>;
+            runtime: z.ZodLiteral<"kay.react-app.v1">;
+            contextOnly: z.ZodOptional<z.ZodLiteral<true>>;
+            sdk: z.ZodObject<{
+                range: z.ZodString;
+            }, z.core.$strict>;
+            entrypoint: z.ZodObject<{
+                module: z.ZodString;
+                export: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            capabilities: z.ZodOptional<z.ZodObject<{
+                endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    "sessions.create": "sessions.create";
+                    "memory.read": "memory.read";
+                    "skills.read": "skills.read";
+                    "automations.run": "automations.run";
+                    "artifacts.read": "artifacts.read";
+                    "navigation.open-session": "navigation.open-session";
+                    "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";
+                    "workspace.place-pane": "workspace.place-pane";
+                    "workspace.pane-header": "workspace.pane-header";
+                    "workspace.arrange": "workspace.arrange";
+                }>>>;
             }, z.core.$strict>>;
+        }, z.core.$strict>, unknown>>>;
+        railEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            page: z.ZodString;
+            homeLocation: z.ZodOptional<z.ZodString>;
+            shortcut: z.ZodOptional<z.ZodString>;
+            order: z.ZodOptional<z.ZodNumber>;
+            section: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                plugins: "plugins";
+            }>>;
         }, z.core.$strict>>>;
         themes: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
@@ -10576,16 +10706,6 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
     globalId: z.ZodString;
     displayName: z.ZodString;
     contextOnly: z.ZodOptional<z.ZodLiteral<true>>;
-    activityRail: z.ZodOptional<z.ZodObject<{
-        section: z.ZodOptional<z.ZodEnum<{
-            primary: "primary";
-            plugins: "plugins";
-        }>>;
-        order: z.ZodOptional<z.ZodNumber>;
-        icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            svg: z.ZodString;
-        }, z.core.$strict>]>>;
-    }, z.core.$strict>>;
     description: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
     runtime: z.ZodLiteral<"kay.react-app.v1">;
@@ -11873,16 +11993,6 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         globalId: z.ZodString;
         displayName: z.ZodString;
         contextOnly: z.ZodOptional<z.ZodLiteral<true>>;
-        activityRail: z.ZodOptional<z.ZodObject<{
-            section: z.ZodOptional<z.ZodEnum<{
-                primary: "primary";
-                plugins: "plugins";
-            }>>;
-            order: z.ZodOptional<z.ZodNumber>;
-            icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-                svg: z.ZodString;
-            }, z.core.$strict>]>>;
-        }, z.core.$strict>>;
         description: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
         runtime: z.ZodLiteral<"kay.react-app.v1">;
@@ -13484,19 +13594,6 @@ export declare interface TurnPacketMessage {
     readonly origin: TurnMessageOrigin;
 }
 
-export declare const UiAppActivityRail: z.ZodObject<{
-    section: z.ZodOptional<z.ZodEnum<{
-        primary: "primary";
-        plugins: "plugins";
-    }>>;
-    order: z.ZodOptional<z.ZodNumber>;
-    icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        svg: z.ZodString;
-    }, z.core.$strict>]>>;
-}, z.core.$strict>;
-
-export declare type UiAppActivityRail = z.infer<typeof UiAppActivityRail>;
-
 export declare const UiAppCapabilities: z.ZodObject<{
     endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
     host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -13560,17 +13657,45 @@ export declare const UiAppContribution: z.ZodObject<{
             "workspace.arrange": "workspace.arrange";
         }>>>;
     }, z.core.$strict>>;
-    activityRail: z.ZodOptional<z.ZodObject<{
-        section: z.ZodOptional<z.ZodEnum<{
-            primary: "primary";
-            plugins: "plugins";
-        }>>;
-        order: z.ZodOptional<z.ZodNumber>;
-        icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            svg: z.ZodString;
-        }, z.core.$strict>]>>;
+}, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
+    localId: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    runtime: z.ZodLiteral<"kay.react-app.v1">;
+    contextOnly: z.ZodOptional<z.ZodLiteral<true>>;
+    sdk: z.ZodObject<{
+        range: z.ZodString;
+    }, z.core.$strict>;
+    entrypoint: z.ZodObject<{
+        module: z.ZodString;
+        export: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "sessions.create": "sessions.create";
+            "memory.read": "memory.read";
+            "skills.read": "skills.read";
+            "automations.run": "automations.run";
+            "artifacts.read": "artifacts.read";
+            "navigation.open-session": "navigation.open-session";
+            "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";
+            "workspace.place-pane": "workspace.place-pane";
+            "workspace.pane-header": "workspace.pane-header";
+            "workspace.arrange": "workspace.arrange";
+        }>>>;
     }, z.core.$strict>>;
-}, z.core.$strict>;
+}, z.core.$strict>, unknown>;
 
 export declare type UiAppContribution = z.infer<typeof UiAppContribution>;
 
@@ -13590,6 +13715,22 @@ export declare const UiEventSubscriptionContribution: z.ZodObject<{
 
 export declare type UiEventSubscriptionContribution = z.infer<typeof UiEventSubscriptionContribution>;
 
+export declare const UiRailEntryContribution: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    page: z.ZodString;
+    homeLocation: z.ZodOptional<z.ZodString>;
+    shortcut: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+    section: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        plugins: "plugins";
+    }>>;
+}, z.core.$strict>;
+
+export declare type UiRailEntryContribution = z.infer<typeof UiRailEntryContribution>;
+
 export declare const UiSlotContribution: z.ZodObject<{
     localId: z.ZodString;
     slot: z.ZodString;

package/dist/index.js

@@ -10,6 +10,12 @@ var KAY_APP_DATA_CHANGE_MAX_BYTES = 256 * 1024;
 var KAY_APP_DATA_READ_REQUEST_MAX_BYTES = 64 * 1024;
 var KAY_APP_DATA_READ_RESULT_MAX_BYTES = 16 * 1024 * 1024;
 
+// packages/plugin-protocol/dist/ui-icon-paths.js
+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 }]);
+}
+
 // packages/plugin-protocol/dist/approval-types.js
 import { z } from "zod";
 var APPROVAL_KINDS = [
@@ -224,12 +230,13 @@ 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.30.0";
+var KAY_PLUGIN_SDK_VERSION = "0.31.0";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.26.3",
   "0.27.1",
   "0.28.0",
-  "0.29.0"
+  "0.29.0",
+  "0.30.0"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -2718,11 +2725,11 @@ __export(contributions_exports, {
   ThemeContribution: () => ThemeContribution,
   ToolContribution: () => ToolContribution,
   ToolPermission: () => ToolPermission,
-  UiAppActivityRail: () => UiAppActivityRail,
   UiAppCapabilities: () => UiAppCapabilities,
   UiAppContribution: () => UiAppContribution,
   UiCommandContribution: () => UiCommandContribution,
   UiEventSubscriptionContribution: () => UiEventSubscriptionContribution,
+  UiRailEntryContribution: () => UiRailEntryContribution,
   UiSlotContribution: () => UiSlotContribution,
   UriModuleContribution: () => UriModuleContribution,
   UriModuleFacts: () => UriModuleFacts,
@@ -3506,12 +3513,17 @@ function createContributionsSchemas(canonical) {
       }
     }
   });
-  const UiAppActivityRail2 = z12.strictObject({
-    section: z12.enum(["primary", "plugins"]).optional(),
+  const UiRailEntryContribution2 = z12.strictObject({
+    id: LocalContributionId2,
+    title: NonEmptyString3,
+    icon: PackageAssetPath2.optional(),
+    page: NonEmptyString3,
+    homeLocation: NonEmptyString3.optional(),
+    shortcut: NonEmptyString3.optional(),
     order: z12.number().finite().optional(),
-    icon: z12.union([NonEmptyString3, z12.strictObject({ svg: NonEmptyString3 })]).optional()
+    section: z12.enum(["primary", "plugins"]).optional()
   });
-  const UiAppContribution2 = z12.strictObject({
+  const UiAppFields = z12.strictObject({
     localId: LocalContributionId2,
     displayName: NonEmptyString3,
     description: NonEmptyString3.optional(),
@@ -3523,9 +3535,17 @@ function createContributionsSchemas(canonical) {
     entrypoint: TargetEntrypoint2,
     styles: z12.array(PackageAssetPath2).optional(),
     assets: z12.array(PackageAssetPath2).optional(),
-    capabilities: UiAppCapabilities2.optional(),
-    activityRail: UiAppActivityRail2.optional()
+    capabilities: UiAppCapabilities2.optional()
   });
+  function stripRetiredUiAppFields(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+      return value;
+    }
+    const remaining = { ...value };
+    delete remaining["activityRail"];
+    return remaining;
+  }
+  const UiAppContribution2 = canonical ? UiAppFields : z12.preprocess(stripRetiredUiAppFields, UiAppFields);
   const ThemeContribution2 = z12.strictObject({
     localId: LocalContributionId2,
     displayName: NonEmptyString3,
@@ -3643,7 +3663,7 @@ function createContributionsSchemas(canonical) {
     RichViewContribution: RichViewContribution2,
     KayUiAppHostCapability: KayUiAppHostCapability2,
     UiAppCapabilities: UiAppCapabilities2,
-    UiAppActivityRail: UiAppActivityRail2,
+    UiRailEntryContribution: UiRailEntryContribution2,
     UiAppContribution: UiAppContribution2,
     ThemeContribution: ThemeContribution2,
     CommandHandler: CommandHandler2,
@@ -3651,7 +3671,7 @@ function createContributionsSchemas(canonical) {
     PluginContributionKind: PluginContributionKind2
   };
 }
-var { ApprovalCardForm, ApprovalCardStoredForm, ApprovalTypeContribution, UriModuleFacts, ToolContribution, ToolPermission, AgentToolContribution, ConverterContribution, UriModuleContribution, AppUriModuleContribution, AppDataSourceContribution, WhiteboardTypeStorage, WhiteboardTypeContribution, AppDataMaterializerContribution, ArtifactUriModuleContribution, CliBindingContribution, GitHostContribution, ResourceContribution, SkillContribution, PluginSkillSourceDeclaration, SearchProviderContribution, InteractionDriverContribution, EntityResolverContribution, AgentRenderContribution, EndpointContribution, WorkflowContribution, McpServerUrl, McpServerAuthMode, McpServerContribution, McpServerContributions, AppEventSubscription, ContextContributorContribution, PluginEventDefinitionContribution, PluginNotificationRuleContribution, UiEventSubscriptionContribution, DeviceDelegationContribution, SessionReaderContribution, UiCommandContribution, UiSlotContribution, SettingsPanelContribution, ResultRendererContribution, ReferenceOpenBehavior, ReferencePresentationVariant, ReferencePresentationVariants, ReferencePresentationUriPattern, ReferencePresentationUrlClaim, ReferencePresentationTooltip, ReferencePresentationContribution, RichViewContribution, KayUiAppHostCapability, UiAppCapabilities, UiAppActivityRail, UiAppContribution, ThemeContribution, CommandHandler, CommandContribution, PluginContributionKind } = createContributionsSchemas(false);
+var { ApprovalCardForm, ApprovalCardStoredForm, ApprovalTypeContribution, UriModuleFacts, ToolContribution, ToolPermission, AgentToolContribution, ConverterContribution, UriModuleContribution, AppUriModuleContribution, AppDataSourceContribution, WhiteboardTypeStorage, WhiteboardTypeContribution, AppDataMaterializerContribution, ArtifactUriModuleContribution, CliBindingContribution, GitHostContribution, ResourceContribution, SkillContribution, PluginSkillSourceDeclaration, SearchProviderContribution, InteractionDriverContribution, EntityResolverContribution, AgentRenderContribution, EndpointContribution, WorkflowContribution, McpServerUrl, McpServerAuthMode, McpServerContribution, McpServerContributions, AppEventSubscription, ContextContributorContribution, PluginEventDefinitionContribution, PluginNotificationRuleContribution, UiEventSubscriptionContribution, DeviceDelegationContribution, SessionReaderContribution, UiCommandContribution, UiSlotContribution, SettingsPanelContribution, ResultRendererContribution, ReferenceOpenBehavior, ReferencePresentationVariant, ReferencePresentationVariants, ReferencePresentationUriPattern, ReferencePresentationUrlClaim, ReferencePresentationTooltip, ReferencePresentationContribution, RichViewContribution, KayUiAppHostCapability, UiAppCapabilities, UiRailEntryContribution, UiAppContribution, ThemeContribution, CommandHandler, CommandContribution, PluginContributionKind } = createContributionsSchemas(false);
 var canonicalContributionSchemas = createContributionsSchemas(true);
 
 // packages/plugin-protocol/dist/icon-shape.js
@@ -3725,7 +3745,7 @@ var KAY_UI_NATIVE_EVENT_SUBSCRIPTIONS = [
 var KAY_UI_NATIVE_EVENT_ALLOWLIST = new Set(KAY_UI_NATIVE_EVENT_SUBSCRIPTIONS);
 var RETIRED_COMPATIBILITY_KEYS = ["policy"];
 function createManifestSchemas(canonical) {
-  const { AgentRenderContribution: AgentRenderContribution2, ApprovalTypeContribution: ApprovalTypeContribution2, WorkflowContribution: WorkflowContribution2, AppDataMaterializerContribution: AppDataMaterializerContribution2, AppDataSourceContribution: AppDataSourceContribution2, AppUriModuleContribution: AppUriModuleContribution2, AppEventSubscription: AppEventSubscription2, ArtifactUriModuleContribution: ArtifactUriModuleContribution2, CliBindingContribution: CliBindingContribution2, CommandContribution: CommandContribution2, ContextContributorContribution: ContextContributorContribution2, ConverterContribution: ConverterContribution2, SessionReaderContribution: SessionReaderContribution2, DeviceDelegationContribution: DeviceDelegationContribution2, EndpointContribution: EndpointContribution2, EntityResolverContribution: EntityResolverContribution2, GitHostContribution: GitHostContribution2, McpServerContributions: McpServerContributions2, PluginEventDefinitionContribution: PluginEventDefinitionContribution2, PluginNotificationRuleContribution: PluginNotificationRuleContribution2, ResourceContribution: ResourceContribution2, ReferencePresentationContribution: ReferencePresentationContribution2, ResultRendererContribution: ResultRendererContribution2, RichViewContribution: RichViewContribution2, PluginSkillSourceDeclaration: PluginSkillSourceDeclaration2, InteractionDriverContribution: InteractionDriverContribution2, SearchProviderContribution: SearchProviderContribution2, SkillContribution: SkillContribution2, SettingsPanelContribution: SettingsPanelContribution2, ThemeContribution: ThemeContribution2, AgentToolContribution: AgentToolContribution2, ToolContribution: ToolContribution2, UiCommandContribution: UiCommandContribution2, UiAppContribution: UiAppContribution2, UiEventSubscriptionContribution: UiEventSubscriptionContribution2, UiSlotContribution: UiSlotContribution2, UriModuleContribution: UriModuleContribution2, WhiteboardTypeContribution: WhiteboardTypeContribution2 } = canonical ? canonicalContributionSchemas : contributions_exports;
+  const { AgentRenderContribution: AgentRenderContribution2, ApprovalTypeContribution: ApprovalTypeContribution2, WorkflowContribution: WorkflowContribution2, AppDataMaterializerContribution: AppDataMaterializerContribution2, AppDataSourceContribution: AppDataSourceContribution2, AppUriModuleContribution: AppUriModuleContribution2, AppEventSubscription: AppEventSubscription2, ArtifactUriModuleContribution: ArtifactUriModuleContribution2, CliBindingContribution: CliBindingContribution2, CommandContribution: CommandContribution2, ContextContributorContribution: ContextContributorContribution2, ConverterContribution: ConverterContribution2, SessionReaderContribution: SessionReaderContribution2, DeviceDelegationContribution: DeviceDelegationContribution2, EndpointContribution: EndpointContribution2, EntityResolverContribution: EntityResolverContribution2, GitHostContribution: GitHostContribution2, McpServerContributions: McpServerContributions2, PluginEventDefinitionContribution: PluginEventDefinitionContribution2, PluginNotificationRuleContribution: PluginNotificationRuleContribution2, ResourceContribution: ResourceContribution2, ReferencePresentationContribution: ReferencePresentationContribution2, ResultRendererContribution: ResultRendererContribution2, RichViewContribution: RichViewContribution2, PluginSkillSourceDeclaration: PluginSkillSourceDeclaration2, InteractionDriverContribution: InteractionDriverContribution2, SearchProviderContribution: SearchProviderContribution2, SkillContribution: SkillContribution2, SettingsPanelContribution: SettingsPanelContribution2, ThemeContribution: ThemeContribution2, AgentToolContribution: AgentToolContribution2, ToolContribution: ToolContribution2, UiCommandContribution: UiCommandContribution2, UiAppContribution: UiAppContribution2, UiRailEntryContribution: UiRailEntryContribution2, UiEventSubscriptionContribution: UiEventSubscriptionContribution2, UiSlotContribution: UiSlotContribution2, UriModuleContribution: UriModuleContribution2, WhiteboardTypeContribution: WhiteboardTypeContribution2 } = canonical ? canonicalContributionSchemas : contributions_exports;
   const { HttpsUrl: HttpsUrl2, LocalContributionId: LocalContributionId2, NonEmptyString: NonEmptyString3, PackageAssetPath: PackageAssetPath2, PluginId: PluginId2, PluginNamespace: PluginNamespace2, RegistrableDomain: RegistrableDomain2, SignedInStatusCode: SignedInStatusCode2, TargetEntrypoint: TargetEntrypoint2 } = canonical ? canonicalCommonSchemas : common_exports;
   const { PluginPermissionManifest: PluginPermissionManifest2 } = canonical ? canonicalPermissionSchemas : permissions_exports;
   const KayAgentTargetManifest2 = z13.strictObject({
@@ -3847,6 +3867,7 @@ function createManifestSchemas(canonical) {
       referencePresentations: z13.array(ReferencePresentationContribution2).optional(),
       views: z13.array(RichViewContribution2).optional(),
       apps: z13.array(UiAppContribution2).optional(),
+      railEntries: z13.array(UiRailEntryContribution2).optional(),
       themes: z13.array(ThemeContribution2).optional(),
       eventSubscriptions: z13.array(UiEventSubscriptionContribution2).optional(),
       dataMaterializers: z13.array(AppDataMaterializerContribution2).optional()
@@ -5052,7 +5073,7 @@ function boundPluginDiagnosticMessage(message) {
 import { z as z14 } from "zod";
 function createResolvedContractSchemas(canonical) {
   const { PluginEventLocalId: PluginEventLocalId2 } = canonical ? canonicalPluginEventSchemas : plugin_events_exports;
-  const { ApprovalTypeContribution: ApprovalTypeContribution2, KayUiAppHostCapability: KayUiAppHostCapability2, UiAppActivityRail: UiAppActivityRail2, McpServerAuthMode: McpServerAuthMode2, McpServerUrl: McpServerUrl2, PluginContributionKind: PluginContributionKindSchema, ReferenceOpenBehavior: ReferenceOpenBehavior2, ReferencePresentationUriPattern: ReferencePresentationUriPattern2, ReferencePresentationUrlClaim: ReferencePresentationUrlClaim2, ReferencePresentationVariants: ReferencePresentationVariants2, UriModuleFacts: UriModuleFacts2, WhiteboardTypeStorage: WhiteboardTypeStorage2 } = canonical ? canonicalContributionSchemas : contributions_exports;
+  const { ApprovalTypeContribution: ApprovalTypeContribution2, KayUiAppHostCapability: KayUiAppHostCapability2, McpServerAuthMode: McpServerAuthMode2, McpServerUrl: McpServerUrl2, PluginContributionKind: PluginContributionKindSchema, ReferenceOpenBehavior: ReferenceOpenBehavior2, ReferencePresentationUriPattern: ReferencePresentationUriPattern2, ReferencePresentationUrlClaim: ReferencePresentationUrlClaim2, ReferencePresentationVariants: ReferencePresentationVariants2, UriModuleFacts: UriModuleFacts2, WhiteboardTypeStorage: WhiteboardTypeStorage2 } = canonical ? canonicalContributionSchemas : contributions_exports;
   const { FileExtensionToken: FileExtensionToken2, GitBasicAuthUser: GitBasicAuthUser2, GitHostName: GitHostName2, GlobalContributionId: GlobalContributionId2, HttpsUrl: HttpsUrl2, LocalContributionId: LocalContributionId2, MimeTypeString: MimeTypeString2, NonEmptyString: NonEmptyString3, PackageAssetPath: PackageAssetPath2, PluginId: PluginId2, PluginNamespace: PluginNamespace2, PluginToolName: PluginToolName2, RegistrableDomain: RegistrableDomain2, SignedInStatusCode: SignedInStatusCode2, TargetEntrypoint: TargetEntrypoint2, UriScheme: UriScheme2 } = canonical ? canonicalCommonSchemas : common_exports;
   const { PluginExternalCliConnect: PluginExternalCliConnect2, PluginOAuthClientSupplier: PluginOAuthClientSupplier2 } = canonical ? canonicalManifestSchemas : manifest_exports;
   const { ResolvedPluginGrants: ResolvedPluginGrants2 } = canonical ? canonicalPermissionSchemas : permissions_exports;
@@ -5337,7 +5358,6 @@ function createResolvedContractSchemas(canonical) {
     globalId: GlobalContributionId2,
     displayName: NonEmptyString3,
     contextOnly: z14.literal(true).optional(),
-    activityRail: UiAppActivityRail2.optional(),
     description: NonEmptyString3.optional(),
     icon: PackageAssetPath2.optional(),
     runtime: z14.literal("kay.react-app.v1"),
@@ -5852,7 +5872,6 @@ function resolveKayPluginContractV1(manifest) {
     localId: app.localId,
     globalId: resolveGlobalContributionId(namespace, app.localId),
     ...app.contextOnly === void 0 ? {} : { contextOnly: app.contextOnly },
-    ...app.activityRail === void 0 ? {} : { activityRail: app.activityRail },
     displayName: app.displayName,
     ...app.description === void 0 ? {} : { description: app.description },
     ...app.icon === void 0 ? {} : { icon: app.icon },
@@ -6147,6 +6166,7 @@ function referencedPaths(manifest) {
       refs.push({ label: `kay.ui app '${app.localId}' icon`, path: app.icon });
     }
   }
+  refs.push(...declaredUiIconPaths(manifest));
   return refs;
 }
 function firstIssue(issues) {
@@ -6822,11 +6842,11 @@ export {
   ThemeContribution,
   ToolContribution,
   ToolPermission,
-  UiAppActivityRail,
   UiAppCapabilities,
   UiAppContribution,
   UiCommandContribution,
   UiEventSubscriptionContribution,
+  UiRailEntryContribution,
   UiSlotContribution,
   UriModuleContribution,
   UriScheme,
@@ -6855,6 +6875,7 @@ export {
   compareClaims,
   compareSemver,
   configSectionKeysForManifest,
+  declaredUiIconPaths,
   dedupeClaims,
   deriveDirectoryPluginToolName,
   finalizeArtifactProvenanceEnvelope,

package/package.json

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