@pikku/addon-mindee 0.0.4 → 0.0.6

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

@@ -1,23 +1,28 @@
 /**
- * This file was generated by @pikku/cli@0.12.103
+ * This file was generated by @pikku/cli@0.12.111
  */
 /**
- * Core function, middleware, and permission types for all wirings
+ * Core function types for all wirings
  */
-import type { CorePikkuMiddleware, CorePermissionGroup, ListInput, ListOutput, PikkuWire, PickRequired, SecretlessServices } from '@pikku/core';
-import type { CorePikkuFunctionConfig, CorePikkuSessionlessFunctionConfig, CorePikkuAuth, CorePikkuAuthConfig, CorePikkuPermission } from '@pikku/core/function';
-import { CreateWireServices } from '@pikku/core/ecosystem';
+import type { PickRequired } from '@pikku/core/utils';
+import type { ListInput, ListOutput } from '@pikku/core/function';
+import type { CorePermissionGroup } from '@pikku/core/function';
+import type { PikkuWire, SecretlessServices } from '@pikku/core/types';
+import type { CorePikkuFunctionConfig, CorePikkuSessionlessFunctionConfig, CorePikkuPermission } from '@pikku/core/function';
 import type { NodeType } from '@pikku/core/node';
+import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.js';
+import type { PikkuPermission } from '../auth/pikku-auth-types.gen.js';
 import type { ScopeId } from '../scopes/pikku-scopes.gen.js';
