@lowdefy/build 5.2.0 → 5.4.0

package/dist/index.js

@@ -20,6 +20,7 @@ import makeId from './utils/makeId.js';
 import tryBuildStep from './utils/tryBuildStep.js';
 import addDefaultPages from './build/addDefaultPages/addDefaultPages.js';
 import addKeys from './build/addKeys.js';
+import buildAgents from './build/buildAgents.js';
 import buildApp from './build/buildApp.js';
 import buildAuth from './build/buildAuth/buildAuth.js';
 import buildConnections from './build/buildConnections.js';
@@ -35,16 +36,21 @@ import buildRefs from './build/buildRefs/buildRefs.js';
 import collectPageContent from './build/collectPageContent.js';
 import buildTypes from './build/buildTypes.js';
 import cleanBuildDirectory from './build/cleanBuildDirectory.js';
+import copyAgentFileSystems from './build/copyAgentFileSystems.js';
 import copyPublicFolder from './build/copyPublicFolder.js';
 import testSchema from './build/testSchema.js';
 import updateServerPackageJson from './build/full/updateServerPackageJson.js';
 import validateConfig from './build/validateConfig.js';
+import writeAgents from './build/writeAgents.js';
 import writeApp from './build/writeApp.js';
+import writeAppMeta from './build/writeAppMeta.js';
 import writeAuth from './build/writeAuth.js';
 import writeConfig from './build/writeConfig.js';
 import writeConnections from './build/writeConnections.js';
 import writeApi from './build/writeApi.js';
 import writeGlobal from './build/writeGlobal.js';
+import codegenI18nLocales from './build/codegenI18nLocales.js';
+import writeI18n from './build/writeI18n.js';
 import writeTheme from './build/writeTheme.js';
 import writeJs from './build/buildJs/writeJs.js';
 import writeLogger from './build/writeLogger.js';
@@ -133,6 +139,10 @@ async function build(options) {
             components,
             context
         });
