@agent-native/core 0.75.4 → 0.76.0

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,SAAS;AACT,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,oCAAoC,EACpC,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,uCAAuC,EACvC,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,UAAU,EACV,EAAE,EACF,cAAc,GAmBf,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,8DAA8D;AAC9D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEnE,2DAA2D;AAC3D,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EAGtB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,GAQ9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kCAAkC,EAClC,qCAAqC,EACrC,kCAAkC,EAClC,mCAAmC,GAEpC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAe1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,QAAQ,EACR,iCAAiC,GAElC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,GAKX,MAAM,sBAAsB,CAAC","sourcesContent":["// Browser-safe entry — only client & shared exports (no Node/Express/chokidar).\n\n// Client\nexport {\n  addContextToAgentChat,\n  appendAgentChatContextToMessage,\n  clearAgentChatContext,\n  formatAgentChatContextItemsForPrompt,\n  listAgentChatContext,\n  refreshAgentChatContext,\n  removeAgentChatContextItem,\n  sendToAgentChat,\n  setAgentChatContextItem,\n  setContextToAgentChat,\n  isEmbedMcpChatBridgeActive,\n  useAgentChatContext,\n  useAgentChatGenerating,\n  useDevMode,\n  useSendToAgentChat,\n  AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES,\n  getMcpAppHostContext,\n  openMcpAppHostLink,\n  requestMcpAppDisplayMode,\n  sendMcpAppHostMessage,\n  updateMcpAppModelContext,\n  useMcpAppHostContext,\n  CodeRequiredDialog,\n  useDbSync,\n  useFileWatcher,\n  useSession,\n  cn,\n  ApiKeySettings,\n  type AgentChatContextItem,\n  type AgentChatContextMessage,\n  type AgentChatContextMutationOptions,\n  type AgentChatContextRemoveOptions,\n  type AgentChatContextSetOptions,\n  type AgentChatContextState,\n  type AgentChatMessage,\n  type AgentNativeMcpAppHostMessageType,\n  type McpAppDisplayMode,\n  type McpAppHostChatMessage,\n  type McpAppHostCapabilities,\n  type McpAppHostContext,\n  type McpAppHostContextSnapshot,\n  type McpAppModelContextContentPart,\n  type McpAppModelContextUpdate,\n  type CodeRequiredDialogProps,\n  type AuthSession,\n  type UseAgentChatContextResult,\n} from \"./client/index.js\";\n\n// Shared (isomorphic)\nexport { agentChat } from \"./shared/index.js\";\n\n// Pure utilities (no Node.js deps — safe for browser and SSR)\nexport { parseArgs, camelCaseArgs } from \"./scripts/parse-args.js\";\n\n// defineAction — used by template actions, no Node.js deps\nexport {\n  defineAction,\n  AgentActionStopError,\n  isAgentActionStopError,\n  type ActionHttpConfig,\n  type AgentActionStopOptions,\n  MCP_APP_EXTENSION_ID,\n  MCP_APP_MIME_TYPE,\n  MCP_APP_RESOURCE_URI_META_KEY,\n  type ActionMcpAppConfig,\n  type ActionMcpAppCsp,\n  type ActionMcpAppCspBuilder,\n  type ActionMcpAppHtmlBuilder,\n  type ActionMcpAppPermissions,\n  type ActionMcpAppResourceConfig,\n  type ActionMcpAppResourceMeta,\n} from \"./action.js\";\nexport {\n  ACTION_CHAT_UI_DATA_CHART_RENDERER,\n  ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER,\n  ACTION_CHAT_UI_DATA_TABLE_RENDERER,\n  ACTION_CHAT_UI_DATA_WIDGET_RENDERER,\n  type ActionChatUIConfig,\n} from \"./action-ui.js\";\nexport {\n  DATA_CHART_WIDGET,\n  DATA_INSIGHTS_WIDGET,\n  DATA_TABLE_WIDGET,\n  createDataChartWidgetResult,\n  createDataInsightsWidgetResult,\n  createDataTableWidgetResult,\n  dataChartWidgetResultSchema,\n  dataChartWidgetSchema,\n  dataInsightsWidgetResultSchema,\n  dataTableWidgetResultSchema,\n  dataTableWidgetSchema,\n  dataWidgetResultSchema,\n  isDataChartWidget,\n  isDataTableWidget,\n  isDataWidgetResult,\n  normalizeDataWidgetKind,\n  normalizeDataWidgetResult,\n  type DataChartSeriesDefinition,\n  type DataChartWidget,\n  type DataChartWidgetResult,\n  type DataChartWidgetResultInput,\n  type DataInsightsWidgetResult,\n  type DataInsightsWidgetResultInput,\n  type DataTableColumn,\n  type DataTableWidget,\n  type DataTableWidgetResult,\n  type DataTableWidgetResultInput,\n  type DataWidgetDisplay,\n  type DataWidgetKind,\n  type DataWidgetResult,\n  type DataWidgetResultMetadata,\n} from \"./data-widgets/index.js\";\nexport {\n  embedApp,\n  MCP_APP_REQUEST_ORIGIN_CSP_SOURCE,\n  type EmbedAppOptions,\n} from \"./mcp/embed-app.js\";\nexport {\n  embedRoute,\n  type EmbedRouteContext,\n  type EmbedRouteOptions,\n  type EmbedRoutePathBuilder,\n  type EmbedRouteResult,\n} from \"./mcp/embed-route.js\";\n"]}
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,SAAS;AACT,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,oCAAoC,EACpC,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,uCAAuC,EACvC,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,SAAS,EACT,IAAI,EACJ,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,UAAU,EACV,EAAE,EACF,cAAc,GA2Bf,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,8DAA8D;AAC9D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEnE,2DAA2D;AAC3D,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EAGtB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,GAQ9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kCAAkC,EAClC,qCAAqC,EACrC,kCAAkC,EAClC,mCAAmC,GAEpC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,GAe1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,QAAQ,EACR,iCAAiC,GAElC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,GAKX,MAAM,sBAAsB,CAAC","sourcesContent":["// Browser-safe entry — only client & shared exports (no Node/Express/chokidar).\n\n// Client\nexport {\n  addContextToAgentChat,\n  appendAgentChatContextToMessage,\n  clearAgentChatContext,\n  formatAgentChatContextItemsForPrompt,\n  listAgentChatContext,\n  refreshAgentChatContext,\n  removeAgentChatContextItem,\n  sendToAgentChat,\n  setAgentChatContextItem,\n  setContextToAgentChat,\n  isEmbedMcpChatBridgeActive,\n  useAgentChatContext,\n  useAgentChatGenerating,\n  useDevMode,\n  useSendToAgentChat,\n  AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES,\n  getMcpAppHostContext,\n  openMcpAppHostLink,\n  requestMcpAppDisplayMode,\n  sendMcpAppHostMessage,\n  updateMcpAppModelContext,\n  useMcpAppHostContext,\n  CodeRequiredDialog,\n  AgentNativeI18nProvider,\n  LanguagePicker,\n  getLocaleInitScript,\n  localeDirection,\n  normalizeLocaleCode,\n  normalizeLocalePreference,\n  normalizeLocalizationPreference,\n  resolveLocaleFromCandidates,\n  resolveLocaleFromPreference,\n  useFormatters,\n  useLocale,\n  useT,\n  DEFAULT_LOCALE,\n  LOCALE_HYDRATION_GLOBAL,\n  LOCALE_METADATA,\n  LOCALE_STORAGE_KEY,\n  SUPPORTED_LOCALES,\n  useDbSync,\n  useFileWatcher,\n  useSession,\n  cn,\n  ApiKeySettings,\n  type AgentChatContextItem,\n  type AgentChatContextMessage,\n  type AgentChatContextMutationOptions,\n  type AgentChatContextRemoveOptions,\n  type AgentChatContextSetOptions,\n  type AgentChatContextState,\n  type AgentChatMessage,\n  type AgentNativeMcpAppHostMessageType,\n  type McpAppDisplayMode,\n  type McpAppHostChatMessage,\n  type McpAppHostCapabilities,\n  type McpAppHostContext,\n  type McpAppHostContextSnapshot,\n  type McpAppModelContextContentPart,\n  type McpAppModelContextUpdate,\n  type CodeRequiredDialogProps,\n  type AuthSession,\n  type UseAgentChatContextResult,\n  type AgentNativeI18nCatalog,\n  type AgentNativeI18nProviderProps,\n  type LocaleCode,\n  type LocaleHydrationPayload,\n  type LocaleMessages,\n  type LocaleMetadata,\n  type LocalePreference,\n  type LocalizationPreference,\n} from \"./client/index.js\";\n\n// Shared (isomorphic)\nexport { agentChat } from \"./shared/index.js\";\n\n// Pure utilities (no Node.js deps — safe for browser and SSR)\nexport { parseArgs, camelCaseArgs } from \"./scripts/parse-args.js\";\n\n// defineAction — used by template actions, no Node.js deps\nexport {\n  defineAction,\n  AgentActionStopError,\n  isAgentActionStopError,\n  type ActionHttpConfig,\n  type AgentActionStopOptions,\n  MCP_APP_EXTENSION_ID,\n  MCP_APP_MIME_TYPE,\n  MCP_APP_RESOURCE_URI_META_KEY,\n  type ActionMcpAppConfig,\n  type ActionMcpAppCsp,\n  type ActionMcpAppCspBuilder,\n  type ActionMcpAppHtmlBuilder,\n  type ActionMcpAppPermissions,\n  type ActionMcpAppResourceConfig,\n  type ActionMcpAppResourceMeta,\n} from \"./action.js\";\nexport {\n  ACTION_CHAT_UI_DATA_CHART_RENDERER,\n  ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER,\n  ACTION_CHAT_UI_DATA_TABLE_RENDERER,\n  ACTION_CHAT_UI_DATA_WIDGET_RENDERER,\n  type ActionChatUIConfig,\n} from \"./action-ui.js\";\nexport {\n  DATA_CHART_WIDGET,\n  DATA_INSIGHTS_WIDGET,\n  DATA_TABLE_WIDGET,\n  createDataChartWidgetResult,\n  createDataInsightsWidgetResult,\n  createDataTableWidgetResult,\n  dataChartWidgetResultSchema,\n  dataChartWidgetSchema,\n  dataInsightsWidgetResultSchema,\n  dataTableWidgetResultSchema,\n  dataTableWidgetSchema,\n  dataWidgetResultSchema,\n  isDataChartWidget,\n  isDataTableWidget,\n  isDataWidgetResult,\n  normalizeDataWidgetKind,\n  normalizeDataWidgetResult,\n  type DataChartSeriesDefinition,\n  type DataChartWidget,\n  type DataChartWidgetResult,\n  type DataChartWidgetResultInput,\n  type DataInsightsWidgetResult,\n  type DataInsightsWidgetResultInput,\n  type DataTableColumn,\n  type DataTableWidget,\n  type DataTableWidgetResult,\n  type DataTableWidgetResultInput,\n  type DataWidgetDisplay,\n  type DataWidgetKind,\n  type DataWidgetResult,\n  type DataWidgetResultMetadata,\n} from \"./data-widgets/index.js\";\nexport {\n  embedApp,\n  MCP_APP_REQUEST_ORIGIN_CSP_SOURCE,\n  type EmbedAppOptions,\n} from \"./mcp/embed-app.js\";\nexport {\n  embedRoute,\n  type EmbedRouteContext,\n  type EmbedRouteOptions,\n  type EmbedRoutePathBuilder,\n  type EmbedRouteResult,\n} from \"./mcp/embed-route.js\";\n"]}

package/dist/localization/actions/get-localization-preference.d.ts

@@ -0,0 +1,4 @@
+import { type LocalizationPreference } from "../shared.js";
+declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, LocalizationPreference>;
+export default _default;
+//# sourceMappingURL=get-localization-preference.d.ts.map

package/dist/localization/actions/get-localization-preference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-localization-preference.d.ts","sourceRoot":"","sources":["../../../src/localization/actions/get-localization-preference.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;;AAEtB,wBAaG"}

package/dist/localization/actions/get-localization-preference.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { defineAction } from "../../action.js";
+import { getUserSetting } from "../../settings/user-settings.js";
+import { LOCALIZATION_SETTING_KEY, normalizeLocalizationPreference, } from "../shared.js";
+export default defineAction({
+    description: "Get the current user's interface language preference. Returns { locale }, where locale is 'system' or a supported BCP-47 locale.",
+    schema: z.object({}),
+    http: { method: "GET" },
+    run: async (_args, ctx) => {
+        if (!ctx?.userEmail)
+            throw new Error("Not authenticated.");
+        const stored = await getUserSetting(ctx.userEmail, LOCALIZATION_SETTING_KEY);
+        return normalizeLocalizationPreference(stored);
+    },
+});
+//# sourceMappingURL=get-localization-preference.js.map

