@lowdefy/server-dev 5.2.0 → 5.4.0

package/lib/build/appMeta.js

@@ -0,0 +1,19 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+import { serializer } from '@lowdefy/helpers';
+import raw from '../../build/appMeta.json';
+
+export default serializer.deserialize(raw);

package/lib/build/i18n.js

@@ -0,0 +1,19 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+import { serializer } from '@lowdefy/helpers';
+import raw from '../../build/i18n.json';
+
+export default serializer.deserialize(raw);

package/lib/server/apiWrapper.js

@@ -20,7 +20,10 @@ import { getSecretsFromEnv } from '@lowdefy/node-utils';
 import { serializer } from '@lowdefy/helpers';
 import { v4 as uuid } from 'uuid';
 
+import agents from '../../build/plugins/agents.js';
+import appMeta from '../build/appMeta.js';
 import config from '../build/config.js';
+import i18nConfig from '../build/i18n.js';
 import connections from '../../build/plugins/connections.js';
 import createLogger from './log/createLogger.js';
 import fileCache from './fileCache.js';
@@ -65,12 +68,15 @@ function apiWrapper(handler) {
     const context = {
       // Important to give absolute path so Next can trace build files
       rid: uuid(),
+      agents,
+      appMeta,
       buildDirectory,
       configDirectory: process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd(),
       config,
       connections,
       fileCache,
       headers: req?.headers,
+      i18n: i18nConfig,
       jsMap,
       handleError: async (err) => {
         console.error(err);

package/lib/server/jitPageBuilder.js

@@ -22,6 +22,7 @@ import { buildPageJit, createContext, makeId } from '@lowdefy/build/dev';
 import compileCss from './compileCss.js';
 import createLogger from './log/createLogger.js';
 import PageCache from './pageCache.mjs';
+import readBuildApiArtifacts from './readBuildApiArtifacts.mjs';
 
 const jitLogger = createLogger({ name: 'jit-build' });
 
@@ -93,8 +94,11 @@ function getBuildContext(buildDirectory, configDirectory) {
   const connectionIds = readJsonFile(path.join(buildDirectory, 'connectionIds.json')) ?? [];
 
   const customTypesMap = readJsonFile(path.join(buildDirectory, 'customTypesMap.json')) ?? {};
+  const customMessagesMap =
+    readJsonFile(path.join(buildDirectory, 'customMessagesMap.json')) ?? {};
 
   cachedBuildContext = createContext({
+    customMessagesMap,
     customTypesMap,
     directories: {
       build: buildDirectory,
@@ -125,6 +129,11 @@ function getBuildContext(buildDirectory, configDirectory) {
     Object.assign(cachedBuildContext.modules, modules);
   }
 
+  // Restore api endpoint configs so JIT CallAPI validation (validateCallApiRefs in
+  // buildPageJit) can resolve endpointIds. Without this the dev context has no
+  // components.api and every CallAPI action is flagged as a non-existent endpoint.
+  cachedBuildContext.components = { api: readBuildApiArtifacts(buildDirectory) };
+
   // Use the frozen icon imports from the initial build for JIT detection.
   // This represents what's actually in the Next.js bundle — not what shallowBuild
   // discovers on subsequent rebuilds (those icons aren't bundled yet).

package/lib/server/readBuildApiArtifacts.mjs

@@ -0,0 +1,53 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import fs from 'fs';
+import path from 'path';
+import { serializer } from '@lowdefy/helpers';
+
+// Recursively collect every endpoint artifact under the api directory. Module
+// endpoints are written to build/api/<moduleId>/<endpointId>.json because their
+// scoped endpointId contains a "/" (buildModules prefixes ids with the module entry
+// id), so a flat read would miss them and flag every module CallAPI as non-existent.
+function readApiConfigs(directory) {
+  const configs = [];
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const entryPath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      configs.push(...readApiConfigs(entryPath));
+    } else if (entry.name.endsWith('.json')) {
+      configs.push(serializer.deserialize(JSON.parse(fs.readFileSync(entryPath, 'utf8'))));
+    }
+  }
+  return configs;
+}
+
+// Read the endpoint artifacts persisted by writeApi (build/api/<endpointId>.json).
+// The full build keeps endpoints in memory on components.api, but the dev context is
+// rebuilt from disk, so getBuildContext hydrates them here. validateCallApiRefs needs
+// each config's endpointId and type, both of which are present in the artifact.
+function readBuildApiArtifacts(buildDirectory) {
+  const apiDirectory = path.join(buildDirectory, 'api');
+  try {
+    return readApiConfigs(apiDirectory);
+  } catch (error) {
+    // writeApi only creates the directory when endpoints are defined — absent means none.
+    if (error.code === 'ENOENT') return [];
+    throw error;
+  }
+}
+
+export default readBuildApiArtifacts;

package/lib/server/readBuildApiArtifacts.test.mjs

@@ -0,0 +1,106 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { serializer } from '@lowdefy/helpers';
+
+import readBuildApiArtifacts from './readBuildApiArtifacts.mjs';
+
+function makeBuildDir() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), 'ldf-read-api-'));
+}
+
+// Mirror writeApi: each endpoint is serialized to build/api/<endpointId>.json.
+// Scoped module endpointIds contain a "/", so the file lands in a nested directory.
+function writeEndpoint(buildDir, endpoint) {
+  const filePath = path.join(buildDir, 'api', `${endpoint.endpointId}.json`);
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, serializer.serializeToString(endpoint));
+}
+
+test('readBuildApiArtifacts returns [] when the api directory does not exist', () => {
+  const buildDir = makeBuildDir();
+  try {
+    expect(readBuildApiArtifacts(buildDir)).toEqual([]);
+  } finally {
+    fs.rmSync(buildDir, { recursive: true, force: true });
+  }
+});
+
+test('readBuildApiArtifacts returns [] when the api directory is empty', () => {
+  const buildDir = makeBuildDir();
+  fs.mkdirSync(path.join(buildDir, 'api'));
+  try {
+    expect(readBuildApiArtifacts(buildDir)).toEqual([]);
+  } finally {
+    fs.rmSync(buildDir, { recursive: true, force: true });
+  }
+});
+
+test('readBuildApiArtifacts reads and deserializes endpoint artifacts with endpointId and type', () => {
+  const buildDir = makeBuildDir();
+  writeEndpoint(buildDir, { id: 'endpoint:my_api', endpointId: 'my_api', type: 'Api' });
+  writeEndpoint(buildDir, {
+    id: 'endpoint:internal_api',
+    endpointId: 'internal_api',
+    type: 'InternalApi',
+  });
+  try {
+    const result = readBuildApiArtifacts(buildDir);
+    expect(result).toHaveLength(2);
+    expect(result).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ endpointId: 'my_api', type: 'Api' }),
+        expect.objectContaining({ endpointId: 'internal_api', type: 'InternalApi' }),
+      ])
+    );
+  } finally {
+    fs.rmSync(buildDir, { recursive: true, force: true });
+  }
+});
+
+test('readBuildApiArtifacts reads scoped module endpoints from nested subdirectories', () => {
+  const buildDir = makeBuildDir();
+  // Top-level endpoint at build/api/top_api.json
+  writeEndpoint(buildDir, { id: 'endpoint:top_api', endpointId: 'top_api', type: 'Api' });
+  // Module endpoint at build/api/inviter/send-invite.json (scoped id contains "/")
+  writeEndpoint(buildDir, {
+    id: 'endpoint:inviter/send-invite',
+    endpointId: 'inviter/send-invite',
+    type: 'Api',
+  });
+  try {
+    const result = readBuildApiArtifacts(buildDir);
+    expect(result.map((c) => c.endpointId).sort()).toEqual(['inviter/send-invite', 'top_api']);
+  } finally {
+    fs.rmSync(buildDir, { recursive: true, force: true });
+  }
+});
+
+test('readBuildApiArtifacts ignores non-json files in the api directory', () => {
+  const buildDir = makeBuildDir();
+  writeEndpoint(buildDir, { id: 'endpoint:my_api', endpointId: 'my_api', type: 'Api' });
+  fs.writeFileSync(path.join(buildDir, 'api', 'notes.txt'), 'ignore me');
+  try {
+    const result = readBuildApiArtifacts(buildDir);
+    expect(result).toHaveLength(1);
+    expect(result[0]).toEqual(expect.objectContaining({ endpointId: 'my_api', type: 'Api' }));
+  } finally {
+    fs.rmSync(buildDir, { recursive: true, force: true });
+  }
+});

