Previous value: -"Set true for a measurement/benchmark workload whose numbers are only comparable on one machine. The job then FAILS if its box is lost mid-run instead of being rerouted to a different one — a silent host swap would make the results meaningless. Default false: a lost box may be replaced by another machine."New value: +"Accepted for compatibility and ignored. A machine that is lost or never starts may be replaced by another one, inside budgetUsd. To keep a benchmark on one GPU model, set gpu.gpuName with gpu.gpuNameExact."

Previous value: -"What this spec is expected to bill you, in dollars — present only when price.evidence is customer (priced at your own maxRuntimeSeconds); absent when nothing about this job predicts its runtime"New value: +"What this spec is expected to bill you, in dollars — present only when price.evidence is customer (the estimate priced at your own maxRuntimeSeconds), and then equal to estimate.likelyUsd; otherwise absent and the total is estimate.likelyUsd"

Previous value: -"basis, referenceSeconds, boundSeconds, boundBy, note: the runtime the estimate assumes and where the run would be stopped"New value: +"boundSeconds, boundBy (budget | customer | platform), note: where the run would be STOPPED on that machine — a limit, never a prediction. The expected runtime is estimate.runtime"

Added value: +{
+  "additionalProperties": {},
+  "description": "The best-effort estimate of the total bill: show likelyUsd with its range, confidence and disclaimer, or perHourUsd when rate_only. budgetUsd stays the hard cap",
+  "properties": {
+    "assumptions": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "confidence": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "low | medium | high — how strong the runtime evidence is; null when rate_only"
+    },
+    "costBreakdown": {
+      "description": "The likely total line by line, in the bill's own categories; the lines sum to likelyUsd",
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "category": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "usd": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "category",
+          "label",
+          "usd"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "disclaimer": {
+      "description": "Show it with the figures: best-effort, may differ, budgetUsd is the hard maximum",
+      "type": "string"
+    },
+    "highUsd": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "The range the charge likely falls in; never above budgetUsd"
+    },
+    "likelyUsd": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "The likely total charge for a run that works, in dollars; a best-effort estimate, never a quote. null when rate_only"
+    },
+    "limitedBySpendingLimit": {
+      "description": "true when the top of the range is budgetUsd itself: the run is stopped there and billed no more",
+      "type": "boolean"
+    },
+    "lowUsd": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "perHourUsd": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "What each hour of running costs on the machine Symbioza would book"
+    },
+    "runtime": {
+      "additionalProperties": {},
+      "description": "likelySeconds, lowSeconds, highSeconds, basis (same-workload | workload-family | command-heuristic | platform-history | customer-cap | none), evidence (one sentence for the user), samples",
+      "properties": {},
+      "type": "object"
+    },
+    "status": {
+      "description": "best_effort: likelyUsd/lowUsd/highUsd are set | rate_only: nothing predicts the runtime, so there is no total — show perHourUsd",
+      "type": "string"
+    }
+  },
+  "required": [
+    "status",
+    "likelyUsd",
+    "lowUsd",
+    "highUsd",
+    "confidence",
+    "perHourUsd",
+    "runtime",
+    "costBreakdown",
+    "limitedBySpendingLimit",
+    "assumptions",
+    "disclaimer"
+  ],
+  "type": "object"
+}

Previous value: -"customer: priced at your own maxRuntimeSeconds | insufficient: nothing about this job predicts its runtime, so this is not a quote"New value: +"customer: priced at your own maxRuntimeSeconds | best-effort: a likely total and range in estimate, not a quote | insufficient: nothing about this job predicts its runtime, so only the hourly price"

Previous value: -"GPUs on ONE machine. Must be 1 — a higher count is REFUSED, never silently reduced to one card. Omit it."New value: +"Exact number of GPUs on ONE machine (never N separate machines). Omit it for one GPU, or declare 2; any other count is REFUSED, never silently changed. Declare it only when the workload runs that many processes on a single host (for example torchrun --nproc_per_node=N); minVramGb then applies to each GPU."

Previous value: -"GPUs on ONE machine. Must be 1 — a higher count is REFUSED, never silently reduced to one card. Omit it unless you mean several cards on a single host (that is not N separate machines)."New value: +"GPUs on ONE machine. Must be 1 — a higher count is REFUSED, never silently reduced to one card. Omit it."

Previous value: -9007199254740991New value: +16