+type CredentialsMap = Record<string, unknown>;
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function';
-import type { UserSession } from '../../types/application-types.d.js';
-import type { SingletonServices } from '../../types/application-types.d.js';
-import type { Services } from '../../types/application-types.d.js';
-import type { Config } from '../../types/application-types.d.js';
+import type { UserSession } from '../../../types/application-types.d.js';
+import type { SingletonServices } from '../../../types/application-types.d.js';
+import type { Services } from '../../../types/application-types.d.js';
 import type { TypedPikkuRPC, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
-import type { RequiredSingletonServices, RequiredWireServices } from '../pikku-services.gen.js';
-import type { TypedWorkflow, TypedScenario, TypedPersonas } from '../workflow/pikku-workflow-types.gen.js';
+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';
 export type { SingletonServices as SingletonServices };
 export type { Services as Services };
 export type Session = UserSession;
@@ -28,11 +33,19 @@ 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>;
-/** `WiredSingletonServices` without `secrets`, for auth gates. */
-export type WiredAuthServices = SecretlessServices<WiredSingletonServices>;
 /**
  * Inline node configuration for function definitions.
  */
@@ -42,162 +55,6 @@ export type NodeConfig = {
     type: NodeType;
     errorOutput?: boolean;
 };
-/**
- * Type-safe API permission definition that integrates with your application's session type.
- * Use this to define authorization logic for your API endpoints.
- *
- * @template In - The input type that the permission check will receive
- * @template RequiredServices - The services required for this permission check
- */
-export type PikkuPermission<In = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices> = CorePikkuPermission<In, RequiredServices, PikkuWire<In, never, false, Session>>;
-/**
- * Type-safe middleware definition that can access your application's services and session.
- * Use this to define reusable middleware that can be applied to multiple wirings.
- *
- * @template RequiredServices - The services required for this middleware
- */
-export type PikkuMiddleware<RequiredServices extends SingletonServices = WiredSingletonServices> = CorePikkuMiddleware<RequiredServices>;
-/**
- * Configuration object for creating a permission with metadata
- */
-export type PikkuPermissionConfig<In = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices> = {
-    /** The permission function */
-    func: PikkuPermission<In, RequiredServices>;
-    /** Optional human-readable name for the permission */
-    name?: string;
-    /** Optional description of what the permission checks */
-    description?: string;
-};
-/**
- * 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'
- *   }
- * })
- * ```
- */
-export declare const pikkuPermission: <In>(permission: PikkuPermission<In> | PikkuPermissionConfig<In>) => PikkuPermission<In>;
-/**
- * Type-safe auth-only permission that only needs services and session.
- * Use this for upfront authorization gates (MCP tools, AI agents, workflows)
- * where request data isn't available yet.
- *
- * @template RequiredServices - The services required for this auth check
- */
-export type PikkuAuth<RequiredServices extends SecretlessServices<SingletonServices> = WiredAuthServices> = CorePikkuAuth<RequiredServices, Session>;
-/**
- * Configuration object for creating an auth permission with metadata
- */
-export type PikkuAuthConfig<RequiredServices extends SecretlessServices<SingletonServices> = WiredAuthServices> = CorePikkuAuthConfig<RequiredServices, Session>;
-/**
- * Factory function for creating auth-only permissions with tree-shaking support.
- * Auth permissions only receive services and session (no request data),
- * making them evaluable before request data is available.
- *
- * @example
- * \`\`\`typescript
- * const isAuthenticated = pikkuAuth(async ({ logger }, session) => {
- *   return !!session
- * })
- *
- * const isAdmin = pikkuAuth({
- *   name: 'Admin Auth',
- *   description: 'Checks if user is an admin',
- *   func: async ({ logger }, session) => {
- *     return session?.role === 'admin'
- *   }
- * })
- * \`\`\`
- */
-export declare const pikkuAuth: <RequiredServices extends SecretlessServices<SingletonServices> = WiredAuthServices>(auth: PikkuAuth<RequiredServices> | PikkuAuthConfig<RequiredServices>) => PikkuPermission<any, any>;
-/**
- * Configuration object for creating middleware with metadata
- */
-export type PikkuMiddlewareConfig<RequiredServices extends SingletonServices = WiredSingletonServices> = {
-    /** The middleware function */
-    func: PikkuMiddleware<RequiredServices>;
-    /** Optional human-readable name for the middleware */
-    name?: string;
-    /** Optional description of what the middleware does */
-    description?: string;
-};
-/**
- * Factory function for creating middleware with tree-shaking support.
- * Supports both direct function and configuration object syntax.
- *
- * @example
- * ```typescript
- * // Direct function syntax
- * const middleware = pikkuMiddleware(({ logger }, wires, next) => {
- *   logger.info('Middleware executed')
- *   await next()
- * })
- *
- * // Configuration object syntax with metadata
- * const logMiddleware = pikkuMiddleware({
- *   name: 'Request Logger',
- *   description: 'Logs all incoming requests',
- *   func: async ({ logger }, wires, next) => {
- *     logger.info('Request started')
- *     await next()
- *   }
- * })
- * ```
- */
-export declare const pikkuMiddleware: <RequiredServices extends SingletonServices = WiredSingletonServices>(middleware: PikkuMiddleware<RequiredServices> | PikkuMiddlewareConfig<RequiredServices>) => PikkuMiddleware<RequiredServices>;
-/**
- * Factory function for creating middleware factories
- * Use this when your middleware needs configuration/input parameters
- *
- * @example
- * ```typescript
- * export const logMiddleware = pikkuMiddlewareFactory<LogOptions>(({
- *   message,
- *   level = 'info'
- * }) => {
- *   return pikkuMiddleware(async ({ logger }, next) => {
- *     logger[level](message)
- *     await next()
- *   })
- * })
- * ```
- */
-export declare const pikkuMiddlewareFactory: <In = any>(factory: (input: In) => PikkuMiddleware) => ((input: In) => PikkuMiddleware);
-/**
- * Factory function for creating permission factories
- * Use this when your permission needs configuration/input parameters
- *
- * @example
- * ```typescript
- * export const requireRole = pikkuPermissionFactory<{ role: string }>(({
- *   role
- * }) => {
- *   return pikkuPermission(async ({ logger }, data, { session }) => {
- *     if (!session || session.role !== role) {
- *       logger.warn(`Permission denied: required role '${role}'`)
- *       return false
- *     }
- *     return true
- *   })
- * })
- * ```
- */
-export declare const pikkuPermissionFactory: <In = any>(factory: (input: In) => PikkuPermission<any>) => ((input: In) => PikkuPermission<any>);
 /**
  * A function that generates a human-readable description of a pending approval action.
  * Used by AI agents to show meaningful approval prompts instead of raw tool arguments.
@@ -232,7 +89,7 @@ export declare const pikkuApprovalDescription: <In = unknown, RequiredServices e
  *   type vary with its return type and cost a `func` written against the
  *   `PikkuFunction | PikkuFunctionSessionless` union its contextual typing.
  */
-export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices, ScenarioOut = unknown> = CorePikkuFunctionSessionless<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, false, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario<ScenarioOut>, TypedPersonas>, RequiredWires>>;
+export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices, ScenarioOut = unknown> = CorePikkuFunctionSessionless<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, false, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario<ScenarioOut>, TypedPersonas, CredentialsMap>, RequiredWires>>;
 /**
  * A session-aware API function that requires user authentication.
  * Use this for protected endpoints that need access to user session data.
@@ -241,7 +98,7 @@ export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires ex
  * @template Out - The output type that the function returns
  * @template RequiredServices - Services required by this function
  */
-export type PikkuFunction<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = 'session', RequiredServices extends SecretlessServices<Services> = WiredServices> = CorePikkuFunction<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, true, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario, TypedPersonas>, RequiredWires>>;
+export type PikkuFunction<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = 'session', RequiredServices extends SecretlessServices<Services> = WiredServices> = CorePikkuFunction<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, true, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario, TypedPersonas, CredentialsMap>, RequiredWires>>;
 /**
  * Helper type to infer the output type from a Standard Schema
  */
@@ -254,12 +111,16 @@ export type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output>
  * @template Out - The output type
  * @template PikkuFunc - The function type (can be narrowed to PikkuFunction or PikkuFunctionSessionless)
  */
-export type PikkuFunctionConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunction<In, Out, RequiredWires, any> | PikkuFunctionSessionless<In, Out, RequiredWires, any, any> = PikkuFunction<In, Out, RequiredWires> | PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = CorePikkuFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema, ScopeId>;
+export type PikkuFunctionConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunction<In, Out, RequiredWires, any> | PikkuFunctionSessionless<In, Out, RequiredWires, any, any> = PikkuFunction<In, Out, RequiredWires> | PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema, ScopeId>, 'node'> & {
+    node?: NodeConfig;
+};
 /**
  * {@link PikkuFunctionConfig} for a function that runs without a session.
  * Has no `scopes`: an anonymous caller holds none, so none can ever be met.
  */
-export type PikkuFunctionSessionlessConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunctionSessionless<In, Out, RequiredWires, any> = PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = CorePikkuSessionlessFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema>;
+type PikkuFunctionSessionlessConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunctionSessionless<In, Out, RequiredWires, any> = PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema>, 'node'> & {
+    node?: NodeConfig;
+};
 /**
  * Configuration object for Pikku functions with Zod schema validation.
  * Use this when you want to define input/output schemas using Zod.
@@ -270,10 +131,11 @@ type SchemaInferred<S, Fallback = unknown> = S extends StandardSchemaV1 ? InferS
  * Schema-overload variant for pikkuFunc. Derived from CorePikkuFunctionConfig
  * so adding a field on the core type automatically propagates here.
  */
-export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuFunctionConfig<PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>, CorePikkuPermission<any>, PikkuMiddleware, undefined, undefined, ScopeId>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription'> & {
+type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuFunctionConfig<PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>, CorePikkuPermission<any>, PikkuMiddleware, undefined, undefined, ScopeId>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription' | 'node'> & {
     func: PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>;
     input?: InputSchema;
     output?: OutputSchema;
+    node?: NodeConfig;
     permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
     approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
 };
