@yaklabs-ai/plugin-protocol 0.54.0 → 0.54.1

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -3305,7 +3305,10 @@ declare const canonicalContributionSchemas: {
             plugins: "plugins";
         }>>;
         badge: z.ZodOptional<z.ZodObject<{
-            source: z.ZodString;
+            source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                pluginId: z.ZodString;
+                localId: z.ZodString;
+            }, z.core.$strict>]>;
             where: z.ZodOptional<z.ZodString>;
             label: z.ZodObject<{
                 one: z.ZodOptional<z.ZodString>;
@@ -3315,11 +3318,9 @@ declare const canonicalContributionSchemas: {
         panel: z.ZodOptional<z.ZodObject<{
             body: z.ZodString;
         }, z.core.$strict>>;
-        featureFlagVariant: z.ZodOptional<z.ZodObject<{
+        visibleWhen: z.ZodOptional<z.ZodObject<{
             flag: z.ZodString;
-            title: z.ZodOptional<z.ZodString>;
-            icon: z.ZodOptional<z.ZodString>;
-            panel: z.ZodOptional<z.ZodLiteral<false>>;
+            enabled: z.ZodBoolean;
         }, z.core.$strict>>;
     }, z.core.$strict>;
     UiToastPreviewContribution: z.ZodObject<{
@@ -4893,8 +4894,11 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.54.0 adds named UI host grants for shared configuration/auth/account reads, retained connection
  * progress/dismissal and support. Built-in-only page capability scopes are removed; executable
  * pages declare capabilities on apps[].
+ *
+ * 0.54.1 adds manifest-declared plugin workers on both backend targets and exposes the canonical
+ * transcript placement and answer-stretch rules through the SDK.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.54.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.54.1";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5844,6 +5848,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
     icon: z.ZodOptional<z.ZodString>;
     iconDark: z.ZodOptional<z.ZodString>;
     namespace: z.ZodOptional<z.ZodString>;
+    workers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        localId: z.ZodString;
+        module: z.ZodString;
+    }, z.core.$strict>>>;
     targets: z.ZodOptional<z.ZodObject<{
         kay: z.ZodOptional<z.ZodObject<{
             agent: z.ZodOptional<z.ZodObject<{
@@ -6932,7 +6940,10 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                             plugins: "plugins";
                         }>>;
                         badge: z.ZodOptional<z.ZodObject<{
-                            source: z.ZodString;
+                            source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                                pluginId: z.ZodString;
+                                localId: z.ZodString;
+                            }, z.core.$strict>]>;
                             where: z.ZodOptional<z.ZodString>;
                             label: z.ZodObject<{
                                 one: z.ZodOptional<z.ZodString>;
@@ -6942,11 +6953,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         panel: z.ZodOptional<z.ZodObject<{
                             body: z.ZodString;
                         }, z.core.$strict>>;
-                        featureFlagVariant: z.ZodOptional<z.ZodObject<{
+                        visibleWhen: z.ZodOptional<z.ZodObject<{
                             flag: z.ZodString;
-                            title: z.ZodOptional<z.ZodString>;
-                            icon: z.ZodOptional<z.ZodString>;
-                            panel: z.ZodOptional<z.ZodLiteral<false>>;
+                            enabled: z.ZodBoolean;
                         }, z.core.$strict>>;
                     }, z.core.$strict>>>;
                     toastPreviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -8301,7 +8310,10 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                 plugins: "plugins";
             }>>;
             badge: z.ZodOptional<z.ZodObject<{
-                source: z.ZodString;
+                source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    pluginId: z.ZodString;
+                    localId: z.ZodString;
+                }, z.core.$strict>]>;
                 where: z.ZodOptional<z.ZodString>;
                 label: z.ZodObject<{
                     one: z.ZodOptional<z.ZodString>;
@@ -8311,11 +8323,9 @@ export declare const KayUiTargetManifest: z.ZodObject<{
             panel: z.ZodOptional<z.ZodObject<{
                 body: z.ZodString;
             }, z.core.$strict>>;
-            featureFlagVariant: z.ZodOptional<z.ZodObject<{
+            visibleWhen: z.ZodOptional<z.ZodObject<{
                 flag: z.ZodString;
-                title: z.ZodOptional<z.ZodString>;
-                icon: z.ZodOptional<z.ZodString>;
-                panel: z.ZodOptional<z.ZodLiteral<false>>;
+                enabled: z.ZodBoolean;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
         toastPreviews: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -14063,6 +14073,10 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
     consumesAuthServices: z.ZodArray<z.ZodString>;
     explicitDependencies: z.ZodArray<z.ZodString>;
     dataDirSharedWith: z.ZodOptional<z.ZodString>;
+    workers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        localId: z.ZodString;
+        module: z.ZodString;
+    }, z.core.$strict>>>;
     workloadPurposes: z.ZodOptional<z.ZodArray<z.ZodObject<{
         purpose: z.ZodString;
         workloadClass: z.ZodEnum<{
@@ -17398,7 +17412,10 @@ export declare const UiRailEntryContribution: z.ZodObject<{
         plugins: "plugins";
     }>>;
     badge: z.ZodOptional<z.ZodObject<{
-        source: z.ZodString;
+        source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            pluginId: z.ZodString;
+            localId: z.ZodString;
+        }, z.core.$strict>]>;
         where: z.ZodOptional<z.ZodString>;
         label: z.ZodObject<{
             one: z.ZodOptional<z.ZodString>;
@@ -17408,11 +17425,9 @@ export declare const UiRailEntryContribution: z.ZodObject<{
     panel: z.ZodOptional<z.ZodObject<{
         body: z.ZodString;
     }, z.core.$strict>>;
-    featureFlagVariant: z.ZodOptional<z.ZodObject<{
+    visibleWhen: z.ZodOptional<z.ZodObject<{
         flag: z.ZodString;
-        title: z.ZodOptional<z.ZodString>;
-        icon: z.ZodOptional<z.ZodString>;
-        panel: z.ZodOptional<z.ZodLiteral<false>>;
+        enabled: z.ZodBoolean;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 

package/dist/index.js

@@ -30,12 +30,6 @@ function declaredUiIconPaths(manifest) {
   const contributes = manifest.targets?.kay?.ui?.contributes;
   return [
     ...(contributes?.railEntries ?? []).flatMap((entry) => entry.icon === void 0 ? [] : [{ label: `kay.ui rail entry '${entry.id}' icon`, path: entry.icon }]),
-    ...(contributes?.railEntries ?? []).flatMap((entry) => entry.featureFlagVariant?.icon === void 0 ? [] : [
-      {
-        label: "kay.ui rail variant icon",
-        path: entry.featureFlagVariant.icon
-      }
-    ]),
     ...(contributes?.pages ?? []).flatMap((page) => page.icon === void 0 ? [] : [{ label: `kay.ui page '${page.id}' icon`, path: page.icon }]),
     ...(contributes?.commands ?? []).flatMap((command) => command.icon === void 0 ? [] : [
       {
@@ -266,8 +260,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.54.0";
+var KAY_PLUGIN_SDK_VERSION = "0.54.1";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.54.0",
   "0.53.0",
   "0.52.1",
   "0.52.0",
@@ -4520,7 +4515,7 @@ function createContributionsSchemas(canonical) {
     }
   });
   const UiRailBadge = z14.strictObject({
-    source: LocalContributionId2,
+    source: UiAppCapabilityReference2,
     where: NonEmptyString3.optional(),
     label: z14.strictObject({
       one: NonEmptyString3.optional(),
@@ -4549,12 +4544,7 @@ function createContributionsSchemas(canonical) {
     section: z14.enum(["primary", "plugins"]).optional(),
     badge: UiRailBadge.optional(),
     panel: z14.strictObject({ body: LocalContributionId2 }).optional(),
-    featureFlagVariant: z14.strictObject({
-      flag: NonEmptyString3,
-      title: NonEmptyString3.optional(),
-      icon: PackageAssetPath2.optional(),
-      panel: z14.literal(false).optional()
-    }).optional()
+    visibleWhen: z14.strictObject({ flag: NonEmptyString3, enabled: z14.boolean() }).optional()
   });
   const UiToastPreviewContribution2 = z14.strictObject({
     rule: LocalContributionId2,
@@ -5356,6 +5346,10 @@ function createManifestSchemas(canonical) {
     icon: PackageAssetPath2.optional(),
     iconDark: PackageAssetPath2.optional(),
     namespace: PluginNamespace2.optional(),
+    workers: z18.array(z18.strictObject({
+      localId: LocalContributionId2,
+      module: PackageAssetPath2
+    })).optional(),
     targets: z18.strictObject({
       kay: z18.strictObject({
         agent: KayAgentTargetManifest2.optional(),
@@ -5388,6 +5382,7 @@ function createManifestSchemas(canonical) {
       plugins: z18.array(PluginId2).optional()
     }).optional()
   }).superRefine((manifest, ctx) => {
+    reportDuplicateLocalIds(ctx, ["workers"], manifest.workers, "worker");
     const sharedWith = manifest.storage?.dataDir?.sharedWith;
     if (sharedWith !== void 0 && (!manifest.storage?.dataDir?.enabled || sharedWith === manifest.id || !manifest.dependencies?.plugins?.includes(sharedWith))) {
       ctx.addIssue({
@@ -5552,7 +5547,7 @@ function createManifestSchemas(canonical) {
         index,
         "badge"
       ];
-      if (!declaredRowsStores.has(entry.badge.source)) {
+      if (typeof entry.badge.source === "string" && !declaredRowsStores.has(entry.badge.source)) {
         ctx.addIssue({
           code: "custom",
           path: [...path, "source"],
@@ -6972,6 +6967,10 @@ function createResolvedContractSchemas(canonical) {
     // full dependency graph together with auth-inferred edges from `consumesAuthServices`.
     explicitDependencies: z19.array(PluginId2),
     dataDirSharedWith: PluginId2.optional(),
+    workers: z19.array(z19.strictObject({
+      localId: LocalContributionId2,
+      module: PackageAssetPath2
+    })).optional(),
     workloadPurposes: z19.array(PluginWorkloadPurpose).optional(),
     shellCommands: z19.array(PluginShellCommand.omit({ endpoint: true }).extend({
       endpointId: GlobalContributionId2
@@ -7538,6 +7537,7 @@ function resolveKayPluginContractV1(manifest) {
       ...manifest.dependencies?.plugins ?? []
     ],
     authServices,
+    ...manifest.workers === void 0 ? {} : { workers: manifest.workers },
     ...manifest.storage?.dataDir?.sharedWith === void 0 ? {} : { dataDirSharedWith: manifest.storage.dataDir.sharedWith },
     ...manifest.workloadPurposes === void 0 ? {} : { workloadPurposes: manifest.workloadPurposes },
     ...manifest.shellCommands === void 0 ? {} : {
@@ -7714,6 +7714,17 @@ async function judgeKayPluginDirectory(input) {
       return refuse("contract-resolve", "path-escapes-plugin-dir", `${reference.label} path '${reference.path}' resolves outside the plugin directory (no symlink escapes, no traversal)`);
     }
   }
+  for (const worker of manifest.workers ?? []) {
+    let entry;
+    try {
+      entry = await tree.entry(worker.module);
+    } catch {
+      return refuse("contract-resolve", "invalid-worker-module", "A declared worker module could not be inspected.");
+    }
+    if (entry?.kind !== "file") {
+      return refuse("contract-resolve", "invalid-worker-module", `worker '${worker.localId}' must name an existing regular file`);
+    }
+  }
   return {
     outcome: "loads",
     hostSdkVersion,
@@ -7789,7 +7800,10 @@ function namedIn(head) {
   return head.displayName === void 0 ? head.id : `${head.displayName} (${head.id})`;
 }
 function referencedPaths(manifest) {
-  const refs = [];
+  const refs = (manifest.workers ?? []).map((worker) => ({
+    label: `worker '${worker.localId}'`,
+    path: worker.module
+  }));
   const kayAgent = manifest.targets?.kay?.agent;
   if (kayAgent !== void 0) {
     refs.push({

package/package.json

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