@yaklabs-ai/plugin-protocol 0.48.0 → 0.48.1

package/dist/index.js

@@ -260,8 +260,9 @@ 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_SDK_VERSION = "0.48.1";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.48.0",
   "0.47.0",
   "0.42.0",
   "0.42.1",
@@ -3381,7 +3382,7 @@ function createContributionsSchemas(canonical) {
       })).optional()
     }).optional()
   });
-  const ToolContribution2 = z12.strictObject({
+  const ToolIdentity = z12.strictObject({
     localId: LocalContributionId2,
     toolName: PluginToolName2,
     displayName: OptionalDisplayName,
@@ -3393,7 +3394,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 +3519,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 +5489,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 +5528,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 +6172,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 +6858,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.48.1",
   "description": "The Kay plugin manifest schema (`kay.plugin.v1`) — parse and validate a kay-plugin.json.",
   "author": "YakLabs",
   "type": "module",