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

package/README.md

@@ -12,7 +12,7 @@ This is a **host-plane** plugin: it registers the `synthetic` provider into the
 
 ## Install
 
-Install the package as a dependency of the profile that hosts `web` (normally `web`). Choose one route.
+Install the package as a profile layer in the profile that hosts `web` (normally `web`). The layer activates the provider row automatically. Choose one route.
 
 ### npm registry
 
@@ -42,22 +42,11 @@ Then rerun the same `dsh plugin --profile web add git+https://…` command. Do n
 
 ### Activate the provider
 
-Add this top-level `insert` block to `$DSH_HOME/profiles/web/cordis.patch.yml` (create the file with this YAML array if it does not exist):
+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.
 
-```yaml
-- insert:
-    - id: web-search-synthetic
-      name: '@auggieteo/dsh-synthetic-web-search'
-      config:
-        # Settings stores the key using this DSH credential reference.
-        apiKeyEnv: SYNTHETIC_API_KEY
-        # Optional; defaults to https://api.synthetic.new.
-        # baseURL: https://api.synthetic.new
-```
+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. The same example is in [`examples/synthetic.cordis.yml`](examples/synthetic.cordis.yml).
-
-Restart the DSH web profile after changing its composition. Do not start a separate Vite server; it does not update an existing DSH GUI.
+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
 
@@ -88,19 +77,20 @@ Provider selection is intentionally unambiguous. The existing `@deepseek-ai/dsh-
 
 ## Uninstall
 
-1. Remove the `web-search-synthetic` row from `$DSH_HOME/profiles/web/cordis.patch.yml`.
-2. Remove the dependency:
+1. Remove the profile layer:
 
    ```bash
    dsh plugin --profile web remove @auggieteo/dsh-synthetic-web-search
    ```
 
-3. Restart the DSH web profile.
-4. If no other configuration uses it, remove `SYNTHETIC_API_KEY` from the process environment and remove the stored credential through your normal DSH credentials management.
+2. Restart the DSH web profile.
+3. If no other configuration uses it, remove `SYNTHETIC_API_KEY` from the process environment and remove the stored credential through your normal DSH credentials management.
 
 ## Compatibility
 
-The public package name is `@auggieteo/dsh-synthetic-web-search`, replacing the former local `@deepseek-ai/dsh-web-search-synthetic` reference. Only the package reference changes. The Cordis row id (`web-search-synthetic`), Settings namespace (`web-search-synthetic`), and default credential reference (`SYNTHETIC_API_KEY`) remain unchanged, so existing persisted plugin settings and credentials continue to apply after the row is updated.
+The public package name is `@auggieteo/dsh-synthetic-web-search`, replacing the former local `@deepseek-ai/dsh-web-search-synthetic` reference. The browser client registers both package ids, so legacy profile rows continue to load during migration. The bundle row id (`synthetic-web-search`) matches the id existing manual profile rows already use, so the plugin mounts once. The Settings namespace (`web-search-synthetic`) and default credential reference (`SYNTHETIC_API_KEY`) remain unchanged, so existing persisted plugin settings and credentials continue to apply after the row is updated.
+
+0.2.1 shipped a bundle row with id `web-search-synthetic`. If you installed 0.2.1 as a bundle and kept a manual `- insert:` block, the plugin mounted twice. Upgrade to 0.2.2 or newer, which aligns the bundle row id with the manual row id, then keep only one mount.
 
 ## Development and verification
 

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# 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
+# dsh.client block in package.json — no row needed here.
+
+- insert:
+    - id: synthetic-web-search
+      name: "@auggieteo/dsh-synthetic-web-search"

package/examples/synthetic.cordis.yml

@@ -1,6 +1,8 @@
 # Host-plane row: it registers a provider into the process-wide `web` service.
 # Install the package into the target profile before adding this row.
-- id: web-search-synthetic
+# `dsh plugin --profile web add @auggieteo/dsh-synthetic-web-search` mounts
+# this row 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.

package/lib/client.js

@@ -1,6 +1,16 @@
-window.__ModuleLoader__.load({
-  id: '@auggieteo/dsh-synthetic-web-search',
-  factory: (require) => {
+const CLIENT_PACKAGE_IDS = [
+  '@auggieteo/dsh-synthetic-web-search',
+  '@deepseek-ai/dsh-web-search-synthetic',
+]
+
+for (const id of CLIENT_PACKAGE_IDS) {
+  window.__ModuleLoader__.load({
+    id,
+    factory: createClientPlugin,
+  })
+}
+
+function createClientPlugin(require) {
     const module = { exports: {} }
     const exports = module.exports
     const React = require('react')
@@ -155,5 +165,4 @@ window.__ModuleLoader__.load({
     exports.inject = inject
     exports.apply = apply
     return module.exports
-  },
-})
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auggieteo/dsh-synthetic-web-search",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Synthetic-backed search provider and Settings card for the DeepSeek Harness web capability seam (ctx.web)",
   "license": "MIT",
   "publishConfig": {
@@ -36,6 +36,9 @@
     "./package.json": "./package.json"
   },
   "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
     "client": {
       "platform": "web",
       "inject": [
@@ -47,6 +50,7 @@
   },
   "files": [
     "lib",
+    "cordis.patch.yml",
     "examples",
     "README.md",
     "LICENSE"
@@ -60,16 +64,14 @@
     "prepack": "npm run build",
     "verify": "npm run clean && npm run check && npm test && npm run build && npm pack --dry-run"
   },
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-credentials": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-launch-environment": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-web": "^0.1.1-rc.2"
+    "@deepseek-ai/dsh-web": "^0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -78,7 +80,9 @@
     "@deepseek-ai/dsh-launch-environment": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-web": "^0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.1",
     "@types/node": "^22.0.0",
+    "js-yaml": "^4.1.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0"
   }