@versori/run 0.7.0-alpha.9 → 1.0.0-alpha.2

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

@@ -67,10 +67,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 +82,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 +92,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":"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;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEtG;;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;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,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"}

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.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,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACH,eAAe,EACf,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,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,79 @@ 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();
+            }
+        });
     }
-    set(key, value) {
-        this.store.set(key instanceof Array ? key.join('.') : key, value);
-        return Promise.resolve();
+    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();
+            }
+        });
     }
-    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);
+        });
     }
 }

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

@@ -2,8 +2,12 @@ import { DestroyOptions, KeyValue, KeyValueProvider, KVOptions } from '../KeyVal
 export declare class MemoryKeyValueProvider implements KeyValueProvider {
     private executionKv;
     private projectKv;
+    private workspaceKv;
+    private organizationKv;
+    private userKv;
     kv(options: KVOptions): KeyValue;
     destroy(options: DestroyOptions): Promise<void>;
     private getExecutionKv;
+    private getUserKv;
 }
 //# sourceMappingURL=MemoryKeyValueProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MemoryKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValueProvider.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGvF,qBAAa,sBAAuB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,SAAS,CAAkC;IAEnD,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAehC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,OAAO,CAAC,cAAc;CAUzB"}
+{"version":3,"file":"MemoryKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValueProvider.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGvF,qBAAa,sBAAuB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,MAAM,CAAoC;IAElD,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAyBhC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/C,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,SAAS;CAUpB"}

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

@@ -25,6 +25,24 @@ export class MemoryKeyValueProvider {
             writable: true,
             value: new MemoryKeyValue()
         });
+        Object.defineProperty(this, "workspaceKv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new MemoryKeyValue()
+        });
+        Object.defineProperty(this, "organizationKv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new MemoryKeyValue()
+        });
+        Object.defineProperty(this, "userKv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
     }
     kv(options) {
         switch (options.scope) {
@@ -35,6 +53,15 @@ export class MemoryKeyValueProvider {
                 return this.getExecutionKv(options.executionId);
             case ':project:':
                 return this.projectKv;
+            case ':workspace:':
+                return this.workspaceKv;
+            case ':organization:':
+                return this.organizationKv;
+            case ':user:':
+                if (typeof options.externalUserId === 'undefined') {
+                    throw new Error('externalUserId is required when scope is :user:');
+                }
+                return this.getUserKv(options.externalUserId);
             default:
                 throw new Error(`Unsupported scope: ${options.scope}`);
         }
@@ -47,6 +74,21 @@ export class MemoryKeyValueProvider {
                 }
                 this.executionKv.delete(options.executionId);
                 return Promise.resolve();
+            case ':project:':
+                this.projectKv = new MemoryKeyValue();
+                return Promise.resolve();
+            case ':workspace:':
+                this.workspaceKv = new MemoryKeyValue();
+                return Promise.resolve();
+            case ':organization:':
+                this.organizationKv = new MemoryKeyValue();
+                return Promise.resolve();
+            case ':user:':
+                if (typeof options.externalUserId === 'undefined') {
+                    throw new Error('externalUserId is required when scope is :user:');
+                }
+                this.userKv.delete(options.externalUserId);
+                return Promise.resolve();
             default:
                 return Promise.resolve();
         }
@@ -59,4 +101,12 @@ export class MemoryKeyValueProvider {
         }
         return kv;
     }
+    getUserKv(externalUserId) {
+        let kv = this.userKv.get(externalUserId);
+        if (!kv) {
+            kv = new MemoryKeyValue();
+            this.userKv.set(externalUserId, kv);
+        }
+        return kv;
+    }
 }

package/esm/src/kv/nats/NatsKeyValue.d.ts

