@yaklabs-ai/plugin-protocol 0.52.0 → 0.52.1

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -1837,6 +1837,7 @@ declare namespace authoringContributionSchemas {
         ReferencePresentationWords,
         ReferencePresentationContribution,
         KayUiAppHostCapability,
+        UiAppCapabilityReference,
         UiAppCapabilities,
         UiRailEntryContribution,
         UiToastPreviewContribution,
@@ -3222,8 +3223,15 @@ declare const canonicalContributionSchemas: {
         "workspace.pane-header": "workspace.pane-header";
         "workspace.arrange": "workspace.arrange";
     }>;
+    UiAppCapabilityReference: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        pluginId: z.ZodString;
+        localId: z.ZodString;
+    }, z.core.$strict>]>;
     UiAppCapabilities: z.ZodObject<{
-        endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
         host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             "navigation.open-session": "navigation.open-session";
             "sessions.create": "sessions.create";
@@ -3241,7 +3249,10 @@ declare const canonicalContributionSchemas: {
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
-        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
     }, z.core.$strict>;
     UiRailEntryContribution: z.ZodObject<{
         id: z.ZodString;
@@ -3302,7 +3313,10 @@ declare const canonicalContributionSchemas: {
         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>>;
+            endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>>>;
             host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 "navigation.open-session": "navigation.open-session";
                 "sessions.create": "sessions.create";
@@ -3320,7 +3334,10 @@ declare const canonicalContributionSchemas: {
                 "workspace.pane-header": "workspace.pane-header";
                 "workspace.arrange": "workspace.arrange";
             }>>>;
-            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>>>;
         }, z.core.$strict>>;
     }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
         localId: z.ZodString;
@@ -3339,7 +3356,10 @@ declare const canonicalContributionSchemas: {
         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>>;
+            endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>>>;
             host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 "navigation.open-session": "navigation.open-session";
                 "sessions.create": "sessions.create";
@@ -3357,7 +3377,10 @@ declare const canonicalContributionSchemas: {
                 "workspace.pane-header": "workspace.pane-header";
                 "workspace.arrange": "workspace.arrange";
             }>>>;
-            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>, unknown>;
     ThemeContribution: z.ZodObject<{
@@ -4790,8 +4813,12 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * contract remains served.
  *
  * 0.51.0 adds flag-dependent title, icon and panel presence on rail entries.
+ *
+ * 0.52.0 adds plugin-owned operational facts through existing manifests and registrations.
+ *
+ * 0.52.1 adds owner-qualified page feed and endpoint references and their kay.ui claims.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.52.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.52.1";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -6696,7 +6723,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         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>>;
+                            endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                pluginId: z.ZodString;
+                                localId: z.ZodString;
+                            }, z.core.$strict>]>>>;
                             host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                                 "navigation.open-session": "navigation.open-session";
                                 "sessions.create": "sessions.create";
@@ -6714,7 +6744,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "workspace.pane-header": "workspace.pane-header";
                                 "workspace.arrange": "workspace.arrange";
                             }>>>;
-                            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                pluginId: z.ZodString;
+                                localId: z.ZodString;
+                            }, z.core.$strict>]>>>;
                         }, z.core.$strict>>;
                     }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
                         localId: z.ZodString;
@@ -6733,7 +6766,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         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>>;
+                            endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                pluginId: z.ZodString;
+                                localId: z.ZodString;
+                            }, z.core.$strict>]>>>;
                             host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                                 "navigation.open-session": "navigation.open-session";
                                 "sessions.create": "sessions.create";
@@ -6751,7 +6787,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "workspace.pane-header": "workspace.pane-header";
                                 "workspace.arrange": "workspace.arrange";
                             }>>>;
-                            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                pluginId: z.ZodString;
+                                localId: z.ZodString;
+                            }, z.core.$strict>]>>>;
                         }, z.core.$strict>>;
                     }, z.core.$strict>, unknown>>>;
                     railEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -8002,7 +8041,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
             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>>;
