@adonis-agora/durable 0.49.0 → 0.50.0

package/dist/src/workflow-discovery.d.ts

@@ -1,3 +1,4 @@
+import { type BarrelTree, type RootedBarrel } from './discovery-roots.js';
 import type { WorkflowEngine } from './engine.js';
 import { type WorkflowMeta } from './workflow-ref.js';
 /**
@@ -16,6 +17,8 @@ export type DiscoveredWorkflowClass = new () => {
 export interface DiscoveredWorkflow {
     meta: WorkflowMeta;
     cls: DiscoveredWorkflowClass;
+    /** The module it was found in: an absolute path for a directory scan, the key for a barrel. */
+    file: string;
 }
 /**
  * A factory that instantiates a workflow class. When provided, it replaces the default `new Ctor()` —
@@ -37,57 +40,45 @@ export type WorkflowClassFactory = (ctor: DiscoveredWorkflowClass) => Discovered
  * (the Adonis container's `make` resolves async), so this function is async.
  */
 export declare function registerWorkflowClass(engine: WorkflowEngine, cls: unknown, factory?: WorkflowClassFactory): Promise<boolean>;
+/** Re-exported from its shared home so existing `pickModuleExt` imports keep working. */
+export { pickModuleExt } from './discovery-roots.js';
 /**
- * Pick the module extension a directory scan should import, from the `readdir` entries already in
- * hand — NOT from this library's own compiled file. A consuming app resolves this library as built
- * `.js` from `node_modules`, but its own `app/workflows` / `app/steps` are `.ts` in dev; deriving the
- * extension from `import.meta.url` (the old bug) always picked `.js` in that setup and silently
- * discovered nothing, because every entry was then skipped.
+ * Scan one directory — or several — RECURSIVELY for modules and collect every exported workflow
+ * class — a `BaseWorkflow` subclass (the default export and any named export are considered) — so
+ * nested conventions like `app/workflows/billing/charge_workflow.ts` are found, matching
+ * `make:workflow`'s nested-path scaffolding. Only the extension present in each directory is
+ * imported (see {@link pickModuleExt}), and each module path is visited once, so a built `.js` and a
+ * dev `.ts` of the same module never both register. Missing directory → nothing from it (the
+ * convention is opt-in: no `app/workflows`, nothing to register).
  *
- * Rules, in order:
- * 1. `.d.ts` entries are never importable modules — ignored entirely.
- * 2. If any remaining entry ends in `.ts`, the scan imports `.ts` files.
- * 3. Otherwise, if any entry ends in `.js`, the scan imports `.js` files.
- * 4. If neither is present, returns `null` (the scan registers nothing).
- *
- * This preserves the original de-duplication intent: a directory containing both a built `foo.js`
- * and its source `foo.ts` resolves to `.ts` only, so the same module is never registered twice.
- * Shared with {@link import('./step-discovery.js').registerStepsFromDir} so the two scanners can't
- * drift apart again.
- */
-export declare function pickModuleExt(entries: readonly string[]): '.ts' | '.js' | null;
-/**
- * Scan a directory RECURSIVELY for modules and collect every exported workflow class — a
- * `BaseWorkflow` subclass (the default export and any named export are considered) — so nested
- * conventions like
- * `app/workflows/billing/charge_workflow.ts` are found, matching `make:workflow`'s nested-path
- * scaffolding. Only the extension present in `dir` is imported (see {@link pickModuleExt}), and
- * each module path is visited once, so a built `.js` and a dev `.ts` of the same module never both
- * register. Missing directory → empty list (the convention is opt-in: no `app/workflows`, nothing to
- * register).
+ * With several directories (a modular app: `['app/orders/flows', 'app/billing/flows']`) every root
+ * is walked in order, and the same workflow name + version defined by different classes in two
+ * roots throws a {@link DuplicateDiscoveryError} naming both files.
  */
-export declare function discoverWorkflows(dir: string): Promise<DiscoveredWorkflow[]>;
+export declare function discoverWorkflows(dir: string | readonly string[]): Promise<DiscoveredWorkflow[]>;
 /**
- * Discover every workflow class (`BaseWorkflow` subclass) under `dir` and register each on the
- * engine. Returns the registered metadata so the caller can log what was wired.
- * Best-effort over a missing directory.
+ * Discover every workflow class (`BaseWorkflow` subclass) under `dir` — one directory or several,
+ * see {@link discoverWorkflows} — and register each on the engine. Returns the registered metadata
+ * so the caller can log what was wired. Best-effort over a missing directory; throws a
+ * {@link DuplicateDiscoveryError} (registering nothing) on a cross-directory name clash.
  */
