@geenius/ai-workflow 0.1.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.0
+
+### Minor Changes
+
+- 4110eac: Bring package to A+++ golden-standard compliance with full documentation, cleanup, structural alignment, Convex codegen integration, and verified multi-variant Storybook parity.
+
 All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
@@ -8,4 +14,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2026-03-20
 
 ### Added
+
 - Initial release

package/README.md

@@ -1 +1,69 @@
-# ✦ geenius-ai-workflow\n\n> Geenius AI Workflow — Chained AI pipelines for Convex apps (React + SolidJS)\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add geenius-ai-workflow\n```\n\n## Usage\n\n```typescript\nimport { init } from 'geenius-ai-workflow';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# @geenius/ai-workflow
+
+DAG-based AI workflow orchestration with shared engine utilities, UI builders, and Convex helpers.
+
+## Install
+
+```bash
+pnpm add @geenius/ai-workflow
+```
+
+## Import Surface
+
+```ts
+import {
+  WORKFLOW_TEMPLATES,
+  WorkflowEngine,
+  connect,
+  llmStep,
+  validateWorkflow,
+} from "@geenius/ai-workflow";
+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
+
+```tsx
+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
+
+- React Storybook app: [`apps/storybook-react`](./apps/storybook-react)
+- SolidJS Storybook app: [`apps/storybook-solidjs`](./apps/storybook-solidjs)
+- Both apps use the shared `@geenius/storybook` shell bridge and Vite preset, and include Tailwind/CSS variant comparison stories.
+
+## Notes
+
+- Storybook apps under `apps/` are development-only and are not part of the published contract.
+- Versioning and release are handled through Changesets.
+
+## License
+
+MIT

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@geenius/ai-workflow",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.4.0",
+  "sideEffects": false,
   "description": "Geenius AI Workflow — Chained AI pipelines for Convex apps (React + SolidJS)",
-  "author": "Antigravity HQ",
+  "author": "Mehdi Nabhani",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mxn2020/geenius-ai-workflow.git"
+    "url": "git+https://github.com/geenius-dev/geenius-ai-workflow.git"
   },
   "keywords": [
     "ai",
@@ -18,23 +19,31 @@
     "solidjs",
     "geenius"
   ],