@@ -1,4 +1,4 @@
-import { KV } from '../../../deps/jsr.io/@nats-io/kv/3.3.1/src/mod.js';
+import { KV } from '../../../deps/jsr.io/@nats-io/kv/3.4.0/src/mod.js';
 import { GetOptions, KeyValue } from '../KeyValue.js';
 import { CountKVResponse, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
 export declare class NatsKeyValue implements KeyValue {

package/esm/src/kv/nats/NatsKeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NatsKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,EAAE,EAAW,MAAM,mDAAmD,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACH,eAAe,EACf,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAE/C,qBAAa,YAAa,YAAW,QAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAM,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAA/B,EAAE,EAAE,EAAE,EAAmB,MAAM,EAAE,MAAM;IAE9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAwBnF,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;IAInD,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;IAKjD,OAAO,CAAC,WAAW;CAGtB"}
+{"version":3,"file":"NatsKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,EAAE,EAAW,MAAM,mDAAmD,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACH,eAAe,EACf,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAK/C,qBAAa,YAAa,YAAW,QAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAM,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAA/B,EAAE,EAAE,EAAE,EAAmB,MAAM,EAAE,MAAM;IAE9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAqCnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD,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;IAYjD,OAAO,CAAC,WAAW;CAGtB"}

package/esm/src/kv/nats/NatsKeyValue.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 NatsKeyValue {
     constructor(kv, prefix) {
         Object.defineProperty(this, "kv", {
@@ -27,39 +29,91 @@ export class NatsKeyValue {
         });
     }
     async get(key, options = {}) {
-        let entry;
-        try {
-            entry = await this.kv.get(this.generateKey(key instanceof Array ? key.join('.') : key));
-        }
-        catch (error) {
-            console.error('Unknown error reading from KV store', error);
-            throw new Error('Unknown error reading from KV store');
-        }
-        if (!entry || ['DEL', 'PURGE'].includes(entry.operation)) {
-            if (options.throwOnNotFound) {
-                throw new KVNotFoundError(key instanceof Array ? key.join('.') : key);
+        return await tracer.startActiveSpan('kv.get', async (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                let entry;
+                try {
+                    entry = await this.kv.get(this.generateKey(keyStr));
+                }
+                catch (error) {
+                    span.recordException(error instanceof Error ? error : new Error(String(error)));
+                    console.error('Unknown error reading from KV store', error);
+                    throw new Error('Unknown error reading from KV store');
+                }
+                if (!entry || ['DEL', 'PURGE'].includes(entry.operation)) {
+                    if (options.throwOnNotFound) {
+                        throw new KVNotFoundError(keyStr);
+                    }
+                    else if (typeof options.defaultValue !== 'undefined') {
+                        return options.defaultValue;
+                    }
+                    return undefined;
+                }
+                return entry.json();
             }
-            else if (typeof options.defaultValue !== 'undefined') {
-                return options.defaultValue;
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
             }
-            return undefined;
-        }
-        return entry.json();
+            finally {
+                span.end();
+            }
+        });
     }
     async set(key, value) {
-        const payload = JSON.stringify(value);
-        await this.kv.put(this.generateKey(key instanceof Array ? key.join('.') : key), payload);
+        return await tracer.startActiveSpan('kv.set', async (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                const payload = JSON.stringify(value);
+                await this.kv.put(this.generateKey(keyStr), payload);
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     async delete(key) {
-        await this.kv.delete(this.generateKey(key instanceof Array ? key.join('.') : key));
+        return await tracer.startActiveSpan('kv.delete', async (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                await this.kv.delete(this.generateKey(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);
+        });
     }
     generateKey(key) {
         return `${this.prefix}.${key instanceof Array ? key.join('.') : key}`;

package/esm/src/kv/nats/NatsKeyValueProvider.d.ts

@@ -1,4 +1,4 @@
-import { TlsOptions } from '../../../deps/jsr.io/@nats-io/transport-deno/3.3.1/src/mod.js';
+import { TlsOptions } from '../../../deps/jsr.io/@nats-io/transport-deno/3.4.0/src/mod.js';
 import { DestroyOptions, KeyValue, KeyValueProvider, KVOptions } from '../KeyValue.js';
 export type NatsKeyValueProviderOptions = {
     organizationId: string;

package/esm/src/kv/nats/NatsKeyValueProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NatsKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValueProvider.ts"],"names":[],"mappings":"AAeA,OAAO,EAA+B,UAAU,EAAE,MAAM,+DAA+D,CAAC;AAExH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA4CvF,MAAM,MAAM,2BAA2B,GAAG;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC;CACL,CAAC;AAuBF,qBAAa,oBAAqB,YAAW,gBAAgB,EAAE,eAAe;IAEtE,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IALzB,OAAO;WAQM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,2BAA2B,CAAM,GAChD,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI/C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAI1C,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAqB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrD,OAAO,CAAC,aAAa;CAYxB"}
+{"version":3,"file":"NatsKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValueProvider.ts"],"names":[],"mappings":"AAeA,OAAO,EAA+B,UAAU,EAAE,MAAM,+DAA+D,CAAC;AAGxH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA4CvF,MAAM,MAAM,2BAA2B,GAAG;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC;CACL,CAAC;AAuBF,qBAAa,oBAAqB,YAAW,gBAAgB,EAAE,eAAe;IAEtE,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IALzB,OAAO;WAQM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,2BAA2B,CAAM,GAChD,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI/C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAI1C,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAyB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrD,OAAO,CAAC,aAAa;CAsBxB"}

package/esm/src/kv/nats/NatsKeyValueProvider.js

@@ -10,9 +10,10 @@
  * 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 { JetStreamApiCodes, JetStreamApiError } from '../../../deps/jsr.io/@nats-io/jetstream/3.3.1/src/mod.js';
-import { Kvm } from '../../../deps/jsr.io/@nats-io/kv/3.3.1/src/mod.js';
-import { connect, credsAuthenticator } from '../../../deps/jsr.io/@nats-io/transport-deno/3.3.1/src/mod.js';
+import { JetStreamApiCodes, JetStreamApiError } from '../../../deps/jsr.io/@nats-io/jetstream/3.4.0/src/mod.js';
+import { Kvm } from '../../../deps/jsr.io/@nats-io/kv/3.4.0/src/mod.js';
+import { connect, credsAuthenticator } from '../../../deps/jsr.io/@nats-io/transport-deno/3.4.0/src/mod.js';
+import { fingerprintExternalUserId } from '../fingerprintExternalUserId.js';
 import { isKVOptionsExecution } from '../isKVOptionsExecution.js';
 import { NatsKeyValue } from './NatsKeyValue.js';
 function getOptionsFromEnv() {
@@ -125,6 +126,10 @@ export class NatsKeyValueProvider {
                 return new NatsKeyValue(this.kvOrgScope, this.subjectPrefix(options));
             case ':project:':
                 return new NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':workspace:':
+                return new NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':user:':
+                return new NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
             case ':execution:':
                 if (!isKVOptionsExecution(options)) {
                     throw new Error('invalid KV options, executionId is required for :execution: scope');
@@ -175,8 +180,17 @@ export class NatsKeyValueProvider {
                 return `${this.opts.organizationId}`;
             case ':project:':
                 return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}${activationSuffix}`;
+            case ':workspace:':
+                return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}`;
+            case ':user:':
+                if (typeof options.externalUserId === 'undefined') {
+                    throw new Error('externalUserId is required when scope is :user:');
+                }
+                return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}.${fingerprintExternalUserId(options.externalUserId)}`;
             case ':execution:':
                 return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}.${options.executionId}${activationSuffix}`;
+            default:
+                throw new Error(`Unsupported scope for subjectPrefix: ${options.scope}`);
         }
     }
 }

package/esm/src/kv/sdk/SDKKeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SDKKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4DAA4D,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAGvF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,qBAAa,WAAY,YAAW,QAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAuB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAnD,KAAK,EAAE,mBAAmB,EAAmB,MAAM,EAAE,MAAM;IAElF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA8BnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAUjD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAY9E,OAAO,CAAC,WAAW;CAGtB"}
+{"version":3,"file":"SDKKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4DAA4D,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAGvF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAKtD,qBAAa,WAAY,YAAW,QAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAuB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAnD,KAAK,EAAE,mBAAmB,EAAmB,MAAM,EAAE,MAAM;IAElF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAuCnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBjD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB9E,OAAO,CAAC,WAAW;CAGtB"}