add core code and spring boot starter sdk

cozeloop-core/src/main/java/com/coze/loop/auth/Auth.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.auth;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/auth/JWTOAuthAuth.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.auth;
 
 import com.coze.loop.exception.AuthException;

cozeloop-core/src/main/java/com/coze/loop/auth/TokenAuth.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.auth;
 
 import com.coze.loop.exception.AuthException;

cozeloop-core/src/main/java/com/coze/loop/client/CozeLoopClient.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.client;
 
 import com.coze.loop.entity.ExecuteParam;

cozeloop-core/src/main/java/com/coze/loop/client/CozeLoopClientBuilder.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.client;
 
 import com.coze.loop.auth.Auth;

cozeloop-core/src/main/java/com/coze/loop/client/CozeLoopClientImpl.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.client;
 
 import com.coze.loop.entity.ExecuteParam;

cozeloop-core/src/main/java/com/coze/loop/config/CozeLoopConfig.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.config;
 
 import com.coze.loop.http.HttpConfig;

cozeloop-core/src/main/java/com/coze/loop/entity/ContentPart.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/ContentType.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonValue;

cozeloop-core/src/main/java/com/coze/loop/entity/ExecuteParam.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/ExecuteResult.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/LLMConfig.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/Message.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/Prompt.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/PromptTemplate.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/Role.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonValue;

cozeloop-core/src/main/java/com/coze/loop/entity/TemplateType.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonValue;

cozeloop-core/src/main/java/com/coze/loop/entity/TokenUsage.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/Tool.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/ToolCall.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/ToolCallConfig.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/UploadFile.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/entity/UploadSpan.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/VariableDef.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonProperty;

cozeloop-core/src/main/java/com/coze/loop/entity/VariableType.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.entity;
 
 import com.fasterxml.jackson.annotation.JsonValue;

cozeloop-core/src/main/java/com/coze/loop/exception/AuthException.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.exception;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/exception/CozeLoopException.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.exception;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/exception/ErrorCode.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.exception;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/exception/ExportException.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.exception;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/exception/PromptException.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.exception;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/exception/TraceException.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.exception;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/http/AuthInterceptor.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.http;
 
 import com.coze.loop.auth.Auth;

cozeloop-core/src/main/java/com/coze/loop/http/HttpClient.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.http;
 
 import com.coze.loop.auth.Auth;

cozeloop-core/src/main/java/com/coze/loop/http/HttpConfig.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.http;
 
 /**

cozeloop-core/src/main/java/com/coze/loop/http/LoggingInterceptor.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.http;
 
 import okhttp3.Interceptor;

cozeloop-core/src/main/java/com/coze/loop/http/RetryInterceptor.java

@@ -1,6 +1,3 @@
-// Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
-// SPDX-License-Identifier: MIT
-
 package com.coze.loop.http;
 
 import okhttp3.Interceptor;

cozeloop-core/src/main/java/com/coze/loop/internal/IdGenerator.java

@@ -0,0 +1,58 @@
+package com.coze.loop.internal;
+
+import java.security.SecureRandom;
+import java.util.Random;
+
+/**
+ * ID generator utility class.
+ */
+public final class IdGenerator {
+    private static final char[] HEX_CHARS = "0123456789abcdef".toCharArray();
+    private static final Random RANDOM = new SecureRandom();
+
+    private IdGenerator() {
+        // Utility class
+    }
+
+    /**
+     * Generate a 32-character hexadecimal trace ID.
+     *
+     * @return trace ID
+     */
+    public static String generateTraceId() {
+        return generateHexString(32);
+    }
+
+    /**
+     * Generate a 16-character hexadecimal span ID.
+     *
+     * @return span ID
+     */
+    public static String generateSpanId() {
+        return generateHexString(16);
+    }
+
+    /**
+     * Generate a hexadecimal string of specified length.
+     *
+     * @param length the length of the string
+     * @return hexadecimal string
+     */
+    public static String generateHexString(int length) {
+        char[] buffer = new char[length];
+        for (int i = 0; i < length; i++) {
+            buffer[i] = HEX_CHARS[RANDOM.nextInt(16)];
+        }
+        return new String(buffer);
+    }
+
+    /**
+     * Generate a UUID-like ID.
+     *
+     * @return UUID string
+     */
+    public static String generateUuid() {
+        return java.util.UUID.randomUUID().toString();
+    }
+}
+

cozeloop-core/src/main/java/com/coze/loop/internal/JsonUtils.java

@@ -0,0 +1,88 @@
+package com.coze.loop.internal;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.SerializationFeature;
+
+/**
+ * JSON utility class for serialization and deserialization.
+ */
+public final class JsonUtils {
+    private static final ObjectMapper MAPPER = new ObjectMapper()
+        .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
+        .configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);
+
+    private JsonUtils() {
+        // Utility class
+    }
+
+    /**
+     * Convert object to JSON string.
+     *
+     * @param obj the object to convert
+     * @return JSON string
+     */
+    public static String toJson(Object obj) {
+        if (obj == null) {
+            return null;
+        }
+        if (obj instanceof String) {
+            return (String) obj;
+        }
+        try {
+            return MAPPER.writeValueAsString(obj);
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("Failed to convert object to JSON", e);
+        }
+    }
+
+    /**
+     * Parse JSON string to object.
+     *
+     * @param json JSON string
+     * @param clazz target class
+     * @param <T> type parameter
+     * @return parsed object
+     */
+    public static <T> T fromJson(String json, Class<T> clazz) {
+        if (json == null || json.isEmpty()) {
+            return null;
+        }
+        try {
+            return MAPPER.readValue(json, clazz);
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("Failed to parse JSON to " + clazz.getName(), e);
+        }
+    }
+
+    /**
+     * Parse JSON string to object with TypeReference.
+     *
+     * @param json JSON string
+     * @param typeRef type reference
+     * @param <T> type parameter
+     * @return parsed object
+     */
+    public static <T> T fromJson(String json, TypeReference<T> typeRef) {
+        if (json == null || json.isEmpty()) {
+            return null;
+        }
+        try {
+            return MAPPER.readValue(json, typeRef);
+        } catch (JsonProcessingException e) {
+            throw new RuntimeException("Failed to parse JSON", e);
+        }
+    }
+
+    /**
+     * Get the ObjectMapper instance.
+     *
+     * @return ObjectMapper
+     */
+    public static ObjectMapper getMapper() {
+        return MAPPER;
+    }
+}
+