@j-o-r/hello-dave 0.1.4 → 0.1.5

package/lib/AgentLauncher.js

@@ -527,6 +527,37 @@ class AgentLauncher {
   getActiveAgent() {
     return this.#activeAgent;
   }
+  /**
+   * Directly assign an already-created Agent instance as the active agent.
+   *
+   * This is the programmatic alternative to `load()`. Use it when the caller
+   * has constructed an agent manually, or when testing an agent module that is
+   * outside the configured agent loader search paths.
+   *
+   * The previous active agent, if any, is cleaned up via `destructor()`. The new
+   * agent becomes the launcher's active agent and has the launcher's
+   * `agent:handoff` listener attached to its Prompt, just like agents loaded via
+   * `load()`.
+   *
+   * The supplied agent is assumed to be a valid `Agent` instance. Unlike
+   * `load()`, this method does not resolve, import, or validate an agent module
+   * through the configured agent loader.
+   *
+   * @param {Agent} newAgent - Existing Agent instance to make active.
+   * @returns {AgentLauncher} Returns `this` for chaining.
+   *
+   * @example
+   * const launcher = new AgentLauncher();
+   * launcher.setActiveAgent(agent);
+   * await launcher.run();
+   *
+   * @see #load
+   * @see #getActiveAgent
+   */
+  setActiveAgent(newAgent) {
+    this.#setActiveAgent(newAgent);
+    return this;
+  }
 
   /**
    * Returns the Prompt belonging to the active agent (or null).
@@ -559,4 +590,4 @@ class AgentLauncher {
   }
 }
 
-export default AgentLauncher;
+export default AgentLauncher;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@j-o-r/hello-dave",
   "type": "module",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "BETA - ESM toolkit for building AI agents. 'Hello, Dave.' A calm, reliable interface to Grok (xAI), OpenAI, and Anthropic — foolproof and incapable of error (mostly). Putting itself to the fullest possible use.",
   "main": "./lib/index.js",
   "types": "./types/index.d.ts",
@@ -57,4 +57,4 @@
   "engines": {
     "node": ">=20"
   }
-}
+}

package/types/AgentLauncher.d.ts

@@ -196,6 +196,34 @@ declare class AgentLauncher {
      * @returns {Agent|null}
      */
     getActiveAgent(): Agent | null;
+    /**
+     * Directly assign an already-created Agent instance as the active agent.
+     *
+     * This is the programmatic alternative to `load()`. Use it when the caller
+     * has constructed an agent manually, or when testing an agent module that is
+     * outside the configured agent loader search paths.
+     *
+     * The previous active agent, if any, is cleaned up via `destructor()`. The new
+     * agent becomes the launcher's active agent and has the launcher's
+     * `agent:handoff` listener attached to its Prompt, just like agents loaded via
+     * `load()`.
+     *
+     * The supplied agent is assumed to be a valid `Agent` instance. Unlike
+     * `load()`, this method does not resolve, import, or validate an agent module
+     * through the configured agent loader.
+     *
+     * @param {Agent} newAgent - Existing Agent instance to make active.
+     * @returns {AgentLauncher} Returns `this` for chaining.
+     *
+     * @example
+     * const launcher = new AgentLauncher();
+     * launcher.setActiveAgent(agent);
+     * await launcher.run();
+     *
+     * @see #load
+     * @see #getActiveAgent
+     */
+    setActiveAgent(newAgent: Agent): AgentLauncher;
     /**
      * Returns the Prompt belonging to the active agent (or null).
      *