@yaklabs-ai/plugin-protocol 0.42.1 → 0.44.0

package/README.md

@@ -11,7 +11,7 @@ flow.
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.42.1"
+    "@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.42.1",
+  "version": "0.44.0",
   "target": "npm",
   "firstPartyLicense": "MIT",
   "bundled": [],

package/dist/index.d.ts

@@ -1678,6 +1678,7 @@ declare namespace authoringContributionSchemas {
         ContextContributorContribution,
         PluginEventDefinitionContribution,
         PluginNotificationRuleContribution,
+        PluginProductEventContribution,
         UiEventSubscriptionContribution,
         DeviceDelegationContribution,
         SessionReaderContribution,
@@ -2600,6 +2601,13 @@ declare const canonicalContributionSchemas: {
         where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
         rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
     }, z.core.$strict>;
+    PluginProductEventContribution: z.ZodUnion<readonly [z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+    }, z.core.$strict>, z.ZodObject<{
+        catalogEvent: z.ZodString;
+    }, z.core.$strict>]>;
     UiEventSubscriptionContribution: z.ZodObject<{
         localId: z.ZodString;
         event: z.ZodString;
@@ -2733,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>>;
@@ -2815,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>>;
@@ -3539,6 +3565,9 @@ export declare function isCredentialShapedText(value: unknown): boolean;
  */
 export declare function isKayPluginCompatibilityRefusal(code: string): code is KayPluginCompatibilityRefusalCode;
 
+/** Whether `name` can name a declared event: the shape above, and not the journal's own family. */
+export declare function isPluginProductEventName(name: string): boolean;
+
 /** Whether only plugins the release carries may hold `claim` ({@link PRIVATE_PLUGIN_CAPABILITY_SLUGS}). */
 export declare function isPrivateCapabilityClaim(claim: PluginCapabilityClaimV1): boolean;
 
@@ -4280,8 +4309,14 @@ export 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.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.42.1";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.44.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -4920,6 +4955,13 @@ export declare const KayAppTargetManifest: z.ZodObject<{
             where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
             rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
         }, z.core.$strict>>>;
+        productEvents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+        }, z.core.$strict>, z.ZodObject<{
+            catalogEvent: z.ZodString;
+        }, z.core.$strict>]>>>;
         eventSubscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
             event: z.ZodString;
@@ -5706,6 +5748,13 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         where: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
                         rule: z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>;
                     }, z.core.$strict>>>;
+                    productEvents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                        name: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+                    }, z.core.$strict>, z.ZodObject<{
+                        catalogEvent: z.ZodString;
+                    }, z.core.$strict>]>>>;
                     eventSubscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
                         event: z.ZodString;
@@ -5875,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>>;
@@ -7032,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>>;
@@ -7374,6 +7441,12 @@ export declare const PLUGIN_ICON_SHAPE_ATTRIBUTE = "data-icon-shape";
 /** Rule-body keys the host stamps, so a manifest's `rule` may not carry them. */
 export declare const PLUGIN_NOTIFICATION_RULE_HOST_KEYS: readonly ["id", "match", "sender"];
 
+/**
+ * Dot-separated lowercase words: `next_steps.decided`, `message_draft_approved`. A leading `$` is
+ * PostHog's own namespace and cannot match. Bounded like the wire's event name.
+ */
+export declare const PLUGIN_PRODUCT_EVENT_NAME_PATTERN: RegExp;
+
 /** The `kind` values of `PluginSignal` v1. `status` is system state that clears itself. */
 export declare const PLUGIN_SIGNAL_KINDS: readonly ["message", "request", "mention", "invite", "status"];
 
