@undefineds.co/xpod 0.4.12 → 0.4.13

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

@@ -0,0 +1,73 @@
+/**
+ * The wording this applet shows, in one place.
+ *
+ * The shared core carries what a provider *is* and how to talk to it - ids,
+ * auth modes, connect modes, endpoints - and deliberately carries no user-facing
+ * wording. A connect entry's wording is a property of the entry's id, so it
+ * belongs here, where it is rendered, rather than in the catalog, in the
+ * payload the server sends, and in this applet's own fallback derivation, which
+ * is where the same button used to be named three different ways.
+ *
+ * An id this table does not know keeps whatever wording its payload declared:
+ * a provider the user configured themselves can still name its own entry, and an
+ * entry that names nothing stays unrendered, which is how "the offering did not
+ * ask for this button" has always been expressed.
+ *
+ * The table lists only the ids the shared core stopped naming - the four connect
+ * actions plus the browser authorization-code entry. A declared wording always
+ * wins (see `authorizationMethodLabel`); this is the fallback that keeps a
+ * payload naming nothing renderable under the action's own name.
+ */
+const AUTHORIZATION_METHOD_LABEL_BY_ID = {
+    'api-key': '添加 API Key',
+    'browser-login': '浏览器登录',
+    'browser-oauth': '浏览器登录',
+    'device-code': '设备码登录',
+    'local-session-import': '已有登录态',
+    'local-service': '本地服务',
+};
+/**
+ * Wording for one connect entry.
+ *
+ * A payload that declares its own wording keeps it: the entry's own name is the
+ * more specific statement, and it is how a provider the user configured names
+ * its entry, and how one offering renames a shared action for its context. The
+ * table only fills the gap the shared core deliberately leaves - it names the
+ * action by `id` and no longer writes the button.
+ */
+export function authorizationMethodLabel(method) {
+    return method.label ?? AUTHORIZATION_METHOD_LABEL_BY_ID[method.id];
+}
+/** Fills in the wording of every entry that has one. */
+export function withAuthorizationMethodLabels(methods) {
+    return methods.map((method) => {
+        const label = authorizationMethodLabel(method);
+        return label === method.label ? method : { ...method, label };
+    });
+}
+/**
+ * The name this applet shows for a provider. English for the providers whose
+ * product name is English, Chinese where the product is known by its Chinese
+ * name - a display decision, so it lives with the display layer instead of
+ * travelling in every payload.
+ */
+export function providerDisplayName(provider) {
+    switch (provider) {
+        case 'openai':
+            return 'OpenAI';
+        case 'anthropic':
+            return 'Anthropic';
+        case 'kimi':
+            return 'Kimi';
+        case 'bailian':
+            return '百炼';
+        case 'deepseek':
+            return 'DeepSeek';
+        case 'zhipu':
+            return '智谱 AI';
+        case 'ollama':
+            return 'Ollama';
+        case 'custom':
+            return 'Custom';
+    }
+}

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

@@ -0,0 +1,24 @@
+import type { AiConnectionsClient, AiConnectionsProvider } from '@undefineds.co/ai-connections-core/client';
+/**
+ * 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 declare function aiConnectionsErrorMessage(error: unknown): string;
+export declare function aiConnectionsErrorMessageForPayload(payload: unknown, status: number, context?: {
+    provider?: AiConnectionsProvider;
+    authMode?: 'apiKey' | 'deviceCodeOAuth' | 'local';
+}): string;
+/**
+ * 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 declare function withDisplayableErrors(client: AiConnectionsClient): AiConnectionsClient;

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

@@ -0,0 +1,253 @@
+import { AiConnectionsRequestError, aiConnectionsErrorCode } from '@undefineds.co/ai-connections-core/client';
+/**
+ * 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 '@undefineds.co/ai-connections-core/endpoint-urls';
 /**
  * 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 '@undefineds.co/ai-connections-core/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 '@undefineds.co/ai-connections-core/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 '@undefineds.co/ai-connections-core/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 '@undefineds.co/ai-connections-core/provider-catalog';
 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 '@undefineds.co/ai-connections-core/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,13 @@
       "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-config": {
-      "types": "./dist/client-config/index.d.ts",
-      "import": "./dist/client-config/index.js",
-      "require": "./dist/client-config/index.cjs"
     }
   },
   "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",
     "test": "vitest run --config ../../vitest.packages.config.mts"
   },
   "dependencies": {
@@ -55,15 +41,6 @@
   },
   "typesVersions": {
     "*": {
-      "provider-catalog": [
-        "dist/provider-catalog.d.ts"
-      ],
-      "client": [
-        "dist/ai-connections-client.d.ts"
-      ],
-      "client-config": [
-        "dist/client-config/index.d.ts"
-      ],
       "manifest": [
         "dist/manifest.d.ts"
       ]

package/node_modules/@undefineds.co/{ai-connections → ai-connections-core}/dist/ai-connections-client.d.ts

@@ -1,6 +1,8 @@
 /**
- * Public entry point of the AI connections client
- * (`@undefineds.co/ai-connections/client`).
+ * Public entry point of the AI Connections client protocol. This package is
+ * the shared core: the gateway and the applet both consume it, and the applet
+ * (`@undefineds.co/ai-connections`) adds the components, artwork and wording.
+ * (`@undefineds.co/ai-connections-core/client`).
  *
  * The implementation lives in `./client`, split into wire types, payload
  * normalisation and the request factory. This file stays a barrel — importers
@@ -10,7 +12,7 @@
  */
 export { AI_CONNECTIONS_PROVIDERS } from './client/types';
 export type { AiConnectAttempt, AiConnectionBeginOptions, AiConnectionsClient, AiConnectionsCredential, AiConnectionsMode, AiConnectionsProvider, AiConnectStatus, AiGatewayModel, AiProviderAuthorizationMethod, AiProviderAuthorizationMethodId, AiProviderAuthorizationMethodsSummary, AiProviderConnectionSummary, AiProviderCredentialSummary, AiProviderOffering, AiProviderSummary, AiProviderSummaryStatus, AiQuotaSnapshot, AiQuotaWindow, CreateApiKeyCredentialInput, CreatedGatewayKey, CustomProviderModel, DiscoveredProviderModel, GatewayKeyRecord, ProviderModelDiscovery, TestProviderCredentialInput, UpdateProviderCredentialInput, } from './client/types';
