SDK configuration

interface NikaSharedConfig {
  eventBufferSize?: number      // default 256
  machineBufferBytes?: number   // default 64 KiB
}

interface NikaLocalConfig extends NikaSharedConfig {
  cwd?: string
  bin?: string
}

interface NikaRemoteConfig extends NikaSharedConfig {
  url: string
  token: string
  allowInsecureHttp?: boolean
  requestTimeout?: number       // default 30 seconds
  fetch?: typeof globalThis.fetch
  cwd?: string
  bin?: string
}

interface NikaCheckOptions {
  model?: string
  nativeStrict?: boolean
  signal?: AbortSignal
}

interface NikaRunOptions {
  inputs?: Record<string, unknown>             // literal typed values — the app channel
  vars?: Record<string, string | number | boolean>  // deprecated: native --var operator channel
  model?: string
  maxCostUsd?: number
  idempotencyKey?: string                      // required for HTTP admission
}

interface NikaEventsOptions {
  signal?: AbortSignal
  bufferSize?: number
}

interface NikaAttachRunOptions { lastEventId?: number }
interface NikaTraceVerifyOptions { signal?: AbortSignal }