@tokenlabai/mcp-server 0.6.8 → 0.6.10

package/contract/openapi.json

@@ -977,6 +977,18 @@
               ]
             },
             "description": "Filter by material library class."
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -1042,6 +1054,18 @@
               "type": "string"
             },
             "example": "asset-20260720123456-qn7wr"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -1193,6 +1217,18 @@
               "type": "string"
             },
             "example": "asset-20260720123456-qn7wr"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -1759,7 +1795,8 @@
             "schema": {
               "type": "integer",
               "minimum": 1,
-              "maximum": 100
+              "maximum": 1000,
+              "default": 20
             },
             "description": "Maximum number of batches to return"
           }
@@ -1870,7 +1907,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AnthropicMessageBatch"
+                  "$ref": "#/components/schemas/AnthropicDeletedMessageBatch"
                 }
               }
             }
@@ -3322,8 +3359,19 @@
           "Files"
         ],
         "summary": "Upload file",
-        "description": "Uploads a JSONL batch input file or an image input file that can be referenced by file_id in supported image edit requests.",
+        "description": "Uploads a TokenLab/OpenAI-compatible batch or image file. With anthropic-beta: files-api-2025-04-14, uploads an Anthropic Files resource without a purpose field and returns Anthropic file metadata.",
         "operationId": "uploadFile",
+        "parameters": [
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
+          }
+        ],
         "requestBody": {
           "required": true,
           "content": {
@@ -3331,8 +3379,7 @@
               "schema": {
                 "type": "object",
                 "required": [
-                  "file",
-                  "purpose"
+                  "file"
                 ],
                 "properties": {
                   "file": {
@@ -3346,7 +3393,7 @@
                       "user_data",
                       "vision"
                     ],
-                    "description": "Use batch for Batch API JSONL files. Use user_data or vision for image files that will be referenced from image edits."
+                    "description": "Required in TokenLab/OpenAI-compatible mode: use batch for Batch API JSONL files, or user_data/vision for image edits. Omit in Anthropic Files mode."
                   },
                   "model": {
                     "type": "string",
@@ -3363,7 +3410,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileObject"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileObject"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicFileObject"
+                    }
+                  ]
                 }
               }
             }
@@ -3392,7 +3446,8 @@
             "schema": {
               "type": "integer",
               "minimum": 1,
-              "maximum": 100
+              "maximum": 1000,
+              "default": 20
             }
           },
           {
@@ -3402,6 +3457,30 @@
               "type": "string"
             }
           },
+          {
+            "name": "after_id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Anthropic Files cursor. Return files after this public file id. Requires the Anthropic Files beta header and cannot be combined with before_id."
+          },
+          {
+            "name": "before_id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Anthropic Files cursor. Return files before this public file id. Requires the Anthropic Files beta header and cannot be combined with after_id."
+          },
+          {
+            "name": "scope_id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "Reserved Anthropic Files scope cursor. TokenLab currently returns an explicit unsupported error rather than silently ignoring this value."
+          },
           {
             "name": "purpose",
             "in": "query",
@@ -3415,6 +3494,15 @@
               ]
             },
             "description": "Optional file purpose filter. batch and batch_output cover Batch API files; user_data and vision cover TokenLab image/reference file bindings. Anthropic Files API mode is selected by Anthropic headers rather than this query parameter."
+          },
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         ],
         "responses": {
@@ -3423,7 +3511,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileListResponse"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileListResponse"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicFileListResponse"
+                    }
+                  ]
                 }
               }
             }
@@ -3449,6 +3544,15 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         ],
         "responses": {
@@ -3457,7 +3561,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileObject"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileObject"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicFileObject"
+                    }
+                  ]
                 }
               }
             }
@@ -3483,6 +3594,15 @@
               "type": "string"
             },
             "description": "File ID returned by the Files API."
