@yaklabs-ai/plugin-protocol 0.39.0 → 0.40.0

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -2807,11 +2807,7 @@ declare const canonicalContributionSchemas: {
         "artifacts.read": "artifacts.read";
         "artifacts.preview": "artifacts.preview";
         "markdown.document-view": "markdown.document-view";
-        "cost.read": "cost.read";
         "billing.read": "billing.read";
-        "skills.read": "skills.read";
-        "memory.read": "memory.read";
-        "self-improvement.read": "self-improvement.read";
         "automations.read": "automations.read";
         "automations.run": "automations.run";
         "shared-artifacts.read": "shared-artifacts.read";
@@ -2827,11 +2823,7 @@ declare const canonicalContributionSchemas: {
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
-            "cost.read": "cost.read";
             "billing.read": "billing.read";
-            "skills.read": "skills.read";
-            "memory.read": "memory.read";
-            "self-improvement.read": "self-improvement.read";
             "automations.read": "automations.read";
             "automations.run": "automations.run";
             "shared-artifacts.read": "shared-artifacts.read";
@@ -2839,6 +2831,7 @@ declare const canonicalContributionSchemas: {
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>;
     UiRailEntryContribution: z.ZodObject<{
         id: z.ZodString;
@@ -2900,11 +2893,7 @@ declare const canonicalContributionSchemas: {
                 "artifacts.read": "artifacts.read";
                 "artifacts.preview": "artifacts.preview";
                 "markdown.document-view": "markdown.document-view";
-                "cost.read": "cost.read";
                 "billing.read": "billing.read";
-                "skills.read": "skills.read";
-                "memory.read": "memory.read";
-                "self-improvement.read": "self-improvement.read";
                 "automations.read": "automations.read";
                 "automations.run": "automations.run";
                 "shared-artifacts.read": "shared-artifacts.read";
@@ -2912,6 +2901,7 @@ declare const canonicalContributionSchemas: {
                 "workspace.pane-header": "workspace.pane-header";
                 "workspace.arrange": "workspace.arrange";
             }>>>;
+            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
     }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
         localId: z.ZodString;
@@ -2937,11 +2927,7 @@ declare const canonicalContributionSchemas: {
                 "artifacts.read": "artifacts.read";
                 "artifacts.preview": "artifacts.preview";
                 "markdown.document-view": "markdown.document-view";
-                "cost.read": "cost.read";
                 "billing.read": "billing.read";
-                "skills.read": "skills.read";
-                "memory.read": "memory.read";
-                "self-improvement.read": "self-improvement.read";
                 "automations.read": "automations.read";
                 "automations.run": "automations.run";
                 "shared-artifacts.read": "shared-artifacts.read";
@@ -2949,6 +2935,7 @@ declare const canonicalContributionSchemas: {
                 "workspace.pane-header": "workspace.pane-header";
                 "workspace.arrange": "workspace.arrange";
             }>>>;
+            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
     }, z.core.$strict>, unknown>;
     ThemeContribution: z.ZodObject<{
@@ -4243,8 +4230,14 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.39.0 lets a plugin word its own addresses (#15750). A reference presentation gains `words`, and
  * `open` and `resourceKind` become an optional pair, so a module can name its rows, tallies and live
  * phrases without its addresses opening. Additive. A plugin that declares words declares ^0.39.0.
+ *
+ * 0.40.0 lets a `kay.ui` app list the feeds it reads (#15909). `capabilities.feeds` names each one,
+ * resolved at load to the plugin's own feed by that name or otherwise the daemon's, and a session
+ * feed may now declare a `store`. It removes the `cost.read`, `skills.read`, `memory.read` and
+ * `self-improvement.read` host capabilities, so a manifest still listing one no longer parses and
+ * lists the feed instead. A plugin that lists feeds declares ^0.40.0.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.39.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.40.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5844,11 +5837,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "artifacts.read": "artifacts.read";
                                 "artifacts.preview": "artifacts.preview";
                                 "markdown.document-view": "markdown.document-view";
-                                "cost.read": "cost.read";
                                 "billing.read": "billing.read";
-                                "skills.read": "skills.read";
-                                "memory.read": "memory.read";
-                                "self-improvement.read": "self-improvement.read";
                                 "automations.read": "automations.read";
                                 "automations.run": "automations.run";
                                 "shared-artifacts.read": "shared-artifacts.read";
@@ -5856,6 +5845,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "workspace.pane-header": "workspace.pane-header";
                                 "workspace.arrange": "workspace.arrange";
                             }>>>;
+                            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         }, z.core.$strict>>;
                     }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
                         localId: z.ZodString;
@@ -5881,11 +5871,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "artifacts.read": "artifacts.read";
                                 "artifacts.preview": "artifacts.preview";
                                 "markdown.document-view": "markdown.document-view";
-                                "cost.read": "cost.read";
                                 "billing.read": "billing.read";
-                                "skills.read": "skills.read";
-                                "memory.read": "memory.read";
-                                "self-improvement.read": "self-improvement.read";
                                 "automations.read": "automations.read";
                                 "automations.run": "automations.run";
                                 "shared-artifacts.read": "shared-artifacts.read";
@@ -5893,6 +5879,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "workspace.pane-header": "workspace.pane-header";
                                 "workspace.arrange": "workspace.arrange";
                             }>>>;
+                            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         }, z.core.$strict>>;
                     }, z.core.$strict>, unknown>>>;
                     railEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -6752,11 +6739,7 @@ export declare const KayUiAppHostCapability: z.ZodEnum<{
     "artifacts.read": "artifacts.read";
     "artifacts.preview": "artifacts.preview";
     "markdown.document-view": "markdown.document-view";
-    "cost.read": "cost.read";
     "billing.read": "billing.read";
-    "skills.read": "skills.read";
-    "memory.read": "memory.read";
-    "self-improvement.read": "self-improvement.read";
     "automations.read": "automations.read";
     "automations.run": "automations.run";
     "shared-artifacts.read": "shared-artifacts.read";
@@ -7008,11 +6991,7 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "artifacts.read": "artifacts.read";
                     "artifacts.preview": "artifacts.preview";
                     "markdown.document-view": "markdown.document-view";
-                    "cost.read": "cost.read";
                     "billing.read": "billing.read";
-                    "skills.read": "skills.read";
-                    "memory.read": "memory.read";
-                    "self-improvement.read": "self-improvement.read";
                     "automations.read": "automations.read";
                     "automations.run": "automations.run";
                     "shared-artifacts.read": "shared-artifacts.read";
@@ -7020,6 +6999,7 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "workspace.pane-header": "workspace.pane-header";
                     "workspace.arrange": "workspace.arrange";
                 }>>>;
+                feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
         }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
             localId: z.ZodString;
@@ -7045,11 +7025,7 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "artifacts.read": "artifacts.read";
                     "artifacts.preview": "artifacts.preview";
                     "markdown.document-view": "markdown.document-view";
-                    "cost.read": "cost.read";
                     "billing.read": "billing.read";
-                    "skills.read": "skills.read";
-                    "memory.read": "memory.read";
-                    "self-improvement.read": "self-improvement.read";
                     "automations.read": "automations.read";
                     "automations.run": "automations.run";
                     "shared-artifacts.read": "shared-artifacts.read";
@@ -7057,6 +7033,7 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "workspace.pane-header": "workspace.pane-header";
                     "workspace.arrange": "workspace.arrange";
                 }>>>;
+                feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
         }, z.core.$strict>, unknown>>>;
         railEntries: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -11382,11 +11359,7 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
-            "cost.read": "cost.read";
             "billing.read": "billing.read";
-            "skills.read": "skills.read";
-            "memory.read": "memory.read";
-            "self-improvement.read": "self-improvement.read";
             "automations.read": "automations.read";
             "automations.run": "automations.run";
             "shared-artifacts.read": "shared-artifacts.read";
@@ -11394,6 +11367,7 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 
@@ -12720,11 +12694,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 "artifacts.read": "artifacts.read";
                 "artifacts.preview": "artifacts.preview";
                 "markdown.document-view": "markdown.document-view";
-                "cost.read": "cost.read";
                 "billing.read": "billing.read";
-                "skills.read": "skills.read";
-                "memory.read": "memory.read";
-                "self-improvement.read": "self-improvement.read";
                 "automations.read": "automations.read";
                 "automations.run": "automations.run";
                 "shared-artifacts.read": "shared-artifacts.read";
@@ -12732,6 +12702,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 "workspace.pane-header": "workspace.pane-header";
                 "workspace.arrange": "workspace.arrange";
             }>>>;
