@pikku/cli 0.10.2 → 0.11.0

package/dist/src/functions/wirings/workflow/serialize-workflow-workers.js

@@ -0,0 +1,60 @@
+/**
+ * Generate queue workers and RPC functions for workflow steps and orchestrator
+ */
+export const serializeWorkflowWorkers = (pathToPikkuTypes) => {
+    return `/**
+ * Auto-generated workflow queue workers and RPC functions
+ * Do not edit manually - regenerate with 'npx pikku'
+ */
+import { pikkuSessionlessFunc, wireQueueWorker } from '${pathToPikkuTypes}'
+
+/**
+ * Worker input types for generated queue workers
+ */
+export type WorkflowStepInput = {
+  runId: string
+  stepName: string
+  rpcName: string
+  data: any
+}
+
+export const pikkuWorkflowWorker = pikkuSessionlessFunc<
+  WorkflowStepInput,
+  void
+>({
+  func: async ({ workflowService, rpc }, { runId, stepName, rpcName, data }) => {
+    await workflowService!.executeWorkflowStep(runId, stepName, rpcName, data, rpc)
+  }
+})
+
+export const pikkuWorkflowOrchestrator = pikkuSessionlessFunc<
+  { runId: string },
+  void
+>({
+  func: async ({ workflowService, rpc }, { runId }) => {
+    await workflowService!.orchestrateWorkflow(runId, rpc)
+  }
+})
+
+export const pikkuWorkflowSleeper = pikkuSessionlessFunc<
+  { runId: string, stepId: string },
+  void
+>({
+  func: async ({ workflowService }, { runId, stepId }) => {
+    await workflowService!.executeWorkflowSleep(runId, stepId)
+  },
+  name: 'pikkuWorkflowStepSleeper',
+  internal: true,
+})
+
+wireQueueWorker({
+  queueName: 'pikku-workflow-step-worker',
+  func: pikkuWorkflowWorker,
+})
+
+wireQueueWorker({
+  queueName: 'pikku-workflow-orchestrator',
+  func: pikkuWorkflowOrchestrator,
+})
+`;
+};

package/dist/src/services/cli-logger-forwarder.service.js

@@ -53,7 +53,7 @@ export class CLILoggerForwarder {
         this.log('trace', LogLevel.trace, message);
     }
     critical(code, message) {
-        const url = `https://pikku.dev/docs/cli-errors/${code.toLowerCase()}`;
+        const url = `https://pikku.dev/docs/pikku-cli/errors/${code.toLowerCase()}`;
         const formattedMessage = `[${code}] ${message}\n  → ${url}`;
         this.error(formattedMessage);
     }

package/dist/src/services/cli-logger.service.js

@@ -8,7 +8,7 @@ const logo = `
 | |    | |  _ (|  _ (|  _ (| |_| |
 |_|    |_|_| _)_| _)____/
 `;
