@yaklabs-ai/plugin-protocol 0.12.2 → 0.12.3

package/README.md

@@ -11,7 +11,7 @@ flow.
 ```json
 {
   "dependencies": {
-    "@kay/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.12.2"
+    "@kay/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.12.3"
   }
 }
 ```

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -1961,7 +1961,7 @@ export declare const KAY_APP_DATA_SNAPSHOT_MAX_BYTES: number;
 export declare const KAY_EVENT_PUBLISHER_ID: "kay";
 
 /** Released SDK contracts still implemented by the host, alongside its current SDK. */
-export declare const KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS: readonly ["0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.9.0", "0.9.1", "0.10.0", "0.11.0", "0.11.1", "0.12.0", "0.12.1"];
+export declare const KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS: readonly ["0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.9.0", "0.9.1", "0.10.0", "0.11.0", "0.11.1", "0.12.0", "0.12.1", "0.12.2"];
 
 export declare const KAY_PLUGIN_PROTOCOL_PACKAGE_NAME: "@kay/plugin-protocol";
 
@@ -2142,8 +2142,17 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * plugin that subscribes to it declares `^0.12.2`, so an older host refuses a directory or
  * repository plugin at load instead of the subscription never firing. That check never runs for a
  * bundled plugin, which ships with the SDK it calls.
+ *
+ * 0.12.3 adds the `page` reference open kind (`{ kind: "page", pageId }` on a
+ * `referencePresentations` entry), and lets a presentation name a `kay.app` URI module as well as a
+ * `kay.agent` one. A plugin's own `scheme://` references then pill with its icon and the module's
+ * `describe` title, and a click opens the plugin's own registered page with the reference URI as
+ * the page's `objectId`. Additive: a `^0.12.2` plugin keeps loading. The value is new schema, so an
+ * older host refuses the whole manifest at parse (`manifest-schema-invalid`), before any range
+ * check runs. A plugin that declares it still declares `^0.12.3`, so the install-time version
+ * checks name the mismatch instead of a schema error.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.12.2";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.12.3";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -2814,6 +2823,9 @@ export declare const KayPluginManifestV1: 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">;
                         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                             resourceKind: z.ZodString;
@@ -3396,6 +3408,9 @@ export declare const KayUiTargetManifest: 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">;
             variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                 resourceKind: z.ZodString;
@@ -5647,6 +5662,9 @@ export declare const ReferenceOpenBehavior: 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">;
 
 export declare type ReferenceOpenBehavior = z.infer<typeof ReferenceOpenBehavior>;
@@ -5659,6 +5677,9 @@ export declare const ReferencePresentationContribution: 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">;
     variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         resourceKind: z.ZodString;
@@ -6850,6 +6871,9 @@ export declare const ResolvedPluginContractV1: 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">;
         variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             resourceKind: z.ZodString;
@@ -7283,6 +7307,9 @@ export declare const ResolvedReferencePresentation: 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">;
     variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         resourceKind: z.ZodString;

package/dist/index.js

@@ -115,7 +115,7 @@ import { z as z2 } from "zod";
 import { z } from "zod";
 var KAY_PLUGIN_PROTOCOL_VERSION = "kay.plugin.v1";
 var KAY_PLUGIN_PROTOCOL_PACKAGE_NAME = "@kay/plugin-protocol";
-var KAY_PLUGIN_SDK_VERSION = "0.12.2";
+var KAY_PLUGIN_SDK_VERSION = "0.12.3";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.8.0",
   "0.8.1",
@@ -129,7 +129,8 @@ var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.11.0",
   "0.11.1",
   "0.12.0",
-  "0.12.1"
+  "0.12.1",
+  "0.12.2"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -2540,7 +2541,13 @@ var ResultRendererContribution = z7.strictObject({
 });
 var ReferenceOpenBehavior = z7.discriminatedUnion("kind", [
   z7.strictObject({ kind: z7.literal("working-document") }),
-  z7.strictObject({ kind: z7.literal("browser-pane") })
+  z7.strictObject({ kind: z7.literal("browser-pane") }),
+  /**
+   * Open one of the presenting plugin's OWN registered pages (`registerPage`'s
+   * descriptor id) with the reference's canonical URI as the page's `objectId`.
+   * Needs no web address, so a plugin-only resource (`user-todo://items/3`) can pill.
+   */
+  z7.strictObject({ kind: z7.literal("page"), pageId: NonEmptyString })
 ]);
 var ReferencePresentationVariant = z7.strictObject({
   resourceKind: NonEmptyString,
@@ -3250,7 +3257,10 @@ var KayPluginManifestV1 = z8.strictObject({
   }
   const subscribedUiEvents = new Set(manifest.targets?.kay?.ui?.contributes?.eventSubscriptions?.map((subscription) => subscription.event) ?? []);
   const invokedUiEndpoints = new Set(manifest.permissions?.byTarget["kay.ui"]?.endpoints?.filter((grant) => grant.operations.includes("invoke")).map((grant) => grant.endpoint) ?? []);
-  const uriModuleIds = new Set(manifest.targets?.kay?.agent?.contributes?.uriModules?.map((module) => module.localId) ?? []);
+  const uriModuleIds = new Set([
+    ...manifest.targets?.kay?.agent?.contributes?.uriModules ?? [],
+    ...manifest.targets?.kay?.app?.contributes?.uriModules ?? []
+  ].map((module) => module.localId));
   const presentationByUriModule = /* @__PURE__ */ new Map();
   for (const [index, presentation] of (manifest.targets?.kay?.ui?.contributes?.referencePresentations ?? []).entries()) {
     const path = [

package/package.json

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