docs: sync API specs from openprotein-api

Author: markgeejw

source/_static/js/foldSpec.js

@@ -240,7 +240,7 @@ const foldSpec = {
         tags: ["fold requests", "esmfold2"],
         summary: "ESMFold2",
         description:
-          "Create structure prediction using ESMFold2, an all-atom structure prediction\nmodel. Folds protein/DNA/RNA/ligand complexes, optionally conditioned on an MSA.\n\nArgs:\n  - `sequences`: List of chain/molecule entities in the input. Each entry describes a protein, nucleic acid, or ligand, including its sequence, identifier(s), and optional attributes such as msa_id, SMILES string, CCD code.\n    - `msa_id` should refer to the id of an msa job which included this protein as a query, or `null` for single sequence mode.\n    - `smiles` and `ccd` are mutually exclusive for ligands.\n  - `diffusion_samples`: Number of diffusion samples to use. Controls how many independent structure samples are generated per input. Default is 1.\n  - `num_steps`: Number of sampling steps to use. Sets the number of steps in the diffusion process for each sample. Default is 200.\n  - `num_recycles`: Number of recycling steps to use. Determines how many times the model refines its prediction iteratively. Default is 3.\n  - `seed`: Random seed for reproducible sampling. `null` lets the system decide.",
+          "Create structure prediction using ESMFold2, an all-atom structure prediction\nmodel. Folds protein/DNA/RNA/ligand complexes, optionally conditioned on an MSA.\n\nArgs:\n  - `sequences`: List of chain/molecule entities in the input. Each entry describes a protein, nucleic acid, or ligand, including its sequence, identifier(s), and optional attributes such as msa_id, SMILES string, CCD code.\n    - `msa_id` should refer to the id of an msa job which included this protein as a query, or `null` for single sequence mode.\n    - `smiles` and `ccd` are mutually exclusive for ligands.\n  - `diffusion_samples`: Number of diffusion samples to use. Controls how many independent structure samples are generated per input. Default is 1.\n  - `num_steps`: Number of sampling steps to use. Sets the number of steps in the diffusion process for each sample. Default is 100.\n  - `num_recycles`: Number of recycling steps to use. Determines how many times the model refines its prediction iteratively. Default is 3.\n  - `seed`: Random seed for reproducible sampling. `null` lets the system decide.",
         requestBody: {
           description: "Request for structure prediction.",
           content: {
@@ -328,7 +328,7 @@ const foldSpec = {
         tags: ["fold requests", "esmfold2"],
         summary: "ESMFold2-Fast",
         description:
-          "Create structure prediction using ESMFold2-Fast, an inference-optimized\nsingle-sequence variant of ESMFold2 whose folding trunk has half the depth\n(24 vs 48 layers). Folds protein/DNA/RNA/ligand complexes.\n\nUnlike ESMFold2, ESMFold2-Fast is single-sequence only and does not accept\nan MSA (`msa_id`).\n\nArgs:\n  - `sequences`: List of chain/molecule entities in the input. Each entry describes a protein, nucleic acid, or ligand, including its sequence, identifier(s), and optional attributes such as SMILES string, CCD code.\n    - `smiles` and `ccd` are mutually exclusive for ligands.\n  - `diffusion_samples`: Number of diffusion samples to use. Controls how many independent structure samples are generated per input. Default is 1.\n  - `num_steps`: Number of sampling steps to use. Sets the number of steps in the diffusion process for each sample. Default is 200.\n  - `num_recycles`: Number of recycling steps to use. Determines how many times the model refines its prediction iteratively. Default is 3.\n  - `seed`: Random seed for reproducible sampling. `null` lets the system decide.",
+          "Create structure prediction using ESMFold2-Fast, an inference-optimized\nsingle-sequence variant of ESMFold2 whose folding trunk has half the depth\n(24 vs 48 layers). Folds protein/DNA/RNA/ligand complexes.\n\nUnlike ESMFold2, ESMFold2-Fast is single-sequence only and does not accept\nan MSA (`msa_id`).\n\nArgs:\n  - `sequences`: List of chain/molecule entities in the input. Each entry describes a protein, nucleic acid, or ligand, including its sequence, identifier(s), and optional attributes such as SMILES string, CCD code.\n    - `smiles` and `ccd` are mutually exclusive for ligands.\n  - `diffusion_samples`: Number of diffusion samples to use. Controls how many independent structure samples are generated per input. Default is 1.\n  - `num_steps`: Number of sampling steps to use. Sets the number of steps in the diffusion process for each sample. Default is 100.\n  - `num_recycles`: Number of recycling steps to use. Determines how many times the model refines its prediction iteratively. Default is 3.\n  - `seed`: Random seed for reproducible sampling. `null` lets the system decide.",
         requestBody: {
           description: "Request for structure prediction.",
           content: {
@@ -2006,7 +2006,7 @@ const foldSpec = {
             type: "integer",
             description: "Number of sampling steps to use.",
             minimum: 1,
-            default: 200,
+            default: 100,
           },
           num_recycles: {
             type: "integer",
@@ -2047,7 +2047,7 @@ const foldSpec = {
             ],
           ],
           diffusion_samples: 1,
-          num_steps: 200,
+          num_steps: 100,
           num_recycles: 3,
         },
       },
@@ -2091,7 +2091,7 @@ const foldSpec = {
             type: "integer",
             description: "Number of sampling steps to use.",
             minimum: 1,
-            default: 200,
+            default: 100,
           },
           num_recycles: {
             type: "integer",
@@ -2131,7 +2131,7 @@ const foldSpec = {
             ],
           ],
           diffusion_samples: 1,
-          num_steps: 200,
+          num_steps: 100,
           num_recycles: 3,
         },
       },

source/_static/js/promptSpec.js

@@ -107,6 +107,48 @@ const promptSpec = {
               format: "uuid",
             },
           },
+          {
+            name: "scope",
+            in: "query",
+            description:
+              "Restrict the listing to the caller's own prompts (`mine`, the\ndefault), platform system prompts (`system`), or both (`all`).",
+            required: false,
+            schema: {
+              type: "string",
+              enum: ["mine", "system", "all"],
+              default: "mine",
+            },
+          },
+          {
+            name: "search",
+            in: "query",
+            description:
+              "Case-insensitive substring matched against prompt name and description.",
+            required: false,
+            schema: {
+              type: "string",
+            },
+          },
+          {
+            name: "page_size",
+            in: "query",
+            description: "Maximum number of prompts to return.",
+            required: false,
+            schema: {
+              type: "integer",
+              default: 1024,
+            },
+          },
+          {
+            name: "page_offset",
+            in: "query",
+            description: "Number of prompts to skip before returning results.",
+            required: false,
+            schema: {
+              type: "integer",
+              default: 0,
+            },
+          },
         ],
         responses: {
           200: {
@@ -587,6 +629,17 @@ const promptSpec = {
               },
             },
           },
+          403: {
+            description:
+              "The target prompt is a platform system prompt and cannot be modified.",
+            content: {
+              "application/json": {
+                schema: {
+                  $ref: "#/components/schemas/Error",
+                },
+              },
+            },
+          },
           404: {
             description: "Prompt not found.",
             content: {
@@ -1365,6 +1418,12 @@ const promptSpec = {
             type: "integer",
             nullable: true,
           },
+          is_system: {
+            type: "boolean",
+            default: false,
+            description:
+              "True for platform-curated system prompts available to every user.\nSystem prompts are read-only over the HTTP API; users cannot create,\nmodify, or delete them. False or absent for user-uploaded prompts.",
+          },
         },
       },
       Error: {