@yaklabs-ai/plugin-protocol 0.37.1 → 0.39.0

package/dist/index.d.ts

@@ -1684,6 +1684,7 @@ declare namespace authoringContributionSchemas {
         ReferencePresentationUrlClaim,
         ReferencePresentationTooltip,
         ReferencePresentationAddress,
+        ReferencePresentationWords,
         ReferencePresentationContribution,
         RichViewContribution,
         KayUiAppHostCapability,
@@ -2528,25 +2529,25 @@ declare const canonicalContributionSchemas: {
     }, z.core.$strict>;
     McpServerUrl: z.ZodString;
     McpServerAuthMode: z.ZodEnum<{
+        none: "none";
         oauth: "oauth";
         "api-key": "api-key";
-        none: "none";
     }>;
     McpServerContribution: z.ZodObject<{
         url: z.ZodString;
         auth: z.ZodOptional<z.ZodEnum<{
+            none: "none";
             oauth: "oauth";
             "api-key": "api-key";
-            none: "none";
         }>>;
         authService: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
     McpServerContributions: z.ZodRecord<z.ZodString, z.ZodObject<{
         url: z.ZodString;
         auth: z.ZodOptional<z.ZodEnum<{
+            none: "none";
             oauth: "oauth";
             "api-key": "api-key";
-            none: "none";
         }>>;
         authService: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
@@ -2567,6 +2568,7 @@ declare const canonicalContributionSchemas: {
         uriScheme: z.ZodString;
         relatedKeys: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
         payloadSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+        signal: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>;
     PluginNotificationRuleContribution: z.ZodObject<{
         localId: z.ZodString;
@@ -2680,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>;
@@ -2696,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>;
@@ -2731,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;
@@ -3188,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";
@@ -3434,6 +3498,20 @@ export declare function isCanonicalArtifactOutputUri(uri: string): boolean;
 /** Whether the report permits the plugin to load. */
 export declare function isCompatible(report: KayPluginCompatibilityReport): boolean;
 
+/**
+ * The recognized credential VALUE formats: one detector for the runtime wire's raw-credential
+ * tripwire (`@bonsai/agent-runtime-protocol`'s `hasRawCredentialField`) and for a plugin that
+ * must keep such text out of what it publishes, so the two cannot disagree on what a hit is.
+ * Lives here, below both, because a plugin cannot import the runtime protocol.
+ */
+/**
+ * Whether `value` is a string in a recognized credential format (a whole `sk-...`, `ghp_...` or
+ * `xoxb-...` token, a JWT, an Authorization header value, or anything holding a PEM private key
+ * block). A publisher that copies outside text into an event drops or replaces such a string:
+ * the daemon refuses an event that carries one.
+ */
+export declare function isCredentialShapedText(value: unknown): boolean;
+
 /**
  * Whether a refusal `code` came from the compatibility check: the plugin was written for another
  * SDK or protocol, as opposed to being malformed.
@@ -4156,8 +4234,17 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 0.37.1 adds the required, ungated `featureFlags.value(key)` reader to both backend targets.
  * Unknown keys return false; the host supplies evaluated values before activation and updates them.
  * Additive: existing plugins keep loading. A consumer declares ^0.37.1.
+ *
+ * 0.38.0 adds signals (epic #15668). An event definition may declare `signal: true`, and its payload
+ * 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.37.1";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.39.0";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -4774,6 +4861,7 @@ export declare const KayAppTargetManifest: z.ZodObject<{
             uriScheme: z.ZodString;
             relatedKeys: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
             payloadSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+            signal: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>>;
         notificationRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
             localId: z.ZodString;
@@ -4813,9 +4901,9 @@ export declare const KayAppTargetManifest: z.ZodObject<{
         mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             url: z.ZodString;
             auth: z.ZodOptional<z.ZodEnum<{
+                none: "none";
                 oauth: "oauth";
                 "api-key": "api-key";
-                none: "none";
             }>>;
             authService: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
@@ -5545,6 +5633,7 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         uriScheme: z.ZodString;
                         relatedKeys: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                         payloadSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+                        signal: z.ZodOptional<z.ZodBoolean>;
                     }, z.core.$strict>>>;
                     notificationRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
                         localId: z.ZodString;
@@ -5584,9 +5673,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                         url: z.ZodString;
                         auth: z.ZodOptional<z.ZodEnum<{
+                            none: "none";
                             oauth: "oauth";
                             "api-key": "api-key";
-                            none: "none";
                         }>>;
                         authService: z.ZodOptional<z.ZodString>;
                     }, z.core.$strict>>>;
@@ -5659,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>;
@@ -5694,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;
@@ -6792,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>;
@@ -6827,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;
@@ -6996,9 +7147,9 @@ export declare const MCP_SIGN_IN_SCHEME_KIND: {
 };
 
 export declare const McpServerAuthMode: z.ZodEnum<{
+    none: "none";
     oauth: "oauth";
     "api-key": "api-key";
-    none: "none";
 }>;
 
 export declare type McpServerAuthMode = z.infer<typeof McpServerAuthMode>;
@@ -7006,9 +7157,9 @@ export declare type McpServerAuthMode = z.infer<typeof McpServerAuthMode>;
 export declare const McpServerContribution: z.ZodObject<{
     url: z.ZodString;
     auth: z.ZodOptional<z.ZodEnum<{
+        none: "none";
         oauth: "oauth";
         "api-key": "api-key";
-        none: "none";
     }>>;
     authService: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
@@ -7018,9 +7169,9 @@ export declare type McpServerContribution = z.infer<typeof McpServerContribution
 export declare const McpServerContributions: z.ZodRecord<z.ZodString, z.ZodObject<{
     url: z.ZodString;
     auth: z.ZodOptional<z.ZodEnum<{
+        none: "none";
         oauth: "oauth";
         "api-key": "api-key";
-        none: "none";
     }>>;
     authService: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>>;
@@ -7149,7 +7300,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", "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", "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. */
@@ -7157,12 +7308,32 @@ export declare const PLUGIN_DIAGNOSTIC_MESSAGE_CAP = 300;
 
 export declare const PLUGIN_EVENT_ID_MAX_BYTES = 1024;
 
+/**
+ * The `name` of the error a host throws when it refuses a publish because the event is invalid.
+ * A publisher skips such an event; any other publish failure may be transient.
+ */
+export declare const PLUGIN_EVENT_REFUSED_ERROR_NAME = "PluginEventRefusedError";
+
 /** The root `<svg>` attribute a tile icon declares itself with. */
 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"];
 
+/** 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"];
+
+export declare const PLUGIN_SIGNAL_LABEL_MAX = 64;
+
+export declare const PLUGIN_SIGNAL_LABELS_MAX = 20;
+
+/** The `related` keys a signal may use; `thread` is required on every signal publish. */
+export declare const PLUGIN_SIGNAL_RELATED_KEYS: readonly ["thread", "from", "to", "cc"];
+
+export declare const PLUGIN_SIGNAL_SNIPPET_MAX = 500;
+
+export declare const PLUGIN_SIGNAL_TITLE_MAX = 300;
+
 export declare const PluginAgentDefinitionPermissionRule: z.ZodObject<{
     effect: z.ZodEnum<{
         allow: "allow";
@@ -7751,6 +7922,10 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     target: "kay.app";
     slug: "workflows.define";
     envelope: Record<string, never>;
+} | {
+    target: "kay.app";
+    slug: "workflows.signals";
+    envelope: Record<string, never>;
 } | {
     target: "kay.app";
     slug: "session-events.subscribe";
@@ -7996,6 +8171,10 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     target: "kay.app";
     slug: "workflows.define";
     envelope: Record<string, never>;
+} | {
+    target: "kay.app";
+    slug: "workflows.signals";
+    envelope: Record<string, never>;
 } | {
     target: "kay.app";
     slug: "session-events.subscribe";
@@ -8237,6 +8416,10 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
     target: z.ZodLiteral<"kay.app">;
     slug: z.ZodLiteral<"workflows.define">;
     envelope: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    target: z.ZodLiteral<"kay.app">;
+    slug: z.ZodLiteral<"workflows.signals">;
+    envelope: z.ZodObject<{}, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     target: z.ZodLiteral<"kay.app">;
     slug: z.ZodLiteral<"session-events.subscribe">;
@@ -8521,6 +8704,10 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"workflows.define">;
         envelope: z.ZodObject<{}, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.app">;
+        slug: z.ZodLiteral<"workflows.signals">;
+        envelope: z.ZodObject<{}, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"session-events.subscribe">;
@@ -8804,6 +8991,10 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
             target: z.ZodLiteral<"kay.app">;
             slug: z.ZodLiteral<"workflows.define">;
             envelope: z.ZodObject<{}, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            target: z.ZodLiteral<"kay.app">;
+            slug: z.ZodLiteral<"workflows.signals">;
+            envelope: z.ZodObject<{}, z.core.$strict>;
         }, z.core.$strict>, z.ZodObject<{
             target: z.ZodLiteral<"kay.app">;
             slug: z.ZodLiteral<"session-events.subscribe">;
@@ -9121,6 +9312,10 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"workflows.define">;
         envelope: z.ZodObject<{}, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.app">;
+        slug: z.ZodLiteral<"workflows.signals">;
+        envelope: z.ZodObject<{}, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"session-events.subscribe">;
@@ -9403,6 +9598,7 @@ export declare const PluginEventDefinitionContribution: z.ZodObject<{
     uriScheme: z.ZodString;
     relatedKeys: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     payloadSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<authoringCommonSchemas.JsonValue, unknown, z.core.$ZodTypeInternals<authoringCommonSchemas.JsonValue, unknown>>>>;
+    signal: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 
 export declare type PluginEventDefinitionContribution = z.infer<typeof PluginEventDefinitionContribution>;
@@ -10211,6 +10407,92 @@ export declare const PluginProvisioningRequirement: z.ZodObject<{
 
 export declare type PluginProvisioningRequirement = z.infer<typeof PluginProvisioningRequirement>;
 
+export declare const PluginSignal: z.ZodObject<{
+    kind: z.ZodEnum<{
+        message: "message";
+        status: "status";
+        request: "request";
+        mention: "mention";
+        invite: "invite";
+    }>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        out: "out";
+        in: "in";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    snippet: z.ZodOptional<z.ZodString>;
+    actor: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        uri: z.ZodString;
+    }, z.core.$strict>>;
+    addressed: z.ZodOptional<z.ZodEnum<{
+        mention: "mention";
+        cc: "cc";
+        direct: "direct";
+        group: "group";
+        none: "none";
+    }>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dueAt: z.ZodOptional<z.ZodISODateTime>;
+    state: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        resolved: "resolved";
+    }>>;
+}, z.core.$strict>;
+
+export declare type PluginSignal = z.infer<typeof PluginSignal>;
+
+export declare type PluginSignalKind = (typeof PLUGIN_SIGNAL_KINDS)[number];
+
+/**
+ * `PluginSignal` v1 as JSON Schema, for the hosts that check a `payload.*` filter path against a
+ * declaration. A signal definition declares no `payloadSchema`; this stands in for it.
+ */
+export declare function pluginSignalPayloadJsonSchema(): Record<string, unknown>;
+
+export declare const PluginSignalPublish: z.ZodObject<{
+    payload: z.ZodObject<{
+        kind: z.ZodEnum<{
+            message: "message";
+            status: "status";
+            request: "request";
+            mention: "mention";
+            invite: "invite";
+        }>;
+        direction: z.ZodOptional<z.ZodEnum<{
+            out: "out";
+            in: "in";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+        snippet: z.ZodOptional<z.ZodString>;
+        actor: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            uri: z.ZodString;
+        }, z.core.$strict>>;
+        addressed: z.ZodOptional<z.ZodEnum<{
+            mention: "mention";
+            cc: "cc";
+            direct: "direct";
+            group: "group";
+            none: "none";
+        }>>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dueAt: z.ZodOptional<z.ZodISODateTime>;
+        state: z.ZodOptional<z.ZodEnum<{
+            open: "open";
+            resolved: "resolved";
+        }>>;
+    }, z.core.$strict>;
+    related: z.ZodObject<{
+        thread: z.ZodString;
+        from: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        to: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        cc: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+
+export declare type PluginSignalPublish = z.infer<typeof PluginSignalPublish>;
+
 export declare const PluginSkillSourceDeclaration: z.ZodDiscriminatedUnion<[z.ZodObject<{
     channel: z.ZodLiteral<"installer">;
     localId: z.ZodString;
@@ -10368,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>;
@@ -10403,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>;
@@ -10458,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
@@ -10954,9 +11301,9 @@ export declare const ResolvedKayAppMcpServer: z.ZodObject<{
     pluginId: z.ZodString;
     url: z.ZodString;
     auth: z.ZodEnum<{
+        none: "none";
         oauth: "oauth";
         "api-key": "api-key";
-        none: "none";
     }>;
     authServiceId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
@@ -12247,9 +12594,9 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
         pluginId: z.ZodString;
         url: z.ZodString;
         auth: z.ZodEnum<{
+            none: "none";
             oauth: "oauth";
             "api-key": "api-key";
-            none: "none";
         }>;
         authServiceId: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
@@ -12265,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;
@@ -12277,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>;
@@ -12312,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;
@@ -12745,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;
@@ -12757,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>;
@@ -12792,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>;
@@ -13835,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;
@@ -13844,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";