@yaklabs-ai/plugin-protocol 0.55.2 → 0.55.3

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -4958,8 +4958,13 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * artifact usage declarations. A plugin using these declares ^0.55.1.
  *
  * 0.55.2 adds opt-in query and connection-selector preservation during URI claim normalization.
+ *
+ * 0.55.3 lets a signal carry the item's own text. `PluginSignal` gains an optional `body`: plain
+ * text, at most `PLUGIN_SIGNAL_BODY_MAX` (20,000) characters. Gmail puts a mail's text there, so
+ * Flows can keep the messages a task came from. Additive: a plugin that publishes a body declares
+ * ^0.55.3.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.55.2";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.55.3";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -8816,6 +8821,12 @@ export declare const PLUGIN_SIGNAL_ATTACHMENT_TYPE_MAX = 127;
 /** At most this many entries in a signal's `attachments`; a source lists the first ones. */
 export declare const PLUGIN_SIGNAL_ATTACHMENTS_MAX = 10;
 
+/**
+ * A signal's `body`, the item's own text, at most this many characters: a source cuts longer text
+ * and marks the cut. Enough for a long email with its quoted history.
+ */
+export declare const PLUGIN_SIGNAL_BODY_MAX = 20000;
+
 /** 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"];
 
@@ -12542,6 +12553,7 @@ export declare const PluginSignal: z.ZodObject<{
     }>>;
     title: z.ZodOptional<z.ZodString>;
     snippet: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
     actor: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         uri: z.ZodString;
@@ -12592,6 +12604,7 @@ export declare const PluginSignalPublish: z.ZodObject<{
         }>>;
         title: z.ZodOptional<z.ZodString>;
         snippet: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
         actor: z.ZodOptional<z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             uri: z.ZodString;

package/dist/index.js

@@ -260,8 +260,9 @@ 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.55.2";
+var KAY_PLUGIN_SDK_VERSION = "0.55.3";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.55.2",
   "0.55.1",
   "0.55.0",
   "0.54.2",
@@ -2953,6 +2954,7 @@ __export(plugin_events_exports, {
   PLUGIN_SIGNAL_ATTACHMENTS_MAX: () => PLUGIN_SIGNAL_ATTACHMENTS_MAX,
   PLUGIN_SIGNAL_ATTACHMENT_NAME_MAX: () => PLUGIN_SIGNAL_ATTACHMENT_NAME_MAX,
   PLUGIN_SIGNAL_ATTACHMENT_TYPE_MAX: () => PLUGIN_SIGNAL_ATTACHMENT_TYPE_MAX,
+  PLUGIN_SIGNAL_BODY_MAX: () => PLUGIN_SIGNAL_BODY_MAX,
   PLUGIN_SIGNAL_KINDS: () => PLUGIN_SIGNAL_KINDS,
   PLUGIN_SIGNAL_LABELS_MAX: () => PLUGIN_SIGNAL_LABELS_MAX,
   PLUGIN_SIGNAL_LABEL_MAX: () => PLUGIN_SIGNAL_LABEL_MAX,
@@ -2986,6 +2988,7 @@ var PLUGIN_SIGNAL_KINDS = [
 ];
 var PLUGIN_SIGNAL_TITLE_MAX = 300;
 var PLUGIN_SIGNAL_SNIPPET_MAX = 500;
+var PLUGIN_SIGNAL_BODY_MAX = 2e4;
 var PLUGIN_SIGNAL_LABELS_MAX = 20;
 var PLUGIN_SIGNAL_LABEL_MAX = 64;
 var PLUGIN_SIGNAL_ATTACHMENTS_MAX = 10;
@@ -3055,6 +3058,13 @@ function createPluginEventsSchemas(canonical) {
     direction: z12.enum(["in", "out"]).optional(),
     title: z12.string().max(PLUGIN_SIGNAL_TITLE_MAX).optional(),
     snippet: z12.string().max(PLUGIN_SIGNAL_SNIPPET_MAX).optional(),
+    /**
+     * The item's own text as plain text (a mail's body with its quoted history, a chat
+     * message, an invite's description), at most `PLUGIN_SIGNAL_BODY_MAX` characters. A
+     * consumer may keep it as the record of what was said; a source that cannot read it leaves
+     * it out.
+     */
+    body: z12.string().max(PLUGIN_SIGNAL_BODY_MAX).optional(),
     actor: z12.strictObject({
       name: z12.string().max(PLUGIN_SIGNAL_TITLE_MAX).optional(),
       uri: PluginEventUri2
@@ -8610,6 +8620,7 @@ export {
   PLUGIN_SIGNAL_ATTACHMENTS_MAX,
   PLUGIN_SIGNAL_ATTACHMENT_NAME_MAX,
   PLUGIN_SIGNAL_ATTACHMENT_TYPE_MAX,
+  PLUGIN_SIGNAL_BODY_MAX,
   PLUGIN_SIGNAL_KINDS,
   PLUGIN_SIGNAL_LABELS_MAX,
   PLUGIN_SIGNAL_LABEL_MAX,

package/package.json

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