hammer-ai 0.2.11 → 0.2.13

package/dist/index.d.ts

@@ -875,8 +875,6 @@ interface MemoryLayerConfig {
     protectedContextTokens: number;
     /** Maximum tokens for the rendered compressed state. */
     stateBudgetTokens: number;
-    /** Hard cap on raw history entries (safety net). */
-    maxRawHistory: number;
     /** Minimum turns between compaction attempts. */
     compactionDebounceTurns: number;
     /** Baseline token overhead for system prompt (conservative estimate). */
@@ -899,7 +897,7 @@ interface MemoryLayerConfig {
  * - State rendering (converting TState to human-readable text)
  *
  * The base class provides:
- * - Append-only raw history with hard cap enforcement
+ * - Append-only raw history
  * - Token-budgeted sliding window for recent messages
  * - buildMessages assembly (system → state → recent)
  * - Compaction triggering (debounce, threshold check, prune)
@@ -1152,8 +1150,6 @@ interface AgentMemoryLayerConfig {
     protectedContextTokens: number;
     /** Token budget for the rendered compressed state block. */
     stateBudgetTokens: number;
-    /** Hard cap on raw history entries. */
-    maxRawHistory: number;
     /** Minimum turns between compaction attempts. */
     compactionDebounceTurns: number;
     /** Token estimate for the system prompt. */
@@ -2259,6 +2255,13 @@ interface SubAgentToolOptions {
     maxSteps?: number;
     /** Temperature for LLM calls. Defaults to LLMClient's built-in default (0.2). */
     temperature?: number;
+    /**
+     * Whether `execute()` awaits the sub-agent loop before returning.
+     * - `true` (default): the parent agent blocks until the sub-agent finishes.
+     * - `false`: the loop is fired in the background and `execute()` returns
+     *   immediately. Override `onSubAgentDispatched()` to track the promise.
+     */
+    blocking?: boolean;
 }
 /**
  * A Tool that runs its own contained agentic loop.
@@ -2295,6 +2298,15 @@ declare abstract class SubAgentTool extends Tool {
      * Override when `getSchema()` adds parameters beyond `task`.
      */
     protected buildSubAgentTask(params: Record<string, any>): string;
+    /**
+     * Called when `blocking` is `false`, right after the sub-agent loop is
+     * dispatched in the background.  Override to track the promise (e.g. for
+     * pending-generation registries) and return a custom immediate result.
+     *
+     * @param params  The raw parameters passed to `execute()`.
+     * @param promise Settles when the background sub-agent loop completes.
+     */
+    protected onSubAgentDispatched(_params: Record<string, any>, _promise: Promise<void>): ToolResult;
     execute(params: Record<string, any>): Promise<ToolResult>;
     protected runSubAgentLoop(task: string): Promise<ToolResult>;
 }

package/dist/index.js

@@ -4154,14 +4154,6 @@ var BaseMemoryLayer = class {
     const timestamp = Date.now();
     const msg = this.createMessage(id, role, content, this.currentTurn, timestamp);
     this.rawHistory.push(msg);
-    if (this.rawHistory.length > this.config.maxRawHistory) {
-      const excess = this.rawHistory.length - this.config.maxRawHistory;
-      const lastPrunedTurn = this.rawHistory[excess - 1].turn;
-      this.rawHistory.splice(0, excess);
-      if (this.compactionCursor.lastCompactedTurn < lastPrunedTurn) {
-        this.compactionCursor.lastCompactedTurn = lastPrunedTurn;
-      }
-    }
     this.onMessageAppended(msg);
     return id;
   }
@@ -5227,7 +5219,6 @@ var AgentMemoryLayer = class extends BaseMemoryLayer {
         compactionTokenThreshold: config.compactionTokenThreshold,
         protectedContextTokens: config.protectedContextTokens,
         stateBudgetTokens: config.stateBudgetTokens,
-        maxRawHistory: config.maxRawHistory,
         compactionDebounceTurns: config.compactionDebounceTurns,
         systemPromptOverhead: config.systemPromptOverhead,
         tokenEstimator: config.tokenEstimator,
@@ -5734,7 +5725,6 @@ var SHARED_WORKSPACE_AGENT_MEMORY_PRESET = {
   //  60_000
   stateBudgetTokens: Math.floor(DEFAULT_MAX_CONTEXT_TOKENS * 0.05),
   //  10_000
-  maxRawHistory: 2e3,
   compactionDebounceTurns: 3,
   systemPromptOverhead: 4e3,
   toolMemoryExtractor: DEFAULT_TOOL_MEMORY_EXTRACTOR
@@ -5744,7 +5734,6 @@ function createAgentMemoryLayer(_preset, overrides) {
     compactionTokenThreshold: SHARED_WORKSPACE_AGENT_MEMORY_PRESET.compactionTokenThreshold,
     protectedContextTokens: SHARED_WORKSPACE_AGENT_MEMORY_PRESET.protectedContextTokens,
     stateBudgetTokens: SHARED_WORKSPACE_AGENT_MEMORY_PRESET.stateBudgetTokens,
-    maxRawHistory: SHARED_WORKSPACE_AGENT_MEMORY_PRESET.maxRawHistory,
     compactionDebounceTurns: SHARED_WORKSPACE_AGENT_MEMORY_PRESET.compactionDebounceTurns,
     systemPromptOverhead: SHARED_WORKSPACE_AGENT_MEMORY_PRESET.systemPromptOverhead,
     tokenEstimator: overrides?.tokenEstimator ?? new CharTokenEstimator(),
@@ -7195,10 +7184,28 @@ var SubAgentTool = class extends Tool {
   buildSubAgentTask(params) {
     return typeof params.task === "string" ? params.task.trim() : "";
   }
+  // ---- non-blocking hook ------------------------------------------------
+  /**
+   * Called when `blocking` is `false`, right after the sub-agent loop is
+   * dispatched in the background.  Override to track the promise (e.g. for
+   * pending-generation registries) and return a custom immediate result.
+   *
+   * @param params  The raw parameters passed to `execute()`.
+   * @param promise Settles when the background sub-agent loop completes.
+   */
+  onSubAgentDispatched(_params, _promise) {
+    return { success: true, pending: true, message: "Sub-agent started in background." };
+  }
   // ---- execute ---------------------------------------------------------
   async execute(params) {
     const task = this.buildSubAgentTask(params);
     if (!task) return { success: false, error: "task is required" };
+    if (this.subAgentOptions.blocking === false) {
+      const promise = this.runSubAgentLoop(task).then(() => {
+      }).catch(() => {
+      });
+      return this.onSubAgentDispatched(params, promise);
+    }
     return this.runSubAgentLoop(task);
   }
   // ---- core loop -------------------------------------------------------