@versori/run 0.7.0-alpha.9 → 0.7.0

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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprintExternalUserId.d.ts","sourceRoot":"","sources":["../../../src/src/kv/fingerprintExternalUserId.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/esm/src/kv/fingerprintExternalUserId.js

@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * 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 { createHash } from 'node:crypto';
+/**
+ * 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 function fingerprintExternalUserId(externalUserId) {
+    return createHash('sha256').update(externalUserId, 'utf8').digest('hex');
+}

package/esm/src/kv/memory/MemoryKeyValue.d.ts

@@ -1,9 +1,10 @@
-import { GetOptions, KeyValue } from '../KeyValue.js';
-import { CountKVResponse, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
+import { GetOptions, KeyValue, SetManyEntry } from '../KeyValue.js';
+import { CountKVResponse, KVBatchResult, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
 export declare class MemoryKeyValue implements KeyValue {
     private store;
     get<T>(key: string | string[], options?: GetOptions<T>): Promise<T | undefined>;
     set<T>(key: string | string[], value: T): Promise<void>;
+    setMany(entries: SetManyEntry[]): Promise<KVBatchResult>;
     delete(key: string | string[]): Promise<void>;
     list(prefix: string[], options?: ListKVRequest): Promise<ListKVResponse>;
     count(prefix: string[]): Promise<CountKVResponse>;

package/esm/src/kv/memory/MemoryKeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACH,eAAe,EACf,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAC/C,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAc/E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAIpD"}
+{"version":3,"file":"MemoryKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACH,eAAe,EAEf,aAAa,EAEb,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAK/C,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAE1C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA0B/E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvD,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAWpD"}

package/esm/src/kv/memory/MemoryKeyValue.js

@@ -11,6 +11,8 @@
  * use of this software will be governed by the Apache License, Version 2.0.
  */
 import { KVNotFoundError } from '../KVNotFoundError.js';
+import opentelemetry from '@opentelemetry/api';
+const tracer = opentelemetry.trace.getTracer('versori-run-kv');
 export class MemoryKeyValue {
     constructor() {
         Object.defineProperty(this, "store", {
@@ -20,30 +22,106 @@ export class MemoryKeyValue {
             value: new Map()
         });
     }
-    get(key, options) {
-        const raw = this.store.get(key instanceof Array ? key.join('.') : key);
-        if (typeof raw === 'undefined') {
-            if (options?.throwOnNotFound) {
-                throw new KVNotFoundError(key instanceof Array ? key.join('.') : key);
-            }
-            return Promise.resolve(undefined);
-        }
-        return Promise.resolve(raw);
+    async get(key, options) {
+        return await tracer.startActiveSpan('kv.get', (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                const raw = this.store.get(keyStr);
+                if (typeof raw === 'undefined') {
+                    if (options?.throwOnNotFound) {
+                        throw new KVNotFoundError(keyStr);
+                    }
+                    return undefined;
+                }
+                return raw;
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    async set(key, value) {
+        return await tracer.startActiveSpan('kv.set', (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                this.store.set(keyStr, value);
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
-    set(key, value) {
-        this.store.set(key instanceof Array ? key.join('.') : key, value);
-        return Promise.resolve();
+    async setMany(entries) {
+        return await tracer.startActiveSpan('kv.set_many', async (span) => {
+            span.setAttribute('kv.count', entries.length);
+            // No native batch primitive in the in-memory store; write each entry sequentially and
+            // assemble a partial-success result mirroring the SDK-backed store's contract.
+            const successes = [];
+            const failures = [];
+            try {
+                for (const entry of entries) {
+                    try {
+                        await this.set(entry.key, entry.value);
+                        successes.push({ ok: true, versionstamp: '', committed: true });
+                    }
+                    catch (error) {
+                        failures.push({
+                            key: entry.key instanceof Array ? entry.key : [entry.key],
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+                return { successes, failures };
+            }
+            finally {
+                span.end();
+            }
+        });
     }
-    delete(key) {
-        this.store.delete(key instanceof Array ? key.join('.') : key);
-        return Promise.resolve();
+    async delete(key) {
+        return await tracer.startActiveSpan('kv.delete', (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                this.store.delete(keyStr);
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     list(prefix, options) {
-        console.log('Listing not implemented', prefix, options);
-        return Promise.reject(new Error('Listing not implemented'));
+        return tracer.startActiveSpan('kv.list', (span) => {
+            span.setAttribute('kv.prefix', prefix.join('.'));
+            console.log('Listing not implemented', prefix, options);
+            const err = new Error('Listing not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
     count(prefix) {
-        console.log('Count not implemented', prefix);
-        return Promise.reject(new Error('Count not implemented'));
+        return tracer.startActiveSpan('kv.count', (span) => {
+            span.setAttribute('kv.prefix', prefix.join('.'));
+            console.log('Count not implemented', prefix);
+            const err = new Error('Count not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
 }