Help us shape the future of Go! Take the 2026 Go Developer Survey

taskruns

package
v0.4.4 Latest Latest
Warning

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

Go to latest
Published: Jun 7, 2026 License: Apache-2.0 Imports: 0 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type PersistedCheck

type PersistedCheck struct {
	ID             string               `json:"id"`
	Description    string               `json:"description,omitempty"`
	Command        string               `json:"command"`
	PreConditions  []PersistedCondition `json:"pre_conditions,omitempty"`
	PostConditions []PersistedCondition `json:"post_conditions,omitempty"`
}

PersistedCheck stores one compiled check definition.

type PersistedCheckpointHint

type PersistedCheckpointHint struct {
	Enabled bool `json:"enabled,omitempty"`
}

PersistedCheckpointHint stores checkpoint metadata for a node or step.

type PersistedCompiledStepSnapshot

type PersistedCompiledStepSnapshot struct {
	ID           string                   `json:"id"`
	Path         string                   `json:"path"`
	ParentPath   string                   `json:"parentPath,omitempty"`
	NextPath     string                   `json:"nextPath,omitempty"`
	Name         string                   `json:"name,omitempty"`
	Description  string                   `json:"description,omitempty"`
	Instructions string                   `json:"instructions,omitempty"`
	AllowedTools []string                 `json:"allowedTools,omitempty"`
	Checkpoint   *PersistedCheckpointHint `json:"checkpoint,omitempty"`
	Checks       []PersistedCheck         `json:"checks"`
	Invariants   []PersistedInvariant     `json:"invariants,omitempty"`
}

PersistedCompiledStepSnapshot stores one compiled executable step.

type PersistedCompiledWorkflowSnapshot

type PersistedCompiledWorkflowSnapshot struct {
	Nodes               map[string]PersistedWorkflowNodeSnapshot `json:"nodes,omitempty"`
	OnboardingPath      string                                   `json:"onboardingPath,omitempty"`
	PlanningPath        string                                   `json:"planningPath,omitempty"`
	FirstExecutablePath string                                   `json:"firstExecutablePath,omitempty"`
	WorkflowSteps       []PersistedCompiledStepSnapshot          `json:"workflowSteps,omitempty"`
}

PersistedCompiledWorkflowSnapshot stores the compiled workflow graph and flattened steps.

type PersistedCondition

type PersistedCondition struct {
	Type   string `json:"type"`
	Value  any    `json:"value,omitempty"`
	Values []any  `json:"values,omitempty"`
	Path   string `json:"path,omitempty"`
}

PersistedCondition stores one serialized precondition or postcondition.

type PersistedExecutionNodeSpec

type PersistedExecutionNodeSpec struct {
	ID           string                       `json:"id"`
	Kind         string                       `json:"kind,omitempty"`
	Name         string                       `json:"name,omitempty"`
	Description  string                       `json:"description,omitempty"`
	Instructions string                       `json:"instructions,omitempty"`
	AllowedTools []string                     `json:"toolsAllowed,omitempty"`
	Checkpoint   *PersistedCheckpointHint     `json:"checkpoint,omitempty"`
	Checks       []PersistedCheck             `json:"checks,omitempty"`
	Invariants   []PersistedInvariant         `json:"invariants,omitempty"`
	Next         string                       `json:"next,omitempty"`
	SubSteps     []PersistedExecutionNodeSpec `json:"subSteps,omitempty"`
}

PersistedExecutionNodeSpec stores one execution node from the authored workflow.

type PersistedInvariant

type PersistedInvariant struct {
	ID          string `json:"id"`
	Description string `json:"description,omitempty"`
	Command     string `json:"command"`
}

PersistedInvariant stores one compiled invariant definition.

type PersistedLifecycleNodeSpec

type PersistedLifecycleNodeSpec struct {
	Instructions string                   `json:"instructions,omitempty"`
	AllowedTools []string                 `json:"toolsAllowed,omitempty"`
	Checkpoint   *PersistedCheckpointHint `json:"checkpoint,omitempty"`
}

PersistedLifecycleNodeSpec stores one onboarding lifecycle node snapshot.

type PersistedOnboardingArtifact

type PersistedOnboardingArtifact struct {
	TaskSummary    string                           `json:"taskSummary"`
	ArtifactMap    []PersistedOnboardingArtifactRef `json:"artifactMap,omitempty"`
	CommonCommands []PersistedOnboardingCommand     `json:"commonCommands,omitempty"`
	Constraints    []string                         `json:"constraints,omitempty"`
	OpenQuestions  []string                         `json:"openQuestions,omitempty"`
}

PersistedOnboardingArtifact captures the completed onboarding payload for one run.

type PersistedOnboardingArtifactRef

type PersistedOnboardingArtifactRef struct {
	Path  string `json:"path"`
	Kind  string `json:"kind"`
	Notes string `json:"notes,omitempty"`
}

PersistedOnboardingArtifactRef points at one onboarding artifact discovered during onboarding.

type PersistedOnboardingCommand

type PersistedOnboardingCommand struct {
	Command string `json:"command"`
	Purpose string `json:"purpose"`
}

PersistedOnboardingCommand records one common command captured during onboarding.

type PersistedPlanningArtifact