@@ -10517,6 +10590,60 @@ export declare const PluginPermissionManifest: z.ZodObject<{
 
 export declare type PluginPermissionManifest = z.infer<typeof PluginPermissionManifest>;
 
+export declare const PluginProductEventContribution: z.ZodUnion<readonly [z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>>;
+}, z.core.$strict>, z.ZodObject<{
+    catalogEvent: z.ZodString;
+}, z.core.$strict>]>;
+
+export declare type PluginProductEventContribution = z.infer<typeof PluginProductEventContribution>;
+
+/**
+ * One declared field. `exportable` fields use the product catalog's bounded kinds and may leave the
+ * device: an enum or a number holds nothing else, and an id-like kind is one short word with no
+ * spaces, so it cannot hold a sentence but can hold a name or a path if an author puts one there. A
+ * `local` field is stored in the journal and never exported.
+ */
+export declare const PluginProductEventField: z.ZodUnion<readonly [z.ZodObject<{
+    class: z.ZodLiteral<"local">;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"enum">;
+    values: z.ZodArray<z.ZodString>;
+    class: z.ZodLiteral<"exportable">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"number">;
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    integer: z.ZodOptional<z.ZodBoolean>;
+    class: z.ZodLiteral<"exportable">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        id: "id";
+        identifier: "identifier";
+        model_provider: "model_provider";
+        model_reference: "model_reference";
+    }>;
+    class: z.ZodLiteral<"exportable">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>]>;
+
+export declare type PluginProductEventField = z.infer<typeof PluginProductEventField>;
+
+/** 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 PluginProvisioningProbe: z.ZodObject<{
     url: z.ZodURL;
     method: z.ZodOptional<z.ZodEnum<{
@@ -10850,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>>;
@@ -10936,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>>;
@@ -12839,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>>;
@@ -13349,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,8 +254,12 @@ 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.42.1";
-var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [];
+var KAY_PLUGIN_SDK_VERSION = "0.44.0";
+var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.42.0",
+  "0.42.1",
+  "0.43.0"
+];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
   "kay.app",
@@ -2753,6 +2757,7 @@ __export(contributions_exports, {
   PluginContributionKind: () => PluginContributionKind,
   PluginEventDefinitionContribution: () => PluginEventDefinitionContribution,
   PluginNotificationRuleContribution: () => PluginNotificationRuleContribution,
+  PluginProductEventContribution: () => PluginProductEventContribution,
   PluginSkillSourceDeclaration: () => PluginSkillSourceDeclaration,
   ReferenceOpenBehavior: () => ReferenceOpenBehavior,
   ReferencePresentationAddress: () => ReferencePresentationAddress,
@@ -3742,6 +3747,14 @@ function createContributionsSchemas(canonical) {
     where: z12.array(JsonObject).optional(),
     rule: JsonObject
   });
+  const PluginProductEventContribution2 = z12.union([
+    z12.strictObject({
+      name: NonEmptyString3,
+      description: NonEmptyString3.optional(),
+      fields: z12.record(z12.string(), JsonObject).optional()
+    }),
+    z12.strictObject({ catalogEvent: NonEmptyString3 })
+  ]);
   const UiEventSubscriptionContribution2 = z12.strictObject({
     localId: LocalContributionId2,
     event: NonEmptyString3
@@ -3841,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"). */
@@ -3848,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."
       });
     }
   });
@@ -4176,6 +4197,7 @@ function createContributionsSchemas(canonical) {
     ContextContributorContribution: ContextContributorContribution2,
     PluginEventDefinitionContribution: PluginEventDefinitionContribution2,
     PluginNotificationRuleContribution: PluginNotificationRuleContribution2,
+    PluginProductEventContribution: PluginProductEventContribution2,
     UiEventSubscriptionContribution: UiEventSubscriptionContribution2,
     DeviceDelegationContribution: DeviceDelegationContribution2,
     SessionReaderContribution: SessionReaderContribution2,
@@ -4205,7 +4227,7 @@ function createContributionsSchemas(canonical) {
     PluginContributionKind: PluginContributionKind2
   };
 }
