@elqnt/workflow 2.1.4 → 2.2.0

package/dist/components/index.d.ts

@@ -0,0 +1,245 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { JSONSchema } from '@elqnt/types';
+
+interface DynamicSchemaFormUIComponents {
+    Input: React.ComponentType<{
+        type?: string;
+        value: any;
+        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+        disabled?: boolean;
+        className?: string;
+        placeholder?: string;
+        min?: number;
+        max?: number;
+        step?: string | number;
+    }>;
+    Label: React.ComponentType<{
+        htmlFor?: string;
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    Textarea: React.ComponentType<{
+        value: any;
+        onChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+        disabled?: boolean;
+        rows?: number;
+        className?: string;
+        placeholder?: string;
+    }>;
+    Checkbox: React.ComponentType<{
+        id?: string;
+        checked: boolean;
+        onCheckedChange: (checked: boolean) => void;
+        disabled?: boolean;
+    }>;
+    Select: React.ComponentType<{
+        value: string;
+        onValueChange: (value: string) => void;
+        disabled?: boolean;
+        children: React.ReactNode;
+    }>;
+    SelectTrigger: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    SelectValue: React.ComponentType<{
+        placeholder?: string;
+    }>;
+    SelectContent: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    SelectItem: React.ComponentType<{
+        value: string;
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    Button: React.ComponentType<{
+        type?: "button" | "submit" | "reset";
+        variant?: string;
+        size?: string;
+        className?: string;
+        onClick?: () => void;
+        disabled?: boolean;
+        children: React.ReactNode;
+    }>;
+    Card: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    PlusIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    TrashIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    ChevronDownIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    ChevronRightIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    VariableIcon?: React.ComponentType<{
+        className?: string;
+    }>;
+    CheckIcon?: React.ComponentType<{
+        className?: string;
+    }>;
+    EditIcon?: React.ComponentType<{
+        className?: string;
+    }>;
+    Popover?: React.ComponentType<{
+        open?: boolean;
+        onOpenChange?: (open: boolean) => void;
+        children: React.ReactNode;
+    }>;
+    PopoverTrigger?: React.ComponentType<{
+        asChild?: boolean;
+        children: React.ReactNode;
+    }>;
+    PopoverContent?: React.ComponentType<{
+        className?: string;
+        align?: "start" | "center" | "end";
+        children: React.ReactNode;
+    }>;
+    Dialog?: React.ComponentType<{
+        open?: boolean;
+        onOpenChange?: (open: boolean) => void;
+        children: React.ReactNode;
+    }>;
+    DialogContent?: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    DialogHeader?: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    DialogTitle?: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    DialogFooter?: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    ScrollArea?: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    MarkdownEditor?: React.ComponentType<{
+        content: string;
+        onChange: (markdown: string) => void;
+        placeholder?: string;
+        className?: string;
+        readOnly?: boolean;
+        minHeight?: string;
+        variables?: Array<{
+            name: string;
+            path: string;
+            title?: string;
+        }>;
+    }>;
+    cn: (...classes: (string | undefined | null | false)[]) => string;
+}
+/**
+ * Variable definition for workflow variables
+ */
+interface WorkflowVariable {
+    name: string;
+    type: string;
+    title?: string;
+    path: string;
+}
+interface DynamicSchemaFormProps {
+    schema: JSONSchema;
+    value: any;
+    onChange: (value: any) => void;
+    disabled?: boolean;
+    path?: string[];
+    components: DynamicSchemaFormUIComponents;
+    /** Workflow variables available for selection */
+    variables?: WorkflowVariable[];
+    /** Whether to show variable picker buttons */
+    showVariablePicker?: boolean;
+}
+declare function DynamicSchemaForm({ schema, value, onChange, disabled, path, components, variables, showVariablePicker, }: DynamicSchemaFormProps): react_jsx_runtime.JSX.Element;
+
+interface SchemaBuilderUIComponents {
+    Input: React.ComponentType<{
+        value: any;
+        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+        disabled?: boolean;
+        className?: string;
+        placeholder?: string;
+    }>;
+    Label: React.ComponentType<{
+        htmlFor?: string;
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    Checkbox: React.ComponentType<{
+        id?: string;
+        checked: boolean;
+        onCheckedChange: (checked: boolean) => void;
+        disabled?: boolean;
+    }>;
+    Select: React.ComponentType<{
+        value: string;
+        onValueChange: (value: string) => void;
+        disabled?: boolean;
+        children: React.ReactNode;
+    }>;
+    SelectTrigger: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    SelectValue: React.ComponentType<{
+        placeholder?: string;
+    }>;
+    SelectContent: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    SelectItem: React.ComponentType<{
+        value: string;
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    Button: React.ComponentType<{
+        type?: "button" | "submit" | "reset";
+        variant?: string;
+        size?: string;
+        className?: string;
+        onClick?: () => void;
+        disabled?: boolean;
+        children: React.ReactNode;
+    }>;
+    Card: React.ComponentType<{
+        className?: string;
+        children: React.ReactNode;
+    }>;
+    PlusIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    TrashIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    GripVerticalIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    ChevronDownIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    ChevronRightIcon: React.ComponentType<{
+        className?: string;
+    }>;
+    cn: (...classes: (string | undefined | null | false)[]) => string;
+}
+interface SchemaBuilderProps {
+    schema: JSONSchema;
+    onChange: (schema: JSONSchema) => void;
+    disabled?: boolean;
+    components: SchemaBuilderUIComponents;
+}
+declare function SchemaBuilder({ schema, onChange, disabled, components, }: SchemaBuilderProps): react_jsx_runtime.JSX.Element;
+
+export { DynamicSchemaForm, type DynamicSchemaFormProps, type DynamicSchemaFormUIComponents, SchemaBuilder, type SchemaBuilderProps, type SchemaBuilderUIComponents, type WorkflowVariable };

package/dist/components/index.js

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+
+var _chunk3GG6KTGJjs = require('../chunk-3GG6KTGJ.js');
+
+
+
+exports.DynamicSchemaForm = _chunk3GG6KTGJjs.DynamicSchemaForm; exports.SchemaBuilder = _chunk3GG6KTGJjs.SchemaBuilder;
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/eloquent/eloquent/packages/@elqnt/workflow/dist/components/index.js"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACF,uDAA6B;AAC7B;AACE;AACA;AACF,uHAAC","file":"/home/runner/work/eloquent/eloquent/packages/@elqnt/workflow/dist/components/index.js"}

package/dist/components/index.mjs

@@ -0,0 +1,10 @@
+"use client";
+import {
+  DynamicSchemaForm,
+  SchemaBuilder
+} from "../chunk-AXXQSYT7.mjs";
+export {
+  DynamicSchemaForm,
+  SchemaBuilder
+};
+//# sourceMappingURL=index.mjs.map

package/dist/components/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks/index.d.mts

@@ -6,84 +6,129 @@ import '@elqnt/types';
 
 type UseWorkflowsOptions = ApiClientOptions;
 /**
- * Hook for workflow definition CRUD operations
+ * The exact, stable return surface of `useWorkflows`.
  *
- * @example
- * ```tsx
- * const { loading, error, listWorkflows, createWorkflow } = useWorkflows({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- * });
- *
- * const workflows = await listWorkflows();
- * ```
+ * This is the agent/consumer **contract**: the only methods that exist on the
+ * workflow-definitions hook. Every method is imperative and DOES NOT throw — on
+ * failure it resolves to the documented default and sets `error`. See `SKILL.md`.
  */
-declare function useWorkflows(options: UseWorkflowsOptions): {
+interface UseWorkflowsReturn {
+    /** True while any method is in flight. */
     loading: boolean;
+    /** Latest method error, else null. */
     error: string | null;
+    /** GET /api/v1/workflows — default `[]` on error. */
     listWorkflows: () => Promise<WorkflowDefinition[]>;
+    /** GET /api/v1/workflows/{id} — default `null`. */
     getWorkflow: (workflowId: string) => Promise<WorkflowDefinition | null>;
+    /** POST /api/v1/workflows — created definition, or `null` on error. */
     createWorkflow: (workflow: Partial<WorkflowDefinition>) => Promise<WorkflowDefinition | null>;
+    /** PUT /api/v1/workflows/{id} — updated definition, or `null` on error. */
     updateWorkflow: (workflowId: string, workflow: Partial<WorkflowDefinition>) => Promise<WorkflowDefinition | null>;
+    /** DELETE /api/v1/workflows/{id} — `true`/`false`. */
     deleteWorkflow: (workflowId: string) => Promise<boolean>;
-};
-
-type UseWorkflowInstancesOptions = ApiClientOptions;
+}
 /**
- * Hook for workflow instance operations
+ * Hook for workflow definition CRUD operations
  *
  * @example
  * ```tsx
- * const { listInstances, getInstance, createInstance } = useWorkflowInstances({
+ * const { loading, error, listWorkflows, createWorkflow } = useWorkflows({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
  * });
  *
- * const instances = await listInstances(definitionId);
+ * const workflows = await listWorkflows();
  * ```
  */
-declare function useWorkflowInstances(options: UseWorkflowInstancesOptions): {
+declare function useWorkflows(options: UseWorkflowsOptions): UseWorkflowsReturn;
+
+type UseWorkflowInstancesOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useWorkflowInstances`.
+ *
+ * This is the agent/consumer **contract**: the only methods that exist on the
+ * workflow-instances hook. Every method is imperative and DOES NOT throw — on
+ * failure it resolves to the documented default and sets `error`. See `SKILL.md`.
+ */
+interface UseWorkflowInstancesReturn {
+    /** True while any method is in flight. */
     loading: boolean;
+    /** Latest method error, else null. */
     error: string | null;
+    /** GET /api/v1/workflows/{definitionId}/instances(?userId=&status=) — default `[]`. */
     listInstances: (definitionId: string, filters?: {
         userId?: string;
         status?: string;
     }) => Promise<WorkflowInstance[]>;
+    /** GET /api/v1/workflows/instances/{id} — default `null`. */
     getInstance: (instanceId: string) => Promise<WorkflowInstance | null>;
+    /** POST /api/v1/workflows/{definitionId}/instances — new instance, or `null`. */
     createInstance: (definitionId: string, data?: {
         variables?: Record<string, unknown>;
         autoExecute?: boolean;
     }) => Promise<WorkflowInstance | null>;
+    /** PUT /api/v1/workflows/instances/{id}/status — updated instance, or `null`. */
     updateStatus: (instanceId: string, status: string) => Promise<WorkflowInstance | null>;
+    /** POST .../instances/{id}/nodes/{nodeId}/execute — node output, or `null`. */
     executeNode: (instanceId: string, nodeId: string, input: Record<string, unknown>) => Promise<Record<string, unknown> | null>;
+    /** POST .../instances/{id}/nodes/{nodeId}/resume — updated instance, or `null`. */
     resumeNode: (instanceId: string, nodeId: string, result: Record<string, unknown>) => Promise<WorkflowInstance | null>;
+    /** POST .../instances/{id}/nodes/{nodeId}/retry — updated instance, or `null`. */
     retryNode: (instanceId: string, nodeId: string) => Promise<WorkflowInstance | null>;
-};
-
-type UseWorkflowTemplatesOptions = ApiClientOptions;
+}
 /**
- * Hook for workflow template operations
+ * Hook for workflow instance operations
  *
  * @example
  * ```tsx
- * const { listTemplates, getTemplate, instantiateTemplate } = useWorkflowTemplates({
+ * const { listInstances, getInstance, createInstance } = useWorkflowInstances({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
  * });
  *
- * const templates = await listTemplates();
+ * const instances = await listInstances(definitionId);
  * ```
  */
-declare function useWorkflowTemplates(options: UseWorkflowTemplatesOptions): {
+declare function useWorkflowInstances(options: UseWorkflowInstancesOptions): UseWorkflowInstancesReturn;
+
+type UseWorkflowTemplatesOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useWorkflowTemplates`.
+ *
+ * This is the agent/consumer **contract**: the only methods that exist on the
+ * workflow-templates hook. Every method is imperative and DOES NOT throw — on
+ * failure it resolves to the documented default and sets `error`. See `SKILL.md`.
+ */
+interface UseWorkflowTemplatesReturn {
+    /** True while any method is in flight. */
     loading: boolean;
+    /** Latest method error, else null. */
     error: string | null;
+    /** GET /api/v1/workflows/templates(?category=) — default `[]` on error. */
     listTemplates: (category?: string) => Promise<WorkflowTemplate[]>;
+    /** GET /api/v1/workflows/templates/{id} — default `null`. */
     getTemplate: (templateId: string) => Promise<WorkflowTemplate | null>;
+    /** POST /api/v1/workflows/templates/{id}/instantiate — new definition, or `null`. */
     instantiateTemplate: (templateId: string, params: {
         variables: Record<string, unknown>;
         title?: string;
     }) => Promise<WorkflowDefinition | null>;
-};
+}
+/**
+ * Hook for workflow template operations
+ *
+ * @example
+ * ```tsx
+ * const { listTemplates, getTemplate, instantiateTemplate } = useWorkflowTemplates({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const templates = await listTemplates();
+ * ```
+ */
+declare function useWorkflowTemplates(options: UseWorkflowTemplatesOptions): UseWorkflowTemplatesReturn;
 
 /**
  * Keep a mutable ref synchronized with the latest value
@@ -104,4 +149,4 @@ declare function useWorkflowTemplates(options: UseWorkflowTemplatesOptions): {
  */
 declare function useOptionsRef<T>(options: T): React.MutableRefObject<T>;
 
-export { type UseWorkflowInstancesOptions, type UseWorkflowTemplatesOptions, type UseWorkflowsOptions, useOptionsRef, useWorkflowInstances, useWorkflowTemplates, useWorkflows };
+export { type UseWorkflowInstancesOptions, type UseWorkflowInstancesReturn, type UseWorkflowTemplatesOptions, type UseWorkflowTemplatesReturn, type UseWorkflowsOptions, type UseWorkflowsReturn, useOptionsRef, useWorkflowInstances, useWorkflowTemplates, useWorkflows };

package/dist/hooks/index.d.ts

@@ -6,84 +6,129 @@ import '@elqnt/types';
 
 type UseWorkflowsOptions = ApiClientOptions;
 /**
- * Hook for workflow definition CRUD operations
+ * The exact, stable return surface of `useWorkflows`.
  *
- * @example
- * ```tsx
- * const { loading, error, listWorkflows, createWorkflow } = useWorkflows({
- *   baseUrl: apiGatewayUrl,
- *   orgId: selectedOrgId,
- * });
- *
- * const workflows = await listWorkflows();
- * ```
+ * This is the agent/consumer **contract**: the only methods that exist on the
+ * workflow-definitions hook. Every method is imperative and DOES NOT throw — on
+ * failure it resolves to the documented default and sets `error`. See `SKILL.md`.
  */
-declare function useWorkflows(options: UseWorkflowsOptions): {
+interface UseWorkflowsReturn {
+    /** True while any method is in flight. */
     loading: boolean;
+    /** Latest method error, else null. */
     error: string | null;
+    /** GET /api/v1/workflows — default `[]` on error. */
     listWorkflows: () => Promise<WorkflowDefinition[]>;
+    /** GET /api/v1/workflows/{id} — default `null`. */
     getWorkflow: (workflowId: string) => Promise<WorkflowDefinition | null>;
+    /** POST /api/v1/workflows — created definition, or `null` on error. */
     createWorkflow: (workflow: Partial<WorkflowDefinition>) => Promise<WorkflowDefinition | null>;
+    /** PUT /api/v1/workflows/{id} — updated definition, or `null` on error. */
     updateWorkflow: (workflowId: string, workflow: Partial<WorkflowDefinition>) => Promise<WorkflowDefinition | null>;
+    /** DELETE /api/v1/workflows/{id} — `true`/`false`. */
     deleteWorkflow: (workflowId: string) => Promise<boolean>;
-};
-
-type UseWorkflowInstancesOptions = ApiClientOptions;
+}
 /**
- * Hook for workflow instance operations
+ * Hook for workflow definition CRUD operations
  *
  * @example
  * ```tsx
- * const { listInstances, getInstance, createInstance } = useWorkflowInstances({
+ * const { loading, error, listWorkflows, createWorkflow } = useWorkflows({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
  * });
  *
- * const instances = await listInstances(definitionId);
+ * const workflows = await listWorkflows();
  * ```
  */
-declare function useWorkflowInstances(options: UseWorkflowInstancesOptions): {
+declare function useWorkflows(options: UseWorkflowsOptions): UseWorkflowsReturn;
+
+type UseWorkflowInstancesOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useWorkflowInstances`.
+ *
+ * This is the agent/consumer **contract**: the only methods that exist on the
+ * workflow-instances hook. Every method is imperative and DOES NOT throw — on
+ * failure it resolves to the documented default and sets `error`. See `SKILL.md`.
+ */
+interface UseWorkflowInstancesReturn {
+    /** True while any method is in flight. */
     loading: boolean;
+    /** Latest method error, else null. */
     error: string | null;
+    /** GET /api/v1/workflows/{definitionId}/instances(?userId=&status=) — default `[]`. */
     listInstances: (definitionId: string, filters?: {
         userId?: string;
         status?: string;
     }) => Promise<WorkflowInstance[]>;
+    /** GET /api/v1/workflows/instances/{id} — default `null`. */
     getInstance: (instanceId: string) => Promise<WorkflowInstance | null>;
+    /** POST /api/v1/workflows/{definitionId}/instances — new instance, or `null`. */
     createInstance: (definitionId: string, data?: {
         variables?: Record<string, unknown>;
         autoExecute?: boolean;
     }) => Promise<WorkflowInstance | null>;
+    /** PUT /api/v1/workflows/instances/{id}/status — updated instance, or `null`. */
     updateStatus: (instanceId: string, status: string) => Promise<WorkflowInstance | null>;
+    /** POST .../instances/{id}/nodes/{nodeId}/execute — node output, or `null`. */
     executeNode: (instanceId: string, nodeId: string, input: Record<string, unknown>) => Promise<Record<string, unknown> | null>;
+    /** POST .../instances/{id}/nodes/{nodeId}/resume — updated instance, or `null`. */
     resumeNode: (instanceId: string, nodeId: string, result: Record<string, unknown>) => Promise<WorkflowInstance | null>;
+    /** POST .../instances/{id}/nodes/{nodeId}/retry — updated instance, or `null`. */
     retryNode: (instanceId: string, nodeId: string) => Promise<WorkflowInstance | null>;
-};
-
-type UseWorkflowTemplatesOptions = ApiClientOptions;
+}
 /**
- * Hook for workflow template operations
+ * Hook for workflow instance operations
  *
  * @example
  * ```tsx
- * const { listTemplates, getTemplate, instantiateTemplate } = useWorkflowTemplates({
+ * const { listInstances, getInstance, createInstance } = useWorkflowInstances({
  *   baseUrl: apiGatewayUrl,
  *   orgId: selectedOrgId,
  * });
  *
- * const templates = await listTemplates();
+ * const instances = await listInstances(definitionId);
  * ```
  */
-declare function useWorkflowTemplates(options: UseWorkflowTemplatesOptions): {
+declare function useWorkflowInstances(options: UseWorkflowInstancesOptions): UseWorkflowInstancesReturn;
+
+type UseWorkflowTemplatesOptions = ApiClientOptions;
+/**
+ * The exact, stable return surface of `useWorkflowTemplates`.
+ *
+ * This is the agent/consumer **contract**: the only methods that exist on the
+ * workflow-templates hook. Every method is imperative and DOES NOT throw — on
+ * failure it resolves to the documented default and sets `error`. See `SKILL.md`.
+ */
+interface UseWorkflowTemplatesReturn {
+    /** True while any method is in flight. */
     loading: boolean;
+    /** Latest method error, else null. */
     error: string | null;
+    /** GET /api/v1/workflows/templates(?category=) — default `[]` on error. */
     listTemplates: (category?: string) => Promise<WorkflowTemplate[]>;
+    /** GET /api/v1/workflows/templates/{id} — default `null`. */
     getTemplate: (templateId: string) => Promise<WorkflowTemplate | null>;
+    /** POST /api/v1/workflows/templates/{id}/instantiate — new definition, or `null`. */
     instantiateTemplate: (templateId: string, params: {
         variables: Record<string, unknown>;
         title?: string;
     }) => Promise<WorkflowDefinition | null>;
-};
+}
+/**
+ * Hook for workflow template operations
+ *
+ * @example
+ * ```tsx
+ * const { listTemplates, getTemplate, instantiateTemplate } = useWorkflowTemplates({
+ *   baseUrl: apiGatewayUrl,
+ *   orgId: selectedOrgId,
+ * });
+ *
+ * const templates = await listTemplates();
+ * ```
+ */
+declare function useWorkflowTemplates(options: UseWorkflowTemplatesOptions): UseWorkflowTemplatesReturn;
 
 /**
  * Keep a mutable ref synchronized with the latest value
@@ -104,4 +149,4 @@ declare function useWorkflowTemplates(options: UseWorkflowTemplatesOptions): {
  */
 declare function useOptionsRef<T>(options: T): React.MutableRefObject<T>;
 
-export { type UseWorkflowInstancesOptions, type UseWorkflowTemplatesOptions, type UseWorkflowsOptions, useOptionsRef, useWorkflowInstances, useWorkflowTemplates, useWorkflows };
+export { type UseWorkflowInstancesOptions, type UseWorkflowInstancesReturn, type UseWorkflowTemplatesOptions, type UseWorkflowTemplatesReturn, type UseWorkflowsOptions, type UseWorkflowsReturn, useOptionsRef, useWorkflowInstances, useWorkflowTemplates, useWorkflows };