@undefineds.co/xpod 0.4.12 → 0.4.14

package/node_modules/@undefineds.co/ai-connections/dist/{client-config → contract/client-config}/index.cjs

@@ -60,7 +60,7 @@ var __export = (target, all) => {
     });
 };
 
-// src/client-config/index.ts
+// src/contract/client-config/index.ts
 var exports_client_config = {};
 __export(exports_client_config, {
   stripLegacyXpodObject: () => stripLegacyXpodObject,
@@ -85,12 +85,12 @@ __export(exports_client_config, {
 });
 module.exports = __toCommonJS(exports_client_config);
 
-// src/client-config/base-adapter.ts
+// src/contract/client-config/base-adapter.ts
 var crypto2 = __toESM(require("node:crypto"));
 var fs2 = __toESM(require("node:fs"));
 var path2 = __toESM(require("node:path"));
 
-// src/client-config/transaction.ts
+// src/contract/client-config/transaction.ts
 var crypto = __toESM(require("node:crypto"));
 var fs = __toESM(require("node:fs"));
 var path = __toESM(require("node:path"));
@@ -269,7 +269,7 @@ class AiClientConfigTransaction {
   }
 }
 
-// src/endpoint-urls.ts
+// src/contract/endpoint-urls.ts
 function normalizeV1Endpoint(endpoint) {
   const normalized = endpoint.trim().replace(/\/+$/, "");
   return normalized.endsWith("/v1") ? normalized : `${normalized}/v1`;
@@ -278,7 +278,7 @@ function normalizeMessagesEndpoint(endpoint) {
   return endpoint.trim().replace(/\/+$/, "").replace(/\/v1$/, "");
 }
 
-// src/client-config/base-adapter.ts
+// src/contract/client-config/base-adapter.ts
 class AiClientConfigError extends Error {
   code;
   constructor(code, message = code) {
@@ -587,7 +587,7 @@ class BaseAiClientConfigAdapter {
     return false;
   }
 }
-// src/client-config/codex.ts
+// src/contract/client-config/codex.ts
 var fs3 = __toESM(require("node:fs"));
 var os = __toESM(require("node:os"));
 var path3 = __toESM(require("node:path"));
@@ -998,7 +998,7 @@ function readCatalogModels(content, label) {
   }
   return catalog.models;
 }
-// src/client-config/json-env-adapter.ts
+// src/contract/client-config/json-env-adapter.ts
 var fs4 = __toESM(require("node:fs"));
 var os2 = __toESM(require("node:os"));
 var path4 = __toESM(require("node:path"));
@@ -1090,7 +1090,7 @@ class CodeBuddyConfigAdapter extends JsonEnvAdapter {
     }));
   }
 }
-// src/client-config/pi.ts
+// src/contract/client-config/pi.ts
 var fs5 = __toESM(require("node:fs"));
 var os3 = __toESM(require("node:os"));
 var path5 = __toESM(require("node:path"));

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

@@ -0,0 +1,9 @@
+/**
+ * Root entry of the shared core.
+ *
+ * The client protocol is what most consumers want, and it is the same surface
+ * `@undefineds.co/ai-connections/client` publishes. The catalog and the
+ * client-configuration adapters stay on their own subpaths because they are
+ * larger and only some consumers need them.
+ */
+export * from './ai-connections-client';

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

@@ -0,0 +1,9 @@
+/**
+ * Root entry of the shared core.
+ *
+ * The client protocol is what most consumers want, and it is the same surface
+ * `@undefineds.co/ai-connections/client` publishes. The catalog and the
+ * client-configuration adapters stay on their own subpaths because they are
+ * larger and only some consumers need them.
+ */
+export * from './ai-connections-client.js';

package/node_modules/@undefineds.co/ai-connections/dist/{provider-catalog.cjs → contract/provider-catalog.cjs}

@@ -36,12 +36,11 @@ var __export = (target, all) => {
     });
 };
 
