llmist 1.6.1 → 1.7.0

package/dist/index.cjs

@@ -1101,7 +1101,7 @@ function applyLineLimit(lines, limit) {
   }
   return lines;
 }
-function createGadgetOutputViewer(store) {
+function createGadgetOutputViewer(store, maxOutputChars = DEFAULT_MAX_OUTPUT_CHARS) {
   return createGadget({
     name: "GadgetOutputViewer",
     description: "View stored output from gadgets that returned too much data. Use patterns to filter lines (like grep) and limit to control output size. Patterns are applied first in order, then the limit is applied to the result.",
@@ -1166,19 +1166,43 @@ function createGadgetOutputViewer(store) {
       if (limit) {
         lines = applyLineLimit(lines, limit);
       }
+      let output = lines.join("\n");
       const totalLines = stored.lineCount;
       const returnedLines = lines.length;
       if (returnedLines === 0) {
         return `No lines matched the filters. Original output had ${totalLines} lines.`;
       }
-      const header = returnedLines < totalLines ? `[Showing ${returnedLines} of ${totalLines} lines]
-` : `[Showing all ${totalLines} lines]
+      let truncatedBySize = false;
+      let linesIncluded = returnedLines;
+      if (output.length > maxOutputChars) {
+        truncatedBySize = true;
+        let truncatedOutput = "";
+        linesIncluded = 0;
+        for (const line of lines) {
+          if (truncatedOutput.length + line.length + 1 > maxOutputChars) break;
+          truncatedOutput += line + "\n";
+          linesIncluded++;
+        }
+        output = truncatedOutput;
+      }
+      let header;
+      if (truncatedBySize) {
+        const remainingLines = returnedLines - linesIncluded;
+        header = `[Showing ${linesIncluded} of ${totalLines} lines (truncated due to size limit)]
+[... ${remainingLines.toLocaleString()} more lines. Use limit parameter to paginate, e.g., limit: "${linesIncluded + 1}-${linesIncluded + 200}"]
 `;
-      return header + lines.join("\n");
+      } else if (returnedLines < totalLines) {
+        header = `[Showing ${returnedLines} of ${totalLines} lines]
+`;
+      } else {
+        header = `[Showing all ${totalLines} lines]
+`;
+      }
+      return header + output;
     }
   });
 }
-var import_zod, patternSchema;
+var import_zod, patternSchema, DEFAULT_MAX_OUTPUT_CHARS;
 var init_output_viewer = __esm({
   "src/gadgets/output-viewer.ts"() {
     "use strict";
@@ -1190,6 +1214,7 @@ var init_output_viewer = __esm({
       before: import_zod.z.number().int().min(0).default(0).describe("Context lines before each match (like grep -B)"),
       after: import_zod.z.number().int().min(0).default(0).describe("Context lines after each match (like grep -A)")
     });
+    DEFAULT_MAX_OUTPUT_CHARS = 76800;
   }
 });
 
@@ -3395,7 +3420,10 @@ var init_agent = __esm({
         const contextWindow = limits?.contextWindow ?? FALLBACK_CONTEXT_WINDOW;
         this.outputLimitCharLimit = Math.floor(contextWindow * (limitPercent / 100) * CHARS_PER_TOKEN);
         if (this.outputLimitEnabled) {
-          this.registry.register("GadgetOutputViewer", createGadgetOutputViewer(this.outputStore));
+          this.registry.register(
+            "GadgetOutputViewer",
+            createGadgetOutputViewer(this.outputStore, this.outputLimitCharLimit)
+          );
         }
         this.hooks = this.mergeOutputLimiterHook(options.hooks);
         const baseBuilder = new LLMMessageBuilder(options.promptConfig);
@@ -5881,6 +5909,7 @@ var init_builder = __esm({
       gadgetOutputLimitPercent;
       compactionConfig;
       signal;
+      trailingMessage;
       constructor(client) {
         this.client = client;
       }
@@ -6356,6 +6385,31 @@ var init_builder = __esm({
         this.signal = signal;
         return this;
       }
+      /**
+       * Add an ephemeral trailing message that appears at the end of each LLM request.
+       *
+       * The message is NOT persisted to conversation history - it only appears in the
+       * current LLM call. This is useful for injecting context-specific instructions
+       * or reminders without polluting the conversation history.
+       *
+       * @param message - Static string or function that generates the message
+       * @returns This builder for chaining
+       *
+       * @example
+       * ```typescript
+       * // Static message
+       * .withTrailingMessage("Always respond in JSON format.")
+       *
+       * // Dynamic message based on iteration
+       * .withTrailingMessage((ctx) =>
+       *   `[Iteration ${ctx.iteration}/${ctx.maxIterations}] Stay focused on the task.`
+       * )
+       * ```
+       */
+      withTrailingMessage(message) {
+        this.trailingMessage = message;
+        return this;
+      }
       /**
        * Add a synthetic gadget call to the conversation history.
        *
@@ -6397,6 +6451,36 @@ ${endPrefix}`
         });
         return this;
       }
+      /**
+       * Compose the final hooks, including trailing message if configured.
+       */
+      composeHooks() {
+        if (!this.trailingMessage) {
+          return this.hooks;
+        }
+        const trailingMsg = this.trailingMessage;
+        const existingBeforeLLMCall = this.hooks?.controllers?.beforeLLMCall;
+        const trailingMessageController = async (ctx) => {
+          const result = existingBeforeLLMCall ? await existingBeforeLLMCall(ctx) : { action: "proceed" };
+          if (result.action === "skip") {
+            return result;
+          }
+          const messages = [...result.modifiedOptions?.messages || ctx.options.messages];
+          const content = typeof trailingMsg === "function" ? trailingMsg({ iteration: ctx.iteration, maxIterations: ctx.maxIterations }) : trailingMsg;
+          messages.push({ role: "user", content });
+          return {
+            action: "proceed",
+            modifiedOptions: { ...result.modifiedOptions, messages }
+          };
+        };
+        return {
+          ...this.hooks,
+          controllers: {
+            ...this.hooks?.controllers,
+            beforeLLMCall: trailingMessageController
+          }
+        };
+      }
       /**
        * Format parameters as block format with JSON Pointer paths.
        */
@@ -6458,7 +6542,7 @@ ${endPrefix}`
           maxIterations: this.maxIterations,
           temperature: this.temperature,
           logger: this.logger,
-          hooks: this.hooks,
+          hooks: this.composeHooks(),
           promptConfig: this.promptConfig,
           initialMessages: this.initialMessages,
           onHumanInputRequired: this.onHumanInputRequired,
@@ -6562,7 +6646,7 @@ ${endPrefix}`
           maxIterations: this.maxIterations,
           temperature: this.temperature,
           logger: this.logger,
-          hooks: this.hooks,
+          hooks: this.composeHooks(),
           promptConfig: this.promptConfig,
           initialMessages: this.initialMessages,
           onHumanInputRequired: this.onHumanInputRequired,