@pentoshi/clai 4.11.5 → 4.11.8

package/dist/agent/turn/loop/empty-response.js

@@ -0,0 +1,51 @@
+import { appendInterruptedReasoning, interruptedReasoningBrief, } from "../../interrupted-reasoning.js";
+import { toolNudge } from "../../../prompts/index.js";
+const MAX_EMPTY_RETRIES = 3;
+const baseNudgeFor = (ports, input) => {
+    if (input.incompleteNativeStream) {
+        return "Your native tool call was incomplete, so nothing ran. Use exactly one complete fenced ```tool block now; do not repeat the incomplete native call.";
+    }
+    if (ports.planModeWithoutPlan) {
+        return ports.toolsAttached
+            ? "No visible output. In plan mode: gather context or call plan.create when ready (do not only describe the plan)."
+            : "No visible output. In plan mode: emit a ```tool block for research/recon or plan.create. " +
+                "Do NOT hide tool calls in <think> tags — put them in the visible response.";
+    }
+    return ports.toolsAttached
+        ? "No visible output. " + toolNudge(true)
+        : "No visible output. Emit a ```tool block or give your final answer. " +
+            "Do NOT hide tool calls in <think> tags — put them in the visible response.";
+};
+export const handleEmptyResponse = (ports, state, input) => {
+    state.emptyVisibleRetries += 1;
+    if (state.emptyVisibleRetries > MAX_EMPTY_RETRIES) {
+        ports.notify("warn", "model returned an empty response after retries — no answer produced");
+        return "stop";
+    }
+    ports.notify("warn", input.hasThinking
+        ? "model produced only thinking — preserving the reasoning and nudging it to act"
+        : "model returned an empty response — nudging it to answer");
+    if (input.hasThinking) {
+        state.interruptedReasoning = appendInterruptedReasoning(state.interruptedReasoning, input.assistantThinkContent);
+    }
+    const preservedReasoning = state.interruptedReasoning;
+    if (input.hasThinking && state.emptyVisibleRetries >= 2) {
+        state.retryWithoutThinking = true;
+    }
+    ports.commitAssistantRetry(input.assistantVisible);
+    state.interruptedReasoning = preservedReasoning;
+    const baseNudge = baseNudgeFor(ports, input);
+    const reasoningBrief = input.hasThinking
+        ? interruptedReasoningBrief(state.interruptedReasoning)
+        : undefined;
+    ports.messages.push(ports.recoveryUserMessage(reasoningBrief
+        ? "Your previous response contained only reasoning and no visible answer or tool call. " +
+            "Do not restart the analysis — your reasoning so far is preserved below. " +
+            "Build on it and act now: emit the next tool call or the final answer.\n\n" +
+            reasoningBrief +
+            "\n\n" +
+            baseNudge
+        : baseNudge));
+    return "continue-round";
+};
+//# sourceMappingURL=empty-response.js.map

package/dist/agent/turn/loop/empty-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-response.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/empty-response.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA0BtD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,YAAY,GAAG,CACnB,KAAyB,EACzB,KAAyB,EACjB,EAAE;IACV,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;QACjC,OAAO,oJAAoJ,CAAC;IAC9J,CAAC;IACD,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,aAAa;YACxB,CAAC,CAAC,iHAAiH;YACnH,CAAC,CAAC,2FAA2F;gBACzF,4EAA4E,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC,aAAa;QACxB,CAAC,CAAC,qBAAqB,GAAG,SAAS,CAAC,IAAI,CAAC;QACzC,CAAC,CAAC,qEAAqE;YACnE,4EAA4E,CAAC;AACrF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAyB,EACzB,KAAyB,EACzB,KAAyB,EACF,EAAE;IACzB,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,mBAAmB,GAAG,iBAAiB,EAAE,CAAC;QAClD,KAAK,CAAC,MAAM,CACV,MAAM,EACN,qEAAqE,CACtE,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAAM,EACN,KAAK,CAAC,WAAW;QACf,CAAC,CAAC,+EAA+E;QACjF,CAAC,CAAC,yDAAyD,CAC9D,CAAC;IACF,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,oBAAoB,GAAG,0BAA0B,CACrD,KAAK,CAAC,oBAAoB,EAC1B,KAAK,CAAC,qBAAqB,CAC5B,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GAAG,KAAK,CAAC,oBAAoB,CAAC;IACtD,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnD,KAAK,CAAC,oBAAoB,GAAG,kBAAkB,CAAC;IAEhD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW;QACtC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,oBAAoB,CAAC;QACvD,CAAC,CAAC,SAAS,CAAC;IACd,KAAK,CAAC,QAAQ,CAAC,IAAI,CACjB,KAAK,CAAC,mBAAmB,CACvB,cAAc;QACZ,CAAC,CAAC,sFAAsF;YACpF,0EAA0E;YAC1E,2EAA2E;YAC3E,cAAc;YACd,MAAM;YACN,SAAS;QACb,CAAC,CAAC,SAAS,CACd,CACF,CAAC;IACF,OAAO,gBAAgB,CAAC;AAC1B,CAAC,CAAC"}

package/dist/agent/turn/loop/final-outcome.d.ts

@@ -0,0 +1,15 @@
+import type { SessionPlan } from "../../../store/plan.js";
+import type { TurnOutcomeStatus } from "../../turn-outcome.js";
+import type { OutcomeEnvelope } from "../../outcomes.js";
+export interface FinalOutcomePorts {
+    readonly outcomeState: OutcomeEnvelope;
+    readonly planApproved: boolean;
+    readonly loadPlan: () => Promise<SessionPlan | undefined>;
+    readonly saveOutcomeState: (state: OutcomeEnvelope) => Promise<void>;
+}
+export interface FinalOutcome {
+    readonly status: TurnOutcomeStatus;
+    readonly remainingCriteria: string[];
+    readonly reason: string | undefined;
+}
+export declare const resolveFinalOutcome: (ports: FinalOutcomePorts, answer: string) => Promise<FinalOutcome>;

package/dist/agent/turn/loop/final-outcome.js

@@ -0,0 +1,49 @@
+import { deriveOutcomeStatus, recordAnswerEvidence, validateCriterionEvidence, } from "../../outcomes.js";
+import { foregroundRemaining, responderOpenTasks } from "../../../store/plan.js";
+const planRemainingCriteria = (plan) => {
+    if (!plan)
+        return { criteria: [], status: undefined };
+    const unfinished = foregroundRemaining(plan);
+    const failed = plan.tasks.filter((task) => !task.responderOwned && task.state === "failed");
+    const criteria = [
+        ...unfinished.map((task) => `[${task.id}] ${task.title}`),
+        ...failed.map((task) => `[${task.id}] retry failed task: ${task.title}`),
+        ...responderOpenTasks(plan).map((task) => `[${task.id}] responder result awaiting analysis: ${task.title}`),
+    ];
+    if (failed.length > 0)
+        return { criteria, status: "failed" };
+    if (unfinished.length > 0)
+        return { criteria, status: "partial" };
+    return { criteria, status: undefined };
+};
+const reasonFor = (status) => {
+    if (status === "failed")
+        return "One or more required plan tasks failed.";
+    if (status === "partial") {
+        return "Required outcome criteria remain unsupported by current evidence.";
+    }
+    return undefined;
+};
+export const resolveFinalOutcome = async (ports, answer) => {
+    let status = "succeeded";
+    const remainingCriteria = [];
+    if (ports.planApproved) {
+        const plan = await ports.loadPlan();
+        const fromPlan = planRemainingCriteria(plan);
+        remainingCriteria.push(...fromPlan.criteria);
+        if (fromPlan.status)
+            status = fromPlan.status;
+    }
+    recordAnswerEvidence(ports.outcomeState, answer);
+    ports.outcomeState.outcome.status = deriveOutcomeStatus(ports.outcomeState.outcome, ports.outcomeState.evidence);
+    await ports.saveOutcomeState(ports.outcomeState);
+    const unsupported = ports.outcomeState.outcome.criteria.filter((criterion) => criterion.required &&
+        !validateCriterionEvidence(criterion, ports.outcomeState.evidence).ok);
+    if (unsupported.length > 0 && status === "succeeded")
+        status = "partial";
+    remainingCriteria.push(...unsupported
+        .map((criterion) => criterion.statement)
+        .filter((statement) => !remainingCriteria.includes(statement)));
+    return { status, remainingCriteria, reason: reasonFor(status) };
+};
+//# sourceMappingURL=final-outcome.js.map

package/dist/agent/turn/loop/final-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-outcome.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/final-outcome.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAejF,MAAM,qBAAqB,GAAG,CAC5B,IAA6B,EACkC,EAAE;IACjE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtD,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAC1D,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACzD,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,wBAAwB,IAAI,CAAC,KAAK,EAAE,CAAC;QACxE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,yCAAyC,IAAI,CAAC,KAAK,EAAE,CAC3E;KACF,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC7D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,MAAyB,EAAsB,EAAE;IAClE,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,yCAAyC,CAAC;IAC1E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,mEAAmE,CAAC;IAC7E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,KAAwB,EACxB,MAAc,EACS,EAAE;IACzB,IAAI,MAAM,GAAsB,WAAW,CAAC;IAC5C,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC7C,iBAAiB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM;YAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAChD,CAAC;IAED,oBAAoB,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,mBAAmB,CACrD,KAAK,CAAC,YAAY,CAAC,OAAO,EAC1B,KAAK,CAAC,YAAY,CAAC,QAAQ,CAC5B,CAAC;IACF,MAAM,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAEjD,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAC5D,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,QAAQ;QAClB,CAAC,yBAAyB,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,CACxE,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,WAAW;QAAE,MAAM,GAAG,SAAS,CAAC;IACzE,iBAAiB,CAAC,IAAI,CACpB,GAAG,WAAW;SACX,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC;SACvC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACjE,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;AAClE,CAAC,CAAC"}

package/dist/agent/turn/loop/group-execution.d.ts

@@ -0,0 +1,14 @@
+import type { ToolCall } from "../../../types.js";
+import type { BoundCall, SingleToolResult } from "../contracts.js";
+import type { RoundState } from "./round-state.js";
+import type { RecordedToolResult } from "./round-recorder.js";
+export interface GroupExecutionPorts {
+    readonly round: RoundState;
+    readonly boundFor: (call: ToolCall) => BoundCall | undefined;
+    readonly eventIdFor: (bound: BoundCall) => string;
+    readonly replay: (bound: BoundCall, uiId: string) => RecordedToolResult | undefined;
+    readonly execute: (call: ToolCall, uiId: string) => Promise<SingleToolResult>;
+    readonly record: (bound: BoundCall, res: RecordedToolResult) => void;
+    readonly remember: (bound: BoundCall, res: RecordedToolResult) => void;
+}
+export declare const executeToolGroups: (ports: GroupExecutionPorts, groups: readonly (readonly ToolCall[])[]) => Promise<void>;

package/dist/agent/turn/loop/group-execution.js

@@ -0,0 +1,44 @@
+const runOne = async (ports, call) => {
+    const bound = ports.boundFor(call);
+    if (!bound)
+        return;
+    const uiId = ports.eventIdFor(bound);
+    const replayed = ports.replay(bound, uiId);
+    if (replayed) {
+        ports.record(bound, replayed);
+        return;
+    }
+    const res = await ports.execute(call, uiId);
+    ports.record(bound, res);
+    ports.remember(bound, res);
+};
+const runConcurrent = async (ports, group) => {
+    const bounds = [];
+    const uiIds = [];
+    for (const call of group) {
+        const bound = ports.boundFor(call);
+        if (!bound)
+            continue;
+        bounds.push(bound);
+        uiIds.push(ports.eventIdFor(bound));
+    }
+    const results = await Promise.all(bounds.map((bound, index) => {
+        const replayed = ports.replay(bound, uiIds[index]);
+        return replayed ?? ports.execute(bound.call, uiIds[index]);
+    }));
+    for (let index = 0; index < results.length; index += 1) {
+        ports.record(bounds[index], results[index]);
+        ports.remember(bounds[index], results[index]);
+    }
+};
+export const executeToolGroups = async (ports, groups) => {
+    for (const group of groups) {
+        if (ports.round.aborted || ports.round.awaitingPlanApproval)
+            break;
+        if (group.length === 1)
+            await runOne(ports, group[0]);
+        else
+            await runConcurrent(ports, group);
+    }
+};
+//# sourceMappingURL=group-execution.js.map

package/dist/agent/turn/loop/group-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-execution.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/group-execution.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,GAAG,KAAK,EAClB,KAA0B,EAC1B,IAAc,EACC,EAAE;IACjB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzB,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EACzB,KAA0B,EAC1B,KAA0B,EACX,EAAE;IACjB,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC;QACpD,OAAO,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CACH,CAAC;IACF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,OAAO,CAAC,KAAK,CAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,OAAO,CAAC,KAAK,CAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,KAA0B,EAC1B,MAAwC,EACzB,EAAE;IACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,oBAAoB;YAAE,MAAM;QACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;;YAClD,MAAM,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC,CAAC"}

package/dist/agent/turn/loop/model-only-rounds.d.ts

@@ -0,0 +1,31 @@
+import type { ChatMessage, ProviderId } from "../../../types.js";
+import type { SessionPlan } from "../../../store/plan.js";
+export interface ModelOnlyRoundPorts {
+    readonly messages: ChatMessage[];
+    readonly provider: ProviderId;
+    readonly model: string;
+    readonly toolsAttached: boolean;
+    readonly notify: (level: "info" | "warn", message: string) => void;
+    readonly commitAssistantRetry: (text: string) => void;
+    readonly recoveryUserMessage: (content: string) => ChatMessage;
+    readonly writeAssistantMessage: (text: string) => void;
+    readonly unreadResponderIds: () => readonly string[];
+}
+export interface ModelOnlyRoundInput {
+    readonly assistantVisible: string;
+    readonly wantsAction: boolean;
+    readonly consecutiveModelOnlyRounds: number;
+    readonly plan: SessionPlan | undefined;
+}
+export interface ModelOnlyStop {
+    readonly kind: "stop";
+    readonly answer: string;
+    readonly remainingCriteria: string[];
+    readonly reason: string;
+}
+export type ModelOnlyRoundDecision = {
+    readonly kind: "proceed";
+} | {
+    readonly kind: "continue-round";
+} | ModelOnlyStop;
+export declare const handleModelOnlyRound: (ports: ModelOnlyRoundPorts, input: ModelOnlyRoundInput) => ModelOnlyRoundDecision;

package/dist/agent/turn/loop/model-only-rounds.js

@@ -0,0 +1,49 @@
+import { foregroundRemaining } from "../../../store/plan.js";
+import { markTextOnlyModel } from "../../../llm/tool-protocol.js";
+const STALLED_MESSAGE = "Stopped a repeated model-only retry cycle after the model returned no executable tool call. Completed work and transcript output were preserved.";
+const NATIVE_FALLBACK_NUDGE = "Native tool calling did not produce an executable call. Continue now with exactly one complete fenced ```tool block. Do not repeat the prior narration.";
+const stallRemainingCriteria = (plan, hasUnreadResponders) => {
+    const criteria = plan
+        ? foregroundRemaining(plan).map((task) => `[${task.id}] ${task.title}`)
+        : [];
+    if (hasUnreadResponders) {
+        criteria.push("Analyze and acknowledge each delivered Responder result.");
+    }
+    if (criteria.length === 0) {
+        criteria.push("Continue the unfinished work with an executable tool call.");
+    }
+    return criteria;
+};
+const unreadResponderNudge = (unread) => `You have ${unread.length} delivered Responder result(s) that remain unread: ${unread.join(", ")}. ` +
+    "If analysis is incomplete, call only the bounded evidence tool needed now. If each result has been analyzed and is satisfactory, you MUST call job.read with its jobId or exact notificationId before giving a final response. job.read does not require an active plan; do not create or update a plan merely to acknowledge a result.";
+export const handleModelOnlyRound = (ports, input) => {
+    const unread = ports.unreadResponderIds();
+    const hasUnread = unread.length > 0;
+    const actionable = input.wantsAction || hasUnread;
+    if (actionable &&
+        ports.toolsAttached &&
+        input.consecutiveModelOnlyRounds === 2) {
+        markTextOnlyModel(ports.provider, ports.model);
+        ports.commitAssistantRetry(input.assistantVisible);
+        ports.notify("warn", "model repeatedly returned prose instead of a native tool call — switching this model to the text tool protocol");
+        ports.messages.push(ports.recoveryUserMessage(NATIVE_FALLBACK_NUDGE));
+        return { kind: "continue-round" };
+    }
+    if (actionable && input.consecutiveModelOnlyRounds >= 6) {
+        ports.commitAssistantRetry(input.assistantVisible);
+        ports.writeAssistantMessage(STALLED_MESSAGE);
+        return {
+            kind: "stop",
+            answer: STALLED_MESSAGE,
+            remainingCriteria: stallRemainingCriteria(input.plan, hasUnread),
+            reason: "The model returned six consecutive responses without executing a tool.",
+        };
+    }
+    if (hasUnread) {
+        ports.commitAssistantRetry(input.assistantVisible);
+        ports.messages.push(ports.recoveryUserMessage(unreadResponderNudge(unread)));
+        return { kind: "continue-round" };
+    }
+    return { kind: "proceed" };
+};
+//# sourceMappingURL=model-only-rounds.js.map

package/dist/agent/turn/loop/model-only-rounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-only-rounds.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/model-only-rounds.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAiClE,MAAM,eAAe,GACnB,kJAAkJ,CAAC;AAErJ,MAAM,qBAAqB,GACzB,yJAAyJ,CAAC;AAE5J,MAAM,sBAAsB,GAAG,CAC7B,IAA6B,EAC7B,mBAA4B,EAClB,EAAE;IACZ,MAAM,QAAQ,GAAG,IAAI;QACnB,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACvE,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,mBAAmB,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,MAAyB,EAAU,EAAE,CACjE,YAAY,MAAM,CAAC,MAAM,sDAAsD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;IACpG,yUAAyU,CAAC;AAE5U,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAA0B,EAC1B,KAA0B,EACF,EAAE;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC;IAElD,IACE,UAAU;QACV,KAAK,CAAC,aAAa;QACnB,KAAK,CAAC,0BAA0B,KAAK,CAAC,EACtC,CAAC;QACD,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnD,KAAK,CAAC,MAAM,CACV,MAAM,EACN,gHAAgH,CACjH,CAAC;QACF,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACtE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,UAAU,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnD,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAC7C,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,eAAe;YACvB,iBAAiB,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;YAChE,MAAM,EACJ,wEAAwE;SAC3E,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC,CAAC"}

package/dist/agent/turn/loop/native-tool-calls.d.ts

@@ -0,0 +1,12 @@
+import type { NativeToolCall, ToolCall } from "../../../types.js";
+import type { StreamDeferredToolCall } from "./stream-session.js";
+import { type ToolNameCanonicalizer } from "./canonicalize-turn-call.js";
+export interface NativeCardPorts {
+    readonly deferredToolCalls: StreamDeferredToolCall[];
+    readonly callIds: string[];
+    readonly allocateEventId: () => string;
+    readonly markPrinted: (eventId: string) => void;
+    readonly mcpRuntime?: ToolNameCanonicalizer | undefined;
+}
+export declare const syncNativeToolCallCards: (ports: NativeCardPorts, calls: readonly NativeToolCall[]) => void;
+export declare const firstNativeToolCall: (calls: readonly NativeToolCall[], mcpRuntime?: ToolNameCanonicalizer | undefined) => ToolCall | undefined;

package/dist/agent/turn/loop/native-tool-calls.js

@@ -0,0 +1,57 @@
+import { canonicalizeTurnCall, } from "./canonicalize-turn-call.js";
+const PLACEHOLDER_NAME = "…";
+const appendCards = (ports, calls) => {
+    for (let index = 0; index < calls.length; index += 1) {
+        const native = calls[index];
+        const call = canonicalizeTurnCall({ name: native.name, args: native.args }, ports.mcpRuntime);
+        const eventId = ports.allocateEventId();
+        ports.callIds[index] = eventId;
+        ports.markPrinted(eventId);
+        ports.deferredToolCalls.push({ eventId, call, shown: false });
+    }
+};
+const reconcileCards = (ports, calls) => {
+    for (let index = 0; index < calls.length; index += 1) {
+        const native = calls[index];
+        const call = canonicalizeTurnCall({ name: native.name, args: native.args }, ports.mcpRuntime);
+        const existing = ports.deferredToolCalls[index];
+        if (existing && existing.call.name !== PLACEHOLDER_NAME) {
+            ports.callIds[index] = existing.eventId;
+            existing.call = call;
+            continue;
+        }
+        const eventId = existing?.eventId ?? ports.allocateEventId();
+        ports.callIds[index] = eventId;
+        ports.markPrinted(eventId);
+        const entry = {
+            eventId,
+            call,
+            shown: existing?.shown ?? false,
+        };
+        if (existing)
+            ports.deferredToolCalls[index] = entry;
+        else
+            ports.deferredToolCalls.push(entry);
+    }
+};
+export const syncNativeToolCallCards = (ports, calls) => {
+    if (calls.length === 0)
+        return;
+    if (ports.deferredToolCalls.length === 0)
+        appendCards(ports, calls);
+    else
+        reconcileCards(ports, calls);
+};
+export const firstNativeToolCall = (calls, mcpRuntime) => {
+    const first = calls[0];
+    if (!first)
+        return undefined;
+    if (first.args?._parseError) {
+        return {
+            name: first.name || "unknown",
+            args: { __nativeParseError: true, _raw: first.args._raw },
+        };
+    }
+    return canonicalizeTurnCall({ name: first.name, args: first.args }, mcpRuntime);
+};
+//# sourceMappingURL=native-tool-calls.js.map

package/dist/agent/turn/loop/native-tool-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tool-calls.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/native-tool-calls.ts"],"names":[],"mappings":"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"}

package/dist/agent/turn/loop/native-write-salvage.d.ts

@@ -0,0 +1,18 @@
+import type { ChatMessage, CompletionResult, NativeToolCall } from "../../../types.js";
+import type { SalvagedWrite } from "../../tool-call-parser.js";
+import type { SalvagedWriteOutcome } from "./tool-call-recovery.js";
+export interface NativeSalvagePorts {
+    readonly messages: ChatMessage[];
+    readonly toolsAttached: boolean;
+    readonly notify: (level: "info" | "warn", message: string) => void;
+    readonly applySalvagedWrite: (salvaged: SalvagedWrite) => Promise<SalvagedWriteOutcome>;
+}
+export interface NativeSalvageInput {
+    readonly nativeToolCalls: readonly NativeToolCall[];
+    readonly assistantVisible: string;
+    readonly assistantThinkContent: string;
+    readonly hasThinking: boolean;
+    readonly completion: Pick<CompletionResult, "reasoningBlock" | "reasoningArtifacts">;
+}
+export declare const hasTruncatedNativeWrite: (calls: readonly NativeToolCall[]) => boolean;
+export declare const salvageTruncatedNativeWrite: (ports: NativeSalvagePorts, input: NativeSalvageInput) => Promise<boolean>;

package/dist/agent/turn/loop/native-write-salvage.js

