generated

type BadRequest = ErrorResponse

type BundledFile struct {
	// Content Inline content payload for a portable bundled file.
	Content BundledFileContent `json:"content"`

	// TargetPath Canonical factory-relative restoration target for the bundled file. Absolute paths, backslash-separated paths, and paths that require dot-segment normalization are rejected.
	TargetPath string `json:"targetPath"`

	// Type Portable file class. SCRIPT entries target factory/scripts/..., DOC entries target factory/docs/..., INPUT entries target factory/inputs/<work-type>/<channel>/..., and ROOT_HELPER entries target supported project-root helper files such as Makefile. Shared-factory INPUT entries snapshot current source inputs at share time instead of creating a live link.
	Type BundledFileType `json:"type"`
}

type BundledFileContent struct {
	// Encoding Declared content encoding for the inline payload. V1 bundled files use UTF-8 text content.
	Encoding BundledFileContentEncoding `json:"encoding"`

	// Inline Inline bundled file content carried in the manifest. Files under factory/scripts/, factory/docs/, and supported root helper paths are only bundled when they appear in bundledFiles.
	Inline string `json:"inline"`
}

type BundledFileContentEncoding string

type BundledFileType string

type ClassificationRoute struct {
	// Label Case-sensitive classifier label that must match the trimmed classifier output exactly.
	Label string `json:"label"`

	// Outputs One or more authored destinations emitted when this classifier label is selected.
	Outputs []WorkstationIO `json:"outputs"`
}

type CommandDiagnostic struct {
	Args          *[]string  `json:"args,omitempty"`
	Command       *string    `json:"command,omitempty"`
	DurationNanos *int64     `json:"durationNanos,omitempty"`
	Env           *StringMap `json:"env,omitempty"`
	ExitCode      *int       `json:"exitCode,omitempty"`
	Stderr        *string    `json:"stderr,omitempty"`
	Stdin         *string    `json:"stdin,omitempty"`
	Stdout        *string    `json:"stdout,omitempty"`
	TimedOut      *bool      `json:"timedOut,omitempty"`
	WorkingDir    *string    `json:"workingDir,omitempty"`
}

type CreateFactoryBadRequest = ErrorResponse

type CreateFactoryConflict = ErrorResponse

type CurrentFactoryNotFound = ErrorResponse

type Diagnostics struct {
	Notes   *[]string                       `json:"notes,omitempty"`
	Workers *map[string]SafeWorkDiagnostics `json:"workers,omitempty"`
}

type DispatchConsumedWorkRef struct {
	// WorkId Canonical work identity for one consumed dispatch input.
	WorkId string `json:"workId"`
}

type DispatchRequestEventMetadata struct {
	// ReplayKey Stable replay correlation key for recorded dispatch reconstruction.
	ReplayKey *string `json:"replayKey,omitempty"`

	// RunnerId Stable built-in runner identifiers supported by factory and workstation runner selection.
	RunnerId *RunnerID `json:"runnerId,omitempty"`

	// RunnerSelectionSource Configuration layer that supplied the resolved built-in runner selection for a dispatch.
	RunnerSelectionSource *RunnerSelectionSource `json:"runnerSelectionSource,omitempty"`
}

type DispatchRequestEventPayload struct {
	// CurrentChainingTraceId Deprecated compatibility copy of the dispatch chaining-trace identifier; prefer FactoryEvent.context.currentChainingTraceId.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	CurrentChainingTraceId *string                   `json:"currentChainingTraceId,omitempty"`
	Inputs                 []DispatchConsumedWorkRef `json:"inputs"`

	// Metadata Optional non-identity dispatch metadata retained on dispatch-request events. Request, trace, work, and dispatch identity must remain on FactoryEvent.context rather than reappearing here.
	Metadata *DispatchRequestEventMetadata `json:"metadata,omitempty"`

	// PreviousChainingTraceIds Deprecated compatibility copy of predecessor chaining traces; prefer FactoryEvent.context.previousChainingTraceIds.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	PreviousChainingTraceIds *[]string   `json:"previousChainingTraceIds,omitempty"`
	Resources                *[]Resource `json:"resources,omitempty"`
	TransitionId             string      `json:"transitionId"`
}

type DispatchResponseEventPayload struct {
	CompletionId *string `json:"completionId,omitempty"`

	// CurrentChainingTraceId Deprecated compatibility copy of the dispatch chaining-trace identifier; prefer FactoryEvent.context.currentChainingTraceId.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	CurrentChainingTraceId *string      `json:"currentChainingTraceId,omitempty"`
	DurationMillis         *int64       `json:"durationMillis,omitempty"`
	Error                  *string      `json:"error,omitempty"`
	FailureMessage         *string      `json:"failureMessage,omitempty"`
	FailureReason          *string      `json:"failureReason,omitempty"`
	Feedback               *string      `json:"feedback,omitempty"`
	Metadata               *StringMap   `json:"metadata,omitempty"`
	Metrics                *WorkMetrics `json:"metrics,omitempty"`

	// Outcome Result category returned by a workstation execution.
	Outcome         WorkOutcome `json:"outcome"`
	Output          *string     `json:"output,omitempty"`
	OutputResources *[]Resource `json:"outputResources,omitempty"`
	OutputWork      *[]Work     `json:"outputWork,omitempty"`

	// PreviousChainingTraceIds Deprecated compatibility copy of predecessor chaining traces; prefer FactoryEvent.context.previousChainingTraceIds.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	PreviousChainingTraceIds    *[]string                `json:"previousChainingTraceIds,omitempty"`
	ProviderFailure             *ProviderFailureMetadata `json:"providerFailure,omitempty"`
	SelectedClassificationLabel *string                  `json:"selectedClassificationLabel,omitempty"`
	TransitionId                string                   `json:"transitionId"`
}

type ErrorFamily string

type ErrorResponse struct {
	// Code Stable machine-readable error code.
	Code ErrorResponseCode `json:"code"`

	// Family Stable machine-readable error family for broader client grouping.
	Family  ErrorFamily `json:"family"`
	Message string      `json:"message"`

	// Targets Optional canonical validation targets that clients can map to factory graph nodes, handles, and form fields.
	Targets *[]FactoryValidationTarget `json:"targets,omitempty"`
}

type ErrorResponseCode string

type ErrorTarget struct {
	// Field Optional request or form field path associated with the error.
	Field *string `json:"field,omitempty"`

	// Id Optional graph entity, relationship, or save condition identifier.
	Id *string `json:"id,omitempty"`

	// Kind Client-visible target category such as form, node, edge, field, or save.
	Kind string `json:"kind"`
}

type Factory struct {
	// FactoryDirectory Directory that contained the factory.json used for this serialized runtime config.
	FactoryDirectory *string `json:"factoryDirectory,omitempty"`

	// Guards Root-level guards that apply across the factory instead of one specific workstation or input.
	Guards *[]FactoryGuard `json:"guards,omitempty"`

	// Id Factory identifier used as the factory-level template context fallback.
	Id *string `json:"id,omitempty"`

	// InputTypes Named input kinds accepted by the factory. The default input type is implicit and must not be declared.
	InputTypes *[]InputType `json:"inputTypes,omitempty"`
	Metadata   *StringMap   `json:"metadata,omitempty"`

	// Name Customer-facing identifier for one stored named factory. `GET /factory-sessions/~default/factory` may also return the reserved `UNDEFINED` identifier when the active runtime is still the default root factory and no durable current-factory pointer exists. Semantic validation failures return `INVALID_FACTORY_NAME`, including attempts to activate a named factory with the reserved identifier.
	Name FactoryName `json:"name"`

	// Resources Shared capacity pools that workers or workstations can consume while work is executing.
	Resources *[]Resource `json:"resources,omitempty"`

	// Runner Stable built-in runner identifiers supported by factory and workstation runner selection.
	Runner *RunnerID `json:"runner,omitempty"`

	// SourceDirectory Original source directory for record/replay and drift diagnostics.
	SourceDirectory *string `json:"sourceDirectory,omitempty"`

	// SupportingFiles Canonical portability manifest for Agent Factory bundles. Required tools are validation-only PATH dependencies; bundled files carry portable content for restoration inside the factory boundary.
	SupportingFiles *ResourceManifest       `json:"supportingFiles,omitempty"`
	Version         *HybridLogicalTimestamp `json:"version,omitempty"`

	// WorkTypes Customer-authored work item categories and the lifecycle states each one can occupy.
	WorkTypes *[]WorkType `json:"workTypes,omitempty"`

	// Workers Reusable worker definitions that workstations reference by name when dispatching work.
	Workers *[]Worker `json:"workers,omitempty"`

	// Workstations Processing steps that consume work, invoke workers, and emit the next work states.
	Workstations *[]Workstation `json:"workstations,omitempty"`
}

type FactoryChangeEventPayload struct {
	// Factory Top-level factory.json contract. Declare the work types, resources, portability resources, workers, and workstations that make up one authored factory here. Guarded loop breakers should be authored as guarded LOGICAL_MOVE workstations using VISIT_COUNT guards instead of a top-level exhaustion-rules field.
	Factory         Factory    `json:"factory"`
	Metadata        *StringMap `json:"metadata,omitempty"`
	SourceDirectory *string    `json:"sourceDirectory,omitempty"`
}

type FactoryEvent struct {
	Context FactoryEventContext `json:"context"`

	// Id Stable event identifier. Record/replay artifacts must preserve this value.
	Id      string               `json:"id"`
	Payload FactoryEvent_Payload `json:"payload"`

	// SchemaVersion Version of the factory event envelope schema.
	SchemaVersion FactoryEventSchemaVersion `json:"schemaVersion"`

	// Type Canonical event vocabulary for customer-visible runtime changes. Work entering the factory is represented as WORK_REQUEST, including single-work submissions that are normalized into one-work requests.
	Type FactoryEventType `json:"type"`
}

type FactoryEventContext struct {
	// CurrentChainingTraceId Canonical chaining-trace identifier for the dispatch currently represented by this event context.
	CurrentChainingTraceId *string `json:"currentChainingTraceId,omitempty"`

	// DispatchId Canonical dispatch identity for dispatch and inference events; payloads must not restate it.
	DispatchId *string `json:"dispatchId,omitempty"`

	// EventTime Wall-clock event timestamp for customer explanation and diagnostics. ISO8601 timestamp.
	EventTime time.Time `json:"eventTime"`

	// PreviousChainingTraceIds Canonical predecessor chaining traces consumed by the dispatch in deterministic order.
	PreviousChainingTraceIds *[]string `json:"previousChainingTraceIds,omitempty"`

	// RequestId Canonical request identity for all request-scoped events; payload metadata must not restate it.
	RequestId *string `json:"requestId,omitempty"`

	// Sequence Append-only event-log sequence number.
	Sequence int `json:"sequence"`

	// Source Human-readable source such as api, filewatcher, replay, cron, or worker.
	Source *string `json:"source,omitempty"`

	// Tick Logical engine tick observed by the runtime.
	Tick int `json:"tick"`

	// TraceIds Canonical trace identifiers that contributed to this event; payloads must not restate them.
	TraceIds *[]string `json:"traceIds,omitempty"`

	// WorkIds Canonical work identities correlated to this event; payloads must not restate them.
	WorkIds *[]string `json:"workIds,omitempty"`
}

type FactoryEventSchemaVersion string

type FactoryEventType string

type FactoryEvent_Payload struct {
	// contains filtered or unexported fields
}

