@lowdefy/api 0.0.0-experimental-20260929101721 → 0.0.0-experimental-20260929135001

package/dist/context/createEvaluateOperators.js

@@ -24,8 +24,9 @@ function createEvaluateOperators(context) {
         secrets,
         user
     });
-    function evaluateOperators({ arrayIndices, error, input, items, literalData, location, payload, state, steps }) {
+    function evaluateOperators({ agent, arrayIndices, error, input, items, literalData, location, payload, state, steps }) {
         const { output, errors } = operatorsParser.parse({
+            agent,
             arrayIndices,
             error,
             input,

package/dist/routes/agent/prepareAgent.js

@@ -35,6 +35,12 @@ async function prepareAgent(context, { agentId, agentContext, endpointDepth = 0,
     authorizeAgent(context, {
         agentConfig
     });
+    // What `_agent` reads in the tool and hook endpoints this agent calls. Built here from the
+    // agent being run and its conversation, so no tool input can set or change it.
+    const agent = {
+        id: agentId,
+        conversationId: agentContext.conversationId ?? null
+    };
     // Evaluate operators in agent properties (e.g. _user, _secret, _payload)
     agentConfig.properties = context.evaluateOperators({
         input: agentConfig.properties ?? {},
@@ -91,6 +97,7 @@ async function prepareAgent(context, { agentId, agentContext, endpointDepth = 0,
             }),
         callEndpoint: async (endpointId, { payload })=>{
             const { error, response, status } = await invokeEndpoint(context, {
+                agent,
                 endpointId,
                 payload,
                 endpointDepth

package/dist/routes/endpoints/handleEndpointCall.js

@@ -66,7 +66,8 @@ async function handleEndpointCall(context, routineContext, { step }) {
                     payload: serializer.serialize(evaluatedProperties.payload ?? {}),
                     principal: {
                         user: serializer.serialize(context.user ?? null),
-                        system: context.system === true
+                        system: context.system === true,
+                        agent: routineContext.agent ?? null
                     }
                 })
             }));
@@ -88,6 +89,7 @@ async function handleEndpointCall(context, routineContext, { step }) {
         };
     }
     const result = await invokeEndpoint(context, {
+        agent: routineContext.agent,
         endpointId: evaluatedProperties.endpointId,
         payload: evaluatedProperties.payload,
         endpointDepth: routineContext.endpointDepth

package/dist/routes/endpoints/handleRequest.js

@@ -70,6 +70,7 @@ async function handleRequest(context, routineContext, { request }) {
         requestProperties
     });
     const result = await callRequestResolver(context, {
+        agent: routineContext.agent,
         connectionProperties,
         endpointDepth: routineContext.endpointDepth,
         requestConfig,

package/dist/routes/endpoints/invokeEndpoint.js

@@ -18,7 +18,7 @@ import authorizeApiEndpoint from './authorizeApiEndpoint.js';
 import getEndpointConfig from './getEndpointConfig.js';
 import runRoutine from './runRoutine.js';
 import validatePayload from './validatePayload.js';
-async function invokeEndpoint(context, { endpointId, payload, endpointDepth, literalData = null }) {
+async function invokeEndpoint(context, { agent = null, endpointId, payload, endpointDepth, literalData = null }) {
     if (endpointDepth >= 10) {
         throw new ConfigError('Endpoint call depth exceeded maximum of 10. Check for recursive endpoint calls.');
     }
@@ -41,6 +41,10 @@ async function invokeEndpoint(context, { endpointId, payload, endpointDepth, lit
         items: {},
         state: {},
         endpointDepth: endpointDepth + 1,
+        // The agent ({ id, conversationId }) whose tool call started this chain of endpoint calls, or
+        // null. Set by the engine from the running agent, never from the payload, so `_agent` can mark
+        // agent work.
+        agent,
         // Set only for the endpoint a Dynamic block calls: its :return becomes page
         // config, so data read into it must not carry operators. Nested CallApi
         // endpoints get a fresh context without it; their result arrives through

package/dist/routes/endpoints/operatorScope.js

@@ -15,8 +15,9 @@
 */ // The routine fields operators can read. A field added to the routine frame goes here, so every
 // routine step and control sees it rather than only the ones that remembered to pass it.
 function operatorScope(routineContext) {
-    const { error, items, payload, state, steps } = routineContext;
+    const { agent, error, items, payload, state, steps } = routineContext;
     return {
+        agent: agent ?? null,
         error: error ?? null,
         items,
         payload,

package/dist/routes/endpoints/runDetachedEndpoint.js

@@ -79,7 +79,9 @@ async function runDetachedEndpoint(context, { endpointId, payload, principal })
         error: null,
         items: {},
         state: {},
-        endpointDepth: 0
+        endpointDepth: 0,
+        // The dispatcher's agent, carried in the principal like its identity.
+        agent: principal?.agent ?? null
     };
     const { error, response, status } = await runRoutine(context, routineContext, {
         routine: endpointConfig.routine

package/dist/routes/request/callRequestResolver.js

@@ -15,7 +15,7 @@
 */ import { RequestError, ServiceError, UserError } from '@lowdefy/errors';
 import getCurrentEnvironment from '../../context/getCurrentEnvironment.js';
 import invokeEndpoint from '../endpoints/invokeEndpoint.js';
-async function callRequestResolver(context, { connectionProperties, endpointDepth, requestConfig, requestProperties, requestResolver, tenant, tenantGuard }) {
+async function callRequestResolver(context, { agent = null, connectionProperties, endpointDepth, requestConfig, requestProperties, requestResolver, tenant, tenantGuard }) {
     const { blockId, endpointId, logger, pageId, payload, signal } = context;
     // stepId for endpoint steps (after build), requestId for page requests
     const stepOrRequestId = requestConfig.stepId ?? requestConfig.requestId;
@@ -27,6 +27,7 @@ async function callRequestResolver(context, { connectionProperties, endpointDept
             endpointId: targetEndpointId
         });
         const result = await invokeEndpoint(context, {
+            agent,
             endpointId: targetEndpointId,
             payload: targetPayload,
             endpointDepth

package/dist/routes/rootConfig/getAppEvents.js

@@ -0,0 +1,22 @@
+/*
+  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';
+// Serialized like page config: the ~k markers, non-enumerable once the artifact
+// is read, must reach the browser so app event errors resolve to their config.
+async function getAppEvents({ readConfigFile }) {
+    const events = await readConfigFile('events.json');
+    return serializer.serialize(events);
+}
+export default getAppEvents;

package/dist/routes/rootConfig/getRootConfig.js

@@ -12,18 +12,21 @@
   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 getHomeAndMenus from './getHomeAndMenus.js';
+*/ import getAppEvents from './getAppEvents.js';
+import getHomeAndMenus from './getHomeAndMenus.js';
 import getLowdefyGlobal from './getLowdefyGlobal.js';
 import getLowdefyI18n from './getLowdefyI18n.js';
 import getLowdefyTheme from './getLowdefyTheme.js';
 async function getRootConfig(context) {
-    const [lowdefyGlobal, theme, i18n, { home, menus }] = await Promise.all([
+    const [events, lowdefyGlobal, theme, i18n, { home, menus }] = await Promise.all([
+        getAppEvents(context),
         getLowdefyGlobal(context),
         getLowdefyTheme(context),
         getLowdefyI18n(context),
         getHomeAndMenus(context)
     ]);
     return {
+        events,
         home,
         i18n,
         lowdefyApp: context.appMeta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/api",
-  "version": "0.0.0-experimental-20260929101721",
+  "version": "0.0.0-experimental-20260929135001",
   "license": "Apache-2.0",
   "description": "",
   "homepage": "https://lowdefy.com",
@@ -37,16 +37,16 @@
     "@better-auth/cimd": "1.7.0",
     "@better-auth/oauth-provider": "1.7.0",
     "@better-auth/passkey": "1.7.0",
-    "@lowdefy/ajv": "0.0.0-experimental-20260929101721",
-    "@lowdefy/build": "0.0.0-experimental-20260929101721",
-    "@lowdefy/connection-smtp": "0.0.0-experimental-20260929101721",
-    "@lowdefy/email-templates": "0.0.0-experimental-20260929101721",
-    "@lowdefy/errors": "0.0.0-experimental-20260929101721",
-    "@lowdefy/helpers": "0.0.0-experimental-20260929101721",
-    "@lowdefy/node-utils": "0.0.0-experimental-20260929101721",
-    "@lowdefy/nunjucks": "0.0.0-experimental-20260929101721",
-    "@lowdefy/operators": "0.0.0-experimental-20260929101721",
-    "@lowdefy/operators-js": "0.0.0-experimental-20260929101721",
+    "@lowdefy/ajv": "0.0.0-experimental-20260929135001",
+    "@lowdefy/build": "0.0.0-experimental-20260929135001",
+    "@lowdefy/connection-smtp": "0.0.0-experimental-20260929135001",
+    "@lowdefy/email-templates": "0.0.0-experimental-20260929135001",
+    "@lowdefy/errors": "0.0.0-experimental-20260929135001",
+    "@lowdefy/helpers": "0.0.0-experimental-20260929135001",
+    "@lowdefy/node-utils": "0.0.0-experimental-20260929135001",
+    "@lowdefy/nunjucks": "0.0.0-experimental-20260929135001",
+    "@lowdefy/operators": "0.0.0-experimental-20260929135001",
+    "@lowdefy/operators-js": "0.0.0-experimental-20260929135001",
     "@modelcontextprotocol/sdk": "1.29.0",
     "better-auth": "1.7.0",
     "jose": "^6.2.3",
@@ -54,7 +54,7 @@
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@lowdefy/connection-mongodb": "0.0.0-experimental-20260929101721",
+    "@lowdefy/connection-mongodb": "0.0.0-experimental-20260929135001",
     "@shelf/jest-mongodb": "4.3.2",
     "@swc/cli": "0.8.1",
     "@swc/core": "1.15.32",