dsh-ops 0.2.2 → 0.2.4

package/dsh-plugin.json

@@ -3,7 +3,7 @@
   "manifestVersion": "0.15",
   "id": "dsh-ops.fastctx",
   "name": "dsh-ops",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "license": "MIT AND Apache-2.0",
   "facets": {
     "host": {
@@ -39,9 +39,9 @@
   "contributes": {
     "x-display": [
       {
-        "icon": "./icon.svg",
-        "title": "Repository tools",
-        "description": "Read, search, replace, and run commands through the hosted FastCtx ops_* tool surface instead of shell commands.",
+        "icon": "./icon.png",
+        "title": "dsh-ops",
+        "description": "Provides bash, PowerShell 7, and a suite of high-performance tools written in Rust for Windows DSH to enhance token efficiency",
         "locales": [
           "locale/en.json",
           "locale/zh.json"
@@ -50,9 +50,19 @@
     ],
     "x-prompt-sections": [
       {
-        "name": "dsh-ops:repository-tooling",
+        "name": "dsh-ops:repository-tooling:file",
         "order": 3250,
-        "summary": "Compact tools-to-bash-to-PowerShell-7 routing; prefer bash except for Windows-native operations."
+        "summary": "File operations only; follows the file component visibility."
+      },
+      {
+        "name": "dsh-ops:repository-tooling:shell",
+        "order": 3251,
+        "summary": "Prefer bash, use bundled PowerShell 7 for Windows-native functionality; removed when shell component is off."
+      },
+      {
+        "name": "dsh-ops:repository-tooling:background",
+        "order": 3252,
+        "summary": "Owned background tasks only; absent by default."
       }
     ],
     "x-tool-namespaces": [
@@ -66,21 +76,39 @@
           "grep",
           "glob",
           "replace",
-          "run",
           "run_background",
           "job_output",
           "job_list",
           "job_kill"
         ],
-        "shellPermission": "enableShellTools AND per-session sandboxPolicy danger-full-access"
+        "shellPermission": "background component enabled AND enableShellTools AND per-session sandboxPolicy danger-full-access"
       },
       {
         "serverName": "dsh-ops",
         "transport": "in-process",
         "source": "the plugin's bash layer via host subprocess",
         "publicPrefix": "ops_",
-        "tools": ["bash"],
-        "shellPermission": "publishBashTool AND per-session sandboxPolicy danger-full-access"
+        "tools": [
+          "bash"
+        ],
+        "shellPermission": "shell component enabled AND publishBashTool AND per-session sandboxPolicy danger-full-access"
+      }
+    ],
+    "x-components": [
+      {
+        "id": "dsh-ops-shell",
+        "entry": "dsh-ops/shell",
+        "defaultEnabled": true
+      },
+      {
+        "id": "dsh-ops-file",
+        "entry": "dsh-ops/file",
+        "defaultEnabled": true
+      },
+      {
+        "id": "dsh-ops-background",
+        "entry": "dsh-ops/background",
+        "defaultEnabled": false
       }
     ]
   },

package/lib/components/background/index.js

@@ -0,0 +1,3 @@
+import { applyComponent } from "../../index.js"
+export const name = "dsh-ops-background"
+export function apply(ctx, config) { return applyComponent(ctx, config, "background") }

package/lib/components/background/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-ops-background",
+    "description": "Manage scientific simulations, model training, and other long-running background tasks."
+  }
+}

package/lib/components/background/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-ops-background",
+    "description": "为科研仿真、模型训练及其他长进程后台任务提供托管"
+  }
+}

package/lib/components/background/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "dsh-ops-background",
+  "description": "Manage scientific simulations, model training, and other long-running background tasks.",
+  "icon": "./icon.png",
+  "type": "module"
+}

package/lib/components/file/index.js

@@ -0,0 +1,3 @@
+import { applyComponent } from "../../index.js"
+export const name = "dsh-ops-file"
+export function apply(ctx, config) { return applyComponent(ctx, config, "file") }

package/lib/components/file/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-ops-file",
+    "description": "High-performance Rust file search with faster execution and compact output for token efficiency."
+  }
+}

