@pikku/core 0.12.3 → 0.12.4

package/src/wirings/rpc/rpc-runner.ts

@@ -1,460 +0,0 @@
-import type { CoreServices, PikkuWire } from '../../types/core.types.js'
-import type { SessionService } from '../../services/user-session-service.js'
-import type { CoreUserSession } from '../../types/core.types.js'
-import { runPikkuFunc } from '../../function/function-runner.js'
-import { pikkuState } from '../../pikku-state.js'
-import { ForbiddenError } from '../../errors/errors.js'
-import { PikkuError, addError } from '../../errors/error-handler.js'
-import type { PikkuRPC, ResolvedFunction } from './rpc-types.js'
-import { parseVersionedId } from '../../version.js'
-import { encryptJSON } from '../../crypto-utils.js'
-
-export class RPCNotFoundError extends PikkuError {
-  public readonly rpcName: string
-  constructor(rpcName: string) {
-    super(`RPC function not found: ${rpcName}`)
-    this.rpcName = rpcName
-  }
-}
-addError(RPCNotFoundError, {
-  status: 404,
-  mcpCode: -32601,
-  message: 'RPC function not found.',
-})
-import type { AIAgentInput } from '../ai-agent/ai-agent.types.js'
-import type { AIStreamChannel } from '../ai-agent/ai-agent.types.js'
-import type { StreamAIAgentOptions } from '../ai-agent/ai-agent-prepare.js'
-import { runAIAgent, resumeAIAgentSync } from '../ai-agent/ai-agent-runner.js'
-import { streamAIAgent, resumeAIAgent } from '../ai-agent/ai-agent-stream.js'
-
-/**
- * Resolve a namespaced function reference to package and function names
- * Uses pikkuState to look up the namespace -> package mapping
- */
-export const resolveNamespace = (
-  namespacedFunction: string
-): ResolvedFunction | null => {
-  const colonIndex = namespacedFunction.indexOf(':')
-  if (colonIndex === -1) {
-    return null
-  }
-
-  const namespace = namespacedFunction.substring(0, colonIndex)
-  const functionName = namespacedFunction.substring(colonIndex + 1)
-
-  const addons = pikkuState(null, 'addons', 'packages')
-  const pkgConfig = addons.get(namespace)
-  if (!pkgConfig) {
-    return null
-  }
-
-  return {
-    package: pkgConfig.package,
-    function: functionName,
-    addonConfig: pkgConfig,
-  }
-}
-
-const getPikkuFunctionName = (rpcName: string): string => {
-  const rpc = pikkuState(null, 'rpc', 'meta')
-  let rpcMeta = rpc[rpcName]
-  if (!rpcMeta) {
-    const { baseName, version } = parseVersionedId(rpcName)
-    if (version !== null) {
-      rpcMeta = rpc[baseName]
-    }
-  }
-  if (!rpcMeta) {
-    throw new RPCNotFoundError(rpcName)
-  }
-  return rpcMeta
-}
-
-// Context-aware RPC client for use within services
-export class ContextAwareRPCService {
-  constructor(
-    private services: CoreServices,
-    private wire: PikkuWire,
-    private options: {
-      requiresAuth?: boolean
-      sessionService?: SessionService<CoreUserSession>
-    }
-  ) {}
-
-  public async rpcExposed(funcName: string, data: any): Promise<any> {
-    let functionMeta: any
-    if (funcName.includes(':')) {
-      const resolved = resolveNamespace(funcName)
-      if (resolved) {
-        functionMeta = pikkuState(resolved.package, 'function', 'meta')[
-          resolved.function
-        ]
-      }
-    } else {
-      functionMeta = pikkuState(null, 'function', 'meta')[funcName]
-    }
-    if (!functionMeta) {
-      throw new RPCNotFoundError(funcName)
-    }
-    if (!functionMeta.expose) {
-      throw new ForbiddenError()
-    }
-    return await this.rpc(funcName, data)
-  }
-
-  public async rpc<In = any, Out = any>(
-    funcName: string,
-    data: In
-  ): Promise<Out> {
-    const rpcDepth = this.wire.rpc?.depth || 0
-    const updatedWire: PikkuWire = {
-      ...this.wire,
-      rpc: this.wire.rpc
-        ? {
-            ...this.wire.rpc,
-            depth: rpcDepth + 1,
-            global: false,
-          }
-        : undefined,
-    }
-
-    // Check if it's a namespaced function call (e.g., 'stripe:createCharge')
-    if (funcName.includes(':')) {
-      return this.invokeAddonFunction<In, Out>(funcName, data, updatedWire)
-    }
-
-    // Main package function
-    return runPikkuFunc<In, Out>(
-      'rpc',
-      funcName,
-      getPikkuFunctionName(funcName),
-      {
-        auth: this.options.requiresAuth,
-        singletonServices: this.services,
-        data: () => data,
-        wire: updatedWire,
-      }
-    )
-  }
-
-  /**
-   * Invoke a function from an addon package
-   * Addon packages register their functions in pikkuState under their package name.
-   * The function is executed using the parent services (shared singleton services).
-   * @private
-   */
-  private async invokeAddonFunction<In = any, Out = any>(
-    namespacedFunction: string,
-    data: In,
-    wire: PikkuWire
-  ): Promise<Out> {
-    // Resolve namespace to package name
-    const resolved = resolveNamespace(namespacedFunction)
-    if (!resolved) {
-      throw new Error(
-        `Unknown namespace in function reference: ${namespacedFunction}. ` +
-          `Make sure the package is registered in addons config.`
-      )
-    }
-
-    // Get the function meta from the addon package
-    // Addon packages use function meta, not RPC meta
-    const addonFunctionMeta = pikkuState(resolved.package, 'function', 'meta')
-    const funcMeta = addonFunctionMeta[resolved.function]
-    if (!funcMeta) {
-      throw new Error(
-        `Function '${resolved.function}' not found in package '${resolved.package}'. ` +
-          `Available functions: ${Object.keys(addonFunctionMeta).join(', ') || '(none)'}`
-      )
-    }
-    const funcName = funcMeta.pikkuFuncId || resolved.function
-
-    const auth = resolved.addonConfig?.auth ?? this.options.requiresAuth
-    const tags = [
-      ...(resolved.addonConfig?.tags ?? []),
-      ...(funcMeta.tags ?? []),
-    ]
-
-    // Execute the function using runPikkuFunc with the addon package's state
-    // We use the parent services (this.services) since addon packages share services
-    // Pass the function's tags so tag-based middleware/permissions are applied
-    return runPikkuFunc<In, Out>('rpc', namespacedFunction, funcName, {
-      auth,
-      singletonServices: this.services,
-      data: () => data,
-      wire,
-      packageName: resolved.package,
-      tags,
-    })
-  }
-
-  public async rpcWithWire<In = any, Out = any>(
-    rpcName: string,
-    data: In,
-    wire: PikkuWire
-  ): Promise<Out> {
-    const rpcDepth = this.wire.rpc?.depth || 0
-    const mergedWire: PikkuWire = {
-      ...this.wire,
-      ...wire,
-      rpc: this.wire.rpc
-        ? {
-            ...this.wire.rpc,
-            depth: rpcDepth + 1,
-            global: false,
-          }
-        : undefined,
-    }
-
-    if (rpcName.includes(':')) {
-      return this.invokeAddonFunction<In, Out>(rpcName, data, mergedWire)
-    }
-
-    return runPikkuFunc<In, Out>(
-      'rpc',
-      rpcName,
-      getPikkuFunctionName(rpcName),
-      {
-        auth: this.options.requiresAuth,
-        singletonServices: this.services,
-        data: () => data,
-        wire: mergedWire,
-      }
-    )
-  }
-
-  public async startWorkflow<In = any>(
-    workflowName: string,
-    input: In,
-    options?: {
-      startNode?: string
-      wire?: { type: string; id?: string; parentRunId?: string }
-    }
-  ): Promise<{ runId: string }> {
-    if (!this.services.workflowService) {
-      throw new Error('WorkflowService service not available')
-    }
-    const parentRunId = this.wire.workflowStep?.runId ?? this.wire.graph?.runId
-    const wire = options?.wire ?? {
-      type: this.wire.wireType ?? 'unknown',
-      id: this.wire.wireId,
-      ...(parentRunId ? { parentRunId } : {}),
-    }
-    return this.services.workflowService.startWorkflow(
-      workflowName,
-      input,
-      wire,
-      this,
-      options
-    )
-  }
-
-  public get agent() {
-    return {
-      run: async (agentName: string, input: AIAgentInput) => {
-        const result = await runAIAgent(agentName, input, {
-          sessionService: this.options.sessionService,
-        })
-        return {
-          runId: result.runId,
-          result: result.object ?? result.text,
-          usage: result.usage,
-          ...(result.status === 'suspended' && {
-            status: 'suspended' as const,
-            pendingApprovals: result.pendingApprovals,
-          }),
-        }
-      },
-      stream: async (
-        agentName: string,
-        input: {
-          message: string
-          threadId: string
-          resourceId: string
-          model?: string
-          temperature?: number
-        },
-        options?: StreamAIAgentOptions
-      ) => {
-        const channel = this.wire.channel as unknown as AIStreamChannel
-        if (!channel) throw new Error('No channel available for streaming')
-        await streamAIAgent(
-          agentName,
-          input,
-          channel,
-          { sessionService: this.options.sessionService },
-          undefined,
-          options
-        )
-      },
-      resume: async (
-        runId: string,
-        input: { toolCallId: string; approved: boolean },
-        options?: StreamAIAgentOptions
-      ) => {
-        const channel = this.wire.channel as unknown as AIStreamChannel
-        if (!channel) throw new Error('No channel available for streaming')
-        await resumeAIAgent(
-          { runId, ...input },
-          channel,
-          { sessionService: this.options.sessionService },
-          options
-        )
-      },
-      approve: async (
-        runId: string,
-        approvals: { toolCallId: string; approved: boolean }[],
-        expectedAgentName?: string
-      ) => {
-        const result = await resumeAIAgentSync(runId, approvals, {
-          sessionService: this.options.sessionService,
-        }, expectedAgentName)
-        return {
-          runId: result.runId,
-          result: result.object ?? result.text,
-          usage: result.usage,
-          ...(result.status === 'suspended' && {
-            status: 'suspended' as const,
-            pendingApprovals: result.pendingApprovals,
-          }),
-        }
-      },
-    }
-  }
-
-  public async remote<In = any, Out = any>(
-    funcName: string,
-    data: In
-  ): Promise<Out> {
-    let endpoint: string | undefined
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-    }
-
-    const colonIndex = funcName.indexOf(':')
-    if (colonIndex !== -1) {
-      const namespace = funcName.substring(0, colonIndex)
-      const addons = pikkuState(null, 'addons', 'packages')
-      const pkgConfig = addons.get(namespace)
-      endpoint = pkgConfig?.rpcEndpoint
-    }
-
-    if (!endpoint && this.services.deploymentService) {
-      const deployments =
-        await this.services.deploymentService.findFunction(funcName)
-      if (deployments.length > 0) {
-        endpoint = deployments[0].endpoint
-      }
-    }
-
-    if (!endpoint) {
-      throw new Error(
-        `No endpoint configured for remote RPC: ${funcName}. ` +
-          `Configure rpcEndpoint in addons config or set up a DeploymentService.`
-      )
-    }
-
-    let secret: string | undefined
-    if (this.services.secrets) {
-      try {
-        secret = await this.services.secrets.getSecret('PIKKU_REMOTE_SECRET')
-      } catch {}
-    }
-    if (secret) {
-      if (!this.services.jwt) {
-        throw new Error(
-          'PIKKU_REMOTE_SECRET is set but JWT service is not available'
-        )
-      }
-      const session =
-        this.wire.getSession && typeof this.wire.getSession === 'function'
-          ? await this.wire.getSession()
-          : (this.wire as any).session
-      const sessionEnc = session
-        ? await encryptJSON(secret, { session })
-        : undefined
-      const token = await this.services.jwt.encode(
-        { value: 5, unit: 'minute' },
-        {
-          aud: 'pikku-remote',
-          fn: funcName,
-          iat: Date.now(),
-          session: sessionEnc,
-        }
-      )
-      headers.Authorization = `Bearer ${token}`
-    }
-
-    const url = `${endpoint}/rpc/${encodeURIComponent(funcName)}`
-    const timeoutMs = 30_000
-    const response = await fetch(url, {
-      method: 'POST',
-      headers,
-      body: JSON.stringify({ data }),
-      signal: AbortSignal.timeout(timeoutMs),
-    })
-
-    if (!response.ok) {
-      let errorBody: string
-      try {
-        errorBody = JSON.stringify(await response.json())
-      } catch {
-        errorBody = await response.text()
-      }
-      throw new Error(
-        `Remote RPC call failed: ${response.status} ${response.statusText}. ${errorBody}`
-      )
-    }
-
-    try {
-      return (await response.json()) as Out
-    } catch {
-      const text = await response.text()
-      throw new Error(
-        `Remote RPC call returned non-JSON response: ${response.status} ${response.statusText}. ${text}`
-      )
-    }
-  }
-}
-
-// RPC Service class for the global interface
-export class PikkuRPCService<
-  Services extends CoreServices,
-  TypedRPC = PikkuRPC,
-> {
-  // Convenience function for initializing
-  getContextRPCService(
-    services: Services,
-    wire: PikkuWire,
-    requiresAuthOrOptions?:
-      | boolean
-      | {
-          requiresAuth?: boolean
-          sessionService?: SessionService<CoreUserSession>
-        }
-      | undefined,
-    depth: number = 0
-  ): TypedRPC {
-    const options =
-      typeof requiresAuthOrOptions === 'object' &&
-      requiresAuthOrOptions !== null
-        ? requiresAuthOrOptions
-        : { requiresAuth: requiresAuthOrOptions }
-    const serviceRPC = new ContextAwareRPCService(services, wire, options)
-    return {
-      depth,
-      global: false,
-      invoke: serviceRPC.rpc.bind(serviceRPC),
-      remote: serviceRPC.remote.bind(serviceRPC),
-      exposed: serviceRPC.rpcExposed.bind(serviceRPC),
-      startWorkflow: serviceRPC.startWorkflow.bind(serviceRPC),
-      get agent() {
-        return serviceRPC.agent
-      },
-      rpcWithWire: serviceRPC.rpcWithWire.bind(serviceRPC),
-    } as any
-  }
-}
-
-// Create a singleton instance
-export const rpcService = new PikkuRPCService()

