octaflow 0.20.1 → 0.22.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { $ as computeReadiness, A as StepConditionHandler, B as StepStatus, C as defineWaitStep, D as StartOptions, E as RetryPolicy, F as StepHandlerNotFoundError, G as WorkflowNotFoundError, H as WorkflowCreatedResult, I as StepHandlerRegistry, J as WorkflowStatus, K as WorkflowNotRetryableError, L as StepId, M as StepError, N as StepExecutionContext, O as StepCompensateHandler, P as StepHandler, Q as ReadinessPlan, R as StepRecord, S as defineSubWorkflowStep, T as InvalidWorkflowDefinitionError, U as WorkflowDefinition, V as WaitTimeoutPolicy, W as WorkflowId, X as JoinRule, Y as WorkflowWithSteps, Z as PlannedSkip, _ as WorkflowOutput, a as STEP_DISPLAY_STATUS, b as defineSleepStep, c as WORKFLOW_STATUS_SCHEMA, d as toPublicWorkflow, et as isTerminalStepStatus, f as StepDeps, g as TypedWorkflow, h as TypedStepContext, i as PublicWorkflowStep, it as ok, j as StepDefinition, k as StepCompensationContext, l as toDisplayStepStatus, m as TypedStep, n as PUBLIC_WORKFLOW_STEP_SCHEMA, nt as Result, o as STEP_DISPLAY_STATUS_SCHEMA, p as StepOutput, q as WorkflowRecord, r as PublicWorkflow, rt as err, s as StepDisplayStatus, t as PUBLIC_WORKFLOW_SCHEMA, tt as FlowErrorShape, u as toPublicStep, v as buildWorkflow, w as FlowError, x as defineStep, y as defineMapStep, z as StepRegistration } from "./index-BURAYZui.js";
 import { n as Logger, r as noopLogger, t as LogAttributes } from "./logger-BCus3AOa.js";
-import { A as ListWorkflowsFilters, C as AddChildStep, D as CreatedWorkflow, E as CreateWorkflowStep, M as TransactionalScope, N as WorkflowStore, O as FailStepParams, S as createInMemoryStepGate, T as CreateWorkflowParams, _ as InMemoryStepGateConfig, a as FlowSpan, b as StepGateDecision, c as RecordingObserver, d as createMeterObserver, f as createRecordingObserver, g as ConcurrencyRule, h as noopTracer, i as FlowObserver, j as ReopenWorkflowParams, k as FinishWorkflowParams, l as RecordingTracer, m as noopObserver, n as FlowEventType, o as FlowTracer, p as createRecordingTracer, r as FlowMeter, s as RecordedSpan, t as FlowEvent, u as combineObservers, v as RateRule, w as CompleteStepParams, x as StepGateRequest, y as StepGate } from "./observability-Bu-SXLcS.js";
+import { A as ListWorkflowsFilters, C as AddChildStep, D as CreatedWorkflow, E as CreateWorkflowStep, M as TransactionalScope, N as WorkflowStore, O as FailStepParams, S as createInMemoryStepGate, T as CreateWorkflowParams, _ as InMemoryStepGateConfig, a as FlowSpan, b as StepGateDecision, c as RecordingObserver, d as createMeterObserver, f as createRecordingObserver, g as ConcurrencyRule, h as noopTracer, i as FlowObserver, j as ReopenWorkflowParams, k as FinishWorkflowParams, l as RecordingTracer, m as noopObserver, n as FlowEventType, o as FlowTracer, p as createRecordingTracer, r as FlowMeter, s as RecordedSpan, t as FlowEvent, u as combineObservers, v as RateRule, w as CompleteStepParams, x as StepGateRequest, y as StepGate } from "./observability-CR9dEdLW.js";
 import { i as EnqueueOptions, n as DispatchStepPayload, r as Dispatcher, t as DispatchKind } from "./dispatcher-g7Ct0J6w.js";
 import { a as WorkflowCompletedArgs, i as BuildStepContextArgs, n as BeforeStartArgs, o as WorkflowHooks, r as BeforeStartResult, t as AfterStepArgs } from "./hooks-BdxIcc92.js";
 //#region src/core/registry.d.ts