+          },
+          {
+            "name": "anthropic-beta",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Include files-api-2025-04-14 to use Anthropic Files API mode."
           }
         ],
         "responses": {
@@ -3491,7 +3611,14 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FileDeletedObject"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/FileDeletedObject"
+                    },
+                    {
+                      "$ref": "#/components/schemas/AnthropicDeletedFile"
+                    }
+                  ]
                 }
               }
             }
@@ -5447,6 +5574,18 @@
               ]
             },
             "description": "Filter by TokenLab material library class."
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -5519,6 +5658,18 @@
               "type": "string"
             },
             "example": "group-20260720123456-vrt01"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -5657,6 +5808,18 @@
               "type": "string"
             },
             "example": "group-20260720123456-vrt01"
+          },
+          {
+            "name": "project_name",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "default": "default"
+            },
+            "description": "Project scope for the material resource."
           }
         ],
         "responses": {
@@ -6101,7 +6264,7 @@
           "Seedance Volc Compatible"
         ],
         "summary": "Seedance Action dispatcher (POST)",
-        "description": "Dispatches Volc-style Action requests with TokenLab Bearer authentication. Real-person validation uses CreateVisualValidateSession and GetVisualValidateResult with Version=2024-01-01; these actions are POST-only.",
+        "description": "Dispatches Volc-style Action requests with TokenLab Bearer authentication. Real-person validation and material asset Actions use Version=2024-01-01 and are POST-only. The same POST contract is also available at the API root for endpoint-only migration from Volcengine.",
         "operationId": "dispatchVolcCompatibleSeedanceActionPost",
         "parameters": [
           {
@@ -6116,7 +6279,17 @@
                 "ListContentsGenerationsTasks",
                 "DeleteContentsGenerationsTasks",
                 "CreateVisualValidateSession",
-                "GetVisualValidateResult"
+                "GetVisualValidateResult",
+                "CreateAssetGroup",
+                "ListAssetGroups",
+                "GetAssetGroup",
+                "UpdateAssetGroup",
+                "DeleteAssetGroup",
+                "CreateAsset",
+                "ListAssets",
+                "GetAsset",
+                "UpdateAsset",
+                "DeleteAsset"
               ]
             }
           },
@@ -6142,6 +6315,9 @@
                   {
                     "$ref": "#/components/schemas/VolcGetVisualValidateResultRequest"
                   },
+                  {
+                    "$ref": "#/components/schemas/VolcMaterialActionRequest"
+                  },
                   {
                     "type": "object",
                     "additionalProperties": true
@@ -6153,7 +6329,7 @@
         },
         "responses": {
           "200": {
-            "description": "Action response. Content-generation actions return task JSON; real-person validation actions return the official ResponseMetadata + Result envelope.",
+            "description": "Action response. Content-generation actions return task JSON; real-person validation and material asset actions return the official ResponseMetadata + Result envelope.",
             "content": {
               "application/json": {
                 "schema": {
@@ -6172,6 +6348,9 @@
                     },
                     {
                       "$ref": "#/components/schemas/VolcGetVisualValidateResultResponse"
+                    },
+                    {
+                      "$ref": "#/components/schemas/VolcMaterialActionResponse"
                     }
                   ]
                 }
@@ -8190,6 +8369,13 @@
             "type": "string",
             "description": "TokenLab material group ID. Required for liveness_face materials; optional for aigc_avatar."
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material asset. Assets and groups are isolated by project inside the authenticated organization."
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -8225,6 +8411,10 @@
             "nullable": true,
             "description": "TokenLab material group ID that owns this material asset."
           },
+          "project_name": {
+            "type": "string",
+            "description": "Project scope for this material asset."
+          },
           "library_type": {
             "type": "string",
             "enum": [
@@ -8269,6 +8459,10 @@
           "created_at": {
             "type": "integer",
             "description": "Unix timestamp when the material asset record was created."
+          },
+          "updated_at": {
+            "type": "integer",
+            "description": "Unix timestamp when the material asset record was last updated."
           }
         }
       },
@@ -8557,6 +8751,7 @@
                   "unauthorized",
                   "invalid_api_key",
                   "expired_api_key",
+                  "permission_error",
                   "insufficient_balance",
                   "quota_exceeded",
                   "invalid_request_error",
@@ -10132,6 +10327,118 @@
           }
         }
       },
