@pikku/cli 0.12.20 → 0.12.22

package/dist/src/functions/runtimes/tanstack-start/pikku-command-tanstack-start.js

@@ -0,0 +1,32 @@
+import { pikkuSessionlessFunc } from '#pikku';
+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 { serializeTanStackStartShim } from './serialize-tanstack-start-shim.js';
+export const pikkuTanStackStart = pikkuSessionlessFunc({
+    func: async ({ logger, config }) => {
+        const startServerFnsFile = config.clientFiles?.startServerFnsFile;
+        const rpcWiringsFile = config.clientFiles?.rpcWiringsFile;
+        const { packageMappings } = config;
+        if (!startServerFnsFile) {
+            logger.debug({
+                message: "Skipping generating TanStack Start shim since startServerFnsFile isn't set in the pikku config.",
+                type: 'skip',
+            });
+            return;
+        }
+        if (!rpcWiringsFile) {
+            logger.warn("Skipping TanStack Start shim: startServerFnsFile is set but rpcWiringsFile is not — the shim imports the PikkuRPC class from rpcWiringsFile.");
+            return;
+        }
+        const rpcWiringsPath = getFileImportRelativePath(startServerFnsFile, rpcWiringsFile, packageMappings);
+        const content = serializeTanStackStartShim(rpcWiringsPath);
+        await writeFileInDir(logger, startServerFnsFile, content);
+    },
+    middleware: [
+        logCommandInfoAndTime({
+            commandStart: 'Generating TanStack Start shim',
+            commandEnd: 'Generated TanStack Start shim',
+        }),
+    ],
+});

package/dist/src/functions/runtimes/tanstack-start/serialize-tanstack-start-shim.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Serialize the TanStack Start server-function shim.
+ *
+ * The "server function" is a Pikku function; this shim is a typed *caller* over
+ * the generated RPC map (`PikkuRPC`) for use in Start loaders, actions and
+ * components. The API base URL comes from `import.meta.env.VITE_API_URL` and the
+ * shim throws if it is unset — never hardcode a host.
+ *
+ * @param rpcWiringsPath - import path to the file exporting the `PikkuRPC` class
+ */
+export declare const serializeTanStackStartShim: (rpcWiringsPath: string) => string;

package/dist/src/functions/runtimes/tanstack-start/serialize-tanstack-start-shim.js

@@ -0,0 +1,36 @@
+/**
+ * Serialize the TanStack Start server-function shim.
+ *
+ * The "server function" is a Pikku function; this shim is a typed *caller* over
+ * the generated RPC map (`PikkuRPC`) for use in Start loaders, actions and
+ * components. The API base URL comes from `import.meta.env.VITE_API_URL` and the
+ * shim throws if it is unset — never hardcode a host.
+ *
+ * @param rpcWiringsPath - import path to the file exporting the `PikkuRPC` class
+ */
+export const serializeTanStackStartShim = (rpcWiringsPath) => {
+    return `/**
+ * This file was generated by the @pikku/cli
+ *
+ * TanStack Start server-function shim. \`makeApi()\` returns a typed PikkuRPC
+ * caller; use it in loaders/actions/components, e.g.
+ *
+ *   loader: () => makeApi().invoke('listCards', {})
+ *
+ * The API base URL is read from \`import.meta.env.VITE_API_URL\`.
+ */
+import { PikkuRPC } from '${rpcWiringsPath}'
+
+export function makeApi(): PikkuRPC {
+  const serverUrl = import.meta.env.VITE_API_URL
+  if (!serverUrl) {
+    throw new Error(
+      'VITE_API_URL is not set — point it at the Pikku API base URL'
+    )
+  }
+  const rpc = new PikkuRPC()
+  rpc.setServerUrl(serverUrl)
+  return rpc
+}
+`;
+};

package/dist/src/functions/runtimes/websocket/pikku-command-websocket-typed.d.ts

@@ -1 +1 @@
-export declare const pikkuWebSocketTyped: 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 pikkuWebSocketTyped: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/ai-agent/pikku-command-ai-agent-types.d.ts

@@ -1 +1 @@
-export declare const pikkuAIAgentTypes: 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 pikkuAIAgentTypes: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/ai-agent/pikku-command-ai-agent.d.ts

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

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

