dsh-agent-skills 0.1.0

package/lib/schemas.js

@@ -0,0 +1,82 @@
+/**
+ * Wire schemas shared by the host typert face and the client remote.
+ * Zod v4 instances — the typert gateway re-checks JSON-safety after schema
+ * parsing, so optional fields must never be `undefined` on the wire.
+ *
+ * @module dsh-agent-skills/schemas
+ */
+import { z } from "zod";
+/** A scan directory shown on the Agent Skills page. */
+export const dirViewSchema = z.object({
+    /** Absolute directory path. */
+    path: z.string(),
+    /** custom = user-added or auto-discovered; builtin = default DSH root. */
+    kind: z.enum(["custom", "builtin"]),
+    /** Whether the directory exists on disk right now. */
+    exists: z.boolean(),
+    /** Whether scanning this directory is enabled. */
+    enabled: z.boolean(),
+    /** Number of valid skills discovered in this directory. */
+    skillCount: z.number().int().min(0),
+    /** UI tag: "用户配置" or "内置路径" — resolved client-side from kind. */
+    tag: z.enum(["user", "builtin"]),
+    /** True for auto-discovered agent directories (custom kind only). */
+    auto: z.boolean().optional(),
+    /** Every valid skill discovered in this directory (undeduplicated). */
+    skills: z.array(z.object({
+        name: z.string(),
+        description: z.string()
+    }))
+});
+/** One skill shown on the Agent Skills page. */
+export const skillViewSchema = z.object({
+    /** Kebab-case skill name. */
+    name: z.string(),
+    /** One-line description from frontmatter. */
+    description: z.string(),
+    /** Optional trigger guidance from frontmatter. */
+    whenToUse: z.string().optional(),
+    /** Raw provider source id (custom / user-agents / user-dsh / bundled / ...). */
+    source: z.string(),
+    /** UI category: 自定义 / 全局 / 内置. */
+    kind: z.enum(["custom", "global", "builtin"]),
+    /** Directory the skill lives in (resource base), when known. */
+    directory: z.string().optional(),
+    /** Effective enabled state (source toggle AND skill toggle). */
+    enabled: z.boolean(),
+    /** True when the skill is user-toggleable (has a file-backed source). */
+    toggleable: z.boolean()
+});
+/** The full page view. */
+export const agentSkillsViewSchema = z.object({
+    dirs: z.array(dirViewSchema),
+    skills: z.array(skillViewSchema),
+    counts: z.object({
+        total: z.number().int().min(0),
+        custom: z.number().int().min(0),
+        global: z.number().int().min(0),
+        builtin: z.number().int().min(0)
+    }),
+    /** Sources summary: existing / missing directories. */
+    validDirs: z.number().int().min(0),
+    missingDirs: z.number().int().min(0)
+});
+/** Input for toggling one skill. */
+export const toggleSkillInputSchema = z.object({
+    name: z.string(),
+    enabled: z.boolean()
+});
+/** Input for toggling one scan directory. */
+export const toggleDirInputSchema = z.object({
+    path: z.string(),
+    enabled: z.boolean()
+});
+/** Input for adding a custom scan directory. */
+export const addDirInputSchema = z.object({
+    path: z.string().min(1)
+});
+/** Input for removing a custom scan directory. */
+export const removeDirInputSchema = z.object({
+    path: z.string().min(1)
+});
+//# sourceMappingURL=schemas.js.map

package/lib/schemas.js.map

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

package/lib/store.d.ts

@@ -0,0 +1,26 @@
+/** One configured scan directory (user-added or auto-discovered). */
+export interface StateDir {
+    path: string;
+    enabled: boolean;
+    /** True when auto-discovered from another AI coding agent's home. */
+    auto?: boolean;
+}
+export interface AgentSkillsState {
+    version: 1;
+    /** Custom + auto-discovered scan directories (the "用户配置" sources). */
+    dirs: StateDir[];
+    /** Skill names the user switched off. */
+    disabledSkills: string[];
+    /** Builtin root paths the user switched off ("内置路径" sources). */
+    disabledDirs: string[];
+}
+/** Absolute path of the state file for a resolved dsh home. */
+export declare function stateFilePath(dshHome?: string): string;
+/**
+ * Read the state file; a missing or malformed file yields the empty state.
+ * The host half is the only writer and publishes atomically, so a torn read
+ * can only ever observe the previous complete document.
+ */
+export declare function readState(dshHome?: string): Promise<AgentSkillsState>;
+/** Atomic publish: write a temp sibling, fsync, then rename over the target. */
+export declare function writeState(state: AgentSkillsState, dshHome?: string): Promise<void>;

