@yaklabs-ai/plugin-protocol 0.8.4 → 0.9.0

package/README.md

@@ -11,7 +11,7 @@ flow.
 ```json
 {
   "dependencies": {
-    "@kay/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.8.4"
+    "@kay/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.9.0"
   }
 }
 ```

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -1829,6 +1829,9 @@ export declare const KAY_APP_DATA_SNAPSHOT_MAX_BYTES: number;
  */
 export declare const KAY_EVENT_PUBLISHER_ID: "kay";
 
+/** Released SDK contracts still implemented by the host, alongside its current SDK. */
+export declare const KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS: readonly ["0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5"];
+
 export declare const KAY_PLUGIN_PROTOCOL_PACKAGE_NAME: "@kay/plugin-protocol";
 
 export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
@@ -1923,8 +1926,16 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * plugin that calls it, or declares `notificationRules`, declares `^0.8.4`: a
  * host still advertising 0.8.3 (signals only, landed separately) refuses it at
  * load instead of failing at the call.
+ *
+ * 0.8.5 republishes `@yaklabs-ai/plugin-sdk` to include the `./jev` and
+ * `./signals` entrypoints: the workspace package has exported them since 0.8.1
+ * (`jev`) and 0.8.3 (`signals`), but `scripts/build-publishable-packages.mjs`'s
+ * hand-maintained `entrypoints` allowlist had omitted both. This packages
+ * EXISTING apis; the type contract does not change. It still takes the patch
+ * slot: nothing a `^0.8.1`/`^0.8.3` plugin already compiles against changes
+ * shape, and the fix is which bytes reach npm, not what the contract promises.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.8.4";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.9.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -2245,6 +2256,8 @@ export declare interface KayPluginHostCompatibility {
     readonly protocolVersion: string;
     /** The plugin SDK version this host injects, e.g. `KAY_PLUGIN_SDK_VERSION`. */
     readonly sdkVersion: string;
+    /** Older SDK releases whose runtime contracts this host still implements; absent means none. */
+    readonly compatibleSdkVersions?: readonly string[];
     /** The Kay app version. Advisory only — never a refusal. */
     readonly appVersion: string;
     /**

package/dist/index.js

@@ -115,7 +115,15 @@ import { z as z2 } from "zod";
 import { z } from "zod";
 var KAY_PLUGIN_PROTOCOL_VERSION = "kay.plugin.v1";
 var KAY_PLUGIN_PROTOCOL_PACKAGE_NAME = "@kay/plugin-protocol";
-var KAY_PLUGIN_SDK_VERSION = "0.8.4";
+var KAY_PLUGIN_SDK_VERSION = "0.9.0";
+var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.8.0",
+  "0.8.1",
+  "0.8.2",
+  "0.8.3",
+  "0.8.4",
+  "0.8.5"
+];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
   "kay.app",
@@ -2106,11 +2114,16 @@ function checkKayPluginHostCompatibility(compatibility, host) {
     }
     return { refusal: void 0, advisories };
   }
-  if (parseSemver(host.sdkVersion) === void 0) {
+  const supportedVersions = [
+    host.sdkVersion,
+    ...host.compatibleSdkVersions ?? []
+  ];
+  const invalidVersion = supportedVersions.find((version) => parseSemver(version) === void 0);
+  if (invalidVersion !== void 0) {
     return {
       refusal: {
         code: "host-sdk-version-invalid",
-        message: `cannot be checked: this Kay reports plugin SDK "${host.sdkVersion}", which is not valid semver`
+        message: `cannot be checked: this Kay reports plugin SDK "${invalidVersion}", which is not valid semver`
       },
       advisories
     };
@@ -2124,7 +2137,7 @@ function checkKayPluginHostCompatibility(compatibility, host) {
       advisories
     };
   }
-  if (satisfiesSemverRange(host.sdkVersion, range) !== true) {
+  if (!supportedVersions.some((version) => satisfiesSemverRange(version, range) === true)) {
     return {
       refusal: {
         code: "sdk-range-unsatisfied",
@@ -4615,6 +4628,7 @@ export {
   KAY_APP_DATA_READ_RESULT_MAX_BYTES,
   KAY_APP_DATA_SNAPSHOT_MAX_BYTES,
   KAY_EVENT_PUBLISHER_ID,
+  KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS,
   KAY_PLUGIN_PROTOCOL_PACKAGE_NAME,
   KAY_PLUGIN_PROTOCOL_VERSION,
   KAY_PLUGIN_SDK_VERSION,

package/package.json

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