type PersistedPlanningArtifact struct {
	PlanSummary   string            `json:"planSummary,omitempty"`
	SelectedFiles []string          `json:"selectedFiles,omitempty"`
	Parameters    map[string]string `json:"parameters,omitempty"`
	Invariants    []string          `json:"invariants,omitempty"`
}

PersistedPlanningArtifact captures the completed planning payload for one run.

type PersistedPlanningNodeSpec

type PersistedPlanningNodeSpec struct {
	Instructions   string                   `json:"instructions,omitempty"`
	AllowedTools   []string                 `json:"toolsAllowed,omitempty"`
	Checkpoint     *PersistedCheckpointHint `json:"checkpoint,omitempty"`
	EditableFields []string                 `json:"editableFields,omitempty"`
	RequiredInputs []string                 `json:"requiredInputs,omitempty"`
	Next           string                   `json:"next,omitempty"`
}

PersistedPlanningNodeSpec stores the planning node snapshot.

type PersistedRunSnapshot

type PersistedRunSnapshot struct {
	RunID                   string                       `json:"runId"`
	TemplateID              string                       `json:"templateId"`
	TemplateName            string                       `json:"templateName"`
	TaskDescription         string                       `json:"taskDescription,omitempty"`
	Status                  string                       `json:"status"`
	Phase                   string                       `json:"phase"`
	WorkflowReady           bool                         `json:"workflowReady"`
	LastFailureMessage      string                       `json:"lastFailureMessage,omitempty"`
	ExplicitFailReason      string                       `json:"explicitFailReason,omitempty"`
	LastActivityAtUnixMilli int64                        `json:"lastActivityAtUnixMilli,omitempty"`
	ExpiresAtUnixMilli      int64                        `json:"expiresAtUnixMilli,omitempty"`
	Onboarding              *PersistedOnboardingArtifact `json:"onboarding,omitempty"`
	Planning                *PersistedPlanningArtifact   `json:"planning,omitempty"`
	SelectedTemplate        PersistedTemplateSnapshot    `json:"selectedTemplate"`
	RunnableTemplate        *PersistedTemplateSnapshot   `json:"runnableTemplate,omitempty"`
	Steps                   []PersistedStepStateSnapshot `json:"steps,omitempty"`
}

PersistedRunSnapshot is the latest persisted snapshot of one task run.

type PersistedStepStateSnapshot

type PersistedStepStateSnapshot struct {
	ID                 string            `json:"id"`
	Path               string            `json:"path"`
	Status             string            `json:"status"`
	InvariantBaselines map[string]string `json:"invariantBaselines,omitempty"`
}

PersistedStepStateSnapshot stores the latest persisted state for one step in a run.

type PersistedTaskSnapshot

type PersistedTaskSnapshot struct {
	ID           string `json:"id"`
	Name         string `json:"name"`
	Description  string `json:"description"`
	Instructions string `json:"instructions,omitempty"`
}

PersistedTaskSnapshot stores the user-facing task metadata for a template.

type PersistedTemplateParameter

type PersistedTemplateParameter struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
}

PersistedTemplateParameter stores one declared template parameter.

type PersistedTemplateSnapshot

type PersistedTemplateSnapshot struct {
	Version          string                             `json:"version"`
	Task             PersistedTaskSnapshot              `json:"task"`
	Parameters       []PersistedTemplateParameter       `json:"parameters,omitempty"`
	Workflow         *PersistedWorkflowSnapshot         `json:"workflow"`
	CompiledWorkflow *PersistedCompiledWorkflowSnapshot `json:"compiledWorkflow,omitempty"`
}

PersistedTemplateSnapshot stores the authored template plus its compiled workflow snapshot.

type PersistedWorkflowNodeSnapshot

type PersistedWorkflowNodeSnapshot struct {
	Path                   string                   `json:"path"`
	Kind                   string                   `json:"kind"`
	ParentPath             string                   `json:"parentPath,omitempty"`
	NextPath               string                   `json:"nextPath,omitempty"`
	StepNumber             int                      `json:"stepNumber,omitempty"`
	StepID                 string                   `json:"stepId,omitempty"`
	Name                   string                   `json:"name,omitempty"`
	Description            string                   `json:"description,omitempty"`
	Instructions           string                   `json:"instructions,omitempty"`
	AllowedTools           []string                 `json:"allowedTools,omitempty"`
	Checkpoint             *PersistedCheckpointHint `json:"checkpoint,omitempty"`
	EditableFields         []string                 `json:"editableFields,omitempty"`
	RequiredPlanningInputs []string                 `json:"requiredPlanningInputs,omitempty"`
}

PersistedWorkflowNodeSnapshot stores one compiled workflow node.

type PersistedWorkflowSnapshot

type PersistedWorkflowSnapshot struct {
	Onboarding  *PersistedLifecycleNodeSpec  `json:"onboarding"`
	Planning    *PersistedPlanningNodeSpec   `json:"planning"`
	Scaffolding []PersistedExecutionNodeSpec `json:"scaffolding,omitempty"`
	Execution   []PersistedExecutionNodeSpec `json:"execution"`
}

PersistedWorkflowSnapshot stores the authored workflow sections from a template.

Jump to

Keyboard shortcuts

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