@tomflow/proflow-task-orchestration 0.1.0

package/dist/src/services.d.ts

@@ -0,0 +1,175 @@
+import type { NodeStatus, Task, TaskEvent, TaskGroup, TaskMessage, TaskNode, TaskResult, TaskStore } from "./model.ts";
+export interface TaskSummary extends Task {
+    canStart: boolean;
+    blockedReason: string | null;
+}
+export interface TaskView {
+    taskId: string;
+    taskGroupId: string | null;
+    sequenceNo: number | null;
+    title: string;
+    objective: string;
+    status: Task["status"];
+    version: number;
+    planVersion: number;
+    currentNodeId: string | null;
+    roleBindings: Array<{
+        agentPackageRef: string;
+        roleRef: string;
+        workerRef: string | null;
+        conversationLocator: string | null;
+    }>;
+    nodes: Array<{
+        nodeId: string;
+        title: string;
+        status: NodeStatus;
+        runNo: number;
+        requiredAgentPackageRef: string;
+        workerRef: string | null;
+        version: number;
+    }>;
+    pendingMessages: TaskMessage[];
+    readiness?: {
+        ready: boolean;
+    };
+}
+export interface NodeResult {
+    taskId: string;
+    nodeId: string;
+    status: NodeStatus;
+    runNo: number;
+    workerRef: string | null;
+    taskVersion: number;
+    nodeVersion: number;
+    startedAt: string | null;
+}
+export interface CreateTaskResult {
+    taskId: string;
+    taskGroupId: string | null;
+    status: Task["status"];
+    version: number;
+    planVersion: number;
+    currentNodeId: string | null;
+    roleBindings: Array<{
+        agentPackageRef: string;
+        roleRef: string;
+        workerRef: string | null;
+        conversationLocator: string | null;
+    }>;
+}
+export interface BindTaskWorkerResult {
+    taskId: string;
+    version: number;
+    roleBinding: {
+        agentPackageRef: string;
+        roleRef: string;
+        workerRef: string;
+        conversationLocator: string;
+    };
+}
+export interface CompleteNodeResult {
+    nodeId: string;
+    status: "SUCCEEDED";
+    runNo: number;
+    completedAt: string;
+    taskStatus: Task["status"];
+    taskVersion: number;
+    nextNodeId: string | null;
+}
+export interface DocumentResult {
+    taskId: string;
+    nodeId: string | null;
+    documentType: string;
+    path: string;
+    contentHash: string;
+    sizeBytes: number;
+    taskVersion: number;
+    updatedAt: string;
+    content?: string;
+}
+export declare function createTaskServices(options: {
+    store: TaskStore;
+    workspaceRoot: string;
+    now?: () => string;
+    createId?: (prefix: string) => string;
+    writeDocument?: (relativePath: string, content: string) => void;
+    promoteDocument?: (stagedRelativePath: string, finalRelativePath: string) => void;
+}): {
+    commands: {
+        createTaskGroup: (raw: unknown) => TaskResult<TaskGroup>;
+        startTaskGroup: (raw: unknown) => TaskResult<TaskGroup & {
+            firstEligibleTaskId: string | null;
+        }>;
+        createTask: (raw: unknown) => TaskResult<CreateTaskResult>;
+        bindTaskWorker: (raw: unknown) => TaskResult<BindTaskWorkerResult>;
+        startTask: (raw: unknown) => TaskResult<TaskView>;
+        pauseTask: (raw: unknown) => TaskResult<Task>;
+        resumeTask: (raw: unknown) => TaskResult<Task>;
+        terminateTask: (raw: unknown) => TaskResult<Task>;
+        startNode: (raw: unknown) => TaskResult<NodeResult>;
+        completeNode: (raw: unknown) => TaskResult<CompleteNodeResult>;
+        waitNode: (raw: unknown) => TaskResult<Task>;
+        failNode: (raw: unknown) => TaskResult<Task>;
+        reopenNode: (raw: unknown) => TaskResult<NodeResult & {
+            currentNodeId: string;
+        }>;
+        acknowledgeMessage: (raw: unknown) => TaskResult<TaskMessage>;
+    };
+    queries: {
+        getTaskGroup: (raw: unknown) => TaskResult<TaskGroup & {
+            currentTaskId: string | null;
+            tasks: Task[];
+        }>;
+        listTasks: (raw: unknown) => TaskResult<{
+            tasks: TaskSummary[];
+        }>;
+        getTask: (raw: unknown) => TaskResult<TaskView>;
+        getTaskDriveProjection: (raw: unknown) => TaskResult<{
+            taskId: string;
+            taskStatus: Task["status"];
+            taskVersion: number;
+            terminal: boolean;
+            currentNode: {
+                nodeId: string;
+                status: NodeStatus;
+                version: number;
+                runNo: number;
+                requiredAgentPackageRef: string;
+            } | null;
+            roleBinding: {
+                agentPackageRef: string;
+                roleRef: string;
+                workerRef: string | null;
+                conversationLocator: string | null;
+            } | null;
+            canDrive: boolean;
+            blockedReason: string | null;
+        }>;
+        getNodeContext: (raw: unknown) => TaskResult<{
+            task: Pick<Task, "taskId" | "title" | "objective" | "status" | "version">;
+            node: Pick<TaskNode, "nodeId" | "title" | "objective" | "status" | "version" | "runNo" | "requiredAgentPackageRef" | "workerRef" | "inputDocuments" | "outputDocuments">;
+            documents: Array<{
+                documentType: string;
+                path: string;
+                contentHash: string;
+                sizeBytes: number;
+            }>;
+        }>;
+        listPendingMessages: (raw: unknown) => TaskResult<{
+            messages: TaskMessage[];
+        }>;
+        listTaskEvents: (raw: unknown) => TaskResult<{
+            events: TaskEvent[];
+        }>;
+        getTaskDocument: (raw: unknown) => TaskResult<DocumentResult>;
+    };
+    documents: {
+        putTaskDocument: (raw: unknown) => TaskResult<DocumentResult>;
+        reconcileDocumentIndex: (input: {
+            taskId: string;
+            actorRef: string;
+        }) => TaskResult<{
+            reconciled: number;
+        }>;
+    };
+};