@dudko.dev/agent-web 0.0.5 → 0.0.7

package/dist/index.d.cts

@@ -3,6 +3,39 @@ import { LanguageModel, ToolSet, Tool, ModelMessage, generateText, streamText }
 import { z, ZodType } from 'zod';
 import { IDBPDatabase } from 'idb';
 
+/** A single step of a plan. Mirrors the Node sibling's IPlanStep. */
+interface IPlanStep {
+    id: string;
+    description: string;
+    expectedOutcome?: string;
+    /** Tools the planner thinks this step needs (drives 'plan-narrowed' selection). */
+    suggestedTools?: string[];
+    /** Set by the pipeline when suggestedTools were named but all were unknown. */
+    requiresTools?: boolean;
+}
+interface IPlan {
+    thought: string;
+    steps: IPlanStep[];
+}
+interface IUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+interface IToolCall {
+    name: string;
+    input: unknown;
+    output: unknown;
+    ok: boolean;
+}
+interface IStepResult {
+    step: IPlanStep;
+    summary: string;
+    toolCalls: IToolCall[];
+    /** True when the executor signalled it could not complete the step ([BLOCKER]). */
+    blocked: boolean;
+}
+
 interface StoredMessage {
     role: 'system' | 'user' | 'assistant';
     content: string;
@@ -245,6 +278,15 @@ declare const promptHintOf: (tool: Tool) => string | undefined;
 
 /** Force a tool-calling strategy, or let the agent pick per model ('auto'). */
 type ToolMode = 'auto' | 'native' | 'prompted';
+/**
+ * When to consult the replanner after an executed step (given `replan` is on):
+ * 'failure' — after a blocked step or a failed tool call (default);
+ * 'always'  — after every step, so the replanner can react to problems the host
+ *             surfaces via `describeState` (one extra model call per step);
+ * predicate — decides per step result; closes over host state if needed, and
+ *             falls back to 'failure' behaviour if it throws.
+ */
+type ReplanTrigger = 'failure' | 'always' | ((result: IStepResult) => boolean | Promise<boolean>);
 /**
  * 'all'           — the executor sees the full ToolSet on every step.
  * 'plan-narrowed' — the executor sees only a step's suggestedTools (the planner
@@ -292,7 +334,7 @@ interface BrowserAgentConfig {
     sessionId?: string;
     /** Hard cap on executed steps incl. replans (default 8). */
     maxIterations?: number;
-    /** Cap on LLM steps inside a single native executor call (default 4). */
+    /** Cap on tool-calling rounds inside one executor call, both modes (default 4). */
     maxStepsPerTask?: number;
     /** Cap on replanner "revise" decisions per run (default 2). */
     maxRevisions?: number;
@@ -300,8 +342,10 @@ interface BrowserAgentConfig {
     chatTimeoutMs?: number;
     budgets?: PhaseBudgets;
     temperature?: number;
-    /** Replan after a blocked/failed step (default true). */
+    /** Master switch for the replan phase (default true). */
     replan?: boolean;
+    /** What triggers the replanner when it is on (default 'failure'). */
+    replanAfter?: ReplanTrigger;
     /** Write a final natural-language summary (default true). */
     synthesize?: boolean;
     /** Compress stored history past this many chars (0 = off, default 12000). */
@@ -323,45 +367,13 @@ interface ResolvedConfig {
     budgets: Required<PhaseBudgets>;
     temperature: number | undefined;
     replan: boolean;
+    replanAfter: ReplanTrigger;
     synthesize: boolean;
     compressAfterChars: number;
     logLevel: LogLevel;
 }
 declare const resolveConfig: (c: BrowserAgentConfig) => ResolvedConfig;
 
-/** A single step of a plan. Mirrors the Node sibling's IPlanStep. */
-interface IPlanStep {
-    id: string;
-    description: string;
-    expectedOutcome?: string;
-    /** Tools the planner thinks this step needs (drives 'plan-narrowed' selection). */
-    suggestedTools?: string[];
-    /** Set by the pipeline when suggestedTools were named but all were unknown. */
-    requiresTools?: boolean;
-}
-interface IPlan {
-    thought: string;
-    steps: IPlanStep[];
-}
-interface IUsage {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-}
-interface IToolCall {
-    name: string;
-    input: unknown;
-    output: unknown;
-    ok: boolean;
-}
-interface IStepResult {
-    step: IPlanStep;
-    summary: string;
-    toolCalls: IToolCall[];
-    /** True when the executor signalled it could not complete the step ([BLOCKER]). */
-    blocked: boolean;
-}
-
 type ReplanMode = 'continue' | 'revise' | 'finish';
 type Phase = 'plan' | 'execute' | 'replan' | 'synthesize';
 /**
@@ -560,8 +572,28 @@ declare const executeStep: (ctx: AgentContext, goal: string, step: IPlanStep, in
     result: IStepResult;
     usage: IUsage;
 }>;
-/** The replanner runs when a step was blocked or any of its tool calls failed. */
+/**
+ * The replanner runs when a step was blocked or a tool call failed and stayed
+ * failed. A failure that a LATER call to the same tool retried successfully is
+ * resolved — the prompted feedback loop (and native multi-step) let the model
+ * self-correct within the step, so it must not force a replan.
+ */
 declare const shouldReplan: (result: IStepResult) => boolean;
+/** Bound a host `replanAfter` predicate by the same watchdog/abort as a model call. */
+interface ReplanWantedOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    /** Called with whatever a host predicate threw before falling back to 'failure'. */
+    onError?: (err: unknown) => void;
+}
+/**
+ * Resolve the configured `replanAfter` trigger for one step result. 'failure'
+ * is the classic `shouldReplan`; 'always' consults the replanner after every
+ * step; a host predicate decides per result. A predicate that throws, rejects,
+ * or outlives the watchdog/abort falls back to 'failure' behaviour so a buggy
+ * or hung predicate can never stall the run (its throw is surfaced via onError).
+ */
+declare const replanWanted: (trigger: ReplanTrigger, result: IStepResult, opts?: ReplanWantedOptions) => Promise<boolean>;
 
 /**
  * Robust parsing of model output. Small in-browser models emit JSON wrapped in
@@ -803,7 +835,7 @@ interface ToolLoopOptions {
      * them to the SDK's `activeTools`; prompted mode bounds `dispatch` to them.
      */
     activeTools?: string[];
-    /** Native mode: cap on internal tool-calling steps (default 4). */
+    /** Cap on tool-calling rounds within this call, in both modes (default 4). */
     maxSteps?: number;
     maxOutputTokens?: number;
     temperature?: number;
@@ -817,11 +849,12 @@ interface ToolLoopResult {
     usage: IUsage;
 }
 /**
- * Run one round of tool-calling in whichever mode the model needs, returning a
- * normalised result. Native mode streams the SDK's multi-step function-calling;
- * prompted mode does a single generation, salvages a `{ reply, actions }` JSON
- * from the text, and dispatches each action through the tool's own execute.
- * Both call the exact same tool implementations.
+ * Run tool-calling in whichever mode the model needs, returning a normalised
+ * result. Native mode streams the SDK's multi-step function-calling; prompted
+ * mode salvages `{ reply, actions }` JSON out of plain text, dispatches each
+ * action through the tool's own execute, then feeds the TOOL RESULTS back and
+ * lets the model continue the same task — up to `maxSteps` rounds in both
+ * modes. Both modes call the exact same tool implementations.
  */
 declare const runToolLoop: (model: LanguageModel, opts: ToolLoopOptions) => Promise<ToolLoopResult>;
 
@@ -926,4 +959,4 @@ interface CompressOptions {
  */
 declare const compressHistory: (messages: StoredMessage[], model: LanguageModel, opts?: CompressOptions) => Promise<StoredMessage[]>;
 
-export { type Agent, type AgentContext, type AgentEvent, type AgentEventHandler, type AgentLogger, type AgentLoggerSink, type AgentTool, type AgentToolSet, type AgentWebDBOptions, type BrowserAgentConfig, type CompressOptions, type ContextStore, type CredentialStore, type EncryptedBlob, type ExecutorPromptContext, type ExecutorResult, type GenerateOptions, type IPlan, type IPlanStep, type IStepResult, type IToolCall, type IUsage, IndexedDBStore, type IndexedDBStoreOptions, IndexedDBVault, KEYS_STORE, type LogLevel, MemoryCredentialStore, MemoryStore, type ModelInput, type Phase, type PhaseBudgets, PlanSchema, type PlanShape, PlanStepSchema, type PlannerPromptContext, type PlannerResult, type PromptParts, type Prompts, type ProviderModelSpec, type ProviderType, type RawAction, type ReplanDecision, type ReplanMode, ReplanSchema, type ReplanShape, type ReplannerPromptContext, type ReplannerResult, type ResolvedConfig, type ResolvedStage, type RunOptions, type RunResult, SECRETS_STORE, SESSIONS_STORE, type StageInput, type StageOverride, type StoredMessage, type SynthesizerPromptContext, type ToolCallMode, type ToolLoopCallbacks, type ToolLoopOptions, type ToolLoopResult, type ToolMode, type ToolSelectionStrategy, VaultCredentialStore, type VaultOptions, type WebLLMModelOptions, buildModelFromStage, compressHistory, createAgent, createLogger, createPlan, createWebLLMModel, decideReplan, decryptJSON, defaultPrompts, defineTool, directBrowserOk, dispatch, encryptJSON, executeStep, generate, generateStructured, getOrCreateVaultKey, isDirectModel, isProviderSpec, isWebGPUAvailable, looksLikeJson, normalizeSteps, normalizeUsage, openAgentWebDB, parseExecutorResponse, parsePlainText, parsePlannerResponse, parseReplannerResponse, preloadWebLLMModel, promptHintOf, renderCatalog, resolveConfig, resolveModel, resolveStage, runToolLoop, selectToolMode, shouldReplan, splitBlocker, stream, supportsNativeTools, supportsStructuredOutput, synthesizeAnswer, unloadWebLLMModel, withSystem };
+export { type Agent, type AgentContext, type AgentEvent, type AgentEventHandler, type AgentLogger, type AgentLoggerSink, type AgentTool, type AgentToolSet, type AgentWebDBOptions, type BrowserAgentConfig, type CompressOptions, type ContextStore, type CredentialStore, type EncryptedBlob, type ExecutorPromptContext, type ExecutorResult, type GenerateOptions, type IPlan, type IPlanStep, type IStepResult, type IToolCall, type IUsage, IndexedDBStore, type IndexedDBStoreOptions, IndexedDBVault, KEYS_STORE, type LogLevel, MemoryCredentialStore, MemoryStore, type ModelInput, type Phase, type PhaseBudgets, PlanSchema, type PlanShape, PlanStepSchema, type PlannerPromptContext, type PlannerResult, type PromptParts, type Prompts, type ProviderModelSpec, type ProviderType, type RawAction, type ReplanDecision, type ReplanMode, ReplanSchema, type ReplanShape, type ReplanTrigger, type ReplannerPromptContext, type ReplannerResult, type ResolvedConfig, type ResolvedStage, type RunOptions, type RunResult, SECRETS_STORE, SESSIONS_STORE, type StageInput, type StageOverride, type StoredMessage, type SynthesizerPromptContext, type ToolCallMode, type ToolLoopCallbacks, type ToolLoopOptions, type ToolLoopResult, type ToolMode, type ToolSelectionStrategy, VaultCredentialStore, type VaultOptions, type WebLLMModelOptions, buildModelFromStage, compressHistory, createAgent, createLogger, createPlan, createWebLLMModel, decideReplan, decryptJSON, defaultPrompts, defineTool, directBrowserOk, dispatch, encryptJSON, executeStep, generate, generateStructured, getOrCreateVaultKey, isDirectModel, isProviderSpec, isWebGPUAvailable, looksLikeJson, normalizeSteps, normalizeUsage, openAgentWebDB, parseExecutorResponse, parsePlainText, parsePlannerResponse, parseReplannerResponse, preloadWebLLMModel, promptHintOf, renderCatalog, replanWanted, resolveConfig, resolveModel, resolveStage, runToolLoop, selectToolMode, shouldReplan, splitBlocker, stream, supportsNativeTools, supportsStructuredOutput, synthesizeAnswer, unloadWebLLMModel, withSystem };

package/dist/index.d.ts

@@ -3,6 +3,39 @@ import { LanguageModel, ToolSet, Tool, ModelMessage, generateText, streamText }
 import { z, ZodType } from 'zod';
 import { IDBPDatabase } from 'idb';
 
+/** A single step of a plan. Mirrors the Node sibling's IPlanStep. */
+interface IPlanStep {
+    id: string;
+    description: string;
+    expectedOutcome?: string;
+    /** Tools the planner thinks this step needs (drives 'plan-narrowed' selection). */
+    suggestedTools?: string[];
+    /** Set by the pipeline when suggestedTools were named but all were unknown. */
+    requiresTools?: boolean;
+}
+interface IPlan {
+    thought: string;
+    steps: IPlanStep[];
+}
+interface IUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+interface IToolCall {
+    name: string;
+    input: unknown;
+    output: unknown;
+    ok: boolean;
+}
+interface IStepResult {
+    step: IPlanStep;
+    summary: string;
+    toolCalls: IToolCall[];
+    /** True when the executor signalled it could not complete the step ([BLOCKER]). */
+    blocked: boolean;
+}
+
 interface StoredMessage {
     role: 'system' | 'user' | 'assistant';
     content: string;
@@ -245,6 +278,15 @@ declare const promptHintOf: (tool: Tool) => string | undefined;
 
 /** Force a tool-calling strategy, or let the agent pick per model ('auto'). */
 type ToolMode = 'auto' | 'native' | 'prompted';
+/**
+ * When to consult the replanner after an executed step (given `replan` is on):
+ * 'failure' — after a blocked step or a failed tool call (default);
+ * 'always'  — after every step, so the replanner can react to problems the host
+ *             surfaces via `describeState` (one extra model call per step);
+ * predicate — decides per step result; closes over host state if needed, and
+ *             falls back to 'failure' behaviour if it throws.
+ */
+type ReplanTrigger = 'failure' | 'always' | ((result: IStepResult) => boolean | Promise<boolean>);
 /**
  * 'all'           — the executor sees the full ToolSet on every step.
  * 'plan-narrowed' — the executor sees only a step's suggestedTools (the planner
@@ -292,7 +334,7 @@ interface BrowserAgentConfig {
     sessionId?: string;
     /** Hard cap on executed steps incl. replans (default 8). */
     maxIterations?: number;
-    /** Cap on LLM steps inside a single native executor call (default 4). */
+    /** Cap on tool-calling rounds inside one executor call, both modes (default 4). */
     maxStepsPerTask?: number;
     /** Cap on replanner "revise" decisions per run (default 2). */
     maxRevisions?: number;
@@ -300,8 +342,10 @@ interface BrowserAgentConfig {
     chatTimeoutMs?: number;
     budgets?: PhaseBudgets;
     temperature?: number;
-    /** Replan after a blocked/failed step (default true). */
+    /** Master switch for the replan phase (default true). */
     replan?: boolean;
+    /** What triggers the replanner when it is on (default 'failure'). */
+    replanAfter?: ReplanTrigger;
     /** Write a final natural-language summary (default true). */
     synthesize?: boolean;
     /** Compress stored history past this many chars (0 = off, default 12000). */
@@ -323,45 +367,13 @@ interface ResolvedConfig {
     budgets: Required<PhaseBudgets>;
     temperature: number | undefined;
     replan: boolean;
+    replanAfter: ReplanTrigger;
     synthesize: boolean;
     compressAfterChars: number;
     logLevel: LogLevel;
 }
 declare const resolveConfig: (c: BrowserAgentConfig) => ResolvedConfig;
 
-/** A single step of a plan. Mirrors the Node sibling's IPlanStep. */
-interface IPlanStep {
-    id: string;
-    description: string;
-    expectedOutcome?: string;
-    /** Tools the planner thinks this step needs (drives 'plan-narrowed' selection). */
-    suggestedTools?: string[];
-    /** Set by the pipeline when suggestedTools were named but all were unknown. */
-    requiresTools?: boolean;
-}
-interface IPlan {
-    thought: string;
-    steps: IPlanStep[];
-}
-interface IUsage {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-}
-interface IToolCall {
-    name: string;
-    input: unknown;
-    output: unknown;
-    ok: boolean;
-}
-interface IStepResult {
-    step: IPlanStep;
-    summary: string;
-    toolCalls: IToolCall[];
-    /** True when the executor signalled it could not complete the step ([BLOCKER]). */
-    blocked: boolean;
-}
-
 type ReplanMode = 'continue' | 'revise' | 'finish';
 type Phase = 'plan' | 'execute' | 'replan' | 'synthesize';
 /**
@@ -560,8 +572,28 @@ declare const executeStep: (ctx: AgentContext, goal: string, step: IPlanStep, in
     result: IStepResult;
     usage: IUsage;
 }>;
-/** The replanner runs when a step was blocked or any of its tool calls failed. */
+/**
+ * The replanner runs when a step was blocked or a tool call failed and stayed
+ * failed. A failure that a LATER call to the same tool retried successfully is
+ * resolved — the prompted feedback loop (and native multi-step) let the model
+ * self-correct within the step, so it must not force a replan.
+ */
 declare const shouldReplan: (result: IStepResult) => boolean;
+/** Bound a host `replanAfter` predicate by the same watchdog/abort as a model call. */
+interface ReplanWantedOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    /** Called with whatever a host predicate threw before falling back to 'failure'. */
+    onError?: (err: unknown) => void;
+}
+/**
+ * Resolve the configured `replanAfter` trigger for one step result. 'failure'
+ * is the classic `shouldReplan`; 'always' consults the replanner after every
+ * step; a host predicate decides per result. A predicate that throws, rejects,
+ * or outlives the watchdog/abort falls back to 'failure' behaviour so a buggy
+ * or hung predicate can never stall the run (its throw is surfaced via onError).
+ */
+declare const replanWanted: (trigger: ReplanTrigger, result: IStepResult, opts?: ReplanWantedOptions) => Promise<boolean>;
 
 /**
  * Robust parsing of model output. Small in-browser models emit JSON wrapped in
@@ -803,7 +835,7 @@ interface ToolLoopOptions {
      * them to the SDK's `activeTools`; prompted mode bounds `dispatch` to them.
      */
     activeTools?: string[];
-    /** Native mode: cap on internal tool-calling steps (default 4). */
+    /** Cap on tool-calling rounds within this call, in both modes (default 4). */
     maxSteps?: number;
     maxOutputTokens?: number;
     temperature?: number;
@@ -817,11 +849,12 @@ interface ToolLoopResult {
     usage: IUsage;
 }
 /**
- * Run one round of tool-calling in whichever mode the model needs, returning a
- * normalised result. Native mode streams the SDK's multi-step function-calling;
- * prompted mode does a single generation, salvages a `{ reply, actions }` JSON
- * from the text, and dispatches each action through the tool's own execute.
- * Both call the exact same tool implementations.
+ * Run tool-calling in whichever mode the model needs, returning a normalised
+ * result. Native mode streams the SDK's multi-step function-calling; prompted
+ * mode salvages `{ reply, actions }` JSON out of plain text, dispatches each
+ * action through the tool's own execute, then feeds the TOOL RESULTS back and
+ * lets the model continue the same task — up to `maxSteps` rounds in both
+ * modes. Both modes call the exact same tool implementations.
  */
 declare const runToolLoop: (model: LanguageModel, opts: ToolLoopOptions) => Promise<ToolLoopResult>;
 
@@ -926,4 +959,4 @@ interface CompressOptions {
  */
 declare const compressHistory: (messages: StoredMessage[], model: LanguageModel, opts?: CompressOptions) => Promise<StoredMessage[]>;
 
-export { type Agent, type AgentContext, type AgentEvent, type AgentEventHandler, type AgentLogger, type AgentLoggerSink, type AgentTool, type AgentToolSet, type AgentWebDBOptions, type BrowserAgentConfig, type CompressOptions, type ContextStore, type CredentialStore, type EncryptedBlob, type ExecutorPromptContext, type ExecutorResult, type GenerateOptions, type IPlan, type IPlanStep, type IStepResult, type IToolCall, type IUsage, IndexedDBStore, type IndexedDBStoreOptions, IndexedDBVault, KEYS_STORE, type LogLevel, MemoryCredentialStore, MemoryStore, type ModelInput, type Phase, type PhaseBudgets, PlanSchema, type PlanShape, PlanStepSchema, type PlannerPromptContext, type PlannerResult, type PromptParts, type Prompts, type ProviderModelSpec, type ProviderType, type RawAction, type ReplanDecision, type ReplanMode, ReplanSchema, type ReplanShape, type ReplannerPromptContext, type ReplannerResult, type ResolvedConfig, type ResolvedStage, type RunOptions, type RunResult, SECRETS_STORE, SESSIONS_STORE, type StageInput, type StageOverride, type StoredMessage, type SynthesizerPromptContext, type ToolCallMode, type ToolLoopCallbacks, type ToolLoopOptions, type ToolLoopResult, type ToolMode, type ToolSelectionStrategy, VaultCredentialStore, type VaultOptions, type WebLLMModelOptions, buildModelFromStage, compressHistory, createAgent, createLogger, createPlan, createWebLLMModel, decideReplan, decryptJSON, defaultPrompts, defineTool, directBrowserOk, dispatch, encryptJSON, executeStep, generate, generateStructured, getOrCreateVaultKey, isDirectModel, isProviderSpec, isWebGPUAvailable, looksLikeJson, normalizeSteps, normalizeUsage, openAgentWebDB, parseExecutorResponse, parsePlainText, parsePlannerResponse, parseReplannerResponse, preloadWebLLMModel, promptHintOf, renderCatalog, resolveConfig, resolveModel, resolveStage, runToolLoop, selectToolMode, shouldReplan, splitBlocker, stream, supportsNativeTools, supportsStructuredOutput, synthesizeAnswer, unloadWebLLMModel, withSystem };
+export { type Agent, type AgentContext, type AgentEvent, type AgentEventHandler, type AgentLogger, type AgentLoggerSink, type AgentTool, type AgentToolSet, type AgentWebDBOptions, type BrowserAgentConfig, type CompressOptions, type ContextStore, type CredentialStore, type EncryptedBlob, type ExecutorPromptContext, type ExecutorResult, type GenerateOptions, type IPlan, type IPlanStep, type IStepResult, type IToolCall, type IUsage, IndexedDBStore, type IndexedDBStoreOptions, IndexedDBVault, KEYS_STORE, type LogLevel, MemoryCredentialStore, MemoryStore, type ModelInput, type Phase, type PhaseBudgets, PlanSchema, type PlanShape, PlanStepSchema, type PlannerPromptContext, type PlannerResult, type PromptParts, type Prompts, type ProviderModelSpec, type ProviderType, type RawAction, type ReplanDecision, type ReplanMode, ReplanSchema, type ReplanShape, type ReplanTrigger, type ReplannerPromptContext, type ReplannerResult, type ResolvedConfig, type ResolvedStage, type RunOptions, type RunResult, SECRETS_STORE, SESSIONS_STORE, type StageInput, type StageOverride, type StoredMessage, type SynthesizerPromptContext, type ToolCallMode, type ToolLoopCallbacks, type ToolLoopOptions, type ToolLoopResult, type ToolMode, type ToolSelectionStrategy, VaultCredentialStore, type VaultOptions, type WebLLMModelOptions, buildModelFromStage, compressHistory, createAgent, createLogger, createPlan, createWebLLMModel, decideReplan, decryptJSON, defaultPrompts, defineTool, directBrowserOk, dispatch, encryptJSON, executeStep, generate, generateStructured, getOrCreateVaultKey, isDirectModel, isProviderSpec, isWebGPUAvailable, looksLikeJson, normalizeSteps, normalizeUsage, openAgentWebDB, parseExecutorResponse, parsePlainText, parsePlannerResponse, parseReplannerResponse, preloadWebLLMModel, promptHintOf, renderCatalog, replanWanted, resolveConfig, resolveModel, resolveStage, runToolLoop, selectToolMode, shouldReplan, splitBlocker, stream, supportsNativeTools, supportsStructuredOutput, synthesizeAnswer, unloadWebLLMModel, withSystem };

package/dist/index.js

@@ -23,6 +23,7 @@ var resolveConfig = (c) => ({
   },
   temperature: c.temperature,
   replan: c.replan ?? true,
+  replanAfter: c.replanAfter ?? "failure",
   synthesize: c.synthesize ?? true,
   compressAfterChars: c.compressAfterChars ?? 12e3,
   logLevel: c.logLevel ?? "warn"
@@ -36,6 +37,7 @@ import {
 } from "ai";
 
 // src/llm/util.ts
+var clip = (s, max) => s.length > max ? `${s.slice(0, max - 1)}\u2026` : s;
 var promptOf = (opts) => opts.messages ? { messages: opts.messages } : { prompt: opts.prompt ?? "" };
 var normalizeUsage = (u) => {
   const inputTokens = u?.inputTokens ?? 0;
@@ -308,7 +310,6 @@ var stateBlock = (state) => state && state.trim() ? `
 
 STATE:
 ${state}` : "";
-var clip = (s, max) => s.length > max ? `${s.slice(0, max - 1)}\u2026` : s;
 var historyBlock = (history) => {
   if (!history || history.length === 0) return "";
   const lines = history.slice(-8).map((m) => `${m.role}: ${clip(m.content, 400)}`);
@@ -341,8 +342,9 @@ Reply with a single JSON object, nothing else:
 - "actions" are the tool calls for THIS step ([] if none are needed). Use ONLY tools from the TOOLS list; "args" must match the tool's parameters.
 - Build on the current STATE \u2014 do not repeat work that is already there.
 - "reply" is one short human sentence (no JSON) describing what you did.
+- After your actions run you will see their TOOL RESULTS and may continue the same step; finish with "actions": [] once it is done.
 - If you CANNOT complete the step, set "actions": [] and put the token [BLOCKER] in "reply" with a short reason.`;
-var REPLANNER_NATIVE = `You are the REPLANNER. After a step that was blocked or had a failed tool call, decide whether to keep going, revise the remaining steps, or finish.
+var REPLANNER_NATIVE = `You are the REPLANNER. After an executed step, decide whether to keep going, revise the remaining steps, or finish.
 "continue": the remaining steps still fit. "revise": provide a better "plan" for the REMAINING work (never repeat done work). "finish": the goal is already met.
 Judge from the current STATE vs the goal. Prefer "continue".`;
 var REPLANNER_PROMPTED = `You are the REPLANNER. After each executed step you decide whether to keep going, revise the remaining steps, or finish.
@@ -476,6 +478,15 @@ import {
   streamText as streamText2
 } from "ai";
 
+// src/agent/loop-types.ts
+var BLOCKER = "[BLOCKER]";
+var emptyUsage = () => ({ inputTokens: 0, outputTokens: 0, totalTokens: 0 });
+var addUsage = (a, b) => ({
+  inputTokens: a.inputTokens + b.inputTokens,
+  outputTokens: a.outputTokens + b.outputTokens,
+  totalTokens: a.totalTokens + b.totalTokens
+});
+
 // src/parse.ts
 var stripFences = (text) => (text || "").replace(/```(?:json)?/gi, "").trim();
 var extractBalanced = (text, open) => {
@@ -674,34 +685,74 @@ var runNative = async (model, opts) => {
   const [text, usage] = await Promise.all([result.text, result.usage]);
   return { text: text.trim(), toolCalls, usage: normalizeUsage(usage) };
 };
+var asJson = (value) => {
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+};
+var toolResultsPrompt = (results) => {
+  const lines = results.map(
+    (r) => `- ${r.name} ${clip(asJson(r.input), 160)} \u2192 ${r.ok ? "ok" : "FAILED"}: ${clip(asJson(r.output), 400)}`
+  );
+  return `TOOL RESULTS:
+${lines.join("\n")}
+
+Continue THIS step using the results above. Reply with a single JSON object, nothing else:
+{ "reply": string, "actions": [ { "tool": string, "args": object } ] }
+- If the step is now complete: "actions": [] and a short outcome in "reply".
+- Otherwise emit ONLY the remaining or corrective calls \u2014 never repeat a successful call.`;
+};
 var runPrompted = async (model, opts) => {
-  const result = await generateText2({
-    model,
-    system: opts.system,
-    ...promptOf(opts),
-    maxOutputTokens: opts.maxOutputTokens,
-    temperature: opts.temperature,
-    abortSignal: timeoutSignal(opts.abortSignal, opts.timeoutMs)
-  });
-  const parsed = parseExecutorResponse(result.text);
-  if (parsed.reply) opts.callbacks?.onTextDelta?.(parsed.reply);
+  const maxRounds = Math.max(1, opts.maxSteps ?? 4);
   const active = opts.activeTools;
   const tools = active ? Object.fromEntries(Object.entries(opts.tools).filter(([name]) => active.includes(name))) : opts.tools;
+  const signal = timeoutSignal(opts.abortSignal, opts.timeoutMs);
+  const messages = opts.messages ? [...opts.messages] : [{ role: "user", content: opts.prompt ?? "" }];
   const toolCalls = [];
-  for (const action of parsed.actions) {
-    opts.callbacks?.onToolCall?.(action.tool, action.args);
-    const rec = await dispatch(action, tools, { abortSignal: opts.abortSignal });
-    toolCalls.push(rec);
-    opts.callbacks?.onToolResult?.(rec.name, rec.output, rec.ok);
+  const seen = /* @__PURE__ */ new Set();
+  let usage = emptyUsage();
+  let text = "";
+  for (let round = 1; round <= maxRounds; round += 1) {
+    if (signal?.aborted) break;
+    const result = await generateText2({
+      model,
+      system: opts.system,
+      messages,
+      maxOutputTokens: opts.maxOutputTokens,
+      temperature: opts.temperature,
+      abortSignal: signal
+    });
+    usage = addUsage(usage, normalizeUsage(result.usage));
+    const parsed = parseExecutorResponse(result.text);
+    text = parsed.reply;
+    if (parsed.reply.includes(BLOCKER)) break;
+    if (parsed.actions.length === 0) break;
+    const batch = asJson(parsed.actions);
+    if (seen.has(batch)) break;
+    seen.add(batch);
+    const results = [];
+    for (const action of parsed.actions) {
+      if (signal?.aborted) break;
+      opts.callbacks?.onToolCall?.(action.tool, action.args);
+      const rec = await dispatch(action, tools, { abortSignal: signal });
+      toolCalls.push(rec);
+      results.push(rec);
+      opts.callbacks?.onToolResult?.(rec.name, rec.output, rec.ok);
+    }
+    if (round === maxRounds || signal?.aborted) break;
+    messages.push({ role: "assistant", content: result.text });
+    messages.push({ role: "user", content: toolResultsPrompt(results) });
   }
-  return { text: parsed.reply, toolCalls, usage: normalizeUsage(result.usage) };
+  if (text) opts.callbacks?.onTextDelta?.(text);
+  return { text, toolCalls, usage };
 };
 
 // src/agent/internal.ts
 var systemFor = (ctx, base) => withSystem(base, ctx.raw.systemPrompt);
 
 // src/agent/executor.ts
-var BLOCKER = "[BLOCKER]";
 var splitBlocker = (raw) => {
   if (!raw.includes(BLOCKER)) return { summary: raw.trim(), blocked: false };
   return { summary: raw.split(BLOCKER).join("").trim(), blocked: true };
@@ -766,15 +817,35 @@ var executeStep = async (ctx, goal, step, index, total, done) => {
     usage: loop.usage
   };
 };
-var shouldReplan = (result) => result.blocked || result.toolCalls.some((c) => !c.ok);
-
-// src/agent/loop-types.ts
-var emptyUsage = () => ({ inputTokens: 0, outputTokens: 0, totalTokens: 0 });
-var addUsage = (a, b) => ({
-  inputTokens: a.inputTokens + b.inputTokens,
-  outputTokens: a.outputTokens + b.outputTokens,
-  totalTokens: a.totalTokens + b.totalTokens
-});
+var shouldReplan = (result) => {
+  if (result.blocked) return true;
+  const { toolCalls } = result;
+  return toolCalls.some(
+    (c, i) => !c.ok && !toolCalls.slice(i + 1).some((later) => later.ok && later.name === c.name)
+  );
+};
+var replanWanted = async (trigger, result, opts = {}) => {
+  if (trigger === "always") return true;
+  if (typeof trigger !== "function") return shouldReplan(result);
+  const fallback = () => shouldReplan(result);
+  const decided = (async () => {
+    try {
+      return Boolean(await trigger(result));
+    } catch (err) {
+      opts.onError?.(err);
+      return fallback();
+    }
+  })();
+  const guard = timeoutSignal(opts.signal, opts.timeoutMs);
+  if (!guard) return decided;
+  return Promise.race([
+    decided,
+    new Promise((resolve) => {
+      if (guard.aborted) resolve(fallback());
+      else guard.addEventListener("abort", () => resolve(fallback()), { once: true });
+    })
+  ]);
+};
 
 // src/agent/schemas.ts
 import { z } from "zod";
@@ -1127,7 +1198,12 @@ var createAgent = async (config) => {
         done.push(
           `${step.description} \u2014 ${applied} applied${failed ? `, ${failed} failed` : ""}${stepResult.blocked ? ", blocked" : ""}`
         );
-        if (cfg.replan && iter < cfg.maxIterations && revisions < cfg.maxRevisions && !isAborted() && shouldReplan(stepResult)) {
+        const wantReplan = cfg.replan && iter < cfg.maxIterations && revisions < cfg.maxRevisions && !isAborted() && await replanWanted(cfg.replanAfter, stepResult, {
+          signal: ctx.signal,
+          timeoutMs: cfg.chatTimeoutMs,
+          onError: (err) => log.warn("replanAfter predicate threw \u2014 using the failure rule", err)
+        });
+        if (wantReplan && !isAborted()) {
           const decision = await decideReplan(
             ctx,
             text,
@@ -1452,6 +1528,7 @@ export {
   preloadWebLLMModel,
   promptHintOf,
   renderCatalog,
+  replanWanted,
   resolveConfig,
   resolveModel,
   resolveStage,