@yaklabs-ai/plugin-protocol 0.55.11 → 0.55.13

package/README.md

@@ -11,7 +11,7 @@ flow.
 ```json
 {
   "dependencies": {
-    "@bonsai/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.55.11"
+    "@bonsai/plugin-protocol": "npm:@yaklabs-ai/plugin-protocol@^0.55.13"
   }
 }
 ```

package/THIRD-PARTY-INVENTORY.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@yaklabs-ai/plugin-protocol",
-  "version": "0.55.11",
+  "version": "0.55.13",
   "target": "npm",
   "firstPartyLicense": "MIT",
   "bundled": [

package/dist/index.d.ts

@@ -3381,12 +3381,14 @@ declare const canonicalContributionSchemas: {
         "report-evidence.read": "report-evidence.read";
         "navigation.open-page": "navigation.open-page";
         "sessions.create": "sessions.create";
+        "composer.append-draft": "composer.append-draft";
         "models.complete": "models.complete";
         "artifacts.read": "artifacts.read";
         "artifacts.preview": "artifacts.preview";
         "markdown.document-view": "markdown.document-view";
         "references.open": "references.open";
         "files.choose-folder": "files.choose-folder";
+        "auth.connect": "auth.connect";
         "billing.read": "billing.read";
         "account.read": "account.read";
         "plugins.read": "plugins.read";
@@ -3420,12 +3422,14 @@ declare const canonicalContributionSchemas: {
             "report-evidence.read": "report-evidence.read";
             "navigation.open-page": "navigation.open-page";
             "sessions.create": "sessions.create";
+            "composer.append-draft": "composer.append-draft";
             "models.complete": "models.complete";
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
             "references.open": "references.open";
             "files.choose-folder": "files.choose-folder";
+            "auth.connect": "auth.connect";
             "billing.read": "billing.read";
             "account.read": "account.read";
             "plugins.read": "plugins.read";
@@ -3534,12 +3538,14 @@ declare const canonicalContributionSchemas: {
                 "report-evidence.read": "report-evidence.read";
                 "navigation.open-page": "navigation.open-page";
                 "sessions.create": "sessions.create";
+                "composer.append-draft": "composer.append-draft";
                 "models.complete": "models.complete";
                 "artifacts.read": "artifacts.read";
                 "artifacts.preview": "artifacts.preview";
                 "markdown.document-view": "markdown.document-view";
                 "references.open": "references.open";
                 "files.choose-folder": "files.choose-folder";
+                "auth.connect": "auth.connect";
                 "billing.read": "billing.read";
                 "account.read": "account.read";
                 "plugins.read": "plugins.read";
@@ -3590,12 +3596,14 @@ declare const canonicalContributionSchemas: {
                 "report-evidence.read": "report-evidence.read";
                 "navigation.open-page": "navigation.open-page";
                 "sessions.create": "sessions.create";
+                "composer.append-draft": "composer.append-draft";
                 "models.complete": "models.complete";
                 "artifacts.read": "artifacts.read";
                 "artifacts.preview": "artifacts.preview";
                 "markdown.document-view": "markdown.document-view";
                 "references.open": "references.open";
                 "files.choose-folder": "files.choose-folder";
+                "auth.connect": "auth.connect";
                 "billing.read": "billing.read";
                 "account.read": "account.read";
                 "plugins.read": "plugins.read";
@@ -5128,8 +5136,21 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * modified time, and the new optional `chatsWithOutputs()` lists every chat with an outputs folder
  * from one scan. The `{ uris }` and `{ sessionId }` shapes stay valid. Additive; a plugin reading
  * the new fields declares ^0.55.11.
+ *
+ * 0.55.12 raises the reset text's cap (compaction plan, 11 Nov): `RESET_TEXT_MAX_CHARS` goes from
+ * 18,000 to 31,500 characters, and the new `RESET_TEXT_MAX_TOKENS` (10,500) states the same cap in
+ * herd's estimated tokens, which herd's own check now allows. Compatible: every entry valid before
+ * is still valid. An entry over 18,000 characters, read by a host before 0.55.12 (an older app
+ * opening the same transcript), fails that host's parse and its reset writes the summary, as for
+ * any entry it cannot use. A plugin writing such a text, or reading the token cap, declares
+ * ^0.55.12; no other plugin's range changes.
+ *
+ * 0.55.13 adds the `composer.append-draft` host capability for a `kay.ui` app (compaction plan, 11
+ * Nov): a page adds text at the end of the composer of the chat its pane is bound to, and nothing is
+ * sent. Additive; a plugin declaring it declares ^0.55.13, since an older
+ * host refuses a manifest naming a capability it does not know.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.55.11";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.55.13";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -7157,12 +7178,14 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "report-evidence.read": "report-evidence.read";
                                 "navigation.open-page": "navigation.open-page";
                                 "sessions.create": "sessions.create";
+                                "composer.append-draft": "composer.append-draft";
                                 "models.complete": "models.complete";
                                 "artifacts.read": "artifacts.read";
                                 "artifacts.preview": "artifacts.preview";
                                 "markdown.document-view": "markdown.document-view";
                                 "references.open": "references.open";
                                 "files.choose-folder": "files.choose-folder";
+                                "auth.connect": "auth.connect";
                                 "billing.read": "billing.read";
                                 "account.read": "account.read";
                                 "plugins.read": "plugins.read";
@@ -7213,12 +7236,14 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                                 "report-evidence.read": "report-evidence.read";
                                 "navigation.open-page": "navigation.open-page";
                                 "sessions.create": "sessions.create";
+                                "composer.append-draft": "composer.append-draft";
                                 "models.complete": "models.complete";
                                 "artifacts.read": "artifacts.read";
                                 "artifacts.preview": "artifacts.preview";
                                 "markdown.document-view": "markdown.document-view";
                                 "references.open": "references.open";
                                 "files.choose-folder": "files.choose-folder";
+                                "auth.connect": "auth.connect";
                                 "billing.read": "billing.read";
                                 "account.read": "account.read";
                                 "plugins.read": "plugins.read";
@@ -8247,12 +8272,14 @@ export declare const KayUiAppHostCapability: z.ZodEnum<{
     "report-evidence.read": "report-evidence.read";
     "navigation.open-page": "navigation.open-page";
     "sessions.create": "sessions.create";
+    "composer.append-draft": "composer.append-draft";
     "models.complete": "models.complete";
     "artifacts.read": "artifacts.read";
     "artifacts.preview": "artifacts.preview";
     "markdown.document-view": "markdown.document-view";
     "references.open": "references.open";
     "files.choose-folder": "files.choose-folder";
+    "auth.connect": "auth.connect";
     "billing.read": "billing.read";
     "account.read": "account.read";
     "plugins.read": "plugins.read";
@@ -8542,12 +8569,14 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "report-evidence.read": "report-evidence.read";
                     "navigation.open-page": "navigation.open-page";
                     "sessions.create": "sessions.create";
+                    "composer.append-draft": "composer.append-draft";
                     "models.complete": "models.complete";
                     "artifacts.read": "artifacts.read";
                     "artifacts.preview": "artifacts.preview";
                     "markdown.document-view": "markdown.document-view";
                     "references.open": "references.open";
                     "files.choose-folder": "files.choose-folder";
+                    "auth.connect": "auth.connect";
                     "billing.read": "billing.read";
                     "account.read": "account.read";
                     "plugins.read": "plugins.read";
@@ -8598,12 +8627,14 @@ export declare const KayUiTargetManifest: z.ZodObject<{
                     "report-evidence.read": "report-evidence.read";
                     "navigation.open-page": "navigation.open-page";
                     "sessions.create": "sessions.create";
+                    "composer.append-draft": "composer.append-draft";
                     "models.complete": "models.complete";
                     "artifacts.read": "artifacts.read";
                     "artifacts.preview": "artifacts.preview";
                     "markdown.document-view": "markdown.document-view";
                     "references.open": "references.open";
                     "files.choose-folder": "files.choose-folder";
+                    "auth.connect": "auth.connect";
                     "billing.read": "billing.read";
                     "account.read": "account.read";
                     "plugins.read": "plugins.read";
@@ -13440,10 +13471,20 @@ export declare const RENAMED_PLUGIN_CAPABILITY_SLUGS: {
 export declare const RESERVED_DIRECTORY_PLUGIN_ID_PREFIXES: readonly ["herd.", "kay."];
 
 /**
- * The longest text an entry may hold, in characters: herd's 6,000 estimated tokens at its three
+ * The longest text an entry may hold, in characters: {@link RESET_TEXT_MAX_TOKENS} at herd's three
  * characters per token for ASCII. Herd also counts the tokens, so denser text is refused sooner.
  */
-export declare const RESET_TEXT_MAX_CHARS = 18000;
+export declare const RESET_TEXT_MAX_CHARS: number;
+
+/**
+ * The most a reset text may hold, in herd's estimated tokens: about 3 characters a token for ASCII,
+ * one token for any other character (`estimateTokens` in herd's compaction executor, which a
+ * plugin's count must repeat). Herd refuses a larger text and writes today's summary
+ * (`PREPARED_STATE_MAX_TOKENS`, kept equal to this by a test in `@bonsai/agent-runtime`). 10,500
+ * fits the median record render the compaction plan chose, about 30,000 characters; a larger render
+ * is trimmed to fit (`docs/plans/compaction.md`, decision log, 11 Nov).
+ */
+export declare const RESET_TEXT_MAX_TOKENS = 10500;
 
 /** The `contributes.resetText` declaration: which of the plugin's state entries holds it. */
 export declare const ResetTextContribution: z.ZodObject<{
@@ -14160,12 +14201,14 @@ export declare const ResolvedKayUiApp: z.ZodObject<{
             "report-evidence.read": "report-evidence.read";
             "navigation.open-page": "navigation.open-page";
             "sessions.create": "sessions.create";
+            "composer.append-draft": "composer.append-draft";
             "models.complete": "models.complete";
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
             "references.open": "references.open";
             "files.choose-folder": "files.choose-folder";
+            "auth.connect": "auth.connect";
             "billing.read": "billing.read";
             "account.read": "account.read";
             "plugins.read": "plugins.read";
@@ -16085,12 +16128,14 @@ export declare const ResolvedPluginContractV1: z.ZodObject<{
                 "report-evidence.read": "report-evidence.read";
                 "navigation.open-page": "navigation.open-page";
                 "sessions.create": "sessions.create";
+                "composer.append-draft": "composer.append-draft";
                 "models.complete": "models.complete";
                 "artifacts.read": "artifacts.read";
                 "artifacts.preview": "artifacts.preview";
                 "markdown.document-view": "markdown.document-view";
                 "references.open": "references.open";
                 "files.choose-folder": "files.choose-folder";
+                "auth.connect": "auth.connect";
                 "billing.read": "billing.read";
                 "account.read": "account.read";
                 "plugins.read": "plugins.read";
@@ -17992,12 +18037,14 @@ export declare const UiAppCapabilities: z.ZodObject<{
         "report-evidence.read": "report-evidence.read";
         "navigation.open-page": "navigation.open-page";
         "sessions.create": "sessions.create";
+        "composer.append-draft": "composer.append-draft";
         "models.complete": "models.complete";
         "artifacts.read": "artifacts.read";
         "artifacts.preview": "artifacts.preview";
         "markdown.document-view": "markdown.document-view";
         "references.open": "references.open";
         "files.choose-folder": "files.choose-folder";
+        "auth.connect": "auth.connect";
         "billing.read": "billing.read";
         "account.read": "account.read";
         "plugins.read": "plugins.read";
@@ -18058,12 +18105,14 @@ export declare const UiAppContribution: z.ZodObject<{
             "report-evidence.read": "report-evidence.read";
             "navigation.open-page": "navigation.open-page";
             "sessions.create": "sessions.create";
+            "composer.append-draft": "composer.append-draft";
             "models.complete": "models.complete";
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
             "references.open": "references.open";
             "files.choose-folder": "files.choose-folder";
+            "auth.connect": "auth.connect";
             "billing.read": "billing.read";
             "account.read": "account.read";
             "plugins.read": "plugins.read";
@@ -18114,12 +18163,14 @@ export declare const UiAppContribution: z.ZodObject<{
             "report-evidence.read": "report-evidence.read";
             "navigation.open-page": "navigation.open-page";
             "sessions.create": "sessions.create";
+            "composer.append-draft": "composer.append-draft";
             "models.complete": "models.complete";
             "artifacts.read": "artifacts.read";
             "artifacts.preview": "artifacts.preview";
             "markdown.document-view": "markdown.document-view";
             "references.open": "references.open";
             "files.choose-folder": "files.choose-folder";
+            "auth.connect": "auth.connect";
             "billing.read": "billing.read";
             "account.read": "account.read";
             "plugins.read": "plugins.read";

package/dist/index.js

@@ -260,8 +260,10 @@ var JsonSchema = z4.record(z4.string(), JsonValue);
 var KAY_PLUGIN_MANIFEST_SIZE_CAP_BYTES = 1024 * 1024;
 var KAY_PLUGIN_PROTOCOL_VERSION = "kay.plugin.v1";
 var KAY_PLUGIN_PROTOCOL_PACKAGE_NAME = "@bonsai/plugin-protocol";
-var KAY_PLUGIN_SDK_VERSION = "0.55.11";
+var KAY_PLUGIN_SDK_VERSION = "0.55.13";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.55.12",
+  "0.55.11",
   "0.55.10",
   "0.55.9",
   "0.55.8",
@@ -4587,6 +4589,11 @@ function createContributionsSchemas(canonical) {
     // Lets `navigation.openChat` create a blank chat (no message, no model
     // turn) when no session id is given. It never sends anything.
     "sessions.create",
+    // Adds text at the end of the composer of the chat the page's pane is bound to
+    // (`useBonsaiComposerDraft`); a page should call it only on the person's own action. The host
+    // picks the chat, keeps what the person typed and never sends: the person edits and sends it,
+    // or not.
+    "composer.append-draft",
     "models.complete",
     "artifacts.read",
     "artifacts.preview",
@@ -4599,6 +4606,9 @@ function createContributionsSchemas(canonical) {
     // Opens the system folder picker when the person acts (`useBonsaiFolderPicker`) and answers
     // the one folder they chose, or nothing when they cancel. It lists and reads nothing.
     "files.choose-folder",
+    // Starts one service's sign-in through the host's connect flow when the person acts
+    // (`useBonsaiConnectService`) and answers how it ended. It reads no account or credential.
+    "auth.connect",
     // Server-rated organization billing, distinct from local/provider cost.
     "billing.read",
     "account.read",
@@ -5026,7 +5036,8 @@ function isPluginStateEntryCustomType(customType) {
 }
 
 // packages/plugin-protocol/dist/reset-text.js
-var RESET_TEXT_MAX_CHARS = 18e3;
+var RESET_TEXT_MAX_TOKENS = 10500;
+var RESET_TEXT_MAX_CHARS = RESET_TEXT_MAX_TOKENS * 3;
 var EntryAddress = z18.strictObject({
   sessionId: z18.string().min(1),
   entryId: z18.string().min(1)
@@ -8857,6 +8868,7 @@ export {
   RENAMED_PLUGIN_CAPABILITY_SLUGS,
   RESERVED_DIRECTORY_PLUGIN_ID_PREFIXES,
   RESET_TEXT_MAX_CHARS,
+  RESET_TEXT_MAX_TOKENS,
   RETIRED_COMPATIBILITY_KEYS,
   RETIRED_PERMISSION_ASK_KEYS,
   RETIRED_PLUGIN_CAPABILITY_SLUGS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaklabs-ai/plugin-protocol",
-  "version": "0.55.11",
+  "version": "0.55.13",
   "description": "The Kay plugin manifest schema (`kay.plugin.v1`) — parse and validate a kay-plugin.json.",
   "author": "YakLabs",
   "type": "module",