dsh-locator 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.14.0 — 2026-11-14
+
+* **Capability adapter (Wave 3, part 1)**: new tools `capability_search(intent, kinds?, riskMax?, ...)` and `capability_preflight(capability, argsJson?)` index the **live** DSH registries — tool definitions (including `mcp__<server>__<tool>` entries) and the skill catalog — and add intent matching, inferred risk (read/write/exec plus approval/sandbox hints), argument-schema validation and side-effect reporting. It reads `ctx.tools.definitions()` / `ctx.skills.list()`; it does not duplicate discovery and has no embedding dependency.
+* Snapshot cache (60 s) and graceful degradation: a missing skill service or registry produces warnings instead of breaking the tool.
+* `171 tests`; six engine binaries rebuilt at 0.14.0.
+* Deferred and explicitly documented: refs persistence plus URL/spill/attachment refs and the panel ref chip (Wave 2), the panel capability view (Wave 3 UI), and tenant/enterprise packaging (blocked on a real dsh-ee instance and credentials).
+
 ## 0.13.0 — 2026-11-14
 
 * **Authorization fix**: `locator_find` no longer lets `sessionId`, `scope: "all"` or `pathPrefix` bypass the caller's identity. An explicit session id is allowed only for the caller session or sessions whose immutable `cwd` equals the caller cwd (the same rule as DSH's session-query tools); `pathPrefix` must resolve inside the configured roots; `scope: "all"` still searches every indexed file but keeps session documents inside the caller's authorized set unless the new `allowCrossWorkspaceSessions: true` is configured.

package/README-es.md

@@ -403,6 +403,11 @@ DeepSeek Harness
 
 El motor es un único proceso Go y respeta las variables estándar `GOMEMLIMIT` y `GOGC` (o `memoryLimitMB` en la configuración). Un índice de 1,2–1,5 M de entradas alcanza varios cientos de MB de RSS con el GC por defecto; usa `GOMEMLIMIT=600MiB` (límite blando, el runtime cambia CPU por memoria) o `GOGC=50` cuando el host vaya justo de RAM. Ninguno cambia el formato de la instantánea. En la instalación en vivo usada para las cifras anteriores, el proceso anfitrión de DSH (incluida la caché de páginas de la base de contenido) rondaba los 700 MB de RSS con el índice construido, y la latencia del host en reposo se mantenía en p50 2 ms.
 
+## Notas de actualización 0.14.0
+
+- **Adaptador de capacidades**: `capability_search` (encontrar "quién puede hacer esto" desde una intención) y `capability_preflight` (visibilidad, validación del esquema de argumentos, aprobación/sandbox y efectos secundarios) leen el registro de herramientas en vivo (incluidas acciones MCP) y el catálogo de skills. Sin descubrimiento duplicado ni embeddings; refresco cada 60 s.
+- Primera parte de Wave 3; la vista de capacidades en el panel, el empaquetado multi-tenant/empresa y los refs persistentes de Wave 2 quedan para versiones posteriores.
+
 ## Notas de actualización 0.13.0
 
 - **Corrección de autorización**: `locator_find` ya no permite que `sessionId`, `scope:"all"` o `pathPrefix` eludan la identidad del llamador. Un id de sesión explícito solo se acepta para la sesión del llamador o sesiones cuyo `cwd` inmutable coincide (misma regla que las herramientas session-query de DSH); `pathPrefix` debe resolver dentro de los roots configurados; `scope:"all"` sigue buscando todos los archivos pero limita las sesiones al conjunto autorizado salvo `allowCrossWorkspaceSessions: true`.

package/README-hi.md

@@ -404,6 +404,11 @@ DeepSeek Harness
 
 इंजन एक Go प्रोसेस है और मानक `GOMEMLIMIT` और `GOGC` (या कॉन्फ़िग में `memoryLimitMB`) मानता है। 1.2–1.5 M एंट्री का इंडेक्स डिफ़ॉल्ट GC के साथ कई सौ MB RSS तक जाता है; होस्ट पर RAM कम हो तो `GOMEMLIMIT=600MiB` (सॉफ़्ट सीमा, रनटाइम CPU देकर मेमोरी बचाता है) या `GOGC=50` रखें। इनसे स्नैपशॉट फ़ॉर्मेट नहीं बदलता। ऊपर के आँकड़ों वाले लाइव सेटअप में DSH होस्ट प्रोसेस (कंटेंट डेटाबेस पेज कैश सहित) इंडेक्स बने रहने पर लगभग 700 MB RSS पर था, और खाली बैठे होस्ट की देरी p50 2ms रही।
 
+## 0.14.0 अपग्रेड नोट्स
+
+- **क्षमता अनुकूलक (capability adapter)**: `capability_search` (स्वाभाविक भाषा में "यह कौन कर सकता है" खोजें) और `capability_preflight` (दृश्यता, argument schema जाँच, approval/sandbox आवश्यकताएँ, side effects) होस्ट के live tool registry (MCP actions सहित) और skill catalog से पढ़ते हैं। कोई दोहरा discovery या embedding नहीं; snapshot हर 60 s में ताज़ा।
+- यह Wave 3 का पहला भाग है; panel capability view, tenant/enterprise packaging और Wave 2 के refs persistence/URL·spill·attachment refs आगे के संस्करणों में।
+
 ## 0.13.0 अपग्रेड नोट्स
 
 - **अधिकार सुधार**: `locator_find` अब `sessionId`, `scope:"all"` या `pathPrefix` को कॉलर की पहचान बायपास करने नहीं देता। स्पष्ट session id केवल कॉलर सत्र या जिनका अपरिवर्तनीय `cwd` कॉलर के बराबर है (DSH session-query नियम) के लिए मान्य है; `pathPrefix` कॉन्फ़िगर किए roots के अंदर होना चाहिए; `scope:"all"` सभी फ़ाइलें खोजता है पर सत्र पंक्तियाँ कॉलर के अधिकृत सेट तक सीमित रहती हैं जब तक `allowCrossWorkspaceSessions: true` न हो।

package/README-pt.md

@@ -404,6 +404,11 @@ DeepSeek Harness
 
 O motor é um único processo Go e respeita as variáveis padrão `GOMEMLIMIT` e `GOGC` (ou `memoryLimitMB` na configuração). Um índice de 1,2–1,5 M de entradas chega a várias centenas de MB de RSS com o GC padrão; use `GOMEMLIMIT=600MiB` (limite suave, o runtime troca CPU por memória) ou `GOGC=50` quando o host estiver apertado de RAM. Nenhum altera o formato do snapshot. Na instalação ao vivo usada para os números acima, o processo anfitrião do DSH (incluindo o cache de páginas do banco de conteúdo) ficava por volta de 700 MB de RSS com o índice construído, e a latência do host ocioso permanecia em p50 2 ms.
 
+## Notas de atualização 0.14.0
+
+- **Adaptador de capacidades**: `capability_search` (encontrar "quem pode fazer isso" a partir de uma intenção) e `capability_preflight` (visibilidade, validação de schema dos argumentos, aprovação/sandbox e efeitos colaterais) leem o registro de ferramentas ao vivo (incluindo ações MCP) e o catálogo de skills. Sem descoberta duplicada e sem embeddings; atualização a cada 60 s.
+- Primeira parte da Wave 3; a visão de capacidades no painel, o empacotamento multi-tenant/empresa e os refs persistentes da Wave 2 ficam para versões futuras.
+
 ## Notas de atualização 0.13.0
 
 - **Correção de autorização**: `locator_find` não deixa mais `sessionId`, `scope:"all"` ou `pathPrefix` contornarem a identidade do chamador. Um id de sessão explícito só é aceito para a sessão do chamador ou sessões cujo `cwd` imutável coincide (mesma regra das ferramentas session-query do DSH); `pathPrefix` deve resolver dentro dos roots configurados; `scope:"all"` continua buscando todos os arquivos mas limita as sessões ao conjunto autorizado, salvo `allowCrossWorkspaceSessions: true`.