type FactoryGuard struct {
	// Model Optional model name to scope throttling more narrowly than the provider-level window.
	Model *string `json:"model,omitempty"`

	// ModelProvider Provider whose inference-throttle history controls this factory-level guard.
	ModelProvider WorkerModelProvider `json:"modelProvider"`

	// RefreshWindow Duration string that controls how long the factory should keep re-checking throttle history before allowing the lane again.
	RefreshWindow string `json:"refreshWindow"`

	// Type Factory-level guard condition to evaluate before dispatch-ready transitions can proceed.
	Type GuardType `json:"type"`
}

type FactoryName = string

type FactorySaveMode string

type FactorySessionSummary struct {
	FactoryDir string                  `json:"factoryDir"`
	FolderPath string                  `json:"folderPath"`
	Id         string                  `json:"id"`
	IsDefault  bool                    `json:"isDefault"`
	Project    string                  `json:"project"`
	Target     FactorySessionTargetRef `json:"target"`
}

type FactorySessionTarget struct {
	FactoryDir string                  `json:"factoryDir"`
	FolderPath string                  `json:"folderPath"`
	Label      string                  `json:"label"`
	Project    string                  `json:"project"`
	Ref        FactorySessionTargetRef `json:"ref"`
}

type FactorySessionTargetRef struct {
	Kind FactorySessionTargetRefKind `json:"kind"`
	Name *string                     `json:"name,omitempty"`
}

type FactorySessionTargetRefKind string

type FactoryState string

type FactoryStateResponseEventPayload struct {
	// PreviousState Lifecycle state of the running factory.
	PreviousState *FactoryState `json:"previousState,omitempty"`
	Reason        *string       `json:"reason,omitempty"`

	// State Lifecycle state of the running factory.
	State FactoryState `json:"state"`
}

type FactoryValidationResult struct {
	// Targets Canonical validation targets for the submitted factory definition.
	Targets []FactoryValidationTarget `json:"targets"`
}

type FactoryValidationSeverity string

type FactoryValidationSubject struct {
	// Id Stable component identifier or name for the affected factory component.
	Id string `json:"id"`

	// Location Factory-domain location within the subject component referenced by one validation target.
	Location FactoryValidationSubjectLocation `json:"location"`

	// Type Factory-domain component type referenced by one validation target subject.
	Type FactoryValidationSubjectType `json:"type"`
}

type FactoryValidationSubjectLocation string

type FactoryValidationSubjectType string

type FactoryValidationTarget struct {
	// Code Stable machine-readable validation rule identifier.
	Code string `json:"code"`

	// Message Human-readable explanation suitable for dialogs and summaries.
	Message string `json:"message"`

	// Severity Validation severity for one factory validation target.
	Severity FactoryValidationSeverity `json:"severity"`
	Subject  FactoryValidationSubject  `json:"subject"`
}

type FactoryWorldMutationView struct {
	FromPlace *string                `json:"fromPlace,omitempty"`
	Reason    *string                `json:"reason,omitempty"`
	ToPlace   *string                `json:"toPlace,omitempty"`
	Token     *FactoryWorldTokenView `json:"token,omitempty"`
	TokenId   string                 `json:"tokenId"`
	Type      string                 `json:"type"`
}

type FactoryWorldProviderDiagnostic struct {
	Model            *string    `json:"model,omitempty"`
	Provider         *string    `json:"provider,omitempty"`
	RequestMetadata  *StringMap `json:"requestMetadata,omitempty"`
	ResponseMetadata *StringMap `json:"responseMetadata,omitempty"`
}

type FactoryWorldRenderedPromptDiagnostic struct {
	SystemPromptHash *string    `json:"systemPromptHash,omitempty"`
	UserMessageHash  *string    `json:"userMessageHash,omitempty"`
	Variables        *StringMap `json:"variables,omitempty"`
}

type FactoryWorldRunnerBaselineCapability string

type FactoryWorldRunnerCapabilitiesView struct {
	BaselineCapabilities []FactoryWorldRunnerBaselineCapability            `json:"baselineCapabilities"`
	OptionalCapabilities []FactoryWorldRunnerOptionalCapabilitySupportView `json:"optionalCapabilities"`
}

type FactoryWorldRunnerOptionalCapability string

type FactoryWorldRunnerOptionalCapabilityStatus string

type FactoryWorldRunnerOptionalCapabilitySupportView struct {
	Capability FactoryWorldRunnerOptionalCapability       `json:"capability"`
	Detail     *string                                    `json:"detail,omitempty"`
	Status     FactoryWorldRunnerOptionalCapabilityStatus `json:"status"`
}

type FactoryWorldScriptRequestView struct {
	Args            *[]string `json:"args,omitempty"`
	Attempt         *int      `json:"attempt,omitempty"`
	Command         *string   `json:"command,omitempty"`
	ScriptRequestId *string   `json:"scriptRequestId,omitempty"`
}

type FactoryWorldScriptResponseView struct {
	Attempt         *int    `json:"attempt,omitempty"`
	DurationMillis  *int64  `json:"durationMillis,omitempty"`
	ExitCode        *int    `json:"exitCode,omitempty"`
	FailureType     *string `json:"failureType,omitempty"`
	Outcome         *string `json:"outcome,omitempty"`
	ScriptRequestId *string `json:"scriptRequestId,omitempty"`
	Stderr          *string `json:"stderr,omitempty"`
	Stdout          *string `json:"stdout,omitempty"`
}

type FactoryWorldSelectedRunnerView struct {
	Capabilities *FactoryWorldRunnerCapabilitiesView `json:"capabilities,omitempty"`
	DisplayName  *string                             `json:"displayName,omitempty"`

	// RunnerId Stable built-in runner identifiers supported by factory and workstation runner selection.
	RunnerId *RunnerID `json:"runnerId,omitempty"`

	// SelectionSource Configuration layer that supplied the resolved built-in runner selection for a dispatch.
	SelectionSource *RunnerSelectionSource `json:"selectionSource,omitempty"`
}

type FactoryWorldTokenView struct {
	ChainingTraceDepth       *int       `json:"chainingTraceDepth,omitempty"`
	CurrentChainingTraceId   *string    `json:"currentChainingTraceId,omitempty"`
	Name                     *string    `json:"name,omitempty"`
	PlaceId                  string     `json:"placeId"`
	PreviousChainingTraceIds *[]string  `json:"previousChainingTraceIds,omitempty"`
	Tags                     *StringMap `json:"tags,omitempty"`
	TokenId                  string     `json:"tokenId"`
	TraceId                  *string    `json:"traceId,omitempty"`
	WorkId                   *string    `json:"workId,omitempty"`
	WorkTypeId               *string    `json:"workTypeId,omitempty"`
}

type FactoryWorldWorkDiagnostics struct {
	Provider       *FactoryWorldProviderDiagnostic       `json:"provider,omitempty"`
	RenderedPrompt *FactoryWorldRenderedPromptDiagnostic `json:"renderedPrompt,omitempty"`
}

type FactoryWorldWorkItemRef struct {
	ChainingTraceDepth *int `json:"chainingTraceDepth,omitempty"`

	// Content Ordered canonical content parts for one work item.
	Content                  *WorkContent                              `json:"content,omitempty"`
	CurrentChainingTraceId   *string                                   `json:"currentChainingTraceId,omitempty"`
	DisplayName              *string                                   `json:"displayName,omitempty"`
	LineageContinuity        *FactoryWorldWorkItemRefLineageContinuity `json:"lineageContinuity,omitempty"`
	LineageLogicalWorkId     *string                                   `json:"lineageLogicalWorkId,omitempty"`
	LineageParentWorkIds     *[]string                                 `json:"lineageParentWorkIds,omitempty"`
	LineageSourceKind        *FactoryWorldWorkItemRefLineageSourceKind `json:"lineageSourceKind,omitempty"`
	PayloadStatus            *FactoryWorldWorkItemRefPayloadStatus     `json:"payloadStatus,omitempty"`
	PayloadUnavailableReason *string                                   `json:"payloadUnavailableReason,omitempty"`
	PreviousChainingTraceIds *[]string                                 `json:"previousChainingTraceIds,omitempty"`
	State                    *string                                   `json:"state,omitempty"`
	TraceId                  *string                                   `json:"traceId,omitempty"`
	WorkId                   string                                    `json:"workId"`
	WorkTypeId               *string                                   `json:"workTypeId,omitempty"`
}

type FactoryWorldWorkItemRefLineageContinuity string

type FactoryWorldWorkItemRefLineageSourceKind string

type FactoryWorldWorkItemRefPayloadStatus string

type FactoryWorldWorkMoveOperationProjectionSlice struct {
	WorkMoveOperationsByWorkId *map[string][]FactoryWorldWorkMoveOperationView `json:"workMoveOperationsByWorkId,omitempty"`
}

type FactoryWorldWorkMoveOperationView struct {
	EventTime   *time.Time `json:"eventTime,omitempty"`
	FromPlaceId string     `json:"fromPlaceId"`
	FromState   string     `json:"fromState"`
	RequestId   *string    `json:"requestId,omitempty"`
	Sequence    int        `json:"sequence"`

	// Source Origin of a WORK_STATE_CHANGE event.
	Source       WorkStateChangeSource `json:"source"`
	Tick         int                   `json:"tick"`
	ToPlaceId    string                `json:"toPlaceId"`
	ToState      string                `json:"toState"`
	WorkId       string                `json:"workId"`
	WorkTypeName *string               `json:"workTypeName,omitempty"`
}

type FactoryWorldWorkstationRequestCountView struct {
	DispatchedCount int `json:"dispatchedCount"`
	ErroredCount    int `json:"erroredCount"`
	RespondedCount  int `json:"respondedCount"`
}

type FactoryWorldWorkstationRequestProjectionSlice struct {
	WorkstationRequestsByDispatchId *map[string]FactoryWorldWorkstationRequestView `json:"workstationRequestsByDispatchId,omitempty"`
}

type FactoryWorldWorkstationRequestRequestView struct {
	ConsumedTokens           *[]FactoryWorldTokenView        `json:"consumedTokens,omitempty"`
	CurrentChainingTraceId   *string                         `json:"currentChainingTraceId,omitempty"`
	InputWorkItems           *[]FactoryWorldWorkItemRef      `json:"inputWorkItems,omitempty"`
	InputWorkTypeIds         *[]string                       `json:"inputWorkTypeIds,omitempty"`
	PreviousChainingTraceIds *[]string                       `json:"previousChainingTraceIds,omitempty"`
	Runner                   *FactoryWorldSelectedRunnerView `json:"runner,omitempty"`
	ScriptRequest            *FactoryWorldScriptRequestView  `json:"scriptRequest,omitempty"`
	StartedAt                *time.Time                      `json:"startedAt,omitempty"`
	TraceIds                 *[]string                       `json:"traceIds,omitempty"`
}

type FactoryWorldWorkstationRequestResponseView struct {
	DurationMillis              *int64                          `json:"durationMillis,omitempty"`
	EndTime                     *time.Time                      `json:"endTime,omitempty"`
	FailureMessage              *string                         `json:"failureMessage,omitempty"`
	FailureReason               *string                         `json:"failureReason,omitempty"`
	Feedback                    *string                         `json:"feedback,omitempty"`
	Outcome                     *string                         `json:"outcome,omitempty"`
	OutputMutations             *[]FactoryWorldMutationView     `json:"outputMutations,omitempty"`
	OutputWorkItems             *[]FactoryWorldWorkItemRef      `json:"outputWorkItems,omitempty"`
	Runner                      *FactoryWorldSelectedRunnerView `json:"runner,omitempty"`
	ScriptResponse              *FactoryWorldScriptResponseView `json:"scriptResponse,omitempty"`
	SelectedClassificationLabel *string                         `json:"selectedClassificationLabel,omitempty"`
}

