@pikku/cli 0.12.114 → 0.12.116

package/dist/.pikku/function/pikku-function-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
  */
 /**
  * Core function types for all wirings
@@ -23,8 +23,21 @@ import type { TypedPikkuRPC, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-ma
 import type { RequiredSingletonServices } from '../pikku-services.gen.js';
 import type { TypedWorkflow } from '../workflow/pikku-workflow-types.gen.js';
 import type { TypedScenario, TypedPersonas } from '../scenarios/pikku-scenario-types.gen.js';
+/**
+ * The services that live for the process — the ones built once in `createConfig`/
+ * `createSingletonServices` and shared by every request.
+ */
 export type { SingletonServices as SingletonServices };
+/**
+ * Everything a function is handed as its first argument: the singleton services
+ * plus whatever is built per request. This is the type to widen when you add a
+ * service.
+ */
 export type { Services as Services };
+/**
+ * The signed-in user as this project defines it. Reached on the wire as
+ * `session`, and replaced with `setSession`.
+ */
 export type Session = UserSession;
 /**
  * The services a wired function actually receives. The inspector records which
@@ -149,24 +162,17 @@ type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefi
  * @param config - Function definition with `input`/`output` Zod schemas and `func`.
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const createUserInput = z.object({ name: z.string(), email: z.string() })
- * const createUserOutput = z.object({ id: z.number() })
- *
- * const createUser = pikkuFunc({
- *   input: createUserInput,
- *   output: createUserOutput,
- *   func: async ({db}, input) => {
- *     // input is typed as { name: string, email: string }
- *     const user = await db.users.create(input)
- *     return { id: user.id } // must match output schema
- *   }
- * })
- * ```
+ * @example snippet: sessionFunction
  */
 export declare function pikkuFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuFunctionConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>;
 export declare function pikkuFunc<In, Out = unknown>(func: PikkuFunction<In, Out, 'session' | 'rpc'> | PikkuFunctionConfig<In, Out, 'session' | 'rpc'>): PikkuFunctionConfig<In, Out, 'session' | 'rpc'>;