package/README.en.md

@@ -404,6 +404,11 @@ DeepSeek Harness
 
 The engine is a single Go process and honours the standard `GOMEMLIMIT` and `GOGC` environment variables (or `memoryLimitMB` in the config). A 1.2–1.5 M-entry index peaks around several hundred MB of RSS with the default GC; set `GOMEMLIMIT=600MiB` (soft limit, the runtime trades CPU for memory) or `GOGC=50` when the host is tight on RAM. Neither changes the snapshot format. In the live setup used for the numbers above, the DSH host process (including the content database page cache) sat around 700 MB RSS with the content index built, and idle host latency stayed at p50 2 ms.
 
+## 0.14.0 upgrade notes
+
+- **Capability adapter**: `capability_search` (find "who can do this" from a natural-language intent) and `capability_preflight` (visibility, argument-schema validation, approval/sandbox requirements and side effects) read the host's live tool registry (including MCP actions) and skill catalog. No duplicate discovery and no embedding model; snapshots refresh every 60 s.
+- This is part 1 of Wave 3. The panel capability view, tenancy/enterprise packaging (needs a real dsh-ee instance and credentials) and the Wave 2 refs persistence/URL·spill·attachment refs remain future work.
+
 ## 0.13.0 upgrade notes
 
 - **Authorization fix**: `locator_find` no longer lets `sessionId`, `scope: "all"` or `pathPrefix` bypass the caller identity. An explicit session id is allowed only for the caller session or sessions whose immutable `cwd` equals the caller cwd (same rule as DSH's session-query tools); `pathPrefix` must resolve inside the configured roots; `scope: "all"` still searches every indexed file but keeps session bodies inside the caller's authorized set unless `allowCrossWorkspaceSessions: true` is configured.

package/README.md

@@ -366,6 +366,11 @@ Go 引擎在 `engine/` 下，测试用 `cd engine && go test ./...`。macOS 的
 - 当前会话范围只覆盖已落定索引的会话消息（活跃会话约 2 分钟延迟）；实时查找用 `Ctrl+F`。会话内查找条只覆盖已加载窗口，更早历史需手动加载。
 - 会话内高亮依赖 CSS Custom Highlight API；不支持它的旧浏览器会退化为整行描边。
 
+## 0.14.0 更新
+
+- **能力索引适配器**：新增 `capability_search`（自然语言找“谁能做这件事”）与 `capability_preflight`（能力是否可见、参数是否符合 schema、需要什么审批/沙箱、有哪些副作用）；数据来自宿主已有的 tool registry（含 MCP 工具）与 skill catalog，不重复发现、不用 embedding，60s 自动刷新。
+- 本版是 Wave 3 的第一部分；面板能力页、租户/企业包，以及 Wave 2 的 refs 持久化/URL·spill·attachment ref 留待后续版本（企业包需 dsh-ee 实例与凭据）。
+
 ## 0.13.0 更新
 
 - **授权修复**：`locator_find` 的 `sessionId`/`scope:"all"`/`pathPrefix` 不再绕过调用方身份——显式会话 id 只允许「当前会话」或「header.cwd 与调用方相同的会话」（与 DSH session-query 工具一致）；`pathPrefix` 必须落在已配置 root 内；`scope:"all"` 仍可搜全部文件，但会话正文默认限调用方授权集合（`allowCrossWorkspaceSessions: true` 可显式放开）。

package/lib/capabilities.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Capability index: which tool/skill/MCP action can do a job, what it costs and
+ * what it may touch. This is a thin adapter over the DSH registries the host
+ * already keeps (tool definitions, skill catalog): it does not re-implement
+ * discovery, it adds intent matching, risk labels and a preflight check.
+ * @module dsh-locator/capabilities
+ */
+import type { ToolRunContext } from '@deepseek-ai/dsh-tools';
+/** One capability card. */
+export interface CapabilityCard {
+    id: string;
+    kind: 'tool' | 'mcp' | 'skill';
+    name: string;
+    summary: string;
+    input?: Record<string, unknown>;
+    tags: string[];
+    risk: {
+        level: 'read' | 'write' | 'exec';
+        actions: string[];
+        basis: 'schema' | 'name';
+    };
+    permission: {
+        approval: 'none' | 'ask';
+        sandbox: 'none' | 'write' | 'any';
+    };
+    state: 'available' | 'unknown';
+    source: 'tools' | 'skills';
+}
+/** One snapshot of the live capability surface. */
+export interface CapabilitySnapshot {
+    builtAt: number;
+    cards: CapabilityCard[];
+    warnings: string[];
+}
+/** Minimal shape of the host services this module reads. */
+export interface CapabilitySources {
+    tools?: {
+        definitions?: (scope?: unknown, toolSet?: unknown) => readonly unknown[];
+        get?: (name: string, scope?: unknown) => unknown;
+    } | undefined;
+    skills?: {
+        list?: (options?: Record<string, unknown>) => Promise<readonly unknown[]>;
+    } | undefined;
+}
+/** Tokenize one intent/name for the lexical scorer (letters, digits, CJK). */
+export declare function tokenize(text: string): string[];
+/** Infer risk/permission from a tool name, description and parameter schema. */
+export declare function inferRisk(name: string, description: string, parameters?: Record<string, unknown>): CapabilityCard['risk'] & {
+    permission: CapabilityCard['permission'];
+};
+/** Build one capability snapshot from the live host services. */
+export declare function buildCapabilitySnapshot(sources: CapabilitySources, scope?: unknown): Promise<CapabilitySnapshot>;
+/** Card projection returned by tools: drop the full input schema payload. */
+export declare function publicCard(card: CapabilityCard): Omit<CapabilityCard, 'input'>;
+/** One ranked capability hit. */
+export interface CapabilityHit {
+    card: CapabilityCard;
+    score: number;
+    why: string[];
+}
+/**
+ * Rank capability cards against an intent and optional filters.
+ * @param cards - snapshot cards.
+ * @param intent - what the caller wants to do.
+ * @param options - kind/risk filters and pagination.
+ * @returns ranked hits and the total before paging.
+ */
+export declare function searchCapabilities(cards: readonly CapabilityCard[], intent: string, options?: {
+    kinds?: readonly CapabilityCard['kind'][];
+    riskMax?: 'read' | 'write' | 'exec';
+    limit?: number;
+    offset?: number;
+    availableOnly?: boolean;
+}): {
+    hits: CapabilityHit[];
+    total: number;
+};
+/** One preflight result. */
+export interface PreflightResult {
+    ok: boolean;
+    card?: CapabilityCard;
+    admitted: boolean;
+    schema?: {
+        valid: boolean;
+        violations: string[];
+    };
+    requires: {
+        approval: 'none' | 'ask';
+        sandbox: 'none' | 'write' | 'any';
+    };
+    sideEffects: string[];
+    next: {
+        callable: boolean;
+        suggestion?: string;
+    };
+    error?: string;
+    warnings: string[];
+}
+/**
+ * Check whether one capability can be called with the given arguments right
+ * now: existence/visibility, argument schema, predicted approval/sandbox and
+ * side effects. It never executes the target.
+ */
+export declare function preflightCapability(snapshot: CapabilitySnapshot, target: string, args?: Record<string, unknown>, sources?: CapabilitySources, scope?: unknown): PreflightResult;
+/** Build `capability_search` and `capability_preflight` bound to the host registries. */
+export declare function makeCapabilityTools(sources: CapabilitySources): readonly [import("@deepseek-ai/dsh-tools").ToolDefinition, import("@deepseek-ai/dsh-tools").ToolDefinition];
+/** ToolRunContext re-export keeps the module self-describing for tests. */
+export type { ToolRunContext };
+//# sourceMappingURL=capabilities.d.ts.map

package/lib/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"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"}

