@adonis-agora/durable 0.3.0 → 0.5.0

package/dist/src/protocol.js

@@ -1,4 +1,30 @@
 import { createStepLogger } from './step-logger.js';
+/**
+ * The scoped-restore slot `@adonis-agora/context` exposes:
+ * `<T>(snapshot: Record<string, unknown> | undefined, fn: () => T) => T`. It runs `fn` INSIDE a
+ * freshly-activated context store seeded from `snapshot` (or just `fn()` when snapshot/slot is
+ * absent). Read structurally so a worker restores the originating request's userRef/tenant/traceId
+ * around a step handler with zero config when context is installed — and a clean no-op (`fn()`) when
+ * it is not. Wrapping (rather than the old `:set`, which only populates an already-active store) gives
+ * both correct propagation AND per-task isolation on a long-lived worker: each task runs in its own
+ * scope, so context never bleeds between tasks. The key is a global-registry symbol so it survives
+ * duplicate copies of either package in a dependency tree.
+ */
+const CONTEXT_SCOPE = Symbol.for('@agora/context:scope');
+/**
+ * Run `fn` inside the originating request's context (userRef/tenant/traceId), restored from the
+ * task's snapshot (stamped at dispatch by the originating engine, see {@link RemoteTask.context}),
+ * so a step handler sees it with no manual code. When `@adonis-agora/context` is not installed (slot
+ * absent) the body runs directly — a clean no-op fallback. Never throws from the propagation path: a
+ * non-function slot is ignored; errors inside `fn` propagate as the step's own failure (the scope
+ * helper itself re-throws nothing of its own).
+ */
+function withRestoredContext(snapshot, fn) {
+    const scope = globalThis[CONTEXT_SCOPE];
+    if (typeof scope !== 'function')
+        return fn();
+    return scope(snapshot, fn);
+}
 /** Canonical step id — the stable identity of a step within a run, used for dedupe and
  *  correlation. The format is part of the cross-language wire contract (Python builds the same). */
 export function stepId(runId, seq) {
@@ -25,23 +51,29 @@ export async function runStepHandler(task, handler) {
     }
     const events = [];
     const withEvents = (result) => events.length > 0 ? { ...result, events } : result;
-    try {
-        const output = await handler(task.input, createStepLogger(events, Date.now));
-        return withEvents({ ...base, status: 'completed', output });
-    }
-    catch (err) {
-        // Carry `code`/`retryable` off the thrown error if present, so the engine's durable retry can
-        // honour a worker's "don't retry this" verdict (e.g. a declined card).
-        const e = err;
-        return withEvents({
-            ...base,
-            status: 'failed',
-            error: {
-                message: err instanceof Error ? err.message : String(err),
-                ...(typeof e?.code === 'string' ? { code: e.code } : {}),
-                ...(typeof e?.retryable === 'boolean' ? { retryable: e.retryable } : {}),
-            },
-        });
-    }
+    // Run the handler INSIDE the originating request's context (userRef/tenant/traceId), restored from
+    // the task snapshot, so cross-process propagation is automatic — `ctx.call(remoteStep, input)`
+    // carries the caller's context with zero manual serialize/deserialize, and each task runs in its
+    // own scope (no cross-task bleed on a long-lived worker). No-op without `@adonis-agora/context`.
+    return withRestoredContext(task.context, async () => {
+        try {
+            const output = await handler(task.input, createStepLogger(events, Date.now));
+            return withEvents({ ...base, status: 'completed', output });
+        }
+        catch (err) {
+            // Carry `code`/`retryable` off the thrown error if present, so the engine's durable retry can
+            // honour a worker's "don't retry this" verdict (e.g. a declined card).
+            const e = err;
+            return withEvents({
+                ...base,
+                status: 'failed',
+                error: {
+                    message: err instanceof Error ? err.message : String(err),
+                    ...(typeof e?.code === 'string' ? { code: e.code } : {}),
+                    ...(typeof e?.retryable === 'boolean' ? { retryable: e.retryable } : {}),
+                },
+            });
+        }
+    });
 }
 //# sourceMappingURL=protocol.js.map

