@khorsheed/dsh-capability-catalog 0.1.95

package/lib/types/client/locales.js

@@ -0,0 +1,395 @@
+/**
+ * Dictionaries for the capability-catalog browser half.
+ * @module @khorsheed/dsh-capability-catalog/client
+ */
+export const NS = 'capability-catalog';
+export const zh = {
+    title: '工具与技能',
+    'section.nav': '工具与技能',
+    intro: '当前实例中已注册的技能与工具。',
+    skillTab: '技能',
+    toolTab: '工具',
+    addSkill: '新增 Skill',
+    empty: '没有已注册的技能。',
+    loading: '加载中…',
+    loadFailed: '加载失败',
+    source: '来源',
+    provider: '提供者',
+    modelInvocable: '模型可调用',
+    whenToUse: '适用场景',
+    yes: '是',
+    no: '否',
+    userOnly: '仅用户',
+    builtin: '内置',
+    sourceProject: '项目',
+    sourceCustom: '自定义',
+    sourceUser: '用户',
+    toolOriginGuideLink: '为什么我的插件工具不在这里？',
+    toolOriginGuideTitle: '为什么我的插件工具不在这里？',
+    toolOriginGuideIntro: '工具要显示为「插件」，需要在注册前为它标记来源。你的插件工具没标，所以它按既有启发式暂显示为「内置」。把下面这段直接发给你的可编程 agent，它会按规范为你的工具标记。',
+    toolOriginGuideCopy: '请先阅读 docs/tool-origin-guide.md 的工具来源标记规范，然后帮我把我的插件工具在 ctx.tools.register 前都标记上 origin（channel: \'plugin\'，owner 填对应包名），让它们显示在「工具与技能」的「插件」分类下。改完告诉我你标记了哪些工具。',
+    toolOriginGuideFooter: '点「复制」复制上面整段说明，发给你写这个插件的 agent 即可。',
+    skillOther: '其他',
+    delete: '删除',
+    confirmDelete: '确定要删除 skill',
+    viewDetail: '查看详情',
+    searchPlaceholder: '按名称或描述搜索…',
+    filterAll: '全部',
+    sortBy: '排序',
+    sortName: '名称',
+    sortUpdated: '最近更新',
+    noFilterMatch: '没有匹配的技能',
+    updated: '更新于',
+    /* Tool catalog. */
+    toolBuiltin: '内置',
+    toolPlugin: '插件',
+    toolParams: '参数',
+    toolNoParams: '无参数',
+    toolExpand: '展开更多',
+    toolCollapse: '收起',
+    toolSearchPlaceholder: '按名称 / 描述 / server 搜索…',
+    toolNoMatch: '没有匹配的工具',
+    toolOther: '其他',
+    paramsTree: '结构',
+    paramsJson: 'JSON',
+    copyJson: '复制 JSON',
+    paramRequired: '必填',
+    credentials: '凭据配置',
+    credentialsHint: '该 skill 的 metadata 声明了以下凭据，配置后模型可读取。',
+    envRefs: '引用的环境变量',
+    envRefsHint: '该 skill 的说明引用了以下变量；它们通常由运行环境或调用方提供，不在此页配置。',
+    configured: '已配置',
+    notConfigured: '未配置',
+    configuredReplace: '已配置——输入新值可替换',
+    credPlaceholder: '输入值',
+    save: '保存',
+    show: '显示',
+    hide: '隐藏',
+    saved: '已保存',
+    saveFailed: '保存失败',
+    viewSource: '查看源码',
+    bundleFiles: '包文件',
+    metadata: 'metadata',
+    copy: '复制',
+    copied: '已复制',
+    detailClose: '关闭',
+    addSkillHint: '上传 skill 包（zip/拖拽）或从源码仓库安装，将写入选定的 skill 根目录。',
+    addTabUpload: '文件上传',
+    addTabCommand: '命令安装',
+    addTabDir: '从本机目录',
+    dirLabel: '本机 skill 目录',
+    dirPlaceholder: '绝对路径，如 ~/.claude/skills 或 ~/my-skills',
+    dirHint: '选择一个包含 SKILL.md 的本机目录，自动解析其中可安装的 skill。',
+    browseDir: '选择目录',
+    dropTitle: '拖入 Skill 文件夹、ZIP 或 SKILL.md',
+    dropHint: '也可以点击选择文件',
+    commandLabel: '安装命令或已安装路径',
+    commandPlaceholder: 'npx skills add owner/repo --skill 名字，或填 owner/repo、github.com/owner/repo 链接、git URL、本机目录',
+    commandHint: '可整条粘贴 README 里的安装命令（含 --skill/-g 等参数）；浏览器里复制的 GitHub 链接也能直接粘贴（可带仓库内路径，如 github.com/owner/repo/skills/名字），host 会被剥掉、路径只在该路径下查找。仓库/路径会克隆进受管根，避免装到 dsh 扫不到的目录。仓库含多个技能时必须用 --skill 指定，否则会报错列出可选项。',
+    listDir: '列出本机目录技能',
+    pickSkills: '选择要安装的技能',
+    noSkillsFound: '该目录里没有找到 skill（需含 SKILL.md）。',
+    addModelInvocable: '允许模型自动发现',
+    addModelInvocableHint: '开启后模型可在合适任务中自动使用；关闭后仅能通过 /{name} 调用。',
+    skillNamePlaceholder: '技能名',
+    noSkillRoots: '未找到本机 skill 根目录',
+    addRoot: '安装到',
+    rootUser: '个人 Skill 目录',
+    rootUserPath: '$DSH_HOME/skills',
+    rootProject: '项目 Skill 目录',
+    rootProjectPath: '.agents/skills（相对项目工作目录）',
+    addSubmit: '导入',
+    cancel: '取消',
+    close: '关闭',
+    addSuccess: '已添加 skill：',
+    addError: '添加失败',
+    readFailed: '文件读取失败',
+    addExistsTitle: '该技能已存在',
+    addExists: '已存在于目标目录，如继续导入将会覆盖原文件，请确认是否要继续。',
+    replace: '覆盖',
+    /* MCP management. */
+    addMcp: '新增 MCP',
+    mcpSection: 'MCP 服务器',
+    mcpServerEmpty: '还没有 MCP 服务器，点击右上角「新增 MCP」。',
+    mcpAddHint: '粘贴一个 MCP server 配置（mcp.json 中的一项，或仅含 command/url 的片段），会自动解析传输与凭据。',
+    mcpPastePlaceholder: '{"command":"npx","args":["-y","@amap/amap-maps-mcp-server"],"env":{"AMAP_MAPS_API_KEY":"sk-…"}}',
+    mcpServerName: '服务名',
+    mcpServerNamePlaceholder: 'server 名称，如 amap-maps',
+    mcpTransport: '传输',
+    mcpUnknown: '未知',
+    mcpEnabled: '启用',
+    mcpDisabled: '已停用',
+    mcpNotEnabled: '服务未启用，展开并启用后连接。',
+    mcpDiscover: '连接并发现工具',
+    mcpDiscovering: '连接中…',
+    mcpNoTools: '未发现工具',
+    mcpToolCount: '{n} 个工具',
+    mcpToolSearchPlaceholder: '搜索工具…',
+    mcpEnabledOf: '启用',
+    mcpTools: '工具',
+    mcpNoCreds: '无凭据',
+    mcpConfig: '配置',
+    mcpHeader: '请求头',
+    mcpEnv: '环境变量',
+    mcpUrl: 'URL',
+    mcpCommand: '命令',
+    mcpArgs: '参数',
+    mcpCwd: '工作目录',
+    mcpRemove: '移除',
+    mcpAdd: '添加',
+    mcpAddTitled: '新增 MCP 服务器',
+    mcpParseFailed: '无法识别该配置：需要一个 command（stdio）或 url（streamable-http) 的 server 片段。',
+    mcpCredBadge: '凭据',
+    mcpCredLabel: '检测到配置项：',
+    mcpNeedsCred: '该配置含凭据项，配置后将通过引用注入，不存明文。',
+    mcpReconnect: '重新连接',
+    mcpToolToggleHint: '单独控制是否启用该工具。',
+    mcpDiscoverHint: '连接该 server 并拉取工具列表。',
+    mcpEmptyTools: '该 server 尚未发现工具。',
+    mcpAddSuccess: '已添加 MCP 服务器：',
+    mcpRemoveConfirm: '移除该 MCP 服务器？',
+    scopeInfoLabel: '生效范围说明',
+    scopePresetTag: 'preset',
+    scopeAllPresets: '全部',
+    scopeSection: '生效的 preset',
+    scopeEvery: '所有 preset',
+    scopeHint: '勾选这个 skill 生效的 preset；一个都不勾表示所有模式可见。改的是 skill 自己的 frontmatter。',
+    scopeProvided: '该 skill 由插件「{provider}」提供：它在哪些模式生效取决于该插件挂在哪些预设的组合里，不能在这里单独限定。',
+    scopeBuiltin: '该 skill 由部署内置提供：生效模式跟随部署组合，不能在这里单独限定。',
+    scopeSave: '保存',
+    scopeSaving: '保存中…',
+    scopeSaved: '已保存',
+    scopeAdopt: '移入受管目录并可限定 preset',
+    scopeRelease: '释放回用户技能目录',
+    scopeConflict: '已拒绝投递：默认根里还有一份同名副本（迁移没完成的残留）',
+    scopeUnavailable: '此部署没有可用的 preset 名单，或受管投递未启用。',
+    scopeBroken: '加载失败',
+    scopeError: '操作失败',
+    scopeProbe: '这是发现/投递策略，不是权限边界；外部 agent（codex/claude/ACP）不覆盖。',
+    /* Mode view: which capabilities each agent preset loads. */
+    modeLabel: '模式',
+    modeHint: '切换查看的 Agent 预设；「全部模式」逐个读取后对比哪些工具/skill 出现在哪些模式里。首次对比会加载尚未挂载的预设。',
+    modeDefault: '默认',
+    modeAll: '全部模式（对比）',
+    modeIn: '出现在',
+    modeChipHint: '切换到该模式查看',
+    modeEvery: '全部模式 · {n}',
+    modeMore: '+{n}',
+    modeCollapse: '收起',
+    modeNone: '该部署里没有任何模式加载它。',
+    modeChipsCost: '（读取每个模式的能力面；未挂载过的预设会被组合一次）',
+    modeBusy: '正在读取该模式的会话插件…',
+    modeCompareNote: '对比 {n} 个模式 · 技能 {skills} · 工具 {tools}',
+    modeUnavailableNote: '{n} 个模式无法读取',
+    modeCompareCost: '对比会逐个加载每个模式的组合，未挂载过的预设可能要等一会。',
+    modeFallback: '该模式当前无法加载（组合失败或未挂载），下面显示的是全局层，不代表该模式实际可见范围。',
+    orphanManaged: '{n} 个受管 skill 未在任何模式生效',
+    orphanManagedHint: '它们的 preset 范围指向了本部署没有的 preset，或投递被同名副本拒绝。展开后可打开详情改范围或释放回用户技能目录。',
+    /* The four shipped presets publish no name; their copy resolves through these
+     * keys (mirrors the host's ui-agent-preset dictionary, same strings). */
+    presetStandardName: '标准模式',
+    presetStandardDescription: '处理代码、文件和资料，适合大多数任务。Agent 会按需使用检索、编辑和终端等工具。',
+    presetPtcName: 'PTC 模式',
+    presetPtcDescription: '包含标准模式的所有能力，更适合批量调用工具，并对结果进行筛选、整理、去重、统计或汇总的任务。',
+    presetMinimalName: '极简模式',
+    presetMinimalDescription: 'Agent 仅使用终端工具完成任务，适合测试和对比其基础表现。',
+    presetCordisName: '创造模式',
+    presetCordisDescription: '用对话定制 DSH：让 Agent 编写插件，添加新功能或界面；也能组合工具和提示词，创建自己的模式。',
+    /* Frontmatter metadata block. */
+    frontmatterMetadata: 'frontmatter metadata',
+};
+export const en = {
+    title: 'Tools & Skills',
+    'section.nav': 'Tools & Skills',
+    intro: 'Skills and tools registered in this instance.',
+    skillTab: 'Skills',
+    toolTab: 'Tools',
+    addSkill: 'Add Skill',
+    empty: 'No skills registered.',
+    loading: 'Loading…',
+    loadFailed: 'Failed to load',
+    source: 'Source',
+    provider: 'Provider',
+    modelInvocable: 'Model-invocable',
+    whenToUse: 'When to use',
+    yes: 'Yes',
+    no: 'No',
+    userOnly: 'User only',
+    builtin: 'Built-in',
+    sourceProject: 'Project',
+    sourceCustom: 'Custom',
+    sourceUser: 'User',
+    toolOriginGuideLink: 'Why is my plugin tool not here?',
+    toolOriginGuideTitle: 'Why is my plugin tool not here?',
+    toolOriginGuideIntro: 'A tool shows as 插件 only if it declares its origin before being registered. Yours is untagged, so it currently falls back to 内置. Send the message below to your coding agent — it will tag your tools per the convention.',
+    toolOriginGuideCopy: 'Please read the tool-origin convention in docs/tool-origin-guide.md, then tag my plugin tools with their origin before ctx.tools.register (channel: \'plugin\', owner = the package name) so they show under 插件 in 工具与技能. Tell me which tools you tagged.',
+    toolOriginGuideFooter: 'Tap 复制 to copy the whole message to the agent that writes this plugin.',
+    skillOther: 'Other',
+    delete: 'Delete',
+    confirmDelete: 'Delete this skill',
+    viewDetail: 'View details',
+    searchPlaceholder: 'Search by name or description…',
+    filterAll: 'All',
+    sortBy: 'Sort',
+    sortName: 'Name',
+    sortUpdated: 'Recently updated',
+    noFilterMatch: 'No matching skills',
+    updated: 'Updated',
+    /* Tool catalog. */
+    toolBuiltin: 'Built-in',
+    toolPlugin: 'Plugin',
+    toolParams: 'Parameters',
+    toolNoParams: 'No parameters',
+    toolExpand: 'Expand',
+    toolCollapse: 'Collapse',
+    toolSearchPlaceholder: 'Search by name / description / server…',
+    toolNoMatch: 'No matching tools',
+    toolOther: 'Other',
+    paramsTree: 'Tree',
+    paramsJson: 'JSON',
+    copyJson: 'Copy JSON',
+    paramRequired: 'Required',
+    credentials: 'Credential config',
+    credentialsHint: 'The skill metadata declares these credentials; configure them so the model can read them.',
+    envRefs: 'Referenced environment variables',
+    envRefsHint: 'The skill description references these variables; they are typically provided by the runtime or caller and are not configured here.',
+    configured: 'Configured',
+    notConfigured: 'Not configured',
+    configuredReplace: 'Configured — enter a new value to replace',
+    credPlaceholder: 'Enter value',
+    save: 'Save',
+    show: 'Show',
+    hide: 'Hide',
+    saved: 'Saved',
+    saveFailed: 'Save failed',
+    viewSource: 'View source',
+    bundleFiles: 'Package files',
+    metadata: 'metadata',
+    copy: 'Copy',
+    copied: 'Copied',
+    detailClose: 'Close',
+    addSkillHint: 'Upload a skill archive (drag-drop) or install from a source repo into the selected skill root.',
+    addTabUpload: 'Upload',
+    addTabCommand: 'Install from source',
+    addTabDir: 'From directory',
+    dirLabel: 'Local skill directory',
+    dirPlaceholder: 'An absolute path, e.g. ~/.claude/skills or ~/my-skills',
+    dirHint: 'Pick a local directory containing SKILL.md skills; they are parsed automatically.',
+    browseDir: 'Choose directory',
+    dropTitle: 'Drop a skill folder, ZIP, or SKILL.md',
+    dropHint: 'You can also click to choose a file',
+    commandLabel: 'Install command or path',
+    commandPlaceholder: 'npx skills add owner/repo --skill name, or owner/repo, a github.com/owner/repo link, a git URL, a local path',
+    commandHint: 'Paste a README install command whole, flags included. A GitHub link copied out of a browser installs as-is too — an in-repo path (`github.com/owner/repo/skills/name`) is honoured, and the leading host is stripped rather than read as the owner. The repo/path is cloned into the managed root so it lands where dsh can scan it. When a repo carries several skills, --skill is required — otherwise the error lists them.',
+    listDir: 'List skills in dir',
+    pickSkills: 'Pick skills to install',
+    noSkillsFound: 'No skill (SKILL.md) found in that directory.',
+    addModelInvocable: 'Allow model auto-discovery',
+    addModelInvocableHint: 'When on, the model can use it automatically in suitable tasks; when off, only /{name} can invoke it.',
+    skillNamePlaceholder: 'skill',
+    noSkillRoots: 'No local skill roots found',
+    addRoot: 'Install to',
+    rootUser: 'Personal skill directory',
+    rootUserPath: '$DSH_HOME/skills',
+    rootProject: 'Project skill directory',
+    rootProjectPath: '.agents/skills (relative to project workdir)',
+    addSubmit: 'Add',
+    cancel: 'Cancel',
+    close: 'Close',
+    addSuccess: 'Added skill: ',
+    addError: 'Failed to add',
+    readFailed: 'Failed to read file',
+    addExistsTitle: 'This skill already exists',
+    addExists: 'already exists in the target root. Continuing to import will overwrite the original file. Please confirm and continue.',
+    replace: 'Replace',
+    /* MCP management. */
+    addMcp: 'Add MCP',
+    mcpSection: 'MCP servers',
+    mcpServerEmpty: 'No MCP servers yet — click "Add MCP" in the top-right.',
+    mcpAddHint: 'Paste one MCP server config (an entry of mcp.json, or a bare command/url snippet). It is parsed into a transport + credentials automatically.',
+    mcpPastePlaceholder: '{"command":"npx","args":["-y","@amap/amap-maps-mcp-server"],"env":{"AMAP_MAPS_API_KEY":"sk-…"}}',
+    mcpServerName: 'Server name',
+    mcpServerNamePlaceholder: 'server name, e.g. amap-maps',
+    mcpTransport: 'Transport',
+    mcpUnknown: 'Unknown',
+    mcpEnabled: 'Enabled',
+    mcpDisabled: 'Disabled',
+    mcpNotEnabled: 'Server not enabled; enable it to connect.',
+    mcpDiscover: 'Connect & discover tools',
+    mcpDiscovering: 'Connecting…',
+    mcpNoTools: 'No tools discovered',
+    mcpToolCount: '{n} tools',
+    mcpToolSearchPlaceholder: 'Search tools…',
+    mcpEnabledOf: 'enabled',
+    mcpTools: 'Tools',
+    mcpNoCreds: 'No credentials',
+    mcpConfig: 'Config',
+    mcpHeader: 'Headers',
+    mcpEnv: 'Env',
+    mcpUrl: 'URL',
+    mcpCommand: 'Command',
+    mcpArgs: 'Args',
+    mcpCwd: 'Cwd',
+    mcpRemove: 'Remove',
+    mcpAdd: 'Add',
+    mcpAddTitled: 'Add MCP server',
+    mcpParseFailed: 'Unrecognized config: a command (stdio) or url (streamable-http) snippet is required.',
+    mcpCredBadge: 'Credential',
+    mcpCredLabel: 'Detected config item:',
+    mcpNeedsCred: 'This config has credential items; they are injected by reference after configuration — never stored as plaintext.',
+    mcpReconnect: 'Reconnect',
+    mcpToolToggleHint: 'Control whether this specific tool is enabled.',
+    mcpDiscoverHint: 'Connect to this server and pull its tool list.',
+    mcpEmptyTools: 'No tools discovered for this server yet.',
+    mcpAddSuccess: 'Added MCP server: ',
+    mcpRemoveConfirm: 'Remove this MCP server?',
+    scopeInfoLabel: 'About the effective scope',
+    scopePresetTag: 'preset',
+    scopeAllPresets: 'all',
+    scopeSection: 'Effective presets',
+    scopeEvery: 'All presets',
+    scopeHint: 'Tick the presets this skill is delivered to; none ticked means every preset sees it. This edits the skill\'s own frontmatter.',
+    scopeProvided: 'This skill comes from the plugin "{provider}": which modes load it follows the plugin\'s row in each preset\'s composition, so its scope cannot be set here.',
+    scopeBuiltin: 'This skill ships with the deployment: its modes follow the deployment composition and cannot be set here.',
+    scopeSave: 'Save',
+    scopeSaving: 'Saving…',
+    scopeSaved: 'Saved',
+    scopeAdopt: 'Move into the managed root (preset-scoped)',
+    scopeRelease: 'Release back to the user skill root',
+    scopeConflict: 'Delivery refused: a same-named copy still exists in a default root',
+    scopeUnavailable: 'No preset roster is available in this deployment, or managed delivery is off.',
+    scopeBroken: 'Failed to load',
+    scopeError: 'Failed',
+    scopeProbe: 'A discovery/delivery policy, not an authorization boundary; external agents (codex/claude/ACP) are not covered.',
+    /* Mode view: which capabilities each agent preset loads. */
+    modeLabel: 'Mode',
+    modeHint: 'Switch the agent preset this grid reads; "All modes" reads every preset and compares which tools/skills appear in which modes. The first comparison composes presets nothing has mounted yet.',
+    modeDefault: 'default',
+    modeAll: 'All modes (compare)',
+    modeIn: 'In',
+    modeChipHint: 'Switch to this mode',
+    modeEvery: 'every mode · {n}',
+    modeMore: '+{n}',
+    modeCollapse: 'less',
+    modeNone: 'No mode in this deployment loads it.',
+    modeChipsCost: '(reads every mode\'s face; a preset nothing has mounted is composed once)',
+    modeBusy: 'Reading this mode\'s session plugins…',
+    modeCompareNote: 'Compared {n} modes · {skills} skills · {tools} tools',
+    modeUnavailableNote: '{n} mode(s) could not be read',
+    modeCompareCost: 'Comparing composes each mode in turn; a preset nothing has mounted yet can take a moment.',
+    modeFallback: 'This mode cannot be composed right now (or is not mounted), so the global layer is shown — it is not that mode\'s real visibility.',
+    orphanManaged: '{n} managed skill(s) load in no mode',
+    orphanManagedHint: 'Their preset scope names a preset this deployment does not supply, or delivery was refused by a duplicate copy. Expand to open a skill and change its scope or release it to the user skill root.',
+    /* The four shipped presets publish no name; their copy resolves through these
+     * keys (mirrors the host's ui-agent-preset dictionary, same strings). */
+    presetStandardName: 'Standard mode',
+    presetStandardDescription: 'Work with code, files, and information. Suitable for most tasks, with search, editing, terminal commands, and other tools available as needed.',
+    presetPtcName: 'PTC mode',
+    presetPtcDescription: 'Includes all Standard mode capabilities. Better suited to tasks that call tools in batches and then filter, organize, deduplicate, count, or summarize the results.',
+    presetMinimalName: 'Minimal mode',
+    presetMinimalDescription: 'The agent works using only a terminal tool. Useful for testing and comparing its basic performance.',
+    presetCordisName: 'Creator mode',
+    presetCordisDescription: 'Customize DSH through conversation. Let the agent write plugins that add features or UI, or combine tools and prompts to create your own mode.',
+    /* Frontmatter metadata block. */
+    frontmatterMetadata: 'frontmatter metadata',
+};

