@flowdesk/opencode-plugin 0.1.14 → 0.1.15

package/README.md

@@ -6,7 +6,7 @@ registration plus opt-in description-driven natural-language tools.
 ## Install
 
 ```bash
-npm install @flowdesk/opencode-plugin@^0.1.14
+npm install @flowdesk/opencode-plugin@^0.1.15
 ```
 
 ## Configure

package/dist/agent-task-output.d.ts

@@ -10,7 +10,19 @@ export interface FlowDeskAgentTaskOutputObservationV1 {
     messageCount: number;
     outputKind: FlowDeskAgentTaskOutputKindV1;
     usableForSynthesis: boolean;
+    /**
+     * ADVISORY ONLY. The captured text superficially resembles a refusal or an
+     * error message. This is a hint for the coordinator's substance judgement; it
+     * NEVER causes the capture layer to drop or fail the result.
+     */
+    looksLikeRefusalOrError: boolean;
 }
+/**
+ * ADVISORY heuristic for the coordinator: does this text look like a refusal or
+ * a bare error message rather than a substantive answer? Capture never gates on
+ * this; the main coordinator uses it to decide whether to re-select and retry.
+ */
+export declare function flowDeskTextLooksLikeRefusalOrErrorV1(text: string | undefined): boolean;
 export declare function flowDeskAgentTaskMessageItems(value: unknown): unknown[];
 export declare function classifyFlowDeskAgentTaskOutputKindV1(text: string | undefined): FlowDeskAgentTaskOutputKindV1;
 export declare function observeFlowDeskAgentTaskOutputV1(response: unknown): FlowDeskAgentTaskOutputObservationV1;

