@jaco-tech/dsh-web-fetch-crw 0.1.0 → 0.2.1

package/README.md

@@ -9,9 +9,7 @@ Registers a `WebFetchProvider` into `ctx.web` so that the existing `web_fetch` m
 
 crw is a self-hosted web scraping and crawling service that implements the [Firecrawl](https://github.com/nicknisi/firecrawl) API. It provides a drop-in replacement for the Firecrawl `/v1/scrape` 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-fetch-crw
@@ -19,17 +17,26 @@ npm install @jaco-tech/dsh-web-fetch-crw
 
 ## Configure
 
-Add to your DSH profile's `cordis.patch.yml`:
+### 1. Install the package
+
+```bash
+npm install @jaco-tech/dsh-web-fetch-crw
+```
+
+### 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-fetch-crw
       name: '@jaco-tech/dsh-web-fetch-crw'
       config:
+        # Required: point at your crw (Firecrawl-compatible) instance
         baseURL: 'http://your-crw-instance:3000'
 ```
 
-Optionally pin `ctx.web` to use this provider explicitly:
+If you have multiple fetch providers registered, pin `ctx.web` to use this one:
 
 ```yaml
 - replace:
@@ -38,6 +45,20 @@ Optionally pin `ctx.web` to use this provider explicitly:
         fetchProvider: crw
 ```
 
+### 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_fetch` tool in your agent will now use your crw 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-fetch-crw" card where you can edit the `baseURL` without editing YAML files.
+
 ## How it works
 
 This is a [Cordis](https://github.com/cordiverse/cordis) plugin that implements the `WebFetchProvider` 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
 /**
@@ -118,8 +119,14 @@ const inject = ["web"];
 const Config = z.object({
     baseURL: z.string().required(),
 });
+/** Settings namespace for the DSH Web UI (Settings → Plugins). */
+const WEB_FETCH_CRW_SETTINGS_NAMESPACE = settingsNamespace("web-fetch-crw");
 function apply(ctx, config) {
-    const current = () => config;
+    let current = () => config;
+    installSettingsSection(ctx, WEB_FETCH_CRW_SETTINGS_NAMESPACE, Config, config, {
+        setSource: (source) => { current = source; },
+        onChange: () => { },
+    });
     ctx.web.registerFetchProvider(new CrwFetchProvider(() => current()));
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jaco-tech/dsh-web-fetch-crw",
   "description": "crw (Firecrawl-compatible) fetch 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"
   },
@@ -33,7 +33,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": {
@@ -41,6 +42,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"
   },