@lowdefy/server 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';
@@ -40,11 +43,14 @@ function apiWrapper(handler) {
     const context = {
       // Important to give absolute path so Next can trace build files
       rid: uuid(),
+      agents,
+      appMeta,
       buildDirectory: path.join(process.cwd(), 'build'),
       config,
       connections,
       fileCache,
       headers: req?.headers,
+      i18n: i18nConfig,
       jsMap,
       handleError: async (err) => {
         console.error(err);

package/lib/server/auth/getAuthOptions.js

@@ -23,8 +23,9 @@ import callbacks from '../../../build/plugins/auth/callbacks.js';
 import events from '../../../build/plugins/auth/events.js';
 import providers from '../../../build/plugins/auth/providers.js';
 
-function getAuthOptions({ logger }) {
+function getAuthOptions({ appMeta, logger }) {
   return getNextAuthConfig({
+    appMeta,
     authJson,
     logger,
     plugins: { adapters, callbacks, events, providers },

package/lib/server/serverSidePropsWrapper.js

@@ -18,6 +18,7 @@ import path from 'path';
 import { createApiContext } from '@lowdefy/api';
 import { v4 as uuid } from 'uuid';
 
+import appMeta from '../build/appMeta.js';
 import config from '../build/config.js';
 import createLogger from './log/createLogger.js';
 import fileCache from './fileCache.js';
@@ -32,6 +33,7 @@ function serverSidePropsWrapper(handler) {
     const context = {
       // Important to give absolute path so Next can trace build files
       rid: uuid(),
+      appMeta,
       buildDirectory: path.join(process.cwd(), 'build'),
       config,
       fileCache,

package/lowdefy/build.mjs

@@ -22,6 +22,7 @@ import { hideBin } from 'yargs/helpers';
 import build from '@lowdefy/build';
 import { BuildError } from '@lowdefy/errors';
 import { createNodeLogger } from '@lowdefy/logger/node';
+import createCustomPluginMessagesMap from './createCustomPluginMessagesMap.mjs';
 import createCustomPluginTypesMap from './createCustomPluginTypesMap.mjs';
 
 const argv = yargs(hideBin(process.argv)).argv;
@@ -39,6 +40,7 @@ async function run() {
   };
 
   const customTypesMap = await createCustomPluginTypesMap({ directories });
+  const customMessagesMap = await createCustomPluginMessagesMap({ directories });
 
   let logger;
   logger = createNodeLogger({
@@ -48,6 +50,7 @@ async function run() {
   });
 
   await build({
+    customMessagesMap,
     customTypesMap,
     directories,
     logger,

package/lowdefy/createCustomPluginMessagesMap.mjs

@@ -0,0 +1,57 @@
+#!/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 }) {
+  const customMessagesMap = {};
+  const pluginDefinitions = await getPluginDefinitions({ directories });
+
+  for (const plugin of pluginDefinitions) {
+    let messagesModule;
+    try {
+      messagesModule = require(`${plugin.name}/messages`);
+    } catch (e) {
+      continue;
+    }
+    const messages = messagesModule.default ?? messagesModule;
+    if (!messages || typeof messages !== 'object') continue;
+    customMessagesMap[plugin.name] = messages;
+  }
+
+  return customMessagesMap;
+}
+
+export default createCustomPluginMessagesMap;

package/lowdefy/createCustomPluginTypesMap.mjs

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

package/next.config.js

@@ -1,15 +1,26 @@
 const { withSentryConfig } = require('@sentry/nextjs');
 const lowdefyConfig = require('./build/config.json');
 const blockPackages = require('./build/blockPackages.json');
+const agentFileSystems = require('./build/agentFileSystems.json');
+const serverExternalPackages = require('./build/serverExternalPackages.json');
 
 const nextConfig = {
   basePath: lowdefyConfig.basePath,
   reactStrictMode: true,
-  transpilePackages: ['@lowdefy/client', ...blockPackages],
+  transpilePackages: [
+    '@lowdefy/client',
+    '@ant-design/x',
+    '@ant-design/x-markdown',
+    ...blockPackages,
+  ],
+  serverExternalPackages,
   turbopack: {},
   poweredByHeader: false,
   // productionBrowserSourceMaps: true
   output: process.env.LOWDEFY_BUILD_OUTPUT_STANDALONE === '1' ? 'standalone' : undefined,
+  outputFileTracingIncludes: agentFileSystems.length
+    ? { '/api/agent/*': agentFileSystems.map((p) => `${p}/**/*`) }
+    : undefined,
 };
 
 // Only wrap with Sentry if SENTRY_DSN is configured

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -38,21 +38,23 @@
   ],
   "dependencies": {
     "@ant-design/cssinjs": "2.1.2",
-    "@lowdefy/actions-core": "5.2.0",
-    "@lowdefy/api": "5.2.0",
-    "@lowdefy/block-utils": "5.2.0",
-    "@lowdefy/blocks-antd": "5.2.0",
-    "@lowdefy/blocks-basic": "5.2.0",
-    "@lowdefy/blocks-loaders": "5.2.0",
-    "@lowdefy/blocks-tiptap": "5.2.0",
-    "@lowdefy/client": "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-js": "5.2.0",
-    "@lowdefy/plugin-next-auth": "5.2.0",
+    "@ant-design/x": "2.7.0",
+    "@lowdefy/actions-core": "5.4.0",
+    "@lowdefy/api": "5.4.0",
+    "@lowdefy/block-utils": "5.4.0",
+    "@lowdefy/blocks-antd": "5.4.0",
+    "@lowdefy/blocks-antd-x": "5.4.0",
+    "@lowdefy/blocks-basic": "5.4.0",
+    "@lowdefy/blocks-loaders": "5.4.0",
+    "@lowdefy/blocks-tiptap": "5.4.0",
+    "@lowdefy/client": "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-js": "5.4.0",
+    "@lowdefy/plugin-next-auth": "5.4.0",
     "@sentry/nextjs": "8.53.0",
     "@tailwindcss/postcss": "4.2.1",
     "antd": "6.3.1",
@@ -67,7 +69,7 @@
     "uuid": "13.0.0"
   },
   "devDependencies": {
-    "@lowdefy/build": "5.2.0",
+    "@lowdefy/build": "5.4.0",
     "@next/eslint-plugin-next": "16.1.6",
     "@tailwindcss/postcss": "4.2.1",
     "tailwindcss": "4.2.1",

package/package.original.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -48,21 +48,23 @@
   },
   "dependencies": {
     "@ant-design/cssinjs": "2.1.2",
-    "@lowdefy/actions-core": "5.2.0",
-    "@lowdefy/api": "5.2.0",
-    "@lowdefy/block-utils": "5.2.0",
-    "@lowdefy/blocks-antd": "5.2.0",
-    "@lowdefy/blocks-basic": "5.2.0",
-    "@lowdefy/blocks-loaders": "5.2.0",
-    "@lowdefy/blocks-tiptap": "5.2.0",
-    "@lowdefy/client": "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-js": "5.2.0",
-    "@lowdefy/plugin-next-auth": "5.2.0",
+    "@ant-design/x": "2.7.0",
+    "@lowdefy/actions-core": "5.4.0",
+    "@lowdefy/api": "5.4.0",
+    "@lowdefy/block-utils": "5.4.0",
+    "@lowdefy/blocks-antd": "5.4.0",
+    "@lowdefy/blocks-antd-x": "5.4.0",
+    "@lowdefy/blocks-basic": "5.4.0",
+    "@lowdefy/blocks-loaders": "5.4.0",
+    "@lowdefy/blocks-tiptap": "5.4.0",
+    "@lowdefy/client": "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-js": "5.4.0",
+    "@lowdefy/plugin-next-auth": "5.4.0",
     "@sentry/nextjs": "8.53.0",
     "@tailwindcss/postcss": "4.2.1",
     "antd": "6.3.1",
@@ -77,7 +79,7 @@
     "uuid": "13.0.0"
   },
   "devDependencies": {
-    "@lowdefy/build": "5.2.0",
+    "@lowdefy/build": "5.4.0",
     "@next/eslint-plugin-next": "16.1.6",
     "@tailwindcss/postcss": "4.2.1",
     "tailwindcss": "4.2.1",
@@ -88,11 +90,6 @@
   "engines": {
     "node": ">=18"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "better-sqlite3"
-    ]
-  },
   "publishConfig": {
     "access": "public"
   }

package/pages/404.js

@@ -17,6 +17,7 @@
 import path from 'path';
 import { createApiContext, getPageConfig, getRootConfig } from '@lowdefy/api';
 
+import appMeta from '../lib/build/appMeta.js';
 import config from '../lib/build/config.js';
 import fileCache from '../lib/server/fileCache.js';
 import Page from '../lib/client/Page.js';
@@ -24,6 +25,7 @@ import Page from '../lib/client/Page.js';
 export async function getStaticProps() {
   // Important to give absolute path so Next can trace build files
   const context = {
+    appMeta,
     buildDirectory: path.join(process.cwd(), 'build'),
     config,
     fileCache,

package/pages/_app.js

@@ -23,10 +23,14 @@ import React, { useCallback, useRef } from 'react';
 import dynamic from 'next/dynamic';
 
 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 createLogUsage from '../lib/client/createLogUsage.js';
 import initSentryClient from '../lib/client/sentry/initSentryClient.js';
@@ -63,6 +67,17 @@ function App({ Component, pageProps: { session, rootConfig, pageConfig } }) {
     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,
@@ -79,9 +94,23 @@ function App({ Component, pageProps: { session, rootConfig, pageConfig } }) {
     }
   }, []);
 
+  // XProvider extends antd's ConfigProvider; merging antd + antd-X locale packs
+  // gives X components (Bubble, Sender, Conversations, ...) their built-in strings
+  // alongside antd's. antd X ships only en_US + zh_CN; other locales fall back
+  // to en_US for X-native strings.
+  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,
@@ -115,7 +144,7 @@ function App({ Component, pageProps: { session, rootConfig, pageConfig } }) {
             </ErrorBoundary>
           </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({ event: 'call_agent', agentId, pageId });
+  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);

package/pages/api/usage.js

@@ -17,7 +17,6 @@
 // TODO
 // import crypto from 'crypto';
 
-import appJson from '../../lib/build/app.js';
 import packageJson from '../../package.json';
 import apiWrapper from '../../lib/server/apiWrapper.js';
 // import validateLicense from '../../lib/server/validateLicense.js';
@@ -37,7 +36,7 @@ async function handler({ context, req, res }) {
   const timestamp = Date.now();
 
   // const data = [
-  //   `git_sha: ${appJson.git_sha}`,
+  //   `gitSha: ${context.appMeta.gitSha}`,
   //   `host: ${host}`,
   //   `license_key: ${license.id}`,
   //   `machine: ${machine}`,
@@ -53,7 +52,7 @@ async function handler({ context, req, res }) {
   return res.status(200).json({
     offline: false,
     data: {
-      git_sha: appJson.git_sha,
+      gitSha: context.appMeta.gitSha,
       host,
       // license_key: license.id,
       machine,