@bratsos/workflow-engine 0.5.1 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -12
- package/dist/{chunk-RZY5YRGL.js → chunk-2MWO6UVR.js} +2 -2
- package/dist/chunk-2MWO6UVR.js.map +1 -0
- package/dist/{chunk-PHLNTR5Z.js → chunk-DIADEUGZ.js} +21 -3
- package/dist/chunk-DIADEUGZ.js.map +1 -0
- package/dist/{chunk-ZYMT2PAO.js → chunk-HKGZ2WHJ.js} +2 -30
- package/dist/chunk-HKGZ2WHJ.js.map +1 -0
- package/dist/{chunk-WQPZ6KON.js → chunk-HOGDFLCG.js} +280 -93
- package/dist/chunk-HOGDFLCG.js.map +1 -0
- package/dist/{client-oLD5ilXp.d.ts → client-llB6XpHS.d.ts} +10 -81
- package/dist/client.d.ts +4 -3
- package/dist/client.js +1 -1
- package/dist/events-D_P24UaY.d.ts +105 -0
- package/dist/{index-CVkkGnxx.d.ts → index-sGgV8JNu.d.ts} +5 -1
- package/dist/index.d.ts +184 -32
- package/dist/index.js +41 -9
- package/dist/index.js.map +1 -1
- package/dist/{interface-TsryH4d7.d.ts → interface-DCdddCe0.d.ts} +7 -2
- package/dist/kernel/index.d.ts +6 -5
- package/dist/kernel/index.js +2 -1
- package/dist/kernel/testing/index.d.ts +3 -2
- package/dist/persistence/index.d.ts +2 -2
- package/dist/persistence/index.js +2 -2
- package/dist/persistence/prisma/index.d.ts +2 -2
- package/dist/persistence/prisma/index.js +2 -2
- package/dist/{plugins-C94AT8Wr.d.ts → plugins-Oyo_iu0l.d.ts} +9 -6
- package/dist/{ports-855bktyD.d.ts → ports-ChGnJcn2.d.ts} +5 -106
- package/dist/{stage-BPw7m9Wx.d.ts → stage-_7BKqqUG.d.ts} +2 -2
- package/dist/testing/index.d.ts +2 -1
- package/dist/testing/index.js +23 -5
- package/dist/testing/index.js.map +1 -1
- package/package.json +1 -1
- package/skills/workflow-engine/SKILL.md +30 -11
- package/skills/workflow-engine/references/02-workflow-builder.md +2 -0
- package/skills/workflow-engine/references/03-runtime-setup.md +1 -1
- package/skills/workflow-engine/references/08-common-patterns.md +2 -1
- package/skills/workflow-engine/references/09-troubleshooting.md +4 -3
- package/dist/chunk-PHLNTR5Z.js.map +0 -1
- package/dist/chunk-RZY5YRGL.js.map +0 -1
- package/dist/chunk-WQPZ6KON.js.map +0 -1
- package/dist/chunk-ZYMT2PAO.js.map +0 -1
|
@@ -4,7 +4,7 @@ description: Guide for @bratsos/workflow-engine - a type-safe workflow engine wi
|
|
|
4
4
|
license: MIT
|
|
5
5
|
metadata:
|
|
6
6
|
author: bratsos
|
|
7
|
-
version: "0.
|
|
7
|
+
version: "0.3.0"
|
|
8
8
|
repository: https://github.com/bratsos/workflow-engine
|
|
9
9
|
---
|
|
10
10
|
|
|
@@ -109,6 +109,10 @@ await kernel.dispatch({
|
|
|
109
109
|
| `createServerlessHost` | Function | `@bratsos/workflow-engine-host-serverless` | Create serverless host |
|
|
110
110
|
| `createAIHelper` | Function | `@bratsos/workflow-engine` | AI operations (text, object, embed, batch) |
|
|
111
111
|
| `registerEmbeddingProvider` | Function | `@bratsos/workflow-engine` | Register custom embedding providers (Voyage, Cohere, etc.) |
|
|
112
|
+
| `createStageIds` | Function | `@bratsos/workflow-engine` | Create stage ID constants from a workflow |
|
|
113
|
+
| `defineStageIds` | Function | `@bratsos/workflow-engine` | Define stage ID constants from a tuple |
|
|
114
|
+
| `isValidStageId` | Function | `@bratsos/workflow-engine` | Runtime stage ID validation |
|
|
115
|
+
| `assertValidStageId` | Function | `@bratsos/workflow-engine` | Assert stage ID validity (throws) |
|
|
112
116
|
| `definePlugin` | Function | `@bratsos/workflow-engine/kernel` | Define kernel plugins |
|
|
113
117
|
| `createPluginRunner` | Function | `@bratsos/workflow-engine/kernel` | Create plugin event processor |
|
|
114
118
|
|
|
@@ -121,10 +125,10 @@ All operations go through `kernel.dispatch(command)`:
|
|
|
121
125
|
| `run.create` | Create a new workflow run |
|
|
122
126
|
| `run.claimPending` | Claim pending runs, enqueue first-stage jobs |
|
|
123
127
|
| `run.transition` | Advance to next stage group or complete |
|
|
124
|
-
| `run.cancel` | Cancel a running workflow |
|
|
125
|
-
| `run.rerunFrom` | Rerun from a specific stage |
|
|
128
|
+
| `run.cancel` | Cancel a running workflow (authoritative: cascades to stages + jobs) |
|
|
129
|
+
| `run.rerunFrom` | Rerun from a specific stage (cleans up blob artifacts by prefix) |
|
|
126
130
|
| `job.execute` | Execute a single stage (uses multi-phase transactions; see 08-common-patterns.md) |
|
|
127
|
-
| `stage.pollSuspended` | Poll suspended stages for readiness (
|
|
131
|
+
| `stage.pollSuspended` | Poll suspended stages for readiness (skips cancelled runs; per-stage transactions) |
|
|
128
132
|
| `lease.reapStale` | Release stale job leases |
|
|
129
133
|
| `run.reapStuck` | Detect and fail RUNNING runs with no recent activity |
|
|
130
134
|
| `outbox.flush` | Publish pending outbox events |
|
|
@@ -179,7 +183,12 @@ const batchStage = defineAsyncBatchStage({
|
|
|
179
183
|
const batchId = await submitBatchJob(ctx.input);
|
|
180
184
|
return {
|
|
181
185
|
suspended: true,
|
|
182
|
-
state: {
|
|
186
|
+
state: {
|
|
187
|
+
batchId,
|
|
188
|
+
submittedAt: new Date().toISOString(),
|
|
189
|
+
pollInterval: 60000,
|
|
190
|
+
maxWaitTime: 3600000,
|
|
191
|
+
},
|
|
183
192
|
pollConfig: { pollInterval: 60000, maxWaitTime: 3600000, nextPollAt: new Date(Date.now() + 60000) },
|
|
184
193
|
};
|
|
185
194
|
},
|
|
@@ -195,23 +204,31 @@ const batchStage = defineAsyncBatchStage({
|
|
|
195
204
|
|
|
196
205
|
## WorkflowBuilder
|
|
197
206
|
|
|
207
|
+
Workflows are linear pipelines of **execution groups**. `.pipe()` creates single-stage groups; `.parallel()` creates multi-stage groups. Parallel group outputs are keyed by stage ID in the workflow context.
|
|
208
|
+
|
|
198
209
|
```typescript
|
|
199
210
|
const workflow = new WorkflowBuilder(
|
|
200
211
|
"workflow-id", "Workflow Name", "Description",
|
|
201
212
|
InputSchema, OutputSchema
|
|
202
213
|
)
|
|
203
|
-
.pipe(stage1)
|
|
204
|
-
.pipe(stage2)
|
|
205
|
-
.parallel([stage3a, stage3b])
|
|
206
|
-
.pipe(stage4)
|
|
214
|
+
.pipe(stage1) // Group 0
|
|
215
|
+
.pipe(stage2) // Group 1
|
|
216
|
+
.parallel([stage3a, stage3b]) // Group 2 (concurrent, output: { "stage3a-id": ..., "stage3b-id": ... })
|
|
217
|
+
.pipe(stage4) // Group 3
|
|
207
218
|
.build();
|
|
208
219
|
|
|
220
|
+
// In stage4, access parallel outputs by stage ID:
|
|
221
|
+
ctx.require("stage3a-id") // output of stage3a
|
|
222
|
+
ctx.require("stage3b-id") // output of stage3b
|
|
223
|
+
|
|
209
224
|
workflow.getStageIds();
|
|
210
225
|
workflow.getExecutionPlan();
|
|
211
226
|
workflow.getDefaultConfig();
|
|
212
227
|
workflow.validateConfig(config);
|
|
213
228
|
```
|
|
214
229
|
|
|
230
|
+
When a workflow completes, the final execution group's output is persisted in `WorkflowRun.output` and included in the `workflow:completed` event.
|
|
231
|
+
|
|
215
232
|
## Kernel Setup
|
|
216
233
|
|
|
217
234
|
```typescript
|
|
@@ -438,5 +455,7 @@ await kernel.dispatch({ type: "run.transition", workflowRunId: job.workflowRunId
|
|
|
438
455
|
4. **Context Access**: Use `ctx.require()` and `ctx.optional()` for type-safe stage output access
|
|
439
456
|
5. **Transactional Outbox**: Events written to outbox, published via `outbox.flush` command. `job.execute` and `stage.pollSuspended` use multi-phase transactions to avoid holding connections during external I/O
|
|
440
457
|
6. **Idempotency**: `run.create` and `job.execute` replay cached results by key; concurrent same-key dispatch throws `IdempotencyInProgressError`
|
|
441
|
-
7. **
|
|
442
|
-
8. **
|
|
458
|
+
7. **Authoritative Cancellation**: `run.cancel` cascades to stages + jobs. Ghost jobs (running against non-RUNNING runs) are detected via `ghost: true` flag and not retried
|
|
459
|
+
8. **Self-Healing**: Stage creation is idempotent (upsert), orchestration steps are isolated, stuck runs are automatically reaped
|
|
460
|
+
9. **Cost Tracking**: All AI calls automatically track tokens and costs
|
|
461
|
+
10. **BlobStore-Only Artifacts**: All artifact storage goes through the BlobStore port. `run.rerunFrom` cleans up artifacts by key prefix
|
|
@@ -55,6 +55,8 @@ Parallel stages:
|
|
|
55
55
|
- Run in the same execution group
|
|
56
56
|
- Receive the same input (output from previous group)
|
|
57
57
|
- Must not depend on each other
|
|
58
|
+
- Their outputs are merged into the workflow context keyed by stage ID (e.g., `{ "classify": classifyOutput, "summarize": summarizeOutput }`)
|
|
59
|
+
- Subsequent stages access each parallel stage's output via `ctx.require("classify")`, `ctx.require("summarize")`, etc.
|
|
58
60
|
|
|
59
61
|
### build()
|
|
60
62
|
|
|
@@ -58,7 +58,7 @@ const kernel = createKernel({
|
|
|
58
58
|
|------|-----------|---------|
|
|
59
59
|
| `persistence` | `Persistence` | CRUD for runs, stages, logs, outbox events, idempotency keys |
|
|
60
60
|
| `blobStore` | `BlobStore` | `put(key, data)`, `get(key)`, `has(key)`, `delete(key)`, `list(prefix)` |
|
|
61
|
-
| `jobTransport` | `JobTransport` | `enqueue`, `enqueueParallel`, `dequeue`, `complete`, `suspend`, `fail` |
|
|
61
|
+
| `jobTransport` | `JobTransport` | `enqueue`, `enqueueParallel`, `dequeue`, `complete`, `suspend`, `fail`, `cancelByRun` |
|
|
62
62
|
| `eventSink` | `EventSink` | `emit(event)` - async event publishing |
|
|
63
63
|
| `scheduler` | `Scheduler` | `schedule(type, payload, runAt)`, `cancel(type, correlationId)` |
|
|
64
64
|
| `clock` | `Clock` | `now()` - returns `Date` |
|
|
@@ -96,6 +96,7 @@ const { deletedStages } = await kernel.dispatch({
|
|
|
96
96
|
|
|
97
97
|
// Stages from "summarize" onward are deleted and re-queued
|
|
98
98
|
// Earlier stages (e.g., "extract") keep their outputs
|
|
99
|
+
// Blob artifacts for deleted stages are cleaned up by key prefix
|
|
99
100
|
```
|
|
100
101
|
|
|
101
102
|
## Plugin System
|
|
@@ -213,7 +214,7 @@ If claiming a specific run fails (e.g., workflow not found, database error), tha
|
|
|
213
214
|
|
|
214
215
|
### Ghost Job Guard
|
|
215
216
|
|
|
216
|
-
`job.execute` verifies the run is in `RUNNING` status before executing. Jobs for `
|
|
217
|
+
`job.execute` verifies the run is in `RUNNING` status both before and after executing the stage. Jobs for non-`RUNNING` runs are discarded with `outcome: "failed"` and a `ghost: true` flag in the result. Hosts check this flag to disable retries (`canRetry = false`). This prevents ghost jobs from rolled-back transactions or concurrent cancellations from resurrecting invalid state.
|
|
217
218
|
|
|
218
219
|
### Orchestration Tick Isolation
|
|
219
220
|
|
|
@@ -62,9 +62,10 @@ await kernel.dispatch({ type: "run.transition", workflowRunId: runId });
|
|
|
62
62
|
|
|
63
63
|
**What it was:** If the kernel transaction rolled back after `jobTransport.enqueueParallel` committed (separate transaction), ghost jobs would exist in the queue pointing to runs/stages that were rolled back.
|
|
64
64
|
|
|
65
|
-
**How it's fixed (
|
|
66
|
-
1. **
|
|
67
|
-
2. **
|
|
65
|
+
**How it's fixed (three layers):**
|
|
66
|
+
1. **Authoritative cancellation:** `run.cancel` cancels all queued/suspended jobs via `jobTransport.cancelByRun()`, preventing most ghost jobs before dequeue.
|
|
67
|
+
2. **Kernel guard:** `job.execute` checks `workflowRun.status === "RUNNING"` both before AND after stage execution. Ghost jobs are discarded with `outcome: "failed"` and a typed `ghost: true` flag in the result.
|
|
68
|
+
3. **Host no-retry:** Both Node and Serverless hosts detect ghost jobs via the `ghost: true` flag (not string matching) and set `canRetry = false`, preventing infinite retry loops.
|
|
68
69
|
|
|
69
70
|
## One Bad Run Blocks Everything
|
|
70
71
|
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/persistence/prisma/ai-logger.ts","../src/persistence/prisma/enum-compat.ts","../src/persistence/prisma/job-queue.ts","../src/persistence/prisma/persistence.ts"],"names":["logger"],"mappings":"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","file":"chunk-PHLNTR5Z.js","sourcesContent":["/**\n * PrismaAICallLogger - Prisma implementation of AICallLogger\n *\n * Handles AI call logging to the database. Uses fire-and-forget pattern\n * for non-blocking logging during AI operations.\n */\n\nimport { createLogger } from \"../../utils/logger\";\nimport type {\n AICallLogger,\n AIHelperStats,\n CreateAICallInput,\n} from \"../interface\";\n\nconst logger = createLogger(\"AICallLogger\");\n\n// Type for prisma client - using any for flexibility\ntype PrismaClient = any;\n\nexport class PrismaAICallLogger implements AICallLogger {\n constructor(private readonly prisma: PrismaClient) {}\n\n /**\n * Log a single AI call (fire and forget)\n * Does not await - logs asynchronously to avoid blocking AI operations\n */\n logCall(call: CreateAICallInput): void {\n this.prisma.aICall\n .create({\n data: {\n topic: call.topic,\n callType: call.callType,\n modelKey: call.modelKey,\n modelId: call.modelId,\n prompt: call.prompt,\n response: call.response,\n inputTokens: call.inputTokens,\n outputTokens: call.outputTokens,\n cost: call.cost,\n metadata: call.metadata as unknown,\n },\n })\n .catch((error: unknown) =>\n logger.error(\"Failed to persist AI call:\", error),\n );\n }\n\n /**\n * Log batch results (for recording batch API results)\n */\n async logBatchResults(\n batchId: string,\n results: CreateAICallInput[],\n ): Promise<void> {\n await this.prisma.aICall.createMany({\n data: results.map((call) => ({\n topic: call.topic,\n callType: call.callType,\n modelKey: call.modelKey,\n modelId: call.modelId,\n prompt: call.prompt,\n response: call.response,\n inputTokens: call.inputTokens,\n outputTokens: call.outputTokens,\n cost: call.cost,\n metadata: {\n ...(call.metadata as object),\n batchId,\n } as unknown,\n })),\n });\n }\n\n /**\n * Get aggregated stats for a topic prefix\n */\n async getStats(topicPrefix: string): Promise<AIHelperStats> {\n const calls = await this.prisma.aICall.findMany({\n where: {\n topic: { startsWith: topicPrefix },\n },\n select: {\n modelKey: true,\n inputTokens: true,\n outputTokens: true,\n cost: true,\n },\n });\n\n const perModel: AIHelperStats[\"perModel\"] = {};\n\n for (const call of calls) {\n if (!perModel[call.modelKey]) {\n perModel[call.modelKey] = {\n calls: 0,\n inputTokens: 0,\n outputTokens: 0,\n cost: 0,\n };\n }\n perModel[call.modelKey].calls++;\n perModel[call.modelKey].inputTokens += call.inputTokens;\n perModel[call.modelKey].outputTokens += call.outputTokens;\n perModel[call.modelKey].cost += call.cost;\n }\n\n return {\n totalCalls: calls.length,\n totalInputTokens: calls.reduce(\n (sum: number, c: { inputTokens: number }) => sum + c.inputTokens,\n 0,\n ),\n totalOutputTokens: calls.reduce(\n (sum: number, c: { outputTokens: number }) => sum + c.outputTokens,\n 0,\n ),\n totalCost: calls.reduce(\n (sum: number, c: { cost: number }) => sum + c.cost,\n 0,\n ),\n perModel,\n };\n }\n\n /**\n * Check if batch results are already recorded\n */\n async isRecorded(batchId: string): Promise<boolean> {\n const existing = await this.prisma.aICall.findFirst({\n where: {\n metadata: {\n path: [\"batchId\"],\n equals: batchId,\n },\n },\n select: { id: true },\n });\n return existing !== null;\n }\n}\n\n// Factory function to create PrismaAICallLogger with prisma client\nexport function createPrismaAICallLogger(prisma: PrismaClient): AICallLogger {\n return new PrismaAICallLogger(prisma);\n}\n","/**\n * Prisma Enum Compatibility Layer\n *\n * Provides compatibility between Prisma 6.x (string enums) and Prisma 7.x (typed enums).\n * Prisma 7.x introduced runtime enum validation, requiring actual enum values instead of strings.\n *\n * This utility resolves enum values from the Prisma client's $Enums property when available,\n * falling back to string values for older Prisma versions.\n *\n * @example\n * ```typescript\n * const helper = createEnumHelper(prisma);\n *\n * // Instead of: status: \"PENDING\"\n * // Use: status: helper.status(\"PENDING\")\n * ```\n */\n\ntype PrismaClient = any;\n\nexport interface PrismaEnumHelper {\n /** Resolve Status enum value (unified enum for workflows, stages, and jobs) */\n status(value: string): unknown;\n /** Resolve ArtifactType enum value */\n artifactType(value: string): unknown;\n /** Resolve LogLevel enum value */\n logLevel(value: string): unknown;\n}\n\n/**\n * Creates an enum helper that resolves enum values from the Prisma client.\n *\n * Supports both Prisma 6.x (returns string) and Prisma 7.x (returns typed enum).\n */\nexport function createEnumHelper(prisma: PrismaClient): PrismaEnumHelper {\n const resolveEnum = (enumName: string, value: string): unknown => {\n try {\n // Prisma 7.x exposes enums via $Enums\n const enumObj = prisma.$Enums?.[enumName];\n if (enumObj && value in enumObj) {\n return enumObj[value];\n }\n } catch {\n // Ignore - fall through to string\n }\n // Fallback for Prisma 6.x or if enum not found\n return value;\n };\n\n return {\n status: (value: string) => resolveEnum(\"Status\", value),\n artifactType: (value: string) => resolveEnum(\"ArtifactType\", value),\n logLevel: (value: string) => resolveEnum(\"LogLevel\", value),\n };\n}\n","/**\n * PrismaJobQueue - Prisma implementation of JobQueue\n *\n * Provides atomic job queue operations using PostgreSQL\n * with FOR UPDATE SKIP LOCKED for safe concurrent access.\n *\n * This is migrated from the original services/job-queue.server.ts\n */\n\nimport { createLogger } from \"../../utils/logger\";\nimport type { DequeueResult, EnqueueJobInput, JobQueue } from \"../interface\";\nimport { createEnumHelper, type PrismaEnumHelper } from \"./enum-compat\";\nimport type { DatabaseType } from \"./persistence\";\n\nconst logger = createLogger(\"JobQueue\");\n\n// Type for prisma client - using any for flexibility\ntype PrismaClient = any;\n\nexport interface PrismaJobQueueOptions {\n /**\n * Unique worker identifier. Defaults to auto-generated ID.\n */\n workerId?: string;\n /**\n * Database type. Defaults to \"postgresql\".\n * Set to \"sqlite\" when using SQLite (uses optimistic locking instead of FOR UPDATE SKIP LOCKED).\n */\n databaseType?: DatabaseType;\n}\n\nexport class PrismaJobQueue implements JobQueue {\n private workerId: string;\n private prisma: PrismaClient;\n private enums: PrismaEnumHelper;\n private databaseType: DatabaseType;\n\n constructor(prisma: PrismaClient, options: PrismaJobQueueOptions = {}) {\n this.prisma = prisma;\n this.workerId = options.workerId || `worker-${process.pid}-${Date.now()}`;\n this.enums = createEnumHelper(prisma);\n this.databaseType = options.databaseType ?? \"postgresql\";\n }\n\n /**\n * Add a new job to the queue\n */\n async enqueue(options: EnqueueJobInput): Promise<string> {\n const job = await this.prisma.jobQueue.create({\n data: {\n workflowRunId: options.workflowRunId,\n stageId: options.stageId,\n priority: options.priority ?? 5,\n payload: {\n ...options.payload,\n _workflowId: options.workflowId,\n } as unknown,\n status: this.enums.status(\"PENDING\"),\n nextPollAt: options.scheduledFor,\n },\n });\n\n logger.debug(\n `Enqueued job ${job.id} for stage ${options.stageId} (run: ${options.workflowRunId})`,\n );\n return job.id;\n }\n\n /**\n * Enqueue multiple stages in parallel (same execution group)\n */\n async enqueueParallel(jobs: EnqueueJobInput[]): Promise<string[]> {\n if (jobs.length === 0) return [];\n\n const results = await this.prisma.$transaction(\n jobs.map((job) =>\n this.prisma.jobQueue.create({\n data: {\n workflowRunId: job.workflowRunId,\n stageId: job.stageId,\n priority: job.priority ?? 5,\n payload: { ...job.payload, _workflowId: job.workflowId } as unknown,\n status: this.enums.status(\"PENDING\"),\n },\n }),\n ),\n );\n\n return results.map((r: { id: string }) => r.id);\n }\n\n /**\n * Atomically dequeue the next available job\n * Uses FOR UPDATE SKIP LOCKED (PostgreSQL) or optimistic locking (SQLite)\n */\n async dequeue(): Promise<DequeueResult | null> {\n if (this.databaseType === \"sqlite\") {\n return this.dequeueSqlite();\n }\n return this.dequeuePostgres();\n }\n\n /**\n * PostgreSQL implementation using FOR UPDATE SKIP LOCKED for safe concurrency\n */\n private async dequeuePostgres(): Promise<DequeueResult | null> {\n try {\n const result = await this.prisma.$queryRaw<\n Array<{\n id: string;\n workflowRunId: string;\n stageId: string;\n priority: number;\n attempt: number;\n maxAttempts: number;\n payload: unknown;\n }>\n >`\n UPDATE \"job_queue\"\n SET\n status = 'RUNNING',\n \"workerId\" = ${this.workerId},\n \"lockedAt\" = NOW(),\n \"startedAt\" = NOW(),\n attempt = attempt + 1\n WHERE id = (\n SELECT id FROM \"job_queue\"\n WHERE status = 'PENDING'\n AND (\"nextPollAt\" IS NULL OR \"nextPollAt\" <= NOW())\n ORDER BY priority DESC, \"createdAt\" ASC\n LIMIT 1\n FOR UPDATE SKIP LOCKED\n )\n RETURNING id, \"workflowRunId\", \"stageId\", priority, attempt, \"maxAttempts\", payload\n `;\n\n if (result.length === 0) {\n return null;\n }\n\n const job = result[0];\n logger.debug(\n `Dequeued job ${job.id} (stage: ${job.stageId}, attempt: ${job.attempt})`,\n );\n\n const payload = job.payload as Record<string, unknown>;\n const { _workflowId, ...rest } = payload;\n return {\n jobId: job.id,\n workflowRunId: job.workflowRunId,\n workflowId: (_workflowId as string) ?? \"\",\n stageId: job.stageId,\n priority: job.priority,\n attempt: job.attempt,\n maxAttempts: job.maxAttempts,\n payload: rest,\n };\n } catch (error) {\n logger.error(\"Error dequeuing job:\", error);\n return null;\n }\n }\n\n /**\n * SQLite implementation using optimistic locking.\n * SQLite doesn't support FOR UPDATE SKIP LOCKED, so we use a two-step approach:\n * 1. Find a PENDING job\n * 2. Atomically update it (only succeeds if still PENDING)\n * 3. If another worker claimed it, retry\n */\n private async dequeueSqlite(): Promise<DequeueResult | null> {\n try {\n const now = new Date();\n\n // Step 1: Find the next PENDING job\n const job = await this.prisma.jobQueue.findFirst({\n where: {\n status: this.enums.status(\"PENDING\"),\n OR: [{ nextPollAt: null }, { nextPollAt: { lte: now } }],\n },\n orderBy: [{ priority: \"desc\" }, { createdAt: \"asc\" }],\n });\n\n if (!job) {\n return null;\n }\n\n // Step 2: Atomically claim it (only succeeds if still PENDING)\n const result = await this.prisma.jobQueue.updateMany({\n where: {\n id: job.id,\n status: this.enums.status(\"PENDING\"), // Optimistic lock\n },\n data: {\n status: this.enums.status(\"RUNNING\"),\n workerId: this.workerId,\n lockedAt: now,\n startedAt: now,\n attempt: { increment: 1 },\n },\n });\n\n if (result.count === 0) {\n // Another worker claimed it, retry\n return this.dequeueSqlite();\n }\n\n // Fetch the updated job to get the new attempt count\n const claimedJob = await this.prisma.jobQueue.findUnique({\n where: { id: job.id },\n });\n\n if (!claimedJob) {\n return null;\n }\n\n logger.debug(\n `Dequeued job ${claimedJob.id} (stage: ${claimedJob.stageId}, attempt: ${claimedJob.attempt})`,\n );\n\n const claimedPayload = claimedJob.payload as Record<string, unknown>;\n const { _workflowId: claimedWfId, ...claimedRest } = claimedPayload;\n return {\n jobId: claimedJob.id,\n workflowRunId: claimedJob.workflowRunId,\n workflowId: (claimedWfId as string) ?? \"\",\n stageId: claimedJob.stageId,\n priority: claimedJob.priority,\n attempt: claimedJob.attempt,\n maxAttempts: claimedJob.maxAttempts,\n payload: claimedRest,\n };\n } catch (error) {\n logger.error(\"Error dequeuing job:\", error);\n return null;\n }\n }\n\n /**\n * Mark job as completed\n */\n async complete(jobId: string): Promise<void> {\n await this.prisma.jobQueue.update({\n where: { id: jobId },\n data: {\n status: this.enums.status(\"COMPLETED\"),\n completedAt: new Date(),\n },\n });\n logger.debug(`Job ${jobId} completed`);\n }\n\n /**\n * Mark job as suspended (for async-batch)\n */\n async suspend(jobId: string, nextPollAt: Date): Promise<void> {\n await this.prisma.jobQueue.update({\n where: { id: jobId },\n data: {\n status: this.enums.status(\"SUSPENDED\"),\n nextPollAt,\n workerId: null,\n lockedAt: null,\n },\n });\n logger.debug(`Job ${jobId} suspended until ${nextPollAt.toISOString()}`);\n }\n\n /**\n * Mark job as failed\n */\n async fail(\n jobId: string,\n error: string,\n shouldRetry: boolean = false,\n ): Promise<void> {\n const job = await this.prisma.jobQueue.findUnique({\n where: { id: jobId },\n select: { attempt: true, maxAttempts: true },\n });\n\n if (shouldRetry && job && job.attempt < job.maxAttempts) {\n // Re-queue for retry with exponential backoff\n const backoffMs = 2 ** job.attempt * 1000; // 2s, 4s, 8s...\n const nextPollAt = new Date(Date.now() + backoffMs);\n\n await this.prisma.jobQueue.update({\n where: { id: jobId },\n data: {\n status: this.enums.status(\"PENDING\"),\n lastError: error,\n workerId: null,\n lockedAt: null,\n nextPollAt: nextPollAt,\n },\n });\n logger.debug(`Job ${jobId} failed, will retry in ${backoffMs}ms`);\n } else {\n await this.prisma.jobQueue.update({\n where: { id: jobId },\n data: {\n status: this.enums.status(\"FAILED\"),\n completedAt: new Date(),\n lastError: error,\n },\n });\n logger.debug(`Job ${jobId} failed permanently: ${error}`);\n }\n }\n\n /**\n * Get suspended jobs that are ready to be checked\n */\n async getSuspendedJobsReadyToPoll(): Promise<\n Array<{ jobId: string; stageId: string; workflowRunId: string }>\n > {\n const jobs = await this.prisma.jobQueue.findMany({\n where: {\n status: this.enums.status(\"SUSPENDED\"),\n nextPollAt: { lte: new Date() },\n },\n select: {\n id: true,\n workflowRunId: true,\n stageId: true,\n },\n });\n\n return jobs.map(\n (j: { id: string; workflowRunId: string; stageId: string }) => ({\n jobId: j.id,\n workflowRunId: j.workflowRunId,\n stageId: j.stageId,\n }),\n );\n }\n\n /**\n * Release stale locks (for crashed workers)\n */\n async releaseStaleJobs(staleThresholdMs: number = 300000): Promise<number> {\n const thresholdDate = new Date(Date.now() - staleThresholdMs);\n\n const result = await this.prisma.jobQueue.updateMany({\n where: {\n status: this.enums.status(\"RUNNING\"),\n lockedAt: { lt: thresholdDate },\n },\n data: {\n status: this.enums.status(\"PENDING\"),\n workerId: null,\n lockedAt: null,\n },\n });\n\n if (result.count > 0) {\n logger.debug(\n `Released ${result.count} stale jobs (locked before ${thresholdDate.toISOString()})`,\n );\n }\n\n return result.count;\n }\n}\n\n/**\n * Factory function to create PrismaJobQueue with prisma client\n *\n * @param prisma - Prisma client instance\n * @param optionsOrWorkerId - Options object or workerId string (for backwards compatibility)\n */\nexport function createPrismaJobQueue(\n prisma: PrismaClient,\n optionsOrWorkerId?: PrismaJobQueueOptions | string,\n): JobQueue {\n // Handle backwards compatibility: if string is passed, treat as workerId\n const options: PrismaJobQueueOptions =\n typeof optionsOrWorkerId === \"string\"\n ? { workerId: optionsOrWorkerId }\n : (optionsOrWorkerId ?? {});\n\n return new PrismaJobQueue(prisma, options);\n}\n","/**\n * PrismaWorkflowPersistence - Prisma implementation of WorkflowPersistence\n *\n * This is the default persistence implementation used by the workflow engine.\n * It wraps Prisma client operations to match the WorkflowPersistence interface.\n */\n\nimport type {\n CreateLogInput,\n CreateOutboxEventInput,\n CreateRunInput,\n CreateStageInput,\n OutboxRecord,\n SaveArtifactInput,\n UpdateRunInput,\n UpdateStageInput,\n UpsertStageInput,\n WorkflowArtifactRecord,\n WorkflowPersistence,\n WorkflowRunRecord,\n WorkflowStageRecord,\n WorkflowStageStatus,\n WorkflowStatus,\n} from \"../interface\";\nimport { StaleVersionError } from \"../interface\";\nimport { createEnumHelper, type PrismaEnumHelper } from \"./enum-compat\";\n\n// Type for prisma client - using any to avoid dependency on specific prisma client\ntype PrismaClient = any;\n\nexport type DatabaseType = \"postgresql\" | \"sqlite\";\n\nexport interface PrismaWorkflowPersistenceOptions {\n /**\n * Database type. Defaults to \"postgresql\".\n * Set to \"sqlite\" when using SQLite (uses optimistic locking instead of FOR UPDATE SKIP LOCKED).\n */\n databaseType?: DatabaseType;\n}\n\nconst IDEMPOTENCY_IN_PROGRESS_MARKER = {\n __workflowEngineState: \"in_progress\",\n};\n\nfunction isInProgressResult(result: unknown): boolean {\n if (!result || typeof result !== \"object\") return false;\n return (\n (result as Record<string, unknown>).__workflowEngineState === \"in_progress\"\n );\n}\n\nexport class PrismaWorkflowPersistence implements WorkflowPersistence {\n private enums: PrismaEnumHelper;\n private databaseType: DatabaseType;\n\n constructor(\n private readonly prisma: PrismaClient,\n options: PrismaWorkflowPersistenceOptions = {},\n ) {\n this.enums = createEnumHelper(prisma);\n this.databaseType = options.databaseType ?? \"postgresql\";\n }\n\n async withTransaction<T>(\n fn: (tx: WorkflowPersistence) => Promise<T>,\n ): Promise<T> {\n if (typeof this.prisma.$transaction !== \"function\") {\n return fn(this);\n }\n return this.prisma.$transaction(async (tx: PrismaClient) => {\n const txPersistence = new PrismaWorkflowPersistence(tx, {\n databaseType: this.databaseType,\n });\n return fn(txPersistence);\n });\n }\n\n // ============================================================================\n // WorkflowRun Operations\n // ============================================================================\n\n async createRun(data: CreateRunInput): Promise<WorkflowRunRecord> {\n const run = await this.prisma.workflowRun.create({\n data: {\n id: data.id,\n workflowId: data.workflowId,\n workflowName: data.workflowName,\n workflowType: data.workflowType,\n input: data.input as unknown,\n config: (data.config ?? {}) as unknown,\n priority: data.priority ?? 5,\n // Spread metadata for domain-specific fields (certificateId, etc.)\n ...(data.metadata ?? {}),\n },\n });\n return this.mapWorkflowRun(run);\n }\n\n async updateRun(id: string, data: UpdateRunInput): Promise<void> {\n const updateData = this.buildRunUpdateData(data);\n\n if (data.expectedVersion === undefined) {\n await this.prisma.workflowRun.update({\n where: { id },\n data: updateData,\n });\n return;\n }\n\n const result = await this.prisma.workflowRun.updateMany({\n where: { id, version: data.expectedVersion },\n data: {\n ...updateData,\n version: { increment: 1 },\n },\n });\n\n if (result.count === 0) {\n const current = await this.prisma.workflowRun.findUnique({\n where: { id },\n select: { version: true },\n });\n throw new StaleVersionError(\n \"WorkflowRun\",\n id,\n data.expectedVersion,\n current?.version ?? -1,\n );\n }\n }\n\n async getRun(id: string): Promise<WorkflowRunRecord | null> {\n const run = await this.prisma.workflowRun.findUnique({ where: { id } });\n return run ? this.mapWorkflowRun(run) : null;\n }\n\n async getRunStatus(id: string): Promise<WorkflowStatus | null> {\n const run = await this.prisma.workflowRun.findUnique({\n where: { id },\n select: { status: true },\n });\n return run?.status ?? null;\n }\n\n async getRunsByStatus(status: WorkflowStatus): Promise<WorkflowRunRecord[]> {\n const runs = await this.prisma.workflowRun.findMany({\n where: { status: this.enums.status(status) },\n orderBy: { createdAt: \"asc\" },\n });\n return runs.map((run: any) => this.mapWorkflowRun(run));\n }\n\n async getStuckRuns(stuckSince: Date): Promise<WorkflowRunRecord[]> {\n // Find RUNNING runs where both the run and ALL its stages\n // have not been updated since the threshold.\n const runs = await this.prisma.workflowRun.findMany({\n where: {\n status: this.enums.status(\"RUNNING\"),\n updatedAt: { lte: stuckSince },\n // No stage updated after the threshold\n stages: {\n none: {\n updatedAt: { gt: stuckSince },\n },\n },\n },\n orderBy: { updatedAt: \"asc\" },\n });\n return runs.map((run: any) => this.mapWorkflowRun(run));\n }\n\n async claimPendingRun(id: string): Promise<boolean> {\n // Atomic update: only succeeds if status is still PENDING\n // This prevents race conditions when multiple workers try to claim the same run\n const result = await this.prisma.workflowRun.updateMany({\n where: {\n id,\n status: this.enums.status(\"PENDING\"),\n },\n data: {\n status: this.enums.status(\"RUNNING\"),\n startedAt: new Date(),\n },\n });\n\n // updateMany returns { count: N } - if count is 0, another worker already claimed it\n return result.count > 0;\n }\n\n async claimNextPendingRun(): Promise<WorkflowRunRecord | null> {\n if (this.databaseType === \"sqlite\") {\n return this.claimNextPendingRunSqlite();\n }\n return this.claimNextPendingRunPostgres();\n }\n\n /**\n * PostgreSQL implementation using FOR UPDATE SKIP LOCKED for zero-contention claiming.\n * This atomically:\n * 1. Finds the highest priority PENDING run (FIFO within same priority)\n * 2. Locks it exclusively (other workers skip locked rows)\n * 3. Updates it to RUNNING\n * 4. Returns the claimed run\n */\n private async claimNextPendingRunPostgres(): Promise<WorkflowRunRecord | null> {\n // Note: Table name is \"workflow_runs\" (snake_case per Prisma @@map convention)\n // Column names are camelCase (e.g., \"createdAt\", \"startedAt\")\n const results = await this.prisma.$queryRaw<any[]>`\n WITH claimed AS (\n SELECT id\n FROM \"workflow_runs\"\n WHERE status = ${this.enums.status(\"PENDING\")}\n ORDER BY priority DESC, \"createdAt\" ASC\n LIMIT 1\n FOR UPDATE SKIP LOCKED\n )\n UPDATE \"workflow_runs\"\n SET status = ${this.enums.status(\"RUNNING\")},\n \"startedAt\" = NOW(),\n \"updatedAt\" = NOW()\n FROM claimed\n WHERE \"workflow_runs\".id = claimed.id\n RETURNING \"workflow_runs\".*\n `;\n\n if (results.length === 0) {\n return null;\n }\n\n return this.mapWorkflowRun(results[0]);\n }\n\n /**\n * SQLite implementation using optimistic locking.\n * SQLite doesn't support FOR UPDATE SKIP LOCKED, so we use a two-step approach:\n * 1. Find a PENDING run\n * 2. Atomically update it (only succeeds if still PENDING)\n * 3. If another worker claimed it, retry\n */\n private async claimNextPendingRunSqlite(): Promise<WorkflowRunRecord | null> {\n // Step 1: Find the next PENDING run\n const run = await this.prisma.workflowRun.findFirst({\n where: { status: this.enums.status(\"PENDING\") },\n orderBy: [{ priority: \"desc\" }, { createdAt: \"asc\" }],\n });\n\n if (!run) {\n return null;\n }\n\n // Step 2: Atomically claim it (only succeeds if still PENDING)\n const result = await this.prisma.workflowRun.updateMany({\n where: {\n id: run.id,\n status: this.enums.status(\"PENDING\"), // Optimistic lock\n },\n data: {\n status: this.enums.status(\"RUNNING\"),\n startedAt: new Date(),\n updatedAt: new Date(),\n },\n });\n\n if (result.count === 0) {\n // Another worker claimed it, retry\n return this.claimNextPendingRunSqlite();\n }\n\n // Fetch the updated record\n const claimedRun = await this.prisma.workflowRun.findUnique({\n where: { id: run.id },\n });\n\n return claimedRun ? this.mapWorkflowRun(claimedRun) : null;\n }\n\n // ============================================================================\n // WorkflowStage Operations\n // ============================================================================\n\n async createStage(data: CreateStageInput): Promise<WorkflowStageRecord> {\n const stage = await this.prisma.workflowStage.create({\n data: {\n workflowRunId: data.workflowRunId,\n stageId: data.stageId,\n stageName: data.stageName,\n stageNumber: data.stageNumber,\n executionGroup: data.executionGroup,\n status: data.status\n ? this.enums.status(data.status)\n : this.enums.status(\"PENDING\"),\n startedAt: data.startedAt,\n config: data.config as unknown,\n inputData: data.inputData as unknown,\n },\n });\n return this.mapWorkflowStage(stage);\n }\n\n async upsertStage(data: UpsertStageInput): Promise<WorkflowStageRecord> {\n const stage = await this.prisma.workflowStage.upsert({\n where: {\n workflowRunId_stageId: {\n workflowRunId: data.workflowRunId,\n stageId: data.stageId,\n },\n },\n create: {\n workflowRunId: data.create.workflowRunId,\n stageId: data.create.stageId,\n stageName: data.create.stageName,\n stageNumber: data.create.stageNumber,\n executionGroup: data.create.executionGroup,\n status: data.create.status\n ? this.enums.status(data.create.status)\n : this.enums.status(\"RUNNING\"),\n startedAt: data.create.startedAt ?? new Date(),\n config: data.create.config as unknown,\n inputData: data.create.inputData as unknown,\n },\n update: {\n status: data.update.status\n ? this.enums.status(data.update.status)\n : undefined,\n startedAt: data.update.startedAt,\n },\n });\n return this.mapWorkflowStage(stage);\n }\n\n async updateStage(id: string, data: UpdateStageInput): Promise<void> {\n const updateData = this.buildStageUpdateData(data);\n\n if (data.expectedVersion === undefined) {\n await this.prisma.workflowStage.update({\n where: { id },\n data: updateData,\n });\n return;\n }\n\n const result = await this.prisma.workflowStage.updateMany({\n where: { id, version: data.expectedVersion },\n data: {\n ...updateData,\n version: { increment: 1 },\n },\n });\n\n if (result.count === 0) {\n const current = await this.prisma.workflowStage.findUnique({\n where: { id },\n select: { version: true },\n });\n throw new StaleVersionError(\n \"WorkflowStage\",\n id,\n data.expectedVersion,\n current?.version ?? -1,\n );\n }\n }\n\n async updateStageByRunAndStageId(\n workflowRunId: string,\n stageId: string,\n data: UpdateStageInput,\n ): Promise<void> {\n const updateData = this.buildStageUpdateData(data);\n\n if (data.expectedVersion === undefined) {\n await this.prisma.workflowStage.update({\n where: {\n workflowRunId_stageId: { workflowRunId, stageId },\n },\n data: updateData,\n });\n return;\n }\n\n const result = await this.prisma.workflowStage.updateMany({\n where: {\n workflowRunId,\n stageId,\n version: data.expectedVersion,\n },\n data: {\n ...updateData,\n version: { increment: 1 },\n },\n });\n\n if (result.count === 0) {\n const current = await this.prisma.workflowStage.findFirst({\n where: { workflowRunId, stageId },\n select: { id: true, version: true },\n });\n throw new StaleVersionError(\n \"WorkflowStage\",\n current?.id ?? `${workflowRunId}/${stageId}`,\n data.expectedVersion,\n current?.version ?? -1,\n );\n }\n }\n\n private buildRunUpdateData(data: UpdateRunInput): Record<string, unknown> {\n return {\n status: data.status ? this.enums.status(data.status) : undefined,\n startedAt: data.startedAt,\n completedAt: data.completedAt,\n duration: data.duration,\n output: data.output as unknown,\n totalCost: data.totalCost,\n totalTokens: data.totalTokens,\n };\n }\n\n private buildStageUpdateData(\n data: UpdateStageInput,\n ): Record<string, unknown> {\n return {\n status: data.status ? this.enums.status(data.status) : undefined,\n startedAt: data.startedAt,\n completedAt: data.completedAt,\n duration: data.duration,\n outputData: data.outputData as unknown,\n config: data.config as unknown,\n suspendedState: data.suspendedState as unknown,\n resumeData: data.resumeData as unknown,\n nextPollAt: data.nextPollAt,\n pollInterval: data.pollInterval,\n maxWaitUntil: data.maxWaitUntil,\n metrics: data.metrics as unknown,\n embeddingInfo: data.embeddingInfo as unknown,\n errorMessage: data.errorMessage,\n };\n }\n\n async getStage(\n runId: string,\n stageId: string,\n ): Promise<WorkflowStageRecord | null> {\n const stage = await this.prisma.workflowStage.findUnique({\n where: {\n workflowRunId_stageId: { workflowRunId: runId, stageId },\n },\n });\n return stage ? this.mapWorkflowStage(stage) : null;\n }\n\n async getStageById(id: string): Promise<WorkflowStageRecord | null> {\n const stage = await this.prisma.workflowStage.findUnique({ where: { id } });\n return stage ? this.mapWorkflowStage(stage) : null;\n }\n\n async getStagesByRun(\n runId: string,\n options?: { status?: WorkflowStageStatus; orderBy?: \"asc\" | \"desc\" },\n ): Promise<WorkflowStageRecord[]> {\n const stages = await this.prisma.workflowStage.findMany({\n where: {\n workflowRunId: runId,\n ...(options?.status && { status: this.enums.status(options.status) }),\n },\n orderBy: { executionGroup: options?.orderBy ?? \"asc\" },\n });\n return stages.map((s: Record<string, unknown>) => this.mapWorkflowStage(s));\n }\n\n async getSuspendedStages(beforeDate: Date): Promise<WorkflowStageRecord[]> {\n const stages = await this.prisma.workflowStage.findMany({\n where: {\n status: this.enums.status(\"SUSPENDED\"),\n nextPollAt: { lte: beforeDate },\n },\n include: {\n workflowRun: { select: { workflowType: true } },\n },\n });\n return stages.map((s: Record<string, unknown>) => this.mapWorkflowStage(s));\n }\n\n async getFirstSuspendedStageReadyToResume(\n runId: string,\n ): Promise<WorkflowStageRecord | null> {\n const stage = await this.prisma.workflowStage.findFirst({\n where: {\n workflowRunId: runId,\n status: this.enums.status(\"SUSPENDED\"),\n nextPollAt: null, // Ready to resume (poll cleared by orchestrator)\n },\n orderBy: { executionGroup: \"asc\" },\n });\n return stage ? this.mapWorkflowStage(stage) : null;\n }\n\n async getFirstFailedStage(\n runId: string,\n ): Promise<WorkflowStageRecord | null> {\n const stage = await this.prisma.workflowStage.findFirst({\n where: {\n workflowRunId: runId,\n status: this.enums.status(\"FAILED\"),\n },\n orderBy: { executionGroup: \"desc\" },\n });\n return stage ? this.mapWorkflowStage(stage) : null;\n }\n\n async getLastCompletedStage(\n runId: string,\n ): Promise<WorkflowStageRecord | null> {\n const stage = await this.prisma.workflowStage.findFirst({\n where: {\n workflowRunId: runId,\n status: this.enums.status(\"COMPLETED\"),\n },\n orderBy: { executionGroup: \"desc\" },\n });\n return stage ? this.mapWorkflowStage(stage) : null;\n }\n\n async getLastCompletedStageBefore(\n runId: string,\n executionGroup: number,\n ): Promise<WorkflowStageRecord | null> {\n const stage = await this.prisma.workflowStage.findFirst({\n where: {\n workflowRunId: runId,\n status: this.enums.status(\"COMPLETED\"),\n executionGroup: { lt: executionGroup },\n },\n orderBy: { executionGroup: \"desc\" },\n });\n return stage ? this.mapWorkflowStage(stage) : null;\n }\n\n async deleteStage(id: string): Promise<void> {\n await this.prisma.workflowStage.delete({ where: { id } });\n }\n\n // ============================================================================\n // WorkflowLog Operations\n // ============================================================================\n\n async createLog(data: CreateLogInput): Promise<void> {\n await this.prisma.workflowLog.create({\n data: {\n workflowRunId: data.workflowRunId,\n workflowStageId: data.workflowStageId,\n level: this.enums.logLevel(data.level),\n message: data.message,\n metadata: data.metadata as unknown,\n },\n });\n }\n\n // ============================================================================\n // WorkflowArtifact Operations\n // ============================================================================\n\n async saveArtifact(data: SaveArtifactInput): Promise<void> {\n await this.prisma.workflowArtifact.upsert({\n where: {\n workflowRunId_key: {\n workflowRunId: data.workflowRunId,\n key: data.key,\n },\n },\n create: {\n workflowRunId: data.workflowRunId,\n workflowStageId: data.workflowStageId,\n key: data.key,\n type: this.enums.artifactType(data.type),\n data: data.data as unknown,\n size: data.size,\n metadata: data.metadata as unknown,\n },\n update: {\n data: data.data as unknown,\n size: data.size,\n metadata: data.metadata as unknown,\n },\n });\n }\n\n async loadArtifact(runId: string, key: string): Promise<unknown> {\n const artifact = await this.prisma.workflowArtifact.findUnique({\n where: {\n workflowRunId_key: { workflowRunId: runId, key },\n },\n });\n return artifact?.data;\n }\n\n async hasArtifact(runId: string, key: string): Promise<boolean> {\n const artifact = await this.prisma.workflowArtifact.findUnique({\n where: {\n workflowRunId_key: { workflowRunId: runId, key },\n },\n select: { id: true },\n });\n return artifact !== null;\n }\n\n async deleteArtifact(runId: string, key: string): Promise<void> {\n await this.prisma.workflowArtifact.delete({\n where: {\n workflowRunId_key: { workflowRunId: runId, key },\n },\n });\n }\n\n async listArtifacts(runId: string): Promise<WorkflowArtifactRecord[]> {\n const artifacts = await this.prisma.workflowArtifact.findMany({\n where: { workflowRunId: runId },\n });\n return artifacts.map((a: Record<string, unknown>) =>\n this.mapWorkflowArtifact(a),\n );\n }\n\n async getStageIdForArtifact(\n runId: string,\n stageId: string,\n ): Promise<string | null> {\n const stage = await this.prisma.workflowStage.findUnique({\n where: {\n workflowRunId_stageId: { workflowRunId: runId, stageId },\n },\n select: { id: true },\n });\n return stage?.id ?? null;\n }\n\n // ============================================================================\n // Stage Output Convenience Methods\n // ============================================================================\n\n async saveStageOutput(\n runId: string,\n workflowType: string,\n stageId: string,\n output: unknown,\n ): Promise<string> {\n // Generate key with consistent pattern: workflow-v2/{type}/{runId}/{stageId}/output.json\n const key = `workflow-v2/${workflowType}/${runId}/${stageId}/output.json`;\n\n const json = JSON.stringify(output);\n const size = Buffer.byteLength(json, \"utf8\");\n\n // Get the workflowStage record ID for linking\n const workflowStageId = await this.getStageIdForArtifact(runId, stageId);\n\n await this.prisma.workflowArtifact.upsert({\n where: {\n workflowRunId_key: { workflowRunId: runId, key },\n },\n update: {\n data: output as unknown,\n size,\n workflowStageId,\n },\n create: {\n workflowRunId: runId,\n workflowStageId,\n key,\n type: this.enums.artifactType(\"STAGE_OUTPUT\"),\n data: output as unknown,\n size,\n },\n });\n\n return key;\n }\n\n // ============================================================================\n // Outbox Operations\n // ============================================================================\n\n async appendOutboxEvents(events: CreateOutboxEventInput[]): Promise<void> {\n if (events.length === 0) return;\n\n // Group by workflowRunId to assign sequences per-run\n const byRun = new Map<string, CreateOutboxEventInput[]>();\n for (const event of events) {\n const list = byRun.get(event.workflowRunId) ?? [];\n list.push(event);\n byRun.set(event.workflowRunId, list);\n }\n\n const rows: Array<{\n workflowRunId: string;\n sequence: number;\n eventType: string;\n payload: unknown;\n causationId: string;\n occurredAt: Date;\n }> = [];\n\n for (const [workflowRunId, runEvents] of byRun) {\n if (\n this.databaseType === \"postgresql\" &&\n typeof this.prisma.$executeRaw === \"function\"\n ) {\n // Serialize per-run sequence assignment inside the transaction.\n await this.prisma.$executeRaw`\n SELECT pg_advisory_xact_lock(hashtext(${workflowRunId}))\n `;\n }\n\n // Get the current max sequence for this run\n const maxResult = await this.prisma.outboxEvent.aggregate({\n where: { workflowRunId },\n _max: { sequence: true },\n });\n let seq = maxResult._max.sequence ?? 0;\n\n for (const event of runEvents) {\n seq++;\n rows.push({\n workflowRunId: event.workflowRunId,\n sequence: seq,\n eventType: event.eventType,\n payload: event.payload as any,\n causationId: event.causationId,\n occurredAt: event.occurredAt,\n });\n }\n }\n\n await this.prisma.outboxEvent.createMany({ data: rows });\n }\n\n async getUnpublishedOutboxEvents(limit?: number): Promise<OutboxRecord[]> {\n const effectiveLimit = limit ?? 100;\n const records = await this.prisma.outboxEvent.findMany({\n where: { publishedAt: null, dlqAt: null },\n orderBy: [{ workflowRunId: \"asc\" }, { sequence: \"asc\" }],\n take: effectiveLimit,\n });\n return records.map((r: any) => this.mapOutboxEvent(r));\n }\n\n async markOutboxEventsPublished(ids: string[]): Promise<void> {\n if (ids.length === 0) return;\n await this.prisma.outboxEvent.updateMany({\n where: { id: { in: ids } },\n data: { publishedAt: new Date() },\n });\n }\n\n // ============================================================================\n // Outbox DLQ Operations\n // ============================================================================\n\n async incrementOutboxRetryCount(id: string): Promise<number> {\n const record = await this.prisma.outboxEvent.update({\n where: { id },\n data: { retryCount: { increment: 1 } },\n select: { retryCount: true },\n });\n return record.retryCount;\n }\n\n async moveOutboxEventToDLQ(id: string): Promise<void> {\n await this.prisma.outboxEvent.update({\n where: { id },\n data: { dlqAt: new Date() },\n });\n }\n\n async replayDLQEvents(maxEvents: number): Promise<number> {\n const dlqEvents = await this.prisma.outboxEvent.findMany({\n where: { dlqAt: { not: null } },\n take: maxEvents,\n select: { id: true },\n });\n\n if (dlqEvents.length === 0) return 0;\n\n const result = await this.prisma.outboxEvent.updateMany({\n where: { id: { in: dlqEvents.map((e: any) => e.id) } },\n data: { dlqAt: null, retryCount: 0 },\n });\n return result.count;\n }\n\n // ============================================================================\n // Idempotency Operations\n // ============================================================================\n\n async acquireIdempotencyKey(\n key: string,\n commandType: string,\n ): Promise<\n | { status: \"acquired\" }\n | { status: \"replay\"; result: unknown }\n | { status: \"in_progress\" }\n > {\n try {\n await this.prisma.idempotencyKey.create({\n data: {\n key,\n commandType,\n result: IDEMPOTENCY_IN_PROGRESS_MARKER as any,\n },\n });\n return { status: \"acquired\" };\n } catch (error: any) {\n if (error?.code !== \"P2002\") {\n throw error;\n }\n }\n\n const existing = await this.prisma.idempotencyKey.findUnique({\n where: { key_commandType: { key, commandType } },\n select: { result: true },\n });\n\n if (!existing || isInProgressResult(existing.result)) {\n return { status: \"in_progress\" };\n }\n\n return { status: \"replay\", result: existing.result };\n }\n\n async completeIdempotencyKey(\n key: string,\n commandType: string,\n result: unknown,\n ): Promise<void> {\n await this.prisma.idempotencyKey.update({\n where: { key_commandType: { key, commandType } },\n data: { result: result as any },\n });\n }\n\n async releaseIdempotencyKey(key: string, commandType: string): Promise<void> {\n await this.prisma.idempotencyKey.deleteMany({\n where: { key, commandType },\n });\n }\n\n // ============================================================================\n // Type Mappers\n // ============================================================================\n\n private mapWorkflowRun(run: any): WorkflowRunRecord {\n return {\n id: run.id,\n createdAt: run.createdAt,\n updatedAt: run.updatedAt,\n workflowId: run.workflowId,\n workflowName: run.workflowName,\n workflowType: run.workflowType,\n status: run.status,\n startedAt: run.startedAt,\n completedAt: run.completedAt,\n duration: run.duration,\n input: run.input,\n output: run.output,\n config: run.config,\n totalCost: run.totalCost,\n totalTokens: run.totalTokens,\n priority: run.priority,\n version: run.version ?? 0,\n };\n }\n\n private mapWorkflowStage(stage: any): WorkflowStageRecord {\n return {\n id: stage.id,\n createdAt: stage.createdAt,\n updatedAt: stage.updatedAt,\n workflowRunId: stage.workflowRunId,\n stageId: stage.stageId,\n stageName: stage.stageName,\n stageNumber: stage.stageNumber,\n executionGroup: stage.executionGroup,\n status: stage.status,\n startedAt: stage.startedAt,\n completedAt: stage.completedAt,\n duration: stage.duration,\n inputData: stage.inputData,\n outputData: stage.outputData,\n config: stage.config,\n suspendedState: stage.suspendedState,\n resumeData: stage.resumeData,\n nextPollAt: stage.nextPollAt,\n pollInterval: stage.pollInterval,\n maxWaitUntil: stage.maxWaitUntil,\n metrics: stage.metrics,\n embeddingInfo: stage.embeddingInfo,\n errorMessage: stage.errorMessage,\n version: stage.version ?? 0,\n };\n }\n\n private mapOutboxEvent(record: any): OutboxRecord {\n return {\n id: record.id,\n workflowRunId: record.workflowRunId,\n sequence: record.sequence,\n eventType: record.eventType,\n payload: record.payload,\n causationId: record.causationId,\n occurredAt: record.occurredAt,\n publishedAt: record.publishedAt,\n retryCount: record.retryCount,\n dlqAt: record.dlqAt,\n };\n }\n\n private mapWorkflowArtifact(artifact: any): WorkflowArtifactRecord {\n return {\n id: artifact.id,\n createdAt: artifact.createdAt,\n updatedAt: artifact.updatedAt,\n workflowRunId: artifact.workflowRunId,\n workflowStageId: artifact.workflowStageId,\n key: artifact.key,\n type: artifact.type,\n data: artifact.data,\n size: artifact.size,\n metadata: artifact.metadata,\n };\n }\n}\n\n/**\n * Factory function to create PrismaWorkflowPersistence\n */\nexport function createPrismaWorkflowPersistence(\n prisma: PrismaClient,\n options?: PrismaWorkflowPersistenceOptions,\n): PrismaWorkflowPersistence {\n return new PrismaWorkflowPersistence(prisma, options);\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/persistence/interface.ts"],"names":[],"mappings":";AAkDO,IAAM,iBAAA,GAAN,cAAgC,KAAA,CAAM;AAAA,EAC3C,WAAA,CACkB,MAAA,EACA,EAAA,EACA,QAAA,EACA,MAAA,EAChB;AACA,IAAA,KAAA;AAAA,MACE,oBAAoB,MAAM,CAAA,CAAA,EAAI,EAAE,CAAA,WAAA,EAAc,QAAQ,SAAS,MAAM,CAAA;AAAA,KACvE;AAPgB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AACA,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AACA,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAKhB,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AAAA,EACd;AACF","file":"chunk-RZY5YRGL.js","sourcesContent":["/**\n * Persistence Interfaces for Workflow Engine\n *\n * These interfaces abstract database operations to enable:\n * - Testing with mock implementations\n * - Future extraction into @bratsos/workflow-engine package\n * - Alternative database backends\n *\n * Implementations:\n * - PrismaWorkflowPersistence (default, in ./prisma/)\n * - InMemoryPersistence (for testing)\n */\n\n// ============================================================================\n// Unified Status Type\n// ============================================================================\n\n/**\n * Unified status type for workflows, stages, and jobs.\n *\n * - PENDING: Not started yet\n * - RUNNING: Currently executing\n * - SUSPENDED: Paused, waiting for external event (e.g., batch job completion)\n * - COMPLETED: Finished successfully\n * - FAILED: Finished with error\n * - CANCELLED: Manually stopped by user\n * - SKIPPED: Stage-specific - bypassed due to condition\n */\nexport type Status =\n | \"PENDING\"\n | \"RUNNING\"\n | \"SUSPENDED\"\n | \"COMPLETED\"\n | \"FAILED\"\n | \"CANCELLED\"\n | \"SKIPPED\";\n\n/** @deprecated Use Status instead */\nexport type WorkflowStatus = Status;\n\n/** @deprecated Use Status instead */\nexport type WorkflowStageStatus = Status;\n\n/** @deprecated Use Status instead. Note: PROCESSING is now RUNNING. */\nexport type JobStatus = Status;\n\nexport type LogLevel = \"DEBUG\" | \"INFO\" | \"WARN\" | \"ERROR\";\n\nexport type ArtifactType = \"STAGE_OUTPUT\" | \"ARTIFACT\" | \"METADATA\";\n\nexport class StaleVersionError extends Error {\n constructor(\n public readonly entity: string,\n public readonly id: string,\n public readonly expected: number,\n public readonly actual: number,\n ) {\n super(\n `Stale version on ${entity} ${id}: expected ${expected}, got ${actual}`,\n );\n this.name = \"StaleVersionError\";\n }\n}\n\n// ============================================================================\n// Record Types (minimal fields needed by the workflow engine)\n// ============================================================================\n\nexport interface WorkflowRunRecord {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n version: number;\n workflowId: string;\n workflowName: string;\n workflowType: string;\n status: WorkflowStatus;\n startedAt: Date | null;\n completedAt: Date | null;\n duration: number | null;\n input: unknown;\n output: unknown | null;\n config: unknown;\n totalCost: number;\n totalTokens: number;\n priority: number;\n}\n\nexport interface WorkflowStageRecord {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n version: number;\n workflowRunId: string;\n stageId: string;\n stageName: string;\n stageNumber: number;\n executionGroup: number;\n status: WorkflowStageStatus;\n startedAt: Date | null;\n completedAt: Date | null;\n duration: number | null;\n inputData: unknown | null;\n outputData: unknown | null;\n config: unknown | null;\n suspendedState: unknown | null;\n resumeData: unknown | null;\n nextPollAt: Date | null;\n pollInterval: number | null;\n maxWaitUntil: Date | null;\n metrics: unknown | null;\n embeddingInfo: unknown | null;\n errorMessage: string | null;\n}\n\nexport interface WorkflowLogRecord {\n id: string;\n createdAt: Date;\n workflowStageId: string | null;\n workflowRunId: string | null;\n level: LogLevel;\n message: string;\n metadata: unknown | null;\n}\n\nexport interface WorkflowArtifactRecord {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n workflowRunId: string;\n workflowStageId: string | null;\n key: string;\n type: ArtifactType;\n data: unknown;\n size: number;\n metadata: unknown | null;\n}\n\n// ============================================================================\n// Outbox and Idempotency Record Types (for kernel transactional outbox)\n// ============================================================================\n\nexport interface OutboxRecord {\n id: string;\n workflowRunId: string;\n sequence: number;\n eventType: string;\n payload: unknown;\n causationId: string;\n occurredAt: Date;\n publishedAt: Date | null;\n retryCount: number;\n dlqAt: Date | null;\n}\n\nexport interface CreateOutboxEventInput {\n workflowRunId: string;\n eventType: string;\n payload: unknown;\n causationId: string;\n occurredAt: Date;\n}\n\nexport interface IdempotencyRecord {\n key: string;\n commandType: string;\n result: unknown;\n createdAt: Date;\n}\n\n// ============================================================================\n// AI Call Record Types\n// ============================================================================\n\nexport interface AICallRecord {\n id: string;\n createdAt: Date;\n topic: string;\n callType: string;\n modelKey: string;\n modelId: string;\n prompt: string;\n response: string;\n inputTokens: number;\n outputTokens: number;\n cost: number;\n metadata: unknown | null;\n}\n\nexport interface JobRecord {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n workflowRunId: string;\n workflowId: string;\n stageId: string;\n status: JobStatus;\n priority: number;\n workerId: string | null;\n lockedAt: Date | null;\n startedAt: Date | null;\n completedAt: Date | null;\n attempt: number;\n maxAttempts: number;\n lastError: string | null;\n nextPollAt: Date | null;\n payload: Record<string, unknown>;\n}\n\n// ============================================================================\n// Input Types (for creating/updating records)\n// ============================================================================\n\nexport interface CreateRunInput {\n id?: string;\n workflowId: string;\n workflowName: string;\n workflowType: string;\n input: unknown;\n config?: unknown;\n priority?: number;\n /** Optional metadata for domain-specific fields */\n metadata?: Record<string, unknown>;\n}\n\nexport interface UpdateRunInput {\n status?: WorkflowStatus;\n startedAt?: Date;\n completedAt?: Date | null;\n duration?: number;\n output?: unknown;\n totalCost?: number;\n totalTokens?: number;\n expectedVersion?: number;\n}\n\nexport interface CreateStageInput {\n workflowRunId: string;\n stageId: string;\n stageName: string;\n stageNumber: number;\n executionGroup: number;\n status?: WorkflowStageStatus;\n startedAt?: Date;\n config?: unknown;\n inputData?: unknown;\n}\n\nexport interface UpdateStageInput {\n status?: WorkflowStageStatus;\n startedAt?: Date;\n completedAt?: Date;\n duration?: number;\n outputData?: unknown;\n config?: unknown;\n suspendedState?: unknown;\n resumeData?: unknown;\n nextPollAt?: Date | null;\n pollInterval?: number;\n maxWaitUntil?: Date;\n metrics?: unknown;\n embeddingInfo?: unknown;\n artifacts?: unknown;\n errorMessage?: string;\n expectedVersion?: number;\n}\n\nexport interface UpsertStageInput {\n workflowRunId: string;\n stageId: string;\n create: CreateStageInput;\n update: UpdateStageInput;\n}\n\nexport interface CreateLogInput {\n workflowRunId?: string;\n workflowStageId?: string;\n level: LogLevel;\n message: string;\n metadata?: unknown;\n}\n\nexport interface SaveArtifactInput {\n workflowRunId: string;\n workflowStageId?: string;\n key: string;\n type: ArtifactType;\n data: unknown;\n size: number;\n metadata?: unknown;\n}\n\nexport interface CreateAICallInput {\n topic: string;\n callType: string;\n modelKey: string;\n modelId: string;\n prompt: string;\n response: string;\n inputTokens: number;\n outputTokens: number;\n cost: number;\n metadata?: unknown;\n}\n\nexport interface EnqueueJobInput {\n workflowRunId: string;\n workflowId: string;\n stageId: string;\n priority?: number;\n payload?: Record<string, unknown>;\n scheduledFor?: Date;\n}\n\nexport interface DequeueResult {\n jobId: string;\n workflowRunId: string;\n workflowId: string;\n stageId: string;\n priority: number;\n attempt: number;\n maxAttempts: number;\n payload: Record<string, unknown>;\n}\n\n// ============================================================================\n// WorkflowPersistence Interface\n// ============================================================================\n\nexport interface WorkflowPersistence {\n /** Execute operations within a transaction boundary. */\n withTransaction<T>(fn: (tx: WorkflowPersistence) => Promise<T>): Promise<T>;\n\n // WorkflowRun operations\n createRun(data: CreateRunInput): Promise<WorkflowRunRecord>;\n updateRun(id: string, data: UpdateRunInput): Promise<void>;\n getRun(id: string): Promise<WorkflowRunRecord | null>;\n getRunStatus(id: string): Promise<WorkflowStatus | null>;\n getRunsByStatus(status: WorkflowStatus): Promise<WorkflowRunRecord[]>;\n getStuckRuns(stuckSince: Date): Promise<WorkflowRunRecord[]>;\n\n /**\n * Atomically claim a pending workflow run for processing.\n * Uses atomic update with WHERE status = 'PENDING' to prevent race conditions.\n *\n * @param id - The workflow run ID to claim\n * @returns true if successfully claimed, false if already claimed by another worker\n */\n claimPendingRun(id: string): Promise<boolean>;\n\n /**\n * Atomically find and claim the next pending workflow run.\n * Uses FOR UPDATE SKIP LOCKED pattern (in Postgres) to prevent race conditions\n * when multiple workers try to claim workflows simultaneously.\n *\n * Priority ordering: higher priority first, then oldest (FIFO within same priority).\n *\n * @returns The claimed workflow run (now with status RUNNING), or null if no pending runs\n */\n claimNextPendingRun(): Promise<WorkflowRunRecord | null>;\n\n // WorkflowStage operations\n createStage(data: CreateStageInput): Promise<WorkflowStageRecord>;\n upsertStage(data: UpsertStageInput): Promise<WorkflowStageRecord>;\n updateStage(id: string, data: UpdateStageInput): Promise<void>;\n updateStageByRunAndStageId(\n workflowRunId: string,\n stageId: string,\n data: UpdateStageInput,\n ): Promise<void>;\n getStage(runId: string, stageId: string): Promise<WorkflowStageRecord | null>;\n getStageById(id: string): Promise<WorkflowStageRecord | null>;\n getStagesByRun(\n runId: string,\n options?: { status?: WorkflowStageStatus; orderBy?: \"asc\" | \"desc\" },\n ): Promise<WorkflowStageRecord[]>;\n getSuspendedStages(beforeDate: Date): Promise<WorkflowStageRecord[]>;\n getFirstSuspendedStageReadyToResume(\n runId: string,\n ): Promise<WorkflowStageRecord | null>;\n getFirstFailedStage(runId: string): Promise<WorkflowStageRecord | null>;\n getLastCompletedStage(runId: string): Promise<WorkflowStageRecord | null>;\n getLastCompletedStageBefore(\n runId: string,\n executionGroup: number,\n ): Promise<WorkflowStageRecord | null>;\n deleteStage(id: string): Promise<void>;\n\n // WorkflowLog operations\n createLog(data: CreateLogInput): Promise<void>;\n\n // WorkflowArtifact operations (for StageStorage)\n saveArtifact(data: SaveArtifactInput): Promise<void>;\n loadArtifact(runId: string, key: string): Promise<unknown>;\n hasArtifact(runId: string, key: string): Promise<boolean>;\n deleteArtifact(runId: string, key: string): Promise<void>;\n listArtifacts(runId: string): Promise<WorkflowArtifactRecord[]>;\n getStageIdForArtifact(runId: string, stageId: string): Promise<string | null>;\n\n // Stage output convenience methods (replaces separate StageStorage)\n saveStageOutput(\n runId: string,\n workflowType: string,\n stageId: string,\n output: unknown,\n ): Promise<string>;\n\n // Outbox DLQ operations\n /** Increment retry count for a failed outbox event. Returns new count. */\n incrementOutboxRetryCount(id: string): Promise<number>;\n\n /** Move an outbox event to DLQ (sets dlqAt). */\n moveOutboxEventToDLQ(id: string): Promise<void>;\n\n /** Reset DLQ events so they can be reprocessed by outbox.flush. Returns count reset. */\n replayDLQEvents(maxEvents: number): Promise<number>;\n\n // Outbox operations\n /** Write events to the outbox. Sequences are auto-assigned per workflowRunId. */\n appendOutboxEvents(events: CreateOutboxEventInput[]): Promise<void>;\n\n /** Read unpublished events ordered by (workflowRunId, sequence). */\n getUnpublishedOutboxEvents(limit?: number): Promise<OutboxRecord[]>;\n\n /** Mark events as published. */\n markOutboxEventsPublished(ids: string[]): Promise<void>;\n\n // Idempotency operations\n /** Atomically acquire an idempotency key for command execution. */\n acquireIdempotencyKey(\n key: string,\n commandType: string,\n ): Promise<\n | { status: \"acquired\" }\n | { status: \"replay\"; result: unknown }\n | { status: \"in_progress\" }\n >;\n\n /** Mark an idempotency key as completed and cache the command result. */\n completeIdempotencyKey(\n key: string,\n commandType: string,\n result: unknown,\n ): Promise<void>;\n\n /** Release an in-progress idempotency key after command failure. */\n releaseIdempotencyKey(key: string, commandType: string): Promise<void>;\n}\n\n// ============================================================================\n// AICallLogger Interface\n// ============================================================================\n\nexport interface AIHelperStats {\n totalCalls: number;\n totalInputTokens: number;\n totalOutputTokens: number;\n totalCost: number;\n perModel: Record<\n string,\n { calls: number; inputTokens: number; outputTokens: number; cost: number }\n >;\n}\n\nexport interface AICallLogger {\n /**\n * Log a single AI call (fire and forget)\n */\n logCall(call: CreateAICallInput): void;\n\n /**\n * Log batch results (for recording batch API results)\n */\n logBatchResults(batchId: string, results: CreateAICallInput[]): Promise<void>;\n\n /**\n * Get aggregated stats for a topic prefix\n */\n getStats(topicPrefix: string): Promise<AIHelperStats>;\n\n /**\n * Check if batch results are already recorded\n */\n isRecorded(batchId: string): Promise<boolean>;\n}\n\n// ============================================================================\n// JobQueue Interface\n// ============================================================================\n\nexport interface JobQueue {\n /**\n * Add a new job to the queue\n */\n enqueue(options: EnqueueJobInput): Promise<string>;\n\n /**\n * Enqueue multiple stages in parallel (same execution group)\n */\n enqueueParallel(jobs: EnqueueJobInput[]): Promise<string[]>;\n\n /**\n * Atomically dequeue the next available job\n */\n dequeue(): Promise<DequeueResult | null>;\n\n /**\n * Mark job as completed\n */\n complete(jobId: string): Promise<void>;\n\n /**\n * Mark job as suspended (for async-batch)\n */\n suspend(jobId: string, nextPollAt: Date): Promise<void>;\n\n /**\n * Mark job as failed\n */\n fail(jobId: string, error: string, shouldRetry?: boolean): Promise<void>;\n\n /**\n * Get suspended jobs that are ready to be checked\n */\n getSuspendedJobsReadyToPoll(): Promise<\n Array<{ jobId: string; stageId: string; workflowRunId: string }>\n >;\n\n /**\n * Release stale locks (for crashed workers)\n */\n releaseStaleJobs(staleThresholdMs?: number): Promise<number>;\n}\n\n// ============================================================================\n// Default Implementations (lazy loaded to avoid circular deps)\n// ============================================================================\n\n// Re-export from prisma implementations for convenience\n// These will be the default implementations used when no custom persistence is provided\n"]}
|