+      "AnthropicFileObject": {
+        "type": "object",
+        "required": [
+          "id",
+          "type",
+          "filename",
+          "mime_type",
+          "size_bytes",
+          "created_at"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "example": "file_01ABC123"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "file"
+            ]
+          },
+          "filename": {
+            "type": "string"
+          },
+          "mime_type": {
+            "type": "string"
+          },
+          "size_bytes": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "downloadable": {
+            "type": "boolean"
+          },
+          "scope": {
+            "type": "object",
+            "nullable": true,
+            "required": [
+              "id",
+              "type"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "session"
+                ]
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": true
+      },
+      "AnthropicFileListResponse": {
+        "type": "object",
+        "required": [
+          "data",
+          "first_id",
+          "last_id",
+          "has_more"
+        ],
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AnthropicFileObject"
+            }
+          },
+          "first_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "last_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "has_more": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": true
+      },
+      "AnthropicDeletedFile": {
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "file_deleted"
+            ]
+          }
+        },
+        "additionalProperties": true
+      },
       "BatchRequestCounts": {
         "type": "object",
         "required": [
@@ -10741,18 +11048,26 @@
                   "$ref": "#/components/schemas/AnthropicMessagesRequest"
                 }
               },
-              "additionalProperties": false
+              "additionalProperties": true
             }
           }
         },
-        "additionalProperties": false
+        "additionalProperties": true
       },
       "AnthropicMessageBatch": {
         "type": "object",
         "description": "Anthropic-compatible message batch object relayed from the provider.",
         "required": [
           "id",
-          "type"
+          "type",
+          "processing_status",
+          "request_counts",
+          "ended_at",
+          "created_at",
+          "expires_at",
+          "cancel_initiated_at",
+          "archived_at",
+          "results_url"
         ],
         "properties": {
           "id": {
@@ -10789,6 +11104,16 @@
             "type": "string",
             "description": "ISO timestamp when the batch expires, when available"
           },
+          "cancel_initiated_at": {
+            "type": "string",
+            "nullable": true,
+            "description": "ISO timestamp when cancellation was initiated, when available"
+          },
+          "archived_at": {
+            "type": "string",
+            "nullable": true,
+            "description": "ISO timestamp when the batch was archived, when available"
+          },
           "results_url": {
             "type": "string",
             "nullable": true,
@@ -10797,8 +11122,34 @@
         },
         "additionalProperties": true
       },
+      "AnthropicDeletedMessageBatch": {
+        "type": "object",
+        "required": [
+          "id",
+          "type"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Deleted Message Batch identifier"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "message_batch_deleted"
+            ]
+          }
+        },
+        "additionalProperties": true
+      },
       "AnthropicMessageBatchListResponse": {
         "type": "object",
+        "required": [
+          "data",
+          "has_more",
+          "first_id",
+          "last_id"
+        ],
         "properties": {
           "data": {
             "type": "array",
@@ -11535,6 +11886,13 @@
             "default": "aigc_avatar",
             "description": "Material library class. Direct creation supports aigc_avatar. Create liveness_face groups through CreateVisualValidateSession followed by GetVisualValidateResult."
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project scope for the material group."
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -11555,6 +11913,12 @@
             "nullable": true,
             "maxLength": 500
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default"
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -11588,6 +11952,10 @@
               "liveness_face"
             ]
           },
+          "project_name": {
+            "type": "string",
+            "description": "Project scope for this material group."
+          },
           "group_name": {
             "type": "string",
             "nullable": true
@@ -11607,6 +11975,10 @@
           "created_at": {
             "type": "integer",
             "format": "int64"
+          },
+          "updated_at": {
+            "type": "integer",
+            "format": "int64"
           }
         }
       },
