Versions in this module Expand all Collapse all v0 v0.2.1 Nov 14, 2026 v0.2.0 Nov 13, 2026 Changes in this version + const ContainerActionV1 + const DefaultDefinitionsDir + const DurableExternalInputV1 + const DurableTaskStateV1 + const GitHubContainersV1 + const MaxCommandOutput + const MaxHelperBytes + const MaxHelperFiles + const OrderedDynamicIterationV1 + const RegisteredGoActionsV1 + const RunStatusCanceled + const RunStatusFailed + const RunStatusInterrupted + const RunStatusNeedsAttention + const RunStatusQueued + const RunStatusRunning + const RunStatusSkipped + const RunStatusSucceeded + const RunStatusWaiting + const StructuredContainersV1 + var ErrActionIntegrity = errors.New("registered action recovery requires attention") + var ErrExternalInput = errors.New("external input conflict") + var ErrExternalInputCanceled = fmt.Errorf("%w: execution canceled", ErrExternalInput) + var ErrExternalInputPaused = fmt.Errorf("%w: execution paused", ErrExternalInput) + var ErrProviderFailure = errors.New("classified provider failure") + var ErrStaleExecution = errors.New("execution generation changed") + var ErrUncertainTool = errors.New("external tool outcome is uncertain; inspect before explicit recovery") + var ErrUsageExhausted = errors.New("provider usage exhausted") + func AgentTaskPrompt(prompt string, input any) (string, error) + func CanonicalLocalRef(ref string) (string, error) + func Capabilities() []string + func CombineStructuredOutputs(values []any, schema map[string]any) any + func CompareStructuredOutputs(left, right any) map[string]any + func EstimateAgentPayloadTokens(value any) int + func ExtractJSONValue(text string) (string, any, error) + func FailureClass(err error) string + func IsControllerAction(uses string) bool + func IsLocalWorkflowRef(ref string) bool + func JSONValuesEqual(left, right any) bool + func MergeStructuredOutputs(values []any, schema map[string]any) any + func Redact(text string, secrets map[string]string) string + func RedactError(err error, secrets map[string]string) error + func RedactValue(value any, secrets map[string]string) any + func RegisterAction[I, O any](r *ActionRegistry, name string, spec ActionSpec[I, O]) error + func RestoreDatabase(ctx context.Context, dir, source string, owner *ownership.Lock) (string, error) + func SplitContainerArgs(text string) ([]string, error) + func TaskStateReadOnly(operation string) bool + func ToolWireName(d ToolDefinition) string + func Validate(w *Workflow) error + func ValidateTaskGroup(group string) error + type ActionAttempt struct + Attempt Attempt + Bindings json.RawMessage + BindingsFingerprint string + Context ActionContext + Contract ActionContract + Error string + Input json.RawMessage + InputFingerprint string + Reconciliations []ActionRecoveryObservation + Result ActionValue + Revision int + State string + type ActionCheckpoint struct + Bindings json.RawMessage + Input I + Result ActionResult[O] + type ActionContext struct + Attempt int + AttemptID string + CredentialRefs string + Generation int64 + Iteration int + JobID string + OperationKey string + RunID string + StepID string + type ActionContract struct + Effect ActionEffect + Fingerprint string + Implementation string + InputSchema json.RawMessage + Name string + OutputSchema json.RawMessage + type ActionEffect string + const ActionExternalMutation + const ActionReadOnly + type ActionJournal interface + ActionAttempts func(context.Context, string) ([]ActionAttempt, error) + AdmitAction func(context.Context, ActionAttempt) error + CheckpointAction func(context.Context, ActionAttempt) error + type ActionReconciliation struct + Outcome string + Proof json.RawMessage + Result ActionResult[O] + type ActionRecoveryObservation struct + Error string + Generation int64 + Outcome string + Proof json.RawMessage + Time time.Time + type ActionRegistry struct + type ActionRequest struct + Iteration int + JobID string + Metadata map[string]any + Needs map[string]JobExecution + RunID string + Secrets map[string]string + StepID string + Steps map[string]StepExecution + Uses string + With map[string]any + type ActionResult struct + Evidence json.RawMessage + Output O + Receipt json.RawMessage + type ActionRunner interface + Admission func(context.Context, map[string]*Workflow) (map[string]any, error) + RunAction func(context.Context, ActionRequest) (map[string]any, error) + type ActionSpec struct + Bindings func(context.Context, ActionContext, I) (json.RawMessage, error) + Effect ActionEffect + Handler func(context.Context, ActionContext, I) (ActionResult[O], error) + Implementation string + Reconcile func(context.Context, ActionContext, ActionCheckpoint[I, O]) (ActionReconciliation[O], error) + ValidateCheckpoint func(context.Context, ActionContext, ActionCheckpoint[I, O]) error + type ActionValue struct + Evidence json.RawMessage + Output json.RawMessage + Receipt json.RawMessage + type AgentDefinition struct + Bytes string + Description string + DeveloperInstructions string + Model string + Name string + ReasoningEffort string + Source string + func LoadAgentDefinition(path string) (*AgentDefinition, error) + type AgentOutputContract struct + Format string + RepairAttempts int + Schema map[string]any + func ParseAgentOutputContract(raw any) (*AgentOutputContract, error) + func (c *AgentOutputContract) Enabled() bool + func (c *AgentOutputContract) Instruction() string + func (c *AgentOutputContract) Validate() error + type AgentRequest struct + AgentID string + Definition *AgentDefinition + Generation int64 + Input any + InvocationID string + Model string + ObserveUsage func(UsageUpdate) error + Output *AgentOutputContract + ParentWorkerID string + Prompt string + RepairOnly bool + RunID string + SessionOwnerID string + Tools *InvocationTools + Turns int + Workspace string + func (request AgentRequest) DetachStructuredContract() (AgentRequest, *AgentOutputContract) + type AgentRunner interface + RunAgent func(context.Context, AgentRequest) (map[string]any, error) + type AgentTaskDispatch struct + Input AgentTaskInput + Operation string + Reference string + type AgentTaskInput struct + Definition *AgentDefinition + Input any + Model string + Output *AgentOutputContract + Prompt string + Turns int + Workspace string + type Artifact struct + AttemptID string + ID string + Name string + RunID string + SHA256 string + Size int + type Attempt struct + AgentTask *AgentTaskDispatch + Conversation *ConversationState + FinishedAt time.Time + ID string + InputFingerprint string + Iteration int + JobID string + Number int + Phase string + RepairCount int + RepairOutputs []map[string]any + Result StepExecution + RunID string + StartedAt time.Time + Status string + StepID string + TaskAttemptID string + TaskOutputs map[string]any + type Broker struct + External ExternalToolDispatcher + Store *SQLiteStore + Workers *WorkerManager + func (b *Broker) Bind(ctx context.Context, in ToolInvocation) (ToolBinding, error) + type Capacity struct + MaxSuspended int + Slots chan struct{} + func (p *Capacity) Acquire(ctx context.Context) (*CapacityLease, error) + func (p *Capacity) Suspended() int + func (p *Capacity) TryAcquire() (*CapacityLease, bool) + type CapacityLease struct + func (l *CapacityLease) Reacquire(ctx context.Context) error + func (l *CapacityLease) Release() + func (l *CapacityLease) Suspend() error + type ChannelMessageTrigger struct + Channels StringList + Chats StringList + Command string + Conversation ConversationSpec + Mentioned *bool + Passthrough *bool + Senders StringList + TextMatches string + type CommandTrigger struct + Args map[string]Input + Channels StringList + Chats StringList + Conversation ConversationSpec + Name string + Passthrough *bool + Senders StringList + type ContainerImplementation struct + Bundle *HelperBundle + ContractVersion int + Guardian runtimeexec.GuardianAsset + Image containerapi.Image + Policy runtimeexec.Policy + Selection containerapi.Selection + type ConversationDelivery struct + From string + ID string + Message string + To string + type ConversationReceipt struct + Fingerprint string + Reply json.RawMessage + type ConversationSpec struct + Delivery string + Session string + type ConversationState struct + Active *ConversationDelivery + Calls int + Deadline time.Time + Failure string + FinishBy string + Finished bool + IntegrityFailure bool + MaxCalls int + MaxMessages int + Messages int + Prompt string + Queue []ConversationDelivery + Receipts map[string]ConversationReceipt + Result any + Roles []string + Sessions map[string]string + Transcript []ConversationDelivery + Turns int + type Definition struct + Call *WorkflowCall + Error string + Name string + Ref string + type Delivery struct + Channel string + ChatID string + MessageID string + ReplyHandles map[string]string + ReplyToMessageID string + ThreadTS string + TopicID string + type Event struct + Data json.RawMessage + RunID string + Sequence int64 + Time time.Time + Type string + Version int + type EventEntityTrigger struct + Attributes map[string]StringList + IDs StringList + Types StringList + type EventTrigger struct + Actor *EventEntityTrigger + Attributes map[string]StringList + Connectors StringList + Sources StringList + Subject *EventEntityTrigger + Types StringList + type Executor struct + ActionFactory func(json.RawMessage) (ActionRunner, error) + Actions ActionRunner + Agents AgentRunner + ApplicationActions *ActionRegistry + BeforeFinalize func(context.Context, string) error + BindTools ToolBinder + Capacity *Capacity + CommandExecution runtimeexec.Policy + ContainerGuardianDirectory string + DefinitionsDir string + MaxParallel int + Ready func(context.Context) error + RoleRunner func(json.RawMessage) (AgentRunner, error) + Roles json.RawMessage + Slots chan struct{} + Store RunStore + Workers *WorkerManager + WorkspaceDir string + func (e *Executor) Discover() ([]Definition, error) + func (e *Executor) Load(ref string) (map[string]*Workflow, error) + func (e *Executor) Prepare(ctx context.Context, req RunRequest) (*Run, error) + func (e *Executor) Resume(ctx context.Context, id string, secrets map[string]string, retry bool) (result *Run, err error) + func (e *Executor) Run(ctx context.Context, req RunRequest) (*Run, error) + type ExternalInputAnswer struct + AnswerID string + EvidenceID string + Value json.RawMessage + type ExternalInputControl struct + Canceled bool + Continuation bool + Paused bool + type ExternalInputGate struct + Answer *ExternalInputAnswer + EvidenceID string + Fingerprint string + Generation int64 + History []ExternalInputObservation + ID string + Iteration int + JobID string + OriginID string + Payload json.RawMessage + Prompt string + RunID string + State string + StepID string + type ExternalInputJournal interface + AcceptInput func(context.Context, string, string, ExternalInputAnswer) (ExternalInputGate, error) + ConsumeInput func(context.Context, string) (ExternalInputGate, error) + EnsureInputGate func(context.Context, ExternalInputGate) (ExternalInputGate, error) + InputControl func(context.Context, string) (ExternalInputControl, error) + Inputs func(context.Context, string) ([]ExternalInputGate, error) + QueueResume func(context.Context, string, string, bool, int) (*Run, error) + type ExternalInputObservation struct + Generation int64 + State string + Time time.Time + type ExternalIntent struct + Key string + Kind string + Payload map[string]any + Result map[string]any + RunID string + Status string + type ExternalToolDispatcher func(context.Context, ToolDefinition, json.RawMessage) (json.RawMessage, error) + type FileStore struct + Dir string + func (s FileStore) Save(ctx context.Context, run *Run) error + type ForEach struct + Concurrency *int + Items any + Key string + type HelperBundle struct + Files []HelperFile + ID string + OriginID string + type HelperFile struct + Mode uint32 + Path string + SHA256 string + Size int64 + type Input struct + Default any + Required bool + Type string + type InvocationTools struct + Binding ToolBinding + Lease *CapacityLease + type InvocationUsage struct + Observations map[string]UsageObservation + type IterationItemResult struct + Attempt int + ChildID string + Error string + FailureClass string + Fingerprint string + Jobs map[string]JobExecution + Key string + Number int + Outputs map[string]any + PlanFingerprint string + Status string + type IterationJournal interface + AppendIteration func(context.Context, string, string, IterationItemResult) error + BeginInput func(context.Context, string, string, string, int, bool, string, bool, string) (Attempt, bool, error) + CheckIteration func(context.Context) error + IterationAttempts func(context.Context, string, string) ([]IterationItemResult, error) + IterationPlan func(context.Context, string, string) (IterationPlan, error) + IterationRun func(context.Context, string, string, string) (string, error) + PinIteration func(context.Context, IterationPlan) error + type IterationPlan struct + Fingerprint string + Items []IterationPlanItem + JobID string + RunID string + type IterationPlanItem struct + Inputs map[string]any + Item any + Key string + Number int + type Job struct + Container *JobContainer + Context RunContext + ContinueOnError bool + ForEach *ForEach + If string + Name string + Needs StringList + Outputs map[string]string + Repeat *Repeat + RunsOn string + Secrets any + Steps []Step + Uses string + With map[string]any + type JobContainer struct + Files []string + Image string + Implementation *ContainerImplementation + func (c *JobContainer) UnmarshalYAML(n *yaml.Node) error + type JobExecution struct + ChildJobs map[string]JobExecution + ChildRunID string + Complete bool + Error string + FailureClass string + ID string + Items []IterationItemResult + Iterations []JobIteration + Outputs map[string]any + Status string + Steps map[string]StepExecution + type JobIteration struct + Error string + Number int + Outputs map[string]any + Status string + Steps map[string]StepExecution + type Journal interface + Admit func(context.Context, *Run, Snapshot) error + Begin func(context.Context, string, string, string, int, bool) (Attempt, bool, error) + Claim func(context.Context, *Run, string) error + Complete func(context.Context, Attempt, StepExecution) error + Load func(context.Context, string) (*Run, Snapshot, error) + RecordAttempt func(context.Context, Attempt) error + type MessageSummary struct + ID string + Sequence int + Status string + WorkerID string + type NativeTaskRunner interface + AdmitNativeTask func(*AgentDefinition) (*AgentDefinition, error) + type Output struct + Value string + type Page struct + Items []T + NextCursor string + type ProviderCapabilities struct + Interrupt bool + ManagedPolicy bool + Resume bool + Sessions bool + StructuredOutput bool + type ProviderEvent struct + Data map[string]any + SessionID string + Type string + type Removal struct + Kind string + Path string + State string + type Repeat struct + MaxAttempts int + Until string + type ResolvedRef struct + Canonical string + Path string + type Resolver struct + DefinitionsDir string + WorkspaceDir string + func (r Resolver) ResolveLocal(ref string) (ResolvedRef, error) + type Retention struct + OriginID string + Removals []Removal + Root string + State string + UpdatedAt time.Time + type Run struct + Error string + FailureClass string + FinishedAt time.Time + Generation int64 + ID string + Jobs map[string]JobExecution + OriginID string + Outputs map[string]any + Owner string + StartedAt time.Time + Status string + Usage *UsageSummary + Version int + WorkflowRef string + type RunContext struct + Delivery string + Session string + type RunRequest struct + Event map[string]any + Execution runtimeexec.Policy + Inputs map[string]any + Metadata map[string]any + Ref string + RequestID string + RetryUncertain bool + SecretRefs map[string]string + Secrets map[string]string + TaskGroup string + type RunStore interface + Save func(context.Context, *Run) error + type RunSummary struct + Generation int64 + ID string + OriginID string + Status string + Updated string + WorkflowRef string + type RuntimeEventTrigger struct + Agents StringList + Channels StringList + Chats StringList + Kinds StringList + Sessions StringList + Sources StringList + type SQLiteStore struct + Dir string + func OpenSQLite(dir string) (*SQLiteStore, error) + func OpenSQLiteInspection(dir string) (*SQLiteStore, error) + func (s *SQLiteStore) AcceptInput(ctx context.Context, origin, id string, a ExternalInputAnswer) (ExternalInputGate, error) + func (s *SQLiteStore) ActionAttempts(ctx context.Context, run string) ([]ActionAttempt, error) + func (s *SQLiteStore) AdmissionRequest(ctx context.Context, requestID string) (*Run, Snapshot, error) + func (s *SQLiteStore) Admit(ctx context.Context, r *Run, snap Snapshot) error + func (s *SQLiteStore) AdmitAction(ctx context.Context, a ActionAttempt) error + func (s *SQLiteStore) AdmitInvocation(ctx context.Context, record runtimeexec.Record) error + func (s *SQLiteStore) AppendIteration(ctx context.Context, run, job string, r IterationItemResult) error + func (s *SQLiteStore) Artifact(ctx context.Context, run, id string) ([]byte, error) + func (s *SQLiteStore) Artifacts(ctx context.Context, run string) ([]Artifact, error) + func (s *SQLiteStore) Attempts(ctx context.Context, id string) ([]Attempt, error) + func (s *SQLiteStore) Backup(ctx context.Context, destination string, owner *ownership.Lock) error + func (s *SQLiteStore) Begin(ctx context.Context, run, job, step string, iteration int, retry bool) (Attempt, bool, error) + func (s *SQLiteStore) BeginBlock(ctx context.Context, run, job, step string, iteration int) (Attempt, bool, error) + func (s *SQLiteStore) BeginConversation(ctx context.Context, run, job, step string, iteration int, ...) (Attempt, bool, error) + func (s *SQLiteStore) BeginFinalization(ctx context.Context, run *Run) error + func (s *SQLiteStore) BeginInput(ctx context.Context, run, job, step string, iteration int, retry bool, ...) (Attempt, bool, error) + func (s *SQLiteStore) BeginRetention(ctx context.Context, record Retention, owner *ownership.Lock) (Retention, error) + func (s *SQLiteStore) BeginUsage(ctx context.Context, identity UsageIdentity) error + func (s *SQLiteStore) CancellationRequested(ctx context.Context, id string) (bool, error) + func (s *SQLiteStore) CaptureHelperBundle(ctx context.Context, origin, base string, declarations []string) (bundle *HelperBundle, returned error) + func (s *SQLiteStore) CheckCleanupPrerequisites(ctx context.Context) error + func (s *SQLiteStore) CheckInvocationCleanup(ctx context.Context, run string) error + func (s *SQLiteStore) CheckIteration(ctx context.Context) error + func (s *SQLiteStore) CheckToolEffects(ctx context.Context, run string) error + func (s *SQLiteStore) CheckWorkerAdmission(ctx context.Context, run string) error + func (s *SQLiteStore) CheckpointAction(ctx context.Context, a ActionAttempt) error + func (s *SQLiteStore) Claim(ctx context.Context, r *Run, previous string) error + func (s *SQLiteStore) CleanupHelperStaging(ctx context.Context, owner *ownership.Lock) error + func (s *SQLiteStore) Close() error + func (s *SQLiteStore) Complete(ctx context.Context, a Attempt, result StepExecution) error + func (s *SQLiteStore) ConsumeInput(ctx context.Context, id string) (ExternalInputGate, error) + func (s *SQLiteStore) ConversationAttempt(ctx context.Context, run, job, step string, iteration int, logical string) (Attempt, bool, error) + func (s *SQLiteStore) Delete(ctx context.Context, id string) error + func (s *SQLiteStore) DeleteOrigin(ctx context.Context, id string) error + func (s *SQLiteStore) EnsureInputGate(ctx context.Context, g ExternalInputGate) (ExternalInputGate, error) + func (s *SQLiteStore) Events(ctx context.Context, id string, after int64) ([]Event, error) + func (s *SQLiteStore) ExecutionRetry(ctx context.Context, id string, generation int64) (bool, error) + func (s *SQLiteStore) FinishRetention(ctx context.Context, record Retention, owner *ownership.Lock) error + func (s *SQLiteStore) HelperBundlePath(bundle *HelperBundle) (string, error) + func (s *SQLiteStore) InitIntents(ctx context.Context) error + func (s *SQLiteStore) InputControl(ctx context.Context, origin string) (c ExternalInputControl, err error) + func (s *SQLiteStore) Inputs(ctx context.Context, run string) ([]ExternalInputGate, error) + func (s *SQLiteStore) InspectTaskState(ctx context.Context, run string) (TaskStateInspection, error) + func (s *SQLiteStore) Intent(ctx context.Context, key string) (ExternalIntent, error) + func (s *SQLiteStore) InterruptInput(ctx context.Context, origin string, generation int64) error + func (s *SQLiteStore) InvocationDirectories(ctx context.Context, origin string) ([]string, error) + func (s *SQLiteStore) Invocations(ctx context.Context, run string, pending bool) ([]runtimeexec.Record, error) + func (s *SQLiteStore) IterationAttempts(ctx context.Context, run, job string) ([]IterationItemResult, error) + func (s *SQLiteStore) IterationPlan(ctx context.Context, run, job string) (p IterationPlan, err error) + func (s *SQLiteStore) IterationRun(ctx context.Context, run, logical, job string) (string, error) + func (s *SQLiteStore) List(ctx context.Context) ([]Run, error) + func (s *SQLiteStore) ListPage(ctx context.Context, limit int, cursor string) (Page[RunSummary], error) + func (s *SQLiteStore) Load(ctx context.Context, id string) (*Run, Snapshot, error) + func (s *SQLiteStore) Metrics(ctx context.Context) (StoreMetrics, error) + func (s *SQLiteStore) Migrate(ctx context.Context, owner *ownership.Lock) error + func (s *SQLiteStore) ObserveUsage(ctx context.Context, identity UsageIdentity, update UsageUpdate) error + func (s *SQLiteStore) OriginRuns(ctx context.Context, id string) ([]Run, error) + func (s *SQLiteStore) PinIteration(ctx context.Context, p IterationPlan) error + func (s *SQLiteStore) ProbeStorage(ctx context.Context) error + func (s *SQLiteStore) PutIntent(ctx context.Context, intent ExternalIntent) error + func (s *SQLiteStore) QueueDepth(ctx context.Context) (int, error) + func (s *SQLiteStore) QueueInputContinuations(ctx context.Context, maxQueued int) error + func (s *SQLiteStore) QueueInputContinuationsExcept(ctx context.Context, maxQueued int, active ...string) error + func (s *SQLiteStore) QueueResume(ctx context.Context, id, requestID string, retry bool, maxQueued int) (*Run, error) + func (s *SQLiteStore) Queued(ctx context.Context) ([]Run, error) + func (s *SQLiteStore) ReconcileInvocations(ctx context.Context, run string) error + func (s *SQLiteStore) RecordAttempt(ctx context.Context, a Attempt) error + func (s *SQLiteStore) Recover(ctx context.Context) error + func (s *SQLiteStore) RecoverToolCalls(ctx context.Context) error + func (s *SQLiteStore) RecoveryBundle(ctx context.Context, destination string, owner *ownership.Lock) error + func (s *SQLiteStore) RequestCancel(ctx context.Context, id string) error + func (s *SQLiteStore) RequestCancelGeneration(ctx context.Context, id string, generation int64) error + func (s *SQLiteStore) RequireCurrentSchema() error + func (s *SQLiteStore) ResumeRequest(ctx context.Context, id, requestID string, retry bool) (*Run, error) + func (s *SQLiteStore) Retention(ctx context.Context, id string) (Retention, error) + func (s *SQLiteStore) Save(ctx context.Context, r *Run) error + func (s *SQLiteStore) SaveRetention(ctx context.Context, record Retention, owner *ownership.Lock) error + func (s *SQLiteStore) TaskState(ctx context.Context, req TaskStateRequest) (TaskStateResponse, error) + func (s *SQLiteStore) ToolCalls(ctx context.Context, run string, unresolved bool) ([]ToolCallRecord, error) + func (s *SQLiteStore) UpdateInvocation(ctx context.Context, record runtimeexec.Record) error + func (s *SQLiteStore) Usage(ctx context.Context, run string) (UsageReport, error) + func (s *SQLiteStore) VerifyHelperBundle(bundle *HelperBundle) error + type ScheduleTrigger struct + Cron string + type Secret struct + Required bool + type SessionRequest struct + SessionID string + type SessionResult struct + Outputs map[string]any + ProviderStatus string + ProviderVersion string + SessionID string + Status string + type SessionRunner interface + Capabilities func(string) (ProviderCapabilities, error) + RunTurn func(context.Context, SessionRequest, func(ProviderEvent)) (SessionResult, error) + type Snapshot struct + ActionContracts map[string]ActionContract + CredentialAliases map[string]string + Definitions map[string]*Workflow + Event map[string]any + Execution runtimeexec.Policy + Hashes map[string]string + Inputs map[string]any + Metadata map[string]any + Parallel int + RequestID string + RequiredSecrets []string + Roles json.RawMessage + SecretRefs map[string]string + Version int + type Step struct + Argv []string + ContainerImplementation *ContainerImplementation + Context RunContext + ContinueOnError bool + Conversation []string + Definition *AgentDefinition + Effect ActionEffect + Env map[string]string + Files []string + Finally []Step + FinishBy string + HandlerTimeout string + ID string + If string + Input map[string]any + InputSchema any + MaxMessages int + MaxTurns int + Name string + OnComplete []Step + OnError []Step + OnFailure []Step + OnIncomplete []Step + OnResult []Step + OutputSchema any + Parallel []Step + Prompt *string + Protocol string + Run string + Sequence []Step + Shell string + Start string + Timeout string + Uses string + With map[string]any + WorkingDirectory string + func FlattenSteps(steps []Step) []Step + type StepExecution struct + AttemptID string + Error string + FailureClass string + FinishedAt time.Time + ID string + Lifecycle *StepLifecycle + Outputs map[string]any + StartedAt time.Time + Status string + UnsafeFailureClass string + type StepLifecycle struct + Agent string + Candidate map[string]any + Deadline time.Time + Handlers map[string][]StepExecution + OriginalClass string + OriginalError string + Skipped map[string]string + Verification any + Verifications []any + type StoreMetrics struct + CleanupBacklog int + Failures int + QueueAgeSeconds float64 + QueueDepth int + Runs map[string]int + Workers map[string]int + type StringList []string + func (s *StringList) UnmarshalYAML(value *yaml.Node) error + type StructuredOutputResult struct + Error string + RawJSON string + Structured any + Valid bool + func ValidateAgentStructuredOutput(text string, contract *AgentOutputContract) StructuredOutputResult + type TaskBudget struct + Limit int64 + Name string + Used int64 + type TaskClaim struct + EvidenceFingerprint string + Fingerprint string + OperationID string + Owner string + OwnerGeneration int64 + OwnerRun string + Proof json.RawMessage + ResultReference string + State string + Task string + type TaskDeadline struct + Deadline time.Time + Extensions int64 + Name string + OriginalDeadline time.Time + type TaskStateInspection struct + Budgets []TaskBudget + Claims []TaskClaim + Closed bool + Deadlines []TaskDeadline + Group string + Requests []TaskStateRequest + type TaskStateRequest struct + Amount int64 + Deadline time.Time + EvidenceFingerprint string + Fingerprint string + Instruction string + Limit int64 + Name string + Operation string + OperationID string + Outcome string + Proof json.RawMessage + RequestID string + ResultReference string + Source string + Task string + type TaskStateResponse struct + Budget *TaskBudget + Claim *TaskClaim + Closed bool + Deadline *TaskDeadline + Dispatch bool + Reusable bool + type ToolBinder func(context.Context, ToolInvocation) (ToolBinding, error) + type ToolBinding interface + Call func(context.Context, ToolRequest) (json.RawMessage, error) + Catalog func() []ToolDefinition + type ToolCallRecord struct + AdmittedAt time.Time + ArgumentFingerprint string + AuditArguments any + CallID string + Error string + FailureClass string + FinishedAt time.Time + Generation int64 + InvocationID string + Result json.RawMessage + RunID string + Server string + Status string + Tool string + type ToolDefinition struct + ControllerValidation bool + Description string + Fingerprint string + InputSchema json.RawMessage + Name string + Server string + func EngineTools() []ToolDefinition + type ToolGrant struct + Server string + Tool string + type ToolInvocation struct + Access WorkerAccess + Catalog []ToolDefinition + Dispatch ExternalToolDispatcher + Generation int64 + Grants []ToolGrant + InvocationID string + Limits WorkerLimits + NativeTools []string + Owner string + ParentWorkerID string + Role string + RunID string + Secrets map[string]string + Workspace string + type ToolRequest struct + Arguments json.RawMessage + CallID string + Server string + Tool string + type UsageGroup struct + Model string + Provider string + Summary UsageSummary + type UsageIdentity struct + Finished bool + ID string + Kind string + Model string + Provider string + RunID string + SessionID string + TaskAttemptID string + WorkerID string + type UsageObservation struct + CachedInputTokens *int64 + Complete bool + CostUSD *float64 + CounterReset bool + DeltaCachedInputTokens *int64 + DeltaInputTokens *int64 + DeltaOutputTokens *int64 + Final bool + InputTokens *int64 + ObservedAt time.Time + OutputTokens *int64 + Scope string + func NormalizeUsage(update UsageUpdate) UsageObservation + type UsageReport struct + ByProviderModel []UsageGroup + Invocations []InvocationUsage + Summary UsageSummary + type UsageSummary struct + CachedInputTokens *int64 + Complete bool + CostComplete bool + CostUSD *float64 + IncompleteInvocations int + InputTokens *int64 + Invocations int + KnownCostUSD *float64 + OutputTokens *int64 + Overflow bool + func SummarizeUsage(invocations []InvocationUsage) UsageSummary + type UsageUpdate struct + CostUSD any + Final bool + Incomplete bool + Key string + Model string + Provider string + SessionID string + Usage map[string]any + type Worker struct + Access WorkerAccess + CreatorInvocation string + Definition *AgentDefinition + Depth int + Error string + FailureAcknowledgement *WorkerFailureAcknowledgement + FailureClass string + FailureGeneration int64 + ID string + MaxDepth int + MaxOutput int + MaxQueued int + MaxWorkers int + ParentID string + Remaining int + Role string + RunID string + SessionID string + SessionOwnerID string + Status string + TaskTurns int + TaskWorkspace string + ToolGrants []ToolGrant + Tools []string + TurnDuration time.Duration + type WorkerAccess struct + Cleanup string + Container bool + Workspace string + Writable bool + type WorkerFactory func(context.Context, string, string, []string) (SessionRunner, []string, map[string]string, error) + type WorkerFailureAcknowledgement struct + AcknowledgedAt time.Time + Evidence string + Generation int64 + MessageID string + Reason string + RequestID string + type WorkerFailureRequest struct + Evidence string + Generation int64 + MessageID string + Owner string + Reason string + RequestID string + RunID string + WorkerID string + type WorkerLimits struct + MaxDepth int + MaxOutput int + MaxQueued int + MaxTurns int + MaxWorkers int + TurnDuration time.Duration + func DefaultWorkerLimits() WorkerLimits + type WorkerManager struct + AdmissionReady func(context.Context) error + BindTools ToolBinder + Capacity *Capacity + Factory WorkerFactory + Limits WorkerLimits + Slots chan struct{} + Store *SQLiteStore + func (m *WorkerManager) AcknowledgeFailure(ctx context.Context, req WorkerFailureRequest) (WorkerFailureAcknowledgement, error) + func (m *WorkerManager) CancelRun(ctx context.Context, run string) error + func (m *WorkerManager) Get(ctx context.Context, run, id string) (Worker, error) + func (m *WorkerManager) Init(ctx context.Context) error + func (m *WorkerManager) Interrupt(ctx context.Context, run, id string, closeWorker bool) error + func (m *WorkerManager) List(ctx context.Context, run string) ([]Worker, error) + func (m *WorkerManager) ListPage(ctx context.Context, run string, limit int, cursor string) (Page[WorkerSummary], error) + func (m *WorkerManager) Messages(ctx context.Context, run, id string) ([]WorkerMessage, error) + func (m *WorkerManager) MessagesPage(ctx context.Context, run, worker string, limit int, cursor string) (Page[MessageSummary], error) + func (m *WorkerManager) Resume(ctx context.Context, run, id string) error + func (m *WorkerManager) Send(ctx context.Context, run, id, requestID, prompt string) (WorkerMessage, error) + func (m *WorkerManager) Serve(ctx context.Context) + func (m *WorkerManager) Spawn(ctx context.Context, spec WorkerSpec) (Worker, error) + func (m *WorkerManager) StopRun(ctx context.Context, run string) error + func (m *WorkerManager) WaitMessage(ctx context.Context, req WorkerWaitRequest) (WorkerMessage, error) + type WorkerMessage struct + EnqueuedAt time.Time + Error string + FailureAcknowledgement *WorkerFailureAcknowledgement + FailureClass string + FinishedAt time.Time + Generation int64 + ID string + Input any + Model string + Output *AgentOutputContract + Prompt string + QueueTimeMS int64 + RepairOnly bool + RequestID string + Result SessionResult + Sequence int + StartedAt time.Time + Status string + TaskAttemptID string + UnsafeFailureClass string + WorkerID string + type WorkerSpec struct + Boundary *ToolInvocation + CreatorInvocation string + Definition *AgentDefinition + Owner string + ParentID string + Role string + RunID string + StableID string + TaskWorkspace string + ToolGrants []ToolGrant + Tools []string + Turns int + type WorkerSummary struct + ID string + ParentID string + Role string + RunID string + Status string + type WorkerWaitRequest struct + Deadline time.Time + MessageID string + OperationID string + RunID string + WorkerID string + type Workflow struct + Gates map[string]any + Jobs map[string]Job + Name string + On WorkflowTriggers + Schemas map[string]map[string]any + func Parse(data []byte) (*Workflow, error) + func (w *Workflow) UnmarshalYAML(value *yaml.Node) error + type WorkflowCall struct + Inputs map[string]Input + Outputs map[string]Output + Secrets map[string]Secret + type WorkflowTriggers struct + ChannelMessage *ChannelMessageTrigger + Command *CommandTrigger + Event *EventTrigger + Manual map[string]any + RuntimeEvent *RuntimeEventTrigger + Schedule []ScheduleTrigger + WorkflowCall *WorkflowCall + func (t *WorkflowTriggers) UnmarshalYAML(value *yaml.Node) error