package/dist/localization/actions/get-localization-preference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-localization-preference.js","sourceRoot":"","sources":["../../../src/localization/actions/get-localization-preference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAEhC,MAAM,cAAc,CAAC;AAEtB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,kIAAkI;IACpI,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAmC,EAAE;QACzD,IAAI,CAAC,GAAG,EAAE,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,GAAG,CAAC,SAAS,EACb,wBAAwB,CACzB,CAAC;QACF,OAAO,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { defineAction } from \"../../action.js\";\nimport { getUserSetting } from \"../../settings/user-settings.js\";\nimport {\n  LOCALIZATION_SETTING_KEY,\n  normalizeLocalizationPreference,\n  type LocalizationPreference,\n} from \"../shared.js\";\n\nexport default defineAction({\n  description:\n    \"Get the current user's interface language preference. Returns { locale }, where locale is 'system' or a supported BCP-47 locale.\",\n  schema: z.object({}),\n  http: { method: \"GET\" },\n  run: async (_args, ctx): Promise<LocalizationPreference> => {\n    if (!ctx?.userEmail) throw new Error(\"Not authenticated.\");\n    const stored = await getUserSetting(\n      ctx.userEmail,\n      LOCALIZATION_SETTING_KEY,\n    );\n    return normalizeLocalizationPreference(stored);\n  },\n});\n"]}

package/dist/localization/actions/set-localization-preference.d.ts

@@ -0,0 +1,6 @@
+import { type LocalizationPreference } from "../shared.js";
+declare const _default: import("../../action.js").ActionDefinition<{
+    locale: string;
+}, LocalizationPreference>;
+export default _default;
+//# sourceMappingURL=set-localization-preference.d.ts.map

package/dist/localization/actions/set-localization-preference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-localization-preference.d.ts","sourceRoot":"","sources":["../../../src/localization/actions/set-localization-preference.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;;;;AAEtB,wBAoBG"}

package/dist/localization/actions/set-localization-preference.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { defineAction } from "../../action.js";
+import { putUserSetting } from "../../settings/user-settings.js";
+import { LOCALIZATION_SETTING_KEY, normalizeLocalePreference, } from "../shared.js";
+export default defineAction({
+    description: "Set the current user's interface language preference to 'system' or a supported BCP-47 locale.",
+    schema: z.object({
+        locale: z
+            .string()
+            .describe("Language preference: 'system' or a supported BCP-47 locale."),
+    }),
+    run: async (args, ctx) => {
+        if (!ctx?.userEmail)
+            throw new Error("Not authenticated.");
+        const locale = normalizeLocalePreference(args.locale);
+        if (!locale) {
+            throw new Error("Unsupported locale. Use system, en-US, zh-CN, es-ES, fr-FR, de-DE, ja-JP, ko-KR, pt-BR, hi-IN, or ar-SA.");
+        }
+        const value = { locale };
+        await putUserSetting(ctx.userEmail, LOCALIZATION_SETTING_KEY, value);
+        return value;
+    },
+});
+//# sourceMappingURL=set-localization-preference.js.map