@@ -11651,6 +12023,12 @@
               "Audio"
             ]
           },
+          "project_name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default"
+          },
           "metadata": {
             "type": "object",
             "nullable": true,
@@ -12643,6 +13021,186 @@
         },
         "additionalProperties": false
       },
+      "VolcMaterialActionRequest": {
+        "type": "object",
+        "description": "PascalCase request body for the material Action selected by the Action query parameter. Required fields depend on the selected Action.",
+        "properties": {
+          "Id": {
+            "type": "string",
+            "description": "Asset or Asset Group identifier for get, update, and delete Actions."
+          },
+          "Name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          },
+          "Description": {
+            "type": "string",
+            "maxLength": 300
+          },
+          "GroupType": {
+            "type": "string",
+            "enum": [
+              "AIGC",
+              "LivenessFace"
+            ]
+          },
+          "GroupId": {
+            "type": "string"
+          },
+          "URL": {
+            "type": "string",
+            "format": "uri"
+          },
+          "AssetType": {
+            "type": "string",
+            "enum": [
+              "Image",
+              "Video",
+              "Audio"
+            ]
+          },
+          "Filter": {
+            "type": "object",
+            "properties": {
+              "GroupIds": {
+                "type": "array",
+                "maxItems": 100,
+                "items": {
+                  "type": "string"
+                }
+              },
+              "GroupType": {
+                "type": "string",
+                "enum": [
+                  "AIGC",
+                  "LivenessFace"
+                ]
+              },
+              "Statuses": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "Active",
+                    "Processing",
+                    "Failed"
+                  ]
+                }
+              },
+              "Name": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64
+              }
+            },
+            "additionalProperties": false
+          },
+          "PageNumber": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 1
+          },
+          "PageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 10
+          },
+          "SortBy": {
+            "type": "string",
+            "enum": [
+              "CreateTime",
+              "UpdateTime",
+              "GroupId"
+            ],
+            "default": "CreateTime"
+          },
+          "SortOrder": {
+            "type": "string",
+            "enum": [
+              "Desc",
+              "Asc"
+            ],
+            "default": "Desc"
+          },
+          "ProjectName": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "default": "default",
+            "description": "Project isolation scope within the authenticated organization."
+          }
+        },
+        "additionalProperties": false
+      },
+      "VolcMaterialResponseMetadata": {
+        "type": "object",
+        "required": [
+          "RequestId",
+          "Action",
+          "Version",
+          "Service",
+          "Region"
+        ],
+        "properties": {
+          "RequestId": {
+            "type": "string"
+          },
+          "Action": {
+            "type": "string",
+            "enum": [
+              "CreateAssetGroup",
+              "ListAssetGroups",
+              "GetAssetGroup",
+              "UpdateAssetGroup",
+              "DeleteAssetGroup",
+              "CreateAsset",
+              "ListAssets",
+              "GetAsset",
+              "UpdateAsset",
+              "DeleteAsset"
+            ]
+          },
+          "Version": {
+            "type": "string",
+            "enum": [
+              "2024-01-01"
+            ]
+          },
+          "Service": {
+            "type": "string",
+            "enum": [
+              "ark"
+            ]
+          },
+          "Region": {
+            "type": "string",
+            "enum": [
+              "cn-beijing"
+            ]
+          }
+        },
+        "additionalProperties": false
+      },
+      "VolcMaterialActionResponse": {
+        "type": "object",
+        "required": [
+          "ResponseMetadata",
+          "Result"
+        ],
+        "properties": {
+          "ResponseMetadata": {
+            "$ref": "#/components/schemas/VolcMaterialResponseMetadata"
+          },
+          "Result": {
+            "type": "object",
+            "description": "Action-dependent result. List Actions return Items, TotalCount, PageNumber, and PageSize; create and update Actions return Id; delete Actions return an empty object.",
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": false
+      },
       "VolcVisualValidationError": {
         "type": "object",
         "required": [