llmist 17.5.1 → 17.6.0

package/dist/index.d.cts

@@ -1010,6 +1010,11 @@ interface CreateGadgetConfig<TSchema extends ZodType> {
      * - `N > 1` = At most N concurrent
      */
     maxConcurrent?: number;
+    /**
+     * If true, this gadget's results are marked sticky and survive compaction.
+     * See `AbstractGadget.stickyResult` for the full contract.
+     */
+    stickyResult?: boolean;
 }
 /**
  * Creates a gadget from a function (simpler than class-based approach).
@@ -1229,6 +1234,7 @@ declare function Gadget<TSchema extends ZodType>(config: GadgetConfig<TSchema>):
          * ```
          */
         execute(params: Record<string, unknown>, ctx?: ExecutionContext): GadgetExecuteReturn | Promise<GadgetExecuteReturn>;
+        stickyResult?: boolean;
         throwIfAborted(ctx?: ExecutionContext): void;
         onAbort(ctx: ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
         createLinkedAbortController(ctx?: ExecutionContext): AbortController;
@@ -3858,6 +3864,15 @@ interface GadgetExecutionResult {
     mediaIds?: string[];
     /** Stored media with paths (for CLI display) */
     storedMedia?: StoredMedia[];
+    /**
+     * If true, the message persisting this gadget result is marked sticky
+     * (`metadata.sticky = true`) so compaction strategies preserve it
+     * indefinitely. Use for gadgets whose output the agent needs to remember
+     * for the rest of the conversation (e.g. `LoadSkill` whose body is the
+     * canonical reference the agent will keep consulting). Copied from
+     * `AbstractGadget.stickyResult` by the executor.
+     */
+    stickyResult?: boolean;
 }
 /**
  * Result returned by gadget execute() method.
@@ -4131,6 +4146,22 @@ declare abstract class AbstractGadget {
      * This is a safety floor: external config cannot weaken it.
      */
     exclusive?: boolean;
+    /**
+     * If true, results produced by this gadget are marked sticky on the
+     * conversation (`message.metadata.sticky === true`). Compaction strategies
+     * preserve sticky messages past the truncation point, so the agent retains
+     * the gadget's output for the rest of the conversation rather than having
+     * it dropped on the next compaction pass.
+     *
+     * Use for gadgets whose output is *reference material* the agent will keep
+     * consulting — `LoadSkill` is the canonical example: a multi-KB skill body
+     * the agent needs to remember across iterations. Don't use for routine
+     * gadget outputs (file reads, computation results) — those should churn
+     * normally with the conversation.
+     *
+     * Has no effect on agents that don't enable compaction.
+     */
+    stickyResult?: boolean;
     /**
      * Execute the gadget with the given parameters.
      * Can be synchronous or asynchronous.
@@ -4554,7 +4585,7 @@ declare class LLMMessageBuilder {
      * @param mediaIds - Optional IDs for the media outputs
      * @param storedMedia - Optional stored media info including file paths
      */
-    addGadgetCallResult(gadget: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[]): this;
+    addGadgetCallResult(gadget: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[], metadata?: Record<string, unknown>): this;
     /**
      * Format parameters as Block format with JSON Pointer paths.
      * Uses the configured argPrefix for consistency with system prompt.
@@ -5914,7 +5945,7 @@ interface IConversationManager {
      * Optionally includes media outputs (images, audio, etc.) for multimodal results.
      * If storedMedia is provided, file paths will be included in the result message.
      */
-    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[]): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[], metadata?: Record<string, unknown>): void;
     /**
      * Gets the complete conversation history including base messages (system prompts, gadget instructions).
      */
@@ -7643,7 +7674,7 @@ declare class ConversationManager implements IConversationManager {
     constructor(baseMessages: LLMMessage[], initialMessages: LLMMessage[], options?: ConversationManagerOptions);
     addUserMessage(content: MessageContent): void;
     addAssistantMessage(content: string): void;
-    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[]): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[], metadata?: Record<string, unknown>): void;
     getMessages(): LLMMessage[];
     getHistoryMessages(): LLMMessage[];
     getBaseMessages(): LLMMessage[];

package/dist/index.d.ts

@@ -1010,6 +1010,11 @@ interface CreateGadgetConfig<TSchema extends ZodType> {
      * - `N > 1` = At most N concurrent
      */
     maxConcurrent?: number;
+    /**
+     * If true, this gadget's results are marked sticky and survive compaction.
+     * See `AbstractGadget.stickyResult` for the full contract.
+     */
+    stickyResult?: boolean;
 }
 /**
  * Creates a gadget from a function (simpler than class-based approach).
@@ -1229,6 +1234,7 @@ declare function Gadget<TSchema extends ZodType>(config: GadgetConfig<TSchema>):
          * ```
          */
         execute(params: Record<string, unknown>, ctx?: ExecutionContext): GadgetExecuteReturn | Promise<GadgetExecuteReturn>;
