dsh-cline-pass 0.2.1 → 0.2.2

package/README.en.md

@@ -13,7 +13,7 @@ Connect [Cline Pass](https://cline.bot/cline-pass) subscription models to the [D
 
 ## Requirements
 
-- dsh `>= 0.1.2-alpha.3 < 0.2.0`
+- dsh `>= 0.1.2-alpha.3 < 0.3.0`
 - Node.js `>= 20.3`
 - A Cline Pass API key
 
@@ -68,7 +68,25 @@ To override defaults, add a `cline-pass` section to your profile's `$DSH_HOME/pr
         apiKeyEnv: CLINE_PASS_BACKUP_KEY
 ```
 
-Common settings include `baseURL`, `knownModels`, `models`, `perModel`, `exposeCatalog`, and `historyLimit`. The default gateway is `https://api.cline.bot/api/v1`. `maxConcurrentRequests` caps how many streams each account keeps open to the gateway at once (default 16); further requests wait for a free slot, and `0` lifts the cap.
+Common settings include `baseURL`, `knownModels`, `models`, `perModel`, `exposeTools`, `exposeCatalog`, and `historyLimit`. The default gateway is `https://api.cline.bot/api/v1`. `maxConcurrentRequests` caps how many streams each account keeps open to the gateway at once (default 16); further requests wait for a free slot, and `0` lifts the cap.
+
+### Management tools
+
+The `cline_pass_*` tools are **not registered by default**. Their eight definitions total roughly 5.5k characters of schema and description that ride in every request's tool list, and managing the route is an occasional need, so the default keeps that cost out of every conversation.
+
+Turn them on with **Expose the tools (takes effect after a restart)** in **Settings → Cline Pass**, or in the profile configuration:
+
+```yaml
+- id: cline-pass
+  config:
+    exposeTools: true
+```
+
+**The value is read when the plugin activates, so a change needs a dsh restart** — a tool already registered cannot be pulled back out of a conversation in progress.
+
+The provider route and the setup panel are unaffected — the panel is a browser page rather than a tool, and it stays available with the tools off.
+
+> A profile upgraded from 0.2.1 or earlier has no `exposeTools` key, so it adopts the new default of `false` and its `cline_pass_*` tools stop being registered. The panel reports this; tick the checkbox and restart to bring them back.
 
 ## Upstream channels
 

package/README.md

@@ -13,7 +13,7 @@
 
 ## 要求
 
-- dsh `>= 0.1.2-alpha.3`
+- dsh `>= 0.1.2-alpha.3 < 0.3.0`
 - Node.js `>= 20.3`
 - Cline Pass API Key
 
@@ -68,6 +68,24 @@ cline_pass_accounts action=mode mode=roundrobin
         apiKeyEnv: CLINE_PASS_BACKUP_KEY
 ```
 
+### 管理工具
+
+`cline_pass_*` 工具**默认不注册**。8 个工具定义合计约 5.5k 字符，会出现在每次请求的工具列表里，而管理路由只是偶尔需要，所以默认让所有对话都不必付这份开销。
+
+需要时在**设置 → Cline Pass** 中勾选「开启工具注入（重启后生效）」，或在 profile 配置里打开：
+
+```yaml
+- id: cline-pass
+  config:
+    exposeTools: true
+```
+
+**该值在插件激活时读取，改动后需重启 dsh 才生效** —— 已经注册的工具无法从进行中的对话里撤回。
+
+提供商路由和设置面板不受影响 —— 面板是浏览器页面而非工具，工具关闭时仍然可用。
+
+> 从 0.2.1 及更早版本升级的 profile 里没有 `exposeTools` 键，因此会采用新的默认值 `false`：升级后 `cline_pass_*` 工具将不再注册。面板会提示，勾选该复选框并在重启后恢复。
+
 常用设置包括 `baseURL`、`knownModels`、`models`、`perModel`、`exposeCatalog` 和 `historyLimit`。默认网关地址为 `https://api.cline.bot/api/v1`。`maxConcurrentRequests` 限制每个账号同时发往网关的流数，默认 16，超出的请求排队等待空位，设为 `0` 表示不限。
 
 ## 上游渠道

package/lib/client.js

@@ -240,6 +240,7 @@ window.__ModuleLoader__.load({
       '.cp-usage-model-cost{font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-primary)}',
       '.cp-usage-model-tokens{font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-tertiary);min-width:52px;text-align:right}',
       '.cp-check{width:14px;height:14px;flex:none;cursor:pointer;accent-color:var(--dsw-alias-brand-primary)}',
+      '.cp-tools-label{cursor:pointer;gap:8px}',
       '.cp-model-hidden .cp-mono,.cp-model-hidden .cp-check{opacity:.55}',
     ].join('')
 
@@ -336,6 +337,7 @@ window.__ModuleLoader__.load({
       noHistory: '暂无记录。',
       busy: '处理中…',
       settingsUnavailable: '设置服务不可用，改动无法保存。',
+      toolsExpose: '开启工具注入（重启后生效）',
       retry: '重试',
     }
     const EN = {
@@ -418,6 +420,7 @@ window.__ModuleLoader__.load({
       noHistory: 'Nothing recorded.',
       busy: 'Working…',
       settingsUnavailable: 'Settings are read-only; changes will not persist.',
+      toolsExpose: 'Expose the tools (takes effect after a restart)',
       retry: 'Retry',
     }
 
@@ -697,6 +700,7 @@ window.__ModuleLoader__.load({
           setAccountEnabled: (name, enabled) => controller.setAccountEnabled(name, enabled),
           pinModel: (payload) => controller.pinModel(payload),
           setModelVisible: (model, visible) => controller.setModelVisible(model, visible),
+          setToolsExposed: (value) => controller.setToolsExposed(value),
           setModelsVisibility: (mode) => controller.setModelsVisibility(mode),
           probeModel: (model) => controller.probeModel(model),
           validateModel: (model) => controller.validateModel(model),
@@ -872,6 +876,21 @@ window.__ModuleLoader__.load({
         return result
       }
 
+      /**
+       * Turn the `cline_pass_*` tools on or off.
+       *
+       * The host reads the setting when the plugin activates, so this cannot
+       * change the running plugin: a tool already registered cannot be pulled
+       * back out of a conversation's tool list. The host says as much in its
+       * reply, and the panel relays it rather than implying the switch already
+       * took effect.
+       */
+      async setToolsExposed(value) {
+        const result = await this.run('tools', async () => await this.call('tools.expose', { value }))
+        if (result !== undefined) this.applyState(result)
+        return result
+      }
+
       /**
        * Show, hide or swap every subscription model at once.
        *
@@ -1660,6 +1679,7 @@ window.__ModuleLoader__.load({
         setAccountEnabled: props.setAccountEnabled,
         pinModel: props.pinModel,
         setModelVisible: props.setModelVisible,
+        setToolsExposed: props.setToolsExposed,
         setModelsVisibility: props.setModelsVisibility,
         probeModel: props.probeModel,
         validateModel: props.validateModel,
@@ -1713,6 +1733,21 @@ window.__ModuleLoader__.load({
         // Everything below the accounts card reads through the key that card
         // stores, so none of it exists until there is one.
         data === null || !ready ? null : h(ModelsCard, { key: 'models', t, data, disabled, busy: state.busy, actions }),
+        // Route-wide switches last: they are not about one model or account, and
+        // nothing below them depends on their value.
+        data === null ? null : h('div', { key: 'tools', className: 'cp-card' }, [
+          h('label', { key: 'head', className: 'cp-row cp-tools-label' }, [
+            h('input', {
+              key: 'on',
+              type: 'checkbox',
+              className: 'cp-check',
+              checked: data.exposeTools !== false,
+              disabled,
+              onChange: (event) => actions.setToolsExposed(event.target.checked),
+            }),
+            h('span', { key: 'l' }, t('toolsExpose')),
+          ]),
+        ]),
         // Diagnostic detail, so it stays folded away until asked for.
         data === null || !ready ? null : h('details', { key: 'history', className: 'cp-card' }, [
           foldHeader(`${t('history')} · ${total}`),

package/lib/index.js

@@ -144,6 +144,24 @@ export const Config = z.object({
    * waits) instead of opening another stream. `0` lifts the cap.
    */
   maxConcurrentRequests: z.number().default(DEFAULT_MAX_CONCURRENT_REQUESTS),
+  /**
+   * Whether the `cline_pass_*` management tools are registered at all.
+   *
+   * The eight definitions are ~5.5k characters of schema and description that
+   * ride in every request's tool list, and the route itself does not need them:
+   * a conversation that never probes, pins or edits the pool pays for them on
+   * every turn. Off leaves the provider and the setup panel exactly as they are
+   * — the panel is a browser page, not a tool, so it keeps working.
+   *
+   * Off by default: the cost is paid by every conversation, while the tools are
+   * wanted by the few that manage the route. Turning them on is one checkbox.
+   * Existing profiles have no `exposeTools` key, so they adopt this default on
+   * upgrade and their tools stop being registered — the panel says so, and the
+   * checkbox restores them.
+   *
+   * Read when the plugin activates, so a change needs a restart.
+   */
+  exposeTools: z.boolean().default(false),
   exposeCatalog: z.boolean().default(false),
   historyLimit: z.number().default(100),
   /**
@@ -543,9 +561,22 @@ export function apply(ctx, config) {
       await credentials.set(credentialRef(ref), String(value))
     },
     refreshCatalog,
+    // Read at activation, so this reports the value the running plugin was
+    // built with rather than the current config field.
+    exposeTools: () => toolsExposed,
   }
 
-  registerTools(ctx, { store, engine, control })
+  // The agent-facing management surface. Optional: the eight definitions are
+  // ~5.5k characters of tool list on every request, and a conversation that
+  // never probes, pins or edits the pool does not need them. `exposeTools:
+  // false` drops them while leaving the provider and the setup panel — a
+  // browser page rather than a tool — untouched.
+  const toolsExposed = config.exposeTools !== false
+  if (toolsExposed) {
+    registerTools(ctx, { store, engine, control })
+  } else {
+    ctx.logger?.info('[cline-pass] cline_pass_* tools are not exposed (exposeTools: false); the provider route and the setup panel are unaffected')
+  }
 
   // The same surface as an ordinary browser page, for users who would rather
   // click than compose a tool call. Absent in a headless composition.

package/lib/panel.js

@@ -139,6 +139,10 @@ export function createPanel({ control, engine, store }) {
       usage: store.usage(),
       catalogCount: Number(store.catalog()?.ids?.length ?? 0),
       historySize: store.historySize(),
+      // Whether the `cline_pass_*` tools are registered. Reported, not switched:
+      // the value is read when the plugin activates, so a control here could not
+      // take effect without a reload.
+      exposeTools: control.exposeTools(),
     }
   }
 
@@ -470,6 +474,21 @@ export function createPanel({ control, engine, store }) {
     }
   }
 
+  /**
+   * Whether the `cline_pass_*` tools are registered.
+   *
+   * The value is read when the plugin activates, so this writes the setting for
+   * the next start rather than changing the running plugin: a tool that is
+   * already registered cannot be pulled back out of a conversation's tool list.
+   * The response carries `restartRequired` so the panel can say so instead of
+   * implying the switch already took effect.
+   */
+  async function toolsExpose(payload) {
+    if (typeof payload?.value !== 'boolean') throw new Error('this action needs a boolean `value`')
+    await control.updateConfig({ exposeTools: payload.value })
+    return { restartRequired: true, ...(await state()) }
+  }
+
   return {
     state,
     usage,
@@ -487,6 +506,7 @@ export function createPanel({ control, engine, store }) {
     'model.test': modelTest,
     'model.reset': modelReset,
     'models.refresh': modelsRefresh,
+    'tools.expose': toolsExpose,
     history,
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cline-pass",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Self-contained Cline Pass provider for dsh: register Cline Pass subscription models on the harness LLM seam, enumerate and validate the upstream channels behind each model, pin or exclude them with failover, and drive an account pool. No proxy process and no external cline-pass-switcher install required.",
   "type": "module",
   "main": "lib/index.js",
@@ -56,18 +56,18 @@
       ]
     },
     "compatibility": {
-      "dsh": ">=0.1.2-alpha.3 <0.2.0"
+      "dsh": ">=0.1.2-alpha.3 <0.3.0"
     }
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-credentials": ">=0.1.2-alpha.3 <0.2.0",
-    "@deepseek-ai/dsh-launch-environment": ">=0.1.2-alpha.3 <0.2.0",
-    "@deepseek-ai/dsh-llm": ">=0.1.2-alpha.3 <0.2.0",
-    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.3 <0.2.0",
-    "@deepseek-ai/dsh-timeout": ">=0.1.2-alpha.3 <0.2.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.3 <0.2.0",
-    "@deepseek-ai/dsh-util-values": ">=0.1.2-alpha.3 <0.2.0",
+    "@deepseek-ai/dsh-credentials": ">=0.1.2-alpha.3 <0.3.0",
+    "@deepseek-ai/dsh-launch-environment": ">=0.1.2-alpha.3 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-alpha.3 <0.3.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.3 <0.3.0",
+    "@deepseek-ai/dsh-timeout": ">=0.1.2-alpha.3 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.3 <0.3.0",
+    "@deepseek-ai/dsh-util-values": ">=0.1.2-alpha.3 <0.3.0",
     "@deepseek-ai/schemastery": "^3.18.1"
   }
 }