llmist 9.3.2 → 9.5.0

package/dist/index.d.cts

@@ -2456,6 +2456,36 @@ interface ExecutionContext {
      * ```
      */
     logger?: Logger<ILogObj>;
+    /**
+     * Request human input during gadget execution.
+     *
+     * When available, gadgets can use this callback to ask the user questions
+     * and receive their answers. This is used internally by gadgets that throw
+     * `HumanInputRequiredException` - the executor catches the exception and
+     * calls this callback if provided.
+     *
+     * Subagents created via `createSubagent()` will automatically inherit this
+     * capability from their parent context, enabling nested agents to bubble up
+     * human input requests to the CLI's TUI.
+     *
+     * This is optional - it will be `undefined` for:
+     * - Gadgets executed via CLI `gadget run` command
+     * - Non-interactive (piped) execution
+     * - Direct gadget testing without agent context
+     *
+     * @example
+     * ```typescript
+     * // Subagents automatically inherit human input capability:
+     * const agent = createSubagent(ctx, {
+     *   name: "BrowseWeb",
+     *   gadgets: [Navigate, Click, AskUser],
+     * }).ask("Log in to example.com");
+     *
+     * // The AskUser gadget inside BrowseWeb can now prompt the user
+     * // and the input request will bubble up to the CLI's TUI
+     * ```
+     */
+    requestHumanInput?: (question: string) => Promise<string>;
 }
 /**
  * Host llmist exports provided to external gadgets via ExecutionContext.
@@ -9167,6 +9197,7 @@ interface SubagentOptions {
  * - Resolves model with "inherit" support from CLI config
  * - Shares the parent's execution tree for cost tracking
  * - Forwards the abort signal for proper cancellation
+ * - Inherits human input handler (for 2FA, CAPTCHAs, etc.)
  *
  * @param ctx - ExecutionContext passed to gadget's execute()
  * @param options - Subagent configuration options
@@ -9198,6 +9229,10 @@ interface SubagentOptions {
  * for await (const event of agent.run()) {
  *   // Events flow through shared tree automatically
  * }
+ *
+ * // Human input bubbles up automatically:
+ * // If a gadget throws HumanInputRequiredException,
+ * // the parent's onHumanInput handler will be called
  * ```
  */
 declare function createSubagent(ctx: ExecutionContext, options: SubagentOptions): AgentBuilder;

package/dist/index.d.ts

@@ -2456,6 +2456,36 @@ interface ExecutionContext {
      * ```
      */
     logger?: Logger<ILogObj>;
+    /**
+     * Request human input during gadget execution.
+     *
+     * When available, gadgets can use this callback to ask the user questions
+     * and receive their answers. This is used internally by gadgets that throw
+     * `HumanInputRequiredException` - the executor catches the exception and
+     * calls this callback if provided.
+     *
+     * Subagents created via `createSubagent()` will automatically inherit this
+     * capability from their parent context, enabling nested agents to bubble up
+     * human input requests to the CLI's TUI.
+     *
+     * This is optional - it will be `undefined` for:
+     * - Gadgets executed via CLI `gadget run` command
+     * - Non-interactive (piped) execution
+     * - Direct gadget testing without agent context
+     *
+     * @example
+     * ```typescript
+     * // Subagents automatically inherit human input capability:
+     * const agent = createSubagent(ctx, {
+     *   name: "BrowseWeb",
+     *   gadgets: [Navigate, Click, AskUser],
+     * }).ask("Log in to example.com");
+     *
+     * // The AskUser gadget inside BrowseWeb can now prompt the user
+     * // and the input request will bubble up to the CLI's TUI
+     * ```
+     */
+    requestHumanInput?: (question: string) => Promise<string>;
 }
 /**
  * Host llmist exports provided to external gadgets via ExecutionContext.
@@ -9167,6 +9197,7 @@ interface SubagentOptions {
  * - Resolves model with "inherit" support from CLI config
  * - Shares the parent's execution tree for cost tracking
  * - Forwards the abort signal for proper cancellation
+ * - Inherits human input handler (for 2FA, CAPTCHAs, etc.)
  *
  * @param ctx - ExecutionContext passed to gadget's execute()
  * @param options - Subagent configuration options
@@ -9198,6 +9229,10 @@ interface SubagentOptions {
  * for await (const event of agent.run()) {
  *   // Events flow through shared tree automatically
  * }
+ *
+ * // Human input bubbles up automatically:
+ * // If a gadget throws HumanInputRequiredException,
+ * // the parent's onHumanInput handler will be called
  * ```
  */
 declare function createSubagent(ctx: ExecutionContext, options: SubagentOptions): AgentBuilder;

package/dist/index.js

@@ -8106,7 +8106,9 @@ var init_executor = __esm({
             // Host exports for external gadgets to use host's llmist classes
             hostExports: getHostExportsInternal(),
             // Logger for structured logging (respects CLI's log level/file config)
-            logger: this.logger
+            logger: this.logger,
+            // Human input callback for subagents to bubble up input requests
+            requestHumanInput: this.requestHumanInput
           };
           let rawResult;
           if (timeoutMs && timeoutMs > 0) {
@@ -12491,6 +12493,9 @@ function createSubagent(ctx, options) {
     defaultValue: defaultMaxIterations
   });
   let builder = new AgentBuilder2(client).withModel(model).withGadgets(...gadgets).withMaxIterations(maxIterations).withParentContext(ctx);
+  if (ctx.requestHumanInput) {
+    builder = builder.onHumanInput(ctx.requestHumanInput);
+  }
   if (systemPrompt) {
     builder = builder.withSystem(systemPrompt);
   }