planner

type Config struct {
	// Name is the workload name; the planner agent is named
	// "<Name>_planner". Required.
	Name string

	// Description is a human-readable summary, surfaced in operator
	// UIs and logs.
	Description string

	// Model is the LLM driving the planner's turn loop. Required.
	Model model.LLM

	// Instruction overrides the default planner instruction template.
	// Empty renders DefaultInstructionTemplate against the roster —
	// the planner-specific frame from orchestration-design's planner
	// section (resolved open question #7: single template with
	// variables; per-workload override as the escape hatch). The
	// generic pkg/agent DefaultTaskInstruction never applies here: a
	// planner is never a generic task agent, so the template embeds
	// the unattended-task discipline itself.
	Instruction string

	// Specialists is the bundle's built roster, indexed by specialist
	// name — the invoke_specialist targets.
	Specialists map[string]adkagent.Agent

	// Order optionally fixes the roster ordering used in the rendered
	// instruction and tool description (bundle declaration order).
	// Names absent from Specialists are ignored; specialists absent
	// from Order are appended in map-iteration-stable sorted order.
	Order []string

	// PauseRecorder mints the durable pause record + resume token for
	// pause_session (the v0.2 plane-A self-pause). Nil leaves
	// pause_session out of the vocabulary — callers without a durable
	// store (one-shot in-memory sessions) get a coherent tool set
	// rather than a pause that would die with the process.
	PauseRecorder PauseRecorder
}

type PauseRecorder interface {
	PauseInterrupt(ctx context.Context, userID, sessionID, interruptID string, spec transcript.PauseSpec) (transcript.PauseHandle, error)
}