hammer-ai 0.2.11 → 0.2.12

package/dist/index.d.ts

@@ -2259,6 +2259,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 +2302,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

@@ -7195,10 +7195,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 -------------------------------------------------------