Classifier workstation

Configure type = CLASSIFIER_WORKSTATION for classification routes and classifier-specific output restrictions through a HOSTED_WORKER companion.

How To Use

Author a workstation with type CLASSIFIER_WORKSTATION and bind a HOSTED_WORKER companion. Choose behavior for the scheduling axis you need — STANDARD for fire-once classification, REPEATER for change-triggered loops, CRON for schedules, or POLLER for long-lived poller ingress. Wire inputs plus classificationRoutes so each label maps to destination workstations, and keep onFailure for failure routing. Do not set outputs, onContinue, onRejection, guards, openCodeAgent, promptFile, outcomeFormat, operation, operationBindings, or cron fields that belong to other WorkstationType or WorkstationKind families. Choose LOGICAL_MOVE for guarded non-worker routing, AGENT_RUN for agent loops, or INFERENCE_RUN for bounded inference harness dispatch. CLASSIFIER_WORKSTATION is not a scheduling behavior and is not LOGICAL_MOVE — keep guards on the logical-move type. Both share HOSTED_WORKER companions, but their selected field sets stay separate.

Discriminator: type = CLASSIFIER_WORKSTATION

CLASSIFIER_WORKSTATION requires a HOSTED_WORKER companion and is compatible with every published WorkstationKind. Bind the hosted worker for classification routing, then choose scheduling on the behavior axis. LOGICAL_MOVE also uses HOSTED_WORKER but selects guards instead of classificationRoutes.

Schema reference

The embed below shows the live Workstation base definition with CLASSIFIER_WORKSTATION overlay applicability. CLASSIFIER_WORKSTATION selects the exclusive classificationRoutes field and excludes outputs, onContinue, and onRejection. Other excluded fields belong to other WorkstationType families or to CRON scheduling and must not appear on this type. Open the full Factory schema reference for exhaustive field lookup rather than copying contract text into this page.

Workstation

object

A processing step in the factory graph. Workstations consume authored work states, run a worker or logical move, and emit the next work states.

additionalPropertiesfalse (closed)

Fields

behaviorbehaviorOptionalWorkstationKind
Scheduling behavior for this workstation, such as STANDARD, REPEATER, or CRON execution.
bodybodyOptionalstring
Inline workstation instructions or script body when authored directly in factory config.
classificationRoutesclassificationRoutesOptionalClassificationRoute[]Selected
Explicit label-to-destination routing used only by CLASSIFIER_WORKSTATION definitions. Each route must declare a unique non-empty label and one or more outputs.
copyReferencedScriptscopyReferencedScriptsOptionalboolean
Copy supported referenced script files into the expanded workstation layout when config expand runs.
croncronOptionalWorkstationCronExcluded
Cron trigger configuration for workstations whose behavior is CRON.
descriptiondescriptionOptionalNameValue
Optional localized customer-facing explanation of this workstation.
envenvOptionalStringMap
Environment variables added to the workstation execution context.
guardsguardsOptionalWorkstationGuard[]Excluded
Guarded loop breakers should use `VISIT_COUNT` guards here with a `LOGICAL_MOVE` workstation instead of top-level exhaustion rules.
ididOptionalstring
Optional durable public identifier for this workstation. Graph and layout references should use this id instead of the mutable name.
inputsinputsRequiredWorkstationIO[]
Work states this workstation can consume before it dispatches.
limitslimitsOptionalWorkstationLimits
Retry and execution ceilings applied to this workstation.
namenameRequiredstring
Customer-authored workstation name used by guards, diagnostics, and authored references.
onContinueonContinueOptionalWorkstationIO[]Excluded
Optional destination emitted when the workstation makes partial progress and should continue iterating. Classifier workstations must not declare onContinue.
onFailureonFailureOptionalWorkstationIO[]
Optional destination emitted when the workstation fails permanently.
onRejectiononRejectionOptionalWorkstationIO[]Excluded
Optional destination emitted when the worker rejects the current work without a hard failure. Classifier workstations must not declare onRejection.
operationoperationOptionalModelOperationNameExcluded
Uppercase provider-agnostic operation requested by `MODEL_INVOKE` workstations, such as `TTS`.
operationBindingsoperationBindingsOptionalWorkstationOperationBinding[]Excluded
Optional workstation-authored slot bindings that resolve operation inputs from runtime content or static config content.
outcomeFormatoutcomeFormatOptionalWorkstationOutcomeFormatExcluded
Optional worker-output parsing mode for model workstations. When set to `decision-envelope`, agent output is parsed as a reviewer/checker JSON envelope that maps directly onto WorkResult outcome, feedback, output, and optional recorded output work instead of stop-token routing.
outputSchemaoutputSchemaOptionalstringExcluded
JSON schema string used to validate or parse structured model output when configured.
outputsoutputsOptionalWorkstationIO[]Excluded
Work states emitted after a non-classifier workstation succeeds. Classifier workstations must use classificationRoutes instead of normal success outputs.
promptFilepromptFileOptionalstringExcluded
Path to a prompt template file loaded for model-oriented workstation execution.
resourcesresourcesOptionalResourceRequirement[]
Resource capacity this workstation consumes while one dispatch is in flight.
runnerrunnerOptionalRunnerID
Optional workstation-specific runner override. When omitted, dispatch falls back to the factory runner, then worker modelProvider compatibility when no explicit runner is configured, then the default codex runner.
stopWordsstopWordsOptionalarrayExcluded
Stop words authored on the topology entry for model-oriented dispatches.
typetypeOptionalWorkstationType
Runtime workstation implementation type, equivalent to the workstation AGENTS.md frontmatter type.
workPropagationworkPropagationOptionalWorkPropagation
Optional policy for whether downstream work uses the workstation output payload or preserves the consumed input payload.
workerworkerRequiredstring
Name of a worker declared in the workers list.
workingDirectoryworkingDirectoryOptionalstring
Go template resolved from token tags at dispatch time.
worktreeworktreeOptionalstring
Go template resolved and passed as the worktree path to CLI dispatchers.

Full Factory schema reference

Examples

Use the minimal valid example when starting a CLASSIFIER_WORKSTATION with behavior STANDARD and classificationRoutes. The misuse example borrows outputs from ordinary WorkstationTypes — that field is excluded from CLASSIFIER_WORKSTATION.

Minimal valid CLASSIFIER_WORKSTATION workstation:

{
  "name": "label-route-step",
  "worker": "hosted-main",
  "type": "CLASSIFIER_WORKSTATION",
  "behavior": "STANDARD",
  "classificationRoutes": {
    "accept": [
      "accepted"
    ],
    "reject": [
      "rejected"
    ]
  },
  "inputs": [
    "ready"
  ],
  "onFailure": [
    "failed"
  ]
}

Incompatible misuse — outputs on CLASSIFIER_WORKSTATION:

{
  "name": "label-route-step",
  "worker": "hosted-main",
  "type": "CLASSIFIER_WORKSTATION",
  "behavior": "STANDARD",
  "outputs": [
    "accepted"
  ],
  "onContinue": [
    "ready"
  ],
  "inputs": [
    "ready"
  ],
  "onFailure": [
    "failed"
  ]
}

outputs, onContinue, and onRejection are excluded from CLASSIFIER_WORKSTATION. Keep label routing on classificationRoutes and failure routing on onFailure only.