type FactoryWorldWorkstationRequestView struct {
	Counts          FactoryWorldWorkstationRequestCountView     `json:"counts"`
	DispatchId      string                                      `json:"dispatchId"`
	Request         FactoryWorldWorkstationRequestRequestView   `json:"request"`
	Response        *FactoryWorldWorkstationRequestResponseView `json:"response,omitempty"`
	TransitionId    string                                      `json:"transitionId"`
	WorkstationName *string                                     `json:"workstationName,omitempty"`
}

type GetProviderSessionDetailsParams struct {
	// Provider Provider that emitted the session identifier. Only codex sessions are currently loadable.
	Provider LoadableProviderSessionProvider `form:"provider" json:"provider"`

	// Kind Provider-session identifier kind. Only session_id is currently loadable.
	Kind LoadableProviderSessionKind `form:"kind" json:"kind"`

	// Id Provider-session identifier to resolve. This is an identifier, not a filesystem path.
	Id string `form:"id" json:"id"`
}

type GorillaServerOptions struct {
	BaseURL          string
	BaseRouter       *mux.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type Guard struct {
	// MatchConfig For `MATCHES_FIELDS` guards, the field-selector configuration used to compare candidate inputs.
	MatchConfig *GuardMatchConfig `json:"matchConfig,omitempty"`

	// MatchInput For `SAME_NAME` and `SAME_TRACE_ID` input guards, the peer input workType name from another input in the same workstation.
	MatchInput *string `json:"matchInput,omitempty"`

	// MaxVisits For `VISIT_COUNT` guards, the visit threshold.
	MaxVisits *int `json:"maxVisits,omitempty"`

	// ParentInput For parent-aware input guards, the parent workType name from another input in the same workstation.
	ParentInput *string `json:"parentInput,omitempty"`

	// SpawnedBy For dynamic fanout input guards, the workstation that spawns the children for count tracking.
	SpawnedBy *string `json:"spawnedBy,omitempty"`

	// Type Guard condition to evaluate for this workstation-level or input-level attachment.
	Type GuardType `json:"type"`

	// Workstation For `VISIT_COUNT` guards, the workstation whose visits are counted.
	Workstation *string `json:"workstation,omitempty"`
}

type GuardMatchConfig struct {
	// InputKey Field selector resolved against each candidate input, such as `.Name` or `.Tags["_last_output"]`.
	InputKey string `json:"inputKey"`
}

type GuardType string

type HostedLinearWorkerClaim struct {
	// AssigneeField Linear issue field name to use when deriving optional assignee claim metadata.
	AssigneeField *string `json:"assigneeField,omitempty"`
}

type HostedLinearWorkerConfig struct {
	// Claim Optional claim-related configuration that v1 hosted Linear workers explicitly allow.
	Claim *HostedLinearWorkerClaim `json:"claim,omitempty"`

	// Mapping Deterministic issue-to-work mapping fields owned by a hosted Linear worker.
	Mapping *HostedLinearWorkerMapping `json:"mapping,omitempty"`

	// PollInterval Optional Go duration that controls how often the hosted Linear worker polls for updates.
	PollInterval *string `json:"pollInterval,omitempty"`

	// StateIds Optional Linear issue-state identifiers that bound the poll source.
	StateIds *[]string `json:"stateIds,omitempty"`

	// TeamIds Optional Linear team identifiers that bound the poll source.
	TeamIds *[]string `json:"teamIds,omitempty"`
}

type HostedLinearWorkerMapping struct {
	// State Canonical submitted work state emitted for matched Linear issues.
	State *string `json:"state,omitempty"`

	// WorkType Canonical submitted work type emitted for matched Linear issues.
	WorkType *string `json:"workType,omitempty"`
}

type HostedWorkerAuth struct {
	// SecretRef Referenced secret name that resolves the hosted provider API key at runtime.
	SecretRef *string `json:"secretRef,omitempty"`
}

type HostedWorkerProvider string

type HybridLogicalTimestamp struct {
	// Logical Monotonic Lamport-style logical component derived from the persisted factory definition version. Serialized as a decimal string so JavaScript clients can round-trip the 64-bit value without precision loss.
	Logical apitypes.Int64String `json:"logical"`

	// Physical UTC physical timestamp component for the persisted factory definition version.
	Physical time.Time `json:"physical"`
}

type InferenceOutcome string

type InferenceRequestEventPayload struct {
	// Attempt One-based provider attempt number for this dispatch.
	Attempt int `json:"attempt"`

	// InferenceRequestId Stable identifier correlating this provider request with its response.
	InferenceRequestId string `json:"inferenceRequestId"`

	// Prompt Rendered prompt sent to the provider.
	Prompt string `json:"prompt"`

	// WorkingDirectory Working directory resolved for the provider attempt.
	WorkingDirectory string `json:"workingDirectory"`

	// Worktree Worktree path resolved for the provider attempt.
	Worktree string `json:"worktree"`
}

type InferenceResponseEventPayload struct {
	// Attempt One-based provider attempt number for this dispatch.
	Attempt int `json:"attempt"`

	// Diagnostics Dashboard-facing execution diagnostics that omit raw prompts, command stdin, and command environment values.
	Diagnostics *SafeWorkDiagnostics `json:"diagnostics,omitempty"`

	// DurationMillis Provider call duration in milliseconds.
	DurationMillis int64 `json:"durationMillis"`

	// ErrorClass Stable failure classification when available.
	ErrorClass *string `json:"errorClass,omitempty"`

	// ExitCode Process exit code when the provider failure exposes one.
	ExitCode *int `json:"exitCode,omitempty"`

	// InferenceRequestId Identifier from the matching inference request event.
	InferenceRequestId string `json:"inferenceRequestId"`

	// Outcome Result category returned by a provider inference attempt.
	Outcome         InferenceOutcome         `json:"outcome"`
	ProviderSession *ProviderSessionMetadata `json:"providerSession,omitempty"`

	// Response Provider response text when present.
	Response *string `json:"response,omitempty"`
}

type InitialStructureRequestEventPayload struct {
	// Factory Top-level factory.json contract. Declare the work types, resources, portability resources, workers, and workstations that make up one authored factory here. Guarded loop breakers should be authored as guarded LOGICAL_MOVE workstations using VISIT_COUNT guards instead of a top-level exhaustion-rules field.
	Factory         Factory    `json:"factory"`
	Metadata        *StringMap `json:"metadata,omitempty"`
	SourceDirectory *string    `json:"sourceDirectory,omitempty"`
}

type InputKind string

type InputType struct {
	// Name Input type name. The reserved name "default" is implicit.
	Name string `json:"name"`

	// Type Kinds of input. `DEFAULT` passes opaque input through to workstations as-is.
	Type InputKind `json:"type"`
}

type IntegerMap map[string]int

type InternalError = ErrorResponse

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type InvokeModelJSONRequestBody = ModelInvocationRequest

type ListFactorySessionsResponse struct {
	Sessions []FactorySessionSummary `json:"sessions"`
}

type ListModelsResponse struct {
	// Results Discovered models exposed by the currently loaded runtime configuration.
	Results []ModelSummary `json:"results"`
}

type ListWorkBySessionIdParams struct {
	// MaxResults Optional positive page size. Omit to use the default page size; non-positive values fall back to the default after successful integer binding.
	MaxResults *MaxResults `form:"maxResults,omitempty" json:"maxResults,omitempty"`

	// NextToken Optional base64-encoded token ID cursor.
	NextToken *NextToken `form:"nextToken,omitempty" json:"nextToken,omitempty"`

	// StateName Optional current work state name filter.
	StateName *StateName `form:"state.name,omitempty" json:"state.name,omitempty"`

	// StateType Optional current work state type filter.
	StateType *StateType `form:"state.type,omitempty" json:"state.type,omitempty"`

	// SortBy Optional list-work sort field. Use state.type to order by current work state type.
	SortBy *ListWorkBySessionIdParamsSortBy `form:"sortBy,omitempty" json:"sortBy,omitempty"`

	// Name Optional work name filter. Matches when the work name contains this value, case-insensitively.
	Name *WorkListName `form:"name,omitempty" json:"name,omitempty"`

	// WorkTypeName Optional work type name filter. Matches when workTypeName equals this value exactly.
	WorkTypeName *WorkListWorkTypeName `form:"workTypeName,omitempty" json:"workTypeName,omitempty"`

	// TraceId Optional trace filter. Matches when traceId or currentChainingTraceId equals this value exactly.
	TraceId *WorkListTraceId `form:"traceId,omitempty" json:"traceId,omitempty"`
}

type ListWorkBySessionIdParamsSortBy string

type ListWorkParams struct {
	// MaxResults Optional positive page size. Omit to use the default page size; non-positive values fall back to the default after successful integer binding.
	MaxResults *MaxResults `form:"maxResults,omitempty" json:"maxResults,omitempty"`

	// NextToken Optional base64-encoded token ID cursor.
	NextToken *NextToken `form:"nextToken,omitempty" json:"nextToken,omitempty"`

	// StateName Optional current work state name filter.
	StateName *StateName `form:"state.name,omitempty" json:"state.name,omitempty"`

	// StateType Optional current work state type filter.
	StateType *StateType `form:"state.type,omitempty" json:"state.type,omitempty"`

	// SortBy Optional list-work sort field. Use state.type to order by current work state type.
	SortBy *ListWorkParamsSortBy `form:"sortBy,omitempty" json:"sortBy,omitempty"`

	// Name Optional work name filter. Matches when the work name contains this value, case-insensitively.
	Name *WorkListName `form:"name,omitempty" json:"name,omitempty"`

	// WorkTypeName Optional work type name filter. Matches when workTypeName equals this value exactly.
	WorkTypeName *WorkListWorkTypeName `form:"workTypeName,omitempty" json:"workTypeName,omitempty"`

	// TraceId Optional trace filter. Matches when traceId or currentChainingTraceId equals this value exactly.
	TraceId *WorkListTraceId `form:"traceId,omitempty" json:"traceId,omitempty"`
}

type ListWorkParamsSortBy string

type ListWorkResponse struct {
	PaginationContext *PaginationContext `json:"paginationContext,omitempty"`
	Results           []Work             `json:"results"`
}

type LoadableProviderSessionKind string

type LoadableProviderSessionProvider string

type LoadableProviderSessionRef struct {
	// Id Provider-session identifier to resolve. This is an identifier, not a filesystem path.
	Id string `json:"id"`

	// Kind Canonical provider-session identifier kind for provider-session detail requests that can be loaded by the API.
	Kind LoadableProviderSessionKind `json:"kind"`

	// Provider Canonical provider value for provider-session detail requests that can be loaded by the API.
	Provider LoadableProviderSessionProvider `json:"provider"`
}

type MaxResults = int

type MiddlewareFunc func(http.Handler) http.Handler

type ModelCapability struct {
	// ModelProvider Canonical model-provider identifiers supported by model workers in factory config.
	ModelProvider *WorkerModelProvider `json:"modelProvider,omitempty"`

	// Operations Operations declared by this worker for the selected model.
	Operations []ModelOperation `json:"operations"`

	// ProviderLocality Provider locality for a model worker capability declaration.
	ProviderLocality WorkerModelLocality `json:"providerLocality"`

	// ResourceNames Factory resource names referenced by the worker declaration.
	ResourceNames []string `json:"resourceNames"`

	// Worker Customer-authored worker name that exposes this capability declaration.
	Worker string `json:"worker"`
}

type ModelDetail struct {
	// Capabilities Worker-scoped capability declarations that contribute to this discovered model.
	Capabilities []ModelCapability `json:"capabilities"`
	Diagnostics  StringMap         `json:"diagnostics"`

	// LoadState Runtime-visible load state for one discovered model. Before local model-manager support lands, local discovered models report `UNLOADED` and cloud-backed models report `NOT_APPLICABLE`.
	LoadState ModelLoadState `json:"loadState"`

	// Modalities Uppercase content modalities observed across all declared operation inputs and outputs.
	Modalities []ModelOperationContentType `json:"modalities"`

	// Name Concrete public model identifier such as `OMNIVOICE_Q4_K_M`.
	Name string `json:"name"`

	// Operations Union of provider-agnostic operations supported by workers for this model.
	Operations []ModelOperation `json:"operations"`

	// ProviderLocality Provider locality for a model worker capability declaration.
	ProviderLocality WorkerModelLocality `json:"providerLocality"`

	// Resources Factory resource summaries associated with this model's workers or explicit model metadata.
	Resources []ModelResourceSummary `json:"resources"`

	// Status Readiness status derived from the currently loaded runtime configuration and declared resources for one discovered model.
	Status ModelStatus `json:"status"`
}

type ModelInvocationOptions struct {
	// ResponseMode Requested direct-invocation response mode.
	ResponseMode *ModelInvocationResponseMode `json:"responseMode,omitempty"`
}

type ModelInvocationRequest struct {
	// Bindings Optional per-request slot bindings that follow the same contract as `MODEL_INVOKE` workstation bindings.
	Bindings *[]WorkstationOperationBinding `json:"bindings,omitempty"`

	// Content Ordered canonical content parts for one work item.
	Content *WorkContent `json:"content,omitempty"`

	// Operation Uppercase provider-agnostic operation to invoke, such as `TTS`.
	Operation string `json:"operation"`

	// Options Optional direct-invocation controls for response shaping and transport.
	Options *ModelInvocationOptions `json:"options,omitempty"`
}

type ModelInvocationResponse struct {
	// Bindings Deterministically resolved slot bindings used for the invocation.
	Bindings []ResolvedModelOperationBinding `json:"bindings"`

	// Content Ordered canonical content parts for one work item.
	Content WorkContent `json:"content"`

	// ModelName Concrete public model identifier such as `OMNIVOICE_Q4_K_M`.
	ModelName string `json:"modelName"`

	// Operation Uppercase provider-agnostic operation that was invoked.
	Operation string `json:"operation"`

	// ProviderLocality Provider locality for a model worker capability declaration.
	ProviderLocality WorkerModelLocality `json:"providerLocality"`

	// Worker Worker selected to satisfy this invocation.
	Worker string `json:"worker"`
}

type ModelInvocationResponseMode string

type ModelLoadState string

type ModelOperation struct {
	// Inputs Named operation input slots this worker can consume.
	Inputs *[]ModelOperationSlot `json:"inputs,omitempty"`

	// Name Uppercase public operation identifier such as `TTS`, `ASR`, or `EMBED`.
	Name ModelOperationName `json:"name"`

	// Outputs Named operation output slots this worker can produce.
	Outputs *[]ModelOperationSlot `json:"outputs,omitempty"`
}

type ModelOperationContentType string

type ModelOperationName = string

type ModelOperationSlot struct {
	// ContentTypes Uppercase content types accepted or produced by this slot.
	ContentTypes []ModelOperationContentType `json:"contentTypes"`

	// Name Stable slot name used by workstation-side bindings and diagnostics.
	Name string `json:"name"`

	// Required Whether this input slot must be resolved before invocation starts. Output slots omit this field when not needed.
	Required *bool `json:"required,omitempty"`
}

type ModelPullDownloadedFile struct {
	// Bytes Downloaded file size in bytes.
	Bytes int64 `json:"bytes"`

	// Path Relative file path written under the managed model cache directory.
	Path string `json:"path"`

	// Sha256 Lowercase SHA-256 checksum for the cached file when known.
	Sha256 *string `json:"sha256,omitempty"`
}

type ModelPullOutcome string

type ModelPullResponse struct {
	// CachePath Final managed cache directory that now contains the pulled model assets.
	CachePath string `json:"cachePath"`

	// DownloadedFiles Files that were downloaded or verified as already present for the managed cache entry.
	DownloadedFiles []ModelPullDownloadedFile `json:"downloadedFiles"`

	// ModelName Concrete public model identifier such as `OMNIVOICE_Q4_K_M`.
	ModelName string `json:"modelName"`

	// Outcome Outcome of a managed local-model asset pull request.
	Outcome ModelPullOutcome `json:"outcome"`

	// ProviderLocality Provider locality for a model worker capability declaration.
	ProviderLocality WorkerModelLocality `json:"providerLocality"`

	// Revision Pulled source revision identifier, such as an upstream repository commit SHA.
	Revision string `json:"revision"`
}

type ModelRequestEventPayload struct {
	// Attempt One-based model execution attempt number for this dispatch.
	Attempt int `json:"attempt"`

	// Bindings Deterministically resolved operation-slot bindings used for invocation.
	Bindings *[]ResolvedModelOperationBinding `json:"bindings,omitempty"`

	// Model Concrete model identity resolved for this invocation.
	Model string `json:"model"`

	// ModelRequestId Stable identifier correlating this model execution request with its response.
	ModelRequestId string `json:"modelRequestId"`

	// Operation Uppercase model operation requested by the workstation, such as TTS.
	Operation string `json:"operation"`

	// ProviderLocality Worker-declared model locality, such as LOCAL or CLOUD.
	ProviderLocality string `json:"providerLocality"`

	// Resources Concrete resources attached to the model worker execution path.
	Resources *[]ModelResourceSummary `json:"resources,omitempty"`

	// Worker Runtime worker name selected for the invocation.
	Worker string `json:"worker"`

	// WorkingDirectory Working directory resolved for the model execution when present.
	WorkingDirectory *string `json:"workingDirectory,omitempty"`

	// Worktree Worktree path resolved for the model execution when present.
	Worktree *string `json:"worktree,omitempty"`
}

type ModelResourceSummary struct {
	// Backend Local runtime backend identifier for model resources.
	Backend *string `json:"backend,omitempty"`

	// Capacity Declared factory capacity for this resource.
	Capacity int `json:"capacity"`

	// LoadPolicy Local load-policy metadata for model resources.
	LoadPolicy *string `json:"loadPolicy,omitempty"`

	// Model Concrete model identifier when the resource is model-specific.
	Model *string `json:"model,omitempty"`

	// Name Factory-authored resource name.
	Name string `json:"name"`

	// Provider Cloud provider identity when the resource models quota or routing.
	Provider *string `json:"provider,omitempty"`

	// Type Uppercase resource families supported by the public factory-config contract.
	Type ResourceType `json:"type"`
}

type ModelResponseEventPayload struct {
	// Attempt One-based model execution attempt number for this dispatch.
	Attempt int `json:"attempt"`

	// Bindings Deterministically resolved operation-slot bindings used for invocation.
	Bindings *[]ResolvedModelOperationBinding `json:"bindings,omitempty"`

	// Diagnostics Dashboard-facing execution diagnostics that omit raw prompts, command stdin, and command environment values.
	Diagnostics *SafeWorkDiagnostics `json:"diagnostics,omitempty"`

	// DurationMillis End-to-end model invocation duration in milliseconds.
	DurationMillis int64 `json:"durationMillis"`

	// ErrorClass Stable failure classification when available.
	ErrorClass *string `json:"errorClass,omitempty"`

	// LoadDurationMillis Duration of the managed local-model load call when one occurred.
	LoadDurationMillis *int64 `json:"loadDurationMillis,omitempty"`

	// LoadRequested Whether this invocation asked the managed local-model runtime to load a handle.
	LoadRequested *bool `json:"loadRequested,omitempty"`

	// LoadReused Whether an already-loaded local model handle was reused instead of loading again.
	LoadReused *bool `json:"loadReused,omitempty"`

	// Model Concrete model identity resolved for this invocation.
	Model string `json:"model"`

	// ModelRequestId Identifier from the matching model request event.
	ModelRequestId string `json:"modelRequestId"`

	// Operation Uppercase model operation requested by the workstation, such as TTS.
	Operation string `json:"operation"`

	// Outcome Result category returned by a provider inference attempt.
	Outcome InferenceOutcome `json:"outcome"`

	// OutputContent Ordered canonical content parts for one work item.
	OutputContent *WorkContent `json:"outputContent,omitempty"`

	// OutputPreview Bounded output preview for non-binary model responses when present.
	OutputPreview *string `json:"outputPreview,omitempty"`

	// ProviderLocality Worker-declared model locality, such as LOCAL or CLOUD.
	ProviderLocality string `json:"providerLocality"`

	// ResourceAcquired Whether the invocation acquired the required local model resources.
	ResourceAcquired *bool `json:"resourceAcquired,omitempty"`

	// ResourceWaitMillis Time spent waiting for local model resources before acquisition.
	ResourceWaitMillis *int64 `json:"resourceWaitMillis,omitempty"`

	// Resources Concrete resources attached to the model worker execution path.
	Resources *[]ModelResourceSummary `json:"resources,omitempty"`

	// Worker Runtime worker name selected for the invocation.
	Worker string `json:"worker"`
}

type ModelStatus string

type ModelSummary struct {
	// LoadState Runtime-visible load state for one discovered model. Before local model-manager support lands, local discovered models report `UNLOADED` and cloud-backed models report `NOT_APPLICABLE`.
	LoadState ModelLoadState `json:"loadState"`

	// Modalities Uppercase content modalities observed across the model's declared operation inputs and outputs.
	Modalities []ModelOperationContentType `json:"modalities"`

	// Name Concrete public model identifier such as `OMNIVOICE_Q4_K_M`.
	Name string `json:"name"`

	// Operations Provider-agnostic operations supported by the discovered model.
	Operations []ModelOperation `json:"operations"`

	// ProviderLocality Provider locality for a model worker capability declaration.
	ProviderLocality WorkerModelLocality `json:"providerLocality"`

	// Resources Factory resource summaries associated with this model's workers or explicit model metadata.
	Resources []ModelResourceSummary `json:"resources"`

	// Status Readiness status derived from the currently loaded runtime configuration and declared resources for one discovered model.
	Status ModelStatus `json:"status"`
}

type MoveWorkBySessionIdJSONRequestBody = MoveWorkRequest

type MoveWorkConflict = ErrorResponse

type MoveWorkJSONRequestBody = MoveWorkRequest

type MoveWorkRequest struct {
	// RequestId Optional client idempotency key. Repeating the same requestId for an already-applied operator move returns 409 Conflict without a second mutation.
	RequestId *string `json:"requestId,omitempty"`

	// StateName Authored marking state name to move the work item into.
	StateName string `json:"stateName"`
}

type NextToken = string

type NotFound = ErrorResponse

type OpenFactorySessionJSONRequestBody = OpenFactorySessionRequest

type OpenFactorySessionRequest struct {
	FolderPath string `json:"folderPath"`

	// InitNewFactory When true, write the default init scaffold at folderPath and open a live session. Mutually exclusive with validateOnly.
	InitNewFactory *bool                    `json:"initNewFactory,omitempty"`
	Target         *FactorySessionTargetRef `json:"target,omitempty"`

	// ValidateOnly When true, validate the folder and optional target selection without creating a live session.
	ValidateOnly *bool `json:"validateOnly,omitempty"`
}

type OpenFactorySessionResponse struct {
	// FolderPath Absolute resolved session folder path when initsNewFactory is true.
	FolderPath *string `json:"folderPath,omitempty"`

	// InitsNewFactory When true, validate-only inspection found a readable folder with no runnable factory targets; the client may offer to create the default init scaffold at folderPath.
	InitsNewFactory *bool                   `json:"initsNewFactory,omitempty"`
	Session         *FactorySessionSummary  `json:"session,omitempty"`
	Targets         *[]FactorySessionTarget `json:"targets,omitempty"`
}

type PaginationContext struct {
	MaxResults int     `json:"maxResults"`
	NextToken  *string `json:"nextToken,omitempty"`
}

type PanicDiagnostic struct {
	Message *string `json:"message,omitempty"`
	Stack   *string `json:"stack,omitempty"`
}

type PromptTemplateContract struct {
	// AvailableVariables Available prompt-template variables for the selected workstation editing context.
	AvailableVariables []PromptTemplateVariableReference `json:"availableVariables"`

	// InputCount Number of authored inputs on the selected workstation, which controls valid `.Inputs[N]` access.
	InputCount int `json:"inputCount"`

	// UnavailableAccessPatterns Unsupported or unavailable variable access patterns for the selected workstation editing context.
	UnavailableAccessPatterns []PromptTemplateUnavailableAccessPattern `json:"unavailableAccessPatterns"`
}

type PromptTemplateDiagnostic struct {
	// EndOffset Inclusive 1-based byte offset where the diagnostic source span ends when available.
	EndOffset int `json:"endOffset"`

	// Kind Diagnostic classification for prompt-template validation.
	Kind PromptTemplateDiagnosticKind `json:"kind"`

	// Message User-readable explanation of the validation failure.
	Message string `json:"message"`

	// Path Canonical variable path or access pattern involved in the diagnostic when available.
	Path string `json:"path"`

	// SourceText Source variable or access expression that triggered the diagnostic when available.
	SourceText string `json:"sourceText"`

	// StartOffset Inclusive 1-based byte offset where the diagnostic source span starts when available.
	StartOffset int `json:"startOffset"`
}

type PromptTemplateDiagnosticKind string

type PromptTemplateUnavailableAccessPattern struct {
	// Example Representative unsupported template snippet for this access pattern.
	Example string `json:"example"`

	// Path Unsupported or unavailable variable path pattern.
	Path string `json:"path"`

	// Reason Why the access pattern is unavailable or unsupported in the selected workstation context.
	Reason string `json:"reason"`
}

type PromptTemplateValidationRequest struct {
	// Prompt Prompt draft to validate against the selected current-factory workstation contract.
	Prompt string `json:"prompt"`
}

type PromptTemplateValidationResult struct {
	// Diagnostics Typed validation diagnostics for the submitted prompt draft.
	Diagnostics []PromptTemplateDiagnostic `json:"diagnostics"`

	// Valid True when the prompt contains no syntax or variable diagnostics.
	Valid bool `json:"valid"`
}

type PromptTemplateVariableReference struct {
	// Category High-level grouping for the variable reference.
	Category PromptTemplateVariableReferenceCategory `json:"category"`

	// Description User-readable description of what the variable resolves to.
	Description string `json:"description"`

	// Example Go template snippet that shows how to reference the variable.
	Example string `json:"example"`

	// Path Canonical variable path summary used in diagnostics and help surfaces.
	Path string `json:"path"`
}

type PromptTemplateVariableReferenceCategory string

type ProviderDiagnostic struct {
	Model            *string    `json:"model,omitempty"`
	Provider         *string    `json:"provider,omitempty"`
	RequestMetadata  *StringMap `json:"requestMetadata,omitempty"`
	ResponseMetadata *StringMap `json:"responseMetadata,omitempty"`
}

type ProviderFailureMetadata struct {
	// Family Stable machine-readable failure family used to decide retry and routing behavior for failed work.
	Family *WorkFailureFamily `json:"family,omitempty"`

	// Type Stable machine-readable failure type used to classify failed work across providers and runtimes.
	Type *WorkFailureType `json:"type,omitempty"`
}

type ProviderSessionDetailResponse struct {
	Parse           ProviderSessionParseSummary   `json:"parse"`
	ProviderSession LoadableProviderSessionRef    `json:"providerSession"`
	Source          ProviderSessionSourceMetadata `json:"source"`

	// Transcript Ordered transcript entries extracted from the provider-session stream.
	Transcript []ProviderSessionTranscriptEntry `json:"transcript"`
}

type ProviderSessionFunctionCallSummary struct {
	// Arguments Compact argument payload when present.
	Arguments *string `json:"arguments,omitempty"`

	// CallId Provider call identifier when present in the session stream.
	CallId *string `json:"callId,omitempty"`

	// Name Function or tool name when present.
	Name *string `json:"name,omitempty"`

	// Order Chronological order of the function or tool call in the session stream.
	Order int `json:"order"`

	// Output Compact output payload when present.
	Output *string `json:"output,omitempty"`

	// Status Result status inferred from the call output or explicit status fields.
	Status *string `json:"status,omitempty"`

	// TurnIndex One-based execution turn index associated with the call when inferable.
	TurnIndex *int `json:"turnIndex,omitempty"`

	// Type Raw response item type for the call, such as function_call or custom_tool_call.
	Type string `json:"type"`
}

type ProviderSessionLineError struct {
	// LineNumber One-based line number of the malformed event-stream record.
	LineNumber int `json:"lineNumber"`

	// Message Client-safe parse error message for the malformed line.
	Message string `json:"message"`
}

type ProviderSessionMetadata struct {
	Id       *string `json:"id,omitempty"`
	Kind     *string `json:"kind,omitempty"`
	Provider *string `json:"provider,omitempty"`
}

type ProviderSessionParseSummary struct {
	// EventCount Number of JSON event records parsed from the session stream.
	EventCount int `json:"eventCount"`

	// FunctionCalls Function and tool calls observed in chronological order.
	FunctionCalls []ProviderSessionFunctionCallSummary `json:"functionCalls"`

	// LineCount Number of non-empty event-stream lines inspected.
	LineCount int `json:"lineCount"`

	// MalformedLineCount Number of non-empty lines that could not be parsed as JSON objects.
	MalformedLineCount int `json:"malformedLineCount"`

	// ParseErrors Line-level parse errors for malformed event-stream records.
	ParseErrors []ProviderSessionLineError `json:"parseErrors"`

	// Reasoning Reasoning entries or summaries observed in chronological order.
	Reasoning  []ProviderSessionReasoningSummary `json:"reasoning"`
	TokenUsage *ProviderSessionTokenUsage        `json:"tokenUsage,omitempty"`

	// Turns Chronological execution turns inferred from turn boundaries and response activity.
	Turns []ProviderSessionTurnSummary `json:"turns"`

	// UnknownEventCount Number of parsed JSON events without a recognized type field.
	UnknownEventCount int `json:"unknownEventCount"`

	// UnknownEvents Compact list of events with unknown or unsupported type fields.
	UnknownEvents []ProviderSessionUnknownEvent `json:"unknownEvents"`
}

type ProviderSessionReasoningSummary struct {
	// Encrypted Whether the reasoning entry only exposed encrypted content.
	Encrypted *bool `json:"encrypted,omitempty"`

	// EncryptedContent Compact encrypted reasoning payload when the provider exposes it.
	EncryptedContent *string `json:"encryptedContent,omitempty"`

	// Order Chronological order of the reasoning entry in the session stream.
	Order int `json:"order"`

	// SourceType Event or response item type that carried the reasoning entry.
	SourceType string `json:"sourceType"`

	// Summary Compact reasoning summary when present.
	Summary *string `json:"summary,omitempty"`

	// Text Reasoning text when plaintext content is present.
	Text *string `json:"text,omitempty"`

	// TurnIndex One-based execution turn index associated with the reasoning entry when inferable.
	TurnIndex *int `json:"turnIndex,omitempty"`
}

type ProviderSessionSourceMetadata struct {
	// ModifiedAt Filesystem modification time when available.
	ModifiedAt *time.Time `json:"modifiedAt,omitempty"`

	// RelativePath Path to the loaded session file relative to the configured provider sessions root.
	RelativePath string `json:"relativePath"`

	// SizeBytes Size of the loaded session file in bytes.
	SizeBytes int64 `json:"sizeBytes"`
}

type ProviderSessionTokenUsage struct {
	CachedInputTokens     *int `json:"cachedInputTokens,omitempty"`
	InputTokens           *int `json:"inputTokens,omitempty"`
	OutputTokens          *int `json:"outputTokens,omitempty"`
	ReasoningOutputTokens *int `json:"reasoningOutputTokens,omitempty"`
	TotalTokens           *int `json:"totalTokens,omitempty"`
}

type ProviderSessionTranscriptEntry struct {
	// Arguments Compact tool-call arguments when present.
	Arguments *string `json:"arguments,omitempty"`

	// CallId Provider tool-call identifier when present.
	CallId *string `json:"callId,omitempty"`

	// Encrypted Whether the entry only exposed encrypted content instead of plaintext.
	Encrypted *bool `json:"encrypted,omitempty"`

	// EncryptedContent Compact encrypted reasoning payload when the provider exposes it.
	EncryptedContent *string `json:"encryptedContent,omitempty"`

	// LineNumber One-based JSONL line number that produced this transcript entry when applicable.
	LineNumber *int `json:"lineNumber,omitempty"`

	// Name Tool or function name when present.
	Name *string `json:"name,omitempty"`

	// Order Stable chronological order of the transcript entry in the session stream.
	Order int `json:"order"`

	// Output Compact tool output when present.
	Output *string `json:"output,omitempty"`

	// SourceType Raw provider event or item type that produced this transcript entry.
	SourceType *string `json:"sourceType,omitempty"`

	// Status Provider or inferred status value when present.
	Status *string `json:"status,omitempty"`

	// Summary Compact summary text when the provider emits a separate summary channel.
	Summary *string `json:"summary,omitempty"`

	// Text Plaintext transcript body when present.
	Text *string `json:"text,omitempty"`

	// Timestamp Provider event timestamp when present in the source session stream.
	Timestamp *time.Time `json:"timestamp,omitempty"`

	// TurnIndex One-based inferred turn index when the session parser can associate the entry with a turn.
	TurnIndex *int `json:"turnIndex,omitempty"`

	// Type Canonical transcript entry type used by the dashboard transcript view.
	Type ProviderSessionTranscriptEntryType `json:"type"`
}

type ProviderSessionTranscriptEntryType string

type ProviderSessionTurnSummary struct {
	// EventCount Number of parsed events associated with the turn.
	EventCount int `json:"eventCount"`

	// FunctionCallCount Number of function or tool calls associated with the turn.
	FunctionCallCount int `json:"functionCallCount"`

	// Index One-based chronological execution turn index.
	Index int `json:"index"`

	// ReasoningCount Number of reasoning entries associated with the turn.
	ReasoningCount int `json:"reasoningCount"`

	// ResponseItemCount Number of response_item records associated with the turn.
	ResponseItemCount int `json:"responseItemCount"`

	// StartedAt First event timestamp associated with the turn when present.
	StartedAt *time.Time `json:"startedAt,omitempty"`
}

type ProviderSessionUnknownEvent struct {
	// LineNumber One-based line number of the unknown event.
	LineNumber int `json:"lineNumber"`

	// PayloadType Raw nested payload type when present.
	PayloadType *string `json:"payloadType,omitempty"`

	// Type Raw top-level event type when present.
	Type *string `json:"type,omitempty"`
}

type Relation struct {
	RequiredState  *string `json:"requiredState,omitempty"`
	SourceWorkName string  `json:"sourceWorkName"`
	TargetWorkId   *string `json:"targetWorkId,omitempty"`
	TargetWorkName string  `json:"targetWorkName"`

	// Type Relationship category between two pieces of work.
	Type RelationType `json:"type"`
}

type RelationType string

type RelationshipChangeRequestEventPayload struct {
	Relation Relation `json:"relation"`
}

type RenderedPromptDiagnostic struct {
	SystemPromptHash *string    `json:"systemPromptHash,omitempty"`
	UserMessageHash  *string    `json:"userMessageHash,omitempty"`
	Variables        *StringMap `json:"variables,omitempty"`
}

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type RequiredTool struct {
	// Command Executable lookup token that must resolve on PATH.
	Command string `json:"command"`

	// Name Human-readable tool name used in manifests and validation output.
	Name string `json:"name"`

	// Purpose Optional explanation of why the portable factory requires this tool.
	Purpose *string `json:"purpose,omitempty"`

	// VersionArgs Optional argument vector used by future validation flows to probe the tool version without changing the executable lookup token.
	VersionArgs *[]string `json:"versionArgs,omitempty"`
}

type ResolvedModelOperationBinding struct {
	// Content Ordered canonical content parts for one work item.
	Content WorkContent `json:"content"`

	// Slot Stable input slot name declared by the worker capability.
	Slot string `json:"slot"`

	// Source Source used to resolve one invocation slot binding.
	Source ResolvedModelOperationBindingSource `json:"source"`
}

type ResolvedModelOperationBindingSource string

type Resource struct {
	// Backend Backend identifier for local model resources, such as a managed runtime or embedded inference backend.
	Backend *string `json:"backend,omitempty"`

	// Capacity Total units of this resource available to the factory at one time.
	Capacity int `json:"capacity"`

	// LoadPolicy Load policy for local model resources, such as `ON_DEMAND` or `EAGER`.
	LoadPolicy *string `json:"loadPolicy,omitempty"`

	// Model Concrete model identifier associated with this resource, such as `OMNIVOICE_Q4_K_M`.
	Model *string `json:"model,omitempty"`

	// Name Resource name referenced from worker requirements and workstation resourceUsage entries.
	Name string `json:"name"`

	// Provider Provider identity associated with this resource, especially for `PROVIDER_QUOTA` resources.
	Provider *string `json:"provider,omitempty"`

	// Type Uppercase resource families supported by the public factory-config contract.
	Type *ResourceType `json:"type,omitempty"`
}

type ResourceManifest struct {
	// BundledFiles Portable bundled files that belong inside the factory boundary. Entries are explicit only, use factory-relative target paths, and must stay under the canonical script, docs, or inputs roots for SCRIPT, DOC, or INPUT entries, or match the supported root-helper allowlist for ROOT_HELPER entries. In v1 shared-factory flows, INPUT entries capture the source factory's current starter work at share time and are restored as independent recipient copies.
	BundledFiles *[]BundledFile `json:"bundledFiles,omitempty"`

	// RequiredTools Declarative external tools that must already resolve on PATH. These entries are validated but not embedded or installed.
	RequiredTools *[]RequiredTool `json:"requiredTools,omitempty"`
}

type ResourceRequirement struct {
	Capacity int    `json:"capacity"`
	Name     string `json:"name"`
}

type ResourceType string

type ResourceUsage struct {
	Available int    `json:"available"`
	Name      string `json:"name"`
	Total     int    `json:"total"`
}

type RunRequestEventPayload struct {
	Diagnostics *Diagnostics `json:"diagnostics,omitempty"`

	// Factory Top-level factory.json contract. Declare the work types, resources, portability resources, workers, and workstations that make up one authored factory here. Guarded loop breakers should be authored as guarded LOGICAL_MOVE workstations using VISIT_COUNT guards instead of a top-level exhaustion-rules field.
	Factory    Factory    `json:"factory"`
	RecordedAt time.Time  `json:"recordedAt"`
	WallClock  *WallClock `json:"wallClock,omitempty"`
}

type RunResponseEventPayload struct {
	Diagnostics *Diagnostics `json:"diagnostics,omitempty"`
	Reason      *string      `json:"reason,omitempty"`

	// State Lifecycle state of the running factory.
	State     *FactoryState `json:"state,omitempty"`
	WallClock *WallClock    `json:"wallClock,omitempty"`
}

type RunnerID string

type RunnerSelectionSource string

type SafeWorkDiagnostics struct {
	Provider       *ProviderDiagnostic       `json:"provider,omitempty"`
	RenderedPrompt *RenderedPromptDiagnostic `json:"renderedPrompt,omitempty"`
}

type SaveCurrentFactoryBadRequest = ErrorResponse

type SaveCurrentFactoryBySessionIdJSONRequestBody = SaveFactoryForSessionRequest

type SaveCurrentFactoryConflict = ErrorResponse

type SaveFactoryForSessionRequest struct {
	// Factory Top-level factory.json contract. Declare the work types, resources, portability resources, workers, and workstations that make up one authored factory here. Guarded loop breakers should be authored as guarded LOGICAL_MOVE workstations using VISIT_COUNT guards instead of a top-level exhaustion-rules field.
	Factory Factory `json:"factory"`

	// Mode Explicit save mode for session-scoped factory submission. Omitted mode on PUT /factory-sessions/{session_id}/factory defaults to REPLACE_CURRENT.
	Mode *FactorySaveMode `json:"mode,omitempty"`
}

type ScriptExecutionOutcome string

type ScriptFailureType string

type ScriptRequestEventPayload struct {
	// Args Fully resolved command arguments passed to the script command runner.
	Args []string `json:"args"`

	// Attempt One-based script attempt number for this dispatch.
	Attempt int `json:"attempt"`

	// Command Concrete command name executed for this script attempt.
	Command    string `json:"command"`
	DispatchId string `json:"dispatchId"`

	// ScriptRequestId Stable identifier correlating this script request with its response.
	ScriptRequestId string `json:"scriptRequestId"`
	TransitionId    string `json:"transitionId"`
}

type ScriptResponseEventPayload struct {
	// Attempt One-based script attempt number for this dispatch.
	Attempt    int    `json:"attempt"`
	DispatchId string `json:"dispatchId"`

	// DurationMillis Script execution duration in milliseconds.
	DurationMillis int64 `json:"durationMillis"`

	// ExitCode Process exit code when the command returned one.
	ExitCode *int `json:"exitCode,omitempty"`

	// FailureType Stable failure classification for script responses without a normal process exit code.
	FailureType *ScriptFailureType `json:"failureType,omitempty"`

	// Outcome Result category returned by one public script execution boundary.
	Outcome ScriptExecutionOutcome `json:"outcome"`

	// ScriptRequestId Identifier from the matching script request event.
	ScriptRequestId string `json:"scriptRequestId"`

	// Stderr Captured stderr text from the script execution boundary.
	Stderr string `json:"stderr"`

	// Stdout Captured stdout text from the script execution boundary.
	Stdout       string `json:"stdout"`
	TransitionId string `json:"transitionId"`
}

type ServerInterface interface {
	// Stream factory events
	// (GET /events)
	GetEvents(w http.ResponseWriter, r *http.Request)
	// List live factory sessions
	// (GET /factory-sessions)
	ListFactorySessions(w http.ResponseWriter, r *http.Request)
	// Open another live factory session
	// (POST /factory-sessions)
	OpenFactorySession(w http.ResponseWriter, r *http.Request)
	// Close one live factory session
	// (DELETE /factory-sessions/{session_id})
	CloseFactorySession(w http.ResponseWriter, r *http.Request, sessionId string)
	// Stream factory events for one session
	// (GET /factory-sessions/{session_id}/events)
	GetEventsBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID)
	// Get current factory for one session
	// (GET /factory-sessions/{session_id}/factory)
	GetCurrentFactoryBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID)
	// Save factory for one session
	// (PUT /factory-sessions/{session_id}/factory)
	SaveCurrentFactoryBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID)
	// Get workstation prompt-template contract
	// (GET /factory-sessions/{session_id}/factory/workstations/{workstation_name}/prompt-template-contract)
	GetCurrentFactoryWorkstationPromptTemplateContractBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID, workstationName string)
	// Validate workstation prompt template
	// (POST /factory-sessions/{session_id}/factory/workstations/{workstation_name}/prompt-template-validation)
	ValidateCurrentFactoryWorkstationPromptTemplateBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID, workstationName string)
	// Get runtime status for one session
	// (GET /factory-sessions/{session_id}/status)
	GetStatusBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID)
	// List work for one session
	// (GET /factory-sessions/{session_id}/work)
	ListWorkBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID, params ListWorkBySessionIdParams)
	// Submit work for one session
	// (POST /factory-sessions/{session_id}/work)
	SubmitWorkBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID)
	// Upsert work request for one session
	// (PUT /factory-sessions/{session_id}/work-requests/{request_id})
	UpsertWorkRequestBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID, requestId string)
	// Stage one submit-work file for one session
	// (POST /factory-sessions/{session_id}/work/staged-files)
	StageSubmitWorkFileBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID)
	// Get work for one session
	// (GET /factory-sessions/{session_id}/work/{id})
	GetWorkBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID, id WorkOrTokenID)
	// Move work to another state for one session
	// (POST /factory-sessions/{session_id}/work/{id}/move)
	MoveWorkBySessionId(w http.ResponseWriter, r *http.Request, sessionId SessionID, id WorkOrTokenID)
	// Validate factory definition
	// (POST /factory-validations)
	ValidateFactory(w http.ResponseWriter, r *http.Request)
	// List discovered models
	// (GET /models)
	ListModels(w http.ResponseWriter, r *http.Request)
	// Get one discovered model
	// (GET /models/{model_name})
	GetModel(w http.ResponseWriter, r *http.Request, modelName string)
	// Invoke one discovered model directly
	// (POST /models/{model_name}/invocations)
	InvokeModel(w http.ResponseWriter, r *http.Request, modelName string)
	// Pull local model assets into the managed cache
	// (POST /models/{model_name}/pull)
	PullModel(w http.ResponseWriter, r *http.Request, modelName string)
	// Get provider session details
	// (GET /provider-sessions/detail)
	GetProviderSessionDetails(w http.ResponseWriter, r *http.Request, params GetProviderSessionDetailsParams)
	// Get runtime status
	// (GET /status)
	GetStatus(w http.ResponseWriter, r *http.Request)
	// List work
	// (GET /work)
	ListWork(w http.ResponseWriter, r *http.Request, params ListWorkParams)
	// Submit work
	// (POST /work)
	SubmitWork(w http.ResponseWriter, r *http.Request)
	// Upsert work request
	// (PUT /work-requests/{request_id})
	UpsertWorkRequest(w http.ResponseWriter, r *http.Request, requestId string)
	// Stage one submit-work file
	// (POST /work/staged-files)
	StageSubmitWorkFile(w http.ResponseWriter, r *http.Request)
	// Get work
	// (GET /work/{id})
	GetWork(w http.ResponseWriter, r *http.Request, id WorkOrTokenID)
	// Move work to another state
	// (POST /work/{id}/move)
	MoveWork(w http.ResponseWriter, r *http.Request, id WorkOrTokenID)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type SessionID = string

