dsh-agent-skills 0.1.0

package/lib/discovery.d.ts

@@ -0,0 +1,9 @@
+/** Well-known skill roots of other AI coding agents (relative to home). */
+export declare const AGENT_SKILL_DIRS: ReadonlyArray<readonly [id: string, rel: string]>;
+/** Whether a directory exists and is a directory. */
+export declare function directoryExists(path: string): Promise<boolean>;
+/**
+ * Discover agent skill directories that exist on this machine, home-expanded.
+ * @returns absolute paths, existing only.
+ */
+export declare function discoverAgentSkillDirs(home?: string): Promise<string[]>;

package/lib/discovery.js

@@ -0,0 +1,48 @@
+/**
+ * Auto-discovery of other AI coding agents' skill directories. On first run
+ * (and on every scan) any of the well-known homes that actually exists is
+ * offered as a scan source, so skills from Claude Code, Codex, Gemini CLI,
+ * Cursor, Qoder, Continue, Roo, Cline and Kilo flow into the catalog without
+ * any manual setup.
+ *
+ * @module dsh-agent-skills/discovery
+ */
+import { homedir } from "node:os";
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+/** Well-known skill roots of other AI coding agents (relative to home). */
+export const AGENT_SKILL_DIRS = [
+    ["claude", join(".claude", "skills")],
+    ["codex", join(".codex", "skills")],
+    ["gemini", join(".gemini", "skills")],
+    ["cursor", join(".cursor", "skills")],
+    ["qoder", join(".qoder", "skills")],
+    ["continue", join(".continue", "skills")],
+    ["roo", join(".roo", "skills")],
+    ["cline", join(".cline", "skills")],
+    ["kilo", join(".kilo", "skills")]
+];
+/** Whether a directory exists and is a directory. */
+export async function directoryExists(path) {
+    try {
+        const info = await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Discover agent skill directories that exist on this machine, home-expanded.
+ * @returns absolute paths, existing only.
+ */
+export async function discoverAgentSkillDirs(home = homedir()) {
+    const found = [];
+    for (const [, rel] of AGENT_SKILL_DIRS) {
+        const path = join(home, rel);
+        if (await directoryExists(path))
+            found.push(path);
+    }
+    return found;
+}
+//# sourceMappingURL=discovery.js.map

package/lib/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAsD;IACjF,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAClC,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAI,GAAG,OAAO,EAAE;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM,eAAe,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * dsh-agent-skills — host entry.
+ *
+ * The same package is mounted in two planes:
+ *
+ * 1. HOST row (web profile bundle, id `agent-skills`): the settings-page
+ *    service. It owns the durable store (custom scan dirs + toggles), exposes
+ *    the `agentSkills` typert namespace for the browser half, and publishes
+ *    catalog invalidations so toggles reach the model on the next agent step.
+ *
+ * 2. PRESET row (appended to the shipped agent presets by
+ *    scripts/install-preset.mjs): registers the `agent-skills` provider into
+ *    the preset layer of the skill registry, where it re-emits every
+ *    candidate with the user's enable/disable policy and scans the custom
+ *    directories. The preset layer outranks the global layer, which is what
+ *    lets the toggles shadow the preset's own skill-filesystem provider.
+ *
+ * @module dsh-agent-skills
+ */
+import type { Context } from "@deepseek-ai/cordis";
+/** Stable cordis plugin name. */
+export declare const name = "agent-skills";
+/** The skill registry is required in both planes. */
+export declare const inject: string[];
+/**
+ * Mount the plugin. Both planes register the skill provider:
+ *   - the HOST row registers into the global layer (covers host-level
+ *     compositions such as the headless profile, where skill-filesystem is a
+ *     host row);
+ *   - a PRESET row registers into its preset layer, which outranks the
+ *     global layer for agent-visible skills (the web profile's arrangement).
+ * The host row additionally provides the settings-page service and the
+ * `agentSkills` typert namespace.
+ */
+export declare function apply(ctx: Context): Promise<void>;

package/lib/index.js

@@ -0,0 +1,26 @@
+import { scopeOf } from "@deepseek-ai/dsh-scope";
+import { AgentSkillsRuntime } from "./runtime.js";
+import { createAgentSkillsProvider } from "./provider.js";
+/** Stable cordis plugin name. */
+export const name = "agent-skills";
+/** The skill registry is required in both planes. */
+export const inject = ["skills"];
+/**
+ * Mount the plugin. Both planes register the skill provider:
+ *   - the HOST row registers into the global layer (covers host-level
+ *     compositions such as the headless profile, where skill-filesystem is a
+ *     host row);
+ *   - a PRESET row registers into its preset layer, which outranks the
+ *     global layer for agent-visible skills (the web profile's arrangement).
+ * The host row additionally provides the settings-page service and the
+ * `agentSkills` typert namespace.
+ */
+export async function apply(ctx) {
+    const scope = scopeOf(ctx);
+    ctx.skills.registerProvider((control) => createAgentSkillsProvider(ctx, control));
+    if (scope === undefined) {
+        // Host plane: settings-page service + typert namespace.
+        new AgentSkillsRuntime(ctx);
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,cAAc,CAAC;AAEnC,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC;AAEjC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAY;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAClF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,wDAAwD;QACxD,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/lib/preset.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Preset-only entry point. It contributes the provider to the preset's
+ * scoped skill layer and deliberately does not construct host services such
+ * as `agentSkills`.
+ */
+import type { Context } from "@deepseek-ai/cordis";
+export declare const name = "agent-skills-preset";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/preset.js

@@ -0,0 +1,7 @@
+import { createAgentSkillsProvider } from "./provider.js";
+export const name = "agent-skills-preset";
+export const inject = ["skills"];
+export function apply(ctx) {
+    ctx.skills.registerProvider((control) => createAgentSkillsProvider(ctx, control));
+}
+//# sourceMappingURL=preset.js.map

package/lib/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAC;AAC1C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC;AAEjC,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/lib/provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The per-agent-preset skill provider. Registered by the preset-scoped half
+ * of this plugin into the preset layer of the skill registry — the layer
+ * that outranks the global layer for agent-visible skills.
+ *
+ * Responsibilities:
+ *   - re-emit every candidate from the layers' other providers (the preset's
+ *     own skill-filesystem, global providers, runtime registrations) at
+ *     rank - 1, so this provider's copies win the per-name dedupe and can
+ *     carry the user's enable/disable policy;
+ *   - discover user-configured custom scan directories itself;
+ *   - delegate `get()` to the original provider / file so skill bodies are
+ *     always loaded by the same code that owns them.
+ *
+ * @module dsh-agent-skills/provider
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import type { SkillCandidate, SkillProvider, SkillProviderControl } from "@deepseek-ai/dsh-skill";
+import { type AgentSkillsState } from "./store.js";
+/** The provider name this plugin registers (never "runtime"). */
+export declare const PROVIDER_NAME = "agent-skills";
+export interface RootPolicy {
+    /** Absolute root path. */
+    path: string;
+    /** True when the root is disabled by the user. */
+    disabled: boolean;
+}
+export interface StateReader {
+    read(): Promise<AgentSkillsState>;
+}
+export declare function stateReaderOf(): StateReader;
+/** Longest matching root wins; returns undefined when no root covers the path. */
+export declare function rootFor(path: string | undefined, roots: RootPolicy[]): RootPolicy | undefined;
+/** Builtin roots resolved from the environment (mirrors dsh-skill-filesystem). */
+export declare function builtinRoots(dshHome?: string): Promise<RootPolicy[]>;
+/** Origins of an emitted candidate, attached for `get()` delegation. */
+interface Origin {
+    kind: "provider" | "runtime" | "custom";
+    provider?: SkillProvider;
+    candidate?: SkillCandidate;
+}
+export declare function originOf(candidate: SkillCandidate): Origin | undefined;
+/**
+ * Create the preset-scope provider. Watchers on the user's custom directories
+ * invalidate the registry cache on file changes so the catalog follows disk
+ * edits without a restart.
+ */
+export declare function createAgentSkillsProvider(ctx: Context, control: SkillProviderControl, stateReader?: StateReader): SkillProvider;
+/** Find this plugin's provider in any scoped layer (the preset instance). */
+export declare function findPresetProvider(skills: unknown): {
+    provider: SkillProvider;
+} | undefined;
+export {};

package/lib/provider.js

@@ -0,0 +1,295 @@
+import { scopeOf } from "@deepseek-ai/dsh-scope";
+import { readState, stateFilePath } from "./store.js";
+import { collectAllLayers, dedupeWinners, registryOf, RANK } from "./registry.js";
+import { scanRoot } from "./scan.js";
+import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
+import { watch } from "node:fs";
+import { resolve } from "node:path";
+/** The provider name this plugin registers (never "runtime"). */
+export const PROVIDER_NAME = "agent-skills";
+export function stateReaderOf() {
+    let cached;
+    return {
+        async read() {
+            const { stat } = await import("node:fs/promises");
+            const file = stateFilePath();
+            let mtimeMs = 0;
+            try {
+                mtimeMs = (await stat(file)).mtimeMs;
+            }
+            catch {
+                /* missing file counts as the empty state */
+            }
+            if (cached !== undefined && cached.mtimeMs === mtimeMs)
+                return cached.state;
+            const state = await readState();
+            cached = { mtimeMs, state };
+            return state;
+        }
+    };
+}
+/** Longest matching root wins; returns undefined when no root covers the path. */
+export function rootFor(path, roots) {
+    if (path === undefined)
+        return undefined;
+    let best;
+    for (const root of roots) {
+        if (path === root.path || path.startsWith(root.path.endsWith("/") ? root.path : root.path + "/")) {
+            if (best === undefined || root.path.length > best.path.length)
+                best = root;
+        }
+    }
+    return best;
+}
+/** Builtin roots resolved from the environment (mirrors dsh-skill-filesystem). */
+export async function builtinRoots(dshHome = resolveDshHome()) {
+    const { homedir } = await import("node:os");
+    const roots = [];
+    roots.push({ path: resolve(dshHome, "skills"), disabled: false });
+    const agentsHome = process.env.DSH_AGENTS_HOME ?? resolve(homedir(), ".agents");
+    roots.push({ path: resolve(agentsHome, "skills"), disabled: false });
+    if (process.env.DSH_BUNDLED_SKILL_DIR !== undefined && process.env.DSH_BUNDLED_SKILL_DIR !== "") {
+        roots.push({ path: resolve(process.env.DSH_BUNDLED_SKILL_DIR), disabled: false });
+    }
+    return roots;
+}
+const origins = new WeakMap();
+export function originOf(candidate) {
+    return origins.get(candidate);
+}
+function emit(candidate, origin, rank) {
+    const emitted = {
+        ...candidate,
+        rank,
+        provider: PROVIDER_NAME
+    };
+    origins.set(emitted, origin);
+    return emitted;
+}
+/** Custom-dir candidates (rank 300) from the current state. */
+async function customCandidates(state, logger) {
+    const candidates = [];
+    const roots = [];
+    let localOrder = 0;
+    for (const dir of state.dirs) {
+        const path = resolve(dir.path);
+        roots.push({ path, disabled: dir.enabled === false });
+        const scanned = await scanRoot(path, logger);
+        for (const skill of scanned.skills) {
+            candidates.push(emit({
+                name: skill.name,
+                description: skill.description,
+                ...(skill.whenToUse !== undefined ? { whenToUse: skill.whenToUse } : {}),
+                invocation: { modelInvocable: skill.modelInvocable, userInvocable: skill.userInvocable },
+                source: "custom",
+                provider: PROVIDER_NAME,
+                rank: RANK.custom,
+                locator: { path: skill.path, directory: skill.directory },
+                ...(skill.metadata !== undefined ? { metadata: skill.metadata } : {}),
+                resourceBase: { kind: "directory", path: skill.directory },
+                path: skill.path
+            }, { kind: "custom" }, RANK.custom - 1));
+            localOrder += 1;
+        }
+    }
+    return { candidates, roots };
+}
+/** Scan the built-in user roots when no filesystem provider is mounted yet. */
+async function builtinCandidates(roots, logger) {
+    const candidates = [];
+    for (const root of roots) {
+        const scanned = await scanRoot(root.path, logger);
+        const source = root.path.endsWith("/skills") && root.path.includes("/.agents/")
+            ? "user-agents"
+            : root.path.endsWith("/skills") && root.path.includes("/.dsh/")
+                ? "user-dsh"
+                : "bundled";
+        const rank = source === "user-agents" ? RANK.userAgents : source === "user-dsh" ? RANK.userDsh : RANK.bundled;
+        for (const skill of scanned.skills) {
+            candidates.push(emit({
+                name: skill.name,
+                description: skill.description,
+                ...(skill.whenToUse !== undefined ? { whenToUse: skill.whenToUse } : {}),
+                invocation: { modelInvocable: skill.modelInvocable, userInvocable: skill.userInvocable },
+                source,
+                provider: PROVIDER_NAME,
+                rank,
+                locator: { path: skill.path, directory: skill.directory },
+                resourceBase: { kind: "directory", path: skill.directory },
+                path: skill.path,
+                ...(skill.metadata !== undefined ? { metadata: skill.metadata } : {})
+            }, { kind: "custom" }, rank - 1));
+        }
+    }
+    return candidates;
+}
+/**
+ * Create the preset-scope provider. Watchers on the user's custom directories
+ * invalidate the registry cache on file changes so the catalog follows disk
+ * edits without a restart.
+ */
+export function createAgentSkillsProvider(ctx, control, stateReader = stateReaderOf()) {
+    const logger = ctx.logger;
+    const scope = scopeOf(ctx);
+    const watchers = new Map();
+    let invalidateQueued = false;
+    const queueInvalidate = () => {
+        if (invalidateQueued)
+            return;
+        invalidateQueued = true;
+        queueMicrotask(() => {
+            invalidateQueued = false;
+            control.invalidate();
+        });
+    };
+    const startWatchers = async () => {
+        const state = await stateReader.read();
+        for (const dir of state.dirs) {
+            const path = resolve(dir.path);
+            if (watchers.has(path))
+                continue;
+            try {
+                const watcher = watch(path, { recursive: true }, (_event, filename) => {
+                    if (filename === null || typeof filename !== "string")
+                        return;
+                    if (!filename.endsWith(".md"))
+                        return;
+                    queueInvalidate();
+                });
+                watchers.set(path, watcher);
+            }
+            catch {
+                /* recursive watching unsupported or the dir is gone — rescan covers it */
+            }
+        }
+    };
+    void startWatchers();
+    control.signal.addEventListener("abort", () => {
+        for (const watcher of watchers.values()) {
+            try {
+                watcher.close();
+            }
+            catch {
+                /* already closed */
+            }
+        }
+        watchers.clear();
+    }, { once: true });
+    return {
+        name: PROVIDER_NAME,
+        async list(options) {
+            const state = await stateReader.read();
+            const registry = registryOf(ctx.skills);
+            const myLayer = scope === undefined ? registry.layers.global : registry.layers.scoped.get(scope);
+            void myLayer; // self is skipped by name below, layer lookup only needed for structure
+            const inner = await collectAllLayers(registry, options, logger, PROVIDER_NAME);
+            const custom = await customCandidates(state, logger);
+            const builtins = await builtinRoots();
+            const builtin = await builtinCandidates(builtins, logger);
+            const roots = [...custom.roots, ...builtins];
+            const disabledDirs = new Set(state.disabledDirs);
+            const disabledSkills = new Set(state.disabledSkills);
+            const policy = roots.map((root) => ({
+                path: root.path,
+                disabled: root.disabled || disabledDirs.has(root.path)
+            }));
+            const winners = dedupeWinners(inner.entries);
+            const emitted = winners.map((entry) => {
+                const dir = rootFor(entry.candidate.resourceBase?.kind === "directory" ? entry.candidate.resourceBase.path : entry.candidate.path, policy);
+                const disabled = disabledSkills.has(entry.candidate.name) || (dir !== undefined && dir.disabled);
+                const invocation = entry.candidate.invocation ?? { modelInvocable: true, userInvocable: true };
+                const origin = entry.provider === undefined
+                    ? { kind: "runtime" }
+                    : { kind: "provider", provider: entry.provider, candidate: entry.candidate };
+                return emit({
+                    ...entry.candidate,
+                    invocation: disabled ? { modelInvocable: false, userInvocable: false } : invocation,
+                    provider: PROVIDER_NAME
+                }, origin, entry.candidate.rank - 1);
+            });
+            // Custom candidates flow through the same policy (a disabled custom dir
+            // hides its skills; an explicitly disabled skill wins over the dir flag).
+            for (const candidate of custom.candidates) {
+                const dir = rootFor(candidate.resourceBase?.kind === "directory" ? candidate.resourceBase.path : candidate.path, policy);
+                const disabled = disabledSkills.has(candidate.name) || (dir !== undefined && dir.disabled);
+                if (disabled) {
+                    emitted.push({ ...candidate, invocation: { modelInvocable: false, userInvocable: false } });
+                }
+                else {
+                    emitted.push(candidate);
+                }
+            }
+            // The host settings service can be ready before the preset's filesystem
+            // provider. Keep the page and the next model step useful during that
+            // window by scanning the same built-in roots directly. When the official
+            // provider is present its candidates have the same rank and the wrapper
+            // above wins the duplicate deterministically.
+            for (const candidate of builtin) {
+                const dir = rootFor(candidate.resourceBase?.kind === "directory" ? candidate.resourceBase.path : candidate.path, policy);
+                const disabled = disabledSkills.has(candidate.name) || (dir !== undefined && dir.disabled);
+                if (disabled)
+                    emitted.push({ ...candidate, invocation: { modelInvocable: false, userInvocable: false } });
+                else
+                    emitted.push(candidate);
+            }
+            const unique = dedupeWinners(emitted.map((candidate, localOrder) => ({
+                candidate,
+                provider: undefined,
+                providerOrder: 0,
+                localOrder
+            }))).map((entry) => entry.candidate);
+            return {
+                candidates: unique,
+                complete: inner.complete
+            };
+        },
+        async get(candidate, options) {
+            const origin = origins.get(candidate);
+            if (origin === undefined)
+                return undefined;
+            if (origin.kind === "provider" && origin.provider !== undefined && origin.candidate !== undefined) {
+                const definition = await origin.provider.get(origin.candidate, options);
+                if (definition === undefined)
+                    return undefined;
+                return definition;
+            }
+            if (origin.kind === "runtime") {
+                const locator = candidate.locator;
+                return locator;
+            }
+            if (origin.kind === "custom") {
+                const locator = candidate;
+                if (locator.locator?.path === undefined)
+                    return undefined;
+                const { parseSkillFile } = await import("./scan.js");
+                const parsed = await parseSkillFile(locator.locator.path, logger);
+                if (parsed === undefined)
+                    return undefined;
+                return {
+                    name: parsed.name,
+                    description: parsed.description,
+                    ...(parsed.whenToUse !== undefined ? { whenToUse: parsed.whenToUse } : {}),
+                    invocation: { modelInvocable: parsed.modelInvocable, userInvocable: parsed.userInvocable },
+                    source: candidate.source,
+                    provider: PROVIDER_NAME,
+                    resourceBase: { kind: "directory", path: parsed.directory },
+                    path: parsed.path,
+                    ...(parsed.metadata !== undefined ? { metadata: parsed.metadata } : {}),
+                    content: parsed.content
+                };
+            }
+            return undefined;
+        }
+    };
+}
+/** Find this plugin's provider in any scoped layer (the preset instance). */
+export function findPresetProvider(skills) {
+    const registry = registryOf(skills);
+    for (const layer of registry.layers.scoped.values()) {
+        const found = layer.providers.get(PROVIDER_NAME);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+//# sourceMappingURL=provider.js.map

package/lib/provider.js.map

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

package/lib/registry.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Internal access to the skill registry's layered provider tables.
+ *
+ * The official types keep `SkillRegistry.layers` private; this module is the
+ * single place that reaches through (cast to a structural shape), reads
+ * provider candidates, and triggers catalog invalidation. Everything here is
+ * read-only except `invalidateSkillCache`, which is exactly what the
+ * "重新扫描" button and every toggle need to republish the model catalog.
+ *
+ * @module dsh-agent-skills/registry
+ */
+import type { SkillCandidate, SkillDefinition, SkillLookupOptions, SkillProvider } from "@deepseek-ai/dsh-skill";
+/** Structural view of one registry layer (the compiled class shape). */
+export interface LayerShape {
+    providers: {
+        get(name: string): {
+            provider: SkillProvider;
+            order: number;
+        } | undefined;
+        values(): IterableIterator<{
+            provider: SkillProvider;
+            order: number;
+        }>;
+    };
+    runtime: Map<string, SkillDefinition>;
+}
+/** Structural view of the SkillRegistry service. */
+export interface RegistryShape {
+    layers: {
+        global: LayerShape;
+        scoped: Map<unknown, LayerShape>;
+    };
+    invalidateCache(): void;
+}
+/** Cast a `ctx.skills` service to the structural shape. */
+export declare function registryOf(skills: unknown): RegistryShape;
+/** One collected candidate plus its origin, mirroring the registry's internal entry. */
+export interface CandidateEntry {
+    candidate: SkillCandidate;
+    /** Original provider for `get()` delegation; undefined for runtime entries. */
+    provider: SkillProvider | undefined;
+    /** Original provider registration order (tie-break for equal ranks). */
+    providerOrder: number;
+    /** Per-provider emission order (tie-break). */
+    localOrder: number;
+}
+/** Skill rank constants mirroring @deepseek-ai/dsh-skill-filesystem. */
+export declare const RANK: {
+    readonly projectDsh: 100;
+    readonly projectAgents: 200;
+    readonly runtime: 250;
+    readonly custom: 300;
+    readonly userDsh: 400;
+    readonly userAgents: 500;
+    readonly bundled: 600;
+};
+/** The runtime provider name (reserved by the skill registry). */
+export declare const RUNTIME_PROVIDER_NAME = "runtime";
+/** Normalize one provider observation into candidates + completeness. */
+export declare function normalizeObservation(output: unknown, providerName: string): {
+    candidates: readonly SkillCandidate[];
+    complete: boolean;
+};
+/**
+ * Collect candidates from one layer: runtime entries first (rank 250), then
+ * each provider in registration order. A provider that throws is skipped and
+ * marks the observation incomplete (mirrors the registry's own resilience).
+ */
+export declare function collectLayer(layer: LayerShape, options: SkillLookupOptions, logger: {
+    warn(message: string): void;
+}, excludeProvider?: string): Promise<{
+    entries: CandidateEntry[];
+    complete: boolean;
+}>;
+/** Collect candidates from the global layer and every scoped layer. */
+export declare function collectAllLayers(registry: RegistryShape, options: SkillLookupOptions, logger: {
+    warn(message: string): void;
+}, excludeProvider?: string): Promise<{
+    entries: CandidateEntry[];
+    complete: boolean;
+}>;
+/** First-wins dedupe after rank/providerOrder/localOrder sort (registry semantics). */
+export declare function dedupeWinners(entries: CandidateEntry[]): CandidateEntry[];
+/** Force the registry to re-collect on the next `list()`/snapshot. */
+export declare function invalidateSkillCache(skills: unknown): void;