@pikku/cli 0.12.114 → 0.12.116

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 /**
@@ -11,6 +11,10 @@ import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/servic
  */
 import './pikku-secrets-meta.gen.json' with { type: 'json' };
 const CREDENTIALS_META = {};
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export class TypedSecretService extends CoreTypedSecretService {
     constructor(secrets) {
         super(secrets, CREDENTIALS_META);

package/dist/.pikku/services/pikku-meta-service.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export declare class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/services/pikku-meta-service.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/setup/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/setup/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Config and service factory definitions, declared once per application
@@ -8,6 +8,10 @@ import { CreateWireServices } from '@pikku/core/types';
 import type { SingletonServices } from '../function/pikku-function-types.gen.js';
 import type { Config } from '../../types/application-types.d.js';
 import type { RequiredSingletonServices, RequiredWireServices } from '../pikku-services.gen.js';
+/**
+ * This project's own config — whatever `createConfig` returns. Every singleton
+ * service is built from it.
+ */
 export type { Config };
 /**
  * Creates a Pikku config factory.
@@ -16,15 +20,7 @@ export type { Config };
  * @param func - Config factory function that returns your application's config
  * @returns The config factory function
  *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
+ * @example snippet: pikkuConfig
  */
 export declare const pikkuConfig: (func: (variables?: any, ...args: any[]) => Promise<Config>) => (variables?: any, ...args: any[]) => Promise<Config>;
 /**
@@ -53,14 +49,6 @@ export declare const pikkuServices: (func: (config: Config, existingServices: Pa
  * @param func - Wire services factory function
  * @returns The wire services factory function
  *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
+ * @example snippet: shopWireServices
  */
 export declare const pikkuWireServices: (func: (services: SingletonServices, wire: any) => Promise<RequiredWireServices>) => CreateWireServices;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Config and service factory definitions, declared once per application
@@ -12,15 +12,7 @@ import { pikkuState as __pikkuState } from '@pikku/core/state';
  * @param func - Config factory function that returns your application's config
  * @returns The config factory function
  *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
+ * @example snippet: pikkuConfig
  */
 export const pikkuConfig = (func) => func;
 /**
@@ -45,6 +37,14 @@ export const pikkuServices = (func) => {
     return async (config, existingServices = {}) => {
         const createdServices = await func(config, existingServices);
         const services = { ...existingServices, ...createdServices };
+        const allowedToShadow = new Set([]);
+        const shadowed = Object.keys(createdServices).filter((name) => !allowedToShadow.has(name) &&
+            existingServices[name] !== undefined &&
+            existingServices[name] !== createdServices[name]);
+        if (shadowed.length > 0) {
+            ;
+            services.logger?.warn?.(`createSingletonServices returned its own ${shadowed.join(', ')}, discarding what the host passed in. A host only passes a service it has already configured — a \`secrets\` holding this deployment's values, a \`kysely\` bound to its database — so the replacement starts empty and fails later somewhere unrelated. Write \`existingServices.<name> ?? new Own...\` to take the host's when there is one and still work standalone, or list the name under \`allowShadowedServices\` in pikku.config.json if replacing it is deliberate.`);
+        }
         const authFactory = __pikkuState(null, 'package', 'authFactory');
         if (authFactory) {
             let authInstance;
@@ -70,15 +70,7 @@ export const pikkuServices = (func) => {
  * @param func - Wire services factory function
  * @returns The wire services factory function
  *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
+ * @example snippet: shopWireServices
  */
 export const pikkuWireServices = (func) => {
     const factories = __pikkuState(null, 'package', 'factories');

package/dist/.pikku/trigger/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/trigger` resolves here.

package/dist/.pikku/trigger/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/trigger` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization
@@ -100,6 +100,8 @@ export declare function pikkuTriggerFunc<TInput, TOutput = unknown>(triggerOrCon
  * Runs everywhere — inspector extracts at build time.
  *
  * @param trigger - Trigger definition with name and function config
+ *
+ * @example snippet: wireTrigger
  */
 export declare const wireTrigger: (trigger: TriggerWiring) => void;
 /**
@@ -108,6 +110,8 @@ export declare const wireTrigger: (trigger: TriggerWiring) => void;
  * Only imported in the trigger worker process.
  *
  * @param source - Trigger source with name, func, and input
+ *
+ * @example snippet: wireTriggerSource
  */
 export declare const wireTriggerSource: <TInput = unknown, TOutput = unknown>(source: TriggerSource<TInput, TOutput>) => void;
 export {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization
@@ -17,6 +17,8 @@ export function pikkuTriggerFunc(triggerOrConfig) {
  * Runs everywhere — inspector extracts at build time.
  *
  * @param trigger - Trigger definition with name and function config
+ *
+ * @example snippet: wireTrigger
  */
 export const wireTrigger = (trigger) => {
     wireTriggerCore(trigger);
@@ -27,6 +29,8 @@ export const wireTrigger = (trigger) => {
  * Only imported in the trigger worker process.
  *
  * @param source - Trigger source with name, func, and input
+ *
+ * @example snippet: wireTriggerSource
  */
 export const wireTriggerSource = (source) => {
     wireTriggerSourceCore(source);

package/dist/.pikku/variables/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/variables/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

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

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 export { defineVariable } 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.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 export { defineVariable } 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.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import type { VariablesService } from '@pikku/core/services';
@@ -11,8 +11,16 @@ import type { VariablesService } from '@pikku/core/services';
  * sidecar is not part of `#pikku/variables`.
  */
 import './pikku-variables-meta.gen.json';
+/**
+ * Every variable this project declares with `defineVariable`, keyed by name. It
+ * is what gives `variables.get('NAME')` a real type.
+ */
 export interface VariablesMap {
 }
+/**
+ * The `variables` service as this project sees it: `get('NAME')` resolves the
+ * value's type from `VariablesMap` instead of returning `unknown`.
+ */
 export declare class TypedVariablesService extends CoreTypedVariablesService<VariablesMap> {
     constructor(variables: VariablesService);
 }

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { TypedVariablesService as CoreTypedVariablesService, } from '@pikku/core/services';
 /**
@@ -11,6 +11,10 @@ import { TypedVariablesService as CoreTypedVariablesService, } from '@pikku/core
  */
 import './pikku-variables-meta.gen.json' with { type: 'json' };
 const TYPED_VARIABLES_META = {};
+/**
+ * The `variables` service as this project sees it: `get('NAME')` resolves the
+ * value's type from `VariablesMap` instead of returning `unknown`.
+ */
 export class TypedVariablesService extends CoreTypedVariablesService {
     constructor(variables) {
         super(variables, TYPED_VARIABLES_META);

package/dist/.pikku/workflow/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/workflow/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import type { PikkuWorkflowGraphConfig, PikkuWorkflowGraphResult } from '@pikku/core/workflow';
@@ -9,6 +9,10 @@ import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/
 import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
 import type { FlattenedWorkflowMap } from './pikku-workflow-map.gen.d.js';
 import type { AgentMap as FlattenedAgentMap } from '../agent/pikku-agent-map.gen.d.js';
+/**
+ * The wire a workflow step is handed: `step` to run one durably, plus sleeping,
+ * waiting for a signal and asking for approval.
+ */
 export interface TypedWorkflow extends PikkuWorkflowWire {
     do<K extends keyof FlattenedRPCMap>(stepName: string, rpcName: K, data: FlattenedRPCMap[K]['input'], options?: WorkflowStepOptions): Promise<FlattenedRPCMap[K]['output']>;
     do<K extends keyof FlattenedWorkflowMap>(stepName: string, workflowName: K, data: FlattenedWorkflowMap[K]['input'], options?: WorkflowStepOptions): Promise<FlattenedWorkflowMap[K]['output']>;
@@ -21,6 +25,9 @@ import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.j
 import type { ScopeId } from '../scopes/pikku-scopes.gen.js';
 import { PikkuError } from '@pikku/core/errors';
 import type { CorePermissionGroup } from '@pikku/core/function';
+/**
+ * The shape of a workflow's body — services, input, and the workflow wire.
+ */
 export type PikkuFunctionWorkflow<In = unknown, Out = never> = PikkuFunctionSessionless<In, Out, 'workflow'>;
 type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = {
     title?: string;
@@ -50,8 +57,22 @@ type PikkuWorkflowConfigWithSchema<InputSchema extends StandardSchemaV1 | undefi
     scopes?: ScopeId[];
     permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
 };
+/**
+ * Declares a workflow: the DSL form, where each step is awaited in order and
+ * the runner persists progress between them so a restart resumes rather than
+ * replays. The default choice for a workflow.
+ *
+ * @example snippet: workflowSteps
+ */
 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'>;
+/**
+ * Declares a workflow whose control flow the DSL cannot express - a loop whose
+ * bound is only known at runtime, or branching that rejoins. An escape hatch:
+ * reach for `pikkuWorkflowFunc` unless the shape genuinely needs this.
+ *
+ * @example snippet: workflowComplexFunc
+ */
 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> = {
@@ -102,4 +123,11 @@ type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | {
     then: NodeIds;
     else?: NodeIds;
 };
+/**
+ * Declares a workflow as an explicit node graph, for a genuine cyclic
+ * dependency or a Node-only import the DSL cannot carry. The last resort of the
+ * three.
+ *
+ * @example snippet: workflowGraph
+ */
 export declare function pikkuWorkflowGraph<const FuncMap extends Record<string, (keyof FlattenedRPCMap & string) | (keyof FlattenedWorkflowMap & string) | (keyof FlattenedAgentMap & string)>>(config: PikkuWorkflowGraphConfig<FuncMap, GraphNodeConfigMap<FuncMap>>): PikkuWorkflowGraphResult;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { pikkuWorkflowGraph as corePikkuWorkflowGraph } from '@pikku/core/workflow';
@@ -10,6 +10,13 @@ export function pikkuWorkflowFunc(func) {
 export function pikkuWorkflowComplexFunc(func) {
     return typeof func === 'function' ? { func } : func;
 }
+/**
+ * Declares a workflow as an explicit node graph, for a genuine cyclic
+ * dependency or a Node-only import the DSL cannot carry. The last resort of the
+ * three.
+ *
+ * @example snippet: workflowGraph
+ */
 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.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { pikkuState } from '@pikku/core/state';
 import allWorkflowMeta from './meta/allWorkflow.gen.json' with { type: 'json' };

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.114
+ * This file was generated by @pikku/cli@0.12.116
  */
 import { addWorkflow } from '@pikku/core/workflow';
 import './pikku-workflow-wirings-meta.gen.js';

package/dist/bin/pikku-bin.mjs

@@ -11,8 +11,8 @@ async function checkForUpdate() {
     })
     if (!res.ok) return
     const { version: latest } = await res.json()
-    if (latest !== '0.12.114') {
-      process.stderr.write(`\n  Update available  0.12.114 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
+    if (latest !== '0.12.116') {
+      process.stderr.write(`\n  Update available  0.12.116 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
     }
   } catch {}
 }

package/dist/src/cli.wiring.js

@@ -49,6 +49,7 @@ import { pikkuNewMiddleware } from './functions/commands/new-middleware.js';
 import { pikkuNewPermission } from './functions/commands/new-permission.js';
 import { pikkuNewAddon } from './functions/commands/new-addon.js';
 import { pikkuImportN8n } from './functions/commands/import-n8n.js';
+import { doc, renderDoc } from './functions/commands/doc.js';
 import { pikkuInfoFunctions, pikkuInfoTags, pikkuInfoMiddleware, pikkuInfoPermissions, } from './functions/commands/info.js';
 import { enableRpc, enableConsole, enableScenarios, enableAgent, enableWorkflow, enableEvents, enableRemoteRpc, enableWebhook, } from './functions/commands/enable.js';
 import { pikkuRealtime } from './functions/wirings/realtime/pikku-command-realtime.js';
@@ -132,6 +133,22 @@ wireCLI({
         },
     },
     commands: {
+        doc: pikkuCLICommand({
+            func: doc,
+            render: renderDoc,
+            description: 'Print the API surface of the pikku installed here — the doors, what they export, and how each export is called',
+            parameters: '[topics...]',
+            options: {
+                ai: {
+                    description: 'Name the skill that teaches each door, for an agent deciding whether it needs to load one',
+                    default: false,
+                },
+                addon: {
+                    description: 'Describe the addon surface instead of the application one',
+                    default: false,
+                },
+            },
+        }),
         all: pikkuCLICommand({
             func: all,
             description: 'Generate all Pikku files (types, schemas, wirings, etc.)',
@@ -948,6 +965,10 @@ wireCLI({
                             description: 'Install skills whose frontmatter includes installGroups: [fabric]',
                             default: false,
                         },
+                        client: {
+                            description: 'Install skills whose frontmatter includes installGroups: [client]',
+                            default: false,
+                        },
                         update: {
                             description: 'Overwrite existing skills if already installed',
                             default: false,

package/dist/src/deploy/analyzer/analyzer.d.ts

@@ -33,6 +33,7 @@ export interface AnalyzerOptions {
      * Queues created via explicit `wireQueue(...)` user code are unaffected.
      */
     workflowQueues?: boolean;
+    globalHTTPPrefix?: string;
 }
 export declare function analyzeDeployment(state: InspectorState, options: AnalyzerOptions): DeploymentManifest;
 export declare function toSafeKebab(str: string): string;

package/dist/src/deploy/analyzer/analyzer.js

@@ -13,6 +13,8 @@ export function analyzeDeployment(state, options) {
     const serverlessIncompatible = new Set(options.serverlessIncompatible ?? []);
     const defaultTarget = options.defaultTarget ?? 'serverless';
     const workflowQueues = options.workflowQueues ?? true;
+    const httpPrefix = (options.globalHTTPPrefix ?? '').replace(/\/+$/, '');
+    const prefixed = (route) => `${httpPrefix}${route}`;
     const units = [];
     const queues = [];
     const scheduledTasks = [];
@@ -94,7 +96,7 @@ export function analyzeDeployment(state, options) {
             const funcName = funcMeta.name ?? funcId;
             const rpcRoute = {
                 method: 'post',
-                route: `/rpc/${funcName}`,
+                route: prefixed(`/rpc/${funcName}`),
                 pikkuFuncId: funcId,
             };
             const fetchHandler = handlers.find((h) => h.type === 'fetch');
@@ -109,7 +111,7 @@ export function analyzeDeployment(state, options) {
             const funcName = funcMeta.name ?? funcId;
             const remoteRoute = {
                 method: 'post',
-                route: `/remote/rpc/${funcName}`,
+                route: prefixed(`/remote/rpc/${funcName}`),
                 pikkuFuncId: funcId,
             };
             const fetchHandler = handlers.find((h) => h.type === 'fetch');
@@ -153,22 +155,22 @@ export function analyzeDeployment(state, options) {
         const agentRoutes = [
             {
                 method: 'post',
-                route: `/rpc/agent/${agentName}`,
+                route: prefixed(`/rpc/agent/${agentName}`),
                 pikkuFuncId: `agentRun:${agentName}`,
             },
             {
                 method: 'post',
-                route: `/rpc/agent/${agentName}/stream`,
+                route: prefixed(`/rpc/agent/${agentName}/stream`),
                 pikkuFuncId: `agentStream:${agentName}`,
             },
             {
                 method: 'post',
-                route: `/rpc/agent/${agentName}/approve`,
+                route: prefixed(`/rpc/agent/${agentName}/approve`),
                 pikkuFuncId: `agentApprove:${agentName}`,
             },
             {
                 method: 'post',
-                route: `/rpc/agent/${agentName}/resume`,
+                route: prefixed(`/rpc/agent/${agentName}/resume`),
                 pikkuFuncId: `agentResume:${agentName}`,
             },
         ];

package/dist/src/deploy/build-pipeline.d.ts

@@ -50,6 +50,7 @@ export declare function runBuildPipeline(options: {
     inspectorState: InspectorState;
     serverlessIncompatible?: string[];
     defaultTarget?: 'serverless' | 'server';
+    globalHTTPPrefix?: string;
     getEntryContext: (unitDir: string, pikkuDir: string, unit: DeploymentManifest['units'][0], state: InspectorState) => unknown;
     deployDir?: string;
     outDir?: string;

package/dist/src/deploy/build-pipeline.js

@@ -69,6 +69,7 @@ export async function runBuildPipeline(options) {
         projectId,
         serverlessIncompatible: options.serverlessIncompatible,
         defaultTarget: options.defaultTarget,
+        globalHTTPPrefix: options.globalHTTPPrefix,
         workflowQueues,
     });
     let bundled = [];