package/dist/agent-task-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-task-output.d.ts","sourceRoot":"","sources":["../src/agent-task-output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mCAAmC,GAAG,OAAO,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,6BAA6B,GACtC,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,OAAO,CAAC;AAEX,MAAM,WAAW,oCAAoC;IACpD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,6BAA6B,CAAC;IAC1C,kBAAkB,EAAE,OAAO,CAAC;CAC5B;AAUD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAMvE;AA4BD,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,6BAA6B,CAqB7G;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,OAAO,GAAG,oCAAoC,CAoDxG"}
+{"version":3,"file":"agent-task-output.d.ts","sourceRoot":"","sources":["../src/agent-task-output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mCAAmC,GAAG,OAAO,GAAG,SAAS,CAAC;AACtE,MAAM,MAAM,6BAA6B,GACtC,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,OAAO,CAAC;AAEX,MAAM,WAAW,oCAAoC;IACpD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,6BAA6B,CAAC;IAC1C,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,uBAAuB,EAAE,OAAO,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CA6BvF;AAUD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAmBvE;AA+CD,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,6BAA6B,CAqB7G;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,OAAO,GAAG,oCAAoC,CA4FxG"}

package/dist/agent-task-output.js

@@ -1,3 +1,39 @@
+/**
+ * ADVISORY heuristic for the coordinator: does this text look like a refusal or
+ * a bare error message rather than a substantive answer? Capture never gates on
+ * this; the main coordinator uses it to decide whether to re-select and retry.
+ */
+export function flowDeskTextLooksLikeRefusalOrErrorV1(text) {
+    const normalized = text?.trim().toLowerCase() ?? "";
+    if (normalized.length === 0)
+        return false;
+    const patterns = [
+        "i cannot",
+        "i can't",
+        "i can not",
+        "i'm unable",
+        "i am unable",
+        "i'm sorry, but i can",
+        "i am sorry, but i can",
+        "i won't be able",
+        "i will not be able",
+        "as an ai",
+        "i'm not able to",
+        "i am not able to",
+        "error:",
+        "exception:",
+        "traceback (most recent call last)",
+        "rate limit",
+        "rate-limited",
+        "request failed",
+        "failed to",
+        "unable to complete",
+    ];
+    // Only treat as refusal/error when the text is short-ish and dominated by the
+    // pattern, to avoid false positives on long answers that merely mention them.
+    const head = normalized.slice(0, 240);
+    return patterns.some(pattern => head.includes(pattern));
+}
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -12,7 +48,22 @@ export function flowDeskAgentTaskMessageItems(value) {
         return [];
     if (Array.isArray(data.items))
         return data.items;
-    return Array.isArray(data.messages) ? data.messages : [];
+    if (Array.isArray(data.messages))
+        return data.messages;
+    // Gemini candidates wrapper: { candidates: [{ content: { role, parts }, finishReason }] }
+    if (Array.isArray(data.candidates)) {
+        const msgs = [];
+        for (const candidate of data.candidates) {
+            if (!isRecord(candidate))
+                continue;
+            const content = isRecord(candidate.content) ? candidate.content : candidate;
+            const finishReason = typeof candidate.finishReason === "string" ? candidate.finishReason
+                : typeof candidate.finish_reason === "string" ? candidate.finish_reason : undefined;
+            msgs.push({ ...content, _finishReason: finishReason });
+        }
+        return msgs;
+    }
+    return [];
 }
 function partText(part) {
     if (typeof part.text === "string")
@@ -25,6 +76,24 @@ function isTerminalPart(part) {
     return ((type === "step-finish" || type === "step_finish" || type === "finish") &&
         (reason === "stop" || reason === "complete" || reason === "completed"));
 }
+/** Check message-level terminal signals (OpenAI finish_reason, Gemini finishReason). */
+function isTerminalMessage(msg) {
+    // OpenAI: finish_reason at message or choice level
+    const fr = typeof msg.finish_reason === "string" ? msg.finish_reason
+        : typeof msg.finishReason === "string" ? msg.finishReason
+            : typeof msg._finishReason === "string" ? msg._finishReason : undefined;
+    if (fr !== undefined) {
+        const normalized = fr.toLowerCase();
+        if (normalized === "stop" || normalized === "end_turn" || normalized === "complete" || normalized === "completed") {
+            return { terminal: true, reason: fr };
+        }
+    }
+    // OpenAI status field
+    if (msg.status === "completed" || msg.status === "complete") {
+        return { terminal: true, reason: String(msg.status) };
+    }
+    return { terminal: false, reason: undefined };
+}
 function terminalReason(part) {
     return typeof part.reason === "string" ? part.reason : undefined;
 }
@@ -73,11 +142,43 @@ export function observeFlowDeskAgentTaskOutputV1(response) {
         const msgRec = isRecord(msg) ? msg : undefined;
         const info = isRecord(msgRec?.info) ? msgRec.info : msgRec;
         const role = info?.role;
-        const parts = Array.isArray(msgRec?.parts)
+        // Accept "assistant" and "model" (Gemini uses "model" for assistant role)
+        const isAssistantRole = role === "assistant" || role === "model";
+        // Check message-level terminal signals (OpenAI/Gemini)
+        if (msgRec !== undefined) {
+            const msgTerminal = isTerminalMessage(msgRec);
+            if (!msgTerminal.terminal && info !== undefined && info !== msgRec) {
+                const infoTerminal = isTerminalMessage(info);
+                if (infoTerminal.terminal) {
+                    terminalObserved = true;
+                    observedTerminalReason = infoTerminal.reason;
+                }
+            }
+            else if (msgTerminal.terminal) {
+                terminalObserved = true;
+                observedTerminalReason = msgTerminal.reason;
+            }
+        }
+        // Collect parts from msg.parts, msg.info.parts, or msg.content (when content is array of parts)
+        let parts = Array.isArray(msgRec?.parts)
             ? msgRec.parts
             : Array.isArray(info?.parts)
                 ? info.parts
                 : [];
+        // OpenAI multi-part content: content is array of part objects
+        if (parts.length === 0 && msgRec !== undefined && Array.isArray(msgRec.content)) {
+            parts = msgRec.content;
+        }
+        // Message-level content string (OpenAI Chat Completions: { role: "assistant", content: "..." })
+        if (parts.length === 0 && isAssistantRole && msgRec !== undefined && typeof msgRec.content === "string" && msgRec.content.trim().length > 0) {
+            latestText = msgRec.content;
+            textPartCount++;
+        }
+        // Also check info-level content string
+        if (parts.length === 0 && isAssistantRole && info !== undefined && info !== msgRec && typeof info.content === "string" && info.content.trim().length > 0) {
+            latestText = info.content;
+            textPartCount++;
+        }
         for (const rawPart of parts) {
             const part = isRecord(rawPart) ? rawPart : undefined;
             if (part === undefined)
@@ -92,9 +193,10 @@ export function observeFlowDeskAgentTaskOutputV1(response) {
                 reasoningPartCount++;
                 continue;
             }
-            if (role !== "assistant")
+            if (!isAssistantRole)
                 continue;
-            if (part.type !== undefined && part.type !== "text")
+            // Accept text, output_text (OpenAI Responses API), or undefined type
+            if (part.type !== undefined && part.type !== "text" && part.type !== "output_text")
                 continue;
             const text = partText(part);
             if (typeof text === "string" && text.trim().length > 0) {
@@ -113,7 +215,11 @@ export function observeFlowDeskAgentTaskOutputV1(response) {
         reasoningPartCount,
         messageCount: items.length,
         outputKind,
+        // Capture-side usability = "there is some text to keep". This is advisory
+        // transport metadata, NOT a substance/quality judgement (that is the
+        // coordinator's job). Only genuinely empty/tool-only captures are unusable.
         usableForSynthesis: outputKind !== "empty" && outputKind !== "tool_trace_only",
+        looksLikeRefusalOrError: flowDeskTextLooksLikeRefusalOrErrorV1(latestText),
     };
 }
 //# sourceMappingURL=agent-task-output.js.map

package/dist/agent-task-output.js.map

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

package/dist/agent-task-runner.d.ts

@@ -1,4 +1,8 @@
 import { type FlowDeskManagedDispatchBetaOpenCodeClientV1 } from "./managed-dispatch-adapter.js";
+export interface FlowDeskAgentTaskFallbackBindingV1 {
+    agentRef: string;
+    providerQualifiedModelId: string;
+}
 export interface FlowDeskAgentTaskInputV1 {
     workflowId: string;
     taskId: string;
@@ -17,12 +21,19 @@ export interface FlowDeskAgentTaskInputV1 {
      * The coordinator polls flowdesk_status_live to detect terminal state.
      */
     asyncMode?: boolean;
+    /**
+     * When provided and the primary attempt fails with no_response,
+     * automatically retry once with this fallback agent/model binding.
+     */
+    fallbackBinding?: FlowDeskAgentTaskFallbackBindingV1;
     /** Override quiet period before nudge — for testing only */
     _nudgeQuietPeriodMs?: number;
     /** Override messages poll timeout — for testing only (default 3000ms in prod) */
     _messagesTimeoutMs?: number;
-    /** Override launch timeout — for testing only (default 300000ms = 5min in prod) */
+    /** Override launch timeout — for testing only (default 30000ms in prod) */
     _launchTimeoutMs?: number;
+    /** Internal: true when this is already a fallback retry (prevents infinite retry) */
+    _isFallbackRetry?: boolean;
 }
 export type FlowDeskAgentTaskResultV1 = {
     status: "task_completed";

package/dist/agent-task-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-task-runner.d.ts","sourceRoot":"","sources":["../src/agent-task-runner.ts"],"names":[],"mappings":"AAWA,OAAO,EACN,KAAK,2CAA2C,EAGhD,MAAM,+BAA+B,CAAC;AASvC,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,2CAA2C,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,yBAAyB,GAClC;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,+DAA+D;AAC/D,eAAO,MAAM,uCAAuC,EAAG,sCAA+C,CAAC;AAEvG,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAMrH;AAqVD,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,wBAAwB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CA8bpC"}
+{"version":3,"file":"agent-task-runner.d.ts","sourceRoot":"","sources":["../src/agent-task-runner.ts"],"names":[],"mappings":"AAcA,OAAO,EACN,KAAK,2CAA2C,EAGhD,MAAM,+BAA+B,CAAC;AASvC,MAAM,WAAW,kCAAkC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,2CAA2C,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,kCAAkC,CAAC;IACrD,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,yBAAyB,GAClC;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GAC9F;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,+DAA+D;AAC/D,eAAO,MAAM,uCAAuC,EAAG,sCAA+C,CAAC;AAsBvG,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAMrH;AA+bD,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,wBAAwB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CAmjBpC"}

package/dist/agent-task-runner.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { applyFlowDeskSessionEvidenceWriteIntentsV1, prepareFlowDeskSessionEvidenceWriteIntentV1, } from "@flowdesk/core";
+import { applyFlowDeskSessionEvidenceWriteIntentsV1, prepareFlowDeskSessionEvidenceWriteIntentV1, reloadFlowDeskSessionEvidenceV1, validateTopTierReviewVerdictV1, } from "@flowdesk/core";
 import { launchFlowDeskInjectedSdkRuntimeLaneFromPlanV1, materializeFlowDeskRuntimeLaneLaunchLifecycleEvidenceV1, } from "./managed-dispatch-adapter.js";
 import { observeFlowDeskAgentTaskOutputV1 } from "./agent-task-output.js";
 import { refreshFlowDeskCompletionUiCachesV1 } from "./completion-ui-cache.js";
@@ -9,6 +9,10 @@ const AGENT_TASK_CONTEXT_MAX_PROMPT_TEXT = 32_768;
 const INVALID_PARENT_SESSION_REF = "ses-invalid-parent-session-binding";
 /** Schema version for async child session tracking evidence */
 export const AGENT_TASK_CHILD_SESSION_SCHEMA_VERSION = "flowdesk.agent_task_child_session.v1";
+/** Stable-idle finalization thresholds for non-terminal captured text. */
+const STABLE_IDLE_MIN_CYCLES = 3;
+const STABLE_IDLE_MIN_MS = 12_000;
+const STABLE_IDLE_MIN_LEN = 16;
 export function sanitizeFlowDeskTaskResultTextV1(text) {
     return {
         text: text.length > TASK_RESULT_MAX_TEXT ? text.slice(0, TASK_RESULT_MAX_TEXT) : text,
@@ -77,7 +81,7 @@ async function extractAssistantTextFromResponse(client, childSessionId, opts) {
     const messages = client.session.messages;
     if (messages === undefined)
         return undefined;
-    const quietPeriodMs = opts?.quietPeriodMs ?? 30_000;
+    const quietPeriodMs = opts?.quietPeriodMs ?? 10_000;
     const maxNudges = opts?.maxNudges ?? 2;
     const MESSAGES_TIMEOUT_MS = opts?.messagesTimeoutMs ?? 3_000; // per-call cap — handles both snapshot and long-poll
     const method = messages;
@@ -139,6 +143,12 @@ async function extractAssistantTextFromResponse(client, childSessionId, opts) {
     let lastHeartbeatMs = startMs;
     let nudgeCount = 0;
     let latestCandidate;
+    // Stable-idle tracking: capture non-terminal text once it has settled, so a
+    // good answer is not lost just because the SDK shape never surfaced an
+    // explicit terminal/finish marker.
+    let stableText;
+    let stableCount = 0;
+    let firstStableMs = 0;
     try {
         while (true) {
             const response = await callMessages();
@@ -160,10 +170,36 @@ async function extractAssistantTextFromResponse(client, childSessionId, opts) {
                 lastHeartbeatMs = nowMs;
             }
             const observed = observe(response);
-            if (observed?.latestText !== undefined && observed.latestText.trim().length > 0)
+            if (observed?.latestText !== undefined && observed.latestText.trim().length > 0) {
                 latestCandidate = observed;
+                // Track text stability for idle finalization. Active tool runs reset
+                // stability so we never finalize mid tool-call.
+                if (observed.hasRunningTool) {
+                    stableText = undefined;
+                    stableCount = 0;
+                }
+                else if (observed.latestText === stableText) {
+                    stableCount++;
+                }
+                else {
+                    stableText = observed.latestText;
+                    stableCount = 1;
+                    firstStableMs = nowMs;
+                }
+            }
             if (observed?.terminalObserved === true && observed.latestText !== undefined && observed.latestText.trim().length > 0) {
-                return { text: observed.latestText, completionStatus: "final", outputKind: observed.outputKind, usableForSynthesis: observed.usableForSynthesis };
+                return { text: observed.latestText, completionStatus: "final", outputKind: observed.outputKind, usableForSynthesis: observed.usableForSynthesis, finalizationReason: "terminal_marker", looksLikeRefusalOrError: observed.looksLikeRefusalOrError };
+            }
+            // Stable-idle: non-terminal text that has been unchanged across several
+            // poll cycles and a minimum interval is treated as captured (not a
+            // semantic success claim — completion_status stays "final" but the
+            // finalization_reason records that this was idle-based capture).
+            if (latestCandidate?.latestText !== undefined &&
+                stableText !== undefined &&
+                stableText.trim().length >= STABLE_IDLE_MIN_LEN &&
+                stableCount >= STABLE_IDLE_MIN_CYCLES &&
+                nowMs - firstStableMs >= STABLE_IDLE_MIN_MS) {
+                return { text: latestCandidate.latestText, completionStatus: "final", outputKind: latestCandidate.outputKind, usableForSynthesis: latestCandidate.usableForSynthesis, finalizationReason: "stable_idle", looksLikeRefusalOrError: latestCandidate.looksLikeRefusalOrError };
             }
             const silenceMs = nowMs - lastActivityMs;
             if (silenceMs >= quietPeriodMs) {
@@ -183,7 +219,7 @@ async function extractAssistantTextFromResponse(client, childSessionId, opts) {
                 else {
                     // Exhausted all nudges. Preserve usable candidate text as partial output.
                     if (latestCandidate?.latestText !== undefined && latestCandidate.latestText.trim().length > 0) {
-                        return { text: latestCandidate.latestText, completionStatus: "partial", outputKind: latestCandidate.outputKind, usableForSynthesis: latestCandidate.usableForSynthesis };
+                        return { text: latestCandidate.latestText, completionStatus: "partial", outputKind: latestCandidate.outputKind, usableForSynthesis: latestCandidate.usableForSynthesis, finalizationReason: "nudge_exhausted_partial", looksLikeRefusalOrError: latestCandidate.looksLikeRefusalOrError };
                     }
                     return undefined;
                 }
@@ -260,6 +296,7 @@ function writeAgentTaskProgress(input) {
 }
 function writeAgentTaskTerminalLifecycle(input) {
     const childSessionRef = input.childSessionRef === input.parentSessionRef ? undefined : input.childSessionRef;
+    const messageRef = input.messageRef ?? (input.state === "complete" ? `msg-${input.laneId}` : undefined);
     const record = {
         schema_version: "flowdesk.lane_lifecycle_record.v1",
         lane_id: input.laneId,
@@ -267,11 +304,13 @@ function writeAgentTaskTerminalLifecycle(input) {
         attempt_id: input.attemptId,
         parent_session_ref: input.parentSessionRef,
         ...(childSessionRef === undefined ? {} : { child_session_ref: childSessionRef }),
-        ...(input.messageRef === undefined ? {} : { message_ref: input.messageRef }),
+        ...(messageRef === undefined ? {} : { message_ref: messageRef }),
         agent_ref: input.agentRef,
         provider_qualified_model_id: input.providerQualifiedModelId,
         state: input.state,
+        ...(input.verdictRef === undefined ? {} : { verdict_ref: input.verdictRef }),
         ...(input.outputRef === undefined ? {} : { output_ref: input.outputRef }),
+        ...(input.state === "complete" ? { runtime_echo_ref: `runtime-echo-${input.laneId}`, telemetry_ref: `telemetry-${input.laneId}` } : {}),
         timeout_ms: input.timeoutMs ?? 0,
         orphan_max_age_ms: 0,
         retry_count: 0,
@@ -289,6 +328,72 @@ function writeAgentTaskTerminalLifecycle(input) {
         record: record,
     });
 }
+function extractJsonBlocksFromText(raw) {
+    const trimmed = raw.trim();
+    const results = [];
+    if (trimmed.startsWith("{") && trimmed.endsWith("}"))
+        return [trimmed];
+    const fencePattern = /```(?:json)?\s*\n?(\{[\s\S]*?\})\s*\n?```/g;
+    for (const match of trimmed.matchAll(fencePattern)) {
+        if (match[1])
+            results.push(match[1].trim());
+    }
+    if (results.length > 0)
+        return results;
+    let depth = 0;
+    let start = -1;
+    let lastBlock;
+    for (let i = 0; i < trimmed.length; i++) {
+        const ch = trimmed[i];
+        if (ch === "{") {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0 && start !== -1) {
+                lastBlock = trimmed.slice(start, i + 1).trim();
+                start = -1;
+            }
+        }
+    }
+    return lastBlock === undefined ? [] : [lastBlock];
+}
+function observedTopTierReviewerVerdictFromText(input) {
+    for (const block of extractJsonBlocksFromText(input.text)) {
+        try {
+            const candidate = JSON.parse(block);
+            const validation = validateTopTierReviewVerdictV1(candidate);
+            if (!validation.ok)
+                continue;
+            const verdict = candidate;
+            if (verdict.workflow_id === input.workflowId)
+                return verdict;
+        }
+        catch {
+            // Keep scanning candidates.
+        }
+    }
+    return undefined;
+}
+function persistObservedReviewerVerdict(input) {
+    const evidenceId = input.verdict.verdict_id;
+    if (!writeSessionEvidence({
+        rootDir: input.rootDir,
+        workflowId: input.workflowId,
+        evidenceId,
+        record: input.verdict,
+    }))
+        return false;
+    const reloaded = reloadFlowDeskSessionEvidenceV1({
+        rootDir: input.rootDir,
+        workflowId: input.workflowId,
+    });
+    return reloaded.ok && reloaded.blocked.length === 0 && reloaded.entries.some((entry) => entry.evidenceClass === "reviewer_verdict" &&
+        entry.evidenceId === evidenceId &&
+        entry.record.verdict_id === input.verdict.verdict_id);
+}
 export async function executeFlowDeskAgentTaskV1(input) {
     const observedAt = new Date().toISOString();
     const token = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
@@ -376,9 +481,8 @@ export async function executeFlowDeskAgentTaskV1(input) {
         observedAt,
     });
     // Launch the lane — wrap in absolute timeout so session.prompt blocking doesn't hang forever.
-    // The launch phase timeout is longer (5 min) since promptAsync may queue work before responding.
-    // 1 min default — if session.prompt blocks for more than 1 min with no activity, give up
-    const LAUNCH_TIMEOUT_MS = input._launchTimeoutMs ?? 60_000;
+    // 30s default — if session.prompt blocks for more than 30s with no activity, give up.
+    const LAUNCH_TIMEOUT_MS = input._launchTimeoutMs ?? 30_000;
     const launchTimeoutHandle = setTimeout(() => { }, LAUNCH_TIMEOUT_MS);
     const dispatchMethod = input.client.session.promptAsync !== undefined ? "promptAsync" : "prompt";
     const launchResult = await Promise.race([
@@ -488,6 +592,11 @@ export async function executeFlowDeskAgentTaskV1(input) {
             updatedAt: new Date().toISOString(),
             timeoutMs: input.timeoutMs,
         });
+        refreshFlowDeskCompletionUiCachesV1({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            observedAt,
+        });
         return {
             status: "task_failed",
             failureCategory,
@@ -508,6 +617,11 @@ export async function executeFlowDeskAgentTaskV1(input) {
         observedAt,
         progressSummaryLabel: `agent task lane launch heartbeat`,
     });
+    refreshFlowDeskCompletionUiCachesV1({
+        rootDir: input.rootDir,
+        workflowId: input.workflowId,
+        observedAt,
+    });
     // Extract child session ID
     const childSessionId = launchResult.childSessionRef?.startsWith("ses-")
         ? launchResult.childSessionRef.slice("ses-".length)
@@ -546,6 +660,11 @@ export async function executeFlowDeskAgentTaskV1(input) {
             progressSeq: 2,
             progressLabel: "agent task waiting for async child result",
         });
+        refreshFlowDeskCompletionUiCachesV1({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            observedAt: new Date().toISOString(),
+        });
         return { status: "task_launched", laneId: input.laneId, childSessionId: resolvedChildId };
     }
     let resultObservation;
@@ -555,7 +674,7 @@ export async function executeFlowDeskAgentTaskV1(input) {
         const agentName = launchResult.status === "lane_launch_started" && typeof launchResult.agent === "string"
             ? launchResult.agent : undefined;
         resultObservation = await extractAssistantTextFromResponse(input.client, childSessionId, {
-            quietPeriodMs: input._nudgeQuietPeriodMs ?? 20_000, // default 20s per policy
+            quietPeriodMs: input._nudgeQuietPeriodMs ?? 10_000, // default 10s per policy
             maxNudges: 2,
             runtimeModel,
             agentName,
@@ -628,6 +747,37 @@ export async function executeFlowDeskAgentTaskV1(input) {
             updatedAt: new Date().toISOString(),
             timeoutMs: input.timeoutMs,
         });
+        refreshFlowDeskCompletionUiCachesV1({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            observedAt: new Date().toISOString(),
+        });
+        // Auto-retry with fallback binding if configured and this is not already a retry
+        if (input.fallbackBinding !== undefined && !input._isFallbackRetry) {
+            const retryToken = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+            const retryTaskId = `${input.taskId}-retry-${retryToken.slice(0, 6)}`;
+            const retryLaneId = `${input.laneId}-retry`;
+            writeAgentTaskProgress({
+                rootDir: input.rootDir,
+                workflowId: input.workflowId,
+                laneId: retryLaneId,
+                taskId: retryTaskId,
+                agentRef: input.fallbackBinding.agentRef,
+                providerQualifiedModelId: input.fallbackBinding.providerQualifiedModelId,
+                phase: "retrying",
+                progressSeq: 0,
+                progressLabel: `auto-retry with ${input.fallbackBinding.providerQualifiedModelId} after ${failureCategory}`,
+            });
+            return executeFlowDeskAgentTaskV1({
+                ...input,
+                taskId: retryTaskId,
+                laneId: retryLaneId,
+                agentRef: input.fallbackBinding.agentRef,
+                providerQualifiedModelId: input.fallbackBinding.providerQualifiedModelId,
+                fallbackBinding: undefined,
+                _isFallbackRetry: true,
+            });
+        }
         return {
             status: "task_failed",
             failureCategory,
@@ -656,9 +806,17 @@ export async function executeFlowDeskAgentTaskV1(input) {
         completion_status: resultObservation?.completionStatus ?? "final",
         output_kind: resultObservation?.outputKind ?? "final_answer",
         usable_for_synthesis: resultObservation?.usableForSynthesis ?? true,
-        missing_contract: input.outputContract === "final_assistant_text" &&
-            (resultObservation?.completionStatus !== "final" ||
-                ["empty", "process_notes", "tool_trace_only"].includes(String(resultObservation?.outputKind ?? ""))),
+        // Capture/judgement separation: text was captured, so this is NOT a
+        // contract failure. output_kind/completion_status/looks_like_refusal_or_error
+        // are advisory inputs for the coordinator's substance judgement, never a
+        // capture-side drop. missing_contract is only ever true when an explicit
+        // contract was requested AND no text was captured (that path returns
+        // task_failed above, so here it is always false).
+        missing_contract: false,
+        ...(resultObservation?.finalizationReason === undefined
+            ? {}
+            : { finalization_reason: resultObservation.finalizationReason }),
+        looks_like_refusal_or_error: resultObservation?.looksLikeRefusalOrError ?? false,
         created_at: observedAt,
         dispatch_authority_enabled: false,
     };
@@ -669,13 +827,73 @@ export async function executeFlowDeskAgentTaskV1(input) {
         record: taskResultRecord,
     });
     if (!taskResultWritten) {
+        const taskFailedEvidenceId = `task-failed-${input.taskId}-${token}-result-write`;
+        const redactedReason = "task_result evidence persistence failed";
+        writeSessionEvidence({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            evidenceId: taskFailedEvidenceId,
+            record: {
+                schema_version: "flowdesk.task_failed.v1",
+                workflow_id: input.workflowId,
+                lane_id: input.laneId,
+                task_id: input.taskId,
+                agent_ref: input.agentRef,
+                provider_qualified_model_id: input.providerQualifiedModelId,
+                failure_category: "unknown",
+                redacted_reason: redactedReason,
+                created_at: observedAt,
+                dispatch_authority_enabled: false,
+            },
+        });
+        writeAgentTaskProgress({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            laneId: input.laneId,
+            taskId: input.taskId,
+            agentRef: input.agentRef,
+            providerQualifiedModelId: input.providerQualifiedModelId,
+            phase: "failed",
+            progressSeq: 4,
+            progressLabel: "agent task result persistence failed",
+        });
+        writeAgentTaskTerminalLifecycle({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            laneId: input.laneId,
+            attemptId,
+            parentSessionRef,
+            agentRef: input.agentRef,
+            providerQualifiedModelId: input.providerQualifiedModelId,
+            state: "invocation_failed",
+            evidenceId: `lifecycle-task-terminal-${input.laneId}-${token}-result-write`,
+            createdAt: observedAt,
+            updatedAt: new Date().toISOString(),
+            timeoutMs: input.timeoutMs,
+        });
+        refreshFlowDeskCompletionUiCachesV1({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            observedAt,
+        });
         return {
             status: "task_failed",
             failureCategory: "unknown",
-            redactedReason: "task_result evidence persistence failed",
+            redactedReason,
             laneId: input.laneId,
         };
     }
+    const observedReviewerVerdict = observedTopTierReviewerVerdictFromText({
+        text: fullResultText,
+        workflowId: input.workflowId,
+    });
+    const reviewerVerdictPersisted = observedReviewerVerdict === undefined
+        ? false
+        : persistObservedReviewerVerdict({
+            rootDir: input.rootDir,
+            workflowId: input.workflowId,
+            verdict: observedReviewerVerdict,
+        });
     writeAgentTaskProgress({
         rootDir: input.rootDir,
         workflowId: input.workflowId,
@@ -685,7 +903,9 @@ export async function executeFlowDeskAgentTaskV1(input) {
         providerQualifiedModelId: input.providerQualifiedModelId,
         phase: "finalizing",
         progressSeq: 3,
-        progressLabel: "agent task result captured",
+        progressLabel: reviewerVerdictPersisted
+            ? "agent task result captured with reviewer verdict evidence"
+            : "agent task result captured",
     });
     writeAgentTaskTerminalLifecycle({
         rootDir: input.rootDir,
@@ -697,7 +917,8 @@ export async function executeFlowDeskAgentTaskV1(input) {
         messageRef: launchResult.messageRef?.startsWith("msg-") ? launchResult.messageRef : undefined,
         agentRef: input.agentRef,
         providerQualifiedModelId: input.providerQualifiedModelId,
-        state: "incomplete",
+        state: reviewerVerdictPersisted ? "complete" : "incomplete",
+        verdictRef: reviewerVerdictPersisted ? observedReviewerVerdict?.verdict_id : undefined,
         outputRef: `output-${taskResultEvidenceId}`,
         evidenceId: `lifecycle-task-terminal-${input.laneId}-${token}`,
         createdAt: observedAt,