@pikku/cli 0.9.15 → 0.9.16-next.0

package/.pikku/function/pikku-functions-meta.min.gen.ts

@@ -0,0 +1,176 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+import { pikkuState } from '@pikku/core'
+pikkuState('function', 'meta', {
+  "all": {
+    "pikkuFuncName": "all",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "watch": {
+    "pikkuFuncName": "watch",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuNext": {
+    "pikkuFuncName": "pikkuNext",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuChannels": {
+    "pikkuFuncName": "pikkuChannels",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuChannelsOutput"
+  },
+  "pikkuChannelTypes": {
+    "pikkuFuncName": "pikkuChannelTypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuChannelsMap": {
+    "pikkuFuncName": "pikkuChannelsMap",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuWebSocketTyped": {
+    "pikkuFuncName": "pikkuWebSocketTyped",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuCLIEntry": {
+    "pikkuFuncName": "pikkuCLIEntry",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuCLITypes": {
+    "pikkuFuncName": "pikkuCLITypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuCLI": {
+    "pikkuFuncName": "pikkuCLI",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuCLIOutput"
+  },
+  "pikkuFetch": {
+    "pikkuFuncName": "pikkuFetch",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuFunctionTypesSplit": {
+    "pikkuFuncName": "pikkuFunctionTypesSplit",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuFunctionTypes": {
+    "pikkuFuncName": "pikkuFunctionTypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuFunctions": {
+    "pikkuFuncName": "pikkuFunctions",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuFunctionsOutput"
+  },
+  "pikkuServices": {
+    "pikkuFuncName": "pikkuServices",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuSchemas": {
+    "pikkuFuncName": "pikkuSchemas",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuSchemasOutput"
+  },
+  "pikkuMCPJSON": {
+    "pikkuFuncName": "pikkuMCPJSON",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuMCPTypes": {
+    "pikkuFuncName": "pikkuMCPTypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuMCP": {
+    "pikkuFuncName": "pikkuMCP",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuMCPOutput"
+  },
+  "pikkuHTTPMap": {
+    "pikkuFuncName": "pikkuHTTPMap",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuHTTP": {
+    "pikkuFuncName": "pikkuHTTP",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuHTTPOutput"
+  },
+  "pikkuHTTPTypes": {
+    "pikkuFuncName": "pikkuHTTPTypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuOpenAPI": {
+    "pikkuFuncName": "pikkuOpenAPI",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuMiddleware": {
+    "pikkuFuncName": "pikkuMiddleware",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuMiddlewareOutput"
+  },
+  "pikkuRPCClient": {
+    "pikkuFuncName": "pikkuRPCClient",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuRPCInternalMap": {
+    "pikkuFuncName": "pikkuRPCInternalMap",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuRPCExposedMap": {
+    "pikkuFuncName": "pikkuRPCExposedMap",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuRPC": {
+    "pikkuFuncName": "pikkuRPC",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuRPCOutput"
+  },
+  "pikkuQueueMap": {
+    "pikkuFuncName": "pikkuQueueMap",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuQueueService": {
+    "pikkuFuncName": "pikkuQueueService",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuQueueTypes": {
+    "pikkuFuncName": "pikkuQueueTypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuQueue": {
+    "pikkuFuncName": "pikkuQueue",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuSchedulerTypes": {
+    "pikkuFuncName": "pikkuSchedulerTypes",
+    "inputSchemaName": null,
+    "outputSchemaName": null
+  },
+  "pikkuScheduler": {
+    "pikkuFuncName": "pikkuScheduler",
+    "inputSchemaName": null,
+    "outputSchemaName": "PikkuSchedulerOutput"
+  }
+})

package/.pikku/function/pikku-functions.gen.ts

@@ -0,0 +1,74 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/* Import and register functions used by RPCs */
+import { addFunction } from '@pikku/core'
+import { all } from '../../src/functions/commands/all.js'
+import { pikkuChannels } from '../../src/functions/wirings/channels/pikku-command-channels.js'
+import { pikkuChannelsMap } from '../../src/functions/wirings/channels/pikku-command-channels-map.js'
+import { pikkuChannelTypes } from '../../src/functions/wirings/channels/pikku-command-channel-types.js'
+import { pikkuCLI } from '../../src/functions/wirings/cli/pikku-command-cli.js'
+import { pikkuCLIEntry } from '../../src/functions/wirings/cli/pikku-command-cli-entry.js'
+import { pikkuCLITypes } from '../../src/functions/wirings/cli/pikku-command-cli-types.js'
+import { pikkuFetch } from '../../src/functions/wirings/fetch/index.js'
+import { pikkuFunctions } from '../../src/functions/wirings/functions/pikku-command-functions.js'
+import { pikkuFunctionTypes } from '../../src/functions/wirings/functions/pikku-function-types.js'
+import { pikkuFunctionTypesSplit } from '../../src/functions/wirings/functions/pikku-command-function-types-split.js'
+import { pikkuHTTP } from '../../src/functions/wirings/http/pikku-http-routes.js'
+import { pikkuHTTPMap } from '../../src/functions/wirings/http/pikku-command-http-map.js'
+import { pikkuHTTPTypes } from '../../src/functions/wirings/http/pikku-command-http-types.js'
+import { pikkuMCP } from '../../src/functions/wirings/mcp/pikku-command-mcp.js'
+import { pikkuMCPJSON } from '../../src/functions/wirings/mcp/pikku-command-mcp-json.js'
+import { pikkuMCPTypes } from '../../src/functions/wirings/mcp/pikku-command-mcp-types.js'
+import { pikkuMiddleware } from '../../src/functions/wirings/middleware/pikku-command-middleware.js'
+import { pikkuNext } from '../../src/functions/runtimes/nextjs/pikku-command-nextjs.js'
+import { pikkuOpenAPI } from '../../src/functions/wirings/http/pikku-command-openapi.js'
+import { pikkuQueue } from '../../src/functions/wirings/queue/pikku-queue.js'
+import { pikkuQueueMap } from '../../src/functions/wirings/queue/pikku-queue-map.js'
+import { pikkuQueueService } from '../../src/functions/wirings/queue/pikku-command-queue-service.js'
+import { pikkuQueueTypes } from '../../src/functions/wirings/queue/pikku-command-queue-types.js'
+import { pikkuRPC } from '../../src/functions/wirings/rpc/pikku-command-rpc.js'
+import { pikkuRPCClient } from '../../src/functions/wirings/rpc/pikku-command-rpc-client.js'
+import { pikkuRPCExposedMap } from '../../src/functions/wirings/rpc/pikku-command-rpc-map.js'
+import { pikkuRPCInternalMap } from '../../src/functions/wirings/rpc/pikku-command-rpc-map.js'
+import { pikkuScheduler } from '../../src/functions/wirings/scheduler/pikku-command-scheduler.js'
+import { pikkuSchedulerTypes } from '../../src/functions/wirings/scheduler/pikku-command-scheduler-types.js'
+import { pikkuSchemas } from '../../src/functions/wirings/functions/schemas.js'
+import { pikkuServices } from '../../src/functions/wirings/functions/pikku-command-services.js'
+import { pikkuWebSocketTyped } from '../../src/functions/wirings/channels/pikku-command-websocket-typed.js'
+import { watch } from '../../src/functions/commands/watch.js'
+
+addFunction('all', all)
+addFunction('pikkuChannels', pikkuChannels)
+addFunction('pikkuChannelsMap', pikkuChannelsMap)
+addFunction('pikkuChannelTypes', pikkuChannelTypes)
+addFunction('pikkuCLI', pikkuCLI)
+addFunction('pikkuCLIEntry', pikkuCLIEntry)
+addFunction('pikkuCLITypes', pikkuCLITypes)
+addFunction('pikkuFetch', pikkuFetch)
+addFunction('pikkuFunctions', pikkuFunctions)
+addFunction('pikkuFunctionTypes', pikkuFunctionTypes)
+addFunction('pikkuFunctionTypesSplit', pikkuFunctionTypesSplit)
+addFunction('pikkuHTTP', pikkuHTTP)
+addFunction('pikkuHTTPMap', pikkuHTTPMap)
+addFunction('pikkuHTTPTypes', pikkuHTTPTypes)
+addFunction('pikkuMCP', pikkuMCP)
+addFunction('pikkuMCPJSON', pikkuMCPJSON)
+addFunction('pikkuMCPTypes', pikkuMCPTypes)
+addFunction('pikkuMiddleware', pikkuMiddleware)
+addFunction('pikkuNext', pikkuNext)
+addFunction('pikkuOpenAPI', pikkuOpenAPI)
+addFunction('pikkuQueue', pikkuQueue)
+addFunction('pikkuQueueMap', pikkuQueueMap)
+addFunction('pikkuQueueService', pikkuQueueService)
+addFunction('pikkuQueueTypes', pikkuQueueTypes)
+addFunction('pikkuRPC', pikkuRPC)
+addFunction('pikkuRPCClient', pikkuRPCClient)
+addFunction('pikkuRPCExposedMap', pikkuRPCExposedMap)
+addFunction('pikkuRPCInternalMap', pikkuRPCInternalMap)
+addFunction('pikkuScheduler', pikkuScheduler)
+addFunction('pikkuSchedulerTypes', pikkuSchedulerTypes)
+addFunction('pikkuSchemas', pikkuSchemas)
+addFunction('pikkuServices', pikkuServices)
+addFunction('pikkuWebSocketTyped', pikkuWebSocketTyped)
+addFunction('watch', watch)

package/.pikku/http/pikku-http-types.gen.ts

@@ -0,0 +1,61 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This file was generated by the @pikku/cli
+ * HTTP-specific type definitions for tree-shaking optimization
+ */
+
+import { AssertHTTPWiringParams, wireHTTP as wireHTTPCore, addHTTPMiddleware as addHTTPMiddlewareCore } from '@pikku/core/http'
+import type { PikkuFunction, PikkuFunctionSessionless, PikkuPermission, PikkuMiddleware } from '../function/pikku-function-types.gen.js'
+import type { CoreHTTPFunctionWiring } from '@pikku/core/http'
+
+/**
+ * Type definition for HTTP API wirings with type-safe path parameters.
+ * Supports both authenticated and unauthenticated functions.
+ *
+ * @template In - Input type for the HTTP wiring
+ * @template Out - Output type for the HTTP wiring
+ * @template Route - String literal type for the HTTP path (e.g., "/users/:id")
+ */
+type HTTPWiring<In, Out, Route extends string> = CoreHTTPFunctionWiring<In, Out, Route, PikkuFunction<In, Out>, PikkuFunctionSessionless<In, Out>, PikkuPermission<In>, PikkuMiddleware>
+
+/**
+ * Registers an HTTP wiring with the Pikku framework.
+ *
+ * @template In - Input type for the HTTP wiring
+ * @template Out - Output type for the HTTP wiring
+ * @template Route - String literal type for the HTTP path (e.g., "/users/:id")
+ * @param httpWiring - HTTP wiring definition with handler, method, and optional middleware
+ */
+export const wireHTTP = <In, Out, Route extends string>(
+  httpWiring: HTTPWiring<In, Out, Route> & AssertHTTPWiringParams<In, Route>
+) => {
+  wireHTTPCore(httpWiring as any)
+}
+
+/**
+ * Registers HTTP middleware either globally or for a specific route pattern.
+ *
+ * When a string route pattern is provided along with middleware, the middleware
+ * is applied only to that route. Otherwise, if an array is provided, it is treated
+ * as global middleware (applied to all routes).
+ *
+ * @param routeOrMiddleware - Either a global middleware array or a route pattern string
+ * @param middleware - The middleware array to apply when a route pattern is specified
+ *
+ * @example
+ * ```typescript
+ * // Add global HTTP middleware
+ * addHTTPMiddleware([authMiddleware, loggingMiddleware])
+ *
+ * // Add route-specific middleware
+ * addHTTPMiddleware('/api/admin/*', [adminAuthMiddleware])
+ * ```
+ */
+export const addHTTPMiddleware = (
+  routeOrMiddleware: PikkuMiddleware[] | string,
+  middleware?: PikkuMiddleware[]
+) => {
+  addHTTPMiddlewareCore(routeOrMiddleware as any, middleware as any)
+}

package/.pikku/mcp/pikku-mcp-types.gen.ts

@@ -0,0 +1,138 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This file was generated by the @pikku/cli
+ * MCP-specific type definitions for tree-shaking optimization
+ */
+
+import {
+  CoreMCPResource,
+  CoreMCPTool,
+  CoreMCPPrompt,
+  wireMCPResource as wireMCPResourceCore,
+  wireMCPTool as wireMCPToolCore,
+  wireMCPPrompt as wireMCPPromptCore,
+  MCPResourceResponse,
+  MCPToolResponse,
+  MCPPromptResponse
+} from '@pikku/core'
+
+import type { PikkuFunctionConfig, PikkuFunctionSessionless } from '../function/pikku-function-types.gen.js'
+
+/**
+ * Type definition for MCP resources that provide data to AI models.
+ *
+ * @template In - Input type for the resource request
+ */
+type MCPResourceWiring<In> = CoreMCPResource<PikkuFunctionConfig<In, MCPResourceResponse>>
+
+/**
+ * Type definition for MCP tools that AI models can invoke.
+ *
+ * @template In - Input type for the tool invocation
+ */
+type MCPToolWiring<In> = CoreMCPTool<PikkuFunctionConfig<In, MCPToolResponse>>
+
+/**
+ * Type definition for MCP prompts that provide templates to AI models.
+ *
+ * @template In - Input type for the prompt parameters
+ */
+type MCPPromptWiring<In> = CoreMCPPrompt<PikkuFunctionConfig<In, MCPPromptResponse>>
+
+/**
+ * Registers an MCP resource with the Pikku framework.
+ * Resources provide data that AI models can access.
+ *
+ * @template In - Input type for the resource request
+ * @param mcpResource - MCP resource definition with data provider function
+ */
+export const wireMCPResource = <In>(
+  mcpResource: MCPResourceWiring<In>
+) => {
+  wireMCPResourceCore(mcpResource as any)
+}
+
+/**
+ * Registers an MCP tool with the Pikku framework.
+ * Tools are functions that AI models can invoke.
+ *
+ * @template In - Input type for the tool invocation
+ * @param mcpTool - MCP tool definition with action function
+ */
+export const wireMCPTool = <In>(
+  mcpTool: MCPToolWiring<In>
+) => {
+  wireMCPToolCore(mcpTool as any)
+}
+
+/**
+ * Registers an MCP prompt with the Pikku framework.
+ * Prompts provide templates that AI models can use.
+ *
+ * @template In - Input type for the prompt parameters
+ * @param mcpPrompt - MCP prompt definition with template function
+ */
+export const wireMCPPrompt = <In>(
+  mcpPrompt: MCPPromptWiring<In>
+) => {
+  wireMCPPromptCore(mcpPrompt as any)
+}
+
+/**
+ * Creates a function for handling MCP prompt requests.
+ * These functions generate prompt templates for AI models.
+ *
+ * @template In - Input type for the prompt parameters
+ * @param func - Function definition, either direct function or configuration object
+ * @returns The unwrapped function for internal use
+ */
+export const pikkuMCPPromptFunc = <In>(
+  func:
+    | PikkuFunctionSessionless<In, MCPPromptResponse>
+    | {
+        func: PikkuFunctionSessionless<In, MCPPromptResponse>
+        name?: string
+      }
+) => {
+  return typeof func === 'function' ? func : func.func
+}
+
+/**
+ * Creates a function for handling MCP tool invocations.
+ * These functions perform actions that AI models can request.
+ *
+ * @template In - Input type for the tool invocation
+ * @param func - Function definition, either direct function or configuration object
+ * @returns The unwrapped function for internal use
+ */
+export const pikkuMCPToolFunc = <In>(
+  func:
+    | PikkuFunctionSessionless<In, MCPToolResponse, null, true>
+    | {
+      func: PikkuFunctionSessionless<In, MCPToolResponse, null, true>
+      name?: string
+    }
+) => {
+  return typeof func === 'function' ? func : func.func
+}
+
+/**
+ * Creates a function for handling MCP resource requests.
+ * These functions provide data that AI models can access.
+ *
+ * @template In - Input type for the resource request
+ * @param func - Function definition, either direct function or configuration object
+ * @returns The unwrapped function for internal use
+ */
+export const pikkuMCPResourceFunc = <In>(
+  func:
+    | PikkuFunctionSessionless<In, MCPResourceResponse, null, true>
+    | {
+      func: PikkuFunctionSessionless<In, MCPResourceResponse, null, true>
+      name?: string
+    }
+) => {
+  return typeof func === 'function' ? func : func.func
+}

package/.pikku/pikku-bootstrap.gen.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+import './cli/pikku-cli-wirings-meta.gen.js'
+import './rpc/pikku-rpc-wirings-meta.internal.gen.js'
+import './function/pikku-functions-meta.gen.js'
+import './function/pikku-functions.gen.js'
+import './schemas/register.gen.js'
+import './cli/pikku-cli-wirings.gen.js'

package/.pikku/pikku-services.gen.ts

@@ -0,0 +1,24 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+
+import type { SingletonServices } from '../types/application-types.d.js'
+import type { Services } from '../types/application-types.d.js'
+import type { PikkuInteraction } from '@pikku/core'
+
+export const singletonServices = {
+    'config': true,
+    'getInspectorState': true,
+    'logger': true,
+} as const
+
+// Singleton services (created once at startup)
+// Only includes services that are both required and available in SingletonServices
+export type RequiredSingletonServices = Pick<SingletonServices, Extract<keyof SingletonServices, 'config' | 'getInspectorState' | 'logger' | 'schema' | 'variables'>> & Partial<Omit<SingletonServices, 'config' | 'getInspectorState' | 'logger' | 'schema' | 'variables'>>
+
+// Session services (created per request, can access singleton services)
+// Omits singleton services and PikkuInteraction (mcp, rpc, http, channel)
+export type RequiredSessionServices = Omit<Services, keyof SingletonServices | keyof PikkuInteraction>

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

@@ -0,0 +1,28 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This file was generated by the @pikku/cli
+ * Main type export hub - re-exports all wiring-specific types
+ */
+
+// Core function, middleware, and permission types
+export * from './function/pikku-function-types.gen.js'
+
+// HTTP wiring types
+export * from './http/pikku-http-types.gen.js'
+
+// Channel wiring types
+export * from './channel/pikku-channel-types.gen.js'
+
+// Scheduler wiring types
+export * from './scheduler/pikku-scheduler-types.gen.js'
+
+// Queue wiring types
+export * from './queue/pikku-queue-types.gen.js'
+
+// MCP wiring types
+export * from './mcp/pikku-mcp-types.gen.js'
+
+// CLI wiring types
+export * from './cli/pikku-cli-types.gen.js'

package/.pikku/queue/pikku-queue-types.gen.ts

@@ -0,0 +1,28 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This file was generated by the @pikku/cli
+ * Queue-specific type definitions for tree-shaking optimization
+ */
+
+import { CoreQueueWorker, wireQueueWorker as wireQueueWorkerCore } from '@pikku/core/queue'
+import type { PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
+
+/**
+ * Type definition for queue workers that process background jobs.
+ *
+ * @template In - Input type for the queue job
+ * @template Out - Output type for the queue job
+ */
+type QueueWiring<In, Out> = CoreQueueWorker<PikkuFunctionConfig<In, Out>>
+
+/**
+ * Registers a queue worker with the Pikku framework.
+ * Workers process background jobs from queues.
+ *
+ * @param queueWorker - Queue worker definition with job handler
+ */
+export const wireQueueWorker = (queueWorker: QueueWiring<any, any>) => {
+  wireQueueWorkerCore(queueWorker as any) // TODO
+}

package/.pikku/rpc/pikku-rpc-wirings-map.gen.d.ts

@@ -0,0 +1,46 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This provides the structure needed for typescript to be aware of RPCs and their return types
+ */
+    
+
+
+// Custom types are those that are defined directly within generics
+// or are broken into simpler types
+export type PikkuChannelsOutput = false | true
+export type PikkuCLIOutput = false | true
+export type PikkuFunctionsOutput = false | true
+export type PikkuSchemasOutput = false | true
+export type PikkuMCPOutput = false | true
+export type PikkuHTTPOutput = false | true
+export type PikkuMiddlewareOutput = false | true
+export type PikkuRPCOutput = false | true
+export type PikkuQueueOutput = false | true
+export type PikkuSchedulerOutput = false | true
+
+interface RPCHandler<I, O> {
+    input: I;
+    output: O;
+}
+
+export type RPCMap = {
+};
+
+
+export type RPCInvoke = <Name extends keyof RPCMap>(
+  name: Name,
+  data: RPCMap[Name]['input'],
+  options?: {
+    location?: 'local' | 'remote' | 'auto'
+  }
+) => Promise<RPCMap[Name]['output']>
+
+export type TypedPikkuRPC = {
+  depth: number;
+  global: boolean;
+  invoke: RPCInvoke;
+  invokeExposed: (name: string, data: any) => Promise<any> 
+}
+  

package/.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts

@@ -0,0 +1,80 @@
+/**
+ * This file was generated by the @pikku/cli
+ */
+/**
+ * This provides the structure needed for typescript to be aware of RPCs and their return types
+ */
+    
+
+
+// Custom types are those that are defined directly within generics
+// or are broken into simpler types
+export type PikkuChannelsOutput = false | true
+export type PikkuCLIOutput = false | true
+export type PikkuFunctionsOutput = false | true
+export type PikkuSchemasOutput = false | true
+export type PikkuMCPOutput = false | true
+export type PikkuHTTPOutput = false | true
+export type PikkuMiddlewareOutput = false | true
+export type PikkuRPCOutput = false | true
+export type PikkuQueueOutput = false | true
+export type PikkuSchedulerOutput = false | true
+
+interface RPCHandler<I, O> {
+    input: I;
+    output: O;
+}
+
+export type RPCMap = {
+  readonly 'all': RPCHandler<null, null>,
+  readonly 'watch': RPCHandler<null, null>,
+  readonly 'pikkuNext': RPCHandler<null, null>,
+  readonly 'pikkuChannels': RPCHandler<null, PikkuChannelsOutput>,
+  readonly 'pikkuChannelTypes': RPCHandler<null, null>,
+  readonly 'pikkuChannelsMap': RPCHandler<null, null>,
+  readonly 'pikkuWebSocketTyped': RPCHandler<null, null>,
+  readonly 'pikkuCLIEntry': RPCHandler<null, null>,
+  readonly 'pikkuCLITypes': RPCHandler<null, null>,
+  readonly 'pikkuCLI': RPCHandler<null, PikkuCLIOutput>,
+  readonly 'pikkuFetch': RPCHandler<null, null>,
+  readonly 'pikkuFunctionTypesSplit': RPCHandler<null, null>,
+  readonly 'pikkuFunctionTypes': RPCHandler<null, null>,
+  readonly 'pikkuFunctions': RPCHandler<null, PikkuFunctionsOutput>,
+  readonly 'pikkuServices': RPCHandler<null, null>,
+  readonly 'pikkuSchemas': RPCHandler<null, PikkuSchemasOutput>,
+  readonly 'pikkuMCPJSON': RPCHandler<null, null>,
+  readonly 'pikkuMCPTypes': RPCHandler<null, null>,
+  readonly 'pikkuMCP': RPCHandler<null, PikkuMCPOutput>,
+  readonly 'pikkuHTTPMap': RPCHandler<null, null>,
+  readonly 'pikkuHTTP': RPCHandler<null, PikkuHTTPOutput>,
+  readonly 'pikkuHTTPTypes': RPCHandler<null, null>,
+  readonly 'pikkuOpenAPI': RPCHandler<null, null>,
+  readonly 'pikkuMiddleware': RPCHandler<null, PikkuMiddlewareOutput>,
+  readonly 'pikkuRPCClient': RPCHandler<null, null>,
+  readonly 'pikkuRPCInternalMap': RPCHandler<null, null>,
+  readonly 'pikkuRPCExposedMap': RPCHandler<null, null>,
+  readonly 'pikkuRPC': RPCHandler<null, PikkuRPCOutput>,
+  readonly 'pikkuQueueMap': RPCHandler<null, null>,
+  readonly 'pikkuQueueService': RPCHandler<null, null>,
+  readonly 'pikkuQueueTypes': RPCHandler<null, null>,
+  readonly 'pikkuQueue': RPCHandler<null, null>,
+  readonly 'pikkuSchedulerTypes': RPCHandler<null, null>,
+  readonly 'pikkuScheduler': RPCHandler<null, PikkuSchedulerOutput>,
+};
+
+
+export type RPCInvoke = <Name extends keyof RPCMap>(
+  name: Name,
+  data: RPCMap[Name]['input'],
+  options?: {
+    location?: 'local' | 'remote' | 'auto'
+  }
+) => Promise<RPCMap[Name]['output']>
+
+export type TypedPikkuRPC = {
+  depth: number;
+  global: boolean;
+  invoke: RPCInvoke;
+  invokeExposed: (name: string, data: any) => Promise<any> 
+}
+