Function RunStructured

cli/plugins/capabilities.go:208–225

RunStructured executes the plugin and always returns a StructuredResult, preferring the structured executor when available and falling back to the legacy ExecuteWithStream pair otherwise. The infrastructure error (network timeout, ctx canceled, plugin binary not found) is returned separately so the

(ctx context.Context, p Plugin, args []string, onOutput func(string))

// timeout, ctx canceled, plugin binary not found) is returned separately so
// the orchestrator can decide whether to abort the batch.
func RunStructured(ctx context.Context, p Plugin, args []string, onOutput func(string)) (StructuredResult, error) {
	if p == nil {
		return StructuredResult{}, errNilPlugin
	}
	if se, ok := p.(StructuredExecutor); ok {
		return se.ExecuteStructured(ctx, args, onOutput)
	}
	out, err := p.ExecuteWithStream(ctx, args, onOutput)
	res := StructuredResult{Output: out}
	if err != nil {
		res.IsError = true
		// ErrorCode classification lives in cli/agent — callers wrap this
		// StructuredResult with agent.WrapStructuredResult to populate
		// ErrorCode. Keeping the classifier out of this package avoids
		// an import cycle (cli/plugins ↛ cli/agent).
	}
	return res, err
}