@pikku/addon-console 0.12.44 → 0.12.46

package/CHANGELOG.md

@@ -1,3 +1,139 @@
+## 0.12.46
+
+### Patch Changes
+
+- d1c6956: The AST-locate-then-text-splice editor that backs `console:updateFunctionConfig`
+  and `console:updateAgentConfig` is now `@pikku/code-edit` instead of a private
+  service inside the console addon. Nothing about the behaviour or the scopes
+  changed — the file moved and the addon imports it.
+
+  Editing a Pikku declaration is not a console concern: the CLI needs the same
+  operation, and the alternative was a second copy that drifts. It stays out of
+  `@pikku/inspector` deliberately, because the inspector is the read model that
+  codegen and validation depend on precisely because it does not mutate.
+
+  The addon still reaches it through a lazy dynamic import, so self-contained
+  bundles that never edit code continue not to ship the TypeScript compiler.
+
+- Updated dependencies [d1c6956]
+- Updated dependencies [56d6fde]
+  - @pikku/code-edit@0.12.1
+
+## 0.12.45
+
+### Patch Changes
+
+- 3c0012c: Gate console agent-thread reads and deletes on thread ownership, claim MongoDB workflow steps atomically, and reach the deployment fallback from `rpcWithWire`
+
+  `getAgentThreadMessages` and `deleteAgentThread` in the console addon took a
+  caller-supplied `threadId` straight to storage, while their siblings
+  `getAgentThreads` and `getAgentThreadRuns` already filtered to what the session
+  owns. Both now carry an `isThreadOwner` permission: an admin reaches any thread,
+  everyone else only their own, and a missing thread is refused rather than 404'd
+  so it is indistinguishable from someone else's.
+
+  `MongoDBWorkflowService` claimed a step by reading its status and then writing
+  it, under a `withStepLock` that is a pass-through — so two dispatches racing for
+  the same step could both proceed and run a side-effecting step twice. The claim
+  is now a single status-guarded update, atomic on one document.
+
+  `rpcWithWire` threw `RPCNotFoundError` for any unresolved namespaced call
+  instead of falling through to the deployment service, so a namespaced RPC that
+  `rpc()` would have dispatched remotely failed when called with an explicit wire.
+
+- 05e47cf: feat(virtual-user): make a run's history readable
+
+  There was no way to ask what the virtual users had been doing. The scaffold
+  generated a way to start a run and a way to read one back by id, and
+  `VirtualUserRunStore.list()` — which takes a persona filter — had no caller at
+  all. The console's Virtual Users screen was built entirely from static meta, so
+  it could say who a persona was and what they could reach, and nothing about
+  whether anybody had ever turned them loose.
+
+  The scaffold now also generates `listVirtualUserRuns` and
+  `getVirtualUserRunSteps`, both behind the existing `virtualUser:read` scope —
+  the transcript is strictly more sensitive than the summary it belongs to, since
+  it carries the live ids and payloads the run actually sent.
+
+  The console reads the same two things through the console addon
+  (`console:getVirtualUserRuns`, `console:getVirtualUserRunSteps`) off the host's
+  own `virtualUserRunStore`, under a new `pikku:console:virtualUsers:read` scope.
+  Going through the store rather than the scaffolded RPCs means a project's runs
+  show up whether or not it turned `scaffold.virtualUser` on — wiring the store is
+  all a run has ever needed. A host with no store answers with an empty list
+  rather than an error: it has no runs, which is a true answer.
+
+  Each persona now shows its recent runs under the declaration — status, when,
+  steps and mutations, findings, disposition and seed — and opening one fetches
+  its transcript. The steps are fetched only on open, because the history is read
+  far more often than any single run is.
+
+- 05e47cf: feat(virtual-user): put each persona on its own clock
+
+  A budget says where one run stops. Nothing said how often a persona should use
+  the application, so in practice each one ran whenever somebody remembered — and
+  what actually tells you about a product is the same user coming back over a
+  fortnight.
+
+  Each persona now gets a row rather than a bigger budget. `virtualUserSchedule`
+  holds `enabled`, the disposition and goals to run with, an interval **range**,
+  and `nextRunAt`. `tickVirtualUserSchedules` acts on whichever rows are due:
+
+  ```ts
+  wireScheduler({
+    name: 'virtualUsers',
+    schedule: '0 * * * *',
+    func: tickVirtualUserSchedules,
+  })
+  ```
+
+  The tick is generated and wired by nobody, deliberately. A scaffolded
+  `wireScheduler` would start spending an application's model budget the moment
+  somebody ran `pikku all`, on a host that may not run schedulers at all. Tick
+  resolution bounds how late a due persona is, never how often it runs.
+
+  Three things it does that are easy to leave out:
+
+  - The next due time is written **before** the run is dispatched, so a tick that
+    dies halfway cannot hand the same persona to the next one. A dispatch that
+    throws waits a full interval instead of retrying every minute for a week.
+    That write is a compare-and-set against the `nextRunAt` the tick read, so it
+    is also how a tick _wins_ the persona: two processes on the same cron see the
+    same due row, and only the one whose claim lands dispatches.
+  - A persona whose previous run is still `running` is skipped, not queued. Two
+    copies of the same user acting at once is a different test, and its findings
+    do not reproduce.
+  - A run still `running` after two hours is failed. Without that, one restart
+    mid-run blocks that persona's schedule permanently — which is where the
+    stranded-record cost of not using a queue finally gets paid.
+
+  Reschedule-on-completion was the other candidate and is worse in exactly one
+  way, fatally: a crash between finishing and scheduling ends the persona forever,
+  and the evidence is an absence.
+
+  New: `VirtualUserScheduleStore` in core (with the tick, `isDue` and `nextRunAt`
+  as pure functions), `KyselyVirtualUserScheduleStore` and its own schema —
+  its own rather than a third table in `virtualUserSchema`, and owned by its own
+  store, so a project that records runs and never wants them unattended carries no
+  cadence table. `scaffold.virtualUser` gains `setVirtualUserSchedule`,
+  `listVirtualUserSchedules` and the tick, behind a new `virtualUser:schedule`
+  scope: starting a run spends money once with a caller watching, while writing a
+  schedule spends it repeatedly with nobody there.
+
+  The console's Virtual Users screen gains a **Run now** button beside a persona's
+  run history, gated on `pikku:console:virtualUsers:run`. It dispatches the
+  project's own `runVirtualUser` rather than starting a run itself, so a run the
+  application would refuse — an acted-upon persona, a non-accountable disposition
+  in production — is still refused.
+
+- Updated dependencies [3c0012c]
+- Updated dependencies [05e47cf]
+- Updated dependencies [cfd364a]
+- Updated dependencies [05e47cf]
+- Updated dependencies [05e47cf]
+- Updated dependencies [05e47cf]
+  - @pikku/core@0.12.90
+
 ## 0.12.44
 
 ### Patch Changes

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * Subpath entry — `#pikku/agent` resolves here.

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

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 export type AgentMap = {}

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 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":"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"}
+{"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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 import { pikkuState } from '@pikku/core/state';
 pikkuState('@pikku/addon-console', 'agent', 'modelAliases', {});

package/dist/.pikku/addon/agent/pikku-scorer-names.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * The AI scorers declared in this project.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 export { pikkuBetterAuth } from '@pikku/better-auth';
 //# sourceMappingURL=auth.types.d.ts.map

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 // AUTO-GENERATED by pikku CLI (bootstrap stub) — replaced by the typed wrapper after inspection
 export { pikkuBetterAuth } from '@pikku/better-auth';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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,sBAAsB,CAAC,CAAA;AACrE,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,sBAAsB,CAAC,CAAA;AACrE,CAAC,CAAA"}

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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":"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"}

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * 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.109
+ * This file was generated by @pikku/cli@0.12.118
  */
 /**
  * Subpath entry — `#pikku/function` resolves here.