package/lib/types/client/mcp-model.d.ts

@@ -0,0 +1,24 @@
+import type { CapabilityCatalogSnapshot, CatalogMcpCredentialDecl, CatalogMcpServerConfig, CatalogMcpSnapshot, CatalogMcpTool, CatalogToolRow, McpTransport } from '@khorsheed/dsh-capability-catalog/types';
+import type { CapabilityCatalogKey } from './locales.ts';
+/** One merged MCP server group shown in the MCP section. `managed` servers are
+ * catalog-controlled (config + credentials + per-tool toggles); live-only ones
+ * are read-only snapshots of already-registered MCP tools. */
+export interface McpGroup {
+    readonly serverName: string;
+    readonly transport: McpTransport | undefined;
+    readonly enabled: boolean;
+    readonly managed: boolean;
+    readonly config: CatalogMcpServerConfig | undefined;
+    readonly tools: readonly CatalogMcpTool[];
+    readonly liveTools: readonly CatalogToolRow[];
+    readonly credentials: readonly CatalogMcpCredentialDecl[];
+    readonly toolCount: number;
+}
+/** Fold the tool-graph MCP entries + the catalog's managed servers into one
+ * server-grouped list (catalog-managed wins over a same-name live group). */
+export declare function buildMcpGroups(snapshot: CapabilityCatalogSnapshot | undefined, mcps: CatalogMcpSnapshot | null, query: string): McpGroup[];
+/** Human label for a transport kind. */
+export declare function transportLabel(t: (key: CapabilityCatalogKey) => string, transport: McpTransport): string;
+/** Read-only JSON view of a server config, with secret values masked. */
+export declare function configDisplay(config: CatalogMcpServerConfig): string;
+//# sourceMappingURL=mcp-model.d.ts.map

