dsh-agent-skills 0.1.0

package/lib/registry.js

@@ -0,0 +1,122 @@
+/** Cast a `ctx.skills` service to the structural shape. */
+export function registryOf(skills) {
+    return skills;
+}
+/** Skill rank constants mirroring @deepseek-ai/dsh-skill-filesystem. */
+export const RANK = {
+    projectDsh: 100,
+    projectAgents: 200,
+    runtime: 250,
+    custom: 300,
+    userDsh: 400,
+    userAgents: 500,
+    bundled: 600
+};
+/** The runtime provider name (reserved by the skill registry). */
+export const RUNTIME_PROVIDER_NAME = "runtime";
+/** Normalize one provider observation into candidates + completeness. */
+export function normalizeObservation(output, providerName) {
+    if (Array.isArray(output))
+        return { candidates: output, complete: true };
+    if (output === null || typeof output !== "object")
+        return { candidates: [], complete: false };
+    const observation = output;
+    if (!Array.isArray(observation.candidates) || typeof observation.complete !== "boolean") {
+        return { candidates: [], complete: false };
+    }
+    return { candidates: observation.candidates, complete: observation.complete };
+}
+/**
+ * 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 async function collectLayer(layer, options, logger, excludeProvider) {
+    const entries = [];
+    let complete = true;
+    let localOrder = 0;
+    for (const [name, definition] of [...layer.runtime.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        entries.push({
+            candidate: {
+                name,
+                description: definition.description,
+                ...(definition.whenToUse !== undefined ? { whenToUse: definition.whenToUse } : {}),
+                invocation: definition.invocation ?? { modelInvocable: true, userInvocable: true },
+                source: definition.source,
+                provider: RUNTIME_PROVIDER_NAME,
+                rank: RANK.runtime,
+                locator: definition,
+                ...(definition.resourceBase !== undefined ? { resourceBase: definition.resourceBase } : {}),
+                ...(definition.path !== undefined ? { path: definition.path } : {}),
+                ...(definition.metadata !== undefined ? { metadata: definition.metadata } : {})
+            },
+            provider: undefined,
+            providerOrder: -1,
+            localOrder: localOrder++
+        });
+    }
+    for (const { provider, order } of layer.providers.values()) {
+        if (excludeProvider !== undefined && provider.name === excludeProvider)
+            continue;
+        let output;
+        try {
+            output = await provider.list(options);
+        }
+        catch (error) {
+            complete = false;
+            logger.warn(`agent-skills: provider "${provider.name}" skipped: ${String(error)}`);
+            continue;
+        }
+        const observation = normalizeObservation(output, provider.name);
+        if (!observation.complete)
+            complete = false;
+        for (const candidate of observation.candidates) {
+            entries.push({ candidate, provider, providerOrder: order, localOrder: localOrder++ });
+        }
+    }
+    return { entries, complete };
+}
+/** Collect candidates from the global layer and every scoped layer. */
+export async function collectAllLayers(registry, options, logger, excludeProvider) {
+    const entries = [];
+    let complete = true;
+    const global = await collectLayer(registry.layers.global, options, logger, excludeProvider);
+    entries.push(...global.entries);
+    if (!global.complete)
+        complete = false;
+    for (const layer of registry.layers.scoped.values()) {
+        const collected = await collectLayer(layer, options, logger, excludeProvider);
+        entries.push(...collected.entries);
+        if (!collected.complete)
+            complete = false;
+    }
+    return { entries, complete };
+}
+/** First-wins dedupe after rank/providerOrder/localOrder sort (registry semantics). */
+export function dedupeWinners(entries) {
+    const sorted = [...entries].sort((a, b) => {
+        const rank = a.candidate.rank - b.candidate.rank;
+        if (rank !== 0)
+            return rank;
+        const order = a.providerOrder - b.providerOrder;
+        if (order !== 0)
+            return order;
+        return a.localOrder - b.localOrder;
+    });
+    const seen = new Set();
+    const winners = [];
+    for (const entry of sorted) {
+        if (seen.has(entry.candidate.name))
+            continue;
+        seen.add(entry.candidate.name);
+        winners.push(entry);
+    }
+    return winners;
+}
+/** Force the registry to re-collect on the next `list()`/snapshot. */
+export function invalidateSkillCache(skills) {
+    const registry = registryOf(skills);
+    if (typeof registry.invalidateCache === "function")
+        registry.invalidateCache();
+}
+//# sourceMappingURL=registry.js.map