type SortBy string

type StageSubmitWorkFileBySessionIdJSONRequestBody = StageSubmitWorkFileRequest

type StageSubmitWorkFileJSONRequestBody = StageSubmitWorkFileRequest

type StageSubmitWorkFileRequest struct {
	// ContentBase64 Base64-encoded file payload to stage behind a backend-owned reference.
	ContentBase64 string `json:"contentBase64"`

	// FileName Browser-authored filename preserved for inline identification and staging.
	FileName string `json:"fileName"`

	// ItemType Supported dashboard submit-work item types for multimodal submission.
	ItemType SubmitWorkItemType `json:"itemType"`

	// MediaType Browser-authored MIME type preserved for validation and dispatch decisions.
	MediaType string `json:"mediaType"`
}

type StageSubmitWorkFileResponse struct {
	// FileName Browser-authored filename preserved for inline identification after staging.
	FileName string `json:"fileName"`

	// MediaType Browser-authored MIME type preserved for inline identification after staging.
	MediaType string `json:"mediaType"`

	// StagedFileRef Backend-owned staged file reference returned for later structured submit-work items.
	StagedFileRef string `json:"stagedFileRef"`

	// Url Canonical content URL for the submitted file-backed item. Supported schemes are file://, http://, https://, and data:.
	Url SubmitWorkContentURLProperty `json:"url"`
}

