@yaklabs-ai/plugin-sdk 0.54.0 → 0.54.2

package/dist/kay-app.js

@@ -1,3 +1,20 @@
+// packages/plugin-sdk/dist/workers.js
+var PluginWorkerError = class extends Error {
+  code;
+  constructor(code, message = `Plugin worker request failed: ${code}`) {
+    super(message);
+    this.code = code;
+    this.name = "PluginWorkerError";
+  }
+};
+function createUnavailablePluginWorkers() {
+  return {
+    async run() {
+      throw new PluginWorkerError("spawn_failed", "Plugin workers are not available on this host.");
+    }
+  };
+}
+
 // packages/herd-uri/dist/errors.js
 var UriError = class extends Error {
 };
@@ -353,6 +370,9 @@ var PLUGIN_SIGNAL_TITLE_MAX = 300;
 var PLUGIN_SIGNAL_SNIPPET_MAX = 500;
 var PLUGIN_SIGNAL_LABELS_MAX = 20;
 var PLUGIN_SIGNAL_LABEL_MAX = 64;
+var PLUGIN_SIGNAL_ATTACHMENTS_MAX = 10;
+var PLUGIN_SIGNAL_ATTACHMENT_NAME_MAX = 255;
+var PLUGIN_SIGNAL_ATTACHMENT_TYPE_MAX = 127;
 var PLUGIN_SIGNAL_RELATED_KEYS = [
   "thread",
   "from",
@@ -1167,12 +1187,16 @@ export {
   KayAppWorkflowFailure,
   MAX_CHOICE_LABELS,
   PLUGIN_EVENT_REFUSED_ERROR_NAME,
+  PLUGIN_SIGNAL_ATTACHMENTS_MAX,
+  PLUGIN_SIGNAL_ATTACHMENT_NAME_MAX,
+  PLUGIN_SIGNAL_ATTACHMENT_TYPE_MAX,
   PLUGIN_SIGNAL_KINDS,
   PLUGIN_SIGNAL_LABELS_MAX,
   PLUGIN_SIGNAL_LABEL_MAX,
   PLUGIN_SIGNAL_RELATED_KEYS,
   PLUGIN_SIGNAL_SNIPPET_MAX,
   PLUGIN_SIGNAL_TITLE_MAX,
+  PluginWorkerError,
   ProjectDirectory,
   ProjectDirectoryRequest,
   ProjectDirectoryResponse,
@@ -1193,6 +1217,7 @@ export {
   createFallbackOnlySignals,
   createKayPluginLog,
   createUnavailablePluginEndpointCaller,
+  createUnavailablePluginWorkers,
   createUnavailableSealing,
   createUnavailableSkills,
   createUnavailableTools,

package/dist/workers.d.ts

@@ -0,0 +1,27 @@
+/** A refusal handle for hosts that have not composed plugin worker execution. */
+export declare function createUnavailablePluginWorkers(): KayPluginWorkers;
+
+/** A declared module exports this function; input and output must be JSON values. */
+export declare interface KayPluginWorkerModule {
+    run(input: unknown): unknown | Promise<unknown>;
+}
+
+/** Run only this plugin's declared modules in a fresh child owned by its hosting process. */
+export declare interface KayPluginWorkers {
+    /** The host terminates the child on deadline, caller abort or plugin disposal. */
+    run<T = unknown>(workerId: string, input: unknown, options: {
+        readonly timeoutMs: number;
+        readonly signal?: AbortSignal;
+    }): Promise<T>;
+}
+
+/** A worker refusal or failure; the code is safe to record without its input or output. */
+export declare class PluginWorkerError extends Error {
+    readonly code: PluginWorkerErrorCode;
+    constructor(code: PluginWorkerErrorCode, message?: string);
+}
+
+/** Stable, content-free failure classes for a plugin worker request. */
+export declare type PluginWorkerErrorCode = "undeclared" | "invalid_module" | "invalid_input" | "input_too_large" | "output_too_large" | "timeout" | "aborted" | "spawn_failed" | "child_failed" | "invalid_output";
+
+export { }

package/dist/workers.js

@@ -0,0 +1,20 @@
+// packages/plugin-sdk/dist/workers.js
+var PluginWorkerError = class extends Error {
+  code;
+  constructor(code, message = `Plugin worker request failed: ${code}`) {
+    super(message);
+    this.code = code;
+    this.name = "PluginWorkerError";
+  }
+};
+function createUnavailablePluginWorkers() {
+  return {
+    async run() {
+      throw new PluginWorkerError("spawn_failed", "Plugin workers are not available on this host.");
+    }
+  };
+}
+export {
+  PluginWorkerError,
+  createUnavailablePluginWorkers
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-sdk",
-  "version": "0.54.0",
+  "version": "0.54.2",
   "description": "The Kay plugin SDK — types and helpers for authoring a Kay directory plugin.",
   "author": "YakLabs",
   "type": "module",
@@ -25,6 +25,10 @@
       "types": "./dist/endpoints.d.ts",
       "default": "./dist/endpoints.js"
     },
+    "./workers": {
+      "types": "./dist/workers.d.ts",
+      "default": "./dist/workers.js"
+    },
     "./kay-app/session-summary": {
       "types": "./dist/kay-app-session-summary.d.ts",
       "default": "./dist/kay-app-session-summary.js"