@yaklabs-ai/plugin-protocol 0.12.2 → 0.12.4

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.4"
   }
 }
 ```

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -1396,9 +1396,21 @@ export declare type CliBinaryName = z.infer<typeof CliBinaryName>;
  * `aliases`) carry a read/write split the approval policy honors, and — for a
  * vendored binary — a credential injected into the child process env under
  * `authEnvVar`, resolved from `authService`. `readOnly`/`write` are argv prefix
- * strings (e.g. `"apps list"`) the plugin advertises as read vs write — contract
+ * strings (e.g. `"apps list"`) the plugin advertises as read vs write: contract
  * data consumed by approval policy and the prompt, not enforced here.
  *
+ * How the host matches a prefix (#10220): it splits the prefix on single spaces
+ * and compares each word with the command's argv at the same position, starting
+ * with the first argument after the binary. Options are never skipped or
+ * interpreted, so `"apps list"` matches `fly apps list --json` but not
+ * `fly --verbose apps list` or `fly apps --org x list`. A command that matches
+ * no prefix is unknown and goes through the user's approval policy. A `write`
+ * match wins over a `readOnly` match. A prefix with an empty word (a leading,
+ * trailing or doubled space) never matches. So list a read only when its
+ * leading words alone make it a read, and expect a command written option-first
+ * to ask: that is the price of an option value never posing as a subcommand
+ * (`vercel --cwd ls deploy` deploys from the directory `ls`).
+ *
  * `provider` (decision 007) selects where the binary comes from:
  *
  * - `"vendored"` (the default when omitted) — a binary from `@kay/vendored-cli`'s
@@ -1961,7 +1973,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", "0.12.3"];
 
 export declare const KAY_PLUGIN_PROTOCOL_PACKAGE_NAME: "@kay/plugin-protocol";
 
@@ -2142,8 +2154,24 @@ 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.
+ *
+ * 0.12.4 adds `app.repos` (`KayAppRepos`): `resolve(folder)` answers which git checkout encloses a
+ * folder (repo root, primary checkout, common dir, remotes, origin), and `linkedWorktrees(commonDir)`
+ * lists git's linked-worktree registry, both read by the host asynchronously under a time limit and
+ * answering `unknown` rather than throwing. Always present and ungated, like `app.paths`. Additive:
+ * a plugin compiled against 0.12.3 never reads it. A plugin that calls it declares `^0.12.4`, so an
+ * older host refuses a directory or repository plugin at load instead of the call failing.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.12.2";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.12.4";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -2814,6 +2842,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 +3427,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 +5681,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 +5696,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 +6890,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 +7326,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.4";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.8.0",
   "0.8.1",
@@ -129,7 +129,9 @@ var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
   "0.11.0",
   "0.11.1",
   "0.12.0",
-  "0.12.1"
+  "0.12.1",
+  "0.12.2",
+  "0.12.3"
 ];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
@@ -2540,7 +2542,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 +3258,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.4",
   "description": "The Kay plugin manifest schema (`kay.plugin.v1`) — parse and validate a kay-plugin.json.",
   "author": "YakLabs",
   "type": "module",