+/**
+ * A `pikkuFunc` whose input and output are already the shared list shape —
+ * filters, sort, paging in; rows and a total out — so a listing endpoint pages
+ * the same way everywhere.
+ *
+ * @example snippet: listFunction
+ */
 export declare const pikkuListFunc: <F extends Record<string, unknown> = {}, Row = unknown, S extends string = never>(config: PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, "session" | "rpc">) => PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, "session" | "rpc">;
 /**
  * Configuration object for sessionless Pikku functions with Zod schema validation.
@@ -194,19 +200,7 @@ type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchema
  * @param config - Function definition with `input`/`output` Zod schemas and `func`.
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const greetInput = z.object({ name: z.string() })
- * const greetOutput = z.object({ message: z.string() })
- *
- * const greet = pikkuSessionlessFunc({
- *   input: greetInput,
- *   output: greetOutput,
- *   func: async (_services, { name }) => {
- *     return { message: `Hello, ${name}!` }
- *   }
- * })
- * ```
+ * @example snippet: readFunction
  */
 export declare function pikkuSessionlessFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredServices extends SecretlessServices<Services> = WiredServices>(config: PikkuFunctionSessionlessConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc', RequiredServices>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>;
 export declare function pikkuSessionlessFunc<In, Out = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices>(func: PikkuFunctionSessionless<In, Out, 'session' | 'rpc', RequiredServices> | PikkuFunctionSessionlessConfig<In, Out, 'session' | 'rpc', PikkuFunctionSessionless<In, Out, 'session' | 'rpc', RequiredServices>>): PikkuFunctionConfig<In, Out, 'session' | 'rpc'>;
@@ -217,14 +211,7 @@ export declare function pikkuSessionlessFunc<In, Out = unknown, RequiredServices
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const cleanupTempFiles = pikkuVoidFunc(async ({fileSystem, logger}) => {
- *     logger.info('Starting cleanup of temporary files')
- *     await fileSystem.deleteDirectory('/tmp/uploads')
- *     logger.info('Cleanup completed')
- * })
- * ```
+ * @example snippet: cleanupFunction
  */
 export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionSessionlessConfig<void, void, "session" | "rpc">) => PikkuFunctionConfig<void, void, "session" | "rpc">;
 /**
@@ -272,8 +259,20 @@ export declare function pikkuRemoteChannelFunc<InputSchema extends StandardSchem
 declare const __addonHttp: {};
 declare const __addonChannel: {};
 declare const __addonCli: {};
+/**
+ * Names an HTTP route an installed addon wires, so you can link or redirect to
+ * it without hardcoding a path the addon may move.
+ */
 export declare const refHTTP: <Name extends keyof typeof __addonHttp>(name: Name, options?: {
     basePath?: string;
 }) => (typeof __addonHttp)[Name];
+/**
+ * Names a channel an installed addon wires, for connecting to it without
+ * hardcoding its name.
+ */
 export declare const refChannel: <Name extends keyof typeof __addonChannel>(name: Name) => (typeof __addonChannel)[Name];
+/**
+ * Names a CLI command an installed addon wires, for invoking it without
+ * hardcoding its name.
+ */
 export declare const refCLI: <Name extends keyof typeof __addonCli>(name: Name) => (typeof __addonCli)[Name];

package/dist/.pikku/function/pikku-function-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
  */
 /**
  * Core function types for all wirings
@@ -23,6 +23,13 @@ export const pikkuApprovalDescription = (fn) => {
 export function pikkuFunc(func) {
     return typeof func === 'function' ? { func } : func;
 }
+/**
+ * A `pikkuFunc` whose input and output are already the shared list shape —
+ * filters, sort, paging in; rows and a total out — so a listing endpoint pages
+ * the same way everywhere.
+ *
+ * @example snippet: listFunction
+ */
 export const pikkuListFunc = (config) => {
     return pikkuFunc(config);
 };
@@ -36,14 +43,7 @@ export function pikkuSessionlessFunc(func) {
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const cleanupTempFiles = pikkuVoidFunc(async ({fileSystem, logger}) => {
- *     logger.info('Starting cleanup of temporary files')
- *     await fileSystem.deleteDirectory('/tmp/uploads')
- *     logger.info('Cleanup completed')
- * })
- * ```
+ * @example snippet: cleanupFunction
  */
 export const pikkuVoidFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
@@ -106,11 +106,23 @@ export function pikkuRemoteChannelFunc(config) {
 const __addonHttp = {};
 const __addonChannel = {};
 const __addonCli = {};
+/**
+ * Names an HTTP route an installed addon wires, so you can link or redirect to
+ * it without hardcoding a path the addon may move.
+ */
 export const refHTTP = (name, options) => {
     const contract = __addonHttp[name];
     return (options?.basePath !== undefined
         ? { ...contract, basePath: options.basePath }
         : contract);
 };
+/**
+ * Names a channel an installed addon wires, for connecting to it without
+ * hardcoding its name.
+ */
 export const refChannel = (name) => __addonChannel[name];
+/**
+ * Names a CLI command an installed addon wires, for invoking it without
+ * hardcoding its name.
+ */
 export const refCLI = (name) => __addonCli[name];

package/dist/.pikku/function/pikku-functions-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 metaData from './pikku-functions-meta.gen.json' with { type: 'json' };

package/dist/.pikku/function/pikku-functions-meta.gen.json

@@ -94,25 +94,6 @@
         "inputHash": "0d9fecc6",
         "outputHash": "53f9b0f4"
     },
-    "FabricDeployPlan": {
-        "pikkuFuncId": "FabricDeployPlan",
-        "functionType": "user",
-        "funcWrapper": "pikkuSessionlessFunc",
-        "sessionless": true,
-        "name": "FabricDeployPlan",
-        "inputSchemaName": "FabricDeployPlanInput",
-        "outputSchemaName": "FabricDeployPlanOutput",
-        "inputs": [
-            "FabricDeployPlanInput"
-        ],
-        "outputs": [
-            "FabricDeployPlanOutput"
-        ],
-        "implementationHash": "5b2993ff2b99bde8",
-        "contractHash": "1f19149a5a41398e",
-        "inputHash": "8fd1bbb5",
-        "outputHash": "c3eaf5b9"
-    },
     "FabricDeployApply": {
         "pikkuFuncId": "FabricDeployApply",
         "functionType": "user",
@@ -127,10 +108,10 @@
         "outputs": [
             "FabricDeployApplyOutput"
         ],
-        "implementationHash": "45f5a8926e0bbd89",
-        "contractHash": "a3efc7c947c40c34",
-        "inputHash": "eb0e905e",
-        "outputHash": "0cc6a239"
+        "implementationHash": "29af90c2e0014ec5",
+        "contractHash": "c6880cdb39fc7786",
+        "inputHash": "06fcf5de",
+        "outputHash": "8133c760"
     },
     "FabricDomainsAdd": {
         "pikkuFuncId": "FabricDomainsAdd",
@@ -222,7 +203,7 @@
         "outputs": [
             "FabricInitOutput"
         ],
-        "implementationHash": "af5225360e5de4f9",
+        "implementationHash": "07d961208ba099c1",
         "contractHash": "b2e147aae8fa11dc",
         "inputHash": "05039012",
         "outputHash": "57ad379a"
@@ -241,7 +222,7 @@
         "outputs": [
             "FabricLinkOutput"
         ],
-        "implementationHash": "428e661fe3b9b091",
+        "implementationHash": "8055b31d4f51883b",
         "contractHash": "1385559220019a47",
         "inputHash": "28003777",
         "outputHash": "41a4d17a"
@@ -393,10 +374,10 @@
         "outputs": [
             "FabricSecretsRotateOutput"
         ],
-        "implementationHash": "346816bed87deec6",
-        "contractHash": "ea64632c9e870545",
+        "implementationHash": "7276d4bd40963325",
+        "contractHash": "431c9b05e828f3f5",
         "inputHash": "c4a580d9",
-        "outputHash": "4cc0b805"
+        "outputHash": "d1cc036e"
     },
     "FabricSecretsSet": {
         "pikkuFuncId": "FabricSecretsSet",
@@ -685,7 +666,7 @@
             "DeployApplyInput"
         ],
         "outputs": [],
-        "implementationHash": "32a1425d0427ac15",
+        "implementationHash": "c4590df513ebc614",
         "contractHash": "e095a77f7d02be4e",
         "inputHash": "344acae5",
         "outputHash": "2b614932"
@@ -717,7 +698,7 @@
             "DeployPlanInput"
         ],
         "outputs": [],
