@oxy.so/services 1.0.3 → 1.1.0

package/lib/typescript/module/ui/components/OxyConsentScreen.d.ts

@@ -1,3 +1,4 @@
+import type { McpOAuthWriteAction } from '@oxy.so/contracts';
 /** The requesting application, resolved by the caller (never user-supplied raw). */
 export interface OxyConsentApplication {
     /** Display name of the requesting application. */
@@ -17,6 +18,8 @@ export interface OxyConsentApplication {
 }
 /** The account that will authorize the request (the currently signed-in user). */
 export interface OxyConsentUser {
+    /** Exact effective account bound to the grant. */
+    accountId?: string;
     /** Real display name, when the profile has one. */
     displayName?: string;
     /** Normalized handle — the sanctioned fallback when `displayName` is absent. */
@@ -24,6 +27,17 @@ export interface OxyConsentUser {
     /** Avatar — a URL or bare file id passed straight to `<Avatar source>`. */
     avatarUri?: string;
 }
+export interface OxyConsentResource {
+    /** Oxy application that owns the protected MCP resource. */
+    application: {
+        name: string;
+        iconUrl?: string;
+    };
+    /** Canonical protected-resource URI bound into the access token. */
+    uri: string;
+    /** Effectful tools enabled by the requested capabilities. */
+    writeActions: McpOAuthWriteAction[];
+}
 export interface OxyConsentScreenProps {
     /** The resolved requesting application. */
     application: OxyConsentApplication;
@@ -31,6 +45,8 @@ export interface OxyConsentScreenProps {
     scopes: string[];
     /** The account that will authorize the request, when known. */
     user?: OxyConsentUser;
+    /** Exact protected resource for an external MCP connection. */
+    resource?: OxyConsentResource;
     /** Approve handler — the caller mints the code / completes the flow. */
     onAllow: () => void | Promise<void>;
     /** Deny handler — the caller cancels the flow. */
@@ -40,6 +56,6 @@ export interface OxyConsentScreenProps {
     /** A blocking error message for the request, when present. */
     error?: string | null;
 }
-export declare function OxyConsentScreen({ application, scopes, user, onAllow, onDeny, busy, error, }: OxyConsentScreenProps): import("react").JSX.Element;
+export declare function OxyConsentScreen({ application, scopes, user, resource, onAllow, onDeny, busy, error, }: OxyConsentScreenProps): import("react").JSX.Element;
 export default OxyConsentScreen;
 //# sourceMappingURL=OxyConsentScreen.d.ts.map

package/lib/typescript/module/ui/components/OxyConsentScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyConsentScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/OxyConsentScreen.tsx"],"names":[],"mappings":"AA8BA,oFAAoF;AACpF,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,WAAW,EAAE,qBAAqB,CAAC;IACnC,wEAAwE;IACxE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,wEAAwE;IACxE,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,kDAAkD;IAClD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAqHD,wBAAgB,gBAAgB,CAAC,EAC/B,WAAW,EACX,MAAM,EACN,IAAI,EACJ,OAAO,EACP,MAAM,EACN,IAAY,EACZ,KAAY,GACb,EAAE,qBAAqB,+BA6KvB;AAoID,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"OxyConsentScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/OxyConsentScreen.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAQ7D,oFAAoF;AACpF,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,YAAY,EAAE,mBAAmB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,WAAW,EAAE,qBAAqB,CAAC;IACnC,wEAAwE;IACxE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,wEAAwE;IACxE,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,kDAAkD;IAClD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAqHD,wBAAgB,gBAAgB,CAAC,EAC/B,WAAW,EACX,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,MAAM,EACN,IAAY,EACZ,KAAY,GACb,EAAE,qBAAqB,+BA+OvB;AA+KD,eAAe,gBAAgB,CAAC"}

package/lib/typescript/module/ui/components/OxyProvider.d.ts

@@ -34,6 +34,20 @@ import type { OxyProviderProps } from '../types/navigation.js';
  *   return <Text>Welcome, {user?.username}!</Text>;
  * }
  * ```
+ *
+ * An app with its own translated UI passes a language config to follow the account's
+ * (or, signed out, the device/guest) resolved locale automatically — see ADR
+ * 0022 (`docs/adr/0022-app-i18n-follows-oxy-language.md`):
+ * ```tsx
+ * <OxyProvider
+ *   baseURL="https://api.oxy.so"
+ *   language={{
+ *     supportedLocales: SUPPORTED_LANGUAGES,       // this app's own catalog
+ *     fallbackLocale: DEFAULT_LANGUAGE,
+ *     onChange: (locale) => i18n.changeLanguage(locale),
+ *   }}
+ * >
+ * ```
  */
 declare const OxyProvider: FC<OxyProviderProps>;
 export default OxyProvider;

package/lib/typescript/module/ui/components/OxyProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyProvider.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/OxyProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAqB,CAAC;AAsB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,QAAA,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CA+LrC,CAAC;AAEF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"OxyProvider.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/OxyProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAqB,CAAC;AAuB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,QAAA,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAiMrC,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/lib/typescript/module/ui/types/navigation.d.ts

@@ -152,5 +152,34 @@ export interface OxyProviderProps {
      * @default 'persistent'
      */
     deviceCredentialStorage?: 'persistent' | 'ephemeral';
+    /**
+     * Wires the app's OWN i18n library to Oxy's resolved language, so the
+     * account (or, signed out, the device/guest locale) drives the app's
+     * translated UI directly — no app-local effect or "sync" component to
+     * remember to mount. Oxy decides WHICH language; the app keeps owning its
+     * own translation catalogs and library (i18next, FormatJS, or anything
+     * else) and is told through `onChange` when to switch.
+     *
+     * Omitted entirely (the default) when an app has no i18n of its own, or
+     * manages it independently of the account/device locale.
+     */
+    language?: OxyLanguageConfig;
+}
+export interface OxyLanguageConfig {
+    /** The exact locales this app ships a translation catalog for. */
+    supportedLocales: readonly string[];
+    /**
+     * Used when Oxy's resolved language matches none of `supportedLocales`,
+     * not even by base language (Oxy's account-locale catalog is broader
+     * than any one app's translations).
+     */
+    fallbackLocale: string;
+    /**
+     * Called whenever the resolved locale changes, coerced to the closest
+     * one in `supportedLocales`. May return a promise; a rejection is
+     * reported to `onError` instead of throwing into the app tree.
+     */
+    onChange: (locale: string) => void | Promise<void>;
+    onError?: (error: unknown, locale: string) => void;
 }
 //# sourceMappingURL=navigation.d.ts.map

package/lib/typescript/module/ui/types/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/ui/types/navigation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../../src/ui/types/navigation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/services",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -154,7 +154,8 @@
     }
   },
   "dependencies": {
-    "@oxy.so/contracts": "1.0.1",
+    "@expo/config-plugins": "57.0.9",
+    "@oxy.so/contracts": "1.1.1",
     "@simplewebauthn/browser": "^13.3.0",
     "color": "^4.2.3"
   },
@@ -163,7 +164,7 @@
     "@commitlint/cli": "^21.2.1",
     "@commitlint/config-conventional": "^21.2.0",
     "@expo/vector-icons": "^15.0.3",
-    "@oxy.so/core": "1.0.1",
+    "@oxy.so/core": "1.2.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^12.0.1",
     "@react-native/babel-preset": "^0.86.2",
@@ -178,7 +179,7 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^20.19.43",
     "@types/react": "*",
-    "@oxy.so/bloom": "^1.0.0",
+    "@oxy.so/bloom": "^1.0.7",
     "copyfiles": "^2.4.1",
     "expo-constants": "~57.0.5",
     "expo-file-system": "~57.0.1",

package/src/index.ts

@@ -296,6 +296,7 @@ export type {
   OxyConsentScreenProps,
   OxyConsentApplication,
   OxyConsentUser,
+  OxyConsentResource,
 } from './ui/components/OxyConsentScreen';
 
 // Optional signed-out gate primitive. Wrap any subtree (or the whole app via

package/src/ui/components/LanguageBridge.tsx

@@ -0,0 +1,44 @@
+import { useEffect, useMemo, useRef } from 'react';
+import { coerceToSupportedLocale } from '@oxy.so/core';
+import { useOxy } from '../context/OxyContext';
+import type { OxyLanguageConfig } from '../types/navigation';
+
+/**
+ * `OxyProvider`'s language config prop, realized. Oxy decides which
+ * language an account (or, signed out, the device/guest locale) should see;
+ * this is the ONE place that decision reaches the host app's own i18n library
+ * — so an app never re-derives or imperatively tracks a language of its own,
+ * and never mounts anything extra to get it. It owns only its translation
+ * catalogs.
+ *
+ * `currentLanguage` may name a locale the host app never shipped a catalog
+ * for — {@link coerceToSupportedLocale} narrows it to the closest one the app
+ * actually has (exact match, then same base language, then `fallbackLocale`).
+ *
+ * Renders nothing. Mounted by `OxyProvider` INSIDE `OxyRuntimeProvider` only
+ * when this config is supplied, so an app with no i18n of its own pays
+ * nothing.
+ */
+export function LanguageBridge({ supportedLocales, fallbackLocale, onChange, onError }: OxyLanguageConfig): null {
+    const { currentLanguage } = useOxy();
+    const resolvedLocale = useMemo(
+        () => coerceToSupportedLocale(currentLanguage, supportedLocales, fallbackLocale),
+        [currentLanguage, supportedLocales, fallbackLocale],
+    );
+
+    // Refs, not effect dependencies: an inline `onChange`/`onError` (the common
+    // case) must not re-fire the effect on every render — only a genuine
+    // change in the RESOLVED locale should call it again.
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    const onErrorRef = useRef(onError);
+    onErrorRef.current = onError;
+
+    useEffect(() => {
+        Promise.resolve(onChangeRef.current(resolvedLocale)).catch((error: unknown) => {
+            onErrorRef.current?.(error, resolvedLocale);
+        });
+    }, [resolvedLocale]);
+
+    return null;
+}

package/src/ui/components/OxyConsentScreen.tsx

@@ -21,6 +21,7 @@
 import { useCallback } from 'react';
 import { Linking, Pressable, ScrollView, StyleSheet, View } from 'react-native';
 import { logger } from '@oxy.so/core';
+import type { McpOAuthWriteAction } from '@oxy.so/contracts';
 import { Avatar } from '@oxy.so/bloom/avatar';
 import { Button } from '@oxy.so/bloom/button';
 import { Text } from '@oxy.so/bloom/typography';
@@ -48,6 +49,8 @@ export interface OxyConsentApplication {
 
 /** The account that will authorize the request (the currently signed-in user). */
 export interface OxyConsentUser {
+  /** Exact effective account bound to the grant. */
+  accountId?: string;
   /** Real display name, when the profile has one. */
   displayName?: string;
   /** Normalized handle — the sanctioned fallback when `displayName` is absent. */
@@ -56,6 +59,18 @@ export interface OxyConsentUser {
   avatarUri?: string;
 }
 
+export interface OxyConsentResource {
+  /** Oxy application that owns the protected MCP resource. */
+  application: {
+    name: string;
+    iconUrl?: string;
+  };
+  /** Canonical protected-resource URI bound into the access token. */
+  uri: string;
+  /** Effectful tools enabled by the requested capabilities. */
+  writeActions: McpOAuthWriteAction[];
+}
+
 export interface OxyConsentScreenProps {
   /** The resolved requesting application. */
   application: OxyConsentApplication;
@@ -63,6 +78,8 @@ export interface OxyConsentScreenProps {
   scopes: string[];
   /** The account that will authorize the request, when known. */
   user?: OxyConsentUser;
+  /** Exact protected resource for an external MCP connection. */
+  resource?: OxyConsentResource;
   /** Approve handler — the caller mints the code / completes the flow. */
   onAllow: () => void | Promise<void>;
   /** Deny handler — the caller cancels the flow. */
@@ -192,6 +209,7 @@ export function OxyConsentScreen({
   application,
   scopes,
   user,
+  resource,
   onAllow,
   onDeny,
   busy = false,
@@ -259,6 +277,40 @@ export function OxyConsentScreen({
         ) : null}
       </View>
 
+      {resource ? (
+        <View style={styles.section}>
+          <Text style={[styles.sectionLabel, { color: theme.colors.textSecondary }]}>
+            {t('consent.resource.title')}
+          </Text>
+          <View
+            testID="consent-resource"
+            style={[styles.resourceCard, { borderColor: theme.colors.border, backgroundColor: theme.colors.card }]}
+          >
+            <Avatar
+              source={resource.application.iconUrl}
+              name={resource.application.name}
+              size={40}
+            />
+            <View style={styles.resourceText}>
+              <Text
+                testID="consent-resource-app"
+                numberOfLines={1}
+                style={[styles.accountName, { color: theme.colors.text }]}
+              >
+                {resource.application.name}
+              </Text>
+              <Text
+                testID="consent-resource-uri"
+                numberOfLines={2}
+                style={[styles.resourceUri, { color: theme.colors.textSecondary }]}
+              >
+                {resource.uri}
+              </Text>
+            </View>
+          </View>
+        </View>
+      ) : null}
+
       {/* Requested permissions */}
       <View style={styles.section}>
         <Text style={[styles.sectionLabel, { color: theme.colors.textSecondary }]}>
@@ -285,6 +337,29 @@ export function OxyConsentScreen({
         </View>
       </View>
 
+      {resource && resource.writeActions.length > 0 ? (
+        <View style={styles.section}>
+          <Text style={[styles.sectionLabel, { color: theme.colors.textSecondary }]}>
+            {t('consent.writeActions.title')}
+          </Text>
+          <View style={[styles.card, { borderColor: theme.colors.border, backgroundColor: theme.colors.card }]}>
+            {resource.writeActions.map((action) => (
+              <View key={`${action.name}:${action.version}`} testID={`consent-write-action-${action.name}`} style={styles.actionRow}>
+                <View style={styles.actionCopy}>
+                  <Text style={[styles.rowText, { color: theme.colors.text }]}>{action.description}</Text>
+                  <Text style={[styles.actionName, { color: theme.colors.textSecondary }]}>{action.name}</Text>
+                </View>
+                <View style={[styles.effectBadge, { borderColor: theme.colors.border }]}>
+                  <Text style={[styles.effectText, { color: theme.colors.textSecondary }]}>
+                    {t(`consent.effects.${action.effect}`)}
+                  </Text>
+                </View>
+              </View>
+            ))}
+          </View>
+        </View>
+      ) : null}
+
       {/* Authorizing account */}
       {user ? (
         <View
@@ -305,6 +380,15 @@ export function OxyConsentScreen({
                 {user.handle}
               </Text>
             ) : null}
+            {user.accountId ? (
+              <Text
+                testID="consent-account-id"
+                numberOfLines={1}
+                style={[styles.accountId, { color: theme.colors.textSecondary }]}
+              >
+                {t('consent.account.id', { id: user.accountId })}
+              </Text>
+            ) : null}
           </View>
         </View>
       ) : null}
@@ -466,6 +550,49 @@ const styles = StyleSheet.create({
   accountHandle: {
     fontSize: 13,
   },
+  accountId: {
+    fontSize: 11,
+  },
+  resourceCard: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 12,
+    borderWidth: StyleSheet.hairlineWidth,
+    borderRadius: 16,
+    padding: 12,
+  },
+  resourceText: {
+    flex: 1,
+    minWidth: 0,
+    gap: 2,
+  },
+  resourceUri: {
+    fontSize: 12,
+    lineHeight: 17,
+  },
+  actionRow: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 10,
+  },
+  actionCopy: {
+    flex: 1,
+    minWidth: 0,
+    gap: 2,
+  },
+  actionName: {
+    fontSize: 11,
+  },
+  effectBadge: {
+    borderWidth: StyleSheet.hairlineWidth,
+    borderRadius: 999,
+    paddingHorizontal: 8,
+    paddingVertical: 4,
+  },
+  effectText: {
+    fontSize: 10,
+    fontWeight: '600',
+  },
   linksRow: {
     flexDirection: 'row',
     flexWrap: 'wrap',

package/src/ui/components/OxyProvider.tsx

@@ -14,6 +14,7 @@ import { createMemoryStorage, createPlatformStorage, type StorageInterface } fro
 import { isNetConnectivityOnline } from '../utils/netConnectivity';
 import { KeyboardBoundary } from './KeyboardBoundary';
 import { ProductAnalyticsObserver } from '../analytics/productAnalytics';
+import { LanguageBridge } from './LanguageBridge';
 
 const bootStyles = StyleSheet.create({
     providerRoot: {
@@ -58,6 +59,20 @@ const isWeb = Platform.OS === 'web';
  *   return <Text>Welcome, {user?.username}!</Text>;
  * }
  * ```
+ *
+ * An app with its own translated UI passes a language config to follow the account's
+ * (or, signed out, the device/guest) resolved locale automatically — see ADR
+ * 0022 (`docs/adr/0022-app-i18n-follows-oxy-language.md`):
+ * ```tsx
+ * <OxyProvider
+ *   baseURL="https://api.oxy.so"
+ *   language={{
+ *     supportedLocales: SUPPORTED_LANGUAGES,       // this app's own catalog
+ *     fallbackLocale: DEFAULT_LANGUAGE,
+ *     onChange: (locale) => i18n.changeLanguage(locale),
+ *   }}
+ * >
+ * ```
  */
 const OxyProvider: FC<OxyProviderProps> = ({
     oxyServices,
@@ -76,6 +91,7 @@ const OxyProvider: FC<OxyProviderProps> = ({
     requireAuth = 'off',
     backgroundSession = false,
     deviceCredentialStorage = 'persistent',
+    language,
 }) => {
 
     // Storage + persistence wiring.
@@ -229,6 +245,7 @@ const OxyProvider: FC<OxyProviderProps> = ({
                 onAuthStateChange={onAuthStateChange as OxyRuntimeProviderProps['onAuthStateChange']}
             >
                 {productAnalytics ? <ProductAnalyticsObserver analytics={productAnalytics} /> : null}
+                {language ? <LanguageBridge {...language} /> : null}
                 <SurfaceProvider>
                     {requireAuth === 'off' ? (
                         children

package/src/ui/components/__tests__/LanguageBridge.test.tsx

@@ -0,0 +1,81 @@
+import React from 'react';
+import { render } from '@testing-library/react';
+import { LanguageBridge } from '../LanguageBridge';
+
+/**
+ * `OxyProvider`'s language config prop, realized: the one place Oxy's
+ * resolved language reaches a host app's own i18n library. `useOxy` is mocked here —
+ * it is the SDK's own well-tested context — so these tests exercise exactly
+ * what this component adds: coercion to the caller's catalog, and calling
+ * back only when the RESOLVED locale actually changes.
+ */
+
+let mockCurrentLanguage = 'en-US';
+jest.mock('../../context/OxyContext', () => ({
+  useOxy: () => ({ currentLanguage: mockCurrentLanguage }),
+}));
+
+const HOST_CATALOG = ['en-US', 'es-ES', 'fr-FR'] as const;
+
+beforeEach(() => {
+  mockCurrentLanguage = 'en-US';
+});
+
+it('resolves and reports the account language on mount', () => {
+  mockCurrentLanguage = 'es-ES';
+  const onChange = jest.fn();
+  render(<LanguageBridge supportedLocales={HOST_CATALOG} fallbackLocale="en-US" onChange={onChange} />);
+
+  expect(onChange).toHaveBeenCalledWith('es-ES');
+});
+
+it('coerces a locale the host never shipped a catalog for, by base language', () => {
+  mockCurrentLanguage = 'es-MX';
+  const onChange = jest.fn();
+  render(<LanguageBridge supportedLocales={HOST_CATALOG} fallbackLocale="en-US" onChange={onChange} />);
+
+  expect(onChange).toHaveBeenCalledWith('es-ES');
+});
+
+it('falls back to the caller default when nothing matches, even by base', () => {
+  mockCurrentLanguage = 'ja-JP';
+  const onChange = jest.fn();
+  render(<LanguageBridge supportedLocales={HOST_CATALOG} fallbackLocale="en-US" onChange={onChange} />);
+
+  expect(onChange).toHaveBeenCalledWith('en-US');
+});
+
+it('calls back again only when the RESOLVED locale changes', () => {
+  const onChange = jest.fn();
+  const { rerender } = render(
+    <LanguageBridge supportedLocales={HOST_CATALOG} fallbackLocale="en-US" onChange={onChange} />,
+  );
+  expect(onChange).toHaveBeenCalledTimes(1);
+
+  // Same resolved locale, brand-new callback identity (the common case for an
+  // inline arrow function) — must not re-fire.
+  rerender(<LanguageBridge supportedLocales={HOST_CATALOG} fallbackLocale="en-US" onChange={() => {}} />);
+  expect(onChange).toHaveBeenCalledTimes(1);
+
+  mockCurrentLanguage = 'fr-FR';
+  rerender(<LanguageBridge supportedLocales={HOST_CATALOG} fallbackLocale="en-US" onChange={onChange} />);
+  expect(onChange).toHaveBeenCalledTimes(2);
+  expect(onChange).toHaveBeenLastCalledWith('fr-FR');
+});
+
+it('reports a rejected onChange to onError instead of throwing', async () => {
+  const failure = new Error('catalog failed to load');
+  const onChange = jest.fn().mockRejectedValue(failure);
+  const onError = jest.fn();
+  render(
+    <LanguageBridge
+      supportedLocales={HOST_CATALOG}
+      fallbackLocale="en-US"
+      onChange={onChange}
+      onError={onError}
+    />,
+  );
+
+  await new Promise((resolve) => setTimeout(resolve, 0));
+  expect(onError).toHaveBeenCalledWith(failure, 'en-US');
+});

package/src/ui/components/__tests__/OxyConsentScreen.test.tsx

@@ -24,6 +24,7 @@ function renderScreen(props: Partial<OxyConsentScreenProps> = {}) {
       application={props.application ?? baseApp}
       scopes={props.scopes ?? ['openid', 'profile']}
       user={props.user}
+      resource={props.resource}
       onAllow={props.onAllow ?? onAllow}
       onDeny={props.onDeny ?? onDeny}
       busy={props.busy}
@@ -138,6 +139,37 @@ describe('OxyConsentScreen', () => {
     expect(getByTestId('consent-account-name').textContent).toBe('Alice A');
   });
 
+  it('renders the exact MCP app, protected resource, account id and catalog-derived write actions', () => {
+    const { getByTestId } = renderScreen({
+      scopes: ['email.read', 'email.send'],
+      user: {
+        accountId: 'account-mail-1',
+        displayName: 'Oxy Mail',
+        handle: 'oxy-mail-account',
+      },
+      resource: {
+        application: { name: 'Inbox', iconUrl: 'inbox-icon' },
+        uri: 'https://mcp.inbox.oxy.so',
+        writeActions: [{
+          name: 'sendEmail',
+          version: '1.0.0',
+          description: 'Send an email from the selected mailbox.',
+          requiredCapabilities: ['email.send'],
+          effect: 'external',
+        }],
+      },
+    });
+
+    expect(getByTestId('consent-resource-app').textContent).toBe('Inbox');
+    expect(getByTestId('consent-resource-uri').textContent).toBe('https://mcp.inbox.oxy.so');
+    expect(getByTestId('consent-account-id').textContent).toContain('account-mail-1');
+    expect(getByTestId('consent-scope-email.send').textContent).toContain('email.send');
+    expect(getByTestId('consent-write-action-sendEmail').textContent).toContain(
+      'Send an email from the selected mailbox.',
+    );
+    expect(getByTestId('consent-write-action-sendEmail').textContent).toContain('External');
+  });
+
   it('falls back to the handle when the account has no display name (D5)', () => {
     const { getByTestId } = renderScreen({ user: { handle: 'bob' } });
     expect(getByTestId('consent-account-name').textContent).toBe('bob');

package/src/ui/types/navigation.ts

@@ -172,4 +172,34 @@ export interface OxyProviderProps {
      * @default 'persistent'
      */
     deviceCredentialStorage?: 'persistent' | 'ephemeral';
+    /**
+     * Wires the app's OWN i18n library to Oxy's resolved language, so the
+     * account (or, signed out, the device/guest locale) drives the app's
+     * translated UI directly — no app-local effect or "sync" component to
+     * remember to mount. Oxy decides WHICH language; the app keeps owning its
+     * own translation catalogs and library (i18next, FormatJS, or anything
+     * else) and is told through `onChange` when to switch.
+     *
+     * Omitted entirely (the default) when an app has no i18n of its own, or
+     * manages it independently of the account/device locale.
+     */
+    language?: OxyLanguageConfig;
+}
+
+export interface OxyLanguageConfig {
+    /** The exact locales this app ships a translation catalog for. */
+    supportedLocales: readonly string[];
+    /**
+     * Used when Oxy's resolved language matches none of `supportedLocales`,
+     * not even by base language (Oxy's account-locale catalog is broader
+     * than any one app's translations).
+     */
+    fallbackLocale: string;
+    /**
+     * Called whenever the resolved locale changes, coerced to the closest
+     * one in `supportedLocales`. May return a promise; a rejection is
+     * reported to `onError` instead of throwing into the app tree.
+     */
+    onChange: (locale: string) => void | Promise<void>;
+    onError?: (error: unknown, locale: string) => void;
 }