package/lib/types/client/mcp-model.js

@@ -0,0 +1,87 @@
+import { maskSecret, SECRET_REF_PREFIX } from '../mcps.js';
+/** Fold the tool-graph MCP entries + the catalog's managed servers into one
+ * server-grouped list (catalog-managed wins over a same-name live group). */
+export function buildMcpGroups(snapshot, mcps, query) {
+    const q = query.trim().toLowerCase();
+    const groups = [];
+    const seen = new Set();
+    for (const server of mcps?.servers ?? []) {
+        if (q !== '' && !server.serverName.toLowerCase().includes(q))
+            continue;
+        const creds = (mcps?.credentials ?? []).filter((c) => c.ref.startsWith(`mcp.${server.serverName}.`));
+        const tools = mcps?.tools[server.serverName] ?? [];
+        groups.push({
+            serverName: server.serverName,
+            transport: server.transport,
+            enabled: server.enabled,
+            managed: true,
+            config: server,
+            tools,
+            liveTools: [],
+            credentials: creds,
+            toolCount: tools.length,
+        });
+        seen.add(server.serverName);
+    }
+    // Live-registered MCP tools (already in `ctx.tools`) folded by server. These
+    // are not catalog-managed, so they are read-only in the section.
+    const byServer = new Map();
+    for (const tool of snapshot?.tools ?? []) {
+        if (tool.channel !== 'mcp')
+            continue;
+        const s = tool.serverName ?? 'MCP';
+        const list = byServer.get(s);
+        if (list !== undefined)
+            list.push(tool);
+        else
+            byServer.set(s, [tool]);
+    }
+    for (const [serverName, live] of byServer) {
+        if (seen.has(serverName))
+            continue;
+        if (q !== '' && !serverName.toLowerCase().includes(q))
+            continue;
+        groups.push({
+            serverName,
+            transport: undefined,
+            enabled: true,
+            managed: false,
+            config: undefined,
+            tools: [],
+            liveTools: live,
+            credentials: [],
+            toolCount: live.length,
+        });
+    }
+    return groups.sort((a, b) => a.serverName.localeCompare(b.serverName));
+}
+/** Human label for a transport kind. */
+export function transportLabel(t, transport) {
+    if (transport === 'stdio')
+        return 'stdio';
+    if (transport === 'streamable-http')
+        return 'streamable-http';
+    return t('mcpUnknown');
+}
+/** Mask any `secretRef:` markers in a URL for read-only display. */
+function maskUrl(url) {
+    return url.replace(new RegExp(`${SECRET_REF_PREFIX}[A-Za-z0-9_.-]+`, 'g'), '·secretRef·');
+}
+/** Read-only JSON view of a server config, with secret values masked. */
+export function configDisplay(config) {
+    const env = (config.env ?? []).map(([k, v]) => [k, maskSecret(v)]);
+    const headers = (config.headers ?? []).map(([k, v]) => [k, maskSecret(v)]);
+    const url = config.url !== undefined ? maskUrl(config.url) : undefined;
+    const masked = {
+        serverName: config.serverName,
+        transport: config.transport,
+        enabled: config.enabled,
+        ...(config.command !== undefined ? { command: config.command } : {}),
+        ...(config.args !== undefined ? { args: config.args } : {}),
+        ...(config.cwd !== undefined ? { cwd: config.cwd } : {}),
+        ...(url !== undefined ? { url } : {}),
+        ...(headers.length > 0 ? { headers } : {}),
+        ...(env.length > 0 ? { env } : {}),
+    };
+    return JSON.stringify(masked, null, 2);
+}

