@pikku/addon-graph 0.12.13 → 0.12.14

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @pikku/addon-graph
 
+## 0.12.14
+
+### Patch Changes
+
+- 712991d: Ship the generated `pikku-db-meta.gen.json` in `dist`. `pikku all` writes it
+  under `.pikku/addon/db/`, but `tsc` only emits the JSON it sees imported and
+  nothing imports this one, so it never reached the published package. Every
+  consumer running `pikku db generate` then failed with "does not publish
+  .pikku/db/pikku-db-meta.gen.json" — an addon that cannot say whether it ships
+  tables — which took out the `ai-postgres`, `remote-rpc-pg` and
+  `workflows-pg-boss` templates.
+- Updated dependencies [bbb9e3b]
+  - @pikku/core@0.12.106
+
 ## 0.12.13
 
 ### Patch Changes

package/dist/.pikku/addon/agent/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/agent` resolves here.

package/dist/.pikku/addon/agent/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/agent` resolves here.

package/dist/.pikku/addon/agent/pikku-agent-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 import { CoreAgent } from '@pikku/core/agent';
 import { pikkuAgentScorer as corePikkuAgentScorer, pikkuAgentJudge as corePikkuAgentJudge } from '@pikku/core/agent-scorer';
@@ -21,9 +21,33 @@ type AgentConfig<InputSchema extends StandardSchemaV1 | undefined = undefined, O
     agents?: AgentConfig<StandardSchemaV1 | undefined, StandardSchemaV1 | undefined>[];
     workflows?: object[];
 };
+/**
+ * Declares an agent: the model, the prompt, the tools it may call and the shape
+ * of what it returns. Wire it like any other function.
+ *
+ * @example snippet: aiAgent
+ */
 export declare const pikkuAgent: <InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(agent: AgentConfig<InputSchema, OutputSchema>) => AgentConfig<InputSchema, OutputSchema>;
+/**
+ * Declares a scorer that grades an agent run programmatically — a function over
+ * the run's input and output returning a score.
+ *
+ * @example snippet: agentScorer
+ */
 export declare const pikkuAgentScorer: (config: Parameters<typeof corePikkuAgentScorer<Services>>[0]) => import("@pikku/core/agent-scorer").PikkuAgentScorer<Services>;
+/**
+ * Declares a scorer that grades an agent run with another model, for the
+ * qualities a programmatic check cannot express.
+ *
+ * @example snippet: agentJudge
+ */
 export declare const pikkuAgentJudge: (config: Parameters<typeof corePikkuAgentJudge<Services>>[0]) => import("@pikku/core/agent-scorer").PikkuAgentScorer<Services>;
+/**
+ * A ready-made function that runs the named agent once and returns its result —
+ * wire it straight to a route when you need no logic around the run.
+ *
+ * @example snippet: aiAgentInvoke
+ */
 export declare const agent: <Name extends keyof AgentMap>(agentName: Name) => PikkuFunctionConfig<AgentInput, {
     runId: string;
     result: AgentMap[Name]["output"];
@@ -32,17 +56,34 @@ export declare const agent: <Name extends keyof AgentMap>(agentName: Name) => Pi
         outputTokens: number;
     };
 }, "session" | "rpc">;
+/**
+ * The streaming counterpart of `agent`: wire it to a channel to send tokens and
+ * tool calls as they happen instead of waiting for the run to finish.
+ *
+ * @example snippet: aiAgentStream
+ */
 export declare const agentStream: <Name extends keyof AgentMap>(agentName?: Name | undefined) => PikkuFunctionConfig<{
     agentName?: string;
     message: string;
     threadId: string;
     resourceId: string;
 }, void, "session" | "rpc">;
+/**
+ * A ready-made function that answers one pending tool approval, letting a run
+ * that paused for a human carry on.
+ *
+ * @example snippet: agentApproval
+ */
 export declare const agentResume: () => PikkuFunctionConfig<{
     runId: string;
     toolCallId: string;
     approved: boolean;
 }, void, "session" | "rpc">;
+/**
+ * A ready-made function that answers every pending approval for a run at once.
+ *
+ * @example snippet: agentApproval
+ */
 export declare const agentApprove: <Name extends keyof AgentMap>(agentName: Name) => PikkuFunctionConfig<{
     runId: string;
     approvals: {

package/dist/.pikku/addon/agent/pikku-agent-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-agent-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/agent/pikku-agent-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAO7C,OAAO,EACL,gBAAgB,IAAI,oBAAoB,EACxC,eAAe,IAAI,mBAAmB,EACvC,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D,KAAK,WAAW,CACd,WAAW,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC5D,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,IAC3D,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG;IAC7I,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,MAAM,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAA;IACxF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC,gBAAgB,GAAG,SAAS,EAAE,gBAAgB,GAAG,SAAS,CAAC,EAAE,CAAA;IAClF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,WAAW,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAC5D,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,OAAO,WAAW,CAAC,WAAW,EAAE,YAAY,CAAC,2CAG9C,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,UAAU,CAAC,OAAO,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,kEACnB,CAAA;AAE3C,eAAO,MAAM,eAAe,GAC1B,QAAQ,UAAU,CAAC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,kEACnB,CAAA;AAI1C,eAAO,MAAM,KAAK,GAAI,IAAI,SAAS,MAAM,QAAQ,EAC/C,WAAW,IAAI,KAEqD,mBAAmB,CACrF,UAAU,EACV;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;IAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACzG,SAAS,GAAG,KAAK,CAEpB,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,IAAI,SAAS,MAAM,QAAQ,EACrD,4BAAgB,KAE0D,mBAAmB,CAC3F;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC7E,IAAI,EACJ,SAAS,GAAG,KAAK,CAEpB,CAAA;AAED,eAAO,MAAM,WAAW,QACM,mBAAmB,CAC7C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EACxD,IAAI,EACJ,SAAS,GAAG,KAAK,CAEpB,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,IAAI,SAAS,MAAM,QAAQ,EACtD,WAAW,IAAI,KAE4D,mBAAmB,CAC5F;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAAE,EACzE,OAAO,EACP,SAAS,GAAG,KAAK,CAEpB,CAAA"}
+{"version":3,"file":"pikku-agent-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/agent/pikku-agent-types.gen.ts"],"names":[],"mappings":"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"}

package/dist/.pikku/addon/agent/pikku-agent-types.gen.js

@@ -1,19 +1,60 @@
 import { agent as coreAgent, agentStream as coreAgentStream, agentResume as coreAgentResume, agentApprove as coreAgentApprove, } from '@pikku/core/agent';
 import { pikkuAgentScorer as corePikkuAgentScorer, pikkuAgentJudge as corePikkuAgentJudge, } from '@pikku/core/agent-scorer';
+/**
+ * Declares an agent: the model, the prompt, the tools it may call and the shape
+ * of what it returns. Wire it like any other function.
+ *
+ * @example snippet: aiAgent
+ */
 export const pikkuAgent = (agent) => {
     return agent;
 };
+/**
+ * Declares a scorer that grades an agent run programmatically — a function over
+ * the run's input and output returning a score.
+ *
+ * @example snippet: agentScorer
+ */
 export const pikkuAgentScorer = (config) => corePikkuAgentScorer(config);
+/**
+ * Declares a scorer that grades an agent run with another model, for the
+ * qualities a programmatic check cannot express.
+ *
+ * @example snippet: agentJudge
+ */
 export const pikkuAgentJudge = (config) => corePikkuAgentJudge(config);
+/**
+ * A ready-made function that runs the named agent once and returns its result —
+ * wire it straight to a route when you need no logic around the run.
+ *
+ * @example snippet: aiAgentInvoke
+ */
 export const agent = (agentName) => {
     return coreAgent(agentName);
 };
+/**
+ * The streaming counterpart of `agent`: wire it to a channel to send tokens and
+ * tool calls as they happen instead of waiting for the run to finish.
+ *
+ * @example snippet: aiAgentStream
+ */
 export const agentStream = (agentName) => {
     return coreAgentStream(agentName);
 };
+/**
+ * A ready-made function that answers one pending tool approval, letting a run
+ * that paused for a human carry on.
+ *
+ * @example snippet: agentApproval
+ */
 export const agentResume = () => {
     return coreAgentResume();
 };
+/**
+ * A ready-made function that answers every pending approval for a run at once.
+ *
+ * @example snippet: agentApproval
+ */
 export const agentApprove = (agentName) => {
     return coreAgentApprove(agentName);
 };

package/dist/.pikku/addon/agent/pikku-agent-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-agent-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/agent/pikku-agent-types.gen.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,IAAI,SAAS,EAClB,WAAW,IAAI,eAAe,EAC9B,WAAW,IAAI,eAAe,EAC9B,YAAY,IAAI,gBAAgB,GACjC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,gBAAgB,IAAI,oBAAoB,EACxC,eAAe,IAAI,mBAAmB,GACvC,MAAM,0BAA0B,CAAA;AAsBjC,MAAM,CAAC,MAAM,UAAU,GAAG,CAIxB,KAA6C,EAC7C,EAAE;IACF,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAA4D,EAC5D,EAAE,CAAC,oBAAoB,CAAW,MAAM,CAAC,CAAA;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAA2D,EAC3D,EAAE,CAAC,mBAAmB,CAAW,MAAM,CAAC,CAAA;AAI1C,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,SAAe,EACf,EAAE;IACF,OAAO,SAAS,CAAW,SAAoC,CAI9D,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,SAAgB,EAChB,EAAE;IACF,OAAO,eAAe,CAAW,SAAoC,CAIpE,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE;IAC9B,OAAO,eAAe,EAIrB,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAAe,EACf,EAAE;IACF,OAAO,gBAAgB,CAAW,SAAoC,CAIrE,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"pikku-agent-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/agent/pikku-agent-types.gen.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,IAAI,SAAS,EAClB,WAAW,IAAI,eAAe,EAC9B,WAAW,IAAI,eAAe,EAC9B,YAAY,IAAI,gBAAgB,GACjC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,gBAAgB,IAAI,oBAAoB,EACxC,eAAe,IAAI,mBAAmB,GACvC,MAAM,0BAA0B,CAAA;AAsBjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAIxB,KAA6C,EAC7C,EAAE;IACF,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAA4D,EAC5D,EAAE,CAAC,oBAAoB,CAAW,MAAM,CAAC,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAA2D,EAC3D,EAAE,CAAC,mBAAmB,CAAW,MAAM,CAAC,CAAA;AAI1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,SAAe,EACf,EAAE;IACF,OAAO,SAAS,CAAW,SAAoC,CAI9D,CAAA;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,SAAgB,EAChB,EAAE;IACF,OAAO,eAAe,CAAW,SAAoC,CAIpE,CAAA;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE;IAC9B,OAAO,eAAe,EAIrB,CAAA;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAAe,EACf,EAAE;IACF,OAAO,gBAAgB,CAAW,SAAoC,CAIrE,CAAA;AACH,CAAC,CAAA"}