-        "implementationHash": "ae081f4d2d8ec0ac",
+        "implementationHash": "9fc16e03881100e1",
         "contractHash": "27db78888aa7bb8b",
         "inputHash": "8137f6d2",
         "outputHash": "e6e7d2ab"
@@ -737,6 +718,25 @@
         "remote": true,
         "implementationHash": "2bf1484d363794f3"
     },
+    "doc": {
+        "pikkuFuncId": "doc",
+        "functionType": "user",
+        "funcWrapper": "pikkuSessionlessFunc",
+        "sessionless": true,
+        "name": "doc",
+        "inputSchemaName": "DocInput",
+        "outputSchemaName": "DocOutput",
+        "inputs": [
+            "DocInput"
+        ],
+        "outputs": [
+            "DocOutput"
+        ],
+        "implementationHash": "6f2699ce4f87e313",
+        "contractHash": "3ee018d0c324022f",
+        "inputHash": "897f55af",
+        "outputHash": "98fc9036"
+    },
     "pikkuEmailsInit": {
         "pikkuFuncId": "pikkuEmailsInit",
         "functionType": "user",
@@ -1692,9 +1692,9 @@
             "PikkuSkillsInstallInput"
         ],
         "outputs": [],
-        "implementationHash": "fdc12152733c53ec",
-        "contractHash": "3eb84a1491c58f86",
-        "inputHash": "8dfd97bd",
+        "implementationHash": "6e454d000a5dd89f",
+        "contractHash": "a34372d753be78d0",
+        "inputHash": "991904e6",
         "outputHash": "2486db2e"
     },
     "pikkuUpdate": {
@@ -2322,7 +2322,7 @@
             "PikkuFunctionTypesSplitInput"
         ],
         "outputs": [],
