@auggieteo/dsh-synthetic-web-search 0.2.3 → 0.2.4

package/README.md

@@ -42,13 +42,19 @@ Then rerun the same `dsh plugin --profile web add git+https://…` command. Do n
 
 ### Activate the provider
 
-The install command adds this package to `dsh.profile.bundles`. Its bundled `cordis.patch.yml` inserts the `synthetic-web-search` row — the same id the manual rows above use.
+The install command adds this package to `dsh.profile.bundles`. Its bundled `cordis.patch.yml` inserts the `synthetic-web-search` row **and selects `synthetic` as the `web` search provider**, replacing DSH's shipped `deepseek-official` selection. No `DSH_WEB_SEARCH_PROVIDER` environment variable is needed.
 
-The row belongs in the **web host profile**, not an agent preset: `ctx.web` is process-wide and each provider must register once. [`examples/synthetic.cordis.yml`](examples/synthetic.cordis.yml) shows the equivalent manual row.
+The row belongs in the **web host profile**, not an agent preset: `ctx.web` is process-wide and each provider must register once. [`examples/synthetic.cordis.yml`](examples/synthetic.cordis.yml) shows the provider row; add the following selection override when mounting it manually:
+
+```yaml
+- id: web
+  config:
+    searchProvider: synthetic
+```
 
 Restart the DSH web profile after installation. Do not start a separate Vite server; it does not update an existing DSH GUI.
 
-## Configure credentials and provider selection
+## Configure credentials
 
 Open **Settings → Plugins → Plugin configuration → Synthetic web search**, enter the API key, and select **Save**. DSH stores it in its credentials domain and does not return it to the browser after saving.
 
@@ -58,14 +64,7 @@ For headless use, the plugin also reads the launch environment reference (by def
 export SYNTHETIC_API_KEY='…'
 ```
 
-When another usable search provider is installed, explicitly select Synthetic before launching DSH:
-
-```bash
-export DSH_WEB_SEARCH_PROVIDER=synthetic
-dsh web
-```
-
-Provider selection is intentionally unambiguous. The existing `@deepseek-ai/dsh-tool-web` agent-preset row exposes `web_search` to the model.
+Provider selection is intentionally unambiguous: installation pins `web.config.searchProvider` to `synthetic`. To use another provider later, apply a higher-precedence profile or `--patch` override with that provider's id. The existing `@deepseek-ai/dsh-tool-web` agent-preset row exposes `web_search` to the model.
 
 ### Configuration
 

package/cordis.patch.yml

@@ -1,8 +1,13 @@
-# Bundle patch for @auggieteo/dsh-synthetic-web-search: inserts its host row into the profile tree.
-# `dsh plugin --profile web add <this package>` appends this bundle to
-# dsh.profile.bundles automatically. Client roster entries come from the
+# Bundle patch for @auggieteo/dsh-synthetic-web-search: inserts its host row and
+# selects Synthetic for web search. `dsh plugin --profile web add <this package>`
+# appends this bundle after DSH's base bundle, so this later row override replaces
+# the shipped `deepseek-official` selection. Client roster entries come from the
 # dsh.client block in package.json — no row needed here.
 
 - insert:
     - id: synthetic-web-search
       name: "@auggieteo/dsh-synthetic-web-search"
+
+- id: web
+  config:
+    searchProvider: synthetic

package/examples/synthetic.cordis.yml

@@ -1,10 +1,15 @@
 # Host-plane row: it registers a provider into the process-wide `web` service.
 # Install the package into the target profile before adding this row.
 # `dsh plugin --profile web add @auggieteo/dsh-synthetic-web-search` mounts
-# this row through the shipped bundle; this file is the manual equivalent.
+# these rows through the shipped bundle; this file is the manual equivalent.
 - id: synthetic-web-search
   name: '@auggieteo/dsh-synthetic-web-search'
   config:
     # The Settings card stores its key under this DSH credential reference.
     # apiKeyEnv: SYNTHETIC_API_KEY
     # baseURL: https://api.synthetic.new
+
++# Overrides DSH's shipped deepseek-official selection.
+- id: web
+  config:
+    searchProvider: synthetic

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auggieteo/dsh-synthetic-web-search",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Synthetic-backed search provider and Settings card for the DeepSeek Harness web capability seam (ctx.web)",
   "license": "MIT",
   "publishConfig": {