llmist 1.6.2 → 1.7.0

package/dist/index.cjs

@@ -5909,6 +5909,7 @@ var init_builder = __esm({
       gadgetOutputLimitPercent;
       compactionConfig;
       signal;
+      trailingMessage;
       constructor(client) {
         this.client = client;
       }
@@ -6384,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.
        *
@@ -6425,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.
        */
@@ -6486,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,
@@ -6590,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,