@pikku/core 0.11.2 → 0.12.0

package/dist/wirings/workflow/graph/index.d.ts

@@ -1,3 +1,4 @@
-export * from './workflow-graph.types.js';
-export * from './graph-node.js';
-export * from './graph-runner.js';
+export { continueGraph, executeGraphStep, onGraphNodeComplete, runFromMeta, runWorkflowGraph, } from './graph-runner.js';
+export { template } from './template.js';
+export type { TemplateString } from './template.js';
+export { pikkuWorkflowGraph, type PikkuWorkflowGraphConfig, type PikkuWorkflowGraphResult, } from './wire-workflow-graph.js';

package/dist/wirings/workflow/graph/index.js

@@ -1,3 +1,3 @@
-export * from './workflow-graph.types.js';
-export * from './graph-node.js';
-export * from './graph-runner.js';
+export { continueGraph, executeGraphStep, onGraphNodeComplete, runFromMeta, runWorkflowGraph, } from './graph-runner.js';
+export { template } from './template.js';
+export { pikkuWorkflowGraph, } from './wire-workflow-graph.js';

package/dist/wirings/workflow/graph/template.d.ts

@@ -0,0 +1,15 @@
+export type TemplateString = {
+    $template: {
+        parts: string[];
+        expressions: Array<{
+            $ref: string;
+            path?: string;
+        }>;
+    };
+} & {
+    __brand: 'TemplateString';
+};
+export declare function template(templateStr: string, refs: Array<{
+    $ref: string;
+    path?: string;
+}>): TemplateString;

package/dist/wirings/workflow/graph/template.js

@@ -0,0 +1,27 @@
+export function template(templateStr, refs) {
+    const parts = [];
+    const expressions = [];
+    const regex = /\$(\d+)/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = regex.exec(templateStr)) !== null) {
+        parts.push(templateStr.slice(lastIndex, match.index));
+        const refIndex = parseInt(match[1], 10);
+        const refValue = refs[refIndex];
+        if (refValue) {
+            const expr = { $ref: refValue.$ref };
+            if (refValue.path) {
+                expr.path = refValue.path;
+            }
+            expressions.push(expr);
+        }
+        else {
+            expressions.push({ $ref: 'unknown' });
+        }
+        lastIndex = regex.lastIndex;
+    }
+    parts.push(templateStr.slice(lastIndex));
+    return {
+        $template: { parts, expressions },
+    };
+}

package/dist/wirings/workflow/graph/wire-workflow-graph.d.ts

@@ -0,0 +1,15 @@
+export interface PikkuWorkflowGraphConfig<FuncMap extends Record<string, string>, T> {
+    disabled?: true;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    nodes: FuncMap;
+    config?: T;
+}
+export interface PikkuWorkflowGraphResult {
+    __type: 'pikkuWorkflowGraph';
+    name?: string;
+    description?: string;
+    tags?: string[];
+}
+export declare function pikkuWorkflowGraph<const FuncMap extends Record<string, string>>(config: PikkuWorkflowGraphConfig<FuncMap, any>): PikkuWorkflowGraphResult;

package/dist/wirings/workflow/graph/wire-workflow-graph.js

@@ -0,0 +1,8 @@
+export function pikkuWorkflowGraph(config) {
+    return {
+        __type: 'pikkuWorkflowGraph',
+        name: config.name,
+        description: config.description,
+        tags: config.tags,
+    };
+}

package/dist/wirings/workflow/graph/workflow-graph.types.d.ts

@@ -46,19 +46,6 @@ export interface GraphNodeConfig<NodeIds extends string = string> {
     /** Error routing - node(s) to execute on error */
     onError?: NodeIds | NodeIds[];
 }
-import type { WorkflowWires } from '../workflow.types.js';
-export type { WorkflowWires };
-/**
- * Workflow graph definition (internal use)
- */
-export interface WorkflowGraphDefinition<Nodes extends Record<string, GraphNodeConfig<string>> = Record<string, GraphNodeConfig>> {
-    /** Unique workflow name */
-    name: string;
-    /** Wire configuration */
-    wires: WorkflowWires;
-    /** Graph nodes */
-    graph: Nodes;
-}
 /**
  * Graph wire context - available to functions running in a workflow graph
  */

package/dist/wirings/workflow/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Workflow module exports
  */
