dsh-skill-hub 0.3.6 → 0.3.8

package/lib/types/client/panel/hooks/useMarketFlow.d.ts

@@ -0,0 +1,73 @@
+/**
+ * useMarketFlow — 市场域：市场源增删、仓库扫描、分支/版本选择、导入任务
+ * （轮询+取消）、更新检查、星标统计、版本同步、全部更新。目录/分组/来源
+ * 的刷新与来源检查经聚合根传入，不直接碰其他域的 state。
+ */
+import type { RepoImportProgressResponse, SourceCheckResult } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import type { FlowNotices, MarketState, RepoDiscoverState } from './shared.ts';
+import type { BranchChoiceState, MarketSyncDialogState, VersionChoiceState } from '../dialogs.tsx';
+export declare function useMarketFlow(api: SkillHubApi, shared: FlowNotices, 
+/** 目录重载（导入/同步后刷新列表，目录域提供）。 */
+reloadCatalog: () => Promise<void>, 
+/** 分组重载（导入后刷新，分组域提供）。 */
+reloadGroups: () => Promise<void>, 
+/** 来源重载（导入/同步后刷新，来源域提供）。 */
+reloadSources: () => Promise<void>, 
+/** 来源更新检查（全部更新后重查，来源域提供）。 */
+checkSources: (repo?: string) => Promise<void>, 
+/** 各来源的上游检查结果（全部更新遍历它，来源域提供）。 */
+sourceCheck: Readonly<Record<string, SourceCheckResult>>): {
+    marketState: MarketState;
+    marketCheck: Readonly<Record<string, {
+        repo: string;
+        ref?: string;
+        latestTag?: string;
+        updateAvailable: boolean;
+        commitSha: string;
+        throttled?: boolean;
+        error?: string;
+    }>>;
+    branchChoice: BranchChoiceState | null;
+    branchBusy: boolean;
+    marketSyncDialog: MarketSyncDialogState | null;
+    syncingMarket: string | null;
+    syncBusy: boolean;
+    newSourceName: string;
+    repoDiscoverState: RepoDiscoverState;
+    scanningRepo: string | null;
+    repoSelected: ReadonlySet<string>;
+    repoImporting: boolean;
+    repoResult: RepoImportProgressResponse | null;
+    importJobId: string | null;
+    marketStats: Readonly<Record<string, {
+        stars: number;
+        downloads: number;
+    }>>;
+    versionDialog: VersionChoiceState | null;
+    versionBusy: boolean;
+    updateAllDialog: boolean;
+    setBranchChoice: import("react").Dispatch<import("react").SetStateAction<BranchChoiceState | null>>;
+    setMarketSyncDialog: import("react").Dispatch<import("react").SetStateAction<MarketSyncDialogState | null>>;
+    setNewSourceName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setRepoSelected: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
+    setUpdateAllDialog: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setVersionDialog: import("react").Dispatch<import("react").SetStateAction<VersionChoiceState | null>>;
+    loadMarket: () => Promise<void>;
+    addSource: (input: string) => Promise<void>;
+    addMarketSource: () => Promise<void>;
+    removeMarketSource: (repo: string) => Promise<void>;
+    scanRepo: (input: string) => Promise<void>;
+    confirmBranchChoice: () => Promise<void>;
+    openVersionDialog: (repo: string) => Promise<void>;
+    confirmVersionDialog: () => Promise<void>;
+    toggleRepoSelected: (path: string, checked: boolean) => void;
+    importRepo: () => Promise<void>;
+    cancelImport: () => Promise<void>;
+    clearScan: () => void;
+    checkMarket: () => Promise<void>;
+    loadMarketStats: () => Promise<void>;
+    syncMarketSource: (repo: string) => Promise<void>;
+    confirmMarketSync: () => Promise<void>;
+    updateAll: () => Promise<void>;
+};

