workflow

type API struct {
	Executions     *executions.API
	NodeExecutions *nodeexecutions.API
	Conversations  *conversations.API
	Worktrees      *worktrees.API
	Registry       *workflowruntime.Registry
	// contains filtered or unexported fields
}

type ComposeRequest struct {
	// WorkflowSlug is empty when the request should create a workflow.
	WorkflowSlug string `json:"workflow_slug"`
	Request      string `json:"request"`
	// Harness, Model, and ReasoningEffort override the settings
	// choice for this call only — empty means "use the configured
	// default" (medium, for the effort).
	Harness         string `json:"harness"`
	Model           string `json:"model"`
	ReasoningEffort string `json:"reasoning_effort"`
}

type ComposeResponse struct {
	WorkflowSlug    string `json:"workflow_slug"`
	Action          string `json:"action"`
	Summary         string `json:"summary"`
	Harness         string `json:"harness"`
	Model           string `json:"model"`
	ReasoningEffort string `json:"reasoning_effort"`
	// Draft is the proposed spec now waiting for Save — empty
	// when the composer proposed nothing.
	Draft string `json:"draft,omitempty"`
}

type CreateRequest struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	// WorkflowSlug overrides the id derived from the name.
	WorkflowSlug string `json:"workflow_slug"`
}

type CreateResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	Name         string `json:"name"`
	// Draft is the scaffolded spec, waiting for nodes and Save.
	Draft string `json:"draft"`
}

type DeleteDraftRequest struct {
	WorkflowSlug string `json:"workflow_slug"`
}

type DeleteDraftResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	Deleted      bool   `json:"deleted"`
}

type DeleteRequest struct {
	WorkflowSlug string `json:"workflow_slug"`
}

type DeleteResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	Deleted      bool   `json:"deleted"`
}

type GetRequest struct {
	WorkflowSlug string `json:"workflow_slug"`
}

type GetResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	Spec         string `json:"spec"`
	// Draft holds unsaved composer changes; empty when none exist.
	Draft string `json:"draft,omitempty"`
}

type ListRequest struct{}

type ListResponse struct {
	Workflows []workflowruntime.WorkflowSummary `json:"workflows"`
}

type RenameRequest struct {
	WorkflowSlug string `json:"workflow_slug"`
	// NewID moves the workflow to a new id; empty keeps the current.
	NewID string `json:"new_id"`
	// Name sets the display name; empty keeps the current.
	Name string `json:"name"`
	// Description sets the description; nil keeps the current, ""
	// clears it.
	Description *string `json:"description,omitempty"`
}

type RenameResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	// UpdatedRefs lists workflows whose specs were rewritten
	// because they embed the renamed workflow.
	UpdatedRefs []string `json:"updated_refs,omitempty"`
}

type SaveDraftRequest struct {
	WorkflowSlug string `json:"workflow_slug"`
}

type SaveDraftResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	Version      string `json:"version"`
	Spec         string `json:"spec"`
}

type UpdateNodeRequest struct {
	WorkflowSlug string `json:"workflow_slug"`
	Node         string `json:"node"`
	// nil fields are left unchanged.
	Model       *string `json:"model,omitempty"`
	Harness     *string `json:"harness,omitempty"`
	Instruction *string `json:"instruction,omitempty"`
	// "" resets to the harness default.
	ReasoningEffort *string `json:"reasoning_effort,omitempty"`
	// "" resets to the compiler default (read_only).
	Permissions *string `json:"permissions,omitempty"`
}

type UpdateNodeResponse struct {
	WorkflowSlug string `json:"workflow_slug"`
	Node         string `json:"node"`
	Spec         string `json:"spec"`
}