@pikku/cli 0.11.3 → 0.12.0

package/.pikku/services/variables.gen.json

@@ -1,13 +0,0 @@
-{
-  "name": "variables",
-  "summary": "",
-  "description": "",
-  "package": "@pikku/core",
-  "path": "../core/dist/types/core.types.d.ts",
-  "version": "0.11.2",
-  "interface": "export interface VariablesService {\n    get: (name: string) => Promise<string | undefined> | string | undefined;\n    getAll: () => Promise<Record<string, string | undefined>> | Record<string, string | undefined>;\n}",
-  "expandedProperties": {
-    "get": "(name: string) => Promise<string | undefined> | string | undefined",
-    "getAll": "() => Promise<Record<string, string | undefined>> | Record<string, string | undefined>"
-  }
-}

package/.pikku/services/workflowService.gen.json

@@ -1,31 +0,0 @@
-{
-  "name": "workflowService",
-  "summary": "Interface for workflow orchestration",
-  "description": "Handles workflow execution, replay, orchestration logic, and run-level state",
-  "package": "@pikku/core",
-  "path": "../core/dist/types/core.types.d.ts",
-  "version": "0.11.2",
-  "interface": "export interface WorkflowService {\n    createRun(workflowName: string, input: any, inline?: boolean): Promise<string>;\n    getRun(id: string): Promise<WorkflowRun | null>;\n    getRunHistory(runId: string): Promise<Array<StepState & {\n        stepName: string;\n    }>>;\n    updateRunStatus(id: string, status: WorkflowStatus, output?: any, error?: SerializedError): Promise<void>;\n    withRunLock<T>(id: string, fn: () => Promise<T>): Promise<T>;\n    close(): Promise<void>;\n    resumeWorkflow(runId: string): Promise<void>;\n    setServices(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices, config: CoreConfig): void;\n    startWorkflow<I>(name: string, input: I, rpcService: any, options?: {\n        inline?: boolean;\n        startNode?: string;\n    }): Promise<{\n        runId: string;\n    }>;\n    runWorkflowJob(runId: string, rpcService: any): Promise<void>;\n    orchestrateWorkflow(runId: string, rpcService: any): Promise<void>;\n    executeWorkflowSleepCompleted(runId: string, stepId: string): Promise<void>;\n    insertStepState(runId: string, stepName: string, rpcName: string, data: any, stepOptions?: {\n        retries?: number;\n        retryDelay?: string | number;\n    }): Promise<StepState>;\n    getStepState(runId: string, stepName: string): Promise<StepState>;\n    setStepRunning(stepId: string): Promise<void>;\n    setStepScheduled(stepId: string): Promise<void>;\n    setStepResult(stepId: string, result: any): Promise<void>;\n    setStepError(stepId: string, error: Error): Promise<void>;\n    createRetryAttempt(stepId: string, status: 'pending' | 'running'): Promise<StepState>;\n    executeWorkflowStep(runId: string, stepName: string, rpcName: string | null, data: any, rpcService: any): Promise<void>;\n}",
-  "expandedProperties": {
-    "createRun": "(workflowName: string, input: any, inline?: boolean) => Promise<string>",
-    "getRun": "(id: string) => Promise<WorkflowRun | null>",
-    "getRunHistory": "(runId: string) => Promise<Array<StepState & { stepName: string; }>>",
-    "updateRunStatus": "(id: string, status: WorkflowStatus, output?: any, error?: SerializedError) => Promise<void>",
-    "withRunLock": "<T>(id: string, fn: () => Promise<T>) => Promise<T>",
-    "close": "() => Promise<void>",
-    "resumeWorkflow": "(runId: string) => Promise<void>",
-    "setServices": "(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices, config: CoreConfig) => void",
-    "startWorkflow": "<I>(name: string, input: I, rpcService: any, options?: { inline?: boolean; startNode?: string; }) => Promise<{ runId: string; }>",
-    "runWorkflowJob": "(runId: string, rpcService: any) => Promise<void>",
-    "orchestrateWorkflow": "(runId: string, rpcService: any) => Promise<void>",
-    "executeWorkflowSleepCompleted": "(runId: string, stepId: string) => Promise<void>",
-    "insertStepState": "(runId: string, stepName: string, rpcName: string, data: any, stepOptions?: { retries?: number; retryDelay?: string | number; }) => Promise<StepState>",
-    "getStepState": "(runId: string, stepName: string) => Promise<StepState>",
-    "setStepRunning": "(stepId: string) => Promise<void>",
-    "setStepScheduled": "(stepId: string) => Promise<void>",
-    "setStepResult": "(stepId: string, result: any) => Promise<void>",
-    "setStepError": "(stepId: string, error: Error) => Promise<void>",
-    "createRetryAttempt": "(stepId: string, status: \"pending\" | \"running\") => Promise<StepState>",
-    "executeWorkflowStep": "(runId: string, stepName: string, rpcName: string | null, data: any, rpcService: any) => Promise<void>"
-  }
-}