package/lib/types/client/panel/hooks/useMetaFlow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * useMetaFlow — 自身更新检查 + 调用统计 + 配置：只依赖 api，
+ * 不碰其他域。补捞 effect 自包含（uses.size + loadUses）。
+ */
+import type { HubConfig } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import { type UpdateState } from './shared.ts';
+export declare function useMetaFlow(api: SkillHubApi): {
+    updateState: UpdateState;
+    checkUpdate: () => Promise<void>;
+    uses: ReadonlyMap<string, {
+        count: number;
+        lastUsed?: number;
+    }>;
+    loadUses: () => Promise<void>;
+    hubConfig: HubConfig | null;
+    loadConfig: () => Promise<void>;
+};

package/lib/types/client/panel/hooks/useSourceFlow.d.ts

@@ -0,0 +1,44 @@
+/**
+ * useSourceFlow — 来源域：来源列表/更新检查/同步确认/跟进删除/回收站恢复/
+ * 清空回收站，以及单个技能/整组的删除确认流。目录与分组的刷新经聚合根
+ * 传入的 reload 回调，不直接碰其他域的 state。
+ */
+import type { SourceCheckResult, SourcesResponse } from '../../../protocol.ts';
+import type { SkillHubApi } from '../../api.ts';
+import type { FlowNotices } from './shared.ts';
+import type { ConfirmDialogState } from '../dialogs.tsx';
+export declare function useSourceFlow(api: SkillHubApi, shared: FlowNotices, 
+/** 目录重载（技能增删后刷新列表，目录域提供）。 */
+reloadCatalog: () => Promise<void>, 
+/** 分组重载（来源/成员变化后刷新，分组域提供）。 */
+reloadGroups: () => Promise<void>): {
+    sourcesState: SourcesResponse | null;
+    sourceCheck: Readonly<Record<string, SourceCheckResult>>;
+    checkingSource: string | null;
+    syncingSource: string | null;
+    confirmDialog: ConfirmDialogState | null;
+    deleteSkillDialog: string | null;
+    deleteGroupDialog: {
+        name: string;
+        skillNames: string[];
+    } | null;
+    confirmClearTrash: boolean;
+    setConfirmDialog: import("react").Dispatch<import("react").SetStateAction<ConfirmDialogState | null>>;
+    setDeleteSkillDialog: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setDeleteGroupDialog: import("react").Dispatch<import("react").SetStateAction<{
+        name: string;
+        skillNames: string[];
+    } | null>>;
+    setConfirmClearTrash: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    loadSources: () => Promise<void>;
+    checkSources: (repo?: string) => Promise<void>;
+    requestSync: (repo: string, skills: string[]) => void;
+    requestDelete: (repo: string, skills: string[]) => void;
+    runConfirmed: () => Promise<void>;
+    restoreTrash: (name: string) => Promise<void>;
+    clearTrash: () => Promise<void>;
+    requestDeleteSkill: (name: string) => void;
+    runDeleteSkill: () => Promise<void>;
+    requestDeleteGroup: (name: string, skillNames: string[]) => void;
+    runDeleteGroup: () => Promise<void>;
+};

package/lib/types/client/panel/market-format.d.ts

@@ -0,0 +1,6 @@
+/** Market tab number formatting (stars/downloads/bytes/speed). Pure, no deps. */
+/** Compact count for stars/downloads (1234 → 1.2k). */
+export declare function formatCount(n: number): string;
+/** Compact byte size for repo preview rows. */
+export declare function formatBytes(bytes: number): string;
+export declare function formatSpeed(bps?: number): string;

package/lib/types/client/panel/useSkillHub.d.ts

@@ -1,68 +1,36 @@
 /**
- * useSkillHub — the panel's state owner. Everything the skill hub panel
- * knows (catalog, groups, sources, market, dialogs, drafts) plus every
- * async flow lives here; the panel itself only renders. All hooks run
- * unconditionally at the top, so the panel may early-return for the detail
- * and tag-editor views without violating the rules of hooks.
+ * useSkillHub — 面板的状态聚合根：只持有跨域共享的通知状态与纯视图状态，
+ * 各域状态与动作分散在 ./hooks/*，这里按依赖顺序组装（meta → 目录 →
+ * 分组 → 来源 → 市场），轮询与派生组装在此。返回形状与拆分前完全一致，
+ * 所有视图无需改动。All hooks run unconditionally at the top, so the panel
+ * may early-return for the detail and tag-editor views without violating
+ * the rules of hooks.
  */
