@daweifu/capability-menu 0.1.0 → 0.1.2

package/cordis.patch.yml

@@ -1,9 +1,11 @@
 # dsh-capability-menu aggregate bundle patch: mounts the meta plugins in one
 # layer, from a single installable package.
 #
-# One package, four plugin entries — each mounts a subpath of
+# One package, five plugin entries — four mount a subpath of
 # `@daweifu/capability-menu` (the loader resolves package subpath exports; see
-# `@deepseek-ai/dsh-web-app/startup` for the same pattern in the harness):
+# `@deepseek-ai/dsh-web-app/startup` for the same pattern in the harness), and
+# the root entry loads the package main to mount the browser-facing gateway
+# (and thereby registers the package itself as a `dsh.client` loader entry):
 #
 #   - id: capability-menu-registry
 #     name: '@daweifu/capability-menu/registry'
@@ -15,50 +17,49 @@
 #     name: '@daweifu/capability-menu/policy'
 #       config:
 #         tools:
-#           exposed:
+#           resident:
 #             - execute_cmd
 #             - get_session_context
 #             - search_kb
 #             - 'mcp__gongfeng__*'
-#           progressive:
+#           on-demand:
 #             - 'mcp__*'
 #             - 'server:km:*'
-#           blocked: []
+#           disabled: []
 #         skills:
-#           exposed:
+#           resident:
 #             - debugging
 #             - coding
 #         metaTools:
 #           - meta_search
 #           - meta_invoke
-#         progressiveSkillCatalog: ~/.dsh/progressive-skills.yaml
 #
 # - `capability-menu-registry` (P0): builds/indexes the capability catalog and
-#   exposes the `ctx.meta` service (search/get/getDetail/refresh). It registers
-#   no model-facing tool itself. Indexes the GLOBAL registry (no visibility
-#   filter) and additionally indexes Progressive skills from
-#   `progressiveSkillCatalog` (§7.2).
+#   exposes the `ctx.capability` service (search/get/getDetail/refresh). It registers
+#   no model-facing tool itself. Indexes every visible tool — MCP tools by their
+#   server and harness-native tools (bash/read/write/…) under the reserved
+#   `built-in` pseudo-server — plus skills from the global layer and every
+#   mountable preset's standing scope. The single on-demand catalog is emitted to
+#   `catalogFile` (default `~/.dsh/capability-catalog.yaml`) for grep/read.
 # - `capability-menu-search` (P1): registers the `meta_search` tool (list + detail).
 # - `capability-menu-invoke` (P2): registers the `meta_invoke` tool (unified
-#   execution of MCP tools and skill loading). Executes on the GLOBAL view
-#   (no agent) so Progressive tools stay runnable; dedups already-loaded skills.
-#   Rejects Blocked capabilities.
-# - `capability-menu-policy` (P3): Exposed/Progressive/Blocked projection
-#   strategy + 能力管理 surface. Reads explicit exposed/progressive/blocked
+#   execution of tools — MCP or native — and skill loading). Executes on the GLOBAL
+#   view (no agent) so On-demand tools stay runnable; dedups already-loaded skills.
+#   Rejects Disabled capabilities.
+# - `capability-menu-policy` (P3): Resident/On-demand/Disabled projection
+#   strategy + 能力管理 surface. Reads explicit resident/on-demand/disabled
 #   rules (exact name + glob + server:<name>:*) and filters `assembly.tools` at
-#   `system-prompt/assemble` to Exposed + meta tools only. The execution chain
-#   (`ctx.tools.execute`) is untouched, so Progressive tools remain executable
+#   `system-prompt/assemble` to Resident + meta tools only. The execution chain
+#   (`ctx.tools.execute`) is untouched, so On-demand capabilities remain executable
 #   via `meta_invoke`. Exposes `ctx.capabilityPolicy` with
-#   `classifyAll`/`getConfig`/`updateConfig` for the frontend 能力菜单 tab
-#   (Exposed/Progressive/Blocked rules + click-to-cycle classification +
+#   `classifyAll`/`getConfig`/`updateConfig` for the frontend 能力管理 tab
+#   (Resident/On-demand/Disabled rules + click-to-cycle classification +
 #   read-only list), plus skill file browsing (`getDetail`/`listSkillDir`/
 #   `readSkillFile`) via the Typert gateway.
 #
-# Default (policy present but no config): every capability is Exposed — the
-# `classify` fallback, nothing is hidden. Add explicit `progressive`/`blocked`
-# rules to pull capabilities out of the model surface. This bundle ships the
-# harness-native coding tools under `tools.exposed` so the model keeps direct
-# bash/file access.
+# Default (policy present but no config): every capability is Resident — the
+# `classify` fallback, nothing is hidden. Add explicit `on-demand`/`disabled`
+# rules to pull capabilities out of the model surface.
 - insert:
     - id: capability-menu-registry
       name: '@daweifu/capability-menu/registry'
@@ -69,15 +70,16 @@
     - id: capability-menu-policy
       name: '@daweifu/capability-menu/policy'
       config:
