dsh-toolfold 0.1.7

package/lib/index.js

@@ -0,0 +1,137 @@
+/**
+ * dsh-toolfold — HOST half.
+ *
+ * Registers the `toolfold` settings namespace in the DSH settings service
+ * (persisted in `~/.dsh/settings.yaml`, the same document every product and
+ * family plugin uses) and serves the browser half through one same-origin
+ * JSON route:
+ *
+ *   GET  /api/dsh-toolfold/settings → { ok, value: { value, revision, writable } }
+ *   POST /api/dsh-toolfold/settings → body { op: 'set'|'unset', field, value?,
+ *                                      expectedRevision? }
+ *                                   → { ok, value: { value, revision, writable } }
+ *
+ * The browser half prefers the official `settingsScope` transport when the
+ * deployment exposes this namespace, then this route, then browser
+ * localStorage as a degraded fallback. `value` is always the fully resolved
+ * section (schema defaults + composition base + the user's settings.yaml
+ * overrides), so the client never re-implements the resolution.
+ *
+ * The same package also declares `dsh.bundle.patch` (see cordis.patch.yml),
+ * which makes `dsh plugin --profile <name> add <this package>` install AND
+ * mount both halves in one command.
+ */
+import { settingsNamespace } from '@deepseek-ai/dsh-settings'
+import z from 'schemastery'
+
+export const name = 'toolfold'
+export const inject = ['settings', 'webServer']
+
+const NS = settingsNamespace('toolfold')
+const API_PATH = '/api/dsh-toolfold/settings'
+const FIELDS = ['durMs', 'keepThink', 'splitThink', 'stats']
+
+const SCHEMA = z.object({
+  durMs: z.number().step(10).min(0).max(2000).default(240),
+  keepThink: z.boolean().default(false),
+  splitThink: z.boolean().default(true),
+  stats: z.boolean().default(false),
+})
+
+/** Write one JSON response. */
+function json(res, status, body) {
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
+  res.end(JSON.stringify(body))
+}
+
+/** Read a JSON request body (bounded). */
+function readJsonBody(req) {
+  return new Promise((resolve, reject) => {
+    let size = 0
+    const chunks = []
+    req.on('data', (chunk) => {
+      size += chunk.length
+      if (size > 64 * 1024) {
+        reject(new Error('body-too-large'))
+        req.destroy()
+        return
+      }
+      chunks.push(chunk)
+    })
+    req.on('end', () => {
+      if (chunks.length === 0) {
+        resolve({})
+        return
+      }
+      try {
+        resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')))
+      } catch {
+        reject(new Error('invalid-json'))
+      }
+    })
+    req.on('error', reject)
+  })
+}
+
+export function apply(ctx) {
+  // Fiber-scoped registration: removed when this plugin is stopped/removed.
+  ctx.settings.register(NS, SCHEMA, { base: {} })
+
+  /** Current resolved section + revision + writability, as one JSON view. */
+  const snapshot = () => {
+    let value = ctx.settings.get(NS)
+    let revision
+    for (const descriptor of ctx.settings.describe()) {
+      if (descriptor.ns === NS) {
+        value = descriptor.value
+        revision = descriptor.revision
+        break
+      }
+    }
+    return {
+      ok: true,
+      value: {
+        value,
+        ...(revision === undefined ? {} : { revision }),
+        writable: ctx.settings.writable,
+      },
+    }
+  }
+
+  const handler = (req, res) => {
+    if (req.method === 'GET') {
+      try {
+        json(res, 200, snapshot())
+      } catch (error) {
+        json(res, 500, { ok: false, error: error instanceof Error ? error.message : String(error) })
+      }
+      return
+    }
+    if (req.method === 'POST') {
+      readJsonBody(req).then((body) => {
+        const field = String(body?.field ?? '')
+        if (!FIELDS.includes(field)) {
+          json(res, 400, { ok: false, error: 'invalid-field' })
+          return
+        }
+        const op = body?.op === 'unset' ? 'unset' : 'set'
+        const ops = op === 'unset'
+          ? [{ op: 'unset', path: [field] }]
+          : [{ op: 'set', path: [field], value: body.value }]
+        const expectedRevision = typeof body?.expectedRevision === 'number' ? body.expectedRevision : undefined
+        return ctx.settings.mutate(NS, ops, expectedRevision)
+          .then(() => json(res, 200, snapshot()))
+          .catch((error) => json(res, 400, { ok: false, error: error instanceof Error ? error.message : String(error) }))
+      }, (error) => {
+        json(res, 400, { ok: false, error: error instanceof Error ? error.message : String(error) })
+      })
+      return
+    }
+    json(res, 405, { ok: false, error: 'method-not-allowed' })
+  }
+
+  ctx.effect(() => {
+    const dispose = ctx.webServer.register({ kind: 'exact', path: API_PATH, handler })
+    return () => dispose()
+  })
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "dsh-toolfold",
+  "version": "0.1.7",
+  "description": "工具调用与思考的折叠显示：连续工具调用折叠为最后一个调用（可展开），已完成的思考随组折叠（可保留、展开时按原顺序显示），进行中的思考保持独立显示。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "scripts",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.7 <0.1.1 || >=0.1.1-rc.0 <0.1.2",
+    "schemastery": "^3.18.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test:engine": "node tools/engine-smoke.mjs",
+    "probe:live": "node tools/live-probe.mjs",
+    "install:dsh": "node scripts/install-dsh.cjs",
+    "uninstall:dsh": "node scripts/install-dsh.cjs uninstall"
+  }
+}