type StateName = string

type StateType = WorkStateType

type StatusCategories struct {
	Failed     int `json:"failed"`
	Initial    int `json:"initial"`
	Processing int `json:"processing"`
	Terminal   int `json:"terminal"`
}

type StatusResponse struct {
	Categories    StatusCategories `json:"categories"`
	FactoryState  string           `json:"factoryState"`
	Resources     *[]ResourceUsage `json:"resources,omitempty"`
	RuntimeStatus string           `json:"runtimeStatus"`
	TotalTokens   int              `json:"totalTokens"`
}

type StringMap map[string]string

type SubmitRelation struct {
	// RequiredState Required target state before the dependency can proceed.
	RequiredState *string `json:"requiredState,omitempty"`

	// TargetWorkId Target runtime work identifier for the relation.
	TargetWorkId string `json:"targetWorkId"`

	// Type Relationship category between two pieces of work.
	Type RelationType `json:"type"`
}

type SubmitWorkAudioItem struct {
	// FileName Browser-authored filename preserved for inline identification and validation.
	FileName string `json:"fileName"`

	// MediaType Browser-authored MIME type preserved for validation and dispatch decisions.
	MediaType string `json:"mediaType"`

	// StagedFileRef Backend-owned staged file reference preserved for later dispatch.
	StagedFileRef string             `json:"stagedFileRef"`
	Type          SubmitWorkItemType `json:"type"`

	// Url Canonical content URL for the submitted file-backed item. Supported schemes are file://, http://, https://, and data:.
	Url SubmitWorkContentURLProperty `json:"url"`
}

