@pikku/addon-ollama 0.1.0 → 0.1.2

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

@@ -1,12 +1,12 @@
 /**
- * This file was generated by @pikku/cli@0.12.1
+ * This file was generated by @pikku/cli@0.12.55
  */
 /**
  * Core function, middleware, and permission types for all wirings
  */
-import { addMiddleware as addMiddlewareCore, addPermission as addPermissionCore } from '@pikku/core';
+import { pikkuAuth as pikkuAuthCore } from '@pikku/core/function';
+import { addTagMiddleware as addTagMiddlewareCore, addGlobalMiddleware as addGlobalMiddlewareCore, addTagPermission as addTagPermissionCore, addGlobalPermission as addGlobalPermissionCore, } from '@pikku/core/middleware';
 import { pikkuState as __pikkuState } from '@pikku/core/internal';
-import { pikkuAuth as pikkuAuthCore } from '@pikku/core';
 /**
  * Factory function for creating permissions with tree-shaking support.
  * Supports both direct function and configuration object syntax.
@@ -124,9 +124,28 @@ export const pikkuMiddlewareFactory = (factory) => {
 export const pikkuPermissionFactory = (factory) => {
     return factory;
 };
+/**
+ * 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;
 }
@@ -150,27 +169,23 @@ export const pikkuVoidFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
 };
 /**
- * Creates a wrapper function for addon package functions that are exposed via RPC.
- * This allows you to wire addon functions to any wiring type (HTTP, queue, etc.)
- * without type compatibility issues.
+ * 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 RPC method name (must be a key in FlattenedRPCMap)
- * @param rpcName - The name of the RPC method to invoke
- * @returns A Pikku function that proxies calls to the addon RPC method
+ * @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
- * // Wire an addon function via HTTP
- * wireHTTP({
- *   auth: false,
- *   method: 'get',
- *   route: '/addon/hello',
- *   func: addon('ext:hello'),
- *   tags: ['addon'],
- * })
+ * // Use in agent tools
+ * tools: [ref('todos:listTodos'), ref('myLocalFunc')]
+ *
+ * // Use in HTTP wiring
+ * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
  * ```
  */
