@lmzhen/dsh-tool-skill-manage 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-tool-skill-manage
+
+Model-facing skill_manage tool
+
+## Model Experience
+
+### skill_manage tool surface
+
+#### What the model sees
+
+The model sees the `skill_manage` tool schema and tool results containing success or validation messages.
+
+#### Token effect
+
+Adds the `skill_manage` tool schema to the request catalog; result tokens scale with returned messages.
+
+#### KV Cache effect
+
+Tool schema is prefix-stable. Skill writes do not alter the current request prompt; catalog invalidation affects the next request.
+
+## Known Limitations and Deferred Work
+
+
+- No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.

package/lib/index.js

@@ -0,0 +1,158 @@
+import z from "@deepseek-ai/schemastery";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import { DEFAULT_SKILL_LIMITS, SkillLibrary, evolutionIoAdapter } from "@lmzhen/dsh-evolution-core";
+//#region lib/types/index.js
+/**
+* Model-facing skill_manage tool over ctx.evolutionIo + ctx.skillUsage.
+*
+* Mutations pass through the evolution approval seam when it is mounted;
+* approved/staged background writes are replayed by the registered runner.
+* The skill library itself never hard-deletes: archive is the maximum
+* destructive action and every curator mutation is snapshot-reversible.
+* @module @lmzhen/dsh-tool-skill-manage
+*/
+const name = "tool-skill-manage";
+const inject = [
+	"tools",
+	"skillUsage",
+	"evolutionIo"
+];
+const Config = z.object({
+	root: z.string().default(""),
+	maxSkillNameLength: z.number().default(DEFAULT_SKILL_LIMITS.maxNameLength),
+	maxDescriptionLength: z.number().default(DEFAULT_SKILL_LIMITS.maxDescriptionLength),
+	maxSkillContentChars: z.number().default(DEFAULT_SKILL_LIMITS.maxSkillContentChars),
+	maxSkillFileBytes: z.number().default(DEFAULT_SKILL_LIMITS.maxSkillFileBytes)
+});
+function apply(ctx, rawConfig = {}) {
+	const io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
+	const library = new SkillLibrary(rawConfig.root || void 0, io, {
+		maxNameLength: rawConfig.maxSkillNameLength ?? DEFAULT_SKILL_LIMITS.maxNameLength,
+		maxDescriptionLength: rawConfig.maxDescriptionLength ?? DEFAULT_SKILL_LIMITS.maxDescriptionLength,
+		maxSkillContentChars: rawConfig.maxSkillContentChars ?? DEFAULT_SKILL_LIMITS.maxSkillContentChars,
+		maxSkillFileBytes: rawConfig.maxSkillFileBytes ?? DEFAULT_SKILL_LIMITS.maxSkillFileBytes
+	});
+	async function executeCore(args, origin = "foreground") {
+		const action = args.action;
+		const name = args.name ?? "";
+		if (action === "list") {
+			const list = await library.list();
+			return {
+				ok: true,
+				message: `Listed ${list.length} skills.`,
+				skills: list.map((s) => s.name)
+			};
+		}
+		let result;
+		if (action === "create") result = await library.create(name, args.content ?? "", origin);
+		else if (action === "edit" || action === "update") result = await library.update(name, args.content ?? "");
+		else if (action === "patch") result = await library.patch(name, args.old_string ?? "", args.new_string ?? "", args.file_path ?? "", args.replace_all === true);
+		else if (action === "delete") result = await library.archive(name, args.absorbed_into ?? "");
+		else if (action === "write_file") result = await library.writeSupportFile(name, args.file_path ?? "", args.file_content ?? "");
+		else if (action === "remove_file") result = await library.removeSupportFile(name, args.file_path ?? "");
+		else result = {
+			ok: false,
+			message: `Unknown action "${action}".`
+		};
+		if (result.ok) {
+			if (name && action === "create" && origin === "background_review") await ctx.skillUsage.markAgentCreated(name);
+			if (name && action !== "list") await ctx.skillUsage.record(name, "patch");
+			ctx.emit("evolution/skill-mutated", {
+				action: action ?? "?",
+				name,
+				...result.path && action === "delete" ? { archivedPath: result.path } : result.path ? { filePath: result.path } : {}
+			});
+		}
+		return {
+			ok: result.ok,
+			message: result.message,
+			skills: []
+		};
+	}
+	ctx.tools.register(defineTool({
+		name: "skill_manage",
+		description: "Manage reusable skills. create/edit take full SKILL.md content; patch applies old_string -> new_string; delete archives to .archive. Protected bundled/hub skills reject mutation; pinned skills reject delete only. Prefer patching an umbrella over creating narrow skills.",
+		parameters: {
+			action: {
+				type: "string",
+				required: true,
+				enum: [
+					"create",
+					"edit",
+					"update",
+					"patch",
+					"delete",
+					"write_file",
+					"remove_file",
+					"list"
+				]
+			},
+			name: { type: "string" },
+			content: { type: "string" },
+			old_string: { type: "string" },
+			new_string: { type: "string" },
+			replace_all: { type: "boolean" },
+			file_path: { type: "string" },
+			file_content: { type: "string" },
+			absorbed_into: { type: "string" }
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					ok: {
+						type: "boolean",
+						required: true
+					},
+					message: {
+						type: "string",
+						required: true
+					},
+					skills: {
+						type: "array",
+						required: true,
+						items: { type: "string" }
+					},
+					pending_id: { type: "string" }
+				}
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: `${value.ok ? "OK" : "Error"}: ${value.message}`
+			}]
+		},
+		isConcurrencySafe: () => false,
+		async execute(args, exec) {
+			const origin = exec.agent?.session.header.origin === "subagent" ? "background_review" : "foreground";
+			const approval = ctx.get("evolutionApproval");
+			if (approval && args.action !== "list") {
+				const decision = await approval.request({
+					kind: "skill",
+					summary: `skill ${args.action ?? "?"} ${args.name ?? ""}`.trim(),
+					args: {
+						operation: args,
+						origin
+					},
+					origin
+				});
+				if (decision.action === "staged") return {
+					ok: true,
+					message: decision.message,
+					skills: [],
+					pending_id: decision.pendingId ?? ""
+				};
+			}
+			return await executeCore(args, origin);
+		}
+	}));
+	ctx.inject(["evolutionApproval"], (approvalCtx) => {
+		const dispose = approvalCtx.evolutionApproval.registerRunner("skill", (args) => {
+			const wrapped = args ?? {};
+			return executeCore(wrapped.operation ?? {}, wrapped.origin ?? "background_review");
+		});
+		approvalCtx.effect(() => dispose, "tool-skill-manage.approval-runner");
+	});
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-tool-skill-manage";
+const name = "tool-skill-manage-invariant";
+const inject = ["invariants"];
+const install = () => {};
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Model-facing skill_manage tool over ctx.evolutionIo + ctx.skillUsage.
+ *
+ * Mutations pass through the evolution approval seam when it is mounted;
+ * approved/staged background writes are replayed by the registered runner.
+ * The skill library itself never hard-deletes: archive is the maximum
+ * destructive action and every curator mutation is snapshot-reversible.
+ * @module @deepseek-ai/dsh-tool-skill-manage
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "tool-skill-manage";
+export declare const inject: string[];
+export interface Config {
+    /** Skill tree root; empty uses $DSH_HOME/skills. Align with skill-usage/catalog rows. */
+    root?: string;
+    maxSkillNameLength?: number;
+    maxDescriptionLength?: number;
+    maxSkillContentChars?: number;
+    maxSkillFileBytes?: number;
+}
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, rawConfig?: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "tool-skill-manage-invariant";
+export declare const inject: string[];
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@lmzhen/dsh-tool-skill-manage",
+  "description": "Model-facing skill_manage tool (community build)",
+  "version": "0.1.0-rc.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/dsh-tool-skill-manage"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts",
+    "lib/types/invariant.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-skill-usage": "^0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-skill-usage": "^0.1.0-rc.1"
+  }
+}