@strands-agents/sdk 1.3.0 → 1.5.0

package/dist/src/middleware/__tests__/registry.test.js

@@ -0,0 +1,525 @@
+import { describe, expect, it } from 'vitest';
+import { MiddlewareRegistry, createStage } from '../index.js';
+import { CancelledError } from '../../errors.js';
+import { InterruptError, Interrupt } from '../../interrupt.js';
+import { collectGenerator } from '../../__fixtures__/model-test-helpers.js';
+async function collect(gen) {
+    const { items, result } = await collectGenerator(gen);
+    return { events: items, result };
+}
+const TestStage = createStage('test');
+describe('MiddlewareRegistry', () => {
+    describe('add', () => {
+        it('stores handlers in registration order', () => {
+            const registry = new MiddlewareRegistry();
+            const callOrder = [];
+            const handler1 = async function* (context, next) {
+                callOrder.push(1);
+                return yield* next(context);
+            };
+            const handler2 = async function* (context, next) {
+                callOrder.push(2);
+                return yield* next(context);
+            };
+            registry.add(TestStage, handler1);
+            registry.add(TestStage, handler2);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                callOrder.push(3);
+                return { output: 'done' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            // Execute the chain to verify order
+            const gen = chain({ value: 'test' });
+            return collect(gen).then(() => {
+                expect(callOrder).toStrictEqual([1, 2, 3]);
+            });
+        });
+    });
+    describe('compose', () => {
+        it('with no handlers returns terminal-equivalent function', async () => {
+            const registry = new MiddlewareRegistry();
+            const terminal = async function* (ctx) {
+                yield { data: `event-${ctx.value}` };
+                return { output: `result-${ctx.value}` };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { events, result } = await collect(chain({ value: 'hello' }));
+            expect(events).toStrictEqual([{ data: 'event-hello' }]);
+            expect(result).toStrictEqual({ output: 'result-hello' });
+        });
+        it('executes handlers in registration order (outermost first)', async () => {
+            const registry = new MiddlewareRegistry();
+            const callOrder = [];
+            const outer = async function* (context, next) {
+                callOrder.push('outer-before');
+                const result = yield* next(context);
+                callOrder.push('outer-after');
+                return result;
+            };
+            const inner = async function* (context, next) {
+                callOrder.push('inner-before');
+                const result = yield* next(context);
+                callOrder.push('inner-after');
+                return result;
+            };
+            registry.add(TestStage, outer);
+            registry.add(TestStage, inner);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                callOrder.push('terminal');
+                return { output: 'done' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await collect(chain({ value: 'test' }));
+            expect(callOrder).toStrictEqual(['outer-before', 'inner-before', 'terminal', 'inner-after', 'outer-after']);
+        });
+    });
+    describe('short-circuit behavior', () => {
+        it('does not call next handlers or terminal when middleware does not call next', async () => {
+            const registry = new MiddlewareRegistry();
+            let terminalCalled = false;
+            let innerCalled = false;
+            const shortCircuit = async function* () {
+                yield { data: 'synthetic' };
+                return { output: 'short-circuited' };
+            };
+            const inner = async function* (context, next) {
+                innerCalled = true;
+                return yield* next(context);
+            };
+            registry.add(TestStage, shortCircuit);
+            registry.add(TestStage, inner);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                terminalCalled = true;
+                return { output: 'terminal' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { events, result } = await collect(chain({ value: 'test' }));
+            expect(terminalCalled).toBe(false);
+            expect(innerCalled).toBe(false);
+            expect(events).toStrictEqual([{ data: 'synthetic' }]);
+            expect(result).toStrictEqual({ output: 'short-circuited' });
+        });
+    });
+    describe('event pass-through via yield* next(context)', () => {
+        it('forwards all events from terminal and returns terminal result', async () => {
+            const registry = new MiddlewareRegistry();
+            const passThrough = async function* (context, next) {
+                return yield* next(context);
+            };
+            registry.add(TestStage, passThrough);
+            const terminal = async function* () {
+                yield { data: 'event-1' };
+                yield { data: 'event-2' };
+                yield { data: 'event-3' };
+                return { output: 'terminal-result' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { events, result } = await collect(chain({ value: 'test' }));
+            expect(events).toStrictEqual([{ data: 'event-1' }, { data: 'event-2' }, { data: 'event-3' }]);
+            expect(result).toStrictEqual({ output: 'terminal-result' });
+        });
+    });
+    describe('event filtering via manual iteration', () => {
+        it('only yields events matching a predicate', async () => {
+            const registry = new MiddlewareRegistry();
+            const filter = async function* (context, next) {
+                const gen = next(context);
+                let iterResult = await gen.next();
+                while (!iterResult.done) {
+                    const event = iterResult.value;
+                    // Only forward events containing 'keep'
+                    if (event.data.includes('keep')) {
+                        yield event;
+                    }
+                    iterResult = await gen.next();
+                }
+                return iterResult.value;
+            };
+            registry.add(TestStage, filter);
+            const terminal = async function* () {
+                yield { data: 'keep-1' };
+                yield { data: 'drop-1' };
+                yield { data: 'keep-2' };
+                yield { data: 'drop-2' };
+                return { output: 'done' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { events, result } = await collect(chain({ value: 'test' }));
+            expect(events).toStrictEqual([{ data: 'keep-1' }, { data: 'keep-2' }]);
+            expect(result).toStrictEqual({ output: 'done' });
+        });
+    });
+    describe('context modification flows to terminal', () => {
+        it('terminal receives modified context', async () => {
+            const registry = new MiddlewareRegistry();
+            let receivedContext;
+            const modifier = async function* (context, next) {
+                const modified = { ...context, value: 'modified' };
+                return yield* next(modified);
+            };
+            registry.add(TestStage, modifier);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* (ctx) {
+                receivedContext = ctx;
+                return { output: ctx.value };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { result } = await collect(chain({ value: 'original' }));
+            expect(receivedContext).toStrictEqual({ value: 'modified' });
+            expect(result).toStrictEqual({ output: 'modified' });
+        });
+        it('each middleware can further modify context', async () => {
+            const registry = new MiddlewareRegistry();
+            let receivedContext;
+            const first = async function* (context, next) {
+                return yield* next({ ...context, value: context.value + '-first' });
+            };
+            const second = async function* (context, next) {
+                return yield* next({ ...context, value: context.value + '-second' });
+            };
+            registry.add(TestStage, first);
+            registry.add(TestStage, second);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* (ctx) {
+                receivedContext = ctx;
+                return { output: ctx.value };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { result } = await collect(chain({ value: 'start' }));
+            expect(receivedContext).toStrictEqual({ value: 'start-first-second' });
+            expect(result).toStrictEqual({ output: 'start-first-second' });
+        });
+    });
+    describe('error propagation through chain', () => {
+        it('errors from terminal reach middleware', async () => {
+            const registry = new MiddlewareRegistry();
+            let caughtError;
+            const catcher = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                catch (error) {
+                    caughtError = error;
+                    return { output: 'recovered' };
+                }
+            };
+            registry.add(TestStage, catcher);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new Error('terminal error');
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const { result } = await collect(chain({ value: 'test' }));
+            expect(caughtError).toBeInstanceOf(Error);
+            expect(caughtError.message).toBe('terminal error');
+            expect(result).toStrictEqual({ output: 'recovered' });
+        });
+        it('errors from middleware reach caller', async () => {
+            const registry = new MiddlewareRegistry();
+            // eslint-disable-next-line require-yield
+            const thrower = async function* () {
+                throw new Error('middleware error');
+            };
+            registry.add(TestStage, thrower);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                return { output: 'done' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow('middleware error');
+        });
+        it('middleware can transform errors from next', async () => {
+            const registry = new MiddlewareRegistry();
+            const transformer = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                catch {
+                    throw new Error('transformed error');
+                }
+            };
+            registry.add(TestStage, transformer);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new Error('original error');
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow('transformed error');
+        });
+    });
+    describe('CancelledError and InterruptError propagation', () => {
+        it('CancelledError propagates without being swallowed', async () => {
+            const registry = new MiddlewareRegistry();
+            const passThrough = async function* (context, next) {
+                return yield* next(context);
+            };
+            registry.add(TestStage, passThrough);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new CancelledError();
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow(CancelledError);
+        });
+        it('InterruptError propagates without being swallowed', async () => {
+            const registry = new MiddlewareRegistry();
+            const passThrough = async function* (context, next) {
+                return yield* next(context);
+            };
+            registry.add(TestStage, passThrough);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new InterruptError(new Interrupt({ id: 'int-1', name: 'test_interrupt' }));
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow(InterruptError);
+        });
+        it('CancelledError propagates through multiple middleware layers', async () => {
+            const registry = new MiddlewareRegistry();
+            const outer = async function* (context, next) {
+                return yield* next(context);
+            };
+            const inner = async function* (context, next) {
+                return yield* next(context);
+            };
+            registry.add(TestStage, outer);
+            registry.add(TestStage, inner);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new CancelledError();
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow(CancelledError);
+        });
+        it('InterruptError propagates through multiple middleware layers', async () => {
+            const registry = new MiddlewareRegistry();
+            const outer = async function* (context, next) {
+                return yield* next(context);
+            };
+            const inner = async function* (context, next) {
+                return yield* next(context);
+            };
+            registry.add(TestStage, outer);
+            registry.add(TestStage, inner);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new InterruptError(new Interrupt({ id: 'int-1', name: 'test_interrupt' }));
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow(InterruptError);
+        });
+    });
+    describe('try-finally guarantees', () => {
+        it('outer finally runs when inner middleware throws', async () => {
+            const registry = new MiddlewareRegistry();
+            const order = [];
+            const outer = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('outer-finally');
+                }
+            };
+            // eslint-disable-next-line require-yield
+            const inner = async function* () {
+                order.push('inner-throw');
+                throw new Error('inner exploded');
+            };
+            registry.add(TestStage, outer);
+            registry.add(TestStage, inner);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                return { output: 'unreachable' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow('inner exploded');
+            expect(order).toStrictEqual(['inner-throw', 'outer-finally']);
+        });
+        it('inner finally runs when terminal throws', async () => {
+            const registry = new MiddlewareRegistry();
+            const order = [];
+            const outer = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('outer-finally');
+                }
+            };
+            const inner = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('inner-finally');
+                }
+            };
+            registry.add(TestStage, outer);
+            registry.add(TestStage, inner);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                order.push('terminal-throw');
+                throw new Error('terminal exploded');
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow('terminal exploded');
+            expect(order).toStrictEqual(['terminal-throw', 'inner-finally', 'outer-finally']);
+        });
+        it('all finally blocks run in reverse order when terminal throws', async () => {
+            const registry = new MiddlewareRegistry();
+            const order = [];
+            const a = async function* (context, next) {
+                try {
+                    order.push('a-enter');
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('a-finally');
+                }
+            };
+            const b = async function* (context, next) {
+                try {
+                    order.push('b-enter');
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('b-finally');
+                }
+            };
+            const c = async function* (context, next) {
+                try {
+                    order.push('c-enter');
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('c-finally');
+                }
+            };
+            registry.add(TestStage, a);
+            registry.add(TestStage, b);
+            registry.add(TestStage, c);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                throw new Error('boom');
+            };
+            const chain = registry.compose(TestStage, terminal);
+            await expect(collect(chain({ value: 'test' }))).rejects.toThrow('boom');
+            expect(order).toStrictEqual(['a-enter', 'b-enter', 'c-enter', 'c-finally', 'b-finally', 'a-finally']);
+        });
+        it('finally runs even when caller abandons the generator mid-stream', async () => {
+            const registry = new MiddlewareRegistry();
+            const order = [];
+            const middleware = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('middleware-finally');
+                }
+            };
+            registry.add(TestStage, middleware);
+            const terminal = async function* () {
+                yield { data: 'event-1' };
+                yield { data: 'event-2' };
+                yield { data: 'event-3' };
+                return { output: 'done' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const gen = chain({ value: 'test' });
+            // Only consume one event then abandon (call return to close the generator)
+            await gen.next();
+            await gen.return({ output: 'abandoned' });
+            expect(order).toStrictEqual(['middleware-finally']);
+        });
+        it('finally runs in both middleware when caller abandons mid-stream', async () => {
+            const registry = new MiddlewareRegistry();
+            const order = [];
+            const outer = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('outer-finally');
+                }
+            };
+            const inner = async function* (context, next) {
+                try {
+                    return yield* next(context);
+                }
+                finally {
+                    order.push('inner-finally');
+                }
+            };
+            registry.add(TestStage, outer);
+            registry.add(TestStage, inner);
+            const terminal = async function* () {
+                yield { data: 'event-1' };
+                yield { data: 'event-2' };
+                return { output: 'done' };
+            };
+            const chain = registry.compose(TestStage, terminal);
+            const gen = chain({ value: 'test' });
+            await gen.next();
+            await gen.return({ output: 'abandoned' });
+            expect(order).toStrictEqual(['inner-finally', 'outer-finally']);
+        });
+    });
+    describe('remove', () => {
+        it('removes a handler so it no longer runs', async () => {
+            const registry = new MiddlewareRegistry();
+            const callOrder = [];
+            const handler = async function* (context, next) {
+                callOrder.push(1);
+                return yield* next(context);
+            };
+            registry.add(TestStage, handler);
+            registry.remove(TestStage, handler);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                callOrder.push(2);
+                return { output: 'done' };
+            };
+            await collect(registry.invoke(TestStage, { value: 'test' }, terminal));
+            expect(callOrder).toStrictEqual([2]);
+        });
+        it('only removes the first occurrence of a duplicate handler', async () => {
+            const registry = new MiddlewareRegistry();
+            let callCount = 0;
+            const handler = async function* (context, next) {
+                callCount++;
+                return yield* next(context);
+            };
+            registry.add(TestStage, handler);
+            registry.add(TestStage, handler);
+            registry.remove(TestStage, handler);
+            // eslint-disable-next-line require-yield
+            const terminal = async function* () {
+                return { output: 'done' };
+            };
+            await collect(registry.invoke(TestStage, { value: 'test' }, terminal));
+            expect(callCount).toBe(1);
+        });
+        it('is a no-op when handler was never registered', async () => {
+            const registry = new MiddlewareRegistry();
+            const handler = async function* (context, next) {
+                return yield* next(context);
+            };
+            // Should not throw
+            registry.remove(TestStage, handler);
+        });
+        it('is a no-op when stage has no handlers', () => {
+            const registry = new MiddlewareRegistry();
+            const OtherStage = createStage('other');
+            const handler = async function* (context, next) {
+                return yield* next(context);
+            };
+            // Should not throw
+            registry.remove(OtherStage, handler);
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/src/middleware/__tests__/registry.test.js.map

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

package/dist/src/middleware/index.d.ts

@@ -0,0 +1,5 @@
+export type { MiddlewareStage, MiddlewareNext, MiddlewareHandler, MiddlewareHandlerOf, MiddlewareNextOf, MiddlewareInputHandler, MiddlewareOutputHandler, MiddlewareInputPhase, MiddlewareWrapPhase, MiddlewareOutputPhase, MiddlewarePhase, MiddlewarePhaseKind, } from './types.js';
+export { createStage, InvokeModelStage, ExecuteToolStage, AgentStreamStage } from './stages.js';
+export type { InvokeModelContext, InvokeModelResult, ExecuteToolContext, ExecuteToolResult, AgentStreamContext, AgentStreamResult, MiddlewareInterruptResult, MiddlewareInterruptible, } from './stages.js';
+export { MiddlewareRegistry } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC/F,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/middleware/index.js

@@ -0,0 +1,3 @@
+export { createStage, InvokeModelStage, ExecuteToolStage, AgentStreamStage } from './stages.js';
+export { MiddlewareRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/src/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAW/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/middleware/registry.d.ts

@@ -0,0 +1,58 @@
+import type { MiddlewareStage, MiddlewareHandler, MiddlewareNext, MiddlewareInputPhase, MiddlewareOutputPhase, MiddlewareInputHandler, MiddlewareOutputHandler } from './types.js';
+/**
+ * Registry that stores middleware handlers keyed by stage tokens
+ * and composes them into execution chains with phase ordering.
+ */
+export declare class MiddlewareRegistry {
+    private readonly _handlers;
+    constructor();
+    /**
+     * Register a middleware handler for a given stage (Wrap phase).
+     * Handlers are stored in registration order within their phase.
+     *
+     * @param stage - The stage token to register the handler for
+     * @param handler - The middleware handler function
+     */
+    add<TContext, TResult, TEvent>(stage: MiddlewareStage<TContext, TResult, TEvent>, handler: MiddlewareHandler<TContext, TResult, TEvent>): void;
+    /**
+     * Register an Input phase handler. Transforms context before the Wrap chain runs.
+     * Multiple Input handlers compose in registration order (each sees the previous handler's output).
+     * Returns the adapted handler for cleanup purposes.
+     */
+    addInput<TContext, TResult, TEvent>(phase: MiddlewareInputPhase<TContext, TResult, TEvent>, handler: MiddlewareInputHandler<TContext>): MiddlewareHandler<TContext, TResult, TEvent>;
+    /**
+     * Register an Output phase handler. Transforms result after the Wrap chain completes.
+     * Multiple Output handlers compose in registration order (each sees the previous handler's output).
+     * Returns the adapted handler for cleanup purposes.
+     */
+    addOutput<TContext, TResult, TEvent>(phase: MiddlewareOutputPhase<TContext, TResult, TEvent>, handler: MiddlewareOutputHandler<TResult>): MiddlewareHandler<TContext, TResult, TEvent>;
+    /**
+     * Remove a previously registered middleware handler for a given stage.
+     * Removes the first occurrence of the handler (by reference equality on the adapted handler).
+     *
+     * @param stage - The stage token to remove the handler from
+     * @param handler - The middleware handler function to remove
+     */
+    remove<TContext, TResult, TEvent>(stage: MiddlewareStage<TContext, TResult, TEvent>, handler: MiddlewareHandler<TContext, TResult, TEvent>): void;
+    /**
+     * Compose all registered handlers for a stage into a single middleware chain.
+     * Handlers are ordered by phase (input → output → wrap), then by registration order within phase.
+     * First in the composed chain = outermost.
+     *
+     * @param stage - The stage token to compose handlers for
+     * @param terminal - The innermost function that performs actual stage execution
+     * @returns A single function representing the full middleware chain
+     */
+    compose<TContext, TResult, TEvent>(stage: MiddlewareStage<TContext, TResult, TEvent>, terminal: MiddlewareNext<TContext, TResult, TEvent>): MiddlewareNext<TContext, TResult, TEvent>;
+    /**
+     * Compose and invoke the middleware chain for a stage in one call.
+     * Equivalent to `compose(stage, terminal)(context)` but reads more clearly at call sites.
+     *
+     * @param stage - The stage token to invoke
+     * @param context - The context to pass into the chain
+     * @param terminal - The innermost function that performs actual stage execution
+     * @returns An async generator yielding events and returning the stage result
+     */
+    invoke<TContext, TResult, TEvent>(stage: MiddlewareStage<TContext, TResult, TEvent>, context: TContext, terminal: MiddlewareNext<TContext, TResult, TEvent>): AsyncGenerator<TEvent, TResult, undefined>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/middleware/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/middleware/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EAEd,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAWnB;;;GAGG;AACH,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqE;;IAM/F;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAC3B,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EACjD,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GACpD,IAAI;IAMP;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAChC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EACtD,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC,GACxC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IAY/C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EACjC,KAAK,EAAE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EACvD,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GACxC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IAY/C;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAC9B,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EACjD,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GACpD,IAAI;IAOP;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAC/B,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EACjD,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GAClD,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;IAgB5C;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAC9B,KAAK,EAAE,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EACjD,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GAClD,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;CAI9C"}