@yaklabs-ai/plugin-sdk 0.15.2 → 0.15.3

package/README.md

@@ -13,7 +13,7 @@ it under the name your plugin code actually imports:
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.15.2"
+    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.15.3"
   }
 }
 ```
@@ -62,7 +62,7 @@ Every tool the entrypoint registers is declared in the manifest too:
   "description": "Greets people by name.",
   "version": "0.1.0",
   "namespace": "widgets",
-  "compatibility": { "sdk": "^0.15.2" },
+  "compatibility": { "sdk": "^0.15.3" },
   "targets": {
     "kay": {
       "agent": {

package/THIRD-PARTY-INVENTORY.json

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

package/dist/kay-app.d.ts

@@ -2568,10 +2568,8 @@ export declare interface KayAppAutomationContext {
 
 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.
+     * Starts a new session each time the automation fires. Created only with
+     * `owner: "user"`; the creating session's directory and project are stamped here.
      */
     readonly kind: "spawn-session";
     readonly prompt: string;
@@ -2596,16 +2594,20 @@ export declare type KayAppAutomationEffect = {
 };
 
 /**
- * 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.
+ * What a plugin may CREATE an automation with; {@link KayAppAutomationEffect} is the STORED type
+ * this input narrows. `spawn-session` needs `owner: "user"`: an automation the creating session
+ * owns is a follow-up that brings that session back, so it cannot start a new one.
+ * `deliver-turn` is the reverse, session-owned only. A script the user owns references a skill
+ * file (`ref: {kind: "skill-file"}`), because it has no session scripts folder.
  */
 export declare type KayAppAutomationEffectInput = {
     readonly kind: "deliver-turn";
     readonly prompt: string;
+} | {
+    readonly kind: "spawn-session";
+    readonly prompt: string;
+    /** Resolve the new session's model by tier instead of the default. */
+    readonly tier?: "small" | "medium" | "large" | "ultra";
 } | {
     readonly kind: "script";
     /** The file this automation runs; every stored binding carries one. */
@@ -2860,6 +2862,12 @@ export declare interface KayAppAutomations {
     create(input: {
         readonly name: string;
         readonly description?: string;
+        /**
+         * Who owns the new automation. `session` (the default) ties it to the calling session;
+         * `user` makes it the person's own: it outlives that session, any session may switch it
+         * off, run or delete it, and the Automations page lists it. Requires SDK 0.15.3.
+         */
+        readonly owner?: "session" | "user";
         readonly condition: KayAppAutomationConditionInput;
         readonly effect: KayAppAutomationEffectInput;
         readonly enabled?: boolean;

package/package.json

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