@gavinc-cn/touchstone-dsh 0.1.1 → 0.3.0

package/backend/routes/agents.js

@@ -0,0 +1,149 @@
+/**
+ * 路由族：智能体探测三条（M6-6）
+ *
+ *   GET /api/agents/scan   → `server.py:1330`（`agents.scan_agents()`）
+ *   GET /api/agents/models → `server.py:1333`（`agent_models(agent_path)`）
+ *   GET /api/agents/skills → `server.py:1338`（`{"skills": scan_skills(agent_path, project_dir)}`）
+ *
+ * 三条都是**登录即可读**（`do_GET` 顶部只查 `_current_user()`，不吃 `_require_admin`），
+ * 成功体一律 `json.dumps(..., ensure_ascii=False)` ⇒ `ctx.json`；本族**没有**任何写口，
+ * 也没有错误体（参数缺省各自回落空串）。
+ *
+ * `agent_models` / `_dsh_plugin_models`（server.py:147/208）本该住 `lib/`，但 M6-6 的
+ * 冻结契约不许改 `backend/lib/**`；它们只被这一条端点消费，故落在本文件（**唯一**消费者），
+ * 语义逐行照 oracle：
+ *  - 值/显示分离（`name` = `provider/<id>` 供宿主 `selectModel` 严格匹配，
+ *    `display_name` = `provider/<显示名>` 供下拉展示）；
+ *  - 空 `agent_path`（db 默认 ''）与未知路径都归默认族 ⇒ **不列模型**、只回读部署默认模型；
+ *  - 结果进 60s 的 `_MODELS_CACHE`（键 = agent_path），驱动不可用时回空表且**不缓存**。
+ */
+import * as agents from '../lib/agents.js';
+import * as dshdriver from '../lib/dshdriver.js';
+import { dshDefaultModel } from '../lib/servercaps.js';
+
+/** `_MODELS_CACHE_TTL`（server.py:139）：60s */
+const MODELS_CACHE_TTL = 60.0;
+
+/** `_MODELS_CACHE`（server.py:138）：agent_path → `[时刻秒, 结果]` */
+const MODELS_CACHE = new Map();
+
+/** Python `dict.get(k) or ""` 后 `str(...)`：非字符串（数组/数字/null）→ 空串（`_req_str`） */
+function reqStr(value) {
+  return typeof value === 'string' ? value : '';
+}
+
+/**
+ * Python `(x or {}).get(key)`：**假值先折成空 dict**（`None`/`[]`/`''`/`0` 都退回 `undefined`），
+ * 其余非 dict（非空 list / 字符串 / 数字）在 Python 抛 AttributeError（端点打成 500、
+ * 只断这一条连接）——这里抛 TypeError 交给 `dispatchSafely`，**不静默兜底**，
+ * 否则驱动返回异常形状时两侧行为分叉（一边 500/断连、一边 200）。
+ */
+function dictGet(value, key) {
+  if (value === null || value === undefined || value === false || value === 0
+      || value === '' || (Array.isArray(value) && value.length === 0)) {
+    return undefined;                        // `x or {}`
+  }
+  if (typeof value !== 'object' || Array.isArray(value)) {
+    throw new TypeError(`'${Array.isArray(value) ? 'list' : typeof value}'`
+      + " object has no attribute 'get'");
+  }
+  return Object.prototype.hasOwnProperty.call(value, key) ? value[key] : undefined;
+}
+
+/**
+ * `_dsh_plugin_models`(147)：dsh 插件族模型列表（值/显示分离 + 思考等级透传）。
+ * 驱动不可用（`DshDriverError`）⇒ `{"models": [], "default": ""}`，**不入缓存**。
+ */
+async function dshPluginModels(cacheKey) {
+  const hit = MODELS_CACHE.get(cacheKey);
+  if (hit && Date.now() / 1000 - hit[0] < MODELS_CACHE_TTL) return hit[1];
+  const models = [];
+  let def = '';
+  let catalog;
+  try {
+    catalog = await dshdriver.models();
+  } catch (e) {
+    if (e instanceof dshdriver.DshDriverError) return { models: [], default: '' };
+    throw e;
+  }
+  for (const group of dictGet(catalog, 'groups') || []) {
+    const provider = strOf(dictGet(group, 'id'));
+    for (const m of dictGet(group, 'models') || []) {
+      const mid = strOf(dictGet(m, 'id')).trim();
+      const label = strOf(dictGet(m, 'name')).trim() || mid;   // 显示名缺省回落 id
+      if (!mid && !label) continue;
+      const modelId = mid || label;
+      // 思考等级选项：只认 id 落在平台白名单内的项，名字缺省回落 id
+      const efforts = [];
+      for (const e of dictGet(m, 'efforts') || []) {
+        const eid = strOf(dictGet(e, 'id')).trim();
+        if (!dshdriver.EFFORT_LEVELS.includes(eid)) continue;
+        efforts.push({ id: eid, name: strOf(dictGet(e, 'name')).trim() || eid });
+      }
+      models.push({
+        name: provider ? `${provider}/${modelId}` : modelId,
+        display_name: provider ? `${provider}/${label}` : label,
+        efforts,
+        default_effort: strOf(dictGet(m, 'default_effort')),
+      });
+    }
+  }
+  const sel = dictGet(catalog, 'default') || {};
+  if (dictGet(sel, 'provider') && dictGet(sel, 'model')) {
+    def = `${dictGet(sel, 'provider')}/${dictGet(sel, 'model')}`;
+  }
+  const result = { models, default: def };
+  MODELS_CACHE.set(cacheKey, [Date.now() / 1000, result]);
+  return result;
+}
+
+/** Python `str(x or "")`（标量面；容器按 JSON 文本兜底 —— 与全仓私有助手同口径） */
+function strOf(value) {
+  if (value === null || value === undefined || value === false || value === 0) return '';
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+  if (Array.isArray(value)) return value.length ? JSON.stringify(value) : '';
+  if (typeof value === 'object') return Object.keys(value).length ? JSON.stringify(value) : '';
+  return String(value);
+}
+
+/**
+ * `agent_models`(208)：指定 agent 的可用模型（空/未知路径 ⇒ 空列表 + 部署默认模型）。
+ * 单族世界（P7b）：只剩 `dsh_plugin`（前缀 `dsh-plugin:`）。
+ */
+async function agentModels(agentPath) {
+  const ap = reqStr(agentPath).trim();
+  if (ap.startsWith(agents.DSH_PLUGIN_PREFIX)) return dshPluginModels(ap);
+  const hit = MODELS_CACHE.get(ap);
+  if (hit && Date.now() / 1000 - hit[0] < MODELS_CACHE_TTL) return hit[1];
+  const result = { models: [], default: dshDefaultModel() };
+  MODELS_CACHE.set(ap, [Date.now() / 1000, result]);
+  return result;
+}
+
+export const routes = [
+  {
+    method: 'GET',
+    path: '/api/agents/scan',
+    /** `scan_agents()`：AGENT_DEFS + EXTRA_DIRS 探测（`which` + `--version`） */
+    handler: (ctx) => {
+      ctx.json(200, agents.scanAgents());
+    },
+  },
+  {
+    method: 'GET',
+    path: '/api/agents/models',
+    /** `agent_models(parsed["agent_path"][0])`：模型下拉数据源（宿主 `/models`） */
+    handler: async (ctx) => {
+      ctx.json(200, await agentModels(ctx.q('agent_path', '')));
+    },
+  },
+  {
+    method: 'GET',
+    path: '/api/agents/skills',
+    /** `scan_skills(agent_path, project_dir)`：用户级 + 项目级 SKILL.md 扫描（dsh 恒为空） */
+    handler: (ctx) => {
+      ctx.json(200, { skills: agents.scanSkills(ctx.q('agent_path', ''), ctx.q('project_dir', '')) });
+    },
+  },
+];