package/dist/localization/actions/set-localization-preference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-localization-preference.js","sourceRoot":"","sources":["../../../src/localization/actions/set-localization-preference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAE1B,MAAM,cAAc,CAAC;AAEtB,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,gGAAgG;IAClG,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,CAAC,6DAA6D,CAAC;KAC3E,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAmC,EAAE;QACxD,IAAI,CAAC,GAAG,EAAE,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAqD,EAAE,MAAM,EAAE,CAAC;QAC3E,MAAM,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { defineAction } from \"../../action.js\";\nimport { putUserSetting } from \"../../settings/user-settings.js\";\nimport {\n  LOCALIZATION_SETTING_KEY,\n  normalizeLocalePreference,\n  type LocalizationPreference,\n} from \"../shared.js\";\n\nexport default defineAction({\n  description:\n    \"Set the current user's interface language preference to 'system' or a supported BCP-47 locale.\",\n  schema: z.object({\n    locale: z\n      .string()\n      .describe(\"Language preference: 'system' or a supported BCP-47 locale.\"),\n  }),\n  run: async (args, ctx): Promise<LocalizationPreference> => {\n    if (!ctx?.userEmail) throw new Error(\"Not authenticated.\");\n    const locale = normalizeLocalePreference(args.locale);\n    if (!locale) {\n      throw new Error(\n        \"Unsupported locale. Use system, en-US, zh-CN, es-ES, fr-FR, de-DE, ja-JP, ko-KR, pt-BR, hi-IN, or ar-SA.\",\n      );\n    }\n    const value: LocalizationPreference & Record<string, unknown> = { locale };\n    await putUserSetting(ctx.userEmail, LOCALIZATION_SETTING_KEY, value);\n    return value;\n  },\n});\n"]}

package/dist/localization/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./shared.js";
+export * from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/localization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/localization/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/localization/index.js

@@ -0,0 +1,3 @@
+export * from "./shared.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/localization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/localization/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./shared.js\";\nexport * from \"./server.js\";\n"]}

package/dist/localization/server.d.ts

@@ -0,0 +1,25 @@
+import { type LocaleCode, type LocalePreference, type LocalizationPreference } from "./shared.js";
+interface RequestLike {
+    headers?: Headers | Record<string, string | string[] | undefined> | null;
+}
+export interface ResolvedRequestLocale {
+    locale: LocaleCode;
+    preference: LocalizationPreference;
+    dir: "ltr" | "rtl";
+}
+export interface ResolveLocaleFromRequestOptions {
+    request?: Request | RequestLike | null;
+    acceptLanguage?: string | null;
+    preference?: LocalizationPreference | LocalePreference | null;
+    fallback?: LocaleCode;
+}
+export interface LocaleInitScriptOptions {
+    locale?: LocaleCode;
+    preference?: LocalizationPreference | LocalePreference;
+    messages?: Record<string, unknown> | null;
+}
+export declare function parseAcceptLanguage(header: string | null | undefined): string[];
+export declare function resolveLocaleFromRequest(options?: ResolveLocaleFromRequestOptions): ResolvedRequestLocale;
+export declare function getLocaleInitScript(options?: LocaleInitScriptOptions): string;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/localization/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/localization/server.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAErB,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;CAC1E;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,sBAAsB,CAAC;IACnC,GAAG,EAAE,KAAK,GAAG,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,UAAU,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAmBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,YAkBpE;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,qBAAqB,CAsBvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,UA4BxE"}

package/dist/localization/server.js