package/lib/store.js

@@ -0,0 +1,88 @@
+/**
+ * Durable state of the Agent Skills page: custom scan directories, per-directory
+ * and per-skill switches. Owned by the host half; persisted atomically under
+ * `$DSH_HOME/agent-skills/state.json` so toggles survive restarts without
+ * touching the profile patch layer.
+ *
+ * @module dsh-agent-skills/store
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
+const STATE_VERSION = 1;
+const EMPTY = {
+    version: STATE_VERSION,
+    dirs: [],
+    disabledSkills: [],
+    disabledDirs: []
+};
+/** Absolute path of the state file for a resolved dsh home. */
+export function stateFilePath(dshHome = resolveDshHome()) {
+    return join(dshHome, "agent-skills", "state.json");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseState(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(parsed) || parsed.version !== STATE_VERSION)
+        return undefined;
+    const dirs = [];
+    if (Array.isArray(parsed.dirs)) {
+        for (const entry of parsed.dirs) {
+            if (!isRecord(entry) || typeof entry.path !== "string" || entry.path === "")
+                continue;
+            dirs.push({
+                path: resolve(entry.path),
+                enabled: entry.enabled !== false,
+                ...(entry.auto === true ? { auto: true } : {})
+            });
+        }
+    }
+    const disabledSkills = [];
+    if (Array.isArray(parsed.disabledSkills)) {
+        for (const name of parsed.disabledSkills) {
+            if (typeof name === "string" && name !== "")
+                disabledSkills.push(name);
+        }
+    }
+    const disabledDirs = [];
+    if (Array.isArray(parsed.disabledDirs)) {
+        for (const path of parsed.disabledDirs) {
+            if (typeof path === "string" && path !== "")
+                disabledDirs.push(resolve(path));
+        }
+    }
+    return { version: STATE_VERSION, dirs, disabledSkills, disabledDirs };
+}
+/**
+ * Read the state file; a missing or malformed file yields the empty state.
+ * The host half is the only writer and publishes atomically, so a torn read
+ * can only ever observe the previous complete document.
+ */
+export async function readState(dshHome) {
+    const file = stateFilePath(dshHome);
+    try {
+        const raw = await readFile(file, "utf8");
+        return parseState(raw) ?? structuredClone(EMPTY);
+    }
+    catch {
+        return structuredClone(EMPTY);
+    }
+}
+/** Atomic publish: write a temp sibling, fsync, then rename over the target. */
+export async function writeState(state, dshHome) {
+    const file = stateFilePath(dshHome);
+    await mkdir(dirname(file), { recursive: true });
+    const tmp = join(dirname(file), `.state.${process.pid}.${Date.now().toString(36)}.tmp`);
+    const serialized = JSON.stringify(state, null, 2);
+    await writeFile(tmp, serialized, "utf8");
+    await rename(tmp, file);
+}
+//# sourceMappingURL=store.js.map

package/lib/store.js.map

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

