@huaweidevtools/aishell-dsh-llm 0.0.2 → 0.0.4

package/README.md

@@ -4,6 +4,10 @@ OpenAI-compatible LLM adapter for DSH. Registers the `aishell` provider route on
 
 Besides the live route, the plugin declares `aishell` in the configurable-provider directory (`ctx.llm.registerConfigurableProviders`) — the directory the Models page joins with live routes, so the route shows up as a configurable provider row with its own settings address. The plugin also carries a Config schema; the settings mirror only lists namespaces whose plugin declares one, so without it the Models page would not show the row.
 
+## The Models-page row
+
+The row itself is read-only: the profile has no fields the host editor knows how to write, and credentials are entered through the form the `aishell-credentials` chips open (the account chip beside the chat input, or the chip on a New Session page). The browser half therefore does not extend the row with a card — it shadows the row's header at runtime (`src/client/provider-row-shadow.ts`, the same approach `aishell-brand` uses for its digest-protected host residues): a status dot after the row's name (green when AK/SK are stored, warn when they are not, with the readiness copy as its hover title) and the header's Edit button hidden, because there is nothing to edit. A MutationObserver keeps the shadow applied across the page's re-renders; the shadow is re-installed on a locale switch so the hover copy follows the active language; disabling the plugin restores the official row exactly.
+
 ## How it works
 
 ```
@@ -76,7 +80,7 @@ The three image fields share `dsh-llm-pi-ai`'s defaults: the gateway publishes n
 
 ## Storing credentials
 
-**Web UI (recommended):** Install `aishell-credentials` (or the `aishell-base` bundle) — the Settings page gets an "AI Shell" section with AK/SK/SecurityToken input fields. Values are transferred to the credential store.
+**Web UI (recommended):** Install `aishell-credentials` (or the `aishell-base` bundle) — clicking the credentials button beside the chat input (or the one on a New Session page) opens a form with AK/SK/SecurityToken fields. Values are verified against Huawei Cloud IAM and transferred to the credential store; the button flips to the account name when they are stored.
 
 **CLI fallback:**
 

package/lib/client.js

@@ -1,221 +1,234 @@
 window.__ModuleLoader__.load({ id: "@huaweidevtools/aishell-dsh-llm", factory: (require) => {
 "use strict";
 var module = { exports: {} }; var exports = module.exports;
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const __deepseek_ai_dsh_client_store = __toESM(require("@deepseek-ai/dsh-client-store"));
-const react = __toESM(require("react"));
-const react_jsx_runtime = __toESM(require("react/jsx-runtime"));
 
-//#region src/client/ProviderCard.tsx
+//#region src/provider-name.ts
 /**
-* Render the aishell family's card extension.
+* The aishell provider's display name, shared by both plugin halves.
+*
+* The Host half registers it on the configurable-provider directory (the
+* Models page renders it as the provider row's name), and the browser half's
+* row shadow finds that row by matching the rendered name against this
+* literal (see `client/provider-row-shadow.ts`). It must stay a single
+* literal string — the shadow compares `textContent` with it.
 *
-* The parent renders this inside the host editor's card (below its fallback
-* hint), so the visual style follows the surrounding card rather than opening
-* a panel of its own: one readiness line and one catalog list, no buttons —
-* the host card's Cancel stays the only control. Readiness folds the
-* credential fact into a single conclusion (the question this page asks is
-* "can I use this provider", not "what are my credentials"); details and
-* management of credentials belong to the AI Shell settings section, which
-* the unconfigured hint names.
+* It is also the name `providerInfo()` reports, so the picker and the Models
+* row call the route the same thing: this package's whole surface is one
+* product, and qualifying it by cloud ("AI Shell (Huawei Cloud)") added a
+* distinction no reader needed — there is no second AI Shell to tell it
+* apart from.
 */
+const PROVIDER_DISPLAY_NAME = "AI Shell";
+
+//#endregion
+//#region src/client/provider-row-shadow.ts
+/** Marker attribute the dot carries (exposed for the spec). */
+const ROW_DOT_MARKER = "data-aishell-provider-dot";
+/** Marker attribute a hidden Edit button carries (exposed for the spec). */
+const ROW_EDIT_HIDDEN = "data-aishell-edit-hidden";
+/** The dot's own CSS: the host credential dot's geometry and palette. */
+const ROW_DOT_CSS = [
+	`[class*="rowIdentity"] [${ROW_DOT_MARKER}] {`,
+	"  box-sizing: border-box;",
+	"  border-radius: 50%;",
+	"  flex: none;",
+	"  width: 8px;",
+	"  height: 8px;",
+	"  display: inline-block;",
+	"}",
+	`[class*="rowIdentity"] [${ROW_DOT_MARKER}="ok"] {`,
+	"  background: var(--dsw-alias-state-success-primary);",
+	"}",
+	`[class*="rowIdentity"] [${ROW_DOT_MARKER}="warn"] {`,
+	"  background: var(--dsw-alias-state-warn-label);",
+	"}",
+	`[${ROW_EDIT_HIDDEN}] {`,
+	"  display: none !important;",
+	"}"
+].join("\n");
+/** Every Edit button an aishell row renders (there is ordinarily one; a
+* re-render that leaves a second copy gets both, so none stays visible). */
+function findEditButtons(row) {
+	const actions = row.querySelector("[class*=\"rowActions\"]");
+	if (actions === null) return [];
+	const found = [];
+	for (const button of actions.querySelectorAll("button")) {
+		const label = button.getAttribute("aria-label") ?? "";
+		if (label.includes(PROVIDER_DISPLAY_NAME) || button.textContent === "编辑") found.push(button);
+	}
+	return found;
+}
 /**
-* What an empty catalog means, and therefore what the card says about it.
-*
-* An empty model list has two unrelated causes that look identical on the
-* wire: the gateway returned nothing, or the request was never signed because
-* no credentials are stored. Only the second one is actionable, and it is the
-* state every new user starts in — so it has to name the place to fix it.
+* Whether `node` is an Element (`querySelectorAll` roots can be non-element
+* nodes like the Document, where the row check below simply answers false).
+*/
+function isElement(node) {
+	return node.nodeType === Node.ELEMENT_NODE;
+}
+/**
+* Whether `node` is a provider row whose rendered name is ours.
 *
-* Extracted from the render so the branch is testable without a DOM: the
-* repo's client-side tests cover pure logic, not components.
+* Duck-typed on the attribute surface rather than `instanceof Element` so
+* the shadow works identically in the browser and under the specs' DOM
+* stub, which provides the attribute methods without the constructor.
+*/
+function isProviderRow(node) {
+	if (node.nodeType !== Node.ELEMENT_NODE) return false;
+	const element = node;
+	const name = element.querySelector("[class*=\"rowName\"]");
+	return name !== null && name.textContent === PROVIDER_DISPLAY_NAME;
+}
+/**
+* Apply the shadow to one row: add the dot (or repaint an existing one) and
+* hide the Edit button. Idempotent — a second pass rewrites the dot's
+* readiness instead of stacking another one.
 *
-* @param catalog - the route body, or `undefined` while it is still loading.
-* @returns the text to show, which the caller renders as-is.
+* `target` is the owning document, passed in because the stub DOM the specs
+* run on keeps no `ownerDocument` link.
 */
-function catalogStatusText(catalog) {
-	if (catalog === void 0) return "获取中…";
-	if (catalog.models.length > 0) return "";
-	return catalog.credentialsPresent ? "网关未返回任何模型" : "需要凭据才能获取（凭据在 设置 → AI Shell 中配置）";
+function shadowRow(row, ready, titles, target) {
+	const identity = row.querySelector("[class*=\"rowIdentity\"]");
+	if (identity === null) return;
+	const state = ready ? "ok" : "warn";
+	const existing = identity.querySelector(`[${ROW_DOT_MARKER}]`);
+	const dot = existing ?? target.createElement("span");
+	dot.setAttribute(ROW_DOT_MARKER, state);
+	dot.setAttribute("title", titles[state]);
+	dot.setAttribute("aria-label", titles[state]);
+	if (existing === null) {
+		dot.setAttribute("role", "img");
+		identity.appendChild(dot);
+	}
+	for (const edit of findEditButtons(row)) edit.setAttribute(ROW_EDIT_HIDDEN, "");
 }
-function AishellProviderCard(props) {
-	const status = props.useCredentials((snapshot) => snapshot);
-	const [catalog, setCatalog] = (0, react.useState)(void 0);
-	const [catalogError, setCatalogError] = (0, react.useState)(void 0);
-	(0, react.useEffect)(() => {
-		let cancelled = false;
-		fetch(MODELS_ROUTE).then(async (response) => {
-			if (!response.ok) throw new Error(`HTTP ${response.status}`);
-			return response.json();
-		}).then((body) => {
-			if (!cancelled) {
-				setCatalog(body);
-				setCatalogError(void 0);
-			}
-		}).catch((error) => {
-			if (!cancelled) setCatalogError(error instanceof Error ? error.message : String(error));
-		});
-		return () => {
-			cancelled = true;
-		};
-	}, []);
-	const configured = status.credentialsStored;
-	const readinessStyle = {
-		display: "flex",
-		alignItems: "center",
-		gap: 8,
-		fontSize: 12,
-		lineHeight: "18px",
-		fontWeight: 500,
-		color: "var(--dsw-alias-label-secondary)"
-	};
-	const readinessTextStyle = {
-		fontWeight: 400,
-		color: configured ? "var(--dsw-alias-label-primary)" : "var(--dsw-alias-label-tertiary)"
-	};
-	const rowStyle = {
-		display: "flex",
-		flexDirection: "column",
-		gap: 2
-	};
-	const catalogLabelStyle = {
-		fontSize: 12,
-		lineHeight: "18px",
-		fontWeight: 500,
-		color: "var(--dsw-alias-label-secondary)"
-	};
-	const valueStyle = {
-		fontSize: 12,
-		lineHeight: "18px",
-		color: "var(--dsw-alias-label-tertiary)"
-	};
-	const sectionStyle = {
-		display: "flex",
-		flexDirection: "column",
-		gap: 10,
-		borderTop: "0.5px solid var(--dsw-alias-border-l4)",
-		marginTop: 12,
-		paddingTop: 12
+/** Undo one row: remove the dot, restore the Edit button. */
+function unshadowRow(row) {
+	row.querySelectorAll(`[${ROW_DOT_MARKER}]`).forEach((dot) => {
+		dot.remove();
+	});
+	row.querySelectorAll(`[${ROW_EDIT_HIDDEN}]`).forEach((button) => {
+		button.removeAttribute(ROW_EDIT_HIDDEN);
+	});
+}
+/**
+* Install the provider-row shadow on a document.
+*
+* `ready` is the credential fact as the browser half derives it from the
+* settings namespace `aishell-credentials` owns (see `client/index.ts`);
+* `titles` is the dot's hover copy in the active locale (the installer
+* translates; this module holds only the DOM work). Neither is read from any
+* store here, so a later credential save or locale switch is a reinstall with
+* the new values, not a re-derivation buried in here. Sweeps the page once,
+* then observes the body so re-rendered rows are covered too. Returns the
+* disposer that stops the observer and restores every row.
+*/
+function installProviderRowShadow(target, ready, titles) {
+	if (typeof target.querySelector !== "function" || typeof MutationObserver !== "function") return () => {};
+	/** Run the shadow over every provider row at or below `root`. */
+	const sweep = (root) => {
+		if (isElement(root) && isProviderRow(root)) shadowRow(root, ready, titles, target);
+		for (const row of root.querySelectorAll("[class*=\"rowCard\"], [class*=\"setupCard\"]")) if (isProviderRow(row)) shadowRow(row, ready, titles, target);
 	};
-	const modelStyle = {
-		display: "flex",
-		alignItems: "center",
-		gap: 8,
-		fontSize: 13,
-		lineHeight: "20px",
-		color: "var(--dsw-alias-label-primary)"
+	const sweepIfRow = (node) => {
+		if (isProviderRow(node)) {
+			shadowRow(node, ready, titles, target);
+			return;
+		}
+		for (let parent = node.parentElement; parent !== null; parent = parent.parentElement) sweep(parent);
 	};
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		style: sectionStyle,
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			style: readinessStyle,
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				style: {
-					width: 6,
-					height: 6,
-					borderRadius: "50%",
-					flex: "none",
-					background: configured ? "var(--dsw-alias-state-success-primary)" : "var(--dsw-alias-state-warn-label)"
-				},
-				"aria-hidden": "true"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				style: readinessTextStyle,
-				children: configured ? "已就绪 — 凭据已验证，可直接对话" : "未就绪 — 凭据未配置（在 设置 → AI Shell 中保存 AK/SK）"
-			})]
-		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			style: rowStyle,
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				style: catalogLabelStyle,
-				children: "模型目录（来自 aishell 网关，只读）"
-			}), catalogError !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-				style: valueStyle,
-				children: ["目录获取失败：", catalogError]
-			}) : catalog === void 0 || catalog.models.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				style: valueStyle,
-				children: catalogStatusText(catalog)
-			}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
-				style: {
-					margin: 0,
-					padding: 0,
-					listStyle: "none",
-					display: "flex",
-					flexDirection: "column",
-					gap: 4
-				},
-				children: catalog.models.map((model) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
-					style: modelStyle,
-					children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							"aria-hidden": "true",
-							children: "·"
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: model.id }),
-						model.inputModalities.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-							style: {
-								fontSize: 11,
-								color: "var(--dsw-alias-label-quaternary)"
-							},
-							children: [model.inputModalities.join(" / "), " 输入"]
-						}) : null
-					]
-				}, model.id))
-			})]
-		})]
+	const style = target.createElement("style");
+	style.setAttribute(ROW_DOT_MARKER + "-css", "");
+	style.textContent = ROW_DOT_CSS;
+	target.head.appendChild(style);
+	sweep(target.body);
+	const observer = new MutationObserver((mutations) => {
+		for (const mutation of mutations) for (const node of mutation.addedNodes) if (node.nodeType === Node.ELEMENT_NODE) sweepIfRow(node);
 	});
+	observer.observe(target.body, {
+		childList: true,
+		subtree: true
+	});
+	return () => {
+		observer.disconnect();
+		style.remove();
+		for (const row of target.body.querySelectorAll("[class*=\"rowCard\"], [class*=\"setupCard\"]")) if (isProviderRow(row)) unshadowRow(row);
+	};
 }
+
+//#endregion
+//#region src/client/locales.ts
 /**
-* Host route, written document-relative like the credential routes the
-* sibling plugin uses: the served index carries `<base href="./">`, so the
-* request lands on the same origin that serves the page — which carries the
-* browser-session cookie the route's authentication fence requires.
+* aishell-llm locale dictionaries — the Models-page provider row's copy.
+*
+* The row shadow is a DOM patch, not a React render, so its strings do not
+* ride the framework's locale seat: the install reads them through `t` at
+* install time and repaints on a locale switch (the client half re-installs
+* on `locale/change`). zh is the key-set source of truth; en mirrors it.
+*
+* @module @huaweidevtools/aishell-dsh-llm/client/locales
 */
-const MODELS_ROUTE = "api/aishell/models";
+/** Dictionary namespace owned by this plugin. */
+const NS = "aishell-llm";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+const zh = {
+	"provider.ready": "已就绪",
+	"provider.warn": "未就绪 — 凭据未配置（点击对话输入框上方的凭据按钮填写 AK/SK）"
+};
+/** English dictionary. */
+const en = {
+	"provider.ready": "Ready",
+	"provider.warn": "Not ready — credentials missing (click the credentials button above the chat input to enter AK/SK)"
+};
 
 //#endregion
 //#region src/client/index.ts
-/** The settings namespace aishell-credentials owns (the card reads its status). */
+/** The settings namespace aishell-credentials owns (the shadow reads its status). */
 const AISHELL_CREDENTIALS_NS = "aishell-client-credentials";
 /** Required services. */
-const inject = ["slots", "configForms"];
+const inject = ["configForms", "locale"];
 function apply(ctx) {
+	if (typeof document === "undefined") return;
+	ctx.effect(() => ctx.locale.register(NS, {
+		zh,
+		en
+	}), "aishell-llm: dictionaries");
+	const t = ctx.locale.bind(NS);
 	const form = ctx.configForms.get(AISHELL_CREDENTIALS_NS);
-	const status = (0, __deepseek_ai_dsh_client_store.createSnapshotStore)({ credentialsStored: false });
+	let readiness = form.getSnapshot().value?.credentialsStored === true;
+	let disposeShadow;
+	const titles = () => ({
+		ok: t("provider.ready"),
+		warn: t("provider.warn")
+	});
+	const sync = () => {
+		disposeShadow?.();
+		disposeShadow = installProviderRowShadow(document, readiness, titles());
+	};
 	const derive = () => {
-		status.set({ credentialsStored: form.getSnapshot().value?.credentialsStored === true });
+		const next = form.getSnapshot().value?.credentialsStored === true;
+		if (next !== readiness) {
+			readiness = next;
+			sync();
+		}
 	};
-	ctx.effect(() => form.subscribe(derive), "aishell-llm: credential presence for the models card");
-	derive();
-	ctx.effect(() => ctx.configForms.whileServed([AISHELL_CREDENTIALS_NS], () => ctx.slots.inject("settings.models.provider-card", () => ctx.slots.register({
-		name: "settings.models.provider-card",
-		key: "aishell-llm",
-		inject: () => ({ hooks: { credentials: status } })
-	}, AishellProviderCard))), "aishell-llm: models page provider card");
+	ctx.effect(() => ctx.configForms.whileServed([AISHELL_CREDENTIALS_NS], () => {
+		sync();
+		return () => {
+			disposeShadow?.();
+			disposeShadow = void 0;
+		};
+	}), "aishell-llm: models page provider row shadow");
+	ctx.effect(() => form.subscribe(derive), "aishell-llm: credential presence for the models row");
+	ctx.effect(() => ctx.on("locale/change", () => {
+		sync();
+	}), "aishell-llm: shadow locale repaint");
 }
 
 //#endregion
+exports.ROW_DOT_MARKER = ROW_DOT_MARKER
+exports.ROW_EDIT_HIDDEN = ROW_EDIT_HIDDEN
 exports.apply = apply
 exports.inject = inject
+exports.installProviderRowShadow = installProviderRowShadow
 return module.exports; } });
 //# sourceMappingURL=client.js.map

package/lib/index.js

@@ -1404,6 +1404,25 @@ async function* translate(payloads) {
 	};
 }
 
+//#endregion
+//#region src/provider-name.ts
+/**
+* The aishell provider's display name, shared by both plugin halves.
+*
+* The Host half registers it on the configurable-provider directory (the
+* Models page renders it as the provider row's name), and the browser half's
+* row shadow finds that row by matching the rendered name against this
+* literal (see `client/provider-row-shadow.ts`). It must stay a single
+* literal string — the shadow compares `textContent` with it.
+*
+* It is also the name `providerInfo()` reports, so the picker and the Models
+* row call the route the same thing: this package's whole surface is one
+* product, and qualifying it by cloud ("AI Shell (Huawei Cloud)") added a
+* distinction no reader needed — there is no second AI Shell to tell it
+* apart from.
+*/
+const PROVIDER_DISPLAY_NAME = "AI Shell";
+
 //#endregion
 //#region src/adapter.ts
 /** Credential store account names for Huawei Cloud credentials. */
@@ -1457,7 +1476,7 @@ var GatewayAdapter = class GatewayAdapter extends LlmAdapter {
 	providerInfo(provider) {
 		return {
 			id: provider,
-			name: "AI Shell"
+			name: PROVIDER_DISPLAY_NAME
 		};
 	}
 	/**
@@ -1487,7 +1506,7 @@ var GatewayAdapter = class GatewayAdapter extends LlmAdapter {
 		return wireModels.map((m) => ({
 			provider,
 			id: m.id,
-			name: m.id,
+			name: m.name ?? m.id,
 			...mapModalities(m.modalities)
 		}));
 	}
@@ -1497,7 +1516,7 @@ var GatewayAdapter = class GatewayAdapter extends LlmAdapter {
 		const base = {
 			provider,
 			id: model,
-			name: model,
+			name: wire?.name ?? model,
 			...mapModalities(wire?.modalities)
 		};
 		if (wire === void 0) return base;
@@ -1669,35 +1688,10 @@ const Config = Schema.object({
 	requestImageMaxBytes: Schema.number().step(1).min(1).default(DEFAULT_REQUEST_IMAGE_MAX_BYTES).volatile(),
 	maxRequestImageBytes: Schema.number().step(1).min(1).default(DEFAULT_MAX_REQUEST_IMAGE_BYTES).volatile()
 });
-/** Route the Models-page card reads the live gateway catalog from. */
-const MODELS_PATH = "/api/aishell/models";
-/**
-* Build the route body from the adapter's own catalog cache, so the card and
-* the pickers cannot disagree about what the gateway carries.
-*
-* `credentialsPresent` is read from the adapter rather than assumed: without
-* credentials `listModels` answers `[]` for a reason that is not "the gateway
-* has no models", and the card's empty state is the one place a fresh user
-* learns which of the two it is.
-*
-* Returned as a plain function of the adapter so a test can pin the mapping
-* without a live context; `apply` wires it to the fetch route.
-*/
-function createModelsRoute(adapter) {
-	return () => adapter.listModels(PROVIDER).then((models) => Response.json({
-		credentialsPresent: adapter.hasCredentials(),
-		models: models.map((m) => ({
-			id: m.id,
-			inputModalities: [...m.inputModalities ?? []]
-		}))
-	}, { headers: { "cache-control": "no-store" } }));
-}
 const name = "aishell-llm";
-const inject = ["llm", "connection"];
+const inject = ["llm"];
 /** The provider route this plugin owns. */
 const PROVIDER = "aishell";
-/** Human-readable provider name the Models page and pickers show. */
-const PROVIDER_DISPLAY_NAME = "AI Shell (Huawei Cloud)";
 function apply(ctx, config) {
 	const keyringService = config.keyringService.get();
 	const store = createCredentialsStore(keyringService === void 0 || keyringService === "" ? {} : { service: keyringService });
@@ -1719,14 +1713,8 @@ function apply(ctx, config) {
 		settingsNs: ctx.fiber.entry?.options.id ?? name,
 		settingsPath: []
 	}]);
-	ctx.effect(() => ctx.connection.fetch.register({
-		path: MODELS_PATH,
-		methods: ["GET"],
-		requestBody: "buffered",
-		fetch: createModelsRoute(adapter)
-	}), "aishell-llm: models catalog route");
 }
 
 //#endregion
-export { Config, PROVIDER, PROVIDER_DISPLAY_NAME, apply, createModelsRoute, inject, name };
+export { Config, PROVIDER, PROVIDER_DISPLAY_NAME, apply, inject, name };
 //# sourceMappingURL=index.js.map

package/lib/types/client/index.d.ts

@@ -1,20 +1,31 @@
 /**
- * aishell LLM browser half — fills the Models page's provider-card seat.
+ * aishell LLM browser half — shadows the Models page's provider row.
  *
- * The Models page's Edit card for an adapter family it does not know renders
- * the host's fallback hint and nothing editable. This plugin owns the family,
- * so it fills the card itself through the `settings.models.provider-card`
- * seat (keyed by the `aishell-llm` settings namespace, which the Host half's
- * directory entry names): a read-only credential line (managed by
- * `aishell-credentials`, shown with the verified account name) and the live
- * gateway model catalog, read from the Host half's `api/aishell/models` route
- * — the same cache `listModels` serves, so the card and the pickers cannot
- * disagree about what the gateway carries.
+ * The page's row for the aishell family is read-only: its profile has no
+ * fields the host editor knows how to write, and its credentials are entered
+ * through the credential form the `aishell-credentials` chips open. What the
+ * row should tell the user is the one fact the old card extension distilled —
+ * ready or not — so the browser half paints it as a status dot beside the
+ * row's name and hides the header's Edit button (see
+ * `client/provider-row-shadow.ts`).
+ *
+ * The readiness fact is read from the `aishell-client-credentials` settings
+ * namespace (`aishell-credentials` owns it; the shadow never names accounts
+ * or manages anything). The shadow follows that namespace through
+ * `whileServed`, so a deployment without that plugin (this LLM package
+ * installed standalone) shows no trace of the dot either — the fact is
+ * unknown, not false.
+ *
+ * The dot's hover copy rides this package's own locale namespace. The shadow
+ * is a DOM patch that does not re-render on a locale switch, so the install
+ * is redone on `locale/change` — the repaint is attribute writes over rows
+ * the sweep re-finds, not a page mutation.
  *
  * @module @huaweidevtools/aishell-dsh-llm/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-export type { AishellProviderCard, AishellProviderCardProps } from './ProviderCard.tsx';
+export type { ProviderRowShadowDisposer, ProviderRowTitles, } from './provider-row-shadow.ts';
+export { installProviderRowShadow, ROW_DOT_MARKER, ROW_EDIT_HIDDEN, } from './provider-row-shadow.ts';
 /** Required services. */
 export declare const inject: string[];
 export declare function apply(ctx: ClientContext): void;

package/lib/types/client/locales.d.ts

@@ -0,0 +1,30 @@
+/**
+ * aishell-llm locale dictionaries — the Models-page provider row's copy.
+ *
+ * The row shadow is a DOM patch, not a React render, so its strings do not
+ * ride the framework's locale seat: the install reads them through `t` at
+ * install time and repaints on a locale switch (the client half re-installs
+ * on `locale/change`). zh is the key-set source of truth; en mirrors it.
+ *
+ * @module @huaweidevtools/aishell-dsh-llm/client/locales
+ */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS: "aishell-llm";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    readonly 'provider.ready': "已就绪";
+    readonly 'provider.warn': "未就绪 — 凭据未配置（点击对话输入框上方的凭据按钮填写 AK/SK）";
+};
+/** English dictionary. */
+export declare const en: {
+    readonly 'provider.ready': "Ready";
+    readonly 'provider.warn': "Not ready — credentials missing (click the credentials button above the chat input to enter AK/SK)";
+};
+/** All keys (derived from the zh dictionary, the source of truth). */
+export type AishellLlmLocaleKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'aishell-llm': AishellLlmLocaleKey;
+    }
+}
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/provider-row-shadow.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Runtime shadow of the aishell provider's Models-page row.
+ *
+ * The Models page renders each configured provider as a row whose header
+ * (`rowHead`) shows the display name followed by an Edit button the aishell
+ * family has no use for: the profile has no fields the host editor knows how
+ * to write (the old card extension said so itself), and the row's directory
+ * entry names no api-key credential, so the host header also paints no status
+ * dot. What the user actually needs from this row is the one fact the old
+ * card distilled — ready or not — and that reads better beside the name than
+ * in a card below the header.
+ *
+ * The header lives in ui-settings-models, digest-protected with no slot for
+ * the identity half (the `settings.models.provider-card` seat extends the
+ * area BELOW the header, which is exactly the part this family no longer
+ * wants). The shadow therefore works the way aishell-brand's host residues
+ * do: find the row, patch the DOM. The row is located by its rendered name
+ * (the directory entry's displayName, `PROVIDER_DISPLAY_NAME` — a literal
+ * both halves share); the class names beside it are CSS-module hashes, so
+ * they are matched by the same `[class*="…"]` substring selectors the hero
+ * patch already relies on.
+ *
+ * What the shadow does to a found row:
+ *
+ *   1. a status dot after the name — the host credential dot's own 8px
+ *      geometry and success/warn colors, green when AK/SK are stored, warn
+ *      when they are not, with the readiness copy (installer-supplied, so it
+ *      follows the active locale) as its title;
+ *   2. the row's Edit button is hidden — the row is read-only, and the only
+ *      control the header keeps is whatever the host itself decides (Remove,
+ *      for user-added rows; this family's row is not removable). The hide is
+ *      a marker-keyed `display: none !important` rule, not the `hidden`
+ *      attribute: the button's own class sets `display: inline-flex`, and an
+ *      author declaration beats the UA sheet's `[hidden] { display: none }`,
+ *      so the attribute alone leaves the button visible.
+ *
+ * The Models page re-renders the rows (credential saves, pushed
+ * invalidations), so a MutationObserver keeps the shadow applied for as long
+ * as the page exists. Shadowing is a default, not a force: install() and the
+ * disposer it returns are symmetric, so disabling the plugin restores the
+ * official row exactly — dot removed, Edit button back.
+ *
+ * @module @huaweidevtools/aishell-dsh-llm/client/provider-row-shadow
+ */
+/**
+ * The disposer stops the observer, removes every dot the install added, and
+ * restores every hidden Edit button; a no-op install returns this.
+ */
+export type ProviderRowShadowDisposer = () => void;
+/** Marker attribute the dot carries (exposed for the spec). */
+export declare const ROW_DOT_MARKER = "data-aishell-provider-dot";
+/** Marker attribute a hidden Edit button carries (exposed for the spec). */
+export declare const ROW_EDIT_HIDDEN = "data-aishell-edit-hidden";
+/** The dot's own CSS: the host credential dot's geometry and palette. */
+export declare const ROW_DOT_CSS: string;
+/** Title copy for the dot, by readiness — supplied by the installer so it
+ * follows the active locale (this module is a DOM patch with no locale seat
+ * of its own). The warn state keeps the actionable half — where to enter
+ * AK/SK — because that is the one thing a fresh user cannot guess; the ready
+ * state needs nothing beyond itself. */
+export interface ProviderRowTitles {
+    /** Hover copy when AK/SK are stored. */
+    readonly ok: string;
+    /** Hover copy when they are not. */
+    readonly warn: string;
+}
+/**
+ * Install the provider-row shadow on a document.
+ *
+ * `ready` is the credential fact as the browser half derives it from the
+ * settings namespace `aishell-credentials` owns (see `client/index.ts`);
+ * `titles` is the dot's hover copy in the active locale (the installer
+ * translates; this module holds only the DOM work). Neither is read from any
+ * store here, so a later credential save or locale switch is a reinstall with
+ * the new values, not a re-derivation buried in here. Sweeps the page once,
+ * then observes the body so re-rendered rows are covered too. Returns the
+ * disposer that stops the observer and restores every row.
+ */
+export declare function installProviderRowShadow(target: Document, ready: boolean, titles: ProviderRowTitles): ProviderRowShadowDisposer;
+//# sourceMappingURL=provider-row-shadow.d.ts.map

package/lib/types/index.d.ts

@@ -14,12 +14,14 @@
  * directory (`registerConfigurableProviders`), which is what the Models page
  * joins with live routes — and it carries a Config schema, without which the
  * settings mirror (and therefore the Models row) never lists this namespace.
+ * The row itself carries no card: the browser half replaces the page's
+ * Edit-card extension with a status dot beside the row's name (see
+ * `client/provider-row-shadow.ts`).
  *
  * @module @huaweidevtools/aishell-dsh-llm
  */
 import type { Context, Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-import { GatewayAdapter } from './adapter.ts';
 export type { GatewayAdapter, GatewayAdapterOptions } from './adapter.ts';
 /** Plugin config. */
 export interface Config {
@@ -56,38 +58,10 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     requestImageMaxBytes: z<number, number, "volatile-defined">;
     maxRequestImageBytes: z<number, number, "volatile-defined">;
 }>>, "plain">;
-/**
- * The catalog the route answers with: the gateway's `/models` entries, mapped
- * to the display shape the browser card renders, plus the credential state
- * that decides which of the two postures the card shows. Detached plain data —
- * no secret rides on it, ever (presence flags only).
- */
-export interface ModelsRouteBody {
-    /** Whether a usable AK/SK pair is stored — the fact that separates "empty catalog" from "no credentials". */
-    readonly credentialsPresent: boolean;
-    readonly models: ReadonlyArray<{
-        readonly id: string;
-        readonly inputModalities: readonly string[];
-    }>;
-}
-/**
- * Build the route body from the adapter's own catalog cache, so the card and
- * the pickers cannot disagree about what the gateway carries.
- *
- * `credentialsPresent` is read from the adapter rather than assumed: without
- * credentials `listModels` answers `[]` for a reason that is not "the gateway
- * has no models", and the card's empty state is the one place a fresh user
- * learns which of the two it is.
- *
- * Returned as a plain function of the adapter so a test can pin the mapping
- * without a live context; `apply` wires it to the fetch route.
- */
-export declare function createModelsRoute(adapter: GatewayAdapter): () => Promise<Response>;
 export declare const name = "aishell-llm";
 export declare const inject: string[];
 /** The provider route this plugin owns. */
 export declare const PROVIDER = "aishell";
-/** Human-readable provider name the Models page and pickers show. */
-export declare const PROVIDER_DISPLAY_NAME = "AI Shell (Huawei Cloud)";
+export { PROVIDER_DISPLAY_NAME } from './provider-name.ts';
 export declare function apply(ctx: Context, config: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/provider-name.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The aishell provider's display name, shared by both plugin halves.
+ *
+ * The Host half registers it on the configurable-provider directory (the
+ * Models page renders it as the provider row's name), and the browser half's
+ * row shadow finds that row by matching the rendered name against this
+ * literal (see `client/provider-row-shadow.ts`). It must stay a single
+ * literal string — the shadow compares `textContent` with it.
+ *
+ * It is also the name `providerInfo()` reports, so the picker and the Models
+ * row call the route the same thing: this package's whole surface is one
+ * product, and qualifying it by cloud ("AI Shell (Huawei Cloud)") added a
+ * distinction no reader needed — there is no second AI Shell to tell it
+ * apart from.
+ */
+export declare const PROVIDER_DISPLAY_NAME = "AI Shell";
+//# sourceMappingURL=provider-name.d.ts.map

package/lib/types/types.d.ts

@@ -86,6 +86,17 @@ export interface WireChunk {
 /** One model entry from the GET /models response (OpenAI-compatible). */
 export interface WireModel {
     id: string;
+    /**
+     * Display name, when the gateway sends one. Outside OpenAI's own model
+     * object (which carries `id` alone), so it is an extension like the
+     * metadata below, and the gateway omits it for a model that declares none.
+     *
+     * This is the field that lets an id stay a durable routing key while the
+     * label a person reads stays free to change — the split every official
+     * adapter's `name ?? id` expresses. Without it the two roles collapse onto
+     * the id, and a reserved name like `trial` has to read well in a picker.
+     */
+    name?: string;
     object?: string;
     owned_by?: string;
     created?: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huaweidevtools/aishell-dsh-llm",
   "description": "aishell LLM gateway adapter for DSH — OpenAI-compatible, Huawei Cloud AK/SK auth via credential store",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "publishConfig": {
     "access": "public"
   },
@@ -33,13 +33,12 @@
   "license": "Apache-2.0",
   "dependencies": {
     "eventsource-parser": "^3.0.0",
-    "@huaweidevtools/aishell-dsh-credentials-store": "0.0.2"
+    "@huaweidevtools/aishell-dsh-credentials-store": "0.0.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/dsh-attachment": ">=0.2.0-0 <0.3.0-0",
     "@deepseek-ai/dsh-brand": ">=0.2.0-0 <0.3.0-0",
-    "@deepseek-ai/dsh-client-connection": ">=0.2.0-0 <0.3.0-0",
     "@deepseek-ai/dsh-fs": ">=0.2.0-0 <0.3.0-0",
     "@deepseek-ai/dsh-llm": ">=0.2.0-0 <0.3.0-0"
   },
@@ -48,24 +47,18 @@
     "@deepseek-ai/cordis-plugin-loader": "^1.0.5",
     "@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
     "@deepseek-ai/dsh-brand": ">=0.2.0-0 <0.3.0-0",
-    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.2.0-0 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-models": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-0 <0.3.0-0",
     "@deepseek-ai/dsh-fs": "0.2.0-rc.1",
     "@deepseek-ai/dsh-llm": ">=0.2.0-0 <0.3.0-0",
-    "@deepseek-ai/schemastery": "3.18.4",
-    "@types/react": "~18.3.1",
-    "react": "^18.2.0"
+    "@deepseek-ai/schemastery": "3.18.4"
   },
   "dsh": {
     "client": {
       "inject": [
         "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-models",
-        "@deepseek-ai/dsh-api-remotes"
+        "@deepseek-ai/dsh-client-locale"
       ],
       "platform": "web"
     },

package/lib/types/client/ProviderCard.d.ts

@@ -1,77 +0,0 @@
-/**
- * The aishell row's Edit-card extension: a one-line readiness status + the
- * live gateway model catalog.
- *
- * The Models page's own editor for an adapter family it does not know renders
- * the host's fallback hint ("other fields live in cordis.patch.yml") with a
- * disabled Apply — nothing to edit, because the aishell profile has no fields
- * the host editor knows how to write. What the user actually needs from this
- * card is the other direction: to READ the family's state.
- *
- * Scope discipline: this page answers "can I use this provider, and what does
- * it carry" — one readiness line whose credential fact comes from
- * `aishell-credentials`' settings namespace (managed at Settings → AI Shell;
- * the card never names accounts or manages anything). The model catalog comes
- * from the gateway through the Host half's `api/aishell/models` route and is
- * likewise read-only — the gateway owns it.
- *
- * @module @huaweidevtools/aishell-dsh-llm/client/ProviderCard
- */
-import { type ReactNode } from 'react';
-import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
-import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-/** The route body the Host half answers (see its ModelsRouteBody). */
-interface ModelsRouteBody {
-    readonly credentialsPresent: boolean;
-    readonly models: ReadonlyArray<{
-        readonly id: string;
-        readonly inputModalities: readonly string[];
-    }>;
-}
-/**
- * Credential presence, read from the settings namespace `aishell-credentials`
- * owns. The card only needs the presence flag for its readiness line; the
- * account name stays in the credentials section that owns it.
- */
-export interface CredentialSnapshot {
-    readonly credentialsStored: boolean;
-}
-/** Full component props: the seat's owner share + the inject face. */
-export type AishellProviderCardProps = PropsRuntime<'settings.models.provider-card'> & InjectFace<AishellProviderCardInjected>;
-/** Injected hooks bound in the client half's apply(). */
-export interface AishellProviderCardInjected {
-    hooks: {
-        /** Credential presence from the aishell-client-credentials namespace. */
-        credentials: SnapshotStore<CredentialSnapshot>;
-    };
-}
-/**
- * Render the aishell family's card extension.
- *
- * The parent renders this inside the host editor's card (below its fallback
- * hint), so the visual style follows the surrounding card rather than opening
- * a panel of its own: one readiness line and one catalog list, no buttons —
- * the host card's Cancel stays the only control. Readiness folds the
- * credential fact into a single conclusion (the question this page asks is
- * "can I use this provider", not "what are my credentials"); details and
- * management of credentials belong to the AI Shell settings section, which
- * the unconfigured hint names.
- */
-/**
- * What an empty catalog means, and therefore what the card says about it.
- *
- * An empty model list has two unrelated causes that look identical on the
- * wire: the gateway returned nothing, or the request was never signed because
- * no credentials are stored. Only the second one is actionable, and it is the
- * state every new user starts in — so it has to name the place to fix it.
- *
- * Extracted from the render so the branch is testable without a DOM: the
- * repo's client-side tests cover pure logic, not components.
- *
- * @param catalog - the route body, or `undefined` while it is still loading.
- * @returns the text to show, which the caller renders as-is.
- */
-export declare function catalogStatusText(catalog: ModelsRouteBody | undefined): string;
-export declare function AishellProviderCard(props: AishellProviderCardProps): ReactNode;
-export {};
-//# sourceMappingURL=ProviderCard.d.ts.map