@versori/run 0.7.0-alpha.8 → 0.7.0

package/esm/src/interpreter/vanilla/VanillaInterpreter.js

@@ -209,7 +209,7 @@ export class VanillaInterpreter {
         const kvp = await getKVProvider(runLocal);
         const organisationId = Deno.env.get(envVarOrgId) || 'development';
         const environmentId = Deno.env.get(envVarEnvId) || 'development';
-        const ctxProvider = new VanillaContextProvider(log, kvp, organisationId, environmentId, issuesProvider);
+        const ctxProvider = new VanillaContextProvider(log, kvp, organisationId, environmentId, issuesProvider, queueProvider);
         return new VanillaInterpreter(log, compiler, ctxProvider, express.Router(), express.Router(), new Map(), connectionFactory, CronAPIClient.fromEnv(), tracer, configReader, queueProvider, otelSDK);
     }
     register(workflow, options) {
@@ -235,19 +235,23 @@ export class VanillaInterpreter {
         };
         const trigger$ = this.compiler.compileTrigger(compilerContext, workflow.trigger, combinedSignal);
         const task$ = this.compiler.compileTask(compilerContext, workflow.task);
+        const triggerName = 'id' in workflow.trigger && typeof workflow.trigger.id === 'string'
+            ? workflow.trigger.id
+            : workflow.trigger.constructor.name;
         const registration = {
+            triggerName,
             trigger$,
             task$,
             localAbortController,
             sigintListener: () => {
-                this.log.info('Received SIGINT, shutting down workflow');
+                this.log.info('Received SIGINT, shutting down workflow', { triggerName });
                 localAbortController.abort();
             },
         };
         this.registeredWorkflows.push(registration);
         return registration;
     }