package/lib/typert.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Host TYPERT manifest for the `agentSkills` namespace, discovered
+ * automatically by @deepseek-ai/dsh-typert-loader through the `./typert`
+ * export. Hand-written in the same shape the typert generator emits; the
+ * client mirror lives in src/client/typert-remote.ts.
+ *
+ * @module dsh-agent-skills/typert
+ */
+import { z } from "zod";
+/** Strict host contribution: `agentSkills/*` endpoints dispatched to ctx.agentSkills. */
+export declare const TYPERT: {
+    readonly package: "dsh-agent-skills";
+    readonly face: "host";
+    readonly schemas: readonly [];
+    readonly model: {
+        readonly services: readonly [{
+            readonly tags: readonly [];
+            readonly key: "agentSkills";
+            readonly exportName: "agentSkills";
+            readonly members: readonly [{
+                readonly name: "list";
+                readonly kind: "method";
+                readonly signature: "(): Promise<AgentSkillsView>";
+            }, {
+                readonly name: "toggleSkill";
+                readonly kind: "method";
+                readonly signature: "(input: ToggleSkillInput): Promise<AgentSkillsView>";
+            }, {
+                readonly name: "toggleDir";
+                readonly kind: "method";
+                readonly signature: "(input: ToggleDirInput): Promise<AgentSkillsView>";
+            }, {
+                readonly name: "addDir";
+                readonly kind: "method";
+                readonly signature: "(input: AddDirInput): Promise<AgentSkillsView>";
+            }, {
+                readonly name: "removeDir";
+                readonly kind: "method";
+                readonly signature: "(input: RemoveDirInput): Promise<AgentSkillsView>";
+            }, {
+                readonly name: "rescan";
+                readonly kind: "method";
+                readonly signature: "(): Promise<AgentSkillsView>";
+            }];
+            readonly types: readonly [{
+                readonly name: "DirView";
+                readonly declaration: "export interface DirView { path: string; kind: 'custom' | 'builtin'; exists: boolean; enabled: boolean; skillCount: number; tag: 'user' | 'builtin'; }";
+            }, {
+                readonly name: "SkillView";
+                readonly declaration: "export interface SkillView { name: string; description: string; whenToUse?: string; source: string; kind: 'custom' | 'global' | 'builtin'; directory?: string; enabled: boolean; toggleable: boolean; }";
+            }, {
+                readonly name: "SkillCounts";
+                readonly declaration: "export interface SkillCounts { total: number; custom: number; global: number; builtin: number; }";
+            }, {
+                readonly name: "AgentSkillsView";
+                readonly declaration: "export interface AgentSkillsView { dirs: DirView[]; skills: SkillView[]; counts: SkillCounts; validDirs: number; missingDirs: number; }";
+            }, {
+                readonly name: "ToggleSkillInput";
+                readonly declaration: "export interface ToggleSkillInput { name: string; enabled: boolean; }";
+            }, {
+                readonly name: "ToggleDirInput";
+                readonly declaration: "export interface ToggleDirInput { path: string; enabled: boolean; }";
+            }, {
+                readonly name: "AddDirInput";
+                readonly declaration: "export interface AddDirInput { path: string; }";
+            }, {
+                readonly name: "RemoveDirInput";
+                readonly declaration: "export interface RemoveDirInput { path: string; }";
+            }];
+        }];
+        readonly events: readonly [];
+        readonly objects: readonly [];
+    };
+    readonly invocations: readonly [{
+        readonly id: "dsh-agent-skills#agentSkills/list";
+        readonly service: "agentSkills";
+        readonly namespace: "agentSkills";
+        readonly method: "list";
+        readonly invocation: {
+            readonly kind: "direct";
+        };
+        readonly parameters: readonly [];
+        readonly result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        };
+    }, {
+        readonly id: "dsh-agent-skills#agentSkills/toggleSkill";
+        readonly service: "agentSkills";
+        readonly namespace: "agentSkills";
+        readonly method: "toggleSkill";
+        readonly invocation: {
+            readonly kind: "direct";
+        };
+        readonly parameters: readonly [{
+            readonly name: "input";
+            readonly wire: "input";
+            readonly source: "json";
+            readonly codec: {
+                mode: string;
+                typeSymbol: string;
+                schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+            };
+        }];
+        readonly result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        };
+    }, {
+        readonly id: "dsh-agent-skills#agentSkills/toggleDir";
+        readonly service: "agentSkills";
+        readonly namespace: "agentSkills";
+        readonly method: "toggleDir";
+        readonly invocation: {
+            readonly kind: "direct";
+        };
+        readonly parameters: readonly [{
+            readonly name: "input";
+            readonly wire: "input";
+            readonly source: "json";
+            readonly codec: {
+                mode: string;
+                typeSymbol: string;
+                schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+            };
+        }];
+        readonly result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        };
+    }, {
+        readonly id: "dsh-agent-skills#agentSkills/addDir";
+        readonly service: "agentSkills";
+        readonly namespace: "agentSkills";
+        readonly method: "addDir";
+        readonly invocation: {
+            readonly kind: "direct";
+        };
+        readonly parameters: readonly [{
+            readonly name: "input";
+            readonly wire: "input";
+            readonly source: "json";
+            readonly codec: {
+                mode: string;
+                typeSymbol: string;
+                schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+            };
+        }];
+        readonly result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        };
+    }, {
+        readonly id: "dsh-agent-skills#agentSkills/removeDir";
+        readonly service: "agentSkills";
+        readonly namespace: "agentSkills";
+        readonly method: "removeDir";
+        readonly invocation: {
+            readonly kind: "direct";
+        };
+        readonly parameters: readonly [{
+            readonly name: "input";
+            readonly wire: "input";
+            readonly source: "json";
+            readonly codec: {
+                mode: string;
+                typeSymbol: string;
+                schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+            };
+        }];
+        readonly result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        };
+    }, {
+        readonly id: "dsh-agent-skills#agentSkills/rescan";
+        readonly service: "agentSkills";
+        readonly namespace: "agentSkills";
+        readonly method: "rescan";
+        readonly invocation: {
+            readonly kind: "direct";
+        };
+        readonly parameters: readonly [];
+        readonly result: {
+            mode: string;
+            typeSymbol: string;
+            schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        };
+    }];
+};

