@yaklabs-ai/plugin-protocol 0.48.0 → 0.49.0

package/dist/index.js

@@ -260,14 +260,8 @@ 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.48.0";
-var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
-  "0.47.0",
-  "0.42.0",
-  "0.42.1",
-  "0.43.0",
-  "0.44.0"
-];
+var KAY_PLUGIN_SDK_VERSION = "0.49.0";
+var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [];
 var KAY_PLUGIN_TARGET_NAMES = [
   "kay.agent",
   "kay.app",
@@ -1730,7 +1724,9 @@ function retiredPermissionAsksIn(rawManifest) {
 // packages/plugin-protocol/dist/authority.js
 var RETIRED_PLUGIN_CAPABILITY_SLUGS = [
   "filesystem.read",
-  "filesystem.write"
+  "filesystem.write",
+  "memory.read",
+  "memory.write"
 ];
 var RENAMED_PLUGIN_CAPABILITY_SLUGS = {
   "jev.use": "systemOne.use",
@@ -1744,8 +1740,7 @@ var PLUGIN_CAPABILITY_SLUGS = [
   "process.spawn",
   "sessions.read",
   "signals.read",
-  "memory.read",
-  "memory.write",
+  "uri.call",
   "skills.read",
   "skills.write",
   "skills.share",
@@ -1811,7 +1806,7 @@ var AGENT_PERMISSION_RULE_FIELDS = [
   "mode"
 ];
 function createAuthoritySchemas(canonical) {
-  const { ArtifactGenerationId: ArtifactGenerationId2, NonEmptyString: NonEmptyString3 } = canonical ? canonicalCommonSchemas : common_exports;
+  const { ArtifactGenerationId: ArtifactGenerationId2, NonEmptyString: NonEmptyString3, UriScheme: UriScheme2 } = canonical ? canonicalCommonSchemas : common_exports;
   const { PluginAgentDefinitionPermissionRule: PluginAgentDefinitionPermissionRule2 } = canonical ? canonicalPermissionSchemas : permissions_exports;
   const WhiteboardCapabilityScope2 = z10.enum(["own-types", "all-types"]);
   const WhiteboardCapabilityOperation2 = z10.enum([
@@ -1902,14 +1897,12 @@ function createAuthoritySchemas(canonical) {
       envelope: z10.strictObject({})
     }),
     z10.strictObject({
-      target: z10.literal("kay.app"),
-      slug: z10.literal("memory.read"),
-      envelope: z10.strictObject({})
-    }),
-    z10.strictObject({
-      target: z10.literal("kay.app"),
-      slug: z10.literal("memory.write"),
-      envelope: z10.strictObject({})
+      target: z10.enum(["kay.agent", "kay.app"]),
+      slug: z10.literal("uri.call"),
+      envelope: z10.strictObject({
+        scheme: UriScheme2,
+        verb: z10.enum(["read", "list", "search", "write", "edit", "delete"])
+      })
     }),
     z10.strictObject({
       // Read every managed skill and its history: identity, versions, revisions, changes against
@@ -2255,8 +2248,6 @@ function sameClaim(a, b) {
     case "sessions.update":
     case "sessions.read":
     case "signals.read":
-    case "memory.read":
-    case "memory.write":
     case "skills.read":
     case "skills.write":
     case "skills.share":
@@ -2281,6 +2272,8 @@ function sameClaim(a, b) {
     case "model-selection.register":
     case "system-prompt.register":
       return true;
+    case "uri.call":
+      return b.slug === "uri.call" && a.envelope.scheme === b.envelope.scheme && a.envelope.verb === b.envelope.verb;
     case "network.connect":
       return b.slug === "network.connect" && a.envelope.connect === b.envelope.connect;
     case "web-session.request":
@@ -2342,8 +2335,6 @@ function envelopePairs(a, b) {
     case "sessions.update":
     case "sessions.read":
     case "signals.read":
-    case "memory.read":
-    case "memory.write":
     case "skills.read":
     case "skills.write":
     case "skills.share":
@@ -2368,6 +2359,11 @@ function envelopePairs(a, b) {
     case "model-selection.register":
     case "system-prompt.register":
       return [];
+    case "uri.call":
+      return b.slug === "uri.call" ? [
+        [a.envelope.scheme, b.envelope.scheme],
+        [a.envelope.verb, b.envelope.verb]
+      ] : [];
     case "network.connect":
       return b.slug === "network.connect" ? [[a.envelope.connect, b.envelope.connect]] : [];
     case "web-session.request":
@@ -3381,7 +3377,7 @@ function createContributionsSchemas(canonical) {
       })).optional()
     }).optional()
   });
-  const ToolContribution2 = z12.strictObject({
+  const ToolIdentity = z12.strictObject({
     localId: LocalContributionId2,
     toolName: PluginToolName2,
     displayName: OptionalDisplayName,
@@ -3393,7 +3389,34 @@ function createContributionsSchemas(canonical) {
     scheme: NonEmptyString3.optional(),
     resourcePrefix: z12.string().max(256).optional(),
     // Arguments whose string values name the resources a call touches.
-    resourceArgs: z12.array(NonEmptyString3).min(1).optional()
+    resourceArgs: z12.array(NonEmptyString3).min(1).optional(),
+    resourceTrim: z12.literal(true).optional(),
+    defaultPermission: z12.enum(["allow", "ask", "never"]).optional(),
+    /** First matching rule wins; every condition in its when list must hold. */
+    classificationRules: z12.array(z12.strictObject({
+      when: z12.array(z12.union([
+        z12.strictObject({
+          arg: NonEmptyString3,
+          equals: z12.union([
+            z12.string(),
+            z12.number(),
+            z12.boolean(),
+            z12.null()
+          ])
+        }),
+        z12.strictObject({ arg: NonEmptyString3, present: z12.boolean() })
+      ])).min(1).max(32),
+      kind: z12.enum(["read", "mutate", "destructive", "execute"]),
+      ruleKey: NonEmptyString3.optional()
+    })).min(1).max(64).optional()
+  });
+  const ToolContribution2 = z12.strictObject({
+    ...ToolIdentity.shape,
+    parameters: JsonSchema.optional(),
+    executionMode: z12.enum(["sequential", "parallel"]).optional(),
+    promptSnippet: NonEmptyString3.optional(),
+    promptGuidelines: z12.array(NonEmptyString3).optional(),
+    permission: ToolPermission2.optional()
   });
   const AgentToolContribution2 = z12.strictObject({
     ...ToolContribution2.shape,
@@ -3491,7 +3514,49 @@ function createContributionsSchemas(canonical) {
     }).exactOptional(),
     skills: z12.array(NonEmptyString3).exactOptional()
   });
+  const ScreenActionOption = z12.discriminatedUnion("kind", [
+    z12.strictObject({
+      kind: z12.literal("exact"),
+      description: NonEmptyString3,
+      verb: z12.enum(["read", "write", "edit", "delete"]),
+      uri: NonEmptyString3
+    }),
+    z12.strictObject({
+      kind: z12.literal("catch-all"),
+      description: NonEmptyString3,
+      verb: z12.enum(["read", "write", "edit", "delete"])
+    })
+  ]);
   const UriModuleFactsShape = {
+    screenActions: z12.strictObject({
+      scheme: UriScheme2,
+      hosts: z12.array(NonEmptyString3),
+      paths: z12.array(NonEmptyString3).min(1).optional(),
+      apps: z12.array(NonEmptyString3),
+      options: z12.record(NonEmptyString3, ScreenActionOption)
+    }).superRefine((catalog, ctx) => {
+      if (catalog.hosts.length === 0 && catalog.apps.length === 0) {
+        ctx.addIssue({
+          code: "custom",
+          message: "screen actions need a host or app"
+        });
+      }
+      for (const [key, option] of Object.entries(catalog.options)) {
+        if (key === "none")
+          ctx.addIssue({
+            code: "custom",
+            path: ["options", key],
+            message: "none is reserved"
+          });
+        if (option.kind === "exact" && !option.uri.startsWith(`${catalog.scheme}://`)) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["options", key, "uri"],
+            message: "screen action URI must use its catalog scheme"
+          });
+        }
+      }
+    }).exactOptional(),
     /** Addresses the module answers, in match order; see `@herd/uri`'s `UriClaim`. */
     claims: z12.array(UriClaimContribution).min(1).exactOptional(),
     /** The module's routes, as its scheme-root `help` lists them. */
@@ -5419,6 +5484,35 @@ function createManifestSchemas(canonical) {
     for (const target of ["agent", "app"]) {
       const contributes = target === "agent" ? manifest.targets?.kay?.agent?.contributes : manifest.targets?.kay?.app?.contributes;
       for (const tool of contributes?.tools ?? []) {
+        const toolPath = ["targets", "kay", target, "contributes", "tools"];
+        if (tool.parameters === void 0 && tool.permission !== void 0 && target === "app") {
+          ctx.addIssue({
+            code: "custom",
+            path: toolPath,
+            message: `tool ${tool.localId} declares permission without parameters`
+          });
+        }
+        if (tool.parameters !== void 0 && tool.description === void 0 && target === "app") {
+          ctx.addIssue({
+            code: "custom",
+            path: toolPath,
+            message: `tool ${tool.localId} declares parameters without a description`
+          });
+        }
+        const properties = tool.parameters?.["properties"];
+        const argumentsUsed = [
+          ...target === "app" ? tool.permission?.resourceArgs ?? [] : [],
+          ...(tool.permission?.classificationRules ?? []).flatMap((rule) => rule.when.map((condition) => condition.arg))
+        ];
+        for (const arg of argumentsUsed) {
+          if (typeof properties !== "object" || properties === null || !Object.hasOwn(properties, arg)) {
+            ctx.addIssue({
+              code: "custom",
+              path: toolPath,
+              message: `tool ${tool.localId} names permission argument ${arg}, which is not a parameter`
+            });
+          }
+        }
         const existing = toolNames.get(tool.toolName);
         if (existing !== void 0) {
           ctx.addIssue({
@@ -5429,6 +5523,15 @@ function createManifestSchemas(canonical) {
         }
         toolNames.set(tool.toolName, tool.localId);
       }
+      for (const module of contributes?.uriModules ?? []) {
+        if (module.screenActions !== void 0 && !module.schemes.includes(module.screenActions.scheme)) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["targets", "kay", target, "contributes", "uriModules"],
+            message: `screen actions must use a scheme owned by module ${module.localId}`
+          });
+        }
+      }
     }
     const converterMimeTypes = /* @__PURE__ */ new Map();
     for (const converter of manifest.targets?.kay?.agent?.contributes?.converters ?? []) {
@@ -6064,7 +6167,7 @@ function createResolvedContractSchemas(canonical) {
     }).optional(),
     permission: canonical ? canonicalContributionSchemas.ToolPermission.optional() : ToolPermission.optional()
   });
-  const ResolvedKayAppTool2 = ResolvedKayToolId;
+  const ResolvedKayAppTool2 = ResolvedKayAgentTool2.omit({ requiresAuth: true });
   const ResolvedKayAppDataSource2 = z14.strictObject({
     localId: LocalContributionId2,
     globalId: GlobalContributionId2,
@@ -6750,6 +6853,7 @@ function resolveKayPluginContractV1(manifest) {
     ...tool.permission === void 0 ? {} : { permission: tool.permission }
   }));
   const kayAppTools = manifest.targets?.kay?.app?.contributes?.tools?.map((tool) => ({
+    ...tool,
     localId: tool.localId,
     globalId: resolveGlobalContributionId(namespace, tool.localId),
     toolName: tool.toolName

package/package.json

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