whale-code 6.4.0

package/dist/server/handlers/workflow-steps.d.ts

@@ -0,0 +1,86 @@
+import type { SupabaseClient } from "@supabase/supabase-js";
+import { initWorkerPool, getPoolStats, shutdownPool } from "../lib/code-worker-pool.js";
+export declare function generateGuestApprovalUrl(approvalId: string, action: string, expiresAt: string): string | null;
+export declare function verifyGuestApprovalSignature(approvalId: string, action: string, expiresAt: string, sig: string): boolean;
+export declare function logWorkflowEvent(supabase: SupabaseClient, runId: string, eventType: string, payload: Record<string, unknown>, stepRunId?: string): Promise<void>;
+export interface StepClaim {
+    step_run_id: string;
+    run_id: string;
+    workflow_id: string;
+    store_id: string;
+    step_id: string;
+    step_key: string;
+    step_type: string;
+    step_config: Record<string, unknown>;
+    on_success: string | null;
+    on_failure: string | null;
+    timeout_seconds: number;
+    input_schema: Record<string, unknown> | null;
+    step_outputs: Record<string, unknown>;
+    trigger_payload: Record<string, unknown>;
+    attempt_count: number;
+    max_attempts: number;
+    max_steps_per_run: number;
+    input: unknown | null;
+    parent_step_run_id: string | null;
+    retry_delay_seconds: number;
+}
+export interface StepResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    branch?: string;
+}
+type ExecuteToolFn = (supabase: SupabaseClient, toolName: string, args: Record<string, unknown>, storeId?: string, traceId?: string) => Promise<{
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}>;
+type TokenBroadcastFn = (runId: string, stepKey: string, token: string) => void;
+type StepErrorBroadcastFn = (runId: string, data: {
+    type: "workflow_error";
+    workflow_id: string;
+    run_id: string;
+    step_name: string;
+    step_type: string;
+    error: string;
+    timestamp: string;
+}) => void;
+type RunAgentQueryFn = (supabase: SupabaseClient, agentId: string, prompt: string, storeId: string, maxTurns?: number, onToken?: (token: string) => void, traceId?: string) => Promise<{
+    success: boolean;
+    response?: string;
+    error?: string;
+}>;
+export declare function setToolExecutor(fn: ExecuteToolFn): void;
+export declare function setAgentExecutor(fn: RunAgentQueryFn): void;
+export declare function setTokenBroadcaster(fn: TokenBroadcastFn): void;
+export declare function setStepErrorBroadcaster(fn: StepErrorBroadcastFn): void;
+export { initWorkerPool, getPoolStats, shutdownPool };
+export declare function getNextCronTime(expression: string, after?: Date, timezone?: string): Date | null;
+export declare function processScheduleTriggers(supabase: SupabaseClient): Promise<number>;
+export declare function enforceWorkflowTimeouts(supabase: SupabaseClient): Promise<number>;
+export declare function cleanupOrphanedSteps(supabase: SupabaseClient): Promise<number>;
+export declare function processDlqRetries(supabase: SupabaseClient): Promise<number>;
+export declare function processEventTriggers(supabase: SupabaseClient): Promise<number>;
+export declare function processWorkflowSteps(supabase: SupabaseClient, batchSize?: number): Promise<{
+    processed: number;
+    errors: number;
+    reclaimed?: number;
+}>;
+/**
+ * Check waiting steps: sub_workflow children completed, parallel/for_each children done.
+ * Called by the persistent worker loop alongside processWorkflowSteps.
+ */
+export declare function processWaitingSteps(supabase: SupabaseClient): Promise<number>;
+export declare function executeAndAdvance(supabase: SupabaseClient, step: StepClaim, traceId?: string): Promise<void>;
+export declare function clearStepCache(): void;
+/**
+ * Execute the first pending step of a run inline, then chain subsequent steps.
+ * Depth guard prevents unbounded recursion — worker loop catches anything left.
+ */
+export declare function executeInlineChain(supabase: SupabaseClient, runId: string, depth?: number, traceId?: string): Promise<void>;
+export declare function completeWorkflowRun(supabase: SupabaseClient, runId: string, workflowId: string, storeId: string | undefined, status: "success" | "failed" | "cancelled" | "timed_out", errorMessage?: string | null, errorStepKey?: string | null, traceId?: string): Promise<void>;
+export declare function handleWebhookIngestion(supabase: SupabaseClient, slug: string, rawBody: string, headers: Record<string, string>, storeId?: string): Promise<{
+    status: number;
+    body: Record<string, unknown>;
+}>;