package/lib/typert.js

@@ -0,0 +1,153 @@
+import { addDirInputSchema, agentSkillsViewSchema, removeDirInputSchema, toggleDirInputSchema, toggleSkillInputSchema } from "./schemas.js";
+const PKG = "dsh-agent-skills";
+const direct = { kind: "direct" };
+function jsonCodec(typeSymbol, schema) {
+    return { mode: "strict", typeSymbol: `${PKG}/types#${typeSymbol}`, schema };
+}
+function result(typeSymbol, schema) {
+    return { mode: "strict", typeSymbol: `${PKG}/types#${typeSymbol}`, schema };
+}
+/** Strict host contribution: `agentSkills/*` endpoints dispatched to ctx.agentSkills. */
+export const TYPERT = {
+    package: PKG,
+    face: "host",
+    schemas: [],
+    model: {
+        services: [
+            {
+                tags: [],
+                key: "agentSkills",
+                exportName: "agentSkills",
+                members: [
+                    { name: "list", kind: "method", signature: "(): Promise<AgentSkillsView>" },
+                    { name: "toggleSkill", kind: "method", signature: "(input: ToggleSkillInput): Promise<AgentSkillsView>" },
+                    { name: "toggleDir", kind: "method", signature: "(input: ToggleDirInput): Promise<AgentSkillsView>" },
+                    { name: "addDir", kind: "method", signature: "(input: AddDirInput): Promise<AgentSkillsView>" },
+                    { name: "removeDir", kind: "method", signature: "(input: RemoveDirInput): Promise<AgentSkillsView>" },
+                    { name: "rescan", kind: "method", signature: "(): Promise<AgentSkillsView>" }
+                ],
+                types: [
+                    {
+                        name: "DirView",
+                        declaration: "export interface DirView { path: string; kind: 'custom' | 'builtin'; exists: boolean; enabled: boolean; skillCount: number; tag: 'user' | 'builtin'; }"
+                    },
+                    {
+                        name: "SkillView",
+                        declaration: "export interface SkillView { name: string; description: string; whenToUse?: string; source: string; kind: 'custom' | 'global' | 'builtin'; directory?: string; enabled: boolean; toggleable: boolean; }"
+                    },
+                    {
+                        name: "SkillCounts",
+                        declaration: "export interface SkillCounts { total: number; custom: number; global: number; builtin: number; }"
+                    },
+                    {
+                        name: "AgentSkillsView",
+                        declaration: "export interface AgentSkillsView { dirs: DirView[]; skills: SkillView[]; counts: SkillCounts; validDirs: number; missingDirs: number; }"
+                    },
+                    {
+                        name: "ToggleSkillInput",
+                        declaration: "export interface ToggleSkillInput { name: string; enabled: boolean; }"
+                    },
+                    {
+                        name: "ToggleDirInput",
+                        declaration: "export interface ToggleDirInput { path: string; enabled: boolean; }"
+                    },
+                    {
+                        name: "AddDirInput",
+                        declaration: "export interface AddDirInput { path: string; }"
+                    },
+                    {
+                        name: "RemoveDirInput",
+                        declaration: "export interface RemoveDirInput { path: string; }"
+                    }
+                ]
+            }
+        ],
+        events: [],
+        objects: []
+    },
+    invocations: [
+        {
+            id: `${PKG}#agentSkills/list`,
+            service: "agentSkills",
+            namespace: "agentSkills",
+            method: "list",
+            invocation: direct,
+            parameters: [],
+            result: result("AgentSkillsView", agentSkillsViewSchema)
+        },
+        {
+            id: `${PKG}#agentSkills/toggleSkill`,
+            service: "agentSkills",
+            namespace: "agentSkills",
+            method: "toggleSkill",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("ToggleSkillInput", toggleSkillInputSchema)
+                }
+            ],
+            result: result("AgentSkillsView", agentSkillsViewSchema)
+        },
+        {
+            id: `${PKG}#agentSkills/toggleDir`,
+            service: "agentSkills",
+            namespace: "agentSkills",
+            method: "toggleDir",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("ToggleDirInput", toggleDirInputSchema)
+                }
+            ],
+            result: result("AgentSkillsView", agentSkillsViewSchema)
+        },
+        {
+            id: `${PKG}#agentSkills/addDir`,
+            service: "agentSkills",
+            namespace: "agentSkills",
+            method: "addDir",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("AddDirInput", addDirInputSchema)
+                }
+            ],
+            result: result("AgentSkillsView", agentSkillsViewSchema)
+        },
+        {
+            id: `${PKG}#agentSkills/removeDir`,
+            service: "agentSkills",
+            namespace: "agentSkills",
+            method: "removeDir",
+            invocation: direct,
+            parameters: [
+                {
+                    name: "input",
+                    wire: "input",
+                    source: "json",
+                    codec: jsonCodec("RemoveDirInput", removeDirInputSchema)
+                }
+            ],
+            result: result("AgentSkillsView", agentSkillsViewSchema)
+        },
+        {
+            id: `${PKG}#agentSkills/rescan`,
+            service: "agentSkills",
+            namespace: "agentSkills",
+            method: "rescan",
+            invocation: direct,
+            parameters: [],
+            result: result("AgentSkillsView", agentSkillsViewSchema)
+        }
+    ]
+};
+//# sourceMappingURL=typert.js.map

package/lib/typert.js.map

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

package/lib/types/client/AgentSkillsSection.d.ts

@@ -0,0 +1,9 @@
+import type { AgentSkillsApi } from "./typert-remote.js";
+import type { TranslateNS } from "@deepseek-ai/dsh-client-ui-slots";
+type T = TranslateNS<"agent-skills">;
+/** The settings page body. */
+export declare function AgentSkillsSection({ api, t }: {
+    api: AgentSkillsApi;
+    t: T;
+}): import("react").JSX.Element;
+export {};

package/lib/types/client/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Client plugin body: injects the page styles, registers the `agent-skills`
+ * locale dictionaries, mounts the `agentSkills` remote namespace, then
+ * registers the Agent Skills page into the `settings.section` slot (设置 →
+ * Agent Skills).
+ *
+ * @module dsh-agent-skills/client
+ */
+import type { ClientContext } from "@deepseek-ai/dsh-client-runtime/client";
+import "./types.js";
+/** Services required before this plugin mounts. */
+export declare const inject: string[];
+/** Mount the browser half. */
+export declare function apply(ctx: ClientContext): Promise<void>;