@@ -45,19 +45,10 @@ export const pikkuAIAgent = pikkuSessionlessFunc({
         const importStatement = supportsImportAttributes
             ? `import metaData from '${jsonImportPath}' with { type: 'json' }`
             : `import metaData from '${jsonImportPath}'`;
-        const modelConfigLines = [];
-        if (!addonName &&
-            (config.models || config.agentDefaults || config.agentOverrides)) {
-            modelConfigLines.push(`\npikkuState(null, 'models', 'config', ${JSON.stringify({
-                models: config.models,
-                agentDefaults: config.agentDefaults,
-                agentOverrides: config.agentOverrides,
-            })} as any)`);
-        }
         await writeFileInDir(logger, agentWiringMetaFile, `import { pikkuState } from '@pikku/core/internal'
 import type { AIAgentMeta } from '@pikku/core/ai-agent'
 ${importStatement}
-pikkuState(${addonName ? `'${addonName}'` : 'null'}, 'agent', 'agentsMeta', metaData.agentsMeta as AIAgentMeta)${modelConfigLines.join('')}`);
+pikkuState(${addonName ? `'${addonName}'` : 'null'}, 'agent', 'agentsMeta', metaData.agentsMeta as AIAgentMeta)`);
         await writeFileInDir(logger, agentMapDeclarationFile, serializeAgentMap(logger, agentMapDeclarationFile, packageMappings, functions.typesMap, agents.agentsMeta));
         return true;
     },

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

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

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

@@ -1,11 +1,13 @@
 export const serializePublicAgent = (pathToPikkuTypes, requireAuth = true, globalHTTPPrefix = '') => {
     const authFlag = requireAuth ? 'true' : 'false';
-    return `import { pikkuSessionlessFunc, defineHTTPRoutes, wireHTTPRoutes } from '${pathToPikkuTypes}'
+    return `import { MissingServiceError } from '@pikku/core/errors'
+import { pikkuSessionlessFunc, defineHTTPRoutes, wireHTTPRoutes } from '${pathToPikkuTypes}'
 
 export const agentCaller = pikkuSessionlessFunc<
   { agentName: string; message: string; threadId: string; resourceId: string },
   unknown
 >({
+  tags: ['pikku'],
   auth: ${authFlag},
   func: async (_services, data, { rpc }) => {
     return await rpc.agent.run(data.agentName as any, {
@@ -20,6 +22,7 @@ export const agentStreamCaller = pikkuSessionlessFunc<
   { agentName: string; message: string; threadId: string; resourceId: string },
   void
 >({
+  tags: ['pikku'],
   auth: ${authFlag},
   func: async (_services, data, { rpc }) => {
     await rpc.agent.stream(data.agentName as any, {
@@ -34,6 +37,7 @@ export const agentApproveCaller = pikkuSessionlessFunc<
   { agentName: string; runId: string; approvals: { toolCallId: string; approved: boolean }[] },
   unknown
 >({
+  tags: ['pikku'],
   auth: ${authFlag},
   func: async (_services, { runId, approvals, agentName }, { rpc }) => {
     return await rpc.agent.approve(runId, approvals, agentName)
@@ -44,6 +48,7 @@ export const agentResumeCaller = pikkuSessionlessFunc<
   { agentName: string; runId: string; toolCallId: string; approved: boolean },
   void
 >({
+  tags: ['pikku'],
   auth: ${authFlag},
   func: async (_services, data, { rpc }) => {
     await rpc.agent.resume(data.runId, {
@@ -53,6 +58,76 @@ export const agentResumeCaller = pikkuSessionlessFunc<
   },
 })
 
+export const getAgentThreads = pikkuSessionlessFunc<
+  { agentName?: string; resourceId?: string; limit?: number; offset?: number },
+  any[]
+>({
+  tags: ['pikku', 'pikku:agent'],
+  title: 'Get Agent Threads',
+  description:
+    'Returns a list of AI agent threads from storage. Accepts optional filters: agentName, resourceId, limit, and offset for pagination.',
+  expose: true,
+  auth: ${authFlag},
+  func: async ({ agentRunService }, input) => {
+    if (!agentRunService) throw new MissingServiceError('agentRunService is not available')
+    return await agentRunService.listThreads({
+      agentName: input?.agentName,
+      resourceId: input?.resourceId,
+      limit: input?.limit,
+      offset: input?.offset,
+    })
+  },
+})
+
+export const getAgentThreadMessages = pikkuSessionlessFunc<
+  { threadId: string; resourceId?: string },
+  any[]
+>({
+  tags: ['pikku', 'pikku:agent'],
+  title: 'Get Agent Thread Messages',
+  description:
+    'Returns all messages for a given AI agent thread, ordered by creation time.',
+  expose: true,
+  auth: ${authFlag},
+  func: async ({ agentRunService }, input) => {
+    if (!agentRunService) throw new MissingServiceError('agentRunService is not available')
+    return await agentRunService.getThreadMessages(input.threadId)
+  },
+})
+
+export const getAgentThreadRuns = pikkuSessionlessFunc<
+  { threadId: string; resourceId?: string },
+  any[]
+>({
+  tags: ['pikku', 'pikku:agent'],
+  title: 'Get Agent Thread Runs',
+  description:
+    'Returns the run history for a given AI agent thread, ordered by creation time.',
+  expose: true,
+  auth: ${authFlag},
+  func: async ({ agentRunService }, input) => {
+    if (!agentRunService) throw new MissingServiceError('agentRunService is not available')
+    return await agentRunService.getThreadRuns(input.threadId)
+  },
+})
+
+export const deleteAgentThread = pikkuSessionlessFunc<
+  { threadId: string; resourceId?: string },
+  { deleted: boolean }
+>({
+  tags: ['pikku', 'pikku:agent'],
+  title: 'Delete Agent Thread',
+  description:
+    'Deletes an AI agent thread and all of its persisted state.',
+  expose: true,
+  auth: ${authFlag},
+  func: async ({ agentRunService }, input) => {
+    if (!agentRunService) throw new MissingServiceError('agentRunService is not available')
+    const deleted = await agentRunService.deleteThread(input.threadId)
+    return { deleted }
+  },
+})
+
 export const agentRoutes = defineHTTPRoutes({
   auth: ${authFlag},
   tags: ['pikku:public'],

package/dist/src/functions/wirings/channels/pikku-channels.d.ts

@@ -1 +1 @@
-export declare const pikkuChannels: 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 pikkuChannels: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/channels/pikku-command-channel-types.d.ts

@@ -1 +1 @@
-export declare const pikkuChannelTypes: 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 pikkuChannelTypes: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/channels/pikku-command-channels-map.d.ts

@@ -1 +1 @@
-export declare const pikkuChannelsMap: 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 pikkuChannelsMap: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

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

@@ -1 +1 @@
-export declare const pikkuChannels: import("#pikku").PikkuFunctionConfig<void, boolean | undefined, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, boolean | undefined, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, boolean | undefined, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuCommandChannels: import("#pikku").PikkuFunctionConfig<void, boolean | undefined, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, boolean | undefined, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, boolean | undefined, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

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

@@ -4,7 +4,7 @@ import { writeFileInDir } from '../../../utils/file-writer.js';
 import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js';
 import { getFileImportRelativePath } from '../../../utils/file-import-path.js';
 import { stripVerboseFields, hasVerboseFields, } from '../../../utils/strip-verbose-meta.js';
-export const pikkuChannels = pikkuSessionlessFunc({
+export const pikkuCommandChannels = pikkuSessionlessFunc({
     func: async ({ logger, config, getInspectorState }) => {
         const visitState = await getInspectorState();
         const { channelsWiringFile, channelsWiringMetaFile, channelsWiringMetaJsonFile, packageMappings, schema, } = config;

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

@@ -1 +1 @@
-export declare const pikkuCLIEntry: 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 pikkuCLIEntry: import("#pikku").PikkuFunctionConfig<void, boolean, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, boolean, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, boolean, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

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

@@ -12,6 +12,7 @@ import { ErrorCode } from '@pikku/inspector';
 export const pikkuCLIEntry = pikkuSessionlessFunc({
     func: async ({ logger, config, getInspectorState }) => {
         const visitState = await getInspectorState();
+        let channelWireGenerated = false;
         // Check if CLI entrypoints are configured
         if (!config.cli?.entrypoints ||
             Object.keys(config.cli.entrypoints).length === 0) {
@@ -19,7 +20,7 @@ export const pikkuCLIEntry = pikkuSessionlessFunc({
                 message: 'No CLI entrypoints configured in config.cli.entrypoints, skipping CLI bootstrap generation',
                 type: 'skip',
             });
-            return;
+            return false;
         }
         // Generate bootstrap files for each configured entrypoint
         for (const [programName, entrypointConfigs] of Object.entries(config.cli.entrypoints)) {
@@ -56,8 +57,9 @@ 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, config.globalHTTPPrefix || '');
+                    const channelCode = serializeChannelCLI(programName, programMeta, channelWireFile, visitState.functions.files, config.packageMappings, config.channelsTypesFile, config.functionTypesFile, channelName, channelRoute, config.globalHTTPPrefix || '', visitState.rpc?.wireAddonDeclarations);
                     await writeFileInDir(logger, channelWireFile, channelCode);
+                    channelWireGenerated = true;
                     logger.debug(`Serialized CLI channel for ${programName}: ${channelWireFile}`);
                     // Generate client code if clientPath is provided
                     if (channelClientPath) {
@@ -117,6 +119,7 @@ export const pikkuCLIEntry = pikkuSessionlessFunc({
                 logger.debug(`Serialized CLI bootstrap for ${programName}: ${bootstrapFile}`);
             }
         }
+        return channelWireGenerated;
     },
     middleware: [
         logCommandInfoAndTime({

package/dist/src/functions/wirings/cli/pikku-command-cli-types.d.ts

@@ -1 +1,5 @@
-export declare const pikkuCLITypes: 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>;
+type CLITypesCommandInput = {
+    bootstrap?: boolean;
+};
+export declare const pikkuCLITypes: import("#pikku").PikkuFunctionConfig<CLITypesCommandInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<CLITypesCommandInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<CLITypesCommandInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export {};

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

@@ -5,9 +5,15 @@ import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-
 import { serializeCLITypes } from './serialize-cli-types.js';
 import { checkRequiredTypes } from '../../../utils/check-required-types.js';
 export const pikkuCLITypes = pikkuSessionlessFunc({
-    func: async ({ logger, config, getInspectorState }) => {
+    func: async ({ logger, config, getInspectorState }, input) => {
         const { cliTypesFile, functionTypesFile, packageMappings } = config;
-        const visitState = await getInspectorState();
+        const bootstrap = input?.bootstrap === true;
+        // In bootstrap mode we only need filesAndMethods (userSession/singleton
+        // services types) — skip schema generation. Full mode would dynamic-import
+        // pikku-types.gen.ts, which re-exports the not-yet-written cli-types file.
+        const visitState = bootstrap
+            ? await getInspectorState(false, true, false)
+            : await getInspectorState();
         const functionTypesImportPath = getFileImportRelativePath(cliTypesFile, functionTypesFile, packageMappings);
         // Check for required types
         checkRequiredTypes(visitState.filesAndMethodsErrors, {

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

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

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

@@ -26,16 +26,27 @@ export function collectRendererNames(programMeta) {
     }
     return rendererNames;
 }
+/**
+ * Resolve a renderer name (e.g. `cli-render:kanban:list`) to the JS identifier
+ * actually imported into the client file. Returns null when the name has no
+ * importable binding so callers can skip it rather than emit invalid JS.
+ */
+function resolveRendererBinding(renderName, renderersMeta) {
+    return renderersMeta?.[renderName]?.exportedName ?? null;
+}
 /**
  * Build a renderers map for CLI commands
  */
-function buildRenderersMap(programMeta) {
+function buildRenderersMap(programMeta, renderersMeta) {
     const entries = [];
-    // Build map entries for each command that has a renderer
+    // Build map entries for each command that has an importable renderer
     function addCommandRenderer(command, path) {
         const commandId = path.join('.');
         if (command.renderName) {
-            entries.push(`    '${commandId}': ${command.renderName}`);
+            const binding = resolveRendererBinding(command.renderName, renderersMeta);
+            if (binding) {
+                entries.push(`    '${commandId}': ${binding}`);
+            }
         }
         // Recursively process subcommands
         if (command.subcommands) {
@@ -75,7 +86,11 @@ export function serializeChannelCLIClient(programName, programMeta, clientFile,
                 if (!importsByFile.has(relativePath)) {
                     importsByFile.set(relativePath, []);
                 }
-                importsByFile.get(relativePath).push(meta.exportedName);
+                const names = importsByFile.get(relativePath);
+                // Distinct renderer names can share an exported binding — import once.
+                if (!names.includes(meta.exportedName)) {
+                    names.push(meta.exportedName);
+                }
             }
         }
         // Generate import statements
@@ -83,11 +98,14 @@ export function serializeChannelCLIClient(programName, programMeta, clientFile,
             rendererImports += `import { ${names.join(', ')} } from '${path}'\n`;
         }
     }
-    // Build renderers map
-    const renderersMap = buildRenderersMap(programMeta);
-    // Determine default renderer
-    const defaultRendererCode = programMeta.defaultRenderName
-        ? `,\n    defaultRenderer: ${programMeta.defaultRenderName}`
+    // Build renderers map (keyed by command id → imported renderer binding)
+    const renderersMap = buildRenderersMap(programMeta, renderersMeta);
+    // Determine default renderer — only when it resolves to an imported binding
+    const defaultRendererBinding = programMeta.defaultRenderName
+        ? resolveRendererBinding(programMeta.defaultRenderName, renderersMeta)
+        : null;
+    const defaultRendererCode = defaultRendererBinding
+        ? `,\n    defaultRenderer: ${defaultRendererBinding}`
         : '';
     return `
 import { executeCLIViaChannel } from '@pikku/core/cli/channel'

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

@@ -1,4 +1,7 @@
 import type { CLIProgramMeta } from '@pikku/core/cli';
+type WireAddonDeclarations = Map<string, {
+    package: string;
+}>;
 /**
  * Serializes a wireChannel call from CLI metadata
  * This creates a WebSocket backend for all CLI commands
@@ -6,4 +9,5 @@ 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, globalHTTPPrefix?: string): string;
+}>, packageMappings: Record<string, string>, channelTypesFile: string, functionTypesFile: string, channelName?: string, channelRoute?: string, globalHTTPPrefix?: string, wireAddonDeclarations?: WireAddonDeclarations): string;
+export {};

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

@@ -3,7 +3,13 @@ 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, globalHTTPPrefix = '') {
+export function serializeChannelCLI(programName, programMeta, channelFile, functionFiles, packageMappings, channelTypesFile, functionTypesFile, channelName, channelRoute, globalHTTPPrefix = '', wireAddonDeclarations) {
+    const packageToNamespace = new Map();
+    if (wireAddonDeclarations) {
+        for (const [namespace, decl] of wireAddonDeclarations.entries()) {
+            packageToNamespace.set(decl.package, namespace);
+        }
+    }
     const finalChannelName = channelName || `${programName}-cli`;
     const finalChannelRoute = channelRoute || `${globalHTTPPrefix}/cli/${programName}`;
     // Flatten all commands into a single routing map
@@ -13,9 +19,13 @@ export function serializeChannelCLI(programName, programMeta, channelFile, funct
             const fullPath = [...path, name];
             const commandKey = fullPath.join('.');
             if (cmd.pikkuFuncId) {
+                const addonNamespace = cmd.packageName
+                    ? packageToNamespace.get(cmd.packageName)
+                    : undefined;
                 commandMap[commandKey] = {
                     pikkuFuncId: cmd.pikkuFuncId,
                     isAddon: !!cmd.packageName,
+                    addonNamespace,
                 };
             }
             // Recursively process subcommands
@@ -113,9 +123,9 @@ wireChannel({
         middleware: [cliCloseOnComplete],
       },
 ${Object.entries(commandMap)
-        .map(([commandKey, { pikkuFuncId, isAddon }]) => {
+        .map(([commandKey, { pikkuFuncId, isAddon, addonNamespace }]) => {
         const funcRef = isAddon
-            ? `ref('${pikkuFuncId}')`
+            ? `ref('${addonNamespace ? `${addonNamespace}:${pikkuFuncId}` : pikkuFuncId}')`
             : (functionFiles.get(pikkuFuncId)?.exportedName ?? pikkuFuncId);
         return `      '${commandKey}': {
         func: ${funcRef},

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

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

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

@@ -4,7 +4,11 @@ import { writeFileInDir } from '../../../utils/file-writer.js';
 import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js';
 import { serializeConsoleFunctions } from './serialize-console-functions.js';
 export const pikkuConsoleFunctions = pikkuSessionlessFunc({
-    func: async ({ logger, config }) => {
+    func: async ({ logger, config, variables }) => {
+        const deployCodegenFlag = await variables.get('PIKKU_DEPLOY_CODEGEN');
+        if (deployCodegenFlag === '1') {
+            return false;
+        }
         if (config.scaffold?.console) {
             const pathToPikkuTypes = getFileImportRelativePath(config.consoleFunctionsFile, config.typesDeclarationFile, config.packageMappings);
             const pathToAgentTypes = getFileImportRelativePath(config.consoleFunctionsFile, config.agentTypesFile, config.packageMappings);

package/dist/src/functions/wirings/console/pikku-command-node-types.d.ts

@@ -1 +1 @@
-export declare const pikkuNodeTypes: 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 pikkuNodeTypes: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/console/pikku-command-nodes-meta.d.ts

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

package/dist/src/functions/wirings/console/serialize-console-functions.js

@@ -7,6 +7,7 @@ export const pikkuConsoleSetSecret = pikkuSessionlessFunc<{
 }, {
   success: boolean
 }>({
+  tags: ['pikku'],
   description: 'Set the value of a secret',
   expose: true,
   auth: false,
@@ -20,6 +21,7 @@ export const pikkuConsoleGetVariable = pikkuSessionlessFunc<
   { variableId: string },
   { exists: boolean; value: unknown | null }
 >({
+  tags: ['pikku'],
   description: 'Get the current value of a variable',
   expose: true,
   auth: false,
@@ -42,6 +44,7 @@ export const pikkuConsoleSetVariable = pikkuSessionlessFunc<
   { variableId: string; value: unknown },
   { success: boolean }
 >({
+  tags: ['pikku'],
   description: 'Set the value of a variable',
   expose: true,
   auth: false,
@@ -59,6 +62,7 @@ export const pikkuConsoleHasSecret = pikkuSessionlessFunc<
   { secretId: string },
   { exists: boolean }
 >({
+  tags: ['pikku'],
   description: 'Check if a secret exists without reading its value',
   expose: true,
   auth: false,
@@ -72,6 +76,7 @@ export const pikkuConsoleGetSecret = pikkuSessionlessFunc<
   { secretId: string },
   { exists: boolean; value: unknown | null }
 >({
+  tags: ['pikku'],
   description: 'Get the current value of a secret',
   expose: true,
   auth: false,

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

@@ -1 +1 @@
-export declare const pikkuCredentials: 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 pikkuCredentials: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/functions/pikku-command-addon-types.d.ts

@@ -1 +1,5 @@
-export declare const pikkuAddonTypes: 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>;
+type AddonTypesCommandInput = {
+    bootstrap?: boolean;
+};
+export declare const pikkuAddonTypes: import("#pikku").PikkuFunctionConfig<AddonTypesCommandInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<AddonTypesCommandInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<AddonTypesCommandInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export {};

package/dist/src/functions/wirings/functions/pikku-command-addon-types.js

@@ -5,12 +5,17 @@ import { writeFileInDir } from '../../../utils/file-writer.js';
 import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js';
 import { serializeAddonTypes } from './serialize-addon-types.js';
 export const pikkuAddonTypes = pikkuSessionlessFunc({
-    func: async ({ logger, config, getInspectorState }) => {
+    func: async ({ logger, config, getInspectorState }, input) => {
         if (!config.addon) {
             return;
         }
-        const visitState = await getInspectorState();
         const { addonTypesFile, packageMappings, servicesFile, secretsFile, credentialsFile, variablesFile, } = config;
+        const bootstrap = input?.bootstrap === true;
+        if (bootstrap) {
+            await writeFileInDir(logger, addonTypesFile, 'export {}\n');
+            return;
+        }
+        const visitState = await getInspectorState();
         checkRequiredTypes(visitState.filesAndMethodsErrors, {
             singletonServicesType: true,
         });

package/dist/src/functions/wirings/functions/pikku-command-function-types-split.d.ts

@@ -1 +1 @@
-export declare const pikkuFunctionTypesSplit: 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 pikkuFunctionTypesSplit: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/functions/pikku-command-function-types-split.js

@@ -6,7 +6,7 @@ import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-
 import { serializeFunctionTypes } from './serialize-function-types.js';
 export const pikkuFunctionTypesSplit = pikkuSessionlessFunc({
     func: async ({ logger, config, getInspectorState }) => {
-        const visitState = await getInspectorState();
+        const visitState = await getInspectorState(false, true);
         const { functionTypesFile, packageMappings, rpcInternalMapDeclarationFile, servicesFile, } = config;
         // Check for required types
         checkRequiredTypes(visitState.filesAndMethodsErrors, {

package/dist/src/functions/wirings/functions/pikku-command-function-types.d.ts

@@ -1 +1 @@
-export declare const pikkuFunctionTypes: 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 pikkuFunctionTypes: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

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

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

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

@@ -1,2 +1,2 @@
 export declare const serializeServicesMap: (allSingletonServices: string[], allWireServices: string[], requiredServices: Set<string>, forceRequiredServices: string[] | undefined, servicesImport: string, wireServicesImport: string, addonRequiredParentServices?: string[]) => string;
-export declare const pikkuServices: 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 pikkuServices: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/wirings/functions/schemas.d.ts

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