@gotza02/mathinking 3.1.1 → 3.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -103,6 +103,59 @@ Add to your `claude_desktop_config.json`:
|
|
|
103
103
|
|
|
104
104
|
---
|
|
105
105
|
|
|
106
|
+
## 🔍 Web Search Configuration
|
|
107
|
+
|
|
108
|
+
The `web_search` tool is **automatically registered** and available in `mathinking_body`. However, it requires at least one of the following API keys to function:
|
|
109
|
+
|
|
110
|
+
### Provider Priority (Fallback Chain)
|
|
111
|
+
|
|
112
|
+
1. **Brave Search** (Recommended - Fast & Reliable)
|
|
113
|
+
- Set `BRAVE_SEARCH_API_KEY`
|
|
114
|
+
- Get your key at: https://api.search.brave.com/app/keys
|
|
115
|
+
- Free tier available
|
|
116
|
+
|
|
117
|
+
2. **Exa.ai** (AI-Native Search)
|
|
118
|
+
- Set `EXA_API_KEY`
|
|
119
|
+
- Get your key at: https://exa.ai
|
|
120
|
+
- Excellent for semantic searches
|
|
121
|
+
|
|
122
|
+
3. **Google Custom Search** (Legacy)
|
|
123
|
+
- Set both `GOOGLE_SEARCH_API_KEY` and `GOOGLE_SEARCH_CX`
|
|
124
|
+
- Get API key at: https://console.cloud.google.com/apis/credentials
|
|
125
|
+
- Create Custom Search Engine at: https://programmablesearchengine.google.com
|
|
126
|
+
|
|
127
|
+
### Behavior Without API Keys
|
|
128
|
+
|
|
129
|
+
If no API keys are configured, `web_search` will return:
|
|
130
|
+
```json
|
|
131
|
+
{
|
|
132
|
+
"query": "your search query",
|
|
133
|
+
"source": "System",
|
|
134
|
+
"results": [{
|
|
135
|
+
"title": "Configuration Required",
|
|
136
|
+
"snippet": "Web search requires API keys. Configure BRAVE_SEARCH_API_KEY, EXA_API_KEY, or GOOGLE_SEARCH_API_KEY.",
|
|
137
|
+
"url": "https://github.com/gotza02/mathinking#configuration"
|
|
138
|
+
}]
|
|
139
|
+
}
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### Usage Example
|
|
143
|
+
|
|
144
|
+
```json
|
|
145
|
+
{
|
|
146
|
+
"id": "search_task",
|
|
147
|
+
"name": "Search for latest news",
|
|
148
|
+
"toolName": "web_search",
|
|
149
|
+
"toolInput": {
|
|
150
|
+
"query": "TypeScript latest features",
|
|
151
|
+
"numResults": 5,
|
|
152
|
+
"freshness": "week"
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
106
159
|
## 🤖 การตั้งค่าสำหรับ Claude และ Gemini (Memory/Instructions)
|
|
107
160
|
|
|
108
161
|
เพื่อให้ AI เข้าใจการใช้งาน Mathinking ได้อย่างมีประสิทธิภาพสูงสุด ควรตั้งค่าใน **Custom Instructions** (Claude) หรือ **System Instruction** (Gemini) ดังนี้:
|
|
@@ -161,7 +214,13 @@ You can define tasks that only run if a certain condition is met:
|
|
|
161
214
|
|
|
162
215
|
**Full changelog available in [CHANGELOG.md](CHANGELOG.md)**
|
|
163
216
|
|
|
164
|
-
### v3.1.
|
|
217
|
+
### v3.1.2 (Latest) - 📝 Documentation
|
|
218
|
+
- **Added:** Comprehensive web_search configuration section with provider details
|
|
219
|
+
- **Clarified:** web_search tool registration status and API key requirements
|
|
220
|
+
- **Added:** Provider priority fallback chain documentation (Brave > Exa > Google)
|
|
221
|
+
- **Added:** Usage examples for web_search tool
|
|
222
|
+
|
|
223
|
+
### v3.1.1 - 🐛 Bug Fixes
|
|
165
224
|
- **Critical:** Fixed array mutation bug in `evaluateOptions`
|
|
166
225
|
- **Critical:** Fixed empty array access with validation
|
|
167
226
|
- **High:** Fixed unsafe type casting with `Array.isArray()` check
|