@yaklabs-ai/plugin-protocol 0.55.5 → 0.55.7

package/README.md

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

package/THIRD-PARTY-INVENTORY.json

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

package/dist/index.d.ts

@@ -4977,8 +4977,17 @@ export declare const KAY_PLUGIN_PROTOCOL_VERSION: "kay.plugin.v1";
  * and each write names the newest entry it was computed from, so a write from a stale base is
  * answered with the newest one instead of landing (compaction plan, phase 2). Additive; plugins
  * calling them declare ^0.55.5.
+ *
+ * 0.55.6 adds the `contributes.resetText { entry }` manifest field under the new private
+ * `compaction.reset-text` claim, and the `ResetTextEntry` shape the declared state entry holds: the
+ * working state a reset may use in place of the summary (compaction plan, phase 2). Additive; a
+ * plugin declaring it declares ^0.55.6.
+ *
+ * 0.55.7 adds `compositionMatched` to the outcome of a forked `app.agents.run`: whether the child
+ * composed like its parent, so its first request could read the parent's cached prefix (compaction
+ * plan, phase 2). Additive; a plugin reading it declares ^0.55.7.
  */
-export declare const KAY_PLUGIN_SDK_VERSION: "0.55.5";
+export declare const KAY_PLUGIN_SDK_VERSION: "0.55.7";
 
 export declare const KAY_PLUGIN_TARGET_NAMES: readonly ["kay.agent", "kay.app", "kay.ui"];
 