@@ -0,0 +1,69 @@
+import { DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, localeDirection, normalizeLocaleCode, normalizeLocalizationPreference, resolveLocaleFromPreference, } from "./shared.js";
+function readHeader(headers, key) {
+    if (!headers)
+        return null;
+    if (typeof headers.get === "function") {
+        return headers.get(key);
+    }
+    const lowerKey = key.toLowerCase();
+    for (const [name, value] of Object.entries(headers)) {
+        if (name.toLowerCase() !== lowerKey)
+            continue;
+        if (Array.isArray(value))
+            return value.join(",");
+        return value ?? null;
+    }
+    return null;
+}
+export function parseAcceptLanguage(header) {
+    if (!header)
+        return [];
+    return header
+        .split(",")
+        .map((part) => {
+        const [tag, ...params] = part.trim().split(";");
+        const q = params
+            .map((param) => param.trim())
+            .find((param) => param.startsWith("q="));
+        const weight = q ? Number.parseFloat(q.slice(2)) : 1;
+        return {
+            tag,
+            weight: Number.isFinite(weight) ? weight : 0,
+        };
+    })
+        .filter((entry) => entry.tag && entry.weight > 0)
+        .sort((a, b) => b.weight - a.weight)
+        .map((entry) => entry.tag);
+}
+export function resolveLocaleFromRequest(options = {}) {
+    const header = options.acceptLanguage ??
+        readHeader(options.request?.headers, "accept-language");
+    const candidates = parseAcceptLanguage(header);
+    const preference = normalizeLocalizationPreference(options.preference ?? { locale: "system" });
+    const locale = preference.locale === "system"
+        ? resolveLocaleFromPreference(preference, [
+            ...candidates,
+            options.fallback ?? DEFAULT_LOCALE,
+        ])
+        : (normalizeLocaleCode(preference.locale) ??
+            options.fallback ??
+            DEFAULT_LOCALE);
+    return {
+        locale,
+        preference,
+        dir: localeDirection(locale),
+    };
+}
+export function getLocaleInitScript(options = {}) {
+    const safeLocale = normalizeLocaleCode(options.locale) ?? DEFAULT_LOCALE;
+    const shouldStorePreference = options.preference !== undefined;
+    const safePreference = normalizeLocalizationPreference(options.preference ?? { locale: "system" });
+    const payload = {
+        locale: safeLocale,
+        preference: safePreference,
+        dir: localeDirection(safeLocale),
+        messages: options.messages ?? undefined,
+    };
+    return `(function(){try{var supported=${JSON.stringify(SUPPORTED_LOCALES)};var payload=${JSON.stringify(payload)};var shouldStorePreference=${JSON.stringify(shouldStorePreference)};function valid(x){return supported.indexOf(x)>=0}function canon(x){if(typeof x!=='string'||!x)return null;try{var c=Intl.getCanonicalLocales(x)[0];if(valid(c))return c;var lang=c&&c.split('-')[0].toLowerCase();for(var i=0;i<supported.length;i++){if(supported[i].split('-')[0].toLowerCase()===lang)return supported[i]}}catch(e){}return null}function storageGet(k){try{return window.localStorage.getItem(k)}catch(e){return null}}function storageSet(k,v){try{window.localStorage.setItem(k,v)}catch(e){}}var stored=storageGet(${JSON.stringify(LOCALE_STORAGE_KEY)});var pref=payload.preference&&payload.preference.locale;var locale=payload.locale;if(!valid(locale)){locale=null}if(!locale&&stored&&stored!=='system'){locale=canon(stored)}if(!locale&&pref&&pref!=='system'){locale=canon(pref)}if(!locale){var langs=navigator.languages&&navigator.languages.length?navigator.languages:[navigator.language];for(var j=0;j<langs.length&&!locale;j++){locale=canon(langs[j])}}if(!locale)locale=${JSON.stringify(DEFAULT_LOCALE)};var root=document.documentElement;root.setAttribute('lang',locale);root.setAttribute('dir',locale==='ar-SA'?'rtl':'ltr');root.setAttribute('data-locale',locale);payload.locale=locale;payload.dir=locale==='ar-SA'?'rtl':'ltr';window[${JSON.stringify(LOCALE_HYDRATION_GLOBAL)}]=payload;if(shouldStorePreference&&pref){storageSet(${JSON.stringify(LOCALE_STORAGE_KEY)},pref)}}catch(e){}})();`;
+}
+//# sourceMappingURL=server.js.map

package/dist/localization/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/localization/server.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DEFAULT_LOCALE,\n  LOCALE_HYDRATION_GLOBAL,\n  LOCALE_STORAGE_KEY,\n  SUPPORTED_LOCALES,\n  localeDirection,\n  normalizeLocaleCode,\n  normalizeLocalizationPreference,\n  resolveLocaleFromPreference,\n  type LocaleCode,\n  type LocalePreference,\n  type LocalizationPreference,\n} from \"./shared.js\";\n\ninterface RequestLike {\n  headers?: Headers | Record<string, string | string[] | undefined> | null;\n}\n\ntype HeaderMap = Headers | Record<string, string | string[] | undefined>;\n\nexport interface ResolvedRequestLocale {\n  locale: LocaleCode;\n  preference: LocalizationPreference;\n  dir: \"ltr\" | \"rtl\";\n}\n\nexport interface ResolveLocaleFromRequestOptions {\n  request?: Request | RequestLike | null;\n  acceptLanguage?: string | null;\n  preference?: LocalizationPreference | LocalePreference | null;\n  fallback?: LocaleCode;\n}\n\nexport interface LocaleInitScriptOptions {\n  locale?: LocaleCode;\n  preference?: LocalizationPreference | LocalePreference;\n  messages?: Record<string, unknown> | null;\n}\n\nfunction readHeader(\n  headers: HeaderMap | undefined | null,\n  key: string,\n): string | null {\n  if (!headers) return null;\n  if (typeof (headers as Headers).get === \"function\") {\n    return (headers as Headers).get(key);\n  }\n  const lowerKey = key.toLowerCase();\n  for (const [name, value] of Object.entries(headers)) {\n    if (name.toLowerCase() !== lowerKey) continue;\n    if (Array.isArray(value)) return value.join(\",\");\n    return value ?? null;\n  }\n  return null;\n}\n\nexport function parseAcceptLanguage(header: string | null | undefined) {\n  if (!header) return [];\n  return header\n    .split(\",\")\n    .map((part) => {\n      const [tag, ...params] = part.trim().split(\";\");\n      const q = params\n        .map((param) => param.trim())\n        .find((param) => param.startsWith(\"q=\"));\n      const weight = q ? Number.parseFloat(q.slice(2)) : 1;\n      return {\n        tag,\n        weight: Number.isFinite(weight) ? weight : 0,\n      };\n    })\n    .filter((entry) => entry.tag && entry.weight > 0)\n    .sort((a, b) => b.weight - a.weight)\n    .map((entry) => entry.tag);\n}\n\nexport function resolveLocaleFromRequest(\n  options: ResolveLocaleFromRequestOptions = {},\n): ResolvedRequestLocale {\n  const header =\n    options.acceptLanguage ??\n    readHeader(options.request?.headers, \"accept-language\");\n  const candidates = parseAcceptLanguage(header);\n  const preference = normalizeLocalizationPreference(\n    options.preference ?? { locale: \"system\" },\n  );\n  const locale =\n    preference.locale === \"system\"\n      ? resolveLocaleFromPreference(preference, [\n          ...candidates,\n          options.fallback ?? DEFAULT_LOCALE,\n        ])\n      : (normalizeLocaleCode(preference.locale) ??\n        options.fallback ??\n        DEFAULT_LOCALE);\n  return {\n    locale,\n    preference,\n    dir: localeDirection(locale),\n  };\n}\n\nexport function getLocaleInitScript(options: LocaleInitScriptOptions = {}) {\n  const safeLocale = normalizeLocaleCode(options.locale) ?? DEFAULT_LOCALE;\n  const shouldStorePreference = options.preference !== undefined;\n  const safePreference = normalizeLocalizationPreference(\n    options.preference ?? { locale: \"system\" },\n  );\n  const payload = {\n    locale: safeLocale,\n    preference: safePreference,\n    dir: localeDirection(safeLocale),\n    messages: options.messages ?? undefined,\n  };\n\n  return `(function(){try{var supported=${JSON.stringify(\n    SUPPORTED_LOCALES,\n  )};var payload=${JSON.stringify(\n    payload,\n  )};var shouldStorePreference=${JSON.stringify(\n    shouldStorePreference,\n  )};function valid(x){return supported.indexOf(x)>=0}function canon(x){if(typeof x!=='string'||!x)return null;try{var c=Intl.getCanonicalLocales(x)[0];if(valid(c))return c;var lang=c&&c.split('-')[0].toLowerCase();for(var i=0;i<supported.length;i++){if(supported[i].split('-')[0].toLowerCase()===lang)return supported[i]}}catch(e){}return null}function storageGet(k){try{return window.localStorage.getItem(k)}catch(e){return null}}function storageSet(k,v){try{window.localStorage.setItem(k,v)}catch(e){}}var stored=storageGet(${JSON.stringify(\n    LOCALE_STORAGE_KEY,\n  )});var pref=payload.preference&&payload.preference.locale;var locale=payload.locale;if(!valid(locale)){locale=null}if(!locale&&stored&&stored!=='system'){locale=canon(stored)}if(!locale&&pref&&pref!=='system'){locale=canon(pref)}if(!locale){var langs=navigator.languages&&navigator.languages.length?navigator.languages:[navigator.language];for(var j=0;j<langs.length&&!locale;j++){locale=canon(langs[j])}}if(!locale)locale=${JSON.stringify(\n    DEFAULT_LOCALE,\n  )};var root=document.documentElement;root.setAttribute('lang',locale);root.setAttribute('dir',locale==='ar-SA'?'rtl':'ltr');root.setAttribute('data-locale',locale);payload.locale=locale;payload.dir=locale==='ar-SA'?'rtl':'ltr';window[${JSON.stringify(\n    LOCALE_HYDRATION_GLOBAL,\n  )}]=payload;if(shouldStorePreference&&pref){storageSet(${JSON.stringify(\n    LOCALE_STORAGE_KEY,\n  )},pref)}}catch(e){}})();`;\n}\n"]}

