@standardagents/spec 0.43.0 → 0.43.1

package/dist/index.d.ts

@@ -2562,7 +2562,11 @@ interface ExecutionState {
     readonly stopped: boolean;
     /** Which side initiated the stop (if stopped) */
     readonly stoppedBy?: 'a' | 'b';
-    /** Live chronological persisted history for the current execution */
+    /**
+     * Live chronological persisted history for the current execution. With
+     * the active prompt's `historyLimit`, only its newest window of
+     * top-level messages (see `PromptDefinition.historyLimit`).
+     */
     readonly messageHistory: Message[];
     /**
      * Force a specific side to play the next turn.
@@ -4380,6 +4384,19 @@ interface PromptDefinition<N extends string = string, S extends ToolArgs = ToolA
      * @default 10
      */
     recentImageThreshold?: number;
+    /**
+     * Bound the stored chat history a request loads (with `includeChat`):
+     * only the newest top-level messages, at least `historyLimit` and fewer
+     * than twice it. The cut moves `historyLimit` messages at a time, never
+     * per message, so the loaded rows stay the same between steps and a
+     * provider's prompt cache stays warm; a `filter_messages` window that
+     * moves in steps dividing `historyLimit` keeps the same messages it
+     * would keep over the whole history. The window is the execution's
+     * history itself, not only the request: `execution.messageHistory`, tools,
+     * hooks and `filter_messages` all see just these rows. Stored history is
+     * untouched. Unset loads the whole history.
+     */
+    historyLimit?: number;
     /**
      * Provider-specific options passed through to the provider.
      * These override model-level providerOptions for this prompt.
@@ -5863,7 +5880,8 @@ interface HookSignatures<State = ThreadState, Msg = HookMessage, ToolCall = Hook
      * Called exactly once per model-context assembly on a stable snapshot of
      * eligible persisted history.
      *
-     * Receives raw message rows from storage before any transformation.
+     * Receives raw message rows from storage before any transformation:
+     * with the prompt's `historyLimit`, only its newest window of them.
      * Use for filtering, sorting, or augmenting message history.
      * The result is the request context and does not replace
      * `state.execution.messageHistory`. Messages injected while this hook runs

package/dist/index.js

@@ -216,6 +216,9 @@ function definePrompt(options) {
   if (options.recentImageThreshold !== void 0 && (options.recentImageThreshold <= 0 || !Number.isInteger(options.recentImageThreshold))) {
     throw new Error("recentImageThreshold must be a positive integer");
   }
+  if (options.historyLimit !== void 0 && (options.historyLimit <= 0 || !Number.isInteger(options.historyLimit))) {
+    throw new Error("historyLimit must be a positive integer");
+  }
   const normalizedVariables = Array.isArray(options.variables) ? options.variables.map((entry) => ({
     name: entry.name,
     type: entry.type === "secret" ? "secret" : "text",