type ToolAnnotations struct {
    ReadOnly             bool   // 是否只读（不修改任何状态）
    Destructive          bool   // 是否具有破坏性（可能导致数据丢失）
    Idempotent           bool   // 是否幂等（多次执行结果相同）
    OpenWorld            bool   // 是否涉及外部系统（网络、第三方API）
    RiskLevel            int    // 风险级别 (0-4)
    Category             string // 工具分类
    RequiresConfirmation bool   // 是否需要用户确认
}

import "github.com/astercloud/aster/pkg/tools"

// 安全只读操作（如 Read, Glob, Grep）
tools.AnnotationsSafeReadOnly

// 安全写入操作（如 Write）
tools.AnnotationsSafeWrite

// 破坏性写入（如删除文件）
tools.AnnotationsDestructiveWrite

// 命令执行（如 Bash）
tools.AnnotationsExecution

// 网络只读（如 WebFetch, WebSearch）
tools.AnnotationsNetworkRead

// 网络写入（如 HTTP POST）
tools.AnnotationsNetworkWrite

// 数据库只读
tools.AnnotationsDatabaseRead

// 数据库写入
tools.AnnotationsDatabaseWrite

// MCP 工具（动态加载）
tools.AnnotationsMCPTool

// 用户交互工具
tools.AnnotationsUserInteraction

import "github.com/astercloud/aster/pkg/tools"

type MyCustomTool struct {
    // ...
}

// 实现 Tool 接口
func (t *MyCustomTool) Name() string { return "MyTool" }
func (t *MyCustomTool) Description() string { return "自定义工具" }
func (t *MyCustomTool) InputSchema() map[string]any { return nil }
func (t *MyCustomTool) Execute(ctx context.Context, input map[string]any, tc *tools.ToolContext) (any, error) {
    // ...
}
func (t *MyCustomTool) Prompt() string { return "" }

// 实现 AnnotatedTool 接口
func (t *MyCustomTool) Annotations() *tools.ToolAnnotations {
    return &tools.ToolAnnotations{
        ReadOnly:    false,
        Destructive: false,
        Idempotent:  true,
        OpenWorld:   false,
        RiskLevel:   tools.RiskLevelLow,
        Category:    "custom",
    }
}

import "github.com/astercloud/aster/pkg/types"

config := &types.AgentConfig{
    PermissionMode: types.PermissionModeSmartApprove,
}

// 获取工具注解（兼容未实现接口的工具）
ann := tools.GetAnnotations(myTool)

// 判断是否可自动批准
if tools.IsToolSafeForAutoApproval(myTool) {
    // 自动执行
}

// 获取风险级别
riskLevel := tools.GetToolRiskLevel(myTool)
fmt.Printf("风险级别: %s\n", ann.RiskLevelName())