@sparkelf/dsh-client-ui-skill-center 0.2.0-rc.9

package/lib/types/index.d.ts

@@ -0,0 +1,155 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
+import type { SkillSummary } from '@deepseek-ai/dsh-skill';
+/** Stable cordis plugin name. */
+export declare const name = "ui-skill-center";
+/** Services required before the routes can mount. */
+export declare const inject: string[];
+/** Route paths, mirrored by the browser half. */
+export declare const ROUTES: {
+    readonly list: "/api/dsh-skill-center/list";
+    readonly setEnabled: "/api/dsh-skill-center/set-enabled";
+    readonly create: "/api/dsh-skill-center/create";
+    readonly delete: "/api/dsh-skill-center/delete";
+    readonly health: "/api/dsh-skill-center/health";
+};
+/** Plugin configuration. */
+export interface Config {
+    /** Extra custom skill root directories. */
+    customSkillDirs?: string[];
+    /** User dsh config root; defaults to `$DSH_HOME` or `~/.dsh`. */
+    dshHome?: string;
+    /** User agents config root; defaults to `$DSH_AGENTS_HOME` or `~/.agents`. */
+    agentsHome?: string;
+}
+/** A skill row as the panel receives it. */
+export interface SkillEntry {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    provider?: string;
+    level: string;
+    path?: string;
+    /** True when the skill resolves through a symlink; deletion is refused. */
+    linked?: boolean;
+    modelInvocable: boolean;
+    userInvocable: boolean;
+    workspaceRoot?: string;
+    workspaceName?: string;
+    isActiveWorkspace?: boolean;
+}
+/** One rendered group. */
+export interface GroupPayload {
+    key: string;
+    title: string;
+    hint: string;
+    skills: SkillEntry[];
+}
+/** One selectable workspace. */
+export interface WorkspaceItem {
+    root: string;
+    name: string;
+    active: boolean;
+}
+/** The list route's payload. */
+export interface ListPayload {
+    cwd: string;
+    projectRoots: string[];
+    complete: boolean;
+    groups: GroupPayload[];
+    workspaces?: WorkspaceItem[];
+}
+/**
+ * The user skill root convention.
+ * @param dshHome - the user's dsh config root, usually `~/.dsh`.
+ * @returns the directory holding user-level skills.
+ */
+export declare function userSkillRoot(dshHome: string): string;
+/**
+ * The project skill root convention.
+ * @param projectRoot - the project's root directory.
+ * @returns the directory holding that project's skills.
+ */
+export declare function projectSkillRoot(projectRoot: string): string;
+/**
+ * The nearest ancestor holding a `.git` entry.
+ * @param cwd - the directory to search upward from.
+ * @returns the project root, or `cwd` itself when no ancestor holds `.git`.
+ */
+export declare function findProjectRoot(cwd: string): string;
+/**
+ * The display group a skill belongs to.
+ *
+ * The registry summary reports a discovery source rather than a file path, so
+ * grouping follows the source name the filesystem provider assigns to each root
+ * it scans. An unrecognized source falls through to the custom group.
+ * @param source - the registry's discovery source label.
+ * @param provider - the provider that owns the skill body.
+ * @returns the group key.
+ */
+export declare function levelOfSource(source: string, provider: string): string;
+/**
+ * Read `disable-model-invocation` from a skill file.
+ * @param source - the skill file's content.
+ * @returns the flag when the frontmatter declares it, otherwise undefined.
+ */
+export declare function readDisabledFlag(source: string): boolean | undefined;
+/**
+ * Rewrite `disable-model-invocation`, adding it when absent.
+ *
+ * The field is one YAML scalar in the leading frontmatter block, so this edits
+ * that line rather than re-serializing the document: comments, key order, and
+ * the body all survive unchanged.
+ * @param source - the skill file's current content.
+ * @param disabled - the value to write.
+ * @returns the new content.
+ */
+export declare function withDisabledFlag(source: string, disabled: boolean): string;
+/**
+ * Build the SKILL.md a create writes.
+ * @param name - the skill's kebab-case name.
+ * @param description - the routing description.
+ * @param whenToUse - extra routing guidance, omitted when undefined.
+ * @param content - the instruction body; an empty value yields a heading.
+ * @returns the complete file content.
+ */
+export declare function buildSkillContent(name: string, description: string, whenToUse: string | undefined, content: string): string;
+/** The routes' dependencies, injectable for tests. */
+export interface SkillRoutesDeps {
+    dshHome: string;
+    agentsHome: string;
+    customSkillDirs: string[];
+    /** The official registry's summaries for a workspace, already bound to the viewing context. */
+    snapshotProject(cwd: string): Promise<{
+        skills: SkillSummary[];
+        complete: boolean;
+    }>;
+    /**
+     * One skill's absolute file path, or undefined when it has none.
+     *
+     * The registry's summaries deliberately omit the path — they are
+     * invocation-neutral metadata — so the write routes resolve it through
+     * `get()` when an action actually needs to touch a file. `collect()` caches
+     * the catalog these calls share, so the resolve is not a second scan.
+     */
+    pathOf(name: string, cwd: string): Promise<string | undefined>;
+    activeSessionCwds(): string[];
+    logger: {
+        warn(error: unknown): void;
+    };
+}
+/** The registry summary this route family reads, re-exported for its callers. */
+export type { SkillSummary };
+/**
+ * Build the skill-center routes.
+ * @param deps - resolved roots, the registry snapshot, and the session list.
+ * @returns the routes for `ctx.webServer.register`.
+ */
+export declare function makeRoutes(deps: SkillRoutesDeps): WebRoute[];
+/**
+ * Mount the skill-center routes.
+ * @param ctx - host context carrying `webServer`, `skills`, and `sessions`.
+ * @param config - resolved plugin config.
+ */
+export declare function apply(ctx: Context, config?: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -0,0 +1,65 @@
+{
+  "description": "Skill center for the dsh web client: browses loaded skills grouped by source, enables or disables model invocation, creates skills, and deletes them into a recoverable trash",
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.1",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ],
+      "platform": "web"
+    }
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
+    },
+    "./client": {
+      "default": "./lib/client.js",
+      "types": "./lib/types/client/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "main": "lib/index.js",
+  "name": "@sparkelf/dsh-client-ui-skill-center",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "directory": "packages/plus/ui-skill-center",
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "type": "module",
+  "types": "lib/types/index.d.ts",
+  "version": "0.2.0-rc.9"
+}