The Agent Developer Kit is the TypeScript library for building agents that watch, produce and deliver video. This page is generated from the published package's own type declarations — 33 exported symbols: 9 classes, 9 framework adapters and 15 types — so it describes the release you can install today rather than the tip of a branch.

Install

npm install @wave-av/adk

Current release 1.0.15. zod is the only runtime dependency.

Classes

AgentLogger

Structured log forwarding for WAVE agents

constructor(config: AgentLoggerConfig)
debug(message: string, data?: Record<string, unknown>): void
info(message: string, data?: Record<string, unknown>): void
warn(message: string, data?: Record<string, unknown>): void
error(message: string, data?: Record<string, unknown>): void
flush(): Promise<void>
destroy(): void

AgentRuntime

Production runtime for WAVE agents

constructor(agent: WaveAgent, config?: AgentRuntimeConfig)
start(): Promise<void>
stop(): Promise<void>
getHealth(): AgentHealthStatus
getLogger(): AgentLogger

AgentToolkit

MCP-compatible tool definitions for AI agents

constructor(config: { apiKey: string; baseUrl?: string; })
getTools(): AgentTool[]
toMCPTools(): { name: string; description: string; inputSchema: Record<string, unknown>; }[]

AutoProducerAgent

AI-powered live show direction

constructor(config: AutoProducerConfig)
start(): Promise<void>
switchToSource(sourceId: string, reason: string): Promise<void>
showGraphic(templateId: string, data: Record<string, unknown>): Promise<void>
markHighlight(label: string): Promise<void>

CaptionAgent

Real-time transcription and captioning agent

constructor(config: CaptionConfig)
start(): Promise<void>
translateTo(streamId: string, targetLanguage: string): Promise<void>
getTranscript(streamId: string): Promise<{ segments: { text: string; start: number; end: number; }[]; }>

ClipFactoryAgent

Monitors streams, auto-creates highlight clips

constructor(config: ClipFactoryConfig)
start(): Promise<void>
exportClip(highlight: ClipHighlight): Promise<string>

ModerationAgent

AI content moderation for live streams

constructor(config: ModerationConfig)
start(): Promise<void>
blockUser(streamId: string, userId: string, reason: string): Promise<void>
approveMessage(messageId: string): Promise<void>

StreamMonitorAgent

Watches stream quality, auto-remediates

constructor(config: StreamMonitorConfig)
start(): Promise<void>
stop(): Promise<void>

WaveAgent

Base class for all WAVE AI agents

constructor(config: WaveAgentConfig)
get isRunning(): boolean
start(): Promise<void>
stop(): Promise<void>
on(event: string, handler: AgentEventHandler): void
getUsageStats(): { totalCalls: number; totalDurationMs: number; }

Framework adapters

Each adapter presents the same WAVE capabilities in the tool shape a given orchestrator expects, so an agent keeps whichever framework its project already uses.

FunctionWhat it returns
createClipNode()Create a WAVE clip creation graph node.
createKernelTools()Create WAVE ADK tools backed by Kernel.sh cloud browsers.
createLangGraphTools()Create LangGraph-compatible tool definitions from WAVE AgentToolkit.
createLiveKitWaveTools()Create LiveKit Agent function tools from WAVE AgentToolkit.
createMastraTools()Create Mastra-compatible tool definitions from WAVE AgentToolkit.
createStreamMonitorNode()Create a WAVE stream monitoring graph node.
createStreamMonitorStep()Create a Mastra workflow step that monitors stream quality.
createWaveMCPConfig()Create a Mastra MCP server configuration for WAVE.
createWaveStreamSource()WAVE stream source for LiveKit room.

Exported types

Importable from the package root for typing your own handlers.

AgentEventHandler · AgentHealthStatus · AgentInvocation · AgentLoggerConfig · AgentRuntimeConfig · AgentTier · AgentTool · AgentType · AgentWebhookEvent · ClipHighlight · KernelConfig · LogLevel · ModerationFlag · StreamQualityAlert · WaveAgentConfig