@pikku/cli 0.10.1 → 0.11.0

package/dist/.pikku/schemas/register.gen.js

@@ -1,15 +1,15 @@
 /**
- * This file was generated by @pikku/cli@0.10.1
+ * This file was generated by @pikku/cli@0.11.0
  */
 import { addSchema } from '@pikku/core/schema';
-import * as PikkuSchemasOutput from './schemas/PikkuSchemasOutput.schema.json' with { type: 'json' };
-addSchema('PikkuSchemasOutput', PikkuSchemasOutput);
 import * as PikkuChannelsOutput from './schemas/PikkuChannelsOutput.schema.json' with { type: 'json' };
 addSchema('PikkuChannelsOutput', PikkuChannelsOutput);
 import * as PikkuCLIOutput from './schemas/PikkuCLIOutput.schema.json' with { type: 'json' };
 addSchema('PikkuCLIOutput', PikkuCLIOutput);
 import * as PikkuFunctionsOutput from './schemas/PikkuFunctionsOutput.schema.json' with { type: 'json' };
 addSchema('PikkuFunctionsOutput', PikkuFunctionsOutput);
+import * as PikkuSchemasOutput from './schemas/PikkuSchemasOutput.schema.json' with { type: 'json' };
+addSchema('PikkuSchemasOutput', PikkuSchemasOutput);
 import * as PikkuHTTPOutput from './schemas/PikkuHTTPOutput.schema.json' with { type: 'json' };
 addSchema('PikkuHTTPOutput', PikkuHTTPOutput);
 import * as PikkuMCPOutput from './schemas/PikkuMCPOutput.schema.json' with { type: 'json' };
@@ -20,9 +20,15 @@ import * as PikkuPermissionsOutput from './schemas/PikkuPermissionsOutput.schema
 addSchema('PikkuPermissionsOutput', PikkuPermissionsOutput);
 import * as PikkuQueueOutput from './schemas/PikkuQueueOutput.schema.json' with { type: 'json' };
 addSchema('PikkuQueueOutput', PikkuQueueOutput);
+import * as PikkuPublicRPCOutput from './schemas/PikkuPublicRPCOutput.schema.json' with { type: 'json' };
+addSchema('PikkuPublicRPCOutput', PikkuPublicRPCOutput);
+import * as PikkuRemoteRPCOutput from './schemas/PikkuRemoteRPCOutput.schema.json' with { type: 'json' };
+addSchema('PikkuRemoteRPCOutput', PikkuRemoteRPCOutput);
 import * as PikkuRPCOutput from './schemas/PikkuRPCOutput.schema.json' with { type: 'json' };
 addSchema('PikkuRPCOutput', PikkuRPCOutput);
 import * as PikkuSchedulerOutput from './schemas/PikkuSchedulerOutput.schema.json' with { type: 'json' };
 addSchema('PikkuSchedulerOutput', PikkuSchedulerOutput);
