@lowdefy/api 5.2.0 → 5.3.0

package/dist/index.js

@@ -12,7 +12,8 @@
   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 callEndpoint from './routes/endpoints/callEndpoint.js';
+*/ import callAgent from './routes/agent/callAgent.js';
+import callEndpoint from './routes/endpoints/callEndpoint.js';
 import callRequest from './routes/request/callRequest.js';
 import createApiContext from './context/createApiContext.js';
 import createSessionCallback from './routes/auth/callbacks/createSessionCallback.js';
@@ -21,4 +22,4 @@ import getNextAuthConfig from './routes/auth/getNextAuthConfig.js';
 import getPageConfig from './routes/page/getPageConfig.js';
 import getRootConfig from './routes/rootConfig/getRootConfig.js';
 import logClientError from './routes/log/logClientError.js';
-export { callEndpoint, callRequest, createApiContext, createSessionCallback, getHomeAndMenus, getNextAuthConfig, getPageConfig, getRootConfig, logClientError };
+export { callAgent, callEndpoint, callRequest, createApiContext, createSessionCallback, getHomeAndMenus, getNextAuthConfig, getPageConfig, getRootConfig, logClientError };

package/dist/routes/agent/callAgent.js

@@ -0,0 +1,217 @@
+/*
+  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, type } from '@lowdefy/helpers';
+import createEvaluateOperators from '../../context/createEvaluateOperators.js';
+import authorizeApiEndpoint from '../endpoints/authorizeApiEndpoint.js';
+import getEndpointConfig from '../endpoints/getEndpointConfig.js';
+import runRoutine from '../endpoints/runRoutine.js';
+import getAgentConfig from './getAgentConfig.js';
+import getAgentResolver from './getAgentResolver.js';
+import getConnectionConfig from '../connections/getConnectionConfig.js';
+import getConnection from '../connections/getConnection.js';
+async function callAgent(context, { agentId, pageId, messages, conversationId, urlQuery, sharedState }) {
+    const { logger } = context;
+    context.pageId = pageId;
+    context.evaluateOperators = createEvaluateOperators(context);
+    logger.debug({
+        event: 'debug_agent',
+        agentId,
+        pageId
+    });
+    const agentConfig = await getAgentConfig(context, {
+        agentId
+    });
+    const agentContext = {
+        conversationId: conversationId ?? undefined,
+        pageId,
+        sharedState: sharedState ?? {},
+        urlQuery: urlQuery ?? {},
+        userId: context.user?.sub ?? context.user?.id ?? null
+    };
+    // Evaluate operators in agent properties (e.g. _user, _secret, _payload)
+    agentConfig.properties = context.evaluateOperators({
+        input: agentConfig.properties ?? {},
+        location: agentConfig.agentId,
+        payload: agentContext,
+        steps: {}
+    });
+    // Load connection config from build artifacts using agent's connectionId
+    const connectionConfig = await getConnectionConfig(context, {
+        connectionId: agentConfig.connectionId,
+        configKey: agentConfig['~k']
+    });
+    // Get connection plugin from registry
+    const connection = getConnection(context, {
+        connectionConfig
+    });
+    // Evaluate operators in connection properties
+    const connectionProperties = context.evaluateOperators({
+        input: connectionConfig.properties || {},
+        location: connectionConfig.connectionId,
+        payload: {},
+        steps: {}
+    });
+    // Create connection instance (e.g., Anthropic provider)
+    const connectionInstance = connection.create({
+        connection: connectionProperties
+    });
+    // Get agent type from plugin registry
+    const agentType = getAgentResolver(context, {
+        agentConfig
+    });
+    // Build resolver context with callEndpoint that allows InternalApi endpoints
+    const resolverContext = {
+        agentContext,
+        evaluateOperators: (input)=>context.evaluateOperators({
+                input,
+                location: agentConfig.agentId,
+                payload: agentContext,
+                steps: {}
+            }),
+        callEndpoint: async (endpointId, { payload, abortSignal })=>{
+            const endpointConfig = await getEndpointConfig(context, {
+                endpointId
+            });
+            authorizeApiEndpoint(context, {
+                endpointConfig
+            });
+            const routineContext = {
+                steps: {},
+                payload: payload ?? {},
+                arrayIndices: [],
+                items: {},
+                endpointDepth: 0
+            };
+            const { error, response, status } = await runRoutine(context, routineContext, {
+                routine: endpointConfig.routine
+            });
+            const success = ![
+                'error',
+                'reject'
+            ].includes(status);
+            return {
+                error: serializer.serialize(error),
+                response: serializer.serialize(response),
+                status: success ? 'success' : status,
+                success
+            };
+        },
+        getEndpointConfig: async ({ endpointId })=>{
+            return getEndpointConfig(context, {
+                endpointId
+            });
+        },
+        getAgentConfig: async ({ agentId })=>{
+            return getAgentConfig(context, {
+                agentId
+            });
+        },
+        getConnectionForAgent: async ({ agentConfig: subAgentConfig })=>{
+            const subConnectionConfig = await getConnectionConfig(context, {
+                connectionId: subAgentConfig.connectionId,
+                configKey: subAgentConfig['~k']
+            });
+            const subConnection = getConnection(context, {
+                connectionConfig: subConnectionConfig
+            });
+            const subConnectionProperties = context.evaluateOperators({
+                input: subConnectionConfig.properties || {},
+                location: subConnectionConfig.connectionId,
+                payload: {},
+                steps: {}
+            });
+            return subConnection.create({
+                connection: subConnectionProperties
+            });
+        },
+        resolveMcpSources: async ({ agentConfig: subAgentConfig })=>{
+            const resolvedMcp = [];
+            for (const mcpSource of subAgentConfig.mcp ?? []){
+                if (!type.isNone(mcpSource.connectionId)) {
+                    const mcpConnConfig = await getConnectionConfig(context, {
+                        connectionId: mcpSource.connectionId,
+                        configKey: subAgentConfig['~k']
+                    });
+                    const mcpConnection = getConnection(context, {
+                        connectionConfig: mcpConnConfig
+                    });
+                    const mcpConnProps = context.evaluateOperators({
+                        input: mcpConnConfig.properties || {},
+                        location: mcpConnConfig.connectionId,
+                        payload: {},
+                        steps: {}
+                    });
+                    const mcpConfig = mcpConnection.create({
+                        connection: mcpConnProps
+                    });
+                    const { connectionId: _, ...overrides } = mcpSource;
+                    resolvedMcp.push({
+                        ...mcpConfig,
+                        ...overrides
+                    });
+                } else {
+                    resolvedMcp.push(mcpSource);
+                }
+            }
+            return resolvedMcp;
+        }
+    };
+    // Resolve MCP connection references to inline config.
+    // Agent-level overrides (like confirm) may still contain operators —
+    // handleAgentChat evaluates those via its existing evaluateOperators call.
+    const resolvedMcp = [];
+    for (const mcpSource of agentConfig.mcp ?? []){
+        if (!type.isNone(mcpSource.connectionId)) {
+            const mcpConnConfig = await getConnectionConfig(context, {
+                connectionId: mcpSource.connectionId,
+                configKey: agentConfig['~k']
+            });
+            const mcpConnection = getConnection(context, {
+                connectionConfig: mcpConnConfig
+            });
+            const mcpConnProps = context.evaluateOperators({
+                input: mcpConnConfig.properties || {},
+                location: mcpConnConfig.connectionId,
+                payload: {},
+                steps: {}
+            });
+            const mcpConfig = mcpConnection.create({
+                connection: mcpConnProps
+            });
+            // Merge: connection properties as base, agent-level overrides on top
+            const { connectionId: _, ...overrides } = mcpSource;
+            resolvedMcp.push({
+                ...mcpConfig,
+                ...overrides
+            });
+        } else {
+            resolvedMcp.push(mcpSource);
+        }
+    }
+    agentConfig.mcp = resolvedMcp;
+    // Call the agent resolver
+    const { response } = await agentType.resolver({
+        connection: connectionInstance,
+        properties: {
+            agent: agentConfig,
+            messages
+        },
+        context: resolverContext
+    });
+    return {
+        response
+    };
+}
+export default callAgent;

package/dist/routes/agent/getAgentConfig.js

@@ -0,0 +1,30 @@
+/*
+  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 { ConfigError } from '@lowdefy/errors';
+async function getAgentConfig({ logger, readConfigFile }, { agentId }) {
+    const agent = await readConfigFile(`agents/${agentId}.json`);
+    if (!agent) {
+        const err = new ConfigError(`Agent "${agentId}" does not exist.`);
+        logger.debug({
+            params: {
+                agentId
+            },
+            err
+        }, err.message);
+        throw err;
+    }
+    return agent;
+}
+export default getAgentConfig;

package/dist/routes/agent/getAgentResolver.js

@@ -0,0 +1,33 @@
+/*
+  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 { ConfigError } from '@lowdefy/errors';
+function getAgentResolver({ agents, logger }, { agentConfig }) {
+    const agentType = agents[agentConfig.type];
+    if (!agentType) {
+        const err = new ConfigError(`Agent type "${agentConfig.type}" can not be found.`, {
+            configKey: agentConfig['~k']
+        });
+        logger.debug({
+            params: {
+                id: agentConfig.agentId,
+                type: agentConfig.type
+            },
+            err
+        }, err.message);
+        throw err;
+    }
+    return agentType;
+}
+export default getAgentResolver;

package/dist/routes/{request → connections}/getConnectionConfig.js

@@ -13,16 +13,15 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { ConfigError } from '@lowdefy/errors';
-async function getConnectionConfig({ logger, readConfigFile }, { requestConfig }) {
-    const { connectionId, requestId } = requestConfig;
+async function getConnectionConfig({ logger, readConfigFile }, { connectionId, configKey }) {
     let err;
     if (!connectionId) {
-        err = new ConfigError(`Request "${requestId}" does not specify a connection.`, {
-            configKey: requestConfig['~k']
+        err = new ConfigError('Connection id is missing.', {
+            configKey
         });
         logger.debug({
             params: {
-                requestId
+                connectionId
             },
             err
         }, err.message);
@@ -31,11 +30,11 @@ async function getConnectionConfig({ logger, readConfigFile }, { requestConfig }
     const connection = await readConfigFile(`connections/${connectionId}.json`);
     if (!connection) {
         err = new ConfigError(`Connection "${connectionId}" does not exist.`, {
-            configKey: requestConfig['~k']
+            configKey
         });
         logger.debug({
             params: {
-                requestId
+                connectionId
             },
             err
         }, err.message);

package/dist/routes/endpoints/handleRequest.js

@@ -17,8 +17,8 @@ import callRequestResolver from '../request/callRequestResolver.js';
 import checkConnectionRead from '../request/checkConnectionRead.js';
 import checkConnectionWrite from '../request/checkConnectionWrite.js';
 import evaluateOperators from '../request/evaluateOperators.js';
-import getConnection from '../request/getConnection.js';
-import getConnectionConfig from '../request/getConnectionConfig.js';
+import getConnection from '../connections/getConnection.js';
+import getConnectionConfig from '../connections/getConnectionConfig.js';
 import getRequestResolver from '../request/getRequestResolver.js';
 import validateSchemas from '../request/validateSchemas.js';
 async function handleRequest(context, routineContext, { request }) {
@@ -30,7 +30,8 @@ async function handleRequest(context, routineContext, { request }) {
     });
     const requestConfig = request;
     const connectionConfig = await getConnectionConfig(context, {
-        requestConfig
+        connectionId: requestConfig.connectionId,
+        configKey: requestConfig['~k']
     });
     const connection = getConnection(context, {
         connectionConfig

package/dist/routes/request/callRequest.js

@@ -18,8 +18,8 @@ import callRequestResolver from './callRequestResolver.js';
 import checkConnectionRead from './checkConnectionRead.js';
 import checkConnectionWrite from './checkConnectionWrite.js';
 import evaluateOperators from './evaluateOperators.js';
-import getConnection from './getConnection.js';
-import getConnectionConfig from './getConnectionConfig.js';
+import getConnection from '../connections/getConnection.js';
+import getConnectionConfig from '../connections/getConnectionConfig.js';
 import getRequestConfig from './getRequestConfig.js';
 import getRequestResolver from './getRequestResolver.js';
 import validateSchemas from './validateSchemas.js';
@@ -43,7 +43,8 @@ async function callRequest(context, { blockId, pageId, payload, requestId }) {
         requestId
     });
     const connectionConfig = await getConnectionConfig(context, {
-        requestConfig
+        connectionId: requestConfig.connectionId,
+        configKey: requestConfig['~k']
     });
     authorizeRequest(context, {
         requestConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/api",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -34,13 +34,13 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/ajv": "5.2.0",
-    "@lowdefy/errors": "5.2.0",
-    "@lowdefy/helpers": "5.2.0",
-    "@lowdefy/node-utils": "5.2.0",
-    "@lowdefy/nunjucks": "5.2.0",
-    "@lowdefy/operators": "5.2.0",
-    "@lowdefy/operators-js": "5.2.0"
+    "@lowdefy/ajv": "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"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",