+            feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
@@ -14359,11 +14330,7 @@ export declare const UiAppCapabilities: z.ZodObject<{
         "artifacts.read": "artifacts.read";
         "artifacts.preview": "artifacts.preview";
         "markdown.document-view": "markdown.document-view";
-        "cost.read": "cost.read";
         "billing.read": "billing.read";
-        "skills.read": "skills.read";
-        "memory.read": "memory.read";
-        "self-improvement.read": "self-improvement.read";
         "automations.read": "automations.read";
         "automations.run": "automations.run";
         "shared-artifacts.read": "shared-artifacts.read";
@@ -14371,6 +14338,7 @@ export declare const UiAppCapabilities: z.ZodObject<{
         "workspace.pane-header": "workspace.pane-header";
         "workspace.arrange": "workspace.arrange";
     }>>>;
+    feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 
 export declare type UiAppCapabilities = z.infer<typeof UiAppCapabilities>;
@@ -14399,11 +14367,7 @@ export declare const UiAppContribution: z.ZodObject<{
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
-            "cost.read": "cost.read";
             "billing.read": "billing.read";
-            "skills.read": "skills.read";
-            "memory.read": "memory.read";
-            "self-improvement.read": "self-improvement.read";
             "automations.read": "automations.read";
             "automations.run": "automations.run";
             "shared-artifacts.read": "shared-artifacts.read";
@@ -14411,6 +14375,7 @@ export declare const UiAppContribution: z.ZodObject<{
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
 }, z.core.$strict> | z.ZodPreprocess<z.ZodObject<{
     localId: z.ZodString;
@@ -14436,11 +14401,7 @@ export declare const UiAppContribution: z.ZodObject<{
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
-            "cost.read": "cost.read";
             "billing.read": "billing.read";
-            "skills.read": "skills.read";
-            "memory.read": "memory.read";
-            "self-improvement.read": "self-improvement.read";
             "automations.read": "automations.read";
             "automations.run": "automations.run";
             "shared-artifacts.read": "shared-artifacts.read";
@@ -14448,6 +14409,7 @@ export declare const UiAppContribution: z.ZodObject<{
             "workspace.pane-header": "workspace.pane-header";
             "workspace.arrange": "workspace.arrange";
         }>>>;
+        feeds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
 }, z.core.$strict>, unknown>;
 

package/dist/index.js

@@ -254,7 +254,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.39.0";
+var KAY_PLUGIN_SDK_VERSION = "0.40.0";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.26.3",
   "0.27.1",
@@ -268,7 +268,8 @@ var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.35.0",
   "0.36.0",
   "0.37.1",
-  "0.38.0"
+  "0.38.0",
+  "0.39.0"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -3460,13 +3461,6 @@ function createContributionsSchemas(canonical) {
     }
     if (source.store === void 0)
       return;
-    if (source.scope === "session") {
-      ctx.addIssue({
-        code: "custom",
-        path: ["store"],
-        message: "A declared app-data store requires runtime or account scope."
-      });
-    }
     const replaces = source.change.semantics?.kind === "snapshot-replacement";
     if (replaces !== (source.store.shape === "value")) {
       ctx.addIssue({
@@ -3958,15 +3952,8 @@ 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",
-    "cost.read",
     // Server-rated organization billing, distinct from local/provider cost.
     "billing.read",
-    // Skills and Memory analytics reads (full snapshots via the capability broker).
-    "skills.read",
-    "memory.read",
-    // The self-improvement lens: reads the telemetry lane's self-improvement rollup
-    // (memory/skill/notebook activity). Follows the same "names the data" convention.
-    "self-improvement.read",
     "automations.read",
     "automations.run",
     // Lists the shared artifacts the signed-in account may open and opens one in Bonsai's shared
@@ -3989,9 +3976,12 @@ function createContributionsSchemas(canonical) {
   ]);
   const UiAppCapabilities2 = z12.strictObject({
     endpoints: z12.array(LocalContributionId2).optional(),
-    host: z12.array(KayUiAppHostCapability2).optional()
+    host: z12.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: z12.array(LocalContributionId2).optional()
   }).superRefine((capabilities, ctx) => {
-    for (const field of ["endpoints", "host"]) {
+    for (const field of ["endpoints", "host", "feeds"]) {
       const seen = /* @__PURE__ */ new Set();
       for (const [index, value] of (capabilities[field] ?? []).entries()) {
         if (seen.has(value)) {
@@ -4870,7 +4860,7 @@ function createManifestSchemas(canonical) {
       }
       materializedAppDataSources.add(materializer.source);
     }
-    const declaredRowsStores = new Set(manifest.targets?.kay?.app?.contributes?.dataSources?.filter((source) => source.store?.shape === "rows").map((source) => source.localId) ?? []);
+    const declaredRowsStores = new Set(manifest.targets?.kay?.app?.contributes?.dataSources?.filter((source) => source.store?.shape === "rows" && source.scope !== "session").map((source) => source.localId) ?? []);
     for (const [index, entry] of (manifest.targets?.kay?.ui?.contributes?.railEntries ?? []).entries()) {
       if (entry.badge === void 0)
         continue;
@@ -6054,7 +6044,8 @@ function createResolvedContractSchemas(canonical) {
     assets: z14.array(PackageAssetPath2).optional(),
     capabilities: z14.strictObject({
       endpoints: z14.array(ResolvedKayUiAppEndpointCapability2).optional(),
-      host: z14.array(KayUiAppHostCapability2).optional()
+      host: z14.array(KayUiAppHostCapability2).optional(),
+      feeds: z14.array(LocalContributionId2).optional()
     }).optional()
   });
   const ResolvedPluginContractV12 = z14.strictObject({
@@ -6583,7 +6574,8 @@ function resolveKayPluginContractV1(manifest) {
             globalId: resolveGlobalContributionId(namespace, endpoint)
           }))
         },
-        ...app.capabilities.host === void 0 ? {} : { host: [...app.capabilities.host] }
+        ...app.capabilities.host === void 0 ? {} : { host: [...app.capabilities.host] },
+        ...app.capabilities.feeds === void 0 ? {} : { feeds: [...app.capabilities.feeds] }
       }
     }
   }));

package/package.json

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