@@ -305,7 +167,6 @@ export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 |
  */
 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'>;
-export type PikkuListFunction<F extends Record<string, unknown> = {}, Row = unknown, S extends string = never> = PikkuFunction<ListInput<F, S>, ListOutput<Row>, 'session' | 'rpc'> | PikkuFunctionSessionless<ListInput<F, S>, ListOutput<Row>, 'session' | 'rpc'>;
 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.
@@ -315,10 +176,11 @@ export declare const pikkuListFunc: <F extends Record<string, unknown> = {}, Row
  * CorePikkuSessionlessFunctionConfig to stay in sync with the generic-typed
  * config — so it has no `scopes` either.
  */
-export type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription'> & {
+type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription' | 'node'> & {
     func: PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>;
     input?: InputSchema;
     output?: OutputSchema;
+    node?: NodeConfig;
     permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
     approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
 };
@@ -364,7 +226,7 @@ export declare function pikkuSessionlessFunc<In, Out = unknown, RequiredServices
  * })
  * ```
  */
-export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionSessionlessConfig<void, void, "session" | "rpc">) => PikkuFunctionSessionlessConfig<void, void, "rpc" | "session", PikkuFunctionSessionless<void, void, "rpc" | "session", WiredServices, unknown>, undefined, undefined>;
+export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionSessionlessConfig<void, void, "session" | "rpc">) => PikkuFunctionConfig<void, void, "session" | "rpc">;
 /**
  * References a registered function by name for use in any wiring.
  * Works for both local and addon functions — resolves via RPC at runtime.
@@ -402,90 +264,6 @@ export declare const ref: <Name extends keyof FlattenedRPCMap>(rpcName: Name) =>
  * ```
  */
 export declare function pikkuRemoteChannelFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: Omit<PikkuFunctionSessionlessConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>, 'func'>): PikkuFunctionConfig<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, 'session' | 'rpc'>;
