Workers

Choose and configure you-agent-factory workers: runtime executors declared in the factory and invoked by workstations, with six Factory WorkerType variants plus a separate mock-worker surface.

A worker is a named runtime executor a workstation invokes by name. factory.json declares each worker; the WorkerType discriminator selects the implementation family. Pick the matching variant page before you author type-specific fields, and keep mock workers on their own test-only schema.

How To Use

Use the selection table to open the WorkerType page that matches the work. Prefer current public WorkerType names in new configs; legacy MODEL_WORKER and HOSTED_WORKER remain loadable aliases with their own migration pages. Author shared identity fields such as name, type, body, timeout, and resources before variant-specific configuration. Mock workers are not a Factory WorkerType — keep them on the mock-workers schema for deterministic test dispatch only.

Select A Worker Variant

Use the comparison below to open the matching variant page. Prefer current public WorkerType names in new configs. Legacy MODEL_WORKER and HOSTED_WORKER remain loadable aliases and have their own pages for migration review.

WorkerType	Use when	Variant page
INFERENCE_WORKER	One-shot harness inference such as TTS, ASR, or typed INFERENCE_RUN dispatches	Inference worker
AGENT_WORKER	Agent-loop execution for AGENT_RUN workstations until acceptance, rejection, or failure	Agent worker
SCRIPT_WORKER	Command-backed SCRIPT_RUN workstations	Script worker
POLLER_WORKER	Hosted poller ingress paired with workstation behavior POLLER	Poller worker
MODEL_WORKER	Legacy managed or local model capability alias — prefer INFERENCE_WORKER or AGENT_WORKER for new configs	Model worker
HOSTED_WORKER	Legacy hosted provider alias — prefer POLLER_WORKER for new configs	Hosted worker
Mock worker (not a WorkerType)	Test-only deterministic accept, script, or reject dispatch from the mock-workers schema	Mock worker

Mock workers are not a seventh Factory WorkerType. Keep them on the mock-workers schema and the mock worker page.

Shared Fields

These fields apply across Factory Worker variants. Variant pages add type-specific fields such as model routing, command and args, or hosted provider auth. The live Worker schema embed below shows the base contract from the installed Factory package.

Field	Role
name	Worker identity declared in the factory and bound by workstations
type	WorkerType discriminator that selects the implementation family
body	Shared markdown body — system prompt for agent workers; descriptive for other types
timeout	Execution time bound for the worker run
resources	Resource claims the worker needs at runtime

Worker Schema

The embed shows the live Factory Worker base definition from the installed package. Open the full Factory schema reference for exhaustive field lookup rather than copying contract text into this index.

Worker

object

A reusable worker definition that tells the factory how a workstation should execute work, such as through a model-backed agent or a script.

additionalPropertiesfalse (closed)

Fields

agentToolsagentToolsOptionalAgentWorkerToolsConfig
Explicit agent-loop tool policy for AGENT_WORKER definitions. Omit or set policy DISABLED to run agent loops without advertising or executing tools.
argsargsOptionalarray
Additional command arguments passed to the configured command.
authauthOptionalHostedWorkerAuth
Hosted-worker authentication contract. V1 hosted workers accept only auth.secretRef.
bodybodyOptionalstring
Inline worker instructions or script body when the worker is authored directly in factory config.
commandcommandOptionalstring
Command to execute when this worker runs through a command or script provider.
descriptiondescriptionOptionalNameValue
Optional localized customer-facing explanation of this worker.
executorProviderexecutorProviderOptionalWorkerProvider
Execution mechanism. Use `ACP` for ACP-backed workers and put the configured integration identity (for example `cursor-acp`) in modelProvider. `SCRIPT_WRAP` remains the command-wrapper compatibility value; legacy named executor identities remain accepted during migration.
ididOptionalstring
Optional durable public identifier for this worker. When present, graph and layout references should use this id instead of the mutable name.
linearlinearOptionalHostedLinearWorkerConfig
Provider-specific configuration for the built-in hosted LINEAR worker.
modelmodelOptionalstring
Model identifier to request from the configured model provider when this worker uses model execution.
modelLocalitymodelLocalityOptionalWorkerModelLocality
Provider locality for this model capability declaration. Use `LOCAL` for embedded or host-managed inference and `CLOUD` for remote provider execution.
modelProvidermodelProviderOptionaloneOf
Canonical provider identity used for model routing and provider diagnostics, or an exact invocation-parameter placeholder such as `${modelProvider}`. For `executorProvider: ACP`, this names the configured ACP integration, such as `cursor-acp`. Extension identities use lowercase standardized syntax; built-in values such as `CLAUDE` and `CODEX` remain compatibility conveniences.
namenameRequiredstring
Worker name referenced by Workstation.worker.
operationsoperationsOptionalModelOperation[]
Provider-agnostic model operations that this worker can execute, including named input and output slots.
providerproviderOptionalHostedWorkerProvider
Built-in hosted provider identity when this worker uses repository-owned hosted execution.
reasoningEffortreasoningEffortOptionalReasoningEffort
resourcesresourcesOptionalResourceRequirement[]
Resource capacity this worker requires before it can be dispatched.
skipPermissionsskipPermissionsOptionalboolean
When true, bypasses permission checks for providers that support permission gating.
stopTokenstopTokenOptionalstring
Marker that tells model-oriented workers where to stop generated output when the provider supports it.
timeouttimeoutOptionalstring
Optional Go duration that caps one worker execution attempt.
typetypeOptionalWorkerType
Worker implementation family to instantiate for this definition.

Full Factory schema reference