taskruns

package
v0.4.3 Latest Latest
Warning

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

Go to latest
Published: May 31, 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