@pogodisco/zephyr 1.3.12 → 1.3.14

package/dist/registry.d.ts

@@ -1,13 +1,14 @@
 import { ActionRegistry, MergeActionRegistries } from "./types.js";
-export declare class ActionRegistryBuilder<R extends ActionRegistry = {}> {
+export declare class ActionRegistryBuilder<R extends ActionRegistry = {}, Prefix extends string = ""> {
+    private prefix;
     private registry;
-    constructor(initial?: R);
+    constructor(prefix: Prefix, initial?: R);
     /**
      * Accepts ANY function - sync or async, any parameter shape
      * F captures the complete function signature for full type inference
      */
-    action<K extends string, F extends (...args: any[]) => any>(key: K, action: F): ActionRegistryBuilder<MergeActionRegistries<R, Record<K, F>>>;
-    extend<Other extends ActionRegistry>(other: ActionRegistryBuilder<Other> | Other): ActionRegistryBuilder<MergeActionRegistries<R, Other>>;
+    action<K extends string, F extends (...args: any[]) => any>(key: K, action: F): ActionRegistryBuilder<MergeActionRegistries<R, Record<`${Prefix}${K}`, F>>, Prefix>;
+    extend<Other extends ActionRegistry>(other: ActionRegistryBuilder<Other, any> | Other): ActionRegistryBuilder<MergeActionRegistries<R, Other>, Prefix>;
     build(): R;
 }
-export declare function createActionRegistry<R extends ActionRegistry = {}>(initial?: R): ActionRegistryBuilder<R>;
+export declare function createActionRegistry<R extends ActionRegistry = {}, Prefix extends string = "">(prefix: Prefix, initial?: R): ActionRegistryBuilder<R, Prefix>;

package/dist/registry.js

@@ -1,5 +1,6 @@
 export class ActionRegistryBuilder {
-    constructor(initial) {
+    constructor(prefix, initial) {
+        this.prefix = prefix;
         this.registry = {};
         if (initial) {
             this.registry = { ...initial };
@@ -10,12 +11,21 @@ export class ActionRegistryBuilder {
      * F captures the complete function signature for full type inference
      */
     action(key, action) {
-        this.registry[key] = action;
+        const fullKey = `${this.prefix}${key}`;
+        if (fullKey in this.registry) {
+            throw new Error(`Action "${fullKey}" already exists`);
+        }
+        this.registry[fullKey] = action;
         return this;
     }
     // Extend with another registry (with override)
     extend(other) {
         const otherRegistry = other instanceof ActionRegistryBuilder ? other.build() : other;
+        for (const key in otherRegistry) {
+            if (key in this.registry) {
+                throw new Error(`Action collision detected "${key}"`);
+            }
+        }
         Object.assign(this.registry, otherRegistry);
         return this;
     }
@@ -23,6 +33,9 @@ export class ActionRegistryBuilder {
         return this.registry;
     }
 }
-export function createActionRegistry(initial) {
-    return new ActionRegistryBuilder(initial);
+export function createActionRegistry(prefix, initial) {
+    if (!prefix || typeof prefix !== "string" || prefix?.trim() === "") {
+        throw new Error(`Registry prefix is required`);
+    }
+    return new ActionRegistryBuilder(prefix, initial);
 }

package/dist/session.d.ts

@@ -1,25 +1,20 @@
 import { ActionRegistry, WorkflowObserver } from "./types.js";
-import { WorkflowDef } from "./workflow-composer.js";
-type ModuleFlows<Reg extends ActionRegistry> = Record<string, WorkflowDef<Reg, any, any>>;
-export declare class WorkflowSession<Reg extends ActionRegistry, State extends Record<string, any>> {
-    private registry;
+export declare class WorkflowSession<Reg extends ActionRegistry, Ctx> {
+    runtime: {
+        run: any;
+        getContext: () => Ctx;
+    };
     private subscribers;
     private running;
     private queue;
-    state: State;
     observers: WorkflowObserver[];
-    private moduleFlows;
-    /**
-     * @param baseModule Module to extend (inherits workflows)
-     * @param registry Action registry
-     * @param initialContext Initial context (session state) — will be mutated in workflows
-     */
-    constructor(baseModule: ModuleFlows<Reg>, registry: Reg, initialContext: State, observers: WorkflowObserver[]);
-    getState(): State;
-    subscribe(fn: (state: Partial<State>) => void): () => boolean;
+    constructor(runtime: {
+        run: any;
+        getContext: () => Ctx;
+    });
+    subscribe(fn: (state: Partial<Ctx>) => void): () => boolean;
     private notify;
     /** Queue a workflow execution by key and input; state/context is automatically updated */
-    dispatch(key: keyof ModuleFlows<Reg>, input?: any): void;
+    dispatch(workflow: any, input: any): void;
     private processQueue;
 }
-export {};

package/dist/session.js

@@ -1,56 +1,32 @@
-import { executeWorkflow } from "./workflow-executor.js";
-import { createModule } from "./workflow-module.js";
 export class WorkflowSession {
-    /**
-     * @param baseModule Module to extend (inherits workflows)
-     * @param registry Action registry
-     * @param initialContext Initial context (session state) — will be mutated in workflows
-     */
-    constructor(baseModule, registry, initialContext, observers) {
-        this.registry = registry;
+    constructor(runtime) {
+        this.runtime = runtime;
         this.subscribers = new Set();
         this.running = false;
         this.queue = [];
+        // public state: State; // session state & workflow context are the same object
         this.observers = [];
-        // Use the same object for session state and module context
-        this.state = initialContext;
-        this.observers = observers;
-        // Per-session module: inherits workflows, shares the same state/context object
-        this.moduleFlows = createModule({
-            registry: this.registry,
-            context: this.state,
-            use: [baseModule],
-            define: () => ({}), // no new flows needed
-        });
-    }
-    getState() {
-        return this.state;
     }
     subscribe(fn) {
         this.subscribers.add(fn);
-        fn(this.state); // immediately notify
+        fn(this.runtime.getContext()); // immediately notify
         return () => this.subscribers.delete(fn);
     }
     notify() {
         for (const fn of this.subscribers)
-            fn(this.state);
+            fn(this.runtime.getContext());
     }
     /** Queue a workflow execution by key and input; state/context is automatically updated */
-    dispatch(key, input = {}) {
-        this.queue.push({ key, input });
+    dispatch(workflow, input) {
+        this.queue.push({ workflow, input });
         if (!this.running)
             this.processQueue();
     }
     async processQueue() {
         this.running = true;
         while (this.queue.length) {
-            const { key, input } = this.queue.shift();
-            const workflow = this.moduleFlows[key];
-            if (!workflow)
-                throw new Error(`Workflow ${String(key)} not found`);
-            // state/context already lives on the module; no need to pass a separate context
-            await executeWorkflow(workflow, this.registry, input, this.observers);
-            // Notify subscribers after workflow mutates state
+            const { workflow, input } = this.queue.shift();
+            await this.runtime.run(workflow, input);
             this.notify();
         }
         this.running = false;

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-import { createWorkflow } from "./workflow-composer.js";
 export type Action<F extends (...args: any[]) => any = (...args: any[]) => any> = F;
 export type ActionRegistry = Record<string, (...args: any[]) => any>;
 export type MergeActionRegistries<A extends ActionRegistry, B extends ActionRegistry> = Simplify<Omit<A, keyof B> & B>;
@@ -27,4 +26,3 @@ export type WorkflowObserver<Reg extends ActionRegistry = any> = {
         frame: ExecutionFrame;
     }, next: () => Promise<any>): Promise<any>;
 };
-export type WF<Reg extends ActionRegistry, Context extends Record<string, any>> = ReturnType<typeof createWorkflow<Reg, Context>>;

package/dist/utils.d.ts

@@ -1,5 +1,3 @@
-import { ActionRegistry } from "./types.js";
-import { WorkflowDef } from "./workflow-composer.js";
 type AnyFn = (...args: any[]) => any;
 /**
  * For generic actions - preserves the generic parameter
@@ -9,20 +7,4 @@ export declare function genericAction<F extends AnyFn>(fn: F): <T>() => ((...arg
  * For fixed actions
  */
 export declare function fixedAction<F extends AnyFn>(fn: F): () => ((...args: Parameters<F>) => ReturnType<F>);
-export declare function createRunner<Reg extends ActionRegistry>(registry: Reg): <W extends WorkflowDef<Reg, any, any, any, any>>(workflow: W, input: W extends WorkflowDef<Reg, infer I, any, any, any> ? I : never, observers?: any[]) => Promise<{
-    output: W extends WorkflowDef<Reg, any, any, any, infer O> ? O : never;
-    results: W extends WorkflowDef<Reg, any, infer R, any, any> ? R : never;
-    extras: Record<string, any>;
-}>;
-/**
- * Create a typed runner for a specific module
- * @example
- * const run = createModuleRunner(modWithLoop, regOne);
- * const result = await run("loopWorkflow", { items: ["APPLE"] });
- */
-export declare function createModuleRunner<M extends Record<string, WorkflowDef<any, any, any, any, any>>, Reg extends ActionRegistry>(module: M, registry: Reg): <K extends keyof M>(key: K, input: M[K] extends WorkflowDef<Reg, infer I, any, any, any> ? I : never, observers?: any[]) => Promise<{
-    output: M[K] extends WorkflowDef<Reg, any, any, any, infer O> ? O : never;
-    results: M[K] extends WorkflowDef<Reg, any, infer R, any, any> ? R : never;
-    extras: Record<string, any>;
-}>;
 export {};

package/dist/utils.js

@@ -1,4 +1,3 @@
-import { executeWorkflow } from "./workflow-executor.js";
 /**
  * For generic actions - preserves the generic parameter
  */
@@ -16,20 +15,21 @@ export function fixedAction(fn) {
         return fn;
     };
 }
-export function createRunner(registry) {
-    return async (workflow, input, observers) => {
-        return executeWorkflow(workflow, registry, input, observers ?? []);
-    };
-}
-/**
- * Create a typed runner for a specific module
- * @example
- * const run = createModuleRunner(modWithLoop, regOne);
- * const result = await run("loopWorkflow", { items: ["APPLE"] });
- */
-export function createModuleRunner(module, registry) {
-    return async (key, input, observers) => {
-        const workflow = module[key];
-        return executeWorkflow(workflow, registry, input, observers ?? []);
-    };
-}
+// export function createRuntime<Reg extends ActionRegistry, Context>(
+//   registry: Reg,
+//   context: Context,
+// ) {
+//   return {
+//     run: async <W extends WorkflowDef<Reg, any, any, any, any>>(
+//       workflow: W,
+//       input: W extends WorkflowDef<Reg, infer I, any, any, any> ? I : never,
+//       observers?: WorkflowObserver[],
+//     ): Promise<{
+//       output: W extends WorkflowDef<Reg, any, any, any, infer O> ? O : never;
+//       results: W extends WorkflowDef<Reg, any, infer R, any, any> ? R : never;
+//       extras: Record<string, any>;
+//     }> => {
+//       return executeWorkflow(workflow, registry, input, context, observers);
+//     },
+//   };
+// }

package/dist/workflow-composer.d.ts

@@ -58,7 +58,6 @@ export type WorkflowDef<Reg extends ActionRegistry, Input, Results, Steps extend
     input: Input;
     results: Results;
     outputResolver?: (ctx: any) => Output;
-    __context?: any;
 };
 type StepRuntimeCtx<I, R, C> = {
     input: I;
@@ -79,16 +78,14 @@ type MergeBranchSteps<Branches extends readonly any[], Acc extends any[]> = Bran
     ...Acc,
     ...(Head extends WorkflowBuilder<any, any, any, infer S, any> ? S : [])
 ]> : Acc;
-export declare class WorkflowBuilder<Reg extends ActionRegistry, Input = unknown, Context extends Record<string, any> = {}, Steps extends StepDef<Reg, any, any>[] = [], Results = {}, Output = undefined> {
+export declare class WorkflowBuilder<Reg extends ActionRegistry, Input = unknown, Context = unknown, Steps extends StepDef<Reg, any, any>[] = [], Results = {}, Output = undefined> {
     private name;
-    private registry;
-    private context;
     private steps;
     private frontier;
     private pendingWhen?;
     private outputResolver?;
     private clearPendingWhen;
-    constructor(name: string, registry: Reg, context: Context);
+    constructor(name: string);
     step<ID extends string, ActionName extends keyof Reg & string, ResolveOut extends ResolvedStepInput = ResolvedStepInput>(id: ID, action: ActionName, resolve?: (ctx: {
         input: Input;
         results: Results;
@@ -144,5 +141,5 @@ export declare class WorkflowBuilder<Reg extends ActionRegistry, Input = unknown
     private validateDependencies;
     private getEndSteps;
 }
-export declare function createWorkflow<Reg extends ActionRegistry, Context extends Record<string, any> = {}>(registry: Reg, context?: Context): <Input = unknown>(name: string) => WorkflowBuilder<Reg, Input, Context, [], {}, undefined>;
+export declare function createWorkflow<Reg extends ActionRegistry, Context extends Record<string, any> = {}>(): <Input = unknown>(name: string) => WorkflowBuilder<Reg, Input, Context, [], {}, undefined>;
 export {};

package/dist/workflow-composer.js

@@ -5,10 +5,8 @@ export class WorkflowBuilder {
     clearPendingWhen() {
         this.pendingWhen = undefined;
     }
-    constructor(name, registry, context) {
+    constructor(name) {
         this.name = name;
-        this.registry = registry;
-        this.context = context;
         this.steps = [];
         this.frontier = [];
     }
@@ -37,64 +35,11 @@ export class WorkflowBuilder {
     as() {
         return this;
     }
-    // parallel<Branches extends WorkflowBuilder<Reg, Input, Context, any, any>[]>(
-    //   ...branches: {
-    //     [K in keyof Branches]: (
-    //       builder: WorkflowBuilder<Reg, Input, Context, [], Results>,
-    //     ) => Branches[K];
-    //   }
-    // ): WorkflowBuilder<
-    //   Reg,
-    //   Input,
-    //   Context,
-    //   [
-    //     ...Steps,
-    //     ...(Branches[number] extends WorkflowBuilder<Reg, any, any, infer S, any>
-    //       ? S
-    //       : never),
-    //   ],
-    //   Simplify<
-    //     Results &
-    //       UnionToIntersection<
-    //         {
-    //           [K in keyof Branches]: Branches[K] extends WorkflowBuilder<
-    //             Reg,
-    //             any,
-    //             any,
-    //             any,
-    //             infer R
-    //           >
-    //             ? R
-    //             : never;
-    //         }[number]
-    //       >
-    //   >
-    // > {
-    //   const parentFrontier = [...this.frontier];
-    //   const branchEnds: string[] = [];
-    //
-    //   branches.forEach((branch) => {
-    //     const b = new WorkflowBuilder<Reg, Input, Context, [], Results>(
-    //       this.name,
-    //       this.registry,
-    //       this.context,
-    //     );
-    //
-    //     b.frontier = parentFrontier;
-    //     branch(b);
-    //     branchEnds.push(...b.frontier);
-    //     this.steps.push(...(b as any).steps);
-    //   });
-    //
-    //   this.frontier = branchEnds;
-    //   this.clearPendingWhen();
-    //   return this as any;
-    // }
     parallel(...branches) {
         const parentFrontier = [...this.frontier];
         const branchEnds = [];
         branches.forEach((branch) => {
-            const b = new WorkflowBuilder(this.name, this.registry, this.context);
+            const b = new WorkflowBuilder(this.name);
             b.frontier = parentFrontier;
             branch(b);
             branchEnds.push(...b.frontier);
@@ -170,7 +115,6 @@ export class WorkflowBuilder {
             input: {},
             results: {},
             outputResolver: this.outputResolver,
-            __context: this.context,
         };
     }
     validateDependencies() {
@@ -194,8 +138,16 @@ export class WorkflowBuilder {
 /* ------------------------------------------------ */
 /* WORKFLOW CREATOR                                 */
 /* ------------------------------------------------ */
-export function createWorkflow(registry, context) {
+// export function createWorkflow<
+//   Reg extends ActionRegistry,
+//   Context extends Record<string, any> = {},
+// >(registry: Reg, context?: Context) {
+//   return function workflow<Input = unknown>(name: string) {
+//     return new WorkflowBuilder<Reg, Input, Context>(name);
+//   };
+// }
+export function createWorkflow() {
     return function workflow(name) {
-        return new WorkflowBuilder(name, registry, context || {});
+        return new WorkflowBuilder(name);
     };
 }

package/dist/workflow-executor.d.ts

@@ -1,6 +1,6 @@
 import { ActionRegistry, WorkflowObserver } from "./types.js";
 import { StepDef, WorkflowDef } from "./workflow-composer.js";
-export declare function executeWorkflow<Reg extends ActionRegistry, I, R, O = R, Steps extends StepDef<Reg, any, any>[] = StepDef<Reg, any, any>[]>(workflow: WorkflowDef<Reg, I, R, Steps, O>, registry: Reg, input: I, observers?: WorkflowObserver<Reg>[]): Promise<{
+export declare function executeWorkflow<Reg extends ActionRegistry, I, R, O = R, Steps extends StepDef<Reg, any, any>[] = StepDef<Reg, any, any>[]>(workflow: WorkflowDef<Reg, I, R, Steps, O>, registry: Reg, input: I, context: any, observers?: WorkflowObserver<Reg>[]): Promise<{
     results: R;
     output: O;
     extras: Record<string, any>;

package/dist/workflow-executor.js

@@ -39,7 +39,7 @@ async function runWithRetry(actionFn, stepOptions) {
     }
     throw lastError;
 }
-export async function executeWorkflow(workflow, registry, input, observers = []) {
+export async function executeWorkflow(workflow, registry, input, context, observers = []) {
     const results = {};
     const extras = {};
     extras.frames = {};
@@ -93,7 +93,6 @@ export async function executeWorkflow(workflow, registry, input, observers = [])
                 start: Date.now(),
             };
             extras.frames[stepId] = frame;
-            const context = workflow.__context;
             const ctx = {
                 stepId,
                 input,

package/dist/workflow-module.d.ts

@@ -1,10 +1,34 @@
-import { ActionRegistry, Simplify } from "./types.js";
+import { ActionRegistry, WorkflowObserver } from "./types.js";
 import { createWorkflow, WorkflowDef } from "./workflow-composer.js";
 type AnyWorkflow = WorkflowDef<any, any, any, any, any>;
+type WorkflowFromDeps<Deps extends Record<string, any>> = {
+    [K in keyof Deps]: Deps[K] extends Module<any, any, infer Own, infer SubDeps> ? Own[keyof Own] | WorkflowFromDeps<SubDeps> : never;
+}[keyof Deps];
 type ModuleShape = Record<string, AnyWorkflow>;
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-type UnionToIntersectionOrEmpty<U> = [U] extends [never] ? {} : UnionToIntersection<U>;
-export type ModuleContext<Reg extends ActionRegistry, Context extends Record<string, any>, Deps extends ModuleShape> = {
+type ContextFromDeps<Deps> = [keyof Deps] extends [never] ? {} : {
+    [K in keyof Deps]: Deps[K] extends Module<any, infer Ctx, any, any> ? Ctx : never;
+}[keyof Deps];
+type FinalContext<Reg extends ActionRegistry, Context extends Record<string, any>, Deps extends ModuleMap<Reg>> = Context & ContextFromDeps<Deps>;
+type ModuleMap<Reg extends ActionRegistry> = Record<string, Module<Reg, any, any, any>>;
+export type WorkflowInput<W> = W extends WorkflowDef<any, infer I, any, any, any> ? I : never;
+export type WorkflowResults<W> = W extends WorkflowDef<any, any, infer R, any, any> ? R : never;
+export type WorkflowOutput<W> = W extends WorkflowDef<any, any, any, any, infer O> ? O : never;
+type Module<Reg extends ActionRegistry, Context extends Record<string, any>, Own extends ModuleShape = {}, Deps extends ModuleMap<Reg> = {}> = {
+    own: Own;
+    deps: Deps;
+    createRuntime: (config: {
+        registry: Reg;
+        context: FinalContext<Reg, Context, Deps>;
+    }) => {
+        run: <W extends Own[keyof Own] | WorkflowFromDeps<Deps>>(workflow: W, input: WorkflowInput<W>, obververs?: WorkflowObserver<Reg>[]) => Promise<{
+            results: WorkflowResults<W>;
+            output: WorkflowOutput<W>;
+            extras: Record<string, any>;
+        }>;
+        getContext: () => FinalContext<Reg, Context, Deps>;
+    };
+};
+export type ModuleContext<Reg extends ActionRegistry, Context extends Record<string, any>, Deps extends ModuleMap<Reg>> = {
     wf: ReturnType<typeof createWorkflow<Reg, Context>>;
     deps: Deps;
     context: Context;
@@ -14,12 +38,8 @@ export type ModuleContext<Reg extends ActionRegistry, Context extends Record<str
         context: Context;
     }) => T) => T;
 };
-export declare function createModule<Reg extends ActionRegistry, Context extends Record<string, any>, Use extends ModuleShape[] = [], Deps extends ModuleShape = Simplify<{
-    [K in keyof UnionToIntersectionOrEmpty<Use[number]>]: AnyWorkflow;
-}>, Own extends ModuleShape = {}>({ registry, context, use, define, }: {
-    registry: Reg;
-    context: Context;
-    use?: [...Use];
-    define: (ctx: ModuleContext<Reg, Context, Deps>) => Own;
-}): Deps & Own;
+export declare function createModuleFactory<Reg extends ActionRegistry, Context extends Record<string, any>>(): <Use extends ModuleMap<Reg> = {}, Own extends ModuleShape = {}>(config: {
+    use?: Use;
+    define: (ctx: ModuleContext<Reg, Context, Use>) => Own;
+}) => Module<Reg, Context, Own, Use>;
 export {};

package/dist/workflow-module.js

@@ -1,30 +1,35 @@
-import { createWorkflow, } from "./workflow-composer.js";
-function mergeModules(mods) {
-    const seen = new Set();
-    const result = {};
-    for (const mod of mods) {
-        for (const key in mod) {
-            if (!seen.has(key)) {
-                seen.add(key);
-                result[key] = mod[key];
-            }
-        }
-    }
-    return result;
-}
-export function createModule({ registry, context, use, define, }) {
-    const wf = createWorkflow(registry, context);
-    // const deps = (use ? Object.assign({}, ...use) : {}) as Deps;
-    const deps = (use ? mergeModules(use) : {});
+import { createWorkflow } from "./workflow-composer.js";
+import { executeWorkflow } from "./workflow-executor.js";
+function createModule(config) {
+    const wf = createWorkflow();
+    const deps = (config.use ?? {});
     const moduleCtx = {
         wf,
         deps,
-        context,
-        tools: (factory) => factory({ wf, deps, context }),
+        context: {},
+        tools: (factory) => factory({
+            wf,
+            deps,
+            context: {},
+        }),
     };
-    const own = define(moduleCtx);
+    const own = config.define(moduleCtx);
     return {
-        ...deps,
-        ...own,
+        own,
+        deps,
+        createRuntime({ registry, context }) {
+            const runtimeCtx = { ...context };
+            return {
+                run: async (workflow, input, observers = []) => {
+                    return executeWorkflow(workflow, registry, input, context, observers);
+                },
+                getContext: () => ({ ...runtimeCtx }),
+            };
+        },
+    };
+}
+export function createModuleFactory() {
+    return function (config) {
+        return createModule(config);
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pogodisco/zephyr",
-  "version": "1.3.12",
+  "version": "1.3.14",
   "publishConfig": {
     "access": "public"
   },