@geenius/ai-workflow 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.6.0
+
+### Minor Changes
+
+- Bring package to A+++ golden-standard compliance with full documentation, cleanup, and structural alignment
+
+## 0.5.0
+
+### Minor Changes
+
+- 6f2c2b2: Bring package to A+++ golden-standard compliance with full documentation, cleanup, and structural alignment.
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -55,13 +55,12 @@ export function WorkflowBuilderScreen() {
 
 ## 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.
+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.
 
 ## Notes
 
-- Storybook apps under `apps/` are development-only and are not part of the published contract.
+- 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

package/convex.js

@@ -0,0 +1,8 @@
+/**
+ * @module ConvexEntrypointFallback
+ * @package @geenius/ai-workflow
+ * @description Node10-compatible subpath fallback for the Convex variant.
+ * This file exists solely to give export-map-unaware resolvers a concrete file
+ * path while delegating all runtime behavior to the built Convex package.
+ */
+export * from "./packages/convex/dist/index.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@geenius/ai-workflow",
   "type": "module",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "sideEffects": false,
   "description": "Geenius AI Workflow — Chained AI pipelines for Convex apps (React + SolidJS)",
   "author": "Mehdi Nabhani",
@@ -26,6 +26,12 @@
     "packages/convex/dist",
     "packages/react-css/dist",
     "packages/solidjs-css/dist",
+    "shared.js",
+    "react.js",
+    "react-css.js",
+    "solidjs.js",
+    "solidjs-css.js",
+    "convex.js",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -33,21 +39,43 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
     "@changesets/cli": "^2.30.0",
-    "@geenius/storybook": "^0.1.1",
-    "prettier": "^3.8.1",
+    "@geenius/storybook": "^0.3.0",
+    "prettier": "^3.8.2",
     "publint": "^0.3.18",
     "typescript": "~6.0.2",
     "vite": "^8.0.8",
     "vitest": "^4.1.4"
   },
   "dependencies": {
-    "@geenius/motion": "^0.1.3",
+    "@geenius/motion": "^0.3.0",
     "@geenius/tools": "^0.3.0",
-    "zod": "^3.23.0"
+    "zod": "^4.3.6"
   },
   "engines": {
     "node": ">=20.0.0"
   },