package/dist/localization/shared.d.ts

@@ -0,0 +1,25 @@
+export declare const SUPPORTED_LOCALES: readonly ["en-US", "zh-CN", "es-ES", "fr-FR", "de-DE", "ja-JP", "ko-KR", "pt-BR", "hi-IN", "ar-SA"];
+export type LocaleCode = (typeof SUPPORTED_LOCALES)[number];
+export type LocalePreference = "system" | LocaleCode;
+export interface LocaleMetadata {
+    code: LocaleCode;
+    englishName: string;
+    nativeName: string;
+    dir: "ltr" | "rtl";
+}
+export interface LocalizationPreference {
+    locale: LocalePreference;
+}
+export declare const DEFAULT_LOCALE: LocaleCode;
+export declare const LOCALIZATION_SETTING_KEY = "localization";
+export declare const LOCALE_STORAGE_KEY = "agent-native:locale-preference";
+export declare const LOCALE_HYDRATION_GLOBAL = "__AGENT_NATIVE_LOCALE__";
+export declare const LOCALE_METADATA: Record<LocaleCode, LocaleMetadata>;
+export declare function isLocaleCode(value: unknown): value is LocaleCode;
+export declare function normalizeLocaleCode(value: unknown): LocaleCode | null;
+export declare function normalizeLocalePreference(value: unknown): LocalePreference | null;
+export declare function normalizeLocalizationPreference(value: unknown): LocalizationPreference;
+export declare function localeDirection(locale: LocaleCode): "ltr" | "rtl";
+export declare function resolveLocaleFromCandidates(candidates: Iterable<unknown>): LocaleCode;
+export declare function resolveLocaleFromPreference(preference: LocalizationPreference | LocalePreference | unknown, systemCandidates?: Iterable<unknown>): LocaleCode;
+//# sourceMappingURL=shared.d.ts.map

package/dist/localization/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/localization/shared.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,qGAWpB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,KAAK,GAAG,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,eAAO,MAAM,cAAc,EAAE,UAAoB,CAAC;AAClD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AACnE,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAEjE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,CA6D9D,CAAC;AAIF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAerE;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,IAAI,CAGzB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,sBAAsB,CASxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,CAEjE;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAC5B,UAAU,CAMZ;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,OAAO,EAC/D,gBAAgB,GAAE,QAAQ,CAAC,OAAO,CAAM,GACvC,UAAU,CAOZ"}

package/dist/localization/shared.js