-// src/provider-catalog.ts
+// src/contract/provider-catalog.ts
 var exports_provider_catalog = {};
 __export(exports_provider_catalog, {
   storedOfferingIdFor: () => storedOfferingIdFor,
   providerOfferings: () => providerOfferings,
-  providerName: () => providerName,
   offeringBaseUrl: () => offeringBaseUrl,
   defaultOfferingFor: () => defaultOfferingFor,
   customCompatibilityValue: () => customCompatibilityValue,
@@ -55,7 +54,7 @@ __export(exports_provider_catalog, {
 });
 module.exports = __toCommonJS(exports_provider_catalog);
 
-// src/client/types.ts
+// src/contract/client/types.ts
 var AI_CONNECTIONS_PROVIDERS = [
   "openai",
   "anthropic",
@@ -67,21 +66,19 @@ var AI_CONNECTIONS_PROVIDERS = [
   "custom"
 ];
 
-// src/provider-catalog.ts
+// src/contract/provider-catalog.ts
 var DEFAULT_PROVIDER_OFFERINGS = [
   { id: "api-platform", label: "API Platform", kind: "api-platform", lifecycle: "active", authModes: ["apiKey"] }
 ];
 var API_KEY_METHOD = {
   id: "api-key",
   authMode: "apiKey",
-  label: "添加 API Key",
   lifecycle: "active"
 };
 var BROWSER_LOGIN_METHOD = {
   id: "browser-login",
   authMode: "apiKey",
   connectMode: "browserAssistedApiKey",
-  label: "浏览器登录",
   lifecycle: "active"
 };
 var API_KEY_METHODS = [API_KEY_METHOD, BROWSER_LOGIN_METHOD];
@@ -381,8 +378,8 @@ function providerOfferings(provider, openAiSubscriptionImportAvailable = false)
         lifecycle: "active",
         authModes: Array.from(new Set([...offering.authModes ?? [], "local"])),
         authorizationMethods: [
-          { id: "device-code", authMode: "deviceCode", connectMode: "deviceCodeOAuth", label: "设备码登录", lifecycle: "active" },
-          { id: "local-session-import", authMode: "local", label: "已有登录态", lifecycle: "active" }
+          { id: "device-code", authMode: "deviceCode", connectMode: "deviceCodeOAuth", lifecycle: "active" },
+          { id: "local-session-import", authMode: "local", lifecycle: "active" }
         ]
       };
     }
@@ -403,26 +400,6 @@ function customCompatibilityValue(value, offeringId) {
     return "anthropic";
   return "openai";
 }
-function providerName(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";
-  }
-}
 function defaultOfferingFor(provider, authMode) {
   if (provider === "openai" && (authMode === "local" || authMode === "oauth" || authMode === "deviceCode")) {
     return "official-subscription";

package/node_modules/@undefineds.co/ai-connections/dist/{provider-catalog.d.ts → contract/provider-catalog.d.ts}

@@ -3,9 +3,10 @@ export declare const DEFAULT_PROVIDER_OFFERINGS: AiProviderOffering[];
 /**
  * How an offering accepts a key: typed into Xpod's own form (this entry) or
  * minted in the provider's console (the browser-assisted entry below). An
- * offering that declares its actions declares this one too - the catalog is the
- * single source of the wording, and the server only decides whether the entry is
- * usable in a given deployment.
+ * offering that declares its actions declares this one too - the catalog names
+ * the action by id and the server only decides whether the entry is usable in a
+ * given deployment. The wording a user reads is the applet's
+ * (`display-wording.ts`), so the same action cannot be named three ways.
  */
 export declare const API_KEY_METHOD: AiProviderAuthorizationMethod;
 /**
@@ -19,10 +20,11 @@ export declare const API_KEY_METHOD: AiProviderAuthorizationMethod;
  * account console to sign into, Ollama is a local service, and `custom` is
  * configured inside Xpod rather than at a provider.
  *
- * The label is 浏览器登录 rather than the legacy 「登录」 because it names the
- * action the way its siblings do (浏览器登录 / 设备码登录 / 已有登录态); 「登录」
- * named the provider instead, which is what let a provider-level string claim a
- * capability no offering declared.
+ * The id names the action the way its siblings do (browser-login / device-code /
+ * local-session-import); the wording follows from the id in the applet, and the
+ * legacy 「登录」 was retired because it named the provider rather than the
+ * action - which is what let a provider-level string claim a capability no
+ * offering declared.
  */
 export declare const BROWSER_LOGIN_METHOD: AiProviderAuthorizationMethod;
 export declare const CUSTOM_DEFAULT_OFFERINGS: AiProviderOffering[];
@@ -42,7 +44,6 @@ export declare function providerOfferings(provider: AiConnectionsProvider, openA
  */
 export declare const AI_CONNECTIONS_PROVIDER_DOCUMENT_IDS: readonly string[];
 export declare function customCompatibilityValue(value: unknown, offeringId?: string): 'openai' | 'anthropic';
-export declare function providerName(provider: AiConnectionsProvider): string;
 export declare function defaultOfferingFor(provider: AiConnectionsProvider, authMode: AiProviderCredentialSummary['authMode']): string;
 export declare function offeringBaseUrl(provider: AiConnectionsProvider, offeringId?: string): string | undefined;
 /**

package/node_modules/@undefineds.co/ai-connections/dist/{provider-catalog.js → contract/provider-catalog.js}

@@ -8,14 +8,14 @@ export const DEFAULT_PROVIDER_OFFERINGS = [
 /**
  * How an offering accepts a key: typed into Xpod's own form (this entry) or
  * minted in the provider's console (the browser-assisted entry below). An
- * offering that declares its actions declares this one too - the catalog is the
- * single source of the wording, and the server only decides whether the entry is
- * usable in a given deployment.
+ * offering that declares its actions declares this one too - the catalog names
+ * the action by id and the server only decides whether the entry is usable in a
+ * given deployment. The wording a user reads is the applet's
+ * (`display-wording.ts`), so the same action cannot be named three ways.
  */
 export const API_KEY_METHOD = {
     id: 'api-key',
     authMode: 'apiKey',
-    label: '添加 API Key',
     lifecycle: 'active',
 };
 /**
@@ -29,16 +29,16 @@ export const API_KEY_METHOD = {
  * account console to sign into, Ollama is a local service, and `custom` is
  * configured inside Xpod rather than at a provider.
  *
- * The label is 浏览器登录 rather than the legacy 「登录」 because it names the
- * action the way its siblings do (浏览器登录 / 设备码登录 / 已有登录态); 「登录」
- * named the provider instead, which is what let a provider-level string claim a
- * capability no offering declared.
+ * The id names the action the way its siblings do (browser-login / device-code /
+ * local-session-import); the wording follows from the id in the applet, and the
+ * legacy 「登录」 was retired because it named the provider rather than the
+ * action - which is what let a provider-level string claim a capability no
+ * offering declared.
  */
 export const BROWSER_LOGIN_METHOD = {
     id: 'browser-login',
     authMode: 'apiKey',
     connectMode: 'browserAssistedApiKey',
-    label: '浏览器登录',
     lifecycle: 'active',
 };
 /** Both ways a key arrives, for an offering whose provider has a console. */
@@ -351,8 +351,8 @@ export function providerOfferings(provider, openAiSubscriptionImportAvailable =
                 lifecycle: 'active',
                 authModes: Array.from(new Set([...(offering.authModes ?? []), 'local'])),
                 authorizationMethods: [
-                    { id: 'device-code', authMode: 'deviceCode', connectMode: 'deviceCodeOAuth', label: '设备码登录', lifecycle: 'active' },
-                    { id: 'local-session-import', authMode: 'local', label: '已有登录态', lifecycle: 'active' },
+                    { id: 'device-code', authMode: 'deviceCode', connectMode: 'deviceCodeOAuth', lifecycle: 'active' },
+                    { id: 'local-session-import', authMode: 'local', lifecycle: 'active' },
                 ],
             };
         }
@@ -391,26 +391,6 @@ export function customCompatibilityValue(value, offeringId) {
         return 'anthropic';
     return 'openai';
 }
-export function providerName(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';
-    }
-}
 export function defaultOfferingFor(provider, authMode) {
     if (provider === 'openai' && (authMode === 'local' || authMode === 'oauth' || authMode === 'deviceCode')) {
         return 'official-subscription';

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

@@ -1,5 +1,5 @@
 import type { SolidLiveUpdateState, WebExtensionHost } from '@undefineds.co/extension-sdk/web';
-import { type AiConnectionsClient, type AiConnectionsProvider, type AiProviderConnectionSummary, type AiProviderSummary } from './ai-connections-client';
+import { type AiConnectionsClient, type AiConnectionsProvider, type AiProviderConnectionSummary, type AiProviderSummary } from './contract/ai-connections-client';
 import type { AiClientConfigurationBridge } from './AiClientConfigurationSection';
 import { type CredentialRow } from './collections';
 import type { PodCollection } from '@undefineds.co/pod-collections';

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

@@ -1,5 +1,6 @@
 import { useSyncExternalStore } from 'react';
-import { AI_CONNECTIONS_PROVIDERS, AiConnectionsRequestError, createAiConnectionsClient, normalizeAiConnectionsThrownError, } from './ai-connections-client.js';
+import { AI_CONNECTIONS_PROVIDERS, AiConnectionsRequestError, createAiConnectionsClient, } from './contract/ai-connections-client.js';
+import { aiConnectionsErrorMessage } from './error-wording.js';
 import { credentialCollectionRuntime, } from './collections.js';
 /**
  * Provider pages explain themselves through the header's ⓘ tooltip, so each
@@ -1014,7 +1015,7 @@ function isDefined(value) {
     return value !== undefined;
 }
 function errorMessage(error) {
-    return normalizeAiConnectionsThrownError(error);
+    return aiConnectionsErrorMessage(error);
 }
 /** The wrapper carries the OIDC client id; parsing it needs no stored secret. */
 function clientIdFromApiKey(apiKey) {

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

@@ -1,4 +1,4 @@
-import type { AiProviderCredentialSummary } from './ai-connections-client';
+import type { AiProviderCredentialSummary } from './contract/ai-connections-client';
 /** Highest priority first: a new credential joins the end of the pool. */
 export declare function nextCredentialPriority(credentials: AiProviderCredentialSummary[]): number;
 export declare function credentialDisplayLabel(credential: AiProviderCredentialSummary): string;

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

@@ -0,0 +1,20 @@
+import type { AiConnectionsProvider, AiProviderAuthorizationMethod } from './contract/ai-connections-client';
+/**
+ * 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 declare function authorizationMethodLabel(method: AiProviderAuthorizationMethod): string | undefined;
+/** Fills in the wording of every entry that has one. */
+export declare function withAuthorizationMethodLabels(methods: readonly AiProviderAuthorizationMethod[]): AiProviderAuthorizationMethod[];
+/**
+ * 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 declare function providerDisplayName(provider: AiConnectionsProvider): string;

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 './contract/ai-connections-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;