@lowdefy/build 5.1.0 → 5.3.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';
@@ -28,15 +29,19 @@ import buildImports from './build/buildImports/buildImports.js';
 import buildJs from './build/full/buildJs.js';
 import buildLogger from './build/buildLogger.js';
 import buildMenu from './build/buildMenu.js';
+import buildModuleDefs from './build/buildModuleDefs.js';
+import buildModules from './build/buildModules.js';
 import buildPages from './build/full/buildPages.js';
 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 writeAuth from './build/writeAuth.js';
 import writeConfig from './build/writeConfig.js';
@@ -58,8 +63,14 @@ async function build(options) {
     let context;
     try {
         context = createContext(options);
+        // Phase 1: Build module definitions
+        // Parses lowdefy.yaml, resolves module refs, populates context.modules
+        await buildModuleDefs({
+            context
+        });
         let components;
         try {
+            // Phase 2: Ref resolution (handles _ref: { module, component/menu })
             components = await buildRefs({
                 context
             });
@@ -73,17 +84,24 @@ async function build(options) {
         }
         // Stop if buildRefs collected any errors (YAML parse, missing files, etc.)
         logCollectedErrors(context);
+        // Phase 3: Process modules — scopes IDs, merges into components
+        buildModules({
+            components,
+            context
+        });
         // Build steps - collect all errors before stopping
         // addKeys runs first so testSchema has ~k markers for error location info
         tryBuildStep(addKeys, 'addKeys', {
             components,
             context
         });
+        // testSchema emits warnings (not errors) — focused validations in each
+        // build step provide better error messages with full context
         tryBuildStep(testSchema, 'testSchema', {
             components,
             context
         });
-        // Schema errors mean structurally invalid data - stop before processing further
+        // Stop if addKeys collected any errors (e.g. invalid ~ignoreBuildChecks)
         logCollectedErrors(context);
         tryBuildStep(buildApp, 'buildApp', {
             components,
@@ -118,6 +136,10 @@ async function build(options) {
             components,
             context
         });
+        tryBuildStep(buildAgents, 'buildAgents', {
+            components,
+            context
+        });
         tryBuildStep(buildPages, 'buildPages', {
             components,
             context
@@ -171,6 +193,10 @@ async function build(options) {
             components,
             context
         });
+        await writeAgents({
+            components,
+            context
+        });
         await writeApi({
             components,
             context
@@ -227,6 +253,10 @@ async function build(options) {
             components,
             context
         });
+        await copyAgentFileSystems({
+            components,
+            context
+        });
     } catch (err) {
         if (err instanceof BuildError) {
             throw err;

package/dist/indexDev.js

@@ -12,7 +12,9 @@
   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.
-*/ export { default as shallowBuild } from './build/jit/shallowBuild.js';
+*/ export { default as buildModuleDefs } from './build/buildModuleDefs.js';
+export { default as buildModules } from './build/buildModules.js';
+export { default as shallowBuild } from './build/jit/shallowBuild.js';
 export { default as buildPageJit } from './build/jit/buildPageJit.js';
 export { default as createPageRegistry } from './build/jit/createPageRegistry.js';
 export { default as createContext } from './createContext.js';

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: [
                         {
@@ -1495,6 +1730,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: {
@@ -1531,6 +1775,64 @@ export default {
                 type: 'App "pages" should be an array.'
             }
         },
+        modules: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: [
+                    'id',
+                    'source'
+                ],
+                properties: {
+                    '~r': {},
+                    '~l': {},
+                    id: {
+                        type: 'string',
+                        errorMessage: {
+                            type: 'Module "id" should be a string.'
+                        }
+                    },
+                    source: {
+                        type: 'string',
+                        errorMessage: {
+                            type: 'Module "source" should be a string.'
+                        }
+                    },
+                    vars: {
+                        type: 'object',
+                        errorMessage: {
+                            type: 'Module "vars" should be an object.'
+                        }
+                    },
+                    connections: {
+                        type: 'object',
+                        errorMessage: {
+                            type: 'Module "connections" should be an object.'
+                        }
+                    },
+                    dependencies: {
+                        type: 'object',
+                        additionalProperties: {
+                            type: 'string'
+                        },
+                        errorMessage: {
+                            type: 'Module "dependencies" should be an object with string values.'
+                        }
+                    }
+                },
+                additionalProperties: false,
+                errorMessage: {
+                    type: 'Module should be an object.',
+                    required: {
+                        id: 'Module should have required property "id".',
+                        source: 'Module should have required property "source".'
+                    }
+                }
+            },
+            errorMessage: {
+                type: 'App "modules" should be an array.'
+            }
+        },
         logger: {
             type: 'object',
             additionalProperties: false,

package/dist/scripts/generateDefaultTypes.js

@@ -16,45 +16,12 @@
 */ import path from 'path';
 import { readFile, writeFile } from '@lowdefy/node-utils';
 import createPluginTypesMap from '../utils/createPluginTypesMap.js';
-const defaultPackages = [
-    '@lowdefy/actions-core',
-    '@lowdefy/actions-pdf-make',
-    '@lowdefy/blocks-aggrid',
-    '@lowdefy/blocks-antd',
-    '@lowdefy/blocks-basic',
-    '@lowdefy/blocks-diff',
-    '@lowdefy/blocks-echarts',
-    '@lowdefy/blocks-google-maps',
-    '@lowdefy/blocks-loaders',
-    '@lowdefy/blocks-markdown',
-    '@lowdefy/blocks-qr',
-    '@lowdefy/connection-axios-http',
-    '@lowdefy/connection-elasticsearch',
-    '@lowdefy/connection-test',
-    '@lowdefy/connection-google-sheets',
-    '@lowdefy/connection-knex',
-    '@lowdefy/connection-mongodb',
-    '@lowdefy/connection-redis',
-    '@lowdefy/connection-sendgrid',
-    '@lowdefy/connection-stripe',
-    '@lowdefy/operators-change-case',
-    '@lowdefy/operators-diff',
-    '@lowdefy/operators-js',
-    '@lowdefy/operators-jsonata',
-    '@lowdefy/operators-dayjs',
-    '@lowdefy/operators-mql',
-    '@lowdefy/operators-nunjucks',
-    '@lowdefy/operators-uuid',
-    '@lowdefy/operators-yaml',
-    '@lowdefy/plugin-auth0',
-    '@lowdefy/plugin-aws',
-    '@lowdefy/plugin-csv',
-    '@lowdefy/plugin-next-auth'
-];
+import defaultPackages from '../defaultPackages.js';
 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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/build",
-  "version": "5.1.0",
+  "version": "5.3.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -45,57 +45,68 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/ajv": "5.1.0",
-    "@lowdefy/block-utils": "5.1.0",
-    "@lowdefy/blocks-basic": "5.1.0",
-    "@lowdefy/blocks-loaders": "5.1.0",
-    "@lowdefy/errors": "5.1.0",
-    "@lowdefy/helpers": "5.1.0",
-    "@lowdefy/node-utils": "5.1.0",
-    "@lowdefy/nunjucks": "5.1.0",
-    "@lowdefy/operators": "5.1.0",
-    "@lowdefy/operators-js": "5.1.0",
+    "@lowdefy/ai-utils": "5.3.0",
+    "@lowdefy/ajv": "5.3.0",
+    "@lowdefy/block-utils": "5.3.0",
+    "@lowdefy/blocks-basic": "5.3.0",
+    "@lowdefy/blocks-loaders": "5.3.0",
+    "@lowdefy/errors": "5.3.0",
+    "@lowdefy/helpers": "5.3.0",
+    "@lowdefy/node-utils": "5.3.0",
+    "@lowdefy/nunjucks": "5.3.0",
+    "@lowdefy/operators": "5.3.0",
+    "@lowdefy/operators-js": "5.3.0",
     "ajv": "8.12.0",
     "json5": "2.2.3",
+    "picomatch": "4.0.1",
+    "semver": "7.5.4",
+    "tar": "6.2.1",
     "yaml": "2.3.4",
     "yargs": "17.7.2"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@lowdefy/actions-core": "5.1.0",
-    "@lowdefy/actions-pdf-make": "5.1.0",
-    "@lowdefy/blocks-aggrid": "5.1.0",
-    "@lowdefy/blocks-antd": "5.1.0",
-    "@lowdefy/blocks-diff": "5.1.0",
-    "@lowdefy/blocks-echarts": "5.1.0",
-    "@lowdefy/blocks-google-maps": "5.1.0",
-    "@lowdefy/blocks-markdown": "5.1.0",
-    "@lowdefy/blocks-qr": "5.1.0",
-    "@lowdefy/connection-axios-http": "5.1.0",
-    "@lowdefy/connection-elasticsearch": "5.1.0",
-    "@lowdefy/connection-test": "5.1.0",
-    "@lowdefy/connection-google-sheets": "5.1.0",
-    "@lowdefy/connection-knex": "5.1.0",
-    "@lowdefy/connection-mongodb": "5.1.0",
-    "@lowdefy/connection-redis": "5.1.0",
-    "@lowdefy/connection-sendgrid": "5.1.0",
-    "@lowdefy/connection-stripe": "5.1.0",
-    "@lowdefy/operators-change-case": "5.1.0",
-    "@lowdefy/operators-diff": "5.1.0",
-    "@lowdefy/operators-jsonata": "5.1.0",
-    "@lowdefy/operators-dayjs": "5.1.0",
-    "@lowdefy/operators-mql": "5.1.0",
-    "@lowdefy/operators-nunjucks": "5.1.0",
-    "@lowdefy/operators-uuid": "5.1.0",
-    "@lowdefy/operators-yaml": "5.1.0",
-    "@lowdefy/plugin-auth0": "5.1.0",
-    "@lowdefy/plugin-aws": "5.1.0",
-    "@lowdefy/plugin-csv": "5.1.0",
-    "@lowdefy/plugin-next-auth": "5.1.0",
+    "@lowdefy/actions-core": "5.3.0",
+    "@lowdefy/actions-pdf-make": "5.3.0",
+    "@lowdefy/blocks-aggrid": "5.3.0",
+    "@lowdefy/blocks-antd": "5.3.0",
+    "@lowdefy/blocks-antd-x": "5.3.0",
+    "@lowdefy/blocks-diff": "5.3.0",
+    "@lowdefy/blocks-echarts": "5.3.0",
+    "@lowdefy/blocks-google-maps": "5.3.0",
+    "@lowdefy/blocks-markdown": "5.3.0",
+    "@lowdefy/blocks-qr": "5.3.0",
+    "@lowdefy/blocks-tiptap": "5.3.0",
+    "@lowdefy/connection-ai-gateway": "5.3.0",
+    "@lowdefy/connection-anthropic": "5.3.0",
+    "@lowdefy/connection-axios-http": "5.3.0",
+    "@lowdefy/connection-elasticsearch": "5.3.0",
+    "@lowdefy/connection-google": "5.3.0",
+    "@lowdefy/connection-google-sheets": "5.3.0",
+    "@lowdefy/connection-knex": "5.3.0",
+    "@lowdefy/connection-mcp": "5.3.0",
+    "@lowdefy/connection-mongodb": "5.3.0",
+    "@lowdefy/connection-openai": "5.3.0",
+    "@lowdefy/connection-redis": "5.3.0",
+    "@lowdefy/connection-sendgrid": "5.3.0",
+    "@lowdefy/connection-stripe": "5.3.0",
+    "@lowdefy/connection-test": "5.3.0",
+    "@lowdefy/logger": "5.3.0",
+    "@lowdefy/operators-change-case": "5.3.0",
+    "@lowdefy/operators-dayjs": "5.3.0",
+    "@lowdefy/operators-diff": "5.3.0",
+    "@lowdefy/operators-jsonata": "5.3.0",
+    "@lowdefy/operators-mql": "5.3.0",
+    "@lowdefy/operators-nunjucks": "5.3.0",
+    "@lowdefy/operators-uuid": "5.3.0",
+    "@lowdefy/operators-yaml": "5.3.0",
+    "@lowdefy/plugin-auth0": "5.3.0",
+    "@lowdefy/plugin-aws": "5.3.0",
+    "@lowdefy/plugin-csv": "5.3.0",
+    "@lowdefy/plugin-next-auth": "5.3.0",
     "@swc/cli": "0.8.0",
     "@swc/core": "1.15.18",
     "@swc/jest": "0.2.39",
-    "@lowdefy/logger": "5.1.0",
     "jest": "28.1.3",
     "pino": "8.16.2"
   },

package/dist/build/jit/stripPageContent.js

@@ -1,29 +0,0 @@
-/*
-  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 { type } from '@lowdefy/helpers';
-import PAGE_CONTENT_KEYS from './pageContentKeys.js';
-function stripPageContent({ components, context }) {
-    for (const page of components.pages ?? []){
-        // Only strip pages that have a source ref (will be JIT-rebuilt).
-        // Inline pages (no ~r) must keep their content for buildShallowPages.
-        const keyMapEntry = context.keyMap[page['~k']];
-        const refId = keyMapEntry?.['~r'] ?? null;
-        if (type.isNone(refId)) continue;
-        for (const key of PAGE_CONTENT_KEYS){
-            delete page[key];
-        }
-    }
-}
-export default stripPageContent;