type SubmitWorkBySessionIdJSONRequestBody = SubmitWorkRequest

type SubmitWorkContentURLProperty = string

type SubmitWorkDocumentItem struct {
	// FileName Browser-authored filename preserved for inline identification and validation.
	FileName string `json:"fileName"`

	// MediaType Browser-authored MIME type preserved for validation and dispatch decisions.
	MediaType string `json:"mediaType"`

	// StagedFileRef Backend-owned staged file reference preserved for later dispatch.
	StagedFileRef string             `json:"stagedFileRef"`
	Type          SubmitWorkItemType `json:"type"`

	// Url Canonical content URL for the submitted file-backed item. Supported schemes are file://, http://, https://, and data:.
	Url SubmitWorkContentURLProperty `json:"url"`
}

type SubmitWorkFileItemCommonFields struct {
	// FileName Browser-authored filename preserved for inline identification and validation.
	FileName *string `json:"fileName,omitempty"`

	// MediaType Browser-authored MIME type preserved for validation and dispatch decisions.
	MediaType *string `json:"mediaType,omitempty"`

	// StagedFileRef Backend-owned staged file reference preserved for later dispatch.
	StagedFileRef *string `json:"stagedFileRef,omitempty"`

	// Url Canonical content URL for the submitted file-backed item. Supported schemes are file://, http://, https://, and data:.
	Url SubmitWorkContentURLProperty `json:"url"`
}

