Generation

api.md §3's generation record. Built from the row field by field, never from_attributes: the row also carries the image digest (architecture.md §2.15).

Example Usage

import { Generation } from "@meetkai/mka1/models/components";

let value: Generation = {
  id: "<id>",
  state: "Hawaii",
  reason: {},
  generator: {
    id: "<id>",
    version: "<value>",
  },
  params: {
    "key": "<value>",
    "key1": "<value>",
    "key2": "<value>",
  },
  paramsHash: "<value>",
  output: {
    repo: "<value>",
    revision: "<value>",
  },
  inputs: {
    "key": "<value>",
  },
  counts: {
    "key": 246883,
    "key1": 266259,
  },
  llm: {
    models: [],
  },
  limits: {
    maxRuntimeHours: 9692.81,
    maxCost: 93.78,
    maxLlmCalls: 244736,
  },
  usage: {
    "key": "<value>",
    "key1": "<value>",
    "key2": "<value>",
  },
  job: null,
  name: "<value>",
  derivedFrom: [],
  createdBy: {
    userId: "<id>",
    teamId: "<id>",
    apiKeyId: "<id>",
  },
  createdAt: new Date("2026-11-10T14:39:15.476Z"),
  startedAt: null,
  terminalAt: null,
};

Fields

Field	Type	Required	Description
id	string	✔️	N/A
state	string	✔️	N/A
reason	Record<string, any>	✔️	N/A
generator	components.GeneratorRef	✔️	N/A
params	Record<string, any>	✔️	N/A
paramsHash	string	✔️	N/A
output	components.OutputRef	✔️	N/A
inputs	Record<string, string>	✔️	N/A
counts	Record<string, number>	✔️	N/A
llm	components.LlmRef	✔️	N/A
limits	components.Limits	✔️	A run's budget: the generator's default_limits, or the effective ones as ctx.limits. No defaults. Every number here is a bound the platform enforces and a caller can be billed against, so a generator that forgets to state one should not silently inherit a guess.
usage	Record<string, any>	✔️	N/A
job	components.JobRef	✔️	N/A
name	string	✔️	N/A
derivedFrom	string[]	✔️	N/A
createdBy	components.CreatedBy	✔️	N/A
createdAt	Date	✔️	N/A
startedAt	Date	✔️	N/A
terminalAt	Date	✔️	N/A