package/dist/{observability-Bu-SXLcS.d.ts → observability-CR9dEdLW.d.ts}

@@ -79,7 +79,7 @@ interface ListWorkflowsFilters {
  * A store bound to an open transaction, plus an opaque handle a capable
  * {@link Dispatcher} can join so a job and the state change that produced it
  * commit together. Core never inspects `handle` — it belongs to the adapter
- * pair (e.g. store-pg hands dispatcher-pgboss its transaction-bound executor).
+ * pair (e.g. `./postgres` hands `./pg-boss` its transaction-bound executor).
  */
 interface TransactionalScope {
   /** A store whose writes go through the open transaction. */
@@ -318,7 +318,7 @@ interface RecordingObserver extends FlowObserver {
 declare function createRecordingObserver(): RecordingObserver;
 /**
  * The slice of a metrics API the engine's meter observer needs. Structural:
- * `@octabits-io/framework/telemetry`'s meter and an OpenTelemetry `Meter`
+ * `@octabits-io/telemetry`'s meter and an OpenTelemetry `Meter`
  * both fit (the SDK's `createCounter`/`createHistogram` need a two-line
  * adapter, the framework's meter none).
  */

package/dist/{dispatcher-pgboss → pg-boss}/index.d.ts

@@ -3,7 +3,7 @@ import { n as Logger } from "../logger-BCus3AOa.js";
 import { r as Dispatcher } from "../dispatcher-g7Ct0J6w.js";
 import { z } from "zod";
 import { PgBoss } from "pg-boss";
-//#region src/dispatcher-pgboss/payload.d.ts
+//#region src/pg-boss/payload.d.ts
 /**
  * The wire payload for a step job. It is the flow-core `DispatchStepPayload`
  * plus the `partitionKey` — the worker needs the partition to reconstruct a
@@ -66,7 +66,7 @@ export interface StartJobContext extends WireStartPayload {
 /** Resolve the per-delivery idempotency key. Explicit key wins over a prefix. */
 export declare function resolveStartIdempotencyKey(payload: WireStartPayload, jobId: string): string | undefined;
 //#endregion
-//#region src/dispatcher-pgboss/queue.d.ts
+//#region src/pg-boss/queue.d.ts
 /**
  * Create the step queue and its dead-letter queue if they do not exist. Call
  * once at startup; the dispatcher also runs it from `prepare` and lazily on a
@@ -148,7 +148,7 @@ export declare function createPgBossDlqWorker(deps: PgBossDlqWorkerDeps): {
   stop: () => Promise<void>;
 };
 //#endregion
-//#region src/dispatcher-pgboss/scheduler.d.ts
+//#region src/pg-boss/scheduler.d.ts
 /** Create the start queue (idempotent). */
 export declare function ensureStartQueue(boss: PgBoss, queueName: string): Promise<void>;
 export interface PgBossSchedulerDeps {

package/dist/{dispatcher-pgboss → pg-boss}/index.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-//#region src/dispatcher-pgboss/payload.ts
+//#region src/pg-boss/payload.ts
 /**
 * The wire payload for a step job. It is the flow-core `DispatchStepPayload`
 * plus the `partitionKey` — the worker needs the partition to reconstruct a
@@ -52,7 +52,7 @@ function resolveStartIdempotencyKey(payload, jobId) {
 	if (payload.idempotencyKeyPrefix !== void 0) return `${payload.idempotencyKeyPrefix}:${jobId}`;
 }
 //#endregion
-//#region src/dispatcher-pgboss/queue.ts
+//#region src/pg-boss/queue.ts
 function dlqName(queueName) {
 	return `${queueName}-dlq`;
 }
@@ -166,7 +166,7 @@ function createPgBossDispatcher(deps) {
 				ok: false,
 				error: {
 					key: "queue_error",
-					message: "Transaction handle is not a SqlExecutor — is the store store-pg?"
+					message: "Transaction handle is not a SqlExecutor — is the store octaflow/postgres?"
 				}
 			};
 			if (!await boss.send(queueName, parsed.data, {
@@ -324,7 +324,7 @@ function createPgBossDlqWorker(deps) {
 	};
 }
 //#endregion
-//#region src/dispatcher-pgboss/scheduler.ts
+//#region src/pg-boss/scheduler.ts
 /** Create the start queue (idempotent). */
 async function ensureStartQueue(boss, queueName) {
 	try {

package/dist/{store-pg → postgres}/index.d.ts

@@ -1,7 +1,7 @@
 import { W as WorkflowId } from "../index-BURAYZui.js";
-import { N as WorkflowStore, g as ConcurrencyRule, i as FlowObserver, t as FlowEvent, v as RateRule, y as StepGate } from "../observability-Bu-SXLcS.js";
+import { N as WorkflowStore, g as ConcurrencyRule, i as FlowObserver, t as FlowEvent, v as RateRule, y as StepGate } from "../observability-CR9dEdLW.js";
 import { Pool } from "pg";
-//#region src/store-pg/ddl.d.ts
+//#region src/postgres/ddl.d.ts
 /**
  * Schema for the Postgres WorkflowStore adapter. Two tables mirror flow-core's
  * record shapes. Apply once at deploy time (or call `applySchema`).
@@ -15,7 +15,7 @@ export declare const FLOW_STORE_DDL: string;
 /** `CREATE SCHEMA IF NOT EXISTS` line for non-default schemas; empty for 'public'. */
 export declare function createSchemaDdl(schema: string): string;
 //#endregion
-//#region src/store-pg/executor.d.ts
+//#region src/postgres/executor.d.ts
 /** Minimal query result shape the adapters consume (a structural subset of `pg`'s `QueryResult`). */
 export interface SqlResult<R> {
   rows: R[];
@@ -50,7 +50,7 @@ export declare function poolExecutor(pool: Pool): SqlExecutor;
  */
 export declare function toExecutor(db: Pool | SqlExecutor): SqlExecutor;
 //#endregion
-//#region src/store-pg/store.d.ts
+//#region src/postgres/store.d.ts
 export interface PgWorkflowStoreDeps {
   pool: Pool;
   /** Partition this store instance is bound to (e.g. a tenant id). */
@@ -88,7 +88,7 @@ export declare function createPgWorkflowStore(deps: PgWorkflowStoreDeps): Workfl
 /** Convenience: apply the flow-store schema to a database. */
 export declare function applySchema(pool: Pool, ddl: string): Promise<void>;
 //#endregion
-//#region src/store-pg/gate.d.ts
+//#region src/postgres/gate.d.ts
 /** DDL for the gate's two tables. Apply once at deploy time (or via `applySchema`). */
 export declare function flowGateDdl(opts?: {
   schema?: string;
@@ -136,7 +136,7 @@ export declare function createStepGate(config: StepGateConfig): StepGate;
  */
 export declare function createPgStepGate(config: PgStepGateConfig): StepGate;
 //#endregion
-//#region src/store-pg/event-sink.d.ts
+//#region src/postgres/event-sink.d.ts
 /**
  * DDL for the append-only run-history table. Apply once at deploy time (alongside
  * `flowStoreDdl`), or call `applySchema(pool, flowEventDdl())`.

package/dist/{store-pg → postgres}/index.js

@@ -1,4 +1,4 @@
-//#region src/store-pg/ddl.ts
+//#region src/postgres/ddl.ts
 /**
 * Schema for the Postgres WorkflowStore adapter. Two tables mirror flow-core's
 * record shapes. Apply once at deploy time (or call `applySchema`).
@@ -79,7 +79,7 @@ function createSchemaDdl(schema) {
 	return schema === "public" ? "" : `CREATE SCHEMA IF NOT EXISTS ${schema};\n\n`;
 }
 //#endregion
-//#region src/store-pg/executor.ts
+//#region src/postgres/executor.ts
 /**
 * Build a {@link SqlExecutor} over a `pg` {@link Pool}: top-level queries run on
 * the pool (autocommit); `transaction` checks out a client and wraps `fn` in
@@ -133,7 +133,7 @@ function toExecutor(db) {
 	return "transaction" in db ? db : poolExecutor(db);
 }
 //#endregion
-//#region src/store-pg/store.ts
+//#region src/postgres/store.ts
 const iso = (v) => v == null ? null : v instanceof Date ? v.toISOString() : v;
 function mapWorkflow(r) {
 	return {
@@ -505,7 +505,7 @@ async function applySchema(pool, ddl) {
 	await pool.query(ddl);
 }
 //#endregion
-//#region src/store-pg/gate.ts
+//#region src/postgres/gate.ts
 const DEFAULT_RATE_TABLE = "flow_rate_bucket";
 const DEFAULT_LEASE_TABLE = "flow_step_lease";
 /** DDL for the gate's two tables. Apply once at deploy time (or via `applySchema`). */
@@ -645,7 +645,7 @@ function createPgStepGate(config) {
 	});
 }
 //#endregion
-//#region src/store-pg/event-sink.ts
+//#region src/postgres/event-sink.ts
 /**
 * DDL for the append-only run-history table. Apply once at deploy time (alongside
 * `flowStoreDdl`), or call `applySchema(pool, flowEventDdl())`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octaflow",
-  "version": "0.20.1",
+  "version": "0.22.0",
   "description": "Durable DAG workflow engine: Zod-typed steps over Postgres + pg-boss, with an optional AI add-on (token/cost/quota). Layered single package.",
   "license": "MIT",
   "type": "module",
@@ -15,15 +15,15 @@
       "import": "./dist/ai/index.js",
       "default": "./dist/ai/index.js"
     },
-    "./store-pg": {
-      "types": "./dist/store-pg/index.d.ts",
-      "import": "./dist/store-pg/index.js",
-      "default": "./dist/store-pg/index.js"
+    "./postgres": {
+      "types": "./dist/postgres/index.d.ts",
+      "import": "./dist/postgres/index.js",
+      "default": "./dist/postgres/index.js"
     },
-    "./dispatcher-pgboss": {
-      "types": "./dist/dispatcher-pgboss/index.d.ts",
-      "import": "./dist/dispatcher-pgboss/index.js",
-      "default": "./dist/dispatcher-pgboss/index.js"
+    "./pg-boss": {
+      "types": "./dist/pg-boss/index.d.ts",
+      "import": "./dist/pg-boss/index.js",
+      "default": "./dist/pg-boss/index.js"
     },
     "./ai/providers": {
       "types": "./dist/ai/providers/index.d.ts",
@@ -102,21 +102,21 @@
     }
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "^4.0.49",
-    "@ai-sdk/mistral": "^4.0.39",
-    "@ai-sdk/openai": "^4.0.58",
-    "@ai-sdk/provider": "^4.0.10",
+    "@ai-sdk/anthropic": "^4.0.52",
+    "@ai-sdk/mistral": "^4.0.42",
+    "@ai-sdk/openai": "^4.0.65",
+    "@ai-sdk/provider": "^4.0.13",
     "@testcontainers/postgresql": "^12.1.0",
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.5.1",
     "@types/pg": "^8.23.1",
-    "ai": "^7.0.93",
+    "ai": "^7.0.97",
     "pg": "^8.23.0",
     "pg-boss": "^12.30.0",
     "testcontainers": "^12.1.0",
     "tsdown": "^0.23.0",
     "typescript": "^7.0.2",
     "vitest": "^5.0.0",
-    "zod": "^4.5.4"
+    "zod": "^4.6.0"
   },
   "scripts": {
     "build": "tsdown",