entari-plugin-hyw 4.0.0rc5__py3-none-any.whl

entari_plugin_hyw/card-ui/src/components/StageCard.vue

@@ -0,0 +1,240 @@
+<script setup lang="ts">
+import { ref, computed } from 'vue'
+import { Icon } from '@iconify/vue'
+import type { Stage } from '../types'
+
+const props = defineProps<{
+  stage: Stage
+  isFirst?: boolean
+  isLast?: boolean
+  prevStageName?: string
+  refOffset?: number
+  hideRefs?: boolean
+}>()
+
+const failedImages = ref<Record<string, boolean>>({})
+const imageHeights = ref<Record<string, number>>({})
+
+function handleImageError(url: string) {
+  failedImages.value[url] = true
+}
+
+function handleImageLoad(url: string, event: Event) {
+  const img = event.target as HTMLImageElement
+  if (img.naturalWidth && img.naturalHeight) {
+    // Store aspect ratio as height per unit width
+    imageHeights.value[url] = img.naturalHeight / img.naturalWidth
+  }
+}
+
+// Compute two columns for masonry layout
+const imageColumns = computed(() => {
+  const images = props.stage.image_references || []
+  const leftColumn: typeof images = []
+  const rightColumn: typeof images = []
+  let leftHeight = 0
+  let rightHeight = 0
+
+  for (const img of images) {
+    if (failedImages.value[img.url]) continue
+    
+    // Get aspect ratio (default to 1 if not loaded yet)
+    const aspectRatio = imageHeights.value[img.url] || 1
+    
+    // Add to shorter column
+    if (leftHeight <= rightHeight) {
+      leftColumn.push(img)
+      leftHeight += aspectRatio
+    } else {
+      rightColumn.push(img)
+      rightHeight += aspectRatio
+    }
+  }
+
+  return { leftColumn, rightColumn }
+})
+
+
+
+
+
+function getDomain(url: string): string {
+  try {
+    const urlObj = new URL(url)
+    const hostname = urlObj.hostname.replace('www.', '')
+    const pathname = urlObj.pathname === '/' ? '' : urlObj.pathname
+    return hostname + pathname
+  } catch {
+    return url
+  }
+}
+
+function getFavicon(url: string): string {
+  const domain = getDomain(url)
+  return `https://www.google.com/s2/favicons?domain=${domain}&sz=32`
+}
+
+function formatTime(seconds: number): string {
+  return `${seconds.toFixed(2)}s`
+}
+
+function formatCost(dollars: number): string {
+  return dollars > 0 ? `$${dollars.toFixed(6)}` : '$0'
+}
+
+function getModelShort(model: string): string {
+  const short = model.includes('/') ? model.split('/').pop() || model : model
+  return short.length > 25 ? short.slice(0, 23) + '…' : short
+}
+
+function getStageTheme(name?: string) {
+  if (!name) return themes['default']
+  const key = name.toLowerCase()
+  
+  if (key.includes('search')) return themes['search']
+  if (key.includes('crawl') || key.includes('page')) return themes['crawler']
+  if (key.includes('agent')) return themes['agent']
+  if (key.includes('instruct')) return themes['instruct']
+  if (key.includes('vision')) return themes['vision']
+  
+  return themes['default']
+}
+
+const themes: Record<string, any> = {
+  'search': { color: 'text-blue-600', bg: 'bg-blue-50', iconBg: 'bg-blue-100/50', icon: 'mdi:magnify' },
+  'crawler': { color: 'text-orange-600', bg: 'bg-orange-50', iconBg: 'bg-orange-100/50', icon: 'mdi:web' },
+  'agent': { color: 'text-purple-600', bg: 'bg-purple-50', iconBg: 'bg-white/80', icon: 'mdi:robot' },
+  'instruct': { color: 'text-red-600', bg: 'bg-red-50', iconBg: 'bg-white/80', icon: 'mdi:lightning-bolt' },
+  'vision': { color: 'text-purple-600', bg: 'bg-purple-50', iconBg: 'bg-white/80', icon: 'mdi:eye' },
+  'default': { color: 'text-gray-600', bg: 'bg-gray-50', iconBg: 'bg-gray-100/50', icon: 'mdi:circle' }
+}
+
+function getIcon(name: string): string {
+  const key = name.toLowerCase()
+  if (key.includes('search')) return 'mdi:magnify'
+  if (key.includes('crawl') || key.includes('page')) return 'mdi:web'
+  if (key.includes('agent')) return 'mdi:robot'
+  if (key.includes('instruct')) return 'mdi:lightning-bolt'
+  if (key.includes('vision')) return 'mdi:eye'
+  return 'mdi:circle'
+}
+
+function getModelLogo(model: string): string | undefined {
+  if (!model) return undefined
+  const m = model.toLowerCase()
+  if (m.includes('openai') || m.includes('gpt')) return 'logos/openai.svg'
+  if (m.includes('claude') || m.includes('anthropic')) return 'logos/anthropic.svg'
+  if (m.includes('gemini') || m.includes('google')) return 'logos/google.svg'
+  if (m.includes('deepseek')) return 'logos/deepseek.png'
+  if (m.includes('huggingface')) return 'logos/huggingface.png'
+  if (m.includes('mistral')) return 'logos/mistral.png'
+  if (m.includes('perplexity')) return 'logos/perplexity.svg'
+  if (m.includes('cerebras')) return 'logos/cerebras.svg'
+  if (m.includes('grok')) return 'logos/grok.png'
+  if (m.includes('qwen')) return 'logos/qwen.png'
+  if (m.includes('minimax')) return 'logos/minimax.png'
+  if (m.includes('nvidia') || m.includes('nvida')) return 'logos/nvida.png'
+  if (m.includes('azure') || m.includes('microsoft')) return 'logos/microsoft.svg'
+  if (m.includes('xai')) return 'logos/xai.png'
+  if (m.includes('xiaomi')) return 'logos/xiaomi.png'
+  if (m.includes('zai')) return 'logos/zai.png'
+  return undefined
+}
+</script>
+
+<template>
+  <div class="relative">
+    <!-- Content -->
+    <div class="flex-1 min-w-0 pl-2">
+        <div class="rounded-none overflow-hidden bg-white">
+        
+          <!-- Header -->
+          <div :class="['bg-white px-4 py-2.5 flex items-center justify-between gap-3']">
+            <div class="flex items-center gap-3">
+              <div :class="['w-8 h-8 flex items-center justify-center shrink-0 overflow-hidden border border-gray-100', getStageTheme(stage.name).iconBg, getStageTheme(stage.name).color]">
+                <img v-if="getModelLogo(stage.model)" :src="getModelLogo(stage.model)" class="w-5 h-5 object-contain" />
+                <Icon v-else :icon="getIcon(stage.name)" class="text-lg" />
+              </div>
+              <div class="flex flex-col">
+                <span class="font-black text-[18px] text-gray-800 uppercase tracking-tight">{{ stage.name }}</span>
+                <span class="text-[15.5px] font-mono tabular-nums tracking-tighter" style="color: var(--text-muted)">{{ getModelShort(stage.model) }}</span>
+              </div>
+            </div>
+            <div v-if="stage.time > 0 || stage.cost > 0" class="text-[15.5px] font-mono flex items-center justify-end gap-2 leading-tight min-w-[120px]" style="color: var(--text-muted)">
+              <span v-if="stage.cost > 0">{{ formatCost(stage.cost) }}</span>
+              <span v-if="stage.time > 0 && stage.cost > 0" class="text-gray-300">·</span>
+              <span v-if="stage.time > 0">{{ formatTime(stage.time) }}</span>
+            </div>
+          </div>
+
+
+          <div v-if="stage.description" class="px-5 py-3 text-[14.5px] text-gray-600 bg-gray-50/40 border-y border-gray-100 italic leading-relaxed font-sans">
+             <span class="mr-1 text-[var(--theme-color)] not-italic opacity-50">✦</span> {{ stage.description }}
+          </div>
+
+          <div v-if="stage.references?.length || stage.image_references?.length || stage.crawled_pages?.length || stage.tasks?.length" class="bg-white pl-11 relative">
+            
+            <!-- Tasks List -->
+            <div v-if="stage.tasks?.length" class="pr-3 py-3 relative z-10 border-b border-gray-50 last:border-0">
+                <div v-for="(task, idx) in stage.tasks" :key="idx" class="flex items-start gap-2.5 mb-2 last:mb-0">
+                    <div class="w-4 h-4 rounded-full border border-[var(--theme-color)] flex items-center justify-center shrink-0 mt-0.5 bg-[var(--theme-color)]/10">
+                         <Icon icon="mdi:check" class="text-[10px] text-[var(--theme-color)]" />
+                    </div>
+                    <span class="text-[15px] text-gray-700 font-medium leading-tight select-text">{{ task }}</span>
+                </div>
+            </div>
+
+            <!-- Image Search Results - True Masonry Layout -->
+            <div v-if="stage.image_references?.length && !hideRefs" class="pr-3 py-3 relative z-10">
+              <div class="flex gap-2">
+                <!-- Left Column -->
+                <div class="flex-1 flex flex-col gap-2">
+                  <a v-for="(img, idx) in imageColumns.leftColumn" :key="`left-${img.url}-${idx}`" 
+                     :href="img.url" target="_blank" 
+                     class="relative overflow-hidden transition-all hover:opacity-90 group block">
+                    <img :src="img.thumbnail || img.url" 
+                         @load="handleImageLoad(img.url, $event)"
+                         @error="handleImageError(img.url)"
+                         class="w-full h-auto block group-hover:scale-[1.02] transition-transform">
+                  </a>
+                </div>
+                <!-- Right Column -->
+                <div class="flex-1 flex flex-col gap-2">
+                  <a v-for="(img, idx) in imageColumns.rightColumn" :key="`right-${img.url}-${idx}`" 
+                     :href="img.url" target="_blank" 
+                     class="relative overflow-hidden transition-all hover:opacity-90 group block">
+                    <img :src="img.thumbnail || img.url" 
+                         @load="handleImageLoad(img.url, $event)"
+                         @error="handleImageError(img.url)"
+                         class="w-full h-auto block group-hover:scale-[1.02] transition-transform">
+                  </a>
+                </div>
+              </div>
+            </div>
+
+            <div v-if="stage.crawled_pages?.length && !hideRefs" class="divide-y divide-gray-50 relative z-10">
+                <div v-for="(page, idx) in stage.crawled_pages" :key="idx" class="pr-3 py-3 hover:bg-gray-50 transition-colors group">
+                  <!-- Header Row: Title & Link -->
+                  <a :href="page.url" target="_blank" class="flex items-start gap-3 block">
+                    <img :src="getFavicon(page.url)" class="w-4 h-4 rounded-none shrink-0 object-contain mt-[4px]">
+                    <div class="flex-1 min-w-0 flex flex-col">
+                      <div class="flex items-center gap-2">
+                        <span class="flex-1 text-[18px] font-bold text-gray-700 truncate leading-tight tracking-tight group-hover:text-[var(--theme-color)] transition-colors">{{ page.title }}</span>
+                        <!-- Square Badge with Shadow -->
+                        <span class="shrink-0 w-[18px] h-[18px] text-[11px] font-bold flex items-center justify-center" style="background-color: var(--theme-color); color: var(--header-text-color); box-shadow: 0 1px 3px 0 rgba(0,0,0,0.15)">{{ (refOffset || 0) + (stage.references?.length || 0) + idx + 1 }}</span>
+                      </div>
+                      <div class="text-[15.5px] font-mono truncate mt-0.5 tracking-tighter" style="color: var(--text-muted)">{{ getDomain(page.url) }}</div>
+                    </div>
+                  </a>
+                  
+                  <!-- Description Sub-container -->
+                  <div v-if="page.description" class="ml-7 mt-2.5 p-3 bg-gray-100/80 text-[14px] text-gray-600 leading-snug font-sans border-l-[3px] border-[var(--theme-color)] rounded-r-sm">
+                      {{ page.description }}
+                  </div>
+                </div>
+            </div>
+          </div>
+        </div>
+    </div>
+  </div>
+</template>