package/lib/registry.js.map

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

package/lib/runtime.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Host typert service backing the Agent Skills settings page. Every mutating
+ * method persists the new state, invalidates the skill registry so the next
+ * agent step republishes the model catalog, and returns the fresh page view.
+ *
+ * @module dsh-agent-skills/runtime
+ */
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import type { AgentSkillsView, AddDirInput, RemoveDirInput, ToggleDirInput, ToggleSkillInput } from "./schemas.js";
+/** The host service behind the `agentSkills` typert namespace. */
+export declare class AgentSkillsRuntime extends TypertRemoteService {
+    constructor(ctx: import("@deepseek-ai/cordis").Context);
+    /** Full page view: sources + catalog + counts. */
+    list(): Promise<AgentSkillsView>;
+    /** Enable or disable one skill by name. */
+    toggleSkill(input: ToggleSkillInput): Promise<AgentSkillsView>;
+    /** Enable or disable one scan directory (custom or builtin root). */
+    toggleDir(input: ToggleDirInput): Promise<AgentSkillsView>;
+    /** Add a custom scan directory. */
+    addDir(input: AddDirInput): Promise<AgentSkillsView>;
+    /** Remove a custom scan directory (auto-discovered ones too). */
+    removeDir(input: RemoveDirInput): Promise<AgentSkillsView>;
+    /** Re-scan everything and return the fresh view. */
+    rescan(): Promise<AgentSkillsView>;
+    /** Shared tail: auto-discover, invalidate the catalog, return the view. */
+    private refresh;
+}

package/lib/runtime.js