-var { ApprovalCardForm, ApprovalCardStoredForm, ApprovalTypeContribution, UriModuleFacts, ToolContribution, ToolPermission, AgentToolContribution, ConverterContribution, UriModuleContribution, AppUriModuleContribution, AppDataSourceContribution, WhiteboardTypeStorage, WhiteboardTypeContribution, AppDataMaterializerContribution, ArtifactUriModuleContribution, CliBindingContribution, GitHostContribution, ResourceContribution, SkillContribution, PluginSkillSourceDeclaration, SearchProviderContribution, InteractionDriverContribution, EntityResolverContribution, AgentRenderContribution, EndpointContribution, WorkflowContribution, McpServerUrl, McpServerAuthMode, McpServerContribution, McpServerContributions, AppEventSubscription, ContextContributorContribution, PluginEventDefinitionContribution, PluginNotificationRuleContribution, UiEventSubscriptionContribution, DeviceDelegationContribution, SessionReaderContribution, UiCommandContribution, UiSlotContribution, SettingsPanelContribution, ResultRendererContribution, ReferenceOpenBehavior, ReferencePresentationVariant, ReferencePresentationVariants, ReferencePresentationUriPattern, ReferencePresentationUrlClaim, ReferencePresentationTooltip, ReferencePresentationAddress, ReferencePresentationWords, ReferencePresentationContribution, RichViewContribution, KayUiAppHostCapability, UiAppCapabilities, UiRailEntryContribution, UiToastPreviewContribution, UiPageContribution, UiAppContribution, ThemeContribution, CommandHandler, CommandContribution, PluginContributionKind } = createContributionsSchemas(false);
+var { ApprovalCardForm, ApprovalCardStoredForm, ApprovalTypeContribution, UriModuleFacts, ToolContribution, ToolPermission, AgentToolContribution, ConverterContribution, UriModuleContribution, AppUriModuleContribution, AppDataSourceContribution, WhiteboardTypeStorage, WhiteboardTypeContribution, AppDataMaterializerContribution, ArtifactUriModuleContribution, CliBindingContribution, GitHostContribution, ResourceContribution, SkillContribution, PluginSkillSourceDeclaration, SearchProviderContribution, InteractionDriverContribution, EntityResolverContribution, AgentRenderContribution, EndpointContribution, WorkflowContribution, McpServerUrl, McpServerAuthMode, McpServerContribution, McpServerContributions, AppEventSubscription, ContextContributorContribution, PluginEventDefinitionContribution, PluginNotificationRuleContribution, PluginProductEventContribution, UiEventSubscriptionContribution, DeviceDelegationContribution, SessionReaderContribution, UiCommandContribution, UiSlotContribution, SettingsPanelContribution, ResultRendererContribution, ReferenceOpenBehavior, ReferencePresentationVariant, ReferencePresentationVariants, ReferencePresentationUriPattern, ReferencePresentationUrlClaim, ReferencePresentationTooltip, ReferencePresentationAddress, ReferencePresentationWords, ReferencePresentationContribution, RichViewContribution, KayUiAppHostCapability, UiAppCapabilities, UiRailEntryContribution, UiToastPreviewContribution, UiPageContribution, UiAppContribution, ThemeContribution, CommandHandler, CommandContribution, PluginContributionKind } = createContributionsSchemas(false);
 var canonicalContributionSchemas = createContributionsSchemas(true);
 
 // packages/plugin-protocol/dist/icon-shape.js
