Settings
Every key in the factory settings document: 169 keys with type, allowed values, default and where each is stored.
Factory settings are one revisioned document per tenant. Change them on the Resolve Platform’s Factory settings page or with PUT /v1/factory/settings. Keys stored on sandbox belong to the Pix Sandbox and are edited here for convenience. A key marked locked cannot be changed.
Sections: agents · approve · audit · autonomy · belai · budget · crews · defaults · delivery · factory · other · forge · hosts · jail · kanban · notify · persistence · pix · providers · schedules · scope · security · signing · systemone · tea · vault
agents
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
agents.finalize_at |
num 0 to 0.95: share of any per-card limit at which the worker is told to wrap up (commit, record findings, publish a draft pull request); a value under 0.5 is raised to 0.5 (0 keeps the agent’s own, 0.85 for the built-ins) | 0 |
factory | Per-agent and per-card limits |
agents.max_attempts |
int 0 to 10: failed attempts at one stage before Belai blocks the card (0 keeps the agent’s own). Not autonomy.max_attempts, which retries a workflow step |
0 |
factory | Per-agent and per-card limits |
agents.max_continuations |
int 0 to 50: times a card may go back to be resumed after its budget ran out with progress made, before it is blocked for a person (0 keeps the agent’s own, 5 by default) | 0 |
factory | Per-agent and per-card limits |
agents.max_cost_usd_per_item |
num 0 to 10000: estimated cost in US dollars at which a worker’s claim on one card ends (0 keeps each agent’s own; the built-in agents allow $8 to $25) | 0 |
factory | Per-agent and per-card limits |
agents.max_iterations |
int 0 to 400: tool rounds per pass (0 keeps the agent’s own) | 0 |
factory | Per-agent and per-card limits |
agents.max_passes_per_item |
int 0 to 1000: goal passes per card, a safety rail beside the cost limit (0 keeps the agent’s own) | 0 |
factory | Per-agent and per-card limits |
agents.max_wall_minutes |
int 0 to 10080: minutes per card, a safety rail (0 keeps the agent’s own) | 0 |
factory | Per-agent and per-card limits |
approve
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
approve.sensitive_paths |
list. list of path globs (feGlobMatch dialect) that stop an approval, besides the built-in list | [] |
factory |
audit
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
audit.calls |
bool. bool: log every model call with its input hash | true |
factory | The audit ledger |
audit.sign |
bool. bool: sign the decision ledger | true |
factory | The audit ledger |
audit.weekly_report |
bool | true |
factory | The audit ledger |
autonomy
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
autonomy.claim_ttl_minutes |
int 1 to 1440. int 1 to 1440: minutes a started crew or worker dispatch may go without a session before the attempt fails card_unclaimed and retries |
60 |
factory | Autonomy levels |
autonomy.concurrency |
int 1 to 64 | 4 |
factory | Autonomy levels |
autonomy.default |
enum: observe, suggest, draft_pr, auto_merge_low_risk |
draft_pr |
factory | Autonomy levels |
autonomy.max |
enum: observe, suggest, draft_pr, auto_merge_low_risk |
draft_pr |
factory | Autonomy levels |
autonomy.max_attempts |
int 1 to 10 | 3 |
factory | Autonomy levels |
autonomy.no_host_ttl_hours |
int 1 to 168. int 1 to 168: hours a crew step may wait for a machine before the run ends no_host_timeout |
6 |
factory | Autonomy levels |
autonomy.parked_concurrency |
int 1 to 1000. int 1 to 1000: runs of the tenant that may wait for a machine at once; they do not count against autonomy.concurrency |
50 |
factory | Autonomy levels |
autonomy.plan_approval |
bool. bool (plan approval for belai:feature) |
true |
factory | Autonomy levels |
belai
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
belai.a2a.show |
bool. bool: transcripts show A2A rows (broadcasts, messages, replies, acks) by default; a viewer can override it locally | true |
factory | |
belai.ask_permission |
bool: whether the workers and crews a workflow or schedule starts stop at permission asks (sent as the dispatch’s ask; docs/factory-engine.md, “Stay and replicas”) |
false |
factory | |
belai.auto_commit_per_task |
bool | true |
factory | |
belai.guardrails |
enum: on, strict, off |
on |
factory | |
belai.mode |
enum: goal, agent, plan, auto |
goal |
factory | |
belai.show_internal_work |
enum: decisions, security, all, hidden |
decisions |
factory | |
belai.tests.on_fail |
enum: fix, diagnose, off |
fix |
factory | |
belai.tests.post_end |
enum: goal, goal_plan, session, off |
goal |
factory |
budget
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
budget.alerts |
list. list of int 1 to 100, ascending | [50, 80, 100] |
factory | Budgets |
budget.factory_share |
pct. pct of the Pix allowance | 75 |
factory | Budgets |
budget.month |
int 0 to 1e15. int tokens, all providers | 30000000 |
factory | Budgets |
budget.on_exceed |
enum: pause_run, downgrade_to_fast, switch_to_pix_allocation, escalate_human, hard_stop |
switch_to_pix_allocation |
factory | Budgets |
crews
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
crews.lease |
enum: 15m, 30m, 2h |
30m |
factory |
defaults
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
defaults.approve-ready.enabled |
bool | true |
factory | |
defaults.ci-fix.enabled |
bool | true |
factory | |
defaults.conflict-fix.enabled |
bool | true |
factory | |
defaults.enabled |
bool. bool: master switch | true |
factory | |
defaults.issue-to-pr.enabled |
bool | true |
factory | |
defaults.lint-sweep.enabled |
bool | true |
factory | |
defaults.pr-review.enabled |
bool | true |
factory | |
defaults.test-sweep.enabled |
bool | true |
factory |
delivery
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
delivery.companyDomain |
str. str: an email domain such as acme.example, or empty |
factory | Delivery | |
delivery.compare |
bool. bool: the hand-worked comparison, which adds the refinement and hand-off overhead | true |
factory | Delivery |
delivery.decisions |
bool. bool: price the decisions System One scored | true |
factory | Delivery |
delivery.enabled |
bool. bool: master switch. Off, every /delivery read answers {"enabled":false} and nothing is computed |
true |
factory | Delivery |
delivery.hoursPerMonth |
num 1 to 400: productive hours per person-month | 150 |
factory | Delivery |
delivery.idleGapMin |
int 1 to 120. int 1 to 120: minutes without an action that end a sitting | 5 |
factory | Delivery |
delivery.kinds.goal.enabled |
bool | true |
factory | Delivery |
delivery.kinds.goal.minutes |
num 0 to 480 | 3 |
factory | Delivery |
delivery.kinds.merge.enabled |
bool | true |
factory | Delivery |
delivery.kinds.merge.minutes |
num 0 to 480 | 8 |
factory | Delivery |
delivery.kinds.mode.enabled |
bool | true |
factory | Delivery |
delivery.kinds.mode.minutes |
num 0 to 480 | 0.5 |
factory | Delivery |
delivery.kinds.other.enabled |
bool | true |
factory | Delivery |
delivery.kinds.other.minutes |
num 0 to 480 | 2 |
factory | Delivery |
delivery.kinds.plan.enabled |
bool | true |
factory | Delivery |
delivery.kinds.plan.minutes |
num 0 to 480 | 4 |
factory | Delivery |
delivery.kinds.toolcall.enabled |
bool | false |
factory | Delivery |
delivery.kinds.toolcall.minutes |
num 0 to 480 | 0 |
factory | Delivery |
delivery.kinds.triage.enabled |
bool | true |
factory | Delivery |
delivery.kinds.triage.minutes |
num 0 to 480 | 6 |
factory | Delivery |
delivery.manualCardDays |
num 0 to 365: days a team takes per card | 5 |
factory | Delivery |
delivery.manualCycleDays |
num 0 to 365: days a team takes per pull request | 4.5 |
factory | Delivery |
delivery.manualDecisionWait |
num 0 to 720: hours a team waits to decide, compared with the measured time | 6 |
factory | Delivery |
delivery.manualIssueDays |
num 0 to 365: days a team takes per issue | 3 |
factory | Delivery |
delivery.multiplier |
num 0.5 to 10: multiplier for agent work no role covers | 2.4 |
factory | Delivery |
delivery.overheadPct |
pct. pct: refinement and hand-off overhead as a share of build and decision hours | 20 |
factory | Delivery |
delivery.overheadRate |
num 0 to 10000: USD per hour for the overhead | 105 |
factory | Delivery |
delivery.people |
bool. bool: the People and Contributors pages | true |
factory | Delivery |
delivery.peopleRate |
num 0 to 10000: USD per hour for the hours people spent in the factory (the cost side) | 110 |
factory | Delivery |
delivery.rate |
num 0 to 10000: USD per hour for agent work no role covers | 95 |
factory | Delivery |
delivery.reviewMinPer100 |
num 0 to 60: minutes of reading per 100 changed lines of a review | 4 |
factory | Delivery |
delivery.roles.devops.enabled |
bool | true |
factory | Delivery |
delivery.roles.devops.mult |
num 0.5 to 10 | 2.0 |
factory | Delivery |
delivery.roles.devops.rate |
num 0 to 10000 | 90 |
factory | Delivery |
delivery.roles.planner.enabled |
bool | true |
factory | Delivery |
delivery.roles.planner.mult |
num 0.5 to 10 | 1.6 |
factory | Delivery |
delivery.roles.planner.rate |
num 0 to 10000 | 120 |
factory | Delivery |
delivery.roles.qa.enabled |
bool | true |
factory | Delivery |
delivery.roles.qa.mult |
num 0.5 to 10 | 2.2 |
factory | Delivery |
delivery.roles.qa.rate |
num 0 to 10000 | 70 |
factory | Delivery |
delivery.roles.reviewer.enabled |
bool | true |
factory | Delivery |
delivery.roles.reviewer.mult |
num 0.5 to 10 | 1.5 |
factory | Delivery |
delivery.roles.reviewer.rate |
num 0 to 10000 | 95 |
factory | Delivery |
delivery.roles.security.enabled |
bool | true |
factory | Delivery |
delivery.roles.security.mult |
num 0.5 to 10 | 2.0 |
factory | Delivery |
delivery.roles.security.rate |
num 0 to 10000 | 110 |
factory | Delivery |
delivery.roles.sse.enabled |
bool | true |
factory | Delivery |
delivery.roles.sse.mult |
num 0.5 to 10 | 2.4 |
factory | Delivery |
delivery.roles.sse.rate |
num 0 to 10000 | 95 |
factory | Delivery |
delivery.roles.writer.enabled |
bool | true |
factory | Delivery |
delivery.roles.writer.mult |
num 0.5 to 10 | 1.8 |
factory | Delivery |
delivery.roles.writer.rate |
num 0 to 10000 | 60 |
factory | Delivery |
delivery.sources.admin |
bool | true |
factory | Delivery |
delivery.sources.chat |
bool | true |
factory | Delivery |
delivery.sources.checkpoint |
bool | true |
factory | Delivery |
delivery.sources.comment |
bool | true |
factory | Delivery |
delivery.sources.commit |
bool | true |
factory | Delivery |
delivery.sources.notification |
bool | true |
factory | Delivery |
delivery.sources.pixcall |
bool | true |
factory | Delivery |
delivery.sources.review |
bool | true |
factory | Delivery |
delivery.value |
bool. bool: price agent work by role | true |
factory | Delivery |
factory
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
factory.fanoutCap |
int 1 to 50. int 1 to 50: runs one delivery or sighting may start; triggers past it, by priority, are skipped as fanout_cap |
feDefaultFanoutCap |
factory |
other
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
firewall_enabled |
bool | true |
factory, locked | Package and AI firewalls on factory work |
forge
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
forge.branch_prefix |
str. str, 1 to 40 chars, [A-Za-z0-9/_.-] |
belai/K- |
factory | Forge quota and the data plane |
forge.calls_per_hour |
int 100 to 100_000 | 5000 |
factory | Forge quota and the data plane |
forge.check_runs |
bool. bool: publish gate results as check runs (needs checks: write) |
false |
factory | Forge quota and the data plane |
forge.etag |
bool. bool: send If-None-Match on every live read |
true |
factory | Forge quota and the data plane |
forge.poll.fallback |
enum: conditional_poll_10m, none |
conditional_poll_10m |
factory | Forge quota and the data plane |
forge.polling.forbidden |
bool. bool, locked true |
true |
factory, locked | Forge quota and the data plane |
forge.pr_state |
enum: draft, ready |
draft |
factory | Forge quota and the data plane |
forge.protected |
bool. bool: never push to protected branches | true |
factory | Forge quota and the data plane |
forge.quota.factory_share |
pct | 10 |
factory | Forge quota and the data plane |
forge.quota.on_exhausted |
enum: pause_live_reads, defer_to_next_window, escalate |
pause_live_reads |
factory | Forge quota and the data plane |
forge.quota.proactive_writes_per_hour |
int 0 to 5000. int 0 to 5000: most calls an installation makes in a clock hour for default workflows (13.4) | 60 |
factory | Forge quota and the data plane |
forge.quota.reserve |
pct | 20 |
factory | Forge quota and the data plane |
forge.read.default |
enum: posture_mirror, s3_raw, live_api |
posture_mirror |
factory | Forge quota and the data plane |
forge.stale.alerts |
duration. dur | 1h |
factory | Forge quota and the data plane |
forge.stale.checks |
duration. dur | 2m |
factory | Forge quota and the data plane |
forge.stale.pulls |
duration. dur | 5m |
factory | Forge quota and the data plane |
forge.stale.repo |
duration. dur | 6h |
factory | Forge quota and the data plane |
hosts
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
hosts.runOn |
str. string auto, pix_sandbox, self_hosted, host:<uuid> or label:<name>, the crew node’s runOn grammar (factoryRunOnValid): where a crew node, a default or a scan that names no runOn runs, and the preference that orders the hosts a node’s own runOn admits (12.5) |
auto |
factory | Hosts and placement |
hosts.runOnFallback |
enum: none, auto |
auto |
factory | Hosts and placement |
jail
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
jail.enforcementMode |
enum: enforce, warn |
enforce |
jail | Trust and SLSA |
kanban
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
kanban.conflict_comment |
bool | true |
factory | |
kanban.mode |
enum: all, skip_review, off |
all |
factory | |
kanban.opt_out_label |
str | no-github |
factory |
notify
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
notify.connector |
enum: slack, teams, discord, google_chat, webhook, jira |
slack |
factory | The messaging centre: connections, routes and templates |
notify.events |
enum: escalations_holds_budget, everything, escalations_only |
escalations_holds_budget |
factory | The messaging centre: connections, routes and templates |
persistence
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
persistence.export |
enum: daily_jsonl_s3, manual |
manual |
factory | |
persistence.postgres |
enum: on, off |
on |
factory | |
persistence.retention |
enum: 400d, 90d, 30d, forever |
400d |
factory |
pix
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
pix.classifier |
enum: clef, jev, tev1 |
clef |
sandbox | Pix Sandboxes |
pix.egressMode |
enum. enum deny_except_allow, allow_all_logged |
deny_except_allow |
sandbox | Pix Sandboxes |
pix.extensionMode |
enum: packs_only, any_indexed |
packs_only |
sandbox | Pix Sandboxes |
pix.jevDailyCap |
int 0 to 100_000_000. int, calls per day, shared with the sandbox | 2000 |
sandbox | Pix Sandboxes |
pix.maintenance |
list. list of {days:["sun"],start:"02:00",end:"04:00",tz:"Australia/Melbourne"}, same value as PUT /v1/belai/sandboxes/{id}/maintenance-window |
[] |
sandbox | Holds, maintenance windows and blackouts |
pix.reservePercent |
pct. pct (same value as budgets reserveInteractivePct) |
20 |
sandbox | Pix Sandboxes |
pix.size |
enum. enum small, medium, large |
medium |
sandbox | Pix Sandboxes |
pix.versionPolicy |
enum. enum safest, stable, latest, rolling, pinned (the first four are the Safe Harbour picks, see pix-sandbox-safe-harbour.md) |
safest |
sandbox | Pix Sandboxes |
providers
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
providers.code |
str. pix-smart, pix-fast or vault:<entryId> |
pix-smart |
factory | Model routing and the Pix allowance |
schedules
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
schedules.blackout |
list. list of {from:{day,time},to:{day,time},label}; day is mon to sun, time HH:MM |
[] |
factory | Holds, maintenance windows and blackouts |
schedules.missed |
enum: run_once, skip, run_all |
run_once |
factory | Holds, maintenance windows and blackouts |
schedules.tz |
tz. IANA zone | UTC |
factory | Holds, maintenance windows and blackouts |
scope
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
scope.archived |
bool | false |
factory | Managed orgs and repositories |
scope.dependencies |
bool | false |
factory | Managed orgs and repositories |
scope.interest |
enum: any_signal, scanned_or_pix, watched_only |
any_signal |
factory | Managed orgs and repositories |
scope.orgs |
list. "all_active" or list of installation logins; same write as PUT /orgs/{id} |
[] |
factory | Managed orgs and repositories |
scope.sync |
enum: 6h, 1h, webhook_only |
6h |
factory | Managed orgs and repositories |
security
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
security.evidence |
enum: cdx_slsa, sbom_only |
cdx_slsa |
factory | Trust and SLSA |
security.scanners |
enum: minimum, all, custom |
minimum |
factory | Trust and SLSA |
security.scanners.custom |
list | [] |
factory | Trust and SLSA |
security.slsa_min |
enum: L1, L2, L3 |
L3 |
factory | Trust and SLSA |
signing
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
signing.auto_add |
bool. bool: add a new key’s public key to the person’s GitHub account | true |
factory | Commit signing |
signing.email |
enum: primary, noreply, ask |
primary |
factory | Commit signing |
signing.mode |
enum: required, preferred, off |
preferred |
factory | Commit signing |
signing.on_missing |
enum: readd, ask |
readd |
factory | Commit signing |
signing.retire_days |
enum: 30, 7, 0, -1 |
30 |
factory | Commit signing |
signing.rotate_days |
enum: 365, 180, 90, 0 |
365 |
factory | Commit signing |
systemone
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
systemone.below_threshold |
enum: escalate_human, route_to_fallback_model, take_safest_outcome, end_run |
escalate_human |
factory | System One decisions |
systemone.fallback |
enum: jev, pix-fast, none |
jev |
factory | System One decisions |
systemone.min_confidence |
num 0 to 1 | 0.8 |
factory | System One decisions |
systemone.min_confidence.adapter |
str. str, read-only, identity the threshold was set for | clef-flash |
factory | System One decisions |
systemone.model |
enum adapter name: clef-flash, clef, jev, tev1 |
clef-flash |
factory | System One decisions |
systemone.on_abstain |
enum: escalate_human, retry_once_then_escalate, end_run |
escalate_human |
factory | System One decisions |
systemone.override |
bool. bool: a person may override any decision | true |
factory | System One decisions |
systemone.retention |
enum: full_400d, hash_only, days_30 |
full_400d |
factory | System One decisions |
tea
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
tea.publish |
enum: on_release_tag, on_merge_main, never |
on_release_tag |
factory | Trust and SLSA |
vault
| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
vault.grant |
object. {"mode":"specific","entries":["ve_1"]} for the pix_sandbox surface; mode is specific, all or all_except |
{"mode": "all"} |
vault | |
vault.on_error |
enum: pause_affected_workflows, fall_back_to_pix |
pause_affected_workflows |
factory |