-export { PikkuWorkflowService, WorkflowCancelledException, } from './pikku-workflow-service.js';
+export { PikkuWorkflowService, WorkflowCancelledException, WorkflowSuspendedException, WorkflowNotFoundError, WorkflowRunNotFoundError, } from './pikku-workflow-service.js';
 export { addWorkflow } from './dsl/workflow-runner.js';
-export { addWorkflowGraph } from './graph/graph-runner.js';
-export { wireWorkflow } from './wire-workflow.js';
-export type { WorkflowDefinition, WorkflowDefinitionFunc, WorkflowDefinitionGraph, } from './wire-workflow.js';
-export type { WorkflowService, WorkflowServiceConfig, WorkflowHTTPWire, WorkflowWires, WorkflowStatus, StepStatus, WorkflowRun, StepState, CoreWorkflow, PikkuWorkflow, ContextVariable, WorkflowContext, WorkflowsMeta, WorkflowRuntimeMeta, WorkflowsRuntimeMeta, WorkflowStepInput, WorkflowOrchestratorInput, WorkflowSleeperInput, } from './workflow.types.js';
-export type { WorkflowStepOptions, WorkflowWireDoRPC, WorkflowWireDoInline, WorkflowWireSleep, InputSource, OutputBinding, RpcStepMeta, SimpleCondition, Condition, BranchCase, BranchStepMeta, ParallelGroupStepMeta, FanoutStepMeta, ReturnStepMeta, InlineStepMeta, SleepStepMeta, CancelStepMeta, SetStepMeta, SwitchCaseMeta, SwitchStepMeta, FilterStepMeta, ArrayPredicateStepMeta, WorkflowStepMeta, WorkflowStepWire, PikkuWorkflowWire, } from './workflow.types.js';
+export { template, type TemplateString } from './graph/template.js';
+export { pikkuWorkflowGraph, type PikkuWorkflowGraphConfig, type PikkuWorkflowGraphResult, } from './graph/wire-workflow-graph.js';
+export { workflow, workflowStart, workflowStatus, graphStart, } from './workflow-helpers.js';
+export type { WorkflowService, WorkflowServiceConfig, WorkflowRunWire, WorkflowStatus, StepStatus, WorkflowRun, StepState, WorkflowRunService, CoreWorkflow, PikkuWorkflow, ContextVariable, WorkflowContext, WorkflowsMeta, WorkflowRuntimeMeta, WorkflowsRuntimeMeta, WorkflowStepInput, WorkflowOrchestratorInput, WorkflowSleeperInput, } from './workflow.types.js';
+export type { WorkflowStepOptions, WorkflowWireDoRPC, WorkflowWireDoInline, WorkflowWireSleep, WorkflowWireSuspend, InputSource, OutputBinding, RpcStepMeta, SimpleCondition, Condition, BranchCase, BranchStepMeta, ParallelGroupStepMeta, FanoutStepMeta, ReturnStepMeta, InlineStepMeta, SleepStepMeta, CancelStepMeta, SetStepMeta, SwitchCaseMeta, SwitchStepMeta, FilterStepMeta, ArrayPredicateStepMeta, WorkflowStepMeta, WorkflowStepWire, PikkuWorkflowWire, } from './workflow.types.js';

package/dist/wirings/workflow/index.js

@@ -1,9 +1,11 @@
 /**
  * Workflow module exports
  */
-export { PikkuWorkflowService, WorkflowCancelledException, } from './pikku-workflow-service.js';
+export { PikkuWorkflowService, WorkflowCancelledException, WorkflowSuspendedException, WorkflowNotFoundError, WorkflowRunNotFoundError, } from './pikku-workflow-service.js';
 // Internal registration functions (used by generated code)
 export { addWorkflow } from './dsl/workflow-runner.js';
-export { addWorkflowGraph } from './graph/graph-runner.js';
-// Unified wireWorkflow function
-export { wireWorkflow } from './wire-workflow.js';
+// Graph helpers (template, pikkuWorkflowGraph)
+export { template } from './graph/template.js';
+export { pikkuWorkflowGraph, } from './graph/wire-workflow-graph.js';
+// Workflow helpers (runtime factories for HTTP handlers)
+export { workflow, workflowStart, workflowStatus, graphStart, } from './workflow-helpers.js';

package/dist/wirings/workflow/pikku-workflow-service.d.ts

@@ -1,5 +1,5 @@
 import { CoreConfig, CoreSingletonServices, CreateWireServices, SerializedError } from '../../types/core.types.js';