+  "typesVersions": {
+    "*": {
+      "shared": [
+        "./packages/shared/dist/index.d.ts"
+      ],
+      "convex": [
+        "./packages/convex/dist/index.d.ts"
+      ],
+      "react": [
+        "./packages/react/dist/index.d.ts"
+      ],
+      "react-css": [
+        "./packages/react-css/dist/index.d.ts"
+      ],
+      "solidjs": [
+        "./packages/solidjs/dist/index.d.ts"
+      ],
+      "solidjs-css": [
+        "./packages/solidjs-css/dist/index.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "types": "./packages/shared/dist/index.d.ts",
@@ -92,15 +120,15 @@
   },
   "scripts": {
     "changeset": "changeset",
-    "dev": "pnpm -r --parallel --filter './packages/*' type-check",
+    "dev": "pnpm --filter ./packages/shared build && 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",
+    "test:types": "npm_config_cache=/tmp/.npm-cache attw --pack --ignore-rules cjs-resolves-to-esm",
+    "lint": "pnpm --filter ./packages/shared build && pnpm -r --filter './packages/*' type-check",
     "lint:pub": "publint",
-    "type-check": "pnpm -r --filter './packages/*' type-check",
+    "type-check": "pnpm --filter ./packages/shared build && 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

@@ -9,6 +9,9 @@ import * as convex_values from 'convex/values';
  * entry anchors the package in Convex projects without relying on generated
  * project-local modules.
  */
+/**
+ * Convex component identifier used when mounting the workflow package.
+ */
 declare const component: convex_server.ComponentDefinition<any>;
 
 /**
@@ -152,11 +155,10 @@ 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
+ * Template version: 1.34-r3
  * Generated at: 2026-04-13
  * Convex SDK: ^1.34.0
  *
@@ -174,7 +176,7 @@ declare const fullApi: ApiFromModules<{
 
 declare const api: FilterApi<
   typeof fullApi,
-  FunctionReference<any, "public">
+  FunctionReference<"query" | "mutation" | "action", "public">
 >;
 
 /**
@@ -273,6 +275,9 @@ declare const aiWorkflowTables: {
         by_status: ["status", "_creationTime"];
     }, {}, {}>;
 };
+/**
+ * Ready-to-merge Convex schema created from the workflow table definitions.
+ */
 declare const workflowSchema: convex_server.SchemaDefinition<{
     workflows: convex_server.TableDefinition<convex_values.VObject<{
         description?: string | undefined;

package/packages/convex/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/convex.config.ts","../src/_generated/api.js","../src/schema.ts","../src/_generated/server.js","../src/mutations.ts","../src/queries.ts"],"names":["workflowStatus","v","runStatus","stepType","stepStatus"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module WorkflowConvexComponent\n * @package @geenius/ai-workflow-convex\n * @description Convex component definition for the AI workflow package. This\n * entry anchors the package in Convex projects without relying on generated\n * project-local modules.\n */\n\nimport { defineComponent } from \"convex/server\";\n\nconst component = defineComponent(\"ai_workflow\");\n\nexport default component;\n","/* eslint-disable */\n/**\n * THIS CODE IS AUTOMATICALLY GENERATED by @geenius/db codegen.\n *\n * Template version: 1.34-r2\n * Generated at: 2026-04-13\n * Convex SDK: ^1.34.0\n *\n * DO NOT EDIT THIS FILE MANUALLY.\n * To regenerate, run: geenius-convex-codegen\n * @module\n */\n\nimport { anyApi, componentsGeneric } from \"convex/server\";\n\nexport const api = anyApi;\nexport const internal = anyApi;\nexport const components = componentsGeneric();\n","/**\n * @module WorkflowConvexSchema\n * @package @geenius/ai-workflow-convex\n * @description Convex schema definitions for persisted workflows, workflow\n * runs, and per-step results. The schema mirrors the shared workflow contract\n * closely enough for typed storage without using `v.any()`.\n */\n\nimport { defineSchema, defineTable } from \"convex/server\";\nimport { v } from \"convex/values\";\n\n/**\n * Mergeable workflow table definitions that consumers spread into their own\n * Convex schema.\n */\n\nconst workflowStatus = v.union(\n  v.literal(\"draft\"),\n  v.literal(\"active\"),\n  v.literal(\"paused\"),\n  v.literal(\"archived\"),\n);\n\nconst runStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"paused\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"cancelled\"),\n);\n\nconst stepType = v.union(\n  v.literal(\"llm-call\"),\n  v.literal(\"transform\"),\n  v.literal(\"condition\"),\n  v.literal(\"human-approval\"),\n  v.literal(\"webhook\"),\n  v.literal(\"delay\"),\n  v.literal(\"parallel\"),\n  v.literal(\"loop\"),\n  v.literal(\"sub-workflow\"),\n  v.literal(\"custom\"),\n);\n\nconst stepStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"skipped\"),\n  v.literal(\"waiting-approval\"),\n);\n\n/**\n * Mergeable Convex table definitions for workflow persistence.\n */\nexport const aiWorkflowTables = {\n  workflows: defineTable({\n    name: v.string(),\n    description: v.optional(v.string()),\n    version: v.number(),\n    status: workflowStatus,\n    definitionJson: v.string(),\n    createdBy: v.string(),\n    tags: v.optional(v.array(v.string())),\n    createdAt: v.number(),\n    updatedAt: v.number(),\n  })\n    .index(\"by_status\", [\"status\"])\n    .index(\"by_createdBy\", [\"createdBy\"])\n    .index(\"by_updatedAt\", [\"updatedAt\"]),\n  workflowRuns: defineTable({\n    workflowId: v.string(),\n    workflowVersion: v.number(),\n    status: runStatus,\n    currentStepIndex: v.number(),\n    inputJson: v.optional(v.string()),\n    variablesJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    triggeredBy: v.string(),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  })\n    .index(\"by_workflowId\", [\"workflowId\"])\n    .index(\"by_status\", [\"status\"])\n    .index(\"by_startedAt\", [\"startedAt\"]),\n  workflowStepResults: defineTable({\n    runId: v.id(\"workflowRuns\"),\n    stepId: v.string(),\n    stepName: v.string(),\n    type: stepType,\n    status: stepStatus,\n    inputJson: v.optional(v.string()),\n    outputJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    durationMs: v.number(),\n    tokens: v.optional(v.number()),\n    costUsd: v.optional(v.number()),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  })\n    .index(\"by_runId\", [\"runId\"])\n    .index(\"by_status\", [\"status\"]),\n};\n\nconst workflowSchema = defineSchema(aiWorkflowTables);\n\nexport default workflowSchema;\n","/* eslint-disable */\n/**\n * THIS CODE IS AUTOMATICALLY GENERATED by @geenius/db codegen.\n *\n * Template version: 1.34-r2\n * Generated at: 2026-04-13\n * Convex SDK: ^1.34.0\n *\n * DO NOT EDIT THIS FILE MANUALLY.\n * To regenerate, run: geenius-convex-codegen\n * @module\n */\n\nimport {\n  actionGeneric,\n  httpActionGeneric,\n  queryGeneric,\n  mutationGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n} from \"convex/server\";\n\nexport const query = queryGeneric;\nexport const internalQuery = internalQueryGeneric;\nexport const mutation = mutationGeneric;\nexport const internalMutation = internalMutationGeneric;\nexport const action = actionGeneric;\nexport const internalAction = internalActionGeneric;\nexport const httpAction = httpActionGeneric;\n","/**\n * @module WorkflowConvexMutations\n * @package @geenius/ai-workflow-convex\n * @description Public Convex mutation definitions for creating workflow\n * entities in package consumers. These mutations depend only on the package-local\n * Convex shim and avoid generated project-specific modules.\n */\n\nimport { mutation } from \"./_generated/server.js\";\nimport { v } from \"convex/values\";\n\nconst workflowStatus = v.union(\n  v.literal(\"draft\"),\n  v.literal(\"active\"),\n  v.literal(\"paused\"),\n  v.literal(\"archived\"),\n);\n\nconst runStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"paused\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"cancelled\"),\n);\n\nconst stepType = v.union(\n  v.literal(\"llm-call\"),\n  v.literal(\"transform\"),\n  v.literal(\"condition\"),\n  v.literal(\"human-approval\"),\n  v.literal(\"webhook\"),\n  v.literal(\"delay\"),\n  v.literal(\"parallel\"),\n  v.literal(\"loop\"),\n  v.literal(\"sub-workflow\"),\n  v.literal(\"custom\"),\n);\n\nconst stepStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"skipped\"),\n  v.literal(\"waiting-approval\"),\n);\n\n/**\n * Creates a workflow definition record in the packaged Convex schema.\n *\n * @returns The inserted workflow document id.\n */\nexport const createWorkflow = mutation({\n  args: {\n    name: v.string(),\n    description: v.optional(v.string()),\n    version: v.number(),\n    status: workflowStatus,\n    definitionJson: v.string(),\n    createdBy: v.string(),\n    tags: v.optional(v.array(v.string())),\n    createdAt: v.number(),\n    updatedAt: v.number(),\n  },\n  returns: v.id(\"workflows\"),\n  handler: async (ctx, args) => {\n    return await ctx.db.insert(\"workflows\", { ...args });\n  },\n});\n\n/**\n * Creates a workflow run record in the packaged Convex schema.\n *\n * @returns The inserted workflow-run document id.\n */\nexport const createWorkflowRun = mutation({\n  args: {\n    workflowId: v.string(),\n    workflowVersion: v.number(),\n    status: runStatus,\n    currentStepIndex: v.number(),\n    inputJson: v.optional(v.string()),\n    variablesJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    triggeredBy: v.string(),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  },\n  returns: v.id(\"workflowRuns\"),\n  handler: async (ctx, args) => {\n    return await ctx.db.insert(\"workflowRuns\", { ...args });\n  },\n});\n\n/**\n * Creates a workflow step-result record in the packaged Convex schema.\n *\n * @returns The inserted workflow-step-result document id.\n */\nexport const createWorkflowStepResult = mutation({\n  args: {\n    runId: v.id(\"workflowRuns\"),\n    stepId: v.string(),\n    stepName: v.string(),\n    type: stepType,\n    status: stepStatus,\n    inputJson: v.optional(v.string()),\n    outputJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    durationMs: v.number(),\n    tokens: v.optional(v.number()),\n    costUsd: v.optional(v.number()),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  },\n  returns: v.id(\"workflowStepResults\"),\n  handler: async (ctx, args) => {\n    return await ctx.db.insert(\"workflowStepResults\", { ...args });\n  },\n});\n","/**\n * @module WorkflowConvexQueries\n * @package @geenius/ai-workflow-convex\n * @description Public Convex query definitions for listing workflow entities in\n * package consumers. These queries depend only on the package-local Convex shim.\n */\n\nimport { query } from \"./_generated/server.js\";\n\n/**\n * Lists stored workflow definitions from the packaged Convex schema.\n *\n * @returns All persisted workflow definitions.\n */\nexport const listWorkflows = query({\n  args: {},\n  handler: async (ctx) => {\n    return await ctx.db.query(\"workflows\").collect();\n  },\n});\n\n/**\n * Lists stored workflow run records from the packaged Convex schema.\n *\n * @returns All persisted workflow runs.\n */\nexport const listWorkflowRuns = query({\n  args: {},\n  handler: async (ctx) => {\n    return await ctx.db.query(\"workflowRuns\").collect();\n  },\n});\n\n/**\n * Lists stored per-step execution results from the packaged Convex schema.\n *\n * @returns All persisted workflow step-result records.\n */\nexport const listWorkflowStepResults = query({\n  args: {},\n  handler: async (ctx) => {\n    return await ctx.db.query(\"workflowStepResults\").collect();\n  },\n});\n"]}
+{"version":3,"sources":["../src/convex.config.ts","../src/_generated/api.js","../src/schema.ts","../src/_generated/server.js","../src/mutations.ts","../src/queries.ts"],"names":["workflowStatus","v","runStatus","stepType","stepStatus"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module WorkflowConvexComponent\n * @package @geenius/ai-workflow-convex\n * @description Convex component definition for the AI workflow package. This\n * entry anchors the package in Convex projects without relying on generated\n * project-local modules.\n */\n\nimport { defineComponent } from \"convex/server\";\n\n/**\n * Convex component identifier used when mounting the workflow package.\n */\nconst component = defineComponent(\"ai_workflow\");\n\nexport default component;\n","/**\n * THIS CODE IS AUTOMATICALLY GENERATED by @geenius/db codegen.\n *\n * Template version: 1.34-r3\n * Generated at: 2026-04-13\n * Convex SDK: ^1.34.0\n *\n * DO NOT EDIT THIS FILE MANUALLY.\n * To regenerate, run: geenius-convex-codegen\n * @module\n */\n\nimport { anyApi, componentsGeneric } from \"convex/server\";\n\nexport const api = anyApi;\nexport const internal = anyApi;\nexport const components = componentsGeneric();\n","/**\n * @module WorkflowConvexSchema\n * @package @geenius/ai-workflow-convex\n * @description Convex schema definitions for persisted workflows, workflow\n * runs, and per-step results. The schema mirrors the shared workflow contract\n * closely enough for typed storage without using `v.any()`.\n */\n\nimport { defineSchema, defineTable } from \"convex/server\";\nimport { v } from \"convex/values\";\n\n/**\n * Mergeable workflow table definitions that consumers spread into their own\n * Convex schema.\n */\n\nconst workflowStatus = v.union(\n  v.literal(\"draft\"),\n  v.literal(\"active\"),\n  v.literal(\"paused\"),\n  v.literal(\"archived\"),\n);\n\nconst runStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"paused\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"cancelled\"),\n);\n\nconst stepType = v.union(\n  v.literal(\"llm-call\"),\n  v.literal(\"transform\"),\n  v.literal(\"condition\"),\n  v.literal(\"human-approval\"),\n  v.literal(\"webhook\"),\n  v.literal(\"delay\"),\n  v.literal(\"parallel\"),\n  v.literal(\"loop\"),\n  v.literal(\"sub-workflow\"),\n  v.literal(\"custom\"),\n);\n\nconst stepStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"skipped\"),\n  v.literal(\"waiting-approval\"),\n);\n\n/**\n * Mergeable Convex table definitions for workflow persistence.\n */\nexport const aiWorkflowTables = {\n  workflows: defineTable({\n    name: v.string(),\n    description: v.optional(v.string()),\n    version: v.number(),\n    status: workflowStatus,\n    definitionJson: v.string(),\n    createdBy: v.string(),\n    tags: v.optional(v.array(v.string())),\n    createdAt: v.number(),\n    updatedAt: v.number(),\n  })\n    .index(\"by_status\", [\"status\"])\n    .index(\"by_createdBy\", [\"createdBy\"])\n    .index(\"by_updatedAt\", [\"updatedAt\"]),\n  workflowRuns: defineTable({\n    workflowId: v.string(),\n    workflowVersion: v.number(),\n    status: runStatus,\n    currentStepIndex: v.number(),\n    inputJson: v.optional(v.string()),\n    variablesJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    triggeredBy: v.string(),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  })\n    .index(\"by_workflowId\", [\"workflowId\"])\n    .index(\"by_status\", [\"status\"])\n    .index(\"by_startedAt\", [\"startedAt\"]),\n  workflowStepResults: defineTable({\n    runId: v.id(\"workflowRuns\"),\n    stepId: v.string(),\n    stepName: v.string(),\n    type: stepType,\n    status: stepStatus,\n    inputJson: v.optional(v.string()),\n    outputJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    durationMs: v.number(),\n    tokens: v.optional(v.number()),\n    costUsd: v.optional(v.number()),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  })\n    .index(\"by_runId\", [\"runId\"])\n    .index(\"by_status\", [\"status\"]),\n};\n\n/**\n * Ready-to-merge Convex schema created from the workflow table definitions.\n */\nconst workflowSchema = defineSchema(aiWorkflowTables);\n\nexport default workflowSchema;\n","/**\n * THIS CODE IS AUTOMATICALLY GENERATED by @geenius/db codegen.\n *\n * Template version: 1.34-r3\n * Generated at: 2026-04-13\n * Convex SDK: ^1.34.0\n *\n * DO NOT EDIT THIS FILE MANUALLY.\n * To regenerate, run: geenius-convex-codegen\n * @module\n */\n\nimport {\n  actionGeneric,\n  httpActionGeneric,\n  internalActionGeneric,\n  internalMutationGeneric,\n  internalQueryGeneric,\n  mutationGeneric,\n  queryGeneric,\n} from \"convex/server\";\n\nexport const query = queryGeneric;\nexport const internalQuery = internalQueryGeneric;\nexport const mutation = mutationGeneric;\nexport const internalMutation = internalMutationGeneric;\nexport const action = actionGeneric;\nexport const internalAction = internalActionGeneric;\nexport const httpAction = httpActionGeneric;\n","/**\n * @module WorkflowConvexMutations\n * @package @geenius/ai-workflow-convex\n * @description Public Convex mutation definitions for creating workflow\n * entities in package consumers. These mutations depend only on the package-local\n * Convex shim and avoid generated project-specific modules.\n */\n\nimport { mutation } from \"./_generated/server.js\";\nimport { v } from \"convex/values\";\n\nconst workflowStatus = v.union(\n  v.literal(\"draft\"),\n  v.literal(\"active\"),\n  v.literal(\"paused\"),\n  v.literal(\"archived\"),\n);\n\nconst runStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"paused\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"cancelled\"),\n);\n\nconst stepType = v.union(\n  v.literal(\"llm-call\"),\n  v.literal(\"transform\"),\n  v.literal(\"condition\"),\n  v.literal(\"human-approval\"),\n  v.literal(\"webhook\"),\n  v.literal(\"delay\"),\n  v.literal(\"parallel\"),\n  v.literal(\"loop\"),\n  v.literal(\"sub-workflow\"),\n  v.literal(\"custom\"),\n);\n\nconst stepStatus = v.union(\n  v.literal(\"pending\"),\n  v.literal(\"running\"),\n  v.literal(\"completed\"),\n  v.literal(\"failed\"),\n  v.literal(\"skipped\"),\n  v.literal(\"waiting-approval\"),\n);\n\n/**\n * Creates a workflow definition record in the packaged Convex schema.\n *\n * @returns The inserted workflow document id.\n */\nexport const createWorkflow = mutation({\n  args: {\n    name: v.string(),\n    description: v.optional(v.string()),\n    version: v.number(),\n    status: workflowStatus,\n    definitionJson: v.string(),\n    createdBy: v.string(),\n    tags: v.optional(v.array(v.string())),\n    createdAt: v.number(),\n    updatedAt: v.number(),\n  },\n  returns: v.id(\"workflows\"),\n  handler: async (ctx, args) => {\n    return await ctx.db.insert(\"workflows\", { ...args });\n  },\n});\n\n/**\n * Creates a workflow run record in the packaged Convex schema.\n *\n * @returns The inserted workflow-run document id.\n */\nexport const createWorkflowRun = mutation({\n  args: {\n    workflowId: v.string(),\n    workflowVersion: v.number(),\n    status: runStatus,\n    currentStepIndex: v.number(),\n    inputJson: v.optional(v.string()),\n    variablesJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    triggeredBy: v.string(),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  },\n  returns: v.id(\"workflowRuns\"),\n  handler: async (ctx, args) => {\n    return await ctx.db.insert(\"workflowRuns\", { ...args });\n  },\n});\n\n/**\n * Creates a workflow step-result record in the packaged Convex schema.\n *\n * @returns The inserted workflow-step-result document id.\n */\nexport const createWorkflowStepResult = mutation({\n  args: {\n    runId: v.id(\"workflowRuns\"),\n    stepId: v.string(),\n    stepName: v.string(),\n    type: stepType,\n    status: stepStatus,\n    inputJson: v.optional(v.string()),\n    outputJson: v.optional(v.string()),\n    error: v.optional(v.string()),\n    durationMs: v.number(),\n    tokens: v.optional(v.number()),\n    costUsd: v.optional(v.number()),\n    startedAt: v.number(),\n    completedAt: v.optional(v.number()),\n  },\n  returns: v.id(\"workflowStepResults\"),\n  handler: async (ctx, args) => {\n    return await ctx.db.insert(\"workflowStepResults\", { ...args });\n  },\n});\n","/**\n * @module WorkflowConvexQueries\n * @package @geenius/ai-workflow-convex\n * @description Public Convex query definitions for listing workflow entities in\n * package consumers. These queries depend only on the package-local Convex shim.\n */\n\nimport { query } from \"./_generated/server.js\";\n\n/**\n * Lists stored workflow definitions from the packaged Convex schema.\n *\n * @returns All persisted workflow definitions.\n */\nexport const listWorkflows = query({\n  args: {},\n  handler: async (ctx) => {\n    return await ctx.db.query(\"workflows\").collect();\n  },\n});\n\n/**\n * Lists stored workflow run records from the packaged Convex schema.\n *\n * @returns All persisted workflow runs.\n */\nexport const listWorkflowRuns = query({\n  args: {},\n  handler: async (ctx) => {\n    return await ctx.db.query(\"workflowRuns\").collect();\n  },\n});\n\n/**\n * Lists stored per-step execution results from the packaged Convex schema.\n *\n * @returns All persisted workflow step-result records.\n */\nexport const listWorkflowStepResults = query({\n  args: {},\n  handler: async (ctx) => {\n    return await ctx.db.query(\"workflowStepResults\").collect();\n  },\n});\n"]}

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

@@ -1,5 +1,5 @@
 import { WorkflowEngineOptions, WorkflowDefinition, WorkflowRun, WorkflowError, StepResult, WorkflowStepDef, StepConnection, RunStatus, StepStatus, WorkflowTemplate, StepType } from '@geenius/ai-workflow-shared';
-export { RunStatus, StepConfig, StepResult, StepStatus, StepType, WORKFLOW_TEMPLATES, WorkflowBuilderState, WorkflowDefinition, WorkflowEngine, WorkflowRun, WorkflowStatus, WorkflowStepDef, validateWorkflow } from '@geenius/ai-workflow-shared';
+export { RunStatus, StepConfig, StepResult, StepStatus, StepType, WORKFLOW_TEMPLATES, WorkflowBuilderState, WorkflowDefinition, WorkflowEngine, WorkflowRun, WorkflowStatus, WorkflowStepDef, getTemplate, getTemplatesByCategory, validateRun, validateWorkflow } from '@geenius/ai-workflow-shared';
 import { ReactElement } from 'react';
 
 /**
@@ -12,6 +12,12 @@ import { ReactElement } from 'react';
 
 /**
  * Runtime integrations accepted by the React workflow hook.
+ *
+ * @property callLLM Optional LLM execution callback inherited from `WorkflowEngineOptions`.
+ * @property callWebhook Optional webhook execution callback inherited from `WorkflowEngineOptions`.
+ * @property onApprovalRequired Optional approval callback inherited from `WorkflowEngineOptions`.
+ * @property onStepComplete Optional per-step completion callback inherited from `WorkflowEngineOptions`.
+ * @property customHandlers Optional custom step-handler registry inherited from `WorkflowEngineOptions`.
  */
 interface UseWorkflowOptions extends WorkflowEngineOptions {
 }
@@ -82,6 +88,10 @@ declare function useWorkflowBuilder(initial?: Partial<WorkflowDefinition>): {
 
 /**
  * Runtime options for workflow run tracking.
+ *
+ * @property pollIntervalMs Reserved polling interval for future remote sync.
+ * @property onStepComplete Optional callback fired whenever a step result changes.
+ * @property onRunComplete Optional callback fired when the run reaches a terminal state.
  */
 interface UseWorkflowRunOptions {
     /** Poll interval for checking run status (ms) */
@@ -151,6 +161,12 @@ declare function useWorkflowStep(stepDef: WorkflowStepDef): UseWorkflowStepResul
  */
 /**
  * Pending approval request exposed to the UI layer.
+ *
+ * @property id Stable approval-request identifier.
+ * @property stepId Workflow step awaiting the operator decision.
+ * @property message Approval prompt shown to the operator.
+ * @property requestedAt Unix timestamp for when the approval was created.
+ * @property approvers Optional list of users or roles allowed to approve.
  */
 interface ApprovalRequest {
     id: string;
@@ -262,6 +278,11 @@ declare function StepNode({ step, isSelected, status, onClick, className, }: Ste
 
 /**
  * Props for a workflow step connector path.
+ *
+ * @property from Starting node position for the connector.
+ * @property to Ending node position for the connector.
+ * @property label Optional inline label rendered above the curve.
+ * @property isActive Whether the connector should use the emphasized active style.
  */
 interface StepConnectorProps {
     from: {
@@ -293,6 +314,11 @@ declare function StepConnector({ from, to, label, isActive }: StepConnectorProps
 
 /**
  * Props for the workflow step configuration panel.
+ *
+ * @property step Shared workflow step being edited in the panel.
+ * @property onUpdate Callback that persists partial step updates.
+ * @property onDelete Callback that removes the selected step.
+ * @property onClose Callback that closes the panel without mutating state.
  */
 interface StepConfigPanelProps {
     step: WorkflowStepDef;
@@ -338,6 +364,11 @@ declare function WorkflowRunPanel({ run, isRunning, onCancel, }: WorkflowRunPane
 
 /**
  * Props for the workflow approval dialog.
+ *
+ * @property request Pending approval request to render, or `null` when idle.
+ * @property onApprove Callback that approves the active request by id.
+ * @property onReject Callback that rejects the active request by id.
+ * @property onDismiss Optional callback used for Escape-key and dismiss flows.
  */
 interface ApprovalModalProps {
     request: ApprovalRequest | null;
@@ -363,6 +394,19 @@ declare function ApprovalModal(props: ApprovalModalProps): ReactElement;
 
 /**
  * Props for the workflow toolbar action surface.
+ *
+ * @property workflowName Human-readable workflow name shown in the title slot.
+ * @property isDirty Whether unsaved edits are currently present.
+ * @property isRunning Whether a run is currently active.
+ * @property canUndo Whether the undo action should be enabled.
+ * @property canRedo Whether the redo action should be enabled.
+ * @property onSave Callback that persists the current workflow definition.
+ * @property onRun Callback that starts a workflow run.
+ * @property onCancel Optional callback that stops an in-flight run.
+ * @property onUndo Callback that restores the previous builder snapshot.
+ * @property onRedo Callback that reapplies the next builder snapshot.
+ * @property onExport Optional callback that exports the workflow definition.
+ * @property className Optional class-name override for the toolbar container.
  */
 interface WorkflowToolbarProps {
     workflowName: string;
@@ -449,6 +493,10 @@ declare function WorkflowBuilderPage({ engineOptions, onSave, className, workflo
 
 /**
  * Props for the workflow runs history page.
+ *
+ * @property runs Workflow run records rendered on the page.
+ * @property onSelectRun Optional callback fired when a run card is selected.
+ * @property className Optional class-name override for the page container.
  */
 interface WorkflowRunsPageProps {
     runs: WorkflowRun[];