@pentoshi/clai 3.9.2 → 3.9.4

package/dist/agent/runner.d.ts

@@ -3,12 +3,23 @@ import { type BackgroundJob, type ResponderNotification } from "../tools/jobs.js
 import { type SessionPlan } from "../store/plan.js";
 import type { AgentEvent } from "./events.js";
 import { type SessionPolicy } from "./session-policy.js";
+import { type PreviousTurnSignal } from "./continue-orient.js";
 import { type ConfirmPort } from "./confirm-port.js";
 export * from "./tool-call-parser.js";
 export { createSessionPolicy, isPreApprovalAllowedTool, isPlanApprovedByStatus, planHasOpenWork, shouldEnableImageOcr, type SessionPolicy, } from "./session-policy.js";
 export { type ConfirmPort } from "./confirm-port.js";
 export declare function styleToolChatter(call: ToolCall, text: string): string;
-export declare function shouldYieldForResponderBeforeReport(plan: SessionPlan | undefined, runningJobs: readonly BackgroundJob[], notifications: readonly ResponderNotification[], currentNotificationId?: string | undefined): boolean;
+/**
+ * A foreground task waits for a responder child only when the plan
+ * Declares that dependency. Report titles carry no scheduling meaning: any
+ * Dependency-ready foreground work is executed while children keep running, and
+ * Their results arrive as addenda.
+ *
+ * A declared dependency blocks only while the child is genuinely live (running
+ * Job or an undelivered/unanalyzed receipt), so an orphaned child can never
+ * Stall the turn forever.
+ */
+export declare function shouldYieldForDeclaredResponderDependency(plan: SessionPlan | undefined, runningJobs: readonly BackgroundJob[], notifications: readonly ResponderNotification[], currentNotificationId?: string | undefined): boolean;
 export interface AgentRunOptions {
     provider?: ProviderId | undefined;
     model?: string | undefined;
@@ -42,7 +53,9 @@ export interface AgentRunOptions {
      * chat; model still receives `prompt`. Omit to show `prompt`.
      */
     displayPrompt?: string | null | undefined;
+    /** How the previous turn ended, so recovery is decided from state. */
+    previousTurn?: PreviousTurnSignal | undefined;
 }
 export declare function runAgentTurn(prompt: string, options?: AgentRunOptions): Promise<import("./turn-outcome.js").TurnOutcome>;
-/** Compatibility boundary for callers that still consume rendered text. */
+/** Compatibility boundary for callers that consume visible assistant text. */
 export declare function runAgentLoop(prompt: string, options?: AgentRunOptions): Promise<string>;