Skip to main content

StorefrontSectionJob

A storefront section generation.

type StorefrontSectionJob {
  costDisplay: String
  creditsUsedCents: Int
  error: String
  jobId: ID!
  partial: String
  section: JSON
  stage: String!
  status: StorefrontSectionJobStatus!
  unmet: [String!]
  writing: StorefrontSectionWriting
}

Fields​

StorefrontSectionJob.costDisplay ● String scalar​

Platform billing figure in USD — Growmax billing the tenant, not tenant money.

StorefrontSectionJob.creditsUsedCents ● Int scalar​

The credits used so far, in cents.

StorefrontSectionJob.error ● String scalar​

The upstream failure, verbatim. Never a generic fallback. A job whose server stopped before it finished (a deploy, a crash) reads FAILED with a message that says so.

StorefrontSectionJob.jobId ● ID! non-null scalar​

The ID of the job.

StorefrontSectionJob.partial ● String scalar​

While the job runs: the last ~3000 characters of PROSE the model has written outside the section, refreshed at most every ~700 ms. The section itself is in writing as it is written, and the model is told to answer only with the section, so this is usually empty or one short sentence: drive a live placeholder from stage (and writing), and show this only when present. Never validated, never a section. Empty once the job ends.

StorefrontSectionJob.section ● JSON scalar​

On COMPLETED: { handle, name, description, category?, version, source: 'ai', liquid, css, settings, blocks?, maxBlocks?, presetBlocks?, brief, revisedFrom? }. A fresh section has a new handle and version 1. A revision of an AI section keeps its handle with version + 1; a revision of any other section gets a new handle. revisedFrom names the { handle, version } that was revised. A repair (repair) keeps the repaired section's identity: its AI handle and version as they were, and its revisedFrom.

StorefrontSectionJob.stage ● String! non-null scalar​

What the job is doing now: queued, writing, checking, repairing, done, failed or cancelled. A plain string, so treat a value you do not know as 'writing'.

StorefrontSectionJob.status ● StorefrontSectionJobStatus! non-null enum​

Where the job stands.

StorefrontSectionJob.unmet ● [String!] list scalar​

On COMPLETED: the parts of the request the section does NOT build, in the seller's terms, as the model reported them (the other sections a page request names, records of a second source, anything a section cannot do). Empty when it covers the whole request. Show it with the section, so a seller never reads a part as built that was not. Not part of the section definition.

StorefrontSectionJob.writing ● StorefrontSectionWriting object​

While the model writes the section: which part it is on and that part's tail, refreshed at most every ~700 ms. Null before it starts writing the section, while it checks, and once the job ends. Unchecked: show as plain text only.

Returned By​

cancelStorefrontSectionGeneration mutation ● startStorefrontSectionGeneration mutation ● storefrontSectionGenerationJob query