workflow

package
v0.107.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 4, 2026 License: Apache-2.0 Imports: 20 Imported by: 0

Documentation

Index

Constants

View Source
const (
	MaxConcurrency  = 16
	MaxAgentsPerRun = 1000
	MaxFanoutItems  = 4096
)

Variables

This section is empty.

Functions

func GenerateRunID

func GenerateRunID() string

func HashString

func HashString(s string) string

func JournalMap

func JournalMap(run *PersistedRun) map[int]JournalEntry

func PersistScript

func PersistScript(name, runID, script string) string

func SaveRun

func SaveRun(state *PersistedRun)

Types

type AgentOptions

type AgentOptions struct {
	Label     string          `json:"label,omitempty"`
	Phase     string          `json:"phase,omitempty"`
	Schema    json.RawMessage `json:"schema,omitempty"`
	Model     string          `json:"model,omitempty"`
	Effort    string          `json:"effort,omitempty"`
	TimeoutMs int             `json:"timeoutMs,omitempty"`
}

type AgentRequest

type AgentRequest struct {
	Prompt  string
	Options AgentOptions
	Phase   string
	Model   string
	Effort  string
	Index   int
	Workdir string
}

type AgentSnapshot

type AgentSnapshot struct {
	Index  int
	Label  string
	Phase  string
	Model  string
	Status RunStatus
	Error  string
}

type Events

type Events struct {
	OnAgentStart func(index int, label, phase, model string)
	OnAgentEnd   func(index int, label, phase string, result any, tokens int, err string)
	OnJournal    func(e JournalEntry)
	OnPhase      func(title string)
	OnLog        func(msg string)
}

type JournalEntry

type JournalEntry struct {
	Index  int    `json:"index"`
	Hash   string `json:"hash"`
	Result any    `json:"result"`
}

type ManagedRun

type ManagedRun struct {
	ID         string
	Name       string
	Status     RunStatus
	ScriptPath string
	Done       chan struct{}
	// contains filtered or unexported fields
}

type Manager

type Manager struct {
	OnSettle func(run RunSummary)
	// contains filtered or unexported fields
}

func NewManager

func NewManager(runner Runner, cwd string) *Manager

func (*Manager) List

func (m *Manager) List() []RunSummary

func (*Manager) Snapshot

func (m *Manager) Snapshot(id string) (Snapshot, bool)

func (*Manager) Start

func (m *Manager) Start(script string, args any, resumeFromRunID string) (RunSummary, error)

func (*Manager) Stop

func (m *Manager) Stop(id string) bool

type Meta

type Meta struct {
	Name        string      `json:"name"`
	Description string      `json:"description"`
	WhenToUse   string      `json:"whenToUse,omitempty"`
	Phases      []MetaPhase `json:"phases,omitempty"`
	Model       string      `json:"model,omitempty"`
	Effort      string      `json:"effort,omitempty"`
}

func Parse

func Parse(script string) (Meta, string, error)

type MetaPhase

type MetaPhase struct {
	Title  string `json:"title"`
	Detail string `json:"detail,omitempty"`
	Model  string `json:"model,omitempty"`
	Effort string `json:"effort,omitempty"`
}

type Options

type Options struct {
	RunID string
	Cwd   string
	Args  any
	Run   Runner

	ResumeJournal map[int]JournalEntry
	Events        Events
	Concurrency   int
	MaxAgents     int
	// contains filtered or unexported fields
}

type PersistedRun

type PersistedRun struct {
	RunID      string         `json:"runId"`
	Name       string         `json:"name"`
	ScriptPath string         `json:"scriptPath,omitempty"`
	Status     string         `json:"status"`
	Args       any            `json:"args,omitempty"`
	Journal    []JournalEntry `json:"journal"`
	Result     any            `json:"result,omitempty"`
	Error      string         `json:"error,omitempty"`
	StartedAt  int64          `json:"startedAt"`
	FinishedAt int64          `json:"finishedAt,omitempty"`
}

func LoadRun

func LoadRun(runID string) *PersistedRun

type Result

type Result struct {
	RunID      string
	Meta       Meta
	Value      any
	AgentCount int
	Tokens     int
	Phases     []string
	Duration   time.Duration
	Journal    []JournalEntry
}

func Run

func Run(ctx context.Context, script string, opts Options) (*Result, error)

type RunStatus

type RunStatus string
const (
	RunRunning  RunStatus = "running"
	RunComplete RunStatus = "complete"
	RunError    RunStatus = "error"
	RunStopped  RunStatus = "stopped"
)

type RunSummary

type RunSummary struct {
	ID         string
	Name       string
	Status     RunStatus
	ScriptPath string
	Done       chan struct{}
}

type Runner

type Runner func(ctx context.Context, req AgentRequest) (result any, usage Usage, err error)

type Snapshot

type Snapshot struct {
	RunID    string
	Name     string
	Status   RunStatus
	Phase    string
	Phases   []string
	Agents   []AgentSnapshot
	Logs     []string
	Result   any
	Error    string
	Duration time.Duration
}

type Usage

type Usage struct{ Total int }

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL