@versori/run 0.7.0-alpha.8 → 0.7.0

package/script/src/kv/nats/NatsKeyValue.js

@@ -11,9 +11,14 @@
  * 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.
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NatsKeyValue = void 0;
 const KVNotFoundError_js_1 = require("../KVNotFoundError.js");
+const api_1 = __importDefault(require("@opentelemetry/api"));
+const tracer = api_1.default.trace.getTracer('versori-run-kv');
 class NatsKeyValue {
     constructor(kv, prefix) {
         Object.defineProperty(this, "kv", {
@@ -30,39 +35,101 @@ 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_js_1.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_js_1.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();
+            }
+        });
+    }
+    setMany(entries) {
+        return tracer.startActiveSpan('kv.set_many', (span) => {
+            span.setAttribute('kv.count', entries.length);
+            console.log('SetMany not implemented', entries.length);
+            const err = new Error('SetMany not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
     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/script/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/script/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/script/src/kv/nats/NatsKeyValueProvider.js

@@ -13,9 +13,10 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NatsKeyValueProvider = void 0;
-const mod_js_1 = require("../../../deps/jsr.io/@nats-io/jetstream/3.3.1/src/mod.js");
-const mod_js_2 = require("../../../deps/jsr.io/@nats-io/kv/3.3.1/src/mod.js");
-const mod_js_3 = require("../../../deps/jsr.io/@nats-io/transport-deno/3.3.1/src/mod.js");
+const mod_js_1 = require("../../../deps/jsr.io/@nats-io/jetstream/3.4.0/src/mod.js");
+const mod_js_2 = require("../../../deps/jsr.io/@nats-io/kv/3.4.0/src/mod.js");
+const mod_js_3 = require("../../../deps/jsr.io/@nats-io/transport-deno/3.4.0/src/mod.js");
+const fingerprintExternalUserId_js_1 = require("../fingerprintExternalUserId.js");
 const isKVOptionsExecution_js_1 = require("../isKVOptionsExecution.js");
 const NatsKeyValue_js_1 = require("./NatsKeyValue.js");
 function getOptionsFromEnv() {
@@ -128,6 +129,10 @@ class NatsKeyValueProvider {
                 return new NatsKeyValue_js_1.NatsKeyValue(this.kvOrgScope, this.subjectPrefix(options));
             case ':project:':
                 return new NatsKeyValue_js_1.NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':workspace:':
+                return new NatsKeyValue_js_1.NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':user:':
+                return new NatsKeyValue_js_1.NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
             case ':execution:':
                 if (!(0, isKVOptionsExecution_js_1.isKVOptionsExecution)(options)) {
                     throw new Error('invalid KV options, executionId is required for :execution: scope');
@@ -178,8 +183,17 @@ 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}.${(0, fingerprintExternalUserId_js_1.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/script/src/kv/sdk/SDKKeyValue.d.ts

@@ -1,17 +1,25 @@
 import { CountKVResponse } from '../../dsl/http/versori/kvapi/models/CountKVResponse.js';
 import { CreateStoreResponse } from '../../dsl/http/versori/kvapi/models/CreateStoreResponse.js';
+import { KVBatchResult } from '../../dsl/http/versori/kvapi/models/KVBatchResult.js';
 import { ListKVRequest } from '../../dsl/http/versori/kvapi/models/ListKVRequest.js';
 import { ListKVResponse } from '../../dsl/http/versori/kvapi/models/ListKVResponse.js';
-import { GetOptions, KeyValue } from '../KeyValue.js';
+import { GetOptions, KeyValue, SetManyEntry } from '../KeyValue.js';
 export declare class SDKKeyValue implements KeyValue {
     private readonly store;
     private readonly prefix;
     constructor(store: CreateStoreResponse, prefix: string);
     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>;
     count(prefix: string[]): Promise<CountKVResponse>;
     list(prefix: string[], options?: ListKVRequest): Promise<ListKVResponse>;
     private generateKey;
+    /**
+     * Removes this store's scope prefix from a key echoed back by the API, yielding the caller-space
+     * key path. The server echoes the fully-prefixed key we sent; if a returned key does not carry our
+     * prefix (an unexpected shape) it is returned unchanged rather than mangled.
+     */
+    private stripPrefix;
 }
 //# sourceMappingURL=SDKKeyValue.d.ts.map

package/script/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":"AAcA,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,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAIvF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKpE,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,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA6CxD,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;IAInB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAStB"}

package/script/src/kv/sdk/SDKKeyValue.js

@@ -11,10 +11,16 @@
  * 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.
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDKKeyValue = void 0;
+const BatchOperationsService_js_1 = require("../../dsl/http/versori/kvapi/services/BatchOperationsService.js");
 const KvOperationsService_js_1 = require("../../dsl/http/versori/kvapi/services/KvOperationsService.js");
 const QueryOperationsService_js_1 = require("../../dsl/http/versori/kvapi/services/QueryOperationsService.js");
+const api_1 = __importDefault(require("@opentelemetry/api"));
+const tracer = api_1.default.trace.getTracer('versori-run-kv');
 class SDKKeyValue {
     constructor(store, prefix) {
         Object.defineProperty(this, "store", {
@@ -31,63 +37,182 @@ class SDKKeyValue {
         });
     }
     async get(key, options = {}) {
-        try {
-            const k = this.generateKey(key instanceof Array ? key.join('/') : key);
-            const entry = await KvOperationsService_js_1.KvOperationsService.getKv(this.store.id, k);
-            if (entry.value === undefined) {
-                if (options.throwOnNotFound) {
-                    throw new Error('Key not found');
+        return await tracer.startActiveSpan('kv.get', async (span) => {
+            const keyStr = key instanceof Array ? key.join('/') : key;
+            span.setAttribute('kv.key', keyStr);
+            span.setAttribute('kv.store_id', this.store.id);
+            try {
+                const k = this.generateKey(keyStr);
+                const entry = await KvOperationsService_js_1.KvOperationsService.getKv(this.store.id, k);
+                if (entry.value === undefined) {
+                    if (options.throwOnNotFound) {
+                        throw new Error('Key not found');
+                    }
+                    return undefined;
                 }
-                return undefined;
+                return JSON.parse(String(entry.value));
             }
-            return JSON.parse(String(entry.value));
-        }
-        catch (error) {
-            if (options.throwOnNotFound && error instanceof Error &&
-                error.message === 'Key not found') {
-                throw new Error('Key not found');
+            catch (error) {
+                if (options.throwOnNotFound && error instanceof Error &&
+                    error.message === 'Key not found') {
+                    throw new Error('Key not found');
+                }
+                else if (!options.throwOnNotFound) {
+                    return undefined;
+                }
+                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');
             }
-            else if (!options.throwOnNotFound) {
-                return undefined;
+            finally {
+                span.end();
             }
-            console.error('Unknown error reading from KV store', error);
-            throw new Error('Unknown error reading from KV store');
-        }
+        });
     }
     async set(key, value) {
-        const payload = JSON.stringify(value);
-        const k = this.generateKey(key instanceof Array ? key.join('/') : key);
-        await KvOperationsService_js_1.KvOperationsService.setKv(this.store.id, k, {
-            value: payload,
-            options: {},
+        return await tracer.startActiveSpan('kv.set', async (span) => {
+            const keyStr = key instanceof Array ? key.join('/') : key;
+            span.setAttribute('kv.key', keyStr);
+            span.setAttribute('kv.store_id', this.store.id);
+            try {
+                const payload = JSON.stringify(value);
+                const k = this.generateKey(keyStr);
+                await KvOperationsService_js_1.KvOperationsService.setKv(this.store.id, k, {
+                    value: payload,
+                    options: {},
+                });
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    async setMany(entries) {
+        return await tracer.startActiveSpan('kv.set_many', async (span) => {
+            span.setAttribute('kv.count', entries.length);
+            span.setAttribute('kv.store_id', this.store.id);
+            // Nothing to write — avoid a pointless round-trip and return an empty result.
+            if (entries.length === 0) {
+                span.end();
+                return { successes: [], failures: [] };
+            }
+            try {
+                // Map each entry into the batch request, applying the scope prefix and JSON-serializing
+                // the value exactly as set() does so batch writes round-trip through get() identically.
+                const batchEntries = entries.map((entry) => ({
+                    key: this.generateKey(entry.key).split('/'),
+                    value: JSON.stringify(entry.value),
+                    options: entry.options,
+                }));
+                const result = await BatchOperationsService_js_1.BatchOperationsService.batchSetKv(this.store.id, {
+                    entries: batchEntries,
+                });
+                // Report failure keys in caller space by stripping the scope prefix we prepended,
+                // matching how set() never exposes the internal prefix. Guard against a malformed key
+                // shape so one odd failure entry can't turn a partial-success response into a rejection.
+                return {
+                    successes: result.successes,
+                    failures: result.failures.map((failure) => ({
+                        ...failure,
+                        key: Array.isArray(failure.key)
+                            ? this.stripPrefix(failure.key)
+                            : failure.key,
+                    })),
+                };
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
         });
     }
     async delete(key) {
-        const k = this.generateKey(key instanceof Array ? key.join('/') : key);
-        await KvOperationsService_js_1.KvOperationsService.deleteKv(this.store.id, k, {
-            options: {},
+        return await tracer.startActiveSpan('kv.delete', async (span) => {
+            const keyStr = key instanceof Array ? key.join('/') : key;
+            span.setAttribute('kv.key', keyStr);
+            span.setAttribute('kv.store_id', this.store.id);
+            try {
+                const k = this.generateKey(keyStr);
+                await KvOperationsService_js_1.KvOperationsService.deleteKv(this.store.id, k, {
+                    options: {},
+                });
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
         });
     }
     async count(prefix) {
-        const k = this.generateKey(prefix).split('/');
-        return await QueryOperationsService_js_1.QueryOperationsService.countKv(this.store.id, {
-            selector: {
-                prefix: k,
-            },
+        return await tracer.startActiveSpan('kv.count', async (span) => {
+            span.setAttribute('kv.prefix', prefix.join('/'));
+            span.setAttribute('kv.store_id', this.store.id);
+            try {
+                const k = this.generateKey(prefix).split('/');
+                return await QueryOperationsService_js_1.QueryOperationsService.countKv(this.store.id, {
+                    selector: {
+                        prefix: k,
+                    },
+                });
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
         });
     }
     async list(prefix, options) {
-        const k = this.generateKey(prefix).split('/');
-        return await QueryOperationsService_js_1.QueryOperationsService.listKv(this.store.id, {
-            selector: {
-                prefix: k,
-                ...options?.selector,
-            },
-            options: options?.options,
+        return await tracer.startActiveSpan('kv.list', async (span) => {
+            span.setAttribute('kv.prefix', prefix.join('/'));
+            span.setAttribute('kv.store_id', this.store.id);
+            try {
+                const k = this.generateKey(prefix).split('/');
+                return await QueryOperationsService_js_1.QueryOperationsService.listKv(this.store.id, {
+                    selector: {
+                        prefix: k,
+                        ...options?.selector,
+                    },
+                    options: options?.options,
+                });
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
         });
     }
     generateKey(key) {
         return `${this.prefix}/${key instanceof Array ? key.join('/') : key}`;
     }
+    /**
+     * Removes this store's scope prefix from a key echoed back by the API, yielding the caller-space
+     * key path. The server echoes the fully-prefixed key we sent; if a returned key does not carry our
+     * prefix (an unexpected shape) it is returned unchanged rather than mangled.
+     */
+    stripPrefix(key) {
+        const prefixSegments = this.prefix.split('/');
+        for (let i = 0; i < prefixSegments.length; i++) {
+            if (key[i] !== prefixSegments[i]) {
+                return key;
+            }
+        }
+        return key.slice(prefixSegments.length);
+    }
 }
 exports.SDKKeyValue = SDKKeyValue;

package/script/src/kv/sdk/SDKKeyValueProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SDKKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValueProvider.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkCvF,MAAM,MAAM,0BAA0B,GAAG;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AA6BF,qBAAa,mBAAoB,YAAW,gBAAgB,EAAE,eAAe;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJzB,OAAO;WAOM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC/C,OAAO,CAAC,mBAAmB,CAAC;IAY/B,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI9C,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":"SDKKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValueProvider.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkCvF,MAAM,MAAM,0BAA0B,GAAG;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AA6BF,qBAAa,mBAAoB,YAAW,gBAAgB,EAAE,eAAe;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJzB,OAAO;WAOM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC/C,OAAO,CAAC,mBAAmB,CAAC;IAY/B,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI9C,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;CAoBxB"}

package/script/src/kv/sdk/SDKKeyValueProvider.js

@@ -15,6 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDKKeyValueProvider = void 0;
 const KvOperationsService_js_1 = require("../../dsl/http/versori/kvapi/services/KvOperationsService.js");
 const StoresService_js_1 = require("../../dsl/http/versori/kvapi/services/StoresService.js");
+const fingerprintExternalUserId_js_1 = require("../fingerprintExternalUserId.js");
 const isKVOptionsExecution_js_1 = require("../isKVOptionsExecution.js");
 const SDKKeyValue_js_1 = require("./SDKKeyValue.js");
 function getOptionsFromEnv() {
@@ -107,6 +108,10 @@ class SDKKeyValueProvider {
                 return new SDKKeyValue_js_1.SDKKeyValue(this.kvOrgScope, this.subjectPrefix(options));
             case ':project:':
                 return new SDKKeyValue_js_1.SDKKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':workspace:':
+                return new SDKKeyValue_js_1.SDKKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':user:':
+                return new SDKKeyValue_js_1.SDKKeyValue(this.kvProjectScope, this.subjectPrefix(options));
             case ':execution:':
                 if (!(0, isKVOptionsExecution_js_1.isKVOptionsExecution)(options)) {
                     throw new Error('invalid KV options, executionId is required for :execution: scope');
@@ -153,6 +158,13 @@ class SDKKeyValueProvider {
                 return `${this.opts.organizationId}/${this.opts.projectId}/${this.opts.environment}${activationSuffix}`;
             case ':execution:':
                 return `${this.opts.organizationId}/${this.opts.projectId}/${this.opts.environment}/${options.executionId}${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}/${(0, fingerprintExternalUserId_js_1.fingerprintExternalUserId)(options.externalUserId)}`;
         }
     }
 }

package/script/src/observability/mod.d.ts

@@ -6,4 +6,5 @@
  * @module
  */
 export * from './logging/mod.js';
+export * from './tracePropagation.js';
 //# sourceMappingURL=mod.d.ts.map

package/script/src/observability/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/observability/mod.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AAEH,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/observability/mod.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}

package/script/src/observability/mod.js

@@ -34,3 +34,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @module
  */
 __exportStar(require("./logging/mod.js"), exports);
+__exportStar(require("./tracePropagation.js"), exports);

package/script/src/observability/tracePropagation.d.ts

@@ -0,0 +1,23 @@
+import { Context } from '@opentelemetry/api';
+/**
+ * Injects the current active OpenTelemetry trace context into the given carrier
+ * using the default W3C trace-context propagator. The returned object will
+ * contain `traceparent` (and optionally `tracestate`) keys that downstream
+ * consumers can use to continue the trace.
+ */
+export declare function injectTraceContext(into?: Record<string, any>): Record<string, any>;
+/**
+ * Extracts an OpenTelemetry trace context from the given carrier (usually a
+ * workflow's metadata containing `traceparent`/`tracestate`). The returned
+ * Context can be passed as the parent context to
+ * `tracer.startActiveSpan(name, options, ctx, fn)` (or to
+ * `opentelemetry.context.with(...)`) so that subsequently created spans are
+ * children of the upstream trace.
+ *
+ * If the carrier has no `traceparent`, the current active context is returned
+ * unchanged - `startActiveSpan` will then create a new root span / new trace,
+ * which is exactly the behaviour we want for workflows submitted without any
+ * upstream trace (e.g. scheduler-triggered submissions).
+ */
+export declare function extractTraceContext(from: Record<string, any> | undefined): Context;
+//# sourceMappingURL=tracePropagation.d.ts.map

package/script/src/observability/tracePropagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracePropagation.d.ts","sourceRoot":"","sources":["../../../src/src/observability/tracePropagation.ts"],"names":[],"mappings":"AAaA,OAAsB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAC/B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAGrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GACtC,OAAO,CAKT"}

package/script/src/observability/tracePropagation.js

@@ -0,0 +1,46 @@
+"use strict";
+/*
+ * 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.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectTraceContext = injectTraceContext;
+exports.extractTraceContext = extractTraceContext;
+const api_1 = __importDefault(require("@opentelemetry/api"));
+/**
+ * Injects the current active OpenTelemetry trace context into the given carrier
+ * using the default W3C trace-context propagator. The returned object will
+ * contain `traceparent` (and optionally `tracestate`) keys that downstream
+ * consumers can use to continue the trace.
+ */
+function injectTraceContext(into = {}) {
+    api_1.default.propagation.inject(api_1.default.context.active(), into);
+    return into;
+}
+/**
+ * Extracts an OpenTelemetry trace context from the given carrier (usually a
+ * workflow's metadata containing `traceparent`/`tracestate`). The returned
+ * Context can be passed as the parent context to
+ * `tracer.startActiveSpan(name, options, ctx, fn)` (or to
+ * `opentelemetry.context.with(...)`) so that subsequently created spans are
+ * children of the upstream trace.
+ *
+ * If the carrier has no `traceparent`, the current active context is returned
+ * unchanged - `startActiveSpan` will then create a new root span / new trace,
+ * which is exactly the behaviour we want for workflows submitted without any
+ * upstream trace (e.g. scheduler-triggered submissions).
+ */
+function extractTraceContext(from) {
+    return api_1.default.propagation.extract(api_1.default.context.active(), from ?? {});
+}

package/script/src/services/platform/generated/core/pathSerializer.gen.d.ts

@@ -19,9 +19,9 @@ type ObjectSeparatorStyle = ObjectStyle | MatrixStyle;
 interface SerializePrimitiveParam extends SerializePrimitiveOptions {
     value: string;
 }
-export declare const separatorArrayExplode: (style: ArraySeparatorStyle) => "," | ";" | "." | "&";
+export declare const separatorArrayExplode: (style: ArraySeparatorStyle) => "." | ";" | "," | "&";
 export declare const separatorArrayNoExplode: (style: ArraySeparatorStyle) => "," | "|" | "%20";
-export declare const separatorObjectExplode: (style: ObjectSeparatorStyle) => "," | ";" | "." | "&";
+export declare const separatorObjectExplode: (style: ObjectSeparatorStyle) => "." | ";" | "," | "&";
 export declare const serializeArrayParam: ({ allowReserved, explode, name, style, value, }: SerializeOptions<ArraySeparatorStyle> & {
     value: unknown[];
 }) => string;