@yaklabs-ai/plugin-sdk 0.9.1 → 0.10.0

package/README.md

@@ -13,7 +13,7 @@ it under the name your plugin code actually imports:
 ```json
 {
   "dependencies": {
-    "@kay/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.9.1"
+    "@kay/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.10.0"
   }
 }
 ```

package/THIRD-PARTY-INVENTORY.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@yaklabs-ai/plugin-sdk",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "target": "npm",
   "firstPartyLicense": "MIT",
   "bundled": [

package/dist/kay-app.d.ts

@@ -1276,9 +1276,20 @@ export declare interface KayAppAutomationContext {
     readonly sessionId: string;
 }
 
-export declare type KayAppAutomationEffect = Extract<KayAppAutomationEffectInput, {
+export declare type KayAppAutomationEffect = {
+    /**
+     * STORED only: a binding created before the 2026-09-28 owner ruling (agents and plugins
+     * may not create `spawn-session` automations) can still carry this effect, so a read must
+     * still parse it. Absent from {@link KayAppAutomationEffectInput}, so no NEW binding can
+     * be minted with it.
+     */
     readonly kind: "spawn-session";
-}> | {
+    readonly prompt: string;
+    readonly cwd?: string;
+    readonly projectId?: string | null;
+    /** Resolve the spawned session's model by tier instead of the caller's default. */
+    readonly tier?: "small" | "medium" | "large" | "ultra";
+} | {
     /** As STORED: always a reference, never inline source. */
     readonly kind: "script";
     readonly ref: KayAppAutomationScriptRef;
@@ -1294,6 +1305,14 @@ export declare type KayAppAutomationEffect = Extract<KayAppAutomationEffectInput
     readonly prompt: string;
 };
 
+/**
+ * What a plugin may CREATE an automation with. `spawn-session` is deliberately absent: owner
+ * ruling (2026-09-28) forbids a plugin (or an agent) from minting a `spawn-session` binding —
+ * durable recurring agent work belongs to a plugin workflow (`app.workflows.define` +
+ * `ctx.runAgent`) or a direct `app.sessions.run`. A binding created before that ruling can still
+ * carry the effect and still reads and runs; see {@link KayAppAutomationEffect}, the STORED type
+ * this input narrows.
+ */
 export declare type KayAppAutomationEffectInput = {
     readonly kind: "deliver-turn";
     readonly prompt: string;
@@ -1307,13 +1326,6 @@ export declare type KayAppAutomationEffectInput = {
      */
     readonly source?: string;
     readonly initialState?: JsonValue_4;
-} | {
-    readonly kind: "spawn-session";
-    readonly prompt: string;
-    readonly cwd?: string;
-    readonly projectId?: string | null;
-    /** Resolve the spawned session's model by tier instead of the caller's default. */
-    readonly tier?: "small" | "medium" | "large" | "ultra";
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-sdk",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "The Kay plugin SDK — types and helpers for authoring a Kay directory plugin.",
   "author": "YakLabs",
   "type": "module",