package/dist/src/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;oGACoG;AACpG,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,GAAW;IAC/C,OAAO,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC;AAC3B,CAAC;AAED;6FAC6F;AAC7F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,GAAW,EAAU,EAAE,CAAC,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;AAM5F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAgB,EAChB,OAAgC;IAEhC,+FAA+F;IAC/F,8FAA8F;IAC9F,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC9F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,GAAG,IAAI;YACP,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,EAAE,OAAO,EAAE,kBAAkB,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;SACpE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,CAAC,MAAkB,EAAc,EAAE,CACpD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,OAAO,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8FAA8F;QAC9F,uEAAuE;QACvE,MAAM,CAAC,GAAG,GAA+D,CAAC;QAC1E,OAAO,UAAU,CAAC;YAChB,GAAG,IAAI;YACP,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE;gBACL,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACzD,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/src/transports/event-emitter.d.ts

@@ -0,0 +1,60 @@
+import { EventEmitter } from 'node:events';
+import { type ControlMessage, type ControlPlane, type Heartbeat, type RemoteTask, type StepResult, type Transport } from '../interfaces.js';
+import { type StepHandler } from '../protocol.js';
+/** Event names the transport multiplexes over a single in-process emitter. */
+export declare const TASK_EVENT = "durable.task";
+export declare const RESULT_EVENT = "durable.result";
+export declare const HEARTBEAT_EVENT = "durable.heartbeat";
+export declare const CONTROL_EVENT = "durable.control";
+export interface EventEmitterTransportOptions {
+    /**
+     * The in-process emitter to multiplex over. Defaults to a fresh Node `EventEmitter` (listener cap
+     * lifted, since the engine wires several long-lived listeners). Pass `@adonisjs/core`'s `emitter`
+     * service if you'd rather ride the app's bus — it is API-compatible for `on`/`emit`.
+     */
+    emitter?: EventEmitter;
+    /**
+     * The worker group this instance serves. Unused for routing (handlers are matched by step name in
+     * this same process) — accepted for parity with the broker transports, and stamped nowhere.
+     */
+    group?: string;
+    /** Stable id for this process (stamped on control `from` when a publisher leaves it unset). Default random. */
+    instanceId?: string;
+}
+/**
+ * A production **in-process** {@link Transport} (and {@link ControlPlane}) backed by a single Node
+ * `EventEmitter`. Zero external infrastructure (no DB, no Redis, no broker): step handlers run in the
+ * same process, fully decoupled from the workflow that dispatched them, so a single-process app runs
+ * real durable workflows with nothing else to deploy.
+ *
+ * Distinct from the test-only {@link import('../testing/in-memory-transport.js').InMemoryTransport}:
+ * that one drives `dispatch` straight into the handler (synchronous-ish, for deterministic tests);
+ * this one decouples both directions through the emitter's event loop, mirroring how a real broker
+ * fans dispatch → worker → result back. Both funnel every step through {@link runStepHandler}, so the
+ * scoped context restore (the `@agora/context:scope` slot) works identically here.
+ *
+ * Swap to {@link import('./db.js').DbTransport} / {@link import('./queue.js').QueueTransport} for
+ * true cross-process or cross-language steps. The {@link ControlPlane} here broadcasts locally (every
+ * subscriber in this process), correct for single-instance; it does NOT fan out across pods.
+ *
+ * Usually you don't construct this directly: `config/durable.ts` selects it via
+ * `transports.eventEmitter()` (alias `transports.memory()` from the factory points at the test
+ * transport) and the provider builds it for you.
+ */
+export declare class EventEmitterTransport implements Transport, ControlPlane {
+    #private;
+    constructor(options?: EventEmitterTransportOptions);
+    /** Stable id stamped on control `from` when a publisher leaves it unset. */
+    get instanceId(): string;
+    dispatch(task: RemoteTask): Promise<void>;
+    /** Register a step handler by name (the worker side, in this same process). */
+    handle(name: string, fn: StepHandler): void;
+    /** Worker side: a liveness heartbeat. In-process handlers run synchronously, so emit it straight
+     *  through for symmetry — an engine that wired `onHeartbeat` still observes it. */
+    heartbeat(beat: Heartbeat): Promise<void>;
+    onResult(handler: (result: StepResult) => Promise<void>): void;
+    onHeartbeat(handler: (beat: Heartbeat) => Promise<void>): void;
+    publishControl(msg: ControlMessage): Promise<void>;
+    onControl(handler: (msg: ControlMessage) => void): void;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/src/transports/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../src/transports/event-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AAElE,8EAA8E;AAC9E,eAAO,MAAM,UAAU,iBAAiB,CAAC;AACzC,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAC7C,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAsB,YAAW,SAAS,EAAE,YAAY;;gBAKvD,OAAO,GAAE,4BAAiC;IAatD,4EAA4E;IAC5E,IAAI,UAAU,IAAI,MAAM,CAEvB;IAMK,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,+EAA+E;IAC/E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAI3C;uFACmF;IAC7E,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/C,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAM9D,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAUxD,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;CAGxD"}

package/dist/src/transports/event-emitter.js

@@ -0,0 +1,103 @@
+import { randomUUID } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import { runStepHandler } from '../protocol.js';
+/** Event names the transport multiplexes over a single in-process emitter. */
+export const TASK_EVENT = 'durable.task';
+export const RESULT_EVENT = 'durable.result';
+export const HEARTBEAT_EVENT = 'durable.heartbeat';
+export const CONTROL_EVENT = 'durable.control';
+/**
+ * A production **in-process** {@link Transport} (and {@link ControlPlane}) backed by a single Node
+ * `EventEmitter`. Zero external infrastructure (no DB, no Redis, no broker): step handlers run in the
+ * same process, fully decoupled from the workflow that dispatched them, so a single-process app runs
+ * real durable workflows with nothing else to deploy.
+ *
+ * Distinct from the test-only {@link import('../testing/in-memory-transport.js').InMemoryTransport}:
+ * that one drives `dispatch` straight into the handler (synchronous-ish, for deterministic tests);
+ * this one decouples both directions through the emitter's event loop, mirroring how a real broker
+ * fans dispatch → worker → result back. Both funnel every step through {@link runStepHandler}, so the
+ * scoped context restore (the `@agora/context:scope` slot) works identically here.
+ *
+ * Swap to {@link import('./db.js').DbTransport} / {@link import('./queue.js').QueueTransport} for
+ * true cross-process or cross-language steps. The {@link ControlPlane} here broadcasts locally (every
+ * subscriber in this process), correct for single-instance; it does NOT fan out across pods.
+ *
+ * Usually you don't construct this directly: `config/durable.ts` selects it via
+ * `transports.eventEmitter()` (alias `transports.memory()` from the factory points at the test
+ * transport) and the provider builds it for you.
+ */
+export class EventEmitterTransport {
+    #emitter;
+    #instanceId;
+    #handlers = new Map();
+    constructor(options = {}) {
+        // A long-lived single emitter carries several engine listeners; lift Node's default cap so the
+        // engine wiring (result + heartbeat + control + task) never trips a MaxListenersExceededWarning.
+        const emitter = options.emitter ?? new EventEmitter();
+        if (emitter instanceof EventEmitter)
+            emitter.setMaxListeners(0);
+        this.#emitter = emitter;
+        this.#instanceId = options.instanceId ?? randomUUID();
+        // The worker side listens for every dispatched task and runs it if it owns the step name.
+        this.#emitter.on(TASK_EVENT, (task) => {
+            void this.#process(task);
+        });
+    }
+    /** Stable id stamped on control `from` when a publisher leaves it unset. */
+    get instanceId() {
+        return this.#instanceId;
+    }
+    // ---------------------------------------------------------------------------
+    // engine → worker
+    // ---------------------------------------------------------------------------
+    async dispatch(task) {
+        this.#emitter.emit(TASK_EVENT, task);
+    }
+    // ---------------------------------------------------------------------------
+    // worker side — register a step handler, run it, emit the result back
+    // ---------------------------------------------------------------------------
+    /** Register a step handler by name (the worker side, in this same process). */
+    handle(name, fn) {
+        this.#handlers.set(name, fn);
+    }
+    /** Worker side: a liveness heartbeat. In-process handlers run synchronously, so emit it straight
+     *  through for symmetry — an engine that wired `onHeartbeat` still observes it. */
+    async heartbeat(beat) {
+        this.#emitter.emit(HEARTBEAT_EVENT, beat);
+    }
+    async #process(task) {
+        const handler = this.#handlers.get(task.name);
+        // Another subscriber may own this step name — stay silent, don't synthesize a "no handler" failure.
+        if (!handler)
+            return;
+        const result = await runStepHandler(task, handler);
+        // Emit the result on a LATER tick: a durable `ctx.call` suspends the run right after dispatch, so
+        // the result must land AFTER that unwinds (else the resume re-enters mid-suspend). Real brokers
+        // deliver asynchronously; this mirrors them.
+        setImmediate(() => this.#emitter.emit(RESULT_EVENT, result));
+    }
+    // ---------------------------------------------------------------------------
+    // worker → engine — the engine consumes results + heartbeats
+    // ---------------------------------------------------------------------------
+    onResult(handler) {
+        this.#emitter.on(RESULT_EVENT, (result) => {
+            void handler(result);
+        });
+    }
+    onHeartbeat(handler) {
+        this.#emitter.on(HEARTBEAT_EVENT, (beat) => {
+            void handler(beat);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // control plane (broadcast within this process)
+    // ---------------------------------------------------------------------------
+    async publishControl(msg) {
+        const stamped = msg.from ? msg : { ...msg, from: this.#instanceId };
+        this.#emitter.emit(CONTROL_EVENT, stamped);
+    }
+    onControl(handler) {
+        this.#emitter.on(CONTROL_EVENT, (msg) => handler(msg));
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/src/transports/event-emitter.js.map

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

package/dist/src/transports/factory.d.ts

@@ -24,9 +24,19 @@ export interface TransportContext {
  * actually selected — keeping those packages optional.
  */
 export type TransportFactory = (ctx: TransportContext) => Promise<Transport & Partial<ControlPlane>>;
-/** Options for the in-memory transport (no peer dependency). */
+/** Options for the in-memory (test-only) transport (no peer dependency). */
 export interface MemoryTransportConfig {
 }
+/** Options for the production in-process EventEmitter transport (no peer dependency). */
+export interface EventEmitterTransportConfig {
+    /**
+     * The worker group this instance serves. Accepted for parity with the broker transports; handlers
+     * are matched by step name in-process, so it does not affect routing.
+     */
+    group?: string;
+    /** Stable id for this process (stamped on control `from` when a publisher leaves it unset). Default random. */
+    instanceId?: string;
+}
 /** Options for the `@adonisjs/queue` transport. */
 export interface QueueTransportConfig {
     /**
@@ -69,8 +79,19 @@ export interface DbTransportConfig {
     instanceId?: string;
 }
 export declare const transports: {
-    /** In-process transport + control plane (single-process, no extra infra). The default. */
+    /**
+     * The test-only in-process transport + control plane (the engine's default when no `transport` is
+     * named). Drives `dispatch` straight into the handler for deterministic tests — for a real
+     * single-process production app, prefer {@link transports.eventEmitter}.
+     */
     memory(_config?: MemoryTransportConfig): TransportFactory;
+    /**
+     * Production **in-process** transport + control plane backed by a single Node `EventEmitter`. Zero
+     * external infrastructure (no DB, no Redis, no broker) — a single-process app runs real durable
+     * workflows with nothing else to deploy. Decouples dispatch → worker → result over the event loop
+     * (mirroring a real broker), unlike the test-only {@link transports.memory}.
+     */
+    eventEmitter(config?: EventEmitterTransportConfig): TransportFactory;
     /** Run remote steps cross-process over `@adonisjs/queue`, using a connection from `config/queue.ts`. */
     queue(config?: QueueTransportConfig): TransportFactory;
     /** Run remote steps cross-process over the app's database, using `@adonisjs/lucid` — no broker. */

package/dist/src/transports/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/transports/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGhE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,GAAG,EAAE;QACH,SAAS,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,CAAC;QACxD,MAAM,EAAE;YAAE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhD,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;CAErC;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyDD,eAAO,MAAM,UAAU;IACrB,0FAA0F;qBAC1E,qBAAqB,GAAQ,gBAAgB;IAI7D,wGAAwG;mBAC1F,oBAAoB,GAAQ,gBAAgB;IAc1D,mGAAmG;gBACxF,iBAAiB,GAAQ,gBAAgB;CAgBrD,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/transports/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGhE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,GAAG,EAAE;QACH,SAAS,EAAE;YAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,CAAC;QACxD,MAAM,EAAE;YAAE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;SAAE,CAAC;KACtD,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;CAErC;AAED,yFAAyF;AACzF,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyDD,eAAO,MAAM,UAAU;IACrB;;;;OAIG;qBACa,qBAAqB,GAAQ,gBAAgB;IAI7D;;;;;OAKG;0BACkB,2BAA2B,GAAQ,gBAAgB;IAUxE,wGAAwG;mBAC1F,oBAAoB,GAAQ,gBAAgB;IAc1D,mGAAmG;gBACxF,iBAAiB,GAAQ,gBAAgB;CAgBrD,CAAC"}

package/dist/src/transports/factory.js

@@ -18,10 +18,29 @@ async function resolveQueueAdapter(ctx, connection) {
     return typeof entry === 'function' ? entry : entry.resolver(ctx.app);
 }
 export const transports = {
-    /** In-process transport + control plane (single-process, no extra infra). The default. */
+    /**
+     * The test-only in-process transport + control plane (the engine's default when no `transport` is
+     * named). Drives `dispatch` straight into the handler for deterministic tests — for a real
+     * single-process production app, prefer {@link transports.eventEmitter}.
+     */
     memory(_config = {}) {
         return async () => new InMemoryTransport();
     },
+    /**
+     * Production **in-process** transport + control plane backed by a single Node `EventEmitter`. Zero
+     * external infrastructure (no DB, no Redis, no broker) — a single-process app runs real durable
+     * workflows with nothing else to deploy. Decouples dispatch → worker → result over the event loop
+     * (mirroring a real broker), unlike the test-only {@link transports.memory}.
+     */
+    eventEmitter(config = {}) {
+        return async () => {
+            const { EventEmitterTransport } = await import('./event-emitter.js');
+            return new EventEmitterTransport({
+                ...(config.group !== undefined ? { group: config.group } : {}),
+                ...(config.instanceId !== undefined ? { instanceId: config.instanceId } : {}),
+            });
+        };
+    },
     /** Run remote steps cross-process over `@adonisjs/queue`, using a connection from `config/queue.ts`. */
     queue(config = {}) {
         return async (ctx) => {

package/dist/src/transports/factory.js.map

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

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

@@ -0,0 +1,45 @@
+import type { WorkflowEngine } from './engine.js';
+import { type WorkflowClass, type WorkflowMeta } from './workflow-ref.js';
+/** A discovered, decorated workflow class plus the metadata its `@Workflow` decorator stamped. */
+export interface DiscoveredWorkflow {
+    meta: WorkflowMeta;
+    cls: WorkflowClass;
+}
+/**
+ * Register a single `@Workflow`-decorated class on the engine: instantiate it once and bind its
+ * `run(ctx, input)` as the workflow body via `engine.register`. The low-level
+ * `engine.register(name, version, fn)` stays the escape hatch — this is the convenience the
+ * `app/workflows` convention builds on. No-op (returns `false`) for an undecorated class.
+ */
+export declare function registerWorkflowClass(engine: WorkflowEngine, cls: unknown): boolean;
+/**
+ * Scan a directory RECURSIVELY for modules and collect every exported `@Workflow`-decorated class
+ * (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 environment-appropriate extension is imported (see {@link MODULE_EXT}), 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).
+ */
+export declare function discoverWorkflows(dir: string): Promise<DiscoveredWorkflow[]>;
+/**
+ * Discover every `@Workflow` class 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.
+ */
+export declare function registerWorkflowsFromDir(engine: WorkflowEngine, dir: string): 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`-decorated export of every module, identical to the runtime scan.
+ */
+export type WorkflowsBarrel = Record<string, () => Promise<Record<string, unknown>>>;
+/**
+ * Register every `@Workflow` class reachable from a generated {@link WorkflowsBarrel}, by awaiting
+ * each lazy module import and registering each decorated export — the build-time equivalent of
+ * {@link registerWorkflowsFromDir}, with no runtime `readdir`. Each module is imported once and each
+ * decorated 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.
+ */
+export declare function registerWorkflowsFromBarrel(engine: WorkflowEngine, barrel: WorkflowsBarrel): Promise<WorkflowMeta[]>;
+//# sourceMappingURL=workflow-discovery.d.ts.map

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

@@ -0,0 +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;AAClD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAExF,kGAAkG;AAClG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,aAAa,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAgBnF;AAUD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAuBlF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB"}

package/dist/src/workflow-discovery.js

@@ -0,0 +1,103 @@
+import { readdir } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { workflowMeta } from './workflow-ref.js';
+/**
+ * Register a single `@Workflow`-decorated class on the engine: instantiate it once and bind its
+ * `run(ctx, input)` as the workflow body via `engine.register`. The low-level
+ * `engine.register(name, version, fn)` stays the escape hatch — this is the convenience the
+ * `app/workflows` convention builds on. No-op (returns `false`) for an undecorated class.
+ */
+export function registerWorkflowClass(engine, cls) {
+    const meta = workflowMeta(cls);
+    if (!meta)
+        return false;
+    const Ctor = cls;
+    const instance = new Ctor();
+    engine.register(meta.name, meta.version, (ctx, input) => Promise.resolve(instance.run(ctx, input)), {
+        ...(meta.tags ? { tags: meta.tags } : {}),
+        ...(meta.executionTimeout !== undefined ? { executionTimeout: meta.executionTimeout } : {}),
+        ...(meta.onEvent ? { onEvent: meta.onEvent } : {}),
+    });
+    return true;
+}
+/**
+ * Pick the module extension for the running environment so a built app (`.js`) and a dev/ts app
+ * (`.ts`, run under a loader) never double-register the same workflow. We import only files whose
+ * extension matches `import.meta.url`'s own (`.ts` when running from source, `.js` from `dist`),
+ * which keeps scanner and `make:workflow` (it scaffolds `.ts`) in agreement under both setups.
+ */
+const MODULE_EXT = extname(import.meta.url || '') === '.ts' ? '.ts' : '.js';
+/**
+ * Scan a directory RECURSIVELY for modules and collect every exported `@Workflow`-decorated class
+ * (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 environment-appropriate extension is imported (see {@link MODULE_EXT}), 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).
+ */
+export async function discoverWorkflows(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { recursive: true });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+    const found = [];
+    const seen = new Set();
+    for (const entry of entries.sort()) {
+        if (extname(entry) !== MODULE_EXT || entry.endsWith(`.d${MODULE_EXT}`))
+            continue;
+        const mod = (await import(pathToFileURL(join(dir, entry)).href));
+        for (const exported of Object.values(mod)) {
+            if (seen.has(exported))
+                continue;
+            const meta = workflowMeta(exported);
+            if (!meta)
+                continue;
+            seen.add(exported);
+            found.push({ meta, cls: exported });
+        }
+    }
+    return found;
+}
+/**
+ * Discover every `@Workflow` class 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.
+ */
+export async function registerWorkflowsFromDir(engine, dir) {
+    const discovered = await discoverWorkflows(dir);
+    for (const { cls } of discovered)
+        registerWorkflowClass(engine, cls);
+    return discovered.map((d) => d.meta);
+}
+/**
+ * Register every `@Workflow` class reachable from a generated {@link WorkflowsBarrel}, by awaiting
+ * each lazy module import and registering each decorated export — the build-time equivalent of
+ * {@link registerWorkflowsFromDir}, with no runtime `readdir`. Each module is imported once and each
+ * decorated 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.
+ */
+export async function registerWorkflowsFromBarrel(engine, barrel) {
+    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);
+            registerWorkflowClass(engine, exported);
+            registered.push(meta);
+        }
+    }
+    return registered;
+}
+//# sourceMappingURL=workflow-discovery.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -6,11 +6,47 @@
  * string stays available for the cross-runtime case.
  */
 /**
- * The symbol the `@Workflow` decorator stamps a workflow's registered name onto, so a class ref can
- * be resolved back to its name. A global-registry symbol (`Symbol.for`) so it survives duplicate
+ * The symbol the `@Workflow` decorator stamps the full options onto (name + version + tags …), so
+ * auto-discovery can register the class against the engine and a class ref can be resolved back to
+ * its name via {@link workflowName}. A global-registry symbol (`Symbol.for`) so it survives duplicate
  * copies of this package in a dependency tree.
  */
-export declare const WORKFLOW_NAME_KEY: unique symbol;
+export declare const WORKFLOW_META_KEY: unique symbol;
+/** Options passed to `@Workflow({ name, version, … })`. */
+export interface WorkflowOptions {
+    /** The registered workflow name (the cross-runtime identity, e.g. `order`). */
+    name: string;
+    /** Workflow version. Defaults to `'1'`. Register a new version for a breaking change. */
+    version?: string;
+    /** Searchable labels merged onto every run of this workflow. */
+    tags?: string[];
+    /** Wall-clock budget for the whole run (a duration string like `'5m'`, or ms). */
+    executionTimeout?: string | number;
+    /** Event names that start a run of this workflow when published (see `onEvent`). */
+    onEvent?: string[];
+}
+/** The metadata the `@Workflow` decorator stamps onto a class for discovery + registration. */
+export interface WorkflowMeta extends WorkflowOptions {
+    version: string;
+}
+/**
+ * Class decorator marking a class as a durable workflow. Stamps the full options (name + version +
+ * tags …) so a class ref resolves via {@link workflowName} and the provider's `app/workflows`
+ * auto-discovery can register it on the engine — no manual `engine.register(...)`. The class must
+ * expose `run(ctx, input)`; that method becomes the workflow body.
+ *
+ * ```ts
+ * @Workflow({ name: 'order', version: '1' })
+ * export default class OrderWorkflow {
+ *   async run(ctx: WorkflowCtx, input: { id: string }) { ... }
+ * }
+ * ```
+ */
+export declare function Workflow(options: WorkflowOptions): <T extends abstract new (...args: never[]) => {
+    run(ctx: never, input: never): unknown;
+}>(target: T) => T;
+/** Read the {@link WorkflowMeta} a `@Workflow` decorator stamped on a class, or `undefined`. */
+export declare function workflowMeta(target: unknown): WorkflowMeta | undefined;
 /** Structural shape of a `@Workflow` class — its `run(ctx, input)` carries the input/output types. */
 export type WorkflowClass<TInput = unknown, TOutput = unknown> = abstract new (...args: never[]) => {
     run(ctx: never, input: TInput): Promise<TOutput> | TOutput;
@@ -27,8 +63,8 @@ export type WorkflowOutputOf<C> = C extends abstract new (...args: never[]) => {
 } ? Awaited<R> : unknown;
 /**
  * Resolve a {@link WorkflowRef} to its registered workflow name: a string is returned as-is; a
- * `@Workflow` class is resolved via the name the decorator stamped on it. Throws if a class was
- * never decorated (so it carries no registered name).
+ * `@Workflow` class is resolved via the name the decorator stamped in its metadata. Throws if a
+ * class was never decorated (so it carries no registered name).
  */
 export declare function workflowName(ref: WorkflowRef): string;
 //# sourceMappingURL=workflow-ref.d.ts.map

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":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAmD,CAAC;AAE3F,sGAAsG;AACtG,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,MACvE,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,yGAAyG;AACzG,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACvD,MAAM,GACN,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,uDAAuD;AACvD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MACjD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CAC1C,GACG,CAAC,GACD,OAAO,CAAC;AAEZ,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;CACxC,GACG,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASrD"}
+{"version":3,"file":"workflow-ref.d.ts","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAmD,CAAC;AAE3F,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,IACvC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK;IAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAA;CAAE,EAC7F,QAAQ,CAAC,KACR,CAAC,CASL;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAGtE;AAED,sGAAsG;AACtG,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,MACvE,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,yGAAyG;AACzG,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACvD,MAAM,GACN,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,uDAAuD;AACvD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MACjD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CAC1C,GACG,CAAC,GACD,OAAO,CAAC;AAEZ,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;CACxC,GACG,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASrD"}