package/.pikku/workflow/pikku-workflow-map.gen.d.ts

@@ -1,28 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.3
- */
-/**
- * Workflow type map with input/output types for each workflow
- */
-
-
-
-
-interface WorkflowHandler<I, O> {
-    input: I;
-    output: O;
-}
-
-export type WorkflowMap = {
-};
-
-
-export type WorkflowClient<Name extends keyof WorkflowMap> = {
-  start: (input: WorkflowMap[Name]['input']) => Promise<{ runId: string }>;
-  getRun: <output extends keyof WorkflowMap[Name]>(runId: string) => Promise<WorkflowMap[Name][output]>;
-  cancelRun: (runId: string) => Promise<boolean>;
-}
-
-export type TypedWorkflowClients = {
-  [Name in keyof WorkflowMap]: WorkflowClient<Name>;
-}

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

@@ -1,349 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.3
- */
-/**
- * Workflow type definitions and helpers
- * Used for authoring both DSL and graph-based workflows
- */
-
-import { PikkuWorkflowWire, WorkflowStepOptions, WorkflowCancelledException } from '@pikku/core/workflow'
-
-// Re-export WorkflowCancelledException for use in workflow functions
-export { WorkflowCancelledException }
-import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
-import type { RPCMap, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js'
-import type { GraphNodeConfig, HTTPMethod } from '@pikku/core'
-import { createGraph, wireWorkflow as coreWireWorkflow } from '@pikku/core'
-
-// ============================================================================
-// DSL Workflow Types (pikkuWorkflowFunc, pikkuWorkflowComplexFunc)
-// ============================================================================
-
-/**
- * Typed workflow wire with RPC awareness
- * Provides type-safe workflow.do() for RPC steps
- */
-export interface TypedWorkflow extends PikkuWorkflowWire {
-  do<K extends keyof RPCMap>(
-    stepName: string,
-    rpcName: K,
-    data: RPCMap[K]['input'],
-    options?: WorkflowStepOptions
-  ): Promise<RPCMap[K]['output']>
-
-  do<T>(
-    stepName: string,
-    fn: () => T | Promise<T>,
-    options?: WorkflowStepOptions
-  ): Promise<T>
-}
-
-/**
- * Workflow function type with typed workflow service
- */
-export type PikkuFunctionWorkflow<
-  In = unknown,
-  Out = never
-> = PikkuFunctionSessionless<In, Out, 'workflow'>
-
-/**
- * Creates a DSL-compatible workflow function (serializable, shows in Forge UI)
- */
-export const pikkuWorkflowFunc = <In, Out = unknown>(
-  func:
-    | PikkuFunctionWorkflow<In, Out>
-    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
-) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-/**
- * Creates a complex workflow function (arbitrary code, hidden from Forge UI)
- */
-export const pikkuWorkflowComplexFunc = <In, Out = unknown>(
-  func:
-    | PikkuFunctionWorkflow<In, Out>
-    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
-) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-// ============================================================================
-// Graph Workflow Types (pikkuWorkflowGraph)
-// ============================================================================
-
-/**
- * Type-safe graph builder with full RPC autocomplete
- */
-const graphBuilder = createGraph<FlattenedRPCMap>()
-
-/** 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  // RPC name of the trigger function
-  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 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>> {
-  return {
-    __type: 'pikkuWorkflowGraph',
-    name: config.name,
-    description: config.description,
-    tags: config.tags,
-    wires: config.wires,
-    graph: graphBuilder(config.nodes, config.config as any),
-  }
-}
-
-/** 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
- *
- * @example
- * template('Hello $0, your order $1 is ready', [ref('trigger', 'name'), ref('step_0', 'orderId')])
- */
-export function template(templateStr: string, refs: TypedRef<unknown>[]): TemplateString {
-  const parts: string[] = []
-  const expressions: Array<{ $ref: string; path?: string }> = []
-
-  // 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: string; path?: string } = { $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 }
-  } as 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 }
-
-// ============================================================================
-// Unified wireWorkflow
-// ============================================================================
-
-/** 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)
- *
- * @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 function wireWorkflow<T extends Record<string, GraphNodeConfig<Extract<keyof T, string>>>, NodeIds extends string = string>(
-  definition: WorkflowDefinitionFunc | WorkflowDefinitionGraph<T, NodeIds>
-): void {
-  coreWireWorkflow(definition as any)
-}

package/.pikku/workflow/pikku-workflow-wirings-meta.gen.ts

@@ -1,9 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.3
- */
-import { pikkuState } from '@pikku/core'
-import type { SerializedWorkflowGraphs } from '@pikku/inspector/workflow-graph'
-
-const workflowsMeta: SerializedWorkflowGraphs = {}
-
-pikkuState(null, 'workflows', 'meta', workflowsMeta)

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

@@ -1,3 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.3
- */