@yaklabs-ai/plugin-sdk 0.13.3 → 0.13.5

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.13.3"
+    "@bonsai/plugin-sdk": "npm:@yaklabs-ai/plugin-sdk@^0.13.5"
   }
 }
 ```
@@ -51,13 +51,47 @@ the diagnostics to read when a plugin does not load. Point your agent at
 `node_modules/@bonsai/plugin-sdk/skills/directory-plugin-authoring/SKILL.md`
 before it writes any plugin code.
 
+A plugin is a directory with a manifest, `kay-plugin.json`, and an entrypoint.
+Every tool the entrypoint registers is declared in the manifest too:
+
+```json
+{
+  "protocol": "kay.plugin.v1",
+  "id": "com.example.widgets",
+  "displayName": "Widgets",
+  "description": "Greets people by name.",
+  "version": "0.1.0",
+  "namespace": "widgets",
+  "compatibility": { "sdk": "^0.13.5" },
+  "targets": {
+    "kay": {
+      "agent": {
+        "entrypoint": { "module": "./entrypoint.ts" },
+        "contributes": {
+          "tools": [
+            {
+              "localId": "greet",
+              "toolName": "widgets_greet",
+              "description": "Greet someone by name."
+            }
+          ]
+        }
+      }
+    }
+  }
+}
+```
+
+The entrypoint, `entrypoint.ts`, default-exports the function Bonsai calls with
+the plugin API:
+
 ```ts
 import {
   defineTool,
   textResult,
   toolParameters,
   z,
-  type KayAgentActivate,
+  type KayAgentPluginApi,
 } from "@bonsai/plugin-sdk/kay-agent";
 
 const greet = defineTool({
@@ -70,13 +104,16 @@ const greet = defineTool({
   },
 });
 
-const activate: KayAgentActivate = (api) => {
+export default function activate(api: KayAgentPluginApi): void {
   api.registerTool(greet);
-};
-
-export default activate;
+}
 ```
 
+An entrypoint that exports a named `activate` instead, as older plugins do,
+still loads. Bonsai reads the default export from plugin SDK 0.13.5 on, and the
+`compatibility.sdk` range makes an older Bonsai refuse the plugin with a message
+naming both versions, instead of loading it and finding no `activate`.
+
 ## Entrypoints
 
 | Import                                 | What it gives you                                                            |
@@ -151,7 +188,7 @@ someone remembering to cut one. If the numbers differ, a newer version exists.
 Installing this SDK gives you **types, editor completion, and a runtime you can
 execute in your own tests**. It is not what runs inside Bonsai.
 
-When the daemon loads your plugin, chord bundles its declared target and keeps
+When the daemon loads your plugin, it bundles the declared target and keeps
 `@bonsai/plugin-sdk/*` as a host external. Those imports resolve to the SDK
 **bundled with the Bonsai app**. The host's copy always wins. That is deliberate —
 one implementation, the one the daemon is built against — but it has a
@@ -204,7 +241,7 @@ checkout script is not the standalone path. The SDK's `kay-app` declarations
 use `node:sqlite`, which TypeScript cannot resolve without the Node 24
 typings.
 
-When Bonsai loads your plugin, chord bundles the declared entrypoint and its
+When Bonsai loads your plugin, it bundles the declared entrypoint and its
 relative imports. Multi-file entrypoints are supported, and TypeScript syntax
 that native stripping cannot execute, such as enums, namespaces, constructor
 parameter properties, and decorators, is compiled into the bundle. The host

package/THIRD-PARTY-INVENTORY.json

@@ -1,38 +1,28 @@
 {
   "schemaVersion": 1,
   "package": "@yaklabs-ai/plugin-sdk",
-  "version": "0.13.3",
+  "version": "0.13.5",
   "target": "npm",
   "firstPartyLicense": "MIT",
   "bundled": [
-    {
-      "name": "@earendil-works/pi-agent-core",
-      "version": "0.99.1",
-      "license": "MIT",
-      "copyright": "Copyright (c) 2025 Mario Zechner",
-      "source": "https://github.com/earendil-works/pi/tree/v0.99.1/packages/agent",
-      "licenseSource": "https://github.com/earendil-works/pi/blob/v0.99.1/LICENSE",
-      "upstreamCommit": "d86654abb8862e201933517d6f1fce9f88dd117f",
-      "noticeFile": "THIRD-PARTY-NOTICES.md"
-    },
     {
       "name": "@earendil-works/pi-ai",
-      "version": "0.99.1",
+      "version": "1.3.0",
       "license": "MIT",
       "copyright": "Copyright (c) 2025 Mario Zechner",
-      "source": "https://github.com/earendil-works/pi/tree/v0.99.1/packages/ai",
-      "licenseSource": "https://github.com/earendil-works/pi/blob/v0.99.1/LICENSE",
-      "upstreamCommit": "d86654abb8862e201933517d6f1fce9f88dd117f",
+      "source": "https://github.com/earendil-works/pi/tree/v1.3.0/packages/ai",
+      "licenseSource": "https://github.com/earendil-works/pi/blob/v1.3.0/LICENSE",
+      "upstreamCommit": "71023aec1546d6d677a65669c5665c0927ce0dd0",
       "noticeFile": "THIRD-PARTY-NOTICES.md"
     },
     {
       "name": "@earendil-works/chord",
-      "version": "0.99.1",
+      "version": "1.3.0",
       "license": "MIT",
       "copyright": "Copyright (c) 2025 Mario Zechner",
-      "source": "https://github.com/earendil-works/pi/tree/v0.99.1/packages/chord",
-      "licenseSource": "https://github.com/earendil-works/pi/blob/v0.99.1/LICENSE",
-      "upstreamCommit": "d86654abb8862e201933517d6f1fce9f88dd117f",
+      "source": "https://github.com/earendil-works/pi/tree/v1.3.0/packages/chord",
+      "licenseSource": "https://github.com/earendil-works/pi/blob/v1.3.0/LICENSE",
+      "upstreamCommit": "71023aec1546d6d677a65669c5665c0927ce0dd0",
       "noticeFile": "THIRD-PARTY-NOTICES.md"
     },
     {

package/THIRD-PARTY-NOTICES.md

@@ -1,24 +1,18 @@
 # Third-party notices
 
-This package bundles 4 first-party-selected component(s). The notices below are reproduced verbatim from each component's upstream MIT license source.
+This package bundles 3 first-party-selected component(s). The notices below are reproduced verbatim from each component's upstream MIT license source.
 
-## @earendil-works/pi-agent-core@0.99.1
+## @earendil-works/pi-ai@1.3.0
 
-- Source: https://github.com/earendil-works/pi/tree/v0.99.1/packages/agent
-- License source: https://github.com/earendil-works/pi/blob/v0.99.1/LICENSE
-- Upstream commit: d86654abb8862e201933517d6f1fce9f88dd117f
+- Source: https://github.com/earendil-works/pi/tree/v1.3.0/packages/ai
+- License source: https://github.com/earendil-works/pi/blob/v1.3.0/LICENSE
+- Upstream commit: 71023aec1546d6d677a65669c5665c0927ce0dd0
 
-## @earendil-works/pi-ai@0.99.1
+## @earendil-works/chord@1.3.0
 
-- Source: https://github.com/earendil-works/pi/tree/v0.99.1/packages/ai
-- License source: https://github.com/earendil-works/pi/blob/v0.99.1/LICENSE
-- Upstream commit: d86654abb8862e201933517d6f1fce9f88dd117f
-
-## @earendil-works/chord@0.99.1
-
-- Source: https://github.com/earendil-works/pi/tree/v0.99.1/packages/chord
-- License source: https://github.com/earendil-works/pi/blob/v0.99.1/LICENSE
-- Upstream commit: d86654abb8862e201933517d6f1fce9f88dd117f
+- Source: https://github.com/earendil-works/pi/tree/v1.3.0/packages/chord
+- License source: https://github.com/earendil-works/pi/blob/v1.3.0/LICENSE
+- Upstream commit: 71023aec1546d6d677a65669c5665c0927ce0dd0
 
 License text for the component(s) above, verbatim from the license source: