@yaklabs-ai/plugin-protocol 0.42.0 → 0.43.0

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -48,6 +48,12 @@ export declare type AgentRuntimeSessionCreatorKind = (typeof AGENT_RUNTIME_SESSI
 
 export declare const AgentToolContribution: z.ZodObject<{
     parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+    executionMode: z.ZodOptional<z.ZodEnum<{
+        sequential: "sequential";
+        parallel: "parallel";
+    }>>;
+    promptSnippet: z.ZodOptional<z.ZodString>;
+    promptGuidelines: z.ZodOptional<z.ZodArray<z.ZodString>>;
     authService: z.ZodOptional<z.ZodString>;
     authScheme: z.ZodOptional<z.ZodString>;
     permission: z.ZodOptional<z.ZodObject<{
@@ -58,6 +64,8 @@ export declare const AgentToolContribution: z.ZodObject<{
             execute: "execute";
         }>;
         ruleKey: z.ZodOptional<z.ZodString>;
+        scheme: z.ZodOptional<z.ZodString>;
+        resourcePrefix: z.ZodOptional<z.ZodString>;
         resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     localId: z.ZodString;
@@ -1670,6 +1678,7 @@ declare namespace authoringContributionSchemas {
         ContextContributorContribution,
         PluginEventDefinitionContribution,
         PluginNotificationRuleContribution,
+        PluginProductEventContribution,
         UiEventSubscriptionContribution,
         DeviceDelegationContribution,
         SessionReaderContribution,
@@ -2041,10 +2050,18 @@ declare const canonicalContributionSchemas: {
             execute: "execute";
         }>;
         ruleKey: z.ZodOptional<z.ZodString>;
+        scheme: z.ZodOptional<z.ZodString>;
+        resourcePrefix: z.ZodOptional<z.ZodString>;
         resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>;
     AgentToolContribution: z.ZodObject<{
         parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            sequential: "sequential";
+            parallel: "parallel";
+        }>>;
+        promptSnippet: z.ZodOptional<z.ZodString>;
+        promptGuidelines: z.ZodOptional<z.ZodArray<z.ZodString>>;
         authService: z.ZodOptional<z.ZodString>;
         authScheme: z.ZodOptional<z.ZodString>;
         permission: z.ZodOptional<z.ZodObject<{
@@ -2055,6 +2072,8 @@ declare const canonicalContributionSchemas: {
                 execute: "execute";
             }>;
             ruleKey: z.ZodOptional<z.ZodString>;
+            scheme: z.ZodOptional<z.ZodString>;
+            resourcePrefix: z.ZodOptional<z.ZodString>;
             resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
         localId: z.ZodString;
@@ -2582,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;
@@ -3521,6 +3547,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;
 
@@ -4259,8 +4288,14 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.42.0 hands background work the shared ResolvedCredential in auth.credential. Workflow
  * accounts carry auth resolution outcomes, and Poller callbacks receive only the credential.
  * Older SDK ranges are refused because their background success shape is no longer served.
+ *
+ * 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.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.42.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.43.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -4286,6 +4321,12 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
     contributes: z.ZodOptional<z.ZodObject<{
         tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
             parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+            executionMode: z.ZodOptional<z.ZodEnum<{
+                sequential: "sequential";
+                parallel: "parallel";
+            }>>;
+            promptSnippet: z.ZodOptional<z.ZodString>;
+            promptGuidelines: z.ZodOptional<z.ZodArray<z.ZodString>>;
             authService: z.ZodOptional<z.ZodString>;
             authScheme: z.ZodOptional<z.ZodString>;
             permission: z.ZodOptional<z.ZodObject<{
@@ -4296,6 +4337,8 @@ export declare const KayAgentTargetManifest: z.ZodObject<{
                     execute: "execute";
                 }>;
                 ruleKey: z.ZodOptional<z.ZodString>;
+                scheme: z.ZodOptional<z.ZodString>;
+                resourcePrefix: z.ZodOptional<z.ZodString>;
                 resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
             localId: z.ZodString;
@@ -4891,6 +4934,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;
@@ -5067,6 +5117,12 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                 contributes: z.ZodOptional<z.ZodObject<{
                     tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+                        executionMode: z.ZodOptional<z.ZodEnum<{
+                            sequential: "sequential";
+                            parallel: "parallel";
+                        }>>;
+                        promptSnippet: z.ZodOptional<z.ZodString>;
+                        promptGuidelines: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         authService: z.ZodOptional<z.ZodString>;
                         authScheme: z.ZodOptional<z.ZodString>;
                         permission: z.ZodOptional<z.ZodObject<{
@@ -5077,6 +5133,8 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 execute: "execute";
                             }>;
                             ruleKey: z.ZodOptional<z.ZodString>;
+                            scheme: z.ZodOptional<z.ZodString>;
+                            resourcePrefix: z.ZodOptional<z.ZodString>;
                             resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         }, z.core.$strict>>;
                         localId: z.ZodString;
@@ -5669,6 +5727,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;
@@ -7317,7 +7382,7 @@ export declare function parseSemver(value: string): ParsedSemver | undefined;
 export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
 
 /** Every capability slug {@link PluginCapabilityClaimV1} can express, for exhaustive table checks. */
-export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "memory.read", "memory.write", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "sessions.annotate", "sessions.compact", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "knowledge-source.register", "artifacts.read", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
+export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "memory.read", "memory.write", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "sessions.annotate", "sessions.compact", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
 
 /** Diagnostic messages carry plugin-controlled text (parse errors, module errors); bound it so a
  *  hostile or accidental multi-megabyte error can never blow up a log line or a render surface. */
@@ -7337,6 +7402,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"];
 
@@ -7963,6 +8034,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     envelope: {
         source: string;
     };
+} | {
+    target: "kay.agent";
+    slug: "session-artifacts.read";
+    envelope: {
+        kind: "output" | "upload";
+    };
+} | {
+    target: "kay.agent";
+    slug: "session-artifacts.create";
+    envelope: {
+        kind: "output";
+    };
 } | {
     target: "kay.app";
     slug: "artifacts.read";
@@ -8212,6 +8295,18 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     envelope: {
         source: string;
     };
+} | {
+    target: "kay.agent";
+    slug: "session-artifacts.read";
+    envelope: {
+        kind: "output" | "upload";
+    };
+} | {
+    target: "kay.agent";
+    slug: "session-artifacts.create";
+    envelope: {
+        kind: "output";
+    };
 } | {
     target: "kay.app";
     slug: "artifacts.read";
@@ -8457,6 +8552,21 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
     envelope: z.ZodObject<{
         source: z.ZodString;
     }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    target: z.ZodLiteral<"kay.agent">;
+    slug: z.ZodLiteral<"session-artifacts.read">;
+    envelope: z.ZodObject<{
+        kind: z.ZodEnum<{
+            output: "output";
+            upload: "upload";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    target: z.ZodLiteral<"kay.agent">;
+    slug: z.ZodLiteral<"session-artifacts.create">;
+    envelope: z.ZodObject<{
+        kind: z.ZodLiteral<"output">;
+    }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     target: z.ZodLiteral<"kay.app">;
     slug: z.ZodLiteral<"artifacts.read">;
@@ -8745,6 +8855,21 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
         envelope: z.ZodObject<{
             source: z.ZodString;
         }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.agent">;
+        slug: z.ZodLiteral<"session-artifacts.read">;
+        envelope: z.ZodObject<{
+            kind: z.ZodEnum<{
+                output: "output";
+                upload: "upload";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.agent">;
+        slug: z.ZodLiteral<"session-artifacts.create">;
+        envelope: z.ZodObject<{
+            kind: z.ZodLiteral<"output">;
+        }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"artifacts.read">;
@@ -9032,6 +9157,21 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
             envelope: z.ZodObject<{
                 source: z.ZodString;
             }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            target: z.ZodLiteral<"kay.agent">;
+            slug: z.ZodLiteral<"session-artifacts.read">;
+            envelope: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    output: "output";
+                    upload: "upload";
+                }>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            target: z.ZodLiteral<"kay.agent">;
+            slug: z.ZodLiteral<"session-artifacts.create">;
+            envelope: z.ZodObject<{
+                kind: z.ZodLiteral<"output">;
+            }, z.core.$strict>;
         }, z.core.$strict>, z.ZodObject<{
             target: z.ZodLiteral<"kay.app">;
             slug: z.ZodLiteral<"artifacts.read">;
@@ -9353,6 +9493,21 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
         envelope: z.ZodObject<{
             source: z.ZodString;
         }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.agent">;
+        slug: z.ZodLiteral<"session-artifacts.read">;
+        envelope: z.ZodObject<{
+            kind: z.ZodEnum<{
+                output: "output";
+                upload: "upload";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.agent">;
+        slug: z.ZodLiteral<"session-artifacts.create">;
+        envelope: z.ZodObject<{
+            kind: z.ZodLiteral<"output">;
+        }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"artifacts.read">;
@@ -10396,6 +10551,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<{
@@ -10997,6 +11206,12 @@ export declare const ResolvedKayAgentTool: z.ZodObject<{
     displayName: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+    executionMode: z.ZodOptional<z.ZodEnum<{
+        sequential: "sequential";
+        parallel: "parallel";
+    }>>;
+    promptSnippet: z.ZodOptional<z.ZodString>;
+    promptGuidelines: z.ZodOptional<z.ZodArray<z.ZodString>>;
     requiresAuth: z.ZodOptional<z.ZodObject<{
         serviceId: z.ZodString;
         schemeId: z.ZodOptional<z.ZodString>;
@@ -11009,6 +11224,8 @@ export declare const ResolvedKayAgentTool: z.ZodObject<{
             execute: "execute";
         }>;
         ruleKey: z.ZodOptional<z.ZodString>;
+        scheme: z.ZodOptional<z.ZodString>;
+        resourcePrefix: z.ZodOptional<z.ZodString>;
         resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     localId: z.ZodString;
@@ -12434,6 +12651,12 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         displayName: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+        executionMode: z.ZodOptional<z.ZodEnum<{
+            sequential: "sequential";
+            parallel: "parallel";
+        }>>;
+        promptSnippet: z.ZodOptional<z.ZodString>;
+        promptGuidelines: z.ZodOptional<z.ZodArray<z.ZodString>>;
         requiresAuth: z.ZodOptional<z.ZodObject<{
             serviceId: z.ZodString;
             schemeId: z.ZodOptional<z.ZodString>;
@@ -12446,6 +12669,8 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 execute: "execute";
             }>;
             ruleKey: z.ZodOptional<z.ZodString>;
+            scheme: z.ZodOptional<z.ZodString>;
+            resourcePrefix: z.ZodOptional<z.ZodString>;
             resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
         localId: z.ZodString;
@@ -14282,6 +14507,8 @@ export declare const ToolPermission: z.ZodObject<{
         execute: "execute";
     }>;
     ruleKey: z.ZodOptional<z.ZodString>;
+    scheme: z.ZodOptional<z.ZodString>;
+    resourcePrefix: z.ZodOptional<z.ZodString>;
     resourceArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 

package/dist/index.js

@@ -254,8 +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.42.0";
-var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [];
+var KAY_PLUGIN_SDK_VERSION = "0.43.0";
+var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.42.0",
+  "0.42.1"
+];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
   "kay.app",
@@ -1750,6 +1753,8 @@ var PLUGIN_CAPABILITY_SLUGS = [
   "app-data.register",
   "knowledge-source.register",
   "artifacts.read",
+  "session-artifacts.read",
+  "session-artifacts.create",
   "account.assert",
   "account.update",
   "agents.permissions",
@@ -2032,6 +2037,16 @@ function createAuthoritySchemas(canonical) {
       /** The declared `contributes.dataSources` localId. */
       envelope: z10.strictObject({ source: NonEmptyString3 })
     }),
+    z10.strictObject({
+      target: z10.literal("kay.agent"),
+      slug: z10.literal("session-artifacts.read"),
+      envelope: z10.strictObject({ kind: z10.enum(["upload", "output"]) })
+    }),
+    z10.strictObject({
+      target: z10.literal("kay.agent"),
+      slug: z10.literal("session-artifacts.create"),
+      envelope: z10.strictObject({ kind: z10.literal("output") })
+    }),
     z10.strictObject({
       target: z10.literal("kay.app"),
       slug: z10.literal("artifacts.read"),
@@ -2261,8 +2276,10 @@ function sameClaim(a, b) {
       return b.slug === "interaction.surface" && a.envelope.surface === b.envelope.surface;
     case "dynamic-context.register":
       return b.slug === "dynamic-context.register" && a.envelope.contributor === b.envelope.contributor;
+    case "session-artifacts.read":
+    case "session-artifacts.create":
     case "artifacts.read":
-      return b.slug === "artifacts.read" && a.envelope.kind === b.envelope.kind;
+      return b.slug === a.slug && a.envelope.kind === b.envelope.kind;
     case "knowledge-source.register":
       return b.slug === "knowledge-source.register" && a.envelope.source === b.envelope.source;
     case "app-data.register":
@@ -2352,8 +2369,10 @@ function envelopePairs(a, b) {
       return b.slug === "interaction.surface" ? [[a.envelope.surface, b.envelope.surface]] : [];
     case "dynamic-context.register":
       return b.slug === "dynamic-context.register" ? [[a.envelope.contributor, b.envelope.contributor]] : [];
+    case "session-artifacts.read":
+    case "session-artifacts.create":
     case "artifacts.read":
-      return b.slug === "artifacts.read" ? [[a.envelope.kind, b.envelope.kind]] : [];
+      return b.slug === a.slug ? [[a.envelope.kind, b.envelope.kind]] : [];
     case "knowledge-source.register":
       return b.slug === "knowledge-source.register" ? [[a.envelope.source, b.envelope.source]] : [];
     case "app-data.register":
@@ -2737,6 +2756,7 @@ __export(contributions_exports, {
   PluginContributionKind: () => PluginContributionKind,
   PluginEventDefinitionContribution: () => PluginEventDefinitionContribution,
   PluginNotificationRuleContribution: () => PluginNotificationRuleContribution,
+  PluginProductEventContribution: () => PluginProductEventContribution,
   PluginSkillSourceDeclaration: () => PluginSkillSourceDeclaration,
   ReferenceOpenBehavior: () => ReferenceOpenBehavior,
   ReferencePresentationAddress: () => ReferencePresentationAddress,
@@ -3227,12 +3247,17 @@ function createContributionsSchemas(canonical) {
   const ToolPermission2 = z12.strictObject({
     kind: z12.enum(["read", "mutate", "destructive", "execute"]),
     ruleKey: NonEmptyString3.optional(),
+    scheme: NonEmptyString3.optional(),
+    resourcePrefix: z12.string().max(256).optional(),
     // Arguments whose string values name the resources a call touches.
     resourceArgs: z12.array(NonEmptyString3).min(1).optional()
   });
   const AgentToolContribution2 = z12.strictObject({
     ...ToolContribution2.shape,
     parameters: JsonSchema.optional(),
+    executionMode: z12.enum(["sequential", "parallel"]).optional(),
+    promptSnippet: NonEmptyString3.optional(),
+    promptGuidelines: z12.array(NonEmptyString3).optional(),
     // A local ref names an auth service declared in this manifest; a dotted ref names another
     // plugin's service, as `UriModuleContribution.authService` does.
     authService: AuthServiceReference2.optional(),
@@ -3721,6 +3746,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
@@ -4155,6 +4188,7 @@ function createContributionsSchemas(canonical) {
     ContextContributorContribution: ContextContributorContribution2,
     PluginEventDefinitionContribution: PluginEventDefinitionContribution2,
     PluginNotificationRuleContribution: PluginNotificationRuleContribution2,
+    PluginProductEventContribution: PluginProductEventContribution2,
     UiEventSubscriptionContribution: UiEventSubscriptionContribution2,
     DeviceDelegationContribution: DeviceDelegationContribution2,
     SessionReaderContribution: SessionReaderContribution2,
@@ -4184,7 +4218,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
@@ -4258,7 +4292,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({
@@ -4356,6 +4390,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(),
@@ -5804,6 +5839,9 @@ function createResolvedContractSchemas(canonical) {
     displayName: NonEmptyString3.optional(),
     description: NonEmptyString3.optional(),
     parameters: JsonSchema.optional(),
+    executionMode: z14.enum(["sequential", "parallel"]).optional(),
+    promptSnippet: NonEmptyString3.optional(),
+    promptGuidelines: z14.array(NonEmptyString3).optional(),
     requiresAuth: z14.strictObject({
       serviceId: GlobalContributionId2,
       schemeId: GlobalContributionId2.optional()
@@ -6456,6 +6494,9 @@ function resolveKayPluginContractV1(manifest) {
     ...tool.displayName === void 0 ? {} : { displayName: tool.displayName },
     ...tool.description === void 0 ? {} : { description: tool.description },
     ...tool.parameters === void 0 ? {} : { parameters: tool.parameters },
+    ...tool.executionMode === void 0 ? {} : { executionMode: tool.executionMode },
+    ...tool.promptSnippet === void 0 ? {} : { promptSnippet: tool.promptSnippet },
+    ...tool.promptGuidelines === void 0 ? {} : { promptGuidelines: tool.promptGuidelines },
     ...tool.authService === void 0 ? {} : {
       requiresAuth: {
         serviceId: isQualifiedAuthServiceRef(tool.authService) ? tool.authService : resolveGlobalContributionId(namespace, tool.authService),
@@ -7277,10 +7318,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)
@@ -7290,12 +7368,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
@@ -7338,25 +7416,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) => {
@@ -7386,9 +7464,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 {
@@ -7510,6 +7588,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,
@@ -7549,6 +7628,8 @@ export {
   PluginNotificationRuleContribution,
   PluginOAuthClientSupplier,
   PluginPermissionManifest,
+  PluginProductEventContribution,
+  PluginProductEventField,
   PluginProvisioningProbe,
   PluginProvisioningRequirement,
   PluginSignal,
@@ -7685,6 +7766,7 @@ export {
   isCompatible,
   isCredentialShapedText,
   isKayPluginCompatibilityRefusal,
+  isPluginProductEventName,
   isPrivateCapabilityClaim,
   isQualifiedAuthSchemeRef,
   isQualifiedAuthServiceRef,

package/package.json

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