-export declare function registerWorkflowsFromDir(engine: WorkflowEngine, dir: string, factory?: WorkflowClassFactory): Promise<WorkflowMeta[]>;
+export declare function registerWorkflowsFromDir(engine: WorkflowEngine, dir: string | readonly string[], factory?: WorkflowClassFactory): Promise<WorkflowMeta[]>;
 /**
  * The shape of the build-time barrel generated by the Assembler `init` hook
  * (`@adonis-agora/durable/hooks/workflows`): a map of stable key → lazy module import, e.g.
- * `{ Charge: () => import('#workflows/charge_workflow') }`. The exact key is irrelevant here — we
- * register every workflow export of every module (`BaseWorkflow` subclass), identical to the runtime
- * scan.
+ * `{ Charge: () => import('#workflows/charge_workflow') }`, nested one level per sub-directory
+ * (`{ billing: { Refund: () => import(...) } }`). The exact key is irrelevant here — we register
+ * every workflow export of every module (`BaseWorkflow` subclass), identical to the runtime scan.
+ * When the hook's `source` lists several directories it writes a {@link RootedBarrel} array instead.
  */
-export type WorkflowsBarrel = Record<string, () => Promise<Record<string, unknown>>>;
+export type WorkflowsBarrel = BarrelTree;
 /**
  * Register every workflow class reachable from a generated {@link WorkflowsBarrel} (`BaseWorkflow`
- * subclass), by awaiting each lazy module import and registering each
- * workflow export — the build-time equivalent of {@link registerWorkflowsFromDir}, with no runtime
- * `readdir`. Each module is imported once and each class registered once (deduped), so a class
- * re-exported from several modules is safe. Returns the registered metadata so the caller can log
- * what was wired.
+ * subclass) — or from the multi-root {@link RootedBarrel} array — by awaiting each lazy module import
+ * and registering each workflow export: the build-time equivalent of {@link registerWorkflowsFromDir},
+ * with no runtime `readdir`. Each module is imported once and each class registered once (deduped),
+ * so a class re-exported from several modules is safe. Same cross-root duplicate rule as the scan.
+ * Returns the registered metadata so the caller can log what was wired.
  */
-export declare function registerWorkflowsFromBarrel(engine: WorkflowEngine, barrel: WorkflowsBarrel, factory?: WorkflowClassFactory): Promise<WorkflowMeta[]>;
+export declare function registerWorkflowsFromBarrel(engine: WorkflowEngine, barrel: WorkflowsBarrel | readonly RootedBarrel[], factory?: WorkflowClassFactory): Promise<WorkflowMeta[]>;
 //# sourceMappingURL=workflow-discovery.d.ts.map