+import * as PikkuWorkflowOutput from './schemas/PikkuWorkflowOutput.schema.json' with { type: 'json' };
+addSchema('PikkuWorkflowOutput', PikkuWorkflowOutput);
 import * as PikkuCLIConfig from './schemas/PikkuCLIConfig.schema.json' with { type: 'json' };
 addSchema('PikkuCLIConfig', PikkuCLIConfig);

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" } }, "packageMappings": { "type": "object", "additionalProperties": { "type": "string" } }, "supportsImportAttributes": { "type": "boolean" }, "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 }, "cli": { "type": "object", "properties": { "entrypoints": { "type": "object", "additionalProperties": { "anyOf": [{ "type": "string" }, { "type": "object", "properties": { "type": { "type": "string", "const": "cli" }, "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": "cli" }, "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", "supportsImportAttributes", "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], "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/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], "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/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.0
+ */
+/**
+ * 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.0
+ */
+/**
+ * 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.js

@@ -0,0 +1,5 @@
+/**
+ * This file was generated by @pikku/cli@0.11.0
+ */
+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.0
+ */

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

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

package/dist/bin/pikku.js

@@ -3,25 +3,27 @@ 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('../.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
+//     )
+//   }
+// }
 // Fallback to Commander.js for initial setup
 // Import bootstrap if it exists
 try {
@@ -56,7 +58,10 @@ const all = (program, name, description) => {
         .option('-n, --names <names...>', 'Filter functions by name patterns (supports wildcards)')
         .option('--httpMethods <methods...>', 'Filter HTTP routes by methods (comma-separated)')
         .option('--httpRoutes <routes...>', 'Filter HTTP routes by route patterns (comma-separated)')
-        .option('-s, --silent', 'Silent mode - only show errors')
+        .option('-s, --silent', 'Silent mode - only show critical errors')
+        .option('--info', 'Show info messages and above (info, warn, error, critical)')
+        .option('--verbose', 'Show all debug messages (most detailed)')
+        .option('--loglevel <level>', 'Set explicit log level (trace, debug, info, warn, error, critical)')
         .option('--state-output <path>', 'Save inspector state to JSON file for reuse')
         .option('--state-input <path>', 'Load inspector state from JSON file (skips inspection)')
         .action((c) => action(name, c));

package/dist/src/cli.wiring.js

@@ -1,99 +1,107 @@
-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 { 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',
-                },
-            },
-        }),
-        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 { 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',
+//     }),
+//   },
+// })

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

@@ -2,8 +2,10 @@ import { existsSync } from 'fs';
 import { pikkuVoidFunc } from '../../../.pikku/pikku-types.gen.js';
 import { getFileImportRelativePath } from '../../utils/file-import-path.js';
 import { writeFileInDir } from '../../utils/file-writer.js';
+import { CommandSummary } from '../../utils/command-summary.js';
 export const all = pikkuVoidFunc({
     func: async ({ logger, config, rpc, getInspectorState }) => {
+        const summary = new CommandSummary('all');
         const allImports = [];
         let typesDeclarationFileExists = true;
         if (!existsSync(config.typesDeclarationFile)) {
@@ -12,7 +14,7 @@ export const all = pikkuVoidFunc({
         await rpc.invoke('pikkuFunctionTypes', null);
         // This is needed since the wireHTTP function will add the routes to the visitState
         if (!typesDeclarationFileExists) {
-            logger.info(`• Type file first created, inspecting again...\x1b[0m`);
+            logger.debug(`• Type file first created, inspecting again...`);
             await getInspectorState(true);
         }
         // Generate wiring-specific type files for tree-shaking
@@ -21,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);
@@ -67,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) {
@@ -97,7 +116,7 @@ export const all = pikkuVoidFunc({
             await rpc.invoke('pikkuNext', null);
         }
         if (config.openAPI) {
-            logger.info(`• OpenAPI requires a reinspection to pickup new generated types..`);
+            logger.debug(`• OpenAPI requires a reinspection to pickup new generated types..`);
             await getInspectorState(true);
             await rpc.invoke('pikkuOpenAPI', null);
         }
@@ -106,6 +125,36 @@ export const all = pikkuVoidFunc({
             .map((to) => `import '${getFileImportRelativePath(config.bootstrapFile, to, config.packageMappings)}'`)
             .sort((to) => (to.includes('meta') ? -1 : 1)) // Ensure meta files are at the top
             .join('\n'));
+        // Get final inspector state and collect stats for summary
+        const state = await getInspectorState();
+        if (state.http?.meta)
+            summary.set('httpRoutes', Object.keys(state.http.meta).length);
+        if (state.channels?.meta)
+            summary.set('channels', Object.keys(state.channels.meta).length);
+        if (state.scheduledTasks?.meta)
+            summary.set('scheduledTasks', Object.keys(state.scheduledTasks.meta).length);
+        if (state.queueWorkers?.meta)
+            summary.set('queueWorkers', Object.keys(state.queueWorkers.meta).length);
+        if (state.mcpEndpoints) {
+            const mcpTotal = Object.keys(state.mcpEndpoints.toolsMeta || {}).length +
+                Object.keys(state.mcpEndpoints.resourcesMeta || {}).length +
+                Object.keys(state.mcpEndpoints.promptsMeta || {}).length;
+            if (mcpTotal > 0)
+                summary.set('mcpEndpoints', mcpTotal);
+        }
+        if (state.cli?.meta) {
+            // Count total CLI commands across all programs
+            const totalCommands = Object.values(state.cli.meta).reduce((sum, program) => sum + (program.commands?.length || 0), 0);
+            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());
+        }
         // Check for critical errors and exit if any were logged
         if (logger.hasCriticalErrors()) {
             process.exit(1);

package/dist/src/functions/commands/bootstrap.d.ts

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

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

@@ -0,0 +1,24 @@
+import { pikkuVoidFunc } from '../../../.pikku/pikku-types.gen.js';
+export const bootstrap = pikkuVoidFunc({
+    func: async ({ logger, config, rpc, getInspectorState }) => {
+        // Initialize inspector state in bootstrap mode with core types only
+        // This allows bootstrap to run immediately without inspecting the codebase
+        // All subsequent RPC commands will use this cached state
+        await getInspectorState(false, false, true);
+        await rpc.invoke('pikkuFunctionTypes', null);
+        // Generate wiring-specific type files for tree-shaking
+        // These use the bootstrap mode state with core types
+        await rpc.invoke('pikkuFunctionTypesSplit', null);
+        await rpc.invoke('pikkuHTTPTypes', null);
+        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
+        if (logger.hasCriticalErrors()) {
+            process.exit(1);
+        }
+    },
+});