@yaklabs-ai/plugin-protocol 0.38.0 → 0.39.0

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -1684,6 +1684,7 @@ declare namespace authoringContributionSchemas {
         ReferencePresentationUrlClaim,
         ReferencePresentationTooltip,
         ReferencePresentationAddress,
+        ReferencePresentationWords,
         ReferencePresentationContribution,
         RichViewContribution,
         KayUiAppHostCapability,
@@ -2681,6 +2682,37 @@ declare const canonicalContributionSchemas: {
             kind: z.ZodLiteral<"none">;
         }, z.core.$strict>>;
     }, z.core.$strict>;
+    ReferencePresentationWords: z.ZodObject<{
+        glyph: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            terminal: "terminal";
+            note: "note";
+            search: "search";
+            person: "person";
+            session: "session";
+            browser: "browser";
+            folder: "folder";
+            repo: "repo";
+            clock: "clock";
+            robot: "robot";
+            globe: "globe";
+            skill: "skill";
+            memory: "memory";
+            plan: "plan";
+            download: "download";
+            attachment: "attachment";
+            settings: "settings";
+            catalog: "catalog";
+            model: "model";
+            doc: "doc";
+            feedback: "feedback";
+            plugin: "plugin";
+        }>>;
+        kind: z.ZodOptional<z.ZodString>;
+        noun: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodString>;
+        kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>;
     ReferencePresentationContribution: z.ZodObject<{
         localId: z.ZodString;
         uriModule: z.ZodOptional<z.ZodString>;
@@ -2697,15 +2729,15 @@ declare const canonicalContributionSchemas: {
                 kind: z.ZodLiteral<"none">;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
-        resourceKind: z.ZodString;
-        open: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        resourceKind: z.ZodOptional<z.ZodString>;
+        open: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"working-document">;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"browser-pane">;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page">;
             pageId: z.ZodString;
-        }, z.core.$strict>], "kind">;
+        }, z.core.$strict>], "kind">>;
         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             resourceKind: z.ZodString;
             presentationPluginId: z.ZodOptional<z.ZodString>;
@@ -2732,6 +2764,37 @@ declare const canonicalContributionSchemas: {
                 search: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>;
         }, z.core.$strict>>;
+        words: z.ZodOptional<z.ZodObject<{
+            glyph: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                terminal: "terminal";
+                note: "note";
+                search: "search";
+                person: "person";
+                session: "session";
+                browser: "browser";
+                folder: "folder";
+                repo: "repo";
+                clock: "clock";
+                robot: "robot";
+                globe: "globe";
+                skill: "skill";
+                memory: "memory";
+                plan: "plan";
+                download: "download";
+                attachment: "attachment";
+                settings: "settings";
+                catalog: "catalog";
+                model: "model";
+                doc: "doc";
+                feedback: "feedback";
+                plugin: "plugin";
+            }>>;
+            kind: z.ZodOptional<z.ZodString>;
+            noun: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     RichViewContribution: z.ZodObject<{
         localId: z.ZodString;
@@ -3189,8 +3252,8 @@ export declare const CorpusResourceInvocationQuery: z.ZodObject<{
     }, z.core.$strict>>;
     limit: z.ZodOptional<z.ZodNumber>;
     rootCreatedByKind: z.ZodOptional<z.ZodEnum<{
-        agent: "agent";
         plugin: "plugin";
+        agent: "agent";
         human: "human";
         trigger: "trigger";
         daemon: "daemon";
@@ -4176,8 +4239,12 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * is then the shared `PluginSignal` v1 with a `related.thread`; a workflow of a plugin the release
  * carries may start on every plugin's signals with `{ kind: "plugin-event", signals: true }` (the
  * private `workflows.signals` claim). Additive: a plugin that declares a signal declares ^0.38.0.
+ *
+ * 0.39.0 lets a plugin word its own addresses (#15750). A reference presentation gains `words`, and
+ * `open` and `resourceKind` become an optional pair, so a module can name its rows, tallies and live
+ * phrases without its addresses opening. Additive. A plugin that declares words declares ^0.39.0.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.38.0";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.39.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5681,15 +5748,15 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 kind: z.ZodLiteral<"none">;
                             }, z.core.$strict>>;
                         }, z.core.$strict>>>;