-const BASE_ERROR_URL = 'https://pikku.dev/errors';
+const BASE_ERROR_URL = 'https://pikku.dev/docs/pikku-cli/errors';
 export class CLILogger {
     silent;
     level = LogLevel.warn; // default to warn level

package/dist/src/utils/command-summary.d.ts

@@ -6,6 +6,7 @@ export interface CommandSummaryStats {
     queueWorkers?: number;
     mcpEndpoints?: number;
     cliCommands?: number;
+    workflows?: number;
     [key: string]: number | undefined;
 }
 /**

package/dist/src/utils/command-summary.js

@@ -44,18 +44,19 @@ export class CommandSummary {
         lines.push(chalk.green(`\npikku ${this.commandName} (completed in ${elapsed}ms)`));
         // Stats
         const statLabels = {
-            httpRoutes: 'HTTP routes',
-            channels: 'WebSocket channels',
-            functions: 'functions',
-            scheduledTasks: 'scheduled tasks',
-            queueWorkers: 'queue workers',
-            mcpEndpoints: 'MCP endpoints',
-            cliCommands: 'CLI commands',
+            httpRoutes: 'HTTP route',
+            channels: 'WebSocket channel',
+            functions: 'Function',
+            scheduledTasks: 'Scheduled task',
+            queueWorkers: 'Queue worker',
+            mcpEndpoints: 'MCP endpoint',
+            cliCommands: 'CLI command',
+            workflows: 'Workflow',
         };
         for (const [key, label] of Object.entries(statLabels)) {
             const value = this.stats[key];
             if (value !== undefined && value > 0) {
-                lines.push(chalk.gray(`  • ${value} ${label}`));
+                lines.push(chalk.gray(`  • ${value} ${label}${value > 1 ? 's' : ''}`));
             }
         }
         // If no stats, show a simple completion message

package/dist/src/utils/pikku-cli-config.js

@@ -40,11 +40,9 @@ const _getPikkuCLIConfig = async (logger, configFile = undefined, requiredFields
                 },
                 ignoreFiles: config.ignoreFiles ??
                     extendedConfig.ignoreFiles ?? [
-                    '**/*.gen.ts',
                     '**/*.test.ts',
                     '**/*.spec.ts',
                     '**/node_modules/**',
-                    '**/.pikku/**',
                     '**/dist/**',
                 ],
                 schema: {
@@ -64,11 +62,9 @@ const _getPikkuCLIConfig = async (logger, configFile = undefined, requiredFields
                     ? resolve(configDir, config.rootDir)
                     : configDir,
                 ignoreFiles: config.ignoreFiles ?? [
-                    '**/*.gen.ts',
                     '**/*.test.ts',
                     '**/*.spec.ts',
                     '**/node_modules/**',
-                    '**/.pikku/**',
                     '**/dist/**',
                 ],
                 schema: {
@@ -85,6 +81,7 @@ const _getPikkuCLIConfig = async (logger, configFile = undefined, requiredFields
         const rpcDir = join(result.outDir, 'rpc');
         const schedulerDir = join(result.outDir, 'scheduler');
         const queueDir = join(result.outDir, 'queue');
+        const workflowDir = join(result.outDir, 'workflow');
         const mcpDir = join(result.outDir, 'mcp');
         const cliDir = join(result.outDir, 'cli');
         const middlewareDir = join(result.outDir, 'middleware');
@@ -144,6 +141,13 @@ const _getPikkuCLIConfig = async (logger, configFile = undefined, requiredFields
         if (!result.rpcMapDeclarationFile) {
             result.rpcMapDeclarationFile = join(rpcDir, 'pikku-rpc-wirings-map.gen.d.ts');
         }
+        // RPC config defaults
+        if (!result.rpc) {
+            result.rpc = {};
+        }
+        if (!result.rpc.remoteRpcWorkersPath) {
+            result.rpc.remoteRpcWorkersPath = join(rpcDir, 'pikku-remote-rpc-workers.gen.ts');
+        }
         // Scheduler
         if (!result.schedulersWiringFile) {
             result.schedulersWiringFile = join(schedulerDir, 'pikku-schedulers-wirings.gen.ts');
@@ -167,6 +171,22 @@ const _getPikkuCLIConfig = async (logger, configFile = undefined, requiredFields
         if (!result.queueTypesFile) {
             result.queueTypesFile = join(queueDir, 'pikku-queue-types.gen.ts');
         }
+        // Workflows
+        if (!result.workflowsWiringFile) {
+            result.workflowsWiringFile = join(workflowDir, 'pikku-workflow-wirings.gen.ts');
+        }
+        if (!result.workflowsWiringMetaFile) {
+            result.workflowsWiringMetaFile = join(workflowDir, 'pikku-workflow-wirings-meta.gen.ts');
+        }
+        if (!result.workflowsWorkersFile) {
+            result.workflowsWorkersFile = join(workflowDir, 'pikku-workflow-workers.gen.ts');
+        }
+        if (!result.workflowMapDeclarationFile) {
+            result.workflowMapDeclarationFile = join(workflowDir, 'pikku-workflow-map.gen.d.ts');
+        }
+        if (!result.workflowTypesFile) {
+            result.workflowTypesFile = join(workflowDir, 'pikku-workflow-types.gen.ts');
+        }
         // Services
         if (!result.servicesFile) {
             result.servicesFile = join(result.outDir, 'pikku-services.gen.ts');

package/dist/src/utils/schema-generator.js

@@ -7,9 +7,14 @@ export async function generateSchemas(logger, tsconfig, typesMap, functionMeta,
     for (const { inputs, outputs } of Object.values(functionMeta)) {
         const types = [...(inputs || []), ...(outputs || [])];
         for (const type of types) {
-            const uniqueName = typesMap.getUniqueName(type);
-            if (uniqueName) {
-                schemasSet.add(uniqueName);
+            try {
+                const uniqueName = typesMap.getUniqueName(type);
+                if (uniqueName) {
+                    schemasSet.add(uniqueName);
+                }
+            }
+            catch {
+                // Skip types not in typesMap (e.g., inline types in generated workflow workers)
             }
         }
     }
@@ -64,10 +69,26 @@ export async function saveSchemas(logger, schemaParentDir, schemas, typesMap, fu
     await writeFileInDir(logger, `${schemaParentDir}/register.gen.ts`, 'export const empty = null;');
     const desiredSchemas = new Set([
         ...Object.values(functionsMeta)
-            .map(({ inputs, outputs }) => [
-            inputs?.[0] ? typesMap.getUniqueName(inputs[0]) : undefined,
-            outputs?.[0] ? typesMap.getUniqueName(outputs[0]) : undefined,
-        ])
+            .map(({ inputs, outputs }) => {
+            const types = [];
+            if (inputs?.[0]) {
+                try {
+                    types.push(typesMap.getUniqueName(inputs[0]));
+                }
+                catch {
+                    // Skip types not in typesMap (e.g., inline types in generated workflow workers)
+                }
+            }
+            if (outputs?.[0]) {
+                try {
+                    types.push(typesMap.getUniqueName(outputs[0]));
+                }
+                catch {
+                    // Skip types not in typesMap (e.g., inline types in generated workflow workers)
+                }
+            }
+            return types;
+        })
             .flat()
             .filter((s) => !!s &&
             !['boolean', 'string', 'number', 'null', 'undefined'].includes(s)),

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../bin/pikku.ts","../src/cli.wiring.ts","../src/services.ts","../src/functions/commands/all.ts","../src/functions/commands/bootstrap.ts","../src/functions/commands/watch.ts","../src/functions/runtimes/nextjs/pikku-command-nextjs.ts","../src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.ts","../src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.ts","../src/functions/wirings/channels/pikku-channels.ts","../src/functions/wirings/channels/pikku-command-channel-types.ts","../src/functions/wirings/channels/pikku-command-channels-map.ts","../src/functions/wirings/channels/pikku-command-channels.ts","../src/functions/wirings/channels/pikku-command-websocket-typed.ts","../src/functions/wirings/channels/serialize-channel-types.ts","../src/functions/wirings/channels/serialize-typed-channel-map.ts","../src/functions/wirings/channels/serialize-websocket-wrapper.ts","../src/functions/wirings/cli/pikku-command-cli-entry.ts","../src/functions/wirings/cli/pikku-command-cli-types.ts","../src/functions/wirings/cli/pikku-command-cli.ts","../src/functions/wirings/cli/serialize-channel-cli-client.ts","../src/functions/wirings/cli/serialize-channel-cli.ts","../src/functions/wirings/cli/serialize-cli-types.ts","../src/functions/wirings/cli/serialize-local-cli-bootstrap.ts","../src/functions/wirings/fetch/index.ts","../src/functions/wirings/functions/pikku-command-function-types-split.ts","../src/functions/wirings/functions/pikku-command-function-types.ts","../src/functions/wirings/functions/pikku-command-functions.ts","../src/functions/wirings/functions/pikku-command-services.ts","../src/functions/wirings/functions/pikku-function-types.ts","../src/functions/wirings/functions/schemas.ts","../src/functions/wirings/functions/serialize-function-imports.ts","../src/functions/wirings/functions/serialize-function-types.ts","../src/functions/wirings/functions/serialize-pikku-types-hub.ts","../src/functions/wirings/http/openapi-spec-generator.ts","../src/functions/wirings/http/pikku-command-http-map.ts","../src/functions/wirings/http/pikku-command-http-routes.ts","../src/functions/wirings/http/pikku-command-http-types.ts","../src/functions/wirings/http/pikku-command-openapi.ts","../src/functions/wirings/http/pikku-http-routes.ts","../src/functions/wirings/http/serialize-fetch-wrapper.ts","../src/functions/wirings/http/serialize-http-types.ts","../src/functions/wirings/http/serialize-typed-http-map.ts","../src/functions/wirings/mcp/pikku-command-mcp-json.ts","../src/functions/wirings/mcp/pikku-command-mcp-types.ts","../src/functions/wirings/mcp/pikku-command-mcp.ts","../src/functions/wirings/mcp/serialize-mcp-json.ts","../src/functions/wirings/mcp/serialize-mcp-types.ts","../src/functions/wirings/middleware/pikku-command-middleware.ts","../src/functions/wirings/middleware/serialize-middleware-groups-meta.ts","../src/functions/wirings/middleware/serialize-middleware-imports.ts","../src/functions/wirings/permissions/pikku-command-permissions.ts","../src/functions/wirings/permissions/serialize-permissions-imports.ts","../src/functions/wirings/queue/pikku-command-queue-map.ts","../src/functions/wirings/queue/pikku-command-queue-service.ts","../src/functions/wirings/queue/pikku-command-queue-types.ts","../src/functions/wirings/queue/pikku-command-queue.ts","../src/functions/wirings/queue/pikku-queue-map.ts","../src/functions/wirings/queue/pikku-queue.ts","../src/functions/wirings/queue/serialize-queue-map.ts","../src/functions/wirings/queue/serialize-queue-meta.ts","../src/functions/wirings/queue/serialize-queue-types.ts","../src/functions/wirings/queue/serialize-queue-wrapper.ts","../src/functions/wirings/rpc/pikku-command-rpc-client.ts","../src/functions/wirings/rpc/pikku-command-rpc-map.ts","../src/functions/wirings/rpc/pikku-command-rpc.ts","../src/functions/wirings/rpc/serialize-rpc-wrapper.ts","../src/functions/wirings/rpc/serialize-typed-rpc-map.ts","../src/functions/wirings/scheduler/pikku-command-scheduler-types.ts","../src/functions/wirings/scheduler/pikku-command-scheduler.ts","../src/functions/wirings/scheduler/serialize-scheduler-meta.ts","../src/functions/wirings/scheduler/serialize-scheduler-types.ts","../src/middleware/log-command-info-and-time.ts","../src/services/cli-logger-forwarder.service.ts","../src/services/cli-logger.service.ts","../src/utils/check-required-types.ts","../src/utils/command-summary.ts","../src/utils/custom-types-generator.ts","../src/utils/file-import-path.ts","../src/utils/file-imports-serializer.ts","../src/utils/file-writer.ts","../src/utils/generate-bootstrap-file.ts","../src/utils/get-cli-version.ts","../src/utils/pikku-cli-config.ts","../src/utils/pikku-files-and-methods.ts","../src/utils/schema-generator.ts","../src/utils/serialize-import-map.ts","../.pikku/pikku-bootstrap.gen.ts","../.pikku/pikku-services.gen.ts","../.pikku/pikku-types.gen.ts","../.pikku/pikku-websocket.gen.ts","../.pikku/channel/pikku-channel-types.gen.ts","../.pikku/channel/pikku-channels-map.gen.d.ts","../.pikku/channel/pikku-channels-meta.gen.ts","../.pikku/channel/pikku-channels.gen.ts","../.pikku/cli/pikku-cli-types.gen.ts","../.pikku/cli/pikku-cli-wirings-meta.gen.ts","../.pikku/cli/pikku-cli-wirings.gen.ts","../.pikku/function/pikku-function-types.gen.ts","../.pikku/function/pikku-functions-meta.gen.ts","../.pikku/function/pikku-functions-meta.min.gen.ts","../.pikku/function/pikku-functions.gen.ts","../.pikku/http/pikku-http-types.gen.ts","../.pikku/http/pikku-http-wirings-map.gen.d.ts","../.pikku/http/pikku-http-wirings-meta.gen.ts","../.pikku/http/pikku-http-wirings.gen.ts","../.pikku/mcp/pikku-mcp-types.gen.ts","../.pikku/mcp/pikku-mcp-wirings-meta.gen.ts","../.pikku/mcp/pikku-mcp-wirings.gen.ts","../.pikku/queue/pikku-queue-types.gen.ts","../.pikku/queue/pikku-queue-workers-wirings-map.gen.d.ts","../.pikku/queue/pikku-queue-workers-wirings-meta.gen.ts","../.pikku/queue/pikku-queue-workers-wirings.gen.ts","../.pikku/rpc/pikku-rpc-wirings-map.gen.d.ts","../.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts","../.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.ts","../.pikku/scheduler/pikku-scheduler-types.gen.ts","../.pikku/scheduler/pikku-schedulers-wirings-meta.gen.ts","../.pikku/scheduler/pikku-schedulers-wirings.gen.ts","../.pikku/schemas/register.gen.ts","../types/application-types.d.ts","../types/config.d.ts"],"version":"5.9.3"}
+{"root":["../bin/pikku.ts","../src/cli.wiring.ts","../src/services.ts","../src/functions/commands/all.ts","../src/functions/commands/bootstrap.ts","../src/functions/commands/watch.ts","../src/functions/runtimes/nextjs/pikku-command-nextjs.ts","../src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.ts","../src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.ts","../src/functions/wirings/channels/pikku-channels.ts","../src/functions/wirings/channels/pikku-command-channel-types.ts","../src/functions/wirings/channels/pikku-command-channels-map.ts","../src/functions/wirings/channels/pikku-command-channels.ts","../src/functions/wirings/channels/pikku-command-websocket-typed.ts","../src/functions/wirings/channels/serialize-channel-types.ts","../src/functions/wirings/channels/serialize-typed-channel-map.ts","../src/functions/wirings/channels/serialize-websocket-wrapper.ts","../src/functions/wirings/cli/pikku-command-cli-entry.ts","../src/functions/wirings/cli/pikku-command-cli-types.ts","../src/functions/wirings/cli/pikku-command-cli.ts","../src/functions/wirings/cli/serialize-channel-cli-client.ts","../src/functions/wirings/cli/serialize-channel-cli.ts","../src/functions/wirings/cli/serialize-cli-types.ts","../src/functions/wirings/cli/serialize-local-cli-bootstrap.ts","../src/functions/wirings/fetch/index.ts","../src/functions/wirings/functions/pikku-command-function-types-split.ts","../src/functions/wirings/functions/pikku-command-function-types.ts","../src/functions/wirings/functions/pikku-command-functions.ts","../src/functions/wirings/functions/pikku-command-services.ts","../src/functions/wirings/functions/pikku-function-types.ts","../src/functions/wirings/functions/schemas.ts","../src/functions/wirings/functions/serialize-function-imports.ts","../src/functions/wirings/functions/serialize-function-types.ts","../src/functions/wirings/functions/serialize-pikku-types-hub.ts","../src/functions/wirings/http/openapi-spec-generator.ts","../src/functions/wirings/http/pikku-command-http-map.ts","../src/functions/wirings/http/pikku-command-http-routes.ts","../src/functions/wirings/http/pikku-command-http-types.ts","../src/functions/wirings/http/pikku-command-openapi.ts","../src/functions/wirings/http/pikku-http-routes.ts","../src/functions/wirings/http/serialize-fetch-wrapper.ts","../src/functions/wirings/http/serialize-http-types.ts","../src/functions/wirings/http/serialize-typed-http-map.ts","../src/functions/wirings/mcp/pikku-command-mcp-json.ts","../src/functions/wirings/mcp/pikku-command-mcp-types.ts","../src/functions/wirings/mcp/pikku-command-mcp.ts","../src/functions/wirings/mcp/serialize-mcp-json.ts","../src/functions/wirings/mcp/serialize-mcp-types.ts","../src/functions/wirings/middleware/pikku-command-middleware.ts","../src/functions/wirings/middleware/serialize-middleware-groups-meta.ts","../src/functions/wirings/middleware/serialize-middleware-imports.ts","../src/functions/wirings/permissions/pikku-command-permissions.ts","../src/functions/wirings/permissions/serialize-permissions-imports.ts","../src/functions/wirings/queue/pikku-command-queue-map.ts","../src/functions/wirings/queue/pikku-command-queue-service.ts","../src/functions/wirings/queue/pikku-command-queue-types.ts","../src/functions/wirings/queue/pikku-command-queue.ts","../src/functions/wirings/queue/pikku-queue-map.ts","../src/functions/wirings/queue/pikku-queue.ts","../src/functions/wirings/queue/serialize-queue-map.ts","../src/functions/wirings/queue/serialize-queue-meta.ts","../src/functions/wirings/queue/serialize-queue-types.ts","../src/functions/wirings/queue/serialize-queue-wrapper.ts","../src/functions/wirings/rpc/pikku-command-public-rpc.ts","../src/functions/wirings/rpc/pikku-command-remote-rpc.ts","../src/functions/wirings/rpc/pikku-command-rpc-client.ts","../src/functions/wirings/rpc/pikku-command-rpc-map.ts","../src/functions/wirings/rpc/pikku-command-rpc.ts","../src/functions/wirings/rpc/serialize-public-rpc.ts","../src/functions/wirings/rpc/serialize-remote-rpc.ts","../src/functions/wirings/rpc/serialize-rpc-wrapper.ts","../src/functions/wirings/rpc/serialize-typed-rpc-map.ts","../src/functions/wirings/scheduler/pikku-command-scheduler-types.ts","../src/functions/wirings/scheduler/pikku-command-scheduler.ts","../src/functions/wirings/scheduler/serialize-scheduler-meta.ts","../src/functions/wirings/scheduler/serialize-scheduler-types.ts","../src/functions/wirings/workflow/pikku-command-workflow-map.ts","../src/functions/wirings/workflow/pikku-command-workflow-types.ts","../src/functions/wirings/workflow/pikku-command-workflow.ts","../src/functions/wirings/workflow/serialize-workflow-map.ts","../src/functions/wirings/workflow/serialize-workflow-meta.ts","../src/functions/wirings/workflow/serialize-workflow-types.ts","../src/functions/wirings/workflow/serialize-workflow-workers.ts","../src/middleware/log-command-info-and-time.ts","../src/services/cli-logger-forwarder.service.ts","../src/services/cli-logger.service.ts","../src/utils/check-required-types.ts","../src/utils/command-summary.ts","../src/utils/custom-types-generator.ts","../src/utils/file-import-path.ts","../src/utils/file-imports-serializer.ts","../src/utils/file-writer.ts","../src/utils/generate-bootstrap-file.ts","../src/utils/get-cli-version.ts","../src/utils/pikku-cli-config.ts","../src/utils/pikku-files-and-methods.ts","../src/utils/schema-generator.ts","../src/utils/serialize-import-map.ts","../.pikku/pikku-bootstrap.gen.ts","../.pikku/pikku-services.gen.ts","../.pikku/pikku-types.gen.ts","../.pikku/pikku-websocket.gen.ts","../.pikku/channel/pikku-channel-types.gen.ts","../.pikku/channel/pikku-channels-map.gen.d.ts","../.pikku/channel/pikku-channels-meta.gen.ts","../.pikku/channel/pikku-channels.gen.ts","../.pikku/cli/pikku-cli-types.gen.ts","../.pikku/cli/pikku-cli-wirings-meta.gen.ts","../.pikku/cli/pikku-cli-wirings.gen.ts","../.pikku/function/pikku-function-types.gen.ts","../.pikku/function/pikku-functions-meta.gen.ts","../.pikku/function/pikku-functions-meta.min.gen.ts","../.pikku/function/pikku-functions.gen.ts","../.pikku/http/pikku-http-types.gen.ts","../.pikku/http/pikku-http-wirings-map.gen.d.ts","../.pikku/http/pikku-http-wirings-meta.gen.ts","../.pikku/http/pikku-http-wirings.gen.ts","../.pikku/mcp/pikku-mcp-types.gen.ts","../.pikku/mcp/pikku-mcp-wirings-meta.gen.ts","../.pikku/mcp/pikku-mcp-wirings.gen.ts","../.pikku/queue/pikku-queue-types.gen.ts","../.pikku/queue/pikku-queue-workers-wirings-map.gen.d.ts","../.pikku/queue/pikku-queue-workers-wirings-meta.gen.ts","../.pikku/queue/pikku-queue-workers-wirings.gen.ts","../.pikku/rpc/pikku-remote-rpc-workers.gen.ts","../.pikku/rpc/pikku-rpc-wirings-map.gen.d.ts","../.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts","../.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.ts","../.pikku/scheduler/pikku-scheduler-types.gen.ts","../.pikku/scheduler/pikku-schedulers-wirings-meta.gen.ts","../.pikku/scheduler/pikku-schedulers-wirings.gen.ts","../.pikku/schemas/register.gen.ts","../.pikku/workflow/pikku-workflow-map.gen.d.ts","../.pikku/workflow/pikku-workflow-types.gen.ts","../.pikku/workflow/pikku-workflow-wirings-meta.gen.ts","../.pikku/workflow/pikku-workflow-wirings.gen.ts","../types/application-types.d.ts","../types/config.d.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/cli",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
   "bin": {
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@openapi-contrib/json-schema-to-openapi-schema": "^4.2.0",
-    "@pikku/core": "^0.10.2",
-    "@pikku/inspector": "^0.10.2",
+    "@pikku/core": "^0.11.0",
+    "@pikku/inspector": "^0.11.0",
     "@types/cookie": "^1.0.0",
     "@types/json-schema": "^7.0.15",
     "chalk": "^5.6.2",

package/src/functions/commands/all.ts

@@ -28,6 +28,7 @@ export const all: any = 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)
 
@@ -89,6 +90,30 @@ export const all: any = pikkuVoidFunc({
       )
     }
 
+    // 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) {
@@ -175,6 +200,9 @@ export const all: any = 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()) {

package/src/functions/commands/bootstrap.ts

@@ -16,6 +16,7 @@ export const bootstrap: any = 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)
 

package/src/functions/wirings/cli/serialize-channel-cli-client.ts

@@ -139,29 +139,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
@@ -181,7 +162,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/src/functions/wirings/queue/pikku-queue.ts

@@ -14,10 +14,19 @@ export const pikkuQueue: any = pikkuSessionlessFunc<void, boolean>({
     } = config
     const { queueWorkers } = visitState
 
+    // 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(queueWorkers.meta)
+      serializeQueueMeta(queueMeta)
     )
     await writeFileInDir(
       logger,

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

@@ -1,4 +1,4 @@
-import type { queueWorkersMeta } from '@pikku/core/queue'
+import type { QueueWorkersMeta } from '@pikku/core/queue'
 import { serializeImportMap } from '../../../utils/serialize-import-map.js'
 import { TypesMap } from '@pikku/inspector'
 import { FunctionsMeta } from '@pikku/core'
@@ -9,7 +9,7 @@ export const serializeQueueMap = (
   packageMappings: Record<string, string>,
   typesMap: TypesMap,
   functionsMeta: FunctionsMeta,
-  queueWorkersMeta: queueWorkersMeta
+  queueWorkersMeta: QueueWorkersMeta
 ) => {
   const requiredTypes = new Set<string>()
   const serializedCustomTypes = generateCustomTypes(typesMap, requiredTypes)
@@ -69,7 +69,7 @@ export type TypedPikkuQueue = {
 }
 
 function generateQueues(
-  queueWorkersMeta: queueWorkersMeta,
+  queueWorkersMeta: QueueWorkersMeta,
   functionsMeta: FunctionsMeta,
   typesMap: TypesMap,
   requiredTypes: Set<string>

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

@@ -1,6 +1,6 @@
-import { queueWorkersMeta } from '@pikku/core/queue'
+import { QueueWorkersMeta } from '@pikku/core/queue'
 
-export const serializeQueueMeta = (queueWorkersMeta: queueWorkersMeta) => {
+export const serializeQueueMeta = (queueWorkersMeta: QueueWorkersMeta) => {
   const serializedOutput: string[] = []
   serializedOutput.push("import { pikkuState } from '@pikku/core'")
   serializedOutput.push(

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

@@ -0,0 +1,32 @@
+import { pikkuSessionlessFunc } from '../../../../.pikku/pikku-types.gen.js'
+import { getFileImportRelativePath } from '../../../utils/file-import-path.js'
+import { writeFileInDir } from '../../../utils/file-writer.js'
+import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js'
+import { serializePublicRPC } from './serialize-public-rpc.js'
+import { join } from 'path'
+
+export const pikkuPublicRPC: any = pikkuSessionlessFunc<void, boolean>({
+  func: async ({ logger, config }) => {
+    if (config.rpc?.publicRpcPath) {
+      const publicRpcPath = join(config.rootDir, config.rpc.publicRpcPath)
+      const pathToPikkuTypes = getFileImportRelativePath(
+        publicRpcPath,
+        config.typesDeclarationFile,
+        config.packageMappings
+      )
+      await writeFileInDir(
+        logger,
+        publicRpcPath,
+        serializePublicRPC(pathToPikkuTypes)
+      )
+      return true
+    }
+    return false
+  },
+  middleware: [
+    logCommandInfoAndTime({
+      commandStart: 'Generating Public RPC Endpoint',
+      commandEnd: 'Generated Public RPC Endpoint',
+    }),
+  ],
+})

package/src/functions/wirings/rpc/pikku-command-remote-rpc.ts

@@ -0,0 +1,35 @@
+import { pikkuSessionlessFunc } from '../../../../.pikku/pikku-types.gen.js'
+import { getFileImportRelativePath } from '../../../utils/file-import-path.js'
+import { writeFileInDir } from '../../../utils/file-writer.js'
+import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js'
+import { serializeRemoteRPC } from './serialize-remote-rpc.js'
+import { join } from 'path'
+
+export const pikkuRemoteRPC: any = pikkuSessionlessFunc<void, boolean>({
+  func: async ({ logger, config }) => {
+    if (config.rpc?.remoteRpcWorkersPath) {
+      const remoteRpcPath = join(
+        config.rootDir,
+        config.rpc.remoteRpcWorkersPath
+      )
+      const pathToPikkuTypes = getFileImportRelativePath(
+        remoteRpcPath,
+        config.typesDeclarationFile,
+        config.packageMappings
+      )
+      await writeFileInDir(
+        logger,
+        remoteRpcPath,
+        serializeRemoteRPC(pathToPikkuTypes)
+      )
+      return true
+    }
+    return false
+  },
+  middleware: [
+    logCommandInfoAndTime({
+      commandStart: 'Generating Remote RPC Workers',
+      commandEnd: 'Generated Remote RPC Workers',
+    }),
+  ],
+})

package/src/functions/wirings/rpc/serialize-public-rpc.ts

@@ -0,0 +1,30 @@
+/**
+ * Generate public RPC HTTP endpoint
+ */
+export const serializePublicRPC = (pathToPikkuTypes: string) => {
+  return `/**
+ * Auto-generated public RPC HTTP endpoint
+ * Do not edit manually - regenerate with 'npx pikku'
+ */
+import { pikkuSessionlessFunc, wireHTTP } from '${pathToPikkuTypes}'
+
+/**
+ * Public RPC endpoint that invokes any exposed RPC by name
+ * This is used for public HTTP access to exposed server functions
+ */
+export const rpcCaller = pikkuSessionlessFunc<
+  { name: string, data?: any },
+  any
+>({
+  func: async ({ rpc }, { name, data }) => {
+    return await (rpc.invokeExposed as any)(name, data)
+  },
+})
+
+wireHTTP({
+  route: '/rpc',
+  method: 'post',
+  func: rpcCaller,
+})
+`
+}

package/src/functions/wirings/rpc/serialize-remote-rpc.ts

@@ -0,0 +1,30 @@
+/**
+ * Generate remote internal RPC queue worker and HTTP endpoint
+ */
+export const serializeRemoteRPC = (pathToPikkuTypes: string) => {
+  return `/**
+ * Auto-generated remote internal RPC queue worker and HTTP endpoint
+ * Do not edit manually - regenerate with 'npx pikku'
+ */
+import { pikkuSessionlessFunc, wireQueueWorker } from '${pathToPikkuTypes}'
+
+/**
+ * Generic remote RPC worker that invokes any internal RPC by name
+ * This is used for executing internal RPCs via a queue or HTTP (e.g., scheduled tasks, background jobs, internal services)
+ */
+export const pikkuRemoteInternalRPC = pikkuSessionlessFunc<
+  { rpcName: string, data?: any },
+  any
+>({
+  func: async ({ rpc }, { rpcName, data }) => {
+    return await (rpc.invoke as any)(rpcName, data)
+  },
+  internal: true,
+})
+
+wireQueueWorker({
+  queueName: 'pikku-remote-internal-rpc',
+  func: pikkuRemoteInternalRPC,
+})
+`
+}

package/src/functions/wirings/rpc/serialize-rpc-wrapper.ts

@@ -53,13 +53,13 @@ export class PikkuRPC {
      * Invokes a remote procedure call on the server.
      * This is a generic method that routes to the appropriate server function
      * based on the function name and passes the provided data.
-     * 
+     *
      * @param name - The name of the server function to invoke
      * @param data - The data to pass to the server function
      * @returns A promise that resolves with the function's return value
      */
     invoke: RPCInvoke = async (name, data) => {
-       return await this.pikkuFetch.post('/rpc', { name, data })
+       return await this.pikkuFetch.post('/rpc' as any, { name, data }) as any
     }
 }