@pentoshi/clai 3.9.1 → 3.9.3

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,6 +53,8 @@ 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. */