package/lib/capabilities.js

@@ -0,0 +1,372 @@
+/**
+ * Capability index: which tool/skill/MCP action can do a job, what it costs and
+ * what it may touch. This is a thin adapter over the DSH registries the host
+ * already keeps (tool definitions, skill catalog): it does not re-implement
+ * discovery, it adds intent matching, risk labels and a preflight check.
+ * @module dsh-locator/capabilities
+ */
+import { defineTool, validateJsonSchemaValue } from '@deepseek-ai/dsh-tools';
+const WRITE_WORDS = ['write', 'edit', 'delete', 'remove', 'move', 'rename', 'mkdir', 'install', 'uninstall', 'publish', 'patch', 'apply'];
+const EXEC_WORDS = ['bash', 'shell', 'execute', 'terminal', 'run_code', 'spawn', 'command'];
+const ALIASES = {
+    文件: ['file', 'files', 'path'], 搜索: ['search', 'find', 'grep'], 写: ['write', 'edit'], 删除: ['delete', 'remove'],
+    运行: ['run', 'exec', 'bash'], 命令: ['command', 'shell'], 网页: ['web', 'http', 'url'], 截图: ['screenshot', 'screen'],
+    测试: ['test'], 安装: ['install'], 插件: ['plugin'], 技能: ['skill'], 工具: ['tool'],
+};
+/** Tokenize one intent/name for the lexical scorer (letters, digits, CJK). */
+export function tokenize(text) {
+    const lowered = text.toLowerCase();
+    const ascii = lowered.match(/[a-z0-9_]{2,}/g) ?? [];
+    const cjk = lowered.match(/[\u4e00-\u9fff]{2}/g) ?? [];
+    const expanded = [...ascii, ...cjk];
+    for (const [key, values] of Object.entries(ALIASES)) {
+        if (lowered.includes(key))
+            expanded.push(...values);
+    }
+    return [...new Set(expanded)];
+}
+/** Infer risk/permission from a tool name, description and parameter schema. */
+export function inferRisk(name, description, parameters) {
+    const haystack = `${name} ${description}`.toLowerCase();
+    const properties = parameters !== undefined && typeof parameters === 'object' && parameters !== null && typeof parameters.properties === 'object'
+        ? Object.keys(parameters.properties)
+        : [];
+    const actions = [];
+    let level = 'read';
+    if (EXEC_WORDS.some(word => haystack.includes(word)) || properties.includes('command') || properties.includes('cmd')) {
+        level = 'exec';
+        actions.push('may execute a process');
+    }
+    if (WRITE_WORDS.some(word => haystack.includes(word)) || properties.includes('content') || properties.includes('sandbox_permissions')) {
+        if (level !== 'exec')
+            level = 'write';
+        actions.push('may modify state');
+    }
+    if (properties.includes('sandbox_permissions'))
+        actions.push('can request escalated sandbox permissions');
+    return {
+        level,
+        actions: [...new Set(actions)],
+        basis: properties.length > 0 ? 'schema' : 'name',
+        permission: { approval: level === 'read' ? 'none' : 'ask', sandbox: level === 'read' ? 'none' : level === 'exec' ? 'any' : 'write' },
+    };
+}
+/** Convert one DSH ToolDefinition into a capability card. */
+function toolCard(definition) {
+    if (typeof definition !== 'object' || definition === null)
+        return undefined;
+    const record = definition;
+    if (typeof record.name !== 'string' || record.name === '')
+        return undefined;
+    const name = record.name;
+    const description = typeof record.description === 'string' ? record.description : '';
+    const parameters = typeof record.parameters === 'object' && record.parameters !== null ? record.parameters : undefined;
+    const risk = inferRisk(name, description, parameters);
+    const mcpParts = /^mcp__([^_]+(?:_[^_]+)*)__(.+)$/.exec(name);
+    const kind = mcpParts !== null ? 'mcp' : 'tool';
+    const display = mcpParts !== null ? `${mcpParts[1]}/${mcpParts[2]}` : name;
+    return {
+        id: kind === 'mcp' ? `mcp:${display}` : `tool:${name}`,
+        kind,
+        name: display,
+        summary: description.split('\n')[0]?.slice(0, 240) ?? '',
+        ...(parameters === undefined ? {} : { input: parameters }),
+        tags: tokenize(`${name} ${description}`).slice(0, 12),
+        risk: { level: risk.level, actions: risk.actions, basis: risk.basis },
+        permission: risk.permission,
+        state: 'available',
+        source: 'tools',
+    };
+}
+/** Convert one SkillSummary into a capability card. */
+function skillCard(skill) {
+    if (typeof skill !== 'object' || skill === null)
+        return undefined;
+    const record = skill;
+    if (typeof record.name !== 'string' || record.name === '')
+        return undefined;
+    const summary = `${typeof record.description === 'string' ? record.description : ''}${typeof record.whenToUse === 'string' ? ` · ${record.whenToUse}` : ''}`.trim();
+    const invocation = typeof record.invocation === 'object' && record.invocation !== null ? record.invocation : undefined;
+    return {
+        id: `skill:${record.name}`,
+        kind: 'skill',
+        name: record.name,
+        summary: summary.slice(0, 240),
+        tags: tokenize(`${record.name} ${summary}`).slice(0, 12),
+        risk: { level: 'read', actions: ['loads instructions, no direct side effects'], basis: 'name' },
+        permission: { approval: 'none', sandbox: 'none' },
+        state: invocation?.modelInvocable === false ? 'unknown' : 'available',
+        source: 'skills',
+    };
+}
+/** Build one capability snapshot from the live host services. */
+export async function buildCapabilitySnapshot(sources, scope) {
+    const warnings = [];
+    const cards = [];
+    try {
+        const definitions = sources.tools?.definitions?.(scope) ?? [];
+        for (const definition of definitions) {
+            const card = toolCard(definition);
+            if (card !== undefined)
+                cards.push(card);
+        }
+    }
+    catch (error) {
+        warnings.push(`tool-catalog-unavailable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (sources.skills?.list !== undefined) {
+        try {
+            const skills = await sources.skills.list(scope === undefined ? {} : { scope });
+            for (const skill of skills) {
+                const card = skillCard(skill);
+                if (card !== undefined)
+                    cards.push(card);
+            }
+        }
+        catch (error) {
+            warnings.push(`skill-catalog-unavailable: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else {
+        warnings.push('skill-service-unavailable');
+    }
+    cards.sort((left, right) => left.id.localeCompare(right.id));
+    return { builtAt: Date.now(), cards, warnings };
+}
+/** Card projection returned by tools: drop the full input schema payload. */
+export function publicCard(card) {
+    const { input: _input, ...rest } = card;
+    return rest;
+}
+/**
+ * Rank capability cards against an intent and optional filters.
+ * @param cards - snapshot cards.
+ * @param intent - what the caller wants to do.
+ * @param options - kind/risk filters and pagination.
+ * @returns ranked hits and the total before paging.
+ */
+export function searchCapabilities(cards, intent, options = {}) {
+    const terms = tokenize(intent);
+    const limit = Math.max(1, Math.min(50, options.limit ?? 10));
+    const offset = Math.max(0, options.offset ?? 0);
+    const matches = cards.filter(card => {
+        if (options.kinds !== undefined && options.kinds.length > 0 && !options.kinds.includes(card.kind))
+            return false;
+        if (options.availableOnly === true && card.state !== 'available')
+            return false;
+        if (options.riskMax !== undefined) {
+            const order = { read: 0, write: 1, exec: 2 };
+            if (order[card.risk.level] > order[options.riskMax])
+                return false;
+        }
+        return true;
+    });
+    const scored = [];
+    for (const card of matches) {
+        const haystack = tokenize(`${card.name} ${card.summary} ${card.tags.join(' ')}`);
+        const why = [];
+        let score = 0;
+        for (const term of terms) {
+            if (card.name.toLowerCase().includes(term)) {
+                score += 6;
+                why.push(`name:${term}`);
+                continue;
+            }
+            if (haystack.includes(term)) {
+                score += 2;
+                why.push(`text:${term}`);
+            }
+        }
+        if (terms.length === 0) {
+            score = 1;
+            why.push('intent-empty: lists capabilities');
+        }
+        if (score > 0)
+            scored.push({ card, score, why: why.slice(0, 6) });
+    }
+    scored.sort((left, right) => right.score - left.score || left.card.id.localeCompare(right.card.id));
+    return { hits: scored.slice(offset, offset + limit), total: scored.length };
+}
+/**
+ * Check whether one capability can be called with the given arguments right
+ * now: existence/visibility, argument schema, predicted approval/sandbox and
+ * side effects. It never executes the target.
+ */
+export function preflightCapability(snapshot, target, args, sources, scope) {
+    const normalized = target.trim();
+    const card = snapshot.cards.find(entry => entry.id === normalized || entry.name === normalized || entry.id === `tool:${normalized}` || entry.id === `mcp:${normalized}` || entry.id === `skill:${normalized}`);
+    if (card === undefined) {
+        return { ok: false, admitted: false, requires: { approval: 'none', sandbox: 'none' }, sideEffects: [], next: { callable: false }, error: 'capability-not-found', warnings: [] };
+    }
+    const warnings = [...snapshot.warnings];
+    let visible = true;
+    if (card.kind !== 'skill' && sources?.tools?.get !== undefined) {
+        try {
+            visible = sources.tools.get(card.kind === 'mcp' ? card.name.replace('/', '__') : card.name, scope) !== undefined;
+        }
+        catch {
+            visible = true;
+        }
+    }
+    let schema;
+    if (args !== undefined && card.input !== undefined) {
+        try {
+            const violations = validateJsonSchemaValue(card.input, args);
+            schema = { valid: violations.length === 0, violations };
+        }
+        catch (error) {
+            schema = { valid: false, violations: [error instanceof Error ? error.message : String(error)] };
+        }
+    }
+    const callable = visible && (schema?.valid ?? true);
+    const suggestion = callable
+        ? undefined
+        : !visible
+            ? 'capability is registered but not visible in this agent scope'
+            : schema?.valid === false
+                ? 'fix the arguments against the declared schema'
+                : 'capability is not callable from this scope';
+    return {
+        ok: true,
+        card: publicCard(card),
+        admitted: callable,
+        ...(schema === undefined ? {} : { schema }),
+        requires: card.permission,
+        sideEffects: card.risk.actions,
+        next: { callable, ...(suggestion === undefined ? {} : { suggestion }) },
+        warnings,
+    };
+}
+const CARD_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        id: { type: 'string' }, kind: { type: 'string', enum: ['tool', 'mcp', 'skill'] },
+        name: { type: 'string' }, summary: { type: 'string' },
+        tags: { type: 'array', items: { type: 'string' } },
+        risk: { type: 'object', additionalProperties: false, properties: { level: { type: 'string' }, actions: { type: 'array', items: { type: 'string' } }, basis: { type: 'string' } } },
+        permission: { type: 'object', additionalProperties: false, properties: { approval: { type: 'string' }, sandbox: { type: 'string' } } },
+        state: { type: 'string' }, source: { type: 'string' },
+    },
+};
+/** Build `capability_search` and `capability_preflight` bound to the host registries. */
+export function makeCapabilityTools(sources) {
+    let cached;
+    const snapshotFor = async (scope) => {
+        if (cached === undefined || Date.now() - cached.builtAt > 60_000)
+            cached = await buildCapabilitySnapshot(sources, scope);
+        return cached;
+    };
+    const searchTool = defineTool({
+        name: 'capability_search',
+        description: [
+            'Find the tool, MCP action or skill that can do a job (dsh-locator capability adapter).',
+            '',
+            'Use it when the caller knows the goal but not which capability performs it: pass the intent in natural language and filter by kind/risk. Every hit carries risk and permission hints plus the card id usable with `capability_preflight`.',
+            '',
+            'This is not a file search: it indexes the live DSH capability registry (tool definitions and the skill catalog), not file names or bodies.',
+        ].join('\n'),
+        parameters: {
+            intent: { type: 'string', required: true, description: 'What should be done, in natural language (English or Chinese).' },
+            kinds: { type: 'array', items: { type: 'string', enum: ['tool', 'mcp', 'skill'] }, description: 'Restrict to these capability kinds.' },
+            riskMax: { type: 'string', enum: ['read', 'write', 'exec'], description: 'Only return capabilities at or below this risk level.' },
+            availableOnly: { type: 'boolean', description: 'Only return cards that are currently visible/available.' },
+            limit: { type: 'integer', description: 'Maximum hits (default 10, at most 50).' },
+            offset: { type: 'integer', description: 'Skip this many ranked hits.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    ok: { type: 'boolean', required: true },
+                    intent: { type: 'string' }, total: { type: 'integer' }, returned: { type: 'integer' },
+                    hits: { type: 'array', items: { type: 'object', additionalProperties: false, properties: { card: CARD_SCHEMA, score: { type: 'number' }, why: { type: 'array', items: { type: 'string' } } } } },
+                    warnings: { type: 'array', items: { type: 'string' } }, error: { type: 'string' },
+                },
+            },
+            render: (_args, value) => {
+                const v = value;
+                if (!v.ok)
+                    return [{ type: 'text', text: `capability_search failed: ${v.error ?? 'unknown error'}` }];
+                const lines = [`capability_search ${JSON.stringify(v.intent ?? '')}: ${String(v.total ?? 0)} match(es)`];
+                for (const hit of v.hits ?? []) {
+                    lines.push(`- ${hit.card.id} [${hit.card.kind}] risk=${hit.card.risk.level} approval=${hit.card.permission.approval} — ${hit.card.summary}`);
+                }
+                if ((v.warnings ?? []).length > 0)
+                    lines.push(`warnings: ${[...new Set(v.warnings ?? [])].join(', ')}`);
+                return [{ type: 'text', text: lines.join('\n') }];
+            },
+        },
+        async execute(args, exec) {
+            const snapshot = await snapshotFor(exec?.agent);
+            const kinds = Array.isArray(args.kinds) ? args.kinds.filter((kind) => kind === 'tool' || kind === 'mcp' || kind === 'skill') : undefined;
+            const riskMax = args.riskMax === 'read' || args.riskMax === 'write' || args.riskMax === 'exec' ? args.riskMax : undefined;
+            const result = searchCapabilities(snapshot.cards, args.intent, { ...(kinds === undefined ? {} : { kinds }), ...(riskMax === undefined ? {} : { riskMax }), limit: Math.max(1, Math.min(50, args.limit ?? 10)), offset: Math.max(0, args.offset ?? 0), availableOnly: args.availableOnly === true });
+            const hits = result.hits.map(hit => ({ ...hit, card: publicCard(hit.card) }));
+            return { ok: true, intent: args.intent, total: result.total, returned: hits.length, hits, warnings: snapshot.warnings };
+        },
+    });
+    const preflightTool = defineTool({
+        name: 'capability_preflight',
+        description: [
+            'Check one capability before calling it (dsh-locator capability adapter): whether it exists and is visible, whether the arguments match its declared schema, and which approval/sandbox/side effects it implies.',
+            '',
+            'It never executes the target. Use it when a plan depends on a tool/MCP action/skill and the caller needs to know the cost or permission risk first.',
+        ].join('\n'),
+        parameters: {
+            capability: { type: 'string', required: true, description: 'Card id (`tool:<name>`, `mcp:<server>/<action>`, `skill:<name>`) or plain name from capability_search.' },
+            argsJson: { type: 'string', description: 'Candidate arguments as a JSON object string to validate against the declared schema.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    ok: { type: 'boolean', required: true },
+                    card: CARD_SCHEMA,
+                    admitted: { type: 'boolean' },
+                    schema: { type: 'object', additionalProperties: false, properties: { valid: { type: 'boolean' }, violations: { type: 'array', items: { type: 'string' } } } },
+                    requires: { type: 'object', additionalProperties: false, properties: { approval: { type: 'string' }, sandbox: { type: 'string' } } },
+                    sideEffects: { type: 'array', items: { type: 'string' } },
+                    next: { type: 'object', additionalProperties: false, properties: { callable: { type: 'boolean' }, suggestion: { type: 'string' } } },
+                    error: { type: 'string' }, warnings: { type: 'array', items: { type: 'string' } },
+                },
+            },
+            render: (_args, value) => {
+                const v = value;
+                if (!v.ok)
+                    return [{ type: 'text', text: `capability_preflight failed: ${v.error ?? 'unknown error'}` }];
+                const lines = [
+                    `capability_preflight ${v.card?.id ?? ''}: callable=${String(v.next?.callable ?? v.admitted ?? false)}`,
+                    `  risk: ${v.card?.risk.level ?? '?'} · approval=${v.requires?.approval ?? '?'} · sandbox=${v.requires?.sandbox ?? '?'}`,
+                    `  schema: ${v.schema === undefined ? 'not checked (no args/schema)' : v.schema.valid ? 'valid' : `invalid (${v.schema.violations.join('; ')})`}`,
+                ];
+                if ((v.sideEffects ?? []).length > 0)
+                    lines.push(`  side effects: ${(v.sideEffects ?? []).join('; ')}`);
+                if (v.next?.suggestion !== undefined)
+                    lines.push(`  suggestion: ${v.next.suggestion}`);
+                return [{ type: 'text', text: lines.join('\n') }];
+            },
+        },
+        async execute(args, exec) {
+            const snapshot = await snapshotFor(exec?.agent);
+            let candidate;
+            if (typeof args.argsJson === 'string' && args.argsJson.trim() !== '') {
+                try {
+                    const parsed = JSON.parse(args.argsJson);
+                    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                        return { ok: false, admitted: false, requires: { approval: 'none', sandbox: 'none' }, sideEffects: [], next: { callable: false }, error: 'invalid-args-json', warnings: [] };
+                    }
+                    candidate = parsed;
+                }
+                catch {
+                    return { ok: false, admitted: false, requires: { approval: 'none', sandbox: 'none' }, sideEffects: [], next: { callable: false }, error: 'invalid-args-json', warnings: [] };
+                }
+            }
+            return preflightCapability(snapshot, args.capability, candidate, sources, exec?.agent);
+        },
+    });
+    return [searchTool, preflightTool];
+}
+//# sourceMappingURL=capabilities.js.map

