@lostgradient/weft 0.11.0 → 0.12.0

package/dist/server/index.d.ts

@@ -4,6 +4,7 @@
  *
  * @module server
  */
+import type { RegistryAgnosticEngine } from '../core/engine.ts';
 import type { RetryPolicy } from '../core/types.ts';
 import type { PrometheusExporter } from '../observability/metrics.ts';
 import type { RoutingPolicy } from '../worker/registry.ts';
@@ -111,7 +112,17 @@ export type UnauthenticatedAccessPolicy = 'warn' | 'allow' | 'reject';
  * ```
  */
 export interface ServeOptions {
-    engine: import('../core/engine.ts').Engine;
+    /**
+     * The engine `serve()` hosts. Typed as {@link RegistryAgnosticEngine}
+     * (see its JSDoc) rather than the plain default `Engine`, so both
+     * documented construction patterns type-check: `new Engine({ storage })`
+     * (registry inferred as the default, empty registry) and
+     * `Engine.create({ workflows })` (registry narrowed to the concrete
+     * workflow map). `serve()` never calls registry-typed methods
+     * (`register`, `start`, etc.) on this value — only registry-erased ones
+     * (`storage`, event listening, `dispatchEvent`). See #708.
+     */
+    engine: RegistryAgnosticEngine;
     port?: number;
     hostname?: string;
     /** Enable Bun's development mode (HMR, source maps, detailed errors). */