rendering

type Engine ¶

type Engine struct {
	// contains filtered or unexported fields
}

Engine renders output blocks sent by plugins over the CoreCLIHelper RPCs.

All rendering goes to the writers the host configured, never to the plugin's own stdio. Rendering is serialized so that blocks appear in the order the plugin sent them even when a plugin sends from multiple goroutines.

func NewEngine(format Format) *Engine

func NewEngineWithWriters(format Format, stdout, stderr io.Writer) *Engine

func (e *Engine) HandleCommandOutput(req *proto.SendCommandOutputRequest)

func (e *Engine) HandlePrompt(req *proto.PromptRequest) *proto.PromptResponse

type EnvelopeBlock ¶

type EnvelopeBlock struct {
	Type    string          `json:"type"`
	Payload json.RawMessage `json:"payload"`
}

EnvelopeBlock represents a single output block in the JSON envelope.

type Format ¶

type Format string

Format selects how the engine renders plugin output.

const (
	// FormatText renders human-readable output.
	FormatText Format = "text"
	// FormatJSON renders a single JSON envelope for the command's final output.
	FormatJSON Format = "json"
)

type JSONEnvelope ¶

type JSONEnvelope struct {
	Command string          `json:"command"`
	Data    []EnvelopeBlock `json:"data"`
}

JSONEnvelope is the standard output format for --format=json. Only success output goes here (stdout). Errors go to stderr + non-zero exit.