@undefineds.co/xpod 0.4.12 → 0.4.14

package/node_modules/@undefineds.co/ai-connections/dist/error-wording.js

@@ -0,0 +1,253 @@
+import { AiConnectionsRequestError, aiConnectionsErrorCode } from './contract/ai-connections-client.js';
+/**
+ * The wording a failed AI Connection request is shown under.
+ *
+ * This used to live in the shared core, which meant the published contract
+ * carried sentences: nine Chinese messages plus the English fallbacks, and every
+ * consumer of the client - the applet and the web app - displayed wording chosen
+ * by a package that has no idea who is rendering it. The core now classifies a
+ * failure and hands over its code; the sentence is chosen here, where it is read.
+ *
+ * The rules below are a move, not a rewrite: the same codes map to the same
+ * sentences as before, so nothing a user reads changes.
+ */
+const AI_CONNECTIONS_GENERIC_ERROR_MESSAGE = 'AI Connection request failed. Please try again.';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+const LOCAL_SESSION_REFRESH_FAILED_MESSAGE = '订阅登录态自动刷新失败，请稍后重试。';
+const LOCAL_SESSION_REAUTH_REQUIRED_MESSAGE = '订阅登录态已失效，请在原客户端重新登录后重读，或使用设备码登录。';
+const OAUTH_MODEL_AUTH_FAILED_MESSAGE = '订阅登录态不可用，请重读登录态或重新登录后再同步模型。';
+const MODEL_DISCOVERY_SAFE_MESSAGES = new Set([
+    OAUTH_MODEL_AUTH_FAILED_MESSAGE,
+    LOCAL_SESSION_REFRESH_FAILED_MESSAGE,
+    LOCAL_SESSION_REAUTH_REQUIRED_MESSAGE,
+    '密钥不可用。请检查密钥是否填写正确，或换一个密钥后重试。',
+    '模型服务地址不正确。请检查服务地址后重试。',
+    '请求太频繁。请稍等一会儿再试。',
+    '模型服务暂时没有响应。请稍后重试。',
+    '模型列表获取失败。请检查密钥、服务地址或网络后重试。',
+]);
+function normalizeAiConnectionsErrorText(message) {
+    if (message.startsWith('provider_models_response_error:')) {
+        return sanitizeProviderResponseMessage(message.slice('provider_models_response_error:'.length))
+            ?? '模型列表获取失败。请检查密钥、服务地址或网络后重试。';
+    }
+    const exact = messageForSafeErrorCode(message);
+    if (exact)
+        return exact;
+    const prefix = message.split(':', 1)[0]?.trim();
+    const prefixed = prefix ? messageForSafeErrorCode(prefix) : undefined;
+    if (prefixed)
+        return prefixed;
+    if (message === 'AI Connection service identity is unavailable')
+        return message;
+    if (MODEL_DISCOVERY_SAFE_MESSAGES.has(message))
+        return message;
+    if (isModelDiscoveryMessageWithProviderDetail(message))
+        return message;
+    if (message.startsWith('invalid_'))
+        return 'AI Connection returned an invalid response.';
+    return AI_CONNECTIONS_GENERIC_ERROR_MESSAGE;
+}
+/**
+ * The sentence to show for anything a request threw.
+ *
+ * A failed request carries the facts - the wire code, the upstream status, the
+ * request's provider and auth mode - so the sentence is chosen from those rather
+ * than parsed back out of a message. Anything that is not a request failure (a
+ * thrown string, an unexpected `Error`) still goes through the sanitiser, which
+ * is what keeps internals off the screen.
+ */
+export function aiConnectionsErrorMessage(error) {
+    if (error instanceof AiConnectionsRequestError) {
+        return aiConnectionsErrorMessageForPayload(error.payload, error.status, {
+            provider: error.provider,
+            authMode: error.authMode,
+        });
+    }
+    if (error instanceof Error) {
+        return normalizeAiConnectionsErrorText(error.message);
+    }
+    return normalizeAiConnectionsErrorText(String(error));
+}
+export function aiConnectionsErrorMessageForPayload(payload, status, context = {}) {
+    const code = aiConnectionsErrorCode(payload);
+    if (code === 'provider_models_response_error') {
+        const message = isRecord(payload) && typeof payload.message === 'string'
+            ? sanitizeProviderResponseMessage(payload.message)
+            : undefined;
+        if (message)
+            return message;
+        return '模型列表获取失败。请检查密钥、服务地址或网络后重试。';
+    }
+    if (code === 'provider_models_fetch_failed') {
+        const providerStatus = isRecord(payload) && typeof payload.providerStatus === 'number'
+            ? payload.providerStatus
+            : undefined;
+        const providerMessage = isRecord(payload) && typeof payload.providerMessage === 'string'
+            ? payload.providerMessage.trim()
+            : undefined;
+        return withProviderMessage(modelDiscoveryErrorMessage(providerStatus, context.authMode), providerMessage);
+    }
+    const coded = code ? messageForSafeErrorCode(code, context.provider) : undefined;
+    if (coded)
+        return coded;
+    const text = isRecord(payload) && typeof payload.error === 'string'
+        ? payload.error
+        : undefined;
+    if (text) {
+        const exact = messageForSafeErrorCode(text, context.provider);
+        if (exact)
+            return exact;
+        if (text === 'AI Connection service identity is unavailable') {
+            return text;
+        }
+        if (text === 'Provider credential not found for current identity') {
+            return '当前身份没有可用的额度凭证。';
+        }
+        if (text === 'Provider quota adapter not found' || text === 'Provider quota lookup failed') {
+            return '该接入方式不支持查询官方额度。';
+        }
+    }
+    if (status === 401)
+        return 'Please sign in again to continue.';
+    if (status === 403)
+        return 'AI Connection permission was denied.';
+    if (status === 404 && context.provider) {
+        return `${providerLabel(context.provider)} connection is not configured.`;
+    }
+    if (status === 429)
+        return 'AI Connection is rate limited. Please try again later.';
+    if (status === 503)
+        return 'AI Connection service is unavailable.';
+    return AI_CONNECTIONS_GENERIC_ERROR_MESSAGE;
+}
+function messageForSafeErrorCode(code, provider) {
+    switch (code.trim().toLowerCase().replace(/-/g, '_')) {
+        case 'not_configured':
+        case 'notconfigured':
+            return provider
+                ? `${providerLabel(provider)} connection is not configured.`
+                : 'AI provider connection is not configured.';
+        case 'unsupported':
+            return provider
+                ? `${providerLabel(provider)} does not support this operation.`
+                : 'This AI Connection operation is not supported.';
+        case 'service_identity_unavailable':
+            return 'AI Connection service identity is unavailable';
+        case 'unauthorized':
+            return 'Please sign in again to continue.';
+        case 'forbidden':
+        case 'permission_denied':
+            return 'AI Connection permission was denied.';
+        case 'rate_limited':
+            return 'AI Connection is rate limited. Please try again later.';
+        case 'service_unavailable':
+            return 'AI Connection service is unavailable.';
+        case 'unsafe_provider_base_url':
+            return '该服务地址指向 Xpod 不允许访问的网络，请改用公网 HTTPS 地址。';
+        case 'invalid_proxy_url':
+            return '代理地址必须是无账号密码的 HTTP 或 HTTPS 地址。';
+        case 'oauth_refresh_failed':
+        case 'oauth_refresh_unavailable':
+        case 'local_session_refresh_failed':
+            return LOCAL_SESSION_REFRESH_FAILED_MESSAGE;
+        case 'oauth_session_reauth_required':
+        case 'oauth_refresh_token_required':
+        case 'local_session_reauth_required':
+        case 'local_session_missing_refresh_token':
+            return LOCAL_SESSION_REAUTH_REQUIRED_MESSAGE;
+        case 'models_persistence_failed':
+            return '模型已获取，但保存到 Pod 失败。请重试同步模型。';
+        case 'quota_credential_not_found':
+            return '当前身份没有可用的额度凭证。';
+        case 'credential_secret_unavailable':
+            return '当前凭证密钥不可用，请重新保存后再查询额度。';
+        case 'gateway_api_key_plaintext_unavailable':
+            return 'Pod 中未找到此 API Key 的原文，无法复制配置。请创建新的 Key，更新客户端后再删除旧 Key。';
+        case 'quota_adapter_not_found':
+            return '该接入方式不支持查询官方额度。';
+        default:
+            return undefined;
+    }
+}
+function modelDiscoveryErrorMessage(providerStatus, authMode) {
+    if (providerStatus === 401 || providerStatus === 403) {
+        if (authMode === 'deviceCodeOAuth')
+            return OAUTH_MODEL_AUTH_FAILED_MESSAGE;
+        return '密钥不可用。请检查密钥是否填写正确，或换一个密钥后重试。';
+    }
+    if (providerStatus === 404) {
+        return '模型服务地址不正确。请检查服务地址后重试。';
+    }
+    if (providerStatus === 429) {
+        return '请求太频繁。请稍等一会儿再试。';
+    }
+    if (providerStatus !== undefined && providerStatus >= 500) {
+        return '模型服务暂时没有响应。请稍后重试。';
+    }
+    return '模型列表获取失败。请检查密钥、服务地址或网络后重试。';
+}
+function withProviderMessage(message, providerMessage) {
+    const sanitized = providerMessage ? sanitizeProviderResponseMessage(providerMessage) : undefined;
+    if (!sanitized)
+        return message;
+    return `${message} 上游返回：${sanitized}`;
+}
+function isModelDiscoveryMessageWithProviderDetail(message) {
+    const marker = ' 上游返回：';
+    const index = message.indexOf(marker);
+    if (index <= 0)
+        return false;
+    return MODEL_DISCOVERY_SAFE_MESSAGES.has(message.slice(0, index));
+}
+function sanitizeProviderResponseMessage(value) {
+    const sanitized = value
+        .replace(/[\u0000-\u001f\u007f]/gu, ' ')
+        .replace(/\bBearer\s+[^\s,;]+/giu, 'Bearer [REDACTED]')
+        .replace(/(?:sk|id)[._-][A-Za-z0-9._-]{8,}/gu, '[REDACTED]')
+        .replace(/https?:\/\/[^\s]+/giu, '[URL]')
+        .trim()
+        .slice(0, 240);
+    return sanitized || undefined;
+}
+function providerLabel(provider) {
+    switch (provider) {
+        case 'openai': return 'OpenAI';
+        case 'anthropic': return 'Anthropic';
+        case 'kimi': return 'Kimi';
+        case 'bailian': return 'Bailian';
+        case 'deepseek': return 'DeepSeek';
+        case 'zhipu': return 'Zhipu';
+        case 'ollama': return 'Ollama';
+        case 'custom': return 'Custom';
+    }
+}
+/**
+ * The shared client reports a failure by naming its code; the sentence a user
+ * reads is the applet's (`error-wording`). This app renders messages straight
+ * from the thrown error, so it relabels them once, at its own boundary, instead
+ * of letting a code reach the screen or teaching every call site to translate.
+ * The error object itself is rethrown unchanged, so callers that inspect it -
+ * `instanceof`, `code`, `providerStatus` - keep working.
+ */
+export function withDisplayableErrors(client) {
+    const wrapped = { ...client };
+    for (const [key, value] of Object.entries(client)) {
+        if (typeof value !== 'function')
+            continue;
+        wrapped[key] = async (...args) => {
+            try {
+                return await value.apply(client, args);
+            }
+            catch (error) {
+                if (error instanceof AiConnectionsRequestError) {
+                    error.message = aiConnectionsErrorMessage(error);
+                }
+                throw error;
+            }
+        };
+    }
+    return wrapped;
+}