-        "implementationHash": "9655e4ec7b5ee088",
+        "implementationHash": "23ec1a1938035fef",
         "middleware": [
             {
                 "type": "wire",

package/dist/.pikku/function/pikku-functions.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 and register functions used by RPCs */
 import { addFunction } from '@pikku/core/function';

package/dist/.pikku/gateway/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/gateway` resolves here.

package/dist/.pikku/gateway/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/gateway` resolves here.

package/dist/.pikku/gateway/pikku-gateway-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
  */
 /**
  * Gateway-specific type definitions for tree-shaking optimization

package/dist/.pikku/gateway/pikku-gateway-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
  */
 /**
  * Gateway-specific type definitions for tree-shaking optimization

package/dist/.pikku/http/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/http` resolves here.

package/dist/.pikku/http/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/http` resolves here.

package/dist/.pikku/http/pikku-http-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
  */
 /**
  * HTTP-specific type definitions for tree-shaking optimization
@@ -25,6 +25,8 @@ type HTTPWiring<In, Out, Route extends string> = CoreHTTPFunctionWiring<In, Out,
  * @template Out - Output type for the HTTP wiring
  * @template Route - String literal type for the HTTP path (e.g., "/users/:id")
  * @param httpWiring - HTTP wiring definition with handler, method, and optional middleware
+ *
+ * @example snippet: httpSingleRoute
  */
 export declare const wireHTTP: <In, Out, Route extends string>(httpWiring: HTTPWiring<In, Out, Route> & AssertHTTPWiringParams<In, Route>) => void;
 /**
@@ -67,6 +69,8 @@ type TypedWireHTTPRoutesConfig = TypedHTTPRoutesGroupConfig & {
 };
 /**
  * Type-safe helper for defining route contracts that can be composed.
+ *
+ * @example snippet: wireHttp
  */
 export declare function defineHTTPRoutes<T extends TypedHTTPRouteMap>(routes: T): TypedHTTPRouteContract<T>;
 export declare function defineHTTPRoutes<T extends TypedHTTPRouteMap>(config: TypedHTTPRoutesGroupConfig & {
@@ -74,6 +78,8 @@ export declare function defineHTTPRoutes<T extends TypedHTTPRouteMap>(config: Ty
 }): TypedHTTPRouteContract<T>;
 /**
  * Wires multiple HTTP routes from a nested map or array configuration.
+ *
+ * @example snippet: httpRoutesWiring
  */
 export declare const wireHTTPRoutes: (config: TypedWireHTTPRoutesConfig) => void;
 export {};

package/dist/.pikku/http/pikku-http-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
  */
 /**
  * HTTP-specific type definitions for tree-shaking optimization
@@ -12,6 +12,8 @@ import { wireHTTP as wireHTTPCore, wireHTTPRoutes as wireHTTPRoutesCore, defineH
  * @template Out - Output type for the HTTP wiring
  * @template Route - String literal type for the HTTP path (e.g., "/users/:id")
  * @param httpWiring - HTTP wiring definition with handler, method, and optional middleware
+ *
+ * @example snippet: httpSingleRoute
  */
 export const wireHTTP = (httpWiring) => {
     wireHTTPCore(httpWiring);
@@ -21,6 +23,8 @@ export function defineHTTPRoutes(configOrRoutes) {
 }
 /**
  * Wires multiple HTTP routes from a nested map or array configuration.
+ *
+ * @example snippet: httpRoutesWiring
  */
 export const wireHTTPRoutes = (config) => {
     wireHTTPRoutesCore(config);

package/dist/.pikku/mcp/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/mcp` resolves here.

package/dist/.pikku/mcp/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/mcp` resolves here.

package/dist/.pikku/mcp/pikku-mcp-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
  */
 /**
  * MCP-specific type definitions for tree-shaking optimization
@@ -33,6 +33,8 @@ type MCPPromptWiring<In> = CoreMCPPrompt<PikkuFunctionConfig<In, MCPPromptRespon
  * @template In - Input type for the resource request
  * @template URI - URI template string for compile-time parameter validation
  * @param mcpResource - MCP resource definition with data provider function
+ *
+ * @example snippet: mcpResource
  */
 export declare const wireMCPResource: <In, URI extends string>(mcpResource: MCPResourceWiring<In, URI> & AssertMCPResourceURIParams<In, URI>) => void;
 /**
@@ -41,6 +43,8 @@ export declare const wireMCPResource: <In, URI extends string>(mcpResource: MCPR
  *
  * @template In - Input type for the prompt parameters
  * @param mcpPrompt - MCP prompt definition with template function
+ *
+ * @example snippet: mcpPrompt
  */
 export declare const wireMCPPrompt: <In>(mcpPrompt: MCPPromptWiring<In>) => void;
 /**
@@ -62,6 +66,8 @@ type MCPPromptFuncConfigWithSchema<InputSchema extends StandardSchemaV1> = {
  * @template In - Input type for the prompt parameters (inferred from schema if provided)
  * @param func - Function definition, either direct function or configuration object
  * @returns The unwrapped function for internal use
+ *
+ * @example snippet: mcpPrompt
  */
 export declare function pikkuMCPPromptFunc<InputSchema extends StandardSchemaV1>(config: MCPPromptFuncConfigWithSchema<InputSchema>): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, MCPPromptResponse, 'mcp' | 'rpc'>;
 export declare function pikkuMCPPromptFunc<In>(func: PikkuFunctionSessionless<In, MCPPromptResponse, 'mcp' | 'rpc'> | {
@@ -93,6 +99,8 @@ type MCPToolFuncConfigWithSchema<InputSchema extends StandardSchemaV1> = {
  * @template In - Input type for the tool invocation (inferred from schema if provided)
  * @param func - Function definition, either direct function or configuration object
  * @returns The unwrapped function for internal use
+ *
+ * @example snippet: mcpSingleTool
  */
 export declare function pikkuMCPToolFunc<InputSchema extends StandardSchemaV1>(config: MCPToolFuncConfigWithSchema<InputSchema>): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, MCPToolResponse, 'mcp' | 'rpc'>;
 export declare function pikkuMCPToolFunc<In>(func: PikkuFunctionSessionless<In, MCPToolResponse, 'mcp' | 'rpc'> | {
@@ -124,6 +132,8 @@ type MCPResourceFuncConfigWithSchema<InputSchema extends StandardSchemaV1> = {
  * @template In - Input type for the resource request (inferred from schema if provided)
  * @param func - Function definition, either direct function or configuration object
  * @returns The unwrapped function for internal use
+ *
+ * @example snippet: mcpResource
  */
 export declare function pikkuMCPResourceFunc<InputSchema extends StandardSchemaV1>(config: MCPResourceFuncConfigWithSchema<InputSchema>): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, MCPResourceResponse, 'mcp' | 'rpc'>;
 export declare function pikkuMCPResourceFunc<In>(func: PikkuFunctionSessionless<In, MCPResourceResponse, 'mcp' | 'rpc'> | {

package/dist/.pikku/mcp/pikku-mcp-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
  */
 /**
  * MCP-specific type definitions for tree-shaking optimization
@@ -12,6 +12,8 @@ import { wireMCPResource as wireMCPResourceCore, wireMCPPrompt as wireMCPPromptC
  * @template In - Input type for the resource request
  * @template URI - URI template string for compile-time parameter validation
  * @param mcpResource - MCP resource definition with data provider function
+ *
+ * @example snippet: mcpResource
  */
 export const wireMCPResource = (mcpResource) => {
     wireMCPResourceCore(mcpResource);
@@ -22,6 +24,8 @@ export const wireMCPResource = (mcpResource) => {
  *
  * @template In - Input type for the prompt parameters
  * @param mcpPrompt - MCP prompt definition with template function
+ *
+ * @example snippet: mcpPrompt
  */
 export const wireMCPPrompt = (mcpPrompt) => {
     wireMCPPromptCore(mcpPrompt);

package/dist/.pikku/middleware/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/middleware` resolves here.

package/dist/.pikku/middleware/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/middleware` resolves here.

package/dist/.pikku/middleware/pikku-middleware-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
  */
 /**
  * Middleware type definitions and registration for all wirings
@@ -9,7 +9,7 @@ import { CorePikkuChannelMiddleware, CorePikkuChannelMiddlewareFactory } from '@
 import type { PikkuAgentMiddlewareHooks } from '@pikku/core/agent';
 import type { Services, SingletonServices } from '../function/pikku-function-types.gen.js';
 import type { RequiredSingletonServices } from '../pikku-services.gen.js';
-export { cors } from '@pikku/core/middleware';
+export { cors, authAPIKey, authBearer, authCookie } from '@pikku/core/middleware';
 export type { MiddlewarePriority };
 /**
  * Derived here rather than imported: nothing outside a generated leaf ever
@@ -66,18 +66,7 @@ export declare const pikkuMiddleware: <RequiredServices extends SingletonService
  * Factory function for creating middleware factories
  * Use this when your middleware needs configuration/input parameters
  *
- * @example
- * ```typescript
- * export const logMiddleware = pikkuMiddlewareFactory<LogOptions>(({
- *   message,
- *   level = 'info'
- * }) => {
- *   return pikkuMiddleware(async ({ logger }, next) => {
- *     logger[level](message)
- *     await next()
- *   })
- * })
- * ```
+ * @example snippet: middlewareFactory
  */
 export declare const pikkuMiddlewareFactory: <In = any>(factory: (input: In) => PikkuMiddleware) => ((input: In) => PikkuMiddleware);
 /**
@@ -93,8 +82,7 @@ export declare const addGlobalMiddleware: (middleware: PikkuMiddleware[]) => voi
 /**
  * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
  *
- * @example
- * addTagMiddleware('admin', [adminMiddleware])
+ * @example snippet: tagMiddleware
  */
 export declare const addTagMiddleware: (tag: string, middleware: PikkuMiddleware[]) => void;
 /**
@@ -107,18 +95,39 @@ export declare const addTagMiddleware: (tag: string, middleware: PikkuMiddleware
  * @param routeOrMiddleware - Either a global middleware array or a route pattern string
  * @param middleware - The middleware array to apply when a route pattern is specified
  *
- * @example
- * ```typescript
- * // Add global HTTP middleware
- * addHTTPMiddleware([authMiddleware, loggingMiddleware])
- *
- * // Add route-specific middleware
- * addHTTPMiddleware('/api/admin/*', [adminAuthMiddleware])
- * ```
+ * @example snippet: httpMiddleware
  */
 export declare const addHTTPMiddleware: (routeOrMiddleware: PikkuMiddleware[] | string, middleware?: PikkuMiddleware[]) => void;
+/**
+ * The shape of channel middleware — it runs around the connection and its
+ * messages rather than around a single request.
+ */
 export type PikkuChannelMiddleware<RequiredServices extends Services = Services, Event = unknown> = CorePikkuChannelMiddleware<RequiredServices, Event>;
+/**
+ * Declares middleware for a channel — it runs around the connection and its
+ * messages rather than around a single request.
+ *
+ * @example snippet: channelMiddleware
+ */
 export declare const pikkuChannelMiddleware: <RequiredServices extends Services = Services, Event = unknown>(middleware: PikkuChannelMiddleware<RequiredServices, Event>) => PikkuChannelMiddleware<RequiredServices, Event>;
+/**
+ * Declares channel middleware that takes options, so one definition can be
+ * wired several times with different configuration.
+ *
+ * @example snippet: channelMiddlewareFactory
+ */
 export declare const pikkuChannelMiddlewareFactory: <In = any>(factory: CorePikkuChannelMiddlewareFactory<In>) => CorePikkuChannelMiddlewareFactory<In>;
+/**
+ * Attaches channel middleware to every channel carrying the given tag, so the
+ * channels themselves stay free of the wiring.
+ *
+ * @example snippet: addChannelMiddleware
+ */
 export declare const addChannelMiddleware: (tag: string, middleware: PikkuChannelMiddleware[]) => CorePikkuChannelMiddleware[];
+/**
+ * Declares middleware for an agent run — hooks around the model call, its tool
+ * calls and the run's state.
+ *
+ * @example snippet: agentMiddleware
+ */
 export declare const pikkuAgentMiddleware: <State extends Record<string, unknown> = Record<string, unknown>, RequiredServices extends SingletonServices = WiredSingletonServices>(hooks: PikkuAgentMiddlewareHooks<State, RequiredServices>) => PikkuAgentMiddlewareHooks<State, RequiredServices>;