-  "scripts": {
-    "dev": "pnpm -r --parallel type-check",
-    "build": "pnpm -r build",
-    "clean": "pnpm -r clean",
-    "lint": "pnpm -r --parallel type-check",
-    "test": "echo \"No tests configured yet\" && exit 0",
-    "type-check": "pnpm -r type-check",
-    "format": "prettier --write \"packages/*/src/**/*.{ts,tsx}\"",
-    "version:patch": "pnpm -r exec -- npm version patch --no-git-tag-version && npm version patch -m 'v%s'",
-    "version:minor": "pnpm -r exec -- npm version minor --no-git-tag-version && npm version minor -m 'v%s'",
-    "version:major": "pnpm -r exec -- npm version major --no-git-tag-version && npm version major -m 'v%s'",
-    "release": "git push && git push --tags",
-    "publish:all": "pnpm -r publish --access public"
-  },
+  "files": [
+    "packages/shared/dist",
+    "packages/react/dist",
+    "packages/solidjs/dist",
+    "packages/convex/dist",
+    "packages/react-css/dist",
+    "packages/solidjs-css/dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@changesets/cli": "^2.30.0",
+    "@geenius/storybook": "^0.1.1",
     "prettier": "^3.8.1",
-    "typescript": "~5.9.3"
+    "publint": "^0.3.18",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.8",
+    "vitest": "^4.1.4"
+  },
+  "dependencies": {
+    "@geenius/motion": "^0.1.3",
+    "@geenius/tools": "^0.3.0",
+    "zod": "^3.23.0"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -42,33 +51,57 @@
   "exports": {
     ".": {
       "types": "./packages/shared/dist/index.d.ts",
-      "import": "./packages/shared/dist/index.js"
+      "import": "./packages/shared/dist/index.js",
+      "default": "./packages/shared/dist/index.js"
     },
     "./shared": {
       "types": "./packages/shared/dist/index.d.ts",
-      "import": "./packages/shared/dist/index.js"
+      "import": "./packages/shared/dist/index.js",
+      "default": "./packages/shared/dist/index.js"
     },
     "./convex": {
       "types": "./packages/convex/dist/index.d.ts",
-      "import": "./packages/convex/dist/index.js"
+      "import": "./packages/convex/dist/index.js",
+      "default": "./packages/convex/dist/index.js"
     },
     "./react": {
       "types": "./packages/react/dist/index.d.ts",
-      "import": "./packages/react/dist/index.js"
+      "import": "./packages/react/dist/index.js",
+      "default": "./packages/react/dist/index.js"
     },
     "./react-css": {
       "types": "./packages/react-css/dist/index.d.ts",
-      "import": "./packages/react-css/dist/index.js"
+      "import": "./packages/react-css/dist/index.js",
+      "default": "./packages/react-css/dist/index.js"
     },
     "./solidjs": {
       "types": "./packages/solidjs/dist/index.d.ts",
-      "import": "./packages/solidjs/dist/index.js"
+      "import": "./packages/solidjs/dist/index.js",
+      "default": "./packages/solidjs/dist/index.js"
     },
     "./solidjs-css": {
       "types": "./packages/solidjs-css/dist/index.d.ts",
-      "import": "./packages/solidjs-css/dist/index.js"
+      "import": "./packages/solidjs-css/dist/index.js",
+      "default": "./packages/solidjs-css/dist/index.js"
     }
   },
   "main": "./packages/shared/dist/index.js",
-  "types": "./packages/shared/dist/index.d.ts"
-}
+  "types": "./packages/shared/dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "changeset": "changeset",
+    "dev": "pnpm -r --parallel --filter './packages/*' type-check",
+    "build": "pnpm --filter ./packages/shared build && pnpm -r --filter './packages/*' --filter '!./packages/shared' build",
+    "clean": "pnpm -r --filter './packages/*' clean",
+    "test": "pnpm build && pnpm run test:unit && pnpm run test:exports && pnpm run test:types",
+    "test:exports": "vitest run __tests__/exports.test.ts --passWithNoTests",
+    "test:types": "npm_config_cache=/tmp/.npm-cache attw --pack --ignore-rules cjs-resolves-to-esm --ignore-rules no-resolution",
+    "lint": "pnpm -r --filter './packages/*' type-check",
+    "lint:pub": "publint",
+    "type-check": "pnpm -r --filter './packages/*' type-check",
+    "format": "prettier --write \"packages/*/src/**/*.{ts,tsx}\"",
+    "test:unit": "pnpm -r --filter './packages/*' test && vitest run __tests__/parity.test.ts --passWithNoTests"
+  }
+}

package/packages/convex/dist/index.d.ts