-        # Harness-native coding tools stay context-resident (Exposed) so the
-        # model can call them directly. meta_invoke only dispatches MCP `mcp__*`
-        # tools, so native tools (bash/read/write/edit/glob/grep) MUST stay
-        # Exposed — listing them Progressive/Blocked would make them neither
-        # visible nor invocable. The default (unlisted) class is Exposed; add
-        # explicit `progressive`/`blocked` rules to pull MCP servers and skills
-        # out of the model surface.
+        # Native coding tools are cataloged under the reserved `built-in`
+        # pseudo-server and are fully manageable like MCP tools. Unlisted
+        # capabilities default to Resident; list them under `on-demand`/
+        # `disabled` to pull MCP servers, native tools, or skills out of the
+        # model surface. On-demand native tools stay invocable through
+        # `meta_search` → `meta_invoke`. The `meta_search`/`meta_invoke`
+        # control-plane tools and the reserved `run_code` transport never enter
+        # the catalog. Do not name a real MCP server `built-in`.
         tools:
-          exposed:
+          resident:
             - bash
             - read
             - write
@@ -85,3 +87,9 @@
             - read_image
             - glob
             - grep
+    # Root entry: loads the package main, which mounts the Typert gateway that
+    # exposes ctx.capabilityPolicy to the browser. Makes this package a loader
+    # entry itself so @deepseek-ai/dsh-client-modules discovers its `dsh.client`
+    # declaration and serves the 能力管理 browser bundle (`./client`).
+    - id: capability-menu
+      name: '@daweifu/capability-menu'

package/lib/client.d.ts