package/lib/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,IAAI,YAAY,EAAiB,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAWzC,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,CAAA;AAEjC,0BAA0B;AAC1B,eAAO,MAAM,IAAI,gBAAgB,CAAA;AAEjC,2DAA2D;AAC3D,eAAO,MAAM,MAAM,UAAY,CAAA;AAoC/B;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA4GxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,IAAI,YAAY,EAAiB,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAYzC,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,CAAA;AAEjC,0BAA0B;AAC1B,eAAO,MAAM,IAAI,gBAAgB,CAAA;AAEjC,2DAA2D;AAC3D,eAAO,MAAM,MAAM,UAAY,CAAA;AAoC/B;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoHxD"}

package/lib/index.js

@@ -11,6 +11,7 @@ import { makeReindexTool } from "./reindex.js";
 import { registerHttp } from "./http.js";
 import { resolveBinary, resolveRoots, resolveStateDir } from "./paths.js";
 import { LocatorRuntime } from "./runtime.js";
+import { makeCapabilityTools } from "./capabilities.js";
 import { makeCiteTool, makeResolveTool } from "./ref-tools.js";
 import { makeRebuildTool, makeSearchTool, makeStatusTool } from "./tools.js";
 export { ConfigSchema as Config };
@@ -160,6 +161,15 @@ export function apply(ctx, config) {
     ctx.tools.register(makeExportTool(rt));
     ctx.tools.register(makeResolveTool(rt, content));
     ctx.tools.register(makeCiteTool());
+    // Capability adapter: read the host's tool registry and skill catalog instead
+    // of duplicating discovery. Optional services stay optional.
+    const skillsService = ctx.get?.('skills');
+    const capabilitySources = {
+        tools: ctx.tools,
+        ...(skillsService === undefined ? {} : { skills: skillsService }),
+    };
+    for (const tool of makeCapabilityTools(capabilitySources))
+        ctx.tools.register(tool);
     if (content !== undefined) {
         ctx.tools.register(makeFindTool(content, ensureContent, roots, config.allowCrossWorkspaceSessions));
         ctx.tools.register(makeReindexTool(content, ensureContent));

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-locator",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Whole-disk, millisecond file search for DeepSeek Harness without Everything: a self-built cross-platform index, an Everything-style query language, agent tools and a Web search panel (Ctrl+Shift+F). Windows, macOS and Linux.",
   "author": "PerryLink contributors",
   "repository": {

package/src/capabilities.ts

@@ -0,0 +1,405 @@
+/**
+ * Capability index: which tool/skill/MCP action can do a job, what it costs and
+ * what it may touch. This is a thin adapter over the DSH registries the host
+ * already keeps (tool definitions, skill catalog): it does not re-implement
+ * discovery, it adds intent matching, risk labels and a preflight check.
+ * @module dsh-locator/capabilities
+ */
+
+import { defineTool, validateJsonSchemaValue } from '@deepseek-ai/dsh-tools'
+import type { ToolRunContext } from '@deepseek-ai/dsh-tools'
+
+/** One capability card. */
+export interface CapabilityCard {
+  id: string
+  kind: 'tool' | 'mcp' | 'skill'
+  name: string
+  summary: string
+  input?: Record<string, unknown>
+  tags: string[]
+  risk: { level: 'read' | 'write' | 'exec'; actions: string[]; basis: 'schema' | 'name' }
+  permission: { approval: 'none' | 'ask'; sandbox: 'none' | 'write' | 'any' }
+  state: 'available' | 'unknown'
+  source: 'tools' | 'skills'
+}
+
+/** One snapshot of the live capability surface. */
+export interface CapabilitySnapshot {
+  builtAt: number
+  cards: CapabilityCard[]
+  warnings: string[]
+}
+
+/** Minimal shape of the host services this module reads. */
+export interface CapabilitySources {
+  tools?: {
+    definitions?: (scope?: unknown, toolSet?: unknown) => readonly unknown[]
+    get?: (name: string, scope?: unknown) => unknown
+  } | undefined
+  skills?: { list?: (options?: Record<string, unknown>) => Promise<readonly unknown[]> } | undefined
+}
+
+const WRITE_WORDS = ['write', 'edit', 'delete', 'remove', 'move', 'rename', 'mkdir', 'install', 'uninstall', 'publish', 'patch', 'apply']
+const EXEC_WORDS = ['bash', 'shell', 'execute', 'terminal', 'run_code', 'spawn', 'command']
+const ALIASES: Record<string, string[]> = {
+  文件: ['file', 'files', 'path'], 搜索: ['search', 'find', 'grep'], 写: ['write', 'edit'], 删除: ['delete', 'remove'],
+  运行: ['run', 'exec', 'bash'], 命令: ['command', 'shell'], 网页: ['web', 'http', 'url'], 截图: ['screenshot', 'screen'],
+  测试: ['test'], 安装: ['install'], 插件: ['plugin'], 技能: ['skill'], 工具: ['tool'],
+}
+
+/** Tokenize one intent/name for the lexical scorer (letters, digits, CJK). */
+export function tokenize(text: string): string[] {
+  const lowered = text.toLowerCase()
+  const ascii = lowered.match(/[a-z0-9_]{2,}/g) ?? []
+  const cjk = lowered.match(/[\u4e00-\u9fff]{2}/g) ?? []
+  const expanded = [...ascii, ...cjk]
+  for (const [key, values] of Object.entries(ALIASES)) {
+    if (lowered.includes(key)) expanded.push(...values)
+  }
+  return [...new Set(expanded)]
+}
+
+/** Infer risk/permission from a tool name, description and parameter schema. */
+export function inferRisk(name: string, description: string, parameters?: Record<string, unknown>): CapabilityCard['risk'] & { permission: CapabilityCard['permission'] } {
+  const haystack = `${name} ${description}`.toLowerCase()
+  const properties = parameters !== undefined && typeof parameters === 'object' && parameters !== null && typeof (parameters as { properties?: unknown }).properties === 'object'
+    ? Object.keys((parameters as { properties: Record<string, unknown> }).properties)
+    : []
+  const actions: string[] = []
+  let level: 'read' | 'write' | 'exec' = 'read'
+  if (EXEC_WORDS.some(word => haystack.includes(word)) || properties.includes('command') || properties.includes('cmd')) { level = 'exec'; actions.push('may execute a process') }
+  if (WRITE_WORDS.some(word => haystack.includes(word)) || properties.includes('content') || properties.includes('sandbox_permissions')) {
+    if (level !== 'exec') level = 'write'
+    actions.push('may modify state')
+  }
+  if (properties.includes('sandbox_permissions')) actions.push('can request escalated sandbox permissions')
+  return {
+    level,
+    actions: [...new Set(actions)],
+    basis: properties.length > 0 ? 'schema' : 'name',
+    permission: { approval: level === 'read' ? 'none' : 'ask', sandbox: level === 'read' ? 'none' : level === 'exec' ? 'any' : 'write' },
+  }
+}
+
+/** Convert one DSH ToolDefinition into a capability card. */
+function toolCard(definition: unknown): CapabilityCard | undefined {
+  if (typeof definition !== 'object' || definition === null) return undefined
+  const record = definition as { name?: unknown; description?: unknown; parameters?: unknown; output?: unknown }
+  if (typeof record.name !== 'string' || record.name === '') return undefined
+  const name = record.name
+  const description = typeof record.description === 'string' ? record.description : ''
+  const parameters = typeof record.parameters === 'object' && record.parameters !== null ? record.parameters as Record<string, unknown> : undefined
+  const risk = inferRisk(name, description, parameters)
+  const mcpParts = /^mcp__([^_]+(?:_[^_]+)*)__(.+)$/.exec(name)
+  const kind: CapabilityCard['kind'] = mcpParts !== null ? 'mcp' : 'tool'
+  const display = mcpParts !== null ? `${mcpParts[1]}/${mcpParts[2]}` : name
+  return {
+    id: kind === 'mcp' ? `mcp:${display}` : `tool:${name}`,
+    kind,
+    name: display,
+    summary: description.split('\n')[0]?.slice(0, 240) ?? '',
+    ...(parameters === undefined ? {} : { input: parameters }),
+    tags: tokenize(`${name} ${description}`).slice(0, 12),
+    risk: { level: risk.level, actions: risk.actions, basis: risk.basis },
+    permission: risk.permission,
+    state: 'available',
+    source: 'tools',
+  }
+}
+
+/** Convert one SkillSummary into a capability card. */
+function skillCard(skill: unknown): CapabilityCard | undefined {
+  if (typeof skill !== 'object' || skill === null) return undefined
+  const record = skill as { name?: unknown; description?: unknown; whenToUse?: unknown; source?: unknown; invocation?: unknown }
+  if (typeof record.name !== 'string' || record.name === '') return undefined
+  const summary = `${typeof record.description === 'string' ? record.description : ''}${typeof record.whenToUse === 'string' ? ` · ${record.whenToUse}` : ''}`.trim()
+  const invocation = typeof record.invocation === 'object' && record.invocation !== null ? record.invocation as { modelInvocable?: unknown } : undefined
+  return {
+    id: `skill:${record.name}`,
+    kind: 'skill',
+    name: record.name,
+    summary: summary.slice(0, 240),
+    tags: tokenize(`${record.name} ${summary}`).slice(0, 12),
+    risk: { level: 'read', actions: ['loads instructions, no direct side effects'], basis: 'name' },
+    permission: { approval: 'none', sandbox: 'none' },
+    state: invocation?.modelInvocable === false ? 'unknown' : 'available',
+    source: 'skills',
+  }
+}
+
+/** Build one capability snapshot from the live host services. */
+export async function buildCapabilitySnapshot(sources: CapabilitySources, scope?: unknown): Promise<CapabilitySnapshot> {
+  const warnings: string[] = []
+  const cards: CapabilityCard[] = []
+  try {
+    const definitions = sources.tools?.definitions?.(scope) ?? []
+    for (const definition of definitions) {
+      const card = toolCard(definition)
+      if (card !== undefined) cards.push(card)
+    }
+  } catch (error) {
+    warnings.push(`tool-catalog-unavailable: ${error instanceof Error ? error.message : String(error)}`)
+  }
+  if (sources.skills?.list !== undefined) {
+    try {
+      const skills = await sources.skills.list(scope === undefined ? {} : { scope })
+      for (const skill of skills) {
+        const card = skillCard(skill)
+        if (card !== undefined) cards.push(card)
+      }
+    } catch (error) {
+      warnings.push(`skill-catalog-unavailable: ${error instanceof Error ? error.message : String(error)}`)
+    }
+  } else {
+    warnings.push('skill-service-unavailable')
+  }
+  cards.sort((left, right) => left.id.localeCompare(right.id))
+  return { builtAt: Date.now(), cards, warnings }
+}
+
+/** Card projection returned by tools: drop the full input schema payload. */
+export function publicCard(card: CapabilityCard): Omit<CapabilityCard, 'input'> {
+  const { input: _input, ...rest } = card
+  return rest
+}
+
+/** One ranked capability hit. */
+export interface CapabilityHit {
+  card: CapabilityCard
+  score: number
+  why: string[]
+}
+
+/**
+ * Rank capability cards against an intent and optional filters.
+ * @param cards - snapshot cards.
+ * @param intent - what the caller wants to do.
+ * @param options - kind/risk filters and pagination.
+ * @returns ranked hits and the total before paging.
+ */
+export function searchCapabilities(
+  cards: readonly CapabilityCard[],
+  intent: string,
+  options: { kinds?: readonly CapabilityCard['kind'][]; riskMax?: 'read' | 'write' | 'exec'; limit?: number; offset?: number; availableOnly?: boolean } = {},
+): { hits: CapabilityHit[]; total: number } {
+  const terms = tokenize(intent)
+  const limit = Math.max(1, Math.min(50, options.limit ?? 10))
+  const offset = Math.max(0, options.offset ?? 0)
+  const matches = cards.filter(card => {
+    if (options.kinds !== undefined && options.kinds.length > 0 && !options.kinds.includes(card.kind)) return false
+    if (options.availableOnly === true && card.state !== 'available') return false
+    if (options.riskMax !== undefined) {
+      const order = { read: 0, write: 1, exec: 2 } as const
+      if (order[card.risk.level] > order[options.riskMax]) return false
+    }
+    return true
+  })
+  const scored: CapabilityHit[] = []
+  for (const card of matches) {
+    const haystack = tokenize(`${card.name} ${card.summary} ${card.tags.join(' ')}`)
+    const why: string[] = []
+    let score = 0
+    for (const term of terms) {
+      if (card.name.toLowerCase().includes(term)) { score += 6; why.push(`name:${term}`); continue }
+      if (haystack.includes(term)) { score += 2; why.push(`text:${term}`) }
+    }
+    if (terms.length === 0) { score = 1; why.push('intent-empty: lists capabilities') }
+    if (score > 0) scored.push({ card, score, why: why.slice(0, 6) })
+  }
+  scored.sort((left, right) => right.score - left.score || left.card.id.localeCompare(right.card.id))
+  return { hits: scored.slice(offset, offset + limit), total: scored.length }
+}
+
+/** One preflight result. */
+export interface PreflightResult {
+  ok: boolean
+  card?: CapabilityCard
+  admitted: boolean
+  schema?: { valid: boolean; violations: string[] }
+  requires: { approval: 'none' | 'ask'; sandbox: 'none' | 'write' | 'any' }
+  sideEffects: string[]
+  next: { callable: boolean; suggestion?: string }
+  error?: string
+  warnings: string[]
+}
+
+/**
+ * Check whether one capability can be called with the given arguments right
+ * now: existence/visibility, argument schema, predicted approval/sandbox and
+ * side effects. It never executes the target.
+ */
+export function preflightCapability(
+  snapshot: CapabilitySnapshot,
+  target: string,
+  args?: Record<string, unknown>,
+  sources?: CapabilitySources,
+  scope?: unknown,
+): PreflightResult {
+  const normalized = target.trim()
+  const card = snapshot.cards.find(entry => entry.id === normalized || entry.name === normalized || entry.id === `tool:${normalized}` || entry.id === `mcp:${normalized}` || entry.id === `skill:${normalized}`)
+  if (card === undefined) {
+    return { ok: false, admitted: false, requires: { approval: 'none', sandbox: 'none' }, sideEffects: [], next: { callable: false }, error: 'capability-not-found', warnings: [] }
+  }
+  const warnings = [...snapshot.warnings]
+  let visible = true
+  if (card.kind !== 'skill' && sources?.tools?.get !== undefined) {
+    try { visible = sources.tools.get(card.kind === 'mcp' ? card.name.replace('/', '__') : card.name, scope) !== undefined } catch { visible = true }
+  }
+  let schema: { valid: boolean; violations: string[] } | undefined
+  if (args !== undefined && card.input !== undefined) {
+    try {
+      const violations = validateJsonSchemaValue(card.input as unknown as Parameters<typeof validateJsonSchemaValue>[0], args)
+      schema = { valid: violations.length === 0, violations }
+    } catch (error) {
+      schema = { valid: false, violations: [error instanceof Error ? error.message : String(error)] }
+    }
+  }
+  const callable = visible && (schema?.valid ?? true)
+  const suggestion = callable
+    ? undefined
+    : !visible
+      ? 'capability is registered but not visible in this agent scope'
+      : schema?.valid === false
+        ? 'fix the arguments against the declared schema'
+        : 'capability is not callable from this scope'
+  return {
+    ok: true,
+    card: publicCard(card),
+    admitted: callable,
+    ...(schema === undefined ? {} : { schema }),
+    requires: card.permission,
+    sideEffects: card.risk.actions,
+    next: { callable, ...(suggestion === undefined ? {} : { suggestion }) },
+    warnings,
+  }
+}
+
+const CARD_SCHEMA = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    id: { type: 'string' }, kind: { type: 'string', enum: ['tool', 'mcp', 'skill'] },
+    name: { type: 'string' }, summary: { type: 'string' },
+    tags: { type: 'array', items: { type: 'string' } },
+    risk: { type: 'object', additionalProperties: false, properties: { level: { type: 'string' }, actions: { type: 'array', items: { type: 'string' } }, basis: { type: 'string' } } },
+    permission: { type: 'object', additionalProperties: false, properties: { approval: { type: 'string' }, sandbox: { type: 'string' } } },
+    state: { type: 'string' }, source: { type: 'string' },
+  },
+} as const
+
+/** Build `capability_search` and `capability_preflight` bound to the host registries. */
+export function makeCapabilityTools(sources: CapabilitySources) {
+  let cached: CapabilitySnapshot | undefined
+  const snapshotFor = async (scope?: unknown): Promise<CapabilitySnapshot> => {
+    if (cached === undefined || Date.now() - cached.builtAt > 60_000) cached = await buildCapabilitySnapshot(sources, scope)
+    return cached
+  }
+  const searchTool = defineTool({
+    name: 'capability_search',
+    description: [
+      'Find the tool, MCP action or skill that can do a job (dsh-locator capability adapter).',
+      '',
+      'Use it when the caller knows the goal but not which capability performs it: pass the intent in natural language and filter by kind/risk. Every hit carries risk and permission hints plus the card id usable with `capability_preflight`.',
+      '',
+      'This is not a file search: it indexes the live DSH capability registry (tool definitions and the skill catalog), not file names or bodies.',
+    ].join('\n'),
+    parameters: {
+      intent: { type: 'string', required: true, description: 'What should be done, in natural language (English or Chinese).' },
+      kinds: { type: 'array', items: { type: 'string', enum: ['tool', 'mcp', 'skill'] }, description: 'Restrict to these capability kinds.' },
+      riskMax: { type: 'string', enum: ['read', 'write', 'exec'], description: 'Only return capabilities at or below this risk level.' },
+      availableOnly: { type: 'boolean', description: 'Only return cards that are currently visible/available.' },
+      limit: { type: 'integer', description: 'Maximum hits (default 10, at most 50).' },
+      offset: { type: 'integer', description: 'Skip this many ranked hits.' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          intent: { type: 'string' }, total: { type: 'integer' }, returned: { type: 'integer' },
+          hits: { type: 'array', items: { type: 'object', additionalProperties: false, properties: { card: CARD_SCHEMA, score: { type: 'number' }, why: { type: 'array', items: { type: 'string' } } } } },
+          warnings: { type: 'array', items: { type: 'string' } }, error: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        const v = value as { ok: boolean; intent?: string; total?: number; hits?: Array<{ card: CapabilityCard; why: string[] }>; warnings?: string[]; error?: string }
+        if (!v.ok) return [{ type: 'text', text: `capability_search failed: ${v.error ?? 'unknown error'}` }]
+        const lines = [`capability_search ${JSON.stringify(v.intent ?? '')}: ${String(v.total ?? 0)} match(es)`]
+        for (const hit of v.hits ?? []) {
+          lines.push(`- ${hit.card.id} [${hit.card.kind}] risk=${hit.card.risk.level} approval=${hit.card.permission.approval} — ${hit.card.summary}`)
+        }
+        if ((v.warnings ?? []).length > 0) lines.push(`warnings: ${[...new Set(v.warnings ?? [])].join(', ')}`)
+        return [{ type: 'text', text: lines.join('\n') }]
+      },
+    },
+    async execute(args, exec) {
+      const snapshot = await snapshotFor(exec?.agent)
+      const kinds = Array.isArray(args.kinds) ? args.kinds.filter((kind): kind is CapabilityCard['kind'] => kind === 'tool' || kind === 'mcp' || kind === 'skill') : undefined
+      const riskMax = args.riskMax === 'read' || args.riskMax === 'write' || args.riskMax === 'exec' ? args.riskMax : undefined
+      const result = searchCapabilities(snapshot.cards, args.intent, { ...(kinds === undefined ? {} : { kinds }), ...(riskMax === undefined ? {} : { riskMax }), limit: Math.max(1, Math.min(50, args.limit ?? 10)), offset: Math.max(0, args.offset ?? 0), availableOnly: args.availableOnly === true })
+      const hits = result.hits.map(hit => ({ ...hit, card: publicCard(hit.card) }))
+      return { ok: true as const, intent: args.intent, total: result.total, returned: hits.length, hits, warnings: snapshot.warnings }
+    },
+  })
+  const preflightTool = defineTool({
+    name: 'capability_preflight',
+    description: [
+      'Check one capability before calling it (dsh-locator capability adapter): whether it exists and is visible, whether the arguments match its declared schema, and which approval/sandbox/side effects it implies.',
+      '',
+      'It never executes the target. Use it when a plan depends on a tool/MCP action/skill and the caller needs to know the cost or permission risk first.',
+    ].join('\n'),
+    parameters: {
+      capability: { type: 'string', required: true, description: 'Card id (`tool:<name>`, `mcp:<server>/<action>`, `skill:<name>`) or plain name from capability_search.' },
+      argsJson: { type: 'string', description: 'Candidate arguments as a JSON object string to validate against the declared schema.' },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          card: CARD_SCHEMA,
+          admitted: { type: 'boolean' },
+          schema: { type: 'object', additionalProperties: false, properties: { valid: { type: 'boolean' }, violations: { type: 'array', items: { type: 'string' } } } },
+          requires: { type: 'object', additionalProperties: false, properties: { approval: { type: 'string' }, sandbox: { type: 'string' } } },
+          sideEffects: { type: 'array', items: { type: 'string' } },
+          next: { type: 'object', additionalProperties: false, properties: { callable: { type: 'boolean' }, suggestion: { type: 'string' } } },
+          error: { type: 'string' }, warnings: { type: 'array', items: { type: 'string' } },
+        },
+      },
+      render: (_args, value) => {
+        const v = value as { ok: boolean; card?: CapabilityCard; admitted?: boolean; schema?: { valid: boolean; violations: string[] }; requires?: { approval: string; sandbox: string }; sideEffects?: string[]; next?: { callable: boolean; suggestion?: string }; error?: string; warnings?: string[] }
+        if (!v.ok) return [{ type: 'text', text: `capability_preflight failed: ${v.error ?? 'unknown error'}` }]
+        const lines = [
+          `capability_preflight ${v.card?.id ?? ''}: callable=${String(v.next?.callable ?? v.admitted ?? false)}`,
+          `  risk: ${v.card?.risk.level ?? '?'} · approval=${v.requires?.approval ?? '?'} · sandbox=${v.requires?.sandbox ?? '?'}`,
+          `  schema: ${v.schema === undefined ? 'not checked (no args/schema)' : v.schema.valid ? 'valid' : `invalid (${v.schema.violations.join('; ')})`}`,
+        ]
+        if ((v.sideEffects ?? []).length > 0) lines.push(`  side effects: ${(v.sideEffects ?? []).join('; ')}`)
+        if (v.next?.suggestion !== undefined) lines.push(`  suggestion: ${v.next.suggestion}`)
+        return [{ type: 'text', text: lines.join('\n') }]
+      },
+    },
+    async execute(args, exec) {
+      const snapshot = await snapshotFor(exec?.agent)
+      let candidate: Record<string, unknown> | undefined
+      if (typeof args.argsJson === 'string' && args.argsJson.trim() !== '') {
+        try {
+          const parsed: unknown = JSON.parse(args.argsJson)
+          if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return { ok: false as const, admitted: false, requires: { approval: 'none' as const, sandbox: 'none' as const }, sideEffects: [], next: { callable: false }, error: 'invalid-args-json', warnings: [] }
+          }
+          candidate = parsed as Record<string, unknown>
+        } catch {
+          return { ok: false as const, admitted: false, requires: { approval: 'none' as const, sandbox: 'none' as const }, sideEffects: [], next: { callable: false }, error: 'invalid-args-json', warnings: [] }
+        }
+      }
+      return preflightCapability(snapshot, args.capability, candidate, sources, exec?.agent)
+    },
+  })
+  return [searchTool, preflightTool] as const
+}
+
+/** ToolRunContext re-export keeps the module self-describing for tests. */
+export type { ToolRunContext }