@@ -0,0 +1,92 @@
+import { salvageTruncatedWriteFromNative } from "../../tool-call-parser.js";
+import { appendAssistantWithTools, appendToolResult, ensureUniqueToolCallIds, toolCallIdsInHistory, } from "../../tool-history.js";
+const WRITE_TOOLS = new Set([
+    "fs.write",
+    "fs.append",
+    "fs.writeMany",
+]);
+const findTruncatedWrite = (calls) => calls.find((call) => WRITE_TOOLS.has(call.name) && Boolean(call.args?._parseError));
+const rawArgumentsOf = (call) => call.rawArguments ??
+    (typeof call.args?._raw === "string" ? String(call.args._raw) : undefined);
+const appendNudgeText = (ports, salvaged, lineCount, priorBytes) => {
+    const toolName = salvaged.operation === "append" ? "fs.append" : "fs.write";
+    const head = `Your ${toolName} tool call was cut off at the token limit, but the system salvaged the partial content and wrote ${lineCount} lines (file is now ${priorBytes} bytes) to ${salvaged.path}. ` +
+        `The file ends with: ${JSON.stringify(salvaged.lastLine)}\n\n`;
+    return ports.toolsAttached
+        ? head +
+            `CONTINUE by calling fs.append with path=${JSON.stringify(salvaged.path)}, expectedPriorBytes=${priorBytes}, and content set to ONLY the next remaining chunk not already on disk. Keep each chunk under 24,000 characters and wait for its receipt before sending another. ` +
+            `Do not re-read the full file; do not re-send content already saved. Use the platform tool interface — no markdown fences.`
+        : head +
+            `CONTINUE with one fs.append chunk under 24,000 characters, then wait for its receipt before sending another:\n` +
+            '```tool\n{"name":"fs.append","args":{"path":' +
+            JSON.stringify(salvaged.path) +
+            ',"expectedPriorBytes":' +
+            priorBytes +
+            ',"content":"...ONLY the remaining content not already on disk..."}}\n```';
+};
+const pairSalvagedHistory = (ports, input, salvagedCall, salvaged, lineCount) => {
+    const historyCalls = ensureUniqueToolCallIds([...input.nativeToolCalls], toolCallIdsInHistory(ports.messages));
+    const salvagedIndex = input.nativeToolCalls.indexOf(salvagedCall);
+    const salvagedToolName = salvaged.operation === "append" ? "fs.append" : "fs.write";
+    const salvagedHistoryArgs = {
+        path: salvaged.path,
+        content: salvaged.content,
+        ...(salvaged.operation === "append"
+            ? {
+                position: "end",
+                ...(typeof salvaged.expectedPriorBytes === "number"
+                    ? { expectedPriorBytes: salvaged.expectedPriorBytes }
+                    : {}),
+            }
+            : {}),
+    };
+    const salvagedCallId = historyCalls[salvagedIndex]?.id ?? salvagedCall.id;
+    if (salvagedIndex >= 0) {
+        historyCalls[salvagedIndex] = {
+            id: salvagedCallId,
+            name: salvagedToolName,
+            args: salvagedHistoryArgs,
+            rawArguments: JSON.stringify(salvagedHistoryArgs),
+        };
+    }
+    appendAssistantWithTools(ports.messages, input.assistantVisible, historyCalls, input.completion.reasoningBlock ??
+        (input.hasThinking && input.assistantThinkContent
+            ? { text: input.assistantThinkContent }
+            : undefined), input.completion.reasoningArtifacts);
+    for (const call of historyCalls) {
+        appendToolResult(ports.messages, call.id, call.id === salvagedCallId
+            ? `Tool ${call.name} result (exit=0, ok=true):\nSalvaged partial write: ${lineCount} lines to ${salvaged.path}`
+            : `Tool ${call.name} result (exit=1, ok=false):\nCancelled — sibling write was truncated and salvaged.`, call.name, call.id === salvagedCallId);
+    }
+};
+export const hasTruncatedNativeWrite = (calls) => {
+    const writeCall = findTruncatedWrite(calls);
+    if (!writeCall)
+        return false;
+    return Boolean(salvageTruncatedWriteFromNative(writeCall.name, rawArgumentsOf(writeCall)));
+};
+export const salvageTruncatedNativeWrite = async (ports, input) => {
+    const writeCall = findTruncatedWrite(input.nativeToolCalls);
+    if (!writeCall)
+        return false;
+    const salvaged = salvageTruncatedWriteFromNative(writeCall.name, rawArgumentsOf(writeCall));
+    if (!salvaged)
+        return false;
+    try {
+        const outcome = await ports.applySalvagedWrite(salvaged);
+        if (!outcome.ok)
+            return false;
+        const lineCount = salvaged.content.split("\n").length;
+        ports.notify("info", `native tool call was truncated — salvaged ${lineCount} lines and wrote to ${salvaged.path}`);
+        pairSalvagedHistory(ports, input, writeCall, salvaged, lineCount);
+        ports.messages.push({
+            role: "user",
+            content: appendNudgeText(ports, salvaged, lineCount, outcome.bytesOnDisk),
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=native-write-salvage.js.map

package/dist/agent/turn/loop/native-write-salvage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-write-salvage.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/native-write-salvage.ts"],"names":[],"mappings":"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"}

package/dist/agent/turn/loop/output-budget.d.ts

@@ -0,0 +1,40 @@
+import type { ChatMessage, CompletionResult, ProviderId } from "../../../types.js";
+export declare const MAX_OUTPUT_BUDGET_CONTINUATIONS = 1;
+export interface OutputBudgetState {
+    truncatedBudgetRounds: number;
+    continuationBudgetFloor: number;
+    retryWithoutThinking: boolean;
+    interruptedVisible: string;
+    interruptedReasoning: string;
+    lowYieldResumptions: number;
+    visibleCommitted: boolean;
+}
+export interface OutputBudgetPorts {
+    readonly messages: ChatMessage[];
+    readonly provider: ProviderId;
+    readonly model: string;
+    readonly stepMaxTokens: number;
+    readonly maxStepCompletionTokens: number;
+    readonly notify: (level: "info" | "warn", message: string) => void;
+    readonly recoveryUserMessage: (content: string) => ChatMessage;
+    readonly pushAssistantHistory: (text: string) => void;
+    readonly commitAssistantRetry: (text: string) => void;
+}
+export interface OutputBudgetInput {
+    readonly completion: CompletionResult;
+    readonly assistantVisible: string;
+    readonly assistantThinkContent: string;
+    readonly hasThinking: boolean;
+    readonly canonicalVisible: string;
+}
+export type OutputBudgetDecision = "continue-round" | "stop-partial" | "proceed";
+export declare const routeCompletionBudget: (input: {
+    readonly provider: ProviderId;
+    readonly model: string;
+    readonly stepMaxTokens: number;
+}) => number;
+export declare const outputBudgetExhausted: (input: {
+    readonly completion: CompletionResult;
+    readonly completionBudget: number;
+}) => boolean;
+export declare const handleOutputBudgetExhaustion: (ports: OutputBudgetPorts, state: OutputBudgetState, input: OutputBudgetInput, completionBudget: number) => OutputBudgetDecision;

package/dist/agent/turn/loop/output-budget.js

@@ -0,0 +1,76 @@
+import { resolveBuiltInProfile } from "../../../llm/provider-profiles.js";
+import { outputBudgetWasExhausted } from "../../reliability-policy.js";
+import { appendInterruptedReasoning, interruptedReasoningBrief, } from "../../interrupted-reasoning.js";
+export const MAX_OUTPUT_BUDGET_CONTINUATIONS = 1;
+export const routeCompletionBudget = (input) => {
+    const limit = resolveBuiltInProfile({
+        provider: input.provider,
+        model: input.model,
+    }).limits.outputTokens;
+    return limit === undefined
+        ? input.stepMaxTokens
+        : Math.min(input.stepMaxTokens, limit);
+};
+export const outputBudgetExhausted = (input) => outputBudgetWasExhausted({
+    finishReason: input.completion.finishReason,
+    completionTokens: input.completion.usage?.completionTokens ?? 0,
+    requestedMaxTokens: input.completionBudget,
+});
+const continuationNudge = (hasVisible, retryWithoutThinking, reasoning) => [
+    hasVisible
+        ? "Your previous response was cut off by the output token limit. Continue from the exact stopping point without repeating any prior text."
+        : "Your previous response spent the output budget before producing a visible answer. Do not restart the analysis; use the preserved conclusions and answer now.",
+    retryWithoutThinking
+        ? "Optional reasoning is disabled for this continuation. Emit the next tool call or final answer directly and briefly."
+        : "Finish the reasoning briefly, then emit the next tool call or final answer directly.",
+    interruptedReasoningBrief(reasoning),
+]
+    .filter((part) => Boolean(part))
+    .join("\n\n");
+const preserveAndContinue = (ports, state, input, completionBudget) => {
+    const profile = resolveBuiltInProfile({
+        provider: ports.provider,
+        model: ports.model,
+    });
+    state.truncatedBudgetRounds += 1;
+    const desired = Math.min(ports.maxStepCompletionTokens, Math.max(completionBudget, completionBudget * 2));
+    state.continuationBudgetFloor =
+        profile.limits.outputTokens === undefined
+            ? desired
+            : Math.min(desired, profile.limits.outputTokens);
+    state.retryWithoutThinking = profile.reasoning.generation !== "mandatory";
+    if (input.hasThinking) {
+        state.interruptedReasoning = appendInterruptedReasoning(state.interruptedReasoning, input.assistantThinkContent);
+    }
+    const preservedReasoning = state.interruptedReasoning;
+    const hasVisible = Boolean(input.canonicalVisible.trim());
+    if (hasVisible) {
+        state.visibleCommitted = true;
+        ports.pushAssistantHistory(input.assistantVisible);
+        state.interruptedVisible = input.canonicalVisible;
+        state.lowYieldResumptions = 0;
+    }
+    else {
+        ports.commitAssistantRetry(input.assistantVisible);
+        state.interruptedReasoning = preservedReasoning;
+    }
+    ports.notify("warn", state.retryWithoutThinking
+        ? "response used the whole output budget — preserving it and continuing once with optional reasoning disabled"
+        : "response used the whole output budget — preserving it and continuing once at the route limit");
+    ports.messages.push(ports.recoveryUserMessage(continuationNudge(hasVisible, state.retryWithoutThinking, state.interruptedReasoning)));
+    return "continue-round";
+};
+export const handleOutputBudgetExhaustion = (ports, state, input, completionBudget) => {
+    if (state.truncatedBudgetRounds < MAX_OUTPUT_BUDGET_CONTINUATIONS) {
+        return preserveAndContinue(ports, state, input, completionBudget);
+    }
+    const hasVisible = Boolean(input.canonicalVisible.trim());
+    ports.notify("warn", hasVisible
+        ? "response reached the output limit again after its bounded continuation — returning the preserved partial answer"
+        : "response reached the output limit again after its bounded continuation — stopping without restarting the reasoning");
+    if (hasVisible)
+        return "proceed";
+    ports.commitAssistantRetry(input.assistantVisible);
+    return "stop-partial";
+};
+//# sourceMappingURL=output-budget.js.map

package/dist/agent/turn/loop/output-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-budget.js","sourceRoot":"","sources":["../../../../src/agent/turn/loop/output-budget.ts"],"names":[],"mappings":"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"}

package/dist/agent/turn/loop/plan-call-deferral.d.ts

@@ -0,0 +1,12 @@
+export interface DeferrableBoundCall {
+    readonly call: {
+        readonly name: string;
+    };
+}
+export interface PlanCallDeferral {
+    readonly runCount: number;
+    readonly deferReason: string;
+    readonly notice: string | undefined;
+    readonly systemMessage: string | undefined;
+}
+export declare const decidePlanCallDeferral: (bound: readonly DeferrableBoundCall[]) => PlanCallDeferral;