-/**
- * Creates a Pikku config factory.
- * Use this to define your application's configuration factory.
- *
- * @param func - Config factory function that returns your application's config
- * @returns The config factory function
- *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
- */
-export declare const pikkuConfig: (func: (variables?: any, ...args: any[]) => Promise<Config>) => (variables?: any, ...args: any[]) => Promise<Config>;
-/**
- * Creates a Pikku singleton services factory.
- * Use this to define services that are created once and shared across all requests.
- *
- * @param func - Singleton services factory function
- * @returns The singleton services factory function
- *
- * @example
- * ```typescript
- * export const createSingletonServices = pikkuServices(async (config, existingServices) => {
- *   return {
- *     config,
- *     logger: new CustomLogger(),
- *     db: await createDatabaseConnection(config.dbUrl)
- *   }
- * })
- * ```
- */
-export declare const pikkuServices: (func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<Partial<Omit<RequiredSingletonServices, "auth">>>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
-/**
- * Creates a Pikku wire services factory.
- * Use this to define services that are created per-request/session.
- *
- * @param func - Wire services factory function
- * @returns The wire services factory function
- *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
- */
-export declare const pikkuWireServices: (func: (services: SingletonServices, wire: any) => Promise<RequiredWireServices>) => CreateWireServices;
-/**
- * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
- *
- * @example
- * addTagMiddleware('admin', [adminMiddleware])
- */
-export declare const addTagMiddleware: (tag: string, middleware: PikkuMiddleware[]) => void;
-/**
- * Wire-agnostic global middleware. Runs at the top of every wiring's
- * middleware chain — before wire-, tag-, and function-level entries.
- *
- * Resolution order: global -> wire -> tag -> function.
- *
- * @example
- * addGlobalMiddleware([telemetryMiddleware])
- */
-export declare const addGlobalMiddleware: (middleware: PikkuMiddleware[]) => void;
-/**
- * Wire-agnostic global permissions. Runs at the top of every wiring's
- * permission resolution — before wire-, tag-, and function-level entries.
- *
- * Resolution order: global -> wire -> tag -> function.
- *
- * @example
- * addGlobalPermission([signedInUser])
- */
-export declare const addGlobalPermission: <In = unknown>(permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => void;
-export { wireAddon, wireRemoteAddon } from '@pikku/core/rpc';
-export type { WireAddonConfig, WireRemoteAddonConfig, RemoteAddonAuth } from '@pikku/core/rpc';
 /**
  * Addon contract references. Generated from each wired addon's published
  * contract metadata — no addon source is imported. Functions are proxied via

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

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-function-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/function/pikku-function-types.gen.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,117 @@
+/**
+ * This file was generated by @pikku/cli@0.12.111
+ */
+/**
+ * Core function types for all wirings
+ */
+/**
+ * Factory function for creating approval description functions with tree-shaking support.
+ *
+ * @example
+ * ```typescript
+ * export const deleteTodoApproval = pikkuApprovalDescription(
+ *   async ({ todoStore }, { id }) => {
+ *     const todo = await todoStore.get(id)
+ *     return \`Delete todo: "${todo.title}"\`
+ *   }
+ * )
+ * ```
+ */
+export const pikkuApprovalDescription = (fn) => {
+    return fn;
+};
+export function pikkuFunc(func) {
+    return typeof func === 'function' ? { func } : func;
+}
+export const pikkuListFunc = (config) => {
+    return pikkuFunc(config);
+};
+export function pikkuSessionlessFunc(func) {
+    return typeof func === 'function' ? { func } : func;
+}
+/**
+ * Creates a function that takes no input and returns no output.
+ * Useful for health checks, triggers, or cleanup operations.
+ *
+ * @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')
+ * })
+ * ```
+ */
+export const pikkuVoidFunc = (func) => {
+    return typeof func === 'function' ? { func } : func;
+};
+/**
+ * References a registered function by name for use in any wiring.
+ * Works for both local and addon functions — resolves via RPC at runtime.
+ *
+ * @template Name - The function name (must be a key in FlattenedRPCMap)
+ * @param rpcName - The name of the function to reference
+ * @returns A Pikku function config that proxies calls via RPC
+ *
+ * @example
+ * ```typescript
+ * // Use in agent tools
+ * tools: [ref('todos:listTodos'), ref('myLocalFunc')]
+ *
+ * // Use in HTTP wiring
+ * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
+ * ```
+ */
+export const ref = (rpcName) => {
+    return {
+        func: async (_services, data, { rpc }) => {
+            return rpc.invoke(rpcName, data);
+        }
+    };
+};
+/**
+ * Declares a capability the connected client answers, reachable from any
+ * `wireChannel` function as `channel.remote(name, input)`.
+ *
+ * There is no `func`: this side owns the contract, the client owns the body.
+ * The `description` is what a person is shown when asked to approve the call,
+ * so write it for them rather than for the caller.
+ *
+ * @example
+ * ```typescript
+ * export const localCheckoutOutput = z.object({ sha: z.string(), branch: z.string() })
+ *
+ * export const localCheckout = pikkuRemoteChannelFunc({
+ *   description: 'Read the current commit and branch of your working tree',
+ *   output: localCheckoutOutput,
+ * })
+ * ```
+ */
+export function pikkuRemoteChannelFunc(config) {
+    return {
+        ...config,
+        func: async (_services, _data, _wire) => {
+            throw new Error(`${config.title ?? 'This'} is a remote channel capability and has no local implementation — reach it with channel.remote() on the channel whose client exposes it.`);
+        },
+    };
+}
+/**
+ * Addon contract references. Generated from each wired addon's published
+ * contract metadata — no addon source is imported. Functions are proxied via
+ * ref() (RPC) exactly like ref('namespace:fn').
+ */
+const __addonHttp = {};
+const __addonChannel = {};
+const __addonCli = {};
+export const refHTTP = (name, options) => {
+    const contract = __addonHttp[name];
+    return (options?.basePath !== undefined
+        ? { ...contract, basePath: options.basePath }
+        : contract);
+};
+export const refChannel = (name) => __addonChannel[name];
+export const refCLI = (name) => __addonCli[name];
+//# sourceMappingURL=pikku-function-types.gen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-function-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/function/pikku-function-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AA6EH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,EAAkD,EACF,EAAE;IAClD,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AA2KD,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAK3B,MAIC,EACyE,EAAE;IAC5E,OAAO,SAAS,CAAC,MAAM,CAAC,CAAA;AAC1B,CAAC,CAAA;AA0ED,MAAM,UAAU,oBAAoB,CAAC,IAAS;IAC5C,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAEiE,EACb,EAAE;IACtD,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,OAAa,EAKb,EAAE;IACF,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,SAAc,EAAE,IAAoC,EAAE,EAAE,GAAG,EAAO,EAAE,EAAE;YACjF,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAClC,CAAC;KAKF,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CAIpC,MAGC;IAED,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,KAAK,EAAE,SAAc,EAAE,KAAU,EAAE,KAAU,EAAE,EAAE;YACrD,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,0IAA0I,CACpK,CAAA;QACH,CAAC;KACK,CAAA;AACV,CAAC;AAKD;;;;GAIG;AACH,MAAM,WAAW,GAAG,EAAW,CAAA;AAC/B,MAAM,cAAc,GAAG,EAAW,CAAA;AAClC,MAAM,UAAU,GAAG,EAAW,CAAA;AAE9B,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,IAAU,EACV,OAA+B,EACH,EAAE;IAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAQ,CAAA;IACzC,OAAO,CACL,OAAO,EAAE,QAAQ,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;QAC7C,CAAC,CAAC,QAAQ,CACiB,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAAU,EACqB,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;AAExD,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,IAAU,EACiB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA"}