+                endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    pluginId: z.ZodString;
+                    localId: z.ZodString;
+                }, z.core.$strict>]>>>;
                 host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                     "navigation.open-session": "navigation.open-session";
                     "sessions.create": "sessions.create";
@@ -8020,7 +8062,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "workspace.pane-header": "workspace.pane-header";
                     "workspace.arrange": "workspace.arrange";
                 }>>>;
-                feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    pluginId: z.ZodString;
+                    localId: z.ZodString;
+                }, z.core.$strict>]>>>;
             }, z.core.$strict>>;
         }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
             localId: z.ZodString;
@@ -8039,7 +8084,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
             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>>;
+                endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    pluginId: z.ZodString;
+                    localId: z.ZodString;
+                }, z.core.$strict>]>>>;
                 host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                     "navigation.open-session": "navigation.open-session";
                     "sessions.create": "sessions.create";
@@ -8057,7 +8105,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "workspace.pane-header": "workspace.pane-header";
                     "workspace.arrange": "workspace.arrange";
                 }>>>;
-                feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    pluginId: z.ZodString;
+                    localId: z.ZodString;
+                }, z.core.$strict>]>>>;
             }, z.core.$strict>>;
         }, z.core.$strict>, unknown>>>;
         railEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -8317,7 +8368,7 @@ export declare function parseSemver(value: string): ParsedSemver | undefined;
 export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
 
 /** Every capability slug {@link PluginCapabilityClaimV1} can express, for exhaustive table checks. */
-export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "uri.call", "endpoints.invoke", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "sessions.annotate", "sessions.compact", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
+export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "uri.call", "endpoints.invoke", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "sessions.annotate", "sessions.compact", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "app-data.read", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
 
 /** Diagnostic messages carry plugin-controlled text (parse errors, module errors); bound it so a
  *  hostile or accidental multi-megabyte error can never blow up a log line or a render surface. */