-export { AI_CONNECTIONS_GENERIC_ERROR_MESSAGE, AiConnectionsRequestError, normalizeAiConnectionsErrorMessage, normalizeAiConnectionsThrownError, normalizeProxyUrl, redactProxyUrl, } from './client/normalize';
+export { AiConnectionsRequestError, aiConnectionsErrorCode, normalizeProxyUrl, redactProxyUrl, } from './client/normalize';
 export { createAiConnectionsClient, resolveAiConnectionsApiBase } from './client/request';
 /**
  * Storage-shape rules for credential rows. They are shared with the Pod adapter

package/node_modules/@undefineds.co/{ai-connections → ai-connections-core}/dist/ai-connections-client.js

@@ -1,6 +1,8 @@
 /**
- * Public entry point of the AI connections client
- * (`@undefineds.co/ai-connections/client`).
+ * Public entry point of the AI Connections client protocol. This package is
+ * the shared core: the gateway and the applet both consume it, and the applet
+ * (`@undefineds.co/ai-connections`) adds the components, artwork and wording.
+ * (`@undefineds.co/ai-connections-core/client`).
  *
  * The implementation lives in `./client`, split into wire types, payload
  * normalisation and the request factory. This file stays a barrel — importers
@@ -9,7 +11,7 @@
  * parsers under `./client` are internal, and `export *` would publish them.
  */
 export { AI_CONNECTIONS_PROVIDERS } from './client/types.js';
-export { AI_CONNECTIONS_GENERIC_ERROR_MESSAGE, AiConnectionsRequestError, normalizeAiConnectionsErrorMessage, normalizeAiConnectionsThrownError, normalizeProxyUrl, redactProxyUrl, } from './client/normalize.js';
+export { AiConnectionsRequestError, aiConnectionsErrorCode, normalizeProxyUrl, redactProxyUrl, } from './client/normalize.js';
 export { createAiConnectionsClient, resolveAiConnectionsApiBase } from './client/request.js';
 /**
  * Storage-shape rules for credential rows. They are shared with the Pod adapter

package/node_modules/@undefineds.co/{ai-connections → ai-connections-core}/dist/client/normalize.d.ts

@@ -8,7 +8,6 @@ import type { AiConnectAttempt, AiConnectionsCredential, AiConnectionsProvider,
  * within this module family. The published surface is the explicit list in
  * `ai-connections-client.ts`, not this file.
  */
-export declare const AI_CONNECTIONS_GENERIC_ERROR_MESSAGE = "AI Connection request failed. Please try again.";
 /**
  * Validate and normalize a user supplied upstream proxy URL. Proxy credentials
  * are intentionally rejected because proxy auth is not stored in the Pod
@@ -16,16 +15,27 @@ export declare const AI_CONNECTIONS_GENERIC_ERROR_MESSAGE = "AI Connection reque
  */
 export declare function normalizeProxyUrl(value: string | undefined | null): string | undefined;
 export declare function redactProxyUrl(value: string | undefined | null): string | undefined;
+/**
+ * A failed AI Connection request.
+ *
+ * It carries the facts a caller needs to decide what to say - the wire code, the
+ * upstream status, the payload itself - and a diagnostic message that names the
+ * code. The sentence a user reads is the applet's (`error-wording.ts`): a shared
+ * client must not pick the wording for whoever happens to render it.
+ */
 export declare class AiConnectionsRequestError extends Error {
     readonly code?: string;
+    readonly status: number;
     readonly providerStatus?: number;
-    constructor(message: string, payload: unknown);
+    readonly payload: unknown;
+    readonly provider?: string;
+    readonly authMode?: string;
+    constructor(payload: unknown, status: number, context?: {
+        provider?: string;
+        authMode?: string;
+    });
 }
-export declare function normalizeAiConnectionsThrownError(error: unknown): string;
-export declare function normalizeAiConnectionsErrorMessage(payload: unknown, status: number, context?: {
-    provider?: AiConnectionsProvider;
-    authMode?: 'apiKey' | 'deviceCodeOAuth' | 'local';
-}): string;
+export declare function aiConnectionsErrorCode(payload: unknown): string | undefined;
 export declare function readJson(response: Response): Promise<unknown>;
 export declare function assertProvider(provider: string): asserts provider is AiConnectionsProvider;
 export declare function parseGatewayKeyRecord(value: unknown): GatewayKeyRecord | undefined;