From de2db06124d16aa4150b6e8fc4696c5353e49063 Mon Sep 17 00:00:00 2001 From: "ark-hand[bot]" Date: Mon, 14 Sep 2026 02:53:56 +0000 Subject: [PATCH] chore: sync from ark-apis 1fc1897377 Auto-generated SDK sync from ark-apis at 1fc18973773ad2bf8920de8840d166cd84ba5a3f. Generated files are overwritten by the sync pipeline and should not be edited by hand. Sync-Source-Commit: 8e9b3c73c7722c09569b4c99e5084d14d4e49791 Ark-APIs-Commit: 1fc18973773ad2bf8920de8840d166cd84ba5a3f Release-Version: 0.8.0 --- .github/workflows/release.yml | 44 +-- README.md | 4 +- VERSION | 2 +- examples/README.md | 10 + examples/byteplus/pom.xml | 2 +- .../ChatCompletionsVisionExample.java | 8 +- examples/pom.xml | 3 +- examples/volc/pom.xml | 2 +- .../volc/ChatCompletionsVisionExample.java | 8 +- pom.xml | 2 +- .../ark/runtime/models/agent/Agent.java | 2 +- .../runtime/models/agent/AgentSkillRef.java | 2 +- .../ark/runtime/models/agent/ModelConfig.java | 2 +- .../runtime/models/agent/SkillRefType.java | 6 +- .../chat/ChatCompletionContentPartImage.java | 10 +- ...atCompletionContentPartImageImageUrl2.java | 119 +++++++ .../models/chat/ChatCompletionRequest.java | 10 +- ...ChatCompletionRequestAssistantMessage.java | 16 +- ...ChatCompletionRequestDeveloperMessage.java | 227 +++++++++++++ .../chat/ChatCompletionRequestMessage.java | 1 + .../ChatCompletionRequestMessageToolCall.java | 227 +++++++++++++ ...pletionRequestMessageToolCallFunction.java | 190 +++++++++++ .../ChatCompletionRequestMessageType.java | 2 + .../ChatCompletionRequestToolMessage.java | 36 +- .../ChatCompletionRequestUserMessage.java | 18 +- .../chat/ChatCompletionResponseFormat.java | 2 +- ...hatCompletionResponseFormatJsonSchema.java | 28 +- .../chat/ChatCompletionTokenLogprob.java | 12 +- .../ChatCompletionTokenLogprobTopLogprob.java | 12 +- .../models/chat/CompletionTokensDetails.java | 45 ++- .../models/chat/PromptTokensDetails.java | 39 ++- .../models/chat/RequestServiceTier.java | 4 +- .../models/chat/ResponseServiceTier.java | 4 +- .../models/environment/Environment.java | 2 +- .../models/file/FileCreateRequest.java | 78 ++++- .../ark/runtime/models/file/FileObject.java | 78 ++++- .../ark/runtime/models/file/Purpose.java | 4 +- .../ark/runtime/models/memory/Memory.java | 2 +- .../runtime/models/memory/MemoryStore.java | 2 +- .../ContentBlockStartContentBlock.java | 10 +- ...ntBlockStartContentBlockServerToolUse.java | 274 +++++++++++++++ .../ContentBlockStartContentBlockText.java | 190 +++++++++++ ...ontentBlockStartContentBlockThinking.java} | 80 ++--- .../ContentBlockStartContentBlockToolUse.java | 274 +++++++++++++++ ...kStartContentBlockWebSearchToolResult.java | 264 +++++++++++++++ .../MessagesContentPartDocumentSource.java | 253 +------------- ...ssagesContentPartDocumentSourceBase64.java | 190 +++++++++++ ...sagesContentPartDocumentSourceContent.java | 190 +++++++++++ ...MessagesContentPartDocumentSourceText.java | 190 +++++++++++ ...essagesContentPartDocumentSourceType.java} | 16 +- .../MessagesContentPartDocumentSourceUrl.java | 190 +++++++++++ .../MessagesContentPartImageSource.java | 10 +- .../MessagesContentPartServerToolUse.java | 4 +- .../messages/MessagesContentPartThinking.java | 2 +- .../MessagesContentPartToolResult.java | 36 +- .../messages/MessagesContentPartToolUse.java | 18 +- ...essagesContentPartWebSearchToolResult.java | 14 +- ...essagesContextManagementClearToolUses.java | 311 ------------------ ...ContextManagementClearToolUsesTrigger.java | 65 +--- .../MessagesContextManagementEdit.java | 298 ++++++++++++++++- .../MessagesContextManagementEditType.java | 57 ---- .../MessagesContextManagementKeepAll.java | 45 ++- ...gesContextManagementKeepThinkingTurns.java | 12 +- ...MessagesContextManagementKeepToolUses.java | 12 +- .../messages/MessagesDocumentContent.java | 120 +++++++ .../messages/MessagesIterationUsage.java | 4 +- .../models/messages/MessagesMetadata.java | 2 +- .../models/messages/MessagesOutputConfig.java | 2 +- .../models/messages/MessagesOutputFormat.java | 188 +---------- .../MessagesOutputFormatJsonObject.java | 190 +++++++++++ .../MessagesOutputFormatJsonSchema.java | 190 +++++++++++ .../messages/MessagesOutputFormatText.java | 190 +++++++++++ .../messages/MessagesOutputFormatType.java | 6 +- .../models/messages/MessagesRequest.java | 53 +-- .../messages/MessagesRequestMessage.java | 30 +- .../messages/MessagesRequestServiceTier.java | 6 +- .../models/messages/MessagesResponse.java | 6 +- .../messages/MessagesResponseContentPart.java | 2 +- ...sagesResponseContentPartServerToolUse.java | 12 +- .../MessagesResponseContentPartText.java | 12 +- .../MessagesResponseContentPartThinking.java | 12 +- .../MessagesResponseContentPartToolUse.java | 12 +- ...a => MessagesResponseContentPartType.java} | 20 +- ...esponseContentPartWebSearchToolResult.java | 12 +- ...agesResponseStreamMessageStartMessage.java | 2 +- .../runtime/models/messages/MessagesTool.java | 17 +- .../messages/MessagesToolChoiceTool.java | 14 +- .../messages/MessagesToolUserLocation.java | 2 +- .../models/messages/MessagesUsage.java | 43 ++- .../messages/MessagesWebSearchResult.java | 2 +- .../session/ManagedAgentsSessionEvent.java | 2 +- ...gedAgentsUserDefineOutcomeEventParams.java | 2 +- .../ark/runtime/models/session/Session.java | 2 +- .../models/session/SessionResource.java | 2 +- .../models/skill/CreateSkillRequest.java | 100 +++++- .../ark/runtime/models/skill/Skill.java | 2 +- .../ark/runtime/models/vault/Credential.java | 2 +- .../ark/runtime/models/vault/Vault.java | 2 +- .../ark/runtime/selfhosted/mcp/McpClient.java | 1 - .../ark/runtime/selfhosted/mcp/McpTools.java | 1 - 100 files changed, 4312 insertions(+), 1223 deletions(-) create mode 100644 src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImageImageUrl2.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestDeveloperMessage.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCall.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCallFunction.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockServerToolUse.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockText.java rename src/main/java/com/volcengine/ark/runtime/models/messages/{MessagesContextManagementClearThinking.java => ContentBlockStartContentBlockThinking.java} (53%) create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockToolUse.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockWebSearchToolResult.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceBase64.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceContent.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceText.java rename src/main/java/com/volcengine/ark/runtime/models/messages/{MessagesDocumentSourceType.java => MessagesContentPartDocumentSourceType.java} (73%) create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceUrl.java delete mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUses.java delete mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEditType.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentContent.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonObject.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonSchema.java create mode 100644 src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatText.java rename src/main/java/com/volcengine/ark/runtime/models/messages/{MessagesRole.java => MessagesResponseContentPartType.java} (68%) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index f354972..4c5e4b0 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -1,7 +1,6 @@ name: Java Release -# Publishes com.volcengine:ark-runtime and the optional ark-runtime-mcp adapter -# to Maven Central. Tags are created +# Publishes com.volcengine:ark-runtime to Maven Central. Tags are created # exclusively by ark-hand after a sync PR lands on main, so a pushed v* tag # is always a reviewed release snapshot whose tree matches the internal # source tree. Mirrors the proven setup from volcengine/volcengine-java-sdk: @@ -59,7 +58,7 @@ jobs: with: ref: ${{ steps.tag.outputs.name }} - - name: Verify artifact versions match tag + - name: Verify pom version matches tag env: RELEASE_TAG: ${{ steps.tag.outputs.name }} run: | @@ -73,22 +72,11 @@ jobs: echo "::error::pom.xml ark-runtime version ${actual} does not match tag ${RELEASE_TAG}" exit 1 fi - mcp_actual=$(python3 -c " - import re - text = open('mcp/pom.xml').read() - artifact = re.search(r'ark-runtime-mcp\s*([^<]+)', text) - dependency = re.search(r'([^<]+)', text) - print((artifact.group(1) if artifact else 'missing') + ' ' + (dependency.group(1) if dependency else 'missing')) - ") - if [ "${mcp_actual}" != "${version} ${version}" ]; then - echo "::error::mcp artifact/core versions ${mcp_actual} do not match tag ${RELEASE_TAG}" - exit 1 - fi - name: Set up JDK uses: actions/setup-java@v4 with: - java-version: "17" + java-version: "8" distribution: "temurin" server-id: central server-username: MAVEN_CENTRAL_USERNAME @@ -96,18 +84,15 @@ jobs: gpg-private-key: ${{ secrets.GPG_PRIVATE_KEY }} gpg-passphrase: GPG_PASSPHRASE - - name: Check Maven Central versions + - name: Check Maven Central version id: maven_check env: RELEASE_TAG: ${{ steps.tag.outputs.name }} run: | version="${RELEASE_TAG#v}" - core_url="https://repo.maven.apache.org/maven2/com/volcengine/ark-runtime/${version}/ark-runtime-${version}.pom" - mcp_url="https://repo.maven.apache.org/maven2/com/volcengine/ark-runtime-mcp/${version}/ark-runtime-mcp-${version}.pom" - core_code=$(curl -sS -o /dev/null -w '%{http_code}' "${core_url}") - mcp_code=$(curl -sS -o /dev/null -w '%{http_code}' "${mcp_url}") - echo "core_publish_needed=$([ "${core_code}" = "200" ] && echo false || echo true)" >> "$GITHUB_OUTPUT" - echo "mcp_publish_needed=$([ "${mcp_code}" = "200" ] && echo false || echo true)" >> "$GITHUB_OUTPUT" + pom_url="https://repo.maven.apache.org/maven2/com/volcengine/ark-runtime/${version}/ark-runtime-${version}.pom" + code=$(curl -sS -o /dev/null -w '%{http_code}' "${pom_url}") + echo "publish_needed=$([ "${code}" = "200" ] && echo false || echo true)" >> "$GITHUB_OUTPUT" - name: Check publish credentials env: @@ -126,8 +111,8 @@ jobs: exit 1 fi - - name: Publish core to Maven Central - if: steps.maven_check.outputs.core_publish_needed == 'true' + - name: Publish to Maven Central + if: steps.maven_check.outputs.publish_needed == 'true' run: | mvn clean deploy -B -Ppublic -DskipTests \ -Dmaven.javadoc.failOnError=false \ @@ -136,14 +121,3 @@ jobs: MAVEN_CENTRAL_USERNAME: ${{ secrets.OSSRH_USERNAME }} MAVEN_CENTRAL_TOKEN: ${{ secrets.OSSRH_TOKEN }} GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }} - - - name: Publish MCP adapter to Maven Central - if: steps.maven_check.outputs.mcp_publish_needed == 'true' - run: | - mvn clean deploy -B -f mcp/pom.xml -Ppublic -DskipTests \ - -Dmaven.javadoc.failOnError=false \ - -Dmaven.javadoc.quiet=true - env: - MAVEN_CENTRAL_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_CENTRAL_TOKEN: ${{ secrets.OSSRH_TOKEN }} - GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }} diff --git a/README.md b/README.md index ca329cf..e516974 100644 --- a/README.md +++ b/README.md @@ -10,14 +10,14 @@ The official Java library for accessing ModelArk on Volcengine and BytePlus. It com.volcengine ark-runtime - 0.7.0 + 0.8.0 ``` ### Gradle ```groovy -implementation 'com.volcengine:ark-runtime:0.7.0' +implementation 'com.volcengine:ark-runtime:0.8.0' ``` ## Choose Volcengine or BytePlus diff --git a/VERSION b/VERSION index faef31a..a3df0a6 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.7.0 +0.8.0 diff --git a/examples/README.md b/examples/README.md index 3c9e729..e36405a 100644 --- a/examples/README.md +++ b/examples/README.md @@ -24,3 +24,13 @@ The paired multimodal and sparse embedding examples default to `doubao-embedding MCP is available in both clouds and its calls explicitly send `ark-beta-mcp: true`. Other built-in tools are CN-only: Knowledge Search sends `ark-beta-knowledge-search: true`, and Doubao App sends `ark-beta-doubao-app: true`. [`self_hosted_mcp_worker/`](./self_hosted_mcp_worker) demonstrates how to discover tools from a local stdio MCP server, convert them into Agent custom tool declarations, and execute them through the self-hosted worker. + +To compile both cloud example modules without making API calls, run from the repository root: + +```bash +mvn -q -DskipTests install +mvn -q -f examples/volc/pom.xml clean compile +mvn -q -f examples/byteplus/pom.xml clean compile +``` + +The cloud example POMs default to SDK 0.8.0. To check another locally installed SDK version, pass `-Dark-runtime.version=` to each example Maven command. diff --git a/examples/byteplus/pom.xml b/examples/byteplus/pom.xml index b94e421..804b695 100644 --- a/examples/byteplus/pom.xml +++ b/examples/byteplus/pom.xml @@ -9,7 +9,7 @@ 0.1.0 - 0.4.0 + 0.8.0 8 8 UTF-8 diff --git a/examples/byteplus/src/main/java/com/volcengine/ark/runtime/examples/byteplus/ChatCompletionsVisionExample.java b/examples/byteplus/src/main/java/com/volcengine/ark/runtime/examples/byteplus/ChatCompletionsVisionExample.java index d03cfaf..caadbb2 100644 --- a/examples/byteplus/src/main/java/com/volcengine/ark/runtime/examples/byteplus/ChatCompletionsVisionExample.java +++ b/examples/byteplus/src/main/java/com/volcengine/ark/runtime/examples/byteplus/ChatCompletionsVisionExample.java @@ -3,6 +3,7 @@ import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPart; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartImage; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartImageImageUrl; +import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartImageImageUrl2; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartText; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartType; import com.volcengine.ark.runtime.models.chat.ChatCompletionMessageContent; @@ -42,9 +43,10 @@ public static void main(String[] args) { .build()); multiParts.add(ChatCompletionContentPartImage.builder() .type(ChatCompletionContentPartType.IMAGE_URL) - .imageUrl(ChatCompletionContentPartImageImageUrl.builder() - .url("https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg") - .build()) + .imageUrl(ChatCompletionContentPartImageImageUrl2.ofChatCompletionContentPartImageImageUrl( + ChatCompletionContentPartImageImageUrl.builder() + .url("https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg") + .build())) .build()); messages.add(ChatCompletionRequestUserMessage.builder() .role(ChatCompletionRequestMessageType.USER) diff --git a/examples/pom.xml b/examples/pom.xml index dfee77f..73ec638 100644 --- a/examples/pom.xml +++ b/examples/pom.xml @@ -13,6 +13,7 @@ Runnable examples for the ark-runtime Java SDK. + 0.8.0 8 8 UTF-8 @@ -22,7 +23,7 @@ com.volcengine ark-runtime - 0.1.0 + ${ark-runtime.version} diff --git a/examples/volc/pom.xml b/examples/volc/pom.xml index f30bd31..d3661f0 100644 --- a/examples/volc/pom.xml +++ b/examples/volc/pom.xml @@ -9,7 +9,7 @@ 0.1.0 - 0.4.0 + 0.8.0 8 8 UTF-8 diff --git a/examples/volc/src/main/java/com/volcengine/ark/runtime/examples/volc/ChatCompletionsVisionExample.java b/examples/volc/src/main/java/com/volcengine/ark/runtime/examples/volc/ChatCompletionsVisionExample.java index 1b1bb1b..f2cefef 100644 --- a/examples/volc/src/main/java/com/volcengine/ark/runtime/examples/volc/ChatCompletionsVisionExample.java +++ b/examples/volc/src/main/java/com/volcengine/ark/runtime/examples/volc/ChatCompletionsVisionExample.java @@ -3,6 +3,7 @@ import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPart; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartImage; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartImageImageUrl; +import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartImageImageUrl2; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartText; import com.volcengine.ark.runtime.models.chat.ChatCompletionContentPartType; import com.volcengine.ark.runtime.models.chat.ChatCompletionMessageContent; @@ -42,9 +43,10 @@ public static void main(String[] args) { .build()); multiParts.add(ChatCompletionContentPartImage.builder() .type(ChatCompletionContentPartType.IMAGE_URL) - .imageUrl(ChatCompletionContentPartImageImageUrl.builder() - .url("https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg") - .build()) + .imageUrl(ChatCompletionContentPartImageImageUrl2.ofChatCompletionContentPartImageImageUrl( + ChatCompletionContentPartImageImageUrl.builder() + .url("https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg") + .build())) .build()); messages.add(ChatCompletionRequestUserMessage.builder() .role(ChatCompletionRequestMessageType.USER) diff --git a/pom.xml b/pom.xml index 02ab9f1..65caf55 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ com.volcengine ark-runtime - 0.7.0 + 0.8.0 jar ark-runtime diff --git a/src/main/java/com/volcengine/ark/runtime/models/agent/Agent.java b/src/main/java/com/volcengine/ark/runtime/models/agent/Agent.java index 090021a..b9ffa40 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/agent/Agent.java +++ b/src/main/java/com/volcengine/ark/runtime/models/agent/Agent.java @@ -157,7 +157,7 @@ public Agent id(@javax.annotation.Nonnull String id) { } /** - * Agent ID，格式 `agent_<opaque>`。对外暴露给 session 引用。 + * Agent ID，形如 `agent-...`。对外暴露给 session 引用。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/agent/AgentSkillRef.java b/src/main/java/com/volcengine/ark/runtime/models/agent/AgentSkillRef.java index 05c5bdc..c867043 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/agent/AgentSkillRef.java +++ b/src/main/java/com/volcengine/ark/runtime/models/agent/AgentSkillRef.java @@ -83,7 +83,7 @@ public AgentSkillRef skillId(@javax.annotation.Nullable String skillId) { } /** - * Skill ID，形如 `skill_01XJ5...`。 + * Skill ID，形如 `skill-...`。 * @return skillId */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/agent/ModelConfig.java b/src/main/java/com/volcengine/ark/runtime/models/agent/ModelConfig.java index a818214..4e8ab4a 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/agent/ModelConfig.java +++ b/src/main/java/com/volcengine/ark/runtime/models/agent/ModelConfig.java @@ -75,7 +75,7 @@ public ModelConfig id(@javax.annotation.Nonnull String id) { } /** - * 模型 ID，例如 `claude-opus-4-7` / `claude-sonnet-4-6` / `claude-haiku-4-5`。 + * 模型 ID，例如 `doubao-seed-2-1`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/agent/SkillRefType.java b/src/main/java/com/volcengine/ark/runtime/models/agent/SkillRefType.java index 524ed37..a22f24e 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/agent/SkillRefType.java +++ b/src/main/java/com/volcengine/ark/runtime/models/agent/SkillRefType.java @@ -25,11 +25,11 @@ */ public enum SkillRefType { - ANTHROPIC("anthropic"), - CUSTOM("custom"), - SKILL_HUB("skill_hub"); + SKILL_HUB("skill_hub"), + + ARK("ark"); private String value; diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImage.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImage.java index b8a16e8..ee4046a 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImage.java @@ -36,7 +36,7 @@ public class ChatCompletionContentPartImage implements ChatCompletionContentPart public static final String JSON_PROPERTY_IMAGE_URL = "image_url"; @javax.annotation.Nonnull - private ChatCompletionContentPartImageImageUrl imageUrl; + private ChatCompletionContentPartImageImageUrl2 imageUrl; public ChatCompletionContentPartImage() { } @@ -66,7 +66,7 @@ public void setType(@javax.annotation.Nonnull ChatCompletionContentPartType type this.type = type; } - public ChatCompletionContentPartImage imageUrl(@javax.annotation.Nonnull ChatCompletionContentPartImageImageUrl imageUrl) { + public ChatCompletionContentPartImage imageUrl(@javax.annotation.Nonnull ChatCompletionContentPartImageImageUrl2 imageUrl) { this.imageUrl = imageUrl; return this; @@ -80,14 +80,14 @@ public ChatCompletionContentPartImage imageUrl(@javax.annotation.Nonnull ChatCom @JsonProperty(value = JSON_PROPERTY_IMAGE_URL, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public ChatCompletionContentPartImageImageUrl getImageUrl() { + public ChatCompletionContentPartImageImageUrl2 getImageUrl() { return imageUrl; } @JsonProperty(value = JSON_PROPERTY_IMAGE_URL, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setImageUrl(@javax.annotation.Nonnull ChatCompletionContentPartImageImageUrl imageUrl) { + public void setImageUrl(@javax.annotation.Nonnull ChatCompletionContentPartImageImageUrl2 imageUrl) { this.imageUrl = imageUrl; } @@ -144,7 +144,7 @@ public ChatCompletionContentPartImage.Builder type(ChatCompletionContentPartType this.instance.type = type; return this; } - public ChatCompletionContentPartImage.Builder imageUrl(ChatCompletionContentPartImageImageUrl imageUrl) { + public ChatCompletionContentPartImage.Builder imageUrl(ChatCompletionContentPartImageImageUrl2 imageUrl) { this.instance.imageUrl = imageUrl; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImageImageUrl2.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImageImageUrl2.java new file mode 100644 index 0000000..49820e2 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionContentPartImageImageUrl2.java @@ -0,0 +1,119 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Chat Completions API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + +package com.volcengine.ark.runtime.models.chat; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonValue; +import com.fasterxml.jackson.core.JsonParser; +import com.fasterxml.jackson.databind.DeserializationContext; +import com.fasterxml.jackson.databind.JsonDeserializer; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.annotation.JsonDeserialize; +import java.io.IOException; +import java.util.Objects; + +/** + * ChatCompletionContentPartImageImageUrl2 + * + * Naked-union holder generated by gen/java/postprocess.py from the openapi + * anyOf schema (variants: String, ChatCompletionContentPartImageImageUrl). + * + * The Jackson apache-httpclient template openapi-generator runs against + * does not support non-discriminated anyOf/oneOf — it either drops to a + * degenerate empty shell or flattens one variant's fields onto the class, + * losing the others. This postprocess rewrite replaces the parent with a + * @JsonValue holder + typed static factories for write-side, plus a custom + * @JsonDeserialize that dispatches by JsonNode shape on the read-side so + * round-trips preserve variant types (string -> typed primitive/enum, + * object -> typed model, array -> typed List). + */ +@JsonDeserialize(using = ChatCompletionContentPartImageImageUrl2.Deserializer.class) +public class ChatCompletionContentPartImageImageUrl2 { + + private final Object value; + + @JsonCreator + public ChatCompletionContentPartImageImageUrl2(Object value) { + this.value = value; + } + + public ChatCompletionContentPartImageImageUrl2() { + this.value = null; + } + + public static ChatCompletionContentPartImageImageUrl2 ofString(String value) { + return new ChatCompletionContentPartImageImageUrl2(value); + } + + public static ChatCompletionContentPartImageImageUrl2 ofChatCompletionContentPartImageImageUrl(ChatCompletionContentPartImageImageUrl value) { + return new ChatCompletionContentPartImageImageUrl2(value); + } + + @JsonValue + public Object getValue() { + return this.value; + } + + public static class Deserializer extends JsonDeserializer { + @Override + public ChatCompletionContentPartImageImageUrl2 deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { + ObjectMapper mapper = (ObjectMapper) p.getCodec(); + JsonNode node = mapper.readTree(p); + if (node.isTextual()) { + return new ChatCompletionContentPartImageImageUrl2(mapper.treeToValue(node, String.class)); + } + if (node.isObject()) { + return new ChatCompletionContentPartImageImageUrl2(mapper.treeToValue(node, ChatCompletionContentPartImageImageUrl.class)); + } + throw ctxt.weirdStringException( + node == null ? "null" : node.toString(), + ChatCompletionContentPartImageImageUrl2.class, + "no ChatCompletionContentPartImageImageUrl2 variant matched JSON node shape"); + } + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + ChatCompletionContentPartImageImageUrl2 other = (ChatCompletionContentPartImageImageUrl2) o; + return Objects.equals(this.value, other.value); + } + + @Override + public int hashCode() { + return Objects.hash(this.value); + } + + @Override + public String toString() { + return "class ChatCompletionContentPartImageImageUrl2 {" + Objects.toString(value) + "}"; + } + + public static class Builder { + private Object value; + public Builder() {} + public Builder value(Object value) { this.value = value; return this; } + public ChatCompletionContentPartImageImageUrl2 build() { return new ChatCompletionContentPartImageImageUrl2(this.value); } + } + + public static ChatCompletionContentPartImageImageUrl2.Builder builder() { return new ChatCompletionContentPartImageImageUrl2.Builder(); } + + public ChatCompletionContentPartImageImageUrl2.Builder toBuilder() { + return new ChatCompletionContentPartImageImageUrl2.Builder().value(this.value); + } +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequest.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequest.java index c5bd666..70af9eb 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequest.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequest.java @@ -170,7 +170,7 @@ public ChatCompletionRequest addMessagesItem(ChatCompletionRequestMessage messag } /** - * A list of messages comprising the conversation so far. + * A non-empty list of messages comprising the conversation so far. * @return messages */ @javax.annotation.Nonnull @@ -353,7 +353,7 @@ public ChatCompletionRequest topLogprobs(@javax.annotation.Nullable Integer topL } /** - * Number of most-likely tokens to return at each position when `logprobs` is true. Range 0-20. + * Number of most-likely tokens to return at each position when `logprobs` is true. The allowed range is model-dependent (default 0-20). * @return topLogprobs */ @javax.annotation.Nullable @@ -378,7 +378,7 @@ public ChatCompletionRequest maxTokens(@javax.annotation.Nullable Integer maxTok } /** - * The maximum number of tokens that can be generated in the completion. + * The non-negative maximum number of tokens that can be generated in the completion. * @return maxTokens */ @javax.annotation.Nullable @@ -403,7 +403,7 @@ public ChatCompletionRequest maxCompletionTokens(@javax.annotation.Nullable Inte } /** - * Upper bound on completion tokens, including reasoning tokens. + * Non-negative upper bound on completion tokens, including reasoning tokens. * @return maxCompletionTokens */ @javax.annotation.Nullable @@ -478,7 +478,7 @@ public ChatCompletionRequest stop(@javax.annotation.Nullable ChatCompletionStop } /** - * Up to 4 sequences where the API will stop generating further tokens. + * Sequences where the API will stop generating further tokens. The count limit is model-dependent (default 4). Null means no stop sequences. * @return stop */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestAssistantMessage.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestAssistantMessage.java index d1b928c..5e1162b 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestAssistantMessage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestAssistantMessage.java @@ -54,7 +54,7 @@ public class ChatCompletionRequestAssistantMessage implements ChatCompletionRequ public static final String JSON_PROPERTY_TOOL_CALLS = "tool_calls"; @javax.annotation.Nullable - private List toolCalls; + private List toolCalls; public static final String JSON_PROPERTY_NAME = "name"; @javax.annotation.Nullable @@ -95,7 +95,7 @@ public ChatCompletionRequestAssistantMessage content(@javax.annotation.Nullable } /** - * The contents of the assistant message. Required unless `tool_calls` is specified. + * Get content * @return content */ @javax.annotation.Nullable @@ -120,7 +120,7 @@ public ChatCompletionRequestAssistantMessage reasoningContent(@javax.annotation. } /** - * The reasoning content emitted by the assistant alongside `content`. + * Get reasoningContent * @return reasoningContent */ @javax.annotation.Nullable @@ -163,13 +163,13 @@ public void setEncryptedContent(@javax.annotation.Nullable String encryptedConte this.encryptedContent = encryptedContent; } - public ChatCompletionRequestAssistantMessage toolCalls(@javax.annotation.Nullable List toolCalls) { + public ChatCompletionRequestAssistantMessage toolCalls(@javax.annotation.Nullable List toolCalls) { this.toolCalls = toolCalls; return this; } - public ChatCompletionRequestAssistantMessage addToolCallsItem(ChatCompletionMessageToolCall toolCallsItem) { + public ChatCompletionRequestAssistantMessage addToolCallsItem(ChatCompletionRequestMessageToolCall toolCallsItem) { if (this.toolCalls == null) { this.toolCalls = new ArrayList<>(); } @@ -185,14 +185,14 @@ public ChatCompletionRequestAssistantMessage addToolCallsItem(ChatCompletionMess @JsonProperty(value = JSON_PROPERTY_TOOL_CALLS, required = false) @JsonInclude(value = JsonInclude.Include.NON_EMPTY) - public List getToolCalls() { + public List getToolCalls() { return toolCalls; } @JsonProperty(value = JSON_PROPERTY_TOOL_CALLS, required = false) @JsonInclude(value = JsonInclude.Include.NON_EMPTY) - public void setToolCalls(@javax.annotation.Nullable List toolCalls) { + public void setToolCalls(@javax.annotation.Nullable List toolCalls) { this.toolCalls = toolCalls; } @@ -294,7 +294,7 @@ public ChatCompletionRequestAssistantMessage.Builder encryptedContent(String enc this.instance.encryptedContent = encryptedContent; return this; } - public ChatCompletionRequestAssistantMessage.Builder toolCalls(List toolCalls) { + public ChatCompletionRequestAssistantMessage.Builder toolCalls(List toolCalls) { this.instance.toolCalls = toolCalls; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestDeveloperMessage.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestDeveloperMessage.java new file mode 100644 index 0000000..0f9f36a --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestDeveloperMessage.java @@ -0,0 +1,227 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Chat Completions API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.chat; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * Developer instructions are treated as system messages. + */ +@JsonPropertyOrder({ + ChatCompletionRequestDeveloperMessage.JSON_PROPERTY_ROLE, + ChatCompletionRequestDeveloperMessage.JSON_PROPERTY_CONTENT, + ChatCompletionRequestDeveloperMessage.JSON_PROPERTY_NAME +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ChatCompletionRequestDeveloperMessage implements ChatCompletionRequestMessage { + public static final String JSON_PROPERTY_ROLE = "role"; + @javax.annotation.Nonnull + private ChatCompletionRequestMessageType role = ChatCompletionRequestMessageType.DEVELOPER; + + public static final String JSON_PROPERTY_CONTENT = "content"; + @javax.annotation.Nonnull + private ChatCompletionMessageContent content; + + public static final String JSON_PROPERTY_NAME = "name"; + @javax.annotation.Nullable + private String name; + + public ChatCompletionRequestDeveloperMessage() { + } + + public ChatCompletionRequestDeveloperMessage role(@javax.annotation.Nonnull ChatCompletionRequestMessageType role) { + + this.role = role; + return this; + } + + /** + * Get role + * @return role + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_ROLE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ChatCompletionRequestMessageType getRole() { + return role; + } + + + @JsonProperty(value = JSON_PROPERTY_ROLE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setRole(@javax.annotation.Nonnull ChatCompletionRequestMessageType role) { + this.role = role; + } + + public ChatCompletionRequestDeveloperMessage content(@javax.annotation.Nonnull ChatCompletionMessageContent content) { + + this.content = content; + return this; + } + + /** + * The contents of the developer message. + * @return content + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ChatCompletionMessageContent getContent() { + return content; + } + + + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setContent(@javax.annotation.Nonnull ChatCompletionMessageContent content) { + this.content = content; + } + + public ChatCompletionRequestDeveloperMessage name(@javax.annotation.Nullable String name) { + + this.name = name; + return this; + } + + /** + * Get name + * @return name + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getName() { + return name; + } + + + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setName(@javax.annotation.Nullable String name) { + this.name = name; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ChatCompletionRequestDeveloperMessage chatCompletionRequestDeveloperMessage = (ChatCompletionRequestDeveloperMessage) o; + return Objects.equals(this.role, chatCompletionRequestDeveloperMessage.role) && + Objects.equals(this.content, chatCompletionRequestDeveloperMessage.content) && + Objects.equals(this.name, chatCompletionRequestDeveloperMessage.name); + } + + @Override + public int hashCode() { + return Objects.hash(role, content, name); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ChatCompletionRequestDeveloperMessage {\n"); + sb.append(" role: ").append(toIndentedString(role)).append("\n"); + sb.append(" content: ").append(toIndentedString(content)).append("\n"); + sb.append(" name: ").append(toIndentedString(name)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ChatCompletionRequestDeveloperMessage instance; + + public Builder() { + this(new ChatCompletionRequestDeveloperMessage()); + } + + protected Builder(ChatCompletionRequestDeveloperMessage instance) { + this.instance = instance; + } + + public ChatCompletionRequestDeveloperMessage.Builder role(ChatCompletionRequestMessageType role) { + this.instance.role = role; + return this; + } + public ChatCompletionRequestDeveloperMessage.Builder content(ChatCompletionMessageContent content) { + this.instance.content = content; + return this; + } + public ChatCompletionRequestDeveloperMessage.Builder name(String name) { + this.instance.name = name; + return this; + } + + + /** + * returns a built ChatCompletionRequestDeveloperMessage instance. + * + * The builder is not reusable. + */ + public ChatCompletionRequestDeveloperMessage build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ChatCompletionRequestDeveloperMessage.Builder builder() { + return new ChatCompletionRequestDeveloperMessage.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ChatCompletionRequestDeveloperMessage.Builder toBuilder() { + return new ChatCompletionRequestDeveloperMessage.Builder() + .role(getRole()) + .content(getContent()) + .name(getName()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessage.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessage.java index 42187f4..c28f8f7 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessage.java @@ -23,6 +23,7 @@ @JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "role", visible = true) @JsonSubTypes({ @JsonSubTypes.Type(value = ChatCompletionRequestAssistantMessage.class, name = "assistant"), + @JsonSubTypes.Type(value = ChatCompletionRequestDeveloperMessage.class, name = "developer"), @JsonSubTypes.Type(value = ChatCompletionRequestSystemMessage.class, name = "system"), @JsonSubTypes.Type(value = ChatCompletionRequestToolMessage.class, name = "tool"), @JsonSubTypes.Type(value = ChatCompletionRequestUserMessage.class, name = "user"), diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCall.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCall.java new file mode 100644 index 0000000..6dd3639 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCall.java @@ -0,0 +1,227 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Chat Completions API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.chat; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * ChatCompletionRequestMessageToolCall + */ +@JsonPropertyOrder({ + ChatCompletionRequestMessageToolCall.JSON_PROPERTY_ID, + ChatCompletionRequestMessageToolCall.JSON_PROPERTY_TYPE, + ChatCompletionRequestMessageToolCall.JSON_PROPERTY_FUNCTION +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ChatCompletionRequestMessageToolCall { + public static final String JSON_PROPERTY_ID = "id"; + @javax.annotation.Nullable + private String id; + + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private ToolType type; + + public static final String JSON_PROPERTY_FUNCTION = "function"; + @javax.annotation.Nonnull + private ChatCompletionRequestMessageToolCallFunction function; + + public ChatCompletionRequestMessageToolCall() { + } + + public ChatCompletionRequestMessageToolCall id(@javax.annotation.Nullable String id) { + + this.id = id; + return this; + } + + /** + * Get id + * @return id + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getId() { + return id; + } + + + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setId(@javax.annotation.Nullable String id) { + this.id = id; + } + + public ChatCompletionRequestMessageToolCall type(@javax.annotation.Nonnull ToolType type) { + + this.type = type; + return this; + } + + /** + * The type of the tool. Currently, only `function` is supported. + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ToolType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull ToolType type) { + this.type = type; + } + + public ChatCompletionRequestMessageToolCall function(@javax.annotation.Nonnull ChatCompletionRequestMessageToolCallFunction function) { + + this.function = function; + return this; + } + + /** + * The function called in a previous assistant message. + * @return function + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_FUNCTION, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ChatCompletionRequestMessageToolCallFunction getFunction() { + return function; + } + + + @JsonProperty(value = JSON_PROPERTY_FUNCTION, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setFunction(@javax.annotation.Nonnull ChatCompletionRequestMessageToolCallFunction function) { + this.function = function; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ChatCompletionRequestMessageToolCall chatCompletionRequestMessageToolCall = (ChatCompletionRequestMessageToolCall) o; + return Objects.equals(this.id, chatCompletionRequestMessageToolCall.id) && + Objects.equals(this.type, chatCompletionRequestMessageToolCall.type) && + Objects.equals(this.function, chatCompletionRequestMessageToolCall.function); + } + + @Override + public int hashCode() { + return Objects.hash(id, type, function); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ChatCompletionRequestMessageToolCall {\n"); + sb.append(" id: ").append(toIndentedString(id)).append("\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" function: ").append(toIndentedString(function)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ChatCompletionRequestMessageToolCall instance; + + public Builder() { + this(new ChatCompletionRequestMessageToolCall()); + } + + protected Builder(ChatCompletionRequestMessageToolCall instance) { + this.instance = instance; + } + + public ChatCompletionRequestMessageToolCall.Builder id(String id) { + this.instance.id = id; + return this; + } + public ChatCompletionRequestMessageToolCall.Builder type(ToolType type) { + this.instance.type = type; + return this; + } + public ChatCompletionRequestMessageToolCall.Builder function(ChatCompletionRequestMessageToolCallFunction function) { + this.instance.function = function; + return this; + } + + + /** + * returns a built ChatCompletionRequestMessageToolCall instance. + * + * The builder is not reusable. + */ + public ChatCompletionRequestMessageToolCall build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ChatCompletionRequestMessageToolCall.Builder builder() { + return new ChatCompletionRequestMessageToolCall.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ChatCompletionRequestMessageToolCall.Builder toBuilder() { + return new ChatCompletionRequestMessageToolCall.Builder() + .id(getId()) + .type(getType()) + .function(getFunction()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCallFunction.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCallFunction.java new file mode 100644 index 0000000..77e4129 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageToolCallFunction.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Chat Completions API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.chat; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * ChatCompletionRequestMessageToolCallFunction + */ +@JsonPropertyOrder({ + ChatCompletionRequestMessageToolCallFunction.JSON_PROPERTY_NAME, + ChatCompletionRequestMessageToolCallFunction.JSON_PROPERTY_ARGUMENTS +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ChatCompletionRequestMessageToolCallFunction { + public static final String JSON_PROPERTY_NAME = "name"; + @javax.annotation.Nonnull + private String name; + + public static final String JSON_PROPERTY_ARGUMENTS = "arguments"; + @javax.annotation.Nullable + private String arguments; + + public ChatCompletionRequestMessageToolCallFunction() { + } + + public ChatCompletionRequestMessageToolCallFunction name(@javax.annotation.Nonnull String name) { + + this.name = name; + return this; + } + + /** + * The name of the function to call. + * @return name + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_NAME, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public String getName() { + return name; + } + + + @JsonProperty(value = JSON_PROPERTY_NAME, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setName(@javax.annotation.Nonnull String name) { + this.name = name; + } + + public ChatCompletionRequestMessageToolCallFunction arguments(@javax.annotation.Nullable String arguments) { + + this.arguments = arguments; + return this; + } + + /** + * The JSON-encoded function arguments. When omitted, the backend uses an empty string. + * @return arguments + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_ARGUMENTS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getArguments() { + return arguments; + } + + + @JsonProperty(value = JSON_PROPERTY_ARGUMENTS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setArguments(@javax.annotation.Nullable String arguments) { + this.arguments = arguments; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ChatCompletionRequestMessageToolCallFunction chatCompletionRequestMessageToolCallFunction = (ChatCompletionRequestMessageToolCallFunction) o; + return Objects.equals(this.name, chatCompletionRequestMessageToolCallFunction.name) && + Objects.equals(this.arguments, chatCompletionRequestMessageToolCallFunction.arguments); + } + + @Override + public int hashCode() { + return Objects.hash(name, arguments); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ChatCompletionRequestMessageToolCallFunction {\n"); + sb.append(" name: ").append(toIndentedString(name)).append("\n"); + sb.append(" arguments: ").append(toIndentedString(arguments)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ChatCompletionRequestMessageToolCallFunction instance; + + public Builder() { + this(new ChatCompletionRequestMessageToolCallFunction()); + } + + protected Builder(ChatCompletionRequestMessageToolCallFunction instance) { + this.instance = instance; + } + + public ChatCompletionRequestMessageToolCallFunction.Builder name(String name) { + this.instance.name = name; + return this; + } + public ChatCompletionRequestMessageToolCallFunction.Builder arguments(String arguments) { + this.instance.arguments = arguments; + return this; + } + + + /** + * returns a built ChatCompletionRequestMessageToolCallFunction instance. + * + * The builder is not reusable. + */ + public ChatCompletionRequestMessageToolCallFunction build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ChatCompletionRequestMessageToolCallFunction.Builder builder() { + return new ChatCompletionRequestMessageToolCallFunction.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ChatCompletionRequestMessageToolCallFunction.Builder toBuilder() { + return new ChatCompletionRequestMessageToolCallFunction.Builder() + .name(getName()) + .arguments(getArguments()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageType.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageType.java index 6b65e4d..a4a8cef 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageType.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestMessageType.java @@ -27,6 +27,8 @@ public enum ChatCompletionRequestMessageType { ASSISTANT("assistant"), + DEVELOPER("developer"), + SYSTEM("system"), TOOL("tool"), diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestToolMessage.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestToolMessage.java index cb6eae7..9f48e9d 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestToolMessage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestToolMessage.java @@ -37,11 +37,11 @@ public class ChatCompletionRequestToolMessage implements ChatCompletionRequestMe private ChatCompletionRequestMessageType role = ChatCompletionRequestMessageType.TOOL; public static final String JSON_PROPERTY_CONTENT = "content"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private ChatCompletionMessageContent content; public static final String JSON_PROPERTY_TOOL_CALL_ID = "tool_call_id"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private String toolCallId; public static final String JSON_PROPERTY_NAME = "name"; @@ -76,53 +76,53 @@ public void setRole(@javax.annotation.Nonnull ChatCompletionRequestMessageType r this.role = role; } - public ChatCompletionRequestToolMessage content(@javax.annotation.Nonnull ChatCompletionMessageContent content) { + public ChatCompletionRequestToolMessage content(@javax.annotation.Nullable ChatCompletionMessageContent content) { this.content = content; return this; } /** - * The contents of the tool message. + * Get content * @return content */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public ChatCompletionMessageContent getContent() { return content; } - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setContent(@javax.annotation.Nonnull ChatCompletionMessageContent content) { + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setContent(@javax.annotation.Nullable ChatCompletionMessageContent content) { this.content = content; } - public ChatCompletionRequestToolMessage toolCallId(@javax.annotation.Nonnull String toolCallId) { + public ChatCompletionRequestToolMessage toolCallId(@javax.annotation.Nullable String toolCallId) { this.toolCallId = toolCallId; return this; } /** - * Tool call that this message is responding to. + * Get toolCallId * @return toolCallId */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_TOOL_CALL_ID, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_TOOL_CALL_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public String getToolCallId() { return toolCallId; } - @JsonProperty(value = JSON_PROPERTY_TOOL_CALL_ID, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setToolCallId(@javax.annotation.Nonnull String toolCallId) { + @JsonProperty(value = JSON_PROPERTY_TOOL_CALL_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setToolCallId(@javax.annotation.Nullable String toolCallId) { this.toolCallId = toolCallId; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestUserMessage.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestUserMessage.java index af18101..955e6d8 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestUserMessage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionRequestUserMessage.java @@ -36,7 +36,7 @@ public class ChatCompletionRequestUserMessage implements ChatCompletionRequestMe private ChatCompletionRequestMessageType role = ChatCompletionRequestMessageType.USER; public static final String JSON_PROPERTY_CONTENT = "content"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private ChatCompletionMessageContent content; public static final String JSON_PROPERTY_NAME = "name"; @@ -71,28 +71,28 @@ public void setRole(@javax.annotation.Nonnull ChatCompletionRequestMessageType r this.role = role; } - public ChatCompletionRequestUserMessage content(@javax.annotation.Nonnull ChatCompletionMessageContent content) { + public ChatCompletionRequestUserMessage content(@javax.annotation.Nullable ChatCompletionMessageContent content) { this.content = content; return this; } /** - * The contents of the user message. + * Get content * @return content */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public ChatCompletionMessageContent getContent() { return content; } - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setContent(@javax.annotation.Nonnull ChatCompletionMessageContent content) { + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setContent(@javax.annotation.Nullable ChatCompletionMessageContent content) { this.content = content; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormat.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormat.java index 1a33da6..b6d924f 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormat.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormat.java @@ -73,7 +73,7 @@ public ChatCompletionResponseFormat jsonSchema(@javax.annotation.Nullable ChatCo } /** - * Structured Outputs configuration; required when `type` is `json_schema`. + * Structured Outputs configuration for `json_schema` responses. * @return jsonSchema */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormatJsonSchema.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormatJsonSchema.java index 70e9d2b..bf5e5d8 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormatJsonSchema.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionResponseFormatJsonSchema.java @@ -19,8 +19,6 @@ import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import com.fasterxml.jackson.annotation.JsonPropertyOrder; -import java.util.HashMap; -import java.util.Map; import java.util.Objects; /** @@ -44,7 +42,7 @@ public class ChatCompletionResponseFormatJsonSchema { public static final String JSON_PROPERTY_SCHEMA = "schema"; @javax.annotation.Nullable - private Map schema; + private Object schema = null; public static final String JSON_PROPERTY_STRICT = "strict"; @javax.annotation.Nullable @@ -60,7 +58,7 @@ public ChatCompletionResponseFormatJsonSchema name(@javax.annotation.Nonnull Str } /** - * The name of the response format. + * The non-empty name of the response format. * @return name */ @javax.annotation.Nonnull @@ -103,36 +101,28 @@ public void setDescription(@javax.annotation.Nullable String description) { this.description = description; } - public ChatCompletionResponseFormatJsonSchema schema(@javax.annotation.Nullable Map schema) { + public ChatCompletionResponseFormatJsonSchema schema(@javax.annotation.Nullable Object schema) { this.schema = schema; return this; } - public ChatCompletionResponseFormatJsonSchema putSchemaItem(String key, Object schemaItem) { - if (this.schema == null) { - this.schema = new HashMap<>(); - } - this.schema.put(key, schemaItem); - return this; - } - /** - * The schema for the response format, described as a JSON Schema object. + * Get schema * @return schema */ @javax.annotation.Nullable @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) - @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public Map getSchema() { + public Object getSchema() { return schema; } @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) - @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) - public void setSchema(@javax.annotation.Nullable Map schema) { + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setSchema(@javax.annotation.Nullable Object schema) { this.schema = schema; } @@ -222,7 +212,7 @@ public ChatCompletionResponseFormatJsonSchema.Builder description(String descrip this.instance.description = description; return this; } - public ChatCompletionResponseFormatJsonSchema.Builder schema(Map schema) { + public ChatCompletionResponseFormatJsonSchema.Builder schema(Object schema) { this.instance.schema = schema; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprob.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprob.java index ee0951f..33d8862 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprob.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprob.java @@ -47,7 +47,7 @@ public class ChatCompletionTokenLogprob { private List bytes; public static final String JSON_PROPERTY_TOP_LOGPROBS = "top_logprobs"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private List topLogprobs; public ChatCompletionTokenLogprob() { @@ -136,7 +136,7 @@ public void setBytes(@javax.annotation.Nullable List bytes) { this.bytes = bytes; } - public ChatCompletionTokenLogprob topLogprobs(@javax.annotation.Nonnull List topLogprobs) { + public ChatCompletionTokenLogprob topLogprobs(@javax.annotation.Nullable List topLogprobs) { this.topLogprobs = topLogprobs; return this; @@ -154,8 +154,8 @@ public ChatCompletionTokenLogprob addTopLogprobsItem(ChatCompletionTokenLogprobT * Get topLogprobs * @return topLogprobs */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_TOP_LOGPROBS, required = true) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_TOP_LOGPROBS, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) public List getTopLogprobs() { @@ -163,9 +163,9 @@ public List getTopLogprobs() { } - @JsonProperty(value = JSON_PROPERTY_TOP_LOGPROBS, required = true) + @JsonProperty(value = JSON_PROPERTY_TOP_LOGPROBS, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setTopLogprobs(@javax.annotation.Nonnull List topLogprobs) { + public void setTopLogprobs(@javax.annotation.Nullable List topLogprobs) { this.topLogprobs = topLogprobs; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprobTopLogprob.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprobTopLogprob.java index 937b99c..94f43fb 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprobTopLogprob.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ChatCompletionTokenLogprobTopLogprob.java @@ -42,7 +42,7 @@ public class ChatCompletionTokenLogprobTopLogprob { private Double logprob; public static final String JSON_PROPERTY_BYTES = "bytes"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private List bytes; public ChatCompletionTokenLogprobTopLogprob() { @@ -98,7 +98,7 @@ public void setLogprob(@javax.annotation.Nonnull Double logprob) { this.logprob = logprob; } - public ChatCompletionTokenLogprobTopLogprob bytes(@javax.annotation.Nonnull List bytes) { + public ChatCompletionTokenLogprobTopLogprob bytes(@javax.annotation.Nullable List bytes) { this.bytes = bytes; return this; @@ -116,8 +116,8 @@ public ChatCompletionTokenLogprobTopLogprob addBytesItem(Integer bytesItem) { * Get bytes * @return bytes */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_BYTES, required = true) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_BYTES, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) public List getBytes() { @@ -125,9 +125,9 @@ public List getBytes() { } - @JsonProperty(value = JSON_PROPERTY_BYTES, required = true) + @JsonProperty(value = JSON_PROPERTY_BYTES, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setBytes(@javax.annotation.Nonnull List bytes) { + public void setBytes(@javax.annotation.Nullable List bytes) { this.bytes = bytes; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/CompletionTokensDetails.java b/src/main/java/com/volcengine/ark/runtime/models/chat/CompletionTokensDetails.java index e62d4fb..09a5e35 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/CompletionTokensDetails.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/CompletionTokensDetails.java @@ -25,7 +25,8 @@ * CompletionTokensDetails */ @JsonPropertyOrder({ - CompletionTokensDetails.JSON_PROPERTY_REASONING_TOKENS + CompletionTokensDetails.JSON_PROPERTY_REASONING_TOKENS, + CompletionTokensDetails.JSON_PROPERTY_PROVISIONED_TOKENS }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") public class CompletionTokensDetails { @@ -33,6 +34,10 @@ public class CompletionTokensDetails { @javax.annotation.Nonnull private Integer reasoningTokens; + public static final String JSON_PROPERTY_PROVISIONED_TOKENS = "provisioned_tokens"; + @javax.annotation.Nullable + private Integer provisionedTokens; + public CompletionTokensDetails() { } @@ -61,6 +66,31 @@ public void setReasoningTokens(@javax.annotation.Nonnull Integer reasoningTokens this.reasoningTokens = reasoningTokens; } + public CompletionTokensDetails provisionedTokens(@javax.annotation.Nullable Integer provisionedTokens) { + + this.provisionedTokens = provisionedTokens; + return this; + } + + /** + * Completion tokens charged against provisioned throughput after conversion. + * @return provisionedTokens + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_PROVISIONED_TOKENS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public Integer getProvisionedTokens() { + return provisionedTokens; + } + + + @JsonProperty(value = JSON_PROPERTY_PROVISIONED_TOKENS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setProvisionedTokens(@javax.annotation.Nullable Integer provisionedTokens) { + this.provisionedTokens = provisionedTokens; + } + @Override public boolean equals(Object o) { @@ -71,12 +101,13 @@ public boolean equals(Object o) { return false; } CompletionTokensDetails completionTokensDetails = (CompletionTokensDetails) o; - return Objects.equals(this.reasoningTokens, completionTokensDetails.reasoningTokens); + return Objects.equals(this.reasoningTokens, completionTokensDetails.reasoningTokens) && + Objects.equals(this.provisionedTokens, completionTokensDetails.provisionedTokens); } @Override public int hashCode() { - return Objects.hash(reasoningTokens); + return Objects.hash(reasoningTokens, provisionedTokens); } @Override @@ -84,6 +115,7 @@ public String toString() { StringBuilder sb = new StringBuilder(); sb.append("class CompletionTokensDetails {\n"); sb.append(" reasoningTokens: ").append(toIndentedString(reasoningTokens)).append("\n"); + sb.append(" provisionedTokens: ").append(toIndentedString(provisionedTokens)).append("\n"); sb.append("}"); return sb.toString(); } @@ -112,6 +144,10 @@ public CompletionTokensDetails.Builder reasoningTokens(Integer reasoningTokens) this.instance.reasoningTokens = reasoningTokens; return this; } + public CompletionTokensDetails.Builder provisionedTokens(Integer provisionedTokens) { + this.instance.provisionedTokens = provisionedTokens; + return this; + } /** @@ -146,7 +182,8 @@ public static CompletionTokensDetails.Builder builder() { */ public CompletionTokensDetails.Builder toBuilder() { return new CompletionTokensDetails.Builder() - .reasoningTokens(getReasoningTokens()); + .reasoningTokens(getReasoningTokens()) + .provisionedTokens(getProvisionedTokens()); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/PromptTokensDetails.java b/src/main/java/com/volcengine/ark/runtime/models/chat/PromptTokensDetails.java index b828439..6a5161d 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/PromptTokensDetails.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/PromptTokensDetails.java @@ -28,6 +28,7 @@ PromptTokensDetails.JSON_PROPERTY_CACHED_TOKENS, PromptTokensDetails.JSON_PROPERTY_TEXT_TOKENS, PromptTokensDetails.JSON_PROPERTY_IMAGE_TOKENS, + PromptTokensDetails.JSON_PROPERTY_PROVISIONED_TOKENS, PromptTokensDetails.JSON_PROPERTY_AUDIO_TOKENS, PromptTokensDetails.JSON_PROPERTY_AUDIO_CACHED_TOKENS }) @@ -45,6 +46,10 @@ public class PromptTokensDetails { @javax.annotation.Nullable private Integer imageTokens; + public static final String JSON_PROPERTY_PROVISIONED_TOKENS = "provisioned_tokens"; + @javax.annotation.Nullable + private Integer provisionedTokens; + public static final String JSON_PROPERTY_AUDIO_TOKENS = "audio_tokens"; @javax.annotation.Nullable private Integer audioTokens; @@ -131,6 +136,31 @@ public void setImageTokens(@javax.annotation.Nullable Integer imageTokens) { this.imageTokens = imageTokens; } + public PromptTokensDetails provisionedTokens(@javax.annotation.Nullable Integer provisionedTokens) { + + this.provisionedTokens = provisionedTokens; + return this; + } + + /** + * Prompt tokens charged against provisioned throughput after conversion. + * @return provisionedTokens + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_PROVISIONED_TOKENS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public Integer getProvisionedTokens() { + return provisionedTokens; + } + + + @JsonProperty(value = JSON_PROPERTY_PROVISIONED_TOKENS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setProvisionedTokens(@javax.annotation.Nullable Integer provisionedTokens) { + this.provisionedTokens = provisionedTokens; + } + public PromptTokensDetails audioTokens(@javax.annotation.Nullable Integer audioTokens) { this.audioTokens = audioTokens; @@ -194,13 +224,14 @@ public boolean equals(Object o) { return Objects.equals(this.cachedTokens, promptTokensDetails.cachedTokens) && Objects.equals(this.textTokens, promptTokensDetails.textTokens) && Objects.equals(this.imageTokens, promptTokensDetails.imageTokens) && + Objects.equals(this.provisionedTokens, promptTokensDetails.provisionedTokens) && Objects.equals(this.audioTokens, promptTokensDetails.audioTokens) && Objects.equals(this.audioCachedTokens, promptTokensDetails.audioCachedTokens); } @Override public int hashCode() { - return Objects.hash(cachedTokens, textTokens, imageTokens, audioTokens, audioCachedTokens); + return Objects.hash(cachedTokens, textTokens, imageTokens, provisionedTokens, audioTokens, audioCachedTokens); } @Override @@ -210,6 +241,7 @@ public String toString() { sb.append(" cachedTokens: ").append(toIndentedString(cachedTokens)).append("\n"); sb.append(" textTokens: ").append(toIndentedString(textTokens)).append("\n"); sb.append(" imageTokens: ").append(toIndentedString(imageTokens)).append("\n"); + sb.append(" provisionedTokens: ").append(toIndentedString(provisionedTokens)).append("\n"); sb.append(" audioTokens: ").append(toIndentedString(audioTokens)).append("\n"); sb.append(" audioCachedTokens: ").append(toIndentedString(audioCachedTokens)).append("\n"); sb.append("}"); @@ -248,6 +280,10 @@ public PromptTokensDetails.Builder imageTokens(Integer imageTokens) { this.instance.imageTokens = imageTokens; return this; } + public PromptTokensDetails.Builder provisionedTokens(Integer provisionedTokens) { + this.instance.provisionedTokens = provisionedTokens; + return this; + } public PromptTokensDetails.Builder audioTokens(Integer audioTokens) { this.instance.audioTokens = audioTokens; return this; @@ -293,6 +329,7 @@ public PromptTokensDetails.Builder toBuilder() { .cachedTokens(getCachedTokens()) .textTokens(getTextTokens()) .imageTokens(getImageTokens()) + .provisionedTokens(getProvisionedTokens()) .audioTokens(getAudioTokens()) .audioCachedTokens(getAudioCachedTokens()); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/RequestServiceTier.java b/src/main/java/com/volcengine/ark/runtime/models/chat/RequestServiceTier.java index 955d51e..5c0eb86 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/RequestServiceTier.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/RequestServiceTier.java @@ -29,7 +29,9 @@ public enum RequestServiceTier { DEFAULT("default"), - FAST("fast"); + FAST("fast"), + + FLEX("flex"); private String value; diff --git a/src/main/java/com/volcengine/ark/runtime/models/chat/ResponseServiceTier.java b/src/main/java/com/volcengine/ark/runtime/models/chat/ResponseServiceTier.java index 6315427..00b4238 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/chat/ResponseServiceTier.java +++ b/src/main/java/com/volcengine/ark/runtime/models/chat/ResponseServiceTier.java @@ -29,7 +29,9 @@ public enum ResponseServiceTier { SCALE("scale"), - FAST("fast"); + FAST("fast"), + + FLEX("flex"); private String value; diff --git a/src/main/java/com/volcengine/ark/runtime/models/environment/Environment.java b/src/main/java/com/volcengine/ark/runtime/models/environment/Environment.java index b44ae4a..b72aded 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/environment/Environment.java +++ b/src/main/java/com/volcengine/ark/runtime/models/environment/Environment.java @@ -127,7 +127,7 @@ public Environment id(@javax.annotation.Nonnull String id) { } /** - * Environment ID。 + * Environment ID，形如 `env-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/file/FileCreateRequest.java b/src/main/java/com/volcengine/ark/runtime/models/file/FileCreateRequest.java index abdd102..daff8a5 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/file/FileCreateRequest.java +++ b/src/main/java/com/volcengine/ark/runtime/models/file/FileCreateRequest.java @@ -26,6 +26,8 @@ */ @JsonPropertyOrder({ FileCreateRequest.JSON_PROPERTY_PURPOSE, + FileCreateRequest.JSON_PROPERTY_MODEL, + FileCreateRequest.JSON_PROPERTY_DESCRIPTION, FileCreateRequest.JSON_PROPERTY_PREPROCESS_CONFIGS, FileCreateRequest.JSON_PROPERTY_EXPIRE_AT, FileCreateRequest.JSON_PROPERTY_URL, @@ -37,6 +39,14 @@ public class FileCreateRequest { @javax.annotation.Nonnull private Purpose purpose; + public static final String JSON_PROPERTY_MODEL = "model"; + @javax.annotation.Nullable + private String model; + + public static final String JSON_PROPERTY_DESCRIPTION = "description"; + @javax.annotation.Nullable + private String description; + public static final String JSON_PROPERTY_PREPROCESS_CONFIGS = "preprocess_configs"; @javax.annotation.Nullable private PreprocessConfigs preprocessConfigs; @@ -81,6 +91,56 @@ public void setPurpose(@javax.annotation.Nonnull Purpose purpose) { this.purpose = purpose; } + public FileCreateRequest model(@javax.annotation.Nullable String model) { + + this.model = model; + return this; + } + + /** + * Model identifier used to preprocess the file. This top-level field is required and only takes effect when `purpose` is `voice`. + * @return model + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_MODEL, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getModel() { + return model; + } + + + @JsonProperty(value = JSON_PROPERTY_MODEL, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setModel(@javax.annotation.Nullable String model) { + this.model = model; + } + + public FileCreateRequest description(@javax.annotation.Nullable String description) { + + this.description = description; + return this; + } + + /** + * Human-readable file description, limited to 500 characters. + * @return description + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_DESCRIPTION, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getDescription() { + return description; + } + + + @JsonProperty(value = JSON_PROPERTY_DESCRIPTION, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setDescription(@javax.annotation.Nullable String description) { + this.description = description; + } + public FileCreateRequest preprocessConfigs(@javax.annotation.Nullable PreprocessConfigs preprocessConfigs) { this.preprocessConfigs = preprocessConfigs; @@ -113,7 +173,7 @@ public FileCreateRequest expireAt(@javax.annotation.Nullable Long expireAt) { } /** - * Unix timestamp (seconds) after which the file should be purged. Defaults to 7 days from upload when omitted. + * Unix timestamp (seconds) after which the file should be purged. A value of `-1` keeps the file permanently. Defaults to 7 days from upload when omitted. * @return expireAt */ @javax.annotation.Nullable @@ -192,6 +252,8 @@ public boolean equals(Object o) { } FileCreateRequest fileCreateRequest = (FileCreateRequest) o; return Objects.equals(this.purpose, fileCreateRequest.purpose) && + Objects.equals(this.model, fileCreateRequest.model) && + Objects.equals(this.description, fileCreateRequest.description) && Objects.equals(this.preprocessConfigs, fileCreateRequest.preprocessConfigs) && Objects.equals(this.expireAt, fileCreateRequest.expireAt) && Objects.equals(this.url, fileCreateRequest.url) && @@ -200,7 +262,7 @@ public boolean equals(Object o) { @Override public int hashCode() { - return Objects.hash(purpose, preprocessConfigs, expireAt, url, tos); + return Objects.hash(purpose, model, description, preprocessConfigs, expireAt, url, tos); } @Override @@ -208,6 +270,8 @@ public String toString() { StringBuilder sb = new StringBuilder(); sb.append("class FileCreateRequest {\n"); sb.append(" purpose: ").append(toIndentedString(purpose)).append("\n"); + sb.append(" model: ").append(toIndentedString(model)).append("\n"); + sb.append(" description: ").append(toIndentedString(description)).append("\n"); sb.append(" preprocessConfigs: ").append(toIndentedString(preprocessConfigs)).append("\n"); sb.append(" expireAt: ").append(toIndentedString(expireAt)).append("\n"); sb.append(" url: ").append(toIndentedString(url)).append("\n"); @@ -240,6 +304,14 @@ public FileCreateRequest.Builder purpose(Purpose purpose) { this.instance.purpose = purpose; return this; } + public FileCreateRequest.Builder model(String model) { + this.instance.model = model; + return this; + } + public FileCreateRequest.Builder description(String description) { + this.instance.description = description; + return this; + } public FileCreateRequest.Builder preprocessConfigs(PreprocessConfigs preprocessConfigs) { this.instance.preprocessConfigs = preprocessConfigs; return this; @@ -291,6 +363,8 @@ public static FileCreateRequest.Builder builder() { public FileCreateRequest.Builder toBuilder() { return new FileCreateRequest.Builder() .purpose(getPurpose()) + .model(getModel()) + .description(getDescription()) .preprocessConfigs(getPreprocessConfigs()) .expireAt(getExpireAt()) .url(getUrl()) diff --git a/src/main/java/com/volcengine/ark/runtime/models/file/FileObject.java b/src/main/java/com/volcengine/ark/runtime/models/file/FileObject.java index 95ef6fe..92c89e9 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/file/FileObject.java +++ b/src/main/java/com/volcengine/ark/runtime/models/file/FileObject.java @@ -30,6 +30,8 @@ FileObject.JSON_PROPERTY_OBJECT, FileObject.JSON_PROPERTY_ID, FileObject.JSON_PROPERTY_PURPOSE, + FileObject.JSON_PROPERTY_MODEL, + FileObject.JSON_PROPERTY_DESCRIPTION, FileObject.JSON_PROPERTY_FILENAME, FileObject.JSON_PROPERTY_BYTES, FileObject.JSON_PROPERTY_MIME_TYPE, @@ -87,6 +89,14 @@ public static ObjectEnum fromValue(String value) { @javax.annotation.Nonnull private Purpose purpose; + public static final String JSON_PROPERTY_MODEL = "model"; + @javax.annotation.Nullable + private String model; + + public static final String JSON_PROPERTY_DESCRIPTION = "description"; + @javax.annotation.Nullable + private String description; + public static final String JSON_PROPERTY_FILENAME = "filename"; @javax.annotation.Nonnull private String filename; @@ -201,6 +211,56 @@ public void setPurpose(@javax.annotation.Nonnull Purpose purpose) { this.purpose = purpose; } + public FileObject model(@javax.annotation.Nullable String model) { + + this.model = model; + return this; + } + + /** + * Model identifier used to preprocess the file, when one was provided. + * @return model + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_MODEL, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getModel() { + return model; + } + + + @JsonProperty(value = JSON_PROPERTY_MODEL, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setModel(@javax.annotation.Nullable String model) { + this.model = model; + } + + public FileObject description(@javax.annotation.Nullable String description) { + + this.description = description; + return this; + } + + /** + * User-provided description for the file, when one was provided. + * @return description + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_DESCRIPTION, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getDescription() { + return description; + } + + + @JsonProperty(value = JSON_PROPERTY_DESCRIPTION, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setDescription(@javax.annotation.Nullable String description) { + this.description = description; + } + public FileObject filename(@javax.annotation.Nonnull String filename) { this.filename = filename; @@ -308,7 +368,7 @@ public FileObject expireAt(@javax.annotation.Nonnull Long expireAt) { } /** - * Unix timestamp (seconds) after which the file is purged. + * Unix timestamp (seconds) after which the file is purged; `-1` means permanent. * @return expireAt */ @javax.annotation.Nonnull @@ -439,6 +499,8 @@ public boolean equals(Object o) { return Objects.equals(this._object, fileObject._object) && Objects.equals(this.id, fileObject.id) && Objects.equals(this.purpose, fileObject.purpose) && + Objects.equals(this.model, fileObject.model) && + Objects.equals(this.description, fileObject.description) && Objects.equals(this.filename, fileObject.filename) && Objects.equals(this.bytes, fileObject.bytes) && Objects.equals(this.mimeType, fileObject.mimeType) && @@ -452,7 +514,7 @@ public boolean equals(Object o) { @Override public int hashCode() { - return Objects.hash(_object, id, purpose, filename, bytes, mimeType, createdAt, expireAt, status, downloadUrl, error, preprocessConfigs); + return Objects.hash(_object, id, purpose, model, description, filename, bytes, mimeType, createdAt, expireAt, status, downloadUrl, error, preprocessConfigs); } @Override @@ -462,6 +524,8 @@ public String toString() { sb.append(" _object: ").append(toIndentedString(_object)).append("\n"); sb.append(" id: ").append(toIndentedString(id)).append("\n"); sb.append(" purpose: ").append(toIndentedString(purpose)).append("\n"); + sb.append(" model: ").append(toIndentedString(model)).append("\n"); + sb.append(" description: ").append(toIndentedString(description)).append("\n"); sb.append(" filename: ").append(toIndentedString(filename)).append("\n"); sb.append(" bytes: ").append(toIndentedString(bytes)).append("\n"); sb.append(" mimeType: ").append(toIndentedString(mimeType)).append("\n"); @@ -507,6 +571,14 @@ public FileObject.Builder purpose(Purpose purpose) { this.instance.purpose = purpose; return this; } + public FileObject.Builder model(String model) { + this.instance.model = model; + return this; + } + public FileObject.Builder description(String description) { + this.instance.description = description; + return this; + } public FileObject.Builder filename(String filename) { this.instance.filename = filename; return this; @@ -580,6 +652,8 @@ public FileObject.Builder toBuilder() { ._object(getObject()) .id(getId()) .purpose(getPurpose()) + .model(getModel()) + .description(getDescription()) .filename(getFilename()) .bytes(getBytes()) .mimeType(getMimeType()) diff --git a/src/main/java/com/volcengine/ark/runtime/models/file/Purpose.java b/src/main/java/com/volcengine/ark/runtime/models/file/Purpose.java index b01b46d..74be258 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/file/Purpose.java +++ b/src/main/java/com/volcengine/ark/runtime/models/file/Purpose.java @@ -27,7 +27,9 @@ public enum Purpose { USER_DATA("user_data"), - AGENT("agent"); + AGENT("agent"), + + VOICE("voice"); private String value; diff --git a/src/main/java/com/volcengine/ark/runtime/models/memory/Memory.java b/src/main/java/com/volcengine/ark/runtime/models/memory/Memory.java index 5c05959..a97470a 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/memory/Memory.java +++ b/src/main/java/com/volcengine/ark/runtime/models/memory/Memory.java @@ -128,7 +128,7 @@ public Memory id(@javax.annotation.Nonnull String id) { } /** - * Memory ID。 + * Memory ID，形如 `mem-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/memory/MemoryStore.java b/src/main/java/com/volcengine/ark/runtime/models/memory/MemoryStore.java index 68d2079..e3f0c9b 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/memory/MemoryStore.java +++ b/src/main/java/com/volcengine/ark/runtime/models/memory/MemoryStore.java @@ -129,7 +129,7 @@ public MemoryStore id(@javax.annotation.Nonnull String id) { } /** - * MemoryStore ID。 + * MemoryStore ID，形如 `memstore-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlock.java b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlock.java index 3932568..c847344 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlock.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlock.java @@ -22,11 +22,11 @@ @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") @JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "type", visible = true) @JsonSubTypes({ - @JsonSubTypes.Type(value = MessagesResponseContentPartServerToolUse.class, name = "server_tool_use"), - @JsonSubTypes.Type(value = MessagesResponseContentPartText.class, name = "text"), - @JsonSubTypes.Type(value = MessagesResponseContentPartThinking.class, name = "thinking"), - @JsonSubTypes.Type(value = MessagesResponseContentPartToolUse.class, name = "tool_use"), - @JsonSubTypes.Type(value = MessagesResponseContentPartWebSearchToolResult.class, name = "web_search_tool_result"), + @JsonSubTypes.Type(value = ContentBlockStartContentBlockServerToolUse.class, name = "server_tool_use"), + @JsonSubTypes.Type(value = ContentBlockStartContentBlockText.class, name = "text"), + @JsonSubTypes.Type(value = ContentBlockStartContentBlockThinking.class, name = "thinking"), + @JsonSubTypes.Type(value = ContentBlockStartContentBlockToolUse.class, name = "tool_use"), + @JsonSubTypes.Type(value = ContentBlockStartContentBlockWebSearchToolResult.class, name = "web_search_tool_result"), }) public interface ContentBlockStartContentBlock { diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockServerToolUse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockServerToolUse.java new file mode 100644 index 0000000..7312fd8 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockServerToolUse.java @@ -0,0 +1,274 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.HashMap; +import java.util.Map; +import java.util.Objects; + +/** + * ContentBlockStartContentBlockServerToolUse + */ +@JsonPropertyOrder({ + ContentBlockStartContentBlockServerToolUse.JSON_PROPERTY_TYPE, + ContentBlockStartContentBlockServerToolUse.JSON_PROPERTY_ID, + ContentBlockStartContentBlockServerToolUse.JSON_PROPERTY_NAME, + ContentBlockStartContentBlockServerToolUse.JSON_PROPERTY_INPUT +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ContentBlockStartContentBlockServerToolUse implements ContentBlockStartContentBlock { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.SERVER_TOOL_USE; + + public static final String JSON_PROPERTY_ID = "id"; + @javax.annotation.Nullable + private String id; + + public static final String JSON_PROPERTY_NAME = "name"; + @javax.annotation.Nullable + private String name; + + public static final String JSON_PROPERTY_INPUT = "input"; + @javax.annotation.Nullable + private Map input; + + public ContentBlockStartContentBlockServerToolUse() { + } + + public ContentBlockStartContentBlockServerToolUse type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ContentBlockStartContentBlockType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + this.type = type; + } + + public ContentBlockStartContentBlockServerToolUse id(@javax.annotation.Nullable String id) { + + this.id = id; + return this; + } + + /** + * Get id + * @return id + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getId() { + return id; + } + + + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setId(@javax.annotation.Nullable String id) { + this.id = id; + } + + public ContentBlockStartContentBlockServerToolUse name(@javax.annotation.Nullable String name) { + + this.name = name; + return this; + } + + /** + * Get name + * @return name + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getName() { + return name; + } + + + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setName(@javax.annotation.Nullable String name) { + this.name = name; + } + + public ContentBlockStartContentBlockServerToolUse input(@javax.annotation.Nullable Map input) { + + this.input = input; + return this; + } + + public ContentBlockStartContentBlockServerToolUse putInputItem(String key, Object inputItem) { + if (this.input == null) { + this.input = new HashMap<>(); + } + this.input.put(key, inputItem); + return this; + } + + /** + * Get input + * @return input + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_INPUT, required = false) + @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) + + public Map getInput() { + return input; + } + + + @JsonProperty(value = JSON_PROPERTY_INPUT, required = false) + @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) + public void setInput(@javax.annotation.Nullable Map input) { + this.input = input; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ContentBlockStartContentBlockServerToolUse contentBlockStartContentBlockServerToolUse = (ContentBlockStartContentBlockServerToolUse) o; + return Objects.equals(this.type, contentBlockStartContentBlockServerToolUse.type) && + Objects.equals(this.id, contentBlockStartContentBlockServerToolUse.id) && + Objects.equals(this.name, contentBlockStartContentBlockServerToolUse.name) && + Objects.equals(this.input, contentBlockStartContentBlockServerToolUse.input); + } + + @Override + public int hashCode() { + return Objects.hash(type, id, name, input); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ContentBlockStartContentBlockServerToolUse {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" id: ").append(toIndentedString(id)).append("\n"); + sb.append(" name: ").append(toIndentedString(name)).append("\n"); + sb.append(" input: ").append(toIndentedString(input)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ContentBlockStartContentBlockServerToolUse instance; + + public Builder() { + this(new ContentBlockStartContentBlockServerToolUse()); + } + + protected Builder(ContentBlockStartContentBlockServerToolUse instance) { + this.instance = instance; + } + + public ContentBlockStartContentBlockServerToolUse.Builder type(ContentBlockStartContentBlockType type) { + this.instance.type = type; + return this; + } + public ContentBlockStartContentBlockServerToolUse.Builder id(String id) { + this.instance.id = id; + return this; + } + public ContentBlockStartContentBlockServerToolUse.Builder name(String name) { + this.instance.name = name; + return this; + } + public ContentBlockStartContentBlockServerToolUse.Builder input(Map input) { + this.instance.input = input; + return this; + } + + + /** + * returns a built ContentBlockStartContentBlockServerToolUse instance. + * + * The builder is not reusable. + */ + public ContentBlockStartContentBlockServerToolUse build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ContentBlockStartContentBlockServerToolUse.Builder builder() { + return new ContentBlockStartContentBlockServerToolUse.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ContentBlockStartContentBlockServerToolUse.Builder toBuilder() { + return new ContentBlockStartContentBlockServerToolUse.Builder() + .type(getType()) + .id(getId()) + .name(getName()) + .input(getInput()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockText.java b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockText.java new file mode 100644 index 0000000..4579cdc --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockText.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * ContentBlockStartContentBlockText + */ +@JsonPropertyOrder({ + ContentBlockStartContentBlockText.JSON_PROPERTY_TYPE, + ContentBlockStartContentBlockText.JSON_PROPERTY_TEXT +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ContentBlockStartContentBlockText implements ContentBlockStartContentBlock { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.TEXT; + + public static final String JSON_PROPERTY_TEXT = "text"; + @javax.annotation.Nullable + private String text; + + public ContentBlockStartContentBlockText() { + } + + public ContentBlockStartContentBlockText type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ContentBlockStartContentBlockType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + this.type = type; + } + + public ContentBlockStartContentBlockText text(@javax.annotation.Nullable String text) { + + this.text = text; + return this; + } + + /** + * Get text + * @return text + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_TEXT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getText() { + return text; + } + + + @JsonProperty(value = JSON_PROPERTY_TEXT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setText(@javax.annotation.Nullable String text) { + this.text = text; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ContentBlockStartContentBlockText contentBlockStartContentBlockText = (ContentBlockStartContentBlockText) o; + return Objects.equals(this.type, contentBlockStartContentBlockText.type) && + Objects.equals(this.text, contentBlockStartContentBlockText.text); + } + + @Override + public int hashCode() { + return Objects.hash(type, text); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ContentBlockStartContentBlockText {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" text: ").append(toIndentedString(text)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ContentBlockStartContentBlockText instance; + + public Builder() { + this(new ContentBlockStartContentBlockText()); + } + + protected Builder(ContentBlockStartContentBlockText instance) { + this.instance = instance; + } + + public ContentBlockStartContentBlockText.Builder type(ContentBlockStartContentBlockType type) { + this.instance.type = type; + return this; + } + public ContentBlockStartContentBlockText.Builder text(String text) { + this.instance.text = text; + return this; + } + + + /** + * returns a built ContentBlockStartContentBlockText instance. + * + * The builder is not reusable. + */ + public ContentBlockStartContentBlockText build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ContentBlockStartContentBlockText.Builder builder() { + return new ContentBlockStartContentBlockText.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ContentBlockStartContentBlockText.Builder toBuilder() { + return new ContentBlockStartContentBlockText.Builder() + .type(getType()) + .text(getText()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearThinking.java b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockThinking.java similarity index 53% rename from src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearThinking.java rename to src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockThinking.java index 1182da5..8b49b78 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearThinking.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockThinking.java @@ -22,26 +22,26 @@ import java.util.Objects; /** - * MessagesContextManagementClearThinking + * ContentBlockStartContentBlockThinking */ @JsonPropertyOrder({ - MessagesContextManagementClearThinking.JSON_PROPERTY_TYPE, - MessagesContextManagementClearThinking.JSON_PROPERTY_KEEP + ContentBlockStartContentBlockThinking.JSON_PROPERTY_TYPE, + ContentBlockStartContentBlockThinking.JSON_PROPERTY_THINKING }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesContextManagementClearThinking implements MessagesContextManagementEdit { +public class ContentBlockStartContentBlockThinking implements ContentBlockStartContentBlock { public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private MessagesContextManagementEditType type = MessagesContextManagementEditType.CLEAR_THINKING; + private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.THINKING; - public static final String JSON_PROPERTY_KEEP = "keep"; + public static final String JSON_PROPERTY_THINKING = "thinking"; @javax.annotation.Nullable - private MessagesContextManagementKeep keep; + private String thinking; - public MessagesContextManagementClearThinking() { + public ContentBlockStartContentBlockThinking() { } - public MessagesContextManagementClearThinking type(@javax.annotation.Nonnull MessagesContextManagementEditType type) { + public ContentBlockStartContentBlockThinking type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { this.type = type; return this; @@ -55,40 +55,40 @@ public MessagesContextManagementClearThinking type(@javax.annotation.Nonnull Mes @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public MessagesContextManagementEditType getType() { + public ContentBlockStartContentBlockType getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull MessagesContextManagementEditType type) { + public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { this.type = type; } - public MessagesContextManagementClearThinking keep(@javax.annotation.Nullable MessagesContextManagementKeep keep) { + public ContentBlockStartContentBlockThinking thinking(@javax.annotation.Nullable String thinking) { - this.keep = keep; + this.thinking = thinking; return this; } /** - * Get keep - * @return keep + * Get thinking + * @return thinking */ @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_KEEP, required = false) + @JsonProperty(value = JSON_PROPERTY_THINKING, required = false) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public MessagesContextManagementKeep getKeep() { - return keep; + public String getThinking() { + return thinking; } - @JsonProperty(value = JSON_PROPERTY_KEEP, required = false) + @JsonProperty(value = JSON_PROPERTY_THINKING, required = false) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setKeep(@javax.annotation.Nullable MessagesContextManagementKeep keep) { - this.keep = keep; + public void setThinking(@javax.annotation.Nullable String thinking) { + this.thinking = thinking; } @@ -100,22 +100,22 @@ public boolean equals(Object o) { if (o == null || getClass() != o.getClass()) { return false; } - MessagesContextManagementClearThinking messagesContextManagementClearThinking = (MessagesContextManagementClearThinking) o; - return Objects.equals(this.type, messagesContextManagementClearThinking.type) && - Objects.equals(this.keep, messagesContextManagementClearThinking.keep); + ContentBlockStartContentBlockThinking contentBlockStartContentBlockThinking = (ContentBlockStartContentBlockThinking) o; + return Objects.equals(this.type, contentBlockStartContentBlockThinking.type) && + Objects.equals(this.thinking, contentBlockStartContentBlockThinking.thinking); } @Override public int hashCode() { - return Objects.hash(type, keep); + return Objects.hash(type, thinking); } @Override public String toString() { StringBuilder sb = new StringBuilder(); - sb.append("class MessagesContextManagementClearThinking {\n"); + sb.append("class ContentBlockStartContentBlockThinking {\n"); sb.append(" type: ").append(toIndentedString(type)).append("\n"); - sb.append(" keep: ").append(toIndentedString(keep)).append("\n"); + sb.append(" thinking: ").append(toIndentedString(thinking)).append("\n"); sb.append("}"); return sb.toString(); } @@ -130,32 +130,32 @@ private String toIndentedString(Object o) { public static class Builder { - private MessagesContextManagementClearThinking instance; + private ContentBlockStartContentBlockThinking instance; public Builder() { - this(new MessagesContextManagementClearThinking()); + this(new ContentBlockStartContentBlockThinking()); } - protected Builder(MessagesContextManagementClearThinking instance) { + protected Builder(ContentBlockStartContentBlockThinking instance) { this.instance = instance; } - public MessagesContextManagementClearThinking.Builder type(MessagesContextManagementEditType type) { + public ContentBlockStartContentBlockThinking.Builder type(ContentBlockStartContentBlockType type) { this.instance.type = type; return this; } - public MessagesContextManagementClearThinking.Builder keep(MessagesContextManagementKeep keep) { - this.instance.keep = keep; + public ContentBlockStartContentBlockThinking.Builder thinking(String thinking) { + this.instance.thinking = thinking; return this; } /** - * returns a built MessagesContextManagementClearThinking instance. + * returns a built ContentBlockStartContentBlockThinking instance. * * The builder is not reusable. */ - public MessagesContextManagementClearThinking build() { + public ContentBlockStartContentBlockThinking build() { try { return this.instance; } finally { @@ -173,17 +173,17 @@ public String toString() { /** * Create a builder with no initialized field. */ - public static MessagesContextManagementClearThinking.Builder builder() { - return new MessagesContextManagementClearThinking.Builder(); + public static ContentBlockStartContentBlockThinking.Builder builder() { + return new ContentBlockStartContentBlockThinking.Builder(); } /** * Create a builder with a shallow copy of this instance. */ - public MessagesContextManagementClearThinking.Builder toBuilder() { - return new MessagesContextManagementClearThinking.Builder() + public ContentBlockStartContentBlockThinking.Builder toBuilder() { + return new ContentBlockStartContentBlockThinking.Builder() .type(getType()) - .keep(getKeep()); + .thinking(getThinking()); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockToolUse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockToolUse.java new file mode 100644 index 0000000..9b901ff --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockToolUse.java @@ -0,0 +1,274 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.HashMap; +import java.util.Map; +import java.util.Objects; + +/** + * ContentBlockStartContentBlockToolUse + */ +@JsonPropertyOrder({ + ContentBlockStartContentBlockToolUse.JSON_PROPERTY_TYPE, + ContentBlockStartContentBlockToolUse.JSON_PROPERTY_ID, + ContentBlockStartContentBlockToolUse.JSON_PROPERTY_NAME, + ContentBlockStartContentBlockToolUse.JSON_PROPERTY_INPUT +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ContentBlockStartContentBlockToolUse implements ContentBlockStartContentBlock { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.TOOL_USE; + + public static final String JSON_PROPERTY_ID = "id"; + @javax.annotation.Nullable + private String id; + + public static final String JSON_PROPERTY_NAME = "name"; + @javax.annotation.Nullable + private String name; + + public static final String JSON_PROPERTY_INPUT = "input"; + @javax.annotation.Nullable + private Map input; + + public ContentBlockStartContentBlockToolUse() { + } + + public ContentBlockStartContentBlockToolUse type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ContentBlockStartContentBlockType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + this.type = type; + } + + public ContentBlockStartContentBlockToolUse id(@javax.annotation.Nullable String id) { + + this.id = id; + return this; + } + + /** + * Get id + * @return id + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getId() { + return id; + } + + + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setId(@javax.annotation.Nullable String id) { + this.id = id; + } + + public ContentBlockStartContentBlockToolUse name(@javax.annotation.Nullable String name) { + + this.name = name; + return this; + } + + /** + * Get name + * @return name + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getName() { + return name; + } + + + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setName(@javax.annotation.Nullable String name) { + this.name = name; + } + + public ContentBlockStartContentBlockToolUse input(@javax.annotation.Nullable Map input) { + + this.input = input; + return this; + } + + public ContentBlockStartContentBlockToolUse putInputItem(String key, Object inputItem) { + if (this.input == null) { + this.input = new HashMap<>(); + } + this.input.put(key, inputItem); + return this; + } + + /** + * Get input + * @return input + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_INPUT, required = false) + @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) + + public Map getInput() { + return input; + } + + + @JsonProperty(value = JSON_PROPERTY_INPUT, required = false) + @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) + public void setInput(@javax.annotation.Nullable Map input) { + this.input = input; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ContentBlockStartContentBlockToolUse contentBlockStartContentBlockToolUse = (ContentBlockStartContentBlockToolUse) o; + return Objects.equals(this.type, contentBlockStartContentBlockToolUse.type) && + Objects.equals(this.id, contentBlockStartContentBlockToolUse.id) && + Objects.equals(this.name, contentBlockStartContentBlockToolUse.name) && + Objects.equals(this.input, contentBlockStartContentBlockToolUse.input); + } + + @Override + public int hashCode() { + return Objects.hash(type, id, name, input); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ContentBlockStartContentBlockToolUse {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" id: ").append(toIndentedString(id)).append("\n"); + sb.append(" name: ").append(toIndentedString(name)).append("\n"); + sb.append(" input: ").append(toIndentedString(input)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ContentBlockStartContentBlockToolUse instance; + + public Builder() { + this(new ContentBlockStartContentBlockToolUse()); + } + + protected Builder(ContentBlockStartContentBlockToolUse instance) { + this.instance = instance; + } + + public ContentBlockStartContentBlockToolUse.Builder type(ContentBlockStartContentBlockType type) { + this.instance.type = type; + return this; + } + public ContentBlockStartContentBlockToolUse.Builder id(String id) { + this.instance.id = id; + return this; + } + public ContentBlockStartContentBlockToolUse.Builder name(String name) { + this.instance.name = name; + return this; + } + public ContentBlockStartContentBlockToolUse.Builder input(Map input) { + this.instance.input = input; + return this; + } + + + /** + * returns a built ContentBlockStartContentBlockToolUse instance. + * + * The builder is not reusable. + */ + public ContentBlockStartContentBlockToolUse build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ContentBlockStartContentBlockToolUse.Builder builder() { + return new ContentBlockStartContentBlockToolUse.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ContentBlockStartContentBlockToolUse.Builder toBuilder() { + return new ContentBlockStartContentBlockToolUse.Builder() + .type(getType()) + .id(getId()) + .name(getName()) + .input(getInput()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockWebSearchToolResult.java b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockWebSearchToolResult.java new file mode 100644 index 0000000..12477aa --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/ContentBlockStartContentBlockWebSearchToolResult.java @@ -0,0 +1,264 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * A web-search result is emitted atomically in the start event, without deltas. + */ +@JsonPropertyOrder({ + ContentBlockStartContentBlockWebSearchToolResult.JSON_PROPERTY_TYPE, + ContentBlockStartContentBlockWebSearchToolResult.JSON_PROPERTY_TOOL_USE_ID, + ContentBlockStartContentBlockWebSearchToolResult.JSON_PROPERTY_CONTENT, + ContentBlockStartContentBlockWebSearchToolResult.JSON_PROPERTY_CALLER +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class ContentBlockStartContentBlockWebSearchToolResult implements ContentBlockStartContentBlock { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.WEB_SEARCH_TOOL_RESULT; + + public static final String JSON_PROPERTY_TOOL_USE_ID = "tool_use_id"; + @javax.annotation.Nullable + private String toolUseId; + + public static final String JSON_PROPERTY_CONTENT = "content"; + @javax.annotation.Nullable + private MessagesWebSearchToolResultContent content; + + public static final String JSON_PROPERTY_CALLER = "caller"; + @javax.annotation.Nullable + private MessagesServerToolCaller caller; + + public ContentBlockStartContentBlockWebSearchToolResult() { + } + + public ContentBlockStartContentBlockWebSearchToolResult type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public ContentBlockStartContentBlockType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + this.type = type; + } + + public ContentBlockStartContentBlockWebSearchToolResult toolUseId(@javax.annotation.Nullable String toolUseId) { + + this.toolUseId = toolUseId; + return this; + } + + /** + * Get toolUseId + * @return toolUseId + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_TOOL_USE_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public String getToolUseId() { + return toolUseId; + } + + + @JsonProperty(value = JSON_PROPERTY_TOOL_USE_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setToolUseId(@javax.annotation.Nullable String toolUseId) { + this.toolUseId = toolUseId; + } + + public ContentBlockStartContentBlockWebSearchToolResult content(@javax.annotation.Nullable MessagesWebSearchToolResultContent content) { + + this.content = content; + return this; + } + + /** + * Get content + * @return content + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public MessagesWebSearchToolResultContent getContent() { + return content; + } + + + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setContent(@javax.annotation.Nullable MessagesWebSearchToolResultContent content) { + this.content = content; + } + + public ContentBlockStartContentBlockWebSearchToolResult caller(@javax.annotation.Nullable MessagesServerToolCaller caller) { + + this.caller = caller; + return this; + } + + /** + * Get caller + * @return caller + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CALLER, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public MessagesServerToolCaller getCaller() { + return caller; + } + + + @JsonProperty(value = JSON_PROPERTY_CALLER, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setCaller(@javax.annotation.Nullable MessagesServerToolCaller caller) { + this.caller = caller; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + ContentBlockStartContentBlockWebSearchToolResult contentBlockStartContentBlockWebSearchToolResult = (ContentBlockStartContentBlockWebSearchToolResult) o; + return Objects.equals(this.type, contentBlockStartContentBlockWebSearchToolResult.type) && + Objects.equals(this.toolUseId, contentBlockStartContentBlockWebSearchToolResult.toolUseId) && + Objects.equals(this.content, contentBlockStartContentBlockWebSearchToolResult.content) && + Objects.equals(this.caller, contentBlockStartContentBlockWebSearchToolResult.caller); + } + + @Override + public int hashCode() { + return Objects.hash(type, toolUseId, content, caller); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class ContentBlockStartContentBlockWebSearchToolResult {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" toolUseId: ").append(toIndentedString(toolUseId)).append("\n"); + sb.append(" content: ").append(toIndentedString(content)).append("\n"); + sb.append(" caller: ").append(toIndentedString(caller)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private ContentBlockStartContentBlockWebSearchToolResult instance; + + public Builder() { + this(new ContentBlockStartContentBlockWebSearchToolResult()); + } + + protected Builder(ContentBlockStartContentBlockWebSearchToolResult instance) { + this.instance = instance; + } + + public ContentBlockStartContentBlockWebSearchToolResult.Builder type(ContentBlockStartContentBlockType type) { + this.instance.type = type; + return this; + } + public ContentBlockStartContentBlockWebSearchToolResult.Builder toolUseId(String toolUseId) { + this.instance.toolUseId = toolUseId; + return this; + } + public ContentBlockStartContentBlockWebSearchToolResult.Builder content(MessagesWebSearchToolResultContent content) { + this.instance.content = content; + return this; + } + public ContentBlockStartContentBlockWebSearchToolResult.Builder caller(MessagesServerToolCaller caller) { + this.instance.caller = caller; + return this; + } + + + /** + * returns a built ContentBlockStartContentBlockWebSearchToolResult instance. + * + * The builder is not reusable. + */ + public ContentBlockStartContentBlockWebSearchToolResult build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static ContentBlockStartContentBlockWebSearchToolResult.Builder builder() { + return new ContentBlockStartContentBlockWebSearchToolResult.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public ContentBlockStartContentBlockWebSearchToolResult.Builder toBuilder() { + return new ContentBlockStartContentBlockWebSearchToolResult.Builder() + .type(getType()) + .toolUseId(getToolUseId()) + .content(getContent()) + .caller(getCaller()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSource.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSource.java index bb67396..e2ca625 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSource.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSource.java @@ -16,249 +16,18 @@ package com.volcengine.ark.runtime.models.messages; -import com.fasterxml.jackson.annotation.JsonInclude; -import com.fasterxml.jackson.annotation.JsonProperty; -import com.fasterxml.jackson.annotation.JsonPropertyOrder; -import java.util.Objects; +import com.fasterxml.jackson.annotation.JsonSubTypes; +import com.fasterxml.jackson.annotation.JsonTypeInfo; -/** - * MessagesContentPartDocumentSource - */ -@JsonPropertyOrder({ - MessagesContentPartDocumentSource.JSON_PROPERTY_TYPE, - MessagesContentPartDocumentSource.JSON_PROPERTY_URL, - MessagesContentPartDocumentSource.JSON_PROPERTY_DATA, - MessagesContentPartDocumentSource.JSON_PROPERTY_CONTENT -}) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesContentPartDocumentSource { - public static final String JSON_PROPERTY_TYPE = "type"; - @javax.annotation.Nonnull - private MessagesDocumentSourceType type; - - public static final String JSON_PROPERTY_URL = "url"; - @javax.annotation.Nullable - private String url; - - public static final String JSON_PROPERTY_DATA = "data"; - @javax.annotation.Nullable - private String data; - - public static final String JSON_PROPERTY_CONTENT = "content"; - @javax.annotation.Nullable - private MessagesMessageContent content; - - public MessagesContentPartDocumentSource() { - } - - public MessagesContentPartDocumentSource type(@javax.annotation.Nonnull MessagesDocumentSourceType type) { - - this.type = type; - return this; - } - - /** - * How the document is supplied. - * @return type - */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - - public MessagesDocumentSourceType getType() { - return type; - } - - - @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull MessagesDocumentSourceType type) { - this.type = type; - } - - public MessagesContentPartDocumentSource url(@javax.annotation.Nullable String url) { - - this.url = url; - return this; - } - - /** - * A URL of the document when `type` is `url`. - * @return url - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_URL, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - - public String getUrl() { - return url; - } - - - @JsonProperty(value = JSON_PROPERTY_URL, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setUrl(@javax.annotation.Nullable String url) { - this.url = url; - } - - public MessagesContentPartDocumentSource data(@javax.annotation.Nullable String data) { - - this.data = data; - return this; - } - - /** - * Document data for `base64` and `text` sources. - * @return data - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_DATA, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - - public String getData() { - return data; - } - - - @JsonProperty(value = JSON_PROPERTY_DATA, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setData(@javax.annotation.Nullable String data) { - this.data = data; - } - - public MessagesContentPartDocumentSource content(@javax.annotation.Nullable MessagesMessageContent content) { - - this.content = content; - return this; - } - - /** - * Inline document content when `type` is `content`. - * @return content - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - - public MessagesMessageContent getContent() { - return content; - } - - - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setContent(@javax.annotation.Nullable MessagesMessageContent content) { - this.content = content; - } - - - @Override - public boolean equals(Object o) { - if (this == o) { - return true; - } - if (o == null || getClass() != o.getClass()) { - return false; - } - MessagesContentPartDocumentSource messagesContentPartDocumentSource = (MessagesContentPartDocumentSource) o; - return Objects.equals(this.type, messagesContentPartDocumentSource.type) && - Objects.equals(this.url, messagesContentPartDocumentSource.url) && - Objects.equals(this.data, messagesContentPartDocumentSource.data) && - Objects.equals(this.content, messagesContentPartDocumentSource.content); - } - - @Override - public int hashCode() { - return Objects.hash(type, url, data, content); - } - - @Override - public String toString() { - StringBuilder sb = new StringBuilder(); - sb.append("class MessagesContentPartDocumentSource {\n"); - sb.append(" type: ").append(toIndentedString(type)).append("\n"); - sb.append(" url: ").append(toIndentedString(url)).append("\n"); - sb.append(" data: ").append(toIndentedString(data)).append("\n"); - sb.append(" content: ").append(toIndentedString(content)).append("\n"); - sb.append("}"); - return sb.toString(); - } - - /** - * Convert the given object to string with each line indented by 4 spaces - * (except the first line). - */ - private String toIndentedString(Object o) { - return o == null ? "null" : o.toString().replace("\n", "\n "); - } - - public static class Builder { - - private MessagesContentPartDocumentSource instance; - - public Builder() { - this(new MessagesContentPartDocumentSource()); - } - - protected Builder(MessagesContentPartDocumentSource instance) { - this.instance = instance; - } - - public MessagesContentPartDocumentSource.Builder type(MessagesDocumentSourceType type) { - this.instance.type = type; - return this; - } - public MessagesContentPartDocumentSource.Builder url(String url) { - this.instance.url = url; - return this; - } - public MessagesContentPartDocumentSource.Builder data(String data) { - this.instance.data = data; - return this; - } - public MessagesContentPartDocumentSource.Builder content(MessagesMessageContent content) { - this.instance.content = content; - return this; - } - - - /** - * returns a built MessagesContentPartDocumentSource instance. - * - * The builder is not reusable. - */ - public MessagesContentPartDocumentSource build() { - try { - return this.instance; - } finally { - // ensure that this.instance is not reused - this.instance = null; - } - } - - @Override - public String toString() { - return getClass() + "=(" + instance + ")"; - } - } - - /** - * Create a builder with no initialized field. - */ - public static MessagesContentPartDocumentSource.Builder builder() { - return new MessagesContentPartDocumentSource.Builder(); - } - - /** - * Create a builder with a shallow copy of this instance. - */ - public MessagesContentPartDocumentSource.Builder toBuilder() { - return new MessagesContentPartDocumentSource.Builder() - .type(getType()) - .url(getUrl()) - .data(getData()) - .content(getContent()); - } - +@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "type", visible = true) +@JsonSubTypes({ + @JsonSubTypes.Type(value = MessagesContentPartDocumentSourceBase64.class, name = "base64"), + @JsonSubTypes.Type(value = MessagesContentPartDocumentSourceContent.class, name = "content"), + @JsonSubTypes.Type(value = MessagesContentPartDocumentSourceText.class, name = "text"), + @JsonSubTypes.Type(value = MessagesContentPartDocumentSourceUrl.class, name = "url"), +}) +public interface MessagesContentPartDocumentSource { + public MessagesContentPartDocumentSourceType getType(); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceBase64.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceBase64.java new file mode 100644 index 0000000..0aa166a --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceBase64.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesContentPartDocumentSourceBase64 + */ +@JsonPropertyOrder({ + MessagesContentPartDocumentSourceBase64.JSON_PROPERTY_TYPE, + MessagesContentPartDocumentSourceBase64.JSON_PROPERTY_DATA +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesContentPartDocumentSourceBase64 implements MessagesContentPartDocumentSource { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesContentPartDocumentSourceType type = MessagesContentPartDocumentSourceType.BASE64; + + public static final String JSON_PROPERTY_DATA = "data"; + @javax.annotation.Nonnull + private String data; + + public MessagesContentPartDocumentSourceBase64() { + } + + public MessagesContentPartDocumentSourceBase64 type(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesContentPartDocumentSourceType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + this.type = type; + } + + public MessagesContentPartDocumentSourceBase64 data(@javax.annotation.Nonnull String data) { + + this.data = data; + return this; + } + + /** + * Base64-encoded document data. + * @return data + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_DATA, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public String getData() { + return data; + } + + + @JsonProperty(value = JSON_PROPERTY_DATA, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setData(@javax.annotation.Nonnull String data) { + this.data = data; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesContentPartDocumentSourceBase64 messagesContentPartDocumentSourceBase64 = (MessagesContentPartDocumentSourceBase64) o; + return Objects.equals(this.type, messagesContentPartDocumentSourceBase64.type) && + Objects.equals(this.data, messagesContentPartDocumentSourceBase64.data); + } + + @Override + public int hashCode() { + return Objects.hash(type, data); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesContentPartDocumentSourceBase64 {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" data: ").append(toIndentedString(data)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesContentPartDocumentSourceBase64 instance; + + public Builder() { + this(new MessagesContentPartDocumentSourceBase64()); + } + + protected Builder(MessagesContentPartDocumentSourceBase64 instance) { + this.instance = instance; + } + + public MessagesContentPartDocumentSourceBase64.Builder type(MessagesContentPartDocumentSourceType type) { + this.instance.type = type; + return this; + } + public MessagesContentPartDocumentSourceBase64.Builder data(String data) { + this.instance.data = data; + return this; + } + + + /** + * returns a built MessagesContentPartDocumentSourceBase64 instance. + * + * The builder is not reusable. + */ + public MessagesContentPartDocumentSourceBase64 build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesContentPartDocumentSourceBase64.Builder builder() { + return new MessagesContentPartDocumentSourceBase64.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesContentPartDocumentSourceBase64.Builder toBuilder() { + return new MessagesContentPartDocumentSourceBase64.Builder() + .type(getType()) + .data(getData()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceContent.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceContent.java new file mode 100644 index 0000000..6647261 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceContent.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesContentPartDocumentSourceContent + */ +@JsonPropertyOrder({ + MessagesContentPartDocumentSourceContent.JSON_PROPERTY_TYPE, + MessagesContentPartDocumentSourceContent.JSON_PROPERTY_CONTENT +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesContentPartDocumentSourceContent implements MessagesContentPartDocumentSource { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesContentPartDocumentSourceType type = MessagesContentPartDocumentSourceType.CONTENT; + + public static final String JSON_PROPERTY_CONTENT = "content"; + @javax.annotation.Nonnull + private MessagesDocumentContent content; + + public MessagesContentPartDocumentSourceContent() { + } + + public MessagesContentPartDocumentSourceContent type(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesContentPartDocumentSourceType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + this.type = type; + } + + public MessagesContentPartDocumentSourceContent content(@javax.annotation.Nonnull MessagesDocumentContent content) { + + this.content = content; + return this; + } + + /** + * Get content + * @return content + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesDocumentContent getContent() { + return content; + } + + + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setContent(@javax.annotation.Nonnull MessagesDocumentContent content) { + this.content = content; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesContentPartDocumentSourceContent messagesContentPartDocumentSourceContent = (MessagesContentPartDocumentSourceContent) o; + return Objects.equals(this.type, messagesContentPartDocumentSourceContent.type) && + Objects.equals(this.content, messagesContentPartDocumentSourceContent.content); + } + + @Override + public int hashCode() { + return Objects.hash(type, content); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesContentPartDocumentSourceContent {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" content: ").append(toIndentedString(content)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesContentPartDocumentSourceContent instance; + + public Builder() { + this(new MessagesContentPartDocumentSourceContent()); + } + + protected Builder(MessagesContentPartDocumentSourceContent instance) { + this.instance = instance; + } + + public MessagesContentPartDocumentSourceContent.Builder type(MessagesContentPartDocumentSourceType type) { + this.instance.type = type; + return this; + } + public MessagesContentPartDocumentSourceContent.Builder content(MessagesDocumentContent content) { + this.instance.content = content; + return this; + } + + + /** + * returns a built MessagesContentPartDocumentSourceContent instance. + * + * The builder is not reusable. + */ + public MessagesContentPartDocumentSourceContent build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesContentPartDocumentSourceContent.Builder builder() { + return new MessagesContentPartDocumentSourceContent.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesContentPartDocumentSourceContent.Builder toBuilder() { + return new MessagesContentPartDocumentSourceContent.Builder() + .type(getType()) + .content(getContent()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceText.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceText.java new file mode 100644 index 0000000..97d6820 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceText.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesContentPartDocumentSourceText + */ +@JsonPropertyOrder({ + MessagesContentPartDocumentSourceText.JSON_PROPERTY_TYPE, + MessagesContentPartDocumentSourceText.JSON_PROPERTY_DATA +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesContentPartDocumentSourceText implements MessagesContentPartDocumentSource { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesContentPartDocumentSourceType type = MessagesContentPartDocumentSourceType.TEXT; + + public static final String JSON_PROPERTY_DATA = "data"; + @javax.annotation.Nonnull + private String data; + + public MessagesContentPartDocumentSourceText() { + } + + public MessagesContentPartDocumentSourceText type(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesContentPartDocumentSourceType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + this.type = type; + } + + public MessagesContentPartDocumentSourceText data(@javax.annotation.Nonnull String data) { + + this.data = data; + return this; + } + + /** + * Plain-text document data. + * @return data + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_DATA, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public String getData() { + return data; + } + + + @JsonProperty(value = JSON_PROPERTY_DATA, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setData(@javax.annotation.Nonnull String data) { + this.data = data; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesContentPartDocumentSourceText messagesContentPartDocumentSourceText = (MessagesContentPartDocumentSourceText) o; + return Objects.equals(this.type, messagesContentPartDocumentSourceText.type) && + Objects.equals(this.data, messagesContentPartDocumentSourceText.data); + } + + @Override + public int hashCode() { + return Objects.hash(type, data); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesContentPartDocumentSourceText {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" data: ").append(toIndentedString(data)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesContentPartDocumentSourceText instance; + + public Builder() { + this(new MessagesContentPartDocumentSourceText()); + } + + protected Builder(MessagesContentPartDocumentSourceText instance) { + this.instance = instance; + } + + public MessagesContentPartDocumentSourceText.Builder type(MessagesContentPartDocumentSourceType type) { + this.instance.type = type; + return this; + } + public MessagesContentPartDocumentSourceText.Builder data(String data) { + this.instance.data = data; + return this; + } + + + /** + * returns a built MessagesContentPartDocumentSourceText instance. + * + * The builder is not reusable. + */ + public MessagesContentPartDocumentSourceText build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesContentPartDocumentSourceText.Builder builder() { + return new MessagesContentPartDocumentSourceText.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesContentPartDocumentSourceText.Builder toBuilder() { + return new MessagesContentPartDocumentSourceText.Builder() + .type(getType()) + .data(getData()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentSourceType.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceType.java similarity index 73% rename from src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentSourceType.java rename to src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceType.java index 5a52b70..926d235 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentSourceType.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceType.java @@ -21,21 +21,21 @@ import com.fasterxml.jackson.annotation.JsonValue; /** - * Gets or Sets MessagesDocumentSourceType + * Gets or Sets MessagesContentPartDocumentSourceType */ -public enum MessagesDocumentSourceType { +public enum MessagesContentPartDocumentSourceType { BASE64("base64"), - TEXT("text"), + CONTENT("content"), - URL("url"), + TEXT("text"), - CONTENT("content"); + URL("url"); private String value; - MessagesDocumentSourceType(String value) { + MessagesContentPartDocumentSourceType(String value) { this.value = value; } @@ -50,8 +50,8 @@ public String toString() { } @JsonCreator - public static MessagesDocumentSourceType fromValue(String value) { - for (MessagesDocumentSourceType b : MessagesDocumentSourceType.values()) { + public static MessagesContentPartDocumentSourceType fromValue(String value) { + for (MessagesContentPartDocumentSourceType b : MessagesContentPartDocumentSourceType.values()) { if (b.value.equalsIgnoreCase(value)) { return b; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceUrl.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceUrl.java new file mode 100644 index 0000000..dbf4f73 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartDocumentSourceUrl.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesContentPartDocumentSourceUrl + */ +@JsonPropertyOrder({ + MessagesContentPartDocumentSourceUrl.JSON_PROPERTY_TYPE, + MessagesContentPartDocumentSourceUrl.JSON_PROPERTY_URL +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesContentPartDocumentSourceUrl implements MessagesContentPartDocumentSource { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesContentPartDocumentSourceType type = MessagesContentPartDocumentSourceType.URL; + + public static final String JSON_PROPERTY_URL = "url"; + @javax.annotation.Nonnull + private String url; + + public MessagesContentPartDocumentSourceUrl() { + } + + public MessagesContentPartDocumentSourceUrl type(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesContentPartDocumentSourceType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesContentPartDocumentSourceType type) { + this.type = type; + } + + public MessagesContentPartDocumentSourceUrl url(@javax.annotation.Nonnull String url) { + + this.url = url; + return this; + } + + /** + * Get url + * @return url + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_URL, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public String getUrl() { + return url; + } + + + @JsonProperty(value = JSON_PROPERTY_URL, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setUrl(@javax.annotation.Nonnull String url) { + this.url = url; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesContentPartDocumentSourceUrl messagesContentPartDocumentSourceUrl = (MessagesContentPartDocumentSourceUrl) o; + return Objects.equals(this.type, messagesContentPartDocumentSourceUrl.type) && + Objects.equals(this.url, messagesContentPartDocumentSourceUrl.url); + } + + @Override + public int hashCode() { + return Objects.hash(type, url); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesContentPartDocumentSourceUrl {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" url: ").append(toIndentedString(url)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesContentPartDocumentSourceUrl instance; + + public Builder() { + this(new MessagesContentPartDocumentSourceUrl()); + } + + protected Builder(MessagesContentPartDocumentSourceUrl instance) { + this.instance = instance; + } + + public MessagesContentPartDocumentSourceUrl.Builder type(MessagesContentPartDocumentSourceType type) { + this.instance.type = type; + return this; + } + public MessagesContentPartDocumentSourceUrl.Builder url(String url) { + this.instance.url = url; + return this; + } + + + /** + * returns a built MessagesContentPartDocumentSourceUrl instance. + * + * The builder is not reusable. + */ + public MessagesContentPartDocumentSourceUrl build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesContentPartDocumentSourceUrl.Builder builder() { + return new MessagesContentPartDocumentSourceUrl.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesContentPartDocumentSourceUrl.Builder toBuilder() { + return new MessagesContentPartDocumentSourceUrl.Builder() + .type(getType()) + .url(getUrl()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartImageSource.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartImageSource.java index 800ae6d..b5f187d 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartImageSource.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartImageSource.java @@ -93,7 +93,7 @@ public MessagesContentPartImageSource url(@javax.annotation.Nullable String url) } /** - * A URL of the image when `type` is `url`. + * Get url * @return url */ @javax.annotation.Nullable @@ -118,7 +118,7 @@ public MessagesContentPartImageSource mediaType(@javax.annotation.Nullable Strin } /** - * The media type of base64-encoded image data. + * Get mediaType * @return mediaType */ @javax.annotation.Nullable @@ -143,7 +143,7 @@ public MessagesContentPartImageSource data(@javax.annotation.Nullable String dat } /** - * Base64-encoded image data when `type` is `base64`. + * Get data * @return data */ @javax.annotation.Nullable @@ -168,7 +168,7 @@ public MessagesContentPartImageSource fileId(@javax.annotation.Nullable String f } /** - * The blob id of an image uploaded out-of-band. + * Get fileId * @return fileId */ @javax.annotation.Nullable @@ -193,7 +193,7 @@ public MessagesContentPartImageSource isFrame(@javax.annotation.Nullable Boolean } /** - * Whether this image was extracted from a document or video. + * Get isFrame * @return isFrame */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartServerToolUse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartServerToolUse.java index 09ce442..c79aa8d 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartServerToolUse.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartServerToolUse.java @@ -23,7 +23,7 @@ import java.util.Objects; /** - * MessagesContentPartServerToolUse + * Replays a server-managed tool invocation in an assistant message. */ @JsonPropertyOrder({ MessagesContentPartServerToolUse.JSON_PROPERTY_TYPE, @@ -84,7 +84,7 @@ public MessagesContentPartServerToolUse id(@javax.annotation.Nonnull String id) } /** - * The public id of the server-managed tool invocation. + * The non-empty public id of the server-managed tool invocation. * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartThinking.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartThinking.java index 870d557..ebd33c3 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartThinking.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartThinking.java @@ -78,7 +78,7 @@ public MessagesContentPartThinking thinking(@javax.annotation.Nullable String th } /** - * The model's thinking content. + * The model's thinking content. At least one of `thinking` or `signature` is required. * @return thinking */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolResult.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolResult.java index 2fd103f..8f5b0a5 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolResult.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolResult.java @@ -37,11 +37,11 @@ public class MessagesContentPartToolResult implements MessagesContentPart { private ContentPartType type = ContentPartType.TOOL_RESULT; public static final String JSON_PROPERTY_TOOL_USE_ID = "tool_use_id"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private String toolUseId; public static final String JSON_PROPERTY_CONTENT = "content"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private MessagesToolResultContent content; public static final String JSON_PROPERTY_IS_ERROR = "is_error"; @@ -76,53 +76,53 @@ public void setType(@javax.annotation.Nonnull ContentPartType type) { this.type = type; } - public MessagesContentPartToolResult toolUseId(@javax.annotation.Nonnull String toolUseId) { + public MessagesContentPartToolResult toolUseId(@javax.annotation.Nullable String toolUseId) { this.toolUseId = toolUseId; return this; } /** - * The tool invocation this result answers. + * Get toolUseId * @return toolUseId */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_TOOL_USE_ID, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_TOOL_USE_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public String getToolUseId() { return toolUseId; } - @JsonProperty(value = JSON_PROPERTY_TOOL_USE_ID, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setToolUseId(@javax.annotation.Nonnull String toolUseId) { + @JsonProperty(value = JSON_PROPERTY_TOOL_USE_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setToolUseId(@javax.annotation.Nullable String toolUseId) { this.toolUseId = toolUseId; } - public MessagesContentPartToolResult content(@javax.annotation.Nonnull MessagesToolResultContent content) { + public MessagesContentPartToolResult content(@javax.annotation.Nullable MessagesToolResultContent content) { this.content = content; return this; } /** - * The content returned by the tool. + * Get content * @return content */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public MessagesToolResultContent getContent() { return content; } - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setContent(@javax.annotation.Nonnull MessagesToolResultContent content) { + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setContent(@javax.annotation.Nullable MessagesToolResultContent content) { this.content = content; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolUse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolUse.java index dd5c2b1..b2b92b7 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolUse.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartToolUse.java @@ -38,7 +38,7 @@ public class MessagesContentPartToolUse implements MessagesContentPart { private ContentPartType type = ContentPartType.TOOL_USE; public static final String JSON_PROPERTY_ID = "id"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private String id; public static final String JSON_PROPERTY_NAME = "name"; @@ -77,28 +77,28 @@ public void setType(@javax.annotation.Nonnull ContentPartType type) { this.type = type; } - public MessagesContentPartToolUse id(@javax.annotation.Nonnull String id) { + public MessagesContentPartToolUse id(@javax.annotation.Nullable String id) { this.id = id; return this; } /** - * The id of the tool invocation. + * Get id * @return id */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_ID, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public String getId() { return id; } - @JsonProperty(value = JSON_PROPERTY_ID, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setId(@javax.annotation.Nonnull String id) { + @JsonProperty(value = JSON_PROPERTY_ID, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setId(@javax.annotation.Nullable String id) { this.id = id; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartWebSearchToolResult.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartWebSearchToolResult.java index e165f43..e0cf554 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartWebSearchToolResult.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContentPartWebSearchToolResult.java @@ -22,7 +22,7 @@ import java.util.Objects; /** - * MessagesContentPartWebSearchToolResult + * Replays a public search result in an assistant message after its `server_tool_use`. */ @JsonPropertyOrder({ MessagesContentPartWebSearchToolResult.JSON_PROPERTY_TYPE, @@ -41,7 +41,7 @@ public class MessagesContentPartWebSearchToolResult implements MessagesContentPa private String toolUseId; public static final String JSON_PROPERTY_CONTENT = "content"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private MessagesWebSearchToolResultContent content; public static final String JSON_PROPERTY_CALLER = "caller"; @@ -101,7 +101,7 @@ public void setToolUseId(@javax.annotation.Nonnull String toolUseId) { this.toolUseId = toolUseId; } - public MessagesContentPartWebSearchToolResult content(@javax.annotation.Nonnull MessagesWebSearchToolResultContent content) { + public MessagesContentPartWebSearchToolResult content(@javax.annotation.Nullable MessagesWebSearchToolResultContent content) { this.content = content; return this; @@ -111,8 +111,8 @@ public MessagesContentPartWebSearchToolResult content(@javax.annotation.Nonnull * Get content * @return content */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) public MessagesWebSearchToolResultContent getContent() { @@ -120,9 +120,9 @@ public MessagesWebSearchToolResultContent getContent() { } - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setContent(@javax.annotation.Nonnull MessagesWebSearchToolResultContent content) { + public void setContent(@javax.annotation.Nullable MessagesWebSearchToolResultContent content) { this.content = content; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUses.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUses.java deleted file mode 100644 index f89160a..0000000 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUses.java +++ /dev/null @@ -1,311 +0,0 @@ -// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. -// SPDX-License-Identifier: Apache-2.0 - -/* - * Ark Messages API - * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) - * - * The version of the OpenAPI document: 0.1.0 - * - * - * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). - * https://openapi-generator.tech - * Do not edit the class manually. - */ - - -package com.volcengine.ark.runtime.models.messages; - -import com.fasterxml.jackson.annotation.JsonInclude; -import com.fasterxml.jackson.annotation.JsonProperty; -import com.fasterxml.jackson.annotation.JsonPropertyOrder; -import java.util.ArrayList; -import java.util.List; -import java.util.Objects; - -/** - * MessagesContextManagementClearToolUses - */ -@JsonPropertyOrder({ - MessagesContextManagementClearToolUses.JSON_PROPERTY_TYPE, - MessagesContextManagementClearToolUses.JSON_PROPERTY_KEEP, - MessagesContextManagementClearToolUses.JSON_PROPERTY_EXCLUDE_TOOLS, - MessagesContextManagementClearToolUses.JSON_PROPERTY_CLEAR_TOOL_INPUTS, - MessagesContextManagementClearToolUses.JSON_PROPERTY_TRIGGER -}) -@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesContextManagementClearToolUses implements MessagesContextManagementEdit { - public static final String JSON_PROPERTY_TYPE = "type"; - @javax.annotation.Nonnull - private MessagesContextManagementEditType type = MessagesContextManagementEditType.CLEAR_TOOL_USES; - - public static final String JSON_PROPERTY_KEEP = "keep"; - @javax.annotation.Nullable - private MessagesContextManagementKeep keep; - - public static final String JSON_PROPERTY_EXCLUDE_TOOLS = "exclude_tools"; - @javax.annotation.Nullable - private List excludeTools; - - public static final String JSON_PROPERTY_CLEAR_TOOL_INPUTS = "clear_tool_inputs"; - @javax.annotation.Nullable - private Boolean clearToolInputs; - - public static final String JSON_PROPERTY_TRIGGER = "trigger"; - @javax.annotation.Nullable - private MessagesContextManagementClearToolUsesTrigger trigger; - - public MessagesContextManagementClearToolUses() { - } - - public MessagesContextManagementClearToolUses type(@javax.annotation.Nonnull MessagesContextManagementEditType type) { - - this.type = type; - return this; - } - - /** - * Get type - * @return type - */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - - public MessagesContextManagementEditType getType() { - return type; - } - - - @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull MessagesContextManagementEditType type) { - this.type = type; - } - - public MessagesContextManagementClearToolUses keep(@javax.annotation.Nullable MessagesContextManagementKeep keep) { - - this.keep = keep; - return this; - } - - /** - * Get keep - * @return keep - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_KEEP, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - - public MessagesContextManagementKeep getKeep() { - return keep; - } - - - @JsonProperty(value = JSON_PROPERTY_KEEP, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setKeep(@javax.annotation.Nullable MessagesContextManagementKeep keep) { - this.keep = keep; - } - - public MessagesContextManagementClearToolUses excludeTools(@javax.annotation.Nullable List excludeTools) { - - this.excludeTools = excludeTools; - return this; - } - - public MessagesContextManagementClearToolUses addExcludeToolsItem(String excludeToolsItem) { - if (this.excludeTools == null) { - this.excludeTools = new ArrayList<>(); - } - this.excludeTools.add(excludeToolsItem); - return this; - } - - /** - * Get excludeTools - * @return excludeTools - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_EXCLUDE_TOOLS, required = false) - @JsonInclude(value = JsonInclude.Include.NON_EMPTY) - - public List getExcludeTools() { - return excludeTools; - } - - - @JsonProperty(value = JSON_PROPERTY_EXCLUDE_TOOLS, required = false) - @JsonInclude(value = JsonInclude.Include.NON_EMPTY) - public void setExcludeTools(@javax.annotation.Nullable List excludeTools) { - this.excludeTools = excludeTools; - } - - public MessagesContextManagementClearToolUses clearToolInputs(@javax.annotation.Nullable Boolean clearToolInputs) { - - this.clearToolInputs = clearToolInputs; - return this; - } - - /** - * Get clearToolInputs - * @return clearToolInputs - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_CLEAR_TOOL_INPUTS, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - - public Boolean getClearToolInputs() { - return clearToolInputs; - } - - - @JsonProperty(value = JSON_PROPERTY_CLEAR_TOOL_INPUTS, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setClearToolInputs(@javax.annotation.Nullable Boolean clearToolInputs) { - this.clearToolInputs = clearToolInputs; - } - - public MessagesContextManagementClearToolUses trigger(@javax.annotation.Nullable MessagesContextManagementClearToolUsesTrigger trigger) { - - this.trigger = trigger; - return this; - } - - /** - * Get trigger - * @return trigger - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_TRIGGER, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - - public MessagesContextManagementClearToolUsesTrigger getTrigger() { - return trigger; - } - - - @JsonProperty(value = JSON_PROPERTY_TRIGGER, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) - public void setTrigger(@javax.annotation.Nullable MessagesContextManagementClearToolUsesTrigger trigger) { - this.trigger = trigger; - } - - - @Override - public boolean equals(Object o) { - if (this == o) { - return true; - } - if (o == null || getClass() != o.getClass()) { - return false; - } - MessagesContextManagementClearToolUses messagesContextManagementClearToolUses = (MessagesContextManagementClearToolUses) o; - return Objects.equals(this.type, messagesContextManagementClearToolUses.type) && - Objects.equals(this.keep, messagesContextManagementClearToolUses.keep) && - Objects.equals(this.excludeTools, messagesContextManagementClearToolUses.excludeTools) && - Objects.equals(this.clearToolInputs, messagesContextManagementClearToolUses.clearToolInputs) && - Objects.equals(this.trigger, messagesContextManagementClearToolUses.trigger); - } - - @Override - public int hashCode() { - return Objects.hash(type, keep, excludeTools, clearToolInputs, trigger); - } - - @Override - public String toString() { - StringBuilder sb = new StringBuilder(); - sb.append("class MessagesContextManagementClearToolUses {\n"); - sb.append(" type: ").append(toIndentedString(type)).append("\n"); - sb.append(" keep: ").append(toIndentedString(keep)).append("\n"); - sb.append(" excludeTools: ").append(toIndentedString(excludeTools)).append("\n"); - sb.append(" clearToolInputs: ").append(toIndentedString(clearToolInputs)).append("\n"); - sb.append(" trigger: ").append(toIndentedString(trigger)).append("\n"); - sb.append("}"); - return sb.toString(); - } - - /** - * Convert the given object to string with each line indented by 4 spaces - * (except the first line). - */ - private String toIndentedString(Object o) { - return o == null ? "null" : o.toString().replace("\n", "\n "); - } - - public static class Builder { - - private MessagesContextManagementClearToolUses instance; - - public Builder() { - this(new MessagesContextManagementClearToolUses()); - } - - protected Builder(MessagesContextManagementClearToolUses instance) { - this.instance = instance; - } - - public MessagesContextManagementClearToolUses.Builder type(MessagesContextManagementEditType type) { - this.instance.type = type; - return this; - } - public MessagesContextManagementClearToolUses.Builder keep(MessagesContextManagementKeep keep) { - this.instance.keep = keep; - return this; - } - public MessagesContextManagementClearToolUses.Builder excludeTools(List excludeTools) { - this.instance.excludeTools = excludeTools; - return this; - } - public MessagesContextManagementClearToolUses.Builder clearToolInputs(Boolean clearToolInputs) { - this.instance.clearToolInputs = clearToolInputs; - return this; - } - public MessagesContextManagementClearToolUses.Builder trigger(MessagesContextManagementClearToolUsesTrigger trigger) { - this.instance.trigger = trigger; - return this; - } - - - /** - * returns a built MessagesContextManagementClearToolUses instance. - * - * The builder is not reusable. - */ - public MessagesContextManagementClearToolUses build() { - try { - return this.instance; - } finally { - // ensure that this.instance is not reused - this.instance = null; - } - } - - @Override - public String toString() { - return getClass() + "=(" + instance + ")"; - } - } - - /** - * Create a builder with no initialized field. - */ - public static MessagesContextManagementClearToolUses.Builder builder() { - return new MessagesContextManagementClearToolUses.Builder(); - } - - /** - * Create a builder with a shallow copy of this instance. - */ - public MessagesContextManagementClearToolUses.Builder toBuilder() { - return new MessagesContextManagementClearToolUses.Builder() - .type(getType()) - .keep(getKeep()) - .excludeTools(getExcludeTools()) - .clearToolInputs(getClearToolInputs()) - .trigger(getTrigger()); - } - - -} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUsesTrigger.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUsesTrigger.java index 16cbb18..3d09265 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUsesTrigger.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementClearToolUsesTrigger.java @@ -16,11 +16,9 @@ package com.volcengine.ark.runtime.models.messages; -import com.fasterxml.jackson.annotation.JsonCreator; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import com.fasterxml.jackson.annotation.JsonPropertyOrder; -import com.fasterxml.jackson.annotation.JsonValue; import java.util.Objects; /** @@ -32,97 +30,64 @@ }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") public class MessagesContextManagementClearToolUsesTrigger { - /** - * Gets or Sets type - */ - public enum TypeEnum { - TOOL_USES(String.valueOf("tool_uses")); - - private String value; - - TypeEnum(String value) { - this.value = value; - } - - @JsonValue - public String getValue() { - return value; - } - - @Override - public String toString() { - return String.valueOf(value); - } - - @JsonCreator - public static TypeEnum fromValue(String value) { - for (TypeEnum b : TypeEnum.values()) { - if (b.value.equalsIgnoreCase(value)) { - return b; - } - } - throw new IllegalArgumentException("Unexpected value '" + value + "'"); - } - } - public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private TypeEnum type; + private String type; public static final String JSON_PROPERTY_VALUE = "value"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private Integer value; public MessagesContextManagementClearToolUsesTrigger() { } - public MessagesContextManagementClearToolUsesTrigger type(@javax.annotation.Nonnull TypeEnum type) { + public MessagesContextManagementClearToolUsesTrigger type(@javax.annotation.Nonnull String type) { this.type = type; return this; } /** - * Get type + * The trigger type. `tool_uses` and other values such as `input_tokens` are accepted. * @return type */ @javax.annotation.Nonnull @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public TypeEnum getType() { + public String getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull TypeEnum type) { + public void setType(@javax.annotation.Nonnull String type) { this.type = type; } - public MessagesContextManagementClearToolUsesTrigger value(@javax.annotation.Nonnull Integer value) { + public MessagesContextManagementClearToolUsesTrigger value(@javax.annotation.Nullable Integer value) { this.value = value; return this; } /** - * Get value + * For `tool_uses`, the server requires a value of at least 1. Other trigger types accept an omitted value or any uint32 value, including 0. This type-specific constraint is validated by the server. * @return value */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_VALUE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Integer getValue() { return value; } - @JsonProperty(value = JSON_PROPERTY_VALUE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setValue(@javax.annotation.Nonnull Integer value) { + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setValue(@javax.annotation.Nullable Integer value) { this.value = value; } @@ -175,7 +140,7 @@ protected Builder(MessagesContextManagementClearToolUsesTrigger instance) { this.instance = instance; } - public MessagesContextManagementClearToolUsesTrigger.Builder type(TypeEnum type) { + public MessagesContextManagementClearToolUsesTrigger.Builder type(String type) { this.instance.type = type; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEdit.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEdit.java index 1162206..b014941 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEdit.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEdit.java @@ -16,16 +16,296 @@ package com.volcengine.ark.runtime.models.messages; -import com.fasterxml.jackson.annotation.JsonSubTypes; -import com.fasterxml.jackson.annotation.JsonTypeInfo; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.ArrayList; +import java.util.List; +import java.util.Objects; -@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "type", visible = true) -@JsonSubTypes({ - @JsonSubTypes.Type(value = MessagesContextManagementClearThinking.class, name = "clear_thinking"), - @JsonSubTypes.Type(value = MessagesContextManagementClearToolUses.class, name = "clear_tool_uses"), +/** + * MessagesContextManagementEdit + */ +@JsonPropertyOrder({ + MessagesContextManagementEdit.JSON_PROPERTY_TYPE, + MessagesContextManagementEdit.JSON_PROPERTY_KEEP, + MessagesContextManagementEdit.JSON_PROPERTY_EXCLUDE_TOOLS, + MessagesContextManagementEdit.JSON_PROPERTY_CLEAR_TOOL_INPUTS, + MessagesContextManagementEdit.JSON_PROPERTY_TRIGGER }) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesContextManagementEdit { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private String type; + + public static final String JSON_PROPERTY_KEEP = "keep"; + @javax.annotation.Nullable + private MessagesContextManagementKeep keep; + + public static final String JSON_PROPERTY_EXCLUDE_TOOLS = "exclude_tools"; + @javax.annotation.Nullable + private List excludeTools; + + public static final String JSON_PROPERTY_CLEAR_TOOL_INPUTS = "clear_tool_inputs"; + @javax.annotation.Nullable + private Boolean clearToolInputs; + + public static final String JSON_PROPERTY_TRIGGER = "trigger"; + @javax.annotation.Nullable + private MessagesContextManagementClearToolUsesTrigger trigger; + + public MessagesContextManagementEdit() { + } + + public MessagesContextManagementEdit type(@javax.annotation.Nonnull String type) { + + this.type = type; + return this; + } + + /** + * Supports `clear_thinking`, `clear_tool_uses`, and version-suffixed forms. + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public String getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull String type) { + this.type = type; + } + + public MessagesContextManagementEdit keep(@javax.annotation.Nullable MessagesContextManagementKeep keep) { + + this.keep = keep; + return this; + } + + /** + * Get keep + * @return keep + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_KEEP, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public MessagesContextManagementKeep getKeep() { + return keep; + } + + + @JsonProperty(value = JSON_PROPERTY_KEEP, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setKeep(@javax.annotation.Nullable MessagesContextManagementKeep keep) { + this.keep = keep; + } + + public MessagesContextManagementEdit excludeTools(@javax.annotation.Nullable List excludeTools) { + + this.excludeTools = excludeTools; + return this; + } + + public MessagesContextManagementEdit addExcludeToolsItem(String excludeToolsItem) { + if (this.excludeTools == null) { + this.excludeTools = new ArrayList<>(); + } + this.excludeTools.add(excludeToolsItem); + return this; + } + + /** + * Get excludeTools + * @return excludeTools + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_EXCLUDE_TOOLS, required = false) + @JsonInclude(value = JsonInclude.Include.NON_EMPTY) + + public List getExcludeTools() { + return excludeTools; + } + + + @JsonProperty(value = JSON_PROPERTY_EXCLUDE_TOOLS, required = false) + @JsonInclude(value = JsonInclude.Include.NON_EMPTY) + public void setExcludeTools(@javax.annotation.Nullable List excludeTools) { + this.excludeTools = excludeTools; + } + + public MessagesContextManagementEdit clearToolInputs(@javax.annotation.Nullable Boolean clearToolInputs) { + + this.clearToolInputs = clearToolInputs; + return this; + } + + /** + * Get clearToolInputs + * @return clearToolInputs + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CLEAR_TOOL_INPUTS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public Boolean getClearToolInputs() { + return clearToolInputs; + } + + + @JsonProperty(value = JSON_PROPERTY_CLEAR_TOOL_INPUTS, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setClearToolInputs(@javax.annotation.Nullable Boolean clearToolInputs) { + this.clearToolInputs = clearToolInputs; + } + + public MessagesContextManagementEdit trigger(@javax.annotation.Nullable MessagesContextManagementClearToolUsesTrigger trigger) { + + this.trigger = trigger; + return this; + } + + /** + * Get trigger + * @return trigger + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_TRIGGER, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public MessagesContextManagementClearToolUsesTrigger getTrigger() { + return trigger; + } + + + @JsonProperty(value = JSON_PROPERTY_TRIGGER, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setTrigger(@javax.annotation.Nullable MessagesContextManagementClearToolUsesTrigger trigger) { + this.trigger = trigger; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesContextManagementEdit messagesContextManagementEdit = (MessagesContextManagementEdit) o; + return Objects.equals(this.type, messagesContextManagementEdit.type) && + Objects.equals(this.keep, messagesContextManagementEdit.keep) && + Objects.equals(this.excludeTools, messagesContextManagementEdit.excludeTools) && + Objects.equals(this.clearToolInputs, messagesContextManagementEdit.clearToolInputs) && + Objects.equals(this.trigger, messagesContextManagementEdit.trigger); + } + + @Override + public int hashCode() { + return Objects.hash(type, keep, excludeTools, clearToolInputs, trigger); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesContextManagementEdit {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" keep: ").append(toIndentedString(keep)).append("\n"); + sb.append(" excludeTools: ").append(toIndentedString(excludeTools)).append("\n"); + sb.append(" clearToolInputs: ").append(toIndentedString(clearToolInputs)).append("\n"); + sb.append(" trigger: ").append(toIndentedString(trigger)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesContextManagementEdit instance; + + public Builder() { + this(new MessagesContextManagementEdit()); + } + + protected Builder(MessagesContextManagementEdit instance) { + this.instance = instance; + } + + public MessagesContextManagementEdit.Builder type(String type) { + this.instance.type = type; + return this; + } + public MessagesContextManagementEdit.Builder keep(MessagesContextManagementKeep keep) { + this.instance.keep = keep; + return this; + } + public MessagesContextManagementEdit.Builder excludeTools(List excludeTools) { + this.instance.excludeTools = excludeTools; + return this; + } + public MessagesContextManagementEdit.Builder clearToolInputs(Boolean clearToolInputs) { + this.instance.clearToolInputs = clearToolInputs; + return this; + } + public MessagesContextManagementEdit.Builder trigger(MessagesContextManagementClearToolUsesTrigger trigger) { + this.instance.trigger = trigger; + return this; + } + + + /** + * returns a built MessagesContextManagementEdit instance. + * + * The builder is not reusable. + */ + public MessagesContextManagementEdit build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesContextManagementEdit.Builder builder() { + return new MessagesContextManagementEdit.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesContextManagementEdit.Builder toBuilder() { + return new MessagesContextManagementEdit.Builder() + .type(getType()) + .keep(getKeep()) + .excludeTools(getExcludeTools()) + .clearToolInputs(getClearToolInputs()) + .trigger(getTrigger()); + } + -public interface MessagesContextManagementEdit { - public MessagesContextManagementEditType getType(); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEditType.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEditType.java deleted file mode 100644 index 5459c97..0000000 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementEditType.java +++ /dev/null @@ -1,57 +0,0 @@ -// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. -// SPDX-License-Identifier: Apache-2.0 - -/* - * Ark Messages API - * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) - * - * The version of the OpenAPI document: 0.1.0 - * - * - * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). - * https://openapi-generator.tech - * Do not edit the class manually. - */ - - -package com.volcengine.ark.runtime.models.messages; - - -import com.fasterxml.jackson.annotation.JsonCreator; -import com.fasterxml.jackson.annotation.JsonValue; - -/** - * Gets or Sets MessagesContextManagementEditType - */ -public enum MessagesContextManagementEditType { - - CLEAR_THINKING("clear_thinking"), - - CLEAR_TOOL_USES("clear_tool_uses"); - - private String value; - - MessagesContextManagementEditType(String value) { - this.value = value; - } - - @JsonValue - public String getValue() { - return value; - } - - @Override - public String toString() { - return String.valueOf(value); - } - - @JsonCreator - public static MessagesContextManagementEditType fromValue(String value) { - for (MessagesContextManagementEditType b : MessagesContextManagementEditType.values()) { - if (b.value.equalsIgnoreCase(value)) { - return b; - } - } - throw new IllegalArgumentException("Unexpected value '" + value + "'"); - } -} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepAll.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepAll.java index 0b2bac6..800a160 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepAll.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepAll.java @@ -25,7 +25,8 @@ * MessagesContextManagementKeepAll */ @JsonPropertyOrder({ - MessagesContextManagementKeepAll.JSON_PROPERTY_TYPE + MessagesContextManagementKeepAll.JSON_PROPERTY_TYPE, + MessagesContextManagementKeepAll.JSON_PROPERTY_VALUE }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") public class MessagesContextManagementKeepAll implements MessagesContextManagementKeepParameter { @@ -33,6 +34,10 @@ public class MessagesContextManagementKeepAll implements MessagesContextManageme @javax.annotation.Nonnull private MessagesContextManagementKeepParameterType type = MessagesContextManagementKeepParameterType.ALL; + public static final String JSON_PROPERTY_VALUE = "value"; + @javax.annotation.Nullable + private Integer value; + public MessagesContextManagementKeepAll() { } @@ -61,6 +66,31 @@ public void setType(@javax.annotation.Nonnull MessagesContextManagementKeepParam this.type = type; } + public MessagesContextManagementKeepAll value(@javax.annotation.Nullable Integer value) { + + this.value = value; + return this; + } + + /** + * Get value + * @return value + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public Integer getValue() { + return value; + } + + + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setValue(@javax.annotation.Nullable Integer value) { + this.value = value; + } + @Override public boolean equals(Object o) { @@ -71,12 +101,13 @@ public boolean equals(Object o) { return false; } MessagesContextManagementKeepAll messagesContextManagementKeepAll = (MessagesContextManagementKeepAll) o; - return Objects.equals(this.type, messagesContextManagementKeepAll.type); + return Objects.equals(this.type, messagesContextManagementKeepAll.type) && + Objects.equals(this.value, messagesContextManagementKeepAll.value); } @Override public int hashCode() { - return Objects.hash(type); + return Objects.hash(type, value); } @Override @@ -84,6 +115,7 @@ public String toString() { StringBuilder sb = new StringBuilder(); sb.append("class MessagesContextManagementKeepAll {\n"); sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" value: ").append(toIndentedString(value)).append("\n"); sb.append("}"); return sb.toString(); } @@ -112,6 +144,10 @@ public MessagesContextManagementKeepAll.Builder type(MessagesContextManagementKe this.instance.type = type; return this; } + public MessagesContextManagementKeepAll.Builder value(Integer value) { + this.instance.value = value; + return this; + } /** @@ -146,7 +182,8 @@ public static MessagesContextManagementKeepAll.Builder builder() { */ public MessagesContextManagementKeepAll.Builder toBuilder() { return new MessagesContextManagementKeepAll.Builder() - .type(getType()); + .type(getType()) + .value(getValue()); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepThinkingTurns.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepThinkingTurns.java index 6433a4d..752481d 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepThinkingTurns.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepThinkingTurns.java @@ -35,7 +35,7 @@ public class MessagesContextManagementKeepThinkingTurns implements MessagesConte private MessagesContextManagementKeepParameterType type = MessagesContextManagementKeepParameterType.THINKING_TURNS; public static final String JSON_PROPERTY_VALUE = "value"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private Integer value; public MessagesContextManagementKeepThinkingTurns() { @@ -66,7 +66,7 @@ public void setType(@javax.annotation.Nonnull MessagesContextManagementKeepParam this.type = type; } - public MessagesContextManagementKeepThinkingTurns value(@javax.annotation.Nonnull Integer value) { + public MessagesContextManagementKeepThinkingTurns value(@javax.annotation.Nullable Integer value) { this.value = value; return this; @@ -76,8 +76,8 @@ public MessagesContextManagementKeepThinkingTurns value(@javax.annotation.Nonnul * Get value * @return value */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_VALUE, required = true) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) public Integer getValue() { @@ -85,9 +85,9 @@ public Integer getValue() { } - @JsonProperty(value = JSON_PROPERTY_VALUE, required = true) + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setValue(@javax.annotation.Nonnull Integer value) { + public void setValue(@javax.annotation.Nullable Integer value) { this.value = value; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepToolUses.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepToolUses.java index 64836e9..cc63105 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepToolUses.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesContextManagementKeepToolUses.java @@ -35,7 +35,7 @@ public class MessagesContextManagementKeepToolUses implements MessagesContextMan private MessagesContextManagementKeepParameterType type = MessagesContextManagementKeepParameterType.TOOL_USES; public static final String JSON_PROPERTY_VALUE = "value"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private Integer value; public MessagesContextManagementKeepToolUses() { @@ -66,7 +66,7 @@ public void setType(@javax.annotation.Nonnull MessagesContextManagementKeepParam this.type = type; } - public MessagesContextManagementKeepToolUses value(@javax.annotation.Nonnull Integer value) { + public MessagesContextManagementKeepToolUses value(@javax.annotation.Nullable Integer value) { this.value = value; return this; @@ -76,8 +76,8 @@ public MessagesContextManagementKeepToolUses value(@javax.annotation.Nonnull Int * Get value * @return value */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_VALUE, required = true) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) public Integer getValue() { @@ -85,9 +85,9 @@ public Integer getValue() { } - @JsonProperty(value = JSON_PROPERTY_VALUE, required = true) + @JsonProperty(value = JSON_PROPERTY_VALUE, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setValue(@javax.annotation.Nonnull Integer value) { + public void setValue(@javax.annotation.Nullable Integer value) { this.value = value; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentContent.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentContent.java new file mode 100644 index 0000000..4d51f56 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesDocumentContent.java @@ -0,0 +1,120 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonValue; +import com.fasterxml.jackson.core.JsonParser; +import com.fasterxml.jackson.databind.DeserializationContext; +import com.fasterxml.jackson.databind.JsonDeserializer; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.annotation.JsonDeserialize; +import java.io.IOException; +import java.util.Objects; + +/** + * MessagesDocumentContent + * + * Naked-union holder generated by gen/java/postprocess.py from the openapi + * anyOf schema (variants: String, java.util.List). + * + * The Jackson apache-httpclient template openapi-generator runs against + * does not support non-discriminated anyOf/oneOf — it either drops to a + * degenerate empty shell or flattens one variant's fields onto the class, + * losing the others. This postprocess rewrite replaces the parent with a + * @JsonValue holder + typed static factories for write-side, plus a custom + * @JsonDeserialize that dispatches by JsonNode shape on the read-side so + * round-trips preserve variant types (string -> typed primitive/enum, + * object -> typed model, array -> typed List). + */ +@JsonDeserialize(using = MessagesDocumentContent.Deserializer.class) +public class MessagesDocumentContent { + + private final Object value; + + @JsonCreator + public MessagesDocumentContent(Object value) { + this.value = value; + } + + public MessagesDocumentContent() { + this.value = null; + } + + public static MessagesDocumentContent ofString(String value) { + return new MessagesDocumentContent(value); + } + + public static MessagesDocumentContent ofList(java.util.List value) { + return new MessagesDocumentContent(value); + } + + @JsonValue + public Object getValue() { + return this.value; + } + + public static class Deserializer extends JsonDeserializer { + @Override + public MessagesDocumentContent deserialize(JsonParser p, DeserializationContext ctxt) throws IOException { + ObjectMapper mapper = (ObjectMapper) p.getCodec(); + JsonNode node = mapper.readTree(p); + if (node.isTextual()) { + return new MessagesDocumentContent(mapper.treeToValue(node, String.class)); + } + if (node.isArray()) { + return new MessagesDocumentContent( + mapper.convertValue(node, new com.fasterxml.jackson.core.type.TypeReference>() {})); + } + throw ctxt.weirdStringException( + node == null ? "null" : node.toString(), + MessagesDocumentContent.class, + "no MessagesDocumentContent variant matched JSON node shape"); + } + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + MessagesDocumentContent other = (MessagesDocumentContent) o; + return Objects.equals(this.value, other.value); + } + + @Override + public int hashCode() { + return Objects.hash(this.value); + } + + @Override + public String toString() { + return "class MessagesDocumentContent {" + Objects.toString(value) + "}"; + } + + public static class Builder { + private Object value; + public Builder() {} + public Builder value(Object value) { this.value = value; return this; } + public MessagesDocumentContent build() { return new MessagesDocumentContent(this.value); } + } + + public static MessagesDocumentContent.Builder builder() { return new MessagesDocumentContent.Builder(); } + + public MessagesDocumentContent.Builder toBuilder() { + return new MessagesDocumentContent.Builder().value(this.value); + } +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesIterationUsage.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesIterationUsage.java index 1751e6b..cf2724f 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesIterationUsage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesIterationUsage.java @@ -58,7 +58,7 @@ public MessagesIterationUsage type(@javax.annotation.Nonnull String type) { } /** - * The iteration usage record type. + * The iteration usage record type, currently `message`. * @return type */ @javax.annotation.Nonnull @@ -83,7 +83,7 @@ public MessagesIterationUsage inputTokens(@javax.annotation.Nonnull Integer inpu } /** - * Number of input tokens consumed by this model iteration. + * Number of input tokens consumed by this iteration, excluding cache reads. * @return inputTokens */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesMetadata.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesMetadata.java index a8cc110..b9f179e 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesMetadata.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesMetadata.java @@ -43,7 +43,7 @@ public MessagesMetadata userId(@javax.annotation.Nullable String userId) { } /** - * An external identifier for the user associated with the request. + * Get userId * @return userId */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputConfig.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputConfig.java index 97c51a7..444fbcd 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputConfig.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputConfig.java @@ -43,7 +43,7 @@ public MessagesOutputConfig effort(@javax.annotation.Nullable String effort) { } /** - * Requested reasoning effort. + * Get effort * @return effort */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormat.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormat.java index 762fde5..521ef3b 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormat.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormat.java @@ -16,185 +16,17 @@ package com.volcengine.ark.runtime.models.messages; -import com.fasterxml.jackson.annotation.JsonInclude; -import com.fasterxml.jackson.annotation.JsonProperty; -import com.fasterxml.jackson.annotation.JsonPropertyOrder; -import java.util.HashMap; -import java.util.Map; -import java.util.Objects; +import com.fasterxml.jackson.annotation.JsonSubTypes; +import com.fasterxml.jackson.annotation.JsonTypeInfo; -/** - * MessagesOutputFormat - */ -@JsonPropertyOrder({ - MessagesOutputFormat.JSON_PROPERTY_TYPE, - MessagesOutputFormat.JSON_PROPERTY_SCHEMA -}) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesOutputFormat { - public static final String JSON_PROPERTY_TYPE = "type"; - @javax.annotation.Nonnull - private MessagesOutputFormatType type; - - public static final String JSON_PROPERTY_SCHEMA = "schema"; - @javax.annotation.Nullable - private Map schema; - - public MessagesOutputFormat() { - } - - public MessagesOutputFormat type(@javax.annotation.Nonnull MessagesOutputFormatType type) { - - this.type = type; - return this; - } - - /** - * The requested output format. - * @return type - */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - - public MessagesOutputFormatType getType() { - return type; - } - - - @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull MessagesOutputFormatType type) { - this.type = type; - } - - public MessagesOutputFormat schema(@javax.annotation.Nullable Map schema) { - - this.schema = schema; - return this; - } - - public MessagesOutputFormat putSchemaItem(String key, Object schemaItem) { - if (this.schema == null) { - this.schema = new HashMap<>(); - } - this.schema.put(key, schemaItem); - return this; - } - - /** - * JSON Schema used when `type` is `json_schema`. - * @return schema - */ - @javax.annotation.Nullable - @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) - @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) - - public Map getSchema() { - return schema; - } - - - @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) - @JsonInclude(content = JsonInclude.Include.ALWAYS, value = JsonInclude.Include.NON_EMPTY) - public void setSchema(@javax.annotation.Nullable Map schema) { - this.schema = schema; - } - - - @Override - public boolean equals(Object o) { - if (this == o) { - return true; - } - if (o == null || getClass() != o.getClass()) { - return false; - } - MessagesOutputFormat messagesOutputFormat = (MessagesOutputFormat) o; - return Objects.equals(this.type, messagesOutputFormat.type) && - Objects.equals(this.schema, messagesOutputFormat.schema); - } - - @Override - public int hashCode() { - return Objects.hash(type, schema); - } - - @Override - public String toString() { - StringBuilder sb = new StringBuilder(); - sb.append("class MessagesOutputFormat {\n"); - sb.append(" type: ").append(toIndentedString(type)).append("\n"); - sb.append(" schema: ").append(toIndentedString(schema)).append("\n"); - sb.append("}"); - return sb.toString(); - } - - /** - * Convert the given object to string with each line indented by 4 spaces - * (except the first line). - */ - private String toIndentedString(Object o) { - return o == null ? "null" : o.toString().replace("\n", "\n "); - } - - public static class Builder { - - private MessagesOutputFormat instance; - - public Builder() { - this(new MessagesOutputFormat()); - } - - protected Builder(MessagesOutputFormat instance) { - this.instance = instance; - } - - public MessagesOutputFormat.Builder type(MessagesOutputFormatType type) { - this.instance.type = type; - return this; - } - public MessagesOutputFormat.Builder schema(Map schema) { - this.instance.schema = schema; - return this; - } - - - /** - * returns a built MessagesOutputFormat instance. - * - * The builder is not reusable. - */ - public MessagesOutputFormat build() { - try { - return this.instance; - } finally { - // ensure that this.instance is not reused - this.instance = null; - } - } - - @Override - public String toString() { - return getClass() + "=(" + instance + ")"; - } - } - - /** - * Create a builder with no initialized field. - */ - public static MessagesOutputFormat.Builder builder() { - return new MessagesOutputFormat.Builder(); - } - - /** - * Create a builder with a shallow copy of this instance. - */ - public MessagesOutputFormat.Builder toBuilder() { - return new MessagesOutputFormat.Builder() - .type(getType()) - .schema(getSchema()); - } - +@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "type", visible = true) +@JsonSubTypes({ + @JsonSubTypes.Type(value = MessagesOutputFormatJsonObject.class, name = "json_object"), + @JsonSubTypes.Type(value = MessagesOutputFormatJsonSchema.class, name = "json_schema"), + @JsonSubTypes.Type(value = MessagesOutputFormatText.class, name = "text"), +}) +public interface MessagesOutputFormat { + public MessagesOutputFormatType getType(); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonObject.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonObject.java new file mode 100644 index 0000000..a81fedc --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonObject.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesOutputFormatJsonObject + */ +@JsonPropertyOrder({ + MessagesOutputFormatJsonObject.JSON_PROPERTY_TYPE, + MessagesOutputFormatJsonObject.JSON_PROPERTY_SCHEMA +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesOutputFormatJsonObject implements MessagesOutputFormat { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesOutputFormatType type = MessagesOutputFormatType.JSON_OBJECT; + + public static final String JSON_PROPERTY_SCHEMA = "schema"; + @javax.annotation.Nullable + private Object schema = null; + + public MessagesOutputFormatJsonObject() { + } + + public MessagesOutputFormatJsonObject type(@javax.annotation.Nonnull MessagesOutputFormatType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesOutputFormatType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesOutputFormatType type) { + this.type = type; + } + + public MessagesOutputFormatJsonObject schema(@javax.annotation.Nullable Object schema) { + + this.schema = schema; + return this; + } + + /** + * Get schema + * @return schema + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public Object getSchema() { + return schema; + } + + + @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setSchema(@javax.annotation.Nullable Object schema) { + this.schema = schema; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesOutputFormatJsonObject messagesOutputFormatJsonObject = (MessagesOutputFormatJsonObject) o; + return Objects.equals(this.type, messagesOutputFormatJsonObject.type) && + Objects.equals(this.schema, messagesOutputFormatJsonObject.schema); + } + + @Override + public int hashCode() { + return Objects.hash(type, schema); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesOutputFormatJsonObject {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" schema: ").append(toIndentedString(schema)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesOutputFormatJsonObject instance; + + public Builder() { + this(new MessagesOutputFormatJsonObject()); + } + + protected Builder(MessagesOutputFormatJsonObject instance) { + this.instance = instance; + } + + public MessagesOutputFormatJsonObject.Builder type(MessagesOutputFormatType type) { + this.instance.type = type; + return this; + } + public MessagesOutputFormatJsonObject.Builder schema(Object schema) { + this.instance.schema = schema; + return this; + } + + + /** + * returns a built MessagesOutputFormatJsonObject instance. + * + * The builder is not reusable. + */ + public MessagesOutputFormatJsonObject build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesOutputFormatJsonObject.Builder builder() { + return new MessagesOutputFormatJsonObject.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesOutputFormatJsonObject.Builder toBuilder() { + return new MessagesOutputFormatJsonObject.Builder() + .type(getType()) + .schema(getSchema()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonSchema.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonSchema.java new file mode 100644 index 0000000..f59baf4 --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatJsonSchema.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesOutputFormatJsonSchema + */ +@JsonPropertyOrder({ + MessagesOutputFormatJsonSchema.JSON_PROPERTY_TYPE, + MessagesOutputFormatJsonSchema.JSON_PROPERTY_SCHEMA +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesOutputFormatJsonSchema implements MessagesOutputFormat { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesOutputFormatType type = MessagesOutputFormatType.JSON_SCHEMA; + + public static final String JSON_PROPERTY_SCHEMA = "schema"; + @javax.annotation.Nullable + private Object schema = null; + + public MessagesOutputFormatJsonSchema() { + } + + public MessagesOutputFormatJsonSchema type(@javax.annotation.Nonnull MessagesOutputFormatType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesOutputFormatType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesOutputFormatType type) { + this.type = type; + } + + public MessagesOutputFormatJsonSchema schema(@javax.annotation.Nullable Object schema) { + + this.schema = schema; + return this; + } + + /** + * Get schema + * @return schema + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public Object getSchema() { + return schema; + } + + + @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setSchema(@javax.annotation.Nullable Object schema) { + this.schema = schema; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesOutputFormatJsonSchema messagesOutputFormatJsonSchema = (MessagesOutputFormatJsonSchema) o; + return Objects.equals(this.type, messagesOutputFormatJsonSchema.type) && + Objects.equals(this.schema, messagesOutputFormatJsonSchema.schema); + } + + @Override + public int hashCode() { + return Objects.hash(type, schema); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesOutputFormatJsonSchema {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" schema: ").append(toIndentedString(schema)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesOutputFormatJsonSchema instance; + + public Builder() { + this(new MessagesOutputFormatJsonSchema()); + } + + protected Builder(MessagesOutputFormatJsonSchema instance) { + this.instance = instance; + } + + public MessagesOutputFormatJsonSchema.Builder type(MessagesOutputFormatType type) { + this.instance.type = type; + return this; + } + public MessagesOutputFormatJsonSchema.Builder schema(Object schema) { + this.instance.schema = schema; + return this; + } + + + /** + * returns a built MessagesOutputFormatJsonSchema instance. + * + * The builder is not reusable. + */ + public MessagesOutputFormatJsonSchema build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesOutputFormatJsonSchema.Builder builder() { + return new MessagesOutputFormatJsonSchema.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesOutputFormatJsonSchema.Builder toBuilder() { + return new MessagesOutputFormatJsonSchema.Builder() + .type(getType()) + .schema(getSchema()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatText.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatText.java new file mode 100644 index 0000000..bb9909a --- /dev/null +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatText.java @@ -0,0 +1,190 @@ +// Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +// SPDX-License-Identifier: Apache-2.0 + +/* + * Ark Messages API + * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator) + * + * The version of the OpenAPI document: 0.1.0 + * + * + * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). + * https://openapi-generator.tech + * Do not edit the class manually. + */ + + +package com.volcengine.ark.runtime.models.messages; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.Objects; + +/** + * MessagesOutputFormatText + */ +@JsonPropertyOrder({ + MessagesOutputFormatText.JSON_PROPERTY_TYPE, + MessagesOutputFormatText.JSON_PROPERTY_SCHEMA +}) +@javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") +public class MessagesOutputFormatText implements MessagesOutputFormat { + public static final String JSON_PROPERTY_TYPE = "type"; + @javax.annotation.Nonnull + private MessagesOutputFormatType type = MessagesOutputFormatType.TEXT; + + public static final String JSON_PROPERTY_SCHEMA = "schema"; + @javax.annotation.Nullable + private Object schema = null; + + public MessagesOutputFormatText() { + } + + public MessagesOutputFormatText type(@javax.annotation.Nonnull MessagesOutputFormatType type) { + + this.type = type; + return this; + } + + /** + * Get type + * @return type + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public MessagesOutputFormatType getType() { + return type; + } + + + @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setType(@javax.annotation.Nonnull MessagesOutputFormatType type) { + this.type = type; + } + + public MessagesOutputFormatText schema(@javax.annotation.Nullable Object schema) { + + this.schema = schema; + return this; + } + + /** + * Get schema + * @return schema + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + + public Object getSchema() { + return schema; + } + + + @JsonProperty(value = JSON_PROPERTY_SCHEMA, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setSchema(@javax.annotation.Nullable Object schema) { + this.schema = schema; + } + + + @Override + public boolean equals(Object o) { + if (this == o) { + return true; + } + if (o == null || getClass() != o.getClass()) { + return false; + } + MessagesOutputFormatText messagesOutputFormatText = (MessagesOutputFormatText) o; + return Objects.equals(this.type, messagesOutputFormatText.type) && + Objects.equals(this.schema, messagesOutputFormatText.schema); + } + + @Override + public int hashCode() { + return Objects.hash(type, schema); + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder(); + sb.append("class MessagesOutputFormatText {\n"); + sb.append(" type: ").append(toIndentedString(type)).append("\n"); + sb.append(" schema: ").append(toIndentedString(schema)).append("\n"); + sb.append("}"); + return sb.toString(); + } + + /** + * Convert the given object to string with each line indented by 4 spaces + * (except the first line). + */ + private String toIndentedString(Object o) { + return o == null ? "null" : o.toString().replace("\n", "\n "); + } + + public static class Builder { + + private MessagesOutputFormatText instance; + + public Builder() { + this(new MessagesOutputFormatText()); + } + + protected Builder(MessagesOutputFormatText instance) { + this.instance = instance; + } + + public MessagesOutputFormatText.Builder type(MessagesOutputFormatType type) { + this.instance.type = type; + return this; + } + public MessagesOutputFormatText.Builder schema(Object schema) { + this.instance.schema = schema; + return this; + } + + + /** + * returns a built MessagesOutputFormatText instance. + * + * The builder is not reusable. + */ + public MessagesOutputFormatText build() { + try { + return this.instance; + } finally { + // ensure that this.instance is not reused + this.instance = null; + } + } + + @Override + public String toString() { + return getClass() + "=(" + instance + ")"; + } + } + + /** + * Create a builder with no initialized field. + */ + public static MessagesOutputFormatText.Builder builder() { + return new MessagesOutputFormatText.Builder(); + } + + /** + * Create a builder with a shallow copy of this instance. + */ + public MessagesOutputFormatText.Builder toBuilder() { + return new MessagesOutputFormatText.Builder() + .type(getType()) + .schema(getSchema()); + } + + +} diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatType.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatType.java index 986f282..28cc8f3 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatType.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesOutputFormatType.java @@ -25,11 +25,11 @@ */ public enum MessagesOutputFormatType { - TEXT("text"), - JSON_OBJECT("json_object"), - JSON_SCHEMA("json_schema"); + JSON_SCHEMA("json_schema"), + + TEXT("text"); private String value; diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequest.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequest.java index 22edb4e..68cd4a8 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequest.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequest.java @@ -215,7 +215,7 @@ public MessagesRequest system(@javax.annotation.Nullable MessagesSystem system) } /** - * A system prompt supplied separately from the conversation messages. + * Get system * @return system */ @javax.annotation.Nullable @@ -240,7 +240,9 @@ public MessagesRequest frequencyPenalty(@javax.annotation.Nullable Double freque } /** - * Number between -2.0 and 2.0. Positive values penalize tokens based on their existing frequency in the generated text. + * Get frequencyPenalty + * minimum: -2 + * maximum: 2 * @return frequencyPenalty */ @javax.annotation.Nullable @@ -273,7 +275,7 @@ public MessagesRequest putLogitBiasItem(String key, Float logitBiasItem) { } /** - * Modify the likelihood of token IDs appearing in the response. Values range from -100 to 100. + * Get logitBias * @return logitBias */ @javax.annotation.Nullable @@ -298,7 +300,7 @@ public MessagesRequest logprobs(@javax.annotation.Nullable Boolean logprobs) { } /** - * Whether to return log probabilities of output tokens. + * Get logprobs * @return logprobs */ @javax.annotation.Nullable @@ -323,7 +325,8 @@ public MessagesRequest maxTokens(@javax.annotation.Nullable Integer maxTokens) { } /** - * Maximum number of tokens that may be generated. + * Get maxTokens + * minimum: 0 * @return maxTokens */ @javax.annotation.Nullable @@ -348,7 +351,9 @@ public MessagesRequest presencePenalty(@javax.annotation.Nullable Double presenc } /** - * Number between -2.0 and 2.0. Positive values penalize tokens based on whether they have appeared in the generated text. + * Get presencePenalty + * minimum: -2 + * maximum: 2 * @return presencePenalty */ @javax.annotation.Nullable @@ -373,7 +378,9 @@ public MessagesRequest repetitionPenalty(@javax.annotation.Nullable Double repet } /** - * Number between 0.0 and 2.0 that penalizes repetition. + * Get repetitionPenalty + * minimum: 0 + * maximum: 2 * @return repetitionPenalty */ @javax.annotation.Nullable @@ -398,7 +405,7 @@ public MessagesRequest outputFormat(@javax.annotation.Nullable MessagesOutputFor } /** - * The format the model must produce. + * Get outputFormat * @return outputFormat */ @javax.annotation.Nullable @@ -448,7 +455,7 @@ public MessagesRequest stream(@javax.annotation.Nullable Boolean stream) { } /** - * Whether to stream the response as server-sent events. + * Get stream * @return stream */ @javax.annotation.Nullable @@ -473,7 +480,7 @@ public MessagesRequest streamOptions(@javax.annotation.Nullable MessagesStreamOp } /** - * Options for streaming responses. + * Get streamOptions * @return streamOptions */ @javax.annotation.Nullable @@ -498,7 +505,9 @@ public MessagesRequest temperature(@javax.annotation.Nullable Double temperature } /** - * Sampling temperature between 0 and 2. + * Get temperature + * minimum: 0 + * maximum: 2 * @return temperature */ @javax.annotation.Nullable @@ -523,7 +532,7 @@ public MessagesRequest toolChoice(@javax.annotation.Nullable MessagesToolChoice } /** - * Controls which tool, if any, the model calls. + * Get toolChoice * @return toolChoice */ @javax.annotation.Nullable @@ -556,7 +565,7 @@ public MessagesRequest addToolsItem(MessagesTool toolsItem) { } /** - * Tools the model may call. + * Get tools * @return tools */ @javax.annotation.Nullable @@ -581,7 +590,9 @@ public MessagesRequest topLogprobs(@javax.annotation.Nullable Integer topLogprob } /** - * Number of most-likely tokens returned at each position. Range 0-20. + * Get topLogprobs + * minimum: 0 + * maximum: 20 * @return topLogprobs */ @javax.annotation.Nullable @@ -606,7 +617,9 @@ public MessagesRequest topP(@javax.annotation.Nullable Double topP) { } /** - * Nucleus sampling probability between 0 and 1. + * Get topP + * minimum: 0 + * maximum: 1 * @return topP */ @javax.annotation.Nullable @@ -631,7 +644,7 @@ public MessagesRequest serviceTier(@javax.annotation.Nullable MessagesRequestSer } /** - * Latency tier used to process the request. + * Get serviceTier * @return serviceTier */ @javax.annotation.Nullable @@ -656,7 +669,7 @@ public MessagesRequest thinking(@javax.annotation.Nullable MessagesThinking thin } /** - * Thinking-mode configuration. + * Get thinking * @return thinking */ @javax.annotation.Nullable @@ -681,7 +694,7 @@ public MessagesRequest outputConfig(@javax.annotation.Nullable MessagesOutputCon } /** - * Output configuration for reasoning models. + * Get outputConfig * @return outputConfig */ @javax.annotation.Nullable @@ -706,7 +719,7 @@ public MessagesRequest metadata(@javax.annotation.Nullable MessagesMetadata meta } /** - * Metadata associated with the request. + * Get metadata * @return metadata */ @javax.annotation.Nullable @@ -731,7 +744,7 @@ public MessagesRequest contextManagement(@javax.annotation.Nullable MessagesCont } /** - * Context-editing rules applied before inference. + * Get contextManagement * @return contextManagement */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestMessage.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestMessage.java index e431c53..3ec31ac 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestMessage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestMessage.java @@ -32,62 +32,62 @@ public class MessagesRequestMessage { public static final String JSON_PROPERTY_ROLE = "role"; @javax.annotation.Nonnull - private MessagesRole role; + private String role; public static final String JSON_PROPERTY_CONTENT = "content"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private MessagesMessageContent content; public MessagesRequestMessage() { } - public MessagesRequestMessage role(@javax.annotation.Nonnull MessagesRole role) { + public MessagesRequestMessage role(@javax.annotation.Nonnull String role) { this.role = role; return this; } /** - * The role of the message author. + * Any non-empty role. Roles other than `user` and `assistant` are interpreted as system messages. * @return role */ @javax.annotation.Nonnull @JsonProperty(value = JSON_PROPERTY_ROLE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public MessagesRole getRole() { + public String getRole() { return role; } @JsonProperty(value = JSON_PROPERTY_ROLE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setRole(@javax.annotation.Nonnull MessagesRole role) { + public void setRole(@javax.annotation.Nonnull String role) { this.role = role; } - public MessagesRequestMessage content(@javax.annotation.Nonnull MessagesMessageContent content) { + public MessagesRequestMessage content(@javax.annotation.Nullable MessagesMessageContent content) { this.content = content; return this; } /** - * The contents of the message. + * Get content * @return content */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public MessagesMessageContent getContent() { return content; } - @JsonProperty(value = JSON_PROPERTY_CONTENT, required = true) - @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setContent(@javax.annotation.Nonnull MessagesMessageContent content) { + @JsonProperty(value = JSON_PROPERTY_CONTENT, required = false) + @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + public void setContent(@javax.annotation.Nullable MessagesMessageContent content) { this.content = content; } @@ -140,7 +140,7 @@ protected Builder(MessagesRequestMessage instance) { this.instance = instance; } - public MessagesRequestMessage.Builder role(MessagesRole role) { + public MessagesRequestMessage.Builder role(String role) { this.instance.role = role; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestServiceTier.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestServiceTier.java index 994afc0..02ac748 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestServiceTier.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRequestServiceTier.java @@ -25,9 +25,13 @@ */ public enum MessagesRequestServiceTier { + EMPTY(""), + AUTO("auto"), - DEFAULT("default"); + DEFAULT("default"), + + FLEX("flex"); private String value; diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponse.java index 7f7a9c2..2b9a8a7 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponse.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponse.java @@ -336,12 +336,12 @@ public MessagesResponse stopSequence(@javax.annotation.Nullable String stopSeque } /** - * The custom stop sequence that was generated, if any. + * Get stopSequence * @return stopSequence */ @javax.annotation.Nullable @JsonProperty(value = JSON_PROPERTY_STOP_SEQUENCE, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + @JsonInclude(value = JsonInclude.Include.ALWAYS) public String getStopSequence() { return stopSequence; @@ -349,7 +349,7 @@ public String getStopSequence() { @JsonProperty(value = JSON_PROPERTY_STOP_SEQUENCE, required = false) - @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) + @JsonInclude(value = JsonInclude.Include.ALWAYS) public void setStopSequence(@javax.annotation.Nullable String stopSequence) { this.stopSequence = stopSequence; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPart.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPart.java index b2f5c9d..de9b704 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPart.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPart.java @@ -30,5 +30,5 @@ }) public interface MessagesResponseContentPart { - public ContentBlockStartContentBlockType getType(); + public MessagesResponseContentPartType getType(); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartServerToolUse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartServerToolUse.java index 24a9b8e..b009290 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartServerToolUse.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartServerToolUse.java @@ -32,10 +32,10 @@ MessagesResponseContentPartServerToolUse.JSON_PROPERTY_INPUT }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesResponseContentPartServerToolUse implements ContentBlockStartContentBlock, MessagesResponseContentPart { +public class MessagesResponseContentPartServerToolUse implements MessagesResponseContentPart { public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.SERVER_TOOL_USE; + private MessagesResponseContentPartType type = MessagesResponseContentPartType.SERVER_TOOL_USE; public static final String JSON_PROPERTY_ID = "id"; @javax.annotation.Nonnull @@ -52,7 +52,7 @@ public class MessagesResponseContentPartServerToolUse implements ContentBlockSta public MessagesResponseContentPartServerToolUse() { } - public MessagesResponseContentPartServerToolUse type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartServerToolUse type(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; return this; @@ -66,14 +66,14 @@ public MessagesResponseContentPartServerToolUse type(@javax.annotation.Nonnull C @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public ContentBlockStartContentBlockType getType() { + public MessagesResponseContentPartType getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public void setType(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; } @@ -210,7 +210,7 @@ protected Builder(MessagesResponseContentPartServerToolUse instance) { this.instance = instance; } - public MessagesResponseContentPartServerToolUse.Builder type(ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartServerToolUse.Builder type(MessagesResponseContentPartType type) { this.instance.type = type; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartText.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartText.java index 0cf33fe..0992e55 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartText.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartText.java @@ -29,10 +29,10 @@ MessagesResponseContentPartText.JSON_PROPERTY_TEXT }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesResponseContentPartText implements ContentBlockStartContentBlock, MessagesResponseContentPart { +public class MessagesResponseContentPartText implements MessagesResponseContentPart { public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.TEXT; + private MessagesResponseContentPartType type = MessagesResponseContentPartType.TEXT; public static final String JSON_PROPERTY_TEXT = "text"; @javax.annotation.Nonnull @@ -41,7 +41,7 @@ public class MessagesResponseContentPartText implements ContentBlockStartContent public MessagesResponseContentPartText() { } - public MessagesResponseContentPartText type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartText type(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; return this; @@ -55,14 +55,14 @@ public MessagesResponseContentPartText type(@javax.annotation.Nonnull ContentBlo @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public ContentBlockStartContentBlockType getType() { + public MessagesResponseContentPartType getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public void setType(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; } @@ -140,7 +140,7 @@ protected Builder(MessagesResponseContentPartText instance) { this.instance = instance; } - public MessagesResponseContentPartText.Builder type(ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartText.Builder type(MessagesResponseContentPartType type) { this.instance.type = type; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartThinking.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartThinking.java index e17f7c1..44f8b20 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartThinking.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartThinking.java @@ -30,10 +30,10 @@ MessagesResponseContentPartThinking.JSON_PROPERTY_SIGNATURE }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesResponseContentPartThinking implements ContentBlockStartContentBlock, MessagesResponseContentPart { +public class MessagesResponseContentPartThinking implements MessagesResponseContentPart { public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.THINKING; + private MessagesResponseContentPartType type = MessagesResponseContentPartType.THINKING; public static final String JSON_PROPERTY_THINKING = "thinking"; @javax.annotation.Nonnull @@ -46,7 +46,7 @@ public class MessagesResponseContentPartThinking implements ContentBlockStartCon public MessagesResponseContentPartThinking() { } - public MessagesResponseContentPartThinking type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartThinking type(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; return this; @@ -60,14 +60,14 @@ public MessagesResponseContentPartThinking type(@javax.annotation.Nonnull Conten @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public ContentBlockStartContentBlockType getType() { + public MessagesResponseContentPartType getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public void setType(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; } @@ -172,7 +172,7 @@ protected Builder(MessagesResponseContentPartThinking instance) { this.instance = instance; } - public MessagesResponseContentPartThinking.Builder type(ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartThinking.Builder type(MessagesResponseContentPartType type) { this.instance.type = type; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartToolUse.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartToolUse.java index 5e93823..97432a9 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartToolUse.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartToolUse.java @@ -32,10 +32,10 @@ MessagesResponseContentPartToolUse.JSON_PROPERTY_INPUT }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesResponseContentPartToolUse implements ContentBlockStartContentBlock, MessagesResponseContentPart { +public class MessagesResponseContentPartToolUse implements MessagesResponseContentPart { public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.TOOL_USE; + private MessagesResponseContentPartType type = MessagesResponseContentPartType.TOOL_USE; public static final String JSON_PROPERTY_ID = "id"; @javax.annotation.Nonnull @@ -52,7 +52,7 @@ public class MessagesResponseContentPartToolUse implements ContentBlockStartCont public MessagesResponseContentPartToolUse() { } - public MessagesResponseContentPartToolUse type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartToolUse type(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; return this; @@ -66,14 +66,14 @@ public MessagesResponseContentPartToolUse type(@javax.annotation.Nonnull Content @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public ContentBlockStartContentBlockType getType() { + public MessagesResponseContentPartType getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public void setType(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; } @@ -210,7 +210,7 @@ protected Builder(MessagesResponseContentPartToolUse instance) { this.instance = instance; } - public MessagesResponseContentPartToolUse.Builder type(ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartToolUse.Builder type(MessagesResponseContentPartType type) { this.instance.type = type; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRole.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartType.java similarity index 68% rename from src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRole.java rename to src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartType.java index cae3195..e595e6f 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesRole.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartType.java @@ -21,19 +21,23 @@ import com.fasterxml.jackson.annotation.JsonValue; /** - * Gets or Sets MessagesRole + * Gets or Sets MessagesResponseContentPartType */ -public enum MessagesRole { +public enum MessagesResponseContentPartType { - ASSISTANT("assistant"), + SERVER_TOOL_USE("server_tool_use"), - USER("user"), + TEXT("text"), - SYSTEM("system"); + THINKING("thinking"), + + TOOL_USE("tool_use"), + + WEB_SEARCH_TOOL_RESULT("web_search_tool_result"); private String value; - MessagesRole(String value) { + MessagesResponseContentPartType(String value) { this.value = value; } @@ -48,8 +52,8 @@ public String toString() { } @JsonCreator - public static MessagesRole fromValue(String value) { - for (MessagesRole b : MessagesRole.values()) { + public static MessagesResponseContentPartType fromValue(String value) { + for (MessagesResponseContentPartType b : MessagesResponseContentPartType.values()) { if (b.value.equalsIgnoreCase(value)) { return b; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartWebSearchToolResult.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartWebSearchToolResult.java index 9fe6864..d6de239 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartWebSearchToolResult.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseContentPartWebSearchToolResult.java @@ -31,10 +31,10 @@ MessagesResponseContentPartWebSearchToolResult.JSON_PROPERTY_CALLER }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") -public class MessagesResponseContentPartWebSearchToolResult implements ContentBlockStartContentBlock, MessagesResponseContentPart { +public class MessagesResponseContentPartWebSearchToolResult implements MessagesResponseContentPart { public static final String JSON_PROPERTY_TYPE = "type"; @javax.annotation.Nonnull - private ContentBlockStartContentBlockType type = ContentBlockStartContentBlockType.WEB_SEARCH_TOOL_RESULT; + private MessagesResponseContentPartType type = MessagesResponseContentPartType.WEB_SEARCH_TOOL_RESULT; public static final String JSON_PROPERTY_TOOL_USE_ID = "tool_use_id"; @javax.annotation.Nonnull @@ -51,7 +51,7 @@ public class MessagesResponseContentPartWebSearchToolResult implements ContentBl public MessagesResponseContentPartWebSearchToolResult() { } - public MessagesResponseContentPartWebSearchToolResult type(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartWebSearchToolResult type(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; return this; @@ -65,14 +65,14 @@ public MessagesResponseContentPartWebSearchToolResult type(@javax.annotation.Non @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public ContentBlockStartContentBlockType getType() { + public MessagesResponseContentPartType getType() { return type; } @JsonProperty(value = JSON_PROPERTY_TYPE, required = true) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setType(@javax.annotation.Nonnull ContentBlockStartContentBlockType type) { + public void setType(@javax.annotation.Nonnull MessagesResponseContentPartType type) { this.type = type; } @@ -204,7 +204,7 @@ protected Builder(MessagesResponseContentPartWebSearchToolResult instance) { this.instance = instance; } - public MessagesResponseContentPartWebSearchToolResult.Builder type(ContentBlockStartContentBlockType type) { + public MessagesResponseContentPartWebSearchToolResult.Builder type(MessagesResponseContentPartType type) { this.instance.type = type; return this; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseStreamMessageStartMessage.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseStreamMessageStartMessage.java index d36d174..a647f2b 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseStreamMessageStartMessage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesResponseStreamMessageStartMessage.java @@ -236,7 +236,7 @@ public MessagesResponseStreamMessageStartMessage addContentItem(Object contentIt } /** - * Get content + * Content is initially empty; blocks arrive in subsequent stream events. * @return content */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesTool.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesTool.java index 791dbbd..da6d938 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesTool.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesTool.java @@ -87,7 +87,7 @@ public MessagesTool description(@javax.annotation.Nullable String description) { } /** - * A description of what the tool does and when the model should use it. + * Get description * @return description */ @javax.annotation.Nullable @@ -145,7 +145,7 @@ public MessagesTool putInputSchemaItem(String key, Object inputSchemaItem) { } /** - * The tool input, described as a JSON Schema object. + * Get inputSchema * @return inputSchema */ @javax.annotation.Nullable @@ -170,7 +170,7 @@ public MessagesTool strict(@javax.annotation.Nullable Boolean strict) { } /** - * Whether strict schema adherence is enabled for this tool. + * Get strict * @return strict */ @javax.annotation.Nullable @@ -195,7 +195,7 @@ public MessagesTool type(@javax.annotation.Nullable String type) { } /** - * A server-managed tool version, such as `web_search_20250305`. + * A tool type. A non-empty type without a description denotes a server-managed tool; web search uses the name `web_search` and a `web_search_` type prefix. * @return type */ @javax.annotation.Nullable @@ -220,7 +220,8 @@ public MessagesTool maxUses(@javax.annotation.Nullable Integer maxUses) { } /** - * Maximum number of times a server-managed tool may be dispatched. + * Get maxUses + * minimum: 1 * @return maxUses */ @javax.annotation.Nullable @@ -253,7 +254,7 @@ public MessagesTool addAllowedDomainsItem(String allowedDomainsItem) { } /** - * Domains that a server-managed web tool is allowed to access. + * Get allowedDomains * @return allowedDomains */ @javax.annotation.Nullable @@ -286,7 +287,7 @@ public MessagesTool addBlockedDomainsItem(String blockedDomainsItem) { } /** - * Domains that a server-managed web tool must not access. + * Get blockedDomains * @return blockedDomains */ @javax.annotation.Nullable @@ -311,7 +312,7 @@ public MessagesTool userLocation(@javax.annotation.Nullable MessagesToolUserLoca } /** - * Optional user location supplied to a server-managed web tool. + * Get userLocation * @return userLocation */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolChoiceTool.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolChoiceTool.java index 19d04bb..39bf04e 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolChoiceTool.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolChoiceTool.java @@ -40,7 +40,7 @@ public class MessagesToolChoiceTool implements MessagesToolChoice { private Boolean disableParallelToolUse; public static final String JSON_PROPERTY_NAME = "name"; - @javax.annotation.Nonnull + @javax.annotation.Nullable private String name; public MessagesToolChoiceTool() { @@ -96,18 +96,18 @@ public void setDisableParallelToolUse(@javax.annotation.Nullable Boolean disable this.disableParallelToolUse = disableParallelToolUse; } - public MessagesToolChoiceTool name(@javax.annotation.Nonnull String name) { + public MessagesToolChoiceTool name(@javax.annotation.Nullable String name) { this.name = name; return this; } /** - * The name of the tool the model must invoke. + * Get name * @return name */ - @javax.annotation.Nonnull - @JsonProperty(value = JSON_PROPERTY_NAME, required = true) + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) public String getName() { @@ -115,9 +115,9 @@ public String getName() { } - @JsonProperty(value = JSON_PROPERTY_NAME, required = true) + @JsonProperty(value = JSON_PROPERTY_NAME, required = false) @JsonInclude(value = JsonInclude.Include.ALWAYS) - public void setName(@javax.annotation.Nonnull String name) { + public void setName(@javax.annotation.Nullable String name) { this.name = name; } diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolUserLocation.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolUserLocation.java index bfea511..1c930b3 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolUserLocation.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesToolUserLocation.java @@ -22,7 +22,7 @@ import java.util.Objects; /** - * MessagesToolUserLocation + * Accepted for web-search compatibility; not currently forwarded to the search provider. */ @JsonPropertyOrder({ MessagesToolUserLocation.JSON_PROPERTY_TYPE, diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesUsage.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesUsage.java index c8ceafb..debc41b 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesUsage.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesUsage.java @@ -29,6 +29,7 @@ @JsonPropertyOrder({ MessagesUsage.JSON_PROPERTY_INPUT_TOKENS, MessagesUsage.JSON_PROPERTY_OUTPUT_TOKENS, + MessagesUsage.JSON_PROPERTY_CACHE_CREATION_INPUT_TOKENS, MessagesUsage.JSON_PROPERTY_CACHE_READ_INPUT_TOKENS, MessagesUsage.JSON_PROPERTY_SERVER_TOOL_USE, MessagesUsage.JSON_PROPERTY_ITERATIONS @@ -43,6 +44,10 @@ public class MessagesUsage { @javax.annotation.Nullable private Integer outputTokens; + public static final String JSON_PROPERTY_CACHE_CREATION_INPUT_TOKENS = "cache_creation_input_tokens"; + @javax.annotation.Nonnull + private Integer cacheCreationInputTokens; + public static final String JSON_PROPERTY_CACHE_READ_INPUT_TOKENS = "cache_read_input_tokens"; @javax.annotation.Nullable private Integer cacheReadInputTokens; @@ -65,7 +70,7 @@ public MessagesUsage inputTokens(@javax.annotation.Nullable Integer inputTokens) } /** - * Number of tokens in the prompt. + * Number of prompt tokens excluding tokens read from the prefill cache. * @return inputTokens */ @javax.annotation.Nullable @@ -108,6 +113,31 @@ public void setOutputTokens(@javax.annotation.Nullable Integer outputTokens) { this.outputTokens = outputTokens; } + public MessagesUsage cacheCreationInputTokens(@javax.annotation.Nonnull Integer cacheCreationInputTokens) { + + this.cacheCreationInputTokens = cacheCreationInputTokens; + return this; + } + + /** + * Cache-creation tokens are not currently supported; this field is returned as zero. + * @return cacheCreationInputTokens + */ + @javax.annotation.Nonnull + @JsonProperty(value = JSON_PROPERTY_CACHE_CREATION_INPUT_TOKENS, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + + public Integer getCacheCreationInputTokens() { + return cacheCreationInputTokens; + } + + + @JsonProperty(value = JSON_PROPERTY_CACHE_CREATION_INPUT_TOKENS, required = true) + @JsonInclude(value = JsonInclude.Include.ALWAYS) + public void setCacheCreationInputTokens(@javax.annotation.Nonnull Integer cacheCreationInputTokens) { + this.cacheCreationInputTokens = cacheCreationInputTokens; + } + public MessagesUsage cacheReadInputTokens(@javax.annotation.Nullable Integer cacheReadInputTokens) { this.cacheReadInputTokens = cacheReadInputTokens; @@ -173,7 +203,7 @@ public MessagesUsage addIterationsItem(MessagesIterationUsage iterationsItem) { } /** - * One token-usage record for each model iteration. + * One token-usage record per model iteration, included for multi-round requests. * @return iterations */ @javax.annotation.Nullable @@ -203,6 +233,7 @@ public boolean equals(Object o) { MessagesUsage messagesUsage = (MessagesUsage) o; return Objects.equals(this.inputTokens, messagesUsage.inputTokens) && Objects.equals(this.outputTokens, messagesUsage.outputTokens) && + Objects.equals(this.cacheCreationInputTokens, messagesUsage.cacheCreationInputTokens) && Objects.equals(this.cacheReadInputTokens, messagesUsage.cacheReadInputTokens) && Objects.equals(this.serverToolUse, messagesUsage.serverToolUse) && Objects.equals(this.iterations, messagesUsage.iterations); @@ -210,7 +241,7 @@ public boolean equals(Object o) { @Override public int hashCode() { - return Objects.hash(inputTokens, outputTokens, cacheReadInputTokens, serverToolUse, iterations); + return Objects.hash(inputTokens, outputTokens, cacheCreationInputTokens, cacheReadInputTokens, serverToolUse, iterations); } @Override @@ -219,6 +250,7 @@ public String toString() { sb.append("class MessagesUsage {\n"); sb.append(" inputTokens: ").append(toIndentedString(inputTokens)).append("\n"); sb.append(" outputTokens: ").append(toIndentedString(outputTokens)).append("\n"); + sb.append(" cacheCreationInputTokens: ").append(toIndentedString(cacheCreationInputTokens)).append("\n"); sb.append(" cacheReadInputTokens: ").append(toIndentedString(cacheReadInputTokens)).append("\n"); sb.append(" serverToolUse: ").append(toIndentedString(serverToolUse)).append("\n"); sb.append(" iterations: ").append(toIndentedString(iterations)).append("\n"); @@ -254,6 +286,10 @@ public MessagesUsage.Builder outputTokens(Integer outputTokens) { this.instance.outputTokens = outputTokens; return this; } + public MessagesUsage.Builder cacheCreationInputTokens(Integer cacheCreationInputTokens) { + this.instance.cacheCreationInputTokens = cacheCreationInputTokens; + return this; + } public MessagesUsage.Builder cacheReadInputTokens(Integer cacheReadInputTokens) { this.instance.cacheReadInputTokens = cacheReadInputTokens; return this; @@ -302,6 +338,7 @@ public MessagesUsage.Builder toBuilder() { return new MessagesUsage.Builder() .inputTokens(getInputTokens()) .outputTokens(getOutputTokens()) + .cacheCreationInputTokens(getCacheCreationInputTokens()) .cacheReadInputTokens(getCacheReadInputTokens()) .serverToolUse(getServerToolUse()) .iterations(getIterations()); diff --git a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesWebSearchResult.java b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesWebSearchResult.java index bed2524..acd5c70 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesWebSearchResult.java +++ b/src/main/java/com/volcengine/ark/runtime/models/messages/MessagesWebSearchResult.java @@ -173,7 +173,7 @@ public MessagesWebSearchResult encryptedContent(@javax.annotation.Nonnull String } /** - * Get encryptedContent + * Opaque signed search content. Replay this value unchanged. * @return encryptedContent */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsSessionEvent.java b/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsSessionEvent.java index dc940e8..f24b9d2 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsSessionEvent.java +++ b/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsSessionEvent.java @@ -78,7 +78,7 @@ public ManagedAgentsSessionEvent id(@javax.annotation.Nullable String id) { } /** - * 事件 id（服务端在 ingest 阶段 stamp，形如 `sevt-<ts>-<rand>`）。 + * 事件 id（服务端在 ingest 阶段 stamp，形如 `sevt-...`）。 * @return id */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsUserDefineOutcomeEventParams.java b/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsUserDefineOutcomeEventParams.java index a5d4464..2afe3c0 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsUserDefineOutcomeEventParams.java +++ b/src/main/java/com/volcengine/ark/runtime/models/session/ManagedAgentsUserDefineOutcomeEventParams.java @@ -93,7 +93,7 @@ public ManagedAgentsUserDefineOutcomeEventParams outcomeId(@javax.annotation.Nul } /** - * outcome id（客户端自定义 unique key）；缺省时由服务端在事件入库前 stamp 一个 `outc-<ts>-<rand>` 形态的 id 出来（见 ark-agent-event eventservice.go::ensureUserEventID 的 envelope-level mint 逻辑）， 因此 wire 上此字段是 optional，不是 required。 + * outcome id（客户端自定义 unique key）；缺省时由服务端在事件入库前 stamp 一个 `outc-...` 形态的 id，因此 wire 上此字段是 optional，不是 required。 * @return outcomeId */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/session/Session.java b/src/main/java/com/volcengine/ark/runtime/models/session/Session.java index 6f7e4b4..9427314 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/session/Session.java +++ b/src/main/java/com/volcengine/ark/runtime/models/session/Session.java @@ -147,7 +147,7 @@ public Session id(@javax.annotation.Nonnull String id) { } /** - * Session ID。 + * Session ID，形如 `sesn-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/session/SessionResource.java b/src/main/java/com/volcengine/ark/runtime/models/session/SessionResource.java index 4ec80d9..47de8dc 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/session/SessionResource.java +++ b/src/main/java/com/volcengine/ark/runtime/models/session/SessionResource.java @@ -93,7 +93,7 @@ public SessionResource id(@javax.annotation.Nullable String id) { } /** - * SessionResource ID。 + * SessionResource ID，形如 `sesrsc-...`。 * @return id */ @javax.annotation.Nullable diff --git a/src/main/java/com/volcengine/ark/runtime/models/skill/CreateSkillRequest.java b/src/main/java/com/volcengine/ark/runtime/models/skill/CreateSkillRequest.java index b45ea4c..2502f9f 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/skill/CreateSkillRequest.java +++ b/src/main/java/com/volcengine/ark/runtime/models/skill/CreateSkillRequest.java @@ -19,6 +19,8 @@ import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import com.fasterxml.jackson.annotation.JsonPropertyOrder; +import java.util.ArrayList; +import java.util.List; import java.util.Objects; /** @@ -26,7 +28,9 @@ */ @JsonPropertyOrder({ CreateSkillRequest.JSON_PROPERTY_DISPLAY_TITLE, - CreateSkillRequest.JSON_PROPERTY_PROTECTION_ENABLED + CreateSkillRequest.JSON_PROPERTY_PROTECTION_ENABLED, + CreateSkillRequest.JSON_PROPERTY_FILES, + CreateSkillRequest.JSON_PROPERTY_FILES_BRACKET }) @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaClientCodegen", comments = "Generator version: 7.21.0") public class CreateSkillRequest { @@ -38,6 +42,14 @@ public class CreateSkillRequest { @javax.annotation.Nullable private Boolean protectionEnabled; + public static final String JSON_PROPERTY_FILES = "files"; + @javax.annotation.Nullable + private List files; + + public static final String JSON_PROPERTY_FILES_BRACKET = "files[]"; + @javax.annotation.Nullable + private List filesBracket; + public CreateSkillRequest() { } @@ -91,6 +103,72 @@ public void setProtectionEnabled(@javax.annotation.Nullable Boolean protectionEn this.protectionEnabled = protectionEnabled; } + public CreateSkillRequest files(@javax.annotation.Nullable List files) { + + this.files = files; + return this; + } + + public CreateSkillRequest addFilesItem(Object filesItem) { + if (this.files == null) { + this.files = new ArrayList<>(); + } + this.files.add(filesItem); + return this; + } + + /** + * 技能包内容。可以是单个 `.zip`，也可以是一组带相对路径的松散文件； 该字段名允许在同一次请求中重复出现以传多个文件。 与 `files[]` 语义等价，两者至少提供其一；同时提供时会被服务端合并。 + * @return files + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_FILES, required = false) + @JsonInclude(value = JsonInclude.Include.NON_EMPTY) + + public List getFiles() { + return files; + } + + + @JsonProperty(value = JSON_PROPERTY_FILES, required = false) + @JsonInclude(value = JsonInclude.Include.NON_EMPTY) + public void setFiles(@javax.annotation.Nullable List files) { + this.files = files; + } + + public CreateSkillRequest filesBracket(@javax.annotation.Nullable List filesBracket) { + + this.filesBracket = filesBracket; + return this; + } + + public CreateSkillRequest addFilesBracketItem(Object filesBracketItem) { + if (this.filesBracket == null) { + this.filesBracket = new ArrayList<>(); + } + this.filesBracket.add(filesBracketItem); + return this; + } + + /** + * `files` 的可重复字段名别名，语义完全等价；便于用 `-F 'files[]=@a' -F 'files[]=@b'` 这种 jQuery/PHP 风格的 multipart 客户端直接使用。 + * @return filesBracket + */ + @javax.annotation.Nullable + @JsonProperty(value = JSON_PROPERTY_FILES_BRACKET, required = false) + @JsonInclude(value = JsonInclude.Include.NON_EMPTY) + + public List getFilesBracket() { + return filesBracket; + } + + + @JsonProperty(value = JSON_PROPERTY_FILES_BRACKET, required = false) + @JsonInclude(value = JsonInclude.Include.NON_EMPTY) + public void setFilesBracket(@javax.annotation.Nullable List filesBracket) { + this.filesBracket = filesBracket; + } + @Override public boolean equals(Object o) { @@ -102,12 +180,14 @@ public boolean equals(Object o) { } CreateSkillRequest createSkillRequest = (CreateSkillRequest) o; return Objects.equals(this.displayTitle, createSkillRequest.displayTitle) && - Objects.equals(this.protectionEnabled, createSkillRequest.protectionEnabled); + Objects.equals(this.protectionEnabled, createSkillRequest.protectionEnabled) && + Objects.equals(this.files, createSkillRequest.files) && + Objects.equals(this.filesBracket, createSkillRequest.filesBracket); } @Override public int hashCode() { - return Objects.hash(displayTitle, protectionEnabled); + return Objects.hash(displayTitle, protectionEnabled, files, filesBracket); } @Override @@ -116,6 +196,8 @@ public String toString() { sb.append("class CreateSkillRequest {\n"); sb.append(" displayTitle: ").append(toIndentedString(displayTitle)).append("\n"); sb.append(" protectionEnabled: ").append(toIndentedString(protectionEnabled)).append("\n"); + sb.append(" files: ").append(toIndentedString(files)).append("\n"); + sb.append(" filesBracket: ").append(toIndentedString(filesBracket)).append("\n"); sb.append("}"); return sb.toString(); } @@ -148,6 +230,14 @@ public CreateSkillRequest.Builder protectionEnabled(Boolean protectionEnabled) { this.instance.protectionEnabled = protectionEnabled; return this; } + public CreateSkillRequest.Builder files(List files) { + this.instance.files = files; + return this; + } + public CreateSkillRequest.Builder filesBracket(List filesBracket) { + this.instance.filesBracket = filesBracket; + return this; + } /** @@ -183,7 +273,9 @@ public static CreateSkillRequest.Builder builder() { public CreateSkillRequest.Builder toBuilder() { return new CreateSkillRequest.Builder() .displayTitle(getDisplayTitle()) - .protectionEnabled(getProtectionEnabled()); + .protectionEnabled(getProtectionEnabled()) + .files(getFiles()) + .filesBracket(getFilesBracket()); } diff --git a/src/main/java/com/volcengine/ark/runtime/models/skill/Skill.java b/src/main/java/com/volcengine/ark/runtime/models/skill/Skill.java index efea3c5..3505366 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/skill/Skill.java +++ b/src/main/java/com/volcengine/ark/runtime/models/skill/Skill.java @@ -123,7 +123,7 @@ public Skill id(@javax.annotation.Nonnull String id) { } /** - * Skill ID，形如 `skill_01XJ5...`。 + * Skill ID，形如 `skill-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/vault/Credential.java b/src/main/java/com/volcengine/ark/runtime/models/vault/Credential.java index b900b31..5972d37 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/vault/Credential.java +++ b/src/main/java/com/volcengine/ark/runtime/models/vault/Credential.java @@ -115,7 +115,7 @@ public Credential id(@javax.annotation.Nonnull String id) { } /** - * Credential ID。 + * Credential ID，形如 `vcrd-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/models/vault/Vault.java b/src/main/java/com/volcengine/ark/runtime/models/vault/Vault.java index 852fbf1..be11b0f 100644 --- a/src/main/java/com/volcengine/ark/runtime/models/vault/Vault.java +++ b/src/main/java/com/volcengine/ark/runtime/models/vault/Vault.java @@ -105,7 +105,7 @@ public Vault id(@javax.annotation.Nonnull String id) { } /** - * Vault ID。 + * Vault ID，形如 `vlt-...`。 * @return id */ @javax.annotation.Nonnull diff --git a/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpClient.java b/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpClient.java index a13c4b4..ca7c846 100644 --- a/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpClient.java +++ b/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpClient.java @@ -4,7 +4,6 @@ package com.volcengine.ark.runtime.selfhosted.mcp; import com.volcengine.ark.runtime.selfhosted.ToolContext; - import java.util.Map; /** Minimal MCP client contract required by a self-hosted worker. */ diff --git a/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpTools.java b/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpTools.java index e71af91..22f276c 100644 --- a/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpTools.java +++ b/src/main/java/com/volcengine/ark/runtime/selfhosted/mcp/McpTools.java @@ -12,7 +12,6 @@ import com.volcengine.ark.runtime.selfhosted.Tool; import com.volcengine.ark.runtime.selfhosted.ToolContext; import com.volcengine.ark.runtime.selfhosted.ToolResult; - import java.nio.charset.StandardCharsets; import java.util.ArrayList; import java.util.Base64;