@jaco-tech/dsh-web-search-searxng 0.1.0 → 0.2.1

package/README.md

@@ -7,9 +7,7 @@ SearXNG-backed search provider plugin for [DeepSeek Harness](https://github.com/
 
 Registers a `WebSearchProvider` into `ctx.web` so that the existing `web_search` model tool routes through your [SearXNG](https://github.com/searxng/searxng) instance. No auth, no API key, no model calls — just a plain HTTP GET against SearXNG's JSON endpoint.
 
-## Status
-
-⚠️ **Not yet published to npm.** The CI/CD workflow builds on every push and publishes automatically when a `v*` tag is pushed. Once the first release is cut:
+## Install
 
 ```bash
 npm install @jaco-tech/dsh-web-search-searxng
@@ -17,13 +15,22 @@ npm install @jaco-tech/dsh-web-search-searxng
 
 ## Configure
 
-Add to your DSH profile's `cordis.patch.yml`:
+### 1. Install the package
+
+```bash
+npm install @jaco-tech/dsh-web-search-searxng
+```
+
+### 2. Add it to your DSH profile
+
+Edit `~/.dsh/profiles/web/cordis.patch.yml` (create it if it doesn't exist) and add:
 
 ```yaml
 - insert:
     - id: web-search-searxng
       name: '@jaco-tech/dsh-web-search-searxng'
       config:
+        # Required: point at your SearXNG instance
         baseURL: 'http://your-searxng-instance:8888'
         # Optional filters:
         language: 'en'
@@ -31,7 +38,7 @@ Add to your DSH profile's `cordis.patch.yml`:
         timeRange: ''
 ```
 
-Optionally pin `ctx.web` to use this provider explicitly:
+If you have multiple search providers registered, pin `ctx.web` to use this one:
 
 ```yaml
 - replace:
@@ -40,6 +47,20 @@ Optionally pin `ctx.web` to use this provider explicitly:
         searchProvider: searxng
 ```
 
+### 3. Restart DSH
+
+Stop your running `dsh` process and start it again:
+
+```bash
+npx @deepseek-ai/dsh web
+```
+
+The plugin will be loaded automatically. The `web_search` tool in your agent will now use your SearXNG instance.
+
+### 4. (Optional) Configure via the Web UI
+
+Once DSH is running, go to **Settings → Plugins** in the Web UI. You'll see a "web-search-searxng" card where you can edit the `baseURL` and filter settings without editing YAML files.
+
 ## How it works
 
 This is a [Cordis](https://github.com/cordiverse/cordis) plugin that implements the `WebSearchProvider` interface from `@deepseek-ai/dsh-web`:

package/lib/index.js

@@ -1,5 +1,6 @@
 import z from "@deepseek-ai/schemastery";
 import { WebError } from "@deepseek-ai/dsh-web";
+import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 //#endregion
 //#region provider
 /**
@@ -142,8 +143,14 @@ const Config = z.object({
     categories: z.string().default(""),
     timeRange: z.string().default(""),
 });
+/** Settings namespace for the DSH Web UI (Settings → Plugins). */
+const WEB_SEARCH_SEARXNG_SETTINGS_NAMESPACE = settingsNamespace("web-search-searxng");
 function apply(ctx, config) {
-    const current = () => config;
+    let current = () => config;
+    installSettingsSection(ctx, WEB_SEARCH_SEARXNG_SETTINGS_NAMESPACE, Config, config, {
+        setSource: (source) => { current = source; },
+        onChange: () => { },
+    });
     ctx.web.registerSearchProvider(new SearXngSearchProvider(() => current()));
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jaco-tech/dsh-web-search-searxng",
   "description": "SearXNG-backed search provider for the DeepSeek Harness web capability seam (ctx.web). No auth, no API key.",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "publishConfig": {
     "access": "public"
   },
@@ -32,7 +32,8 @@
     "cordis-plugin"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-web": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-web": "^0.1.0-rc.7 || ^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7 || ^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "dependencies": {
@@ -40,6 +41,7 @@
   },
   "devDependencies": {
     "@deepseek-ai/dsh-web": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
     "@deepseek-ai/cordis": "^4.0.1",
     "typescript": "^5.7.0"
   },