ai-workflows 1.0.0 → 2.0.0

package/dist/workflow.js

@@ -0,0 +1,456 @@
+/**
+ * Unified Workflow API
+ *
+ * Usage:
+ *   Workflow($ => {
+ *     $.on.Customer.created(async (customer, $) => {
+ *       $.log('Customer created', customer)
+ *       await $.send('Email.welcome', { to: customer.email })
+ *     })
+ *
+ *     $.every.Monday.at9am(async ($) => {
+ *       $.log('Weekly standup reminder')
+ *     })
+ *   })
+ */
+/**
+ * Well-known cron patterns for common schedules
+ */
+const KNOWN_PATTERNS = {
+    second: '* * * * * *',
+    minute: '* * * * *',
+    hour: '0 * * * *',
+    day: '0 0 * * *',
+    week: '0 0 * * 0',
+    month: '0 0 1 * *',
+    year: '0 0 1 1 *',
+    Monday: '0 0 * * 1',
+    Tuesday: '0 0 * * 2',
+    Wednesday: '0 0 * * 3',
+    Thursday: '0 0 * * 4',
+    Friday: '0 0 * * 5',
+    Saturday: '0 0 * * 6',
+    Sunday: '0 0 * * 0',
+    weekday: '0 0 * * 1-5',
+    weekend: '0 0 * * 0,6',
+    midnight: '0 0 * * *',
+    noon: '0 12 * * *',
+};
+/**
+ * Time suffixes for day-based schedules
+ */
+const TIME_PATTERNS = {
+    at6am: { hour: 6, minute: 0 },
+    at7am: { hour: 7, minute: 0 },
+    at8am: { hour: 8, minute: 0 },
+    at9am: { hour: 9, minute: 0 },
+    at10am: { hour: 10, minute: 0 },
+    at11am: { hour: 11, minute: 0 },
+    at12pm: { hour: 12, minute: 0 },
+    atnoon: { hour: 12, minute: 0 },
+    at1pm: { hour: 13, minute: 0 },
+    at2pm: { hour: 14, minute: 0 },
+    at3pm: { hour: 15, minute: 0 },
+    at4pm: { hour: 16, minute: 0 },
+    at5pm: { hour: 17, minute: 0 },
+    at6pm: { hour: 18, minute: 0 },
+    at7pm: { hour: 19, minute: 0 },
+    at8pm: { hour: 20, minute: 0 },
+    at9pm: { hour: 21, minute: 0 },
+    atmidnight: { hour: 0, minute: 0 },
+};
+/**
+ * Combine a day pattern with a time pattern
+ */
+function combineWithTime(baseCron, time) {
+    const parts = baseCron.split(' ');
+    parts[0] = String(time.minute);
+    parts[1] = String(time.hour);
+    return parts.join(' ');
+}
+/**
+ * Parse event string into noun and event
+ */
+export function parseEvent(event) {
+    const parts = event.split('.');
+    if (parts.length !== 2) {
+        return null;
+    }
+    const [noun, eventName] = parts;
+    if (!noun || !eventName) {
+        return null;
+    }
+    return { noun, event: eventName };
+}
+/**
+ * Create a workflow with the $ context
+ *
+ * @example
+ * ```ts
+ * const workflow = Workflow($ => {
+ *   $.on.Customer.created(async (customer, $) => {
+ *     $.log('New customer:', customer.name)
+ *     await $.send('Email.welcome', { to: customer.email })
+ *   })
+ *
+ *   $.every.hour(async ($) => {
+ *     $.log('Hourly check')
+ *   })
+ *
+ *   $.every.Monday.at9am(async ($) => {
+ *     $.log('Weekly standup')
+ *   })
+ *
+ *   $.every('first Monday of the month', async ($) => {
+ *     $.log('Monthly report')
+ *   })
+ * })
+ *
+ * await workflow.start()
+ * await workflow.send('Customer.created', { name: 'John', email: 'john@example.com' })
+ * ```
+ */
+export function Workflow(setup, options = {}) {
+    // Registries for handlers captured during setup
+    const eventRegistry = [];
+    const scheduleRegistry = [];
+    // State
+    const state = {
+        context: { ...options.context },
+        history: [],
+    };
+    // Schedule timers
+    let scheduleTimers = [];
+    /**
+     * Add to history
+     */
+    const addHistory = (entry) => {
+        state.history.push({
+            ...entry,
+            timestamp: Date.now(),
+        });
+    };
+    /**
+     * Register an event handler
+     */
+    const registerEventHandler = (noun, event, handler) => {
+        eventRegistry.push({
+            noun,
+            event,
+            handler,
+            source: handler.toString(),
+        });
+    };
+    /**
+     * Register a schedule handler
+     */
+    const registerScheduleHandler = (interval, handler) => {
+        scheduleRegistry.push({
+            interval,
+            handler,
+            source: handler.toString(),
+        });
+    };
+    /**
+     * Create the $.on proxy
+     */
+    const createOnProxy = () => {
+        return new Proxy({}, {
+            get(_target, noun) {
+                return new Proxy({}, {
+                    get(_eventTarget, event) {
+                        return (handler) => {
+                            registerEventHandler(noun, event, handler);
+                        };
+                    }
+                });
+            }
+        });
+    };
+    /**
+     * Create the $.every proxy
+     */
+    const createEveryProxy = () => {
+        const handler = {
+            get(_target, prop) {
+                const pattern = KNOWN_PATTERNS[prop];
+                if (pattern) {
+                    const result = (handlerFn) => {
+                        registerScheduleHandler({ type: 'cron', expression: pattern, natural: prop }, handlerFn);
+                    };
+                    return new Proxy(result, {
+                        get(_t, timeKey) {
+                            const time = TIME_PATTERNS[timeKey];
+                            if (time) {
+                                const cron = combineWithTime(pattern, time);
+                                return (handlerFn) => {
+                                    registerScheduleHandler({ type: 'cron', expression: cron, natural: `${prop}.${timeKey}` }, handlerFn);
+                                };
+                            }
+                            return undefined;
+                        },
+                        apply(_t, _thisArg, args) {
+                            registerScheduleHandler({ type: 'cron', expression: pattern, natural: prop }, args[0]);
+                        }
+                    });
+                }
+                // Plural units (seconds, minutes, hours, days, weeks)
+                const pluralUnits = {
+                    seconds: 'second',
+                    minutes: 'minute',
+                    hours: 'hour',
+                    days: 'day',
+                    weeks: 'week',
+                };
+                if (pluralUnits[prop]) {
+                    return (value) => (handlerFn) => {
+                        registerScheduleHandler({ type: pluralUnits[prop], value, natural: `${value} ${prop}` }, handlerFn);
+                    };
+                }
+                return undefined;
+            },
+            apply(_target, _thisArg, args) {
+                const [description, handler] = args;
+                if (typeof description === 'string' && typeof handler === 'function') {
+                    registerScheduleHandler({ type: 'natural', description }, handler);
+                }
+            }
+        };
+        return new Proxy(function () { }, handler);
+    };
+    /**
+     * Deliver an event to matching handlers (fire and forget)
+     */
+    const deliverEvent = async (event, data) => {
+        const parsed = parseEvent(event);
+        if (!parsed) {
+            console.warn(`Invalid event format: ${event}. Expected Noun.event`);
+            return;
+        }
+        const matching = eventRegistry.filter(h => h.noun === parsed.noun && h.event === parsed.event);
+        if (matching.length === 0) {
+            return;
+        }
+        await Promise.all(matching.map(async ({ handler }) => {
+            try {
+                await handler(data, $);
+            }
+            catch (error) {
+                console.error(`Error in handler for ${event}:`, error);
+            }
+        }));
+    };
+    /**
+     * Execute an event and wait for result from first matching handler
+     */
+    const executeEvent = async (event, data, durable) => {
+        const parsed = parseEvent(event);
+        if (!parsed) {
+            throw new Error(`Invalid event format: ${event}. Expected Noun.event`);
+        }
+        const matching = eventRegistry.filter(h => h.noun === parsed.noun && h.event === parsed.event);
+        if (matching.length === 0) {
+            throw new Error(`No handler registered for ${event}`);
+        }
+        // Use first matching handler for result
+        const { handler } = matching[0];
+        if (durable && options.db) {
+            // Create action for durability tracking
+            await options.db.createAction({
+                actor: 'workflow',
+                object: event,
+                action: 'execute',
+                metadata: { data },
+            });
+        }
+        try {
+            const result = await handler(data, $);
+            return result;
+        }
+        catch (error) {
+            if (durable) {
+                // Could implement retry logic here
+                console.error(`[workflow] Durable action failed for ${event}:`, error);
+            }
+            throw error;
+        }
+    };
+    /**
+     * Create the $ context
+     */
+    const $ = {
+        async send(event, data) {
+            addHistory({ type: 'event', name: event, data });
+            // Record to database if connected (durable)
+            if (options.db) {
+                await options.db.recordEvent(event, data);
+            }
+            await deliverEvent(event, data);
+        },
+        async do(event, data) {
+            addHistory({ type: 'action', name: `do:${event}`, data });
+            // Record to database (durable)
+            if (options.db) {
+                await options.db.recordEvent(event, data);
+            }
+            return executeEvent(event, data, true);
+        },
+        async try(event, data) {
+            addHistory({ type: 'action', name: `try:${event}`, data });
+            // Non-durable - no database recording
+            return executeEvent(event, data, false);
+        },
+        on: createOnProxy(),
+        every: createEveryProxy(),
+        // Direct access to state context
+        state: state.context,
+        getState() {
+            // Return a deep copy to prevent mutation
+            return {
+                current: state.current,
+                context: { ...state.context },
+                history: [...state.history],
+            };
+        },
+        set(key, value) {
+            state.context[key] = value;
+        },
+        get(key) {
+            return state.context[key];
+        },
+        log(message, data) {
+            addHistory({ type: 'action', name: 'log', data: { message, data } });
+            console.log(`[workflow] ${message}`, data ?? '');
+        },
+        db: options.db,
+    };
+    // Run setup to capture handlers
+    setup($);
+    /**
+     * Start schedule handlers
+     */
+    const startSchedules = async () => {
+        for (const schedule of scheduleRegistry) {
+            const { interval, handler } = schedule;
+            let ms = 0;
+            switch (interval.type) {
+                case 'second':
+                    ms = (interval.value ?? 1) * 1000;
+                    break;
+                case 'minute':
+                    ms = (interval.value ?? 1) * 60 * 1000;
+                    break;
+                case 'hour':
+                    ms = (interval.value ?? 1) * 60 * 60 * 1000;
+                    break;
+                case 'day':
+                    ms = (interval.value ?? 1) * 24 * 60 * 60 * 1000;
+                    break;
+                case 'week':
+                    ms = (interval.value ?? 1) * 7 * 24 * 60 * 60 * 1000;
+                    break;
+                case 'cron':
+                case 'natural':
+                    // Cron/natural need special handling
+                    console.log(`[workflow] Cron/natural scheduling not yet implemented: ${interval.type === 'cron' ? interval.expression : interval.description}`);
+                    continue;
+            }
+            if (ms > 0) {
+                const timer = setInterval(async () => {
+                    try {
+                        addHistory({ type: 'schedule', name: interval.natural ?? interval.type });
+                        await handler($);
+                    }
+                    catch (error) {
+                        console.error('[workflow] Schedule handler error:', error);
+                    }
+                }, ms);
+                scheduleTimers.push(timer);
+            }
+        }
+    };
+    const instance = {
+        definition: {
+            name: 'workflow',
+            events: eventRegistry,
+            schedules: scheduleRegistry,
+            initialContext: options.context,
+        },
+        get state() {
+            return state;
+        },
+        $,
+        async send(event, data) {
+            await $.send(event, data);
+        },
+        async start() {
+            console.log(`[workflow] Starting with ${eventRegistry.length} event handlers and ${scheduleRegistry.length} schedules`);
+            await startSchedules();
+        },
+        async stop() {
+            console.log('[workflow] Stopping');
+            for (const timer of scheduleTimers) {
+                clearInterval(timer);
+            }
+            scheduleTimers = [];
+        },
+    };
+    return instance;
+}
+/**
+ * Create an isolated $ context for testing
+ */
+export function createTestContext() {
+    const emittedEvents = [];
+    const stateContext = {};
+    const history = [];
+    const $ = {
+        emittedEvents,
+        async send(event, data) {
+            emittedEvents.push({ event, data });
+        },
+        async do(_event, _data) {
+            throw new Error('$.do not implemented in test context - register handlers via Workflow()');
+        },
+        async try(_event, _data) {
+            throw new Error('$.try not implemented in test context - register handlers via Workflow()');
+        },
+        on: new Proxy({}, {
+            get() {
+                return new Proxy({}, {
+                    get() {
+                        return () => { }; // No-op for testing
+                    }
+                });
+            }
+        }),
+        every: new Proxy(function () { }, {
+            get() {
+                return () => () => { }; // No-op for testing
+            },
+            apply() { }
+        }),
+        state: stateContext,
+        getState() {
+            return {
+                context: { ...stateContext },
+                history: [...history],
+            };
+        },
+        set(key, value) {
+            stateContext[key] = value;
+        },
+        get(key) {
+            return stateContext[key];
+        },
+        log(message, data) {
+            console.log(`[test] ${message}`, data ?? '');
+        },
+    };
+    return $;
+}
+// Also export standalone on/every for import { on, every } usage
+export { on, registerEventHandler, getEventHandlers, clearEventHandlers } from './on.js';
+export { every, registerScheduleHandler, getScheduleHandlers, clearScheduleHandlers, toCron, intervalToMs, formatInterval, setCronConverter } from './every.js';
+export { send } from './send.js';
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/package.json

