dsh-opencode 0.1.4 → 0.1.6

package/lib/commands.js

@@ -1,8 +1,44 @@
-import { PRODUCT_BY_ROUTE, ROUTE_BY_PRODUCT, describeNonReadyState } from "./normalize.js";
+import { ROUTE_BY_PRODUCT, describeNonReadyState } from "./normalize.js";
+import { setupCancelled, setupHelp, setupSaved, setupUsage } from "./shared/language.js";
+import { hostText } from "./language.js";
 //#region src/commands.ts
+/**
+* The host commands this plugin registers.
+*
+* `/opencode-refresh` forces a catalog refresh, `/opencode-status` reports
+* source freshness and counts, and `/opencode-models` lists a product's
+* models, including the non-ready ones with their reasons under `--all`.
+*
+* `/dsh-opencode` returns a short setup instruction on the Host. Secret input is
+* owned by Settings > Models and never arrives through command rawInput.
+*
+* @module opencode-live/commands
+*/
 const USAGE_REFRESH = "Usage: /opencode-refresh [all|zen|go]";
 const USAGE_MODELS = "Usage: /opencode-models <zen|go> [--all]";
-const USAGE_ENABLE = "Usage: /dsh-opencode [status|help]";
+/** User-facing setup guidance; detailed diagnostics belong to /opencode-status. */
+async function setupGuidance(services) {
+	const labels = ["OpenCode Zen", "OpenCode Go"];
+	const results = await Promise.allSettled([services.describeCredential(ROUTE_BY_PRODUCT.zen), services.describeCredential(ROUTE_BY_PRODUCT.go)]);
+	const missing = [];
+	const unknown = [];
+	results.forEach((result, index) => {
+		if (result.status === "rejected" || result.value === void 0) unknown.push(labels[index]);
+		else if (!result.value.configured) missing.push(labels[index]);
+	});
+	if (unknown.length > 0) return {
+		kind: "error",
+		text: `${missing.length > 0 ? `${missing.join(" and ")} API key is not configured.\n` : ""}Could not check the API key settings for ${unknown.join(" and ")}.\n${setupHelp}`
+	};
+	if (missing.length > 0) return {
+		kind: "error",
+		text: `${missing.length === 2 ? "OpenCode" : missing[0]} API key is not configured.\n${setupHelp}`
+	};
+	return {
+		kind: "success",
+		text: setupSaved
+	};
+}
 /** Whether one date stamp renders as a short local time. */
 function renderTime(timestamp) {
 	if (timestamp === void 0) return "never";
@@ -130,24 +166,29 @@ function commandDefinitions(ctx, services) {
 		},
 		{
 			name: "dsh-opencode",
-			description: "Show OpenCode setup and credential status",
+			description: hostText(ctx, "OpenCode settings"),
 			recordInput: false,
 			handler: async (invocation) => {
 				const input = invocation.rawInput.trim();
 				if (input !== "" && input !== "status" && input !== "help") return {
 					kind: "error",
-					text: USAGE_ENABLE
+					text: hostText(ctx, setupUsage)
 				};
-				const routes = [ROUTE_BY_PRODUCT.zen, ROUTE_BY_PRODUCT.go];
 				if (invocation.signal.aborted) return {
 					kind: "success",
-					text: "Refresh cancelled."
+					text: hostText(ctx, setupCancelled)
 				};
-				const lines = ["OpenCode setup status (use the Client setup form to save a key):"];
-				for (const route of routes) lines.push(await productStatus(ctx, services, PRODUCT_BY_ROUTE[route]));
-				return {
+				if (input === "help") return {
 					kind: "success",
-					text: lines.join("\n")
+					text: hostText(ctx, setupHelp)
+				};
+				const result = await setupGuidance(services);
+				return invocation.signal.aborted ? {
+					kind: "success",
+					text: hostText(ctx, setupCancelled)
+				} : {
+					...result,
+					text: hostText(ctx, result.text ?? "")
 				};
 			}
 		}

package/lib/credentials.js

@@ -1,3 +1,4 @@
+import { hostText } from "./language.js";
 import { LlmError, assertUsableApiKey } from "@deepseek-ai/dsh-llm";
 import "@deepseek-ai/dsh-credentials";
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
@@ -6,8 +7,8 @@ import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
 * Resolve the API key for one inference call.
 *
 * Mirrors the fail-loud reference semantics of the DSH pi-ai adapter: a named
-* reference that misses throws `MISSING_CREDENTIAL` naming the route and the
-* reference, never a key fragment, and never falls back to an ambient key
+* reference that misses throws `MISSING_CREDENTIAL` with a settings instruction,
+* never a key fragment, and never falls back to an ambient key
 * another provider might have left in the environment.
 * @param ctx - the plugin context carrying the optional credential service.
 * @param route - the live route the credential is resolved for.
@@ -21,7 +22,7 @@ async function resolveApiKeyFor(ctx, route, profile) {
 	const credentials = ctx.get("credentials");
 	const hit = credentials !== void 0 ? (await credentials.resolve(ref))?.value : launchEnvironmentOf(ctx).get(ref)?.value;
 	if (hit !== void 0 && hit.length > 0) return assertUsableApiKey(hit, "opencode-live", ref);
-	throw new LlmError(`opencode-live: no credential for provider route "${route}"; its profile resolves ${ref}, which is not set — store it through the credentials service (the web Models page writes it) or export it in the launching environment`, "MISSING_CREDENTIAL");
+	throw new LlmError(`${profile.displayName}: ${hostText(ctx, "The API key is not configured. Enter it in Settings > Models, click \"Save API key\", then send your message again.")}`, "MISSING_CREDENTIAL");
 }
 /**
 * Api-key auth for a route the plugin authenticates itself.

package/lib/language.js

@@ -0,0 +1,8 @@
+import { localePreference, resolveLanguage, translate } from "./shared/language.js";
+//#region src/language.ts
+/** Optional settings must never become a prerequisite for command registration. */
+function hostText(ctx, text) {
+	return translate(text, resolveLanguage(localePreference(ctx.get?.("settings")?.get("locale")), process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG));
+}
+//#endregion
+export { hostText };

package/lib/shared/language.js

@@ -0,0 +1,78 @@
+//#region src/shared/language.ts
+/** Explicit DSH preference wins; otherwise use the primary browser/OS locale. */
+function resolveLanguage(preference, fallback) {
+	const locale = typeof preference === "string" && preference.trim() ? preference : fallback;
+	return /^ja(?:[-_.@]|$)/i.test(locale?.trim() ?? "") ? "ja" : "en";
+}
+function localePreference(value) {
+	return typeof value === "object" && value !== null && "preference" in value ? value.preference : void 0;
+}
+const setupHelp = [
+	"1. Open Settings > Models.",
+	"2. Enter your API key in the OpenCode provider you want to use.",
+	"3. Click \"Save API key\"."
+].join("\n");
+const setupUsage = "Enter your API key in Settings > Models, not in chat.";
+const setupSaved = "Your OpenCode API key is saved. Choose an OpenCode model from the model picker at the bottom right of the chat.";
+const setupCancelled = "The check was cancelled.";
+/** English source copy is the key. Only our known copy is translated. */
+const japanese = {
+	"OpenCode settings": "OpenCode の設定",
+	"Close": "閉じる",
+	"OpenCode API key": "OpenCode APIキー",
+	"Key saved — enter a new key to replace it": "保存済みです。変更する場合は新しいキーを入力してください",
+	"Paste your OpenCode API key": "OpenCodeのAPIキーを貼り付けてください",
+	"This key is shared by OpenCode Zen and Go. Deleting it removes the key for both providers.": "このキーはOpenCode ZenとGoで共有しています。削除すると両方のキー設定が解除されます。",
+	"Checking credential status…": "APIキーの設定を確認しています…",
+	"Saving…": "保存中…",
+	"Save API key": "APIキーを保存",
+	"Deleting…": "削除中…",
+	"Delete API key": "APIキーを削除",
+	"Clear input": "入力を消去",
+	"The credential check was cancelled.": "APIキーの確認をキャンセルしました。",
+	"The configured credential reference is unavailable.": "APIキーの保存先を確認できませんでした。",
+	"Could not check whether an API key is saved.": "APIキーが保存されているか確認できませんでした。",
+	"Could not load settings or credential status.": "設定またはAPIキーの状態を読み込めませんでした。",
+	"The settings form was closed.": "設定画面が閉じられました。",
+	"The settings form was closed. Open it again and retry.": "設定画面が閉じられました。開き直して再試行してください。",
+	"The API key settings changed. Check which providers share the key and retry.": "APIキーの設定が変更されました。キーを共有するプロバイダーを確認して再試行してください。",
+	"This credential is read-only. Remove it from the environment that launches DSH.": "このAPIキーは読み取り専用です。DSHを起動する環境の設定から削除してください。",
+	"This credential is already being updated.": "このAPIキーは更新中です。完了後に再試行してください。",
+	"Could not delete the API key. Try again.": "APIキーを削除できませんでした。再試行してください。",
+	"The deletion request succeeded, but the key status could not be confirmed. Reload Settings > Models.": "削除リクエストは成功しましたが、キーの状態を確認できませんでした。Settings > Modelsを開き直してください。",
+	"The saved key was removed, but an API key is still configured. Check its source in Settings > Models.": "保存したキーは削除されましたが、別のAPIキー設定が残っています。Settings > Modelsで設定元を確認してください。",
+	"API key deleted for OpenCode Zen and Go.": "OpenCode ZenとGoの共有APIキーを削除しました。",
+	"API key deleted.": "APIキーを削除しました。",
+	"Paste the API key only, without quotes or an environment-variable assignment.": "引用符や環境変数の代入式を含めず、APIキーだけを貼り付けてください。",
+	"The credential reference changed. Reload its status and retry.": "APIキーの保存先が変更されました。状態を読み込み直して再試行してください。",
+	"This credential is read-only. Update it in the environment that launches DSH.": "このAPIキーは読み取り専用です。DSHを起動する環境の設定で変更してください。",
+	"Could not save the API key.": "APIキーを保存できませんでした。",
+	"The API key is not configured. Enter it in Settings > Models, click \"Save API key\", then send your message again.": "APIキーが未設定です。Settings > ModelsでAPIキーを入力して「APIキーを保存」を押してから、もう一度送信してください。",
+	"API key saved.": "APIキーを保存しました。",
+	"The key was saved, but its status could not be confirmed.": "APIキーを保存しましたが、保存後の状態を確認できませんでした。",
+	"1. Open Settings > Models.": "1. Settings > Modelsを開きます。",
+	"2. Enter your API key in the OpenCode provider you want to use.": "2. 使用するOpenCodeの欄にAPIキーを入力します。",
+	"3. Click \"Save API key\".": "3. 「APIキーを保存」を押してください。",
+	[setupUsage]: "APIキーはチャットに入力せず、Settings > Modelsから設定してください。",
+	[setupSaved]: "OpenCodeのAPIキーは保存されています。チャット右下のモデル選択から、使いたいOpenCodeのモデルを選んでください。",
+	[setupCancelled]: "確認をキャンセルしました。"
+};
+for (const label of [
+	"OpenCode",
+	"OpenCode Zen",
+	"OpenCode Go",
+	"OpenCode Zen and OpenCode Go"
+]) {
+	const jaLabel = label.replace(" and ", "・");
+	japanese[`${label} API key is not configured.`] = `${jaLabel}のAPIキーが未設定です。`;
+	japanese[`Could not check the API key settings for ${label}.`] = `${jaLabel}のAPIキー設定を確認できませんでした。`;
+}
+const english = new Map(Object.entries(japanese).map(([en, ja]) => [ja, en]));
+function translate(text, language) {
+	return text.split("\n").map((line) => {
+		const source = english.get(line) ?? line;
+		return language === "ja" ? japanese[source] ?? line : source;
+	}).join("\n");
+}
+//#endregion
+export { localePreference, resolveLanguage, setupCancelled, setupHelp, setupSaved, setupUsage, translate };

package/lib/transport.js

@@ -27,7 +27,7 @@ import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.l
 */
 /** The plugin's honest client identification value. */
 const PLUGIN_ID = "opencode-live";
-const PLUGIN_VERSION = "0.1.3";
+const PLUGIN_VERSION = "0.1.5";
 /** Header OpenCode Go documents for coding-agent session identification. */
 const SESSION_HEADER = "x-opencode-session";
 /** Header carrying this plugin's honest client identity alongside DSH attribution. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-opencode",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Out-of-tree DSH bundle with live dynamic OpenCode Zen / Go model catalogs",
   "private": false,
   "license": "MIT",
@@ -45,16 +45,11 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-commands",
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-layout",
-        "@deepseek-ai/dsh-client-ui-commands",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-models",
-        "@deepseek-ai/dsh-client-ui-primitives",
-        "@deepseek-ai/dsh-client-ui-slots",
         "@deepseek-ai/dsh-client-ui-renderer",
-        "@deepseek-ai/dsh-client-store"
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-commands"
       ]
     }
   },