@cecwxf/wtt 0.1.10 → 0.1.12

package/dist/runtime/task-executor.d.ts

@@ -0,0 +1,169 @@
+import { type ProgressHeartbeatPayload } from "./progress-ticker.js";
+import { type RuntimeTransitionResult } from "./status-transition.js";
+import { type TaskRunExecutorIntent, type TaskRunExecutorPersistenceOptions, type TaskRunIntentMetadata, type TaskRunRecoveryMetadata } from "./task-executor-persistence.js";
+type HttpMethod = "GET" | "POST" | "PATCH";
+type RecoverySource = "queued" | "running";
+type InflightState = "queued" | "running";
+export interface TaskRuntimeMetadata extends TaskRunIntentMetadata {
+}
+export interface RuntimeApiRequest {
+    method: HttpMethod;
+    path: string;
+    body?: unknown;
+}
+export interface TaskRunDetailPayload {
+    id: string;
+    title: string;
+    description: string;
+    topicId: string;
+    taskType: string;
+    execMode: string;
+    status: string;
+}
+export interface TaskRunInferenceRequest {
+    taskId: string;
+    prompt: string;
+    task: TaskRunDetailPayload;
+    accountId: string;
+}
+export interface TaskRunInferenceUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    totalTokens?: number;
+    source?: string;
+    provider?: string;
+    model?: string;
+}
+export interface TaskRunInferenceResult {
+    outputText: string;
+    provider?: string;
+    usage?: TaskRunInferenceUsage;
+    raw?: unknown;
+}
+export interface TaskRunSessionRuntimeMetrics {
+    source?: string;
+    queueDepth?: number;
+    queueMode?: string;
+    sessionKey?: string;
+    inflight?: boolean;
+}
+export interface TaskRunExecutorRequest extends TaskRunExecutorIntent {
+    now?: () => Date;
+    apiRequest: (request: RuntimeApiRequest) => Promise<unknown>;
+    publishHeartbeat?: (payload: ProgressHeartbeatPayload) => Promise<void> | void;
+    fetchTaskDetail?: () => Promise<unknown>;
+    invokeTaskInference?: (request: TaskRunInferenceRequest) => Promise<TaskRunInferenceResult>;
+    getSessionRuntimeMetrics?: () => Promise<TaskRunSessionRuntimeMetrics | undefined> | TaskRunSessionRuntimeMetrics | undefined;
+}
+export interface TaskRunSummaryPayload {
+    kind: "task_run_summary";
+    taskId: string;
+    at: string;
+    status: string;
+    action: string;
+    transitionApplied: "run_endpoint" | "patch_status" | "none";
+    notes: string[];
+    nextSteps: string[];
+    outputPreview?: string;
+}
+export interface TaskRunPersistenceAck {
+    enabled: boolean;
+    filePath?: string;
+    recoveredFrom?: RecoverySource;
+}
+export interface TaskRunIdempotencyDecision {
+    decision: "enqueued" | "deduplicated";
+    idempotencyKey: string;
+    triggerContextKey: string;
+    reason: string;
+    duplicateState?: InflightState;
+    duplicateTaskId?: string;
+    duplicateEnqueuedAt?: string;
+}
+export interface TaskRunExecutionResult {
+    deduplicated: false;
+    taskId: string;
+    accountId: string;
+    queue: {
+        enqueuedAt: string;
+        dequeuedAt: string;
+        finishedAt: string;
+        pendingAfterDequeue: number;
+    };
+    transition: RuntimeTransitionResult;
+    transitionApplied: "run_endpoint" | "patch_status" | "none";
+    endpointFallbackUsed: boolean;
+    fallbackMessage?: string;
+    finalStatus: string;
+    task: TaskRunDetailPayload;
+    inference: {
+        attempted: boolean;
+        succeeded: boolean;
+        provider: string;
+        outputText: string;
+        prompt: string;
+        usage?: TaskRunInferenceUsage;
+        error?: string;
+    };
+    heartbeatPayloads: ProgressHeartbeatPayload[];
+    heartbeatPublished: number;
+    heartbeatPublishErrors: string[];
+    summary: TaskRunSummaryPayload;
+    persistence: TaskRunPersistenceAck;
+    idempotency: TaskRunIdempotencyDecision;
+    recovery?: TaskRunRecoveryMetadata;
+}
+export interface TaskRunDedupResult {
+    deduplicated: true;
+    taskId: string;
+    accountId: string;
+    queueLength: number;
+    runningTaskId: string | null;
+    persistence: TaskRunPersistenceAck;
+    idempotency: TaskRunIdempotencyDecision;
+}
+export type TaskRunEnqueueResult = TaskRunExecutionResult | TaskRunDedupResult;
+export interface TaskRunExecutorSnapshot {
+    queueLength: number;
+    runningTaskId: string | null;
+    processing: boolean;
+    stopping: boolean;
+    lastError: string | null;
+    persistenceEnabled: boolean;
+    persistenceFilePath?: string;
+    enqueueAccepted: number;
+    dedupHits: number;
+    recovery: {
+        loadedQueued: number;
+        loadedRunning: number;
+        requeued: number;
+        skippedTerminalOrReview: number;
+        skippedByRetryCap: number;
+        retryAttempts: number;
+    };
+    drainLockContention: number;
+}
+export interface TaskRunExecutorLoop {
+    enqueueRun: (request: TaskRunExecutorRequest) => Promise<TaskRunEnqueueResult>;
+    getQueueDepth: () => number;
+    isProcessing: () => boolean;
+    getSnapshot: () => TaskRunExecutorSnapshot;
+    getStatus: () => TaskRunExecutorSnapshot;
+    stopGracefully: () => Promise<void>;
+}
+export interface TaskRunExecutorLoopOptions {
+    persistence?: TaskRunExecutorPersistenceOptions;
+    createRecoveredApiRequest?: (intent: TaskRunExecutorIntent, source: RecoverySource) => TaskRunExecutorRequest["apiRequest"] | undefined;
+    onRecoveredExecutionResult?: (result: TaskRunEnqueueResult) => void;
+    onRecoveredExecutionError?: (error: unknown, intent: TaskRunExecutorIntent) => void;
+    maxRecoveryRetryCount?: number;
+    reviewPatchRetryDelaysMs?: number[];
+    compensatingReviewDelayMs?: number;
+    compensatingReviewRetryDelaysMs?: number[];
+}
+export declare function createTaskRunExecutorLoop(options?: TaskRunExecutorLoopOptions): TaskRunExecutorLoop;
+export declare function getSharedTaskRunExecutor(): TaskRunExecutorLoop;
+export {};
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/runtime/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/runtime/task-executor.ts"],"names":[],"mappings":"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"}