@konbakuyomu/smart-search-linux-x64 0.1.29 → 0.1.30-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konbakuyomu/smart-search-linux-x64",
-  "version": "0.1.29",
+  "version": "0.1.30-beta.1",
   "description": "Self-contained Smart Search CLI for linux/x64",
   "license": "MIT",
   "repository": {

package/runtime/smart-search/_internal/certifi/cacert.pem

@@ -1975,6 +1975,87 @@ jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw
 3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0=
 -----END CERTIFICATE-----
 
+# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign Root CA - G1"
+# Serial: 235931866688319308814040
+# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac
+# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c
+# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67
+-----BEGIN CERTIFICATE-----
+MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD
+VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU
+ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH
+MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO
+MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv
+Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN
+BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz
+f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO
+8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq
+d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM
+tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt
+Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB
+o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD
+AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x
+PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM
+wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d
+GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH
+6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby
+RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
+iN66zB+Afko=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign Root CA - C1"
+# Serial: 825510296613316004955058
+# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68
+# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01
+# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f
+-----BEGIN CERTIFICATE-----
+MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG
+A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg
+SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v
+dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ
+BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ
+HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH
+3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH
+GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c
+xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1
+aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq
+TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87
+/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4
+kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG
+YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT
++xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo
+WXzhriKi4gp6D/piq1JM4fHfyr6DDUI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign ECC Root CA - C3"
+# Serial: 582948710642506000014504
+# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5
+# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66
+# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3
+-----BEGIN CERTIFICATE-----
+MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG
+EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx
+IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND
+IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci
+MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti
+sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O
+BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB
+Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c
+3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J
+0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ==
+-----END CERTIFICATE-----
+
 # Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post
 # Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post
 # Label: "Hongkong Post Root CA 3"

package/runtime/smart-search/_internal/smart_search/assets/i18n/messages.json

@@ -17931,14 +17931,6 @@
     "没有在 WSL 中找到 smart-search。请先在 WSL 中安装 CLI，并确认 bash 能直接运行 smart-search。",
     "smart-search was not found in WSL. Install the CLI in WSL first and make sure bash can run smart-search directly."
   ],
