WeKnora/cli/internal/output/ndjson_stream.go

44 lines
1.4 KiB
Go

package output
import (
"encoding/json"
"io"
)
// InitEvent is the CLI-injected lifecycle event written at the head of a
// streaming command's NDJSON output (§5.3). Carries enough context for an
// agent to thread follow-ups (session id, kb id, model, profile).
//
// Type field is always "init"; the JSON tag fixes the wire shape.
type InitEvent struct {
Type string `json:"type"`
SessionID string `json:"session_id"`
AgentID string `json:"agent_id,omitempty"`
KBID string `json:"kb_id,omitempty"`
RequestID string `json:"request_id,omitempty"`
Model string `json:"model,omitempty"`
Profile string `json:"profile,omitempty"`
}
// WriteNDJSONLine emits one NDJSON event line to w.
func WriteNDJSONLine(w io.Writer, v any) error {
enc := json.NewEncoder(w)
enc.SetEscapeHTML(false)
return enc.Encode(v)
}
// EmitInit writes the lifecycle init event to start an NDJSON stream.
// MUST be called before any other writes to w within an NDJSON stream —
// agents key on lines[0].type == "init" to discover session/profile/kb
// context. Sets Type=init regardless of caller-supplied value.
func EmitInit(w io.Writer, ev InitEvent) error {
ev.Type = "init"
return WriteNDJSONLine(w, ev)
}
// EmitSDKEvent passes through the raw SDK event as one NDJSON line.
// SDK is source of truth for event vocab (§5.1).
func EmitSDKEvent(w io.Writer, ev any) error {
return WriteNDJSONLine(w, ev)
}