package/dist/.pikku/addon/agent/pikku-model-aliases.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 import { pikkuState } from '@pikku/core/state';
 pikkuState('@pikku/addon-graph', 'agent', 'modelAliases', {});

package/dist/.pikku/addon/auth/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/auth` resolves here.

package/dist/.pikku/addon/auth/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/auth` resolves here.

package/dist/.pikku/addon/auth/pikku-auth-types.gen.d.ts

@@ -1,13 +1,20 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Permission, auth gate and credential definitions
  */
 import type { PikkuWire, SecretlessServices } from '@pikku/core/types';
 import type { CorePermissionGroup, CorePikkuAuth, CorePikkuAuthConfig, CorePikkuPermission } from '@pikku/core/function';
-import type { Services, Session, SingletonServices, WiredServices, WiredSingletonServices } from '../function/pikku-function-types.gen.js';
+import type { Services, Session, SingletonServices, WiredServices } from '../function/pikku-function-types.gen.js';
+import type { RequiredSingletonServices } from '../pikku-services.gen.js';
 export { defineCredential } from '@pikku/core/credential';
+/**
+ * Derived here rather than imported: nothing outside a generated leaf ever
+ * names this intersection, so the function leaf keeps it to itself and the
+ * leaves that want it spell it out.
+ */
+type WiredSingletonServices = RequiredSingletonServices & SingletonServices;
 /** `WiredSingletonServices` without `secrets`, for auth gates. */
 type WiredAuthServices = SecretlessServices<WiredSingletonServices>;
 /**
@@ -33,24 +40,7 @@ type PikkuPermissionConfig<In = unknown, RequiredServices extends SecretlessServ
  * Factory function for creating permissions with tree-shaking support.
  * Supports both direct function and configuration object syntax.
  *
- * @example
- * ```typescript
- * // Direct function syntax
- * const permission = pikkuPermission(async ({ logger }, data, { session }) => {
- *   const session = await session?.get()
- *   return session?.role === 'admin'
- * })
- *
- * // Configuration object syntax with metadata
- * const adminPermission = pikkuPermission({
- *   name: 'Admin Permission',
- *   description: 'Checks if user has admin role',
- *   func: async ({ logger }, data, { session }) => {
- *     const session = await session?.get()
- *     return session?.role === 'admin'
- *   }
- * })
- * ```
+ * @example snippet: permissionFunction
  */
 export declare const pikkuPermission: <In>(permission: PikkuPermission<In> | PikkuPermissionConfig<In>) => PikkuPermission<In>;
 /**

package/dist/.pikku/addon/auth/pikku-auth-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-auth-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/auth/pikku-auth-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACvB,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,kEAAkE;AAClE,KAAK,iBAAiB,GAAG,kBAAkB,CAAC,sBAAsB,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,gBAAgB,SAAS,kBAAkB,CAAC,QAAQ,CAAC,GAAG,aAAa,IAAI,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;AAElM;;GAEG;AACH,KAAK,qBAAqB,CAAC,EAAE,GAAG,OAAO,EAAE,gBAAgB,SAAS,kBAAkB,CAAC,QAAQ,CAAC,GAAG,aAAa,IAAI;IAChH,8BAA8B;IAC9B,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAA;IAC3C,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,eAAe,GAAI,EAAE,EAChC,YAAY,eAAe,CAAC,EAAE,CAAC,GAAG,qBAAqB,CAAC,EAAE,CAAC,KAC1D,eAAe,CAAC,EAAE,CAEpB,CAAA;AAED;;;;;;GAMG;AACH,KAAK,SAAS,CAAC,gBAAgB,SAAS,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,IAAI,aAAa,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;AAE7I;;GAEG;AACH,KAAK,eAAe,CAAC,gBAAgB,SAAS,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;AAEzJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,GAAI,gBAAgB,SAAS,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,EAC1G,MAAM,SAAS,CAAC,gBAAgB,CAAC,GAAG,eAAe,CAAC,gBAAgB,CAAC,KACpE,eAAe,CAAC,GAAG,EAAE,GAAG,CAE1B,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB,GAAI,EAAE,GAAG,GAAG,EAC7C,SAAS,CAAC,KAAK,EAAE,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,KAC3C,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,CAEtC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,EAAE,GAAG,OAAO,EAAE,aAAa,mBAAmB,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,EAAE,SAE9H,CAAA"}
+{"version":3,"file":"pikku-auth-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/auth/pikku-auth-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,iBAAiB,EACjB,aAAa,EACd,MAAM,yCAAyC,CAAA;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD;;;;GAIG;AACH,KAAK,sBAAsB,GAAG,yBAAyB,GAAG,iBAAiB,CAAA;AAE3E,kEAAkE;AAClE,KAAK,iBAAiB,GAAG,kBAAkB,CAAC,sBAAsB,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,gBAAgB,SAAS,kBAAkB,CAAC,QAAQ,CAAC,GAAG,aAAa,IAAI,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;AAElM;;GAEG;AACH,KAAK,qBAAqB,CAAC,EAAE,GAAG,OAAO,EAAE,gBAAgB,SAAS,kBAAkB,CAAC,QAAQ,CAAC,GAAG,aAAa,IAAI;IAChH,8BAA8B;IAC9B,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAA;IAC3C,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,EAAE,EAChC,YAAY,eAAe,CAAC,EAAE,CAAC,GAAG,qBAAqB,CAAC,EAAE,CAAC,KAC1D,eAAe,CAAC,EAAE,CAEpB,CAAA;AAED;;;;;;GAMG;AACH,KAAK,SAAS,CAAC,gBAAgB,SAAS,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,IAAI,aAAa,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;AAE7I;;GAEG;AACH,KAAK,eAAe,CAAC,gBAAgB,SAAS,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;AAEzJ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,GAAI,gBAAgB,SAAS,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,EAC1G,MAAM,SAAS,CAAC,gBAAgB,CAAC,GAAG,eAAe,CAAC,gBAAgB,CAAC,KACpE,eAAe,CAAC,GAAG,EAAE,GAAG,CAE1B,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB,GAAI,EAAE,GAAG,GAAG,EAC7C,SAAS,CAAC,KAAK,EAAE,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,KAC3C,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,CAEtC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,EAAE,GAAG,OAAO,EAAE,aAAa,mBAAmB,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,EAAE,SAE9H,CAAA"}

package/dist/.pikku/addon/auth/pikku-auth-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Permission, auth gate and credential definitions
@@ -11,24 +11,7 @@ export { defineCredential } from '@pikku/core/credential';
  * Factory function for creating permissions with tree-shaking support.
  * Supports both direct function and configuration object syntax.
  *
- * @example
- * ```typescript
- * // Direct function syntax
- * const permission = pikkuPermission(async ({ logger }, data, { session }) => {
- *   const session = await session?.get()
- *   return session?.role === 'admin'
- * })
- *
- * // Configuration object syntax with metadata
- * const adminPermission = pikkuPermission({
- *   name: 'Admin Permission',
- *   description: 'Checks if user has admin role',
- *   func: async ({ logger }, data, { session }) => {
- *     const session = await session?.get()
- *     return session?.role === 'admin'
- *   }
- * })
- * ```
+ * @example snippet: permissionFunction
  */
 export const pikkuPermission = (permission) => {
     return typeof permission === 'function' ? permission : permission.func;

package/dist/.pikku/addon/auth/pikku-auth-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-auth-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/auth/pikku-auth-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AASH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AASvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AA0BzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAA2D,EACtC,EAAE;IACvB,OAAO,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAA;AACxE,CAAC,CAAA;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAqE,EAC1C,EAAE;IAC7B,OAAO,aAAa,CAAC,IAAW,CAAQ,CAAA;AAC1C,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAA4C,EACL,EAAE;IACzC,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAe,WAA6E,EAAE,EAAE;IACjI,uBAAuB,CAAC,WAAkB,EAAE,oBAAoB,CAAC,CAAA;AACnE,CAAC,CAAA"}
+{"version":3,"file":"pikku-auth-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/auth/pikku-auth-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AASH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AASvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAiCzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAA2D,EACtC,EAAE;IACvB,OAAO,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAA;AACxE,CAAC,CAAA;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAqE,EAC1C,EAAE;IAC7B,OAAO,aAAa,CAAC,IAAW,CAAQ,CAAA;AAC1C,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAA4C,EACL,EAAE;IACzC,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAe,WAA6E,EAAE,EAAE;IACjI,uBAAuB,CAAC,WAAkB,EAAE,oBAAoB,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/dist/.pikku/addon/channel/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/channel` resolves here.

package/dist/.pikku/addon/channel/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/channel` resolves here.

package/dist/.pikku/addon/channel/pikku-channel-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization
@@ -20,6 +20,8 @@ type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output> ? Outp
  * @template Out - Output type for connection response
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export declare const pikkuChannelConnectionFunc: <Out = unknown>(func: PikkuFunctionSessionless<void, Out, "channel" | "session" | "rpc"> | PikkuFunctionConfig<void, Out, "channel" | "session" | "rpc">) => PikkuFunctionConfig<void, Out, "channel" | "rpc" | "session">;
 /**
@@ -28,6 +30,8 @@ export declare const pikkuChannelConnectionFunc: <Out = unknown>(func: PikkuFunc
  *
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export declare const pikkuChannelDisconnectionFunc: (func: PikkuFunctionSessionless<void, void, "channel"> | PikkuFunctionConfig<void, void, "channel" | "session" | "rpc">) => PikkuFunctionConfig<void, void, "channel" | "rpc" | "session">;
 /**
@@ -58,23 +62,7 @@ type PikkuChannelFuncConfigWithSchema<InputSchema extends StandardSchemaV1, Outp
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * // Pattern 1: Using generic types
- * const handleMessage = pikkuChannelFunc<{text: string}, {received: boolean}>({
- *   func: async (_services, { text }) => ({ received: true })
- * })
- *
- * // Pattern 2: Using Zod schemas
- * const messageInput = z.object({ text: z.string() })
- * const messageOutput = z.object({ received: z.boolean() })
- *
- * const handleMessage = pikkuChannelFunc({
- *   input: messageInput,
- *   output: messageOutput,
- *   func: async (_services, { text }) => ({ received: true })
- * })
- * ```
+ * @example snippet: orderStatusChannel
  */
 export declare function pikkuChannelFunc<InputSchema extends StandardSchemaV1, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuChannelFuncConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'channel' | 'session' | 'rpc'>;
 export declare function pikkuChannelFunc<In, Out = unknown>(func: PikkuFunctionSessionless<In, Out, 'channel' | 'session' | 'rpc'> | PikkuFunctionConfig<In, Out, 'channel' | 'session' | 'rpc'>): PikkuFunctionConfig<In, Out, 'channel' | 'session' | 'rpc'>;
@@ -85,6 +73,8 @@ export declare function pikkuChannelFunc<In, Out = unknown>(func: PikkuFunctionS
  * @template T - Record of channel route handlers
  * @param routes - The channel routes record
  * @returns The same routes record (identity function for type safety)
+ *
+ * @example snippet: channelRoutes
  */
 export declare function defineChannelRoutes<T extends Record<string, any>>(routes: T): T;
 export {};

package/dist/.pikku/addon/channel/pikku-channel-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-channel-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pikku-channel-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAC5G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAI1F;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,GAAI,GAAG,GAAG,OAAO,EACtD,MACI,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,GAClE,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,kEAGlE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GACxC,MACI,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,GAC/C,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,mEAGnE,CAAA;AAED;;GAEG;AACH,KAAK,gCAAgC,CACnC,WAAW,SAAS,gBAAgB,EACpC,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,IAC3D;IACF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,wBAAwB,CAC5B,iBAAiB,CAAC,WAAW,CAAC,EAC9B,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,EACjF,SAAS,GAAG,SAAS,GAAG,KAAK,CAC9B,CAAA;IACD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,WAAW,CAAC,EAAE,mBAAmB,CAAC,eAAe,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;IAClF,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,KAAK,EAAE,WAAW,CAAA;IAClB,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,SAAS,gBAAgB,EACpC,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,MAAM,EAAE,gCAAgC,CAAC,WAAW,EAAE,YAAY,CAAC,GAClE,mBAAmB,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,YAAY,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,CAAA;AACxK,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,EAChD,IAAI,EACA,wBAAwB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,GAChE,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,GAC9D,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC,CAAA;AAM9D;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAE/E"}

package/dist/.pikku/addon/channel/pikku-channel-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization
@@ -12,6 +12,8 @@ import { defineChannelRoutes as defineChannelRoutesCore } from '@pikku/core/chan
  * @template Out - Output type for connection response
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export const pikkuChannelConnectionFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
@@ -22,6 +24,8 @@ export const pikkuChannelConnectionFunc = (func) => {
  *
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export const pikkuChannelDisconnectionFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
@@ -36,6 +40,8 @@ export function pikkuChannelFunc(func) {
  * @template T - Record of channel route handlers
  * @param routes - The channel routes record
  * @returns The same routes record (identity function for type safety)
+ *
+ * @example snippet: channelRoutes
  */
 export function defineChannelRoutes(routes) {
     return defineChannelRoutesCore(routes);

package/dist/.pikku/addon/channel/pikku-channel-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-channel-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAcpF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAEiE,EACjE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,IAEkE,EAClE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAmED,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAGD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAgC,MAAS;IAC1E,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}
+{"version":3,"file":"pikku-channel-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAcpF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAEiE,EACjE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,IAEkE,EAClE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAmDD,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAGD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAgC,MAAS;IAC1E,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}

package/dist/.pikku/addon/error/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/pikku-error-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/pikku-error-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/addon/function/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/function` resolves here.

package/dist/.pikku/addon/function/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * Subpath entry — `#pikku/function` resolves here.

package/dist/.pikku/addon/function/pikku-function-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.141
  */
 /**
  * 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
@@ -33,8 +46,18 @@ export type Session = UserSession;
  * services **non-optional** at every call site. A service is optional only when
  * nothing destructures it — in which case it is never created either. This is
  * why an `if (!service)` guard inside a function body is always dead code.
+ *
+ * Only the wire-services half lives here. The singleton half is declared by the
+ * auth and middleware leaves that use it, because whether a name earns its
+ * export is measured rather than chosen: emit declarations for a project and
+ * `WiredServices` is named by 147 of its `.d.ts` files, while the singleton
+ * intersection is named by none outside the leaves that declare it. Export the
+ * latter and it is a compatibility promise nothing asked for; unexport
+ * `WiredServices` and every wired module inlines the intersection instead,
+ * which asks it to name each member service through a specifier it does not
+ * have — 3308 TS2883s. `--noEmit` cannot surface any of that, so re-check with
+ * `tsc --declaration --emitDeclarationOnly` before moving either one.
  */
-export type WiredSingletonServices = RequiredSingletonServices & SingletonServices;
 export type WiredServices = SecretlessServices<RequiredSingletonServices & Services>;
 /**
  * Inline node configuration for function definitions.
@@ -139,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.
@@ -184,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'>;
@@ -207,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">;
 /**
@@ -262,9 +259,21 @@ 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];
 //# sourceMappingURL=pikku-function-types.gen.d.ts.map