package/lib/components/file/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-ops-file",
+    "description": "更快、更高性能、输出更精简更省token的rust文件检索"
+  }
+}

package/lib/components/file/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "dsh-ops-file",
+  "description": "High-performance Rust file search with faster execution and compact output for token efficiency.",
+  "icon": "./icon.png",
+  "type": "module"
+}

package/lib/components/shell/index.js

@@ -0,0 +1,3 @@
+import { applyComponent } from "../../index.js"
+export const name = "dsh-ops-bash & powershell 7"
+export function apply(ctx, config) { return applyComponent(ctx, config, "shell") }

package/lib/components/shell/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-ops-bash & powershell 7",
+    "description": "Prefer bash for general commands and provide PowerShell 7 when Windows-native functionality is needed."
+  }
+}

package/lib/components/shell/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-ops-bash & powershell 7",
+    "description": "将默认终端改为bash，以及bash覆盖不到时提供powershell7"
+  }
+}

package/lib/components/shell/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "dsh-ops-bash & powershell 7",
+  "description": "Prefer bash for general commands and provide PowerShell 7 when Windows-native functionality is needed.",
+  "icon": "./icon.png",
+  "type": "module"
+}

package/lib/index.js

@@ -1,9 +1,10 @@
 /** dsh-ops host half. Own registrations only; no @deepseek-ai value imports. */
 import { PACKAGE_ROOT, probeBinary, resolveBinary } from './binary.js'
 import { resolveConfig } from './config.js'
-import { SECTION_ORDERS, TOOLING_SECTION, hostShellRefusal, renderToolingPolicy } from './policy.js'
+import { SECTION_ORDERS, TOOLING_SECTION, BACKGROUND_TOOLS, FILE_TOOLS, BASH_TOOL, publicToolName, hostShellRefusal, renderToolingPolicy } from './policy.js'
 import { resolveShells } from './shells.js'
 import { mountSessionBash } from './session-shells.js'
+import { mountBundledPwsh } from './session-pwsh.js'
 import { FastCtxTools } from './tools.js'
 
 export const name = 'dsh-ops'
@@ -54,30 +55,34 @@ function installHostShellDenial(ctx, config) {
   }
 }
 