@@ -4279,7 +4301,7 @@ var KAY_UI_NATIVE_EVENT_SUBSCRIPTIONS = [
 var KAY_UI_NATIVE_EVENT_ALLOWLIST = new Set(KAY_UI_NATIVE_EVENT_SUBSCRIPTIONS);
 var RETIRED_COMPATIBILITY_KEYS = ["policy"];
 function createManifestSchemas(canonical) {
-  const { AgentRenderContribution: AgentRenderContribution2, ApprovalTypeContribution: ApprovalTypeContribution2, WorkflowContribution: WorkflowContribution2, AppDataMaterializerContribution: AppDataMaterializerContribution2, AppDataSourceContribution: AppDataSourceContribution2, AppUriModuleContribution: AppUriModuleContribution2, AppEventSubscription: AppEventSubscription2, ArtifactUriModuleContribution: ArtifactUriModuleContribution2, CliBindingContribution: CliBindingContribution2, CommandContribution: CommandContribution2, ContextContributorContribution: ContextContributorContribution2, ConverterContribution: ConverterContribution2, SessionReaderContribution: SessionReaderContribution2, DeviceDelegationContribution: DeviceDelegationContribution2, EndpointContribution: EndpointContribution2, EntityResolverContribution: EntityResolverContribution2, GitHostContribution: GitHostContribution2, McpServerContributions: McpServerContributions2, PluginEventDefinitionContribution: PluginEventDefinitionContribution2, PluginNotificationRuleContribution: PluginNotificationRuleContribution2, ResourceContribution: ResourceContribution2, ReferencePresentationContribution: ReferencePresentationContribution2, ResultRendererContribution: ResultRendererContribution2, RichViewContribution: RichViewContribution2, PluginSkillSourceDeclaration: PluginSkillSourceDeclaration2, InteractionDriverContribution: InteractionDriverContribution2, SearchProviderContribution: SearchProviderContribution2, SkillContribution: SkillContribution2, SettingsPanelContribution: SettingsPanelContribution2, ThemeContribution: ThemeContribution2, AgentToolContribution: AgentToolContribution2, ToolContribution: ToolContribution2, UiCommandContribution: UiCommandContribution2, UiAppContribution: UiAppContribution2, UiRailEntryContribution: UiRailEntryContribution2, UiToastPreviewContribution: UiToastPreviewContribution2, UiPageContribution: UiPageContribution2, UiEventSubscriptionContribution: UiEventSubscriptionContribution2, UiSlotContribution: UiSlotContribution2, UriModuleContribution: UriModuleContribution2, WhiteboardTypeContribution: WhiteboardTypeContribution2 } = canonical ? canonicalContributionSchemas : contributions_exports;
+  const { AgentRenderContribution: AgentRenderContribution2, ApprovalTypeContribution: ApprovalTypeContribution2, WorkflowContribution: WorkflowContribution2, AppDataMaterializerContribution: AppDataMaterializerContribution2, AppDataSourceContribution: AppDataSourceContribution2, AppUriModuleContribution: AppUriModuleContribution2, AppEventSubscription: AppEventSubscription2, ArtifactUriModuleContribution: ArtifactUriModuleContribution2, CliBindingContribution: CliBindingContribution2, CommandContribution: CommandContribution2, ContextContributorContribution: ContextContributorContribution2, ConverterContribution: ConverterContribution2, SessionReaderContribution: SessionReaderContribution2, DeviceDelegationContribution: DeviceDelegationContribution2, EndpointContribution: EndpointContribution2, EntityResolverContribution: EntityResolverContribution2, GitHostContribution: GitHostContribution2, McpServerContributions: McpServerContributions2, PluginEventDefinitionContribution: PluginEventDefinitionContribution2, PluginNotificationRuleContribution: PluginNotificationRuleContribution2, PluginProductEventContribution: PluginProductEventContribution2, ResourceContribution: ResourceContribution2, ReferencePresentationContribution: ReferencePresentationContribution2, ResultRendererContribution: ResultRendererContribution2, RichViewContribution: RichViewContribution2, PluginSkillSourceDeclaration: PluginSkillSourceDeclaration2, InteractionDriverContribution: InteractionDriverContribution2, SearchProviderContribution: SearchProviderContribution2, SkillContribution: SkillContribution2, SettingsPanelContribution: SettingsPanelContribution2, ThemeContribution: ThemeContribution2, AgentToolContribution: AgentToolContribution2, ToolContribution: ToolContribution2, UiCommandContribution: UiCommandContribution2, UiAppContribution: UiAppContribution2, UiRailEntryContribution: UiRailEntryContribution2, UiToastPreviewContribution: UiToastPreviewContribution2, UiPageContribution: UiPageContribution2, UiEventSubscriptionContribution: UiEventSubscriptionContribution2, UiSlotContribution: UiSlotContribution2, UriModuleContribution: UriModuleContribution2, WhiteboardTypeContribution: WhiteboardTypeContribution2 } = canonical ? canonicalContributionSchemas : contributions_exports;
   const { HttpsUrl: HttpsUrl2, LocalContributionId: LocalContributionId2, NonEmptyString: NonEmptyString3, PackageAssetPath: PackageAssetPath2, PluginId: PluginId2, PluginNamespace: PluginNamespace2, RegistrableDomain: RegistrableDomain2, SignedInStatusCode: SignedInStatusCode2, TargetEntrypoint: TargetEntrypoint2 } = canonical ? canonicalCommonSchemas : common_exports;
   const { PluginPermissionManifest: PluginPermissionManifest2 } = canonical ? canonicalPermissionSchemas : permissions_exports;
   const KayAgentTargetManifest2 = z13.strictObject({
@@ -4377,6 +4399,7 @@ function createManifestSchemas(canonical) {
       // Default notification rules over this plugin's own `eventDefinitions`; seeded by the host
       // (see `PluginNotificationRuleContribution`).
       notificationRules: z13.array(PluginNotificationRuleContribution2).optional(),
+      productEvents: z13.array(PluginProductEventContribution2).optional(),
       eventSubscriptions: z13.array(AppEventSubscription2).optional(),
       deviceDelegations: z13.array(DeviceDelegationContribution2).optional(),
       sessionReaders: z13.array(SessionReaderContribution2).optional(),
@@ -7304,10 +7327,47 @@ var WhiteboardTypeInfo = z19.strictObject({
   }).optional()
 });
 
-// packages/plugin-protocol/dist/artifact-outputs.js
+// packages/plugin-protocol/dist/product-events.js
 import { z as z20 } from "zod";
+var exportable = {
+  class: z20.literal("exportable"),
+  optional: z20.boolean().optional()
+};
+var PluginProductEventField = z20.union([
+  z20.strictObject({ class: z20.literal("local") }),
+  z20.strictObject({
+    ...exportable,
+    type: z20.literal("enum"),
+    values: z20.array(z20.string())
+  }),
+  z20.strictObject({
+    ...exportable,
+    type: z20.literal("number"),
+    min: z20.number(),
+    max: z20.number(),
+    integer: z20.boolean().optional()
+  }),
+  z20.strictObject({
+    ...exportable,
+    type: z20.enum([
+      "boolean",
+      "id",
+      "identifier",
+      "model_provider",
+      "model_reference"
+    ])
+  })
+]);
+var PLUGIN_PRODUCT_EVENT_NAME_PATTERN = /^[a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*$/;
+var PLUGIN_PRODUCT_EVENT_NAME_MAX = 120;
+function isPluginProductEventName(name) {
+  return name.length <= PLUGIN_PRODUCT_EVENT_NAME_MAX && PLUGIN_PRODUCT_EVENT_NAME_PATTERN.test(name) && !name.startsWith("runtime.usage.");
+}
+
+// packages/plugin-protocol/dist/artifact-outputs.js
+import { z as z21 } from "zod";
 var ARTIFACT_OUTPUT_PAGE_MAX = 200;
-var Segment = z20.string().min(1).max(1024).refine((value) => !/[^A-Za-z0-9._-]/.test(value)).refine((value) => value !== "." && value !== "..");
+var Segment = z21.string().min(1).max(1024).refine((value) => !/[^A-Za-z0-9._-]/.test(value)).refine((value) => value !== "." && value !== "..");
 function parseArtifactOutputUri(uri) {
   const match = /^output:\/\/([^/]+)\/([^/]+)$/.exec(uri);
   if (match === null || !Segment.safeParse(match[1]).success || !Segment.safeParse(match[2]).success)
@@ -7317,12 +7377,12 @@ function parseArtifactOutputUri(uri) {
 function isCanonicalArtifactOutputUri(uri) {
   return parseArtifactOutputUri(uri) !== void 0;
 }
-var ArtifactOutputUri = z20.string().refine(isCanonicalArtifactOutputUri, "Expected a canonical output://session/name URI");
-var ArtifactOutputChange = z20.union([
-  z20.strictObject({
-    uris: z20.array(ArtifactOutputUri).min(1).max(ARTIFACT_OUTPUT_PAGE_MAX)
+var ArtifactOutputUri = z21.string().refine(isCanonicalArtifactOutputUri, "Expected a canonical output://session/name URI");
+var ArtifactOutputChange = z21.union([
+  z21.strictObject({
+    uris: z21.array(ArtifactOutputUri).min(1).max(ARTIFACT_OUTPUT_PAGE_MAX)
   }),
-  z20.strictObject({ sessionId: Segment })
+  z21.strictObject({ sessionId: Segment })
 ]);
 
 // packages/plugin-protocol/dist/credential-text.js
@@ -7365,25 +7425,25 @@ function isCredentialShapedText(value) {
 }
 
 // packages/plugin-protocol/dist/ui-module-bundle.js
-import { z as z21 } from "zod";
+import { z as z22 } from "zod";
 var KAY_UI_MODULE_BUNDLE_PROTOCOL = "kay.ui.module-bundle.v1";
 var KAY_UI_MODULE_FILE_MAX_BYTES = 8 * 1024 * 1024;
 var KAY_UI_MODULE_BUNDLE_MAX_BYTES = 32 * 1024 * 1024;
 var KAY_UI_MODULE_BUNDLE_MAX_FILES = 256;
-var OutputPath = z21.string().min(1).max(1024).refine((value) => {
+var OutputPath = z22.string().min(1).max(1024).refine((value) => {
   const parsed = KayUiBundleIndexV1.shape.entryPath.safeParse(value);
   return parsed.success && parsed.data === value && value.split("/").every((part) => part !== "" && part !== ".") && // oxlint-disable-next-line eslint/no-control-regex -- Untrusted artifact paths must reject literal control characters.
   !/[\u0000-\u001f?#:%]/.test(value);
 }, { message: "bundle path must contain only unambiguous relative segments" });
-var Sha256 = z21.string().regex(/^[a-f0-9]{64}$/);
-var KayUiModuleBundleIndexV1 = z21.strictObject({
-  protocol: z21.literal(KAY_UI_MODULE_BUNDLE_PROTOCOL),
+var Sha256 = z22.string().regex(/^[a-f0-9]{64}$/);
+var KayUiModuleBundleIndexV1 = z22.strictObject({
+  protocol: z22.literal(KAY_UI_MODULE_BUNDLE_PROTOCOL),
   entryPath: OutputPath,
-  stylePaths: z21.array(OutputPath).max(KAY_UI_MODULE_BUNDLE_MAX_FILES),
-  files: z21.array(z21.strictObject({
+  stylePaths: z22.array(OutputPath).max(KAY_UI_MODULE_BUNDLE_MAX_FILES),
+  files: z22.array(z22.strictObject({
     path: OutputPath,
-    mediaType: z21.string().min(1).max(128).regex(/^[a-zA-Z0-9!#$&^_.+-]+\/[a-zA-Z0-9!#$&^_.+-]+$/),
-    byteLength: z21.number().int().min(1).max(KAY_UI_MODULE_FILE_MAX_BYTES),
+    mediaType: z22.string().min(1).max(128).regex(/^[a-zA-Z0-9!#$&^_.+-]+\/[a-zA-Z0-9!#$&^_.+-]+$/),
+    byteLength: z22.number().int().min(1).max(KAY_UI_MODULE_FILE_MAX_BYTES),
     sha256: Sha256
   })).min(1).max(KAY_UI_MODULE_BUNDLE_MAX_FILES)
 }).superRefine((index, ctx) => {
@@ -7413,9 +7473,9 @@ var KayUiModuleBundleIndexV1 = z21.strictObject({
       message: "bundle exceeds byte cap"
     });
 });
-var KayUiModuleBundleReference = z21.strictObject({
+var KayUiModuleBundleReference = z22.strictObject({
   generationId: Sha256,
-  revision: z21.string().min(1).max(4096).refine((value) => value.trim() === value),
+  revision: z22.string().min(1).max(4096).refine((value) => value.trim() === value),
   index: KayUiModuleBundleIndexV1
 });
 export {
@@ -7537,6 +7597,7 @@ export {
   PLUGIN_EVENT_REFUSED_ERROR_NAME,
   PLUGIN_ICON_SHAPE_ATTRIBUTE,
   PLUGIN_NOTIFICATION_RULE_HOST_KEYS,
+  PLUGIN_PRODUCT_EVENT_NAME_PATTERN,
   PLUGIN_SIGNAL_KINDS,
   PLUGIN_SIGNAL_LABELS_MAX,
   PLUGIN_SIGNAL_LABEL_MAX,
@@ -7576,6 +7637,8 @@ export {
   PluginNotificationRuleContribution,
   PluginOAuthClientSupplier,
   PluginPermissionManifest,
+  PluginProductEventContribution,
+  PluginProductEventField,
   PluginProvisioningProbe,
   PluginProvisioningRequirement,
   PluginSignal,
@@ -7712,6 +7775,7 @@ export {
   isCompatible,
   isCredentialShapedText,
   isKayPluginCompatibilityRefusal,
+  isPluginProductEventName,
   isPrivateCapabilityClaim,
   isQualifiedAuthSchemeRef,
   isQualifiedAuthServiceRef,

package/package.json

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