type SubmitWorkImageItem struct {
	// FileName Browser-authored filename preserved for inline identification and validation.
	FileName string `json:"fileName"`

	// MediaType Browser-authored MIME type preserved for validation and dispatch decisions.
	MediaType string `json:"mediaType"`

	// StagedFileRef Backend-owned staged file reference preserved for later dispatch.
	StagedFileRef string             `json:"stagedFileRef"`
	Type          SubmitWorkItemType `json:"type"`

	// Url Canonical content URL for the submitted file-backed item. Supported schemes are file://, http://, https://, and data:.
	Url SubmitWorkContentURLProperty `json:"url"`
}

type SubmitWorkItem struct {
	// contains filtered or unexported fields
}

type SubmitWorkItemList = []SubmitWorkItem

type SubmitWorkItemType string

type SubmitWorkJSONRequestBody = SubmitWorkRequest

type SubmitWorkRequest struct {
	// Content Ordered canonical content parts for one work item.
	Content *WorkContent `json:"content,omitempty"`

	// CurrentChainingTraceId Explicit chaining-trace identifier for the submitted work.
	CurrentChainingTraceId *string `json:"currentChainingTraceId,omitempty"`

	// Items Ordered dashboard-authored submit-work items preserved for one submission.
	Items *SubmitWorkItemList `json:"items,omitempty"`

	// Name Required authored name for this single-work submission.
	Name string `json:"name"`

	// Payload Opaque work payload forwarded as raw JSON.
	Payload interface{} `json:"payload,omitempty"`

	// Relations Optional token-level runtime relations preserved on the submitted work item.
	Relations *[]SubmitRelation `json:"relations,omitempty"`
	Tags      *StringMap        `json:"tags,omitempty"`

	// TraceId Legacy trace identifier retained for compatibility; prefer currentChainingTraceId.
	TraceId *string `json:"traceId,omitempty"`

	// WorkTypeName Configured work type name from factory.json to submit to.
	WorkTypeName string `json:"workTypeName"`
}

type SubmitWorkResponse struct {
	// Accepted False when the same requestId was already accepted (idempotent replay).
	Accepted bool `json:"accepted"`

	// Name Submitted work display name.
	Name *string `json:"name,omitempty"`

	// RequestId Stable request identifier assigned during normalization.
	RequestId string `json:"requestId"`

	// SessionId Factory session that accepted the submit (~default for POST /work).
	SessionId *string `json:"sessionId,omitempty"`

	// TraceId Trace identifier for the submitted work request batch.
	TraceId string `json:"traceId"`

	// WorkId Primary work identifier for single-work submits (batch-<requestId>-<name> when omitted).
	WorkId *string `json:"workId,omitempty"`

	// WorkTypeName Configured work type name for the submitted work.
	WorkTypeName *string `json:"workTypeName,omitempty"`
}

type SubmitWorkTextItem struct {
	// Text Authored inline text preserved in item order.
	Text string             `json:"text"`
	Type SubmitWorkItemType `json:"type"`
}

type SubmitWorkVideoItem struct {
	// FileName Browser-authored filename preserved for inline identification and validation.
	FileName string `json:"fileName"`

	// MediaType Browser-authored MIME type preserved for validation and dispatch decisions.
	MediaType string `json:"mediaType"`

	// StagedFileRef Backend-owned staged file reference preserved for later dispatch.
	StagedFileRef string             `json:"stagedFileRef"`
	Type          SubmitWorkItemType `json:"type"`

	// Url Canonical content URL for the submitted file-backed item. Supported schemes are file://, http://, https://, and data:.
	Url SubmitWorkContentURLProperty `json:"url"`
}

type TokenHistory struct {
	ConsecutiveFailures *IntegerMap `json:"consecutiveFailures,omitempty"`
	LastError           *string     `json:"lastError,omitempty"`
	PlaceVisits         *IntegerMap `json:"placeVisits,omitempty"`
	TotalVisits         *IntegerMap `json:"totalVisits,omitempty"`
}

