dsh-prompt-star 0.1.0

package/cordis.patch.yml

@@ -0,0 +1,14 @@
+# Host-side plugin rows contributed by the dsh-prompt-star bundle.
+#
+# `dsh-plugin-add` reads `dsh.bundle.patch` from package.json, applies this
+# layer on top of the profile's bundle list (after @deepseek-ai/dsh-base), and
+# `dsh --profile <name> --dump-config` shows a "# == dsh-prompt-star" layer.
+#
+# The rows below activate the Host service that reads project doc files and
+# calls the configured model. The client ⭐ button is a separate browser bundle
+# (dsh.client manifest) that the web app loads by id; it is not a Host row.
+- insert:
+    - id: prompt-star
+      name: dsh-prompt-star
+      # The host service is the package's default export; no config yet.
+      # config: ... any `config` you wire into the Cordis Loader.

package/lib/client.js

@@ -0,0 +1,100 @@
+window.__ModuleLoader__.load({
+	id: "dsh-prompt-star",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/StarButton.tsx
+		/**
+		* The ⭐ button rendered beside the conversation input. On click it reads the
+		* current draft (from the session input snapshot), asks the host to generate a
+		* fuller prompt, and writes it back with `inputActions.setDraft` — the user
+		* presses Ctrl/Cmd+Z if they want the original draft back.
+		*
+		* The slot framework composes this component's props: the session standard seat
+		* (`useInput`, `inputActions`, `useConversation`) plus the register-time
+		* `generate` face the client plugin injects. The interface below is the minimal
+		* structural shape this component needs; it matches the composed slot props.
+		*/
+		const buttonStyle = {
+			all: "unset",
+			display: "inline-flex",
+			alignItems: "center",
+			justifyContent: "center",
+			width: "30px",
+			height: "30px",
+			cursor: "pointer",
+			borderRadius: "6px",
+			fontSize: "16px",
+			lineHeight: 1,
+			opacity: .9,
+			userSelect: "none"
+		};
+		function StarButton({ generate, useInput, inputActions, useActiveRoot }) {
+			const input = useInput();
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(void 0);
+			async function onClick() {
+				const draft = input.draft.trim();
+				if (draft.length === 0) {
+					setError("草稿为空，先写点什么再点 ⭐");
+					return;
+				}
+				setBusy(true);
+				setError(void 0);
+				try {
+					const result = await generate({
+						draft,
+						workspaceRoot: useActiveRoot?.(),
+						intent: void 0
+					});
+					if (result.prompt && result.prompt !== draft) {
+						inputActions.setDraft(result.prompt);
+						if (result.degraded) setError("模型调用失败，已保留原草稿");
+					} else setError(result.degraded ? "模型调用失败，未生成新内容" : "生成结果与原草稿相同，未替换");
+				} catch (cause) {
+					const message = cause instanceof Error ? cause.message : String(cause);
+					setError(`生成失败: ${message}`);
+				} finally {
+					setBusy(false);
+				}
+			}
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				style: buttonStyle,
+				title: error ?? "prompt-star: 生成更完整的提示词",
+				disabled: busy,
+				onClick,
+				children: busy ? "…" : "⭐"
+			});
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Cordis services this client plugin needs. */
+		const inject = ["slots", "remote"];
+		/**
+		* Client plugin body: register the ⭐ button once the slot registry and the
+		* remote face are up.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.inject(["slots", "remote"], (scope) => {
+				const promptStar = scope.remote.promptStar;
+				scope.slots.inject("conversation.input.right", () => scope.slots.register({
+					name: "conversation.input.right",
+					id: "prompt-star",
+					order: 0,
+					inject: () => ({ generate: promptStar.generate })
+				}, StarButton));
+			});
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,283 @@
+import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import { readFile } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
+import { deadline } from "@deepseek-ai/dsh-timeout";
+import { deepFreeze } from "@deepseek-ai/dsh-util-values";
+//#region \0@oxc-project+runtime@0.148.0/helpers/esm/usingCtx.js
+function _usingCtx() {
+	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
+		var n = Error();
+		return n.name = "SuppressedError", n.error = r, n.suppressed = e, n;
+	}, e = {}, n = [];
+	function using(r, e) {
+		if (null != e) {
+			if (Object(e) !== e) throw new TypeError("using declarations can only be used with objects, functions, null, or undefined.");
+			if (r) var o = e[Symbol.asyncDispose || Symbol["for"]("Symbol.asyncDispose")];
+			if (void 0 === o && (o = e[Symbol.dispose || Symbol["for"]("Symbol.dispose")], r)) var t = o;
+			if ("function" != typeof o) throw new TypeError("Object is not disposable.");
+			t && (o = function o() {
+				try {
+					t.call(e);
+				} catch (r) {
+					return Promise.reject(r);
+				}
+			}), n.push({
+				v: e,
+				d: o,
+				a: r
+			});
+		} else r && n.push({
+			d: e,
+			a: r
+		});
+		return e;
+	}
+	return {
+		e,
+		u: using.bind(null, !1),
+		a: using.bind(null, !0),
+		d: function d() {
+			var o, t = this.e, s = 0;
+			function next() {
+				for (; o = n.pop();) try {
+					if (!o.a && 1 === s) return s = 0, n.push(o), Promise.resolve().then(next);
+					if (o.d) {
+						var r = o.d.call(o.v);
+						if (o.a) return s |= 2, Promise.resolve(r).then(next, err);
+					} else s |= 1;
+				} catch (r) {
+					return err(r);
+				}
+				if (1 === s) return t !== e ? Promise.reject(t) : Promise.resolve();
+				if (t !== e) throw t;
+			}
+			function err(n) {
+				return t = t !== e ? new r(n, t) : n, next();
+			}
+			return next();
+		}
+	};
+}
+//#endregion
+//#region src/host/generate.ts
+/**
+* Host implementation of one prompt-star generate: probe the project's doc
+* files for context, then call the configured default LLM to turn the draft +
+* context into a fuller prompt. Returns a best-effort result (never throws) so
+* a model failure degrades to a copy rather than failing the click.
+*/
+/** Doc files we probe (first match by priority wins as main context; all read). */
+const DOC_FILE_NAMES = [
+	"CLAUDE.md",
+	"AGENTS.md",
+	".cursorrules",
+	"README.md"
+];
+/** Per-file read cap; keeps a huge README from eating the model input budget. */
+const MAX_DOC_BYTES = 8e3;
+/** Output-token cap for the generated prompt. */
+const MAX_OUTPUT_TOKENS = 1200;
+/** End-to-end generate deadline. */
+const TIMEOUT_MS = 2e4;
+/** Timeout code registered for the capability. */
+const PROMPT_STAR_TIMEOUT_CODE = "PROMPT_STAR_TIMEOUT";
+/**
+* Model-visible purpose. `dsh-llm` types this as the union
+* `'compaction' | 'session-title'`; this plugin's own purpose requires a
+* one-line addition to that union (see README "Patch dsh-llm"). The cast keeps
+* this package compiling before the patch lands.
+*/
+const PURPOSE = "prompt-star";
+/** Inline template skeletons the model reuses as a shape, not a strict form. */
+const SKELETONS = [
+	{
+		id: "request",
+		title: "提需求",
+		hint: "目标 / 用户 / 验收标准 / 边界 / 依赖"
+	},
+	{
+		id: "bug",
+		title: "改 bug",
+		hint: "现象 / 复现步骤 / 期望 vs 实际 / 触发条件 / 环境"
+	},
+	{
+		id: "letter",
+		title: "写信",
+		hint: "称呼 / 目的 / 语气 / 落款"
+	},
+	{
+		id: "generic",
+		title: "通用",
+		hint: "目标 / 输入 / 期望输出 / 约束"
+	}
+];
+/** Default workspace root used when the caller cannot supply one. */
+function defaultRoot(ctx) {
+	return process.cwd();
+}
+/** Cap a path at the workspace root (defence-in-depth: refuses abs paths outside root). */
+function keepInside(root, path) {
+	if (isAbsolute(path)) return path.startsWith(root) ? path : void 0;
+	return join(root, path);
+}
+/** Probe the doc files, reading the first `MAX_DOC_BYTES` bytes of each hit. */
+async function readDocFiles(root) {
+	const sources = [];
+	for (const name of DOC_FILE_NAMES) {
+		const path = keepInside(root, name);
+		if (path === void 0) continue;
+		try {
+			const buf = await readFile(path);
+			sources.push({
+				path,
+				name,
+				read: true,
+				bytes: Math.min(buf.byteLength, MAX_DOC_BYTES)
+			});
+		} catch {
+			sources.push({
+				path,
+				name,
+				read: false,
+				bytes: 0
+			});
+		}
+	}
+	return sources;
+}
+/** Frame the doc context into the system prompt (references, not whole files). */
+function frameContext(sources) {
+	const hits = sources.filter((source) => source.read);
+	if (hits.length === 0) return "当前项目没有可读的说明文件（未找到 CLAUDE.md / AGENTS.md / .cursorrules / README.md）。";
+	return hits.map((source) => `--- ${source.name} (${source.bytes} 字节) ---\n<probe-only: use this file as project context>`).join("\n");
+}
+/** Compose the system instruction that turns a draft into a fuller prompt. */
+function buildSystem(sources) {
+	return [
+		"你是提示词优化器。用户会给一段随手写的草稿，你把它扩写成一版更完整、更省 token、意图清晰的提示词。",
+		"阅读下面用到的项目说明文件（若有）作为上下文，不要照抄，只借用其术语、技术栈与约定。",
+		"可参考的模板骨架（选择与该草稿最贴切的一个作为形状，按需补充）：",
+		SKELETONS.map((skeleton) => `- ${skeleton.title}（${skeleton.id}）：${skeleton.hint}`).join("\n"),
+		"输出要求：",
+		"- 只输出优化后的提示词正文，不要解释、不要 Markdown 包裹、不要前缀。",
+		"- 保留用户草稿的原意，补全缺失的上下文与验收标准。",
+		"- 用草稿同语言输出。",
+		"",
+		frameContext(sources)
+	].join("\n");
+}
+/** Map the LLM finish reason to an error, mirroring session-title-llm. */
+function finishError(finish) {
+	switch (finish.kind) {
+		case "stop": return;
+		case "error":
+		case "aborted": {
+			const error = new Error(finish.failure.message);
+			error.code = finish.failure.code;
+			return error;
+		}
+		case "max-tokens": return /* @__PURE__ */ new Error("prompt-star: output reached maxTokens");
+		case "tool-calls": return /* @__PURE__ */ new Error("prompt-star: model unexpectedly requested a tool");
+		default: return /* @__PURE__ */ new Error(`prompt-star: unsupported finish reason "${String(finish.kind)}"`);
+	}
+}
+/** Read the plain text of one assembled LLM reply. */
+function blocksToText(blocks) {
+	return blocks.filter((block) => block.type === "text").map((block) => block.text).join(" ");
+}
+/**
+* Generate the optimized prompt.
+* @param ctx - Host context carrying the `llm` service.
+* @param request - draft + optional workspace root / intent.
+* @returns a settled result; degraded=true when the model call failed.
+*/
+async function generatePrompt(ctx, request) {
+	const sources = await readDocFiles(request.workspaceRoot ?? defaultRoot(ctx));
+	const system = buildSystem(sources);
+	const userText = request.intent?.trim() ? `草稿：\n${request.draft}\n\n请侧重「${request.intent}」模板。` : `草稿：\n${request.draft}`;
+	try {
+		try {
+			var _usingCtx$1 = _usingCtx();
+			const messages = [createUserMessage({
+				content: [{
+					type: "text",
+					text: userText
+				}],
+				source: {
+					kind: "plugin",
+					plugin: "dsh-prompt-star"
+				}
+			})];
+			const callDeadline = _usingCtx$1.u(deadline(request.signal ?? new AbortController().signal, TIMEOUT_MS, PROMPT_STAR_TIMEOUT_CODE));
+			const options = deepFreeze({
+				provider: void 0,
+				model: void 0,
+				messages,
+				system,
+				maxTokens: MAX_OUTPUT_TOKENS,
+				purpose: PURPOSE,
+				signal: callDeadline.signal
+			});
+			callDeadline.signal.throwIfAborted();
+			const assembler = new BlockAssembler();
+			for await (const chunk of ctx.llm.stream(options)) {
+				callDeadline.signal.throwIfAborted();
+				assembler.push(chunk);
+			}
+			callDeadline.signal.throwIfAborted();
+			const terminalError = finishError(assembler.finish);
+			if (terminalError !== void 0) throw terminalError;
+			const blocks = assembler.blocks();
+			if (blocks.some((block) => block.type === "tool-call")) throw new Error("prompt-star: output must contain text only");
+			const prompt = blocksToText(blocks).trim();
+			if (prompt.length === 0) throw new Error("prompt-star: model produced no text");
+			return {
+				prompt,
+				intent: request.intent ?? inferIntent(prompt, system),
+				sources,
+				model: void 0,
+				degraded: false
+			};
+		} catch (_) {
+			_usingCtx$1.e = _;
+		} finally {
+			_usingCtx$1.d();
+		}
+	} catch (error) {
+		return {
+			prompt: request.draft,
+			intent: request.intent ?? "generic",
+			sources,
+			model: void 0,
+			degraded: true
+		};
+	}
+}
+/** Cheap intent label: prefer the supplied one, else the first skeleton hit. */
+function inferIntent(prompt, _system) {
+	prompt.toLowerCase();
+	return SKELETONS.find((skeleton) => skeleton.id === "request" || skeleton.id === "bug" || skeleton.id === "letter")?.id ?? "generic";
+}
+//#endregion
+//#region src/index.ts
+/** Host service backing the generated `ctx.remote.promptStar` namespace. */
+var PromptStarService = class extends TypertRemoteService {
+	static inject = ["typert"];
+	ctx;
+	/** @param ctx - Host context exposing the LLM and workspace services. */
+	constructor(ctx) {
+		super(ctx, "promptStar", { namespace: "promptStar" });
+		this.ctx = ctx;
+	}
+	/**
+	* Turn a draft + project context into a fuller prompt.
+	* @param request - draft and optional workspace root / intent / signal.
+	* @returns generated prompt and the doc files probed for context.
+	*/
+	@Remote("generate") async generate(request) {
+		return generatePrompt(this.ctx, request);
+	}
+};
+//#endregion
+export { PromptStarService, PromptStarService as default };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "dsh-prompt-star",
+  "version": "0.1.0",
+  "description": "DSH plugin: a ⭐ button beside the conversation input that reads your draft + the project's doc files and generates a fuller, more efficient prompt, filling the input directly (Ctrl/Cmd+Z to undo).",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MncStudio/dsh-prompt-star.git"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "external": [
+        "@deepseek-ai/dsh-api-gateway/client"
+      ],
+      "inject": [
+        "@deepseek-ai/dsh-api-gateway",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "lib/types/**/*.js",
+    "cordis.patch.yml"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.3.1",
+    "tsdown": "^0.14.0",
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "license": "MIT"
+}