@divergeai/cli 0.1.9 → 0.1.11

package/README.md

@@ -79,10 +79,13 @@ Anthropic or OpenAI. Every other model, dsh included, searches through the
 platform's `search_online` tool: one key on the platform, metered and audited
 per organization. The dsh overlay wires it in as `mcp__divergent__search_online`
 (dsh's DeepSeek-backed `web_search` needs a vendor key and is off; `web_fetch`
-stays). In dsh's web profile the shipped agent presets still list `web_search`,
-where a patch cannot reach; it fails loudly and the model uses the bridge's
-tool listed beside it. To give Claude Code or Codex the same tool for a
-non-native upstream, register the bridge once:
+stays). dsh's web profile composes the model's tools per agent preset, where a
+patch cannot reach, so `diverge agents setup dsh` and `run dsh` also derive a
+**Divergent** preset from the installed dsh's `standard` one, with the vendor
+search left out of the model's tools, under `$DSH_HOME/.agent-presets/`, and
+make it the default for new web sessions once in `settings.yaml` (a preset you
+pick yourself there stays picked). To give Claude Code or Codex the same tool
+for a non-native upstream, register the bridge once:
 
 ```bash
 claude mcp add --scope user divergent -- diverge tools bridge --tools search_online
@@ -149,6 +152,11 @@ on the binding when the endpoint is a tailnet or LAN address.
 ## Updating
 
 `diverge update` installs the latest release with the npm that installed it.
+Once a day, after a command finishes, the CLI asks the registry for the latest
+version in the background and caches the answer under `$DIVERGE_HOME`; the
+next command prints one line on stderr when a newer release exists. Nothing
+waits on the network for it, and it stays quiet in the bridge, in
+non-interactive shells, under `CI`, and with `DIVERGE_NO_UPDATE_CHECK=1`.
 
 ## Environment
 
@@ -159,6 +167,7 @@ on the binding when the endpoint is a tailnet or LAN address.
 | `DIVERGENT_ORG_ID`, `DIVERGENT_PROJECT_ID` | tool scope when the flags are omitted; without either, the login's organization |
 | `DIVERGENT_CLIENT_ID`, `DIVERGENT_CLIENT_SECRET`, `DIVERGENT_USER_ID` | unattended tool execution with service credentials, delegated to that person |
 | `DSH_HOME` | where dsh keeps its files, default `~/.dsh` |
+| `DIVERGE_NO_UPDATE_CHECK` | set to skip the once-a-day check for a newer release |
 
 ## Security
 

package/dist/diverge.mjs

@@ -114,17 +114,17 @@ var require_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    function visit_(key, node, visitor, path11) {
-      const ctrl = callVisitor(key, node, visitor, path11);
+    function visit_(key, node, visitor, path12) {
+      const ctrl = callVisitor(key, node, visitor, path12);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path11, ctrl);
-        return visit_(key, ctrl, visitor, path11);
+        replaceNode(key, path12, ctrl);
+        return visit_(key, ctrl, visitor, path12);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node)) {
-          path11 = Object.freeze(path11.concat(node));
+          path12 = Object.freeze(path12.concat(node));
           for (let i = 0; i < node.items.length; ++i) {
-            const ci = visit_(i, node.items[i], visitor, path11);
+            const ci = visit_(i, node.items[i], visitor, path12);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -135,13 +135,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node)) {
-          path11 = Object.freeze(path11.concat(node));
-          const ck = visit_("key", node.key, visitor, path11);
+          path12 = Object.freeze(path12.concat(node));
+          const ck = visit_("key", node.key, visitor, path12);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node.key = null;
-          const cv = visit_("value", node.value, visitor, path11);
+          const cv = visit_("value", node.value, visitor, path12);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -162,17 +162,17 @@ var require_visit = __commonJS({
     visitAsync.BREAK = BREAK;
     visitAsync.SKIP = SKIP;
     visitAsync.REMOVE = REMOVE;
-    async function visitAsync_(key, node, visitor, path11) {
-      const ctrl = await callVisitor(key, node, visitor, path11);
+    async function visitAsync_(key, node, visitor, path12) {
+      const ctrl = await callVisitor(key, node, visitor, path12);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path11, ctrl);
-        return visitAsync_(key, ctrl, visitor, path11);
+        replaceNode(key, path12, ctrl);
+        return visitAsync_(key, ctrl, visitor, path12);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node)) {
-          path11 = Object.freeze(path11.concat(node));
+          path12 = Object.freeze(path12.concat(node));
           for (let i = 0; i < node.items.length; ++i) {
-            const ci = await visitAsync_(i, node.items[i], visitor, path11);
+            const ci = await visitAsync_(i, node.items[i], visitor, path12);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -183,13 +183,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node)) {
-          path11 = Object.freeze(path11.concat(node));
-          const ck = await visitAsync_("key", node.key, visitor, path11);
+          path12 = Object.freeze(path12.concat(node));
+          const ck = await visitAsync_("key", node.key, visitor, path12);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node.key = null;
-          const cv = await visitAsync_("value", node.value, visitor, path11);
+          const cv = await visitAsync_("value", node.value, visitor, path12);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -216,23 +216,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node, visitor, path11) {
+    function callVisitor(key, node, visitor, path12) {
       if (typeof visitor === "function")
-        return visitor(key, node, path11);
+        return visitor(key, node, path12);
       if (identity.isMap(node))
-        return visitor.Map?.(key, node, path11);
+        return visitor.Map?.(key, node, path12);
       if (identity.isSeq(node))
-        return visitor.Seq?.(key, node, path11);
+        return visitor.Seq?.(key, node, path12);
       if (identity.isPair(node))
-        return visitor.Pair?.(key, node, path11);
+        return visitor.Pair?.(key, node, path12);
       if (identity.isScalar(node))
-        return visitor.Scalar?.(key, node, path11);
+        return visitor.Scalar?.(key, node, path12);
       if (identity.isAlias(node))
-        return visitor.Alias?.(key, node, path11);
+        return visitor.Alias?.(key, node, path12);
       return void 0;
     }
-    function replaceNode(key, path11, node) {
-      const parent = path11[path11.length - 1];
+    function replaceNode(key, path12, node) {
+      const parent = path12[path12.length - 1];
       if (identity.isCollection(parent)) {
         parent.items[key] = node;
       } else if (identity.isPair(parent)) {
@@ -842,10 +842,10 @@ var require_Collection = __commonJS({
     var createNode = require_createNode();
     var identity = require_identity();
     var Node = require_Node();
-    function collectionFromPath(schema, path11, value) {
+    function collectionFromPath(schema, path12, value) {
       let v = value;
-      for (let i = path11.length - 1; i >= 0; --i) {
-        const k = path11[i];
+      for (let i = path12.length - 1; i >= 0; --i) {
+        const k = path12[i];
         if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
           const a = [];
           a[k] = v;
@@ -864,7 +864,7 @@ var require_Collection = __commonJS({
         sourceObjects: /* @__PURE__ */ new Map()
       });
     }
-    var isEmptyPath = (path11) => path11 == null || typeof path11 === "object" && !!path11[Symbol.iterator]().next().done;
+    var isEmptyPath = (path12) => path12 == null || typeof path12 === "object" && !!path12[Symbol.iterator]().next().done;
     var Collection = class extends Node.NodeBase {
       constructor(type, schema) {
         super(type);
@@ -894,11 +894,11 @@ var require_Collection = __commonJS({
        * be a Pair instance or a `{ key, value }` object, which may not have a key
        * that already exists in the map.
        */
-      addIn(path11, value) {
-        if (isEmptyPath(path11))
+      addIn(path12, value) {
+        if (isEmptyPath(path12))
           this.add(value);
         else {
-          const [key, ...rest] = path11;
+          const [key, ...rest] = path12;
           const node = this.get(key, true);
           if (identity.isCollection(node))
             node.addIn(rest, value);
@@ -912,8 +912,8 @@ var require_Collection = __commonJS({
        * Removes a value from the collection.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path11) {
-        const [key, ...rest] = path11;
+      deleteIn(path12) {
+        const [key, ...rest] = path12;
         if (rest.length === 0)
           return this.delete(key);
         const node = this.get(key, true);
@@ -927,8 +927,8 @@ var require_Collection = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path11, keepScalar) {
-        const [key, ...rest] = path11;
+      getIn(path12, keepScalar) {
+        const [key, ...rest] = path12;
         const node = this.get(key, true);
         if (rest.length === 0)
           return !keepScalar && identity.isScalar(node) ? node.value : node;
@@ -946,8 +946,8 @@ var require_Collection = __commonJS({
       /**
        * Checks if the collection includes a value with the key `key`.
        */
-      hasIn(path11) {
-        const [key, ...rest] = path11;
+      hasIn(path12) {
+        const [key, ...rest] = path12;
         if (rest.length === 0)
           return this.has(key);
         const node = this.get(key, true);
@@ -957,8 +957,8 @@ var require_Collection = __commonJS({
        * Sets a value in this collection. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path11, value) {
-        const [key, ...rest] = path11;
+      setIn(path12, value) {
+        const [key, ...rest] = path12;
         if (rest.length === 0) {
           this.set(key, value);
         } else {
@@ -3473,9 +3473,9 @@ var require_Document = __commonJS({
           this.contents.add(value);
       }
       /** Adds a value to the document. */
-      addIn(path11, value) {
+      addIn(path12, value) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path11, value);
+          this.contents.addIn(path12, value);
       }
       /**
        * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
@@ -3550,14 +3550,14 @@ var require_Document = __commonJS({
        * Removes a value from the document.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path11) {
-        if (Collection.isEmptyPath(path11)) {
+      deleteIn(path12) {
+        if (Collection.isEmptyPath(path12)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path11) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path12) : false;
       }
       /**
        * Returns item at `key`, or `undefined` if not found. By default unwraps
@@ -3572,10 +3572,10 @@ var require_Document = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path11, keepScalar) {
-        if (Collection.isEmptyPath(path11))
+      getIn(path12, keepScalar) {
+        if (Collection.isEmptyPath(path12))
           return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity.isCollection(this.contents) ? this.contents.getIn(path11, keepScalar) : void 0;
+        return identity.isCollection(this.contents) ? this.contents.getIn(path12, keepScalar) : void 0;
       }
       /**
        * Checks if the document includes a value with the key `key`.
@@ -3586,10 +3586,10 @@ var require_Document = __commonJS({
       /**
        * Checks if the document includes a value at `path`.
        */
-      hasIn(path11) {
-        if (Collection.isEmptyPath(path11))
+      hasIn(path12) {
+        if (Collection.isEmptyPath(path12))
           return this.contents !== void 0;
-        return identity.isCollection(this.contents) ? this.contents.hasIn(path11) : false;
+        return identity.isCollection(this.contents) ? this.contents.hasIn(path12) : false;
       }
       /**
        * Sets a value in this document. For `!!set`, `value` needs to be a
@@ -3606,13 +3606,13 @@ var require_Document = __commonJS({
        * Sets a value in this document. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path11, value) {
-        if (Collection.isEmptyPath(path11)) {
+      setIn(path12, value) {
+        if (Collection.isEmptyPath(path12)) {
           this.contents = value;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path11), value);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path12), value);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path11, value);
+          this.contents.setIn(path12, value);
         }
       }
       /**
@@ -5572,9 +5572,9 @@ var require_cst_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    visit.itemAtPath = (cst, path11) => {
+    visit.itemAtPath = (cst, path12) => {
       let item = cst;
-      for (const [field, index] of path11) {
+      for (const [field, index] of path12) {
         const tok = item?.[field];
         if (tok && "items" in tok) {
           item = tok.items[index];
@@ -5583,23 +5583,23 @@ var require_cst_visit = __commonJS({
       }
       return item;
     };
-    visit.parentCollection = (cst, path11) => {
-      const parent = visit.itemAtPath(cst, path11.slice(0, -1));
-      const field = path11[path11.length - 1][0];
+    visit.parentCollection = (cst, path12) => {
+      const parent = visit.itemAtPath(cst, path12.slice(0, -1));
+      const field = path12[path12.length - 1][0];
       const coll = parent?.[field];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path11, item, visitor) {
-      let ctrl = visitor(item, path11);
+    function _visit(path12, item, visitor) {
+      let ctrl = visitor(item, path12);
       if (typeof ctrl === "symbol")
         return ctrl;
       for (const field of ["key", "value"]) {
         const token = item[field];
         if (token && "items" in token) {
           for (let i = 0; i < token.items.length; ++i) {
-            const ci = _visit(Object.freeze(path11.concat([[field, i]])), token.items[i], visitor);
+            const ci = _visit(Object.freeze(path12.concat([[field, i]])), token.items[i], visitor);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -5610,10 +5610,10 @@ var require_cst_visit = __commonJS({
             }
           }
           if (typeof ctrl === "function" && field === "key")
-            ctrl = ctrl(item, path11);
+            ctrl = ctrl(item, path12);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path11) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path12) : ctrl;
     }
     exports.visit = visit;
   }
@@ -6915,14 +6915,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs8 = this.flowScalar(this.type);
+              const fs10 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map.items.push({ start, key: fs8, sep: [] });
+                map.items.push({ start, key: fs10, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs8);
+                this.stack.push(fs10);
               } else {
-                Object.assign(it, { key: fs8, sep: [] });
+                Object.assign(it, { key: fs10, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -7050,13 +7050,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs8 = this.flowScalar(this.type);
+              const fs10 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs8, sep: [] });
+                fc.items.push({ start: [], key: fs10, sep: [] });
               else if (it.sep)
-                this.stack.push(fs8);
+                this.stack.push(fs10);
               else
-                Object.assign(it, { key: fs8, sep: [] });
+                Object.assign(it, { key: fs10, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -7382,12 +7382,12 @@ var CliError = class extends Error {
 };
 
 // src/commands/agents.ts
-import fs6 from "node:fs";
+import fs7 from "node:fs";
 import path10 from "node:path";
 import { parseArgs } from "node:util";
 
 // src/version.ts
-var VERSION = true ? "0.1.9" : "dev";
+var VERSION = true ? "0.1.11" : "dev";
 var USER_AGENT = `diverge/${VERSION}`;
 
 // src/http.ts
@@ -7916,6 +7916,8 @@ function mergeCodexConfig(existing, block) {
 
 // src/agents/dsh.ts
 var import_yaml = __toESM(require_dist(), 1);
+import fs4 from "node:fs";
+import { createRequire } from "node:module";
 import os4 from "node:os";
 import path5 from "node:path";
 var DSH_SHIPPED_DEFAULT_MODEL = "deepseek-flash";
@@ -8028,6 +8030,83 @@ function dshSettingsDefaultModel(settingsText, surface) {
 function stalePinMessage(settingsPath, pinned, surface, served) {
   return `${settingsPath} pins ${pinned} on divergent-${surface}, which the gateway does not serve; set agent-default-model.model there to one of: ${served.join(", ")} (or remove it to use ${served[0]})`;
 }
+var DIVERGENT_PRESET_ID = "divergent";
+var DSH_USER_PRESETS_DIR = ".agent-presets";
+function dshPackageDir(binary) {
+  if (/\.(cmd|bat)$/i.test(binary)) {
+    const dir2 = path5.join(path5.dirname(binary), "node_modules", "@deepseek-ai", "dsh");
+    return fs4.existsSync(path5.join(dir2, "package.json")) ? dir2 : null;
+  }
+  let dir;
+  try {
+    dir = path5.dirname(fs4.realpathSync(binary));
+  } catch {
+    return null;
+  }
+  for (; ; ) {
+    try {
+      if (JSON.parse(fs4.readFileSync(path5.join(dir, "package.json"), "utf8")).name === "@deepseek-ai/dsh") return dir;
+    } catch {
+    }
+    const parent = path5.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function shippedPresetDir(packageDir, id = "standard") {
+  try {
+    const require2 = createRequire(path5.join(packageDir, "package.json"));
+    const dir = path5.join(path5.dirname(require2.resolve("@deepseek-ai/dsh-agent-presets/package.json")), "presets", id);
+    return fs4.existsSync(path5.join(dir, "agent.cordis.yml")) ? dir : null;
+  } catch {
+    return null;
+  }
+}
+function divergentPreset(shippedComposition) {
+  const lines = shippedComposition.split("\n");
+  const start = lines.findIndex((line) => /^- id: ['"]?tool-web['"]?\s*$/.test(line));
+  if (start === -1) throw new Error("the shipped preset composes no tool-web row");
+  let end = lines.findIndex((line, index) => index > start && /^- /.test(line));
+  if (end === -1) end = lines.length;
+  const row = lines.slice(start, end);
+  const search = row.findIndex((line) => /^\s+search:/.test(line));
+  if (search !== -1) {
+    row[search] = row[search].replace(/:.*$/, ": false");
+  } else {
+    const config = row.findIndex((line) => /^  config:\s*$/.test(line));
+    if (config !== -1) row.splice(config + 1, 0, "    search: false");
+    else row.splice(1, 0, "  config:", "    search: false");
+  }
+  return [
+    `# The Divergent agent preset: dsh's shipped "standard" preset with the vendor web`,
+    "# search left out of the model's tools; the platform's search_online arrives over the",
+    "# bridge (row mcp-divergent). Derived from the installed dsh by `diverge agents",
+    "# setup dsh` and `diverge agents run dsh` on every run; edits do not survive.",
+    ...lines.slice(0, start),
+    ...row,
+    ...lines.slice(end)
+  ].join("\n");
+}
+var DIVERGENT_PRESET_METADATA = [
+  "name: Divergent",
+  "description: The standard coding agent, searching the web through the platform's search_online tool instead of a vendor key.",
+  "order: 0",
+  ""
+].join("\n");
+function writeDivergentPreset(home, shippedDir) {
+  const dir = path5.join(home, DSH_USER_PRESETS_DIR, DIVERGENT_PRESET_ID);
+  writeTextAtomic(path5.join(dir, "agent.cordis.yml"), divergentPreset(fs4.readFileSync(path5.join(shippedDir, "agent.cordis.yml"), "utf8")), 420);
+  writeTextAtomic(path5.join(dir, "preset.yml"), DIVERGENT_PRESET_METADATA, 420);
+  return dir;
+}
+function withDivergentPresetDefault(settingsText) {
+  const parsed = settingsText?.trim() ? (0, import_yaml.parse)(settingsText) : null;
+  const settings = parsed && typeof parsed === "object" && !Array.isArray(parsed) ? { ...parsed } : {};
+  const presets = settings["agent-presets"];
+  if (presets && typeof presets === "object" && presets.default) return null;
+  settings["agent-presets"] = { ...presets ?? {}, default: DIVERGENT_PRESET_ID };
+  return (0, import_yaml.stringify)(settings, { lineWidth: 0 });
+}
 
 // src/agents/opencode.ts
 import os5 from "node:os";