@@ -1,79 +1,38 @@
 {
   "name": "ai-workflows",
+  "version": "2.0.0",
+  "description": "Event-driven workflows with state machine support",
   "type": "module",
-  "version": "1.0.0",
-  "description": "Composable AI Workflows & Durable Execution Framework",
   "main": "dist/index.js",
-  "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "bin": {
-    "ai-workflows": "bin/cli.js"
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
   },
-  "files": [
-    "dist",
-    "bin"
-  ],
   "scripts": {
     "build": "tsc",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "lint": "eslint src",
-    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx}\" \"*.{md,mdx}\"",
-    "prepublishOnly": "pnpm run build"
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "rpc.do": "^0.1.0",
+    "xstate": "^5.18.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0"
   },
   "keywords": [
     "ai",
     "workflows",
-    "mdx",
-    "durable-execution"
+    "events",
+    "state-machine",
+    "xstate",
+    "primitives"
   ],
-  "author": "AI Primitives",
-  "license": "MIT",
-  "homepage": "https://mdx.org.ai",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ai-primitives/ai-workflows.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ai-primitives/ai-workflows/issues"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.26.0",
-    "@babel/preset-env": "^7.26.0",
-    "@eslint/js": "^9.17.0",
-    "@jest/globals": "^29.7.0",
-    "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/github": "^11.0.1",
-    "@semantic-release/npm": "^12.0.1",
-    "@semantic-release/release-notes-generator": "^14.0.1",
-    "@testing-library/jest-dom": "^6.4.2",
-    "@testing-library/react": "^16.1.0",
-    "@types/jest": "^29.5.14",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.10.2",
-    "@types/react": "^18.3.17",
-    "@types/react-dom": "^18.2.0",
-    "@typescript-eslint/eslint-plugin": "^8.18.0",
-    "@typescript-eslint/parser": "^8.18.0",
-    "babel-jest": "^29.7.0",
-    "eslint": "^9.17.0",
-    "identity-obj-proxy": "^3.0.0",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "prettier": "^3.4.2",
-    "semantic-release": "^24.2.0",
-    "ts-jest": "^29.2.5",
-    "typescript": "^5.7.2"
-  },
-  "dependencies": {
-    "@ai-sdk/openai": "^1.0.8",
-    "ai": "^4.0.18",
-    "ai-functions": "^0.2.19",
-    "gray-matter": "^4.0.3",
-    "mdxld": "^0.1.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.2.0",
-    "yaml": "^2.6.1",
-    "zod": "^3.24.1"
-  }
+  "license": "MIT"
 }