package/node_modules/@undefineds.co/ai-connections/dist/gateway-endpoints.js

@@ -1,4 +1,4 @@
-import { normalizeMessagesEndpoint, normalizeV1Endpoint } from './endpoint-urls.js';
+import { normalizeMessagesEndpoint, normalizeV1Endpoint } from './contract/endpoint-urls.js';
 /**
  * The protocols the Xpod gateway serves, as registered by
  * `src/api/handlers/AiGatewayHandler.ts`:

package/node_modules/@undefineds.co/ai-connections/dist/index.d.ts

@@ -1,6 +1,5 @@
 import type { WebExtensionModule } from '@undefineds.co/extension-sdk/web';
 import { type AiConnectionsController } from './controller';
-export * from './ai-connections-client';
 export * from './AiClientConfigurationSection';
 export * from './AiConnectionsPanel';
 export * from './AiCopyButton';
@@ -16,8 +15,8 @@ export * from './AiCustomProviderDialog';
 export * from './AiModelEditorDialog';
 export * from './controller';
 export * from './collections';
-export * from './credential-storage';
-export * from './endpoint-urls';
+export * from './display-wording';
+export * from './error-wording';
 export * from './gateway-endpoints';
 export * from './AiProviderCard';
 export * from './AiCredentialPoolSection';

package/node_modules/@undefineds.co/ai-connections/dist/index.js

@@ -6,7 +6,6 @@ import { AiConnectionsMainHeader } from './AiConnectionsMainHeader.js';
 import { createAiConnectionsController, } from './controller.js';
 import { aiConnectionManifest } from './manifest.js';
 import { createElement } from 'react';
-export * from './ai-connections-client.js';
 export * from './AiClientConfigurationSection.js';
 export * from './AiConnectionsPanel.js';
 export * from './AiCopyButton.js';
@@ -22,8 +21,8 @@ export * from './AiCustomProviderDialog.js';
 export * from './AiModelEditorDialog.js';
 export * from './controller.js';
 export * from './collections.js';
-export * from './credential-storage.js';
-export * from './endpoint-urls.js';
+export * from './display-wording.js';
+export * from './error-wording.js';
 export * from './gateway-endpoints.js';
 export * from './AiProviderCard.js';
 export * from './AiCredentialPoolSection.js';

package/node_modules/@undefineds.co/ai-connections/dist/offering-endpoints.d.ts

@@ -1,4 +1,4 @@
-import type { AiProviderOffering } from './ai-connections-client';
+import type { AiProviderOffering } from './contract/ai-connections-client';
 /** One protocol the user can point a client at: the `protocol → base URL` pair the UI lists. */
 export interface AiEndpointEntry {
     protocol: string;

package/node_modules/@undefineds.co/ai-connections/dist/offering-label.d.ts

@@ -1,4 +1,4 @@
-import type { AiProviderAuthorizationMethod, AiProviderOffering } from './ai-connections-client';
+import type { AiProviderAuthorizationMethod, AiProviderOffering } from './contract/ai-connections-client';
 export declare function offeringTitle(offering: AiProviderOffering): string;
 /** Name of the offering kind. Same taxonomy as the title fallback, so it reuses the one map. */
 export declare function offeringKindLabel(kind: string): string;

package/node_modules/@undefineds.co/ai-connections/dist/provider-visuals.d.ts

@@ -1,4 +1,4 @@
-import type { AiConnectionsProvider } from './ai-connections-client';
+import type { AiConnectionsProvider } from './contract/ai-connections-client';
 /**
  * The Xpod shield (`ui/src/assets/xpod-shield.svg`), inlined like the provider
  * marks: from a coding client's point of view Xpod is just another provider.

package/node_modules/@undefineds.co/ai-connections/dist/service-access.js

@@ -1,4 +1,4 @@
-import { AI_CONNECTIONS_PROVIDER_DOCUMENT_IDS } from './provider-catalog.js';
+import { AI_CONNECTIONS_PROVIDER_DOCUMENT_IDS } from './contract/provider-catalog.js';
 export const AI_CONNECTIONS_APPLET_ID = 'co.undefineds.ai-connections';
 const KNOWN_RESOURCE_PATHS = {
     providerCredentials: 'settings/credentials.ttl',

package/node_modules/@undefineds.co/ai-connections/dist/useAiConnectDialog.d.ts

@@ -1,4 +1,4 @@
-import type { AiConnectAttempt, AiConnectionsMode, AiProviderAuthorizationMethod, AiProviderCredentialSummary, AiProviderOffering } from './ai-connections-client';
+import type { AiConnectAttempt, AiConnectionsMode, AiProviderAuthorizationMethod, AiProviderCredentialSummary, AiProviderOffering } from './contract/ai-connections-client';
 /**
  * Lifecycle of the connect dialog: which offering is being connected, whether the
  * user is creating or editing, and the busy/error state the toolbar and the

package/node_modules/@undefineds.co/ai-connections/package.json

@@ -13,27 +13,31 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./client": {
-      "types": "./dist/ai-connections-client.d.ts",
-      "import": "./dist/ai-connections-client.js"
-    },
-    "./provider-catalog": {
-      "types": "./dist/provider-catalog.d.ts",
-      "import": "./dist/provider-catalog.js",
-      "require": "./dist/provider-catalog.cjs"
-    },
     "./manifest": {
       "types": "./dist/manifest.d.ts",
       "import": "./dist/manifest.js"
     },
+    "./client": {
+      "types": "./dist/contract/ai-connections-client.d.ts",
+      "import": "./dist/contract/ai-connections-client.js"
+    },
+    "./provider-catalog": {
+      "types": "./dist/contract/provider-catalog.d.ts",
+      "import": "./dist/contract/provider-catalog.js",
+      "require": "./dist/contract/provider-catalog.cjs"
+    },
     "./client-config": {
-      "types": "./dist/client-config/index.d.ts",
-      "import": "./dist/client-config/index.js",
-      "require": "./dist/client-config/index.cjs"
+      "types": "./dist/contract/client-config/index.d.ts",
+      "import": "./dist/contract/client-config/index.js",
+      "require": "./dist/contract/client-config/index.cjs"
+    },
+    "./endpoint-urls": {
+      "types": "./dist/contract/endpoint-urls.d.ts",
+      "import": "./dist/contract/endpoint-urls.js"
     }
   },
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.json && bun ../../scripts/fix-dist-js-imports.mjs dist && bun build src/client-config/index.ts --target=node --format=cjs --outfile=dist/client-config/index.cjs && bun build src/provider-catalog.ts --target=node --format=cjs --outfile=dist/provider-catalog.cjs",
+    "build": "rm -rf dist && tsc -p tsconfig.json && bun ../../scripts/fix-dist-js-imports.mjs dist && bun build src/contract/client-config/index.ts --target=node --format=cjs --outfile=dist/contract/client-config/index.cjs && bun build src/contract/provider-catalog.ts --target=node --format=cjs --outfile=dist/contract/provider-catalog.cjs",
     "test": "vitest run --config ../../vitest.packages.config.mts"
   },
   "dependencies": {
@@ -55,17 +59,20 @@
   },
   "typesVersions": {
     "*": {
+      "manifest": [
+        "dist/manifest.d.ts"
+      ],
       "provider-catalog": [
-        "dist/provider-catalog.d.ts"
+        "dist/contract/provider-catalog.d.ts"
       ],
       "client": [
-        "dist/ai-connections-client.d.ts"
+        "dist/contract/ai-connections-client.d.ts"
       ],
       "client-config": [
-        "dist/client-config/index.d.ts"
+        "dist/contract/client-config/index.d.ts"
       ],
-      "manifest": [
-        "dist/manifest.d.ts"
+      "endpoint-urls": [
+        "dist/contract/endpoint-urls.d.ts"
       ]
     }
   }

package/node_modules/@undefineds.co/shared-ui/dist/index.d.ts

@@ -9,9 +9,11 @@ export * from './user-facing-errors';
 export * from './input';
 export * from './label';
 export { LoginAccountView, LoginAvatar, LoginCardShell, LoginConnectingView, LoginErrorBanner, LoginFailureView, LoginRestoringView, RememberedLoginView, type RememberedLoginIdentity, type RememberedLoginViewCopy, type SessionLoginPresentationState, type SessionLoginStatus, } from './login';
-/** LinX product login surface. Xpod does not render this. */
+/**
+ * Shared login surface. Hosts inject their brand and product name;
+ * the component itself assumes neither.
+ */
 export { LoginModal, } from './login/LoginModal';
-/** LinX product login surface. Xpod does not render this. */
 export { LoginView, type LoginViewActions, type LoginViewProps, type LoginViewState, } from './login/LoginView';
 export { LocalReachabilitySummary, } from './login/LocalReachabilitySummary';
 export { getProviderActionLabel, getProviderDisplayLabel, getProviderInfoText, getProviderSourceLabel, getProviderStatusBadge, getProviderSubtitle, type ProviderStatusBadge, } from './login/presentation';

package/node_modules/@undefineds.co/shared-ui/dist/index.js

@@ -9,9 +9,11 @@ export * from './user-facing-errors.js';
 export * from './input.js';
 export * from './label.js';
 export { LoginAccountView, LoginAvatar, LoginCardShell, LoginConnectingView, LoginErrorBanner, LoginFailureView, LoginRestoringView, RememberedLoginView, } from './login.js';
-/** LinX product login surface. Xpod does not render this. */
+/**
+ * Shared login surface. Hosts inject their brand and product name;
+ * the component itself assumes neither.
+ */
 export { LoginModal, } from './login/LoginModal.js';
-/** LinX product login surface. Xpod does not render this. */
 export { LoginView, } from './login/LoginView.js';
 export { LocalReachabilitySummary, } from './login/LocalReachabilitySummary.js';
 export { getProviderActionLabel, getProviderDisplayLabel, getProviderInfoText, getProviderSourceLabel, getProviderStatusBadge, getProviderSubtitle, } from './login/presentation.js';

package/node_modules/@undefineds.co/shared-ui/dist/login/LoginModal.d.ts

@@ -1,3 +1,6 @@
 import type { LoginModalProps } from './types';
-/** LinX product login modal. Xpod does not render this component. */
+/**
+ * Shared login modal. The host supplies the brand and, optionally, the product
+ * name that user-facing messages refer to.
+ */
 export declare function LoginModal(props: LoginModalProps): import("react").JSX.Element | null;

package/node_modules/@undefineds.co/shared-ui/dist/login/LoginModal.js

@@ -7,13 +7,17 @@ import { getProviderDisplayLabel, } from './presentation.js';
 import { resolveLoginProviderSource } from './provider-model.js';
 import { LoginCardShell } from '../login.js';
 import { formatLoginErrorForUser } from './error-messages.js';
+import { LoginProductNameProvider, useLoginProductName } from './login-branding.js';
 import { LocalReachabilitySummary } from './LocalReachabilitySummary.js';
-/** LinX product login modal. Xpod does not render this component. */
+/**
+ * Shared login modal. The host supplies the brand and, optionally, the product
+ * name that user-facing messages refer to.
+ */
 export function LoginModal(props) {
     const { state, storageConflict, view } = props;
     if (state === 'authenticated' && !storageConflict)
         return null;
-    return (_jsx(LoginCardShell, { ariaLabel: props.ariaLabel ?? 'Sign in', overlayClassName: props.overlayClassName, cardClassName: props.cardClassName, cardSize: "compact", children: storageConflict ? (_jsx(StorageConflictView, { storedAccount: props.storedAccount, storageConflict: storageConflict, onDismiss: props.onDismissStorageConflict, onOpenCurrentSpacePodSetup: props.onOpenCurrentSpacePodSetup })) : state === 'restoring' ? (_jsx(RestoringView, { storedAccount: props.storedAccount })) : state === 'connecting' ? (_jsx(ConnectingView, { authWindowStatus: props.authWindowStatus, connectingProvider: props.connectingProvider, onCancel: props.onCancelConnecting })) : view === 'local' ? (_jsx(LocalOnboardingView, { localOnboarding: props.localOnboarding, localProviderSource: props.localProviderSource, error: props.error, onBack: props.onBackFromLocal, onContinue: props.onContinueLocalLogin, onSwitchAccount: props.onSwitchAccount, onTestConnectivity: props.onTestLocalConnectivity, onOpenSettings: props.onOpenLocalSettings, onClearError: props.onClearError })) : props.storedAccount ? (_jsx(AccountView, { storedAccount: props.storedAccount, hasRestorableSession: props.hasRestorableSession, onContinueStoredAccount: props.onContinueStoredAccount, onSwitchAccount: props.onSwitchAccount, error: props.error, onClearError: props.onClearError })) : (_jsx(ProviderSelectionView, { providers: props.providers, error: props.error, localLoginStatus: props.localLoginStatus, onConnect: props.onConnect, onAddProvider: props.onAddProvider, onClearError: props.onClearError, brand: props.brand, capabilities: props.capabilities })) }));
+    return (_jsx(LoginProductNameProvider, { productName: props.productName, children: _jsx(LoginCardShell, { ariaLabel: props.ariaLabel ?? 'Sign in', overlayClassName: props.overlayClassName, cardClassName: props.cardClassName, cardSize: "compact", children: storageConflict ? (_jsx(StorageConflictView, { storedAccount: props.storedAccount, storageConflict: storageConflict, onDismiss: props.onDismissStorageConflict, onOpenCurrentSpacePodSetup: props.onOpenCurrentSpacePodSetup })) : state === 'restoring' ? (_jsx(RestoringView, { storedAccount: props.storedAccount })) : state === 'connecting' ? (_jsx(ConnectingView, { authWindowStatus: props.authWindowStatus, connectingProvider: props.connectingProvider, onCancel: props.onCancelConnecting })) : view === 'local' ? (_jsx(LocalOnboardingView, { localOnboarding: props.localOnboarding, localProviderSource: props.localProviderSource, error: props.error, onBack: props.onBackFromLocal, onContinue: props.onContinueLocalLogin, onSwitchAccount: props.onSwitchAccount, onTestConnectivity: props.onTestLocalConnectivity, onOpenSettings: props.onOpenLocalSettings, onClearError: props.onClearError })) : props.storedAccount ? (_jsx(AccountView, { storedAccount: props.storedAccount, hasRestorableSession: props.hasRestorableSession, onContinueStoredAccount: props.onContinueStoredAccount, onSwitchAccount: props.onSwitchAccount, error: props.error, onClearError: props.onClearError })) : (_jsx(ProviderSelectionView, { providers: props.providers, error: props.error, localLoginStatus: props.localLoginStatus, onConnect: props.onConnect, onAddProvider: props.onAddProvider, onClearError: props.onClearError, brand: props.brand, capabilities: props.capabilities })) }) }));
 }
 function StorageConflictView({ storedAccount, storageConflict, onDismiss, onOpenCurrentSpacePodSetup, }) {
     const accountName = storedAccount?.displayName || '当前账号';
@@ -89,6 +93,7 @@ function ConnectingView({ authWindowStatus, connectingProvider, onCancel, }) {
 }
 // ── LocalOnboardingView ──────────────────────────────────────────────
 function LocalOnboardingView({ localOnboarding, localProviderSource, error, onBack, onContinue, onSwitchAccount, onTestConnectivity, onOpenSettings, onClearError, }) {
+    const productName = useLoginProductName();
     const snapshot = localOnboarding;
     const autoProbeKeyRef = useRef(null);
     const isStandalone = localProviderSource === 'standalone';
@@ -132,7 +137,7 @@ function LocalOnboardingView({ localOnboarding, localProviderSource, error, onBa
         snapshot?.publicUrl,
         snapshot?.spaceKind,
     ]);
-    return (_jsxs("div", { className: "flex-1 flex flex-col h-full", children: [_jsxs("div", { className: "px-5 pt-5 pb-3 shrink-0 flex items-center gap-2", children: [_jsxs("button", { onClick: onBack, className: "-ml-1.5 inline-flex h-8 items-center gap-1.5 rounded-lg px-2 text-xs text-muted-foreground hover:text-foreground hover:bg-muted/50 transition-colors cursor-pointer", "aria-label": "\u8FD4\u56DE\u7A7A\u95F4\u9009\u62E9", children: [_jsx(ArrowLeft, { className: "w-4 h-4" }), "\u8FD4\u56DE"] }), _jsx("h2", { className: "text-lg font-semibold text-foreground", children: productLabel })] }), _jsx(ErrorBanner, { error: error, onClearError: onClearError }), _jsx("div", { className: "flex-1 min-h-0 overflow-y-auto px-5 py-2", children: _jsxs("div", { className: "flex min-h-full flex-col justify-center gap-4", children: [(isPendingStart || isStarting) && (_jsxs("div", { className: "flex flex-col items-center gap-3 text-center", children: [_jsx(Loader2, { className: "w-6 h-6 text-primary animate-spin" }), _jsxs("p", { className: "text-sm font-medium text-foreground", children: ["\u6B63\u5728\u51C6\u5907", productLabel] }), _jsx("p", { className: "max-w-[18rem] text-xs leading-5 text-muted-foreground", children: progressDetail })] })), isReady && (_jsxs("div", { className: "flex flex-col gap-3", children: [_jsx("p", { className: "text-sm font-medium text-foreground text-center", children: isLocalNetworkBlocked ? '本机空间入口异常' : `${productLabel} 已准备好` }), isLocalNetworkBlocked ? (_jsx("p", { className: "text-xs text-muted-foreground leading-relaxed text-center", children: formatLocalStatusMessageForUser(connectivity?.message, '本机入口不可达。请确认本机空间已启动后重试。') })) : null, isStandalone ? (_jsx(RouteInfoCard, { title: "\u672C\u673A\u5165\u53E3", value: localUrl })) : null, !isStandalone ? (_jsx(LocalReachabilitySummary, { connectivity: connectivity, assumeLocalReachable: true })) : null, _jsx("button", { onClick: onContinue, className: "w-full h-10 rounded-xl bg-primary text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors cursor-pointer", children: isLocalNetworkBlocked ? '重新检测' : '继续登录' })] })), (isRepair || isError) && (_jsx(LocalUnavailableRecovery, { canOpenSettings: Boolean(snapshot?.canOpenSettings), canRetry: Boolean(snapshot?.canRetry), onRetry: onContinue, onOpenSettings: onOpenSettings ?? (() => undefined), onSwitchAccount: onSwitchAccount }))] }) }), _jsx("div", { className: "px-5 pb-5 shrink-0" }), _jsx(Footer, {})] }));
+    return (_jsxs("div", { className: "flex-1 flex flex-col h-full", children: [_jsxs("div", { className: "px-5 pt-5 pb-3 shrink-0 flex items-center gap-2", children: [_jsxs("button", { onClick: onBack, className: "-ml-1.5 inline-flex h-8 items-center gap-1.5 rounded-lg px-2 text-xs text-muted-foreground hover:text-foreground hover:bg-muted/50 transition-colors cursor-pointer", "aria-label": "\u8FD4\u56DE\u7A7A\u95F4\u9009\u62E9", children: [_jsx(ArrowLeft, { className: "w-4 h-4" }), "\u8FD4\u56DE"] }), _jsx("h2", { className: "text-lg font-semibold text-foreground", children: productLabel })] }), _jsx(ErrorBanner, { error: error, onClearError: onClearError }), _jsx("div", { className: "flex-1 min-h-0 overflow-y-auto px-5 py-2", children: _jsxs("div", { className: "flex min-h-full flex-col justify-center gap-4", children: [(isPendingStart || isStarting) && (_jsxs("div", { className: "flex flex-col items-center gap-3 text-center", children: [_jsx(Loader2, { className: "w-6 h-6 text-primary animate-spin" }), _jsxs("p", { className: "text-sm font-medium text-foreground", children: ["\u6B63\u5728\u51C6\u5907", productLabel] }), _jsx("p", { className: "max-w-[18rem] text-xs leading-5 text-muted-foreground", children: progressDetail })] })), isReady && (_jsxs("div", { className: "flex flex-col gap-3", children: [_jsx("p", { className: "text-sm font-medium text-foreground text-center", children: isLocalNetworkBlocked ? '本机空间入口异常' : `${productLabel} 已准备好` }), isLocalNetworkBlocked ? (_jsx("p", { className: "text-xs text-muted-foreground leading-relaxed text-center", children: formatLocalStatusMessageForUser(connectivity?.message, '本机入口不可达。请确认本机空间已启动后重试。', productName) })) : null, isStandalone ? (_jsx(RouteInfoCard, { title: "\u672C\u673A\u5165\u53E3", value: localUrl })) : null, !isStandalone ? (_jsx(LocalReachabilitySummary, { connectivity: connectivity, assumeLocalReachable: true })) : null, _jsx("button", { onClick: onContinue, className: "w-full h-10 rounded-xl bg-primary text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors cursor-pointer", children: isLocalNetworkBlocked ? '重新检测' : '继续登录' })] })), (isRepair || isError) && (_jsx(LocalUnavailableRecovery, { canOpenSettings: Boolean(snapshot?.canOpenSettings), canRetry: Boolean(snapshot?.canRetry), onRetry: onContinue, onOpenSettings: onOpenSettings ?? (() => undefined), onSwitchAccount: onSwitchAccount }))] }) }), _jsx("div", { className: "px-5 pb-5 shrink-0" }), _jsx(Footer, {})] }));
 }
 function RouteInfoCard({ title, value, action, }) {
     return (_jsxs("div", { className: "rounded-2xl border border-border/60 bg-muted/25 p-3", children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsx("p", { className: "text-[11px] font-medium tracking-wide text-muted-foreground/70", children: title }), action] }), _jsx("p", { className: "mt-2 break-all font-mono text-[11px] leading-5 text-foreground", children: value ?? '正在获取入口' })] }));