-export const addon = (rpcName) => {
+export const ref = (rpcName) => {
     return {
         func: async (_services, data, { rpc }) => {
             return rpc.invoke(rpcName, data);
@@ -215,9 +230,24 @@ export const pikkuConfig = (func) => func;
  */
 export const pikkuServices = (func) => {
     return async (config, existingServices = {}) => {
-        const services = await func(config, existingServices);
-        __pikkuState(null, 'package', 'singletonServices', services);
-        return services;
+        const createdServices = await func(config, existingServices);
+        const services = { ...existingServices, ...createdServices };
+        const authFactory = __pikkuState(null, 'package', 'authFactory');
+        if (authFactory) {
+            let authInstance;
+            services.auth = () => {
+                authInstance ??= Promise.resolve()
+                    .then(() => authFactory(services))
+                    .catch((error) => {
+                    authInstance = undefined;
+                    throw error;
+                });
+                return authInstance;
+            };
+        }
+        const resolved = services;
+        __pikkuState(null, 'package', 'singletonServices', resolved);
+        return resolved;
     };
 };
 /**
@@ -243,56 +273,62 @@ export const pikkuWireServices = (func) => {
     return func;
 };
 /**
- * Adds global middleware for a specific tag.
- *
- * This function allows you to register middleware that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
- *
- * @param tag - The tag that the middleware should apply to.
- * @param middleware - The middleware array to apply for the specified tag.
- *
- * @throws Error if middleware for the tag already exists.
+ * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin middleware for admin endpoints
- * addMiddleware('admin', [adminMiddleware])
- *
- * // Add authentication middleware for auth endpoints
- * addMiddleware('auth', [authMiddleware])
- *
- * // Add logging middleware for all API endpoints
- * addMiddleware('api', [loggingMiddleware])
- * ```
+ * addTagMiddleware('admin', [adminMiddleware])
  */
-export const addMiddleware = (tag, middleware) => {
-    addMiddlewareCore(tag, middleware, '@pikku/addon-ollama');
+export const addTagMiddleware = (tag, middleware) => {
+    addTagMiddlewareCore(tag, middleware, '@pikku/addon-ollama');
 };
 /**
- * Adds global permissions for a specific tag.
+ * Wire-agnostic global middleware. Runs at the top of every wiring's
+ * middleware chain — before wire-, tag-, and function-level entries.
  *
- * This function allows you to register permissions that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
+ * Resolution order: global -> wire -> tag -> function.
  *
- * @param tag - The tag that the permissions should apply to.
- * @param permissions - The permissions array or object to apply for the specified tag.
- *
- * @throws Error if permissions for the tag already exist.
+ * @example
+ * addGlobalMiddleware([telemetryMiddleware])
+ */
+export const addGlobalMiddleware = (middleware) => {
+    addGlobalMiddlewareCore(middleware, '@pikku/addon-ollama');
+};
+/**
+ * Tag-scoped permissions. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin permissions for admin endpoints
- * addPermission('admin', [adminPermission])
+ * addTagPermission('admin', [adminPermission])
+ */
+export const addTagPermission = (tag, permissions) => {
+    addTagPermissionCore(tag, permissions, '@pikku/addon-ollama');
+};
+/**
+ * Wire-agnostic global permissions. Runs at the top of every wiring's
+ * permission resolution — before wire-, tag-, and function-level entries.
  *
- * // Add authentication permissions for auth endpoints
- * addPermission('auth', [authPermission])
+ * Resolution order: global -> wire -> tag -> function.
  *
- * // Add read permissions for all API endpoints (as object)
- * addPermission('api', { read: readPermission })
- * ```
+ * @example
+ * addGlobalPermission([signedInUser])
+ */
+export const addGlobalPermission = (permissions) => {
+    addGlobalPermissionCore(permissions, '@pikku/addon-ollama');
+};
+export { wireAddon } 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
+ * ref() (RPC) exactly like ref('namespace:fn').
  */
-export const addPermission = (tag, permissions) => {
-    addPermissionCore(tag, permissions, '@pikku/addon-ollama');
+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 { wireAddon } from '@pikku/core';
+export const refChannel = (name) => __addonChannel[name];
+export const refCLI = (name) => __addonCli[name];
 //# sourceMappingURL=pikku-function-types.gen.js.map

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

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

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

@@ -1,13 +1,20 @@
 /**
- * This file was generated by @pikku/cli@0.12.1
+ * This file was generated by @pikku/cli@0.12.55
  */
 /**
  * Core function, middleware, and permission types for all wirings
  */
 
-import { CorePikkuFunctionConfig, CorePikkuAuth, CorePikkuAuthConfig, CorePikkuPermission, CorePikkuMiddleware, CorePermissionGroup, addMiddleware as addMiddlewareCore, addPermission as addPermissionCore, PikkuWire, PickRequired } from '@pikku/core'
+import type { CorePikkuMiddleware, CorePermissionGroup, ListInput, ListOutput, PikkuWire, PickRequired } from '@pikku/core'
+import type { CorePikkuFunctionConfig, CorePikkuAuth, CorePikkuAuthConfig, CorePikkuPermission } from '@pikku/core/function'
+import { pikkuAuth as pikkuAuthCore } from '@pikku/core/function'
+import {
+  addTagMiddleware as addTagMiddlewareCore,
+  addGlobalMiddleware as addGlobalMiddlewareCore,
+  addTagPermission as addTagPermissionCore,
+  addGlobalPermission as addGlobalPermissionCore,
+} from '@pikku/core/middleware'
 import { pikkuState as __pikkuState, CreateWireServices } from '@pikku/core/internal'
-import { pikkuAuth as pikkuAuthCore } from '@pikku/core'
 import type { NodeType } from '@pikku/core/node'
 import type { StandardSchemaV1 } from '@standard-schema/spec'
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function'
@@ -222,6 +229,37 @@ export const pikkuPermissionFactory = <In = any>(
   return factory
 }
 
+/**
+ * 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.
+ *
+ * @template In - The input type (same as the function it describes)
+ * @template RequiredServices - The services required for this description function
+ */
+export type PikkuApprovalDescription<In = unknown, RequiredServices extends Services = Services> = (
+  services: RequiredServices,
+  data: In
+) => Promise<string>
+
+/**
+ * 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 = <In = unknown, RequiredServices extends Services = Services>(
+  fn: PikkuApprovalDescription<In, RequiredServices>
+): PikkuApprovalDescription<In, RequiredServices> => {
+  return fn
+}
+
 /**
  * A sessionless API function that doesn't require user authentication.
  * Use this for public endpoints, health checks, or operations that don't need user context.
@@ -291,31 +329,36 @@ export type PikkuFunctionConfig<
  * Use this when you want to define input/output schemas using Zod.
  * Types are automatically inferred from the schemas.
  */
+type SchemaInferred<S, Fallback = unknown> = S extends StandardSchemaV1
+  ? InferSchemaOutput<S>
+  : Fallback
+
+/**
+ * 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,
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined,
   RequiredWires extends keyof PikkuWire = never
-> = {
-  name?: string
-  tags?: string[]
-  expose?: boolean
-  mcp?: boolean
-  internal?: boolean
-  func: PikkuFunction<
-    InferSchemaOutput<InputSchema>,
-    OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
-    RequiredWires
-  > | PikkuFunctionSessionless<
-    InferSchemaOutput<InputSchema>,
-    OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
-    RequiredWires
-  >
-  auth?: boolean
-  permissions?: CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>
-  middleware?: PikkuMiddleware[]
-  input: InputSchema
+> = Omit<
+  CorePikkuFunctionConfig<
+    | PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>
+    | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>
+  >,
+  'func' | 'input' | 'output' | 'permissions' | 'approvalDescription'
+> & {
+  func:
+    | PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>
+    | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>
+  input?: InputSchema
   output?: OutputSchema
-  node?: NodeConfig
+  permissions?: InputSchema extends StandardSchemaV1
+    ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>
+    : undefined
+  approvalDescription?: InputSchema extends StandardSchemaV1
+    ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>>
+    : never
 }
 
 /**
@@ -357,11 +400,11 @@ export type PikkuFunctionConfigWithSchema<
  * ```
  */
 export function pikkuFunc<
-  InputSchema extends StandardSchemaV1,
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
 >(
   config: PikkuFunctionConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>
-): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>
+): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>
 export function pikkuFunc<In, Out = unknown>(
   func:
     | PikkuFunction<In, Out, 'session' | 'rpc'>
@@ -371,32 +414,62 @@ export function pikkuFunc(func: any) {
   return typeof func === 'function' ? { func } : func
 }
 
+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 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'> => {
+  return pikkuFunc(config)
+}
+
 /**
  * Configuration object for sessionless Pikku functions with Zod schema validation.
  */
+/**
+ * Schema-overload variant for pikkuSessionlessFunc. Derived from
+ * CorePikkuFunctionConfig to stay in sync with the generic-typed config.
+ */
 export type PikkuFunctionSessionlessConfigWithSchema<
-  InputSchema extends StandardSchemaV1,
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined,
   RequiredWires extends keyof PikkuWire = never
-> = {
-  name?: string
-  description?: string
-  tags?: string[]
-  expose?: boolean
-  mcp?: boolean
-  internal?: boolean
-  remote?: boolean
+> = Omit<
+  CorePikkuFunctionConfig<
+    PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>
+  >,
+  'func' | 'input' | 'output' | 'permissions' | 'approvalDescription'
+> & {
   func: PikkuFunctionSessionless<
-    InferSchemaOutput<InputSchema>,
-    OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
+    SchemaInferred<InputSchema>,
+    SchemaInferred<OutputSchema>,
     RequiredWires
   >
-  auth?: boolean
-  permissions?: CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>
-  middleware?: PikkuMiddleware[]
-  input: InputSchema
+  input?: InputSchema
   output?: OutputSchema
-  node?: NodeConfig
+  permissions?: InputSchema extends StandardSchemaV1
+    ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>
+    : undefined
+  approvalDescription?: InputSchema extends StandardSchemaV1
+    ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>>
+    : never
 }
 
 /**
@@ -435,11 +508,11 @@ export type PikkuFunctionSessionlessConfigWithSchema<
  * ```
  */
 export function pikkuSessionlessFunc<
-  InputSchema extends StandardSchemaV1,
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
 >(
   config: PikkuFunctionSessionlessConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>
-): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>
+): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>
 export function pikkuSessionlessFunc<In, Out = unknown>(
   func:
     | PikkuFunctionSessionless<In, Out, 'session' | 'rpc'>
@@ -474,27 +547,23 @@ export const pikkuVoidFunc = (
 }
 
 /**
- * Creates a wrapper function for addon package functions that are exposed via RPC.
- * This allows you to wire addon functions to any wiring type (HTTP, queue, etc.)
- * without type compatibility issues.
+ * 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 RPC method name (must be a key in FlattenedRPCMap)
- * @param rpcName - The name of the RPC method to invoke
- * @returns A Pikku function that proxies calls to the addon RPC method
+ * @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
- * // Wire an addon function via HTTP
- * wireHTTP({
- *   auth: false,
- *   method: 'get',
- *   route: '/addon/hello',
- *   func: addon('ext:hello'),
- *   tags: ['addon'],
- * })
+ * // Use in agent tools
+ * tools: [ref('todos:listTodos'), ref('myLocalFunc')]
+ *
+ * // Use in HTTP wiring
+ * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
  * ```
  */
-export const addon = <Name extends keyof FlattenedRPCMap>(
+export const ref = <Name extends keyof FlattenedRPCMap>(
   rpcName: Name
 ): PikkuFunctionConfig<
   FlattenedRPCMap[Name]['input'],
@@ -553,12 +622,27 @@ export const pikkuConfig = (
  * ```
  */
 export const pikkuServices = (
-  func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<RequiredSingletonServices>
+  func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<Partial<Omit<RequiredSingletonServices, 'auth'>>>
 ) => {
   return async (config: Config, existingServices: Partial<SingletonServices> = {}) => {
-    const services = await func(config, existingServices)
-    __pikkuState(null, 'package', 'singletonServices', services as any)
-    return services
+    const createdServices = await func(config, existingServices)
+    const services = { ...existingServices, ...createdServices }
+    const authFactory = __pikkuState(null, 'package', 'authFactory')
+    if (authFactory) {
+      let authInstance: Promise<unknown> | undefined
+      ;(services as any).auth = () => {
+        authInstance ??= Promise.resolve()
+          .then(() => authFactory(services as any))
+          .catch((error) => {
+            authInstance = undefined
+            throw error
+          })
+        return authInstance
+      }
+    }
+    const resolved = services as RequiredSingletonServices
+    __pikkuState(null, 'package', 'singletonServices', resolved as any)
+    return resolved
   }
 }
 
@@ -591,58 +675,80 @@ export const pikkuWireServices = (
 }
 
 /**
- * Adds global middleware for a specific tag.
- *
- * This function allows you to register middleware that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
- *
- * @param tag - The tag that the middleware should apply to.
- * @param middleware - The middleware array to apply for the specified tag.
- *
- * @throws Error if middleware for the tag already exists.
+ * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin middleware for admin endpoints
- * addMiddleware('admin', [adminMiddleware])
- *
- * // Add authentication middleware for auth endpoints
- * addMiddleware('auth', [authMiddleware])
- *
- * // Add logging middleware for all API endpoints
- * addMiddleware('api', [loggingMiddleware])
- * ```
+ * addTagMiddleware('admin', [adminMiddleware])
  */
-export const addMiddleware = (tag: string, middleware: PikkuMiddleware[]) => {
-  addMiddlewareCore(tag, middleware as any, '@pikku/addon-ollama')
+export const addTagMiddleware = (tag: string, middleware: PikkuMiddleware[]) => {
+  addTagMiddlewareCore(tag, middleware as any, '@pikku/addon-ollama')
 }
 
 /**
- * Adds global permissions for a specific tag.
+ * Wire-agnostic global middleware. Runs at the top of every wiring's
+ * middleware chain — before wire-, tag-, and function-level entries.
  *
- * This function allows you to register permissions that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
+ * Resolution order: global -> wire -> tag -> function.
  *
- * @param tag - The tag that the permissions should apply to.
- * @param permissions - The permissions array or object to apply for the specified tag.
- *
- * @throws Error if permissions for the tag already exist.
+ * @example
+ * addGlobalMiddleware([telemetryMiddleware])
+ */
+export const addGlobalMiddleware = (middleware: PikkuMiddleware[]) => {
+  addGlobalMiddlewareCore(middleware as any, '@pikku/addon-ollama')
+}
+
+/**
+ * Tag-scoped permissions. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin permissions for admin endpoints
- * addPermission('admin', [adminPermission])
+ * addTagPermission('admin', [adminPermission])
+ */
+export const addTagPermission = <In = unknown>(tag: string, permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => {
+  addTagPermissionCore(tag, permissions as any, '@pikku/addon-ollama')
+}
+
+/**
+ * Wire-agnostic global permissions. Runs at the top of every wiring's
+ * permission resolution — before wire-, tag-, and function-level entries.
  *
- * // Add authentication permissions for auth endpoints
- * addPermission('auth', [authPermission])
+ * Resolution order: global -> wire -> tag -> function.
  *
- * // Add read permissions for all API endpoints (as object)
- * addPermission('api', { read: readPermission })
- * ```
+ * @example
+ * addGlobalPermission([signedInUser])
+ */
+export const addGlobalPermission = <In = unknown>(permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => {
+  addGlobalPermissionCore(permissions as any, '@pikku/addon-ollama')
+}
+
+export { wireAddon } from '@pikku/core/rpc'
+export type { WireAddonConfig } 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
+ * ref() (RPC) exactly like ref('namespace:fn').
  */
-export const addPermission = <In = unknown>(tag: string, permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => {
-  addPermissionCore(tag, permissions as any, '@pikku/addon-ollama')
+const __addonHttp = {} as const
+const __addonChannel = {} as const
+const __addonCli = {} as const
+
+export const refHTTP = <Name extends keyof typeof __addonHttp>(
+  name: Name,
+  options?: { basePath?: string }
+): (typeof __addonHttp)[Name] => {
+  const contract = __addonHttp[name] as any
+  return (
+    options?.basePath !== undefined
+      ? { ...contract, basePath: options.basePath }
+      : contract
+  ) as (typeof __addonHttp)[Name]
 }
 
-export { wireAddon } from '@pikku/core'
-export type { WireAddonConfig } from '@pikku/core'
+export const refChannel = <Name extends keyof typeof __addonChannel>(
+  name: Name
+): (typeof __addonChannel)[Name] => __addonChannel[name]
+
+export const refCLI = <Name extends keyof typeof __addonCli>(
+  name: Name
+): (typeof __addonCli)[Name] => __addonCli[name]