-                        resourceKind: z.ZodString;
-                        open: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        resourceKind: z.ZodOptional<z.ZodString>;
+                        open: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             kind: z.ZodLiteral<"working-document">;
                         }, z.core.$strict>, z.ZodObject<{
                             kind: z.ZodLiteral<"browser-pane">;
                         }, z.core.$strict>, z.ZodObject<{
                             kind: z.ZodLiteral<"page">;
                             pageId: z.ZodString;
-                        }, z.core.$strict>], "kind">;
+                        }, z.core.$strict>], "kind">>;
                         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                             resourceKind: z.ZodString;
                             presentationPluginId: z.ZodOptional<z.ZodString>;
@@ -5716,6 +5783,37 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 search: z.ZodOptional<z.ZodString>;
                             }, z.core.$strict>;
                         }, z.core.$strict>>;
+                        words: z.ZodOptional<z.ZodObject<{
+                            glyph: z.ZodOptional<z.ZodEnum<{
+                                file: "file";
+                                terminal: "terminal";
+                                note: "note";
+                                search: "search";
+                                person: "person";
+                                session: "session";
+                                browser: "browser";
+                                folder: "folder";
+                                repo: "repo";
+                                clock: "clock";
+                                robot: "robot";
+                                globe: "globe";
+                                skill: "skill";
+                                memory: "memory";
+                                plan: "plan";
+                                download: "download";
+                                attachment: "attachment";
+                                settings: "settings";
+                                catalog: "catalog";
+                                model: "model";
+                                doc: "doc";
+                                feedback: "feedback";
+                                plugin: "plugin";
+                            }>>;
+                            kind: z.ZodOptional<z.ZodString>;
+                            noun: z.ZodOptional<z.ZodString>;
+                            target: z.ZodOptional<z.ZodString>;
+                            kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+                        }, z.core.$strict>>;
                     }, z.core.$strict>>>;
                     views: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
@@ -6814,15 +6912,15 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     kind: z.ZodLiteral<"none">;
                 }, z.core.$strict>>;
             }, z.core.$strict>>>;
-            resourceKind: z.ZodString;
-            open: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            resourceKind: z.ZodOptional<z.ZodString>;
+            open: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"working-document">;
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"browser-pane">;
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"page">;
                 pageId: z.ZodString;
-            }, z.core.$strict>], "kind">;
+            }, z.core.$strict>], "kind">>;
             variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 resourceKind: z.ZodString;
                 presentationPluginId: z.ZodOptional<z.ZodString>;
@@ -6849,6 +6947,37 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     search: z.ZodOptional<z.ZodString>;
                 }, z.core.$strict>;
             }, z.core.$strict>>;
+            words: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodOptional<z.ZodEnum<{
+                    file: "file";
+                    terminal: "terminal";
+                    note: "note";
+                    search: "search";
+                    person: "person";
+                    session: "session";
+                    browser: "browser";
+                    folder: "folder";
+                    repo: "repo";
+                    clock: "clock";
+                    robot: "robot";
+                    globe: "globe";
+                    skill: "skill";
+                    memory: "memory";
+                    plan: "plan";
+                    download: "download";
+                    attachment: "attachment";
+                    settings: "settings";
+                    catalog: "catalog";
+                    model: "model";
+                    doc: "doc";
+                    feedback: "feedback";
+                    plugin: "plugin";
+                }>>;
+                kind: z.ZodOptional<z.ZodString>;
+                noun: z.ZodOptional<z.ZodString>;
+                target: z.ZodOptional<z.ZodString>;
+                kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         views: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
@@ -10521,15 +10650,15 @@ export declare const ReferencePresentationContribution: z.ZodObject<{
             kind: z.ZodLiteral<"none">;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
-    resourceKind: z.ZodString;
-    open: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    resourceKind: z.ZodOptional<z.ZodString>;
+    open: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"working-document">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser-pane">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"page">;
         pageId: z.ZodString;
-    }, z.core.$strict>], "kind">;
+    }, z.core.$strict>], "kind">>;
     variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         resourceKind: z.ZodString;
         presentationPluginId: z.ZodOptional<z.ZodString>;
