@pikku/cli 0.11.2 → 0.11.3

package/dist/.pikku/schemas/schemas/PikkuCLIOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuChannelsOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuForgeNodesOutput.schema.json

@@ -0,0 +1 @@
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuFunctionsOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuHTTPOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuMCPOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuMiddlewareOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuPackageOutput.schema.json

@@ -0,0 +1 @@
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuPermissionsOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuPublicRPCOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuQueueOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuRPCOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuRemoteRPCOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuSchedulerOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuSchemasOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "description": "This provides the structure needed for typescript to be aware of RPCs and their return types", "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/schemas/schemas/PikkuWorkflowOutput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "type": "boolean" }

package/dist/.pikku/workflow/pikku-workflow-types.gen.d.ts

@@ -1,62 +1,232 @@
 /**
- * This file was generated by @pikku/cli@0.11.2
+ * This file was generated by @pikku/cli@0.11.3
  */
 /**
- * Workflow-specific type definitions for tree-shaking optimization
+ * Workflow type definitions and helpers
+ * Used for authoring both DSL and graph-based workflows
  */
-import { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/workflow';
+import { PikkuWorkflowWire, WorkflowStepOptions, WorkflowCancelledException } from '@pikku/core/workflow';
+export { WorkflowCancelledException };
 import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js';
-import type { RPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
+import type { RPCMap, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
+import type { GraphNodeConfig, HTTPMethod } from '@pikku/core';
 /**
  * Typed workflow wire with RPC awareness
  * Provides type-safe workflow.do() for RPC steps
  */
 export interface TypedWorkflow extends PikkuWorkflowWire {
-    /**
-     * Execute a workflow step with RPC invocation (typed based on available RPCs)
-     * @template K - RPC name from the RPC map
-     */
     do<K extends keyof RPCMap>(stepName: string, rpcName: K, data: RPCMap[K]['input'], options?: WorkflowStepOptions): Promise<RPCMap[K]['output']>;
-    /**
-     * Execute a workflow step with inline function
-     * @template T - Return type of the inline function
-     */
     do<T>(stepName: string, fn: () => T | Promise<T>, options?: WorkflowStepOptions): Promise<T>;
 }
 /**
  * Workflow function type with typed workflow service
- * Includes the workflow wire object with typed RPC methods
  */
 export type PikkuFunctionWorkflow<In = unknown, Out = never> = PikkuFunctionSessionless<In, Out, 'workflow'>;
 /**
- * Creates a workflow function with typed input and output.
- * Workflow functions have access to the workflow wire object for step execution.
- *
- * This is the permissive mode - workflows that don't conform to simple DSL will fall back
- * to basic extraction with a warning.
- *
- * @template In - Input type for the workflow
- * @template Out - Output type for the workflow
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
+ * Creates a DSL-compatible workflow function (serializable, shows in Forge UI)
  */
 export declare const pikkuWorkflowFunc: <In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>) => PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>;
 /**
- * Creates a simple workflow function with typed input and output.
- * Simple workflows must conform to the restricted DSL for static analysis.
+ * Creates a complex workflow function (arbitrary code, hidden from Forge UI)
+ */
+export declare const pikkuWorkflowComplexFunc: <In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>) => PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>;
+/** HTTP wire configuration for graph workflows */
+interface GraphHttpWire<NodeIds extends string> {
+    route: string;
+    method: HTTPMethod;
+    startNode: NodeIds;
+}
+/** Channel wire configuration for graph workflows */
+interface GraphChannelWire<NodeIds extends string> {
+    name: string;
+    onConnect?: NodeIds;
+    onDisconnect?: NodeIds;
+    onMessage?: NodeIds;
+}
+/** Queue wire configuration for graph workflows */
+interface GraphQueueWire<NodeIds extends string> {
+    name: string;
+    startNode: NodeIds;
+}
+/** CLI wire configuration for graph workflows */
+interface GraphCliWire<NodeIds extends string> {
+    command: string;
+    startNode: NodeIds;
+}
+/** MCP wire configurations for graph workflows */
+interface GraphMcpWires<NodeIds extends string> {
+    tool?: Array<{
+        name: string;
+        startNode: NodeIds;
+    }>;
+    prompt?: Array<{
+        name: string;
+        startNode: NodeIds;
+    }>;
+    resource?: Array<{
+        uri: string;
+        startNode: NodeIds;
+    }>;
+}
+/** Schedule wire configuration for graph workflows */
+interface GraphScheduleWire<NodeIds extends string> {
+    cron?: string;
+    interval?: string;
+    startNode: NodeIds;
+}
+/** Trigger wire configuration for graph workflows */
+interface GraphTriggerWire<NodeIds extends string> {
+    name: string;
+    startNode: NodeIds;
+}
+/** All wire configurations for graph workflows */
+interface GraphWiresConfig<NodeIds extends string> {
+    http?: Array<GraphHttpWire<NodeIds>>;
+    channel?: Array<GraphChannelWire<NodeIds>>;
+    queue?: Array<GraphQueueWire<NodeIds>>;
+    cli?: Array<GraphCliWire<NodeIds>>;
+    mcp?: GraphMcpWires<NodeIds>;
+    schedule?: Array<GraphScheduleWire<NodeIds>>;
+    trigger?: Array<GraphTriggerWire<NodeIds>>;
+}
+/** Configuration for graph-based workflow */
+export interface PikkuWorkflowGraphConfig<FuncMap extends Record<string, keyof FlattenedRPCMap & string>, T> {
+    /** Workflow name (optional - defaults to exported variable name) */
+    name?: string;
+    /** Optional description */
+    description?: string;
+    /** Optional tags for organization */
+    tags?: string[];
+    /** Node to RPC function mapping */
+    nodes: FuncMap;
+    /** Wire configurations - how this workflow can be triggered */
+    wires?: GraphWiresConfig<Extract<keyof FuncMap, string>>;
+    /** Node configurations (next, input, onError) */
+    config?: T;
+}
+/** Result of pikkuWorkflowGraph - includes metadata for wiring */
+export interface PikkuWorkflowGraphResult<T, NodeIds extends string = string> {
+    __type: 'pikkuWorkflowGraph';
+    name?: string;
+    description?: string;
+    tags?: string[];
+    wires?: GraphWiresConfig<NodeIds>;
+    graph: T;
+}
+/**
+ * Creates a graph-based workflow definition with metadata
+ * Name defaults to the exported variable name if not provided.
+ *
+ * @example
+ * // Name inferred from exported variable name
+ * export const myWorkflow = pikkuWorkflowGraph({
+ *   description: 'Handles user onboarding',
+ *   tags: ['onboarding'],
+ *   nodes: {
+ *     entry: 'createUser',
+ *     sendEmail: 'sendWelcomeEmail',
+ *   },
+ *   config: {
+ *     entry: { next: 'sendEmail' },
+ *     sendEmail: { input: (ref) => ({ to: ref('entry', 'email') }) },
+ *   },
+ * })
+ */
+export declare function pikkuWorkflowGraph<const FuncMap extends Record<string, keyof FlattenedRPCMap & string>>(config: PikkuWorkflowGraphConfig<FuncMap, GraphNodeConfigMap<FuncMap>>): PikkuWorkflowGraphResult<Record<Extract<keyof FuncMap, string>, GraphNodeConfig<Extract<keyof FuncMap, string>>>, Extract<keyof FuncMap, string>>;
+/** Typed ref value */
+type TypedRef<T> = {
+    $ref: string;
+    path?: string;
+} & {
+    __phantomType?: T;
+};
+/** Template string type - assignable to string fields */
+type TemplateString = {
+    $template: {
+        parts: string[];
+        expressions: Array<{
+            $ref: string;
+            path?: string;
+        }>;
+    };
+} & {
+    __brand: 'TemplateString';
+};
+/**
+ * Creates a template string with variable interpolation
+ * Uses indexed placeholders $0, $1, etc. with refs array
  *
- * This is the strict mode - workflows that don't conform to simple DSL will cause
- * a critical error during inspection.
+ * @example
+ * template('Hello $0, your order $1 is ready', [ref('trigger', 'name'), ref('step_0', 'orderId')])
+ */
+export declare function template(templateStr: string, refs: TypedRef<unknown>[]): TemplateString;
+/** Map input type fields to allow TypedRef or TemplateString for any field */
+type InputWithRefs<T> = {
+    [K in keyof T]?: T[K] | TypedRef<T[K]> | TypedRef<unknown> | TemplateString;
+};
+/** Get the input type for a node based on its RPC mapping */
+type NodeInputType<FuncMap extends Record<string, string>, K extends keyof FuncMap> = FuncMap[K] extends keyof FlattenedRPCMap ? InputWithRefs<FlattenedRPCMap[FuncMap[K]]['input']> : Record<string, unknown>;
+/** Get the output type keys for a node based on its RPC mapping */
+type NodeOutputKeys<FuncMap extends Record<string, string>, N extends string> = N extends keyof FuncMap ? FuncMap[N] extends keyof FlattenedRPCMap ? keyof FlattenedRPCMap[FuncMap[N]]['output'] & string : string : string;
+/** Ref function type with path validation */
+type RefFunction<FuncMap extends Record<string, string>> = {
+    <N extends Extract<keyof FuncMap, string>>(nodeId: N, path: NodeOutputKeys<FuncMap, N>): TypedRef<unknown>;
+    (nodeId: 'trigger' | '$item', path?: string): TypedRef<unknown>;
+};
+/** Template function type */
+type TemplateFunction = (templateStr: string, refs: TypedRef<unknown>[]) => TemplateString;
+/** Type helper for node configuration */
+type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
+    [K in Extract<keyof FuncMap, string>]?: {
+        next?: NextConfig<Extract<keyof FuncMap, string>>;
+        input?: NodeInputType<FuncMap, K> | (() => NodeInputType<FuncMap, K>) | ((ref: RefFunction<FuncMap>, template: TemplateFunction) => NodeInputType<FuncMap, K>);
+        onError?: Extract<keyof FuncMap, string> | Extract<keyof FuncMap, string>[];
+    };
+};
+type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | {
+    if: string;
+    then: NodeIds;
+    else?: NodeIds;
+};
+/** Workflow definition with DSL function */
+interface WorkflowDefinitionFunc {
+    /** Whether this workflow wiring is enabled (default: true) */
+    enabled?: boolean;
+    /** Wire configurations for the workflow */
+    wires: {
+        http?: {
+            route: string;
+            method: HTTPMethod;
+        };
+        channel?: string;
+        queue?: string;
+    };
+    /** DSL workflow function */
+    func: PikkuFunctionConfig<any, any, 'workflow', PikkuFunctionWorkflow<any, any>>;
+}
+/** Workflow definition with graph */
+interface WorkflowDefinitionGraph<T, NodeIds extends string = string> {
+    /** Whether this workflow wiring is enabled (default: true) */
+    enabled?: boolean;
+    /** Graph workflow definition - wires are defined in the graph itself */
+    graph: PikkuWorkflowGraphResult<T, NodeIds>;
+}
+/**
+ * Wire a workflow with wires
+ * Accepts either a DSL function (func) or a graph definition (graph)
  *
- * Constraints:
- * - Must use only workflow.do() with RPC form (no inline functions)
- * - Only if/else, for..of, and Promise.all(array.map()) control flow allowed
- * - Step names must be unique (except across mutually exclusive branches)
- * - All workflow calls must be awaited
+ * @example
+ * // DSL workflow
+ * wireWorkflow({
+ *   wires: { http: { route: '/start', method: 'post' } },
+ *   func: myWorkflowFunc,
+ * })
  *
- * @template In - Input type for the workflow
- * @template Out - Output type for the workflow
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
+ * @example
+ * // Graph workflow - wires are defined in the graph itself
+ * wireWorkflow({
+ *   enabled: true,  // default: true
+ *   graph: myGraphWorkflow,
+ * })
  */