-    start() {
+    async start() {
         const port = Deno.env.get('PORT') || 3000;
         const cronPort = Deno.env.get('CRON_PORT') || 3001;
         const webhookApp = express();
@@ -265,16 +269,23 @@ export class VanillaInterpreter {
             Deno.addSignalListener('SIGINT', registration.sigintListener);
             registration.subscription = registration.trigger$
                 .pipe(tap((ctx) => {
-                ctx.log.info('VanillaInterpreter.executionStarted', { data: ctx.data });
+                ctx.log.info('VanillaInterpreter.executionStarted', {
+                    triggerName: registration.triggerName,
+                    data: ctx.data,
+                });
             }), mergeMap((ctx) => of(ctx).pipe(registration.task$, catchError((err) => {
                 ctx.log.error('VanillaInterpreter.executionError', {
+                    triggerName: registration.triggerName,
                     error: err instanceof Error ? err.toString() : err,
                 });
                 try {
                     ctx.options.onError?.(ctx.withData(err));
                 }
                 catch (err) {
-                    ctx.log.error('VanillaInterpreter.onErrorError: failed to call onError handler', { error: err instanceof Error ? err.toString() : err });
+                    ctx.log.error('VanillaInterpreter.onErrorError: failed to call onError handler', {
+                        triggerName: registration.triggerName,
+                        error: err instanceof Error ? err.toString() : err,
+                    });
                     ctx.options.onError?.(ctx.withData({
                         message: 'Internal server error',
                         error: err instanceof Error ? err.toString() : err,
@@ -286,13 +297,17 @@ export class VanillaInterpreter {
                 next: (ctx) => {
                     const durationMs = Date.now() - ctx.startTime.getTime();
                     ctx.log.info('VanillaInterpreter.executionCompleted', {
+                        triggerName: registration.triggerName,
                         durationMs,
                     });
                     try {
                         ctx.options.onSuccess?.(ctx);
                     }
                     catch (err) {
-                        ctx.log.error('VanillaInterpreter.onSuccessError: failed to call onSuccess handler', { error: err instanceof Error ? err.toString() : err });
+                        ctx.log.error('VanillaInterpreter.onSuccessError: failed to call onSuccess handler', {
+                            triggerName: registration.triggerName,
+                            error: err instanceof Error ? err.toString() : err,
+                        });
                         ctx.options.onSuccess?.(ctx.withData({
                             message: 'Internal server error',
                             error: err instanceof Error ? err.toString() : err,
@@ -302,12 +317,15 @@ export class VanillaInterpreter {
                 },
                 error: (err) => {
                     this.log.error('VanillaInterpreter.error', {
+                        triggerName: registration.triggerName,
                         error: err instanceof Error ? err.toString() : err,
                     });
                     Deno.removeSignalListener('SIGINT', registration.sigintListener);
                 },
                 complete: () => {
-                    this.log.info('VanillaInterpreter.workflowCompleted');
+                    this.log.info('VanillaInterpreter.workflowCompleted', {
+                        triggerName: registration.triggerName,
+                    });
                     Deno.removeSignalListener('SIGINT', registration.sigintListener);
                 },
             });
@@ -316,14 +334,29 @@ export class VanillaInterpreter {
             });
         }
         try {
-            this.cronProvider.updateCrons(this.cronRegistry);
+            await this.cronProvider.updateCrons(this.cronRegistry);
         }
         catch (err) {
             this.log.error('VanillaInterpreter.updateCronsError', {
-                error: err instanceof Error ? err.toString() : err,
+                error: err instanceof Error ? err.message : String(err),
+                stacktrace: err instanceof Error ? err.stack : undefined,
             });
             throw new Error('Unable to register scheduler tasks with central cron provider');
         }
+        // Error-handling middleware: catches rejections forwarded from async
+        // route middleware (via asyncHandler) so platform-API failures during a
+        // webhook request return 500 instead of crashing the host process.
+        webhookApp.use((err, req, res, _next) => {
+            this.log.error('webhook middleware error', {
+                path: req.path,
+                method: req.method,
+                error: err instanceof Error ? err.message : String(err),
+                stacktrace: err instanceof Error ? err.stack : undefined,
+            });
+            if (!res.headersSent) {
+                res.status(500).json({ error: 'Internal server error' });
+            }
+        });
         this.webhookServer = webhookApp.listen(port, () => {
             this.log.info(`Express server listening on port ${port}`);
         });

package/esm/src/interpreter/vanilla/compilers/catch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catch.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/catch.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAG5D,OAAO,EAA2B,YAAY,EAAE,MAAM,YAAY,CAAC;AAwFnE,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAGrE,CAAC"}
+{"version":3,"file":"catch.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/catch.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAG5D,OAAO,EAA2B,YAAY,EAAE,MAAM,YAAY,CAAC;AA0FnE,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAGrE,CAAC"}

package/esm/src/interpreter/vanilla/compilers/catch.js

@@ -44,7 +44,7 @@ function compileCatch(compilerCtx, task) {
                         //     reason: 'error',
                         //     severity: 'high',
                         // });
-                        return errorOperator(of(ctx.withData(new ExecutionError(ctx, error.message, { cause: error }))));
+                        return errorOperator(of(ctx.withData(new ExecutionError(ctx, error.message, { cause: error }), { recoveredFromCatch: true })));
                     }
                     ctx.log.error('execution has encountered an error', {
                         error: error,
@@ -63,7 +63,7 @@ function compileCatch(compilerCtx, task) {
                     // });
                     span.setAttribute('error', `${error}`);
                     span.end();
-                    return errorOperator(of(ctx.withData(new ExecutionError(ctx, `${error}`, { cause: error }))));
+                    return errorOperator(of(ctx.withData(new ExecutionError(ctx, `${error}`, { cause: error }), { recoveredFromCatch: true })));
                 });
             }));
         }));

package/esm/src/interpreter/vanilla/compilers/durableworkflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durableworkflow.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/durableworkflow.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACzB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAqB,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,wBAAgB,sBAAsB,CAClC,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,WAAW,GACpB,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAqFjD;AAED,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,mBAAmB,EAAE,sBAAsB,CAI5F,CAAC"}
+{"version":3,"file":"durableworkflow.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/durableworkflow.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EACH,mBAAmB,EACnB,sBAAsB,EACzB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAqB,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,wBAAgB,sBAAsB,CAClC,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,WAAW,GACpB,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAiJjD;AAED,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,mBAAmB,EAAE,sBAAsB,CAI5F,CAAC"}

package/esm/src/interpreter/vanilla/compilers/durableworkflow.js

@@ -10,31 +10,25 @@
  * As of the Change Date, in accordance with the Business Source License,
  * use of this software will be governed by the Apache License, Version 2.0.
  */
+import { ulid } from '../../../../deps/jsr.io/@std/ulid/1.0.0/mod.js';
 import { Observable } from 'rxjs';
 import { DurableWorkflowTrigger, } from '../../../dsl/triggers/DurableTrigger.js';
 import { VanillaActivation } from '../ObservableCompiler.js';
+import { extractTraceContext } from '../../../observability/tracePropagation.js';
 export function compileDurableWorkflow(ctx, trigger, signal) {
     return new Observable((subscriber) => {
         function cleanup() {
-            ctx.log.debug('webhook trigger stopped');
+            ctx.log.debug('durable workflow trigger stopped');
             subscriber.complete();
         }
         signal.addEventListener('abort', cleanup, { once: true });
         let consecutiveErrors = 0;
-        const maxConsecutiveErrors = 5;
         (async () => {
             while (true) {
                 if (signal.aborted) {
                     cleanup();
                     break;
                 }
-                if (consecutiveErrors >= maxConsecutiveErrors) {
-                    ctx.log.error('reached too many consecutive errors stopping trigger', {
-                        'triggerId': trigger.id,
-                    });
-                    cleanup();
-                    break;
-                }
                 try {
                     // Right now the API itself will hang for a period of time if no workflows are available.
                     // so we don't need to add a delay here.
@@ -47,34 +41,75 @@ export function compileDurableWorkflow(ctx, trigger, signal) {
                         continue;
                     }
                     for (const wf of wfs.workflows) {
-                        if (wf.id &&
-                            wf.attempt !== undefined &&
-                            trigger.options.maxAttempts &&
-                            wf.attempt > trigger.options.maxAttempts) {
-                            ctx.log.error('Workflow exceeded max attempts failing', {
-                                workflowId: wf.id,
-                                attempts: wf.attempt,
-                            });
-                            await ctx.queueProvider.complete({
-                                id: wf.id,
-                                output: wf.output,
-                                status: 'failed',
-                            });
-                            continue;
-                        }
-                        const data = JSON.parse(atob(wf.payload ?? '{}'));
-                        const activation = VanillaActivation;
-                        const newContext = ctx.contextProvider.create(data, {
-                            activation: activation,
-                            workflowId: wf.id,
+                        // If the metadata carries a traceparent, extractTraceContext returns a
+                        // context with the remote span as parent; otherwise it returns the
+                        // current active context, which causes startActiveSpan to create a new
+                        // root span (new trace). Either way the SDK does the right thing.
+                        const parentCtx = extractTraceContext(wf.metadata);
+                        await ctx.tracer.startActiveSpan(`durableworkflow-${trigger.id}`, {}, parentCtx, (span) => {
+                            span.setAttribute('task.id', trigger.id);
+                            span.setAttribute('task.type', 'durableworkflow');
+                            span.setAttribute('execution.id', wf.metadata?.executionId ?? '');
+                            if (wf.metadata?.activationId) {
+                                span.setAttribute('activation.id', wf.metadata.activationId);
+                            }
+                            if (wf.metadata?.traceparent) {
+                                span.setAttribute('trace.continuation', true);
+                            }
+                            try {
+                                const payload = wf.payload ? atob(wf.payload) : '{}';
+                                const data = JSON.parse(payload);
+                                const newContext = ctx.contextProvider
+                                    .createWithExecutionId(VanillaActivation, data, wf.metadata?.executionId ?? ulid().toString(), {
+                                    workflow: wf,
+                                    onSuccess: (completedContext) => {
+                                        const opts = completedContext.options;
+                                        if (opts.recoveredFromCatch) {
+                                            return;
+                                        }
+                                        // locked status means we own the workflow and it's not completed yet
+                                        if (wf.status !== 'locked') {
+                                            return;
+                                        }
+                                        ctx.queueProvider
+                                            .complete({
+                                            id: wf.id,
+                                            output: btoa(JSON.stringify(completedContext.data)),
+                                            status: 'completed',
+                                        })
+                                            .catch((err) => {
+                                            ctx.log.error('failed to mark workflow complete', {
+                                                workflowId: wf.id,
+                                                executionId: completedContext
+                                                    .executionId,
+                                                error: err instanceof Error
+                                                    ? err.message
+                                                    : String(err),
+                                                stacktrace: err instanceof Error
+                                                    ? err.stack
+                                                    : undefined,
+                                            });
+                                        });
+                                    },
+                                });
+                                consecutiveErrors = 0;
+                                subscriber.next(newContext);
+                            }
+                            catch (error) {
+                                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                                ctx.log.error('Error processing workflow', { error });
+                            }
+                            finally {
+                                span.end();
+                            }
                         });
-                        consecutiveErrors = 0;
-                        subscriber.next(newContext);
                     }
                 }
                 catch (error) {
                     ctx.log.error('Error fetching workflows', { error });
                     consecutiveErrors++;
+                    // no workflows available, back-off a bit before retrying
+                    await new Promise((resolve) => setTimeout(resolve, Math.min(consecutiveErrors * 1000, 30000)));
                 }
             }
         })();

package/esm/src/interpreter/vanilla/compilers/fn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fn.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/fn.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD,OAAO,EAA2B,YAAY,EAAE,MAAM,YAAY,CAAC;AAgCnE,eAAO,MAAM,UAAU,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAG/D,CAAC"}
+{"version":3,"file":"fn.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/fn.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD,OAAO,EAA2B,YAAY,EAAE,MAAM,YAAY,CAAC;AAkCnE,eAAO,MAAM,UAAU,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAG/D,CAAC"}

package/esm/src/interpreter/vanilla/compilers/fn.js

@@ -19,12 +19,15 @@ function compileFn(compilerCtx, task) {
         return await compilerCtx.tracer.startActiveSpan(`fn-${task.id}`, async (span) => {
             span.setAttribute('task.id', task.id);
             span.setAttribute('execution.id', ctx.executionId);
-            if (typeof ctx.idx === 'number') {
+            try {
+                if (typeof ctx.idx === 'number') {
+                    return ctx.withData(await task._fn(ctx, ctx.idx));
+                }
+                return ctx.withData(await task._fn(ctx));
+            }
+            finally {
                 span.end();
-                return ctx.withData(await task._fn(ctx, ctx.idx));
             }
-            span.end();
-            return ctx.withData(await task._fn(ctx));
         });
     }));
 }

package/esm/src/interpreter/vanilla/compilers/webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/webhook.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA+D7C,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,WAAW,EAAE,cAAc,CA+QxE,CAAC"}
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/vanilla/compilers/webhook.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA8E7C,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,WAAW,EAAE,cAAc,CAwSxE,CAAC"}

package/esm/src/interpreter/vanilla/compilers/webhook.js

@@ -17,6 +17,16 @@ import { pipeline } from 'node:stream/promises';
 import { Observable } from 'rxjs';
 import { WebhookTrigger } from '../../../dsl/triggers/WebhookTrigger.js';
 import { VanillaActivation } from '../ObservableCompiler.js';
+// Stream error codes that indicate the HTTP client (or the response stream)
+// closed before the response body finished writing. These are expected during
+// normal webhook traffic (clients hanging up after a 202, short timeouts, etc.)
+// and must not crash the host service.
+const CLIENT_DISCONNECT_CODES = new Set([
+    'ERR_STREAM_PREMATURE_CLOSE',
+    'ERR_STREAM_DESTROYED',
+    'ECONNRESET',
+    'EPIPE',
+]);
 const xml2jsDefaults = {
     explicitArray: false,
     normalize: false,
@@ -73,7 +83,7 @@ export const webhookCompiler = {
             throw new Error('Invalid response mode, must be either "sync" or "async"');
         }
         const method = trigger.options.method || 'post';
-        const validMethods = ['get', 'post', 'put', 'delete', 'patch', 'options', 'head'];
+        const validMethods = ['get', 'post', 'put', 'delete', 'patch', 'options', 'head', 'all'];
         if (method !== method.toLowerCase()) {
             throw new Error(`HTTP method must be in lowercase: ${method} on webhook ${trigger.id}`);
         }
@@ -88,26 +98,36 @@ export const webhookCompiler = {
         if (trigger.options.response?.onError) {
             onError = trigger.options.response.onError;
         }
+        const triggerId = trigger.id;
+        const log = ctx.log;
         const ctxOptionsFn = (req, res) => ({
             onSuccess: (ctx) => {
                 if (isSync) {
-                    sendResponse(res, onSuccess(ctx));
+                    sendResponse(res, onSuccess(ctx), log, {
+                        triggerId,
+                        executionId: ctx.executionId,
+                    });
                 }
             },
             onError: (ctx) => {
                 if (isSync) {
-                    sendResponse(res, onError(ctx));
+                    sendResponse(res, onError(ctx), log, {
+                        triggerId,
+                        executionId: ctx.executionId,
+                    });
                 }
             },
             request: req,
         });
+        const routeMiddleware = [];
         if (!trigger.options.request?.rawBody) {
-            ctx.webhookRouter.use(express.json({ limit: '50mb' }));
-            ctx.webhookRouter.use(xmlparser(xml2jsDefaults));
+            routeMiddleware.push(express.json({ limit: '50mb', type: ['application/json', '*/*+json'] }));
+            routeMiddleware.push(xmlparser(xml2jsDefaults));
         }
         else {
-            ctx.webhookRouter.use(express.raw({ type: '*/*', limit: '50mb' }));
+            routeMiddleware.push(express.raw({ type: '*/*', limit: '50mb' }));
         }
+        routeMiddleware.push(vanillaWebhookMiddleware());
         return new Observable((subscriber) => {
             if (!ctx.webhookRouter) {
                 throw new Error('Router not available in compiler context');
@@ -123,7 +143,7 @@ export const webhookCompiler = {
                 }
             }
             // endpoint for sans user because I'm not quite sure how the dynamic routing works
-            ctx.webhookRouter[method](`/${trigger.id}`, vanillaWebhookMiddleware(), async (req, res) => {
+            ctx.webhookRouter[method](`/${trigger.id}`, ...routeMiddleware, async (req, res) => {
                 await ctx.tracer.startActiveSpan(`webhook-${trigger.id}`, (span) => {
                     span.setAttribute('task.id', trigger.id);
                     span.setAttribute('task.type', 'webhook');
@@ -133,7 +153,10 @@ export const webhookCompiler = {
                     try {
                         subscriber.next(executionCtx);
                         if (isAsync) {
-                            sendResponse(res, onSuccess(executionCtx));
+                            sendResponse(res, onSuccess(executionCtx), log, {
+                                triggerId,
+                                executionId: executionCtx.executionId,
+                            });
                         }
                     }
                     catch (error) {
@@ -141,7 +164,10 @@ export const webhookCompiler = {
                             error: JSON.stringify(error),
                         });
                         if (isAsync) {
-                            sendResponse(res, onError(executionCtx.withData(error)));
+                            sendResponse(res, onError(executionCtx.withData(error)), log, {
+                                triggerId,
+                                executionId: executionCtx.executionId,
+                            });
                         }
                     }
                     finally {
@@ -150,7 +176,7 @@ export const webhookCompiler = {
                 });
             });
             // this endpoint will trigger the workflow for each activation given by the external user ID
-            ctx.webhookRouter[method](`/${trigger.id}/users/:userId`, vanillaWebhookMiddleware(), async (req, res) => {
+            ctx.webhookRouter[method](`/${trigger.id}/users/:userId`, ...routeMiddleware, async (req, res) => {
                 await ctx.tracer.startActiveSpan(`webhook-${trigger.id}`, (span) => {
                     span.setAttribute('task.id', trigger.id);
                     span.setAttribute('task.type', 'webhook');
@@ -187,17 +213,23 @@ export const webhookCompiler = {
                     }
                     if (isAsync) {
                         if (errors.length === 0) {
-                            sendResponse(res, onSuccess(executionCtx));
+                            sendResponse(res, onSuccess(executionCtx), log, {
+                                triggerId,
+                                executionId: executionCtx.executionId,
+                            });
                         }
                         else {
-                            sendResponse(res, onError(executionCtx.withData(errors)));
+                            sendResponse(res, onError(executionCtx.withData(errors)), log, {
+                                triggerId,
+                                executionId: executionCtx.executionId,
+                            });
                         }
                     }
                     span.end();
                 });
             });
             // this endpoint will trigger the workflow only for the activation given by its ID
-            ctx.webhookRouter[method](`/${trigger.id}/activations/:activationId`, vanillaWebhookMiddleware(), async (req, res) => {
+            ctx.webhookRouter[method](`/${trigger.id}/activations/:activationId`, ...routeMiddleware, async (req, res) => {
                 await ctx.tracer.startActiveSpan(`webhook-${trigger.id}`, (span) => {
                     span.setAttribute('task.id', trigger.id);
                     span.setAttribute('task.type', 'webhook');
@@ -220,7 +252,10 @@ export const webhookCompiler = {
                     try {
                         subscriber.next(activationCtx);
                         if (isAsync) {
-                            sendResponse(res, onSuccess(activationCtx));
+                            sendResponse(res, onSuccess(activationCtx), log, {
+                                triggerId,
+                                executionId: activationCtx.executionId,
+                            });
                         }
                     }
                     catch (error) {
@@ -228,7 +263,10 @@ export const webhookCompiler = {
                             error: JSON.stringify(error),
                         });
                         if (isAsync) {
-                            sendResponse(res, onError(activationCtx.withData(error)));
+                            sendResponse(res, onError(activationCtx.withData(error)), log, {
+                                triggerId,
+                                executionId: activationCtx.executionId,
+                            });
                         }
                     }
                     finally {
@@ -248,12 +286,30 @@ export const webhookCompiler = {
         });
     },
 };
-function sendResponse(res, response) {
+function sendResponse(res, response, log, meta) {
     res.status(response.status);
     response.headers.forEach((value, key) => {
         res.setHeader(key, value);
     });
-    if (response.body) {
-        pipeline(response.body, res);
+    if (!response.body) {
+        return;
     }
+    pipeline(response.body, res).catch((err) => {
+        if (CLIENT_DISCONNECT_CODES.has(err?.code ?? '')) {
+            log.warn('webhook response stream closed by client', {
+                triggerId: meta.triggerId,
+                executionId: meta.executionId,
+                code: err.code,
+                error: err.message,
+                stacktrace: err.stack,
+            });
+            return;
+        }
+        log.error('webhook response pipeline failed', {
+            triggerId: meta.triggerId,
+            executionId: meta.executionId,
+            error: err instanceof Error ? err.message : String(err),
+            stacktrace: err instanceof Error ? err.stack : undefined,
+        });
+    });
 }

package/esm/src/issues/Issues.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '@versori/run/observability';
+import { Logger } from '../observability/mod.js';
 export type CreateIssue = {
     reason: 'manual' | 'error';
     severity: 'low' | 'medium' | 'high';

package/esm/src/issues/Issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Issues.d.ts","sourceRoot":"","sources":["../../../src/src/issues/Issues.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAWpD,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QACtC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAC7B;AAED,qBAAa,SAAU,YAAW,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IA2BjB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QACtC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;YAWX,MAAM;CA2DvB;AAED,qBAAa,UAAW,YAAW,QAAQ;IACvC,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;QACnC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAG5B"}
+{"version":3,"file":"Issues.d.ts","sourceRoot":"","sources":["../../../src/src/issues/Issues.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAWjD,MAAM,MAAM,WAAW,GAAG;IACtB,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QACtC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAC7B;AAED,qBAAa,SAAU,YAAW,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IA2BjB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QACtC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;YAWX,MAAM;CA2DvB;AAED,qBAAa,UAAW,YAAW,QAAQ;IACvC,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;QACnC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAG5B"}

package/esm/src/kv/KeyValue.d.ts

@@ -1,4 +1,4 @@
-import { CountKVResponse, ListKVRequest, ListKVResponse } from '../dsl/http/versori/kvapi/index.js';
+import { CountKVResponse, KVBatchResult, ListKVRequest, ListKVResponse, SetOptions } from '../dsl/http/versori/kvapi/index.js';
 type GetOptionsMaybeDefault<T> = {
     defaultValue?: T;
     throwOnNotFound?: false;
@@ -16,6 +16,22 @@ type GetOptionsWithThrow<T> = {
  * @template T The expected type of the value.
  */
 export type GetOptions<T> = GetOptionsMaybeDefault<T> | GetOptionsWithDefault<T> | GetOptionsWithThrow<T>;
+/**
+ * SetManyEntry is a single key-value pair for a {@link KeyValue.setMany} batch write.
+ *
+ * @template T The type of the value to store.
+ */
+export interface SetManyEntry<T = any> {
+    /** The key or key path as a string or array of strings. */
+    key: string | string[];
+    /** The value to store (will be JSON serialized, exactly as {@link KeyValue.set}). */
+    value: T;
+    /**
+     * Per-entry write options (e.g. `ifNotExists`, `ifVersionstamp`, expiry). Optional — omit for a
+     * plain unconditional upsert, which is the same behaviour as {@link KeyValue.set}.
+     */
+    options?: SetOptions;
+}
 /**
  * KeyValue provides a simple key-value storage interface for workflow data. Values are automatically JSON serialized
  * and deserialized. The storage scope is determined when opening the KV store via `ctx.openKv()`.
@@ -41,6 +57,21 @@ export interface KeyValue {
      * @param value The value to store (will be JSON serialized).
      */
     set<T>(key: string | string[], value: T): Promise<void>;
+    /**
+     * Set multiple key-value pairs in a single batched request.
+     *
+     * Values are JSON serialized identically to {@link set}, so entries written here round-trip through
+     * {@link get} the same way single writes do. The operation is partial-success: the returned result
+     * reports which entries committed (`successes`) and which failed (`failures`), rather than throwing
+     * when an individual entry fails. It only rejects if the whole request fails (e.g. transport error).
+     *
+     * Keys in `failures` are returned in caller space as an unprefixed key path, matching how
+     * {@link set} never exposes the internal scope prefix.
+     *
+     * @param entries The key-value pairs to write. Values may be of mixed types across entries.
+     * @returns A batch result listing per-entry successes and failures.
+     */
+    setMany(entries: SetManyEntry[]): Promise<KVBatchResult>;
     /**
      * List all keys with a given prefix.
      *
@@ -67,10 +98,13 @@ export interface KeyValue {
  * KeyValueScope determines the visibility and lifetime of key-value data.
  *
  * - `:execution:` - Data scoped to a single workflow execution (deleted after execution completes).
- * - `:project:` - Data scoped to the current project (shared across all executions).
+ * - `:project:` - Contrary to the name this scopes the KV to the current activation, not the project.
+ * - `:workspace:` - Data scoped to the true project (shared across all activations within the project).
  * - `:organization:` - Data scoped to the organization (shared across all projects).
+ * - `:user:` - Data scoped to the current user based on the external_id of the activation.
+ *
  */
-export type KeyValueScope = ':execution:' | ':project:' | ':organization:';
+export type KeyValueScope = ':execution:' | ':project:' | ':workspace:' | ':organization:' | ':user:';
 /**
  * KVOptionsExecution specifies options for opening an execution-scoped KV store.
  */
@@ -79,7 +113,7 @@ export type KVOptionsExecution = {
     executionId: string;
 };
 /**
- * KVOptionsNotExecution specifies options for opening project or organization-scoped KV stores.
+ * KVOptionsNotExecution specifies options for opening project, workspace, organization, or user-scoped KV stores.
  */
 export type KVOptionsNotExecution = {
     scope: Exclude<KeyValueScope, ':execution:'>;
@@ -89,6 +123,7 @@ export type KVOptionsNotExecution = {
  */
 export type KVOptions = (KVOptionsExecution | KVOptionsNotExecution) & {
     activationId?: string;
+    externalUserId?: string;
 };
 /**
  * DestroyOptions configures which KV store to destroy.

package/esm/src/kv/KeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../src/src/kv/KeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpG,KAAK,sBAAsB,CAAC,CAAC,IAAI;IAC7B,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,eAAe,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,KAAK,qBAAqB,CAAC,CAAC,IAAI;IAC5B,YAAY,EAAE,CAAC,CAAC;IAChB,eAAe,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,KAAK,mBAAmB,CAAC,CAAC,IAAI;IAC1B,eAAe,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAClB,sBAAsB,CAAC,CAAC,CAAC,GACzB,qBAAqB,CAAC,CAAC,CAAC,GACxB,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;;;;OAQG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EACP,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,GAAG,GAAG,EACP,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEtF;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAElD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,GAAG;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAEjC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}
+{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../src/src/kv/KeyValue.ts"],"names":[],"mappings":"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"}

package/esm/src/kv/fingerprintExternalUserId.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Stable hex fingerprint of an external user id for KV path segments.
+ * Output is `[0-9a-f]{64}` so it satisfies backends that only allow `[a-zA-Z0-9_-]+` per segment.
+ */
+export declare function fingerprintExternalUserId(externalUserId: string): string;
+//# sourceMappingURL=fingerprintExternalUserId.d.ts.map