@@ -10556,6 +10685,37 @@ export declare const ReferencePresentationContribution: z.ZodObject<{
             search: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>;
     }, z.core.$strict>>;
+    words: z.ZodOptional<z.ZodObject<{
+        glyph: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            terminal: "terminal";
+            note: "note";
+            search: "search";
+            person: "person";
+            session: "session";
+            browser: "browser";
+            folder: "folder";
+            repo: "repo";
+            clock: "clock";
+            robot: "robot";
+            globe: "globe";
+            skill: "skill";
+            memory: "memory";
+            plan: "plan";
+            download: "download";
+            attachment: "attachment";
+            settings: "settings";
+            catalog: "catalog";
+            model: "model";
+            doc: "doc";
+            feedback: "feedback";
+            plugin: "plugin";
+        }>>;
+        kind: z.ZodOptional<z.ZodString>;
+        noun: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodString>;
+        kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type ReferencePresentationContribution = z.infer<typeof ReferencePresentationContribution>;
@@ -10611,6 +10771,40 @@ export declare const ReferencePresentationVariants: z.ZodRecord<z.ZodString, z.Z
 
 export declare type ReferencePresentationVariants = z.infer<typeof ReferencePresentationVariants>;
 
+export declare const ReferencePresentationWords: z.ZodObject<{
+    glyph: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        terminal: "terminal";
+        note: "note";
+        search: "search";
+        person: "person";
+        session: "session";
+        browser: "browser";
+        folder: "folder";
+        repo: "repo";
+        clock: "clock";
+        robot: "robot";
+        globe: "globe";
+        skill: "skill";
+        memory: "memory";
+        plan: "plan";
+        download: "download";
+        attachment: "attachment";
+        settings: "settings";
+        catalog: "catalog";
+        model: "model";
+        doc: "doc";
+        feedback: "feedback";
+        plugin: "plugin";
+    }>>;
+    kind: z.ZodOptional<z.ZodString>;
+    noun: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodString>;
+    kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strict>;
+
+export declare type ReferencePresentationWords = z.infer<typeof ReferencePresentationWords>;
+
 /**
  * The web-session scope-confinement refinement, coined ONCE and shared by both
  * web-session boundaries: `loginUrl` and `probe.url` must each fall within a
@@ -12418,6 +12612,7 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         globalId: z.ZodString;
         uriModule: z.ZodOptional<z.ZodString>;
         schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        displayName: z.ZodOptional<z.ZodString>;
         addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
             pattern: z.ZodObject<{
                 protocol: z.ZodString;
@@ -12430,15 +12625,15 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 kind: z.ZodLiteral<"none">;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
-        resourceKind: z.ZodString;
-        open: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        resourceKind: z.ZodOptional<z.ZodString>;
+        open: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"working-document">;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"browser-pane">;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"page">;
             pageId: z.ZodString;
-        }, z.core.$strict>], "kind">;
+        }, z.core.$strict>], "kind">>;
         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             resourceKind: z.ZodString;
             presentationPluginId: z.ZodOptional<z.ZodString>;
@@ -12465,6 +12660,37 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 search: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>;
         }, z.core.$strict>>;
+        words: z.ZodOptional<z.ZodObject<{
+            glyph: z.ZodOptional<z.ZodEnum<{
+                file: "file";
+                terminal: "terminal";
+                note: "note";
+                search: "search";
+                person: "person";
+                session: "session";
+                browser: "browser";
+                folder: "folder";
+                repo: "repo";
+                clock: "clock";
+                robot: "robot";
+                globe: "globe";
+                skill: "skill";
+                memory: "memory";
+                plan: "plan";
+                download: "download";
+                attachment: "attachment";
+                settings: "settings";
+                catalog: "catalog";
+                model: "model";
+                doc: "doc";
+                feedback: "feedback";
+                plugin: "plugin";
+            }>>;
+            kind: z.ZodOptional<z.ZodString>;
+            noun: z.ZodOptional<z.ZodString>;
+            target: z.ZodOptional<z.ZodString>;
+            kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>>;
     kayUiApps: z.ZodOptional<z.ZodArray<z.ZodObject<{
         localId: z.ZodString;
@@ -12898,6 +13124,7 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
     globalId: z.ZodString;
     uriModule: z.ZodOptional<z.ZodString>;
     schemes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    displayName: z.ZodOptional<z.ZodString>;
     addresses: z.ZodOptional<z.ZodArray<z.ZodObject<{
         pattern: z.ZodObject<{
             protocol: z.ZodString;
@@ -12910,15 +13137,15 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
             kind: z.ZodLiteral<"none">;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
-    resourceKind: z.ZodString;
-    open: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    resourceKind: z.ZodOptional<z.ZodString>;
+    open: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"working-document">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"browser-pane">;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"page">;
         pageId: z.ZodString;
-    }, z.core.$strict>], "kind">;
+    }, z.core.$strict>], "kind">>;
     variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         resourceKind: z.ZodString;
         presentationPluginId: z.ZodOptional<z.ZodString>;
@@ -12945,6 +13172,37 @@ export declare const ResolvedReferencePresentation: z.ZodObject<{
             search: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>;
     }, z.core.$strict>>;
+    words: z.ZodOptional<z.ZodObject<{
+        glyph: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            terminal: "terminal";
+            note: "note";
+            search: "search";
+            person: "person";
+            session: "session";
+            browser: "browser";
+            folder: "folder";
+            repo: "repo";
+            clock: "clock";
+            robot: "robot";
+            globe: "globe";
+            skill: "skill";
+            memory: "memory";
+            plan: "plan";
+            download: "download";
+            attachment: "attachment";
+            settings: "settings";
+            catalog: "catalog";
+            model: "model";
+            doc: "doc";
+            feedback: "feedback";
+            plugin: "plugin";
+        }>>;
+        kind: z.ZodOptional<z.ZodString>;
+        noun: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodString>;
+        kindNamesSource: z.ZodOptional<z.ZodLiteral<true>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 
 export declare type ResolvedReferencePresentation = z.infer<typeof ResolvedReferencePresentation>;
@@ -13988,6 +14246,9 @@ export declare const ThemeContribution: z.ZodObject<{
 
 export declare type ThemeContribution = z.infer<typeof ThemeContribution>;
 
+/** The marks Bonsai draws for local work and for sources with no icon of their own. */
+export declare const TOOL_GLYPHS: readonly ["terminal", "file", "search", "folder", "person", "repo", "clock", "robot", "globe", "browser", "skill", "memory", "session", "plan", "download", "attachment", "settings", "catalog", "model", "doc", "feedback", "plugin", "note"];
+
 export declare const ToolContribution: z.ZodObject<{
     localId: z.ZodString;
     toolName: z.ZodString;
@@ -13997,6 +14258,9 @@ export declare const ToolContribution: z.ZodObject<{
 
 export declare type ToolContribution = z.infer<typeof ToolContribution>;
 
+/** A mark for local work and for Bonsai's own surfaces, drawn at the start of a tool row. */
+export declare type ToolGlyph = (typeof TOOL_GLYPHS)[number];
+
 export declare const ToolPermission: z.ZodObject<{
     kind: z.ZodEnum<{
         read: "read";

package/dist/index.js

@@ -254,7 +254,7 @@ 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.38.0";
+var KAY_PLUGIN_SDK_VERSION = "0.39.0";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.26.3",
   "0.27.1",
@@ -267,7 +267,8 @@ var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.34.0",
   "0.35.0",
   "0.36.0",
-  "0.37.1"
+  "0.37.1",
+  "0.38.0"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -2759,6 +2760,7 @@ __export(contributions_exports, {
   ReferencePresentationUrlClaim: () => ReferencePresentationUrlClaim,
   ReferencePresentationVariant: () => ReferencePresentationVariant,
   ReferencePresentationVariants: () => ReferencePresentationVariants,
+  ReferencePresentationWords: () => ReferencePresentationWords,
   ResourceContribution: () => ResourceContribution,
   ResultRendererContribution: () => ResultRendererContribution,
   RichViewContribution: () => RichViewContribution,
@@ -3118,6 +3120,33 @@ function evaluateCommandWhere(where, values) {
   return evaluateWhere(where, (key) => values[key]);
 }
 
+// packages/plugin-protocol/dist/tool-glyph.js
+var TOOL_GLYPHS = [
+  "terminal",
+  "file",
+  "search",
+  "folder",
+  "person",
+  "repo",
+  "clock",
+  "robot",
+  "globe",
+  "browser",
+  "skill",
+  "memory",
+  "session",
+  "plan",
+  "download",
+  "attachment",
+  "settings",
+  "catalog",
+  "model",
+  "doc",
+  "feedback",
+  "plugin",
+  "note"
+];
+
 // packages/plugin-protocol/dist/contributions.js
 var MCP_SERVER_LOCAL_HTTP_HOSTNAMES = /* @__PURE__ */ new Set(["localhost", "127.0.0.1"]);
 var MCP_SIGN_IN_SCHEME_KIND = {
@@ -3801,6 +3830,26 @@ function createContributionsSchemas(canonical) {
     objectId: NonEmptyString3.optional(),
     open: z12.strictObject({ kind: z12.literal("none") }).optional()
   });
+  const ReferencePresentationWords2 = z12.strictObject({
+    /** The row's mark, for a source with no icon of its own. Left out: the plugin's main icon. */
+    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(),
+    /** 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"). */
+    target: NonEmptyString3.optional(),
+    /** `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)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["kind"],
+        message: "glyph and kindNamesSource describe a row, which needs a kind."
+      });
+    }
+  });
   const ReferencePresentationContribution2 = z12.strictObject({
     localId: LocalContributionId2,
     /** This manifest's URI module. Leave it out only for an address another layer serves. */
@@ -3813,16 +3862,48 @@ function createContributionsSchemas(canonical) {
     scheme: UriScheme2.optional(),
     /** Which of the addresses open the page, and on what. Read by the window. */
     addresses: z12.array(ReferencePresentationAddress2).min(1).optional(),
-    resourceKind: NonEmptyString3,
-    open: ReferenceOpenBehavior2,
+    /** Comes with `open`. A presentation with neither only words its module's addresses. */
+    resourceKind: NonEmptyString3.optional(),
+    /** How the address opens. Left out, it stays plain text. */
+    open: ReferenceOpenBehavior2.optional(),
     /** MIME-specific resource kinds; absent keys use the base presentation. */
     variants: ReferencePresentationVariants2.optional(),
     /** Lexical public URL claims used only for host-rendered browser presentations. */
     claims: z12.array(ReferencePresentationUrlClaim2).optional(),
     /** Informational app presentation matched against the canonical resource URI. */
-    tooltip: ReferencePresentationTooltip2.optional()
+    tooltip: ReferencePresentationTooltip2.optional(),
+    /** What the transcript calls this module's addresses. Needs a `uriModule`. */
+    words: ReferencePresentationWords2.optional()
   }).superRefine((value, ctx) => {
-    if (value.claims !== void 0 && value.claims.length > 0 && value.open.kind !== "browser-pane") {
+    if (value.open === void 0 !== (value.resourceKind === void 0)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["open"],
+        message: "open and resourceKind come together: name both or neither."
+      });
+    }
+    if (value.open === void 0 && value.words === void 0) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["words"],
+        message: "A reference presentation that opens nothing must have words."
+      });
+    }
+    if (value.words !== void 0 && value.uriModule === void 0) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["words"],
+        message: "Words belong to a URI module: name its uriModule."
+      });
+    }
+    if (value.open === void 0 && (value.variants !== void 0 || value.tooltip !== void 0)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["open"],
+        message: "variants and tooltip need an open."
+      });
+    }
+    if (value.claims !== void 0 && value.claims.length > 0 && value.open?.kind !== "browser-pane") {
       ctx.addIssue({
         code: "custom",
         path: ["claims"],
@@ -3836,14 +3917,14 @@ function createContributionsSchemas(canonical) {
         message: "A reference presentation names a uriModule or a scheme."
       });
     }
-    if ((value.scheme !== void 0 || value.addresses !== void 0) && value.open.kind !== "page") {
+    if ((value.scheme !== void 0 || value.addresses !== void 0) && value.open?.kind !== "page") {
       ctx.addIssue({
         code: "custom",
         path: ["open"],
         message: "scheme and addresses require page opening."
       });
     }
-    if (value.tooltip !== void 0 && value.open.kind === "page") {
+    if (value.tooltip !== void 0 && value.open?.kind === "page") {
       ctx.addIssue({
         code: "custom",
         path: ["tooltip"],
@@ -4104,6 +4185,7 @@ function createContributionsSchemas(canonical) {
     ReferencePresentationUrlClaim: ReferencePresentationUrlClaim2,
     ReferencePresentationTooltip: ReferencePresentationTooltip2,
     ReferencePresentationAddress: ReferencePresentationAddress2,
+    ReferencePresentationWords: ReferencePresentationWords2,
     ReferencePresentationContribution: ReferencePresentationContribution2,
     RichViewContribution: RichViewContribution2,
     KayUiAppHostCapability: KayUiAppHostCapability2,
@@ -4118,7 +4200,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, 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, 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
@@ -4943,7 +5025,7 @@ function createManifestSchemas(canonical) {
           message: `reference presentation ${presentation.localId} references unknown ui app ${presentation.tooltip.app}`
         });
       }
-      if (presentation.open.kind === "page" && !declaredPageIds.has(presentation.open.pageId)) {
+      if (presentation.open?.kind === "page" && !declaredPageIds.has(presentation.open.pageId)) {
         ctx.addIssue({
           code: "custom",
           path: [...path, "open", "pageId"],
@@ -5663,7 +5745,7 @@ function boundPluginDiagnosticMessage(message) {
 import { z as z14 } from "zod";
 function createResolvedContractSchemas(canonical) {
   const { PluginEventLocalId: PluginEventLocalId2 } = canonical ? canonicalPluginEventSchemas : plugin_events_exports;
-  const { ApprovalTypeContribution: ApprovalTypeContribution2, KayUiAppHostCapability: KayUiAppHostCapability2, McpServerAuthMode: McpServerAuthMode2, McpServerUrl: McpServerUrl2, PluginContributionKind: PluginContributionKindSchema, ReferenceOpenBehavior: ReferenceOpenBehavior2, ReferencePresentationUriPattern: ReferencePresentationUriPattern2, ReferencePresentationAddress: ReferencePresentationAddress2, ReferencePresentationUrlClaim: ReferencePresentationUrlClaim2, ReferencePresentationVariants: ReferencePresentationVariants2, UriModuleFacts: UriModuleFacts2, WhiteboardTypeStorage: WhiteboardTypeStorage2 } = canonical ? canonicalContributionSchemas : contributions_exports;
+  const { ApprovalTypeContribution: ApprovalTypeContribution2, KayUiAppHostCapability: KayUiAppHostCapability2, McpServerAuthMode: McpServerAuthMode2, McpServerUrl: McpServerUrl2, PluginContributionKind: PluginContributionKindSchema, ReferenceOpenBehavior: ReferenceOpenBehavior2, ReferencePresentationUriPattern: ReferencePresentationUriPattern2, ReferencePresentationAddress: ReferencePresentationAddress2, ReferencePresentationUrlClaim: ReferencePresentationUrlClaim2, ReferencePresentationVariants: ReferencePresentationVariants2, ReferencePresentationWords: ReferencePresentationWords2, UriModuleFacts: UriModuleFacts2, WhiteboardTypeStorage: WhiteboardTypeStorage2 } = canonical ? canonicalContributionSchemas : contributions_exports;
   const { FileExtensionToken: FileExtensionToken2, GitBasicAuthUser: GitBasicAuthUser2, GitHostName: GitHostName2, GlobalContributionId: GlobalContributionId2, HttpsUrl: HttpsUrl2, LocalContributionId: LocalContributionId2, MimeTypeString: MimeTypeString2, NonEmptyString: NonEmptyString3, PackageAssetPath: PackageAssetPath2, PluginId: PluginId2, PluginNamespace: PluginNamespace2, PluginToolName: PluginToolName2, RegistrableDomain: RegistrableDomain2, SignedInStatusCode: SignedInStatusCode2, TargetEntrypoint: TargetEntrypoint2, UriScheme: UriScheme2 } = canonical ? canonicalCommonSchemas : common_exports;
   const { PluginExternalCliConnect: PluginExternalCliConnect2, PluginOAuthClientSupplier: PluginOAuthClientSupplier2 } = canonical ? canonicalManifestSchemas : manifest_exports;
   const { ResolvedPluginGrants: ResolvedPluginGrants2 } = canonical ? canonicalPermissionSchemas : permissions_exports;
@@ -5827,18 +5909,22 @@ function createResolvedContractSchemas(canonical) {
     localId: LocalContributionId2,
     globalId: GlobalContributionId2,
     uriModule: GlobalContributionId2.optional(),
-    /** The schemes a page-opening presentation answers for: its `scheme`, or its module's. */
+    /** The schemes this presentation is about: its `scheme`, or its module's. */
     schemes: z14.array(UriScheme2).min(1).optional(),
+    /** The module's `displayName`: the source's name in a row. */
+    displayName: NonEmptyString3.optional(),
     addresses: z14.array(ReferencePresentationAddress2).min(1).optional(),
-    resourceKind: NonEmptyString3,
-    open: ReferenceOpenBehavior2,
+    /** Comes with `open`. A presentation with neither only words its module's addresses. */
+    resourceKind: NonEmptyString3.optional(),
+    open: ReferenceOpenBehavior2.optional(),
     /** MIME-specific resource kinds; absent keys use the base presentation. */
     variants: ReferencePresentationVariants2.optional(),
     claims: z14.array(ReferencePresentationUrlClaim2).optional(),
     tooltip: z14.strictObject({
       app: GlobalContributionId2,
       pattern: ReferencePresentationUriPattern2
-    }).optional()
+    }).optional(),
+    words: ReferencePresentationWords2.optional()
   });
   const ResolvedPluginProvisioningRequirement2 = z14.strictObject({
     id: LocalContributionId2,
@@ -6454,10 +6540,13 @@ function resolveKayPluginContractV1(manifest) {
     ...presentation.uriModule === void 0 ? {} : {
       uriModule: resolveGlobalContributionId(namespace, presentation.uriModule)
     },
-    ...presentationSchemes(manifest, presentation),
+    ...presentationSource(manifest, presentation),
     ...presentation.addresses === void 0 ? {} : { addresses: presentation.addresses },
-    resourceKind: presentation.resourceKind,
-    open: presentation.open,
+    ...presentation.open === void 0 || presentation.resourceKind === void 0 ? {} : {
+      resourceKind: presentation.resourceKind,
+      open: presentation.open
+    },
+    ...presentation.words === void 0 ? {} : { words: { ...presentation.words } },
     ...presentation.tooltip === void 0 ? {} : {
       tooltip: {
         app: resolveGlobalContributionId(namespace, presentation.tooltip.app),
@@ -6540,18 +6629,17 @@ function safeResolveKayPluginContractV1(manifest) {
     throw error;
   }
 }
-function presentationSchemes(manifest, presentation) {
-  if (presentation.scheme !== void 0) {
-    return { schemes: [presentation.scheme] };
-  }
-  if (presentation.open.kind !== "page")
-    return {};
+function presentationSource(manifest, presentation) {
   const contributes = manifest.targets?.kay;
   const module = [
     ...contributes?.agent?.contributes?.uriModules ?? [],
     ...contributes?.app?.contributes?.uriModules ?? []
   ].find((candidate) => candidate.localId === presentation.uriModule);
-  return module === void 0 ? {} : { schemes: [...module.schemes] };
+  const schemes = presentation.scheme === void 0 ? module?.schemes : [presentation.scheme];
+  return {
+    ...schemes === void 0 ? {} : { schemes: [...schemes] },
+    ...module?.displayName === void 0 ? {} : { displayName: module.displayName }
+  };
 }
 function uriModuleFacts({ localId: _localId, schemes: _schemes, displayName: _displayName, authService: _authService, authScheme: _authScheme, knownResources: _knownResources, describesOperations: _describesOperations, ...facts }) {
   return facts;
@@ -7453,6 +7541,7 @@ export {
   ReferencePresentationUrlClaim,
   ReferencePresentationVariant,
   ReferencePresentationVariants,
+  ReferencePresentationWords,
   RegistrableDomain,
   ResolvedAuthGrantRequest,
   ResolvedEndpointGrantRequest,
@@ -7504,6 +7593,7 @@ export {
   SignedInStatusCode,
   SkillContribution,
   StorageGrantRequest,
+  TOOL_GLYPHS,
   TargetEntrypoint,
   TargetPermissionSet,
   TargetPermissionWiring,

package/package.json

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