package/src/context.ts

@@ -0,0 +1,108 @@
+/**
+ * Workflow context implementation
+ */
+
+import type { WorkflowContext, WorkflowState, WorkflowHistoryEntry, OnProxy, EveryProxy } from './types.js'
+
+/**
+ * Event bus interface (imported from send.ts to avoid circular dependency)
+ */
+interface EventBusLike {
+  emit(event: string, data: unknown): Promise<void>
+}
+
+/**
+ * Create a workflow context
+ */
+export function createWorkflowContext(eventBus: EventBusLike): WorkflowContext {
+  const workflowState: WorkflowState = {
+    context: {},
+    history: [],
+  }
+
+  const addHistory = (entry: Omit<WorkflowHistoryEntry, 'timestamp'>) => {
+    workflowState.history.push({
+      ...entry,
+      timestamp: Date.now(),
+    })
+  }
+
+  // Create no-op proxies for on/every (these are used in send context, not workflow setup)
+  const noOpOnProxy = new Proxy({} as OnProxy, {
+    get() {
+      return new Proxy({}, {
+        get() {
+          return () => {}
+        }
+      })
+    }
+  })
+
+  const noOpEveryProxy = new Proxy(function() {} as any, {
+    get() {
+      return () => () => {}
+    },
+    apply() {}
+  }) as EveryProxy
+
+  return {
+    async send<T = unknown>(event: string, data: T): Promise<void> {
+      addHistory({ type: 'event', name: event, data })
+      await eventBus.emit(event, data)
+    },
+
+    async do<TData = unknown, TResult = unknown>(_event: string, _data: TData): Promise<TResult> {
+      throw new Error('$.do not available in this context')
+    },
+
+    async try<TData = unknown, TResult = unknown>(_event: string, _data: TData): Promise<TResult> {
+      throw new Error('$.try not available in this context')
+    },
+
+    on: noOpOnProxy,
+    every: noOpEveryProxy,
+
+    state: workflowState.context,
+
+    getState(): WorkflowState {
+      // Return a deep copy to prevent mutation
+      return {
+        current: workflowState.current,
+        context: { ...workflowState.context },
+        history: [...workflowState.history],
+      }
+    },
+
+    set<T = unknown>(key: string, value: T): void {
+      workflowState.context[key] = value
+    },
+
+    get<T = unknown>(key: string): T | undefined {
+      return workflowState.context[key] as T | undefined
+    },
+
+    log(message: string, data?: unknown): void {
+      addHistory({ type: 'action', name: 'log', data: { message, data } })
+      console.log(`[workflow] ${message}`, data ?? '')
+    },
+  }
+}
+
+/**
+ * Create an isolated workflow context (not connected to event bus)
+ * Useful for testing or standalone execution
+ */
+export function createIsolatedContext(): WorkflowContext & { getEmittedEvents: () => Array<{ event: string; data: unknown }> } {
+  const emittedEvents: Array<{ event: string; data: unknown }> = []
+
+  const ctx = createWorkflowContext({
+    async emit(event: string, data: unknown): Promise<void> {
+      emittedEvents.push({ event, data })
+    },
+  })
+
+  return {
+    ...ctx,
+    getEmittedEvents: () => [...emittedEvents],
+  }
+}