hot.dev/hot-ai / ::ai::stream-labels

Functions

ns alias

Alias of ::ai::stream-labels/

Canonical data-type labels used across ::ai::* for ::hot::stream/data emissions. Centralizing the strings keeps consumers (dashboards, replays, logs) stable as new producers are added.

Convention

Labels follow <package>:<topic>:<verb>:

• <package> — top-level namespace identifying the producer (ai, hot, mcp, agent, …).
• <topic> — feature area (chat, tool, bundle, skill).
• <verb> — granularity (step, delta, usage, start, end, error).

Producers SHOULD prefer the constants exported here over string literals; consumers MAY match by prefix to bucket related events.

Currently emitted

• ai:chat:step — ::ai::chat/run-loop per-turn observability record (when opts.emit-steps: true).
• ai:chat:delta — ::ai::chat/run-loop-stream per-event mirror of the streaming ReplyDelta (when opts.emit-stream-deltas: true).

Reserved (future producers)

Reserve namespace prefixes here so adopters know what's safe to use without colliding with built-in producers:

• ai:tool:* — tool-call lifecycle (start/end/error).
• ai:rag:* — RAG pipeline events (retrieve/score/answer).
• ai:skill:* — skill activation lifecycle.
• ai:agent:* — higher-level agent orchestration events.
• mcp:* — MCP server activity.