@@ -8049,7 +8128,7 @@ function mergeOpencodeConfig(existing, options) {
 
 // src/agents/run-dsh.ts
 import { spawn as spawn2 } from "node:child_process";
-import fs4 from "node:fs";
+import fs5 from "node:fs";
 import path7 from "node:path";
 function findOnPath(name, env = process.env, platform = process.platform) {
   const dirs = (env.PATH ?? "").split(path7.delimiter).filter(Boolean);
@@ -8059,8 +8138,8 @@ function findOnPath(name, env = process.env, platform = process.platform) {
     for (const candidate of candidates) {
       const full = path7.join(dir, candidate);
       try {
-        fs4.accessSync(full, fs4.constants.X_OK);
-        if (fs4.statSync(full).isFile()) return full;
+        fs5.accessSync(full, fs5.constants.X_OK);
+        if (fs5.statSync(full).isFile()) return full;
       } catch {
       }
     }
@@ -8068,7 +8147,7 @@ function findOnPath(name, env = process.env, platform = process.platform) {
   return null;
 }
 function writeDshToken(credentialsPath, accessToken) {
-  const existing = fs4.existsSync(credentialsPath) ? fs4.readFileSync(credentialsPath, "utf8") : null;
+  const existing = fs5.existsSync(credentialsPath) ? fs5.readFileSync(credentialsPath, "utf8") : null;
   let merged;
   try {
     merged = mergeDshCredentials(existing, accessToken);
@@ -8086,7 +8165,7 @@ function dshLaunch(binary, args, platform = process.platform, execPath = process
   const packageDir = path7.join(path7.dirname(binary), "node_modules", "@deepseek-ai", "dsh");
   let bin;
   try {
-    bin = JSON.parse(fs4.readFileSync(path7.join(packageDir, "package.json"), "utf8")).bin;
+    bin = JSON.parse(fs5.readFileSync(path7.join(packageDir, "package.json"), "utf8")).bin;
   } catch {
     throw new CliError(`${binary} is not an npm shim for @deepseek-ai/dsh (no ${packageDir}); reinstall: npm install -g @deepseek-ai/dsh`);
   }
@@ -8177,19 +8256,19 @@ async function rotateTokenFile(loop) {
 }
 
 // src/agents/self-command.ts
-import fs5 from "node:fs";
+import fs6 from "node:fs";
 import path9 from "node:path";
 function resolveSelfCommand(argv = process.argv, platform = process.platform, execPath = process.execPath) {
   const script = argv[1];
   if (!script) return { command: execPath, args: [] };
   if (platform !== "win32") {
     try {
-      fs5.accessSync(script, fs5.constants.X_OK);
+      fs6.accessSync(script, fs6.constants.X_OK);
       return { command: path9.resolve(script), args: [] };
     } catch {
     }
   }
-  return { command: execPath, args: [fs5.realpathSync(script)] };
+  return { command: execPath, args: [fs6.realpathSync(script)] };
 }
 function shellCommand(self, ...trailing) {
   return [self.command, ...self.args, ...trailing].map((part) => /[\s"]/.test(part) ? `"${part.replace(/"/g, '\\"')}"` : part).join(" ");
@@ -8216,12 +8295,29 @@ function surfaceOf(value, fallback) {
   throw new CliError(`--surface must be one of: ${SURFACES.join(", ")}`);
 }
 function readJson(file) {
-  if (!fs6.existsSync(file)) return null;
-  return JSON.parse(fs6.readFileSync(file, "utf8"));
+  if (!fs7.existsSync(file)) return null;
+  return JSON.parse(fs7.readFileSync(file, "utf8"));
 }
 async function servedModels(apiUrl, token, surface) {
   return (await listModels(apiUrl, token.access_token, surface)).map((entry) => entry.id);
 }
+function syncDivergentPreset(io, binary, home) {
+  if (!binary) {
+    io.stderr("dsh is not on PATH; the Divergent agent preset is derived when `diverge agents run dsh` first runs.");
+    return;
+  }
+  const packageDir = dshPackageDir(binary);
+  const shipped = packageDir ? shippedPresetDir(packageDir) : null;
+  if (!shipped) {
+    io.stderr(`warning: no shipped "standard" preset found behind ${binary}; dsh's own web_search stays in its web sessions and fails without a vendor key`);
+    return;
+  }
+  const dir = writeDivergentPreset(home, shipped);
+  const settingsPath = path10.join(home, "settings.yaml");
+  const settings = withDivergentPresetDefault(fs7.existsSync(settingsPath) ? fs7.readFileSync(settingsPath, "utf8") : null);
+  if (settings !== null) writeTextAtomic(settingsPath, settings);
+  io.stderr(`Agent preset "${DIVERGENT_PRESET_ID}" (${dir}): web sessions search through the platform${settings !== null ? "; set as the default preset in settings.yaml" : ""}.`);
+}
 async function overlayAndDefault(apiUrl, token, surface, io, requested) {
   const models = await servedModels(apiUrl, token, surface);
   if (models.length === 0) throw new CliError(`the gateway serves no models on the ${surface} surface for this organization`);
@@ -8277,7 +8373,7 @@ async function setup(args, io) {
       }
       const token = await ensureInferenceLogin(io, apiUrl, values["organization-id"]);
       const file = values.config ?? codexConfigPath();
-      const existing = fs6.existsSync(file) ? fs6.readFileSync(file, "utf8") : null;
+      const existing = fs7.existsSync(file) ? fs7.readFileSync(file, "utf8") : null;
       writeTextAtomic(file, mergeCodexConfig(existing, block));
       io.stdout(`Codex provider divergent \u2192 ${openaiBaseUrl(apiUrl)} as you, organization ${tokenClaims(token.access_token).organizationId}. Wrote ${file}.`);
       io.stdout('Select it per run with: codex -c model_provider=divergent   (or set model_provider = "divergent" in the config)');
@@ -8296,6 +8392,7 @@ async function setup(args, io) {
       writeTextAtomic(file, overlay);
       io.stdout(`dsh route divergent-${surface} \u2192 ${surfaceBaseUrl(apiUrl, surface)} as you, organization ${tokenClaims(token.access_token).organizationId}, default model ${defaultModel}. Wrote ${file}.`);
       io.stdout("Web search is the platform tool search_online over `diverge tools bridge` (row mcp-divergent); dsh's DeepSeek search is off.");
+      syncDivergentPreset(io, findOnPath("dsh", io.env), dshHome(io.env));
       io.stdout("Boot a profile with the overlay and the token in its environment (user tokens expire; the login refreshes):");
       io.stdout(`  DIVERGENT_TOKEN="$(diverge token)" dsh --profile headless --patch ${file} "<task>"`);
       io.stdout(`or let the CLI keep the token fresh for the whole session:  diverge agents run dsh --surface ${surface} -- --profile web --port 3131 --no-open`);
@@ -8326,7 +8423,7 @@ ${agentsUsage}`);
   const settingsPath = path10.join(home, "settings.yaml");
   let pinned;
   try {
-    pinned = dshSettingsDefaultModel(fs6.existsSync(settingsPath) ? fs6.readFileSync(settingsPath, "utf8") : null, surface);
+    pinned = dshSettingsDefaultModel(fs7.existsSync(settingsPath) ? fs7.readFileSync(settingsPath, "utf8") : null, surface);
   } catch (error) {
     throw new CliError(`${settingsPath}: ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -8334,6 +8431,7 @@ ${agentsUsage}`);
   if (pinned && !served.includes(pinned)) throw new CliError(stalePinMessage(settingsPath, pinned, surface, served));
   const overlayPath = path10.join(home, `divergent-${surface}.yml`);
   writeTextAtomic(overlayPath, overlay);
+  syncDivergentPreset(io, binary, home);
   io.stderr(`dsh on divergent-${surface} as you (organization ${tokenClaims(token.access_token).organizationId}), default model ${defaultModel}`);
   if (passthrough.length === 0) io.stderr('Starting the web UI; open the URL dsh prints. For one task without the UI: diverge agents run dsh -- "<task>"');
   const source = { tokenFile: tokenFile(io.env), baseUrl: apiUrl, clientId: clientId(io.env) };
@@ -8793,10 +8891,10 @@ var ToolsClient = class {
     if (this.settings.mode === "service") headers["x-divergent-user-id"] = this.settings.delegatedUserId;
     return headers;
   }
-  scoped(path11) {
+  scoped(path12) {
     const query = new URLSearchParams({ organizationId: this.settings.organizationId });
     if (this.settings.projectId) query.set("projectId", this.settings.projectId);
-    return `${this.settings.apiUrl}${path11}?${query.toString()}`;
+    return `${this.settings.apiUrl}${path12}?${query.toString()}`;
   }
   async send(method, url, body) {
     return this.request(method, url, body, void 0);
@@ -9277,7 +9375,7 @@ ${toolsUsage}`);
 }
 
 // src/commands/plugins.ts
-import fs7 from "node:fs";
+import fs8 from "node:fs";
 import { parseArgs as parseArgs5 } from "node:util";
 var pluginsUsage = `diverge plugins <validate|publish|list|retire> [--organization-id <id>] ...
 
@@ -9304,7 +9402,7 @@ function readManifest(file) {
 ${pluginsUsage}`);
   let text;
   try {
-    text = fs7.readFileSync(file, "utf8");
+    text = fs8.readFileSync(file, "utf8");
   } catch (error) {
     throw new CliError(`Cannot read ${file}: ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -9403,7 +9501,57 @@ ${pluginsUsage}`);
 }
 
 // src/commands/update.ts
+import { spawn as spawn4 } from "node:child_process";
+
+// src/update-notice.ts
 import { spawn as spawn3 } from "node:child_process";
+import fs9 from "node:fs";
+import path11 from "node:path";
+var UPDATE_CHECK_FILE = "update-check.json";
+var UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+function updateCheckFile(env) {
+  return path11.join(configDir(env), UPDATE_CHECK_FILE);
+}
+function readUpdateCheck(env) {
+  try {
+    const parsed = JSON.parse(fs9.readFileSync(updateCheckFile(env), "utf8"));
+    if (parsed && typeof parsed === "object" && typeof parsed.checkedAt === "number" && typeof parsed.latest === "string") return parsed;
+  } catch {
+  }
+  return null;
+}
+function writeUpdateCheck(env, check) {
+  writeJsonAtomic(updateCheckFile(env), check);
+}
+function noticeFor(check, version = VERSION) {
+  if (!check || !isNewer(check.latest, version)) return null;
+  return `diverge ${check.latest} is available (this is ${version}). Update with: diverge update   (or run npx @divergeai/cli@latest)`;
+}
+function noticeApplies(argv, io, version = VERSION) {
+  if (version === "dev" || !io.interactive) return false;
+  if (io.env.DIVERGE_NO_UPDATE_CHECK?.trim() || io.env.CI?.trim()) return false;
+  if (argv[0] === "update") return false;
+  if (argv[0] === "tools" && argv[1] === "bridge") return false;
+  return true;
+}
+function scheduleUpdateCheck(spawnImpl = spawn3) {
+  try {
+    const child = spawnImpl(process.execPath, [process.argv[1], "update", "--record"], { detached: true, stdio: "ignore" });
+    child.on("error", () => {
+    });
+    child.unref();
+  } catch {
+  }
+}
+function updateNotice(argv, io, deps = { now: Date.now, schedule: scheduleUpdateCheck, read: readUpdateCheck, version: VERSION }) {
+  if (!noticeApplies(argv, io, deps.version)) return;
+  const check = deps.read(io.env);
+  const notice = noticeFor(check, deps.version);
+  if (notice) io.stderr(notice);
+  if (!check || deps.now() - check.checkedAt > UPDATE_CHECK_INTERVAL_MS) deps.schedule();
+}
+
+// src/commands/update.ts
 var PACKAGE_NAME = "@divergeai/cli";
 var updateUsage = "diverge update\n\nInstall the latest release with the npm that installed this one.";
 async function latestVersion(registry = "https://registry.npmjs.org") {
@@ -9428,7 +9576,14 @@ function isNewer(a, b) {
   if (!y.pre) return false;
   return x.pre > y.pre;
 }
-async function runUpdate(_args, io, deps = { latestVersion, install: installLatest }) {
+async function runUpdate(args, io, deps = { latestVersion, install: installLatest, record: writeUpdateCheck, now: Date.now }) {
+  if (args[0] === "--record") {
+    try {
+      deps.record(io.env, { checkedAt: deps.now(), latest: await deps.latestVersion() });
+    } catch {
+    }
+    return ExitCode.Ok;
+  }
   if (VERSION === "dev") throw new CliError("This is a source checkout, not an installed release; pull the repository instead.");
   const latest = await deps.latestVersion();
   if (!isNewer(latest, VERSION)) {
@@ -9444,7 +9599,7 @@ async function runUpdate(_args, io, deps = { latestVersion, install: installLate
 function installLatest(version) {
   const npm = process.platform === "win32" ? "npm.cmd" : "npm";
   return new Promise((resolve, reject) => {
-    const child = spawn3(npm, ["install", "-g", `${PACKAGE_NAME}@${version}`], { stdio: "inherit" });
+    const child = spawn4(npm, ["install", "-g", `${PACKAGE_NAME}@${version}`], { stdio: "inherit" });
     child.on("error", reject);
     child.on("exit", (code2) => resolve(code2 ?? 1));
   });
@@ -9499,6 +9654,11 @@ ${usage()}`);
     io.stdout(command.usage);
     return ExitCode.Ok;
   }
+  const code2 = await runCommand(command, rest, io);
+  updateNotice(argv, io);
+  return code2;
+}
+async function runCommand(command, rest, io) {
   try {
     return await command.run(rest, io);
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@divergeai/cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Divergent platform CLI: sign in, wire coding agents to the inference gateway, call platform tools",
   "license": "UNLICENSED",
   "type": "module",