@pikku/cli 0.10.2 → 0.11.1

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

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "additionalProperties": false, "properties": { "outDir": { "type": "string" }, "schemaDirectory": { "type": "string" }, "typesDeclarationFile": { "type": "string" }, "functionsFile": { "type": "string" }, "functionsMetaFile": { "type": "string" }, "functionsMetaMinFile": { "type": "string" }, "functionTypesFile": { "type": "string" }, "httpWiringsFile": { "type": "string" }, "httpWiringMetaFile": { "type": "string" }, "httpMapDeclarationFile": { "type": "string" }, "httpTypesFile": { "type": "string" }, "channelsWiringFile": { "type": "string" }, "channelsWiringMetaFile": { "type": "string" }, "channelsMapDeclarationFile": { "type": "string" }, "channelsTypesFile": { "type": "string" }, "rpcInternalWiringMetaFile": { "type": "string" }, "rpcInternalMapDeclarationFile": { "type": "string" }, "rpcMapDeclarationFile": { "type": "string" }, "schedulersWiringFile": { "type": "string" }, "schedulersWiringMetaFile": { "type": "string" }, "schedulersTypesFile": { "type": "string" }, "queueWorkersWiringFile": { "type": "string" }, "queueWorkersWiringMetaFile": { "type": "string" }, "queueMapDeclarationFile": { "type": "string" }, "queueTypesFile": { "type": "string" }, "mcpWiringsFile": { "type": "string" }, "mcpWiringsMetaFile": { "type": "string" }, "mcpTypesFile": { "type": "string" }, "cliWiringsFile": { "type": "string" }, "cliWiringMetaFile": { "type": "string" }, "cliBootstrapFile": { "type": "string" }, "cliTypesFile": { "type": "string" }, "servicesFile": { "type": "string" }, "middlewareFile": { "type": "string" }, "middlewareGroupsMetaFile": { "type": "string" }, "permissionsFile": { "type": "string" }, "bootstrapFile": { "type": "string" }, "$schema": { "type": "string" }, "extends": { "type": "string" }, "rootDir": { "type": "string" }, "srcDirectories": { "type": "array", "items": { "type": "string" } }, "ignoreFiles": { "type": "array", "items": { "type": "string" } }, "packageMappings": { "type": "object", "additionalProperties": { "type": "string" } }, "configFile": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "types": { "type": "array", "items": { "type": "string" } }, "userSessionType": { "type": "string" }, "singletonServicesFactoryType": { "type": "string" }, "sessionServicesFactoryType": { "type": "string" }, "configDir": { "type": "string" }, "tsconfig": { "type": "string" }, "nextBackendFile": { "type": "string" }, "nextHTTPFile": { "type": "string" }, "fetchFile": { "type": "string" }, "websocketFile": { "type": "string" }, "rpcWiringsFile": { "type": "string" }, "queueWiringsFile": { "type": "string" }, "mcpJsonFile": { "type": "string" }, "openAPI": { "type": "object", "properties": { "outputFile": { "type": "string" }, "additionalInfo": { "$ref": "#/definitions/OpenAPISpecInfo" } }, "required": ["outputFile", "additionalInfo"], "additionalProperties": false }, "schema": { "type": "object", "properties": { "additionalProperties": { "type": "boolean" }, "supportsImportAttributes": { "type": "boolean" } }, "additionalProperties": false }, "cli": { "type": "object", "properties": { "entrypoints": { "type": "object", "additionalProperties": { "anyOf": [{ "type": "string" }, { "type": "object", "properties": { "type": { "type": "string", "const": "local" }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "channel" }, "name": { "type": "string" }, "route": { "type": "string" }, "wirePath": { "type": "string" }, "path": { "type": "string" } }, "required": ["type", "wirePath"], "additionalProperties": false }, { "type": "array", "items": { "anyOf": [{ "type": "string" }, { "type": "object", "properties": { "type": { "type": "string", "const": "local" }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "channel" }, "name": { "type": "string" }, "route": { "type": "string" }, "wirePath": { "type": "string" }, "path": { "type": "string" } }, "required": ["type", "wirePath"], "additionalProperties": false }] } }] } } }, "additionalProperties": false }, "forceRequiredServices": { "type": "array", "items": { "type": "string" } }, "schemasFromTypes": { "type": "array", "items": { "type": "string" } }, "stateOutput": { "type": "string" }, "stateInput": { "type": "string" }, "filters": { "$ref": "#/definitions/InspectorFilters" } }, "required": ["bootstrapFile", "channelsMapDeclarationFile", "channelsTypesFile", "channelsWiringFile", "channelsWiringMetaFile", "cliBootstrapFile", "cliTypesFile", "cliWiringMetaFile", "cliWiringsFile", "configDir", "filters", "functionTypesFile", "functionsFile", "functionsMetaFile", "functionsMetaMinFile", "httpMapDeclarationFile", "httpTypesFile", "httpWiringMetaFile", "httpWiringsFile", "mcpTypesFile", "mcpWiringsFile", "mcpWiringsMetaFile", "middlewareFile", "middlewareGroupsMetaFile", "outDir", "packageMappings", "permissionsFile", "queueMapDeclarationFile", "queueTypesFile", "queueWorkersWiringFile", "queueWorkersWiringMetaFile", "rootDir", "rpcInternalMapDeclarationFile", "rpcInternalWiringMetaFile", "rpcMapDeclarationFile", "schedulersTypesFile", "schedulersWiringFile", "schedulersWiringMetaFile", "schemaDirectory", "servicesFile", "srcDirectories", "tsconfig", "typesDeclarationFile"], "definitions": { "OpenAPISpecInfo": { "type": "object", "properties": { "info": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "string" }, "description": { "type": "string" }, "termsOfService": { "type": "string" }, "contact": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" }, "email": { "type": "string" } }, "additionalProperties": false }, "license": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "required": ["name"], "additionalProperties": false } }, "required": ["title", "version", "description"], "additionalProperties": false }, "servers": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "description": { "type": "string" } }, "required": ["url"], "additionalProperties": false } }, "tags": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "required": ["name"], "additionalProperties": false } }, "externalDocs": { "type": "object", "properties": { "description": { "type": "string" }, "url": { "type": "string" } }, "required": ["url"], "additionalProperties": false }, "securitySchemes": { "type": "object" }, "security": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "array", "items": {} } } } }, "required": ["info", "servers"], "additionalProperties": false }, "InspectorFilters": { "type": "object", "properties": { "names": { "type": "array", "items": { "type": "string" } }, "tags": { "type": "array", "items": { "type": "string" } }, "types": { "type": "array", "items": { "type": "string" } }, "directories": { "type": "array", "items": { "type": "string" } }, "httpRoutes": { "type": "array", "items": { "type": "string" } }, "httpMethods": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false } } }
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "additionalProperties": false, "properties": { "outDir": { "type": "string" }, "schemaDirectory": { "type": "string" }, "typesDeclarationFile": { "type": "string" }, "functionsFile": { "type": "string" }, "functionsMetaFile": { "type": "string" }, "functionsMetaMinFile": { "type": "string" }, "functionTypesFile": { "type": "string" }, "httpWiringsFile": { "type": "string" }, "httpWiringMetaFile": { "type": "string" }, "httpMapDeclarationFile": { "type": "string" }, "httpTypesFile": { "type": "string" }, "channelsWiringFile": { "type": "string" }, "channelsWiringMetaFile": { "type": "string" }, "channelsMapDeclarationFile": { "type": "string" }, "channelsTypesFile": { "type": "string" }, "rpcInternalWiringMetaFile": { "type": "string" }, "rpcInternalMapDeclarationFile": { "type": "string" }, "rpcMapDeclarationFile": { "type": "string" }, "schedulersWiringFile": { "type": "string" }, "schedulersWiringMetaFile": { "type": "string" }, "schedulersTypesFile": { "type": "string" }, "queueWorkersWiringFile": { "type": "string" }, "queueWorkersWiringMetaFile": { "type": "string" }, "queueMapDeclarationFile": { "type": "string" }, "queueTypesFile": { "type": "string" }, "workflowsWiringFile": { "type": "string" }, "workflowsWiringMetaFile": { "type": "string" }, "workflowsWorkersFile": { "type": "string" }, "workflowMapDeclarationFile": { "type": "string" }, "workflowTypesFile": { "type": "string" }, "mcpWiringsFile": { "type": "string" }, "mcpWiringsMetaFile": { "type": "string" }, "mcpTypesFile": { "type": "string" }, "cliWiringsFile": { "type": "string" }, "cliWiringMetaFile": { "type": "string" }, "cliBootstrapFile": { "type": "string" }, "cliTypesFile": { "type": "string" }, "servicesFile": { "type": "string" }, "middlewareFile": { "type": "string" }, "middlewareGroupsMetaFile": { "type": "string" }, "permissionsFile": { "type": "string" }, "bootstrapFile": { "type": "string" }, "$schema": { "type": "string" }, "extends": { "type": "string" }, "rootDir": { "type": "string" }, "srcDirectories": { "type": "array", "items": { "type": "string" } }, "ignoreFiles": { "type": "array", "items": { "type": "string" } }, "packageMappings": { "type": "object", "additionalProperties": { "type": "string" } }, "configFile": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "types": { "type": "array", "items": { "type": "string" } }, "userSessionType": { "type": "string" }, "singletonServicesFactoryType": { "type": "string" }, "sessionServicesFactoryType": { "type": "string" }, "configDir": { "type": "string" }, "tsconfig": { "type": "string" }, "nextBackendFile": { "type": "string" }, "nextHTTPFile": { "type": "string" }, "fetchFile": { "type": "string" }, "websocketFile": { "type": "string" }, "rpcWiringsFile": { "type": "string" }, "queueWiringsFile": { "type": "string" }, "mcpJsonFile": { "type": "string" }, "openAPI": { "type": "object", "properties": { "outputFile": { "type": "string" }, "additionalInfo": { "$ref": "#/definitions/OpenAPISpecInfo" } }, "required": ["outputFile", "additionalInfo"], "additionalProperties": false }, "schema": { "type": "object", "properties": { "additionalProperties": { "type": "boolean" }, "supportsImportAttributes": { "type": "boolean" } }, "additionalProperties": false }, "cli": { "type": "object", "properties": { "entrypoints": { "type": "object", "additionalProperties": { "anyOf": [{ "type": "string" }, { "type": "object", "properties": { "type": { "type": "string", "const": "local" }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "channel" }, "name": { "type": "string" }, "route": { "type": "string" }, "wirePath": { "type": "string" }, "path": { "type": "string" } }, "required": ["type", "wirePath"], "additionalProperties": false }, { "type": "array", "items": { "anyOf": [{ "type": "string" }, { "type": "object", "properties": { "type": { "type": "string", "const": "local" }, "path": { "type": "string" } }, "required": ["type", "path"], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "channel" }, "name": { "type": "string" }, "route": { "type": "string" }, "wirePath": { "type": "string" }, "path": { "type": "string" } }, "required": ["type", "wirePath"], "additionalProperties": false }] } }] } } }, "additionalProperties": false }, "workflows": { "anyOf": [{ "type": "object", "properties": { "singleQueue": { "type": "boolean", "const": true }, "path": { "type": "string" }, "orchestratorQueue": { "type": "string" }, "workerQueue": { "type": "string" } }, "required": ["singleQueue", "path"], "additionalProperties": false }, { "type": "object", "properties": { "singleQueue": { "type": "boolean", "const": false }, "dir": { "type": "string" }, "orchestratorQueuePrefix": { "type": "string" }, "workerQueuePrefix": { "type": "string" } }, "required": ["singleQueue", "dir"], "additionalProperties": false }] }, "rpc": { "type": "object", "properties": { "remoteRpcWorkersPath": { "type": "string" }, "publicRpcPath": { "type": "string" } }, "additionalProperties": false }, "forceRequiredServices": { "type": "array", "items": { "type": "string" } }, "schemasFromTypes": { "type": "array", "items": { "type": "string" } }, "stateOutput": { "type": "string" }, "stateInput": { "type": "string" }, "filters": { "$ref": "#/definitions/InspectorFilters" } }, "required": ["bootstrapFile", "channelsMapDeclarationFile", "channelsTypesFile", "channelsWiringFile", "channelsWiringMetaFile", "cliBootstrapFile", "cliTypesFile", "cliWiringMetaFile", "cliWiringsFile", "configDir", "filters", "functionTypesFile", "functionsFile", "functionsMetaFile", "functionsMetaMinFile", "httpMapDeclarationFile", "httpTypesFile", "httpWiringMetaFile", "httpWiringsFile", "mcpTypesFile", "mcpWiringsFile", "mcpWiringsMetaFile", "middlewareFile", "middlewareGroupsMetaFile", "outDir", "packageMappings", "permissionsFile", "queueMapDeclarationFile", "queueTypesFile", "queueWorkersWiringFile", "queueWorkersWiringMetaFile", "rootDir", "rpcInternalMapDeclarationFile", "rpcInternalWiringMetaFile", "rpcMapDeclarationFile", "schedulersTypesFile", "schedulersWiringFile", "schedulersWiringMetaFile", "schemaDirectory", "servicesFile", "srcDirectories", "tsconfig", "typesDeclarationFile", "workflowMapDeclarationFile", "workflowTypesFile", "workflowsWiringFile", "workflowsWiringMetaFile", "workflowsWorkersFile"], "definitions": { "OpenAPISpecInfo": { "type": "object", "properties": { "info": { "type": "object", "properties": { "title": { "type": "string" }, "version": { "type": "string" }, "description": { "type": "string" }, "termsOfService": { "type": "string" }, "contact": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" }, "email": { "type": "string" } }, "additionalProperties": false }, "license": { "type": "object", "properties": { "name": { "type": "string" }, "url": { "type": "string" } }, "required": ["name"], "additionalProperties": false } }, "required": ["title", "version", "description"], "additionalProperties": false }, "servers": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "description": { "type": "string" } }, "required": ["url"], "additionalProperties": false } }, "tags": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" } }, "required": ["name"], "additionalProperties": false } }, "externalDocs": { "type": "object", "properties": { "description": { "type": "string" }, "url": { "type": "string" } }, "required": ["url"], "additionalProperties": false }, "securitySchemes": { "type": "object" }, "security": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "array", "items": {} } } } }, "required": ["info", "servers"], "additionalProperties": false }, "InspectorFilters": { "type": "object", "properties": { "names": { "type": "array", "items": { "type": "string" } }, "tags": { "type": "array", "items": { "type": "string" } }, "types": { "type": "array", "items": { "type": "string" } }, "directories": { "type": "array", "items": { "type": "string" } }, "httpRoutes": { "type": "array", "items": { "type": "string" } }, "httpMethods": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false } } }

