dsh-select-quote 0.3.17 → 0.3.19

package/lib/index.js

@@ -899,15 +899,17 @@ defineMethod("transform", [
 */
 const PACKAGE_NAME = "dsh-select-quote";
 //#endregion
-//#region src/shared/side-task-remote.ts
+//#region src/shared/plugin-remote.ts
 /**
 * Wire contract shared by the two halves.
 *
-* The Host owns the implementation (`ctx.selectQuoteSideTask`); the browser
-* mounts the same descriptor group through `ctx.remote.$mount(...)`. Both
-* schemas are written here so the argument shapes cannot drift apart.
+* The Host owns the implementations (`ctx.selectQuoteSideTask`,
+* `ctx.selectQuoteTranslate`); the browser mounts the same descriptor group
+* through `ctx.remote.$mount(...)`. Both schemas are written here so the
+* argument shapes cannot drift apart.
 */
 const SIDE_TASK_SERVICE = "selectQuoteSideTask";
+const TRANSLATE_SERVICE = "selectQuoteTranslate";
 //#endregion
 //#region src/shared/side-task-reuse.ts
 /**
@@ -945,8 +947,8 @@ function isNotResumable(error) {
 * It is a plain string (not a Symbol), so a third-party package can publish the
 * same marker without importing the protocol package at runtime.
 */
-const REMOTE_METHOD_DESCRIPTOR = "@deepseek-ai/dsh-typert-protocol/remote-methods";
-const REMOTE_METHODS = Object.freeze({
+const REMOTE_METHOD_DESCRIPTOR$1 = "@deepseek-ai/dsh-typert-protocol/remote-methods";
+const REMOTE_METHODS$1 = Object.freeze({
 	version: 1,
 	methods: Object.freeze([Object.freeze({
 		method: "create",
@@ -1016,7 +1018,280 @@ var SelectQuoteSideTask = class extends Service {
 		})).childId };
 	}
 };
-Object.defineProperty(SelectQuoteSideTask.prototype, REMOTE_METHOD_DESCRIPTOR, {
+Object.defineProperty(SelectQuoteSideTask.prototype, REMOTE_METHOD_DESCRIPTOR$1, {
+	configurable: true,
+	value: REMOTE_METHODS$1
+});
+//#endregion
+//#region src/translate-service.ts
+/**
+* Host face of the translation entry point.
+*
+* The browser owns the popover, language choice, and the prompt (built-in or
+* the user's custom text). This service only resolves the route, calls the
+* provider once, and streams the text back. No subagent and no session
+* context: the model receives exactly the system prompt plus the selected
+* passage.
+*
+* Thinking is requested off. A route that cannot disable it keeps its own
+* default; the stream then announces `thinking` so the popover can show a
+* reasoning loader instead of a frozen spinner.
+*/
+const REMOTE_METHOD_DESCRIPTOR = "@deepseek-ai/dsh-typert-protocol/remote-methods";
+const REMOTE_METHODS = Object.freeze({
+	version: 1,
+	methods: Object.freeze([Object.freeze({
+		method: "translate",
+		mode: "stream",
+		invocation: Object.freeze({ kind: "direct" })
+	})])
+});
+/** Generous enough for a reasoning model to answer one bounded passage. */
+const TIMEOUT_MS = 9e4;
+const MAX_TEXT_CHARS = 8e3;
+const MAX_PROMPT_CHARS = 8e3;
+const LANGUAGES = /* @__PURE__ */ new Set([
+	"zh",
+	"en",
+	"ja",
+	"es",
+	"fr",
+	"de",
+	"ru",
+	"pt"
+]);
+var SelectQuoteTranslate = class extends Service {
+	/** Visible binding the Gateway's source-mode discovery requires. */
+	typertRemote;
+	constructor(ctx) {
+		super(ctx, TRANSLATE_SERVICE);
+		this.typertRemote = Object.freeze({
+			service: this,
+			serviceKey: TRANSLATE_SERVICE,
+			namespace: TRANSLATE_SERVICE
+		});
+	}
+	async *translate(agent, request, signal) {
+		const services = this.ctx;
+		const log = loggerOf(services.logger);
+		const meta = {
+			target: request.target,
+			chars: request.text.length,
+			provider: request.provider,
+			model: request.model
+		};
+		const controller = new AbortController();
+		let timedOut = false;
+		const abortFromCaller = () => {
+			controller.abort(signal?.reason);
+		};
+		const timer = setTimeout(() => {
+			timedOut = true;
+			controller.abort(/* @__PURE__ */ new Error("translation timed out"));
+		}, TIMEOUT_MS);
+		if (signal?.aborted) abortFromCaller();
+		else signal?.addEventListener("abort", abortFromCaller, { once: true });
+		try {
+			if (request.text.trim().length === 0) throw new Error("nothing to translate");
+			if (request.text.length > MAX_TEXT_CHARS) throw new Error("the selection is too long to translate");
+			if (request.prompt.trim().length === 0) throw new Error("the translation prompt is empty");
+			if (request.prompt.length > MAX_PROMPT_CHARS) throw new Error("the translation prompt is too long");
+			if (!LANGUAGES.has(request.target)) throw new Error("unsupported translation target");
+			const llm = services.llm;
+			if (llm === void 0) throw new Error("the model service is unavailable");
+			const route = resolveRoute(agent, request, services);
+			if (route === void 0) throw new Error("no translation model is available");
+			meta.provider = route.provider;
+			meta.model = route.model;
+			controller.signal.throwIfAborted();
+			const call = await prepareCall(llm, route, controller.signal, log);
+			controller.signal.throwIfAborted();
+			const effort = call.config.reasoningEffort;
+			let thinking = typeof effort === "string" && effort !== "off";
+			if (thinking) log?.debug("dsh-select-quote: translation keeps reasoning on for %s/%s", route.provider, route.model);
+			yield {
+				type: "thinking",
+				active: thinking
+			};
+			const messages = [{
+				id: randomUUID(),
+				role: "user",
+				content: [{
+					type: "text",
+					text: request.text
+				}],
+				source: { kind: "dsh-select-quote" }
+			}];
+			const options = {
+				...call.config,
+				messages,
+				system: request.prompt,
+				sessionId: agent.id,
+				purpose: "select-quote-translate",
+				signal: controller.signal
+			};
+			let accumulated = "";
+			let reasoning = "";
+			let failure;
+			for await (const chunk of call.stream(options)) {
+				controller.signal.throwIfAborted();
+				if (chunk.type === "reasoning-delta") {
+					const delta = chunk.text ?? "";
+					if (delta.length === 0) continue;
+					if (!thinking) {
+						thinking = true;
+						yield {
+							type: "thinking",
+							active: true
+						};
+					}
+					reasoning += delta;
+					yield {
+						type: "reasoning",
+						text: reasoning
+					};
+				} else if (chunk.type === "block-end" && chunk.block?.type === "reasoning") {
+					const full = chunk.block.text ?? "";
+					if (full.length === 0 || reasoning.length > 0) continue;
+					if (!thinking) {
+						thinking = true;
+						yield {
+							type: "thinking",
+							active: true
+						};
+					}
+					reasoning = full;
+					yield {
+						type: "reasoning",
+						text: reasoning
+					};
+				} else if (chunk.type === "text-delta") {
+					const delta = chunk.text ?? "";
+					if (delta.length === 0) continue;
+					if (thinking) {
+						thinking = false;
+						yield {
+							type: "thinking",
+							active: false
+						};
+					}
+					accumulated += delta;
+					yield {
+						type: "text",
+						text: accumulated
+					};
+				} else if (chunk.type === "block-end" && chunk.block?.type === "text") {
+					const full = chunk.block.text ?? "";
+					if (full.length === 0 || accumulated.length > 0) continue;
+					if (thinking) {
+						thinking = false;
+						yield {
+							type: "thinking",
+							active: false
+						};
+					}
+					accumulated = full;
+					yield {
+						type: "text",
+						text: accumulated
+					};
+				} else if (chunk.type === "finish") failure = chunk.reason;
+			}
+			controller.signal.throwIfAborted();
+			if (failure?.kind === "error" || failure?.kind === "aborted") {
+				const code = failure.failure?.code;
+				const message = failure.failure?.message;
+				throw new Error(code === void 0 ? message === void 0 ? "translation failed" : trimMessage(message) : `${code}: ${trimMessage(message ?? "translation failed")}`);
+			}
+			const translated = accumulated.trim();
+			if (translated.length === 0) throw new Error(failure?.kind === "max-tokens" ? "the model ran out of output tokens before returning a translation" : "the model returned no translation");
+			if (failure?.kind === "max-tokens") log?.warn("dsh-select-quote: translation truncated at the output limit for %s/%s", route.provider, route.model);
+			else if (failure?.kind !== void 0 && failure.kind !== "stop") log?.warn("dsh-select-quote: translation finished with %s for %s/%s", failure.kind, route.provider, route.model);
+			yield {
+				type: "done",
+				text: translated
+			};
+		} catch (error) {
+			if (timedOut) {
+				const timeout = /* @__PURE__ */ new Error("translation timed out");
+				logFailure(log, meta, timeout, routeOf(meta));
+				throw timeout;
+			}
+			if (signal?.aborted) {
+				log?.debug("dsh-select-quote: translation cancelled by the client");
+				throw error;
+			}
+			logFailure(log, meta, error, routeOf(meta));
+			throw error;
+		} finally {
+			clearTimeout(timer);
+			signal?.removeEventListener("abort", abortFromCaller);
+		}
+	}
+};
+/** Prefer disabled thinking; fall back to the provider default when rejected. */
+async function prepareCall(llm, route, signal, log) {
+	try {
+		return await llm.prepareCall({
+			provider: route.provider,
+			model: route.model,
+			reasoningEffort: "off"
+		}, signal);
+	} catch (error) {
+		signal.throwIfAborted();
+		log?.debug("dsh-select-quote: thinking cannot be disabled for %s/%s (%s); using the model default", route.provider, route.model, describe(error));
+		return llm.prepareCall(route, signal);
+	}
+}
+/** Explicit config route wins; otherwise follow the conversation's own model. */
+function resolveRoute(agent, request, services) {
+	if (request.provider !== void 0 && request.model !== void 0) return {
+		provider: request.provider,
+		model: request.model
+	};
+	const live = agent.options;
+	if (live?.provider !== void 0 && live.model !== void 0) return {
+		provider: live.provider,
+		model: live.model
+	};
+	const current = services.get("agentDefaultModel")?.currentSelection();
+	if (current?.provider !== void 0 && current.model !== void 0) return {
+		provider: current.provider,
+		model: current.model
+	};
+}
+/** Resolve the callable logger facade (`ctx.logger` is callable in Cordis). */
+function loggerOf(source) {
+	if (typeof source === "function") try {
+		return source("dsh-select-quote");
+	} catch {
+		return;
+	}
+	return source;
+}
+function routeOf(meta) {
+	return `${meta.provider ?? "?"}/${meta.model ?? "?"}`;
+}
+function logFailure(log, meta, error, route) {
+	log?.warn("dsh-select-quote: translation failed %o", {
+		target: meta.target,
+		chars: meta.chars,
+		route,
+		error: describe(error)
+	});
+}
+function trimMessage(message) {
+	const oneLine = message.replace(/\s+/g, " ").trim();
+	return oneLine.length > 240 ? `${oneLine.slice(0, 239)}…` : oneLine;
+}
+function describe(error) {
+	if (error instanceof Error) {
+		const code = error.code;
+		return typeof code === "string" ? `${code}: ${error.message}` : error.message;
+	}
+	return String(error);
+}
+Object.defineProperty(SelectQuoteTranslate.prototype, REMOTE_METHOD_DESCRIPTOR, {
 	configurable: true,
 	value: REMOTE_METHODS
 });
@@ -1030,13 +1305,30 @@ const Config = Schema.object({
 	]).default("auto").volatile(),
 	toolbarPlacement: Schema.union(["above", "below"]).default("above").volatile(),
 	shortcut: Schema.boolean().default(false).volatile(),
-	sideTaskMode: Schema.union(["separate", "reuse"]).default("separate").volatile()
+	sideTaskMode: Schema.union(["separate", "reuse"]).default("separate").volatile(),
+	translateTarget: Schema.union([
+		"auto",
+		"zh",
+		"en",
+		"ja",
+		"es",
+		"fr",
+		"de",
+		"ru",
+		"pt"
+	]).default("auto").volatile(),
+	translateProvider: Schema.string().default("").volatile(),
+	translateModel: Schema.string().default("").volatile(),
+	translatePrompt: Schema.string().default("").volatile()
 });
 const name = PACKAGE_NAME;
 function apply(ctx, _config) {
 	ctx.inject(["subagents"], (scope) => {
 		new SelectQuoteSideTask(scope);
 	});
+	ctx.inject(["llm"], (scope) => {
+		new SelectQuoteTranslate(scope);
+	});
 }
 //#endregion
 export { Config, apply, name };

package/lib/typert.js

@@ -13671,29 +13671,32 @@ function createRemoteInfo(spec, zod) {
 	};
 }
 //#endregion
-//#region src/shared/side-task-remote.ts
+//#region src/shared/plugin-remote.ts
 /**
 * Wire contract shared by the two halves.
 *
-* The Host owns the implementation (`ctx.selectQuoteSideTask`); the browser
-* mounts the same descriptor group through `ctx.remote.$mount(...)`. Both
-* schemas are written here so the argument shapes cannot drift apart.
+* The Host owns the implementations (`ctx.selectQuoteSideTask`,
+* `ctx.selectQuoteTranslate`); the browser mounts the same descriptor group
+* through `ctx.remote.$mount(...)`. Both schemas are written here so the
+* argument shapes cannot drift apart.
 */
 const SIDE_TASK_SERVICE = "selectQuoteSideTask";
 const SIDE_TASK_METHOD = `${SIDE_TASK_SERVICE}/create`;
+const TRANSLATE_SERVICE = "selectQuoteTranslate";
+const TRANSLATE_METHOD = `${TRANSLATE_SERVICE}/translate`;
 const modelShape = () => ({
 	provider: string$1(),
 	model: string$1(),
 	reasoningEffort: string$1().optional()
 });
-const requestSchema = () => object({
+const sideRequestSchema = () => object({
 	prompt: string$1(),
 	label: string$1().optional(),
 	model: object(modelShape()).optional(),
 	/** Continue the parent's one side-task child instead of forking a new one. */
 	reuse: boolean$1().optional()
 });
-const strictRequestSchema = () => strictObject({
+const strictSideRequestSchema = () => strictObject({
 	prompt: string$1(),
 	label: string$1().optional(),
 	model: strictObject(modelShape()).optional(),
@@ -13709,96 +13712,186 @@ const modelJsonSchema = (additionalProperties) => ({
 	required: ["provider", "model"],
 	additionalProperties
 });
-const resultSchema = () => object({ childId: string$1() });
-function createSideTaskRemote() {
+const translateRouteShape = () => ({
+	provider: string$1().optional(),
+	model: string$1().optional()
+});
+const translateRequestSchema = () => object({
+	text: string$1(),
+	target: string$1(),
+	/** Resolved instructions: built-in or the user's custom prompt. */
+	prompt: string$1(),
+	...translateRouteShape()
+});
+const strictTranslateRequestSchema = () => strictObject({
+	text: string$1(),
+	target: string$1(),
+	prompt: string$1(),
+	...translateRouteShape()
+});
+const translateJsonSchema = (additionalProperties) => ({
+	type: "object",
+	properties: {
+		text: { type: "string" },
+		target: { type: "string" },
+		prompt: { type: "string" },
+		provider: { type: "string" },
+		model: { type: "string" }
+	},
+	required: [
+		"text",
+		"target",
+		"prompt"
+	],
+	additionalProperties
+});
+/** The owning live agent, resolved by the Gateway from the session id. */
+const agentParameter = () => ({
+	name: "agent",
+	wire: "agentId",
+	description: "owning live agent.",
+	source: "lookup",
+	lookup: "agent",
+	codec: {
+		mode: "strict",
+		typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+		create: () => string$1(),
+		jsonSchema: { type: "string" }
+	},
+	strictCodec: {
+		mode: "strict",
+		typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
+		create: () => string$1(),
+		jsonSchema: { type: "string" }
+	}
+});
+function createPluginRemote() {
 	return createRemoteInfo({
 		package: PACKAGE_NAME,
-		methods: { [SIDE_TASK_METHOD]: {
-			service: SIDE_TASK_SERVICE,
-			description: "Start a fork-backed side task for one live agent.",
-			invocation: { kind: "direct" },
-			scope: {
-				context: "agent",
-				wire: "agentId"
-			},
-			parameters: [{
-				name: "agent",
-				wire: "agentId",
-				description: "owning live agent.",
-				source: "lookup",
-				lookup: "agent",
-				codec: {
-					mode: "strict",
-					typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
-					create: () => string$1(),
-					jsonSchema: { type: "string" }
+		methods: {
+			[SIDE_TASK_METHOD]: {
+				service: SIDE_TASK_SERVICE,
+				description: "Start a fork-backed side task for one live agent.",
+				invocation: { kind: "direct" },
+				scope: {
+					context: "agent",
+					wire: "agentId"
 				},
-				strictCodec: {
-					mode: "strict",
-					typeSymbol: "@deepseek-ai/dsh-session/types#SessionId",
-					create: () => string$1(),
-					jsonSchema: { type: "string" }
-				}
-			}, {
-				name: "request",
-				description: "initial prompt, display label, optional child model, and whether to reuse the side child.",
-				source: "json",
-				codec: {
+				parameters: [agentParameter(), {
+					name: "request",
+					description: "initial prompt, display label, optional child model, and whether to reuse the side child.",
+					source: "json",
+					codec: {
+						mode: "strict",
+						typeSymbol: "dsh-select-quote#SideTaskRequest",
+						create: sideRequestSchema,
+						jsonSchema: {
+							type: "object",
+							properties: {
+								prompt: { type: "string" },
+								label: { type: "string" },
+								model: modelJsonSchema(true),
+								reuse: { type: "boolean" }
+							},
+							required: ["prompt"],
+							additionalProperties: true
+						}
+					},
+					strictCodec: {
+						mode: "strict",
+						typeSymbol: "dsh-select-quote#SideTaskRequest",
+						create: strictSideRequestSchema,
+						jsonSchema: {
+							type: "object",
+							properties: {
+								prompt: { type: "string" },
+								label: { type: "string" },
+								model: modelJsonSchema(false),
+								reuse: { type: "boolean" }
+							},
+							required: ["prompt"],
+							additionalProperties: false
+						}
+					}
+				}],
+				result: {
 					mode: "strict",
-					typeSymbol: "dsh-select-quote#SideTaskRequest",
-					create: requestSchema,
+					typeSymbol: "dsh-select-quote#SideTaskCreateResult",
+					create: () => object({ childId: string$1() }),
+					description: "the created child session id.",
 					jsonSchema: {
 						type: "object",
-						properties: {
-							prompt: { type: "string" },
-							label: { type: "string" },
-							model: modelJsonSchema(true),
-							reuse: { type: "boolean" }
-						},
-						required: ["prompt"],
-						additionalProperties: true
+						properties: { childId: { type: "string" } },
+						required: ["childId"],
+						additionalProperties: false
 					}
 				},
-				strictCodec: {
+				sourceLocation: {
+					file: "src/side-task-service.ts",
+					line: 1,
+					column: 1
+				}
+			},
+			[TRANSLATE_METHOD]: {
+				service: TRANSLATE_SERVICE,
+				description: "Stream one translation of a selected passage with a direct model call.",
+				invocation: { kind: "direct" },
+				/** Live stream: thinking state, growing text snapshots, then the final text. */
+				mode: "stream",
+				cancellation: { parameter: "signal" },
+				scope: {
+					context: "agent",
+					wire: "agentId"
+				},
+				parameters: [agentParameter(), {
+					name: "request",
+					description: "selected text, target language, resolved instructions, and optional model route.",
+					source: "json",
+					codec: {
+						mode: "strict",
+						typeSymbol: "dsh-select-quote#TranslateRequest",
+						create: translateRequestSchema,
+						jsonSchema: translateJsonSchema(true)
+					},
+					strictCodec: {
+						mode: "strict",
+						typeSymbol: "dsh-select-quote#TranslateRequest",
+						create: strictTranslateRequestSchema,
+						jsonSchema: translateJsonSchema(false)
+					}
+				}],
+				result: {
 					mode: "strict",
-					typeSymbol: "dsh-select-quote#SideTaskRequest",
-					create: strictRequestSchema,
+					typeSymbol: "dsh-select-quote#TranslateStreamEvent",
+					create: () => object({
+						type: string$1(),
+						text: string$1().optional(),
+						active: boolean$1().optional()
+					}),
+					description: "streamed translation events.",
 					jsonSchema: {
 						type: "object",
 						properties: {
-							prompt: { type: "string" },
-							label: { type: "string" },
-							model: modelJsonSchema(false),
-							reuse: { type: "boolean" }
+							type: { type: "string" },
+							text: { type: "string" },
+							active: { type: "boolean" }
 						},
-						required: ["prompt"],
+						required: ["type"],
 						additionalProperties: false
 					}
+				},
+				sourceLocation: {
+					file: "src/translate-service.ts",
+					line: 1,
+					column: 1
 				}
-			}],
-			result: {
-				mode: "strict",
-				typeSymbol: "dsh-select-quote#SideTaskCreateResult",
-				create: resultSchema,
-				description: "the created child session id.",
-				jsonSchema: {
-					type: "object",
-					properties: { childId: { type: "string" } },
-					required: ["childId"],
-					additionalProperties: false
-				}
-			},
-			sourceLocation: {
-				file: "src/side-task-service.ts",
-				line: 1,
-				column: 1
 			}
-		} }
+		}
 	}, external_exports);
 }
 //#endregion
 //#region src/typert.ts
-const $remote = createSideTaskRemote();
+const $remote = createPluginRemote();
 /**
 * Host-face Typert contribution.
 *

package/locale/de.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Auswahlanmerkungen",
-    "description": "Zitiere ausgewählten Text aus dem Gespräch in deiner nächsten Nachricht: Die Auswahl bleibt im Original markiert, und das Modell antwortet auf jede Stelle."
+    "description": "Zitiere ausgewählten Text in deiner nächsten Nachricht, frage in einer Seitenaufgabe nach oder übersetze ihn direkt: Die Auswahl bleibt im Original markiert, und das Modell antwortet auf jede Stelle."
   }
 }

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Selection Annotations",
-    "description": "Quote text from the conversation into your next message: the selection stays marked in the source and the model points back at it."
+    "description": "Quote text from the conversation into your next message, ask in a sidebar subagent, or translate the selection in place: the selection stays marked in the source and the model points back at it."
   }
 }

package/locale/es.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Anotaciones de selección",
-    "description": "Cita texto de la conversación en tu próximo mensaje: la selección queda marcada en el original y el modelo responde a cada fragmento."
+    "description": "Cita el texto seleccionado en el próximo mensaje, pregunta en una tarea lateral o tradúcelo en el sitio: la selección queda marcada en el original y el modelo responde a cada fragmento."
   }
 }

package/locale/fr.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Annotations de sélection",
-    "description": "Citez le texte sélectionné de la conversation dans votre prochain message : la sélection reste marquée dans l’original et le modèle répond à chaque passage."
+    "description": "Citez le texte sélectionné dans votre prochain message, posez une question dans une tâche latérale ou traduisez-le sur place : la sélection reste marquée dans l’original et le modèle répond à chaque passage."
   }
 }

package/locale/ja.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "選択範囲の注釈",
-    "description": "会話で選んだ原文を次のメッセージに持ち込みます。原文にはマークが残り、モデルは各部分に個別に応答できます。"
+    "description": "会話で選んだ原文を次のメッセージに持ち込むか、サイドで質問するか、その場で翻訳できます。原文にはマークが残り、モデルは各部分に個別に応答できます。"
   }
 }