@pikku/cli 0.12.4 → 0.12.7

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

package/dist/.pikku/variables/pikku-variable-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 export { wireVariable } from '@pikku/core/variable';
 export type { CoreVariable, VariableDefinitionMeta, VariableDefinitionsMeta } from '@pikku/core/variable';

package/dist/.pikku/variables/pikku-variable-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 export { wireVariable } from '@pikku/core/variable';

package/dist/.pikku/variables/pikku-variables.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import type { VariablesService } from '@pikku/core/services';

package/dist/.pikku/variables/pikku-variables.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 const VARIABLES_META = {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { template } from '@pikku/core/workflow';
@@ -7,16 +7,45 @@ import { type PikkuWorkflowGraphConfig, type PikkuWorkflowGraphResult } from '@p
 import type { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/workflow';
 export { WorkflowCancelledException };
 import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js';
-import type { RPCMap, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
+import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
 import type { WorkflowMap, GraphsMap } from './pikku-workflow-map.gen.d.js';
 export { template };
 export interface TypedWorkflow extends PikkuWorkflowWire {
-    do<K extends keyof RPCMap>(stepName: string, rpcName: K, data: RPCMap[K]['input'], options?: WorkflowStepOptions): Promise<RPCMap[K]['output']>;
+    do<K extends keyof FlattenedRPCMap>(stepName: string, rpcName: K, data: FlattenedRPCMap[K]['input'], options?: WorkflowStepOptions): Promise<FlattenedRPCMap[K]['output']>;
+    do<K extends keyof WorkflowMap>(stepName: string, workflowName: K, data: WorkflowMap[K]['input'], options?: WorkflowStepOptions): Promise<WorkflowMap[K]['output']>;
     do<T>(stepName: string, fn: () => T | Promise<T>, options?: WorkflowStepOptions): Promise<T>;
 }
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { InferSchemaOutput, PikkuPermission, PikkuMiddleware, NodeConfig, PikkuApprovalDescription } from '../function/pikku-function-types.gen.js';
+import { PikkuError } from '@pikku/core/errors';
+import type { CorePermissionGroup } from '@pikku/core';
 export type PikkuFunctionWorkflow<In = unknown, Out = never> = PikkuFunctionSessionless<In, Out, 'workflow'>;
-export declare const pikkuWorkflowFunc: <In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>) => PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>;
-export declare const pikkuWorkflowComplexFunc: <In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>) => PikkuFunctionConfig<In, Out, "workflow", PikkuFunctionWorkflow<In, Out>>;
+export type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = {
+    title?: string;
+    description?: string;
+    tags?: string[];
+    expose?: boolean;
+    internal?: boolean;
+    override?: string;
+    version?: number;
+    remote?: boolean;
+    mcp?: boolean;
+    readonly?: boolean;
+    approvalRequired?: boolean;
+    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
+    func: PikkuFunctionWorkflow<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>;
+    auth?: boolean;
+    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
+    middleware?: PikkuMiddleware[];
+    input?: InputSchema;
+    output?: OutputSchema;
+    node?: NodeConfig;
+    errors?: Array<typeof PikkuError>;
+};
+export declare function pikkuWorkflowFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuWorkflowConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'workflow', PikkuFunctionWorkflow<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>;
+export declare function pikkuWorkflowFunc<In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>): PikkuFunctionConfig<In, Out, 'workflow'>;
+export declare function pikkuWorkflowComplexFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuWorkflowConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'workflow', PikkuFunctionWorkflow<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>;
+export declare function pikkuWorkflowComplexFunc<In, Out = unknown>(func: PikkuFunctionWorkflow<In, Out> | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>): PikkuFunctionConfig<In, Out, 'workflow'>;
 type TypedRef<T> = {
     $ref: string;
     path?: string;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { workflow as coreWorkflow, workflowStart as coreWorkflowStart, workflowStatus as coreWorkflowStatus, graphStart as coreGraphStart, } from '@pikku/core/workflow';
@@ -7,12 +7,12 @@ import { template } from '@pikku/core/workflow';
 import { pikkuWorkflowGraph as corePikkuWorkflowGraph, } from '@pikku/core/workflow';
 export { WorkflowCancelledException };
 export { template };
-export const pikkuWorkflowFunc = (func) => {
+export function pikkuWorkflowFunc(func) {
     return typeof func === 'function' ? { func } : func;
-};
-export const pikkuWorkflowComplexFunc = (func) => {
+}
+export function pikkuWorkflowComplexFunc(func) {
     return typeof func === 'function' ? { func } : func;
-};
+}
 export function pikkuWorkflowGraph(config) {
     return corePikkuWorkflowGraph(config);
 }

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.4
+ * This file was generated by @pikku/cli@0.12.7
  */
 import { pikkuState } from '@pikku/core/internal';
 const workflowsMeta = {};

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

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

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

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

package/dist/src/cli.wiring.js

@@ -87,6 +87,12 @@ wireCLI({
         watch: pikkuCLICommand({
             func: watch,
             description: 'Watch for file changes and regenerate automatically',
+            options: {
+                hmr: {
+                    description: 'Enable hot module reload for registered functions',
+                    default: false,
+                },
+            },
         }),
         console: pikkuCLICommand({
             func: consoleCommand,
@@ -102,6 +108,10 @@ wireCLI({
                     default: 'false',
                     short: 'o',
                 },
+                hmr: {
+                    description: 'Enable hot module reload for registered functions',
+                    default: false,
+                },
             },
         }),
         schemas: pikkuCLICommand({
@@ -279,7 +289,7 @@ wireCLI({
             subcommands: {
                 init: pikkuCLICommand({
                     func: pikkuVersionsInit,
-                    description: 'Initialize the version manifest (versions.json)',
+                    description: 'Initialize the version manifest (versions.pikku.json)',
                     options: {
                         force: {
                             description: 'Overwrite existing manifest',

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

@@ -21,6 +21,21 @@ export const all = pikkuVoidFunc({
     func: async ({ logger, config, getInspectorState }, _data, { rpc }) => {
         const allImports = [];
         let typesDeclarationFileExists = true;
+        if (!existsSync(config.outDir)) {
+            logger.debug(`• .pikku directory not found, running bootstrap first...`);
+            await getInspectorState(false, false, true);
+            await rpc.invoke('pikkuFunctionTypes', null);
+            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('pikkuWorkflow', null);
+            await rpc.invoke('pikkuMCPTypes', null);
+            await rpc.invoke('pikkuAIAgentTypes', null);
+            await rpc.invoke('pikkuCLITypes', null);
+            await getInspectorState(true);
+        }
         if (!existsSync(config.typesDeclarationFile)) {
             typesDeclarationFileExists = false;
         }
@@ -163,7 +178,7 @@ export const all = pikkuVoidFunc({
             await rpc.invoke('pikkuVersionsUpdate', null);
         }
         catch {
-            logger.warn(`Run 'pikku init' to enable contract versioning.`);
+            logger.warn(`Run 'pikku versions init' to enable contract versioning.`);
         }
         await rpc.invoke('pikkuBootstrap', { allImports });
         await rpc.invoke('pikkuSummary', null);

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

@@ -1,10 +1,13 @@
 export declare const consoleCommand: import("#pikku").PikkuFunctionConfig<{
     port?: string;
     open?: string;
+    hmr?: boolean;
 }, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     port?: string;
     open?: string;
+    hmr?: boolean;
 }, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     port?: string;
     open?: string;
+    hmr?: boolean;
 }, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

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

@@ -5,6 +5,7 @@ import { fileURLToPath } from 'url';
 import { pikkuSessionlessFunc } from '#pikku';
 import chokidar from 'chokidar';
 import open from 'open';
+import { pikkuDevReloader } from '@pikku/core/dev';
 const MIME_TYPES = {
     '.html': 'text/html',
     '.js': 'application/javascript',
@@ -21,7 +22,7 @@ const MIME_TYPES = {
 };
 export const consoleCommand = pikkuSessionlessFunc({
     remote: true,
-    func: async ({ logger, config }, { port, open: openBrowser }, { rpc }) => {
+    func: async ({ logger, config }, { port, open: openBrowser, hmr }, { rpc }) => {
         if (!config.scaffold?.console) {
             logger.error('Console is not enabled. Add { "scaffold": { "console": "no-auth" } } to your pikku.config.json');
             return;
@@ -65,6 +66,12 @@ export const consoleCommand = pikkuSessionlessFunc({
                 open(`http://localhost:${resolvedPort}`);
             }
         });
+        if (hmr) {
+            await pikkuDevReloader({
+                srcDirectories: config.srcDirectories,
+                logger,
+            });
+        }
         const configWatcher = chokidar.watch(config.srcDirectories, {
             ignoreInitial: true,
             ignored: /.*\.gen\.tsx?/,

package/dist/src/functions/commands/new-addon.js

@@ -1,9 +1,9 @@
 import { existsSync } from 'fs';
 import { join } from 'path';
 import { mkdir, writeFile } from 'fs/promises';
+import { createEmptyManifest, saveManifest, } from '../../utils/contract-versions.js';
 import { pikkuSessionlessFunc } from '#pikku';
-import { parseOpenAPISpec } from '../../utils/openapi/parse-openapi.js';
-import { generateAddonFromOpenAPI } from '../../utils/openapi/codegen.js';
+import { parseOpenAPISpec, computeContractHash, generateAddonFromOpenAPI, } from '@pikku/openapi-parser';
 function toCamelCase(str) {
     return str.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
 }
@@ -31,14 +31,15 @@ function getAddonFiles(vars, flags) {
                 types: './dist/src/index.d.ts',
                 import: './dist/src/index.js',
             },
-            './.pikku/*': './.pikku/*',
-            './.pikku/pikku-metadata.gen.json': './.pikku/pikku-metadata.gen.json',
+            './.pikku/*': './dist/.pikku/*',
+            './.pikku/pikku-metadata.gen.json': './dist/.pikku/pikku-metadata.gen.json',
             './.pikku/rpc/pikku-rpc-wirings-map.internal.gen.js': {
-                types: './.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts',
+                types: './dist/.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts',
             },
         },
-        files: ['dist', '.pikku'],
+        files: ['dist'],
         scripts: {
+            prepublishOnly: 'yarn build',
             prebuild: 'pikku all',
             build: 'tsc && cp -r .pikku dist/',
             pikku: 'pikku all',
@@ -463,24 +464,16 @@ function getTestFiles(vars) {
 wireAddon({ name: '${name}', package: '@pikku/addon-${name}' })
 `;
     // test/src/services.ts
-    files['src/services.ts'] = `import type {
-  SingletonServices,
-} from '../types/application-types.js'
-import {
-  CreateSingletonServices,
-} from '@pikku/core'
-import {
+    files['src/services.ts'] = `import {
   ConsoleLogger,
   LocalVariablesService,
   LocalSecretService,
 } from '@pikku/core/services'
+import { pikkuServices } from '#pikku'
 
 import '../.pikku/pikku-bootstrap.gen.js'
 
-export const createSingletonServices: CreateSingletonServices<
-  {},
-  SingletonServices
-> = async (_config, existingServices) => {
+export const createSingletonServices = pikkuServices(async (_config, existingServices) => {
   const variables = existingServices?.variables ?? new LocalVariablesService(process.env)
   const secrets = existingServices?.secrets ?? new LocalSecretService(variables)
 
@@ -489,7 +482,7 @@ export const createSingletonServices: CreateSingletonServices<
     variables,
     secrets,
   }
-}
+})
 `;
     // test/src/{name}-tests.function.ts
     files[`src/${name}-tests.function.ts`] =
@@ -621,6 +614,16 @@ export const pikkuNewAddon = pikkuSessionlessFunc({
                 mcp,
             });
             Object.assign(addonFiles, openapiFiles);
+            // Inject openapi metadata into pikku.config.json
+            const config = JSON.parse(addonFiles['pikku.config.json']);
+            if (typeof config.addon === 'boolean' || !config.addon) {
+                config.addon = {};
+            }
+            config.addon.openapi = {
+                version: spec.info.version,
+                hash: computeContractHash(spec),
+            };
+            addonFiles['pikku.config.json'] = JSON.stringify(config, null, 2);
         }
         const written = await writeFiles(addonDir, addonFiles);
         // Test harness
@@ -629,6 +632,9 @@ export const pikkuNewAddon = pikkuSessionlessFunc({
             const testWritten = await writeFiles(join(addonDir, 'test'), testFiles);
             written.push(...testWritten);
         }
+        // Initialize version manifest
+        const manifestPath = join(addonDir, 'versions.pikku.json');
+        await saveManifest(manifestPath, createEmptyManifest());
         logger.info(`Created addon at ${addonDir}`);
         for (const f of written) {
             logger.debug({ message: `  ${f}`, type: 'success' });

package/dist/src/functions/commands/versions-check.js

@@ -13,7 +13,7 @@ export const pikkuVersionsCheck = pikkuSessionlessFunc({
     func: async ({ logger, config, getInspectorState }) => {
         const visitState = await getInspectorState();
         if (!visitState.manifest.initial) {
-            const manifestPath = join(config.outDir, 'versions.json');
+            const manifestPath = join(config.rootDir, 'versions.pikku.json');
             throw new Error(`[${ErrorCode.MANIFEST_MISSING}] Version manifest not found at ${manifestPath}. Run 'pikku versions init' to create one.`);
         }
         if (visitState.manifest.errors.length > 0) {
@@ -50,9 +50,9 @@ export const pikkuVersionsCheck = pikkuSessionlessFunc({
                     if (error.latestVersion !== undefined) {
                         logger.info(`  Latest recorded version: ${error.latestVersion}`);
                     }
-                    logger.info(`  Version ${error.version} exists in code but not in versions.json`);
+                    logger.info(`  Version ${error.version} exists in code but not in versions.pikku.json`);
                     logger.info(``);
-                    logger.info(`  This usually means a merge conflict in versions.json.`);
+                    logger.info(`  This usually means a merge conflict in versions.pikku.json.`);
                     logger.info(`  Resolve the conflict, then run:`);
                     logger.info(`  npx pikku versions-update`);
                 }
@@ -76,7 +76,7 @@ export const pikkuVersionsCheck = pikkuSessionlessFunc({
                 }
                 else if (error.code === ErrorCode.MANIFEST_INTEGRITY_ERROR &&
                     error.functionKey) {
-                    logger.info(`✗ ${error.functionKey} — versions.json integrity error`);
+                    logger.info(`✗ ${error.functionKey} — versions.pikku.json integrity error`);
                     if (error.latestVersion !== undefined) {
                         logger.info(`  "latest" field: ${error.latestVersion}`);
                     }

package/dist/src/functions/commands/versions-init.js

@@ -4,7 +4,7 @@ import { pikkuSessionlessFunc } from '#pikku';
 import { createEmptyManifest, saveManifest, } from '../../utils/contract-versions.js';
 export const pikkuVersionsInit = pikkuSessionlessFunc({
     func: async ({ logger, config }, { force }) => {
-        const manifestPath = join(config.outDir, 'versions.json');
+        const manifestPath = join(config.rootDir, 'versions.pikku.json');
         if (existsSync(manifestPath) && !force) {
             logger.error(`Version manifest already exists at ${manifestPath}. Use --force to overwrite.`);
             process.exit(1);

package/dist/src/functions/commands/versions-update.js

@@ -4,7 +4,7 @@ import { ErrorCode } from '@pikku/inspector';
 import { saveManifest } from '../../utils/contract-versions.js';
 export const pikkuVersionsUpdate = pikkuSessionlessFunc({
     func: async ({ logger, config, getInspectorState }) => {
-        const manifestPath = join(config.outDir, 'versions.json');
+        const manifestPath = join(config.rootDir, 'versions.pikku.json');
         const visitState = await getInspectorState();
         if (!visitState.manifest.initial) {
             throw new Error(`Version manifest not found at ${manifestPath}. Run 'pikku versions init' to create one.`);

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

@@ -1 +1,7 @@
-export declare const watch: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const watch: import("#pikku").PikkuFunctionConfig<{
+    hmr?: boolean;
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
+    hmr?: boolean;
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    hmr?: boolean;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

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

@@ -1,8 +1,15 @@
-import { pikkuVoidFunc } from '#pikku';
+import { pikkuSessionlessFunc } from '#pikku';
 import chokidar from 'chokidar';
-export const watch = pikkuVoidFunc({
+import { pikkuDevReloader } from '@pikku/core/dev';
+export const watch = pikkuSessionlessFunc({
     remote: true,
-    func: async ({ logger, config }, _data, { rpc }) => {
+    func: async ({ logger, config }, { hmr }, { rpc }) => {
+        if (hmr) {
+            await pikkuDevReloader({
+                srcDirectories: config.srcDirectories,
+                logger,
+            });
+        }
         const configWatcher = chokidar.watch(config.srcDirectories, {
             ignoreInitial: true,
             ignored: /.*\.gen\.tsx?/,

package/dist/src/functions/runtimes/nextjs/pikku-command-nextjs.js

@@ -43,14 +43,14 @@ export const pikkuNext = pikkuSessionlessFunc({
             const bootstrapPath = getFileImportRelativePath(nextBackendFile, config.bootstrapFile, packageMappings);
             const routesMapDeclarationPath = getFileImportRelativePath(nextBackendFile, httpMapDeclarationFile, packageMappings);
             const rpcMapDeclarationPath = getFileImportRelativePath(nextBackendFile, rpcMapDeclarationFile, packageMappings);
-            const content = serializeNextBackendWrapper(bootstrapPath, routesMapDeclarationPath, rpcMapDeclarationPath, pikkuConfigImport, singletonServicesImport, wireServicesImport);
+            const content = serializeNextBackendWrapper(bootstrapPath, routesMapDeclarationPath, rpcMapDeclarationPath, pikkuConfigImport, singletonServicesImport, wireServicesImport, config.globalHTTPPrefix || '');
             await writeFileInDir(logger, nextBackendFile, content);
         }
         if (nextHTTPFile && fetchFile) {
             const routesMapDeclarationPath = getFileImportRelativePath(nextHTTPFile, httpMapDeclarationFile, packageMappings);
             const rpcMapDeclarationPath = getFileImportRelativePath(nextHTTPFile, rpcMapDeclarationFile, packageMappings);
             const fetchPath = getFileImportRelativePath(nextHTTPFile, fetchFile, packageMappings);
-            const content = serializeNextHTTPWrapper(routesMapDeclarationPath, rpcMapDeclarationPath, fetchPath);
+            const content = serializeNextHTTPWrapper(routesMapDeclarationPath, rpcMapDeclarationPath, fetchPath, config.globalHTTPPrefix || '');
             await writeFileInDir(logger, nextHTTPFile, content);
         }
     },

package/dist/src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.d.ts

@@ -1 +1 @@
-export declare const serializeNextJsBackendWrapper: (bootstrapPath: string, routesMapPath: string, rpcMapPath: string, configImport: string, singleServicesFactoryImport: string, wireServicesImport: string | undefined) => string;
+export declare const serializeNextJsBackendWrapper: (bootstrapPath: string, routesMapPath: string, rpcMapPath: string, configImport: string, singleServicesFactoryImport: string, wireServicesImport: string | undefined, globalHTTPPrefix?: string) => string;

package/dist/src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.js

@@ -1,4 +1,4 @@
-export const serializeNextJsBackendWrapper = (bootstrapPath, routesMapPath, rpcMapPath, configImport, singleServicesFactoryImport, wireServicesImport) => {
+export const serializeNextJsBackendWrapper = (bootstrapPath, routesMapPath, rpcMapPath, configImport, singleServicesFactoryImport, wireServicesImport, globalHTTPPrefix = '') => {
     return `'server-only'
 
 /**
@@ -194,7 +194,7 @@ export const pikku = (_options?: any) => {
     rpcName: Name,
     data: FlattenedRPCMap[Name]['input']
   ): Promise<FlattenedRPCMap[Name]['output']> => {
-    return dynamicActionRequest('/rpc/:rpcName' as '/rpc/:rpcName', 'POST', { rpcName, data: data ?? null }) as unknown as FlattenedRPCMap[Name]['output']
+    return dynamicActionRequest('${globalHTTPPrefix}/rpc/:rpcName' as '${globalHTTPPrefix}/rpc/:rpcName', 'POST', { rpcName, data: data ?? null }) as unknown as FlattenedRPCMap[Name]['output']
   }
 
   /**

package/dist/src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.d.ts

@@ -1 +1 @@
-export declare const serializeNextJsHTTPWrapper: (routesMapPath: string, rpcMapPath: string, pikkuFetchImport: string) => string;
+export declare const serializeNextJsHTTPWrapper: (routesMapPath: string, rpcMapPath: string, pikkuFetchImport: string, globalHTTPPrefix?: string) => string;

package/dist/src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.js

@@ -1,4 +1,4 @@
-export const serializeNextJsHTTPWrapper = (routesMapPath, rpcMapPath, pikkuFetchImport) => {
+export const serializeNextJsHTTPWrapper = (routesMapPath, rpcMapPath, pikkuFetchImport, globalHTTPPrefix = '') => {
     return `'server-only'
   
 /**
@@ -173,7 +173,7 @@ export const pikku = (options?: CorePikkuFetchOptions) => {
     rpcName: Name,
     data: FlattenedRPCMap[Name]['input']
   ): Promise<FlattenedRPCMap[Name]['output']> => {
-    return dynamicActionRequest('/rpc/:rpcName' as '/rpc/:rpcName', 'POST', { rpcName, data: data ?? null }) as unknown as FlattenedRPCMap[Name]['output']
+    return dynamicActionRequest('${globalHTTPPrefix}/rpc/:rpcName' as '${globalHTTPPrefix}/rpc/:rpcName', 'POST', { rpcName, data: data ?? null }) as unknown as FlattenedRPCMap[Name]['output']
   }
 
   /**

package/dist/src/functions/wirings/ai-agent/pikku-command-public-agent.js

@@ -7,7 +7,7 @@ export const pikkuPublicAgent = pikkuSessionlessFunc({
     func: async ({ logger, config }) => {
         if (config.scaffold?.agent) {
             const pathToPikkuTypes = getFileImportRelativePath(config.publicAgentFile, config.typesDeclarationFile, config.packageMappings);
-            await writeFileInDir(logger, config.publicAgentFile, serializePublicAgent(pathToPikkuTypes, config.scaffold.agent === 'auth'));
+            await writeFileInDir(logger, config.publicAgentFile, serializePublicAgent(pathToPikkuTypes, config.scaffold.agent === 'auth', config.globalHTTPPrefix || ''));
             return true;
         }
         return false;

package/dist/src/functions/wirings/ai-agent/serialize-ai-agent-types.js

@@ -14,16 +14,22 @@ import type { StandardSchemaV1 } from '@standard-schema/spec'
 import type { AIAgentMemoryConfig, AIAgentInput } from '@pikku/core/ai-agent'
 import type { AgentMap } from '${agentMapImportPath}'
 
-type AIAgentConfig = Omit<CoreAIAgent<PikkuPermission, PikkuMiddleware>, 'tools' | 'agents' | 'memory'> & {
-  input?: StandardSchemaV1
-  output?: StandardSchemaV1
+type AIAgentConfig<
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
+  OutputSchema extends StandardSchemaV1 | undefined = undefined
+> = Omit<CoreAIAgent<PikkuPermission, PikkuMiddleware>, 'tools' | 'agents' | 'memory' | 'input' | 'output'> & {
+  input?: InputSchema
+  output?: OutputSchema
   memory?: Omit<AIAgentMemoryConfig, 'workingMemory'> & { workingMemory?: StandardSchemaV1 }
   tools?: object[]
-  agents?: AIAgentConfig[]
+  agents?: AIAgentConfig<StandardSchemaV1 | undefined, StandardSchemaV1 | undefined>[]
 }
 
-export const pikkuAIAgent = (
-  agent: AIAgentConfig
+export const pikkuAIAgent = <
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
+  OutputSchema extends StandardSchemaV1 | undefined = undefined
+>(
+  agent: AIAgentConfig<InputSchema, OutputSchema>
 ) => {
   return agent
 }

package/dist/src/functions/wirings/ai-agent/serialize-public-agent.d.ts

@@ -1 +1 @@
-export declare const serializePublicAgent: (pathToPikkuTypes: string, requireAuth?: boolean) => string;
+export declare const serializePublicAgent: (pathToPikkuTypes: string, requireAuth?: boolean, globalHTTPPrefix?: string) => string;

package/dist/src/functions/wirings/ai-agent/serialize-public-agent.js

@@ -1,4 +1,4 @@
-export const serializePublicAgent = (pathToPikkuTypes, requireAuth = true) => {
+export const serializePublicAgent = (pathToPikkuTypes, requireAuth = true, globalHTTPPrefix = '') => {
     const authFlag = requireAuth ? 'true' : 'false';
     return `import { pikkuSessionlessFunc, defineHTTPRoutes, wireHTTPRoutes } from '${pathToPikkuTypes}'
 
@@ -58,23 +58,23 @@ export const agentRoutes = defineHTTPRoutes({
   tags: ['pikku:public'],
   routes: {
     agentRun: {
-      route: '/rpc/agent/:agentName',
+      route: '${globalHTTPPrefix}/rpc/agent/:agentName',
       method: 'post',
       func: agentCaller,
     },
     agentStream: {
-      route: '/rpc/agent/:agentName/stream',
+      route: '${globalHTTPPrefix}/rpc/agent/:agentName/stream',
       method: 'post',
       sse: true,
       func: agentStreamCaller,
     },
     agentApprove: {
-      route: '/rpc/agent/:agentName/approve',
+      route: '${globalHTTPPrefix}/rpc/agent/:agentName/approve',
       method: 'post',
       func: agentApproveCaller,
     },
     agentResume: {
-      route: '/rpc/agent/:agentName/resume',
+      route: '${globalHTTPPrefix}/rpc/agent/:agentName/resume',
       method: 'post',
       sse: true,
       func: agentResumeCaller,

package/dist/src/functions/wirings/cli/pikku-command-cli-entry.js

@@ -56,7 +56,7 @@ export const pikkuCLIEntry = pikkuSessionlessFunc({
                             `Move it to a source directory like "src/wirings/cli-channel.gen.ts".`);
                     }
                     const channelWireFile = resolvedWirePath;
-                    const channelCode = serializeChannelCLI(programName, programMeta, channelWireFile, visitState.functions.files, config.packageMappings, config.channelsTypesFile, config.functionTypesFile, channelName, channelRoute);
+                    const channelCode = serializeChannelCLI(programName, programMeta, channelWireFile, visitState.functions.files, config.packageMappings, config.channelsTypesFile, config.functionTypesFile, channelName, channelRoute, config.globalHTTPPrefix || '');
                     await writeFileInDir(logger, channelWireFile, channelCode);
                     logger.debug(`Serialized CLI channel for ${programName}: ${channelWireFile}`);
                     // Generate client code if clientPath is provided

package/dist/src/functions/wirings/cli/serialize-channel-cli.d.ts

@@ -6,4 +6,4 @@ import type { CLIProgramMeta } from '@pikku/core/cli';
 export declare function serializeChannelCLI(programName: string, programMeta: CLIProgramMeta, channelFile: string, functionFiles: Map<string, {
     path: string;
     exportedName: string;
-}>, packageMappings: Record<string, string>, channelTypesFile: string, functionTypesFile: string, channelName?: string, channelRoute?: string): string;
+}>, packageMappings: Record<string, string>, channelTypesFile: string, functionTypesFile: string, channelName?: string, channelRoute?: string, globalHTTPPrefix?: string): string;

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

@@ -3,9 +3,9 @@ import { getFileImportRelativePath } from '../../../utils/file-import-path.js';
  * Serializes a wireChannel call from CLI metadata
  * This creates a WebSocket backend for all CLI commands
  */
-export function serializeChannelCLI(programName, programMeta, channelFile, functionFiles, packageMappings, channelTypesFile, functionTypesFile, channelName, channelRoute) {
+export function serializeChannelCLI(programName, programMeta, channelFile, functionFiles, packageMappings, channelTypesFile, functionTypesFile, channelName, channelRoute, globalHTTPPrefix = '') {
     const finalChannelName = channelName || `${programName}-cli`;
-    const finalChannelRoute = channelRoute || `/cli/${programName}`;
+    const finalChannelRoute = channelRoute || `${globalHTTPPrefix}/cli/${programName}`;
     // Flatten all commands into a single routing map
     const commandMap = {};
     const collectCommands = (commands, path = []) => {

package/dist/src/functions/wirings/console/pikku-command-console-functions.js

@@ -8,7 +8,7 @@ export const pikkuConsoleFunctions = pikkuSessionlessFunc({
         if (config.scaffold?.console) {
             const pathToPikkuTypes = getFileImportRelativePath(config.consoleFunctionsFile, config.typesDeclarationFile, config.packageMappings);
             const pathToAgentTypes = getFileImportRelativePath(config.consoleFunctionsFile, config.agentTypesFile, config.packageMappings);
-            await writeFileInDir(logger, config.consoleFunctionsFile, serializeConsoleFunctions(pathToPikkuTypes, pathToAgentTypes));
+            await writeFileInDir(logger, config.consoleFunctionsFile, serializeConsoleFunctions(pathToPikkuTypes, pathToAgentTypes, config.globalHTTPPrefix || ''));
             return true;
         }
         return false;

package/dist/src/functions/wirings/console/serialize-console-functions.d.ts

@@ -1 +1 @@
-export declare const serializeConsoleFunctions: (pathToPikkuTypes: string, _pathToAgentTypes: string) => string;
+export declare const serializeConsoleFunctions: (pathToPikkuTypes: string, _pathToAgentTypes: string, globalHTTPPrefix?: string) => string;