package/src/index.ts

@@ -14,6 +14,7 @@ import { makeReindexTool } from './reindex.ts'
 import { registerHttp } from './http.ts'
 import { resolveBinary, resolveRoots, resolveStateDir } from './paths.ts'
 import { LocatorRuntime } from './runtime.ts'
+import { makeCapabilityTools, type CapabilitySources } from './capabilities.ts'
 import { makeCiteTool, makeResolveTool } from './ref-tools.ts'
 import { makeRebuildTool, makeSearchTool, makeStatusTool } from './tools.ts'
 
@@ -168,6 +169,14 @@ export function apply(ctx: Context, config: Config): void {
   ctx.tools.register(makeExportTool(rt))
   ctx.tools.register(makeResolveTool(rt, content))
   ctx.tools.register(makeCiteTool())
+  // Capability adapter: read the host's tool registry and skill catalog instead
+  // of duplicating discovery. Optional services stay optional.
+  const skillsService = (ctx as unknown as { get?: (name: string) => unknown }).get?.('skills')
+  const capabilitySources: CapabilitySources = {
+    tools: ctx.tools as unknown as CapabilitySources['tools'],
+    ...(skillsService === undefined ? {} : { skills: skillsService as CapabilitySources['skills'] }),
+  }
+  for (const tool of makeCapabilityTools(capabilitySources)) ctx.tools.register(tool)
   if (content !== undefined) {
     ctx.tools.register(makeFindTool(content, ensureContent, roots, config.allowCrossWorkspaceSessions))
     ctx.tools.register(makeReindexTool(content, ensureContent))