package/dist/.pikku/schemas/schemas/PikkuChannelsOutput.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": {} }
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }

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

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

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

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "rpcName": { "type": "string" }, "data": {} }, "required": ["rpcName"], "additionalProperties": false, "definitions": {} }

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

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

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

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }
+{ "$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": {} }

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * This file was generated by @pikku/cli@0.11.1
+ */
+/**
+ * Workflow-specific type definitions for tree-shaking optimization
+ */
+import { CoreWorkflow, PikkuWorkflowInteraction, WorkflowStepOptions } from '@pikku/core/workflow';
+import { CorePikkuFunctionConfig, CorePikkuFunctionSessionless } from '@pikku/core';
+import type { PikkuPermission, PikkuMiddleware } from '../function/pikku-function-types.gen.js';
+import type { UserSession, SingletonServices } from '../../types/application-types.d.js';
+import type { TypedPikkuRPC, RPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
+/**
+ * Type definition for workflows that orchestrate multi-step processes.
+ * Workflows support both inline and remote execution modes with step caching.
+ */
+type WorkflowWiring = CoreWorkflow<CorePikkuFunctionConfig<PikkuFunctionWorkflow<any, any>, PikkuPermission<any>, PikkuMiddleware>>;
+/**
+ * Typed workflow interaction with RPC awareness
+ * Provides type-safe workflow.do() for RPC steps
+ */
+export interface TypedWorkflow extends PikkuWorkflowInteraction {
+    /**
+     * 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 interaction object with typed RPC methods
+ */
+export type PikkuFunctionWorkflow<In = unknown, Out = never> = CorePikkuFunctionSessionless<In, Out, null, SingletonServices & {
+    rpc: TypedPikkuRPC;
+    workflow: TypedWorkflow;
+}, UserSession>;
+/**
+ * Creates a workflow function with typed input and output.
+ * Workflow functions have access to the workflow interaction object for step execution.
+ *
+ * @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
+ */
+export declare const pikkuWorkflowFunc: <In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | CorePikkuFunctionConfig<PikkuFunctionWorkflow<In, Out>, PikkuPermission<In>, PikkuMiddleware>) => CorePikkuFunctionConfig<PikkuFunctionWorkflow<In, Out>, PikkuPermission<In>, PikkuMiddleware>;
+/**
+ * Registers a workflow with the Pikku framework.
+ * Workflows can run in 'inline' (synchronous) or 'remote' (queue-based) execution modes.
+ *
+ * @param workflow - Workflow definition with name, execution mode, and handler function
+ */
+export declare const wireWorkflow: (workflow: WorkflowWiring) => void;
+export {};

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

@@ -0,0 +1,28 @@
+/**
+ * This file was generated by @pikku/cli@0.11.1
+ */
+/**
+ * Workflow-specific type definitions for tree-shaking optimization
+ */
+import { wireWorkflow as wireWorkflowCore } from '@pikku/core/workflow';
+/**
+ * Creates a workflow function with typed input and output.
+ * Workflow functions have access to the workflow interaction object for step execution.
+ *
+ * @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
+ */
+export const pikkuWorkflowFunc = (func) => {
+    return typeof func === 'function' ? { func } : func;
+};
+/**
+ * Registers a workflow with the Pikku framework.
+ * Workflows can run in 'inline' (synchronous) or 'remote' (queue-based) execution modes.
+ *
+ * @param workflow - Workflow definition with name, execution mode, and handler function
+ */
+export const wireWorkflow = (workflow) => {
+    wireWorkflowCore(workflow);
+};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,5 @@
+/**
+ * This file was generated by @pikku/cli@0.11.1
+ */
+import { pikkuState } from '@pikku/core';
+pikkuState('workflows', 'meta', {});

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

@@ -0,0 +1,4 @@
+export {};
+/**
+ * This file was generated by @pikku/cli@0.11.1
+ */

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

@@ -0,0 +1,5 @@
+export {};
+/**
+ * This file was generated by @pikku/cli@0.11.1
+ */
+/* The files with an wireWorkflow function call */ 

package/dist/bin/pikku.js

@@ -3,27 +3,25 @@ import { Command } from 'commander';
 import { createConfig, createSingletonServices } from '../src/services.js';
 import { PikkuRPCService } from '@pikku/core/rpc';
 import { LocalVariablesService } from '@pikku/core/services';
-// import { existsSync } from 'fs'
-// import { fileURLToPath } from 'url'
-// import { dirname, join } from 'path'
-// const __filename = fileURLToPath(import.meta.url)
-// const __dirname = dirname(__filename)
+import { existsSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 // Check if Pikku CLI is available
-// const pikkuCliPath = join(__dirname, '../.pikku/cli/pikku-cli.gen.js')
-// if (existsSync(pikkuCliPath)) {
-//   try {
-//     // Use the generated Pikku CLI
-//     const { PikkuCLI } = await import('../.pikku/cli/pikku-cli.gen.js')
-//     await PikkuCLI(process.argv.slice(2))
-//     process.exit(0)
-//   } catch (error) {
-//     // If import fails, fall back to Commander.js
-//     console.warn(
-//       'Failed to load Pikku CLI, using fallback mode:',
-//       error.message
-//     )
-//   }
-// }
+const pikkuCliPath = join(__dirname, '../.pikku/cli/pikku-cli.gen.js');
+if (existsSync(pikkuCliPath)) {
+    try {
+        // Use the generated Pikku CLI
+        const { PikkuCLI } = await import(pikkuCliPath);
+        await PikkuCLI(process.argv.slice(2));
+        process.exit(0);
+    }
+    catch (error) {
+        // If import fails, fall back to Commander.js
+        console.warn('Failed to load Pikku CLI, using fallback mode:', error.message);
+    }
+}
 // Fallback to Commander.js for initial setup
 // Import bootstrap if it exists
 try {

package/dist/src/cli.wiring.js

@@ -1,107 +1,109 @@
-// import { pikkuSchemas } from './functions/wirings/functions/schemas.js'
-// import { pikkuFetch } from './functions/wirings/fetch/index.js'
-// import { pikkuWebSocketTyped } from './functions/wirings/channels/pikku-command-websocket-typed.js'
-// import { pikkuRPCClient } from './functions/wirings/rpc/pikku-command-rpc-client.js'
-// import { pikkuQueueService } from './functions/wirings/queue/pikku-command-queue-service.js'
-// import { pikkuOpenAPI } from './functions/wirings/http/pikku-command-openapi.js'
-// import { pikkuNext } from './functions/runtimes/nextjs/pikku-command-nextjs.js'
-// import { pikkuCLICommand, wireCLI } from '../.pikku/cli/pikku-cli-types.gen.js'
-// import { all } from './functions/commands/all.js'
-// import { bootstrap } from './functions/commands/bootstrap.js'
-// import { clientCLIRenderer } from './services.js'
-export {};
-// wireCLI({
-//   program: 'pikku',
-//   description:
-//     'Pikku CLI - Code generation tool for type-safe backend development',
-//   render: clientCLIRenderer,
-//   options: {
-//     config: {
-//       description: 'Path to pikku.config.json file',
-//       short: 'c',
-//     },
-//     logLevel: {
-//       description: 'Set log level',
-//       default: 'info' as const,
-//       short: 'l',
-//     },
-//     userSessionType: {
-//       description:
-//         'Specify which UserSession type to use (when multiple exist)',
-//     },
-//     singletonServicesFactoryType: {
-//       description: 'Specify which singleton services factory to use',
-//     },
-//     sessionServicesFactoryType: {
-//       description: 'Specify which session services factory to use',
-//     },
-//     stateOutput: {
-//       description: 'Save inspector state to JSON file for reuse',
-//     },
-//     stateInput: {
-//       description: 'Load inspector state from JSON file (skips inspection)',
-//     },
-//   },
-//   commands: {
-//     all: pikkuCLICommand({
-//       func: all,
-//       description: 'Generate all Pikku files (types, schemas, wirings, etc.)',
-//       isDefault: true,
-//       options: {
-//         tags: {
-//           description: 'Filter functions by tags (comma-separated)',
-//           short: 't',
-//         },
-//         types: {
-//           description: 'Filter functions by types (comma-separated)',
-//         },
-//         directories: {
-//           description: 'Filter functions by directories (comma-separated)',
-//           short: 'd',
-//         },
-//         httpMethods: {
-//           description: 'Filter HTTP routes by methods (comma-separated)',
-//         },
-//         httpRoutes: {
-//           description: 'Filter HTTP routes by route patterns (comma-separated)',
-//         },
-//         names: {
-//           description: 'Filter functions by name patterns (supports wildcards)',
-//           short: 'n',
-//         },
-//       },
-//     }),
-//     bootstrap: pikkuCLICommand({
-//       func: bootstrap,
-//       description: 'Generate only type files (setup phase only)',
-//     }),
-//     schemas: pikkuCLICommand({
-//       func: pikkuSchemas,
-//       description: 'Generate JSON schemas for function input/output types',
-//     }),
-//     fetch: pikkuCLICommand({
-//       func: pikkuFetch,
-//       description: 'Generate type-safe HTTP fetch client',
-//     }),
-//     websocket: pikkuCLICommand({
-//       func: pikkuWebSocketTyped,
-//       description: 'Generate type-safe WebSocket client',
-//     }),
-//     rpc: pikkuCLICommand({
-//       func: pikkuRPCClient,
-//       description: 'Generate RPC client wrappers',
-//     }),
-//     'queue-service': pikkuCLICommand({
-//       func: pikkuQueueService,
-//       description: 'Generate queue service wrapper',
-//     }),
-//     openapi: pikkuCLICommand({
-//       func: pikkuOpenAPI,
-//       description: 'Generate OpenAPI specification from HTTP routes',
-//     }),
-//     nextjs: pikkuCLICommand({
-//       func: pikkuNext,
-//       description: 'Generate Next.js backend and HTTP wrappers',
-//     }),
-//   },
-// })
+import { pikkuSchemas } from './functions/wirings/functions/schemas.js';
+import { pikkuFetch } from './functions/wirings/fetch/index.js';
+import { pikkuWebSocketTyped } from './functions/wirings/channels/pikku-command-websocket-typed.js';
+import { pikkuRPCClient } from './functions/wirings/rpc/pikku-command-rpc-client.js';
+import { pikkuQueueService } from './functions/wirings/queue/pikku-command-queue-service.js';
+import { pikkuOpenAPI } from './functions/wirings/http/pikku-command-openapi.js';
+import { pikkuNext } from './functions/runtimes/nextjs/pikku-command-nextjs.js';
+import { pikkuCLICommand, wireCLI } from '../.pikku/cli/pikku-cli-types.gen.js';
+import { all } from './functions/commands/all.js';
+import { bootstrap } from './functions/commands/bootstrap.js';
+import { watch } from './functions/commands/watch.js';
+import { clientCLIRenderer } from './services.js';
+wireCLI({
+    program: 'pikku',
+    description: 'Pikku CLI - Code generation tool for type-safe backend development',
+    render: clientCLIRenderer,
+    options: {
+        config: {
+            description: 'Path to pikku.config.json file',
+            short: 'c',
+        },
+        logLevel: {
+            description: 'Set log level',
+            default: 'info',
+            short: 'l',
+        },
+        userSessionType: {
+            description: 'Specify which UserSession type to use (when multiple exist)',
+        },
+        singletonServicesFactoryType: {
+            description: 'Specify which singleton services factory to use',
+        },
+        sessionServicesFactoryType: {
+            description: 'Specify which session services factory to use',
+        },
+        stateOutput: {
+            description: 'Save inspector state to JSON file for reuse',
+        },
+        stateInput: {
+            description: 'Load inspector state from JSON file (skips inspection)',
+        },
+    },
+    commands: {
+        all: pikkuCLICommand({
+            func: all,
+            description: 'Generate all Pikku files (types, schemas, wirings, etc.)',
+            isDefault: true,
+            options: {
+                tags: {
+                    description: 'Filter functions by tags (comma-separated)',
+                    short: 't',
+                },
+                types: {
+                    description: 'Filter functions by types (comma-separated)',
+                },
+                directories: {
+                    description: 'Filter functions by directories (comma-separated)',
+                    short: 'd',
+                },
+                httpMethods: {
+                    description: 'Filter HTTP routes by methods (comma-separated)',
+                },
+                httpRoutes: {
+                    description: 'Filter HTTP routes by route patterns (comma-separated)',
+                },
+                names: {
+                    description: 'Filter functions by name patterns (supports wildcards)',
+                    short: 'n',
+                },
+            },
+        }),
+        bootstrap: pikkuCLICommand({
+            func: bootstrap,
+            description: 'Generate only type files (setup phase only)',
+        }),
+        watch: pikkuCLICommand({
+            func: watch,
+            description: 'Watch for file changes and regenerate automatically',
+        }),
+        schemas: pikkuCLICommand({
+            func: pikkuSchemas,
+            description: 'Generate JSON schemas for function input/output types',
+        }),
+        fetch: pikkuCLICommand({
+            func: pikkuFetch,
+            description: 'Generate type-safe HTTP fetch client',
+        }),
+        websocket: pikkuCLICommand({
+            func: pikkuWebSocketTyped,
+            description: 'Generate type-safe WebSocket client',
+        }),
+        rpc: pikkuCLICommand({
+            func: pikkuRPCClient,
+            description: 'Generate RPC client wrappers',
+        }),
+        'queue-service': pikkuCLICommand({
+            func: pikkuQueueService,
+            description: 'Generate queue service wrapper',
+        }),
+        openapi: pikkuCLICommand({
+            func: pikkuOpenAPI,
+            description: 'Generate OpenAPI specification from HTTP routes',
+        }),
+        nextjs: pikkuCLICommand({
+            func: pikkuNext,
+            description: 'Generate Next.js backend and HTTP wrappers',
+        }),
+    },
+});

package/dist/src/functions/commands/all.js

@@ -23,6 +23,7 @@ export const all = pikkuVoidFunc({
         await rpc.invoke('pikkuChannelTypes', null);
         await rpc.invoke('pikkuSchedulerTypes', null);
         await rpc.invoke('pikkuQueueTypes', null);
+        await rpc.invoke('pikkuWorkflowTypes', null);
         await rpc.invoke('pikkuMCPTypes', null);
         await rpc.invoke('pikkuCLITypes', null);
         const hasFunctionRegistrations = await rpc.invoke('pikkuFunctions', null);
@@ -69,6 +70,22 @@ export const all = pikkuVoidFunc({
         if (scheduler) {
             allImports.push(config.schedulersWiringMetaFile, config.schedulersWiringFile);
         }
+        // Generate Workflows
+        const workflows = await rpc.invoke('pikkuWorkflow', null);
+        // Generate Remote RPC Workers (must be before queue discovery so wireQueueWorker calls are picked up)
+        const remoteRPC = await rpc.invoke('pikkuRemoteRPC', null);
+        // Reinspect to pick up generated workflow workers and remote RPC workers BEFORE generating maps
+        if (workflows || remoteRPC) {
+            await getInspectorState(true);
+        }
+        if (workflows) {
+            await rpc.invoke('pikkuWorkflowMap', null);
+            allImports.push(config.workflowsWiringMetaFile, config.workflowsWiringFile);
+        }
+        if (remoteRPC && config.rpc?.remoteRpcWorkersPath) {
+            // Only add to imports if we actually generated the file
+            allImports.push(config.rpc.remoteRpcWorkersPath);
+        }
         // Generate Queues
         const queues = await rpc.invoke('pikkuQueue', null);
         if (queues) {
@@ -131,6 +148,9 @@ export const all = pikkuVoidFunc({
             if (totalCommands > 0)
                 summary.set('cliCommands', totalCommands);
         }
+        if (state.workflows?.meta) {
+            summary.set('workflows', Object.keys(state.workflows.meta).length);
+        }
         // Display summary (unless in silent mode)
         if (!logger.isSilent()) {
             console.log(summary.format());

package/dist/src/functions/commands/bootstrap.js

@@ -13,6 +13,7 @@ export const bootstrap = pikkuVoidFunc({
         await rpc.invoke('pikkuChannelTypes', null);
         await rpc.invoke('pikkuSchedulerTypes', null);
         await rpc.invoke('pikkuQueueTypes', null);
+        await rpc.invoke('pikkuWorkflowTypes', null);
         await rpc.invoke('pikkuMCPTypes', null);
         await rpc.invoke('pikkuCLITypes', null);
         // Check for critical errors and exit if any were logged

package/dist/src/functions/wirings/cli/serialize-channel-cli-client.js

@@ -99,29 +99,10 @@ ${rendererImports}
  * Executes CLI commands over a WebSocket connection
  */
 export async function ${capitalizedName}CLIClient(
-  url: string,
+  ws: WebSocket,
   args?: string[]
 ): Promise<void> {
-  // Get WebSocket implementation (browser or Node.js)
-  let WebSocketImpl: any
-  if (typeof WebSocket !== 'undefined') {
-    WebSocketImpl = WebSocket
-  } else {
-    // Node.js environment - dynamically import 'ws'
-    try {
-      const wsModule = await import('ws')
-      WebSocketImpl = wsModule.default
-    } catch (e) {
-      throw new Error(
-        'No WebSocket implementation found. In Node.js environments, you need to:\\n' +
-        '1. Install the "ws" package: npm install ws\\n' +
-        'Learn more: https://www.npmjs.com/package/ws'
-      )
-    }
-  }
-
-  // Create WebSocket connection
-  const ws = new WebSocketImpl(url) as WebSocket
+  // Create Pikku WebSocket wrapper
   const pikkuWS = new CorePikkuWebsocket(ws)
 
   // Register renderers for CLI commands
@@ -141,7 +122,19 @@ export default ${capitalizedName}CLIClient
 // For direct execution (if this file is run directly)
 if (import.meta.url === \`file://\${process.argv[1]}\`) {
   const url = process.env.PIKKU_WS_URL || 'ws://localhost:4002${finalChannelRoute}'
-  ${capitalizedName}CLIClient(url, process.argv.slice(2)).catch(error => {
+
+  // Create WebSocket instance
+  let WebSocketImpl: any
+  if (typeof WebSocket !== 'undefined') {
+    WebSocketImpl = WebSocket
+  } else {
+    // Node.js environment - dynamically import 'ws'
+    const wsModule = await import('ws')
+    WebSocketImpl = wsModule.default
+  }
+
+  const ws = new WebSocketImpl(url) as WebSocket
+  ${capitalizedName}CLIClient(ws, process.argv.slice(2)).catch(error => {
     console.error('Fatal channel CLI error:', error)
     // TODO: We get an error code even when it exists cleanly, investigate
     // process.exit(1)

package/dist/src/functions/wirings/queue/pikku-queue.js

@@ -8,7 +8,15 @@ export const pikkuQueue = pikkuSessionlessFunc({
         const visitState = await getInspectorState();
         const { queueWorkersWiringFile, queueWorkersWiringMetaFile, packageMappings, } = config;
         const { queueWorkers } = visitState;
-        await writeFileInDir(logger, queueWorkersWiringMetaFile, serializeQueueMeta(queueWorkers.meta));
+        // Add remote RPC worker to queue metadata if it exists
+        const queueMeta = { ...queueWorkers.meta };
+        if (config.rpc?.remoteRpcWorkersPath) {
+            queueMeta['pikku-remote-internal-rpc'] = {
+                pikkuFuncName: 'pikkuRemoteInternalRPC',
+                queueName: 'pikku-remote-internal-rpc',
+            };
+        }
+        await writeFileInDir(logger, queueWorkersWiringMetaFile, serializeQueueMeta(queueMeta));
         await writeFileInDir(logger, queueWorkersWiringFile, serializeFileImports('addQueueWorkers', queueWorkersWiringFile, queueWorkers.files, packageMappings));
         return true;
     },

package/dist/src/functions/wirings/queue/serialize-queue-map.d.ts

@@ -1,4 +1,4 @@
-import type { queueWorkersMeta } from '@pikku/core/queue';
+import type { QueueWorkersMeta } from '@pikku/core/queue';
 import { TypesMap } from '@pikku/inspector';
 import { FunctionsMeta } from '@pikku/core';
-export declare const serializeQueueMap: (relativeToPath: string, packageMappings: Record<string, string>, typesMap: TypesMap, functionsMeta: FunctionsMeta, queueWorkersMeta: queueWorkersMeta) => string;
+export declare const serializeQueueMap: (relativeToPath: string, packageMappings: Record<string, string>, typesMap: TypesMap, functionsMeta: FunctionsMeta, queueWorkersMeta: QueueWorkersMeta) => string;

package/dist/src/functions/wirings/queue/serialize-queue-meta.d.ts

@@ -1,2 +1,2 @@
-import { queueWorkersMeta } from '@pikku/core/queue';
-export declare const serializeQueueMeta: (queueWorkersMeta: queueWorkersMeta) => string;
+import { QueueWorkersMeta } from '@pikku/core/queue';
+export declare const serializeQueueMeta: (queueWorkersMeta: QueueWorkersMeta) => string;

package/dist/src/functions/wirings/rpc/pikku-command-public-rpc.d.ts

@@ -0,0 +1 @@
+export declare const pikkuPublicRPC: any;