package/lib/types/client/mode-model.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The cross-mode comparison model: ONE grid built from every mode's face.
+ *
+ * The section answers two different questions with one grid. A mode-selected
+ * view shows what that mode loads; the comparison shows, for every capability
+ * the instance knows, the modes that load it — which is the question "这个工具
+ * 会在哪些模式下被加载?" and the reason the mode control exists at all.
+ *
+ * Two properties make the comparison trustworthy:
+ *
+ * - A capability's ROW is taken from the deployment default's face when the
+ *   default mode also has it. Every mode registers its own instance of a tool
+ *   (its own description, its own channel attribution), and picking whichever
+ *   mode happened to be read first would make the card's prose depend on roster
+ *   order. The default mode is the one the human sees everywhere else in the
+ *   panel, so it wins whenever it can answer.
+ * - A mode that could not be read contributes NO modes-list and no rows; it is
+ *   reported in `unavailable` instead. "Not loaded in this mode" and "this mode
+ *   could not be read" are different claims, and a union that merged them would
+ *   quietly understate where a capability is available.
+ *
+ * Pure over its input, so the unit tests need no renderer.
+ * @module @khorsheed/dsh-capability-catalog/client/mode-model
+ */
+import type { CatalogModeFace, CatalogPresetOption, CatalogScopedSkillRow, CatalogSkillRow, CatalogToolRow } from '@khorsheed/dsh-capability-catalog/types';
+/** One mode attributed to a capability, as a card's chip renders it. */
+export interface CatalogModeChip {
+    readonly id: string;
+    /** The preset's display name, falling back to its id. */
+    readonly label: string;
+    readonly isDefault: boolean;
+}
+/**
+ * Resolve the mode ids a capability was found in into chips, in the order the
+ * ids arrive (the roster's own read order). An id the roster no longer supplies
+ * still renders — its own id is the only label left — because dropping it would
+ * hide a mode the comparison actually read.
+ * @param ids - mode ids, in roster order.
+ * @param options - the roster, for display names and the default marker.
+ * @returns one chip per id.
+ */
+export declare function resolveModeChips(ids: readonly string[], options: readonly CatalogPresetOption[]): readonly CatalogModeChip[];
+/** One mode's face that could not be read, and why. */
+export interface UnavailableMode {
+    readonly preset: string;
+    /** The preset's display name, falling back to its id. */
+    readonly label: string;
+    readonly reason: string;
+}
+/**
+ * One managed skill that is delivered NOWHERE: scoped to preset ids no readable
+ * mode supplies, or refused by a duplicate-name conflict.
+ *
+ * These rows are the reason a mode-filtered grid needs a diagnostic surface at
+ * all. Every other managed skill is reachable by selecting a mode that loads it;
+ * these appear in no mode's face, so filtering alone would make them invisible —
+ * and an invisible managed skill cannot be released.
+ */
+export interface OrphanManagedSkill {
+    readonly name: string;
+    readonly description: string;
+    readonly modelInvocable: boolean;
+    readonly userInvocable: boolean;
+    /** The preset ids its frontmatter declares (empty = every preset, i.e. not an orphan). */
+    readonly declared: readonly string[];
+    /** Declared ids the roster no longer supplies or cannot compose. */
+    readonly unreachable: readonly string[];
+    /** The default root already supplying this name, when delivery was refused. */
+    readonly conflict?: string;
+}
+/**
+ * Find the managed skills no readable mode can show.
+ *
+ * The judgement needs no faces: the delivery status already knows which preset
+ * ids a skill declares, which presets the roster supplies, and which of those
+ * failed to resolve a standing scope. A skill whose declared ids are ALL
+ * unreachable is in no mode's face by construction — and a conflicted one is
+ * excluded from delivery entirely, so its managed copy is in no face either.
+ *
+ * An UNSCOPED managed skill (no declared ids) is deliberately NOT an orphan: the
+ * delivery serves it to every preset through the global layer, so every mode
+ * shows it. Treating it as one would put a permanent, wrong diagnostic on screen.
+ * @param skills - the managed rows (`presetScopeStatus().skills`).
+ * @param presets - every preset the roster supplies.
+ * @param failedPresets - preset ids whose standing scope could not be resolved.
+ * @returns the orphan rows, name-sorted.
+ */
+export declare function orphanManagedSkills(skills: readonly CatalogScopedSkillRow[], presets: readonly CatalogPresetOption[], failedPresets: readonly string[]): readonly OrphanManagedSkill[];
+/** The comparison grid: the union of every readable mode, with attribution. */
+export interface ModeComparison {
+    /** Union rows, name-sorted, one row per capability name. */
+    readonly skills: readonly CatalogSkillRow[];
+    readonly tools: readonly CatalogToolRow[];
+    /** Capability name → the mode ids that load it, in the order the roster read them. */
+    readonly skillModes: ReadonlyMap<string, readonly string[]>;
+    readonly toolModes: ReadonlyMap<string, readonly string[]>;
+    /** How many faces were in the union. */
+    readonly modes: number;
+    /** Faces that could not be read; excluded from the union entirely. */
+    readonly unavailable: readonly UnavailableMode[];
+}
+/**
+ * Fold every mode's face into one comparison grid.
+ * @param faces - the faces the host read, in roster order.
+ * @returns the union rows, the per-capability mode lists, and the unread modes.
+ */
+export declare function buildModeComparison(faces: readonly CatalogModeFace[]): ModeComparison;
+//# sourceMappingURL=mode-model.d.ts.map