@@ -0,0 +1,134 @@
+export const SUPPORTED_LOCALES = [
+    "en-US",
+    "zh-CN",
+    "es-ES",
+    "fr-FR",
+    "de-DE",
+    "ja-JP",
+    "ko-KR",
+    "pt-BR",
+    "hi-IN",
+    "ar-SA",
+];
+export const DEFAULT_LOCALE = "en-US";
+export const LOCALIZATION_SETTING_KEY = "localization";
+export const LOCALE_STORAGE_KEY = "agent-native:locale-preference";
+export const LOCALE_HYDRATION_GLOBAL = "__AGENT_NATIVE_LOCALE__";
+export const LOCALE_METADATA = {
+    "en-US": {
+        code: "en-US",
+        englishName: "English",
+        nativeName: "English",
+        dir: "ltr",
+    },
+    "zh-CN": {
+        code: "zh-CN",
+        englishName: "Chinese (Simplified)",
+        nativeName: "简体中文",
+        dir: "ltr",
+    },
+    "es-ES": {
+        code: "es-ES",
+        englishName: "Spanish",
+        nativeName: "Español",
+        dir: "ltr",
+    },
+    "fr-FR": {
+        code: "fr-FR",
+        englishName: "French",
+        nativeName: "Français",
+        dir: "ltr",
+    },
+    "de-DE": {
+        code: "de-DE",
+        englishName: "German",
+        nativeName: "Deutsch",
+        dir: "ltr",
+    },
+    "ja-JP": {
+        code: "ja-JP",
+        englishName: "Japanese",
+        nativeName: "日本語",
+        dir: "ltr",
+    },
+    "ko-KR": {
+        code: "ko-KR",
+        englishName: "Korean",
+        nativeName: "한국어",
+        dir: "ltr",
+    },
+    "pt-BR": {
+        code: "pt-BR",
+        englishName: "Portuguese (Brazil)",
+        nativeName: "Português (Brasil)",
+        dir: "ltr",
+    },
+    "hi-IN": {
+        code: "hi-IN",
+        englishName: "Hindi",
+        nativeName: "हिन्दी",
+        dir: "ltr",
+    },
+    "ar-SA": {
+        code: "ar-SA",
+        englishName: "Arabic",
+        nativeName: "العربية",
+        dir: "rtl",
+    },
+};
+const SUPPORTED_LOCALE_SET = new Set(SUPPORTED_LOCALES);
+export function isLocaleCode(value) {
+    return typeof value === "string" && SUPPORTED_LOCALE_SET.has(value);
+}
+export function normalizeLocaleCode(value) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        return null;
+    try {
+        for (const canonical of Intl.getCanonicalLocales(value.trim())) {
+            if (isLocaleCode(canonical))
+                return canonical;
+            const language = canonical.split("-")[0]?.toLowerCase();
+            const match = SUPPORTED_LOCALES.find((locale) => locale.split("-")[0]?.toLowerCase() === language);
+            if (match)
+                return match;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export function normalizeLocalePreference(value) {
+    if (value === "system")
+        return "system";
+    return normalizeLocaleCode(value);
+}
+export function normalizeLocalizationPreference(value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        const locale = normalizeLocalePreference(value.locale);
+        if (locale)
+            return { locale };
+    }
+    const locale = normalizeLocalePreference(value);
+    return { locale: locale ?? "system" };
+}
+export function localeDirection(locale) {
+    return LOCALE_METADATA[locale]?.dir ?? "ltr";
+}
+export function resolveLocaleFromCandidates(candidates) {
+    for (const candidate of candidates) {
+        const normalized = normalizeLocaleCode(candidate);
+        if (normalized)
+            return normalized;
+    }
+    return DEFAULT_LOCALE;
+}
+export function resolveLocaleFromPreference(preference, systemCandidates = []) {
+    const normalized = typeof preference === "string"
+        ? normalizeLocalePreference(preference)
+        : normalizeLocalizationPreference(preference).locale;
+    if (normalized && normalized !== "system")
+        return normalized;
+    return resolveLocaleFromCandidates(systemCandidates);
+}
+//# sourceMappingURL=shared.js.map

package/dist/localization/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/localization/shared.ts"],"names":[],"mappings":"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","sourcesContent":["export const SUPPORTED_LOCALES = [\n  \"en-US\",\n  \"zh-CN\",\n  \"es-ES\",\n  \"fr-FR\",\n  \"de-DE\",\n  \"ja-JP\",\n  \"ko-KR\",\n  \"pt-BR\",\n  \"hi-IN\",\n  \"ar-SA\",\n] as const;\n\nexport type LocaleCode = (typeof SUPPORTED_LOCALES)[number];\nexport type LocalePreference = \"system\" | LocaleCode;\n\nexport interface LocaleMetadata {\n  code: LocaleCode;\n  englishName: string;\n  nativeName: string;\n  dir: \"ltr\" | \"rtl\";\n}\n\nexport interface LocalizationPreference {\n  locale: LocalePreference;\n}\n\nexport const DEFAULT_LOCALE: LocaleCode = \"en-US\";\nexport const LOCALIZATION_SETTING_KEY = \"localization\";\nexport const LOCALE_STORAGE_KEY = \"agent-native:locale-preference\";\nexport const LOCALE_HYDRATION_GLOBAL = \"__AGENT_NATIVE_LOCALE__\";\n\nexport const LOCALE_METADATA: Record<LocaleCode, LocaleMetadata> = {\n  \"en-US\": {\n    code: \"en-US\",\n    englishName: \"English\",\n    nativeName: \"English\",\n    dir: \"ltr\",\n  },\n  \"zh-CN\": {\n    code: \"zh-CN\",\n    englishName: \"Chinese (Simplified)\",\n    nativeName: \"简体中文\",\n    dir: \"ltr\",\n  },\n  \"es-ES\": {\n    code: \"es-ES\",\n    englishName: \"Spanish\",\n    nativeName: \"Español\",\n    dir: \"ltr\",\n  },\n  \"fr-FR\": {\n    code: \"fr-FR\",\n    englishName: \"French\",\n    nativeName: \"Français\",\n    dir: \"ltr\",\n  },\n  \"de-DE\": {\n    code: \"de-DE\",\n    englishName: \"German\",\n    nativeName: \"Deutsch\",\n    dir: \"ltr\",\n  },\n  \"ja-JP\": {\n    code: \"ja-JP\",\n    englishName: \"Japanese\",\n    nativeName: \"日本語\",\n    dir: \"ltr\",\n  },\n  \"ko-KR\": {\n    code: \"ko-KR\",\n    englishName: \"Korean\",\n    nativeName: \"한국어\",\n    dir: \"ltr\",\n  },\n  \"pt-BR\": {\n    code: \"pt-BR\",\n    englishName: \"Portuguese (Brazil)\",\n    nativeName: \"Português (Brasil)\",\n    dir: \"ltr\",\n  },\n  \"hi-IN\": {\n    code: \"hi-IN\",\n    englishName: \"Hindi\",\n    nativeName: \"हिन्दी\",\n    dir: \"ltr\",\n  },\n  \"ar-SA\": {\n    code: \"ar-SA\",\n    englishName: \"Arabic\",\n    nativeName: \"العربية\",\n    dir: \"rtl\",\n  },\n};\n\nconst SUPPORTED_LOCALE_SET = new Set<string>(SUPPORTED_LOCALES);\n\nexport function isLocaleCode(value: unknown): value is LocaleCode {\n  return typeof value === \"string\" && SUPPORTED_LOCALE_SET.has(value);\n}\n\nexport function normalizeLocaleCode(value: unknown): LocaleCode | null {\n  if (typeof value !== \"string\" || value.trim().length === 0) return null;\n  try {\n    for (const canonical of Intl.getCanonicalLocales(value.trim())) {\n      if (isLocaleCode(canonical)) return canonical;\n      const language = canonical.split(\"-\")[0]?.toLowerCase();\n      const match = SUPPORTED_LOCALES.find(\n        (locale) => locale.split(\"-\")[0]?.toLowerCase() === language,\n      );\n      if (match) return match;\n    }\n  } catch {\n    return null;\n  }\n  return null;\n}\n\nexport function normalizeLocalePreference(\n  value: unknown,\n): LocalePreference | null {\n  if (value === \"system\") return \"system\";\n  return normalizeLocaleCode(value);\n}\n\nexport function normalizeLocalizationPreference(\n  value: unknown,\n): LocalizationPreference {\n  if (value && typeof value === \"object\" && !Array.isArray(value)) {\n    const locale = normalizeLocalePreference(\n      (value as { locale?: unknown }).locale,\n    );\n    if (locale) return { locale };\n  }\n  const locale = normalizeLocalePreference(value);\n  return { locale: locale ?? \"system\" };\n}\n\nexport function localeDirection(locale: LocaleCode): \"ltr\" | \"rtl\" {\n  return LOCALE_METADATA[locale]?.dir ?? \"ltr\";\n}\n\nexport function resolveLocaleFromCandidates(\n  candidates: Iterable<unknown>,\n): LocaleCode {\n  for (const candidate of candidates) {\n    const normalized = normalizeLocaleCode(candidate);\n    if (normalized) return normalized;\n  }\n  return DEFAULT_LOCALE;\n}\n\nexport function resolveLocaleFromPreference(\n  preference: LocalizationPreference | LocalePreference | unknown,\n  systemCandidates: Iterable<unknown> = [],\n): LocaleCode {\n  const normalized =\n    typeof preference === \"string\"\n      ? normalizeLocalePreference(preference)\n      : normalizeLocalizationPreference(preference).locale;\n  if (normalized && normalized !== \"system\") return normalized;\n  return resolveLocaleFromCandidates(systemCandidates);\n}\n"]}

package/dist/server/action-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-discovery.d.ts","sourceRoot":"","sources":["../../src/server/action-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA4ChE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACnC,IAAI,CAKN;AAqRD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAqC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAgGtC;AAED,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CAmFf;AAED,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,4BAAsB,CAAC"}
+{"version":3,"file":"action-discovery.d.ts","sourceRoot":"","sources":["../../src/server/action-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AA4ChE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACnC,IAAI,CAKN;AAqRD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAqC7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAgGtC;AAED,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CA2Ff;AAED,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,4BAAsB,CAAC"}

package/dist/server/action-discovery.js

@@ -500,6 +500,14 @@ export async function mergeCoreSharingActions(registry) {
             "context-report",
             () => import("../agent/context-xray/actions/context-report.js"),
         ],
+        [
+            "get-localization-preference",
+            () => import("../localization/actions/get-localization-preference.js"),
+        ],
+        [
+            "set-localization-preference",
+            () => import("../localization/actions/set-localization-preference.js"),
+        ],
         [
             "change-appearance",
             () => import("../appearance/actions/change-appearance.js"),