-import type { StepState, WorkflowRun, WorkflowStatus, WorkflowStepOptions } from './workflow.types.js';
+import type { StepState, WorkflowRun, WorkflowRunWire, WorkflowStatus, WorkflowStepOptions } from './workflow.types.js';
 import { WorkflowService } from '../../services/workflow-service.js';
 import { PikkuError } from '../../errors/error-handler.js';
 /**
@@ -19,15 +19,20 @@ export declare class WorkflowCancelledException extends Error {
     constructor(runId: string, reason?: string | undefined);
 }
 /**
- * Error class for workflow not found
+ * Exception thrown when workflow is suspended
  */
-export declare class WorkflowNotFoundError extends PikkuError {
-    constructor(name: string);
+export declare class WorkflowSuspendedException extends Error {
+    readonly runId: string;
+    readonly reason: string;
+    constructor(runId: string, reason: string);
 }
 /**
  * Error class for workflow not found
  */
-export declare class WorkflowRunNotFound extends PikkuError {
+export declare class WorkflowNotFoundError extends PikkuError {
+    constructor(name: string);
+}
+export declare class WorkflowRunNotFoundError extends PikkuError {
     constructor(runId: string);
 }
 export declare class WorkflowServiceNotInitialized extends Error {
@@ -58,14 +63,9 @@ export declare abstract class PikkuWorkflowService implements WorkflowService {
      * Unregister a run from inline tracking
      */
     unregisterInlineRun(runId: string): void;
-    setServices(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices, { workflow }: CoreConfig): void;
-    /**
-     * Create a new workflow run
-     * @param name - Workflow name
-     * @param input - Input data for the workflow
-     * @returns Run ID
-     */
-    abstract createRun(workflowName: string, input: any, inline?: boolean): Promise<string>;
+    setServices(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices | undefined, { workflow }: CoreConfig): void;
+    registerWorkflowVersions(): Promise<void>;
+    abstract createRun(workflowName: string, input: any, inline: boolean, graphHash: string, wire: WorkflowRunWire): Promise<string>;
     /**
      * Get a workflow run by ID
      * @param id - Run ID
@@ -165,6 +165,7 @@ export declare abstract class PikkuWorkflowService implements WorkflowService {
      */
     abstract getCompletedGraphState(runId: string): Promise<{
         completedNodeIds: string[];
+        failedNodeIds: string[];
         branchKeys: Record<string, string>;
     }>;
     /**
@@ -200,11 +201,17 @@ export declare abstract class PikkuWorkflowService implements WorkflowService {
      * @returns The state object with all variables
      */
     abstract getRunState(runId: string): Promise<Record<string, unknown>>;
+    abstract upsertWorkflowVersion(name: string, graphHash: string, graph: any, source: string): Promise<void>;
+    abstract getWorkflowVersion(name: string, graphHash: string): Promise<{
+        graph: any;
+        source: string;
+    } | null>;
     /**
      * Resume a paused workflow by triggering the orchestrator
      * @param runId - Run ID
      */
     resumeWorkflow(runId: string): Promise<void>;
+    queueStepWorker(runId: string, stepName: string, rpcName: string, data: any): Promise<void>;
     /**
      * Execute a workflow sleep step completion
      * Sets the step result to null and resumes the workflow
@@ -223,13 +230,18 @@ export declare abstract class PikkuWorkflowService implements WorkflowService {
      * @param options.inline - If true, execute workflow directly without queue service
      * @param options.startNode - Starting node ID for graph workflows (from wire config)
      */
-    startWorkflow<I>(name: string, input: I, rpcService: any, options?: {
+    startWorkflow<I>(name: string, input: I, wire: WorkflowRunWire, rpcService: any, options?: {
         inline?: boolean;
         startNode?: string;
     }): Promise<{
         runId: string;
     }>;
+    runToCompletion<I>(name: string, input: I, rpcService: any, options?: {
+        pollIntervalMs?: number;
+        wire?: WorkflowRunWire;
+    }): Promise<any>;
     runWorkflowJob(runId: string, rpcService: any): Promise<void>;
+    private runVersionMismatchFallback;
     /**
      * Execute a single workflow step (called by worker)
      * Handles idempotency, RPC execution, result storage, retry logic, and orchestrator triggering
@@ -244,6 +256,8 @@ export declare abstract class PikkuWorkflowService implements WorkflowService {
     private rpcStep;
     private inlineStep;
     private sleepStep;
+    private getSuspendStepName;
+    private suspendStep;
     private createWorkflowWire;
     private verifyStepName;
     private getConfig;