@@ -0,0 +1,182 @@
+window.__ModuleLoader__.load({ id: "@daweifu/capability-menu", factory: (require) => {
+var module = { exports: {} };
+var exports = module.exports;
+
+import { ClientContext } from "@deepseek-ai/dsh-client-runtime/client";
+//#region src/client/store.d.ts
+/**
+ * ⚠️ VERIFIED AGAINST REAL rc.8 CLIENT API.
+ *
+ * Types + small helpers for the 能力管理 (Capability Management) settings
+ * section. The component reads/writes the Host `ctx.capabilityPolicy` through
+ * the generated `remote.capabilityPolicy` face (see `./remote.ts`), mirroring
+ * how `dsh-client-ui-settings-plugin-inventory` consumes
+ * `ctx.remote.pluginInventory`.
+ */
+/** One capability's Resident/On-demand/Disabled row, as surfaced by the server. */
+interface CapabilityRow {
+  readonly id: string;
+  readonly kind: 'tool' | 'skill';
+  readonly name: string;
+  /** Server namespace for tools (`built-in` groups harness-native tools); undefined for skills. */
+  readonly server?: string;
+  /** Skill source root label (`project-dsh`/`user-agents`/…), present only for skills. */
+  readonly source?: string;
+  readonly class: 'resident' | 'on-demand' | 'disabled';
+  /** Human-friendly display: `Resident · 常驻（直接调用）` / `On-demand · 按需（目录渐进加载）` / `Disabled · 禁用`. */
+  readonly classLabel?: string;
+  readonly mandatory: boolean;
+}
+/** Snapshot of the management surface. */
+interface CapabilitySnapshot {
+  readonly rows: readonly CapabilityRow[];
+}
+/** One direct child in a skill directory listing. */
+interface SkillFileEntry {
+  readonly name: string;
+  readonly type: 'file' | 'directory';
+}
+/** Full detail projection of one capability (schema, description, stats). */
+interface ToolDetail {
+  readonly id: string;
+  readonly kind: 'tool' | 'skill';
+  readonly actions: readonly string[];
+  readonly name: string;
+  readonly description: string;
+  readonly whenToUse?: string;
+  readonly parameters: Record<string, unknown>;
+  readonly output?: Record<string, unknown>;
+  readonly origin: {
+    readonly provider: string;
+    readonly serverName?: string;
+    readonly path?: string;
+    readonly source?: string;
+  };
+  readonly tags: readonly string[];
+  readonly stats: {
+    readonly uses: number;
+    readonly successes: number;
+    readonly failures: number;
+    readonly totalMs: number;
+    readonly lastUsedAt?: number;
+  };
+}
+/** 能力目录查看负载：两份只读「文件」+ 缺失原因。 */
+interface CatalogDocs {
+  /** 当前生效的三档策略配置 YAML。 */
+  readonly policyYaml: string;
+  /** 按需能力目录物化文件（path + content）。 */
+  readonly catalog?: {
+    readonly path: string;
+    readonly content: string;
+  };
+  /** catalog 不可用原因：'disabled' = 物化未启用；'read-failed' = 读盘失败。 */
+  readonly catalogMissing?: 'disabled' | 'read-failed';
+}
+/** The Host `capabilityPolicy` remote face (generated contribution). */
+interface CapabilityPolicyRemote {
+  getConfig(): Promise<{
+    ok: true;
+    value: Record<string, unknown>;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  updateConfig(partial: Record<string, unknown>): Promise<{
+    ok: true;
+    value: void;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  classifyAll(): Promise<{
+    ok: true;
+    value: CapabilityRow[];
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  listSkillDir(id: string, relPath?: string): Promise<{
+    ok: true;
+    value: SkillFileEntry[] | undefined;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  readSkillFile(id: string, relPath: string): Promise<{
+    ok: true;
+    value: string | undefined;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  getDetail(id: string): Promise<{
+    ok: true;
+    value: ToolDetail | undefined;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  getCatalogDocs(): Promise<{
+    ok: true;
+    value: CatalogDocs;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+}
+//#endregion
+//#region src/client/CapabilitySection.d.ts
+/** Props injected by the settings.section registration (see index.ts). */
+interface CapabilitySectionInjected {
+  remote: CapabilityPolicyRemote;
+  t(key: CapabilityKey, params?: Record<string, unknown>): string;
+  /** Diagnostic: `$mount` failure surfaced instead of crashing the section. */
+  mountError?: string;
+  /** Diagnostic: namespace methods actually installed on `ctx.remote.capabilityPolicy`. */
+  remoteKeys?: string;
+}
+type CapabilitySectionProps = CapabilitySectionInjected;
+type CapabilityKey = 'nav' | 'title' | 'desc' | 'resident' | 'on-demand' | 'disabled' | 'kind' | 'class' | 'tool' | 'skill' | 'mandatory' | 'rules' | 'toolsGroup' | 'skillsGroup' | 'builtInGroup' | 'globalSkills' | 'projectSkills' | 'emptyTools' | 'emptySkills' | 'emptyGlobalSkills' | 'emptyProjectSkills' | 'toolCount' | 'residentShort' | 'onDemandShort' | 'disabledShort' | 'cycleHint' | 'notPreviewable' | 'previewClose' | 'detailNotFound' | 'cycleOverridden' | 'viewCatalog' | 'catalogPolicy' | 'catalogOnDemand' | 'catalogPolicyNote' | 'catalogDisabled' | 'catalogUnreadable';
+//#endregion
+//#region src/client/index.d.ts
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** 能力管理 tab copy. */
+    'settings.capability': Record<CapabilityKey, string>;
+  }
+}
+/** Required services (cordis fiber inject). `remote.capabilityPolicy` is NOT
+ *  injected: we mount it in `apply`, so declaring it would deadlock the boot
+ *  ("waiting for service"). Access it via `ctx.get('remote.capabilityPolicy')`,
+ *  which resolves the mounted namespace service without the inject gate. */
+declare const inject: string[];
+/** Register the 能力管理 section once `settings.section` is on the ledger. */
+declare function apply(ctx: ClientContext): Promise<() => void>;
+//#endregion
+export { type CapabilityKey, type CapabilityPolicyRemote, type CapabilityRow, type CapabilitySectionInjected, type CapabilitySectionProps, type CapabilitySnapshot, apply, inject };
+
+return module.exports;
+}});
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client/store.ts","../src/client/CapabilitySection.tsx","../src/client/index.ts"],"mappings":";;;;;;;;;;;;;;;;UAWiB;WACN;WACA;WACA;;WAEA;;WAEA;WACA;;WAEA;WACA;;;UAIM;WACN,eAAe;;;UAIT;WACN;WACA;;;UAIM;WACN;WACA;WACA;WACA;WACA;WACA;WACA,YAAY;WACZ,SAAS;WACT;aAAmB;aAA2B;aAA8B;aAAwB;;WACpG;WACA;aACE;aACA;aACA;aACA;aACA;;;;UAKI;;WAEN;;WAEA;aAAqB;aAAuB;;;WAE5C;;;UAIM;EACf,aAAa;IAAU;IAAU,OAAO;;IAA8B;IAAW;MAAS;MAAc;;;EACxG,aAAa,SAAS,0BAA0B;IAAU;IAAU;;IAAkB;IAAW;MAAS;MAAc;;;EACxH,eAAe;IAAU;IAAU,OAAO;;IAAsB;IAAW;MAAS;MAAc;;;EAClG,aAAa,YAAY,mBAAmB;IAAU;IAAU,OAAO;;IAAmC;IAAW;MAAS;MAAc;;;EAC5I,cAAc,YAAY,kBAAkB;IAAU;IAAU;;IAAgC;IAAW;MAAS;MAAc;;;EAClI,UAAU,aAAa;IAAU;IAAU,OAAO;;IAA6B;IAAW;MAAS;MAAc;;;EACjH,kBAAkB;IAAU;IAAU,OAAO;;IAAkB;IAAW;MAAS;MAAc;;;;;;;UChDlF;EACf,QAAQ;EACR,EAAE,KAAK,eAAe,SAAS;;EAE/B;;EAEA;;KAGU,yBAAyB;KAEzB;;;;YCdA;;IAER,uBAAuB,OAAO;;;;;;;cAQrB;;iBAGS,MAAM,KAAK,gBAAgB"}