Previous value: -"Optional. A VRAM floor the box must meet, only when the workload has an evidenced one (a measured peak, a known model footprint). Omit it when unknown: Symbioza then sizes the GPU itself. Never ask the user to choose a tier, and never derive a number from an unrelated run."New value: +"Optional. A VRAM floor the box must meet, PER GPU, only when the workload has an evidenced one (a measured peak, a known model footprint). Omit it when unknown: Symbioza then sizes the GPU itself. Never ask the user to choose a tier, and never derive a number from an unrelated run."

Previous value: -"The job spec: image + command run on a rented box sized by minDiskGb (and gpu, when declared), under budgetUsd. Supply the workload: the image, the command, its inputs, the expected outputs and budgetUsd. Symbioza sizes the machine — do not ask the user to choose CPU cores, RAM, VRAM, a GPU model, a provider or a region, and do not derive a resource minimum from a thread count, a worker count or a measurement taken somewhere else. gpu.minVramGb, minRamGb and minCpuCores are optional expert floors: declare one only when the workload has evidence for it, and omit it otherwise — an omitted floor is sized by Symbioza, never treated as zero. The gpu block is optional: leave it out and the job is still GPU work with Symbioza sizing the card; declare it to carry minCudaVersion or an evidenced floor."New value: +"The job spec to estimate: image + command run on a rented box sized by minDiskGb (and gpu, when declared). budgetUsd is optional here — leave it out to see the likely cost before the user chooses one; submitJob requires it. Supply the workload: the image, the command, its inputs, the expected outputs and budgetUsd. Symbioza sizes the machine — do not ask the user to choose CPU cores, RAM, VRAM, a GPU model, a provider or a region, and do not derive a resource minimum from a thread count, a worker count or a measurement taken somewhere else. gpu.minVramGb, minRamGb and minCpuCores are optional expert floors: declare one only when the workload has evidence for it, and omit it otherwise — an omitted floor is sized by Symbioza, never treated as zero. The gpu block is optional: leave it out and the job is still GPU work with Symbioza sizing the card; declare it to carry minCudaVersion or an evidenced floor."

Previous value: -"Hard spend ceiling for the whole job, USD. The job is refused or stopped rather than exceeding it."New value: +"Optional here: the job's hard spend ceiling, USD. Leave it out to see the estimate before the user chooses one; submitJob requires it, so estimate again with the user's budget before submitting."

Previous value: -[
-  "image",
-  "command",
-  "budgetUsd"
-]New value: +[
+  "image",
+  "command"
+]

Added value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +"Would submitJob accept this spec's budget today; null when the spec has no budgetUsd"

Removed value: -"boolean"

Added value: +"With a budget: the link for the credit this job needs"

Previous value: -[
-  "availableUsd",
-  "promoUsd",
-  "promoExpiresAtMs",
-  "coversThisJob",
-  "promoJobCapUsd",
-  "claimableUsd",
-  "nextAction",
-  "claimUrl",
-  "topupUrl"
-]New value: +[
+  "availableUsd",
+  "promoUsd",
+  "promoExpiresAtMs",
+  "coversThisJob",
+  "promoJobCapUsd",
+  "claimableUsd",
+  "nextAction",
+  "claimUrl"
+]

Previous value: -"Your own cap, read back; nothing bills past it"New value: +"Your own cap, read back; nothing bills past it. Absent when the spec has none"

Previous value: -"What this spec is expected to bill you, in dollars"New value: +"What this spec is expected to bill you, in dollars — present only when price.evidence is customer (priced at your own maxRuntimeSeconds); absent when nothing about this job predicts its runtime"

