@useorgx/openclaw-plugin 0.4.6 → 0.4.9

package/dist/http/helpers/auto-continue-engine.d.ts

@@ -0,0 +1,298 @@
+import type { OrgXClient } from "../../api.js";
+import { type RuntimeHookPayload, type RuntimeInstanceRecord, type RuntimeSourceClient } from "../../runtime-instance-store.js";
+import { type MissionControlNode } from "./mission-control.js";
+export interface CreateAutoContinueEngineDeps {
+    client: OrgXClient;
+    filename: string;
+    safeErrorMessage: (err: unknown) => string;
+    pidAlive: (pid: number) => boolean;
+    stopProcess: (pid: number) => Promise<{
+        stopped: boolean;
+        wasRunning: boolean;
+    }>;
+    resolveOrgxAgentForDomain: (domain: string) => {
+        id: string;
+        name: string;
+    };
+    checkSpawnGuardSafe: (input: {
+        domain: string;
+        taskId?: string | null;
+        initiativeId: string | null;
+        correlationId: string;
+        runId?: string | null;
+        targetLabel?: string | null;
+    }) => Promise<unknown | null>;
+    syncParentRollupsForTask: (input: {
+        initiativeId: string | null;
+        taskId: string | null;
+        workstreamId?: string | null;
+        milestoneId?: string | null;
+        correlationId?: string | null;
+    }) => Promise<void>;
+    emitActivitySafe: (input: {
+        initiativeId: string | null;
+        runId?: string | null;
+        correlationId?: string | null;
+        phase: "intent" | "execution" | "blocked" | "review" | "handoff" | "completed";
+        level?: "info" | "warn" | "error";
+        message: string;
+        progressPct?: number;
+        nextStep?: string;
+        metadata?: Record<string, unknown>;
+    }) => Promise<void>;
+    requestDecisionSafe: (input: {
+        initiativeId: string | null;
+        correlationId?: string | null;
+        title: string;
+        summary?: string | null;
+        urgency?: "low" | "medium" | "high" | "urgent";
+        options?: string[];
+        blocking?: boolean;
+    }) => Promise<void>;
+    registerArtifactSafe: (input: {
+        initiativeId: string;
+        runId: string;
+        agentId: string;
+        agentName?: string | null;
+        workstreamId: string;
+        artifact: {
+            name: string;
+            artifact_type?: string | null;
+            description?: string | null;
+            url?: string | null;
+            milestone_id?: string | null;
+            task_ids?: string[] | null;
+        };
+    }) => Promise<{
+        ok: boolean;
+        id: string | null;
+    }>;
+    applyAgentStatusUpdatesSafe: (input: {
+        initiativeId: string;
+        runId: string;
+        correlationId: string;
+        taskUpdates: Array<{
+            task_id: string;
+            status: string;
+            reason?: string | null;
+        }>;
+        milestoneUpdates: Array<{
+            milestone_id: string;
+            status: string;
+            reason?: string | null;
+        }>;
+    }) => Promise<{
+        applied: number;
+        buffered: boolean;
+    }>;
+    upsertRuntimeInstanceFromHook: (payload: RuntimeHookPayload) => RuntimeInstanceRecord;
+    broadcastRuntimeSse: (event: string, payload: RuntimeInstanceRecord) => void;
+    clearSnapshotResponseCache: () => void;
+    resolveByokEnvOverrides: () => Record<string, string | undefined>;
+    randomUUID?: () => string;
+}
+export declare function createAutoContinueEngine(deps: CreateAutoContinueEngineDeps): {
+    autoContinueRuns: Map<string, {
+        initiativeId: string;
+        agentId: string;
+        agentName: string | null;
+        includeVerification: boolean;
+        allowedWorkstreamIds: string[] | null;
+        stopAfterSlice: boolean;
+        tokenBudget: number;
+        tokensUsed: number;
+        status: "stopped" | "running" | "stopping";
+        stopReason: ("error" | "blocked" | "completed" | "stopped" | "budget_exhausted") | null;
+        stopRequested: boolean;
+        startedAt: string;
+        stoppedAt: string | null;
+        updatedAt: string;
+        lastError: string | null;
+        lastTaskId: string | null;
+        lastRunId: string | null;
+        activeTaskId: string | null;
+        activeRunId: string | null;
+        activeTaskTokenEstimate: number | null;
+    }>;
+    autoContinueSliceRuns: Map<string, {
+        runId: string;
+        initiativeId: string;
+        initiativeTitle: string | null;
+        workstreamId: string;
+        workstreamTitle: string | null;
+        agentId: string;
+        agentName: string | null;
+        domain: string;
+        requiredSkills: string[];
+        sourceClient: RuntimeSourceClient;
+        pid: number | null;
+        status: "error" | "blocked" | "completed" | "running";
+        startedAt: string;
+        finishedAt: string | null;
+        updatedAt: string;
+        tokenEstimate: number | null;
+        outputPath: string;
+        logPath: string;
+        taskIds: string[];
+        milestoneIds: string[];
+        lastError: string | null;
+    }>;
+    localInitiativeStatusOverrides: Map<string, {
+        status: string;
+        updatedAt: string;
+    }>;
+    writeRuntimeEvent: (input: {
+        sourceClient: RuntimeSourceClient;
+        event: RuntimeHookPayload["event"];
+        runId: string;
+        initiativeId: string;
+        workstreamId: string | null;
+        taskId: string | null;
+        agentId: string | null;
+        agentName: string | null;
+        phase: string | null;
+        message?: string | null;
+        progressPct?: number | null;
+        metadata?: Record<string, unknown> | null;
+        timestamp?: string | null;
+    }) => RuntimeInstanceRecord;
+    autoContinueTickMs: number;
+    defaultAutoContinueTokenBudget: () => number;
+    setLocalInitiativeStatusOverride: (initiativeId: string, status: string) => void;
+    clearLocalInitiativeStatusOverride: (initiativeId: string) => void;
+    applyLocalInitiativeOverrides: (rows: Record<string, unknown>[]) => Record<string, unknown>[];
+    applyLocalInitiativeOverrideToGraph: <T extends {
+        initiative: {
+            id: string;
+            status: string;
+        };
+        nodes: MissionControlNode[];
+    }>(graph: T) => T;
+    updateInitiativeAutoContinueState: (input: {
+        initiativeId: string;
+        run: {
+            initiativeId: string;
+            agentId: string;
+            agentName: string | null;
+            includeVerification: boolean;
+            allowedWorkstreamIds: string[] | null;
+            stopAfterSlice: boolean;
+            tokenBudget: number;
+            tokensUsed: number;
+            status: "stopped" | "running" | "stopping";
+            stopReason: ("error" | "blocked" | "completed" | "stopped" | "budget_exhausted") | null;
+            stopRequested: boolean;
+            startedAt: string;
+            stoppedAt: string | null;
+            updatedAt: string;
+            lastError: string | null;
+            lastTaskId: string | null;
+            lastRunId: string | null;
+            activeTaskId: string | null;
+            activeRunId: string | null;
+            activeTaskTokenEstimate: number | null;
+        };
+    }) => Promise<void>;
+    stopAutoContinueRun: (input: {
+        run: {
+            initiativeId: string;
+            agentId: string;
+            agentName: string | null;
+            includeVerification: boolean;
+            allowedWorkstreamIds: string[] | null;
+            stopAfterSlice: boolean;
+            tokenBudget: number;
+            tokensUsed: number;
+            status: "stopped" | "running" | "stopping";
+            stopReason: ("error" | "blocked" | "completed" | "stopped" | "budget_exhausted") | null;
+            stopRequested: boolean;
+            startedAt: string;
+            stoppedAt: string | null;
+            updatedAt: string;
+            lastError: string | null;
+            lastTaskId: string | null;
+            lastRunId: string | null;
+            activeTaskId: string | null;
+            activeRunId: string | null;
+            activeTaskTokenEstimate: number | null;
+        };
+        reason: "error" | "blocked" | "completed" | "stopped" | "budget_exhausted";
+        error?: string | null;
+    }) => Promise<void>;
+    tickAutoContinueRun: (run: {
+        initiativeId: string;
+        agentId: string;
+        agentName: string | null;
+        includeVerification: boolean;
+        allowedWorkstreamIds: string[] | null;
+        stopAfterSlice: boolean;
+        tokenBudget: number;
+        tokensUsed: number;
+        status: "stopped" | "running" | "stopping";
+        stopReason: ("error" | "blocked" | "completed" | "stopped" | "budget_exhausted") | null;
+        stopRequested: boolean;
+        startedAt: string;
+        stoppedAt: string | null;
+        updatedAt: string;
+        lastError: string | null;
+        lastTaskId: string | null;
+        lastRunId: string | null;
+        activeTaskId: string | null;
+        activeRunId: string | null;
+        activeTaskTokenEstimate: number | null;
+    }) => Promise<void>;
+    tickAllAutoContinue: () => Promise<void>;
+    isInitiativeActiveStatus: (status: string | null | undefined) => boolean;
+    runningAutoContinueForWorkstream: (initiativeId: string, workstreamId: string) => {
+        initiativeId: string;
+        agentId: string;
+        agentName: string | null;
+        includeVerification: boolean;
+        allowedWorkstreamIds: string[] | null;
+        stopAfterSlice: boolean;
+        tokenBudget: number;
+        tokensUsed: number;
+        status: "stopped" | "running" | "stopping";
+        stopReason: ("error" | "blocked" | "completed" | "stopped" | "budget_exhausted") | null;
+        stopRequested: boolean;
+        startedAt: string;
+        stoppedAt: string | null;
+        updatedAt: string;
+        lastError: string | null;
+        lastTaskId: string | null;
+        lastRunId: string | null;
+        activeTaskId: string | null;
+        activeRunId: string | null;
+        activeTaskTokenEstimate: number | null;
+    } | null;
+    startAutoContinueRun: (input: {
+        initiativeId: string;
+        agentId: string;
+        agentName?: string | null;
+        tokenBudget: unknown;
+        includeVerification: boolean;
+        allowedWorkstreamIds: string[] | null;
+        stopAfterSlice?: boolean;
+    }) => Promise<{
+        initiativeId: string;
+        agentId: string;
+        agentName: string | null;
+        includeVerification: boolean;
+        allowedWorkstreamIds: string[] | null;
+        stopAfterSlice: boolean;
+        tokenBudget: number;
+        tokensUsed: number;
+        status: "stopped" | "running" | "stopping";
+        stopReason: ("error" | "blocked" | "completed" | "stopped" | "budget_exhausted") | null;
+        stopRequested: boolean;
+        startedAt: string;
+        stoppedAt: string | null;
+        updatedAt: string;
+        lastError: string | null;
+        lastTaskId: string | null;
+        lastRunId: string | null;
+        activeTaskId: string | null;
+        activeRunId: string | null;
+        activeTaskTokenEstimate: number | null;
+    }>;
+};