package/backend/routes/assets.js

@@ -0,0 +1,145 @@
+/**
+ * 路由族：平台内置资产（skill / dsh 插件）两条（M6-6）
+ *
+ *   GET  /api/builtin-assets                          → `server.py:1326` → `_api_builtin_assets_list`(1946)
+ *   POST /api/builtin-assets/<id>/(install|uninstall)  → `server.py:1085` → `_api_builtin_asset_action`(1971)
+ *
+ * 权限与隔离（照 oracle 的 `_assets_target`(1930)，**逐条不同**）：
+ *   - `target=user`（缺省）：读状态**登录即可**；写（install/uninstall）仅管理员 ⇒ 403
+ *     `json.dumps` 形态（**带空格**）。用户级写入的是服务进程 HOME 下的 agent 配置
+ *     （影响本机所有项目），故写口必须管理员。
+ *   - `target=project`：读/写都要过项目归属；越权/不存在 ⇒ **紧凑** 404 `project not found`
+ *     （与既有按 project_id 的端点同口径）。`project_id` 必须是 JSON **int**（bool 不算），
+ *     否则 400（`json.dumps` 形态）。
+ *   - 其它 target ⇒ 400 `target 必须是 user 或 project`（`json.dumps` 形态）。
+ *
+ * 落点（`builtin-assets.js` 的 `ext_dir()` / `dsh_profiles_dir()`）：资产**清单**根默认是仓库
+ * `extensions/`（`TS_EXT_DIR` 覆盖），安装产物落 `~/.dsh/skills`（`TS_DSH_PROFILES` 覆盖）
+ * —— 单测必须把这两个 env 指到夹具，**绝不允许**在真 `~/.dsh` 上做安装/卸载。
+ */
+import * as assets from '../lib/builtin-assets.js';
+
+/** `_is_admin`：管理员判据只有用户名等于 `admin`（与 `routes/admin.js` 同款） */
+function isAdmin(ctx) {
+  return Boolean(ctx.user) && ctx.user.username === 'admin';
+}
+
+/** Python `str(x or "")`（标量面；target/asset_id 这类字段都是字符串） */
+function pyStrOrEmpty(value) {
+  if (value === null || value === undefined || value === false || value === 0) return '';
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+  if (Array.isArray(value)) return value.length ? JSON.stringify(value) : '';
+  if (typeof value === 'object') return Object.keys(value).length ? JSON.stringify(value) : '';
+  return String(value);
+}
+
+/** `_req_str`(580)：非字符串（数组/数字/null）一律按空串处理 */
+function reqStr(value) {
+  return typeof value === 'string' ? value : '';
+}
+
+/**
+ * `_assets_target`(1930)：解析资产操作目标 → `{ok, project_dir, pid}`；错误路径已回响应。
+ * `write=true` 时用户级要管理员；项目级无论读写都要归属（越权 404 紧凑）。
+ */
+function assetsTarget(ctx, target, projectId, write = false) {
+  if (target === 'user') {
+    if (write && !isAdmin(ctx)) {
+      ctx.errorSpaced(403, '用户级安装影响本机所有项目，仅管理员可操作');
+      return { ok: false, projectDir: '', pid: null };
+    }
+    return { ok: true, projectDir: '', pid: null };
+  }
+  if (target !== 'project') {
+    ctx.errorSpaced(400, 'target 必须是 user 或 project');
+    return { ok: false, projectDir: '', pid: null };
+  }
+  if (!Number.isInteger(projectId) || typeof projectId === 'boolean') {
+    ctx.errorSpaced(400, '项目级操作需要 project_id');
+    return { ok: false, projectDir: '', pid: null };
+  }
+  const row = ctx.ownedProject(projectId);          // 已回 404 project not found（紧凑）
+  if (row === null) return { ok: false, projectDir: '', pid: null };
+  return { ok: true, projectDir: row.project_dir, pid: row.id };
+}
+
+/**
+ * `_api_builtin_assets_list`(1946)：清单 + 指定目标下的安装状态。
+ * `can_install` 为当前用户在该目标的写权限；逐资产 `supported` 为「该资产是否支持此目标」。
+ */
+function apiBuiltinAssetsList(ctx) {
+  const target = (reqStr(ctx.q('target', 'user')) || 'user').trim();
+  const rawPid = reqStr(ctx.q('project_id', '')).trim();
+  // Python `int(raw_pid) if raw_pid.isdigit() else None`：Unicode 数字面按全仓 ASCII 口径
+  const pidIn = /^[0-9]+$/.test(rawPid) ? Number(rawPid) : null;
+  const resolved = assetsTarget(ctx, target, pidIn);
+  if (!resolved.ok) return;
+  let list;
+  try {
+    list = assets.listAssets(target, resolved.projectDir);
+  } catch (e) {
+    if (e instanceof assets.AssetError) {
+      ctx.errorSpaced(e.code, e.message);
+      return;
+    }
+    throw e;
+  }
+  const canInstall = target === 'user' ? isAdmin(ctx) : true;
+  ctx.json(200, {
+    target,
+    project_id: resolved.pid,
+    can_install: canInstall,
+    assets: list,
+  });
+}
+
+/**
+ * `_api_builtin_asset_action`(1971)：安装（收敛到期望状态）/ 卸载（删清单内文件）。
+ * 失败按 `AssetError.code` 回 400/500；磁盘异常（OSError）统一 500 带原因。
+ */
+async function apiBuiltinAssetAction(ctx, assetId, action) {
+  const body = await ctx.readBody();           // Python 在 do_POST:1048 统一读体
+  const target = (reqStr(body.target) || 'user').trim();
+  const rawPid = body.project_id;
+  const pid = (typeof rawPid === 'number' && Number.isInteger(rawPid) && typeof rawPid !== 'boolean')
+    ? rawPid : null;
+  const resolved = assetsTarget(ctx, target, pid, true);
+  if (!resolved.ok) return;
+  const asset = assets.getAsset(assetId);
+  if (asset === null || asset === undefined) {
+    ctx.errorSpaced(404, `未知资产：${assetId}`);      // json.dumps 形态（带空格）
+    return;
+  }
+  let result;
+  try {
+    result = action === 'install'
+      ? assets.install(asset, target, resolved.projectDir)
+      : assets.uninstall(asset, target, resolved.projectDir);
+  } catch (e) {
+    if (e instanceof assets.AssetError) {
+      ctx.errorSpaced(e.code, e.message);
+      return;
+    }
+    // 磁盘异常（权限/空间）统一 500，带原因供前端 toast（Python 只吞 OSError）
+    if (e && typeof e.code === 'string') {
+      ctx.errorSpaced(500, `操作失败：${pyStrOrEmpty(e.message)}`);
+      return;
+    }
+    throw e;
+  }
+  ctx.json(200, result);
+}
+
+export const routes = [
+  {
+    method: 'GET',
+    path: '/api/builtin-assets',
+    handler: (ctx) => apiBuiltinAssetsList(ctx),
+  },
+  {
+    method: 'POST',
+    re: /^\/api\/builtin-assets\/([a-z0-9][a-z0-9._-]*)\/(install|uninstall)$/,
+    handler: (ctx, m) => apiBuiltinAssetAction(ctx, m[1], m[2]),
+  },
+];