Added value: +{
+  "additionalProperties": {},
+  "description": "What the price rests on, what it includes and what is still unknown",
+  "properties": {
+    "evidence": {
+      "description": "customer: priced at your own maxRuntimeSeconds | insufficient: nothing about this job predicts its runtime, so this is not a quote",
+      "type": "string"
+    },
+    "includes": {
+      "description": "What the estimate counts",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "nextStep": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "perHourUsd": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "What each hour of running costs on the machine Symbioza would book"
+    },
+    "summary": {
+      "description": "One sentence for the user",
+      "type": "string"
+    },
+    "unknown": {
+      "description": "What it cannot count yet",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "evidence",
+    "summary",
+    "perHourUsd",
+    "includes",
+    "unknown",
+    "nextStep"
+  ],
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "What stands between this estimate and a submittable one, plus advice about its inputs",
+  "properties": {
+    "missing": {
+      "description": "budget_required | inputs_unverified | inputs_not_declared | access_required, each with a detail; the input notes are advice and never block a submit",
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "detail": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "detail"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "status": {
+      "description": "preliminary while budget_required or access_required is listed; otherwise ready",
+      "type": "string"
+    }
+  },
+  "required": [
+    "status",
+    "missing"
+  ],
+  "type": "object"
+}

Previous value: -"basis, referenceSeconds, boundSeconds, boundBy, note: the runtime the price assumes and where the run would be stopped"New value: +"basis, referenceSeconds, boundSeconds, boundBy, note: the runtime the estimate assumes and where the run would be stopped"

Previous value: -"Fingerprint of the exact spec and budget priced here; pass it to submitJob"New value: +"Fingerprint of the exact spec and budget priced here; pass it to submitJob. Absent when the spec has no budgetUsd: submitJob requires one"

Previous value: -"Environment variables for the container. They are stored with the job spec in clear on our control plane and are included in our routine backups, so do not put credentials or other secrets here — pass them in at run time or fetch them from your own store inside the command."New value: +"Non-sensitive configuration for the container (e.g. MODEL_NAME, EPOCHS). They are stored with the job spec in clear on our control plane and are included in our routine backups, so NEVER put credentials here: API keys, tokens, passwords and cloud keys belong in saved Secrets, attached with `secrets`."

Added value: +{
+  "description": "Saved secret sets this job needs, by name (e.g. [{\"name\":\"hf-training\"}]) or by the access it needs ([{\"type\":\"huggingface\",\"purpose\":\"Access a gated model\"}]). Every variable in each set is injected into the container at run time; values are never in the spec, the response or the chat. A missing set comes back with a Symbioza setup link for the user.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "fields": {
+        "description": "For a custom requirement only: the environment variable NAMES the workload expects (e.g. [\"MODEL_API_TOKEN\"]). Names only, never values.",
+        "items": {
+          "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,127}$",
+          "type": "string"
+        },
+        "maxItems": 32,
+        "type": "array"
+      },
+      "id": {
+        "description": "The saved set's id (sec_…). Symbioza pins it at submit; you normally give the name.",
+        "pattern": "^sec_[A-Za-z0-9_-]{22}$",
+        "type": "string"
+      },
+      "name": {
+        "description": "The saved secret set's name, e.g. \"hf-training\". Read the names with listSecrets.",
+        "pattern": "^[a-z0-9][a-z0-9_-]{0,62}$",
+        "type": "string"
+      },
+      "purpose": {
+        "description": "A short reason shown to the user on the setup page, e.g. \"Access a gated model\". Never a credential.",
+        "maxLength": 160,
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": {
+        "description": "What access the workload needs: huggingface, object-storage, wandb or custom. With no name, Symbioza uses your one saved set of this type, or returns a setup link when there is none.",
+        "enum": [
+          "huggingface",
+          "object-storage",
+          "wandb",
+          "custom"
+        ],
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "maxItems": 16,
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": {},
+  "description": "The saved secrets this spec attaches, by name and type only",
+  "properties": {
+    "complete": {
+      "description": "true when every set the spec names is saved and nothing collides; submitJob refuses otherwise",
+      "type": "boolean"
+    },
+    "conflicts": {
+      "description": "A variable two attached sets (or a set and env) both define",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "nextAction": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "add_access | fix_spec | null"
+    },
+    "ready": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "fields": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "type",
+          "fields"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "required": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "candidates": {
+            "description": "ambiguous: the saved set names that could serve; ask the user which",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "message": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "purpose": {
+            "type": "string"
+          },
+          "setupUrl": {
+            "description": "missing: the Symbioza link where the user saves it; give it as returned",
+            "type": "string"
+          },
+          "status": {
+            "description": "missing | ambiguous | type_mismatch",
+            "type": "string"
+          },
+          "type": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "status",
+          "type",
+          "message"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "complete",
+    "ready",
+    "required",
+    "conflicts",
+    "nextAction"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Whole dollars of credit this job still needs; 0 when it is covered",
+  "type": "number"
+}

Previous value: -"The one next step: authenticate, fix_spec, raise_budget, add_funds, claim_credit, relax_spec_or_retry, retry_later, contact_support"New value: +"The one next step: authenticate, fix_spec, raise_budget, add_funds, claim_credit, add_access, relax_spec_or_retry, retry_later, contact_support"

Previous value: -"Machine-readable refusal code: unauthorized, invalid_spec, budget_too_low, insufficient_balance, no_compute, unavailable, refused"New value: +"Machine-readable refusal code: unauthorized, invalid_spec, budget_too_low, insufficient_balance, access_required, secret_conflict, no_compute, unavailable, refused"