@@ -163,8 +168,8 @@ function getLocalPreparationDetail(state, progressPhase) {
         return '正在准备登录授权';
     return '正在启动本机服务';
 }
-function formatLocalStatusMessageForUser(value, fallback) {
-    return formatLoginErrorForUser(value, fallback);
+function formatLocalStatusMessageForUser(value, fallback, productName) {
+    return formatLoginErrorForUser(value, fallback, { productName });
 }
 function formatProviderLabelForUser(value) {
     if (value === 'Cloud')
@@ -176,9 +181,10 @@ function formatProviderLabelForUser(value) {
     return value ?? '所选空间';
 }
 function ErrorBanner({ error, onClearError }) {
+    const productName = useLoginProductName();
     if (!error)
         return null;
-    const message = formatLoginErrorForUser(error, '操作失败，请返回上一步后重试。');
+    const message = formatLoginErrorForUser(error, '操作失败，请返回上一步后重试。', { productName });
     return (_jsxs("div", { className: "mx-4 mb-3 px-3 py-2 bg-destructive/10 rounded-lg flex items-start gap-2 shrink-0", children: [_jsx(AlertCircle, { className: "w-3.5 h-3.5 text-destructive mt-0.5 shrink-0" }), _jsx("p", { className: "text-xs text-destructive flex-1 leading-relaxed", children: message }), _jsx("button", { onClick: onClearError, className: "text-destructive/60 hover:text-destructive shrink-0 cursor-pointer", "aria-label": "\u5173\u95ED\u9519\u8BEF\u63D0\u793A", children: _jsx(X, { className: "w-3.5 h-3.5" }) })] }));
 }
 function Footer() {

package/node_modules/@undefineds.co/shared-ui/dist/login/LoginView.d.ts

@@ -9,7 +9,7 @@ export interface LoginViewActions {
     dismissError: () => void;
 }
 /**
- * LinX-controlled authentication presentation. Xpod does not render this.
+ * Shared authentication presentation, driven by the host that renders it.
  *
  * `error` is idle-context copy, not a fifth product phase. Session creation,
  * restoration and Account/WebID composition belong to the host.

package/node_modules/@undefineds.co/shared-ui/dist/login/host-types.d.ts

@@ -64,9 +64,15 @@ export interface StorageConflict {
 export interface LoginModalHostProps {
     /** Presentational seam only; hosts supply their own product brand. */
     brand?: ReactNode;
+    /**
+     * The name this host's product is shown under, used in user-facing text such
+     * as an error that asks the user to restart the application. Shared components
+     * do not assume one: leaving it out renders the neutral default.
+     */
+    productName?: string;
     /** Accessible dialog label for the login surface. */
     ariaLabel?: string;
-    /** Optional affordances. Omitted values preserve the complete LinX source UI. */
+    /** Optional affordances. Omitted values preserve the complete source UI. */
     capabilities?: {
         storageSelection?: boolean;
         additionalProviders?: boolean;

package/node_modules/@undefineds.co/shared-ui/dist/login/login-branding.d.ts

@@ -0,0 +1,6 @@
+import { type ReactNode } from 'react';
+export declare function LoginProductNameProvider({ productName, children, }: {
+    productName?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useLoginProductName(): string;

package/node_modules/@undefineds.co/shared-ui/dist/login/login-branding.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+import { DEFAULT_PRODUCT_NAME } from '../user-facing-errors.js';
+/**
+ * The name the host's product is shown under, for the shared login surface.
+ *
+ * The login components are shared, so none of them may assume a product name:
+ * this carries the host's choice to the few places that mention the product in
+ * user-facing text - an error that asks the user to restart the application, for
+ * instance - without threading a prop through every nested view.
+ */
+const LoginProductNameContext = createContext(DEFAULT_PRODUCT_NAME);
+export function LoginProductNameProvider({ productName, children, }) {
+    return (_jsx(LoginProductNameContext.Provider, { value: productName?.trim() || DEFAULT_PRODUCT_NAME, children: children }));
+}
+export function useLoginProductName() {
+    return useContext(LoginProductNameContext);
+}

package/node_modules/@undefineds.co/shared-ui/dist/user-facing-errors.d.ts

@@ -1,2 +1,14 @@
-export declare function formatErrorForUser(error: unknown, fallback?: string): string;
-export declare function createUserFacingError(error: unknown, fallback: string): Error;
+/**
+ * Product name used in user-facing text when the caller supplies none.
+ *
+ * These components are shared, so they must not assert a product identity: a
+ * host passes its own name in, and the fallback stays neutral enough to read
+ * correctly for any of them.
+ */
+export declare const DEFAULT_PRODUCT_NAME = "\u5E94\u7528";
+export interface UserFacingErrorOptions {
+    /** The name the host's product is shown under. */
+    productName?: string;
+}
+export declare function formatErrorForUser(error: unknown, fallback?: string, options?: UserFacingErrorOptions): string;
+export declare function createUserFacingError(error: unknown, fallback: string, options?: UserFacingErrorOptions): Error;