package/src/wirings/rpc/rpc-types.ts

@@ -1,56 +0,0 @@
-export type PikkuRPC<
-  Invoke extends Function = any,
-  Remote extends Function = any,
-  startWorkflow extends Function = any,
-  AgentRun extends Function = any,
-  AgentStream extends Function = any,
-> = {
-  depth: number
-  global: boolean
-  invoke: Invoke
-  remote: Remote
-  exposed: (name: string, data: any) => Promise<any>
-  startWorkflow: startWorkflow
-  agent: {
-    run: AgentRun
-    stream: AgentStream
-    resume: (
-      runId: string,
-      input: { toolCallId: string; approved: boolean },
-      options?: any
-    ) => Promise<void>
-    approve: (
-      runId: string,
-      approvals: { toolCallId: string; approved: boolean }[],
-      expectedAgentName?: string
-    ) => Promise<any>
-  }
-}
-
-export type RPCMeta = {
-  pikkuFuncId: string
-  expose: boolean
-  remote?: boolean
-}
-
-/**
- * Type for RPC handlers
- */
-export interface RPCHandler<Input, Output> {
-  input: Input
-  output: Output
-}
-
-/**
- * Resolved function reference from namespace
- */
-export interface ResolvedFunction {
-  package: string
-  function: string
-  addonConfig: {
-    package: string
-    auth?: boolean
-    tags?: string[]
-    rpcEndpoint?: string
-  }
-}