package/scripts/install-dsh.cjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * One-click install / uninstall of dsh-toolfold into a dsh profile through
+ * the official plugin CLI:
+ *
+ *   dsh plugin --profile <name> add <this-package>
+ *
+ * which installs the package with pnpm and — seeing the package's
+ * `dsh.bundle.patch` declaration — automatically appends `dsh-toolfold` to
+ * the profile's `dsh.profile.bundles` stack. No profile file edits.
+ *
+ * Usage:
+ *   node scripts/install-dsh.cjs            # install (default profile: web)
+ *   node scripts/install-dsh.cjs uninstall  # remove
+ *   DSH_PROFILE=headless node scripts/install-dsh.cjs
+ *
+ * After install, restart the dsh process: bundle layers are composed at boot.
+ */
+const { spawnSync } = require('node:child_process')
+const { join } = require('node:path')
+
+const profile = process.env.DSH_PROFILE || 'web'
+const uninstall = process.argv.includes('uninstall')
+// Forward slashes keep the spec unambiguous when cmd/PowerShell re-quotes it.
+const pkgSpec = join(__dirname, '..').replace(/\\/g, '/')
+// `pnpm add` takes a path spec; `pnpm remove` takes the dependency NAME.
+const target = uninstall ? 'dsh-toolfold' : pkgSpec
+
+/** Run one dsh CLI invocation; on Windows go through PowerShell so the dsh.ps1 / pnpm.ps1 shims resolve. */
+function runDsh(args) {
+  const quoted = args.map((arg) => "'" + String(arg).replace(/'/g, "''") + "'").join(' ')
+  const result = process.platform === 'win32'
+    ? spawnSync('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', `dsh ${quoted}`], { stdio: 'inherit' })
+    : spawnSync('dsh', args, { stdio: 'inherit' })
+  if (result.error !== undefined) {
+    console.error(`dsh CLI not found on PATH (${result.error.message}); install pnpm and put the dsh launcher on PATH`)
+    return 127
+  }
+  return result.status ?? 1
+}
+
+const verb = uninstall ? 'remove' : 'add'
+const status = runDsh(['plugin', '--profile', profile, verb, target])
+if (status !== 0) {
+  console.error(`dsh plugin ${verb} failed (exit ${status})`)
+  process.exit(status)
+}
+if (uninstall) {
+  console.log(`dsh-toolfold removed from profile "${profile}". Restart dsh to unload it.`)
+} else {
+  console.log(`dsh-toolfold installed into profile "${profile}" and added to dsh.profile.bundles.`)
+  console.log('Restart dsh (the GUI process) to activate — bundle layers are composed at boot.')
+}