@geenius/ai-workflow

DAG-based AI workflow orchestration with shared engine utilities, UI builders, and Convex helpers.

Install

pnpm add @geenius/ai-workflow

Add the peers you actually use:

• react and react-dom for @geenius/ai-workflow/react or @geenius/ai-workflow/react-css
• solid-js for @geenius/ai-workflow/solidjs or @geenius/ai-workflow/solidjs-css
• convex for @geenius/ai-workflow/convex

Import Surface

import {
  WORKFLOW_TEMPLATES,
  WorkflowEngine,
  connect,
  llmStep,
} from "@geenius/ai-workflow";
import { validateWorkflow } from "@geenius/ai-workflow/shared";
import { WorkflowCanvas, WorkflowRunPanel } from "@geenius/ai-workflow/react";
import { WorkflowCanvas as CssWorkflowCanvas } from "@geenius/ai-workflow/react-css";
import { WorkflowCanvas as SolidWorkflowCanvas } from "@geenius/ai-workflow/solidjs";
import { WorkflowCanvas as SolidCssWorkflowCanvas } from "@geenius/ai-workflow/solidjs-css";
import { aiWorkflowTables } from "@geenius/ai-workflow/convex";

@geenius/ai-workflow and @geenius/ai-workflow/shared both resolve to the shared framework-agnostic contract.

Usage

import { WORKFLOW_TEMPLATES } from "@geenius/ai-workflow";
import { WorkflowBuilderPage } from "@geenius/ai-workflow/react";

const launchTemplate = WORKFLOW_TEMPLATES[0];

export function WorkflowBuilderScreen() {
  return (
    <WorkflowBuilderPage
      initialDefinition={launchTemplate.create("demo-user")}
    />
  );
}

Package Layout

• @geenius/ai-workflow / @geenius/ai-workflow/shared: engine, step builders, templates, validators, interpolation helpers, DAG utilities, error types, and shared types.
• @geenius/ai-workflow/react: React hooks, components, and workflow pages.
• @geenius/ai-workflow/react-css: plain-CSS React components and page variants.
• @geenius/ai-workflow/solidjs: SolidJS primitives, components, and workflow pages.
• @geenius/ai-workflow/solidjs-css: plain-CSS SolidJS components and page variants.
• @geenius/ai-workflow/convex: workflow table exports and Convex integration helpers.

Storybook

Local React and SolidJS Storybook review apps are included in the repository for development and parity review. Both use the shared @geenius/storybook shell bridge and render the Tailwind and vanilla CSS variants side by side. The package intentionally follows the same custom review-app model as geenius-adapters instead of CSF files, with parity enforced by the shared story surface and Playwright coverage.

pnpm --filter ./apps/storybook-react build
pnpm --filter ./apps/storybook-solidjs build
pnpm test:e2e

For local browser review, the same preview ports used by Playwright are:

• React review app: http://127.0.0.1:3086
• SolidJS review app: http://127.0.0.1:3087

Start them with:

pnpm --filter ./apps/storybook-react build
pnpm --dir apps/storybook-react exec vite preview --host 127.0.0.1 --strictPort --port 3086

pnpm --filter ./apps/storybook-solidjs build
pnpm --dir apps/storybook-solidjs exec vite preview --host 127.0.0.1 --strictPort --port 3087

Notes

• The repository includes private Storybook review apps for local development; they are not part of the published contract.
• Versioning and release are handled through Changesets.

License

SEE LICENSE IN LICENSE