@pikku/addon-ollama 0.1.5 → 0.1.7

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.190
  */
 /**
  * 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.190
  */
 /**
  * Subpath entry — `#pikku/agent` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * 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.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 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.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { CoreAgent } from '@pikku/core/agent';
 import { pikkuAgentScorer as corePikkuAgentScorer, pikkuAgentJudge as corePikkuAgentJudge } from '@pikku/core/agent-scorer';
@@ -21,34 +21,75 @@ 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"];
+    result: AgentMap[Name]['output'];
     usage: {
         inputTokens: number;
         outputTokens: number;
     };
-}, "session" | "rpc">;
+}, '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">;
+}, 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">;
+}, 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: {
         toolCallId: string;
         approved: boolean;
     }[];
-}, unknown, "session" | "rpc">;
+}, unknown, 'session' | 'rpc'>;
 export {};
 //# sourceMappingURL=pikku-agent-types.gen.d.ts.map

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-agent-types.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { CoreAgent } from '@pikku/core/agent'
 import {
@@ -33,6 +33,12 @@ type AgentConfig<
   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 const pikkuAgent = <
   InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
@@ -42,16 +48,34 @@ export const pikkuAgent = <
   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: Parameters<typeof corePikkuAgentScorer<Services>>[0]
 ) => corePikkuAgentScorer<Services>(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: Parameters<typeof corePikkuAgentJudge<Services>>[0]
 ) => corePikkuAgentJudge<Services>(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 = <Name extends keyof AgentMap>(
   agentName: Name
 ) => {
@@ -62,6 +86,12 @@ export const agent = <Name extends keyof AgentMap>(
   >
 }
 
+/**
+ * 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 = <Name extends keyof AgentMap>(
   agentName?: Name
 ) => {
@@ -72,6 +102,12 @@ export const agentStream = <Name extends keyof AgentMap>(
   >
 }
 
+/**
+ * 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() as PikkuFunctionConfig<
     { runId: string; toolCallId: string; approved: boolean },
@@ -80,6 +116,11 @@ export const agentResume = () => {
   >
 }
 
+/**
+ * A ready-made function that answers every pending approval for a run at once.
+ *
+ * @example snippet: agentApproval
+ */
 export const agentApprove = <Name extends keyof AgentMap>(
   agentName: Name
 ) => {

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.190
  */
 import { pikkuState } from '@pikku/core/state';
 pikkuState('@pikku/addon-ollama', 'agent', 'modelAliases', {});

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { pikkuState } from '@pikku/core/state'
 

package/dist/.pikku/addon/agent/pikku-scorer-names.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.190
  */
 /**
  * The AI scorers declared in this project.

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

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/analytics` resolves here.
+ */
+export * from './pikku-analytics-types.gen.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/.pikku/addon/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/analytics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,gCAAgC,CAAA"}

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

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/analytics` resolves here.
+ */
+export * from './pikku-analytics-types.gen.js';
+//# sourceMappingURL=index.js.map

package/dist/.pikku/addon/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../.pikku/addon/analytics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,gCAAgC,CAAA"}

package/dist/.pikku/addon/analytics/index.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/analytics` resolves here.
+ */
+
+export * from './pikku-analytics-types.gen.js'

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

@@ -0,0 +1,6 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+export { defineAnalyticsEvents, fanOutAnalytics, cookieAnalyticsIdentity, composeAnalyticsIdentity, anonymousAnalyticsIdentity, mintCookie, randomDigits, LoggerAnalyticsService, } from '@pikku/core/analytics';
+export type { AnalyticsClientContext, AnalyticsEventBase, AnalyticsEventDefinitions, AnalyticsEventPropsSchema, AnalyticsIdentity, AnalyticsIdentityResolver, AnalyticsLog, AnalyticsRecord, AnalyticsService, AnalyticsSink, } from '@pikku/core/analytics';
+//# sourceMappingURL=pikku-analytics-types.gen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-analytics-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/analytics/pikku-analytics-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,UAAU,EACV,YAAY,EACZ,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,uBAAuB,CAAA"}

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

@@ -0,0 +1,5 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+export { defineAnalyticsEvents, fanOutAnalytics, cookieAnalyticsIdentity, composeAnalyticsIdentity, anonymousAnalyticsIdentity, mintCookie, randomDigits, LoggerAnalyticsService, } from '@pikku/core/analytics';
+//# sourceMappingURL=pikku-analytics-types.gen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-analytics-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/analytics/pikku-analytics-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,UAAU,EACV,YAAY,EACZ,sBAAsB,GACvB,MAAM,uBAAuB,CAAA"}

package/dist/.pikku/addon/analytics/pikku-analytics-types.gen.ts

@@ -0,0 +1,25 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+export {
+  defineAnalyticsEvents,
+  fanOutAnalytics,
+  cookieAnalyticsIdentity,
+  composeAnalyticsIdentity,
+  anonymousAnalyticsIdentity,
+  mintCookie,
+  randomDigits,
+  LoggerAnalyticsService,
+} from '@pikku/core/analytics'
+export type {
+  AnalyticsClientContext,
+  AnalyticsEventBase,
+  AnalyticsEventDefinitions,
+  AnalyticsEventPropsSchema,
+  AnalyticsIdentity,
+  AnalyticsIdentityResolver,
+  AnalyticsLog,
+  AnalyticsRecord,
+  AnalyticsService,
+  AnalyticsSink,
+} from '@pikku/core/analytics'

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.190
  */
 /**
  * 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.190
  */
 /**
  * Subpath entry — `#pikku/auth` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * 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.190
  */
 /**
  * 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,cACpB,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,QACpG,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,WACpC,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,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.190
  */
 /**
  * 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,qBAAqB,CAAC,CAAA;AACpE,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,qBAAqB,CAAC,CAAA;AACpE,CAAC,CAAA"}

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Permission, auth gate and credential definitions
@@ -19,11 +19,18 @@ import type {
   Session,
   SingletonServices,
   WiredServices,
-  WiredSingletonServices,
 } 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>
 
@@ -52,24 +59,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 const pikkuPermission = <In>(
   permission: PikkuPermission<In> | PikkuPermissionConfig<In>

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.190
  */
 /**
  * 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.190
  */
 /**
  * Subpath entry — `#pikku/channel` resolves here.

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

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