@@ -0,0 +1,363 @@
+import * as convex_server from 'convex/server';
+import { FilterApi, ApiFromModules, FunctionReference } from 'convex/server';
+import * as convex_values from 'convex/values';
+
+/**
+ * @module WorkflowConvexComponent
+ * @package @geenius/ai-workflow-convex
+ * @description Convex component definition for the AI workflow package. This
+ * entry anchors the package in Convex projects without relying on generated
+ * project-local modules.
+ */
+declare const component: convex_server.ComponentDefinition<any>;
+
+/**
+ * @module WorkflowConvexMutations
+ * @package @geenius/ai-workflow-convex
+ * @description Public Convex mutation definitions for creating workflow
+ * entities in package consumers. These mutations depend only on the package-local
+ * Convex shim and avoid generated project-specific modules.
+ */
+/**
+ * Creates a workflow definition record in the packaged Convex schema.
+ *
+ * @returns The inserted workflow document id.
+ */
+declare const createWorkflow: convex_server.RegisteredMutation<"public", {
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    status: "draft" | "active" | "paused" | "archived";
+    name: string;
+    version: number;
+    definitionJson: string;
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
+}, Promise<convex_values.GenericId<"workflows">>>;
+/**
+ * Creates a workflow run record in the packaged Convex schema.
+ *
+ * @returns The inserted workflow-run document id.
+ */
+declare const createWorkflowRun: convex_server.RegisteredMutation<"public", {
+    inputJson?: string | undefined;
+    variablesJson?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+    status: "paused" | "pending" | "running" | "completed" | "failed" | "cancelled";
+    workflowId: string;
+    workflowVersion: number;
+    currentStepIndex: number;
+    triggeredBy: string;
+    startedAt: number;
+}, Promise<convex_values.GenericId<"workflowRuns">>>;
+/**
+ * Creates a workflow step-result record in the packaged Convex schema.
+ *
+ * @returns The inserted workflow-step-result document id.
+ */
+declare const createWorkflowStepResult: convex_server.RegisteredMutation<"public", {
+    inputJson?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+    outputJson?: string | undefined;
+    tokens?: number | undefined;
+    costUsd?: number | undefined;
+    type: "llm-call" | "transform" | "condition" | "human-approval" | "webhook" | "delay" | "parallel" | "loop" | "sub-workflow" | "custom";
+    status: "pending" | "running" | "completed" | "failed" | "skipped" | "waiting-approval";
+    startedAt: number;
+    runId: convex_values.GenericId<"workflowRuns">;
+    stepId: string;
+    stepName: string;
+    durationMs: number;
+}, Promise<convex_values.GenericId<"workflowStepResults">>>;
+
+declare const mutations_createWorkflow: typeof createWorkflow;
+declare const mutations_createWorkflowRun: typeof createWorkflowRun;
+declare const mutations_createWorkflowStepResult: typeof createWorkflowStepResult;
+declare namespace mutations {
+  export { mutations_createWorkflow as createWorkflow, mutations_createWorkflowRun as createWorkflowRun, mutations_createWorkflowStepResult as createWorkflowStepResult };
+}
+
+/**
+ * @module WorkflowConvexQueries
+ * @package @geenius/ai-workflow-convex
+ * @description Public Convex query definitions for listing workflow entities in
+ * package consumers. These queries depend only on the package-local Convex shim.
+ */
+/**
+ * Lists stored workflow definitions from the packaged Convex schema.
+ *
+ * @returns All persisted workflow definitions.
+ */
+declare const listWorkflows: convex_server.RegisteredQuery<"public", {}, Promise<{
+    _id: convex_values.GenericId<"workflows">;
+    _creationTime: number;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    status: "draft" | "active" | "paused" | "archived";
+    name: string;
+    version: number;
+    definitionJson: string;
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
+}[]>>;
+/**
+ * Lists stored workflow run records from the packaged Convex schema.
+ *
+ * @returns All persisted workflow runs.
+ */
+declare const listWorkflowRuns: convex_server.RegisteredQuery<"public", {}, Promise<{
+    _id: convex_values.GenericId<"workflowRuns">;
+    _creationTime: number;
+    inputJson?: string | undefined;
+    variablesJson?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+    status: "paused" | "pending" | "running" | "completed" | "failed" | "cancelled";
+    workflowId: string;
+    workflowVersion: number;
+    currentStepIndex: number;
+    triggeredBy: string;
+    startedAt: number;
+}[]>>;
+/**
+ * Lists stored per-step execution results from the packaged Convex schema.
+ *
+ * @returns All persisted workflow step-result records.
+ */
+declare const listWorkflowStepResults: convex_server.RegisteredQuery<"public", {}, Promise<{
+    _id: convex_values.GenericId<"workflowStepResults">;
+    _creationTime: number;
+    inputJson?: string | undefined;
+    error?: string | undefined;
+    completedAt?: number | undefined;
+    outputJson?: string | undefined;
+    tokens?: number | undefined;
+    costUsd?: number | undefined;
+    type: "llm-call" | "transform" | "condition" | "human-approval" | "webhook" | "delay" | "parallel" | "loop" | "sub-workflow" | "custom";
+    status: "pending" | "running" | "completed" | "failed" | "skipped" | "waiting-approval";
+    startedAt: number;
+    runId: convex_values.GenericId<"workflowRuns">;
+    stepId: string;
+    stepName: string;
+    durationMs: number;
+}[]>>;
+
+declare const queries_listWorkflowRuns: typeof listWorkflowRuns;
+declare const queries_listWorkflowStepResults: typeof listWorkflowStepResults;
+declare const queries_listWorkflows: typeof listWorkflows;
+declare namespace queries {
+  export { queries_listWorkflowRuns as listWorkflowRuns, queries_listWorkflowStepResults as listWorkflowStepResults, queries_listWorkflows as listWorkflows };
+}
+
+/* eslint-disable */
+/**
+ * THIS CODE IS AUTOMATICALLY GENERATED by @geenius/db codegen.
+ *
+ * Template version: 1.34-r2
+ * Generated at: 2026-04-13
+ * Convex SDK: ^1.34.0
+ *
+ * DO NOT EDIT THIS FILE MANUALLY.
+ * To regenerate, run: geenius-convex-codegen
+ * @module
+ */
+
+
+
+declare const fullApi: ApiFromModules<{
+  "mutations": typeof mutations;
+  "queries": typeof queries;
+}>;
+
+declare const api: FilterApi<
+  typeof fullApi,
+  FunctionReference<any, "public">
+>;
+
+/**
+ * @module WorkflowConvexSchema
+ * @package @geenius/ai-workflow-convex
+ * @description Convex schema definitions for persisted workflows, workflow
+ * runs, and per-step results. The schema mirrors the shared workflow contract
+ * closely enough for typed storage without using `v.any()`.
+ */
+/**
+ * Mergeable Convex table definitions for workflow persistence.
+ */
+declare const aiWorkflowTables: {
+    workflows: convex_server.TableDefinition<convex_values.VObject<{
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        status: "draft" | "active" | "paused" | "archived";
+        name: string;
+        version: number;
+        definitionJson: string;
+        createdBy: string;
+        createdAt: number;
+        updatedAt: number;
+    }, {
+        name: convex_values.VString<string, "required">;
+        description: convex_values.VString<string | undefined, "optional">;
+        version: convex_values.VFloat64<number, "required">;
+        status: convex_values.VUnion<"draft" | "active" | "paused" | "archived", [convex_values.VLiteral<"draft", "required">, convex_values.VLiteral<"active", "required">, convex_values.VLiteral<"paused", "required">, convex_values.VLiteral<"archived", "required">], "required", never>;
+        definitionJson: convex_values.VString<string, "required">;
+        createdBy: convex_values.VString<string, "required">;
+        tags: convex_values.VArray<string[] | undefined, convex_values.VString<string, "required">, "optional">;
+        createdAt: convex_values.VFloat64<number, "required">;
+        updatedAt: convex_values.VFloat64<number, "required">;
+    }, "required", "status" | "name" | "description" | "version" | "definitionJson" | "createdBy" | "tags" | "createdAt" | "updatedAt">, {
+        by_status: ["status", "_creationTime"];
+        by_createdBy: ["createdBy", "_creationTime"];
+        by_updatedAt: ["updatedAt", "_creationTime"];
+    }, {}, {}>;
+    workflowRuns: convex_server.TableDefinition<convex_values.VObject<{
+        inputJson?: string | undefined;
+        variablesJson?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+        status: "paused" | "pending" | "running" | "completed" | "failed" | "cancelled";
+        workflowId: string;
+        workflowVersion: number;
+        currentStepIndex: number;
+        triggeredBy: string;
+        startedAt: number;
+    }, {
+        workflowId: convex_values.VString<string, "required">;
+        workflowVersion: convex_values.VFloat64<number, "required">;
+        status: convex_values.VUnion<"paused" | "pending" | "running" | "completed" | "failed" | "cancelled", [convex_values.VLiteral<"pending", "required">, convex_values.VLiteral<"running", "required">, convex_values.VLiteral<"paused", "required">, convex_values.VLiteral<"completed", "required">, convex_values.VLiteral<"failed", "required">, convex_values.VLiteral<"cancelled", "required">], "required", never>;
+        currentStepIndex: convex_values.VFloat64<number, "required">;
+        inputJson: convex_values.VString<string | undefined, "optional">;
+        variablesJson: convex_values.VString<string | undefined, "optional">;
+        error: convex_values.VString<string | undefined, "optional">;
+        triggeredBy: convex_values.VString<string, "required">;
+        startedAt: convex_values.VFloat64<number, "required">;
+        completedAt: convex_values.VFloat64<number | undefined, "optional">;
+    }, "required", "status" | "workflowId" | "workflowVersion" | "currentStepIndex" | "inputJson" | "variablesJson" | "error" | "triggeredBy" | "startedAt" | "completedAt">, {
+        by_workflowId: ["workflowId", "_creationTime"];
+        by_status: ["status", "_creationTime"];
+        by_startedAt: ["startedAt", "_creationTime"];
+    }, {}, {}>;
+    workflowStepResults: convex_server.TableDefinition<convex_values.VObject<{
+        inputJson?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+        outputJson?: string | undefined;
+        tokens?: number | undefined;
+        costUsd?: number | undefined;
+        type: "llm-call" | "transform" | "condition" | "human-approval" | "webhook" | "delay" | "parallel" | "loop" | "sub-workflow" | "custom";
+        status: "pending" | "running" | "completed" | "failed" | "skipped" | "waiting-approval";
+        startedAt: number;
+        runId: convex_values.GenericId<"workflowRuns">;
+        stepId: string;
+        stepName: string;
+        durationMs: number;
+    }, {
+        runId: convex_values.VId<convex_values.GenericId<"workflowRuns">, "required">;
+        stepId: convex_values.VString<string, "required">;
+        stepName: convex_values.VString<string, "required">;
+        type: convex_values.VUnion<"llm-call" | "transform" | "condition" | "human-approval" | "webhook" | "delay" | "parallel" | "loop" | "sub-workflow" | "custom", [convex_values.VLiteral<"llm-call", "required">, convex_values.VLiteral<"transform", "required">, convex_values.VLiteral<"condition", "required">, convex_values.VLiteral<"human-approval", "required">, convex_values.VLiteral<"webhook", "required">, convex_values.VLiteral<"delay", "required">, convex_values.VLiteral<"parallel", "required">, convex_values.VLiteral<"loop", "required">, convex_values.VLiteral<"sub-workflow", "required">, convex_values.VLiteral<"custom", "required">], "required", never>;
+        status: convex_values.VUnion<"pending" | "running" | "completed" | "failed" | "skipped" | "waiting-approval", [convex_values.VLiteral<"pending", "required">, convex_values.VLiteral<"running", "required">, convex_values.VLiteral<"completed", "required">, convex_values.VLiteral<"failed", "required">, convex_values.VLiteral<"skipped", "required">, convex_values.VLiteral<"waiting-approval", "required">], "required", never>;
+        inputJson: convex_values.VString<string | undefined, "optional">;
+        outputJson: convex_values.VString<string | undefined, "optional">;
+        error: convex_values.VString<string | undefined, "optional">;
+        durationMs: convex_values.VFloat64<number, "required">;
+        tokens: convex_values.VFloat64<number | undefined, "optional">;
+        costUsd: convex_values.VFloat64<number | undefined, "optional">;
+        startedAt: convex_values.VFloat64<number, "required">;
+        completedAt: convex_values.VFloat64<number | undefined, "optional">;
+    }, "required", "type" | "status" | "inputJson" | "error" | "startedAt" | "completedAt" | "runId" | "stepId" | "stepName" | "outputJson" | "durationMs" | "tokens" | "costUsd">, {
+        by_runId: ["runId", "_creationTime"];
+        by_status: ["status", "_creationTime"];
+    }, {}, {}>;
+};
+declare const workflowSchema: convex_server.SchemaDefinition<{
+    workflows: convex_server.TableDefinition<convex_values.VObject<{
+        description?: string | undefined;
+        tags?: string[] | undefined;
+        status: "draft" | "active" | "paused" | "archived";
+        name: string;
+        version: number;
+        definitionJson: string;
+        createdBy: string;
+        createdAt: number;
+        updatedAt: number;
+    }, {
+        name: convex_values.VString<string, "required">;
+        description: convex_values.VString<string | undefined, "optional">;
+        version: convex_values.VFloat64<number, "required">;
+        status: convex_values.VUnion<"draft" | "active" | "paused" | "archived", [convex_values.VLiteral<"draft", "required">, convex_values.VLiteral<"active", "required">, convex_values.VLiteral<"paused", "required">, convex_values.VLiteral<"archived", "required">], "required", never>;
+        definitionJson: convex_values.VString<string, "required">;
+        createdBy: convex_values.VString<string, "required">;
+        tags: convex_values.VArray<string[] | undefined, convex_values.VString<string, "required">, "optional">;
+        createdAt: convex_values.VFloat64<number, "required">;
+        updatedAt: convex_values.VFloat64<number, "required">;
+    }, "required", "status" | "name" | "description" | "version" | "definitionJson" | "createdBy" | "tags" | "createdAt" | "updatedAt">, {
+        by_status: ["status", "_creationTime"];
+        by_createdBy: ["createdBy", "_creationTime"];
+        by_updatedAt: ["updatedAt", "_creationTime"];
+    }, {}, {}>;
+    workflowRuns: convex_server.TableDefinition<convex_values.VObject<{
+        inputJson?: string | undefined;
+        variablesJson?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+        status: "paused" | "pending" | "running" | "completed" | "failed" | "cancelled";
+        workflowId: string;
+        workflowVersion: number;
+        currentStepIndex: number;
+        triggeredBy: string;
+        startedAt: number;
+    }, {
+        workflowId: convex_values.VString<string, "required">;
+        workflowVersion: convex_values.VFloat64<number, "required">;
+        status: convex_values.VUnion<"paused" | "pending" | "running" | "completed" | "failed" | "cancelled", [convex_values.VLiteral<"pending", "required">, convex_values.VLiteral<"running", "required">, convex_values.VLiteral<"paused", "required">, convex_values.VLiteral<"completed", "required">, convex_values.VLiteral<"failed", "required">, convex_values.VLiteral<"cancelled", "required">], "required", never>;
+        currentStepIndex: convex_values.VFloat64<number, "required">;
+        inputJson: convex_values.VString<string | undefined, "optional">;
+        variablesJson: convex_values.VString<string | undefined, "optional">;
+        error: convex_values.VString<string | undefined, "optional">;
+        triggeredBy: convex_values.VString<string, "required">;
+        startedAt: convex_values.VFloat64<number, "required">;
+        completedAt: convex_values.VFloat64<number | undefined, "optional">;
+    }, "required", "status" | "workflowId" | "workflowVersion" | "currentStepIndex" | "inputJson" | "variablesJson" | "error" | "triggeredBy" | "startedAt" | "completedAt">, {
+        by_workflowId: ["workflowId", "_creationTime"];
+        by_status: ["status", "_creationTime"];
+        by_startedAt: ["startedAt", "_creationTime"];
+    }, {}, {}>;
+    workflowStepResults: convex_server.TableDefinition<convex_values.VObject<{
+        inputJson?: string | undefined;
+        error?: string | undefined;
+        completedAt?: number | undefined;
+        outputJson?: string | undefined;
+        tokens?: number | undefined;
+        costUsd?: number | undefined;
+        type: "llm-call" | "transform" | "condition" | "human-approval" | "webhook" | "delay" | "parallel" | "loop" | "sub-workflow" | "custom";
+        status: "pending" | "running" | "completed" | "failed" | "skipped" | "waiting-approval";
+        startedAt: number;
+        runId: convex_values.GenericId<"workflowRuns">;
+        stepId: string;
+        stepName: string;
+        durationMs: number;
+    }, {
+        runId: convex_values.VId<convex_values.GenericId<"workflowRuns">, "required">;
+        stepId: convex_values.VString<string, "required">;
+        stepName: convex_values.VString<string, "required">;
+        type: convex_values.VUnion<"llm-call" | "transform" | "condition" | "human-approval" | "webhook" | "delay" | "parallel" | "loop" | "sub-workflow" | "custom", [convex_values.VLiteral<"llm-call", "required">, convex_values.VLiteral<"transform", "required">, convex_values.VLiteral<"condition", "required">, convex_values.VLiteral<"human-approval", "required">, convex_values.VLiteral<"webhook", "required">, convex_values.VLiteral<"delay", "required">, convex_values.VLiteral<"parallel", "required">, convex_values.VLiteral<"loop", "required">, convex_values.VLiteral<"sub-workflow", "required">, convex_values.VLiteral<"custom", "required">], "required", never>;
+        status: convex_values.VUnion<"pending" | "running" | "completed" | "failed" | "skipped" | "waiting-approval", [convex_values.VLiteral<"pending", "required">, convex_values.VLiteral<"running", "required">, convex_values.VLiteral<"completed", "required">, convex_values.VLiteral<"failed", "required">, convex_values.VLiteral<"skipped", "required">, convex_values.VLiteral<"waiting-approval", "required">], "required", never>;
+        inputJson: convex_values.VString<string | undefined, "optional">;
+        outputJson: convex_values.VString<string | undefined, "optional">;
+        error: convex_values.VString<string | undefined, "optional">;
+        durationMs: convex_values.VFloat64<number, "required">;
+        tokens: convex_values.VFloat64<number | undefined, "optional">;
+        costUsd: convex_values.VFloat64<number | undefined, "optional">;
+        startedAt: convex_values.VFloat64<number, "required">;
+        completedAt: convex_values.VFloat64<number | undefined, "optional">;
+    }, "required", "type" | "status" | "inputJson" | "error" | "startedAt" | "completedAt" | "runId" | "stepId" | "stepName" | "outputJson" | "durationMs" | "tokens" | "costUsd">, {
+        by_runId: ["runId", "_creationTime"];
+        by_status: ["status", "_creationTime"];
+    }, {}, {}>;
+}, true>;
+
+export { aiWorkflowTables, api, component as componentDefinition, createWorkflow, createWorkflowRun, createWorkflowStepResult, listWorkflowRuns, listWorkflowStepResults, listWorkflows, workflowSchema };