-export declare const pikkuSimpleWorkflowFunc: <In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>) => PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>;
+export declare function wireWorkflow<T extends Record<string, GraphNodeConfig<Extract<keyof T, string>>>, NodeIds extends string = string>(definition: WorkflowDefinitionFunc | WorkflowDefinitionGraph<T, NodeIds>): void;

package/dist/.pikku/workflow/pikku-workflow-types.gen.js

@@ -1,42 +1,118 @@
 /**
- * This file was generated by @pikku/cli@0.11.2
+ * This file was generated by @pikku/cli@0.11.3
  */
 /**
- * Workflow-specific type definitions for tree-shaking optimization
+ * Workflow type definitions and helpers
+ * Used for authoring both DSL and graph-based workflows
  */
+import { WorkflowCancelledException } from '@pikku/core/workflow';
+// Re-export WorkflowCancelledException for use in workflow functions
+export { WorkflowCancelledException };
+import { createGraph, wireWorkflow as coreWireWorkflow } from '@pikku/core';
 /**
- * Creates a workflow function with typed input and output.
- * Workflow functions have access to the workflow wire object for step execution.
- *
- * This is the permissive mode - workflows that don't conform to simple DSL will fall back
- * to basic extraction with a warning.
- *
- * @template In - Input type for the workflow
- * @template Out - Output type for the workflow
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
+ * Creates a DSL-compatible workflow function (serializable, shows in Forge UI)
  */
 export const pikkuWorkflowFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
 };
 /**
- * Creates a simple workflow function with typed input and output.
- * Simple workflows must conform to the restricted DSL for static analysis.
+ * Creates a complex workflow function (arbitrary code, hidden from Forge UI)
+ */
+export const pikkuWorkflowComplexFunc = (func) => {
+    return typeof func === 'function' ? { func } : func;
+};
+// ============================================================================
+// Graph Workflow Types (pikkuWorkflowGraph)
+// ============================================================================
+/**
+ * Type-safe graph builder with full RPC autocomplete
+ */
+const graphBuilder = createGraph();
+/**
+ * Creates a graph-based workflow definition with metadata
+ * Name defaults to the exported variable name if not provided.
  *
- * This is the strict mode - workflows that don't conform to simple DSL will cause
- * a critical error during inspection.
+ * @example
+ * // Name inferred from exported variable name
+ * export const myWorkflow = pikkuWorkflowGraph({
+ *   description: 'Handles user onboarding',
+ *   tags: ['onboarding'],
+ *   nodes: {
+ *     entry: 'createUser',
+ *     sendEmail: 'sendWelcomeEmail',
+ *   },
+ *   config: {
+ *     entry: { next: 'sendEmail' },
+ *     sendEmail: { input: (ref) => ({ to: ref('entry', 'email') }) },
+ *   },
+ * })
+ */
+export function pikkuWorkflowGraph(config) {
+    return {
+        __type: 'pikkuWorkflowGraph',
+        name: config.name,
+        description: config.description,
+        tags: config.tags,
+        wires: config.wires,
+        graph: graphBuilder(config.nodes, config.config),
+    };
+}
+/**
+ * Creates a template string with variable interpolation
+ * Uses indexed placeholders $0, $1, etc. with refs array
  *
- * Constraints:
- * - Must use only workflow.do() with RPC form (no inline functions)
- * - Only if/else, for..of, and Promise.all(array.map()) control flow allowed
- * - Step names must be unique (except across mutually exclusive branches)
- * - All workflow calls must be awaited
+ * @example
+ * template('Hello $0, your order $1 is ready', [ref('trigger', 'name'), ref('step_0', 'orderId')])
+ */
+export function template(templateStr, refs) {
+    const parts = [];
+    const expressions = [];
+    // Parse template string: "Hello $0" -> parts: ["Hello ", ""], use refs[0] for expression
+    const regex = /$(d+)/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = regex.exec(templateStr)) !== null) {
+        // Add the part before this match
+        parts.push(templateStr.slice(lastIndex, match.index));
+        // Get the ref by 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;
+    }
+    // Add the remaining part
+    parts.push(templateStr.slice(lastIndex));
+    return {
+        $template: { parts, expressions }
+    };
+}
+/**
+ * Wire a workflow with wires
+ * Accepts either a DSL function (func) or a graph definition (graph)
  *
- * @template In - Input type for the workflow
- * @template Out - Output type for the workflow
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
+ * @example
+ * // DSL workflow
+ * wireWorkflow({
+ *   wires: { http: { route: '/start', method: 'post' } },
+ *   func: myWorkflowFunc,
+ * })
+ *
+ * @example
+ * // Graph workflow - wires are defined in the graph itself
+ * wireWorkflow({
+ *   enabled: true,  // default: true
+ *   graph: myGraphWorkflow,
+ * })
  */