-  "位于 WSL {0}，使用该发行版中的配置和 Skills。请在 WSL 终端用原安装方式更新 CLI。": [
-    "位于 WSL {0}，使用该发行版中的配置和 Skills。请在 WSL 终端用原安装方式更新 CLI。",
-    "Installed in WSL {0}; it uses that distribution's configuration and Skills. Update the CLI from a WSL terminal with the tool you installed it with."
-  ],
-  "WSL {0} 中的 CLI 版本过旧，App 无法连接。请在 WSL 终端更新：npm install -g @konbakuyomu/smart-search@latest": [
-    "WSL {0} 中的 CLI 版本过旧，App 无法连接。请在 WSL 终端更新：npm install -g @konbakuyomu/smart-search@latest",
-    "The CLI in WSL {0} is too old for the App to connect. Update it from a WSL terminal: npm install -g @konbakuyomu/smart-search@latest"
-  ],
   "旧版": [
     "旧版",
     "old version"
@@ -17966,5 +17958,69 @@
   "{0} · 需要更新": [
     "{0} · 需要更新",
     "{0} · update needed"
+  ],
+  "位于 WSL {0}，使用该发行版中的配置和 Skills。": [
+    "位于 WSL {0}，使用该发行版中的配置和 Skills。",
+    "Installed in WSL {0}; it uses that distribution's configuration and Skills."
+  ],
+  "WSL {0} 中的 CLI 版本过旧，App 无法连接。": [
+    "WSL {0} 中的 CLI 版本过旧，App 无法连接。",
+    "The CLI in WSL {0} is too old for the App to connect."
+  ],
+  "此 CLI 由 mise 管理，请在 WSL 终端更新：mise use -g npm:@konbakuyomu/smart-search@latest": [
+    "此 CLI 由 mise 管理，请在 WSL 终端更新：mise use -g npm:@konbakuyomu/smart-search@latest",
+    "mise manages this CLI. Update it from a WSL terminal: mise use -g npm:@konbakuyomu/smart-search@latest"
+  ],
+  "npm 全局目录需要管理员权限，请在 WSL 终端更新：sudo npm install -g @konbakuyomu/smart-search@latest": [
+    "npm 全局目录需要管理员权限，请在 WSL 终端更新：sudo npm install -g @konbakuyomu/smart-search@latest",
+    "Its npm global directory needs administrator rights. Update it from a WSL terminal: sudo npm install -g @konbakuyomu/smart-search@latest"
+  ],
+  "App 无法确定它的安装方式，请在 WSL 终端用原安装方式更新。": [
+    "App 无法确定它的安装方式，请在 WSL 终端用原安装方式更新。",
+    "The App cannot tell how it was installed. Update it from a WSL terminal with the tool you installed it with."
+  ],
+  "WSL {0} 的 npm 全局目录需要管理员权限，App 不使用 sudo。请在 WSL 终端运行：sudo npm install -g @konbakuyomu/smart-search@latest": [
+    "WSL {0} 的 npm 全局目录需要管理员权限，App 不使用 sudo。请在 WSL 终端运行：sudo npm install -g @konbakuyomu/smart-search@latest",
+    "The npm global directory in WSL {0} needs administrator rights, and the App does not use sudo. In a WSL terminal, run: sudo npm install -g @konbakuyomu/smart-search@latest"
+  ],
+  "WSL {0} 中的 Node.js 没有配套的 npm。请重新安装 Node.js，再点击“检测 WSL”。": [
+    "WSL {0} 中的 Node.js 没有配套的 npm。请重新安装 Node.js，再点击“检测 WSL”。",
+    "Node.js in WSL {0} has no matching npm. Reinstall Node.js, then click Detect WSL."
+  ],
+  "WSL {0} 中没有找到 Node.js 18 或更新版本。请先在 WSL 中安装 Node.js，再点击“检测 WSL”。": [
+    "WSL {0} 中没有找到 Node.js 18 或更新版本。请先在 WSL 中安装 Node.js，再点击“检测 WSL”。",
+    "No Node.js 18 or later was found in WSL {0}. Install Node.js in WSL, then click Detect WSL."
+  ],
+  "{0} 中的 CLI 已安装或更新为 {1}。": [
+    "{0} 中的 CLI 已安装或更新为 {1}。",
+    "The CLI in {0} is now {1}."
+  ],
+  "更新 {0} 中的 CLI": [
+    "更新 {0} 中的 CLI",
+    "Update the CLI in {0}"
+  ],
+  "这些环境还没有 Smart Search CLI。安装使用该环境自己的 npm，不会改动其他环境。": [
+    "这些环境还没有 Smart Search CLI。安装使用该环境自己的 npm，不会改动其他环境。",
+    "These environments have no Smart Search CLI yet. Installing uses that environment's own npm and leaves the others unchanged."
+  ],
+  "安装到 {0}": [
+    "安装到 {0}",
+    "Install in {0}"
+  ],
+  "在 WSL 中安装 Node.js": [
+    "在 WSL 中安装 Node.js",
+    "Install Node.js in WSL"
+  ],
+  "未安装 CLI 的环境": [
+    "未安装 CLI 的环境",
+    "Environments without the CLI"
+  ],
+  "WSL {0} · npm {1} · {2}": [
+    "WSL {0} · npm {1} · {2}",
+    "WSL {0} · npm {1} · {2}"
+  ],
+  "正在卸载 CLI…": [
+    "正在卸载 CLI…",
+    "Removing the CLI…"
   ]
 }

package/runtime/smart-search/_internal/smart_search-0.1.30b1.dist-info/METADATA

