PaginatedResponse[TrainingSessionReadSchema]

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/getoneprofile-ai/json-schema/getoneprofile-ai-paginated-response-training-session-read-schema-schema.json",
  "title": "PaginatedResponse[TrainingSessionReadSchema]",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/getoneprofile-ai-agent-training-api-openapi.yml#/components/schemas/PaginatedResponse_TrainingSessionReadSchema_",
  "properties": {
    "data": {
      "description": "The list of ResponseItems.",
      "items": {
        "$ref": "#/$defs/TrainingSessionReadSchema"
      },
      "title": "Data",
      "type": "array"
    },
    "next_page_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The cursor to the next page. If there are no more pages, this is None."
    },
    "previous_page_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The cursor to the previous page. If there are no previous pages, this is None."
    }
  },
  "type": "object",
  "$defs": {
    "AgentConfidence": {
      "description": "The agent's own read on how solid its final answer is.",
      "enum": [
        "high",
        "medium",
        "low"
      ],
      "title": "AgentConfidence",
      "type": "string"
    },
    "AgentStepAction": {
      "description": "What one agent step did.\n\n``FETCH_PAGE`` is historical: the loop emits ``SCRAPE`` for the same act\ntoday, but stored step traces still carry the old value and must keep\ndeserializing, so the member stays.",
      "enum": [
        "search",
        "fetch_page",
        "map",
        "scrape",
        "crawl",
        "mcp_tool",
        "workspace_action",
        "find_work_email",
        "read_linkedin_profile",
        "find_people_at_company",
        "finish",
        "browser_open",
        "browser_click",
        "browser_type",
        "browser_select",
        "browser_press",
        "browser_wait",
        "browser_back",
        "inbox_find"
      ],
      "title": "AgentStepAction",
      "type": "string"
    },
    "AgentStepOutcome": {
      "description": "How one agent step ended: the structured half of its observation.",
      "enum": [
        "completed",
        "failed",
        "refused"
      ],
      "title": "AgentStepOutcome",
      "type": "string"
    },
    "EnrichmentCellOutcome": {
      "description": "How one cell's enrichment execution ended.\n\n``SKIPPED`` is a first-class third outcome: the action was deliberately\nnot run (a required input was empty), no work was done, and nothing is\ncharged.\n\n``WAITING`` hands the cell to work that runs outside the table run (a\nsender's LinkedIn browser, minutes to days away): the cell stays owed with\nno value, says what it waits for, and is filled by whoever hands the\nanswer back. Nothing is charged here; the outside work charges for itself.",
      "enum": [
        "succeeded",
        "failed",
        "skipped",
        "waiting"
      ],
      "title": "EnrichmentCellOutcome",
      "type": "string"
    },
    "EnrichmentErrorClass": {
      "description": "Machine-readable classification of a failed enrichment cell.\n\nThe class decides everything downstream: whether the executor retries\n(transient classes) or gives up (terminal ones), what the cell tooltip\nnames, and whether the failure is free. Errors never charge, but only a\nclassified error can prove which kind it was. A clean no-answer (no_data)\nis free for a lookup; an AI column's is charged what it used.",
      "enum": [
        "timeout",
        "rate_limited",
        "quota_exhausted",
        "provider_error",
        "network",
        "schema_violation",
        "refused",
        "invalid_input",
        "no_data",
        "enrichment_failed",
        "sources_unavailable",
        "unexpected"
      ],
      "title": "EnrichmentErrorClass",
      "type": "string"
    },
    "TrainingProgressSchema": {
      "description": "How far the examples' run has got.",
      "properties": {
        "done": {
          "title": "Done",
          "type": "integer"
        },
        "failed": {
          "title": "Failed",
          "type": "integer"
        },
        "total": {
          "title": "Total",
          "type": "integer"
        }
      },
      "required": [
        "total",
        "done",
        "failed"
      ],
      "title": "TrainingProgressSchema",
      "type": "object"
    },
    "TrainingRowReadSchema": {
      "description": "One example: its fixed inputs and its latest answer.\n\n``verdict`` is the reviewer's Looks good on that answer, null until given, which is\nwhat lets a reloaded page show the examples already judged. A Needs work runs the\nexample again in place: ``status`` goes back to pending, then running, and\n``run_no`` counts up.",
      "properties": {
        "confidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/AgentConfidence"
            },
            {
              "type": "null"
            }
          ]
        },
        "credits_charged": {
          "title": "Credits Charged",
          "type": "number"
        },
        "cycle": {
          "title": "Cycle",
          "type": "integer"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Error"
        },
        "error_class": {
          "anyOf": [
            {
              "$ref": "#/$defs/EnrichmentErrorClass"
            },
            {
              "type": "null"
            }
          ]
        },
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "inputs": {
          "additionalProperties": {
            "type": "string"
          },
          "title": "Inputs",
          "type": "object"
        },
        "needs_work": {
          "default": false,
          "description": "Whether the example is marked Needs work: its latest thumbs down stands. An Undo clears it, so an example put back as it was is not counted.",
          "title": "Needs Work",
          "type": "boolean"
        },
        "outcome": {
          "anyOf": [
            {
              "$ref": "#/$defs/EnrichmentCellOutcome"
            },
            {
              "type": "null"
            }
          ]
        },
        "position": {
          "title": "Position",
          "type": "integer"
        },
        "reasoning": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reasoning"
        },
        "run_no": {
          "description": "How many times Needs work has run this example again; 0 for its first run.",
          "title": "Run No",
          "type": "integer"
        },
        "skipped_reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Skipped Reason"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "title": "Sources",
          "type": "array"
        },
        "status": {
          "$ref": "#/$defs/TrainingRowStatus"
        },
        "steps": {
          "items": {
            "$ref": "#/$defs/TrainingStepSchema"
          },
          "title": "Steps",
          "type": "array"
        },
        "value": {
          "description": "The produced value, on success.",
          "title": "Value"
        },
        "verdict": {
          "anyOf": [
            {
              "$ref": "#/$defs/TrainingVerdict"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "position",
        "inputs",
        "cycle",
        "run_no",
        "status",
        "outcome",
        "error",
        "error_class",
        "skipped_reason",
        "confidence",
        "reasoning",
        "steps",
        "sources",
        "credits_charged",
        "verdict"
      ],
      "title": "TrainingRowReadSchema",
      "type": "object"
    },
    "TrainingRowStatus": {
      "description": "How far one training row has got in the CURRENT cycle's run.\n\n``DONE`` means the run settled, not that it succeeded. A row whose agent\ncall failed is still done, and its ``outcome`` says what happened. The\nreviewer critiques failures too.",
      "enum": [
        "pending",
        "running",
        "done"
      ],
      "title": "TrainingRowStatus",
      "type": "string"
    },
    "TrainingSessionReadSchema": {
      "description": "A whole Preview, as the reviewer's page polls it.\n\nEverything the page needs in one payload: the phase (``status``), and the examples\nwith their answers and verdicts. The page keeps polling while any example runs,\na Needs work redo included.",
      "properties": {
        "created_at": {
          "format": "date-time",
          "title": "Created At",
          "type": "string"
        },
        "cycle": {
          "title": "Cycle",
          "type": "integer"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Error"
        },
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "progress": {
          "$ref": "#/$defs/TrainingProgressSchema"
        },
        "rows": {
          "items": {
            "$ref": "#/$defs/TrainingRowReadSchema"
          },
          "title": "Rows",
          "type": "array"
        },
        "saved_agent_id": {
          "format": "uuid",
          "title": "Saved Agent Id",
          "type": "string"
        },
        "source_input_mappings": {
          "additionalProperties": {
            "type": "string"
          },
          "title": "Source Input Mappings",
          "type": "object"
        },
        "source_kind": {
          "$ref": "#/$defs/TrainingSourceKind"
        },
        "source_table_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source Table Id"
        },
        "status": {
          "$ref": "#/$defs/TrainingSessionStatus"
        },
        "updated_at": {
          "format": "date-time",
          "title": "Updated At",
          "type": "string"
        }
      },
      "required": [
        "id",
        "saved_agent_id",
        "status",
        "cycle",
        "source_kind",
        "source_table_id",
        "source_input_mappings",
        "error",
        "created_at",
        "updated_at",
        "progress",
        "rows"
      ],
      "title": "TrainingSessionReadSchema",
      "type": "object"
    },
    "TrainingSessionStatus": {
      "description": "Where an agent Preview stands: the state the reviewer's screen shows.\n\nOne enum rather than a separate lifecycle flag and phase, because the\nphase IS the state: a session is either waiting on the machine\n(``RUNNING``), waiting on the reviewer (``REVIEWING``), or finished.\nCallers never derive the screen from row counts. A Needs work on one\nexample runs that example again without leaving ``REVIEWING``: the row's\nown status says it is running.",
      "enum": [
        "running",
        "reviewing",
        "proposed",
        "completed",
        "abandoned"
      ],
      "title": "TrainingSessionStatus",
      "type": "string"
    },
    "TrainingSourceKind": {
      "description": "Where a session's training inputs came from.",
      "enum": [
        "table",
        "manual"
      ],
      "title": "TrainingSourceKind",
      "type": "string"
    },
    "TrainingStepSchema": {
      "description": "One research step the agent took on an example.",
      "properties": {
        "action": {
          "$ref": "#/$defs/AgentStepAction"
        },
        "detail": {
          "title": "Detail",
          "type": "string"
        },
        "duration_ms": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "How long the step took; null on records that predate timing.",
          "title": "Duration Ms"
        },
        "observation": {
          "title": "Observation",
          "type": "string"
        },
        "outcome": {
          "$ref": "#/$defs/AgentStepOutcome",
          "default": "completed",
          "description": "How the step ended, so a failed or refused step reads as one."
        },
        "thought": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The model's stated reasoning for this step; null when not recorded.",
          "title": "Thought"
        }
      },
      "required": [
        "action",
        "detail",
        "observation"
      ],
      "title": "TrainingStepSchema",
      "type": "object"
    },
    "TrainingVerdict": {
      "description": "The reviewer's call on one row's output.\n\nKept as its own enum rather than reusing the cells' ``up``/``down`` thumbs:\na training verdict is a judgement on a worked example, and the two domains\nare deliberately independent of each other.\n\nOnly ``GOOD`` (Looks good) is given now. Needs work is a thumbs down\n(``agent_feedback``): it saves a learning and runs the example again, and\nthe learning event is its record. ``BAD`` stays for the verdicts given\nbefore, each with the note that explained it.",
      "enum": [
        "good",
        "bad"
      ],
      "title": "TrainingVerdict",
      "type": "string"
    }
  }
}