@flowdesk/opencode-plugin 0.1.11 → 0.1.13

package/dist/stall-recovery.d.ts

@@ -0,0 +1,214 @@
+import { type FlowDeskAutoRetryResultV1 } from "@flowdesk/core";
+import type { FlowDeskManagedDispatchBetaOpenCodeClientV1 } from "./managed-dispatch-adapter.js";
+export interface FlowDeskTimeoutConfig {
+    sessionReadMs?: number;
+}
+export type FlowDeskSdkSessionHealthV1 = {
+    status: "api_responsive";
+} | {
+    status: "api_timeout";
+    reason: string;
+} | {
+    status: "unknown";
+    reason: string;
+};
+export declare function checkSdkSessionApiHealthV1(client: FlowDeskManagedDispatchBetaOpenCodeClientV1, sessionId: string, timeouts?: FlowDeskTimeoutConfig): Promise<FlowDeskSdkSessionHealthV1>;
+export type FlowDeskLaneAbortHelperResultV1 = {
+    status: "aborted";
+    lane_id: string;
+    lifecycle_evidence_id: string;
+    reason: string;
+} | {
+    status: "blocked";
+    reason: string;
+    current_state?: string;
+} | {
+    status: "write_failed";
+    reason: string;
+};
+export interface FlowDeskGuardSignOffV1 {
+    schema_version: "flowdesk.guard_sign_off.v1";
+    sign_off_id: string;
+    created_at: string;
+    target_markdown_sha256: string;
+    p6_safe: boolean;
+    nonce: string;
+    expires_at?: string;
+    hmac_sha256: string;
+    dispatch_authority_enabled: false;
+}
+export interface FlowDeskAutoAbortConfigV1 {
+    autoAbortOnStall?: boolean;
+    preAbortWarningMs?: number;
+    guardSignOffPath?: string;
+    guardHmacKey?: string;
+    productionMode?: boolean;
+    autoRetryAfterAbort?: boolean;
+    maxAutoRetries?: number;
+}
+export type FlowDeskAutoAbortEnablementV1 = {
+    enabled: true;
+    sign_off_id: string;
+} | {
+    enabled: false;
+    reason: string;
+};
+export type FlowDeskGuardedAutoAbortResultV1 = {
+    status: "noop";
+    reason: string;
+} | {
+    status: "manual_recommended";
+    reason: string;
+} | {
+    status: "warning_issued";
+    warning_id: string;
+    expires_at: string;
+    cancel_command: string;
+} | {
+    status: "warning_pending";
+    warning_id: string;
+    expires_at: string;
+    cancel_command: string;
+} | {
+    status: "warning_cancelled";
+    warning_id: string;
+    cancel_id: string;
+} | {
+    status: "auto_abort_executed";
+    warning_id: string;
+    lifecycle_evidence_id: string;
+} | {
+    status: "blocked";
+    reason: string;
+};
+export declare function verifyGuardSignOffHmacV1(input: {
+    signOff: unknown;
+    markdownText: string;
+    hmacKey: string | undefined;
+    now?: Date;
+}): {
+    ok: true;
+    signOff: FlowDeskGuardSignOffV1;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function computeGuardSignOffHmacV1(input: {
+    unsignedSignOff: Omit<FlowDeskGuardSignOffV1, "hmac_sha256">;
+    hmacKey: string;
+}): string;
+export declare function isAutoAbortEnabledV1(input: {
+    config: FlowDeskAutoAbortConfigV1;
+    rootDir: string;
+    now?: Date;
+    env?: Record<string, string | undefined>;
+    loadedSignOff?: {
+        signOff: unknown;
+        markdownText: string;
+    };
+}): FlowDeskAutoAbortEnablementV1;
+export declare function validateAndAbortFlowDeskLaneEvidenceV1(input: {
+    rootDir: string;
+    workflow_id: string;
+    lane_id: string;
+    now?: () => Date;
+    requireExplicitOwnership?: boolean;
+}): FlowDeskLaneAbortHelperResultV1;
+export declare function cancelPendingAbortWarningEvidenceV1(input: {
+    rootDir: string;
+    workflow_id: string;
+    lane_id: string;
+    warning_id_ref: string;
+    now?: () => Date;
+}): FlowDeskGuardedAutoAbortResultV1;
+export declare function evaluateGuardedAutoAbortHookV1(input: {
+    rootDir: string;
+    workflow_id: string;
+    lane_id: string;
+    config: FlowDeskAutoAbortConfigV1;
+    stallConfirmed: boolean;
+    sdkSessionHealth: FlowDeskSdkSessionHealthV1;
+    now?: () => Date;
+    loadedSignOff?: {
+        signOff: unknown;
+        markdownText: string;
+    };
+    env?: Record<string, string | undefined>;
+}): FlowDeskGuardedAutoAbortResultV1;
+export type FlowDeskAgentTaskTerminalBackfillResultV1 = {
+    status: "backfill_completed";
+    workflowId: string;
+    lanesScanned: number;
+    lanesTerminalized: number;
+    terminalLifecycleEvidenceIds: string[];
+} | {
+    status: "backfill_skipped";
+    workflowId: string;
+    reason: "session_evidence_reload_failed";
+};
+/**
+ * Safe local cleanup/backfill for legacy `flowdesk_agent_task_run` lanes.
+ *
+ * Older agent-task results/failures could persist `task_result.v1` or
+ * `task_failed.v1` while the latest `lane_lifecycle` remained
+ * `created`/`running`, which made status cards keep reporting stale active
+ * lanes. This helper only writes terminal lifecycle evidence when existing
+ * durable evidence already proves the agent-task ended.
+ * It never launches, aborts, retries, enables dispatch authority, or rewrites
+ * existing evidence.
+ */
+export declare function backfillTerminalAgentTaskFailedLanesV1(input: {
+    rootDir: string;
+    workflowId: string;
+    now?: Date;
+}): FlowDeskAgentTaskTerminalBackfillResultV1;
+/**
+ * On startup/reload: any `pending_retry_plan` in `launched` state with no matching
+ * `retry_executed` or `retry_failed` within 10 minutes of `created_at` is reconciled
+ * as `retry_failed(indeterminate_launch)`.
+ */
+export declare function reconcileStalePendingRetryPlansV1(input: {
+    rootDir: string;
+    workflowId: string;
+    now?: Date;
+    staleThresholdMs?: number;
+}): void;
+/**
+ * Evaluate guarded auto-retry hook following the execution order from the design doc exactly.
+ * Called after `evaluateGuardedAutoAbortHookV1` returns `auto_abort_executed`.
+ */
+export declare function evaluateGuardedAutoRetryHookV1(input: {
+    config: FlowDeskAutoAbortConfigV1;
+    rootDir: string;
+    workflowId: string;
+    laneId: string;
+    abortEvidenceId: string;
+    client: FlowDeskManagedDispatchBetaOpenCodeClientV1 | undefined;
+    parentSessionId: string;
+    timeoutMs?: number;
+    abortSignal?: AbortSignal;
+    now?: Date;
+}): Promise<FlowDeskAutoRetryResultV1>;
+export interface FlowDeskWatchdogConfigV1 {
+    enabled?: boolean;
+    intervalMs?: number;
+    stallThresholdMs?: number;
+    mcpTriggerEnabled?: boolean;
+}
+export interface FlowDeskWatchdogCycleResultV1 {
+    cycleAt: string;
+    guardValid: boolean;
+    lanesChecked: number;
+    lanesAborted: number;
+    lanesRetried: number;
+    lanesFailed: number;
+    skippedReason?: string;
+}
+export declare function runFlowDeskWatchdogCycleV1(input: {
+    config: FlowDeskAutoAbortConfigV1;
+    rootDir: string;
+    client: FlowDeskManagedDispatchBetaOpenCodeClientV1 | undefined;
+    parentSessionId: string;
+    now?: Date;
+}): Promise<FlowDeskWatchdogCycleResultV1>;
+//# sourceMappingURL=stall-recovery.d.ts.map

package/dist/stall-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-recovery.d.ts","sourceRoot":"","sources":["../src/stall-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAeN,KAAK,yBAAyB,EAE9B,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EACX,2CAA2C,EAC3C,MAAM,+BAA+B,CAAC;AAWvC,MAAM,WAAW,qBAAqB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,0BAA0B,GACnC;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAsB,0BAA0B,CAC/C,MAAM,EAAE,2CAA2C,EACnD,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,qBAA0B,GAClC,OAAO,CAAC,0BAA0B,CAAC,CAoBrC;AAwBD,MAAM,MAAM,+BAA+B,GACxC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrF;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACtC,cAAc,EAAE,4BAA4B,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B,EAAE,KAAK,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,6BAA6B,GACtC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,gCAAgC,GACzC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAiEzC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAC;CACX,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsBhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAChD,eAAe,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAIT;AAWD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D,GAAG,6BAA6B,CAgBhC;AA6CD,wBAAgB,sCAAsC,CAAC,KAAK,EAAE;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACnC,GAAG,+BAA+B,CAoElC;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CACjB,GAAG,gCAAgC,CAsCnC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,yBAAyB,CAAC;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC,GAAG,gCAAgC,CAmHnC;AAkCD,MAAM,MAAM,yCAAyC,GAClD;IACD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4BAA4B,EAAE,MAAM,EAAE,CAAC;CACvC,GACC;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gCAAgC,CAAA;CAAE,CAAC;AA6ChG;;;;;;;;;;GAUG;AACH,wBAAgB,sCAAsC,CAAC,KAAK,EAAE;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;CACX,GAAG,yCAAyC,CA2F5C;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,IAAI,CA4CP;AAqFD;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC3D,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,2CAA2C,GAAG,SAAS,CAAC;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;CACX,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAoarC;AAMD,MAAM,WAAW,wBAAwB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AA6BD,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACvD,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,2CAA2C,GAAG,SAAS,CAAC;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,IAAI,CAAC;CACX,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAmJzC"}