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

package/README.md

@@ -22,7 +22,7 @@ dsh plugin --profile web add @auggieteo/dsh-synthetic-web-search
 
 ### Public Git URL
 
-After the public repository exists, install directly from Git:
+Install directly from the public Git repository:
 
 ```bash
 dsh plugin --profile web add git+https://github.com/auggie246/dsh-synthetic-web-search.git
@@ -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
 
@@ -101,6 +100,8 @@ npm run verify
 
 `npm run verify` cleans generated output, type-checks, runs mocked provider tests, builds `lib/` from source (including the browser client bundle), and checks the npm package contents with `npm pack --dry-run`.
 
+Releases are automated. Publish a GitHub release tagged `v<version>`, where `<version>` matches `package.json`. The publish workflow installs with `npm ci`, checks the tag, tests, builds, and publishes to npm. A prerelease publishes under the npm dist-tag `next`. A stable release publishes under `latest`.
+
 To test a local checkout without touching another profile, point a throwaway profile at its absolute path:
 
 ```bash
@@ -114,7 +115,9 @@ The provider sends the documented request:
 ```http
 POST https://api.synthetic.new/v2/search
 Authorization: Bearer $SYNTHETIC_API_KEY
+Accept: application/json
 Content-Type: application/json
+User-Agent: deepseek-harness-synthetic/0.1.0
 
 { "query": "…" }
 ```
@@ -128,6 +131,6 @@ It maps valid results into the Harness source vocabulary:
 | `text` | `snippet` |
 | `published` | `publishedAt` |
 
-Malformed or non-URL entries are ignored. The provider does not create a generated answer (`content`) and returns `truncated: false`; the `ctx.web` seam applies the caller's `maxResults` cap. Network, redirect, HTTP, and response-shape failures surface as `WEB_PROVIDER_ERROR`; aborted requests surface as `WEB_ABORTED`.
+Malformed or non-URL entries are ignored. The provider does not create a generated answer (`content`) and returns `truncated: false`; the `ctx.web` seam applies the caller's `maxResults` cap. Network, redirect, HTTP, and response-shape failures surface as `WEB_PROVIDER_ERROR`; a missing API key surfaces as `WEB_PROVIDER_CREDENTIAL_MISSING`; aborted requests surface as `WEB_ABORTED`.
 
 Synthetic's documented API currently exposes only `query`, so `maxResults` is intentionally not sent upstream.

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.2",
+  "version": "0.2.4",
   "description": "Synthetic-backed search provider and Settings card for the DeepSeek Harness web capability seam (ctx.web)",
   "license": "MIT",
   "publishConfig": {