@@ -0,0 +1,294 @@
+Metadata-Version: 2.4
+Name: smart-search
+Version: 0.1.30b1
+Summary: CLI-first multi-source web research with xAI/OpenAI-compatible search, Exa, Context7, Zhipu, Tavily, Firecrawl, and Deep Research planning.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx[socks]>=0.28.0
+Requires-Dist: InquirerPy<0.4,>=0.3.4
+Requires-Dist: pyfiglet<2,>=1.0
+Requires-Dist: rich<16,>=13.9
+Requires-Dist: tenacity>=8.0.0
+Provides-Extra: dev
+Requires-Dist: PyYAML<7,>=6.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/konbakuyomu/smartsearch/main/assets/branding/smart-search.png" alt="Smart Search" width="104">
+
+# Smart Search
+
+### Let your AI search the web, read the original pages, and answer with sources you can check
+
+**You pick the providers and bring the keys. Jev decides which channel each question should go to.**
+
+[简体中文](README.zh-CN.md) | English
+
+[![npm](https://img.shields.io/npm/v/@konbakuyomu/smart-search?style=flat-square&color=4A62C9&label=npm)](https://www.npmjs.com/package/@konbakuyomu/smart-search)
+[![CI](https://img.shields.io/github/actions/workflow/status/konbakuyomu/smartsearch/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/konbakuyomu/smartsearch/actions/workflows/ci.yml)
+[![App](https://img.shields.io/badge/App-Windows%20%7C%20macOS-728CE2?style=flat-square)](https://github.com/konbakuyomu/smartsearch/releases/latest)
+[![Node.js](https://img.shields.io/badge/Node.js-18%2B-3C873A?style=flat-square)](https://nodejs.org/)
+[![Skills](https://img.shields.io/badge/Skills-17%20Agents-D97757?style=flat-square)](#supported-ai-tools)
+[![License](https://img.shields.io/badge/license-MIT-2F9E4F?style=flat-square)](https://github.com/konbakuyomu/smartsearch/blob/main/LICENSE)
+
+[Download the App](https://github.com/konbakuyomu/smartsearch/releases/latest) · [User guide](https://github.com/konbakuyomu/smartsearch/tree/main/docs/guide) · [Jev routing](https://github.com/konbakuyomu/smartsearch/blob/main/docs/jev-routing.md) · [Report a problem](https://github.com/konbakuyomu/smartsearch/issues)
+
+[See it](#see-it) · [Quick start](#quick-start) · [Everyday use](#everyday-use) · [How it works](#how-it-works) · [Providers](#capabilities-and-providers) · [Commands](#common-commands) · [FAQ](#faq)
+
+<code>npm install -g @konbakuyomu/smart-search@latest</code>
+
+</div>
+
+<br>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/konbakuyomu/smartsearch/main/docs/media/jev-routing.gif" alt="The same question twice: the built-in search on the left is still spinning; on the right, Jev scores the candidate channels and Smart Search dispatches the best one and returns sources" width="100%">
+</p>
+<p align="center"><sub>The same question, asked with the built-in search (left) and with Smart Search (right): Jev scores every configured channel and dispatches only the highest one above the threshold. The numbers shown are examples. Animations are in Chinese.</sub></p>
+
+> [!IMPORTANT]
+> Smart Search does not provide search itself. Searching and page reading are done by the providers you choose, with API keys you supply, saved in your local configuration folder. Provider tests and searches may use those providers' paid quota; opening the App or checking the local environment never runs a paid search.
+
+## What it is
+
+Smart Search puts search, page reading and provider configuration in one place and connects them to AI tools such as Codex, Claude Code and Cursor. It has three parts:
+
+| Part | What it does |
+| --- | --- |
+| **Independent CLI** (`smart-search`) | Runs searches, page reads and live research; your AI goes online through it |
+| **Desktop App** (Windows / macOS) | Installs the CLI, configures providers, updates Skills, searches and shows activity |
+| **Skills** | Instructions installed into your AI tools that tell them when and how to call the CLI |
+
+The App only manages; after you close it, your AI keeps calling the CLI as its Skill describes.
+
+It helps when you are:
+
+- **Working with a library or API:** find current documentation and read the relevant pages.
+- **Following recent changes:** look up announcements or news newer than a model's knowledge.
+- **Checking a claim:** find its source, read the page, and compare it with other evidence.
+- **Researching a larger question:** collect sources over several rounds, inspect gaps, and build a cited answer.
+
+## See it
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="https://raw.githubusercontent.com/konbakuyomu/smartsearch/main/docs/media/ask-ai.gif" alt="In an AI tool, ask it to use Smart Search; it searches, reads the original page, and answers with sources">
+      <p><b>Ask your AI</b><br><sub>Say three things: use Smart Search, read the relevant page, give the sources. The AI searches, reads the original page and cites it.</sub></p>
+    </td>
+    <td width="50%" valign="top">
+      <img src="https://raw.githubusercontent.com/konbakuyomu/smartsearch/main/docs/media/app-setup.gif" alt="On the App's Providers page, paste an Exa API key, test it, then save">
+      <p><b>Configure a provider in the App</b><br><sub>Pick a provider, paste its key, test it (one real request), then save.</sub></p>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="https://raw.githubusercontent.com/konbakuyomu/smartsearch/main/docs/media/app-search.gif" alt="On the App's Search & research page, run a search; the result and its source links appear together">
+      <p><b>Search in the App</b><br><sub>On Search &amp; research, pick a tool and enter a question; the result comes with its source links, ready to copy or export.</sub></p>
+    </td>
+    <td width="50%" valign="top">
+      <p><b>The full videos</b></p>
+      <sub>The feature film, the setup tutorial and the everyday-use tutorial are <a href="#full-videos">below</a>. All three are rendered frame by frame from code; their sources are in <a href="promo/"><code>promo/</code></a> and can be rebuilt locally.</sub>
+      <br><br>
+      <sub>Clawd in the animations is an unofficial fan depiction, not affiliated with Anthropic. The App screens are a redrawn illustration of the Windows App, with text taken from its source.</sub>
+    </td>
+  </tr>
+</table>
+
+### Full videos
+
+The captions are in Chinese.
+
+**The feature film, “The Same Question”** (53 s): the same question asked with the built-in search and with Smart Search, side by side: Jev routing, search, reading the original page, and an answer with sources.
+
+https://github.com/user-attachments/assets/8909f8b9-394b-4617-b6bb-3c8b6904efc6
+
+**Setup tutorial** (69 s): the Windows App page by page: install the CLI, add and test an API key, turn on Jev routing, update Skills.
+
+https://github.com/user-attachments/assets/d2b17aea-1abe-4658-808a-1f212649e5e1
+
+**Everyday use** (62 s): ask your AI directly, search and research in the App, read Activity, the common commands, and keep working after closing the App.
+
+https://github.com/user-attachments/assets/915cb409-e012-4aa4-8910-3d213f732386
+
+## Quick start
+
+### With the App (recommended)
+
+1. **Install the App and the CLI.** Download the package for your system from [Releases](https://github.com/konbakuyomu/smartsearch/releases/latest). Step 1 on **Overview** finds npm on your machine (or takes a manual path); **Install CLI** installs and connects the independent CLI. On Windows with a WSL distribution, each environment gets its own button: **Install in Windows** and **Install in WSL &lt;distribution&gt;** (WSL needs Node.js 18 or later).
+2. **Configure providers.** On **Providers**, choose one provider each for main search, documentation search and page fetching, enter its API key, click **Test**, then **Save changes**. Each provider has a **Get API key** link. One working retrieval channel is enough to search; with all three, routing has more channels to choose from.
+3. **Turn on Jev routing (optional).** Under **Providers → Intent routing**, enter a TypeSafe API key. The router mode defaults to **JEV semantic routing**; without a key, channels are chosen by local rules.
+4. **Connect your AI tools.** On **Update Skills**, select your Agents (Codex, Claude Code and Cursor are selected by default) and click **Update selected Skills**. Files that differ are backed up first and extra files are kept. Reopen your Agent session and start asking.
+
+Page-by-page instructions: [Set up and use the App](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/app.md).
+
+### Terminal only
+
+```sh
+npm install -g @konbakuyomu/smart-search@latest
+smart-search setup          # terminal wizard; smart-search ui opens a local configuration page instead
+smart-search doctor --format json
+```
+
+The npm CLI needs only Node.js 18+. Its platform package includes the Python runtime and does not use a user-installed Python. For a uv source installation or a fixed Python version, see [CLI installation](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/cli.md#cli-installation).
+
+## Everyday use
+
+**In your AI tool:** ask naturally, for example:
+
+> Use Smart Search to find the current React documentation for useEffect cleanup. Read the relevant page and include the source.
+
+> Use Smart Search to check the claims in this page: https://example.com/article
+
+| You say | It does |
+| --- | --- |
+| "Look up the current docs for X" | `search`: Jev picks one channel, which returns results and sources |
+| "Read this link" | `fetch`: reads the page as clean text |
+| "Check this claim" | Finds the source, `fetch`es the original, cites the pages it read |
+| "Research X in depth" | `research`: several rounds of retrieval and reading; Jev judges each round whether the evidence is enough |
+
+**In the App:** open **Search & research**, choose a tool (Search, Read page, Live research and more), enter a question or URL, and read the result and its **Source links** on the right; copy or export it. **Activity** shows each task's status, phase and provider, including tasks your AI started from the terminal.
+
+**Language:** the App follows your system by default; choose Chinese or English in **Settings & about → Interface language**. The CLI keeps its own language preference and accepts a one-command `--lang en` / `--lang zh`. These settings change the interface and messages, not the text of a source page.
+
+## How it works
+
+The default intent router is **Jev semantic routing** (`SMART_SEARCH_INTENT_ROUTER=jev`); the judgments come from TypeSafe's Jev model:
+
+```mermaid
+flowchart LR
+    Q["Your question"] --> C["Candidate operations<br/>configured, enabled channels only"]
+    C --> J["Jev judges each one<br/>one Noul probability per candidate"]
+    J --> F{"Above 0.5?<br/>sorted by probability"}
+    F -- "search" --> S["Dispatch the top one"]
+    F -- "research" --> R["Dispatch several per round, concurrently"]
+    R --> E{"Enough evidence?<br/>threshold 0.75"}
+    E -- "gaps remain" --> R
+    E -- "enough" --> A["Result cites only pages actually read"]
+    S --> A2["Results and sources"]
+```
+
+- **The program lists the candidates; Jev only chooses.** Each candidate carries its provider, operation, capability, the actual query or URL, and your preference order, never a channel key. Jev does not write free-form queries or make tool calls.
+- **search routes once.** It picks one suitable channel and returns results and sources, without sufficiency assessment, follow-up searches, filtering or synthesis; its `evidence_assessment.status` is `not_evaluated`. A successful retrieval is not a verified fact.
+- **research follows the evidence gaps.** Each round Jev picks complementary actions that run concurrently, discovered pages are read, and the evidence is judged for a direct answer, detail, freshness, authority and corroboration. Only fetched or read text enters the citations.
+- **It still works without Jev.** Without a TypeSafe key, or without a valid judgment, the default `--fallback auto` routes by local capability rules and marks the result as degraded; `--fallback off` fails instead. Explicit `local` mode never calls Jev.
+- **Budgets are bounded.** Live research at quick / standard / deep allows at most 2 / 3 / 10 rounds and 1 / 2 / 10 channels per round, further limited by your Jev settings (3 rounds and 3 channels by default), and stops early once the evidence is enough.
+
+The thresholds are a starting policy and do not guarantee a correct judgment. The full description, settings and output fields are in [Jev multi-channel routing](https://github.com/konbakuyomu/smartsearch/blob/main/docs/jev-routing.md) (Chinese).
+
+## Capabilities and providers
+
+One provider per capability is enough. Enter keys on the App's **Providers** page or save them with `smart-search config set`.
+
+| Capability | Providers | What it does |
+| --- | --- | --- |
+| Main search | xAI, OpenAI-compatible API | A model searches the web and answers with citations |
+| Documentation search | Context7, Exa | Library, API and official documentation pages |
+| Web search | Zhipu, Zhipu Coding Plan, Tavily, TinyFish, DeepSeek, Firecrawl | Discovers pages and excerpts |
+| Page fetching | Jina, Firecrawl, Zhipu page reading, Tavily, TinyFish, DeepSeek | Reads a known URL as clean text |
+| Vertical retrieval (experimental) | AnySearch, SciVerse | Domain and academic retrieval; SciVerse runs only when named explicitly |
+| Intent routing (optional) | Jev (TypeSafe) | Scores candidate channels and routes |
+
+## Supported AI tools
+
+Skills can be installed for 17 targets: Codex, Claude Code, Cursor, OpenCode, GitHub Copilot, Gemini CLI, Cline, Roo Code, Kiro, Qoder, CodeBuddy, Factory Droid, Pi Agent, Kilo CLI, Antigravity, Windsurf and Hermes Agent. Install and sign in to the Agent applications yourself.
+
+## Common commands
+
+| Command | What it does |
+| --- | --- |
+| `smart-search search "question" --format markdown` | Ordinary search: one channel, results and sources |
+| `smart-search fetch "https://…" --format markdown` | Reads a page as clean text |
+| `smart-search research "question" --budget standard` | Live research: rounds of retrieval and reading, with evidence judgments |
+| `smart-search deep "question" --budget standard` | Writes a research plan only; no network, no cost |
+| `smart-search route "question"` | Previews routing locally without calling providers; `--remote` calls Jev (may be billed) |
+| `smart-search doctor --format json` | Probes every configured provider with real requests |
+| `smart-search setup` / `smart-search ui` | Terminal wizard / temporary local configuration page |
+| `smart-search skills status` / `skills update` | Checks or syncs installed Skills |
+
+All commands: [Complete command reference](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/cli-reference.md).
+
+## FAQ
+
+<details>
+<summary><strong>How many providers do I need?</strong></summary>
+
+One working retrieval channel is enough to search. The App's **Check configuration** and Overview ask for main search, documentation search and page fetching; with all three, routing has enough channels to choose from and page reading has a dedicated fetcher.
+
+</details>
+
+<details>
+<summary><strong>Does it work without a TypeSafe key?</strong></summary>
+
+Yes. Jev is optional. Without a key, channels are chosen by local capability rules and the result is marked as degraded; you can also pick **Local routing** under **Intent routing**.
+
+</details>
+
+<details>
+<summary><strong>Does it work with the App closed?</strong></summary>
+
+Yes. Searches run in the independent CLI, which your AI calls as its Skill describes. If tasks the App started are still running when you close it, the App asks whether to **Continue in background** or **Cancel tasks and quit**; cancelling affects only the App's own tasks, never an external CLI.
+
+</details>
+
+<details>
+<summary><strong>Does it cost money?</strong></summary>
+
+Smart Search itself is free and open source. Provider tests, searches, `doctor` and `route --remote` call the services you configured and may use their quota. `route` without `--remote`, `deep` and opening the App never make paid requests.
+
+</details>
+
+<details>
+<summary><strong>How is this different from an AI tool's built-in web search?</strong></summary>
+
+You choose the providers and can configure several; Jev picks a channel for each question; and the pages behind an answer can be fetched and checked in full. The Skill tells the AI to use Smart Search alone for web research within a task instead of mixing routes.
+
+</details>
+
+<details>
+<summary><strong>Windows shows SmartScreen; macOS cannot verify the developer</strong></summary>
+
+Windows `-signed.exe` packages use a self-signed certificate and may still trigger SmartScreen; see [Windows signatures and first launch](docs/windows-signing.md). macOS packages use ad-hoc bundle integrity signing and separate Sparkle EdDSA update signatures, without Developer ID signing or notarization.
+
+</details>
+
+<details>
+<summary><strong>How do the App and the CLI update?</strong></summary>
+
+Separately. The App checks under **Settings & about → App Updates** and downloads only after you confirm. Update the CLI from **Overview → 1. Prepare local environment**, or run `npm install -g @konbakuyomu/smart-search@latest`. After an upgrade the CLI maintains connected Skills and preserves personal edits.
+
+</details>
+
+## Known limits
+
+- A search hit is a lead. Read the source before relying on an important claim.
+- Ordinary search does not assess evidence; use live research, or have your AI read the original page, when a claim needs checking.
+- Jev's thresholds (0.5 for routing, 0.75 for sufficient evidence) are a starting policy and need calibrating against real questions.
+- Availability, quota and result quality depend on each provider.
+- Existing Inno installations need a one-time full migration. Final GUI and old-install migration acceptance is recorded separately from automated build and upgrade checks.
+
+## Documentation
+
+| Topic | Link |
+| --- | --- |
+| Set up and use the App | [docs/guide/en/app.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/app.md) |
+| CLI guide | [docs/guide/en/cli.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/cli.md) |
+| Providers and configuration | [docs/guide/en/configuration.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/configuration.md) |
+| Search, research and evidence | [docs/guide/en/research.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/research.md) |
+| Jev multi-channel routing | [docs/jev-routing.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/jev-routing.md) |
+| Troubleshooting | [docs/guide/en/troubleshooting.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/troubleshooting.md) |
+| Development and releases | [docs/guide/en/development.md](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/development.md) |
+
+## Acknowledgements
+
+Thanks to the [LINUX DO](https://linux.do/) community for its feedback and discussion.
+
+[![Star History Chart](https://api.star-history.com/svg?repos=konbakuyomu/smartsearch&type=Date)](https://www.star-history.com/#konbakuyomu/smartsearch&Date)
+
+## License
+
+Licensed under [MIT](https://github.com/konbakuyomu/smartsearch/blob/main/LICENSE). Clawd in the animations is an unofficial fan depiction of Anthropic's mascot, not affiliated with or endorsed by Anthropic.

package/runtime/smart-search/_internal/{smart_search-0.1.29.dist-info → smart_search-0.1.30b1.dist-info}/RECORD

@@ -1,13 +1,13 @@
 ../../../bin/smart-search,sha256=3Si0-mMx4MCMjCfKNF0xeBuTy8aXkDufWgG0psj8uJs,205
-smart_search-0.1.29.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
-smart_search-0.1.29.dist-info/METADATA,sha256=J9te_ouaOFc2g25v4IxzBYvw6llk4z5jo50wFqluzEA,6721
-smart_search-0.1.29.dist-info/RECORD,,
-smart_search-0.1.29.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-smart_search-0.1.29.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-smart_search-0.1.29.dist-info/direct_url.json,sha256=lFRY6ow2tINE_t60B1wCO0WZXfSjjC9GUsp1Y2OjrAY,75
-smart_search-0.1.29.dist-info/entry_points.txt,sha256=fiHguhz7hQ6ybeepO0OPpZm19XCi2J-Bkigf8DGBuKM,55
-smart_search-0.1.29.dist-info/licenses/LICENSE,sha256=o_zbH827gkTiZfsNLJGQn1z8Z4eLAvb8heFaSqSGVv8,1067
-smart_search-0.1.29.dist-info/top_level.txt,sha256=mBPprcb_b3tBApeRa2nlLaGj3UVNxXCdyz6QQvDzJpc,13
+smart_search-0.1.30b1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+smart_search-0.1.30b1.dist-info/METADATA,sha256=IKDDKMv9M8tO5uNwBRbX-5fOSldmvIrIU1trjU0EnO4,19628
+smart_search-0.1.30b1.dist-info/RECORD,,
+smart_search-0.1.30b1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+smart_search-0.1.30b1.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+smart_search-0.1.30b1.dist-info/direct_url.json,sha256=lFRY6ow2tINE_t60B1wCO0WZXfSjjC9GUsp1Y2OjrAY,75
+smart_search-0.1.30b1.dist-info/entry_points.txt,sha256=fiHguhz7hQ6ybeepO0OPpZm19XCi2J-Bkigf8DGBuKM,55
+smart_search-0.1.30b1.dist-info/licenses/LICENSE,sha256=o_zbH827gkTiZfsNLJGQn1z8Z4eLAvb8heFaSqSGVv8,1067
+smart_search-0.1.30b1.dist-info/top_level.txt,sha256=mBPprcb_b3tBApeRa2nlLaGj3UVNxXCdyz6QQvDzJpc,13
 smart_search/__init__.py,sha256=da1PTClDMl-IBkrSvq6JC1lnS-K_BASzCvxVhNxN5Ls,13
 smart_search/__pycache__/__init__.cpython-313.pyc,,
 smart_search/__pycache__/activity.cpython-313.pyc,,
@@ -40,7 +40,7 @@ smart_search/__pycache__/ui_metadata.cpython-313.pyc,,
 smart_search/__pycache__/ui_server.cpython-313.pyc,,
 smart_search/__pycache__/utils.cpython-313.pyc,,
 smart_search/activity.py,sha256=66yPPAfuaDSF4UTEuRRDefp2m1-l8eVnr8K5_ShoQCU,13368
-smart_search/assets/i18n/messages.json,sha256=eVpQhvVBwQc6eBDTZO6af0uNTmoetzzl0qRQnrB9QNk,635958
+smart_search/assets/i18n/messages.json,sha256=2cEW-_sOWuQbqb3va9CixuxROAdZNgPujOy5HygLVSc,638801
 smart_search/assets/skills/smart-search-cli/SKILL.md,sha256=465CCVKGCHfiJLDD9LlYbIhlbxWucwLiNVVAcRRlEf8,8561
 smart_search/assets/skills/smart-search-cli/agents/openai.yaml,sha256=4S1VuEER7Puw9JvxDsyI__Tdrr1j2h6aF26yHho_x8E,162
 smart_search/assets/skills/smart-search-cli/references/cli-contract.md,sha256=mZyQRioJ4_ySkxcl9WQBMGXk5fcWOEMBMnXXUGnRoEA,1843

package/runtime/smart-search/_internal/{smart_search-0.1.29.dist-info → smart_search-0.1.30b1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (84.0.0)
+Generator: setuptools (84.2.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

package/runtime/smart-search/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konbakuyomu/smart-search",
-  "version": "0.1.29",
+  "version": "0.1.30-beta.1",
   "description": "CLI-first multi-source web research with xAI/OpenAI-compatible search, Exa, Context7, Zhipu, Tavily, Firecrawl, and Deep Research planning.",
   "license": "MIT",
   "homepage": "https://github.com/konbakuyomu/smartsearch#readme",
@@ -39,11 +39,11 @@
   },
   "smartSearchBinary": true,
   "optionalDependencies": {
-    "@konbakuyomu/smart-search-darwin-x64": "0.1.29",
-    "@konbakuyomu/smart-search-darwin-arm64": "0.1.29",
-    "@konbakuyomu/smart-search-win32-x64": "0.1.29",
-    "@konbakuyomu/smart-search-win32-arm64": "0.1.29",
-    "@konbakuyomu/smart-search-linux-x64": "0.1.29",
-    "@konbakuyomu/smart-search-linux-arm64": "0.1.29"
+    "@konbakuyomu/smart-search-darwin-x64": "0.1.30-beta.1",
+    "@konbakuyomu/smart-search-darwin-arm64": "0.1.30-beta.1",
+    "@konbakuyomu/smart-search-win32-x64": "0.1.30-beta.1",
+    "@konbakuyomu/smart-search-win32-arm64": "0.1.30-beta.1",
+    "@konbakuyomu/smart-search-linux-x64": "0.1.30-beta.1",
+    "@konbakuyomu/smart-search-linux-arm64": "0.1.30-beta.1"
   }
 }

package/runtime/smart-search/_internal/smart_search-0.1.29.dist-info/METADATA

@@ -1,97 +0,0 @@
-Metadata-Version: 2.4
-Name: smart-search
-Version: 0.1.29
-Summary: CLI-first multi-source web research with xAI/OpenAI-compatible search, Exa, Context7, Zhipu, Tavily, Firecrawl, and Deep Research planning.
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx[socks]>=0.28.0
-Requires-Dist: InquirerPy<0.4,>=0.3.4
-Requires-Dist: pyfiglet<2,>=1.0
-Requires-Dist: rich<16,>=13.9
-Requires-Dist: tenacity>=8.0.0
-Provides-Extra: dev
-Requires-Dist: PyYAML<7,>=6.0; extra == "dev"
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
-Dynamic: license-file
-
-<div align="center">
-
-<img src="https://raw.githubusercontent.com/konbakuyomu/smartsearch/main/assets/branding/smart-search.png" alt="Smart Search" width="112">
-
-# Smart Search
-
-**Search the web, read sources, and bring current information into your AI conversations.**
-
-[简体中文](README.zh-CN.md) | English
-
-[![npm](https://img.shields.io/npm/v/@konbakuyomu/smart-search)](https://www.npmjs.com/package/@konbakuyomu/smart-search)
-[![CI](https://github.com/konbakuyomu/smartsearch/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/konbakuyomu/smartsearch/actions/workflows/ci.yml)
-[![MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/konbakuyomu/smartsearch/blob/main/LICENSE)
-
-[Download the App](https://github.com/konbakuyomu/smartsearch/releases/latest) · [User guide](https://github.com/konbakuyomu/smartsearch/tree/main/docs/guide) · [Report a problem](https://github.com/konbakuyomu/smartsearch/issues)
-
-</div>
-
-## What is Smart Search?
-
-Smart Search connects search and page-reading services to AI tools such as Codex and Claude Code. Use the desktop App to configure your services and run searches. Once connected, you can also ask your AI to use Smart Search directly.
-
-You choose the providers and supply their API keys. The App manages configuration; the independent command-line tool runs AI requests even after you close the App.
-
-## When is it useful?
-
-- **Working with a library or API:** find current documentation and read the relevant pages.
-- **Following recent changes:** look up announcements or news that may be newer than a model's knowledge.
-- **Checking a claim:** find its source, read the page, and compare it with other evidence.
-- **Researching a larger question:** collect sources, inspect gaps, and build a cited answer.
-
-These tasks need information from the web and a way to trace it back to its source. Smart Search puts search, page reading, and provider configuration in one place. A search hit is a starting point; read the source before relying on an important claim.
-
-## Get started in the App
-
-1. **Download and open Smart Search.** Choose the package for your system from [Releases](https://github.com/konbakuyomu/smartsearch/releases/latest). The first step on Overview detects npm or accepts a manual npm path, then installs and connects the independent CLI.
-2. **Open Providers.** Add services for the three required jobs: answering searches, finding documentation, and reading pages. The page shows what is still missing and where to obtain each key. Check or test the settings, then save them.
-3. **Open Update Skills.** Once the CLI is connected, read its Skills, select your Agents, and confirm backup and sync. Codex, Claude Code, Cursor and 14 other targets are supported. Install and sign in to the Agent applications yourself.
-4. **Verify the Agent connection.** In a new AI conversation, use the independent CLI invocation supplied by the Skill. First check that the command runs; then try a search.
-
-Provider tests and searches may use your providers' paid quota. Opening the App or checking the local environment does not run a paid search.
-
-Version 0.1.24 combines the refreshed native interface with Velopack on Windows and Sparkle on macOS, and publishes the first official framework update feeds. The current development version manages App and CLI updates independently; the CLI maintains connected Skills while preserving personal edits. Existing Inno installations require a one-time full migration. Windows `-signed.exe` packages use a **self-signed certificate** and may still trigger SmartScreen; see [Windows signatures and first launch](docs/windows-signing.md). macOS uses ad-hoc bundle integrity signing and separate Sparkle EdDSA update signatures, without Developer ID signing or notarization. Final GUI and old-install migration acceptance remains separate from automated build and upgrade checks.
-
-[App setup, supported platforms, and troubleshooting →](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/app.md)
-
-## Everyday use
-
-**In the App:** open Search & research, enter a question or URL, and review the result and its sources. Activity shows what is running and which provider it used. You can copy or export the result.
-
-**In your AI tool:** ask naturally, for example:
-
-> Use Smart Search to find the current React documentation for useEffect cleanup. Read the relevant page and include the source.
-
-> Use Smart Search to check the claims in this page: https://example.com/article
-
-The App can stay closed. Your AI calls the independent CLI using the installed integration instructions.
-
-**Language:** the App follows your system by default. Change it in Settings & about → Language. The CLI has its own saved preference and a one-command `--lang en` / `--lang zh` override. These settings change the tool's interface and messages, not the text of a source page.
-
-## Prefer the terminal?
-
-```sh
-npm install -g @konbakuyomu/smart-search@latest
-smart-search setup
-```
-
-The new npm CLI requires Node.js 18+ / npm only. Its platform package includes the Python runtime and does not use a user-installed Python. See the [CLI guide](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/cli.md) for installation, language settings, commands, and examples.
-For uv source installation and a fixed Python version, see [CLI installation](https://github.com/konbakuyomu/smartsearch/blob/main/docs/guide/en/cli.md#cli-installation).
-
-## Need more detail?
-
-The [complete guide](https://github.com/konbakuyomu/smartsearch/tree/main/docs/guide) covers all commands and configuration keys, provider choices, research, and troubleshooting. Development and release instructions are there too.
-
-Thanks to the [LINUX DO](https://linux.do/) community for its feedback and discussion.
-
-[![Star History Chart](https://api.star-history.com/svg?repos=konbakuyomu/smartsearch&type=Date)](https://www.star-history.com/#konbakuyomu/smartsearch&Date)
-
-Licensed under [MIT](https://github.com/konbakuyomu/smartsearch/blob/main/LICENSE).