+        stickyResult?: boolean;
         throwIfAborted(ctx?: ExecutionContext): void;
         onAbort(ctx: ExecutionContext | undefined, cleanup: () => void | Promise<void>): void;
         createLinkedAbortController(ctx?: ExecutionContext): AbortController;
@@ -3858,6 +3864,15 @@ interface GadgetExecutionResult {
     mediaIds?: string[];
     /** Stored media with paths (for CLI display) */
     storedMedia?: StoredMedia[];
+    /**
+     * If true, the message persisting this gadget result is marked sticky
+     * (`metadata.sticky = true`) so compaction strategies preserve it
+     * indefinitely. Use for gadgets whose output the agent needs to remember
+     * for the rest of the conversation (e.g. `LoadSkill` whose body is the
+     * canonical reference the agent will keep consulting). Copied from
+     * `AbstractGadget.stickyResult` by the executor.
+     */
+    stickyResult?: boolean;
 }
 /**
  * Result returned by gadget execute() method.
@@ -4131,6 +4146,22 @@ declare abstract class AbstractGadget {
      * This is a safety floor: external config cannot weaken it.
      */
     exclusive?: boolean;
+    /**
+     * If true, results produced by this gadget are marked sticky on the
+     * conversation (`message.metadata.sticky === true`). Compaction strategies
+     * preserve sticky messages past the truncation point, so the agent retains
+     * the gadget's output for the rest of the conversation rather than having
+     * it dropped on the next compaction pass.
+     *
+     * Use for gadgets whose output is *reference material* the agent will keep
+     * consulting — `LoadSkill` is the canonical example: a multi-KB skill body
+     * the agent needs to remember across iterations. Don't use for routine
+     * gadget outputs (file reads, computation results) — those should churn
+     * normally with the conversation.
+     *
+     * Has no effect on agents that don't enable compaction.
+     */
+    stickyResult?: boolean;
     /**
      * Execute the gadget with the given parameters.
      * Can be synchronous or asynchronous.
@@ -4554,7 +4585,7 @@ declare class LLMMessageBuilder {
      * @param mediaIds - Optional IDs for the media outputs
      * @param storedMedia - Optional stored media info including file paths
      */
-    addGadgetCallResult(gadget: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[]): this;
+    addGadgetCallResult(gadget: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[], metadata?: Record<string, unknown>): this;
     /**
      * Format parameters as Block format with JSON Pointer paths.
      * Uses the configured argPrefix for consistency with system prompt.
@@ -5914,7 +5945,7 @@ interface IConversationManager {
      * Optionally includes media outputs (images, audio, etc.) for multimodal results.
      * If storedMedia is provided, file paths will be included in the result message.
      */
-    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[]): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[], metadata?: Record<string, unknown>): void;
     /**
      * Gets the complete conversation history including base messages (system prompts, gadget instructions).
      */
@@ -7643,7 +7674,7 @@ declare class ConversationManager implements IConversationManager {
     constructor(baseMessages: LLMMessage[], initialMessages: LLMMessage[], options?: ConversationManagerOptions);
     addUserMessage(content: MessageContent): void;
     addAssistantMessage(content: string): void;
-    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[]): void;
+    addGadgetCallResult(gadgetName: string, parameters: Record<string, unknown>, result: string, invocationId: string, media?: GadgetMediaOutput[], mediaIds?: string[], storedMedia?: StoredMedia[], metadata?: Record<string, unknown>): void;
     getMessages(): LLMMessage[];
     getHistoryMessages(): LLMMessage[];
     getBaseMessages(): LLMMessage[];

package/dist/index.js

@@ -81,7 +81,7 @@ import {
   toBase64,
   validateGadgetSchema,
   withErrorHandling
-} from "./chunk-HM7PUGPA.js";
+} from "./chunk-EXFIXEGW.js";
 
 // src/core/execution-tree-aggregator.ts
 var ExecutionTreeAggregator;