type TokenResponse struct {
	ChainingTraceDepth *int `json:"chainingTraceDepth,omitempty"`

	// Content Ordered canonical content parts for one work item.
	Content                  *WorkContent  `json:"content,omitempty"`
	CreatedAt                time.Time     `json:"createdAt"`
	CurrentChainingTraceId   *string       `json:"currentChainingTraceId,omitempty"`
	EnteredAt                time.Time     `json:"enteredAt"`
	History                  *TokenHistory `json:"history,omitempty"`
	Id                       string        `json:"id"`
	Name                     *string       `json:"name,omitempty"`
	PlaceId                  string        `json:"placeId"`
	PreviousChainingTraceIds *[]string     `json:"previousChainingTraceIds,omitempty"`
	Tags                     *StringMap    `json:"tags,omitempty"`
	TraceId                  string        `json:"traceId"`
	WorkId                   string        `json:"workId"`
	WorkType                 string        `json:"workType"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type Transition struct {
	// From Source workstation name.
	From string `json:"from"`

	// To Destination workstation name.
	To string `json:"to"`
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type UpsertWorkRequestBySessionIdJSONRequestBody = WorkRequest

type UpsertWorkRequestJSONRequestBody = WorkRequest

type UpsertWorkRequestResponse struct {
	RequestId string                           `json:"requestId"`
	TraceId   string                           `json:"traceId"`
	Works     []UpsertWorkRequestSubmittedWork `json:"works"`
}

type UpsertWorkRequestSubmittedWork struct {
	Name         string `json:"name"`
	WorkId       string `json:"workId"`
	WorkTypeName string `json:"workTypeName"`
}

type ValidateCurrentFactoryWorkstationPromptTemplateBySessionIdJSONRequestBody = PromptTemplateValidationRequest

type ValidateFactoryJSONRequestBody = Factory

type WallClock struct {
	FinishedAt *time.Time `json:"finishedAt,omitempty"`
	StartedAt  *time.Time `json:"startedAt,omitempty"`
}

type Work struct {
	// ChainingTraceDepth Current chaining depth for this work item when the runtime already knows its upstream lineage.
	ChainingTraceDepth *int `json:"chainingTraceDepth,omitempty"`

	// Content Ordered canonical content parts for one work item.
	Content *WorkContent `json:"content,omitempty"`

	// CurrentChainingTraceId Explicit chaining-trace identifier for this submitted work item.
	CurrentChainingTraceId *string `json:"currentChainingTraceId,omitempty"`

	// Name A human readable name for the work, not unique
	Name string `json:"name"`

	// Payload Opaque work payload forwarded as raw JSON, or a binary data, or whatever else.
	Payload interface{} `json:"payload,omitempty"`

	// PreviousChainingTraceIds Explicit predecessor chaining traces that directly caused this work item.
	PreviousChainingTraceIds *[]string `json:"previousChainingTraceIds,omitempty"`

	// Relations Current outbound relationships attached to this listed source work item when returned by read APIs.
	Relations *[]Relation `json:"relations,omitempty"`

	// RequestId Identifier for the original request that created this work, if applicable
	RequestId *string `json:"requestId,omitempty"`

	// State A lifecycle state that a work item can occupy inside one work type.
	State *WorkState `json:"state,omitempty"`
	Tags  *StringMap `json:"tags,omitempty"`

	// TraceId Legacy trace identifier retained for compatibility; prefer currentChainingTraceId.
	TraceId *string `json:"traceId,omitempty"`

	// WorkId Unique identifier for the work
	WorkId *string `json:"workId,omitempty"`

	// WorkTypeName Configured work type name from factory.json for this submitted work item.
	WorkTypeName *string `json:"workTypeName,omitempty"`
}

type WorkAudioContentPart struct {
	// ArtifactId Optional artifact identifier for externally materialized content.
	ArtifactId *string `json:"artifactId,omitempty"`

	// ContentType Optional MIME content type for file-backed or structured parts.
	ContentType *string `json:"contentType,omitempty"`

	// File Deprecated host-local file path. Use url instead. Legacy values may be normalized to url at ingest during migration.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	File *WorkContentDeprecatedFileProperty `json:"file,omitempty"`

	// Label Optional caller-defined label for slot binding or diagnostics.
	Label *string `json:"label,omitempty"`

	// Metadata Optional metadata attached to one work content part.
	Metadata *WorkContentMetadata `json:"metadata,omitempty"`

	// Role Optional semantic role for model-operation authoring.
	Role *string `json:"role,omitempty"`

	// Slot Optional slot name used by model-operation binding selectors and diagnostics.
	Slot *string             `json:"slot,omitempty"`
	Type WorkContentPartType `json:"type"`

	// Url Canonical content reference for file-backed parts. Supported schemes are file://, http://, https://, and data:.
	Url WorkContentURLProperty `json:"url"`
}

type WorkBinaryContentPart struct {
	// ArtifactId Optional artifact identifier for externally materialized content.
	ArtifactId *string `json:"artifactId,omitempty"`

	// ContentType Optional MIME content type for file-backed or structured parts.
	ContentType *string `json:"contentType,omitempty"`

	// File Deprecated host-local file path. Use url instead. Legacy values may be normalized to url at ingest during migration.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	File *WorkContentDeprecatedFileProperty `json:"file,omitempty"`

	// Label Optional caller-defined label for slot binding or diagnostics.
	Label *string `json:"label,omitempty"`

	// Metadata Optional metadata attached to one work content part.
	Metadata *WorkContentMetadata `json:"metadata,omitempty"`

	// Role Optional semantic role for model-operation authoring.
	Role *string `json:"role,omitempty"`

	// Slot Optional slot name used by model-operation binding selectors and diagnostics.
	Slot *string             `json:"slot,omitempty"`
	Type WorkContentPartType `json:"type"`

	// Url Canonical content reference for file-backed parts. Supported schemes are file://, http://, https://, and data:.
	Url WorkContentURLProperty `json:"url"`
}

type WorkContent = []WorkContentPart

type WorkContentCommonFields struct {
	// ArtifactId Optional artifact identifier for externally materialized content.
	ArtifactId *string `json:"artifactId,omitempty"`

	// ContentType Optional MIME content type for file-backed or structured parts.
	ContentType *string `json:"contentType,omitempty"`

	// Label Optional caller-defined label for slot binding or diagnostics.
	Label *string `json:"label,omitempty"`

	// Metadata Optional metadata attached to one work content part.
	Metadata *WorkContentMetadata `json:"metadata,omitempty"`

	// Role Optional semantic role for model-operation authoring.
	Role *string `json:"role,omitempty"`

	// Slot Optional slot name used by model-operation binding selectors and diagnostics.
	Slot *string `json:"slot,omitempty"`
}

type WorkContentDeprecatedFileProperty = string

type WorkContentMetadata map[string]interface{}

type WorkContentPart struct {
	// contains filtered or unexported fields
}

type WorkContentPartType string

type WorkContentURLProperty = string

type WorkDiagnostics struct {
	Command        *CommandDiagnostic        `json:"command,omitempty"`
	Metadata       *StringMap                `json:"metadata,omitempty"`
	Panic          *PanicDiagnostic          `json:"panic,omitempty"`
	Provider       *ProviderDiagnostic       `json:"provider,omitempty"`
	RenderedPrompt *RenderedPromptDiagnostic `json:"renderedPrompt,omitempty"`
}

type WorkFailureFamily string

type WorkFailureType string

type WorkImageContentPart struct {
	// ArtifactId Optional artifact identifier for externally materialized content.
	ArtifactId *string `json:"artifactId,omitempty"`

	// ContentType Optional MIME content type for file-backed or structured parts.
	ContentType *string `json:"contentType,omitempty"`

	// File Deprecated host-local file path. Use url instead. Legacy values may be normalized to url at ingest during migration.
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	File *WorkContentDeprecatedFileProperty `json:"file,omitempty"`

	// Label Optional caller-defined label for slot binding or diagnostics.
	Label *string `json:"label,omitempty"`

	// Metadata Optional metadata attached to one work content part.
	Metadata *WorkContentMetadata `json:"metadata,omitempty"`

	// Role Optional semantic role for model-operation authoring.
	Role *string `json:"role,omitempty"`

	// Slot Optional slot name used by model-operation binding selectors and diagnostics.
	Slot *string             `json:"slot,omitempty"`
	Type WorkContentPartType `json:"type"`

	// Url Canonical content reference for file-backed parts. Supported schemes are file://, http://, https://, and data:.
	Url WorkContentURLProperty `json:"url"`
}

type WorkJsonContentPart struct {
	// ArtifactId Optional artifact identifier for externally materialized content.
	ArtifactId *string `json:"artifactId,omitempty"`

	// ContentType Optional MIME content type for file-backed or structured parts.
	ContentType *string `json:"contentType,omitempty"`

	// Json Arbitrary JSON value preserved in canonical part order.
	Json interface{} `json:"json"`

	// Label Optional caller-defined label for slot binding or diagnostics.
	Label *string `json:"label,omitempty"`

	// Metadata Optional metadata attached to one work content part.
	Metadata *WorkContentMetadata `json:"metadata,omitempty"`

	// Role Optional semantic role for model-operation authoring.
	Role *string `json:"role,omitempty"`

	// Slot Optional slot name used by model-operation binding selectors and diagnostics.
	Slot *string             `json:"slot,omitempty"`
	Type WorkContentPartType `json:"type"`
}

type WorkListName = string

type WorkListTraceId = string

type WorkListWorkTypeName = string

type WorkMetrics struct {
	Cost           *float64 `json:"cost,omitempty"`
	DurationMillis *int64   `json:"durationMillis,omitempty"`
	RetryCount     *int     `json:"retryCount,omitempty"`
}

type WorkOrTokenID = string

type WorkOutcome string

type WorkRequest struct {
	// CurrentChainingTraceId Optional default chaining-trace identifier applied to submitted work items that omit it.
	CurrentChainingTraceId *string `json:"currentChainingTraceId,omitempty"`

	// Relations Relationships between various work items.
	Relations *[]Relation `json:"relations,omitempty"`

	// RequestId Stable client-provided request identifier used for idempotent batch submission.
	RequestId string `json:"requestId"`

	// Type Kind of work request accepted by the factory.
	Type WorkRequestType `json:"type"`

	// Works A batch of work items to be submitted together.
	Works *[]Work `json:"works,omitempty"`
}

type WorkRequestEventPayload struct {
	ParentLineage *[]string   `json:"parentLineage,omitempty"`
	Relations     *[]Relation `json:"relations,omitempty"`
	Source        *string     `json:"source,omitempty"`

	// Type Kind of work request accepted by the factory.
	Type  WorkRequestType `json:"type"`
	Works *[]Work         `json:"works,omitempty"`
}

type WorkRequestType string

type WorkState struct {
	// Name Customer-authored state name referenced by workstation inputs and outputs.
	Name string `json:"name"`

	// Type Categories of work states. The factory runtime treats these categories differently for lifecycle tracking and metrics purposes. Initial: The work is waiting to be picked up by a workstation. Processing: The work has been partially processed, and is continuing through its lifecycle. Terminal: The work has completed successfully. Failed: The work has failed.
	Type WorkStateType `json:"type"`
}

type WorkStateChangeEventPayload struct {
	// FromPlaceId Marking place identifier before the move.
	FromPlaceId string `json:"fromPlaceId"`

	// FromState Authored state name before the move.
	FromState string `json:"fromState"`

	// Reason Optional human-readable reason for the move.
	Reason *string `json:"reason,omitempty"`

	// Source Origin of a WORK_STATE_CHANGE event.
	Source WorkStateChangeSource `json:"source"`

	// ToPlaceId Marking place identifier after the move.
	ToPlaceId string `json:"toPlaceId"`

	// ToState Authored state name after the move.
	ToState string `json:"toState"`

	// TriggerWorkId Optional work identifier that triggered a cascade move.
	TriggerWorkId *string `json:"triggerWorkId,omitempty"`
	WorkId        string  `json:"workId"`
	WorkTypeName  string  `json:"workTypeName"`
}

type WorkStateChangeSource string

type WorkStateType string

type WorkTextContentPart struct {
	// ArtifactId Optional artifact identifier for externally materialized content.
	ArtifactId *string `json:"artifactId,omitempty"`

	// ContentType Optional MIME content type for file-backed or structured parts.
	ContentType *string `json:"contentType,omitempty"`

	// Label Optional caller-defined label for slot binding or diagnostics.
	Label *string `json:"label,omitempty"`

	// Metadata Optional metadata attached to one work content part.
	Metadata *WorkContentMetadata `json:"metadata,omitempty"`

	// Role Optional semantic role for model-operation authoring.
	Role *string `json:"role,omitempty"`

	// Slot Optional slot name used by model-operation binding selectors and diagnostics.
	Slot *string `json:"slot,omitempty"`

	// Text Inline text content preserved in canonical part order.
	Text string              `json:"text"`
	Type WorkContentPartType `json:"type"`
}

type WorkType struct {
	// HandlingBehavior Optional CLI routing markers for this work type. Factories used with you run --factory must declare handlingBehavior DEFAULT on exactly one work type.
	HandlingBehavior *[]WorkTypeHandlingBehavior `json:"handlingBehavior,omitempty"`

	// Name Customer-authored work type name referenced by workstation inputs, outputs, and submitted work.
	Name string `json:"name"`

	// States Lifecycle states available for work items of this type.
	States []WorkState `json:"states"`
}

type WorkTypeHandlingBehavior string

type Worker struct {
	// Args Additional command arguments passed to the configured command.
	Args *[]string `json:"args,omitempty"`

	// Auth Hosted-worker authentication contract. V1 hosted workers accept only secret references rather than inline credentials or OAuth-style fields.
	Auth *HostedWorkerAuth `json:"auth,omitempty"`

	// Body Inline worker instructions or script body when the worker is authored directly in factory config.
	Body *string `json:"body,omitempty"`

	// Command Command to execute when this worker runs through a command or script provider.
	Command *string `json:"command,omitempty"`

	// ExecutorProvider Concrete worker-provider wrappers supported by the public factory-config contract.
	ExecutorProvider *WorkerProvider `json:"executorProvider,omitempty"`

	// Linear Provider-specific poller configuration for the built-in hosted Linear worker.
	Linear *HostedLinearWorkerConfig `json:"linear,omitempty"`

	// Model Model identifier to request from the configured model provider when this worker uses model execution.
	Model *string `json:"model,omitempty"`

	// ModelLocality Provider locality for a model worker capability declaration.
	ModelLocality *WorkerModelLocality `json:"modelLocality,omitempty"`

	// ModelProvider Canonical model-provider identifiers supported by model workers in factory config.
	ModelProvider *WorkerModelProvider `json:"modelProvider,omitempty"`

	// Name Worker name referenced by Workstation.worker.
	Name string `json:"name"`

	// OpenCodeAgent Optional OpenCode agent profile name for model workers that dispatch through the OpenCode runner. When set, OpenCode dispatches invoke `opencode run --agent <name>`. Discover agent names with `opencode agent list` (see https://opencode.ai/docs/cli/).
	OpenCodeAgent *string `json:"openCodeAgent,omitempty"`

	// Operations Provider-agnostic model operations that this worker can execute, including named input and output slots.
	Operations *[]ModelOperation `json:"operations,omitempty"`

	// Provider Built-in repository-owned hosted worker providers supported by the public factory-config contract.
	Provider *HostedWorkerProvider `json:"provider,omitempty"`

	// Resources Resource capacity this worker requires before it can be dispatched.
	Resources *[]ResourceRequirement `json:"resources,omitempty"`

	// SkipPermissions When true, bypasses permission checks for providers that support permission gating.
	SkipPermissions *bool `json:"skipPermissions,omitempty"`

	// StopToken Marker that tells model-oriented workers where to stop generated output when the provider supports it.
	StopToken *string `json:"stopToken,omitempty"`

	// Timeout Optional Go duration that caps one worker execution attempt.
	Timeout *string `json:"timeout,omitempty"`

	// Type Worker implementation families supported by the public factory-config contract.
	Type *WorkerType `json:"type,omitempty"`
}