@@ -5825,6 +5834,9 @@ export declare const KayAppTargetManifest: z.ZodObject<{
             displayName: z.ZodOptional<z.ZodString>;
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
+        resetText: z.ZodOptional<z.ZodObject<{
+            entry: z.ZodString;
+        }, z.core.$strict>>;
         mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             url: z.ZodString;
             auth: z.ZodOptional<z.ZodEnum<{
@@ -6794,6 +6806,9 @@ export declare const KayPluginManifestV1: z.ZodObject<{
                         displayName: z.ZodOptional<z.ZodString>;
                         description: z.ZodOptional<z.ZodString>;
                     }, z.core.$strict>>>;
+                    resetText: z.ZodOptional<z.ZodObject<{
+                        entry: z.ZodString;
+                    }, z.core.$strict>>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
                         url: z.ZodString;
                         auth: z.ZodOptional<z.ZodEnum<{
@@ -8800,7 +8815,7 @@ export declare function parseSemver(value: string): ParsedSemver | undefined;
 export declare function parseWhere(source: string, keyTypes?: WhereKeyTypes): WhereParseResult;
 
 /** Every capability slug {@link PluginCapabilityClaimV1} can express, for exhaustive table checks. */
-export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "uri.call", "endpoints.invoke", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "plugins.read", "sessions.assign-project", "artifacts.resolve-file", "process.run", "sessions.annotate", "sessions.compact", "sessions.state", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "app-data.read", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "family-folder.root", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
+export declare const PLUGIN_CAPABILITY_SLUGS: readonly ["sessions.run", "network.connect", "web-session.request", "web-session.download", "process.spawn", "sessions.read", "signals.read", "uri.call", "endpoints.invoke", "skills.read", "skills.write", "skills.share", "plugins.set-enabled", "plugins.read", "sessions.assign-project", "artifacts.resolve-file", "process.run", "sessions.annotate", "sessions.compact", "sessions.state", "compaction.reset-text", "soul.write", "tools.describe", "workspace.command", "sessions.create", "sessions.update", "models.complete", "systemOne.use", "automations.write", "automations.run", "workflows.define", "workflows.signals", "session-events.subscribe", "agents.run", "dynamic-context.register", "app-data.register", "app-data.read", "knowledge-source.register", "artifacts.read", "session-artifacts.read", "session-artifacts.create", "account.assert", "account.update", "agents.permissions", "tool-interception.register", "interaction.surface", "config.declare-section", "auth.own-service", "auth.shared-identity", "cli.bind", "mcp.host-server", "prompt.resident", "skills.declared-source", "family-folder.root", "whiteboard.discover", "whiteboard.read", "whiteboard.create", "whiteboard.update", "whiteboard.remove", "model-selection.register", "system-prompt.register"];
 
 /** Diagnostic messages carry plugin-controlled text (parse errors, module errors); bound it so a
  *  hostile or accidental multi-megabyte error can never blow up a log line or a render surface. */
@@ -9561,6 +9576,10 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     target: "kay.app";
     slug: "sessions.state";
     envelope: Record<string, never>;
+} | {
+    target: "kay.app";
+    slug: "compaction.reset-text";
+    envelope: Record<string, never>;
 } | {
     target: "kay.app";
     slug: "soul.write";
@@ -9859,6 +9878,10 @@ export declare const PluginCapabilityClaimInputV1: z.ZodCustom<{
     target: "kay.app";
     slug: "sessions.state";
     envelope: Record<string, never>;
+} | {
+    target: "kay.app";
+    slug: "compaction.reset-text";
+    envelope: Record<string, never>;
 } | {
     target: "kay.app";
     slug: "soul.write";
@@ -10167,6 +10190,10 @@ export declare const PluginCapabilityClaimV1: z.ZodDiscriminatedUnion<[z.ZodObje
     target: z.ZodLiteral<"kay.app">;
     slug: z.ZodLiteral<"sessions.state">;
     envelope: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    target: z.ZodLiteral<"kay.app">;
+    slug: z.ZodLiteral<"compaction.reset-text">;
+    envelope: z.ZodObject<{}, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     target: z.ZodLiteral<"kay.app">;
     slug: z.ZodLiteral<"soul.write">;
@@ -10521,6 +10548,10 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"sessions.state">;
         envelope: z.ZodObject<{}, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.app">;
+        slug: z.ZodLiteral<"compaction.reset-text">;
+        envelope: z.ZodObject<{}, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"soul.write">;
@@ -10874,6 +10905,10 @@ export declare const PluginCapabilityDecisionV1: z.ZodDiscriminatedUnion<[z.ZodO
             target: z.ZodLiteral<"kay.app">;
             slug: z.ZodLiteral<"sessions.state">;
             envelope: z.ZodObject<{}, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            target: z.ZodLiteral<"kay.app">;
+            slug: z.ZodLiteral<"compaction.reset-text">;
+            envelope: z.ZodObject<{}, z.core.$strict>;
         }, z.core.$strict>, z.ZodObject<{
             target: z.ZodLiteral<"kay.app">;
             slug: z.ZodLiteral<"soul.write">;
@@ -11261,6 +11296,10 @@ export declare const PluginCapabilityRefusalV1: z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"sessions.state">;
         envelope: z.ZodObject<{}, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        target: z.ZodLiteral<"kay.app">;
+        slug: z.ZodLiteral<"compaction.reset-text">;
+        envelope: z.ZodObject<{}, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         target: z.ZodLiteral<"kay.app">;
         slug: z.ZodLiteral<"soul.write">;
@@ -13197,6 +13236,30 @@ 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
+ * characters per token for ASCII. Herd also counts the tokens, so denser text is refused sooner.
+ */
+export declare const RESET_TEXT_MAX_CHARS = 18000;
+
+/** The `contributes.resetText` declaration: which of the plugin's state entries holds it. */
+export declare const ResetTextContribution: z.ZodObject<{
+    entry: z.ZodString;
+}, z.core.$strict>;
+
+export declare type ResetTextContribution = z.infer<typeof ResetTextContribution>;
+
+export declare const ResetTextEntry: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    coveredThrough: z.ZodObject<{
+        sessionId: z.ZodString;
+        entryId: z.ZodString;
+    }, z.core.$strict>;
+    text: z.ZodString;
+}, z.core.$strict>;
+
+export declare type ResetTextEntry = z.infer<typeof ResetTextEntry>;
+
 /**
  * Resolves the runtime selection key for a provider-shaped contribution - the
  * value an *adapter binding* names to make one implementation live.