package/manager/processes/lowdefyBuild.mjs

@@ -15,6 +15,7 @@
 */
 
 import { shallowBuild } from '@lowdefy/build/dev';
+import createCustomPluginMessagesMap from '../utils/createCustomPluginMessagesMap.mjs';
 import createCustomPluginTypesMap from '../utils/createCustomPluginTypesMap.mjs';
 
 function formatDuration(ms) {
@@ -27,8 +28,10 @@ function lowdefyBuild({ directories, logger, options }) {
     logger.info({ spin: 'start' }, 'Building config...');
     const startTime = Date.now();
     const customTypesMap = await createCustomPluginTypesMap({ directories, logger });
+    const customMessagesMap = await createCustomPluginMessagesMap({ directories, logger });
 
     const result = await shallowBuild({
+      customMessagesMap,
       customTypesMap,
       directories,
       logger,

package/manager/utils/createCustomPluginMessagesMap.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { createRequire } from 'node:module';
+import path from 'path';
+import { get } from '@lowdefy/helpers';
+import { readFile } from '@lowdefy/node-utils';
+import YAML from 'yaml';
+
+const require = createRequire(import.meta.url);
+
+async function getPluginDefinitions({ directories }) {
+  let lowdefyYaml = await readFile(path.join(directories.config, 'lowdefy.yaml'));
+  if (!lowdefyYaml) {
+    lowdefyYaml = await readFile(path.join(directories.config, 'lowdefy.yml'));
+  }
+  if (!lowdefyYaml) {
+    return [];
+  }
+  const lowdefy = YAML.parse(lowdefyYaml);
+  return get(lowdefy, 'plugins', { default: [] });
+}
+
+async function createCustomPluginMessagesMap({ directories, logger }) {
+  const customMessagesMap = {};
+  const pluginDefinitions = await getPluginDefinitions({ directories });
+
+  for (const plugin of pluginDefinitions) {
+    let messagesModule;
+    try {
+      messagesModule = require(`${plugin.name}/messages`);
+    } catch (e) {
+      // Plugin does not ship a `./messages` export — silently skip.
+      logger?.debug?.(`Plugin "${plugin.name}" has no "./messages" export; skipping.`);
+      continue;
+    }
+    const messages = messagesModule.default ?? messagesModule;
+    if (!messages || typeof messages !== 'object') continue;
+    customMessagesMap[plugin.name] = messages;
+  }
+
+  return customMessagesMap;
+}
+
+export default createCustomPluginMessagesMap;

package/manager/utils/createCustomPluginTypesMap.mjs

@@ -39,6 +39,7 @@ async function getPluginDefinitions({ directories }) {
 async function createCustomPluginTypesMap({ directories, logger }) {
   const customTypesMap = {
     actions: {},
+    agents: {},
     auth: {
       adapters: {},
       callbacks: {},

package/next.config.js

@@ -1,16 +1,23 @@
 const lowdefyConfig = require('./build/config.json');
 const blockPackages = require('./build/blockPackages.json');
+const serverExternalPackages = require('./build/serverExternalPackages.json');
 
 // Transpile @lowdefy/client plus all block plugin packages that may
 // contain CSS imports (e.g., AG Grid themes, loaders, markdown).
 // Built dynamically so custom user plugins are included automatically.
-const transpilePackages = ['@lowdefy/client', ...blockPackages];
+const transpilePackages = [
+  '@lowdefy/client',
+  '@ant-design/x',
+  '@ant-design/x-markdown',
+  ...blockPackages,
+];
 
 const nextConfig = {
   basePath: lowdefyConfig.basePath,
   // reactStrictMode: true,
   turbopack: {},
   transpilePackages,
+  serverExternalPackages,
   compress: false,
   poweredByHeader: false,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server-dev",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -36,35 +36,37 @@
     ".npmrc"
   ],
   "dependencies": {
-    "@lowdefy/actions-core": "5.2.0",
-    "@lowdefy/api": "5.2.0",
-    "@lowdefy/block-utils": "5.2.0",
-    "@lowdefy/blocks-aggrid": "5.2.0",
-    "@lowdefy/blocks-antd": "5.2.0",
-    "@lowdefy/blocks-basic": "5.2.0",
-    "@lowdefy/blocks-echarts": "5.2.0",
-    "@lowdefy/blocks-loaders": "5.2.0",
-    "@lowdefy/blocks-markdown": "5.2.0",
-    "@lowdefy/blocks-tiptap": "5.2.0",
-    "@lowdefy/build": "5.2.0",
-    "@lowdefy/client": "5.2.0",
-    "@lowdefy/connection-axios-http": "5.2.0",
-    "@lowdefy/engine": "5.2.0",
-    "@lowdefy/errors": "5.2.0",
-    "@lowdefy/helpers": "5.2.0",
-    "@lowdefy/layout": "5.2.0",
-    "@lowdefy/logger": "5.2.0",
-    "@lowdefy/node-utils": "5.2.0",
-    "@lowdefy/operators-change-case": "5.2.0",
-    "@lowdefy/operators-dayjs": "5.2.0",
-    "@lowdefy/operators-diff": "5.2.0",
-    "@lowdefy/operators-js": "5.2.0",
-    "@lowdefy/operators-mql": "5.2.0",
-    "@lowdefy/operators-nunjucks": "5.2.0",
-    "@lowdefy/operators-uuid": "5.2.0",
-    "@lowdefy/operators-yaml": "5.2.0",
-    "@lowdefy/plugin-next-auth": "5.2.0",
+    "@lowdefy/actions-core": "5.4.0",
+    "@lowdefy/api": "5.4.0",
+    "@lowdefy/block-utils": "5.4.0",
+    "@lowdefy/blocks-aggrid": "5.4.0",
+    "@lowdefy/blocks-antd": "5.4.0",
+    "@lowdefy/blocks-antd-x": "5.4.0",
+    "@lowdefy/blocks-basic": "5.4.0",
+    "@lowdefy/blocks-echarts": "5.4.0",
+    "@lowdefy/blocks-loaders": "5.4.0",
+    "@lowdefy/blocks-markdown": "5.4.0",
+    "@lowdefy/blocks-tiptap": "5.4.0",
+    "@lowdefy/build": "5.4.0",
+    "@lowdefy/client": "5.4.0",
+    "@lowdefy/connection-axios-http": "5.4.0",
+    "@lowdefy/engine": "5.4.0",
+    "@lowdefy/errors": "5.4.0",
+    "@lowdefy/helpers": "5.4.0",
+    "@lowdefy/layout": "5.4.0",
+    "@lowdefy/logger": "5.4.0",
+    "@lowdefy/node-utils": "5.4.0",
+    "@lowdefy/operators-change-case": "5.4.0",
+    "@lowdefy/operators-dayjs": "5.4.0",
+    "@lowdefy/operators-diff": "5.4.0",
+    "@lowdefy/operators-js": "5.4.0",
+    "@lowdefy/operators-mql": "5.4.0",
+    "@lowdefy/operators-nunjucks": "5.4.0",
+    "@lowdefy/operators-uuid": "5.4.0",
+    "@lowdefy/operators-yaml": "5.4.0",
+    "@lowdefy/plugin-next-auth": "5.4.0",
     "@ant-design/cssinjs": "2.1.2",
+    "@ant-design/x": "2.7.0",
     "antd": "6.3.1",
     "dayjs": "1.11.19",
     "chokidar": "3.5.3",

package/package.original.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server-dev",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -44,35 +44,37 @@
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {
-    "@lowdefy/actions-core": "5.2.0",
-    "@lowdefy/api": "5.2.0",
-    "@lowdefy/block-utils": "5.2.0",
-    "@lowdefy/blocks-aggrid": "5.2.0",
-    "@lowdefy/blocks-antd": "5.2.0",
-    "@lowdefy/blocks-basic": "5.2.0",
-    "@lowdefy/blocks-echarts": "5.2.0",
-    "@lowdefy/blocks-loaders": "5.2.0",
-    "@lowdefy/blocks-markdown": "5.2.0",
-    "@lowdefy/blocks-tiptap": "5.2.0",
-    "@lowdefy/build": "5.2.0",
-    "@lowdefy/client": "5.2.0",
-    "@lowdefy/connection-axios-http": "5.2.0",
-    "@lowdefy/engine": "5.2.0",
-    "@lowdefy/errors": "5.2.0",
-    "@lowdefy/helpers": "5.2.0",
-    "@lowdefy/layout": "5.2.0",
-    "@lowdefy/logger": "5.2.0",
-    "@lowdefy/node-utils": "5.2.0",
-    "@lowdefy/operators-change-case": "5.2.0",
-    "@lowdefy/operators-dayjs": "5.2.0",
-    "@lowdefy/operators-diff": "5.2.0",
-    "@lowdefy/operators-js": "5.2.0",
-    "@lowdefy/operators-mql": "5.2.0",
-    "@lowdefy/operators-nunjucks": "5.2.0",
-    "@lowdefy/operators-uuid": "5.2.0",
-    "@lowdefy/operators-yaml": "5.2.0",
-    "@lowdefy/plugin-next-auth": "5.2.0",
+    "@lowdefy/actions-core": "5.4.0",
+    "@lowdefy/api": "5.4.0",
+    "@lowdefy/block-utils": "5.4.0",
+    "@lowdefy/blocks-aggrid": "5.4.0",
+    "@lowdefy/blocks-antd": "5.4.0",
+    "@lowdefy/blocks-antd-x": "5.4.0",
+    "@lowdefy/blocks-basic": "5.4.0",
+    "@lowdefy/blocks-echarts": "5.4.0",
+    "@lowdefy/blocks-loaders": "5.4.0",
+    "@lowdefy/blocks-markdown": "5.4.0",
+    "@lowdefy/blocks-tiptap": "5.4.0",
+    "@lowdefy/build": "5.4.0",
+    "@lowdefy/client": "5.4.0",
+    "@lowdefy/connection-axios-http": "5.4.0",
+    "@lowdefy/engine": "5.4.0",
+    "@lowdefy/errors": "5.4.0",
+    "@lowdefy/helpers": "5.4.0",
+    "@lowdefy/layout": "5.4.0",
+    "@lowdefy/logger": "5.4.0",
+    "@lowdefy/node-utils": "5.4.0",
+    "@lowdefy/operators-change-case": "5.4.0",
+    "@lowdefy/operators-dayjs": "5.4.0",
+    "@lowdefy/operators-diff": "5.4.0",
+    "@lowdefy/operators-js": "5.4.0",
+    "@lowdefy/operators-mql": "5.4.0",
+    "@lowdefy/operators-nunjucks": "5.4.0",
+    "@lowdefy/operators-uuid": "5.4.0",
+    "@lowdefy/operators-yaml": "5.4.0",
+    "@lowdefy/plugin-next-auth": "5.4.0",
     "@ant-design/cssinjs": "2.1.2",
+    "@ant-design/x": "2.7.0",
     "antd": "6.3.1",
     "dayjs": "1.11.19",
     "chokidar": "3.5.3",

package/pages/_app.js

@@ -25,10 +25,14 @@ import { useRouter } from 'next/router';
 import useSWR from 'swr';
 
 import { ErrorBoundary } from '@lowdefy/block-utils';
-import { useDarkMode } from '@lowdefy/client';
+import { useDarkMode, useLocale } from '@lowdefy/client';
 import { StyleProvider } from '@ant-design/cssinjs';
-import { App as AntdApp, ConfigProvider, theme as antdTheme } from 'antd';
+import { App as AntdApp, theme as antdTheme } from 'antd';
+import { XProvider } from '@ant-design/x';
 
+import antdLocaleLoaders from '../build/i18n/antdLocales.js';
+import antdXLocaleLoaders from '../build/i18n/antdXLocales.js';
+import dayjsLocaleMap from '../build/i18n/dayjsLocales.js';
 import Auth from '../lib/client/auth/Auth.js';
 import ErrorBar from '../lib/client/ErrorBar.js';
 import request from '../lib/client/utils/request.js';
@@ -62,6 +66,17 @@ function App({ Component }) {
     configDarkMode: lowdefyRef.current.theme?.darkMode,
   });
 
+  const { active: activeLocale, antdLocale, antdXLocale } = useLocale({
+    i18n: rootConfig?.i18n,
+    antdLocaleLoaders,
+    antdXLocaleLoaders,
+    dayjsLocaleMap,
+  });
+
+  if (rootConfig?.i18n?.defaultLocale) {
+    lowdefyRef.current.i18n = { ...rootConfig.i18n, active: activeLocale };
+  }
+
   const {
     lightToken: _lightToken,
     darkToken: _darkToken,
@@ -99,9 +114,21 @@ function App({ Component }) {
     }
   }, []);
 
+  // XProvider extends antd's ConfigProvider; merging antd + antd-X locale packs
+  // gives X components their built-in strings alongside antd's.
+  const mergedLocale = antdLocale || antdXLocale
+    ? { ...(antdLocale ?? {}), ...(antdXLocale ?? {}) }
+    : undefined;
+
   return (
     <StyleProvider layer>
-      <ConfigProvider
+      <XProvider
+        locale={mergedLocale}
+        form={
+          antdLocale?.Form?.defaultValidateMessages
+            ? { validateMessages: antdLocale.Form.defaultValidateMessages }
+            : undefined
+        }
         theme={{
           ...antdConfig,
           token,
@@ -134,7 +161,7 @@ function App({ Component }) {
             <ErrorBar errors={runtimeErrors} />
           </ThemeTokenResolver>
         </AntdApp>
-      </ConfigProvider>
+      </XProvider>
     </StyleProvider>
   );
 }

package/pages/api/agent/[...path].js

@@ -0,0 +1,86 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { callAgent } from '@lowdefy/api';
+import { translate, type } from '@lowdefy/helpers';
+
+import apiWrapper from '../../../lib/server/apiWrapper.js';
+
+async function handler({ context, req, res }) {
+  const t = (key, values) => translate({ key, values, i18n: context.i18n });
+  if (req.method !== 'POST') {
+    throw new Error(t('agent.runtime.methodNotAllowed'));
+  }
+  const segments = req.query.path;
+  if (!Array.isArray(segments) || segments.length < 2) {
+    res.status(400).json({ error: t('agent.runtime.invalidPath') });
+    return;
+  }
+  const agentId = segments[segments.length - 1];
+  const pageId = segments.slice(0, -1).join('/');
+  context.logger.info({ color: 'gray' }, `Agent: ${pageId} → ${agentId}`);
+  const { conversationId } = req.query;
+  const { messages, urlQuery, sharedState } = req.body;
+  if (!Array.isArray(messages)) {
+    res.status(400).json({ error: t('agent.runtime.messagesMustBeArray') });
+    return;
+  }
+  if (urlQuery != null && (typeof urlQuery !== 'object' || Array.isArray(urlQuery))) {
+    res.status(400).json({ error: t('agent.runtime.urlQueryMustBeObject') });
+    return;
+  }
+  if (sharedState != null && !type.isObject(sharedState)) {
+    res.status(400).json({ error: t('agent.runtime.sharedStateMustBeObject') });
+    return;
+  }
+  const { response: webResponse } = await callAgent(context, {
+    agentId,
+    pageId,
+    messages,
+    conversationId: conversationId ?? undefined,
+    sharedState: sharedState ?? undefined,
+    urlQuery: urlQuery ?? undefined,
+  });
+
+  // Stream the Web Response body to the Next.js response
+  res.setHeader('Content-Type', 'text/event-stream');
+  res.setHeader('Cache-Control', 'no-cache');
+  res.setHeader('Connection', 'keep-alive');
+  res.setHeader('Content-Encoding', 'none');
+  res.setHeader('Transfer-Encoding', 'chunked');
+
+  const reader = webResponse.body.getReader();
+  const decoder = new TextDecoder();
+  let done = false;
+  while (!done) {
+    const { value, done: readerDone } = await reader.read();
+    done = readerDone;
+    if (value) {
+      res.write(decoder.decode(value, { stream: true }));
+    }
+  }
+  res.end();
+}
+
+export const config = {
+  api: {
+    bodyParser: {
+      sizeLimit: '10mb',
+    },
+  },
+};
+
+export default apiWrapper(handler);