-export const pikkuSimpleWorkflowFunc = (func) => {
-    return typeof func === 'function' ? { func } : func;
-};
+export function wireWorkflow(definition) {
+    coreWireWorkflow(definition);
+}

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -1,6 +1,6 @@
 /**
- * This file was generated by @pikku/cli@0.11.2
+ * This file was generated by @pikku/cli@0.11.3
  */
 import { pikkuState } from '@pikku/core';
-import metaData from './pikku-workflow-wirings-meta.gen.json' with { type: 'json' };
-pikkuState('workflows', 'meta', metaData);
+const workflowsMeta = {};
+pikkuState(null, 'workflows', 'meta', workflowsMeta);

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

@@ -1,8 +1,4 @@
+export {};
 /**
- * This file was generated by @pikku/cli@0.11.2
- */
-/**
- * Auto-generated workflow registrations
- * Do not edit manually - regenerate with 'npx pikku'
+ * This file was generated by @pikku/cli@0.11.3
  */
-export {};

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js

@@ -1,8 +1,4 @@
+export {};
 /**
- * This file was generated by @pikku/cli@0.11.2
- */
-/**
- * Auto-generated workflow registrations
- * Do not edit manually - regenerate with 'npx pikku'
+ * This file was generated by @pikku/cli@0.11.3
  */
-export {};