flowtemplate

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

type Parameter struct {
	// Name matches the placeholder in Body (e.g. "TopicName" for
	// {{.TopicName}}).
	Name string `json:"name"`

	// Description helps the coordinator / operator pick a value.
	Description string `json:"description,omitempty"`

	// Default is the value used when Instantiate is called without
	// overriding this parameter. Empty means "required — no default".
	Default string `json:"default,omitempty"`

	// Required signals the caller must supply a value (no default).
	// When Required is true, Default is ignored.
	Required bool `json:"required,omitempty"`
}

type Template struct {
	// ID uniquely identifies the template in the FLOW_TEMPLATES bucket.
	// Kebab-case convention: "research-pipeline", "temp-anomaly-agent".
	ID string `json:"id"`

	// Name is a human-friendly label surfaced to operators and the
	// coordinator agent when choosing a template.
	Name string `json:"name"`

	// Description is optional context explaining what this template
	// produces and when to use it — surfaced to the coordinator so it
	// can pick sensibly.
	Description string `json:"description,omitempty"`

	// Body is the flow definition with text/template placeholders. When
	// instantiated, placeholders resolve against user-supplied Parameters.
	// Canonical substitution syntax: {{.SomeParam}}.
	Body string `json:"body"`

	// Parameters declares the substitution points and their defaults.
	// Instantiate() uses defaults for any param the caller omits. Order
	// of Parameters is not significant — the slice form is just to
	// preserve authoring order for operators scanning the template.
	Parameters []Parameter `json:"parameters,omitempty"`
}