@@ -0,0 +1,162 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+/**
+ * Host typert service backing the Agent Skills settings page. Every mutating
+ * method persists the new state, invalidates the skill registry so the next
+ * agent step republishes the model catalog, and returns the fresh page view.
+ *
+ * @module dsh-agent-skills/runtime
+ */
+import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import { readState, writeState } from "./store.js";
+import { buildView, ensureDiscovered, canonicalizeDir } from "./views.js";
+import { invalidateSkillCache } from "./registry.js";
+import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
+/** Strip undefined recursively so the strict wire codec always passes. */
+function jsonSafe(value) {
+    if (Array.isArray(value))
+        return value.map((entry) => jsonSafe(entry));
+    if (typeof value === "object" && value !== null) {
+        const out = {};
+        for (const [key, entry] of Object.entries(value)) {
+            if (entry !== undefined)
+                out[key] = jsonSafe(entry);
+        }
+        return out;
+    }
+    return value;
+}
+/** The host service behind the `agentSkills` typert namespace. */
+let AgentSkillsRuntime = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _list_decorators;
+    let _toggleSkill_decorators;
+    let _toggleDir_decorators;
+    let _addDir_decorators;
+    let _removeDir_decorators;
+    let _rescan_decorators;
+    return class AgentSkillsRuntime extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _list_decorators = [Remote];
+            _toggleSkill_decorators = [Remote];
+            _toggleDir_decorators = [Remote];
+            _addDir_decorators = [Remote];
+            _removeDir_decorators = [Remote];
+            _rescan_decorators = [Remote];
+            __esDecorate(this, null, _list_decorators, { kind: "method", name: "list", static: false, private: false, access: { has: obj => "list" in obj, get: obj => obj.list }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _toggleSkill_decorators, { kind: "method", name: "toggleSkill", static: false, private: false, access: { has: obj => "toggleSkill" in obj, get: obj => obj.toggleSkill }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _toggleDir_decorators, { kind: "method", name: "toggleDir", static: false, private: false, access: { has: obj => "toggleDir" in obj, get: obj => obj.toggleDir }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _addDir_decorators, { kind: "method", name: "addDir", static: false, private: false, access: { has: obj => "addDir" in obj, get: obj => obj.addDir }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _removeDir_decorators, { kind: "method", name: "removeDir", static: false, private: false, access: { has: obj => "removeDir" in obj, get: obj => obj.removeDir }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _rescan_decorators, { kind: "method", name: "rescan", static: false, private: false, access: { has: obj => "rescan" in obj, get: obj => obj.rescan }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        constructor(ctx) {
+            super(ctx, "agentSkills");
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+        /** Full page view: sources + catalog + counts. */
+        async list() {
+            return this.refresh();
+        }
+        /** Enable or disable one skill by name. */
+        async toggleSkill(input) {
+            const state = await readState();
+            const set = new Set(state.disabledSkills);
+            if (input.enabled)
+                set.delete(input.name);
+            else
+                set.add(input.name);
+            state.disabledSkills = [...set].sort();
+            await writeState(state);
+            return this.refresh();
+        }
+        /** Enable or disable one scan directory (custom or builtin root). */
+        async toggleDir(input) {
+            const state = await readState();
+            const path = canonicalizeDir(input.path);
+            const custom = state.dirs.find((dir) => canonicalizeDir(dir.path) === path);
+            if (custom !== undefined) {
+                custom.enabled = input.enabled;
+            }
+            else {
+                const set = new Set(state.disabledDirs.map((entry) => canonicalizeDir(entry)));
+                if (input.enabled)
+                    set.delete(path);
+                else
+                    set.add(path);
+                state.disabledDirs = [...set].sort();
+            }
+            await writeState(state);
+            return this.refresh();
+        }
+        /** Add a custom scan directory. */
+        async addDir(input) {
+            const state = await readState();
+            const path = canonicalizeDir(input.path);
+            const existing = state.dirs.find((dir) => canonicalizeDir(dir.path) === path);
+            if (existing === undefined)
+                state.dirs.push({ path, enabled: true });
+            await writeState(state);
+            return this.refresh();
+        }
+        /** Remove a custom scan directory (auto-discovered ones too). */
+        async removeDir(input) {
+            const state = await readState();
+            const path = canonicalizeDir(input.path);
+            state.dirs = state.dirs.filter((dir) => canonicalizeDir(dir.path) !== path);
+            await writeState(state);
+            return this.refresh();
+        }
+        /** Re-scan everything and return the fresh view. */
+        async rescan() {
+            return this.refresh();
+        }
+        /** Shared tail: auto-discover, invalidate the catalog, return the view. */
+        async refresh() {
+            const dshHome = resolveDshHome();
+            const state = await readState(dshHome);
+            if (await ensureDiscovered(state))
+                await writeState(state, dshHome);
+            invalidateSkillCache(this.ctx.get("skills"));
+            const view = await buildView(this.ctx, state);
+            return jsonSafe(view);
+        }
+    };
+})();
+export { AgentSkillsRuntime };
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

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

package/lib/scan.d.ts

@@ -0,0 +1,29 @@
+export interface ParsedSkill {
+    name: string;
+    description: string;
+    whenToUse?: string;
+    modelInvocable: boolean;
+    userInvocable: boolean;
+    metadata?: Record<string, unknown>;
+    content: string;
+    /** Absolute path of the skill file (SKILL.md or flat .md). */
+    path: string;
+    /** Absolute directory containing the skill file. */
+    directory: string;
+}
+export interface ScannedRoot {
+    path: string;
+    skills: ParsedSkill[];
+}
+/** Parse one skill file; returns undefined when the file is not a usable skill. */
+export declare function parseSkillFile(path: string, logger: {
+    warn(message: string): void;
+}): Promise<ParsedSkill | undefined>;
+/**
+ * Scan one root directory for skills (one level deep: <dir>/SKILL.md or
+ * flat *.md files). A missing root yields an empty result; a root that is
+ * not a directory is treated the same.
+ */
+export declare function scanRoot(root: string, logger: {
+    warn(message: string): void;
+}): Promise<ScannedRoot>;

package/lib/scan.js

@@ -0,0 +1,156 @@
+/**
+ * Skill discovery for user-configured scan directories. Mirrors the parsing
+ * rules of @deepseek-ai/dsh-skill-filesystem so a skill authored for Claude
+ * Code / Codex / DSH looks identical from every source:
+ *   - a directory carrying SKILL.md, or a flat *.md file, per root entry;
+ *   - YAML frontmatter requiring name + description;
+ *   - optional whenToUse, disable-model-invocation, user-invocable, metadata.
+ *
+ * @module dsh-agent-skills/scan
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { load as parseYaml } from "js-yaml";
+const SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringField(data, key) {
+    const value = data[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function frontmatterBoolean(data, key) {
+    if (!Object.hasOwn(data, key))
+        return undefined;
+    const value = data[key];
+    if (typeof value === "boolean")
+        return value;
+    if (value === 1 || value === "1")
+        return true;
+    if (value === 0 || value === "0")
+        return false;
+    if (typeof value === "string") {
+        const lowered = value.toLowerCase();
+        if (lowered === "true" || lowered === "yes" || lowered === "on")
+            return true;
+        if (lowered === "false" || lowered === "no" || lowered === "off")
+            return false;
+    }
+    return undefined;
+}
+/** Split a raw skill file into frontmatter data and body; undefined when invalid. */
+function parseFrontmatter(raw) {
+    const firstLineEnd = raw.indexOf("\n");
+    if (firstLineEnd < 0)
+        return undefined;
+    if (raw.slice(0, firstLineEnd).replace(/\r$/, "") !== "---")
+        return undefined;
+    const start = firstLineEnd + 1;
+    let lineStart = start;
+    while (lineStart <= raw.length) {
+        const nextNewline = raw.indexOf("\n", lineStart);
+        const lineEnd = nextNewline < 0 ? raw.length : nextNewline;
+        if (raw.slice(lineStart, lineEnd).replace(/\r$/, "") === "---") {
+            const bodyStart = nextNewline < 0 ? raw.length : nextNewline + 1;
+            let parsed;
+            try {
+                parsed = parseYaml(raw.slice(start, lineStart));
+            }
+            catch {
+                return undefined;
+            }
+            if (!isRecord(parsed))
+                return undefined;
+            return { data: parsed, body: raw.slice(bodyStart) };
+        }
+        if (nextNewline < 0)
+            return undefined;
+        lineStart = nextNewline + 1;
+    }
+    return undefined;
+}
+/** Parse one skill file; returns undefined when the file is not a usable skill. */
+export async function parseSkillFile(path, logger) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    const parsed = parseFrontmatter(raw);
+    if (parsed === undefined) {
+        logger.warn(`agent-skills: skill file ${path} ignored: missing or invalid YAML frontmatter`);
+        return undefined;
+    }
+    const name = stringField(parsed.data, "name");
+    const description = stringField(parsed.data, "description");
+    if (name === undefined || description === undefined) {
+        logger.warn(`agent-skills: skill file ${path} ignored: frontmatter requires name and description`);
+        return undefined;
+    }
+    if (!SKILL_NAME.test(name)) {
+        logger.warn(`agent-skills: skill file ${path} ignored: invalid skill name "${name}"`);
+        return undefined;
+    }
+    const disableModelInvocation = frontmatterBoolean(parsed.data, "disable-model-invocation");
+    const userInvocable = frontmatterBoolean(parsed.data, "user-invocable");
+    const metadata = parsed.data.metadata;
+    return {
+        name,
+        description,
+        ...(stringField(parsed.data, "whenToUse") !== undefined ? { whenToUse: stringField(parsed.data, "whenToUse") } : {}),
+        modelInvocable: disableModelInvocation !== true,
+        userInvocable: userInvocable !== false,
+        ...(isRecord(metadata) ? { metadata } : {}),
+        content: parsed.body.trim(),
+        path,
+        directory: dirname(path)
+    };
+}
+/**
+ * Scan one root directory for skills (one level deep: <dir>/SKILL.md or
+ * flat *.md files). A missing root yields an empty result; a root that is
+ * not a directory is treated the same.
+ */
+export async function scanRoot(root, logger) {
+    let entries;
+    try {
+        entries = await readdir(root, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch {
+        return { path: root, skills: [] };
+    }
+    const skills = [];
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (entry.name === ".system")
+            continue;
+        const path = join(root, entry.name);
+        let kind;
+        if (entry.isDirectory())
+            kind = "directory";
+        else if (entry.isFile())
+            kind = "file";
+        else if (entry.isSymbolicLink()) {
+            try {
+                const info = await stat(path);
+                kind = info.isDirectory() ? "directory" : info.isFile() ? "file" : undefined;
+            }
+            catch {
+                continue;
+            }
+        }
+        const locator = kind === "directory"
+            ? { path: join(path, "SKILL.md"), directory: path }
+            : kind === "file" && entry.name.endsWith(".md")
+                ? { path, directory: root }
+                : undefined;
+        if (locator === undefined)
+            continue;
+        const parsed = await parseSkillFile(locator.path, logger);
+        if (parsed !== undefined)
+            skills.push(parsed);
+    }
+    return { path: root, skills };
+}
+//# sourceMappingURL=scan.js.map

package/lib/scan.js.map

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

package/lib/schemas.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 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 declare const dirViewSchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        custom: "custom";
+        builtin: "builtin";
+    }>;
+    exists: z.ZodBoolean;
+    enabled: z.ZodBoolean;
+    skillCount: z.ZodNumber;
+    tag: z.ZodEnum<{
+        builtin: "builtin";
+        user: "user";
+    }>;
+    auto: z.ZodOptional<z.ZodBoolean>;
+    skills: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DirView = z.infer<typeof dirViewSchema>;
+/** One skill shown on the Agent Skills page. */
+export declare const skillViewSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    whenToUse: z.ZodOptional<z.ZodString>;
+    source: z.ZodString;
+    kind: z.ZodEnum<{
+        custom: "custom";
+        builtin: "builtin";
+        global: "global";
+    }>;
+    directory: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodBoolean;
+    toggleable: z.ZodBoolean;
+}, z.core.$strip>;
+export type SkillView = z.infer<typeof skillViewSchema>;
+/** The full page view. */
+export declare const agentSkillsViewSchema: z.ZodObject<{
+    dirs: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            custom: "custom";
+            builtin: "builtin";
+        }>;
+        exists: z.ZodBoolean;
+        enabled: z.ZodBoolean;
+        skillCount: z.ZodNumber;
+        tag: z.ZodEnum<{
+            builtin: "builtin";
+            user: "user";
+        }>;
+        auto: z.ZodOptional<z.ZodBoolean>;
+        skills: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    skills: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        whenToUse: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+        kind: z.ZodEnum<{
+            custom: "custom";
+            builtin: "builtin";
+            global: "global";
+        }>;
+        directory: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodBoolean;
+        toggleable: z.ZodBoolean;
+    }, z.core.$strip>>;
+    counts: z.ZodObject<{
+        total: z.ZodNumber;
+        custom: z.ZodNumber;
+        global: z.ZodNumber;
+        builtin: z.ZodNumber;
+    }, z.core.$strip>;
+    validDirs: z.ZodNumber;
+    missingDirs: z.ZodNumber;
+}, z.core.$strip>;
+export type AgentSkillsView = z.infer<typeof agentSkillsViewSchema>;
+/** Input for toggling one skill. */
+export declare const toggleSkillInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type ToggleSkillInput = z.infer<typeof toggleSkillInputSchema>;
+/** Input for toggling one scan directory. */
+export declare const toggleDirInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type ToggleDirInput = z.infer<typeof toggleDirInputSchema>;
+/** Input for adding a custom scan directory. */
+export declare const addDirInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export type AddDirInput = z.infer<typeof addDirInputSchema>;
+/** Input for removing a custom scan directory. */
+export declare const removeDirInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export type RemoveDirInput = z.infer<typeof removeDirInputSchema>;