@yaklabs-ai/plugin-protocol 0.43.0 → 0.44.0

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -2741,6 +2741,15 @@ declare const canonicalContributionSchemas: {
             plugin: "plugin";
         }>>;
         kind: z.ZodOptional<z.ZodString>;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodObject<{
+                protocol: z.ZodString;
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                search: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            kind: z.ZodString;
+        }, z.core.$strict>>>;
         noun: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodString>;
         kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -2823,6 +2832,15 @@ declare const canonicalContributionSchemas: {
                 plugin: "plugin";
             }>>;
             kind: z.ZodOptional<z.ZodString>;
+            kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodObject<{
+                    protocol: z.ZodString;
+                    hostname: z.ZodString;
+                    pathname: z.ZodOptional<z.ZodString>;
+                    search: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                kind: z.ZodString;
+            }, z.core.$strict>>>;
             noun: z.ZodOptional<z.ZodString>;
             target: z.ZodOptional<z.ZodString>;
             kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -4294,8 +4312,11 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  *
  * 0.43.0 adds product events (#15769). `productEvents` in a plugin's `kay.app` target declares them,
  * and `app.productEvents.send` sends them. Additive: a plugin that declares one declares ^0.43.0.
+ *
+ * 0.44.0 adds `words.kinds` to a reference presentation (#15905): an ordered list of address patterns
+ * and the kind each one names. Additive: a plugin that lists them declares ^0.44.0.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.43.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.44.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5903,6 +5924,15 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 plugin: "plugin";
                             }>>;
                             kind: z.ZodOptional<z.ZodString>;
+                            kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                pattern: z.ZodObject<{
+                                    protocol: z.ZodString;
+                                    hostname: z.ZodString;
+                                    pathname: z.ZodOptional<z.ZodString>;
+                                    search: z.ZodOptional<z.ZodString>;
+                                }, z.core.$strict>;
+                                kind: z.ZodString;
+                            }, z.core.$strict>>>;
                             noun: z.ZodOptional<z.ZodString>;
                             target: z.ZodOptional<z.ZodString>;
                             kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -7060,6 +7090,15 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     plugin: "plugin";
                 }>>;
                 kind: z.ZodOptional<z.ZodString>;
+                kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    pattern: z.ZodObject<{
+                        protocol: z.ZodString;
+                        hostname: z.ZodString;
+                        pathname: z.ZodOptional<z.ZodString>;
+                        search: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                    kind: z.ZodString;
+                }, z.core.$strict>>>;
                 noun: z.ZodOptional<z.ZodString>;
                 target: z.ZodOptional<z.ZodString>;
                 kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -10938,6 +10977,15 @@ export declare const ReferencePresentationContribution: z.ZodObject<{
             plugin: "plugin";
         }>>;
         kind: z.ZodOptional<z.ZodString>;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodObject<{
+                protocol: z.ZodString;
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                search: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            kind: z.ZodString;
+        }, z.core.$strict>>>;
         noun: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodString>;
         kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -11024,6 +11072,15 @@ export declare const ReferencePresentationWords: z.ZodObject<{
         plugin: "plugin";
     }>>;
     kind: z.ZodOptional<z.ZodString>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pattern: z.ZodObject<{
+            protocol: z.ZodString;
+            hostname: z.ZodString;
+            pathname: z.ZodOptional<z.ZodString>;
+            search: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        kind: z.ZodString;
+    }, z.core.$strict>>>;
     noun: z.ZodOptional<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
     kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -12927,6 +12984,15 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 plugin: "plugin";
             }>>;
             kind: z.ZodOptional<z.ZodString>;
+            kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodObject<{
+                    protocol: z.ZodString;
+                    hostname: z.ZodString;
+                    pathname: z.ZodOptional<z.ZodString>;
+                    search: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                kind: z.ZodString;
+            }, z.core.$strict>>>;
             noun: z.ZodOptional<z.ZodString>;
             target: z.ZodOptional<z.ZodString>;
             kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
@@ -13437,6 +13503,15 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
             plugin: "plugin";
         }>>;
         kind: z.ZodOptional<z.ZodString>;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pattern: z.ZodObject<{
+                protocol: z.ZodString;
+                hostname: z.ZodString;
+                pathname: z.ZodOptional<z.ZodString>;
+                search: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            kind: z.ZodString;
+        }, z.core.$strict>>>;
         noun: z.ZodOptional<z.ZodString>;
         target: z.ZodOptional<z.ZodString>;
         kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;

package/dist/index.js

@@ -254,10 +254,11 @@ 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.43.0";
+var KAY_PLUGIN_SDK_VERSION = "0.44.0";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.42.0",
-  "0.42.1"
+  "0.42.1",
+  "0.43.0"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -3853,6 +3854,14 @@ function createContributionsSchemas(canonical) {
     glyph: z12.enum(TOOL_GLYPHS).optional(),
     /** The thing an address names ("channel" in "Read Slack channel"). Left out: the row reads the scheme's own name. */
     kind: NonEmptyString3.optional(),
+    /**
+     * A more specific kind by the address's shape. The first row that matches decides, and an
+     * address no row matches reads `kind`.
+     */
+    kinds: z12.array(z12.strictObject({
+      pattern: ReferencePresentationUriPattern2,
+      kind: NonEmptyString3
+    })).min(1).optional(),
     /** What a tally counts one address as ("Slack message"). Left out: `kind`, else "item". */
     noun: NonEmptyString3.optional(),
     /** What the live phrase names ("Slack" in "Reading Slack"). Left out: the bare verb ("Reading"). */
@@ -3860,11 +3869,11 @@ function createContributionsSchemas(canonical) {
     /** `kind` already says which source this is: "Edited plan", not "Edited Plan plan". */
     kindNamesSource: z12.literal(true).optional()
   }).superRefine((value, ctx) => {
-    if (value.kind === void 0 && (value.glyph !== void 0 || value.kindNamesSource !== void 0)) {
+    if (value.kind === void 0 && (value.glyph !== void 0 || value.kindNamesSource !== void 0 || value.kinds !== void 0)) {
       ctx.addIssue({
         code: "custom",
         path: ["kind"],
-        message: "glyph and kindNamesSource describe a row, which needs a kind."
+        message: "glyph, kinds and kindNamesSource describe a row, which needs a kind."
       });
     }
   });

package/package.json

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