@yaklabs-ai/plugin-sdk 0.15.3 → 0.27.0

package/dist/whiteboard.js

@@ -0,0 +1,174 @@
+// packages/plugin-protocol/dist/whiteboard.js
+import { z as z4 } from "zod";
+
+// packages/plugin-protocol/dist/common.js
+import { z as z3 } from "zod";
+
+// packages/plugin-protocol/dist/schema-form.js
+import { z } from "zod";
+function pluginString(canonical) {
+  return canonical ? z.string().refine((value) => value === value.trim(), {
+    message: "Expected an unpadded string"
+  }) : z.string().trim();
+}
+
+// packages/plugin-protocol/dist/json.js
+import { z as z2 } from "zod";
+var JsonValue = z2.lazy(() => z2.union([
+  z2.string(),
+  z2.number(),
+  z2.boolean(),
+  z2.null(),
+  z2.array(JsonValue),
+  z2.record(z2.string(), JsonValue)
+]));
+var JsonObject = z2.record(z2.string(), JsonValue);
+var JsonSchema = z2.record(z2.string(), JsonValue);
+
+// packages/plugin-protocol/dist/common.js
+var KAY_PLUGIN_PROTOCOL_VERSION = "kay.plugin.v1";
+var KAY_PLUGIN_TARGET_NAMES = [
+  "kay.agent",
+  "kay.app",
+  "kay.ui"
+];
+var KayPluginProtocolVersion = z3.literal(KAY_PLUGIN_PROTOCOL_VERSION);
+var PluginTargetName = z3.enum(KAY_PLUGIN_TARGET_NAMES);
+var PLUGIN_ID_PATTERN = /^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)*$/;
+var LOCAL_CONTRIBUTION_ID_PATTERN = /^[a-z][a-z0-9-]*$/;
+var PLUGIN_TOOL_NAME_PATTERN = /^[a-z][a-z0-9_-]*$/;
+var PACKAGE_ASSET_PATH_PATTERN = /^\.\/(?:[A-Za-z0-9._-]+\/)*[A-Za-z0-9._-]+$/;
+var KAY_EVENT_PUBLISHER_ID = "kay";
+var HOST_LABEL_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+var MAX_HOST_LENGTH = 253;
+var MAX_HOST_LABEL_LENGTH = 63;
+function createCommonSchemas(canonical) {
+  const NonEmptyString2 = pluginString(canonical).min(1);
+  const PluginId2 = pluginString(canonical).regex(PLUGIN_ID_PATTERN).refine((id) => id !== KAY_EVENT_PUBLISHER_ID, {
+    message: `'${KAY_EVENT_PUBLISHER_ID}' is reserved for Bonsai's own event publisher`
+  });
+  const PluginNamespace2 = PluginId2;
+  const LocalContributionId2 = pluginString(canonical).regex(LOCAL_CONTRIBUTION_ID_PATTERN);
+  const GlobalContributionId2 = pluginString(canonical).regex(PLUGIN_ID_PATTERN);
+  const PluginToolName2 = pluginString(canonical).regex(PLUGIN_TOOL_NAME_PATTERN);
+  const AuthServiceReference2 = GlobalContributionId2;
+  const AuthSchemeReference2 = GlobalContributionId2;
+  const AdapterSelectionKey2 = pluginString(canonical).regex(PLUGIN_ID_PATTERN);
+  const AdapterPlacement2 = z3.enum(["local-only", "anywhere"]);
+  const UriScheme2 = pluginString(canonical).regex(/^[a-z][a-z0-9+.-]*$/);
+  const MimeTypeString2 = pluginString(canonical).regex(/^[a-z0-9][a-z0-9!#$&^_.+-]*\/[a-z0-9][a-z0-9!#$&^_.+-]*$/);
+  const FileExtensionToken2 = pluginString(canonical).regex(/^[a-z0-9]+$/);
+  const CliBinaryName2 = NonEmptyString2.refine((value) => !value.includes("/"), {
+    message: "cli binding binary/alias must be a basename, not a path (no '/')"
+  });
+  const CliAuthEnvVarName2 = pluginString(canonical).regex(/^[A-Z][A-Z0-9_]*$/);
+  const PackageAssetPath2 = pluginString(canonical).regex(PACKAGE_ASSET_PATH_PATTERN).refine((value) => !value.split("/").includes(".."), {
+    message: "package asset path must not contain a '..' path segment"
+  });
+  const PluginSourceClass2 = z3.enum([
+    "bundled",
+    "org-shared",
+    "user-local",
+    "verified-marketplace",
+    "freeform"
+  ]);
+  const ArtifactGenerationId2 = pluginString(canonical).min(1).brand();
+  const HttpsUrl2 = z3.url({ protocol: /^https$/ });
+  const RegistrableDomain2 = pluginString(canonical).regex(/^[a-z0-9-]+(?:\.[a-z0-9-]+)+$/);
+  const GitHostName2 = RegistrableDomain2.max(MAX_HOST_LENGTH).refine((host) => host.split(".").every((label) => label.length <= MAX_HOST_LABEL_LENGTH && HOST_LABEL_PATTERN.test(label)), {
+    message: "git host labels must be 1-63 characters and start and end with a letter or digit"
+  });
+  const GitBasicAuthUser2 = pluginString(canonical).min(1).max(128).regex(/^[A-Za-z0-9._~-]+$/);
+  const HttpStatusCode2 = z3.number().int().min(100).max(599);
+  const SignedInStatusCode2 = HttpStatusCode2.refine((status) => !(status < 200 || status >= 300 && status < 400), {
+    message: "signedInStatuses cannot include 1xx or 3xx: the probe follows redirects and never observes them as a final status"
+  });
+  const JsonPointer2 = pluginString(canonical).regex(/^(?:\/(?:[^/~]|~[01])*)*$/);
+  const TargetEntrypoint2 = z3.strictObject({
+    module: NonEmptyString2,
+    export: NonEmptyString2.optional()
+  });
+  return {
+    NonEmptyString: NonEmptyString2,
+    PluginId: PluginId2,
+    PluginNamespace: PluginNamespace2,
+    LocalContributionId: LocalContributionId2,
+    GlobalContributionId: GlobalContributionId2,
+    PluginToolName: PluginToolName2,
+    AuthServiceReference: AuthServiceReference2,
+    AuthSchemeReference: AuthSchemeReference2,
+    AdapterSelectionKey: AdapterSelectionKey2,
+    AdapterPlacement: AdapterPlacement2,
+    UriScheme: UriScheme2,
+    MimeTypeString: MimeTypeString2,
+    FileExtensionToken: FileExtensionToken2,
+    CliBinaryName: CliBinaryName2,
+    CliAuthEnvVarName: CliAuthEnvVarName2,
+    PackageAssetPath: PackageAssetPath2,
+    PluginSourceClass: PluginSourceClass2,
+    ArtifactGenerationId: ArtifactGenerationId2,
+    HttpsUrl: HttpsUrl2,
+    RegistrableDomain: RegistrableDomain2,
+    GitHostName: GitHostName2,
+    GitBasicAuthUser: GitBasicAuthUser2,
+    HttpStatusCode: HttpStatusCode2,
+    SignedInStatusCode: SignedInStatusCode2,
+    JsonPointer: JsonPointer2,
+    TargetEntrypoint: TargetEntrypoint2
+  };
+}
+var { NonEmptyString, PluginId, PluginNamespace, LocalContributionId, GlobalContributionId, PluginToolName, AuthServiceReference, AuthSchemeReference, AdapterSelectionKey, AdapterPlacement, UriScheme, MimeTypeString, FileExtensionToken, CliBinaryName, CliAuthEnvVarName, PackageAssetPath, PluginSourceClass, ArtifactGenerationId, HttpsUrl, RegistrableDomain, GitHostName, GitBasicAuthUser, HttpStatusCode, SignedInStatusCode, JsonPointer, TargetEntrypoint } = createCommonSchemas(false);
+var canonicalCommonSchemas = createCommonSchemas(true);
+
+// packages/plugin-protocol/dist/whiteboard.js
+var WhiteboardValue = JsonValue;
+var WhiteboardEntryEnvelope = z4.strictObject({
+  id: NonEmptyString,
+  typeId: GlobalContributionId,
+  schemaVersion: z4.number().int().positive(),
+  title: z4.string(),
+  authorSessionId: NonEmptyString.nullable()
+});
+var WhiteboardEntrySummary = z4.strictObject({
+  name: NonEmptyString,
+  entry: WhiteboardEntryEnvelope,
+  revision: NonEmptyString
+});
+var WhiteboardEntrySnapshot = WhiteboardEntrySummary.extend({
+  value: WhiteboardValue
+});
+var WhiteboardDiagnostic = z4.strictObject({
+  ruleId: NonEmptyString,
+  severity: z4.enum(["error", "warning"]),
+  message: NonEmptyString
+});
+var WhiteboardEntryInfo = z4.strictObject({
+  name: NonEmptyString,
+  revision: NonEmptyString,
+  entry: WhiteboardEntryEnvelope.optional(),
+  state: z4.enum(["available", "unavailable", "unsupported-version", "invalid"]),
+  mutable: z4.boolean(),
+  diagnostics: z4.array(z4.string())
+});
+var WhiteboardEntryInspection = WhiteboardEntryInfo.extend({
+  value: WhiteboardValue.optional(),
+  text: z4.string(),
+  truncated: z4.boolean()
+});
+var WhiteboardTypeInfo = z4.strictObject({
+  typeId: GlobalContributionId,
+  displayName: NonEmptyString,
+  schemaVersion: z4.number().int().positive(),
+  available: z4.boolean(),
+  /** A plugin-owned readonly presentation; absent types use the host fallback. */
+  presentation: z4.strictObject({
+    app: GlobalContributionId
+  }).optional()
+});
+export {
+  JsonValue,
+  WhiteboardEntryEnvelope,
+  WhiteboardEntryInfo,
+  WhiteboardEntryInspection,
+  WhiteboardTypeInfo
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-sdk",
-  "version": "0.15.3",
+  "version": "0.27.0",
   "description": "The Kay plugin SDK — types and helpers for authoring a Kay directory plugin.",
   "author": "YakLabs",
   "type": "module",
@@ -57,6 +57,10 @@
       "types": "./dist/app-data.d.ts",
       "default": "./dist/app-data.js"
     },
+    "./whiteboard": {
+      "types": "./dist/whiteboard.d.ts",
+      "default": "./dist/whiteboard.js"
+    },
     "./transcript-review": {
       "types": "./dist/transcript-review.d.ts",
       "default": "./dist/transcript-review.js"