package/dist/src/workflow-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU;IAC9C,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D,CAAC;AAEF;2CAC2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,uBAAuB,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,uBAAuB,KAC1B,uBAAuB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;AAQ1F;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,oBAA6C,GACrD,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAY9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyBlF;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErF;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}
+{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,YAAY,EAElB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU;IAC9C,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D,CAAC;AAEF;2CAC2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,uBAAuB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,uBAAuB,KAC1B,uBAAuB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;AAQ1F;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,oBAA6C,GACrD,OAAO,CAAC,OAAO,CAAC,CAwDlB;AAED,yFAAyF;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqCrD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE/B;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAC/B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GAAG,SAAS,YAAY,EAAE,EACjD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB"}

package/dist/src/workflow-discovery.js

@@ -1,6 +1,4 @@
-import { readdir } from 'node:fs/promises';
-import { extname, join } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { barrelModules, DuplicateDiscoveryError, scanDirsModules, } from './discovery-roots.js';
 import { eventTriggerCanonicalName, workflowEvents } from './workflow-events.js';
 import { onErrorRoutesOf, workflowMeta, workflowSchedules, } from './workflow-ref.js';
 function defaultWorkflowFactory(ctor) {
@@ -32,7 +30,19 @@ export async function registerWorkflowClass(engine, cls, factory = defaultWorkfl
     const exactNames = events
         .map(eventTriggerCanonicalName)
         .filter((name) => name !== null);
+    // Inline dead-letter handler: a `deadLetter(ctx, dead)` method becomes the workflow `<name>.dlq`.
+    const inlineDeadLetter = instance.deadLetter;
+    let deadLetterWorkflow = meta.deadLetterWorkflow;
+    if (typeof inlineDeadLetter === 'function') {
+        if (meta.deadLetterWorkflow !== undefined) {
+            throw new Error(`workflow ${meta.name} declares both a deadLetter() method and a deadLetterWorkflow option. Use one: the inline handler, or the reference.`);
+        }
+        const dlqName = `${meta.name}.dlq`;
+        engine.register(dlqName, meta.version, (ctx, input) => Promise.resolve(inlineDeadLetter.call(instance, ctx, input)), meta.origin ? { origin: meta.origin } : undefined);
+        deadLetterWorkflow = dlqName;
+    }
     engine.register(meta.name, meta.version, (ctx, input) => Promise.resolve(instance.run(ctx, input)), {
+        ...(deadLetterWorkflow !== undefined ? { deadLetterWorkflow } : {}),
         ...(meta.tags ? { tags: meta.tags } : {}),
         ...(meta.executionTimeout !== undefined ? { executionTimeout: meta.executionTimeout } : {}),
         ...(meta.onEvent || exactNames.length > 0
@@ -42,6 +52,8 @@ export async function registerWorkflowClass(engine, cls, factory = defaultWorkfl
         ...(meta.concurrency ? { concurrency: meta.concurrency } : {}),
         ...(meta.origin ? { origin: meta.origin } : {}),
         ...(meta.onError?.length ? { onError: onErrorRoutesOf(meta) } : {}),
+        ...(meta.inputSchema ? { inputSchema: meta.inputSchema } : {}),
+        ...(meta.searchAttributes ? { searchAttributesSchema: meta.searchAttributes } : {}),
     });
     // Collect any colocated `static schedule` on the class so the worker loop can fire it alongside the
     // config schedules. Both discovery paths (dir scan + generated barrel) funnel through here, so this
@@ -51,87 +63,64 @@ export async function registerWorkflowClass(engine, cls, factory = defaultWorkfl
         engine.registerSchedules(schedules);
     return true;
 }
+/** Re-exported from its shared home so existing `pickModuleExt` imports keep working. */
+export { pickModuleExt } from './discovery-roots.js';
 /**
- * Pick the module extension a directory scan should import, from the `readdir` entries already in
- * hand — NOT from this library's own compiled file. A consuming app resolves this library as built
- * `.js` from `node_modules`, but its own `app/workflows` / `app/steps` are `.ts` in dev; deriving the
- * extension from `import.meta.url` (the old bug) always picked `.js` in that setup and silently
- * discovered nothing, because every entry was then skipped.
+ * Collect every workflow class reachable from `modules`, in order: each export is considered
+ * (default and named), and a class seen twice (re-exported from several modules, or reachable from
+ * two overlapping roots) is kept once.
  *
- * Rules, in order:
- * 1. `.d.ts` entries are never importable modules — ignored entirely.
- * 2. If any remaining entry ends in `.ts`, the scan imports `.ts` files.
- * 3. Otherwise, if any entry ends in `.js`, the scan imports `.js` files.
- * 4. If neither is present, returns `null` (the scan registers nothing).
- *
- * This preserves the original de-duplication intent: a directory containing both a built `foo.js`
- * and its source `foo.ts` resolves to `.ts` only, so the same module is never registered twice.
- * Shared with {@link import('./step-discovery.js').registerStepsFromDir} so the two scanners can't
- * drift apart again.
- */
-export function pickModuleExt(entries) {
-    let hasTs = false;
-    let hasJs = false;
-    for (const entry of entries) {
-        if (entry.endsWith('.d.ts'))
-            continue;
-        const ext = extname(entry);
-        if (ext === '.ts')
-            hasTs = true;
-        else if (ext === '.js')
-            hasJs = true;
-    }
-    if (hasTs)
-        return '.ts';
-    if (hasJs)
-        return '.js';
-    return null;
-}
-/**
- * Scan a directory RECURSIVELY for modules and collect every exported workflow class — a
- * `BaseWorkflow` subclass (the default export and any named export are considered) — so nested
- * conventions like
- * `app/workflows/billing/charge_workflow.ts` are found, matching `make:workflow`'s nested-path
- * scaffolding. Only the extension present in `dir` is imported (see {@link pickModuleExt}), and
- * each module path is visited once, so a built `.js` and a dev `.ts` of the same module never both
- * register. Missing directory → empty list (the convention is opt-in: no `app/workflows`, nothing to
- * register).
+ * Two DIFFERENT classes claiming the same name + version from two different roots throw a
+ * {@link DuplicateDiscoveryError} quoting both files — before anything is registered. Within a single
+ * root nothing changes from the single-directory behaviour (both are kept; the later registration
+ * wins on the engine).
  */
-export async function discoverWorkflows(dir) {
-    let entries;
-    try {
-        entries = await readdir(dir, { recursive: true });
-    }
-    catch (err) {
-        if (err.code === 'ENOENT')
-            return [];
-        throw err;
-    }
-    const moduleExt = pickModuleExt(entries);
+async function collectWorkflows(modules) {
     const found = [];
-    if (moduleExt === null)
-        return found;
     const seen = new Set();
-    for (const entry of entries.sort()) {
-        if (extname(entry) !== moduleExt || entry.endsWith(`.d${moduleExt}`))
-            continue;
-        const mod = (await import(pathToFileURL(join(dir, entry)).href));
+    const owners = new Map();
+    for (const { root, file, load } of modules) {
+        const mod = await load();
         for (const exported of Object.values(mod)) {
             if (seen.has(exported))
                 continue;
             const meta = workflowMeta(exported);
             if (!meta)
                 continue;
+            const id = `${meta.name}@${meta.version}`;
+            const owner = owners.get(id);
+            if (owner && owner.root !== root) {
+                throw new DuplicateDiscoveryError('workflow', id, [owner.file, file]);
+            }
+            if (!owner)
+                owners.set(id, { root, file });
             seen.add(exported);
-            found.push({ meta, cls: exported });
+            found.push({ meta, cls: exported, file });
         }
     }
     return found;
 }
 /**
- * Discover every workflow class (`BaseWorkflow` subclass) under `dir` and register each on the
- * engine. Returns the registered metadata so the caller can log what was wired.
- * Best-effort over a missing directory.
+ * Scan one directory — or several — RECURSIVELY for modules and collect every exported workflow
+ * class — a `BaseWorkflow` subclass (the default export and any named export are considered) — so
+ * nested conventions like `app/workflows/billing/charge_workflow.ts` are found, matching
+ * `make:workflow`'s nested-path scaffolding. Only the extension present in each directory is
+ * imported (see {@link pickModuleExt}), and each module path is visited once, so a built `.js` and a
+ * dev `.ts` of the same module never both register. Missing directory → nothing from it (the
+ * convention is opt-in: no `app/workflows`, nothing to register).
+ *
+ * With several directories (a modular app: `['app/orders/flows', 'app/billing/flows']`) every root
+ * is walked in order, and the same workflow name + version defined by different classes in two
+ * roots throws a {@link DuplicateDiscoveryError} naming both files.
+ */
+export async function discoverWorkflows(dir) {
+    return collectWorkflows(await scanDirsModules(typeof dir === 'string' ? [dir] : dir));
+}
+/**
+ * Discover every workflow class (`BaseWorkflow` subclass) under `dir` — one directory or several,
+ * see {@link discoverWorkflows} — and register each on the engine. Returns the registered metadata
+ * so the caller can log what was wired. Best-effort over a missing directory; throws a
+ * {@link DuplicateDiscoveryError} (registering nothing) on a cross-directory name clash.
  */
 export async function registerWorkflowsFromDir(engine, dir, factory) {
     const discovered = await discoverWorkflows(dir);
@@ -141,28 +130,16 @@ export async function registerWorkflowsFromDir(engine, dir, factory) {
 }
 /**
  * Register every workflow class reachable from a generated {@link WorkflowsBarrel} (`BaseWorkflow`
- * subclass), by awaiting each lazy module import and registering each
- * workflow export — the build-time equivalent of {@link registerWorkflowsFromDir}, with no runtime
- * `readdir`. Each module is imported once and each class registered once (deduped), so a class
- * re-exported from several modules is safe. Returns the registered metadata so the caller can log
- * what was wired.
+ * subclass) — or from the multi-root {@link RootedBarrel} array — by awaiting each lazy module import
+ * and registering each workflow export: the build-time equivalent of {@link registerWorkflowsFromDir},
+ * with no runtime `readdir`. Each module is imported once and each class registered once (deduped),
+ * so a class re-exported from several modules is safe. Same cross-root duplicate rule as the scan.
+ * Returns the registered metadata so the caller can log what was wired.
  */
 export async function registerWorkflowsFromBarrel(engine, barrel, factory) {
-    const registered = [];
-    const seen = new Set();
-    for (const load of Object.values(barrel)) {
-        const mod = await load();
-        for (const exported of Object.values(mod)) {
-            if (seen.has(exported))
-                continue;
-            const meta = workflowMeta(exported);
-            if (!meta)
-                continue;
-            seen.add(exported);
-            await registerWorkflowClass(engine, exported, factory);
-            registered.push(meta);
-        }
-    }
-    return registered;
+    const discovered = await collectWorkflows(barrelModules(barrel));
+    for (const { cls } of discovered)
+        await registerWorkflowClass(engine, cls, factory);
+    return discovered.map((d) => d.meta);
 }
 //# sourceMappingURL=workflow-discovery.js.map

package/dist/src/workflow-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-discovery.js","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-discovery.js","sourceRoot":"","sources":["../../src/workflow-discovery.ts"],"names":[],"mappings":"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"}

package/dist/src/workflow-ref.d.ts

@@ -7,7 +7,9 @@
  */
 import type { ConcurrencyConfig } from './concurrency.js';
 import type { SingletonConfig } from './engine.js';
+import type { SearchAttributesSchema } from './interfaces.js';
 import type { ScheduledWorkflow, WorkflowScheduleConfig } from './scheduler.js';
+import type { StandardSchemaV1 } from './standard-schema.js';
 /** Options for a workflow's `static workflow = { name, version, … }` config (see {@link BaseWorkflow}). */
 export interface WorkflowOptions {
     /** The registered workflow name (the cross-runtime identity, e.g. `order`). */
@@ -57,6 +59,28 @@ export interface WorkflowOptions {
         };
         workflow: WorkflowRef;
     }[];
+    /**
+     * Where a run of this workflow that goes `dead` (past `maxRecoveryAttempts`) is handed: the engine
+     * starts this workflow with a `DeadLetter` input (`{ deadRunId, workflow, input, error }`) under
+     * the run id `dlq:<deadRunId>`, in the dead run's namespace. Overrides the config-level
+     * `deadLetterWorkflow`. A class can instead define a `deadLetter(ctx, dead)` method (registered as
+     * `<name>.dlq`); declaring both is an error at boot.
+     */
+    deadLetterWorkflow?: WorkflowRef;
+    /**
+     * Validate the run input at start against any Standard Schema (zod, valibot, arktype, …). A bad
+     * payload throws a `SchemaValidationError` from `start` and no run is created (an `onEvent`
+     * trigger with a rejected payload simply doesn't start this workflow). The schema's OUTPUT value
+     * (parsed / coerced / defaulted) is what the run stores and `run(ctx, input)` receives.
+     */
+    inputSchema?: StandardSchemaV1;
+    /**
+     * The run's typed search-attributes shape (a {@link SearchAttributesSchema}): every
+     * `ctx.upsertSearchAttributes` validates the merged attributes against it and rejects a
+     * non-conforming write. Pair with `run(ctx: WorkflowCtx<InferSearchAttributes<typeof schema>>)`
+     * for compile-time typing, and read them back typed with `attributesOf(WorkflowClass, run)`.
+     */
+    searchAttributes?: SearchAttributesSchema;
 }
 /** The metadata read off a workflow class's `static workflow` config for discovery + registration. */
 export interface WorkflowMeta extends WorkflowOptions {

package/dist/src/workflow-ref.d.ts.map

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

package/dist/src/workflow-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-ref.js","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-ref.js","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"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"}

package/dist/stubs/config/durable.stub

@@ -50,6 +50,12 @@ export default defineConfig({
   // remoteRedispatchMs: 5 * 60 * 1000,
   // remoteRedispatchMax: 10,
 
+  /**
+   * Liveness window of a remote (polyglot) workflow turn: with no decision and no run-scoped
+   * heartbeat for this long, the turn is re-driven instead of waiting forever. Heartbeats rearm it.
+   */
+  // remoteAdvanceSilenceMs: 2 * 60 * 1000,
+
   /**
    * Recurring workflows fired by the \`durable:work\` worker loop on every tick. Each window starts
    * exactly once even with several worker instances racing (idempotent by the schedule's time-bucket

package/dist/stubs/config/durable_dashboard.stub

@@ -2,13 +2,17 @@
   exports({ to: app.configPath('durable_dashboard.ts') })
 }}}
 import { defineConfig } from '@adonis-agora/durable/dashboard'
+// Used by the commented-out dashboardAuth example below.
+// import env from '#start/env'
 
 /**
  * Configuration for the @adonis-agora/durable dashboard.
  *
- * By default the dashboard is open OUTSIDE production, and in production it
- * requires a bearer token equal to \`DURABLE_DASHBOARD_TOKEN\` (deny if unset).
- * Replace \`authorize\` with your own guard (session, role, IP allow-list, …).
+ * By default the dashboard FAILS CLOSED in every environment: it requires a
+ * bearer token equal to \`DURABLE_DASHBOARD_TOKEN\`, and denies everything when
+ * that env var is unset. Replace \`authorize\` with your own guard (session,
+ * role, IP allow-list, …), or set \`allowUnauthenticated: true\` for a trusted
+ * local network only.
  *
  * \`dashboardAuth\` is an ADDITIVE, optional session gate on top of \`authorize\` —
  * a signed cookie minted via a built-in login page (Mode B: \`login\`) and/or a

package/dist/stubs/database/migrations/create_durable_tables.stub

@@ -7,7 +7,8 @@ import { createDurableTables, dropDurableTables } from '@adonis-agora/durable'
 
 /**
  * Durable workflow tables for the @adonis-agora/durable \`lucid\` state store: runs, step checkpoints,
- * the search-attribute side-table, signal waiters, buffered signals and buffered events.
+ * the search-attribute side-table, signal waiters, buffered signals, buffered events and persisted
+ * schedules (seven tables, plus the one-row \`durable_schema_meta\` marker).
  *
  * This migration DELEGATES to the library instead of reproducing its DDL. The schema belongs to the
  * library — \`LucidStateStore\` decides what columns it reads and writes — so a hand-copied snapshot

package/dist/stubs/database/migrations/create_durable_transport_messages.stub

@@ -0,0 +1,43 @@
+{{{
+  exports({ to: app.migrationsPath(`${new Date().getTime()}_create_durable_transport_messages.ts`) })
+}}}
+import { BaseSchema } from '@adonisjs/lucid/schema'
+
+/**
+ * The message channel of the @adonis-agora/durable \`db\` transport: remote-workflow decisions and step
+ * events, and the store-less (tenant pod) protocol's start-run, run-request, run-reply and tenant-event
+ * rows. Also adds the \`kind\` column (\`step\` / \`workflow\`) to \`durable_transport_tasks\` when an
+ * older migration created that table without it. Only needed when you select the \`db\` transport in
+ * config/durable.ts.
+ */
+export default class extends BaseSchema {
+  async up() {
+    this.schema.createTable('durable_transport_messages', (table) => {
+      table.increments('id').primary()
+      table.string('kind', 32).notNullable()
+      table.string('namespace').notNullable().defaultTo('default')
+      table.string('recipient').notNullable().defaultTo('')
+      table.string('reply_to')
+      table.text('payload', 'longtext').notNullable()
+      table.string('claimed_by')
+      table.bigInteger('claimed_at')
+      table.bigInteger('created_at').notNullable()
+      table.index(['namespace', 'kind', 'recipient', 'claimed_at', 'id'], 'durable_transport_messages_idx')
+    })
+
+    // Upgrading: a tasks table from an earlier release has no kind column. (A fresh install creates
+    // it with one, whichever of the two migrations runs first.)
+    // Each check takes a fresh schema builder: a Knex schema builder is stateful.
+    this.defer(async (db) => {
+      if (!(await db.schema.hasTable('durable_transport_tasks'))) return
+      if (await db.schema.hasColumn('durable_transport_tasks', 'kind')) return
+      await db.schema.alterTable('durable_transport_tasks', (table) => {
+        table.string('kind', 16).notNullable().defaultTo('step')
+      })
+    })
+  }
+
+  async down() {
+    this.schema.dropTableIfExists('durable_transport_messages')
+  }
+}

package/dist/stubs/database/migrations/create_durable_transport_tables.stub

@@ -6,9 +6,9 @@ import { BaseSchema } from '@adonisjs/lucid/schema'
 /**
  * Transport tables for the @adonis-agora/durable \`db\` transport: the point-to-point work channels (tasks /
  * results / heartbeats / control) that let durable remote steps run cross-process over the database
- * alone. JSON payloads are stored as TEXT (the transport (de)serializes them) and timestamps as
- * epoch-ms integers, so the schema is portable across SQLite / Postgres / MySQL. Only needed when you
- * select the \`db\` transport in config/durable.ts.
+ * alone. JSON payloads are stored as text (the transport (de)serializes them) — \`longtext\` on MySQL,
+ * where \`text\` stops at 64KB — and timestamps as epoch-ms integers, so the schema is portable across
+ * SQLite / Postgres / MySQL. Only needed when you select the \`db\` transport in config/durable.ts.
  */
 export default class extends BaseSchema {
   async up() {
@@ -19,11 +19,14 @@ export default class extends BaseSchema {
       table.string('name').notNullable()
       table.string('grp').notNullable()
       table.string('namespace').notNullable().defaultTo('default')
-      table.text('input')
+      table.text('input', 'longtext')
       table.string('traceparent')
-      table.text('context')
+      table.text('context', 'longtext')
       table.string('transport')
       table.integer('attempt').notNullable()
+      table.integer('reclaims').notNullable().defaultTo(0)
+      table.integer('priority').notNullable().defaultTo(0)
+      table.string('kind', 16).notNullable().defaultTo('step')
       table.string('claimed_by')
       table.bigInteger('claimed_at')
       table.bigInteger('created_at').notNullable()
@@ -36,10 +39,10 @@ export default class extends BaseSchema {
       table.integer('seq').notNullable()
       table.string('status').notNullable()
       table.string('namespace').notNullable().defaultTo('default')
-      table.text('output')
-      table.text('error')
+      table.text('output', 'longtext')
+      table.text('error', 'longtext')
       table.bigInteger('started_at')
-      table.text('events')
+      table.text('events', 'longtext')
       table.string('claimed_by')
       table.bigInteger('claimed_at')
       table.bigInteger('created_at').notNullable()
@@ -61,7 +64,7 @@ export default class extends BaseSchema {
 
     this.schema.createTable('durable_transport_control', (table) => {
       table.increments('id').primary()
-      table.text('payload').notNullable()
+      table.text('payload', 'longtext').notNullable()
       table.string('namespace').notNullable().defaultTo('default')
       table.string('claimed_by')
       table.bigInteger('claimed_at')

package/dist/stubs/database/migrations/create_durable_transport_worker_keys.stub

@@ -12,7 +12,7 @@ export default class extends BaseSchema {
   async up() {
     this.schema.createTable('durable_transport_worker_keys', (table) => {
       table.string('key', 512).primary()
-      table.text('value').notNullable()
+      table.text('value', 'longtext').notNullable()
       table.bigInteger('expires_at').notNullable()
       table.index(['expires_at'], 'durable_transport_worker_keys_expires_idx')
     })

package/dist/stubs/make/workflow/main.stub

@@ -1,4 +1,4 @@
-{{#var workflowName = string(entity.name).pascalCase().toString()}}
+{{#var workflowName = string(entity.name).snakeCase().removeSuffix('workflow').pascalCase().toString()}}
 {{#var workflowFileName = string(entity.name).snakeCase().removeSuffix('workflow').toString() + '_workflow'}}
 {{#var registeredName = string(entity.name).snakeCase().removeSuffix('workflow').toString()}}
 {{{