@@ -1884,11 +1884,19 @@ var init_sliding_window = __esm({
         }
         const turnsToKeep = turns.slice(-preserveCount);
         const turnsRemoved = turns.length - preserveCount;
+        const keptMessageRefs = new Set(turnsToKeep.flatMap((turn) => turn.messages));
+        const stickyToPreserve = messages.filter(
+          (msg) => msg.metadata?.sticky === true && !keptMessageRefs.has(msg)
+        );
         const truncationMarker = {
           role: "user",
           content: TRUNCATION_MARKER_TEMPLATE.replace("{count}", turnsRemoved.toString())
         };
-        const compactedMessages = [truncationMarker, ...flattenTurns(turnsToKeep)];
+        const compactedMessages = [
+          truncationMarker,
+          ...stickyToPreserve,
+          ...flattenTurns(turnsToKeep)
+        ];
         const tokensAfter = Math.ceil(
           compactedMessages.reduce((sum, msg) => sum + (msg.content?.length ?? 0), 0) / 4
         );
@@ -1932,7 +1940,14 @@ var init_summarization = __esm({
         }
         const turnsToSummarize = turns.slice(0, -preserveCount);
         const turnsToKeep = turns.slice(-preserveCount);
-        const conversationToSummarize = this.formatTurnsForSummary(flattenTurns(turnsToSummarize));
+        const keptMessageRefs = new Set(turnsToKeep.flatMap((turn) => turn.messages));
+        const stickyToPreserve = messages.filter(
+          (msg) => msg.metadata?.sticky === true && !keptMessageRefs.has(msg)
+        );
+        const turnsToSummarizeMessages = flattenTurns(turnsToSummarize).filter(
+          (msg) => msg.metadata?.sticky !== true
+        );
+        const conversationToSummarize = this.formatTurnsForSummary(turnsToSummarizeMessages);
         const summary = await this.generateSummary(conversationToSummarize, config, context);
         const summaryMessage = {
           role: "user",
@@ -1940,7 +1955,11 @@ var init_summarization = __esm({
 ${summary}
 [End of summary - conversation continues below]`
         };
-        const compactedMessages = [summaryMessage, ...flattenTurns(turnsToKeep)];
+        const compactedMessages = [
+          summaryMessage,
+          ...stickyToPreserve,
+          ...flattenTurns(turnsToKeep)
+        ];
         const tokensAfter = Math.ceil(
           compactedMessages.reduce((sum, msg) => sum + (msg.content?.length ?? 0), 0) / 4
         );
@@ -2261,7 +2280,7 @@ var init_conversation_manager = __esm({
       addAssistantMessage(content) {
         this.historyBuilder.addAssistant(content);
       }
-      addGadgetCallResult(gadgetName, parameters, result, invocationId, media, mediaIds, storedMedia) {
+      addGadgetCallResult(gadgetName, parameters, result, invocationId, media, mediaIds, storedMedia, metadata) {
         this.historyBuilder.addGadgetCallResult(
           gadgetName,
           parameters,
@@ -2269,7 +2288,8 @@ var init_conversation_manager = __esm({
           invocationId,
           media,
           mediaIds,
-          storedMedia
+          storedMedia,
+          metadata
         );
       }
       getMessages() {
@@ -2401,6 +2421,7 @@ var init_conversation_updater = __esm({
           for (const output of gadgetResults) {
             if (output.type === "gadget_result") {
               const gadgetResult = output.result;
+              const metadata = gadgetResult.stickyResult === true && gadgetResult.error === void 0 ? { sticky: true } : void 0;
               this.conversation.addGadgetCallResult(
                 gadgetResult.gadgetName,
                 gadgetResult.parameters,
@@ -2408,7 +2429,8 @@ var init_conversation_updater = __esm({
                 gadgetResult.invocationId,
                 gadgetResult.media,
                 gadgetResult.mediaIds,
-                gadgetResult.storedMedia
+                gadgetResult.storedMedia,
+                metadata
               );
             }
           }
@@ -4118,6 +4140,12 @@ function createLoadSkillGadget(registry) {
       skill: z2.enum(skillNames).describe("Name of the skill to load"),
       arguments: z2.string().optional().describe("Arguments for the skill (e.g., a filename, issue number, or search query)")
     }),
+    // LoadSkill exists specifically so the agent can keep a skill body in
+    // context for the rest of the task — marking its results sticky lets the
+    // compaction layer preserve them past truncation. Without this the agent
+    // gets the skill body once, compaction drops it, and the next iteration
+    // falls back to stale training knowledge of whatever the skill covered.
+    stickyResult: true,
     execute: async ({ skill: skillName, arguments: args }) => {
       const skill = registry.get(skillName);
       if (!skill) {
@@ -13499,7 +13527,13 @@ var init_executor = __esm({
             cost: totalCost,
             media,
             mediaIds,
-            storedMedia
+            storedMedia,
+            // Copy the gadget's sticky flag into the result envelope so the
+            // conversation-updater can mark the persisted message sticky for
+            // the compaction layer. Only set on success — errors and other
+            // unsuccessful exits skip this so failed loads don't pin themselves
+            // in context.
+            stickyResult: gadget.stickyResult
           };
         } catch (error) {
           const isTaskCompletionSignal = error instanceof Error && error.name === "TaskCompletionSignal";
@@ -15688,7 +15722,7 @@ var init_agent = __esm({
         }
         const unsubscribeBridge = bridgeTreeToHooks(this.tree, this.hooks, this.logger);
         if (this.mcpSpecs.length > 0) {
-          const { setupMcpServers } = await import("./runtime-GKQ6QIQP.js");
+          const { setupMcpServers } = await import("./runtime-LKTAP7X6.js");
           this.mcpLifecycle = await setupMcpServers({
             specs: this.mcpSpecs,
             registry: this.registry,