package/src/wirings/rpc/wire-addon.ts

@@ -1,21 +0,0 @@
-import { pikkuState } from '../../pikku-state.js'
-
-export type WireAddonConfig = {
-  name: string
-  package: string
-  rpcEndpoint?: string
-  auth?: boolean
-  mcp?: boolean
-  tags?: string[]
-  secretOverrides?: Record<string, string>
-  variableOverrides?: Record<string, string>
-}
-
-export const wireAddon = (config: WireAddonConfig): void => {
-  pikkuState(null, 'addons', 'packages').set(config.name, {
-    package: config.package,
-    rpcEndpoint: config.rpcEndpoint,
-    auth: config.auth,
-    tags: config.tags,
-  })
-}

package/src/wirings/scheduler/index.ts

@@ -1,11 +0,0 @@
-export {
-  runScheduledTask,
-  wireScheduler,
-  getScheduledTasks,
-} from './scheduler-runner.js'
-export { logSchedulers } from './log-schedulers.js'
-export type {
-  CoreScheduledTask,
-  ScheduledTasksMeta,
-  PikkuScheduledTask,
-} from './scheduler.types.js'

package/src/wirings/scheduler/log-schedulers.ts

@@ -1,20 +0,0 @@
-import { pikkuState } from '../../pikku-state.js'
-import type { Logger } from '../../services/index.js'
-
-/**
- * Logs all the loaded scheduled tasks.
- * @param logger - A logger for logging information.
- */
-export const logSchedulers = (logger: Logger) => {
-  const scheduledTasks = pikkuState(null, 'scheduler', 'tasks')
-  if (scheduledTasks.size === 0) {
-    logger.info('No scheduled tasks added')
-    return
-  }
-
-  let scheduledTasksMessage = 'Scheduled tasks:'
-  scheduledTasks.forEach(({ schedule }, name) => {
-    scheduledTasksMessage += `\n\t- ${name} -> ${schedule}`
-  })
-  logger.info(scheduledTasksMessage)
-}