@geenius/ai-workflow 0.4.0 → 0.6.0

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

@@ -458,6 +458,12 @@ interface WorkflowBuilderState {
  *
  * The engine stays framework-agnostic by requiring callers to provide LLM,
  * webhook, approval, and custom-step integrations explicitly.
+ *
+ * @property callLLM Optional callback used to execute `llm-call` steps.
+ * @property callWebhook Optional callback used to execute `webhook` steps.
+ * @property onApprovalRequired Optional callback used for `human-approval` steps.
+ * @property onStepComplete Optional callback invoked after each step result is captured.
+ * @property customHandlers Optional registry of named handlers for `custom` steps.
  */
 interface WorkflowEngineOptions {
     /** LLM call function for llm-call steps */
@@ -661,7 +667,7 @@ declare const stepConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     handler: z.ZodString;
     params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     outputVar: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "type">;
 /**
  * Zod schema for one workflow step definition.
  */
@@ -742,7 +748,7 @@ declare const workflowStepDefSchema: z.ZodObject<{
         handler: z.ZodString;
         params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         outputVar: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>]>;
+    }, z.core.$strip>], "type">;
     position: z.ZodOptional<z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -869,7 +875,7 @@ declare const workflowDefinitionSchema: z.ZodObject<{
             handler: z.ZodString;
             params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             outputVar: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>]>;
+        }, z.core.$strip>], "type">;
         position: z.ZodOptional<z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