-async function mountServer(ctx, config, runtime) {
+async function mountServer(ctx, config, runtime, component) {
   if (!runtime) return
-  const surface = new FastCtxTools({ ctx, config, runtime, report: (message, level) => report(ctx, message, level) })
+  const background = component === 'background'
+  const surface = new FastCtxTools({ ctx, config, runtime,
+    fileTools: !background, commandTools: background ? BACKGROUND_TOOLS : [], shared: true,
+    report: (message, level) => report(ctx, message, level) })
   ctx.effect(() => () => surface.stop(), 'dsh-ops: fastctx server')
-  ctx.on('agent/created', ({ agent }) => surface.attachAgent(agent))
-  ctx.on('agent/disposed', ({ agent }) => surface.detachAgent(agent))
-  ctx.on('session/event', (session, event) => {
-    if (event.type === 'sandbox/mode') surface.refreshAgents(session)
-  })
-  // Authority may mount after the tools service or be hot-reloaded. Losing it
-  // immediately retires every command layer; it never falls back to env state.
-  surface.authorityAvailable = false
-  ctx.inject(['sandboxPolicy'], authorityCtx => {
-    surface.authorityAvailable = true
-    surface.refreshAgents()
-    authorityCtx.effect(() => () => {
-      surface.authorityAvailable = false
+  if (background) {
+    ctx.on('agent/created', ({ agent }) => surface.attachAgent(agent))
+    ctx.on('agent/disposed', ({ agent }) => surface.detachAgent(agent))
+    ctx.on('session/event', (_session, event) => {
+      if (event.type === 'sandbox/mode') surface.refreshAgents()
+    })
+    // Background command layers follow authoritative per-session permission.
+    surface.authorityAvailable = false
+    ctx.inject(['sandboxPolicy'], authorityCtx => {
+      surface.authorityAvailable = true
       surface.refreshAgents()
-    }, 'dsh-ops: permission authority')
-  })
-  for (const agent of ctx.get('agents')?.list?.() ?? []) surface.attachAgent(agent)
+      authorityCtx.effect(() => () => {
+        surface.authorityAvailable = false
+        surface.refreshAgents()
+      }, 'dsh-ops: permission authority')
+    })
+    for (const agent of ctx.get('agents')?.list?.() ?? []) surface.attachAgent(agent)
+  }
   try {
     const tools = await surface.start()
-    report(ctx, `dsh-ops: FastCtx ${runtime.version} ready; ${tools.length} file tools, session-authorized command layers.`, 'info')
+    report(ctx, `dsh-ops: FastCtx ${runtime.version} ready; ${component} component, ${tools.length} global tools.`, 'info')
   } catch (error) {
     report(ctx, `dsh-ops: FastCtx unavailable: ${error.message}`)
     if (config.required) throw error
@@ -85,24 +90,33 @@ async function mountServer(ctx, config, runtime) {
   }
 }
 
-export function apply(root, rawConfig) {
+export function applyComponent(root, rawConfig, component) {
   const config = resolveConfig(rawConfig)
-  const runtime = prepareRuntime(root, config)
-  const shells = resolveShells(config)
+  const runtime = component === 'shell' ? undefined : prepareRuntime(root, config)
+  const shells = component === 'shell' ? resolveShells(config) : undefined
+  const owned = component === 'shell' ? [BASH_TOOL, 'pwsh']
+    : component === 'file' ? FILE_TOOLS.map(publicToolName) : BACKGROUND_TOOLS.map(publicToolName)
+  if (component === 'file') owned.push('read_image')
   if (config.promptPolicy) root.inject(['systemPrompt'], ctx => {
     ctx.effect(() => ctx.systemPrompt.section({
-      name: TOOLING_SECTION,
-      order: SECTION_ORDERS[TOOLING_SECTION],
+      name: `${TOOLING_SECTION}:${component}`,
+      order: SECTION_ORDERS[TOOLING_SECTION] + (component === 'shell' ? 1 : component === 'background' ? 2 : 0),
       interpolate: false,
       text: context => renderToolingPolicy({
-        published: visibleTools(ctx, context.agent), pwsh7: shells.pwsh.available,
+        published: visibleTools(ctx, context.agent).filter(name => owned.includes(name)),
+        shellComponent: component === 'shell', pwsh7: shells?.pwsh.available ?? false,
         extraGuidance: config.extraGuidance,
       }),
-    }), 'dsh-ops: repository tooling')
-  })
-  root.inject(['tools'], ctx => {
-    mountSessionBash(ctx, config, shells)
-    if (config.shellPolicy === 'deny-host-shell') installHostShellDenial(ctx, config)
-    return mountServer(ctx, config, runtime)
+    }), `dsh-ops: ${component} tooling`)
   })
+  if (component === 'shell') {
+    mountBundledPwsh(root, shells)
+    root.inject(['tools'], ctx => {
+      mountSessionBash(ctx, config, shells)
+      if (config.shellPolicy === 'deny-host-shell') installHostShellDenial(ctx, config)
+    })
+  } else root.inject(['tools'], ctx => mountServer(ctx, config, runtime, component))
 }
+
+// Backward-compatible module entry. The bundle uses independently toggled rows.
+export function apply(root, rawConfig) { return applyComponent(root, rawConfig, 'file') }

package/lib/policy.js

@@ -5,7 +5,8 @@ export const HOST_SHELL_SECTION = 'dsh-ops:host-shell-policy'
 export const SECTION_ORDERS = Object.freeze({ [TOOLING_SECTION]: 3250 })
 export const TOOL_PREFIX = 'ops_'
 export const FILE_TOOLS = Object.freeze(['inspect_local_file', 'grep', 'glob', 'replace'])
-export const SHELL_TOOLS = Object.freeze(['run', 'run_background', 'job_output', 'job_list', 'job_kill'])
+export const BACKGROUND_TOOLS = Object.freeze(['run_background', 'job_output', 'job_list', 'job_kill'])
+export const SHELL_TOOLS = Object.freeze(['run', ...BACKGROUND_TOOLS])
 // The plugin's second layer executes POSIX commands; pwsh7 uses the host tool.
 export const IN_PROCESS_TOOLS = Object.freeze(['bash'])
 export function publicToolName(rawName) { return `${TOOL_PREFIX}${rawName}` }