@@ -8982,7 +9033,7 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
         verb: "search" | "read" | "list" | "write" | "edit" | "delete";
     };
 } | {
-    target: "kay.agent" | "kay.app";
+    target: "kay.agent" | "kay.app" | "kay.ui";
     slug: "endpoints.invoke";
     envelope: {
         pluginId: string;
@@ -9070,6 +9121,13 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     envelope: {
         contributor: string;
     };
+} | {
+    target: "kay.ui";
+    slug: "app-data.read";
+    envelope: {
+        pluginId: string;
+        sourceId: string;
+    };
 } | {
     target: "kay.app";
     slug: "app-data.register";
@@ -9249,7 +9307,7 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
         verb: "search" | "read" | "list" | "write" | "edit" | "delete";
     };
 } | {
-    target: "kay.agent" | "kay.app";
+    target: "kay.agent" | "kay.app" | "kay.ui";
     slug: "endpoints.invoke";
     envelope: {
         pluginId: string;
@@ -9337,6 +9395,13 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     envelope: {
         contributor: string;
     };
+} | {
+    target: "kay.ui";
+    slug: "app-data.read";
+    envelope: {
+        pluginId: string;
+        sourceId: string;
+    };
 } | {
     target: "kay.app";
     slug: "app-data.register";
@@ -9525,6 +9590,7 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
     target: z.ZodEnum<{
         "kay.agent": "kay.agent";
         "kay.app": "kay.app";
+        "kay.ui": "kay.ui";
     }>;
     slug: z.ZodLiteral<"endpoints.invoke">;
     envelope: z.ZodObject<{
@@ -9613,6 +9679,13 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
     envelope: z.ZodObject<{
         contributor: z.ZodString;
     }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    target: z.ZodLiteral<"kay.ui">;
+    slug: z.ZodLiteral<"app-data.read">;
+    envelope: z.ZodObject<{
+        pluginId: z.ZodString;
+        sourceId: z.ZodString;
+    }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     target: z.ZodLiteral<"kay.app">;
     slug: z.ZodLiteral<"app-data.register">;
@@ -9847,6 +9920,7 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
         target: z.ZodEnum<{
             "kay.agent": "kay.agent";
             "kay.app": "kay.app";
+            "kay.ui": "kay.ui";
         }>;
         slug: z.ZodLiteral<"endpoints.invoke">;
         envelope: z.ZodObject<{
@@ -9935,6 +10009,13 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
         envelope: z.ZodObject<{
             contributor: z.ZodString;
         }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.ui">;
+        slug: z.ZodLiteral<"app-data.read">;
+        envelope: z.ZodObject<{
+            pluginId: z.ZodString;
+            sourceId: z.ZodString;
+        }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"app-data.register">;
@@ -10168,6 +10249,7 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
             target: z.ZodEnum<{
                 "kay.agent": "kay.agent";
                 "kay.app": "kay.app";
+                "kay.ui": "kay.ui";
             }>;
             slug: z.ZodLiteral<"endpoints.invoke">;
             envelope: z.ZodObject<{
@@ -10256,6 +10338,13 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
             envelope: z.ZodObject<{
                 contributor: z.ZodString;
             }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            target: z.ZodLiteral<"kay.ui">;
+            slug: z.ZodLiteral<"app-data.read">;
+            envelope: z.ZodObject<{
+                pluginId: z.ZodString;
+                sourceId: z.ZodString;
+            }, z.core.$strict>;
         }, z.core.$strict>, z.ZodObject<{
             target: z.ZodLiteral<"kay.app">;
             slug: z.ZodLiteral<"app-data.register">;
@@ -10523,6 +10612,7 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
         target: z.ZodEnum<{
             "kay.agent": "kay.agent";
             "kay.app": "kay.app";
+            "kay.ui": "kay.ui";
         }>;
         slug: z.ZodLiteral<"endpoints.invoke">;
         envelope: z.ZodObject<{
@@ -10611,6 +10701,13 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
         envelope: z.ZodObject<{
             contributor: z.ZodString;
         }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.ui">;
+        slug: z.ZodLiteral<"app-data.read">;
+        envelope: z.ZodObject<{
+            pluginId: z.ZodString;
+            sourceId: z.ZodString;
+        }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"app-data.register">;
@@ -13049,10 +13146,13 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
     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.ZodObject<{
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             localId: z.ZodString;
             globalId: z.ZodString;
-        }, z.core.$strict>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
         host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             "navigation.open-session": "navigation.open-session";
             "sessions.create": "sessions.create";
@@ -13070,16 +13170,22 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
-        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type ResolvedKayUiApp = z.infer<typeof ResolvedKayUiApp>;
 
-export declare const ResolvedKayUiAppEndpointCapability: z.ZodObject<{
+export declare const ResolvedKayUiAppEndpointCapability: z.ZodUnion<readonly [z.ZodObject<{
     localId: z.ZodString;
     globalId: z.ZodString;
-}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    pluginId: z.ZodString;
+    localId: z.ZodString;
+}, z.core.$strict>]>;
 
 export declare type ResolvedKayUiAppEndpointCapability = z.infer<typeof ResolvedKayUiAppEndpointCapability>;
 
@@ -14681,10 +14787,13 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         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.ZodObject<{
+            endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
                 localId: z.ZodString;
                 globalId: z.ZodString;
-            }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>>>;
             host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 "navigation.open-session": "navigation.open-session";
                 "sessions.create": "sessions.create";
@@ -14702,7 +14811,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 "workspace.pane-header": "workspace.pane-header";
                 "workspace.arrange": "workspace.arrange";
             }>>>;
-            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
@@ -16559,7 +16671,10 @@ export declare interface TurnPacketMessage {
 }
 
 export declare const UiAppCapabilities: z.ZodObject<{
-    endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        pluginId: z.ZodString;
+        localId: z.ZodString;
+    }, z.core.$strict>]>>>;
     host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         "navigation.open-session": "navigation.open-session";
         "sessions.create": "sessions.create";
@@ -16577,11 +16692,21 @@ export declare const UiAppCapabilities: z.ZodObject<{
         "workspace.pane-header": "workspace.pane-header";
         "workspace.arrange": "workspace.arrange";
     }>>>;
-    feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        pluginId: z.ZodString;
+        localId: z.ZodString;
+    }, z.core.$strict>]>>>;
 }, z.core.$strict>;
 
 export declare type UiAppCapabilities = z.infer<typeof UiAppCapabilities>;
 
+export declare const UiAppCapabilityReference: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    pluginId: z.ZodString;
+    localId: z.ZodString;
+}, z.core.$strict>]>;
+
+export declare type UiAppCapabilityReference = z.infer<typeof UiAppCapabilityReference>;
+
 export declare const UiAppContribution: z.ZodObject<{
     localId: z.ZodString;
     displayName: z.ZodString;
@@ -16599,7 +16724,10 @@ export declare const UiAppContribution: z.ZodObject<{
     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>>;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
         host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             "navigation.open-session": "navigation.open-session";
             "sessions.create": "sessions.create";
@@ -16617,7 +16745,10 @@ export declare const UiAppContribution: z.ZodObject<{
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
-        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
     }, z.core.$strict>>;
 }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
     localId: z.ZodString;
@@ -16636,7 +16767,10 @@ export declare const UiAppContribution: z.ZodObject<{
     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>>;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
         host: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             "navigation.open-session": "navigation.open-session";
             "sessions.create": "sessions.create";
@@ -16654,7 +16788,10 @@ export declare const UiAppContribution: z.ZodObject<{
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
-        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>>>;
     }, z.core.$strict>>;
 }, z.core.$strict>, unknown>;
 

package/dist/index.js

@@ -266,8 +266,9 @@ 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.52.0";
+var KAY_PLUGIN_SDK_VERSION = "0.52.1";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.52.0",
   "0.51.0",
   "0.50.0",
   "0.49.0"
@@ -1822,6 +1823,7 @@ var PLUGIN_CAPABILITY_SLUGS = [
   "agents.run",
   "dynamic-context.register",
   "app-data.register",
+  "app-data.read",
   "knowledge-source.register",
   "artifacts.read",
   "session-artifacts.read",
@@ -1965,7 +1967,7 @@ function createAuthoritySchemas(canonical) {
       })
     }),
     z11.strictObject({
-      target: z11.enum(["kay.agent", "kay.app"]),
+      target: z11.enum(["kay.agent", "kay.app", "kay.ui"]),
       slug: z11.literal("endpoints.invoke"),
       envelope: z11.strictObject({
         pluginId: PluginId2,
@@ -2108,6 +2110,14 @@ function createAuthoritySchemas(canonical) {
       // section tag at the model boundary - so the row a human consents to names the section.
       envelope: z11.strictObject({ contributor: NonEmptyString3 })
     }),
+    z11.strictObject({
+      target: z11.literal("kay.ui"),
+      slug: z11.literal("app-data.read"),
+      envelope: z11.strictObject({
+        pluginId: PluginId2,
+        sourceId: LocalContributionId2
+      })
+    }),
     z11.strictObject({
       target: z11.literal("kay.app"),
       slug: z11.literal("app-data.register"),
@@ -2361,6 +2371,8 @@ function sameClaim(a, b) {
       return b.slug === a.slug && a.envelope.kind === b.envelope.kind;
     case "knowledge-source.register":
       return b.slug === "knowledge-source.register" && a.envelope.source === b.envelope.source;
+    case "app-data.read":
+      return b.slug === "app-data.read" && a.envelope.pluginId === b.envelope.pluginId && a.envelope.sourceId === b.envelope.sourceId;
     case "app-data.register":
       return b.slug === "app-data.register" && a.envelope.source === b.envelope.source;
     case "agents.permissions":
@@ -2462,6 +2474,11 @@ function envelopePairs(a, b) {
       return b.slug === a.slug ? [[a.envelope.kind, b.envelope.kind]] : [];
     case "knowledge-source.register":
       return b.slug === "knowledge-source.register" ? [[a.envelope.source, b.envelope.source]] : [];
+    case "app-data.read":
+      return b.slug === "app-data.read" ? [
+        [a.envelope.pluginId, b.envelope.pluginId],
+        [a.envelope.sourceId, b.envelope.sourceId]
+      ] : [];
     case "app-data.register":
       return b.slug === "app-data.register" ? [[a.envelope.source, b.envelope.source]] : [];
     case "agents.permissions":
@@ -2864,6 +2881,7 @@ __export(contributions_exports, {
   ToolContribution: () => ToolContribution,
   ToolPermission: () => ToolPermission,
   UiAppCapabilities: () => UiAppCapabilities,
+  UiAppCapabilityReference: () => UiAppCapabilityReference,
   UiAppContribution: () => UiAppContribution,
   UiCommandContribution: () => UiCommandContribution,
   UiEventSubscriptionContribution: () => UiEventSubscriptionContribution,
@@ -4349,24 +4367,29 @@ function createContributionsSchemas(canonical) {
     // rearrange the workspace but never remove something the user would have to notice going missing.
     "workspace.arrange"
   ]);
+  const UiAppCapabilityReference2 = z13.union([
+    LocalContributionId2,
+    z13.strictObject({ pluginId: PluginId2, localId: LocalContributionId2 })
+  ]);
   const UiAppCapabilities2 = z13.strictObject({
-    endpoints: z13.array(LocalContributionId2).optional(),
+    endpoints: z13.array(UiAppCapabilityReference2).optional(),
     host: z13.array(KayUiAppHostCapability2).optional(),
-    // The feeds this app's pages read with `useBonsaiFeed`. A name means this plugin's own
-    // `kay.app` data source if it declares one, otherwise the feed the daemon publishes.
-    feeds: z13.array(LocalContributionId2).optional()
+    // A local name selects this plugin's source first, otherwise the daemon's.
+    // An explicit reference selects only the named plugin.
+    feeds: z13.array(UiAppCapabilityReference2).optional()
   }).superRefine((capabilities, ctx) => {
     for (const field of ["endpoints", "host", "feeds"]) {
       const seen = /* @__PURE__ */ new Set();
       for (const [index, value] of (capabilities[field] ?? []).entries()) {
-        if (seen.has(value)) {
+        const key = typeof value === "string" ? value : JSON.stringify([value.pluginId, value.localId]);
+        if (seen.has(key)) {
           ctx.addIssue({
             code: "custom",
             path: [field, index],
-            message: `duplicate ui app ${field} capability ${value}`
+            message: `duplicate ui app ${field} capability ${key}`
           });
         }
-        seen.add(value);
+        seen.add(key);
       }
     }
   });
@@ -4558,6 +4581,7 @@ function createContributionsSchemas(canonical) {
     ReferencePresentationWords: ReferencePresentationWords2,
     ReferencePresentationContribution: ReferencePresentationContribution2,
     KayUiAppHostCapability: KayUiAppHostCapability2,
+    UiAppCapabilityReference: UiAppCapabilityReference2,
     UiAppCapabilities: UiAppCapabilities2,
     UiRailEntryContribution: UiRailEntryContribution2,
     UiToastPreviewContribution: UiToastPreviewContribution2,
@@ -4569,7 +4593,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, PluginCardContribution, WorkflowContribution, McpServerUrl, McpServerAuthMode, McpServerContribution, McpServerContributions, AppEventSubscription, ContextContributorContribution, PluginEventDefinitionContribution, PluginNotificationRuleContribution, PluginProductEventContribution, UiEventSubscriptionContribution, DeviceDelegationContribution, SessionReaderContribution, UiCommandContribution, UiSlotContribution, ReferenceOpenBehavior, ReferencePresentationVariant, ReferencePresentationVariants, ReferencePresentationUriPattern, ReferencePresentationUrlClaim, ReferencePresentationTooltip, ReferencePresentationAddress, ReferencePresentationAccountLinks, ReferencePresentationWords, ReferencePresentationContribution, KayUiAppHostCapability, UiAppCapabilities, UiRailEntryContribution, UiToastPreviewContribution, UiPageContribution, 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, PluginCardContribution, WorkflowContribution, McpServerUrl, McpServerAuthMode, McpServerContribution, McpServerContributions, AppEventSubscription, ContextContributorContribution, PluginEventDefinitionContribution, PluginNotificationRuleContribution, PluginProductEventContribution, UiEventSubscriptionContribution, DeviceDelegationContribution, SessionReaderContribution, UiCommandContribution, UiSlotContribution, ReferenceOpenBehavior, ReferencePresentationVariant, ReferencePresentationVariants, ReferencePresentationUriPattern, ReferencePresentationUrlClaim, ReferencePresentationTooltip, ReferencePresentationAddress, ReferencePresentationAccountLinks, ReferencePresentationWords, ReferencePresentationContribution, KayUiAppHostCapability, UiAppCapabilityReference, UiAppCapabilities, UiRailEntryContribution, UiToastPreviewContribution, UiPageContribution, UiAppContribution, ThemeContribution, CommandHandler, CommandContribution, PluginContributionKind } = createContributionsSchemas(false);
 var canonicalContributionSchemas = createContributionsSchemas(true);
 var UI_APP_SOURCE_MODULE = /\.(?:tsx|ts|jsx)$/;
 function isUiAppSourceModule(module) {
@@ -6007,6 +6031,8 @@ function createManifestSchemas(canonical) {
           "endpoints",
           endpointIndex
         ];
+        if (typeof endpoint !== "string")
+          continue;
         if (!endpointIds.has(endpoint)) {
           ctx.addIssue({
             code: "custom",
@@ -6636,10 +6662,13 @@ function createResolvedContractSchemas(canonical) {
     /** The service's browser half, when the manifest declares one. */
     webSession: ResolvedPluginWebSession2.optional()
   });
-  const ResolvedKayUiAppEndpointCapability2 = z17.strictObject({
-    localId: LocalContributionId2,
-    globalId: GlobalContributionId2
-  });
+  const ResolvedKayUiAppEndpointCapability2 = z17.union([
+    z17.strictObject({
+      localId: LocalContributionId2,
+      globalId: GlobalContributionId2
+    }),
+    z17.strictObject({ pluginId: PluginId2, localId: LocalContributionId2 })
+  ]);
   const ResolvedKayUiApp2 = z17.strictObject({
     localId: LocalContributionId2,
     globalId: GlobalContributionId2,
@@ -6655,7 +6684,7 @@ function createResolvedContractSchemas(canonical) {
     capabilities: z17.strictObject({
       endpoints: z17.array(ResolvedKayUiAppEndpointCapability2).optional(),
       host: z17.array(KayUiAppHostCapability2).optional(),
-      feeds: z17.array(LocalContributionId2).optional()
+      feeds: z17.array((canonical ? canonicalContributionSchemas : contributions_exports).UiAppCapabilityReference).optional()
     }).optional()
   });
   const ResolvedPluginContractV12 = z17.strictObject({
@@ -7208,10 +7237,10 @@ function resolveKayPluginContractV1(manifest) {
     ...app.capabilities === void 0 ? {} : {
       capabilities: {
         ...app.capabilities.endpoints === void 0 ? {} : {
-          endpoints: app.capabilities.endpoints.map((endpoint) => ({
+          endpoints: app.capabilities.endpoints.map((endpoint) => typeof endpoint === "string" ? {
             localId: endpoint,
             globalId: resolveGlobalContributionId(namespace, endpoint)
-          }))
+          } : endpoint)
         },
         ...app.capabilities.host === void 0 ? {} : { host: [...app.capabilities.host] },
         ...app.capabilities.feeds === void 0 ? {} : { feeds: [...app.capabilities.feeds] }
@@ -8288,6 +8317,7 @@ export {
   ToolContribution,
   ToolPermission,
   UiAppCapabilities,
+  UiAppCapabilityReference,
   UiAppContribution,
   UiCommandContribution,
   UiEventSubscriptionContribution,

package/package.json

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