@flowdesk/opencode-plugin 0.1.13 → 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.8
+npm install @flowdesk/opencode-plugin@^0.1.15
 ```
 
 ## Configure

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

@@ -0,0 +1,29 @@
+export type FlowDeskAgentTaskCompletionStatusV1 = "final" | "partial";
+export type FlowDeskAgentTaskOutputKindV1 = "final_answer" | "partial_findings" | "process_notes" | "tool_trace_only" | "empty";
+export interface FlowDeskAgentTaskOutputObservationV1 {
+    latestText: string | undefined;
+    terminalObserved: boolean;
+    terminalReason: string | undefined;
+    hasRunningTool: boolean;
+    textPartCount: number;
+    reasoningPartCount: number;
+    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;
+//# sourceMappingURL=agent-task-output.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,225 @@
+/**
+ * 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);
+}
+function responseData(value) {
+    return isRecord(value) && "data" in value ? value.data : value;
+}
+export function flowDeskAgentTaskMessageItems(value) {
+    const data = responseData(value);
+    if (Array.isArray(data))
+        return data;
+    if (!isRecord(data))
+        return [];
+    if (Array.isArray(data.items))
+        return data.items;
+    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")
+        return part.text;
+    return typeof part.content === "string" ? part.content : undefined;
+}
+function isTerminalPart(part) {
+    const type = typeof part.type === "string" ? part.type : "";
+    const reason = typeof part.reason === "string" ? part.reason : "";
+    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;
+}
+function partHasRunningTool(part) {
+    if (part.type === "tool" || part.tool !== undefined) {
+        const state = isRecord(part.state) ? part.state : undefined;
+        return state?.status === "running" || part.status === "running";
+    }
+    return false;
+}
+export function classifyFlowDeskAgentTaskOutputKindV1(text) {
+    const normalized = text?.trim().toLowerCase() ?? "";
+    if (normalized.length === 0)
+        return "empty";
+    if (normalized.includes("{") && normalized.includes("}"))
+        return "final_answer";
+    const processFragments = [
+        "i need to",
+        "i should",
+        "i'll ",
+        "i will ",
+        "let me",
+        "thinking",
+        "planning",
+        "investigating",
+        "clarifying",
+        "considering",
+        "i’m thinking",
+    ];
+    if (processFragments.some(fragment => normalized.includes(fragment)))
+        return "process_notes";
+    const findingFragments = ["finding", "risk", "issue", "recommend", "verdict", "summary", "plan", "fix"];
+    if (findingFragments.some(fragment => normalized.includes(fragment)))
+        return "partial_findings";
+    return "final_answer";
+}
+export function observeFlowDeskAgentTaskOutputV1(response) {
+    const items = flowDeskAgentTaskMessageItems(response);
+    let latestText;
+    let terminalObserved = false;
+    let observedTerminalReason;
+    let hasRunningTool = false;
+    let textPartCount = 0;
+    let reasoningPartCount = 0;
+    for (const msg of items) {
+        const msgRec = isRecord(msg) ? msg : undefined;
+        const info = isRecord(msgRec?.info) ? msgRec.info : msgRec;
+        const role = info?.role;
+        // 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)
+                continue;
+            if (isTerminalPart(part)) {
+                terminalObserved = true;
+                observedTerminalReason = terminalReason(part);
+            }
+            if (partHasRunningTool(part))
+                hasRunningTool = true;
+            if (part.type === "reasoning") {
+                reasoningPartCount++;
+                continue;
+            }
+            if (!isAssistantRole)
+                continue;
+            // 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) {
+                latestText = text;
+                textPartCount++;
+            }
+        }
+    }
+    const outputKind = classifyFlowDeskAgentTaskOutputKindV1(latestText);
+    return {
+        latestText,
+        terminalObserved,
+        terminalReason: observedTerminalReason,
+        hasRunningTool,
+        textPartCount,
+        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

@@ -0,0 +1 @@
+{"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;
@@ -11,17 +15,47 @@ export interface FlowDeskAgentTaskInputV1 {
     client: FlowDeskManagedDispatchBetaOpenCodeClientV1;
     timeoutMs?: number;
     outputContract?: "final_assistant_text";
+    /**
+     * When true, return immediately after lane launch with { status: "task_launched" }.
+     * The watchdog takes over polling, nudging (noReply), and aborting the child session.
+     * 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 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";
     resultText: string;
     laneId: string;
     taskResultEvidenceId: string;
+} | {
+    status: "task_launched";
+    laneId: string;
+    childSessionId: string;
 } | {
     status: "task_failed";
     failureCategory: string;
     redactedReason: string;
     laneId: string;
 };
+/** Schema version for async child session tracking evidence */
+export declare const AGENT_TASK_CHILD_SESSION_SCHEMA_VERSION: "flowdesk.agent_task_child_session.v1";
+export declare function sanitizeFlowDeskTaskResultTextV1(text: string): {
+    text: string;
+    changed: boolean;
+    truncated: boolean;
+};
 export declare function executeFlowDeskAgentTaskV1(input: FlowDeskAgentTaskInputV1): Promise<FlowDeskAgentTaskResultV1>;
 //# sourceMappingURL=agent-task-runner.d.ts.map

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":"AAUA,OAAO,EACN,KAAK,2CAA2C,EAGhD,MAAM,+BAA+B,CAAC;AAMvC,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;CACxC;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,aAAa,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAuL9F,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,wBAAwB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CAyPpC"}
+{"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"}