content: /*
   * Copyright 2024-2025 the original author or authors.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * You may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      https://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package io.agentscope.core.tool;
  
  import java.lang.annotation.Documented;
  import java.lang.annotation.ElementType;
  import java.lang.annotation.Retention;
  import java.lang.annotation.RetentionPolicy;
  import java.lang.annotation.Target;
  
  @Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
  @Retention(RetentionPolicy.RUNTIME)
  @Documented
  public @interface Tool {
  
      /**
       * The name of the tool. If not provided, the method name will be used.
       */
      String name() default "";
  
      /**
       * The description of the tool. If not provided, the method name will be used.
       */
      String description() default "";
  
      /**
       * Whether the tool result should be returned directly or passed back to the model.
       */
      boolean returnDirect() default false;
  
      /**
       * The class to use to convert the tool call result to a String.
       */
      Class<? extends ToolCallResultConverter> resultConverter() default
              DefaultToolCallResultConverter.class;
  }
  