@daweifu/capability-menu 0.1.1 → 0.1.3

package/lib/client.d.ts

@@ -3,30 +3,33 @@ 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 Menu) 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 Exposed/Progressive/Blocked row, as surfaced by the server. */
+import { RemoteResult } from "@deepseek-ai/dsh-typert-protocol";
+//#region src/client/remote.d.ts
+/** Read-only row: one capability's Resident/On-demand/Disabled classification. */
 interface CapabilityRow {
   readonly id: string;
   readonly kind: 'tool' | 'skill';
   readonly name: string;
   readonly server?: string;
-  readonly class: 'exposed' | 'progressive' | 'blocked';
-  /** Human-friendly display: `Exposed · 常驻（直接调用）` / `Progressive · 按需（目录渐进加载）` / `Blocked · 禁用`. */
+  /** Skill source root label (`project-dsh`/`user-agents`/…), present only for skills. */
+  readonly source?: string;
+  /** The skill's own directory on disk, present only for skills whose provider has one. */
+  readonly path?: string;
+  readonly class: 'resident' | 'on-demand' | 'disabled';
   readonly classLabel?: string;
   readonly mandatory: boolean;
 }
-/** Snapshot of the management surface. */
-interface CapabilitySnapshot {
-  readonly rows: readonly CapabilityRow[];
+/** 能力目录查看负载：两份只读「文件」+ 缺失原因。 */
+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';
 }
 /** One direct child in a skill directory listing. */
 interface SkillFileEntry {
@@ -47,6 +50,7 @@ interface ToolDetail {
     readonly provider: string;
     readonly serverName?: string;
     readonly path?: string;
+    readonly source?: string;
   };
   readonly tags: readonly string[];
   readonly stats: {
@@ -57,6 +61,99 @@ interface ToolDetail {
     readonly lastUsedAt?: number;
   };
 }
+/** One MCP server declared in the patch file. */
+interface McpLocation {
+  readonly id: string;
+  readonly serverName: string;
+  readonly transport: 'stdio' | 'streamable-http';
+  readonly disabled: boolean;
+  readonly command?: string;
+  readonly args?: readonly string[];
+  readonly env?: Readonly<Record<string, string>>;
+  readonly cwd?: string;
+  readonly url?: string;
+  readonly headers?: Readonly<Record<string, string>>;
+  readonly toolCallTimeoutMs?: number;
+}
+/** One skill entry under a managed skill root (the user root or a project's). */
+interface SkillLocation {
+  /** The entry's own name under `entryDir`; what update and remove address. */
+  readonly name: string;
+  /** The name the skill declares in its `SKILL.md` — dsh's identity for it, and what a capability row is named. */
+  readonly skillName?: string;
+  readonly path: string;
+  readonly linked: boolean;
+  readonly valid: boolean;
+  /** `user` for the default root, `project` for a project's own skill root. */
+  readonly root: 'user' | 'project';
+  /** The skills directory holding the entry; pass it back to update or remove. */
+  readonly entryDir: string;
+  /** The directory the entry points at, with symlinks resolved. */
+  readonly target?: string;
+}
+/** Input for registering a new MCP server. */
+interface McpInput {
+  readonly serverName: string;
+  readonly transport: 'stdio' | 'streamable-http';
+  readonly command?: string;
+  readonly args?: readonly string[];
+  readonly env?: Readonly<Record<string, string>>;
+  readonly cwd?: string;
+  readonly url?: string;
+  readonly headers?: Readonly<Record<string, string>>;
+  readonly toolCallTimeoutMs?: number;
+}
+/** Input for editing a declared server (`serverName` is immutable). */
+type McpUpdateInput = Omit<McpInput, 'serverName'>;
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface TypertRemoteNamespace$6361706162696c697479506f6c696379 {
+    getConfig: () => Promise<RemoteResult<Record<string, unknown>>>;
+    updateConfig: (partial: Record<string, unknown>) => Promise<RemoteResult<void>>;
+    classifyAll: () => Promise<RemoteResult<CapabilityRow[]>>;
+    refresh: () => Promise<RemoteResult<void>>;
+    listSkillDir: (id: string, relPath?: string) => Promise<RemoteResult<SkillFileEntry[] | undefined>>;
+    readSkillFile: (id: string, relPath: string) => Promise<RemoteResult<string | undefined>>;
+    getDetail: (id: string) => Promise<RemoteResult<ToolDetail | undefined>>;
+    getCatalogDocs: () => Promise<RemoteResult<CatalogDocs>>;
+    listLocations: () => Promise<RemoteResult<McpLocation[]>>;
+    addLocation: (input: McpInput) => Promise<RemoteResult<string>>;
+    removeLocation: (id: string) => Promise<RemoteResult<boolean>>;
+    updateLocation: (id: string, input: McpUpdateInput) => Promise<RemoteResult<boolean>>;
+    listSkillLocations: () => Promise<RemoteResult<SkillLocation[]>>;
+    addSkillLocation: (dir: string, projectPath?: string) => Promise<RemoteResult<string>>;
+    removeSkillLocation: (name: string, entryDir?: string) => Promise<RemoteResult<boolean>>;
+    adoptSkillLocation: (name: string) => Promise<RemoteResult<string>>;
+    updateSkillLocation: (name: string, dir: string, entryDir?: string) => Promise<RemoteResult<boolean>>;
+  }
+  interface TypertRemoteMap {
+    'capabilityPolicy/getConfig': () => Promise<RemoteResult<Record<string, unknown>>>;
+    'capabilityPolicy/updateConfig': (partial: Record<string, unknown>) => Promise<RemoteResult<void>>;
+    'capabilityPolicy/classifyAll': () => Promise<RemoteResult<CapabilityRow[]>>;
+    'capabilityPolicy/refresh': () => Promise<RemoteResult<void>>;
+    'capabilityPolicy/listSkillDir': (id: string, relPath?: string) => Promise<RemoteResult<SkillFileEntry[] | undefined>>;
+    'capabilityPolicy/readSkillFile': (id: string, relPath: string) => Promise<RemoteResult<string | undefined>>;
+    'capabilityPolicy/getDetail': (id: string) => Promise<RemoteResult<ToolDetail | undefined>>;
+    'capabilityPolicy/getCatalogDocs': () => Promise<RemoteResult<CatalogDocs>>;
+    'capabilityPolicy/listLocations': () => Promise<RemoteResult<McpLocation[]>>;
+    'capabilityPolicy/addLocation': (input: McpInput) => Promise<RemoteResult<string>>;
+    'capabilityPolicy/removeLocation': (id: string) => Promise<RemoteResult<boolean>>;
+    'capabilityPolicy/updateLocation': (id: string, input: McpUpdateInput) => Promise<RemoteResult<boolean>>;
+    'capabilityPolicy/listSkillLocations': () => Promise<RemoteResult<SkillLocation[]>>;
+    'capabilityPolicy/addSkillLocation': (dir: string, projectPath?: string) => Promise<RemoteResult<string>>;
+    'capabilityPolicy/removeSkillLocation': (name: string, entryDir?: string) => Promise<RemoteResult<boolean>>;
+    'capabilityPolicy/adoptSkillLocation': (name: string) => Promise<RemoteResult<string>>;
+    'capabilityPolicy/updateSkillLocation': (name: string, dir: string, entryDir?: string) => Promise<RemoteResult<boolean>>;
+  }
+  interface TypertRemoteNamespaceMap {
+    'capabilityPolicy': TypertRemoteNamespace$6361706162696c697479506f6c696379;
+  }
+}
+//#endregion
+//#region src/client/store.d.ts
+/** Snapshot of the management surface. */
+interface CapabilitySnapshot {
+  readonly rows: readonly CapabilityRow[];
+}
 /** The Host `capabilityPolicy` remote face (generated contribution). */
 interface CapabilityPolicyRemote {
   getConfig(): Promise<{
@@ -89,6 +186,16 @@ interface CapabilityPolicyRemote {
       message: string;
     };
   }>;
+  refresh(): Promise<{
+    ok: true;
+    value: void;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
   listSkillDir(id: string, relPath?: string): Promise<{
     ok: true;
     value: SkillFileEntry[] | undefined;
@@ -119,6 +226,106 @@ interface CapabilityPolicyRemote {
       message: string;
     };
   }>;
+  getCatalogDocs(): Promise<{
+    ok: true;
+    value: CatalogDocs;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  listLocations(): Promise<{
+    ok: true;
+    value: McpLocation[];
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  addLocation(input: McpInput): Promise<{
+    ok: true;
+    value: string;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  removeLocation(id: string): Promise<{
+    ok: true;
+    value: boolean;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  updateLocation(id: string, input: McpUpdateInput): Promise<{
+    ok: true;
+    value: boolean;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  listSkillLocations(): Promise<{
+    ok: true;
+    value: SkillLocation[];
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  addSkillLocation(dir: string, projectPath?: string): Promise<{
+    ok: true;
+    value: string;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  removeSkillLocation(name: string, entryDir?: string): Promise<{
+    ok: true;
+    value: boolean;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  adoptSkillLocation(name: string): Promise<{
+    ok: true;
+    value: string;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
+  updateSkillLocation(name: string, dir: string, entryDir?: string): Promise<{
+    ok: true;
+    value: boolean;
+  } | {
+    ok: false;
+    error: {
+      code: string;
+      message: string;
+    };
+  }>;
 }
 //#endregion
 //#region src/client/CapabilitySection.d.ts
@@ -128,11 +335,9 @@ interface CapabilitySectionInjected {
   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' | 'exposed' | 'progressive' | 'blocked' | 'kind' | 'class' | 'tool' | 'skill' | 'mandatory' | 'rules' | 'toolsGroup' | 'skillsGroup' | 'emptyTools' | 'emptySkills' | 'toolCount' | 'exposedShort' | 'progressiveShort' | 'blockedShort' | 'cycleHint' | 'notPreviewable' | 'previewClose' | 'detailNotFound';
+type CapabilityKey = 'nav' | 'title' | 'desc' | 'resident' | 'on-demand' | 'disabled' | 'tool' | 'skill' | 'mandatory' | 'toolsGroup' | 'skillsGroup' | 'builtInGroup' | 'globalSkills' | 'projectSkills' | 'emptyTools' | 'emptySkills' | 'emptyGlobalSkills' | 'emptyProjectSkills' | 'toolCount' | 'residentShort' | 'onDemandShort' | 'disabledShort' | 'cycleHint' | 'notPreviewable' | 'previewClose' | 'detailNotFound' | 'cycleOverridden' | 'refresh' | 'refreshing' | 'refreshFailed' | 'retry' | 'carrierFailureHint' | 'registerCapability' | 'editMcp' | 'editSkillNamed' | 'edit' | 'save' | 'remove' | 'cancel' | 'confirmRemove' | 'confirmRemoveMcp' | 'confirmRemoveSkillLink' | 'confirmRemoveSkillDir' | 'confirmSaveAnyway' | 'saveConfirmRealDir' | 'register' | 'notEditable' | 'entryNotFound' | 'mcpServers' | 'skillDirs' | 'skillDirPath' | 'skillDirHint' | 'skillRoot' | 'skillRootUser' | 'skillRootProject' | 'skillRootHintUser' | 'skillRootHintProject' | 'skillProjectPath' | 'skillProjectPathHint' | 'skillRegisteredAt' | 'skillRepointed' | 'skillAdopted' | 'skillSource' | 'skillSourceHint' | 'skillUnmanaged' | 'adoptSkill' | 'adoptSkillHint' | 'adoptSkillTitle' | 'sourceCustom' | 'sourceBundled' | 'serverName' | 'serverNameImmutable' | 'transport' | 'transportStdio' | 'transportHttp' | 'transportHintStdio' | 'transportHintHttp' | 'command' | 'args' | 'cwd' | 'env' | 'url' | 'headers' | 'headersHint' | 'timeout' | 'timeoutInvalid' | 'viewCatalog' | 'catalogPolicy' | 'catalogOnDemand' | 'catalogPolicyNote' | 'catalogDisabled' | 'catalogUnreadable';
 //#endregion
 //#region src/client/index.d.ts
 declare module '@deepseek-ai/dsh-client-ui-slots' {

package/lib/client.d.ts.map

@@ -1 +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;WACA;WACA;;WAEA;WACA;;;UAIM;WACN,eAAe;;;UAIT;WACN;WACA;;;UAIM;WACN;WACA;WACA;WACA;WACA;WACA;WACA,YAAY;WACZ,SAAS;WACT;aAAmB;aAA2B;aAA8B;;WAC5E;WACA;aACE;aACA;aACA;aACA;aACA;;;;UAKI;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;;;;;;;UCtClG;EACf,QAAQ;EACR,EAAE,KAAK,eAAe,SAAS;;EAE/B;;EAEA;;KAGU,yBAAyB;KAEzB;;;;YCVA;;IAER,uBAAuB,OAAO;;;;;;;cAQrB;;iBAGS,MAAM,KAAK,gBAAgB"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client/remote.ts","../src/client/store.ts","../src/client/CapabilitySection.tsx","../src/client/index.ts"],"mappings":"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"}