Previous value: -"Every artifact the scan produces, each with artifact_id, status, is_available, version, owner_phase, read_path, and dashboard ui_url. Fetch an available artifact with get_artifact(artifact_id=...). 'available' means readable now. reason and awaiting_approval describe an approval pause."New value: +"Every artifact the scan produces, each with artifact_id, kind (document, graph or structured), status, is_available, version, owner_phase, read_path, and dashboard ui_url. Fetch an available artifact with get_artifact(artifact_id=...). 'available' means readable now. reason and awaiting_approval describe an approval pause."

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "With reason rate_limited, how many seconds Trent asks the caller to wait.",
+  "title": "Retry After Seconds"
+}

Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "commit_sha": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "The commit the scan read there.",
+      "title": "Commit Sha"
+    },
+    "repo_slug": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "The repository, as owner/name.",
+      "title": "Repo Slug"
+    }
+  },
+  "title": "ScanRepositoryCommit",
+  "type": "object"
+}

Previous value: -"Sub-step within the current stage as an ordinal, such as '3/6'. Each stage restarts its count. Absent until a stage reports a sub-step and during an approval pause."New value: +"Sub-step within the current stage as an ordinal, such as '3/6'. Each stage restarts its count, and an incremental scan's stages have fewer sub-steps than a full scan's. Absent until a stage reports a sub-step, during an approval pause, and when the stage is not running."

Previous value: -"Commit SHA of the latest analysis. Trent's findings describe this commit."New value: +"Commit of the last completed scan, which Trent's current findings describe; never a running scan's. On a pinned scan_id, the commit that scan read, when it read one repository."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "While a scan runs, the commit it reads, when it reads one repository. Absent until the running scan has recorded the commit it cloned.",
+  "title": "Running Commit Sha"
+}

Previous value: -"Running stage as an ordinal, such as '1/3'. The denominator is the scan's fixed stage count. Use it to describe progress and reason for workflow decisions. Do not convert it to a percentage: secure declares seven sub-steps to plan's two, so '2/3' does not mean two thirds done. Absent during an approval pause, on older single-stage projects, or for a pinned scan_id earlier than the project's latest scan."New value: +"Running stage as an ordinal, such as '1/3'. The denominator is the scan's fixed stage count. Use it to describe progress and reason for workflow decisions. Do not convert it to a percentage: stages have different lengths, so '2/3' does not mean two thirds done. Absent during an approval pause, on older single-stage projects, or for a pinned scan_id earlier than the project's latest scan."

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "$ref": "#/$defs/ScanRepositoryCommit"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Each repository the described scan read, with repo_slug and commit_sha: the pinned scan on a scan_id read, otherwise the running scan. Absent until that scan has recorded its cloned commits.",
+  "title": "Scan Repositories"
+}