+        tryBuildStep(buildAgents, 'buildAgents', {
+            components,
+            context
+        });
         tryBuildStep(buildPages, 'buildPages', {
             components,
             context
@@ -178,6 +188,10 @@ async function build(options) {
             components,
             context
         });
+        await writeAppMeta({
+            components,
+            context
+        });
         await writeAuth({
             components,
             context
@@ -186,6 +200,10 @@ async function build(options) {
             components,
             context
         });
+        await writeAgents({
+            components,
+            context
+        });
         await writeApi({
             components,
             context
@@ -210,6 +228,14 @@ async function build(options) {
             components,
             context
         });
+        await writeI18n({
+            components,
+            context
+        });
+        await codegenI18nLocales({
+            components,
+            context
+        });
         await writeLogger({
             components,
             context
@@ -242,6 +268,10 @@ async function build(options) {
             components,
             context
         });
+        await copyAgentFileSystems({
+            components,
+            context
+        });
     } catch (err) {
         if (err instanceof BuildError) {
             throw err;

package/dist/lowdefySchema.js

@@ -67,6 +67,229 @@ export default {
                 }
             }
         },
+        agent: {
+            type: 'object',
+            additionalProperties: false,
+            required: [
+                'id',
+                'type',
+                'connectionId'
+            ],
+            properties: {
+                '~ignoreBuildChecks': {
+                    oneOf: [
+                        {
+                            const: true
+                        },
+                        {
+                            type: 'array',
+                            items: {
+                                type: 'string',
+                                enum: [
+                                    'state-refs',
+                                    'payload-refs',
+                                    'step-refs',
+                                    'link-refs',
+                                    'request-refs',
+                                    'connection-refs',
+                                    'types',
+                                    'schema'
+                                ]
+                            }
+                        }
+                    ]
+                },
+                '~r': {},
+                '~l': {},
+                id: {
+                    type: 'string',
+                    errorMessage: {
+                        type: 'Agent "id" should be a string.'
+                    }
+                },
+                type: {
+                    type: 'string',
+                    errorMessage: {
+                        type: 'Agent "type" should be a string.'
+                    }
+                },
+                connectionId: {
+                    type: 'string',
+                    errorMessage: {
+                        type: 'Agent "connectionId" should be a string.'
+                    }
+                },
+                properties: {
+                    type: 'object',
+                    errorMessage: {
+                        type: 'Agent "properties" should be an object.'
+                    }
+                },
+                tools: {
+                    type: 'array',
+                    items: {
+                        anyOf: [
+                            {
+                                type: 'string'
+                            },
+                            {
+                                type: 'object',
+                                required: [
+                                    'endpointId'
+                                ],
+                                properties: {
+                                    endpointId: {
+                                        type: 'string'
+                                    },
+                                    confirm: {
+                                        const: true
+                                    }
+                                },
+                                additionalProperties: false
+                            }
+                        ]
+                    },
+                    errorMessage: {
+                        type: 'Agent "tools" should be an array.'
+                    }
+                },
+                mcp: {
+                    type: 'array',
+                    items: {
+                        anyOf: [
+                            {
+                                type: 'string'
+                            },
+                            {
+                                type: 'object',
+                                properties: {
+                                    connectionId: {
+                                        type: 'string'
+                                    },
+                                    url: {
+                                        type: 'string'
+                                    },
+                                    transport: {
+                                        type: 'string',
+                                        enum: [
+                                            'http',
+                                            'sse',
+                                            'stdio'
+                                        ],
+                                        default: 'http'
+                                    },
+                                    headers: {
+                                        type: 'object'
+                                    },
+                                    command: {
+                                        type: 'string'
+                                    },
+                                    args: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'string'
+                                        }
+                                    },
+                                    env: {
+                                        type: 'object'
+                                    },
+                                    confirm: {
+                                        const: true
+                                    }
+                                },
+                                additionalProperties: false
+                            }
+                        ]
+                    },
+                    errorMessage: {
+                        type: 'Agent "mcp" should be an array.'
+                    }
+                },
+                hooks: {
+                    type: 'object',
+                    properties: {
+                        onStart: {
+                            type: 'array',
+                            items: {
+                                type: 'string'
+                            }
+                        },
+                        onStepStart: {
+                            type: 'array',
+                            items: {
+                                type: 'string'
+                            }
+                        },
+                        onToolCallStart: {
+                            type: 'array',
+                            items: {
+                                type: 'string'
+                            }
+                        },
+                        onToolCallFinish: {
+                            type: 'array',
+                            items: {
+                                type: 'string'
+                            }
+                        },
+                        onStepFinish: {
+                            type: 'array',
+                            items: {
+                                type: 'string'
+                            }
+                        },
+                        onFinish: {
+                            type: 'array',
+                            items: {
+                                type: 'string'
+                            }
+                        }
+                    },
+                    errorMessage: {
+                        type: 'Agent "hooks" should be an object.'
+                    }
+                },
+                agents: {
+                    type: 'array',
+                    items: {
+                        anyOf: [
+                            {
+                                type: 'string'
+                            },
+                            {
+                                type: 'object',
+                                required: [
+                                    'agentId'
+                                ],
+                                properties: {
+                                    agentId: {
+                                        type: 'string'
+                                    },
+                                    description: {
+                                        type: 'string'
+                                    },
+                                    inputSchema: {
+                                        type: 'object'
+                                    }
+                                },
+                                additionalProperties: false
+                            }
+                        ]
+                    },
+                    errorMessage: {
+                        type: 'Agent "agents" should be an array.'
+                    }
+                }
+            },
+            errorMessage: {
+                type: 'Agent should be an object.',
+                required: {
+                    id: 'Agent should have required property "id".',
+                    type: 'Agent should have required property "type".',
+                    connectionId: 'Agent should have required property "connectionId".'
+                }
+            }
+        },
         app: {
             type: 'object',
             additionalProperties: false,
@@ -905,6 +1128,18 @@ export default {
                         type: 'Api endpoint "type" should be a string.'
                     }
                 },
+                description: {
+                    type: 'string',
+                    errorMessage: {
+                        type: 'Api endpoint "description" should be a string.'
+                    }
+                },
+                payloadSchema: {
+                    type: 'object',
+                    errorMessage: {
+                        type: 'Api endpoint "payloadSchema" should be an object.'
+                    }
+                },
                 routine: {
                     anyOf: [
                         {
@@ -1089,6 +1324,16 @@ export default {
                         type: 'MenuGroup "type" should be a string.'
                     }
                 },
+                style: {
+                    errorMessage: {
+                        type: 'MenuGroup "style" should be an object, string, or array.'
+                    }
+                },
+                class: {
+                    errorMessage: {
+                        type: 'MenuGroup "class" should be a string, array, or object.'
+                    }
+                },
                 properties: {
                     type: 'object',
                     errorMessage: {
@@ -1113,8 +1358,81 @@ export default {
                 }
             }
         },
+        menuDivider: {
+            type: 'object',
+            additionalProperties: false,
+            required: [
+                'id',
+                'type'
+            ],
+            properties: {
+                '~ignoreBuildChecks': {
+                    oneOf: [
+                        {
+                            const: true
+                        },
+                        {
+                            type: 'array',
+                            items: {
+                                type: 'string',
+                                enum: [
+                                    'state-refs',
+                                    'payload-refs',
+                                    'step-refs',
+                                    'link-refs',
+                                    'request-refs',
+                                    'connection-refs',
+                                    'types',
+                                    'schema'
+                                ]
+                            }
+                        }
+                    ]
+                },
+                '~r': {},
+                '~l': {},
+                id: {
+                    type: 'string',
+                    errorMessage: {
+                        type: 'MenuDivider "id" should be a string.'
+                    }
+                },
+                type: {
+                    type: 'string',
+                    errorMessage: {
+                        type: 'MenuDivider "type" should be a string.'
+                    }
+                },
+                style: {
+                    errorMessage: {
+                        type: 'MenuDivider "style" should be an object, string, or array.'
+                    }
+                },
+                class: {
+                    errorMessage: {
+                        type: 'MenuDivider "class" should be a string, array, or object.'
+                    }
+                },
+                properties: {
+                    type: 'object',
+                    errorMessage: {
+                        type: 'MenuDivider "properties" should be an object.'
+                    }
+                }
+            },
+            errorMessage: {
+                type: 'MenuDivider should be an object.',
+                required: {
+                    id: 'MenuDivider should have required property "id".',
+                    type: 'MenuDivider should have required property "type".'
+                }
+            }
+        },
         menuItem: {
             anyOf: [
+                {
+                    $ref: '#/definitions/menuDivider'
+                },
                 {
                     $ref: '#/definitions/menuGroup'
                 },
@@ -1192,6 +1510,16 @@ export default {
                         type: 'MenuLink "input" should be an object.'
                     }
                 },
+                style: {
+                    errorMessage: {
+                        type: 'MenuLink "style" should be an object, string, or array.'
+                    }
+                },
+                class: {
+                    errorMessage: {
+                        type: 'MenuLink "class" should be a string, array, or object.'
+                    }
+                },
                 properties: {
                     type: 'object',
                     errorMessage: {
@@ -1396,6 +1724,20 @@ export default {
                 type: 'App "version" should be a string.'
             }
         },
+        slug: {
+            type: 'string',
+            pattern: '^[a-z][a-z0-9]*(-[a-z0-9]+)*$',
+            errorMessage: {
+                type: 'App "slug" should be a string.',
+                pattern: 'App "slug" must be kebab-case: lowercase letters and digits, hyphen-separated, starting with a letter, no leading/trailing/consecutive hyphens, no underscores.'
+            }
+        },
+        description: {
+            type: 'string',
+            errorMessage: {
+                type: 'App "description" should be a string.'
+            }
+        },
         app: {
             $ref: '#/definitions/app'
         },
@@ -1453,6 +1795,69 @@ export default {
                     errorMessage: {
                         type: 'App "config.homePageId" should be a string.'
                     }
+                },
+                i18n: {
+                    type: 'object',
+                    additionalProperties: false,
+                    required: [
+                        'defaultLocale',
+                        'locales'
+                    ],
+                    properties: {
+                        '~k': {},
+                        '~r': {},
+                        '~l': {},
+                        defaultLocale: {
+                            type: 'string',
+                            description: 'BCP 47 locale code used when no user preference or browser match is available.'
+                        },
+                        locales: {
+                            type: 'array',
+                            minItems: 1,
+                            items: {
+                                type: 'object',
+                                additionalProperties: false,
+                                required: [
+                                    'code'
+                                ],
+                                properties: {
+                                    '~k': {},
+                                    '~r': {},
+                                    '~l': {},
+                                    code: {
+                                        type: 'string',
+                                        description: 'BCP 47 locale code (e.g. "en-US", "de-DE").'
+                                    },
+                                    label: {
+                                        type: 'string',
+                                        description: 'Human-readable label for language pickers.'
+                                    },
+                                    antd: {
+                                        type: 'string',
+                                        description: 'Ant Design locale module name (e.g. "en_US"). Loaded from antd/locale/{name}.'
+                                    },
+                                    dayjs: {
+                                        type: 'string',
+                                        description: 'Dayjs locale id (e.g. "en", "zh-cn").'
+                                    }
+                                }
+                            }
+                        },
+                        messages: {
+                            type: 'object',
+                            description: 'Translation messages keyed by locale code. Each locale maps to an object of { key: ICU MessageFormat string }.',
+                            additionalProperties: {
+                                type: 'object'
+                            }
+                        }
+                    },
+                    errorMessage: {
+                        type: 'App "config.i18n" should be an object.',
+                        required: {
+                            defaultLocale: 'App "config.i18n" requires "defaultLocale".',
+                            locales: 'App "config.i18n" requires a "locales" array.'
+                        }
+                    }
                 }
             }
         },
@@ -1495,6 +1900,15 @@ export default {
                 type: 'App "global" should be an object.'
             }
         },
+        agents: {
+            type: 'array',
+            items: {
+                $ref: '#/definitions/agent'
+            },
+            errorMessage: {
+                type: 'App "agents" should be an array.'
+            }
+        },
         connections: {
             type: 'array',
             items: {

package/dist/scripts/generateDefaultMessages.js

@@ -0,0 +1,37 @@
+#!/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 path from 'path';
+import { writeFile } from '@lowdefy/node-utils';
+import defaultPackages from '../defaultPackages.js';
+async function generateDefaultMessagesMap() {
+    const defaultMessagesMap = {};
+    for (const packageName of defaultPackages){
+        let messagesModule;
+        try {
+            messagesModule = await import(`${packageName}/messages`);
+        } catch (e) {
+            continue;
+        }
+        const messages = messagesModule.default ?? messagesModule;
+        if (!messages || typeof messages !== 'object') continue;
+        defaultMessagesMap[packageName] = messages;
+    }
+    await writeFile(path.resolve(process.cwd(), './dist/defaultMessagesMap.js'), `const defaultMessagesMap = ${JSON.stringify(defaultMessagesMap, null, 2)};
+
+export default defaultMessagesMap;
+`);
+}
+generateDefaultMessagesMap();

package/dist/scripts/generateDefaultTypes.js

@@ -21,6 +21,7 @@ async function generateDefaultTypesMap() {
     const packageFile = JSON.parse(await readFile(path.resolve(process.cwd(), './package.json')));
     const defaultTypesMap = {
         actions: {},
+        agents: {},
         auth: {
             adapters: {},
             callbacks: {},

package/dist/test-utils/testContext.js

@@ -29,6 +29,7 @@ function testContext({ writeBuildArtifact, configDirectory, readConfigFile, logg
         },
         typeCounters: {
             actions: createCounter(),
+            agents: createCounter(),
             auth: {
                 adapters: createCounter(),
                 callbacks: createCounter(),
@@ -49,6 +50,7 @@ function testContext({ writeBuildArtifact, configDirectory, readConfigFile, logg
         refMap: {},
         keyMap: {},
         jsMap: {},
+        agentIds: new Set(),
         connectionIds: new Set()
     };
     context.logger = {

package/dist/utils/createPluginTypesMap.js

@@ -32,6 +32,13 @@ function createPluginTypesMap({ packageName, packageTypes, typePrefix = '', type
         typePrefix,
         version
     });
+    createTypeDefinitions({
+        typeNames: packageTypes.agents,
+        store: typesMap.agents,
+        packageName,
+        typePrefix,
+        version
+    });
     createTypeDefinitions({
         typeNames: type.isObject(packageTypes.auth) ? packageTypes.auth.adapters : [],
         store: typesMap.auth.adapters,