@yaklabs-ai/plugin-protocol 0.55.12 → 0.55.14

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@yaklabs-ai/plugin-protocol",
-  "version": "0.55.12",
+  "version": "0.55.14",
   "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";
@@ -5136,8 +5144,18 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * 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.
+ *
+ * 0.55.14 lets a reset entry name the pass that wrote it (`pass`: `asked`, `spacing` or `ahead`,
+ * `ResetTextPass`), which the host counts per reset (#16714). An entry carrying `pass`, read by a
+ * host before 0.55.14, fails that host's parse and its reset writes the summary, as for any entry
+ * it cannot use. A plugin writing `pass` declares ^0.55.14; no other plugin's range changes.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.55.12";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.55.14";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -7165,12 +7183,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";
@@ -7221,12 +7241,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";
@@ -8255,12 +8277,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";
@@ -8550,12 +8574,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";
@@ -8606,12 +8632,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";
@@ -13477,10 +13505,29 @@ export declare const ResetTextEntry: z.ZodObject<{
         entryId: z.ZodString;
     }, z.core.$strict>;
     text: z.ZodString;
+    pass: z.ZodOptional<z.ZodEnum<{
+        asked: "asked";
+        spacing: "spacing";
+        ahead: "ahead";
+    }>>;
 }, z.core.$strict>;
 
 export declare type ResetTextEntry = z.infer<typeof ResetTextEntry>;
 
+/**
+ * Which pass wrote a reset text: one the agent asked for (`asked`), one on the regular spacing as the
+ * conversation grows (`spacing`), or the one just ahead of the reset threshold (`ahead`). The host
+ * counts which kind covered a reset, never reads it as a reason to use the text. Optional on the
+ * entry (SDK 0.55.14): an entry written before names none.
+ */
+export declare const ResetTextPass: z.ZodEnum<{
+    asked: "asked";
+    spacing: "spacing";
+    ahead: "ahead";
+}>;
+
+export declare type ResetTextPass = z.infer<typeof ResetTextPass>;
+
 /**
  * Resolves the runtime selection key for a provider-shaped contribution - the
  * value an *adapter binding* names to make one implementation live.
@@ -14178,12 +14225,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";
@@ -16103,12 +16152,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";
@@ -18010,12 +18061,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";
@@ -18076,12 +18129,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";
@@ -18132,12 +18187,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.12";
+var KAY_PLUGIN_SDK_VERSION = "0.55.14";
 var KAY_PLUGIN_COMPATIBLE_SDK_VERSIONS = [
+  "0.55.13",
+  "0.55.12",
   "0.55.11",
   "0.55.10",
   "0.55.9",
@@ -4588,6 +4590,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",
@@ -4600,6 +4607,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",
@@ -5033,6 +5043,7 @@ var EntryAddress = z18.strictObject({
   sessionId: z18.string().min(1),
   entryId: z18.string().min(1)
 });
+var ResetTextPass = z18.enum(["asked", "spacing", "ahead"]);
 var ResetTextEntry = z18.strictObject({
   version: z18.literal(1),
   /**
@@ -5042,7 +5053,8 @@ var ResetTextEntry = z18.strictObject({
    */
   coveredThrough: EntryAddress,
   /** The working state as Markdown, without the harness ledger. */
-  text: z18.string().min(1).max(RESET_TEXT_MAX_CHARS)
+  text: z18.string().min(1).max(RESET_TEXT_MAX_CHARS),
+  pass: ResetTextPass.optional()
 });
 var ResetTextContribution = z18.strictObject({
   entry: z18.string().regex(PLUGIN_STATE_ENTRY_NAME_PATTERN)
@@ -8877,6 +8889,7 @@ export {
   RegistrableDomain,
   ResetTextContribution,
   ResetTextEntry,
+  ResetTextPass,
   ResolvedAuthGrantRequest,
   ResolvedEndpointGrantRequest,
   ResolvedKayAgentArtifactUriModule,

package/package.json

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