-import { type FormEvent } from 'react';
-import type { CatalogResponse, CatalogSkill, DisabledSkill, GroupsResponse, HubConfig, MarketSourceRecord, RepoDiscoverResponse, RepoImportProgressResponse, SkillDetail, SkillTag, SourceCheckResult, SourcesResponse, UpdateCheckResponse, WritableRoot } from '../../protocol.ts';
 import type { SkillHubApi } from '../api.ts';
-import { type SortKey, type GroupSwitchState } from '../grouping.ts';
-import type { BranchChoiceState, ConfirmDialogState, ConflictDialogState, MarketSyncDialogState } from './dialogs.tsx';
-/** One-shot self-update check state. */
-type UpdateState = {
-    status: 'idle';
-} | {
-    status: 'checking';
-} | {
-    status: 'ready';
-    data: UpdateCheckResponse;
-} | {
-    status: 'error';
-    message: string;
-};
-/** Repo scanner/import state (drives the market source preview). */
-type RepoDiscoverState = {
-    status: 'idle';
-} | {
-    status: 'scanning';
-} | {
-    status: 'ready';
-    data: RepoDiscoverResponse;
-} | {
-    status: 'error';
-    message: string;
-};
-/** Market sources list state. */
-type MarketState = {
-    status: 'loading' | 'ready' | 'error';
-    repos: MarketSourceRecord[];
-};
 /** The hook's result: the panel's complete state + action surface. */
 export type SkillHubState = ReturnType<typeof useSkillHub>;
 export declare function useSkillHub(api: SkillHubApi): {
-    catalog: CatalogResponse | null;
+    catalog: import("../../protocol.ts").CatalogResponse | null;
     loading: boolean;
     loadError: string | null;
     successBanner: string | null;
-    updateState: UpdateState;
-    repoDiscoverState: RepoDiscoverState;
+    updateState: import("./hooks/shared.ts").UpdateState;
+    repoDiscoverState: import("./hooks/shared.ts").RepoDiscoverState;
     scanningRepo: string | null;
     repoSelected: ReadonlySet<string>;
     repoImporting: boolean;
-    repoResult: RepoImportProgressResponse | null;
+    repoResult: import("../../protocol.ts").RepoImportProgressResponse | null;
     importJobId: string | null;
     search: string;
     workspace: string;
-    detail: SkillDetail | null;
+    detail: import("../../protocol.ts").SkillDetail | null;
     detailLoading: boolean;
     busyNames: ReadonlySet<string>;
     batchBusy: boolean;
     showForm: boolean;
     formName: string;
     formDesc: string;
-    formRoot: WritableRoot;
+    formRoot: import("../../protocol.ts").WritableRoot;
     formBusy: boolean;
     formMessage: {
         kind: "error" | "success";
@@ -72,12 +40,13 @@ export declare function useSkillHub(api: SkillHubApi): {
         count: number;
         lastUsed?: number;
     }>;
-    hubConfig: HubConfig | null;
+    hubConfig: import("../../protocol.ts").HubConfig | null;
     tab: "sources" | "scenes" | "market";
     skillView: "flat" | "groups";
     sourceFilter: string;
-    sortKey: SortKey;
-    marketState: MarketState;
+    invocationFilter: "user" | "model" | "all";
+    sortKey: import("../grouping.ts").SortKey;
+    marketState: import("./hooks/shared.ts").MarketState;
     marketCheck: Readonly<Record<string, {
         repo: string;
         ref?: string;
@@ -87,19 +56,23 @@ export declare function useSkillHub(api: SkillHubApi): {
         throttled?: boolean;
         error?: string;
     }>>;
-    branchChoice: BranchChoiceState | null;
+    marketStats: Readonly<Record<string, {
+        stars: number;
+        downloads: number;
+    }>>;
+    branchChoice: import("./dialogs.tsx").BranchChoiceState | null;
     branchBusy: boolean;
-    marketSyncDialog: MarketSyncDialogState | null;
+    marketSyncDialog: import("./dialogs.tsx").MarketSyncDialogState | null;
     syncingMarket: string | null;
     syncBusy: boolean;
     newSourceName: string;
-    groupsState: GroupsResponse | null;
-    sourcesState: SourcesResponse | null;
-    sourceCheck: Readonly<Record<string, SourceCheckResult>>;
+    groupsState: import("../../protocol.ts").GroupsResponse | null;
+    sourcesState: import("../../protocol.ts").SourcesResponse | null;
+    sourceCheck: Readonly<Record<string, import("../../protocol.ts").SourceCheckResult>>;
     checkingSource: string | null;
     syncingSource: string | null;
-    conflictDialog: ConflictDialogState | null;
-    confirmDialog: ConfirmDialogState | null;
+    conflictDialog: import("./dialogs.tsx").ConflictDialogState | null;
+    confirmDialog: import("./dialogs.tsx").ConfirmDialogState | null;
     deleteSkillDialog: string | null;
     deleteGroupDialog: {
         name: string;
@@ -107,7 +80,7 @@ export declare function useSkillHub(api: SkillHubApi): {
     } | null;
     confirmClearTrash: boolean;
     updateAllDialog: boolean;
-    editingTag: SkillTag | null;
+    editingTag: import("../../protocol.ts").SkillTag | null;
     editName: string;
     membersDraft: ReadonlySet<string>;
     newTagName: string;
@@ -117,22 +90,25 @@ export declare function useSkillHub(api: SkillHubApi): {
     subdividedProjects: ReadonlySet<string>;
     showLegend: boolean;
     editMode: boolean;
+    versionDialog: import("./dialogs.tsx").VersionChoiceState | null;
+    versionBusy: boolean;
     actionNames: Set<string>;
     viewNames: Set<string>;
     normalized: string;
     origins: Record<string, string>;
     sourceOptions: string[];
-    filtered: CatalogSkill[];
-    sorted: CatalogSkill[];
+    filtered: import("../../protocol.ts").CatalogSkill[];
+    sorted: import("../../protocol.ts").CatalogSkill[];
+    shortenedCount: number;
     setLoadError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     setSuccessBanner: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     setSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
     setWorkspace: import("react").Dispatch<import("react").SetStateAction<string>>;
-    setDetail: import("react").Dispatch<import("react").SetStateAction<SkillDetail | null>>;
+    setDetail: import("react").Dispatch<import("react").SetStateAction<import("../../protocol.ts").SkillDetail | null>>;
     setShowForm: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setFormName: import("react").Dispatch<import("react").SetStateAction<string>>;
     setFormDesc: import("react").Dispatch<import("react").SetStateAction<string>>;
-    setFormRoot: import("react").Dispatch<import("react").SetStateAction<WritableRoot>>;
+    setFormRoot: import("react").Dispatch<import("react").SetStateAction<import("../../protocol.ts").WritableRoot>>;
     setFormMessage: import("react").Dispatch<import("react").SetStateAction<{
         kind: "error" | "success";
         text: string;
@@ -141,12 +117,13 @@ export declare function useSkillHub(api: SkillHubApi): {
     setTab: import("react").Dispatch<import("react").SetStateAction<"sources" | "scenes" | "market">>;
     setSkillView: import("react").Dispatch<import("react").SetStateAction<"flat" | "groups">>;
     setSourceFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
-    setSortKey: import("react").Dispatch<import("react").SetStateAction<SortKey>>;
-    setBranchChoice: import("react").Dispatch<import("react").SetStateAction<BranchChoiceState | null>>;
-    setMarketSyncDialog: import("react").Dispatch<import("react").SetStateAction<MarketSyncDialogState | null>>;
+    setInvocationFilter: import("react").Dispatch<import("react").SetStateAction<"user" | "model" | "all">>;
+    setSortKey: import("react").Dispatch<import("react").SetStateAction<import("../grouping.ts").SortKey>>;
+    setBranchChoice: import("react").Dispatch<import("react").SetStateAction<import("./dialogs.tsx").BranchChoiceState | null>>;
+    setMarketSyncDialog: import("react").Dispatch<import("react").SetStateAction<import("./dialogs.tsx").MarketSyncDialogState | null>>;
     setNewSourceName: import("react").Dispatch<import("react").SetStateAction<string>>;
-    setConflictDialog: import("react").Dispatch<import("react").SetStateAction<ConflictDialogState | null>>;
-    setConfirmDialog: import("react").Dispatch<import("react").SetStateAction<ConfirmDialogState | null>>;
+    setConflictDialog: import("react").Dispatch<import("react").SetStateAction<import("./dialogs.tsx").ConflictDialogState | null>>;
+    setConfirmDialog: import("react").Dispatch<import("react").SetStateAction<import("./dialogs.tsx").ConfirmDialogState | null>>;
     setDeleteSkillDialog: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     setDeleteGroupDialog: import("react").Dispatch<import("react").SetStateAction<{
         name: string;
@@ -154,22 +131,23 @@ export declare function useSkillHub(api: SkillHubApi): {
     } | null>>;
     setConfirmClearTrash: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setUpdateAllDialog: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    setEditingTag: import("react").Dispatch<import("react").SetStateAction<SkillTag | null>>;
+    setEditingTag: import("react").Dispatch<import("react").SetStateAction<import("../../protocol.ts").SkillTag | null>>;
     setEditName: import("react").Dispatch<import("react").SetStateAction<string>>;
     setMembersDraft: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
     setNewTagName: import("react").Dispatch<import("react").SetStateAction<string>>;
     setEditSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
     setShowLegend: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     setEditMode: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setVersionDialog: import("react").Dispatch<import("react").SetStateAction<import("./dialogs.tsx").VersionChoiceState | null>>;
     toggleGroupCollapse: (key: string) => void;
     toggleSubdivide: (key: string) => void;
     checkUpdate: () => Promise<void>;
     loadMarket: () => Promise<void>;
     openDetail: (name: string) => Promise<void>;
-    toggle: (skill: CatalogSkill, enabled: boolean) => Promise<void>;
-    enableDisabled: (record: DisabledSkill) => Promise<void>;
+    toggle: (skill: import("../../protocol.ts").CatalogSkill, enabled: boolean) => Promise<void>;
+    enableDisabled: (record: import("../../protocol.ts").DisabledSkill) => Promise<void>;
     batchToggleNames: (names: string[], enabled: boolean) => Promise<void>;
-    toggleGroup: (key: string, name: string, view: GroupSwitchState) => void;
+    toggleGroup: (key: string, name: string, view: import("../grouping.ts").GroupSwitchState) => void;
     resolveConflict: (closeAll: boolean) => Promise<void>;
     runConfirmed: () => Promise<void>;
     checkSources: (repo?: string) => Promise<void>;
@@ -177,11 +155,16 @@ export declare function useSkillHub(api: SkillHubApi): {
     requestDelete: (repo: string, skills: string[]) => void;
     restoreTrash: (name: string) => Promise<void>;
     clearTrash: () => Promise<void>;
+    fixingPaths: ReadonlySet<string>;
+    fixDiagnostic: (path: string) => Promise<void>;
+    clearListFilters: () => void;
+    openVersionDialog: (repo: string) => Promise<void>;
+    confirmVersionDialog: () => Promise<void>;
     requestDeleteSkill: (name: string) => void;
     runDeleteSkill: () => Promise<void>;
     requestDeleteGroup: (name: string, skillNames: string[]) => void;
     runDeleteGroup: () => Promise<void>;
-    createTag: (event: FormEvent) => Promise<void>;
+    createTag: (event: import("react").FormEvent) => Promise<void>;
     deleteTag: (id: string) => Promise<void>;
     saveTag: (id: string, name: string, memberNames: string[] | null) => Promise<void>;
     reorderTags: (orderedIds: string[]) => Promise<void>;
@@ -197,9 +180,9 @@ export declare function useSkillHub(api: SkillHubApi): {
     cancelImport: () => Promise<void>;
     clearScan: () => void;
     checkMarket: () => Promise<void>;
+    loadMarketStats: () => Promise<void>;
     syncMarketSource: (repo: string) => Promise<void>;
     confirmMarketSync: () => Promise<void>;
     updateAll: () => Promise<void>;
-    create: (event: FormEvent) => Promise<void>;
+    create: (event: import("react").FormEvent) => Promise<void>;
 };
-export {};

package/lib/types/client/settings-card.d.ts

@@ -30,23 +30,6 @@ export interface PluginSettingsCardProps {
  * @returns the card, or nothing while the namespace is still loading.
  */
 export declare function PluginSettingsCard(props: PluginSettingsCardProps): ReactElement | null;
-/** One staged boolean field: 继承 / 开 / 关. */
-export interface BooleanFieldProps {
-    id: string;
-    label: string;
-    hint: string;
-    inheritLabel: string;
-    onLabel: string;
-    offLabel: string;
-    overriddenLabel: string;
-    resetLabel: string;
-    disabled: boolean;
-    text: string;
-    overridden: boolean;
-    onEdit: (text: string) => void;
-    onReset: () => void;
-}
-export declare function BooleanField(props: BooleanFieldProps): ReactElement;
 /**
  * A compact sliding switch for the card's master enable/disable control.
  * An empty text value means the field inherits its default; the switch still
@@ -82,6 +65,26 @@ export interface ColorFieldProps {
     onReset: () => void;
 }
 export declare function ColorField(props: ColorFieldProps): ReactElement;
+/**
+ * One staged secret field: a password input that never echoes the stored
+ * value. Shows a "set" state via the overridden badge; Reset unsets it.
+ */
+export interface SecretFieldProps {
+    id: string;
+    label: string;
+    hint: string;
+    /** Placeholder shown while empty (never the stored token). */
+    placeholder: string;
+    overriddenLabel: string;
+    resetLabel: string;
+    disabled: boolean;
+    text: string;
+    overridden: boolean;
+    invalid?: boolean;
+    onEdit: (text: string) => void;
+    onReset: () => void;
+}
+export declare function SecretField(props: SecretFieldProps): ReactElement;
 /** One staged numeric field: a numeric draft text input with inherit/reset semantics. */
 export interface NumberFieldProps {
     id: string;

package/lib/types/client/settings-form.d.ts

@@ -23,6 +23,12 @@ export interface FieldSpec {
 export declare function booleanField(field: string): FieldSpec;
 /** A #rrggbb color field, edited through hex draft text. */
 export declare function colorField(field: string): FieldSpec;
+/**
+ * A secret field (API token): the stored value is never echoed back into the
+ * draft (format always yields ''), so typing is always a fresh set and Reset
+ * always unsets. An empty draft stages nothing.
+ */
+export declare function secretField(field: string): FieldSpec;
 /**
  * A numeric field with range clamping. Integer by default: a fractional draft
  * is truncated so "5.5 分钟" cannot sneak past an integer-only schema.
@@ -98,7 +104,6 @@ export declare class CardForm {
     private specOf;
     private sectionValue;
     private baseValue;
-    private userLayer;
     private stored;
     private publish;
 }

package/lib/types/protocol/api.d.ts

@@ -0,0 +1,38 @@
+/** Browser-facing base paths of the skill-hub API family. */
+export declare const SKILL_HUB_API: {
+    readonly catalog: "/api/skill-hub/catalog";
+    readonly skill: "/api/skill-hub/skill";
+    readonly skillDelete: "/api/skill-hub/skill/delete";
+    readonly toggle: "/api/skill-hub/toggle";
+    readonly toggleBatch: "/api/skill-hub/toggle-batch";
+    readonly create: "/api/skill-hub/create";
+    readonly stats: "/api/skill-hub/stats";
+    readonly config: "/api/skill-hub/config";
+    readonly market: "/api/skill-hub/market";
+    readonly marketSource: "/api/skill-hub/market/source";
+    readonly marketSourceDelete: "/api/skill-hub/market/source/delete";
+    readonly marketSourceRef: "/api/skill-hub/market/source/ref";
+    readonly marketCheck: "/api/skill-hub/market/check";
+    readonly marketSync: "/api/skill-hub/market/source/sync";
+    readonly repo: "/api/skill-hub/repo";
+    readonly repoImport: "/api/skill-hub/repo/import";
+    readonly repoImportProgress: "/api/skill-hub/repo/import/progress";
+    readonly repoImportCancel: "/api/skill-hub/repo/import/cancel";
+    readonly update: "/api/skill-hub/update";
+    readonly groups: "/api/skill-hub/groups";
+    readonly tag: "/api/skill-hub/tag";
+    readonly tagDelete: "/api/skill-hub/tag/delete";
+    readonly tagMembers: "/api/skill-hub/tag/members";
+    readonly tagReorder: "/api/skill-hub/tag/reorder";
+    readonly collectionReorder: "/api/skill-hub/collections/reorder";
+    readonly sourceGroupReorder: "/api/skill-hub/source-groups/reorder";
+    readonly sources: "/api/skill-hub/sources";
+    readonly sourceCheck: "/api/skill-hub/sources/check";
+    readonly sourceSync: "/api/skill-hub/sources/sync";
+    readonly sourceDelete: "/api/skill-hub/sources/delete";
+    readonly sourceRestore: "/api/skill-hub/sources/restore";
+    readonly sourceTrashClear: "/api/skill-hub/sources/trash/clear";
+    readonly diagnosticFix: "/api/skill-hub/diagnostic/fix";
+    readonly marketSourceVersions: "/api/skill-hub/market/source/versions";
+    readonly marketStats: "/api/skill-hub/market/stats";
+};

package/lib/types/protocol/catalog.d.ts

@@ -0,0 +1,155 @@
+/** User-level roots the hub may write to (matches dsh-skill-filesystem ranks 400/500). */
+export type WritableRoot = 'user-dsh' | 'user-agents';
+/** Invocation policy resolved by the registry, re-spelled for the wire. */
+export interface HubInvocation {
+    /** Whether model-facing catalogs may load this skill. */
+    modelInvocable: boolean;
+    /** Whether human-facing command catalogs may load this skill. */
+    userInvocable: boolean;
+}
+/** One enabled skill row in the catalog. */
+export interface CatalogSkill {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    invocation: HubInvocation;
+    provider: string;
+    /** Whether the hub may toggle this skill (user-level filesystem skills only). */
+    writable: boolean;
+    /** 技能来源标识（user-dsh/user-agents/project-dsh/project-agents/...）。 */
+    source: string;
+    /** SKILL.md creation time (epoch ms); used for "added" sorting. Absent when unknown. */
+    addedAt?: number;
+    /** SKILL.md last-modified time (epoch ms); used for "updated" display. Absent when unknown. */
+    updatedAt?: number;
+    /** 项目技能的所属工作区路径（仅 project-dsh/project-agents 来源携带）。 */
+    workspace?: string;
+    /** 工作区显示标题（来自 workspace.json；无则回退为路径）。 */
+    workspaceTitle?: string;
+    /** UI metadata from agents/openai.yaml (mirrors codex SkillInterface). */
+    displayName?: string;
+    shortDescription?: string;
+    brandColor?: string;
+    iconSmall?: string;
+    iconLarge?: string;
+    defaultPrompt?: string;
+}
+/** One disabled skill tracked by the hub sidecar (SKILL.md renamed away). */
+export interface DisabledSkill {
+    name: string;
+    description: string;
+    /** Absolute path of the renamed file (SKILL.md.disabled / <name>.md.disabled). */
+    path: string;
+    root: WritableRoot;
+    disabledAt: number;
+}
+/** One discovery diagnostic: a file the filesystem provider skips, with the reason. */
+export interface DiagnosticEntry {
+    path: string;
+    root: string;
+    reason: string;
+    /** Whether this diagnostic can be auto-fixed (e.g. unquoted colon). */
+    fixable?: boolean;
+}
+/** POST /api/skill-hub/diagnostic/fix — repair a fixable diagnostic in place. */
+export interface DiagnosticFixRequest {
+    path: string;
+}
+export interface DiagnosticFixResponse {
+    ok: true;
+    path: string;
+}
+/** GET /api/skill-hub/catalog */
+export interface CatalogResponse {
+    ok: true;
+    /** 已安装插件自身的版本号（package.json version），面板标题旁显示。 */
+    pluginVersion: string;
+    /** Whether discovery completed within a stable catalog revision. */
+    complete: boolean;
+    /** Sorted winning summaries of every enabled skill (all roots + providers). */
+    skills: CatalogSkill[];
+    /** Skills the hub has toggled off (kept outside provider discovery). */
+    disabled: DisabledSkill[];
+    /** Files in the writable roots the provider ignores, with reasons. */
+    diagnostics: DiagnosticEntry[];
+    /** Skill names that appeared in multiple roots (first wins, others hidden). Mirrors codex name_counts. */
+    duplicateNames?: string[];
+}
+/** GET /api/skill-hub/skill */
+export interface SkillDetail {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    invocation: HubInvocation;
+    provider: string;
+    /** Absolute file path when the skill came from disk. */
+    path?: string;
+    /** SKILL.md creation time (epoch ms); absent when the file is unreadable. */
+    addedAt?: number;
+    /** SKILL.md last-modified time (epoch ms); absent when the file is unreadable. */
+    updatedAt?: number;
+    /** Markdown instruction body. */
+    content: string;
+    displayName?: string;
+    shortDescription?: string;
+    brandColor?: string;
+    iconSmall?: string;
+    iconLarge?: string;
+    defaultPrompt?: string;
+}
+export interface SkillDetailResponse {
+    ok: true;
+    skill: SkillDetail;
+}
+/** POST /api/skill-hub/skill/delete — 把单个技能移入回收站（可恢复）。 */
+export interface SkillDeleteRequest {
+    name: string;
+}
+/** POST /api/skill-hub/skill/delete */
+export interface SkillDeleteResponse {
+    ok: true;
+    name: string;
+    /** 移入回收站后的路径（目录或文件）。 */
+    path: string;
+}
+/** POST /api/skill-hub/toggle */
+export interface ToggleRequest {
+    /** Kebab-case skill name. */
+    name: string;
+    /** true re-enables a hub-disabled skill; false disables an enabled one. */
+    enabled: boolean;
+}
+export interface ToggleResponse {
+    ok: true;
+    /** Fresh catalog after the mutation (the filesystem provider may lag a beat). */
+    catalog: CatalogResponse;
+}
+/** POST /api/skill-hub/toggle-batch — one group of skills, one write. */
+export interface ToggleBatchRequest {
+    names: string[];
+    enabled: boolean;
+}
+/** POST /api/skill-hub/toggle-batch */
+export interface ToggleBatchResponse {
+    ok: true;
+    catalog: CatalogResponse;
+    /** Per-name failures (unknown/read-only skills); empty means all landed. */
+    failures: Array<{
+        name: string;
+        error: string;
+    }>;
+}
+/** POST /api/skill-hub/create */
+export interface CreateRequest {
+    /** Kebab-case skill name (validated with the official isSkillName grammar). */
+    name: string;
+    /** Optional one-line routing description for the frontmatter. */
+    description?: string;
+    /** Target user root; defaults to user-dsh (~/.dsh/skills). */
+    root?: WritableRoot;
+}
+export interface CreateResponse {
+    ok: true;
+    path: string;
+    root: WritableRoot;
+}