@bratsos/workflow-engine 0.2.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alex Bratsos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -642,7 +642,7 @@ async execute(ctx) {
 | `run.transition` | Advance to next stage group | `workflowRunId` |
 | `run.cancel` | Cancel a running workflow | `workflowRunId`, `reason?` |
 | `run.rerunFrom` | Rerun from a specific stage | `workflowRunId`, `fromStageId` |
-| `job.execute` | Execute a single stage | `idempotencyKey?`, `workflowRunId`, `workflowId`, `stageId`, `config` |
+| `job.execute` | Execute a single stage (multi-phase transactions) | `idempotencyKey?`, `workflowRunId`, `workflowId`, `stageId`, `config` |
 | `stage.pollSuspended` | Poll suspended stages | `maxChecks?` (returns `resumedWorkflowRunIds`) |
 | `lease.reapStale` | Release stale job leases | `staleThresholdMs` |
 | `outbox.flush` | Publish pending events | `maxEvents?` |
@@ -652,6 +652,10 @@ Idempotency behavior:
 - Replaying the same `idempotencyKey` returns cached results.
 - If the same key is already executing, dispatch throws `IdempotencyInProgressError`.
 
+Transaction behavior:
+- Most commands execute inside a single database transaction (handler + outbox events).
+- `job.execute` uses multi-phase transactions: Phase 1 commits `RUNNING` status immediately, Phase 2 runs `stageDef.execute()` outside any transaction, Phase 3 commits the final status. This avoids holding a database connection during long-running stage execution.
+
 ### Node Host Config
 
 | Option | Type | Default | Description |

package/dist/{chunk-P4KMGCT3.js → chunk-QBYB2PJJ.js}

@@ -1372,6 +1372,18 @@ function getModelProvider(modelConfig) {
   }
   return google(modelConfig.id);
 }
+function getEmbeddingModelProvider(modelConfig) {
+  if (modelConfig.provider === "openrouter") {
+    return openrouter.textEmbeddingModel(modelConfig.id);
+  }
+  if (modelConfig.provider === "google") {
+    const googleModelId = modelConfig.id.replace(/^google\//, "");
+    return google.embeddingModel(googleModelId);
+  }
+  throw new Error(
+    `Unsupported embedding provider "${modelConfig.provider}" for model "${modelConfig.id}". Supported providers: "openrouter", "google".`
+  );
+}
 function calculateCostWithDiscount(modelKey, inputTokens, outputTokens, isBatch = false) {
   const model = getModel(modelKey);
   const baseCost = calculateCost(modelKey, inputTokens, outputTokens);
@@ -1718,6 +1730,7 @@ var AIHelperImpl = class _AIHelperImpl {
     logger.debug(`embed request`, {
       model: modelKey,
       modelId: modelConfig.id,
+      provider: modelConfig.provider,
       textCount: texts.length,
       textPreview,
       dimensions,
@@ -1727,14 +1740,16 @@ var AIHelperImpl = class _AIHelperImpl {
       const embeddings = [];
       let totalInputTokens = 0;
       for (const t of texts) {
-        const embeddingModelId = modelConfig.id.replace(/^google\//, "");
+        const embeddingModel = getEmbeddingModelProvider(modelConfig);
         const result = await embed({
-          model: google.embeddingModel(embeddingModelId),
+          model: embeddingModel,
           value: t,
-          providerOptions: {
-            google: {
-              outputDimensionality: dimensions,
-              taskType: options.taskType ?? "RETRIEVAL_DOCUMENT"
+          ...modelConfig.provider === "google" && {
+            providerOptions: {
+              google: {
+                outputDimensionality: dimensions,
+                taskType: options.taskType ?? "RETRIEVAL_DOCUMENT"
+              }
             }
           }
         });
@@ -1767,6 +1782,7 @@ var AIHelperImpl = class _AIHelperImpl {
       });
       logger.debug(`embed response`, {
         model: modelKey,
+        provider: modelConfig.provider,
         embeddingsCount: embeddings.length,
         dimensions,
         inputTokens: totalInputTokens,
@@ -2288,5 +2304,5 @@ function createAIHelper(topic, logger2, logContext) {
 }
 
 export { AVAILABLE_MODELS, AnthropicBatchProvider, DEFAULT_MODEL_KEY, GoogleBatchProvider, ModelKey, ModelStatsTracker, NoInputSchema, OpenAIBatchProvider, calculateCost, createAIHelper, defineAsyncBatchStage, defineStage, getBestProviderForModel, getDefaultModel, getModel, getModelById, getRegisteredModel, listModels, listRegisteredModels, modelSupportsBatch, printAvailableModels, registerModels, requireStageOutput, resolveModelForProvider };
-//# sourceMappingURL=chunk-P4KMGCT3.js.map
-//# sourceMappingURL=chunk-P4KMGCT3.js.map
+//# sourceMappingURL=chunk-QBYB2PJJ.js.map
+//# sourceMappingURL=chunk-QBYB2PJJ.js.map