entari_plugin_hyw/card-ui/src/main.ts

@@ -0,0 +1,5 @@
+import { createApp } from 'vue'
+import './style.css'
+import App from './App.vue'
+
+createApp(App).mount('#app')

entari_plugin_hyw/card-ui/src/style.css

@@ -0,0 +1,29 @@
+@import "tailwindcss";
+@plugin "daisyui";
+@plugin "@tailwindcss/typography";
+
+/* Custom styles */
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+/* Premium reading color scheme - applies to all prose elements */
+.prose {
+  color: var(--text-body, #3a3a3c) !important;
+}
+
+.prose h1, .prose h2, .prose h3, .prose h4, .prose h5, .prose h6 {
+  color: var(--text-primary, #2c2c2e) !important;
+}
+
+.prose p, .prose li, .prose td, .prose th {
+  color: var(--text-body, #3a3a3c) !important;
+}
+
+.prose strong, .prose b {
+  color: var(--text-primary, #2c2c2e) !important;
+}
+
+.prose code {
+  color: var(--text-body, #3a3a3c) !important;
+}

entari_plugin_hyw/card-ui/src/test_regex.js

@@ -0,0 +1,103 @@
+
+const stripPrefixBeforeH1 = (text) => {
+    const h1Match = text.match(/^#\s+/m)
+    if (h1Match && h1Match.index !== undefined) {
+        return text.substring(h1Match.index)
+    }
+    return text
+}
+
+const dedent = (text) => {
+    const lines = text.split('\n')
+    // Find minimum indentation of non-empty lines
+    let minIndent = Infinity
+    for (const line of lines) {
+        if (line.trim().length === 0) continue
+        const leadingSpace = line.match(/^\s*/)?.[0].length || 0
+        if (leadingSpace < minIndent) minIndent = leadingSpace
+    }
+
+    if (minIndent === Infinity || minIndent === 0) return text
+
+    return lines.map(line => {
+        if (line.trim().length === 0) return ''
+        return line.substring(minIndent)
+    }).join('\n')
+}
+
+const parse = (rawMd) => {
+    if (!rawMd) return []
+
+    const md = stripPrefixBeforeH1(rawMd)
+
+    let content = md.replace(/^#\s+.+$/m, '')
+    content = content.replace(/(?:^|\n)\s*(?:#{1,3}|\*\*)\s*(?:References|Citations|Sources)[\s\S]*$/i, '')
+    content = content.trim()
+
+    const sections = []
+
+    const combinedRegex = /(```[\s\S]*?```|((?:^|\n)\|[^\n]*\|(?:\n\|[^\n]*\|)*)|<summary>[\s\S]*?<\/summary>)/
+
+    let remaining = content
+
+    while (remaining) {
+        const match = remaining.match(combinedRegex)
+        if (!match) {
+            if (remaining.trim()) {
+                sections.push({ type: 'markdown', content: remaining.trim() })
+            }
+            break
+        }
+
+        const index = match.index
+        const matchedStr = match[0]
+        const preText = remaining.substring(0, index)
+
+        if (preText.trim()) {
+            sections.push({ type: 'markdown', content: preText.trim() })
+        }
+
+        const isCode = matchedStr.startsWith('```')
+        const isSummary = matchedStr.startsWith('<summary>')
+        const isTable = !isCode && !isSummary && matchedStr.trim().startsWith('|')
+
+        if (isCode || isTable || isSummary) {
+            let language = ''
+            let content = matchedStr.trim()
+
+            if (isCode) {
+                const match = matchedStr.match(/^```(\w+)/)
+                if (match && match[1]) language = match[1]
+            } else if (isSummary) {
+                content = content.replace(/^<summary>/, '').replace(/<\/summary>$/, '')
+                content = dedent(content)
+            }
+
+            sections.push({
+                type: 'card',
+                title: isCode ? 'Code' : (isSummary ? 'Summary' : 'Table'),
+                content: content,
+                contentType: isCode ? 'code' : (isSummary ? 'summary' : 'table'),
+                language: language
+            })
+        } else {
+            sections.push({ type: 'markdown', content: matchedStr })
+        }
+
+        remaining = remaining.substring(index + matchedStr.length)
+    }
+
+    return sections
+}
+
+const test1 = `
+# Title
+
+<summary>
+    Indented text.
+    It might become code block.
+</summary>
+`
+
+console.log("\n--- Test 2 (After Fix) ---")
+console.log(JSON.stringify(parse(test1), null, 2))

entari_plugin_hyw/card-ui/src/types.ts

@@ -0,0 +1,61 @@
+// Type definitions for render data
+// Python only passes raw data, all processing happens in frontend
+
+export interface Stage {
+    name: string
+    model: string
+    provider: string
+    icon_name?: string  // Icon identifier (e.g., "google", "openai")
+    icon_config?: string // Config key for icon (e.g. "openai")
+    time: number        // Time in seconds (raw number)
+    cost: number        // Cost in dollars (raw number)
+    usage?: any         // Token usage stats
+    references?: Reference[]
+    image_references?: ImageReference[]
+    crawled_pages?: CrawledPage[]
+    description?: string // Brief intro or thought for this stage
+    tasks?: string[]
+}
+
+export interface Reference {
+    title: string
+    url: string
+    is_fetched?: boolean
+    snippet?: string
+    type?: string
+    images?: string[]  // Extracted images (base64)
+}
+
+export interface ImageReference {
+    title: string
+    url: string
+    thumbnail?: string
+}
+
+export interface CrawledPage {
+    title: string
+    url: string
+    description?: string
+}
+
+export interface Stats {
+    total_time?: number
+    vision_duration?: number
+}
+
+export interface Flags {
+    has_vision: boolean
+    has_search: boolean
+}
+
+// Raw data from Python - minimal processing
+export interface RenderData {
+    markdown: string          // Raw markdown content
+    stages: Stage[]
+    references: Reference[]   // All references for citation
+    page_references: Reference[]
+    image_references: ImageReference[]
+    stats: Stats
+    total_time: number
+    theme_color?: string      // Configurable theme color (hex)
+}

entari_plugin_hyw/card-ui/tsconfig.app.json

@@ -0,0 +1,16 @@
+{
+  "extends": "@vue/tsconfig/tsconfig.dom.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "types": ["vite/client"],
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
+}

entari_plugin_hyw/card-ui/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

entari_plugin_hyw/card-ui/tsconfig.node.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "target": "ES2023",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "types": ["node"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["vite.config.ts"]
+}

entari_plugin_hyw/card-ui/vite.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import tailwindcss from '@tailwindcss/vite'
+import { viteSingleFile } from 'vite-plugin-singlefile'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    tailwindcss(),
+    viteSingleFile(),
+  ],
+  build: {
+    outDir: '../assets/card-dist',
+    emptyOutDir: true,
+  },
+})

entari_plugin_hyw/definitions.py

@@ -0,0 +1,130 @@
+"""
+Centralized Definitions
+
+All global prompts and tool definitions for the pipeline stages.
+"""
+
+from typing import Dict, Any
+
+# =============================================================================
+# PROMPTS
+# =============================================================================
+
+INSTRUCT_SP = """你是一个智能 INSTRUCT 助手。
+你的目标是为用户的查询制定调研计划并执行。
+> 尽量完成所有搜索和获取, 需要的时候可以并发执行多个同种或不同种工具
+
+- 用户消息包含典型名词、可能的专有名词组合: 调用 `web_search` 工具(最大3)。
+    - 提炼消息中出独立的关键词搜索关键词本身, 不添加任何其他辅助搜索词, 搜索效果最好
+    - 不混合搜索词, 每次只针对搜索一个关键词, 获取其目的方向的最新数据
+- 用户消息中出现链接时, 调用 `crawl_page`(最大3) 获取网页全文
+- 以下情况调用 `refuse_answer`。
+    - 明显的鉴证、国家领导人、历史敏感事件隐喻
+    - 过于露骨的r18+、r18g内容(但不包括 galgame等acg向, 除非其过于违规)
+
+
+## 重要规则 (CRITICAL RULES)：
+- 禁止输出任何文本回复：你必须且只能通过工具调用来行动。
+- 禁止回答用户的问题：你的任务仅仅是收集信息，回答将由后续阶段完成。
+- 禁止解释你的行为：不要输出思考过程或计划描述，直接调用工具。
+- 如果没有工具调用，流程将自动结束。
+"""
+
+INSTRUCT_REVIEW_SP = """你是一个智能 INSTRUCT 审查助手, 你需要对 INSTRUCT 的输出进行二次信息补充或直接通过(不进行操作)
+
+
+- 你已经使用过 `web_search` 工具, 不推荐再次使用, 即便你微调搜索词也只能获取重复信息
+- 推荐使用 `crawl_page` 工具查看官方网站、wiki网站(但不推荐维基百科)、权威网站
+    - crawl_page 永远不使用国内垃圾网站例如 csdn、知乎、等重复搬运二手信息的网站
+    
+## 重要规则 (CRITICAL RULES)：
+- 禁止输出任何文本回复：你必须且只能通过工具调用来行动。
+- 禁止回答用户的问题：你的任务仅仅是收集信息。
+- 禁止解释你的行为：直接调用所需工具。
+- 如果没有必要进一步操作，请不要输出任何内容（空回复），流程将自动进入下一阶段。
+"""
+
+
+SUMMARY_REPORT_SP = """# 你是一个信息整合专家 (Summary Agent).
+你需要根据用户问题、搜索结果和网页详细内容，生成最终的回答.
+如果用户发送你好或空内容回应你好即可.
+
+## 过程要求
+- 用户要求的回复语言(包裹在 language 标签内)
+```language
+{language}
+```
+- 字数控制在600字以内, 百科式风格, 语言严谨不啰嗦.
+- 视觉信息: 输入中如果包含自动获取的网页截图，请分析图片中的信息作为参考.
+- 注意分辨搜索内容是否和用户问题有直接关系, 避免盲目相信混为一谈.
+- 正文格式: 
+  - 先给出一个 `# `大标题约 8-10 个字, 不要有多余废话, 不要直接回答用户的提问.
+  - 然后紧接着给出一个 <summary>...</summary>, 除了给出一个约 100 字的纯文本简介, 介绍本次输出的长文的清晰、重点概括.
+  - 随后开始详细二级标题 + markdown 正文, 语言描绘格式丰富多样, 简洁准确可信.
+  - 请不要给出过长的代码、表格列数等, 只讲重点和准确的数据.
+  - 不支持渲染: 链接, 图片链接, mermaid
+  - 支持渲染: 公式, 代码高亮, 只在需要的时候给出.
+  - 图片链接、链接框架会自动渲染出, 你无需显式给出.
+- 引用:
+  > 重要: 所有正文内容必须基于实际信息, 保证百分百真实度
+  - 信息来源已按获取顺序编号为 [1], [2], [3]... 但不超过 9 个引用.
+  - 优先引用优质 fetch 抓取的页面的资源, 但如果抓取到需要登录、需要验证码、需要跳转到其他网站等无法获取的资源, 则不引用此资源
+  - 正文中直接使用 [1] 格式引用, 只引用对回答有帮助的来源, 只使用官方性较强的 wiki、官方网站、资源站等等, 不使用第三方转载新闻网站.
+  - 无需给出参考文献列表, 系统会自动生成
+"""
+
+
+# =============================================================================
+# TOOL DEFINITIONS
+# =============================================================================
+
+def get_refuse_answer_tool() -> Dict[str, Any]:
+    """Tool for refusing to answer inappropriate content."""
+    return {
+        "type": "function",
+        "function": {
+            "name": "refuse_answer",
+            "description": "违规内容拒绝回答",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "reason": {"type": "string", "description": "拒绝回答的原因（展示给用户）"},
+                },
+                "required": ["reason"],
+            },
+        },
+    }
+
+
+def get_web_search_tool() -> Dict[str, Any]:
+    """Tool for searching the web."""
+    return {
+        "type": "function",
+        "function": {
+            "name": "internal_web_search",
+            "description": "网络搜索",
+            "parameters": {
+                "type": "object",
+                "properties": {"query": {"type": "string"}},
+                "required": ["query"],
+            },
+        },
+    }
+
+
+def get_crawl_page_tool() -> Dict[str, Any]:
+    """Tool for crawling a web page."""
+    return {
+        "type": "function",
+        "function": {
+            "name": "crawl_page",
+            "description": "抓取网页并返回 Markdown 文本 / 网页截图",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "url": {"type": "string"},
+                },
+                "required": ["url"],
+            },
+        },
+    }