@jaco-tech/dsh-web-fetch-crw 0.2.0 → 0.2.2

package/README.md

@@ -15,19 +15,38 @@ crw is a self-hosted web scraping and crawling service that implements the [Fire
 npm install @jaco-tech/dsh-web-fetch-crw
 ```
 
+Requires DeepSeek Harness 0.2.1-rc.5. The tested DSH dependency set pins
+`@deepseek-ai/dsh-web` and `@deepseek-ai/dsh-settings` exactly at `0.2.1-rc.5`.
+`@deepseek-ai/cordis` is the deliberate exception: like the first-party DSH web plugins,
+this package declares the compatible patch range `~4.0.5`. A consumer lockfile could in
+principle resolve a different 4.0.x cordis patch and create a second framework copy; this
+plugin's one-shot install is verified against cordis 4.0.5. Every DSH bump therefore needs
+a release of this package with its framework peers re-pinned (`test/peer-pins.test.mjs`
+enforces their presence and pin form). DSH 0.1.x is no longer supported; use
+`@jaco-tech/dsh-web-fetch-crw@0.1` there.
+
 ## 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:
@@ -36,6 +55,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. `baseURL` is a volatile setting: the provider reads it on every fetch, so an edit applies without restarting DSH.
+
 ## How it works
 
 This is a [Cordis](https://github.com/cordiverse/cordis) plugin that implements the `WebFetchProvider` interface from `@deepseek-ai/dsh-web`:
@@ -73,8 +106,8 @@ This plugin communicates with [crw](https://github.com/us/crw) via its Firecrawl
 
 ```bash
 # Tag and push — the CI workflow builds and publishes to npm automatically
-git tag v0.1.0
-git push origin v0.1.0
+git tag v0.2.2
+git push origin v0.2.2
 ```
 
 Requires the `NPM_TOKEN` secret to be set in the repository.
@@ -84,8 +117,27 @@ Requires the `NPM_TOKEN` secret to be set in the repository.
 ```bash
 npm install
 npm run build
+npm test    # builds, then imports the built package against the installed DSH (hermetic)
 ```
 
+Verify a one-shot scratch install of DSH plus this package's `npm pack` tarball:
+
+```bash
+repo=$PWD
+scratch=$(mktemp -d)
+tarball=$(npm pack --pack-destination "$scratch" --silent)
+printf '%s\n' \
+  "{\"private\":true,\"dependencies\":{\"@deepseek-ai/dsh\":\"0.2.1-rc.5\",\"@jaco-tech/dsh-web-fetch-crw\":\"file:./$tarball\"}}" \
+  > "$scratch/package.json"
+(cd "$scratch" && npm install --no-audit --no-fund)
+node "$repo/test/installed-tree-identity.mjs" "$scratch"
+```
+
+The final check is hermetic (it only reads the installed tree). It requires exactly one
+installed copy each of `@deepseek-ai/dsh-web`,
+`@deepseek-ai/dsh-settings`, and `@deepseek-ai/cordis`, and requires
+`@deepseek-ai/cordis-plugin-group` to be present.
+
 ## License
 
 MIT

package/lib/index.js

@@ -1,6 +1,5 @@
 import z from "@deepseek-ai/schemastery";
 import { WebError } from "@deepseek-ai/dsh-web";
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 //#endregion
 //#region provider
 /**
@@ -117,17 +116,11 @@ const name = "web-fetch-crw";
 /** The web seam this provider registers into. */
 const inject = ["web"];
 const Config = z.object({
-    baseURL: z.string().required(),
+    baseURL: z.string().required().volatile(),
 });
-/** Settings namespace for the DSH Web UI (Settings → Plugins). */
-const WEB_FETCH_CRW_SETTINGS_NAMESPACE = settingsNamespace("web-fetch-crw");
+/** Register the crw fetch provider with `ctx.web`. */
 function apply(ctx, config) {
-    let current = () => config;
-    installSettingsSection(ctx, WEB_FETCH_CRW_SETTINGS_NAMESPACE, Config, config, {
-        setSource: (source) => { current = source; },
-        onChange: () => { },
-    });
-    ctx.web.registerFetchProvider(new CrwFetchProvider(() => current()));
+    ctx.web.registerFetchProvider(new CrwFetchProvider(() => ({ baseURL: config.baseURL.get() })));
 }
 //#endregion
 //#region helpers

package/lib/types/index.d.ts

@@ -1,5 +1,5 @@
 import z from "@deepseek-ai/schemastery";
-import type { Context } from "@deepseek-ai/cordis";
+import type { Context, Volatile } from "@deepseek-ai/cordis";
 import type { WebFetchProvider, WebFetchRequest, WebFetchResult } from "@deepseek-ai/dsh-web";
 interface CrwScrapeResponse {
     success: boolean;
@@ -69,11 +69,18 @@ declare const name = "web-fetch-crw";
 declare const inject: string[];
 /**
  * Plugin configuration. `baseURL` is required (point at your crw instance).
+ * The field is volatile: DSH's settings plane updates it in place, and the
+ * provider reads it on every call, so an edit applies without a reload.
  */
 interface Config {
     /** Base URL of the crw service (without /v1/scrape suffix). */
-    baseURL: string;
+    baseURL: Volatile<string>;
 }
-declare const Config: z<Config>;
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    baseURL: z<string, string, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    baseURL: z<string, string, "volatile-defined">;
+}>>, "plain">;
+/** Register the crw fetch provider with `ctx.web`. */
 declare function apply(ctx: Context, config: Config): void;
 export { CRW_PROVIDER_ID, CrwFetchProvider, Config, apply, inject, name, mapCrwResponse };

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.2.0",
+  "version": "0.2.2",
   "publishConfig": {
     "access": "public"
   },
@@ -33,21 +33,21 @@
     "cordis-plugin"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh-web": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/dsh-web": "0.2.1-rc.5",
+    "@deepseek-ai/cordis": "~4.0.5"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/schemastery": "~3.18.5 || ~3.19.0"
   },
   "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",
+    "@deepseek-ai/dsh": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-web": "0.2.1-rc.5",
+    "@deepseek-ai/cordis": "~4.0.5",
     "typescript": "^5.7.0"
   },
   "scripts": {
     "build": "tsc",
+    "test": "npm run build && node --test test/peer-pins.test.mjs test/smoke.test.mjs",
     "prepublishOnly": "tsc"
   }
-}
+}