@@ -23,17 +24,24 @@ export function ladderLevels({ published, pwsh = false }) {
 }
 
 /** A single compact table; absent tools never get advertised. */
-export function renderToolingPolicy({ published, enableShellTools, mounted, levels, pwsh7 = false, extraGuidance = '' }) {
+export function renderToolingPolicy({ published, enableShellTools, mounted, levels, pwsh7 = false, shellComponent = true, extraGuidance = '' }) {
   const names = new Set(published ?? (mounted || levels?.fastctx
     ? [...FILE_TOOLS, ...(enableShellTools ? SHELL_TOOLS : []), ...(levels?.bash ? IN_PROCESS_TOOLS : [])].map(publicToolName) : []))
   if (levels?.pwsh) names.add('pwsh')
-  if (!FILE_TOOLS.some(name => names.has(publicToolName(name))) && !names.has(BASH_TOOL)) return ''
-  const lines = ['# Repository operations: tools → bash → PowerShell 7', '', '| Task | Tool |', '| --- | --- |']
+  if (!shellComponent) names.delete('pwsh')
+  const hasFiles = FILE_TOOLS.some(name => names.has(publicToolName(name)))
+  const hasBash = names.has(BASH_TOOL)
+  const hasBackground = names.has(publicToolName('run_background'))
+  const hasPwsh = shellComponent && names.has('pwsh')
+  if (!hasFiles && !hasBash && !hasBackground && !hasPwsh) return ''
+  const heading = hasBash ? '# Shell routing: bash → PowerShell 7'
+    : hasFiles ? '# Repository file tools' : hasBackground ? '# Background task tools' : '# Windows-native shell'
+  const lines = [heading, '', '| Task | Tool |', '| --- | --- |']
   const row = (raw, task) => {
     if (names.has(publicToolName(raw))) lines.push(`| ${task} | ${publicToolName(raw)} |`)
   }
   row('inspect_local_file', 'Text / multiple ranges / encoding / PDF text / hex')
-  lines.push('| Images | read_image (host) |')
+  if (hasFiles && names.has('read_image')) lines.push('| Images | read_image (host) |')
   row('grep', 'Search contents')
   row('glob', 'Find paths')
   row('replace', 'Batch replacement; use host edit for precise edits')
@@ -41,9 +49,10 @@ export function renderToolingPolicy({ published, enableShellTools, mounted, leve
   if (names.has('pwsh')) lines.push(`| Windows-native cmdlets / registry / services only | pwsh (${pwsh7 || levels?.pwsh ? 'bundled PowerShell 7 via host' : 'host PowerShell'}) |`)
   row('run', 'Bounded bash command result (full access only)')
   if (names.has(publicToolName('run_background'))) {
-    lines.push(`| Background commands / owned jobs | ${SHELL_TOOLS.slice(1).map(publicToolName).join(', ')} |`)
+    lines.push(`| Background commands / owned jobs | ${BACKGROUND_TOOLS.map(publicToolName).filter(name => names.has(name)).join(', ')} |`)
   }
-  lines.push('', '- Do not build shell command lines for file operations.',
+  lines.push('', '- ops_* arguments are strict: pass only declared fields.')
+  if (hasFiles) lines.push('- Use file tools for file operations; use count for totals and batch independent requests.',
     '- On a tool error, correct the arguments and retry; do not switch to a shell workaround.')
   if (names.has(BASH_TOOL)) lines.push('- Prefer bash for command execution. Use PowerShell only when Windows-native functionality is necessary; fix bash errors in bash, do not switch shells or mix their syntax.')
   if (names.has(publicToolName('run_background'))) lines.push('- Only operate on job IDs you started in this session.')

package/lib/runtime-pool.js

@@ -0,0 +1,42 @@
+/** One plugin-owned FastCtx connection shared by independently toggled components. */
+import { McpStdioClient } from './handshake.js'
+const pools = new WeakMap()
+export async function acquireRuntime(ctx, runtime, env) {
+  const root = ctx.root
+  let pool = pools.get(root)
+  if (!pool) { pool = { clients: new Map(), closing: Promise.resolve() }; pools.set(root, pool) }
+  await pool.closing
+  let entry = pool.clients.get(runtime.file)
+  if (!entry) {
+    const client = McpStdioClient.start({ file: runtime.file, args: ['serve', '--enable-shell'], env, timeoutMs: 60000 })
+    entry = { client, refs: 0, ready: undefined }
+    pool.clients.set(runtime.file, entry)
+    entry.ready = (async () => {
+      try {
+        const handshake = await client.initialize('dsh-ops-components')
+        const tools = await client.listTools()
+        return { client, handshake, tools }
+      } catch (error) {
+        if (pool.clients.get(runtime.file) === entry) pool.clients.delete(runtime.file)
+        await client.close()
+        throw error
+      }
+    })()
+    void client.exited.then(() => { if (pool.clients.get(runtime.file) === entry) pool.clients.delete(runtime.file) })
+  }
+  entry.refs += 1
+  let released = false
+  const release = async () => {
+    if (released) return
+    released = true
+    entry.refs -= 1
+    if (!entry.refs) {
+      if (pool.clients.get(runtime.file) === entry) pool.clients.delete(runtime.file)
+      const closing = pool.closing.then(() => entry.client.close())
+      pool.closing = closing.catch(() => {})
+      await closing
+    }
+  }
+  try { return { ...await entry.ready, release } }
+  catch (error) { await release(); throw error }
+}

package/lib/session-pwsh.js

@@ -0,0 +1,31 @@
+/** A reversible runtime-only config overlay; never edits profile files or services. */
+export function mountBundledPwsh(ctx, shells) {
+  if (!shells.pwsh.available || process.platform !== 'win32') return
+  ctx.inject(['loader'], loaderCtx => {
+    const loader = loaderCtx.get('loader')
+    const matches = entry => entry?.options?.id === 'pwsh-sandbox'
+      && entry.options.name === '@deepseek-ai/dsh-pwsh-sandbox'
+    const refresh = () => {
+      for (const entry of loader.entries()) {
+        if (matches(entry) && entry.fiber?.state === 2) {
+          // Public Fiber.update with noSave recomputes from the owner's latest
+          // raw config. No stored config, volatile reference, or method is changed.
+          entry.fiber.update(entry.options.config, true)
+        }
+      }
+    }
+    const unhook = loaderCtx.on('internal/config', function (_raw, next) {
+      const config = next()
+      if (!matches(this.entry) || this.parent?.fiber?.entry === this.entry) return config
+      return { ...config, pwshPath: shells.pwsh.file }
+    }, { global: true, prepend: true })
+    let stopped = false
+    loaderCtx.effect(() => () => {
+      if (stopped) return
+      stopped = true
+      unhook()
+      refresh()
+    }, 'dsh-ops: restore owning PowerShell executor config')
+    refresh()
+  })
+}

package/lib/tools.js

@@ -23,6 +23,8 @@ import { McpStdioClient } from './handshake.js'
 import { FILE_TOOLS, SHELL_TOOLS, publicToolName } from './policy.js'
 import { projectTool } from './presentation.js'
 import { cleanBackground, jobEntries, startedJob } from './jobs.js'
+import { acquireRuntime } from './runtime-pool.js'
+import { resolveShells } from './shells.js'
 
 /** Deadline for one connection attempt: spawn, initialize, and `tools/list`. */
 const CONNECT_TIMEOUT_MS = 60_000
@@ -216,10 +218,16 @@ export class FastCtxTools {
    * @param {{file: string, source: string, version: string}} options.runtime - the resolved FastCtx executable.
    * @param {(message: string, level?: string) => void} [options.report] - where asynchronous events are reported.
    */
-  constructor({ ctx, config, runtime, report }) {
+  constructor({ ctx, config, runtime, report, fileTools = true, commandTools = SHELL_TOOLS, shared = false }) {
     this.ctx = ctx
     this.config = config
     this.runtime = runtime
+    this.fileTools = fileTools
+    this.commandTools = commandTools
+    this.shared = shared
+    this.leases = new Map()
+    this.pendingCalls = new Set()
+    this.shuttingDown = false
     this.report = report ?? (() => {})
     /** The live connection, or undefined while the surface is down. */
     this.client = undefined
@@ -282,7 +290,7 @@ export class FastCtxTools {
     if (!entry?.ctx) return
     for (const dispose of entry.disposers) dispose()
     entry.disposers = []
-    if (this.stopped) return
+    if (this.stopped || this.shuttingDown) return
     if (!this.shellAllowed(agent.session)) {
       // A child must not inherit an authorized ancestor's command surface.
       const names = (this.ctx.get('tools')?.schemas(agent) ?? []).map(tool => tool.name)
@@ -293,8 +301,8 @@ export class FastCtxTools {
       }
       return
     }
-    const commandTools = this.tools.filter(tool => SHELL_TOOLS.includes(tool.name))
-    if (commandTools.length !== SHELL_TOOLS.length) return
+    const commandTools = this.tools.filter(tool => this.commandTools.includes(tool.name))
+    if (commandTools.length !== this.commandTools.length) return
     try {
       for (const tool of commandTools) {
         entry.disposers.push(entry.ctx.tools.register(toolDefinition({
@@ -367,6 +375,20 @@ export class FastCtxTools {
    * @returns {Promise<void>} resolves once the child is gone.
    */
   async stop() {
+    this.shuttingDown = true
+    this.refreshAgents()
+    // Drain launches before killing only this component's owned jobs. Closing
+    // FastCtx alone does not stop its durable supervisors.
+    await Promise.allSettled([...this.pendingCalls])
+    const cleanupClient = this.client
+    if (cleanupClient) {
+      for (const ids of this.ownedJobs.values()) for (const job_id of ids) {
+        try {
+          const result = await cleanupClient.callTool('job_kill', { job_id }, { timeoutMs: 15000 })
+          if (result?.isError) this.report(`dsh-ops: owned job ${job_id} could not be stopped during component shutdown.`, 'warn')
+        } catch (error) { this.report(`dsh-ops: owned job ${job_id} shutdown failed: ${messageOf(error)}`, 'warn') }
+      }
+    }
     this.stopped = true
     if (this.timer !== undefined) {
       clearTimeout(this.timer)
@@ -380,7 +402,14 @@ export class FastCtxTools {
     this.tools = []
     this.ownedJobs.clear()
     await Promise.all([...this.agents.keys()].map(agent => this.detachAgent(agent)))
-    if (client !== undefined) await client.close()
+    if (client !== undefined) await this.#release(client)
+  }
+
+  async #release(client) {
+    const lease = this.leases.get(client)
+    this.leases.delete(client)
+    if (lease) await lease.release()
+    else if (!this.shared) await client.close()
   }
 
   /**
@@ -388,7 +417,16 @@ export class FastCtxTools {
    * @returns {Promise<void>} resolves once the generation is live.
    */
   async #connect() {
-    const client = McpStdioClient.start({
+    let lease
+    if (this.shared) {
+      const env = childEnv()
+      const bash = resolveShells(this.config).bash
+      if (bash.available) env.FASTCTX_BASH = bash.file
+      lease = await acquireRuntime(this.ctx, this.runtime, env)
+      if (this.shuttingDown || this.stopped) { await lease.release(); throw new StoppedError() }
+      this.leases.set(lease.client, lease)
+    }
+    const client = lease?.client ?? McpStdioClient.start({
       file: this.runtime.file,
       args: serverArgs(this.config.enableShellTools),
       env: childEnv(),
@@ -401,9 +439,9 @@ export class FastCtxTools {
     // already replaced or abandoned.
     void client.exited.then(({ code, signal, error }) => this.#onExit(client, code, signal, error))
     try {
-      const handshake = await client.initialize('dsh-ops')
-      const tools = await client.listTools()
-      if (this.stopped || client !== this.client) throw new StoppedError()
+      const handshake = lease?.handshake ?? await client.initialize('dsh-ops')
+      const tools = lease?.tools ?? await client.listTools()
+      if (this.stopped || this.shuttingDown || client !== this.client) throw new StoppedError()
       this.ownedJobs.clear()
       this.#publish(tools)
       this.serverInfo = handshake?.serverInfo
@@ -411,7 +449,7 @@ export class FastCtxTools {
       this.serverInstructions = ''
       this.connectedAt = Date.now()
     } catch (error) {
-      await client.close()
+      await this.#release(client)
       if (this.client === client) this.client = undefined
       throw error
     }
@@ -426,7 +464,8 @@ export class FastCtxTools {
    * @returns {void}
    */
   #onExit(client, code, signal, error) {
-    if (this.stopped || client !== this.client) return
+    if (this.stopped || this.shuttingDown || client !== this.client) return
+    void this.#release(client)
     this.client = undefined
     this.ownedJobs.clear()
     this.tools = []
@@ -449,7 +488,7 @@ export class FastCtxTools {
   #scheduleReconnect() {
     // One pending timer at a time: a crash and a failed first connect can both
     // land here, and two loops would double every later attempt.
-    if (this.stopped || this.timer !== undefined) return
+    if (this.stopped || this.shuttingDown || this.timer !== undefined) return
     // A connection that stayed up long enough closed the previous outage.
     if (this.connectedAt !== undefined && Date.now() - this.connectedAt >= RECONNECT.maxDelayMs) {
       this.attempts = 0
@@ -486,12 +525,12 @@ export class FastCtxTools {
    * @returns {Promise<void>} resolves once this attempt settled.
    */
   async #reconnect() {
-    if (this.stopped) return
+    if (this.stopped || this.shuttingDown) return
     try {
       await this.#connect()
       this.report(`dsh-ops: ${this.#describe()} reconnected with ${this.names().length} tool(s).`)
     } catch (error) {
-      if (this.stopped) return
+      if (this.stopped || this.shuttingDown) return
       this.report(
         `dsh-ops: FastCtx reconnect attempt ${this.attempts}/${RECONNECT.maxAttempts} `
         + `failed (${messageOf(error)}).`,
@@ -521,7 +560,7 @@ export class FastCtxTools {
         throw new Error(`${this.#describe()} listed the tool "${String(tool?.name)}" more than once`)
       }
       seen.add(name)
-      if (!FILE_TOOLS.includes(tool.name)) continue
+      if (!this.fileTools || !FILE_TOOLS.includes(tool.name)) continue
       definitions.push(toolDefinition({
         tool,
         call: (args, exec) => this.#call(tool.name, args, exec),
@@ -556,7 +595,15 @@ export class FastCtxTools {
    * @param {{signal?: AbortSignal, agent?: {session?: object}}} [exec] - the host execution context.
    * @returns {Promise<{content: unknown[], structuredContent?: unknown}>} the canonical value.
    */
-  async #call(rawName, args, exec) {
+  #call(rawName, args, exec) {
+    if (this.shuttingDown || this.stopped) return Promise.reject(new Error('This dsh-ops component is shutting down.'))
+    const call = this.#callActive(rawName, args, exec)
+    this.pendingCalls.add(call)
+    void call.then(() => this.pendingCalls.delete(call), () => this.pendingCalls.delete(call))
+    return call
+  }
+
+  async #callActive(rawName, args, exec) {
     const label = publicToolName(rawName)
     const session = exec?.agent?.session
     if (SHELL_TOOLS.includes(rawName) && !this.shellAllowed(session)) {
@@ -569,6 +616,7 @@ export class FastCtxTools {
         throw new Error('This is an image; use host read_image.')
       }
     }
+    if (rawName === 'run_background') args = { ...args, cwd: args?.cwd ?? session?.header?.cwd }
     const client = this.client
     if (client === undefined) {
       // A dead server must be an immediate, explicit failure rather than a

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "Repository tools",
-    "description": "Read, search, replace, and run commands through the hosted FastCtx ops_* tool surface instead of shell commands."
+    "title": "dsh-ops",
+    "description": "Provides bash, PowerShell 7, and a suite of high-performance tools written in Rust for Windows DSH to enhance token efficiency"
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "仓库工具",
-    "description": "通过托管的 FastCtx ops_* 工具完成读取、搜索、替换与命令执行，替代 shell 命令。"
+    "title": "dsh-ops",
+    "description": "为windows的dsh提供bash、powershell7及一系列rust编写的高性能tools来提高token效率"
   }
 }