@@ -1217,12 +1223,17 @@ declare function evaluateExpression(expression: string, context: Record<string,
  */
 /**
  * Minimal graph node shape accepted by DAG helpers.
+ *
+ * @property id Stable node identifier used in graph traversal.
  */
 interface DAGNode {
     id: string;
 }
 /**
  * Minimal graph edge shape accepted by DAG helpers.
+ *
+ * @property from Source node identifier.
+ * @property to Destination node identifier.
  */
 interface DAGEdge {
     from: string;
@@ -1291,78 +1302,4 @@ declare function calculateRunCost(results: StepResult[]): {
 /** Format cost as a human-readable string */
 declare function formatCost(usd: number): string;
 
-/**
- * @module WorkflowConvexSchemaFields
- * @package @geenius/ai-workflow-shared
- * @description Typed Convex-style schema manifests for the workflow package.
- * These structured objects preserve field shape so consumers can persist and
- * query workflow payloads without losing typed storage metadata.
- */
-type LiteralField<T extends string | number | boolean> = {
-    type: 'literal';
-    value: T;
-    optional?: true;
-};
-type StringField = {
-    type: 'string';
-    optional?: true;
-};
-type NumberField = {
-    type: 'number';
-    optional?: true;
-};
-type BooleanField = {
-    type: 'boolean';
-    optional?: true;
-};
-type UnknownField = {
-    type: 'any';
-    optional?: true;
-};
-type ArrayField = {
-    type: 'array';
-    items: SchemaField;
-    optional?: true;
-};
-type RecordField = {
-    type: 'record';
-    key: SchemaField;
-    value: SchemaField;
-    optional?: true;
-};
-type ObjectField = {
-    type: 'object';
-    fields: Record<string, SchemaField>;
-    optional?: true;
-};
-type UnionField = {
-    type: 'union';
-    values: SchemaField[];
-    optional?: true;
-};
-/**
- * Typed schema field descriptor used to describe Convex document shapes.
- */
-type SchemaField = LiteralField<string | number | boolean> | StringField | NumberField | BooleanField | UnknownField | ArrayField | RecordField | ObjectField | UnionField;
-/**
- * Manifest describing persisted workflow definition documents.
- */
-declare const workflowsTable: ObjectField;
-/**
- * Manifest describing persisted workflow execution run documents.
- */
-declare const workflowRunsTable: ObjectField;
-/**
- * Manifest describing persisted per-step execution result documents.
- */
-declare const workflowStepResultsTable: ObjectField;
-/**
- * Named collection of all workflow table manifests for consumer schema merges.
- */
-declare const workflowTables: {
-    workflows: ObjectField;
-    workflowRuns: ObjectField;
-    workflowStepResults: ObjectField;
-};
-
-export { type ConditionConfig, type ConfigureWorkflowOptions, type CustomStepConfig, type DAGEdge, type DAGNode, type DelayConfig, type HumanApprovalConfig, type LLMCallConfig, type LoopConfig, MODEL_RATES, type ParallelConfig, type RunStatus, type StepConfig, type StepConnection, type StepResult, type StepStatus, type StepType, type SubWorkflowConfig, type TransformConfig, WORKFLOW_TEMPLATES, type WebhookConfig, type WorkflowBuilderState, WorkflowConfigurationError, type WorkflowDefinition, WorkflowEngine, type WorkflowEngineOptions, WorkflowError, type WorkflowErrorContext, WorkflowExecutionError, WorkflowExpressionError, WorkflowGraphError, type WorkflowRun, type WorkflowStatus, type WorkflowStepDef, type WorkflowTemplate, type WorkflowVariable, approvalStep, calculateRunCost, conditionStep, configureWorkflow, connect, defaultWorkflowConfig, delayStep, detectCycle, estimateStepCost, estimateStepTokens, estimateTokens, estimateWorkflowCost, evaluateExpression, extractVariables, findEntryNodes, findExitNodes, findMissingVariables, findPaths, formatCost, getTemplate, getTemplatesByCategory, interpolate, linearWorkflow, llmStep, normalizeWorkflowError, stepConfigSchema, stepConnectionSchema, stepResultSchema, topoSort, transformStep, validateConnectionIntegrity, validateRun, validateWorkflow, webhookStep, workflowDefinitionSchema, workflowRunSchema, workflowRunsTable, workflowStepDefSchema, workflowStepResultsTable, workflowTables, workflowVariableSchema, workflowsTable };
+export { type ConditionConfig, type ConfigureWorkflowOptions, type CustomStepConfig, type DAGEdge, type DAGNode, type DelayConfig, type HumanApprovalConfig, type LLMCallConfig, type LoopConfig, MODEL_RATES, type ParallelConfig, type RunStatus, type StepConfig, type StepConnection, type StepResult, type StepStatus, type StepType, type SubWorkflowConfig, type TransformConfig, WORKFLOW_TEMPLATES, type WebhookConfig, type WorkflowBuilderState, WorkflowConfigurationError, type WorkflowDefinition, WorkflowEngine, type WorkflowEngineOptions, WorkflowError, type WorkflowErrorContext, WorkflowExecutionError, WorkflowExpressionError, WorkflowGraphError, type WorkflowRun, type WorkflowStatus, type WorkflowStepDef, type WorkflowTemplate, type WorkflowVariable, approvalStep, calculateRunCost, conditionStep, configureWorkflow, connect, defaultWorkflowConfig, delayStep, detectCycle, estimateStepCost, estimateStepTokens, estimateTokens, estimateWorkflowCost, evaluateExpression, extractVariables, findEntryNodes, findExitNodes, findMissingVariables, findPaths, formatCost, getTemplate, getTemplatesByCategory, interpolate, linearWorkflow, llmStep, normalizeWorkflowError, stepConfigSchema, stepConnectionSchema, stepResultSchema, topoSort, transformStep, validateConnectionIntegrity, validateRun, validateWorkflow, webhookStep, workflowDefinitionSchema, workflowRunSchema, workflowStepDefSchema, workflowVariableSchema };

package/packages/shared/dist/index.js

@@ -1589,93 +1589,6 @@ function getTemplatesByCategory(category) {
   return WORKFLOW_TEMPLATES.filter((t) => t.category === category);
 }
 
-// src/convex/schemas.ts
-var stringField = (optional = false) => ({ type: "string", ...optional ? { optional: true } : {} });
-var numberField = (optional = false) => ({ type: "number", ...optional ? { optional: true } : {} });
-var unknownField = (optional = false) => ({ type: "any", ...optional ? { optional: true } : {} });
-var literalField = (value, optional = false) => ({ type: "literal", value, ...optional ? { optional: true } : {} });
-var arrayField = (items, optional = false) => ({ type: "array", items, ...optional ? { optional: true } : {} });
-var recordField = (key, value, optional = false) => ({ type: "record", key, value, ...optional ? { optional: true } : {} });
-var objectField = (fields, optional = false) => ({ type: "object", fields, ...optional ? { optional: true } : {} });
-var unionField = (values, optional = false) => ({ type: "union", values, ...optional ? { optional: true } : {} });
-var workflowsTable = objectField({
-  name: stringField(),
-  description: stringField(true),
-  version: numberField(),
-  status: unionField([
-    literalField("draft"),
-    literalField("active"),
-    literalField("archived"),
-    literalField("error")
-  ]),
-  definition: objectField({
-    id: stringField(),
-    name: stringField(),
-    description: stringField(true),
-    version: numberField(),
-    status: stringField(),
-    steps: arrayField(unknownField()),
-    connections: arrayField(unknownField()),
-    inputSchema: arrayField(unknownField(), true),
-    variables: recordField(stringField(), unknownField(), true),
-    tags: arrayField(stringField(), true),
-    createdBy: stringField(),
-    createdAt: numberField(),
-    updatedAt: numberField()
-  }),
-  createdBy: stringField(),
-  tags: arrayField(stringField(), true),
-  createdAt: numberField(),
-  updatedAt: numberField()
-});
-var workflowRunsTable = objectField({
-  workflowId: stringField(),
-  workflowVersion: numberField(),
-  status: unionField([
-    literalField("pending"),
-    literalField("running"),
-    literalField("paused"),
-    literalField("completed"),
-    literalField("failed"),
-    literalField("cancelled")
-  ]),
-  input: recordField(stringField(), unknownField(), true),
-  variables: recordField(stringField(), unknownField(), true),
-  currentStepIndex: numberField(),
-  stepResults: arrayField(unknownField(), true),
-  error: stringField(true),
-  triggeredBy: stringField(),
-  startedAt: numberField(),
-  completedAt: numberField(true)
-});
-var workflowStepResultsTable = objectField({
-  runId: stringField(),
-  stepId: stringField(),
-  stepName: stringField(),
-  type: stringField(),
-  status: unionField([
-    literalField("pending"),
-    literalField("running"),
-    literalField("completed"),
-    literalField("failed"),
-    literalField("skipped"),
-    literalField("waiting-approval")
-  ]),
-  input: recordField(stringField(), unknownField(), true),
-  output: unknownField(true),
-  error: stringField(true),
-  durationMs: numberField(),
-  tokens: numberField(true),
-  costUsd: numberField(true),
-  startedAt: numberField(),
-  completedAt: numberField(true)
-});
-var workflowTables = {
-  workflows: workflowsTable,
-  workflowRuns: workflowRunsTable,
-  workflowStepResults: workflowStepResultsTable
-};
-
-export { MODEL_RATES, WORKFLOW_TEMPLATES, WorkflowConfigurationError, WorkflowEngine, WorkflowError, WorkflowExecutionError, WorkflowExpressionError, WorkflowGraphError, approvalStep, calculateRunCost, conditionStep, configureWorkflow, connect, defaultWorkflowConfig, delayStep, detectCycle, estimateStepCost, estimateStepTokens, estimateTokens, estimateWorkflowCost, evaluateExpression, extractVariables, findEntryNodes, findExitNodes, findMissingVariables, findPaths, formatCost, getTemplate, getTemplatesByCategory, interpolate, linearWorkflow, llmStep, normalizeWorkflowError, stepConfigSchema, stepConnectionSchema, stepResultSchema, topoSort, transformStep, validateConnectionIntegrity, validateRun, validateWorkflow, webhookStep, workflowDefinitionSchema, workflowRunSchema, workflowRunsTable, workflowStepDefSchema, workflowStepResultsTable, workflowTables, workflowVariableSchema, workflowsTable };
+export { MODEL_RATES, WORKFLOW_TEMPLATES, WorkflowConfigurationError, WorkflowEngine, WorkflowError, WorkflowExecutionError, WorkflowExpressionError, WorkflowGraphError, approvalStep, calculateRunCost, conditionStep, configureWorkflow, connect, defaultWorkflowConfig, delayStep, detectCycle, estimateStepCost, estimateStepTokens, estimateTokens, estimateWorkflowCost, evaluateExpression, extractVariables, findEntryNodes, findExitNodes, findMissingVariables, findPaths, formatCost, getTemplate, getTemplatesByCategory, interpolate, linearWorkflow, llmStep, normalizeWorkflowError, stepConfigSchema, stepConnectionSchema, stepResultSchema, topoSort, transformStep, validateConnectionIntegrity, validateRun, validateWorkflow, webhookStep, workflowDefinitionSchema, workflowRunSchema, workflowStepDefSchema, workflowVariableSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map