@yaklabs-ai/plugin-sdk 0.42.1 → 0.44.0

package/README.md

@@ -13,7 +13,7 @@ it under the name your plugin code actually imports:
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.42.1"
+    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.44.0"
   }
 }
 ```
@@ -62,7 +62,7 @@ Every tool the entrypoint registers is declared in the manifest too:
   "description": "Greets people by name.",
   "version": "0.1.0",
   "namespace": "widgets",
-  "compatibility": { "sdk": "^0.42.1" },
+  "compatibility": { "sdk": "^0.44.0" },
   "targets": {
     "kay": {
       "agent": {

package/THIRD-PARTY-INVENTORY.json

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

package/dist/disclosure.d.ts

@@ -2424,8 +2424,14 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  *
  * 0.42.1 adds current-session tool lifetimes and invocation-bound artifact reads/new outputs,
  * plus described-tool execution, guidance and permission resource metadata.
+ *
+ * 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.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.42.1";
+declare const KAY_PLUGIN_SDK_VERSION: "0.44.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/dist/kay-agent-testing.d.ts

@@ -2478,8 +2478,14 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  *
  * 0.42.1 adds current-session tool lifetimes and invocation-bound artifact reads/new outputs,
  * plus described-tool execution, guidance and permission resource metadata.
+ *
+ * 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.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.42.1";
+declare const KAY_PLUGIN_SDK_VERSION: "0.44.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5818,6 +5824,15 @@ 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>>;

package/dist/kay-agent.d.ts

@@ -2753,8 +2753,14 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  *
  * 0.42.1 adds current-session tool lifetimes and invocation-bound artifact reads/new outputs,
  * plus described-tool execution, guidance and permission resource metadata.
+ *
+ * 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.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.42.1";
+declare const KAY_PLUGIN_SDK_VERSION: "0.44.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 

package/dist/kay-app.d.ts

@@ -501,6 +501,15 @@ declare function BigInt_3(options?: TNumberOptions): TBigInt;
 
 declare const BigIntPattern = "-?(?:0|[1-9][0-9]*)n";
 
+export declare interface BonsaiProductEvents {
+    /**
+     * Sends one event this plugin declares in its manifest, or a catalog event it names there. A
+     * field the declaration does not name is not sent. An event it does not declare, or a value that
+     * does not fit, is dropped with a diagnostic in the daemon's log. Returns nothing and never throws.
+     */
+    send(name: string, input?: PluginProductEventSend): void;
+}
+
 /** Creates a Boolean type. */
 declare function Boolean_2(options?: TSchemaOptions): TBoolean;
 
@@ -2729,8 +2738,14 @@ declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  *
  * 0.42.1 adds current-session tool lifetimes and invocation-bound artifact reads/new outputs,
  * plus described-tool execution, guidance and permission resource metadata.
+ *
+ * 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.
  */
-declare const KAY_PLUGIN_SDK_VERSION: "0.42.1";
+declare const KAY_PLUGIN_SDK_VERSION: "0.44.0";
 
 declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5355,6 +5370,8 @@ export declare interface KayAppPluginApi {
     readonly endpoints: KayAppEndpoints;
     /** Publish one event declared by this plugin's `kay.app` manifest target. */
     readonly events: KayAppPluginEvents;
+    /** Sends the product events this plugin declares in its manifest. */
+    readonly productEvents: BonsaiProductEvents;
     /** The fine per-tool, app-wide event stream. */
     readonly toolEvents: KayAppToolEvents;
     /** Register an app-scoped URI module, active-by-default in every session. */
@@ -9831,6 +9848,16 @@ declare const PluginNamespace: z.ZodString;
 
 declare type PluginNamespace = z.infer<typeof PluginNamespace>;
 
+/** What a send of a product event carries, from a plugin's code or its page. */
+export declare interface PluginProductEventSend {
+    /** Declared fields of either class. A field the declaration does not name is not sent. */
+    readonly properties?: Readonly<Record<string, string | number | boolean>>;
+    /** The session it is about, when there is one. Exported, so it must be a session id. */
+    readonly sessionId?: string;
+    /** The address it is about. Stays on the device. */
+    readonly subjectUri?: string;
+}
+
 export declare const PluginSignal: z.ZodObject<{
     kind: z.ZodEnum<{
         message: "message";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-sdk",
-  "version": "0.42.1",
+  "version": "0.44.0",
   "description": "The Kay plugin SDK — types and helpers for authoring a Kay directory plugin.",
   "author": "YakLabs",
   "type": "module",