@versori/run 0.4.0-alpha.1 → 0.4.0-alpha.10

package/script/src/internal/InternalAuth.js

@@ -1,6 +1,19 @@
 "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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalAuth = void 0;
+const cli_js_1 = require("./cli.js");
 const constants_js_1 = require("./constants.js");
 class InternalAuth {
     constructor() {
@@ -22,12 +35,24 @@ class InternalAuth {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "runLocal", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "accessToken", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "jwt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "expiresAt", {
             enumerable: true,
             configurable: true,
@@ -37,14 +62,27 @@ class InternalAuth {
         this.clientId = Deno.env.get(constants_js_1.envVarClientId) || '';
         this.clientSecret = Deno.env.get(constants_js_1.envVarClientSecret) || '';
         this.tokenEndpoint = Deno.env.get(constants_js_1.envVarTokenEndpoint) || '';
+        this.jwt = '';
         this.accessToken = '';
         this.expiresAt = 0;
+        this.runLocal = Deno.env.get(constants_js_1.envVarLocalRun) === 'true';
         if (Deno.env.get(constants_js_1.envVarInternalToken)) {
             this.accessToken = Deno.env.get(constants_js_1.envVarInternalToken) || '';
             this.expiresAt = Date.now() + 365 * 24 * 60 * 60 * 1000; // expires in 1 year
             console.log(`Using static token provided by ${constants_js_1.envVarInternalToken}`);
             return;
         }
+        if (Deno.env.get(constants_js_1.envVarJwt)) {
+            this.jwt = Deno.env.get(constants_js_1.envVarJwt) || '';
+            this.expiresAt = Date.now() + 365 * 24 * 60 * 60 * 1000; // expires in 1 year
+            console.log(`Using static JWT provided by ${constants_js_1.envVarJwt}`);
+            return;
+        }
+        if (this.runLocal) {
+            console.info('Running in local mode using cookie for authentication');
+            this.accessToken = (0, cli_js_1.getVersoriCookie)();
+            return;
+        }
         if (!this.clientId || !this.clientSecret || !this.tokenEndpoint) {
             const missingVars = [];
             if (!this.clientId)
@@ -57,9 +95,15 @@ class InternalAuth {
         }
     }
     async getAuthHeader() {
+        if (this.runLocal) {
+            return { 'Cookie': this.accessToken };
+        }
         if (this.accessToken && this.expiresAt > Date.now()) {
             return { 'X-Versori-Internal-Token': this.accessToken };
         }
+        if (this.jwt) {
+            return { 'Authorization': `JWT ${this.jwt}` };
+        }
         const encoded = btoa(`${this.clientId}:${this.clientSecret}`);
         const response = await fetch(this.tokenEndpoint, {
             method: 'POST',

package/script/src/internal/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function getVersoriCookie(): string;
+//# sourceMappingURL=cli.d.ts.map

package/script/src/internal/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/src/internal/cli.ts"],"names":[],"mappings":"AA8BA,wBAAgB,gBAAgB,IAAI,MAAM,CAmBzC"}

package/script/src/internal/cli.js

@@ -0,0 +1,35 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersoriCookie = getVersoriCookie;
+// This file contains functions that can read stuff generated by the Versori CLI. This is used when running locally.
+const node_os_1 = require("node:os");
+const cookiesFileName = 'cookies.json';
+const versoriCookieName = 'versori_sess';
+function getVersoriCookie() {
+    const cookiesFilePath = `${(0, node_os_1.homedir)()}/.config/versori/${cookiesFileName}`;
+    let cookiesFile;
+    try {
+        cookiesFile = JSON.parse(Deno.readTextFileSync(cookiesFilePath));
+    }
+    catch (e) {
+        console.error('Error reading file, have you run the Versori CLI to log in?');
+        throw new Error(`Failed to read or parse cookies file at ${cookiesFilePath}: ${e}`);
+    }
+    const versoriCookie = cookiesFile.cookies.find((cookie) => cookie.Name === versoriCookieName);
+    if (!versoriCookie) {
+        throw new Error(`Cookie 'versori_sess' not found in ${cookiesFilePath}`);
+    }
+    return `${versoriCookieName}=${versoriCookie.Value}`;
+}

package/script/src/internal/constants.d.ts

@@ -10,13 +10,12 @@ export declare const envVarSelfRefURL = "RUN_SELF_REF_URL";
 export declare const envVarCredsBaseURL = "RUN_CREDENTIALS_SERVICE_INTERNAL_URL";
 export declare const envVarOtelTracesURL = "RUN_OTEL_TRACES_URL";
 export declare const envVarVersion = "RUN_SERVICE_VERSION";
-export declare const envReadyCheckURL = "READY_CHECK_URL";
-export declare const envPort = "PORT";
-export declare const envCronPort = "CRON_PORT";
 export declare const envVarConfigFile = "RUN_CONFIG_FILE";
 export declare const envVarClientId = "RUN_CLIENT_ID";
 export declare const envVarClientSecret = "RUN_CLIENT_SECRET";
 export declare const envVarTokenEndpoint = "RUN_TOKEN_ENDPOINT";
 export declare const envVarInternalToken = "RUN_INTERNAL_TOKEN";
+export declare const envVarJwt = "RUN_VERSORI_JWT";
+export declare const envVarLocalRun = "RUN_LOCAL";
 export declare const cronPort = 3001;
 //# sourceMappingURL=constants.d.ts.map

package/script/src/internal/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/src/internal/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AACxE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,aAAa,wBAAwB,CAAC;AACnD,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AACjD,eAAO,MAAM,OAAO,SAAS,CAAC;AAC9B,eAAO,MAAM,WAAW,cAAc,CAAC;AAGvC,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAGlD,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAMxD,eAAO,MAAM,QAAQ,OAAO,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/src/internal/constants.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AACxE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAGlD,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,SAAS,oBAAoB,CAAC;AAG3C,eAAO,MAAM,cAAc,cAAc,CAAC;AAG1C,eAAO,MAAM,QAAQ,OAAO,CAAC"}

package/script/src/internal/constants.js

@@ -1,6 +1,18 @@
 "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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cronPort = exports.envVarInternalToken = exports.envVarTokenEndpoint = exports.envVarClientSecret = exports.envVarClientId = exports.envVarConfigFile = exports.envCronPort = exports.envPort = exports.envReadyCheckURL = exports.envVarVersion = exports.envVarOtelTracesURL = exports.envVarCredsBaseURL = exports.envVarSelfRefURL = exports.envVarSDKApiBaseURL = exports.envVarCronApiBaseURL = exports.envVarPlatformApiBaseURL = exports.envVarOrgSlug = exports.envVarProjectId = exports.envVarEnvironmentName = exports.envVarEnvId = exports.envVarOrgId = void 0;
+exports.cronPort = exports.envVarLocalRun = exports.envVarJwt = exports.envVarInternalToken = exports.envVarTokenEndpoint = exports.envVarClientSecret = exports.envVarClientId = exports.envVarConfigFile = exports.envVarVersion = exports.envVarOtelTracesURL = exports.envVarCredsBaseURL = exports.envVarSelfRefURL = exports.envVarSDKApiBaseURL = exports.envVarCronApiBaseURL = exports.envVarPlatformApiBaseURL = exports.envVarOrgSlug = exports.envVarProjectId = exports.envVarEnvironmentName = exports.envVarEnvId = exports.envVarOrgId = void 0;
 // This file contains constants used in the Versori DSL HTTP client.
 exports.envVarOrgId = 'RUN_ORGANISATION_ID';
 exports.envVarEnvId = 'RUN_ENVIRONMENT_ID';
@@ -14,9 +26,6 @@ exports.envVarSelfRefURL = 'RUN_SELF_REF_URL';
 exports.envVarCredsBaseURL = 'RUN_CREDENTIALS_SERVICE_INTERNAL_URL';
 exports.envVarOtelTracesURL = 'RUN_OTEL_TRACES_URL';
 exports.envVarVersion = 'RUN_SERVICE_VERSION';
-exports.envReadyCheckURL = 'READY_CHECK_URL';
-exports.envPort = 'PORT';
-exports.envCronPort = 'CRON_PORT';
 // The following environment variables are used for the config file
 exports.envVarConfigFile = 'RUN_CONFIG_FILE';
 // The following environment variables are used for internal authentication
@@ -24,7 +33,8 @@ exports.envVarClientId = 'RUN_CLIENT_ID';
 exports.envVarClientSecret = 'RUN_CLIENT_SECRET';
 exports.envVarTokenEndpoint = 'RUN_TOKEN_ENDPOINT';
 exports.envVarInternalToken = 'RUN_INTERNAL_TOKEN';
+exports.envVarJwt = 'RUN_VERSORI_JWT';
 // The following are for running locally
-// export const envVarLocalRun = 'RUN_LOCAL';
+exports.envVarLocalRun = 'RUN_LOCAL';
 // please no changerino
 exports.cronPort = 3001; // The port on which the cron API communicates with the service

package/script/src/interpreter/durable/DurableInterpreter.d.ts

@@ -3,27 +3,39 @@ import { NodeSDK } from '@opentelemetry/sdk-node';
 import { Router } from 'express';
 import { Observable, Subscription } from 'rxjs';
 import { DirectConnectionFactory } from '../../connection/DirectConnectionFactory.js';
+import { ContextImpl } from '../../context/Context.js';
 import { ContextProvider } from '../../context/ContextProvider.js';
 import { ConfigReader, CronProvider } from '../../dsl/http/types.js';
 import { Workflow } from '../../dsl/Workflow.js';
 import { IssueAPI } from '../../issues/Issues.js';
-import { ContextImpl, ContextOperatorFunction } from '../../mod.js';
 import { Logger } from '../../observability/logging/Logger.js';
 import { PlatformApi } from '../../services/platform/PlatformApi.js';
+import { ContextOperatorFunction } from './compilers/types.js';
 import { ObservableCompiler } from './ObservableCompiler.js';
 import { QueueAPI } from './Queue.js';
-declare global {
-    namespace Express {
-        interface Request {
-            rawBody: Uint8Array;
-        }
-    }
-}
+/**
+ * DurableInterpreterOptions configures the behavior of the {@link DurableInterpreter}.
+ */
 export type DurableInterpreterOptions = {
+    /**
+     * Custom logger instance. Defaults to ConsoleLogger.
+     */
     logger?: Logger;
+    /**
+     * Custom compiler for workflow execution. Advanced use only.
+     */
     compiler?: ObservableCompiler;
+    /**
+     * Custom context provider. Advanced use only.
+     */
     contextProvider?: ContextProvider;
+    /**
+     * Abort signal to cancel workflow execution.
+     */
     signal?: AbortSignal;
+    /**
+     * Skip loading Versori credentials. Useful for local development.
+     */
     skipVersoriCredentials?: boolean;
 };
 type Registration = {
@@ -33,19 +45,37 @@ type Registration = {
     sigintListener: () => void;
     subscription?: Subscription;
 };
-type WebhookRegistry = Map<string, {
-    method: string;
-    path: string;
-    options: any;
-}>;
+/**
+ * DurableInterpreter is an interpreter for executing Versori workflows with support for durable, queue-based workflow
+ * execution. It supports all trigger types including the {@link workflow} trigger which allows workflows to be started
+ * programmatically.
+ *
+ * Unlike {@link MemoryInterpreter}, this interpreter provides durability and retry capabilities through a queue-based
+ * architecture. Workflows started with `ctx.start()` are queued and executed asynchronously with configurable retry
+ * policies.
+ *
+ * @example
+ * ```typescript
+ * import { DurableInterpreter, workflow, fn } from '@versori/run';
+ *
+ * const processJob = workflow('process-job', { maxAttempts: 3 })
+ *   .then(fn('task', async (ctx) => {
+ *     ctx.log.info('Processing job', { data: ctx.data });
+ *     // ... long-running process
+ *   }));
+ *
+ * const interpreter = new DurableInterpreter();
+ * interpreter.register(processJob);
+ * await interpreter.start();
+ * ```
+ */
 export declare class DurableInterpreter {
     private readonly log;
     private readonly compiler;
     private readonly contextProvider;
     private readonly webhookRouter;
     private readonly cronRouter;
-    private cronRegistry;
-    private webhookRegistry;
+    private readonly cronRegistry;
     private readonly platformApi;
     private readonly cnxFetchFactory;
     private readonly cronProvider;
@@ -59,7 +89,7 @@ export declare class DurableInterpreter {
     private cronServer?;
     private shutdownServer?;
     private isShuttingDown;
-    constructor(log: Logger, compiler: ObservableCompiler, contextProvider: ContextProvider, webhookRouter: Router, cronRouter: Router, cronRegistry: Map<string, string>, webhookRegistry: WebhookRegistry, platformApi: PlatformApi, cnxFetchFactory: DirectConnectionFactory, cronProvider: CronProvider, tracer: Tracer, issue: IssueAPI, cfgReader: ConfigReader, queueProvider: QueueAPI, otelSDK?: NodeSDK | undefined);
+    constructor(log: Logger, compiler: ObservableCompiler, contextProvider: ContextProvider, webhookRouter: Router, cronRouter: Router, cronRegistry: Map<string, string>, platformApi: PlatformApi, cnxFetchFactory: DirectConnectionFactory, cronProvider: CronProvider, tracer: Tracer, issue: IssueAPI, cfgReader: ConfigReader, queueProvider: QueueAPI, otelSDK?: NodeSDK | undefined);
     static newInstance(options?: DurableInterpreterOptions): Promise<DurableInterpreter>;
     register<O>(workflow: Workflow<O>, options?: DurableInterpreterOptions): Registration;
     start(): Promise<void>;

package/script/src/interpreter/durable/DurableInterpreter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DurableInterpreter.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/durable/DurableInterpreter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DurableInterpreter.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/durable/DurableInterpreter.ts"],"names":[],"mappings":"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"}

package/script/src/interpreter/durable/DurableInterpreter.js

@@ -1,4 +1,16 @@
 "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 };
 };
@@ -10,14 +22,13 @@ const resources_1 = require("@opentelemetry/resources");
 const sdk_node_1 = require("@opentelemetry/sdk-node");
 const express_1 = __importDefault(require("express"));
 const rxjs_1 = require("rxjs");
+const CredentialsProvider_js_1 = require("../../connection/CredentialsProvider.js");
 const DirectConnectionFactory_js_1 = require("../../connection/DirectConnectionFactory.js");
 const ContextProvider_js_1 = require("../../context/ContextProvider.js");
-const default_js_1 = require("../../dsl/http/default.js");
 const configloader_js_1 = require("../../dsl/http/versori/configloader.js");
+const constants_js_1 = require("../../dsl/http/versori/constants.js");
 const cronapi_js_1 = require("../../dsl/http/versori/cronapi.js");
 const Workflow_js_1 = require("../../dsl/Workflow.js");
-const constants_js_1 = require("../../internal/constants.js");
-const supervisor_js_1 = require("../../internal/supervisor.js");
 const Issues_js_1 = require("../../issues/Issues.js");
 const MemoryKeyValueProvider_js_1 = require("../../kv/memory/MemoryKeyValueProvider.js");
 const SDKKeyValueProvider_js_1 = require("../../kv/sdk/SDKKeyValueProvider.js");
@@ -25,18 +36,38 @@ const ConsoleLogger_js_1 = require("../../observability/logging/ConsoleLogger.js
 const PlatformApi_js_1 = require("../../services/platform/PlatformApi.js");
 const ObservableCompiler_js_1 = require("./ObservableCompiler.js");
 const Queue_js_1 = require("./Queue.js");
-function getKVProvider() {
-    if (supervisor_js_1.enabled) {
+function getKVProvider(runLocal) {
+    if (runLocal) {
         return Promise.resolve(new MemoryKeyValueProvider_js_1.MemoryKeyValueProvider());
     }
     return SDKKeyValueProvider_js_1.SDKKeyValueProvider.fromEnv();
 }
-function getRoundTripperFactory(log) {
-    log.info('Running with default round tripper factory');
-    return new default_js_1.DefaultRoundTripperFactory();
-}
+/**
+ * DurableInterpreter is an interpreter for executing Versori workflows with support for durable, queue-based workflow
+ * execution. It supports all trigger types including the {@link workflow} trigger which allows workflows to be started
+ * programmatically.
+ *
+ * Unlike {@link MemoryInterpreter}, this interpreter provides durability and retry capabilities through a queue-based
+ * architecture. Workflows started with `ctx.start()` are queued and executed asynchronously with configurable retry
+ * policies.
+ *
+ * @example
+ * ```typescript
+ * import { DurableInterpreter, workflow, fn } from '@versori/run';
+ *
+ * const processJob = workflow('process-job', { maxAttempts: 3 })
+ *   .then(fn('task', async (ctx) => {
+ *     ctx.log.info('Processing job', { data: ctx.data });
+ *     // ... long-running process
+ *   }));
+ *
+ * const interpreter = new DurableInterpreter();
+ * interpreter.register(processJob);
+ * await interpreter.start();
+ * ```
+ */
 class DurableInterpreter {
-    constructor(log, compiler, contextProvider, webhookRouter, cronRouter, cronRegistry, webhookRegistry, platformApi, cnxFetchFactory, cronProvider, tracer, issue, cfgReader, queueProvider, otelSDK) {
+    constructor(log, compiler, contextProvider, webhookRouter, cronRouter, cronRegistry, platformApi, cnxFetchFactory, cronProvider, tracer, issue, cfgReader, queueProvider, otelSDK) {
         Object.defineProperty(this, "log", {
             enumerable: true,
             configurable: true,
@@ -73,12 +104,6 @@ class DurableInterpreter {
             writable: true,
             value: cronRegistry
         });
-        Object.defineProperty(this, "webhookRegistry", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: webhookRegistry
-        });
         Object.defineProperty(this, "platformApi", {
             enumerable: true,
             configurable: true,
@@ -168,15 +193,16 @@ class DurableInterpreter {
         const compiler = options.compiler || new ObservableCompiler_js_1.ObservableCompiler();
         const serviceName = Deno.env.get(constants_js_1.envVarProjectId) || 'example-service';
         const environmentID = Deno.env.get(constants_js_1.envVarEnvId) || 'development';
-        const serviceId = Deno.env.get(constants_js_1.envVarProjectId) || 'development';
+        const _serviceId = Deno.env.get(constants_js_1.envVarProjectId) || 'development';
         const version = Deno.env.get(constants_js_1.envVarVersion) || '1.0.0';
         const environment = Deno.env.get(constants_js_1.envVarEnvironmentName) || 'development';
-        const sdkAPIBaseURL = Deno.env.get(constants_js_1.envVarSDKApiBaseURL) || 'http://localhost:8902';
+        const _sdkAPIBaseURL = Deno.env.get(constants_js_1.envVarSDKApiBaseURL) || 'http://localhost:8902';
         const orgId = Deno.env.get(constants_js_1.envVarOrgId) || 'development';
         const orgSlug = Deno.env.get(constants_js_1.envVarOrgSlug) || 'development';
         const otelTracesURL = Deno.env.get(constants_js_1.envVarOtelTracesURL);
         let otelSDK;
         const configReader = configloader_js_1.VersoriConfigReader.fromEnv(log);
+        const runLocal = Deno.env.get(constants_js_1.envVarLocalRun) === 'true';
         await waitForReady(log);
         // Do NOT change those attributes, they are used by the API to filter on
         const resource = (0, resources_1.resourceFromAttributes)({
@@ -198,30 +224,21 @@ class DurableInterpreter {
             log.info('Starting OpenTelemetry SDK');
             otelSDK.start();
         }
-        else if (supervisor_js_1.enabled) {
-            otelSDK = new sdk_node_1.NodeSDK({
-                traceExporter: new supervisor_js_1.Fake(),
-                serviceName: serviceName,
-                resource: resource,
-            });
-            log.info('Starting Testing OpenTelemetry SDK');
-            otelSDK.start();
-        }
         const tracer = api_1.default.trace.getTracer(serviceName, version);
-        const roundTripperFactory = getRoundTripperFactory(log);
         const queueProvider = await Queue_js_1.QueueImpl.fromEnv(log);
+        const connectionFactory = DirectConnectionFactory_js_1.DirectConnectionFactory.fromEnv(log);
         const issuesProvider = new Issues_js_1.IssueImpl(log);
         if (options.contextProvider) {
             // no need to set up a key-value provider if options.contextProvider is already
             // initialised.
-            return new DurableInterpreter(log, compiler, options.contextProvider, express_1.default.Router(), express_1.default.Router(), new Map(), new Map(), PlatformApi_js_1.PlatformApiImpl.fromEnv(), DirectConnectionFactory_js_1.DirectConnectionFactory.fromEnv(log), cronapi_js_1.CronAPIClient.fromEnv(), tracer, issuesProvider, configReader, queueProvider, otelSDK);
+            return new DurableInterpreter(log, compiler, options.contextProvider, express_1.default.Router(), express_1.default.Router(), new Map(), PlatformApi_js_1.PlatformApiImpl.fromEnv(), connectionFactory, cronapi_js_1.CronAPIClient.fromEnv(), tracer, issuesProvider, configReader, queueProvider, otelSDK);
         }
-        const kvp = await getKVProvider();
+        const kvp = await getKVProvider(runLocal);
         const platformApi = PlatformApi_js_1.PlatformApiImpl.fromEnv();
         const organisationId = Deno.env.get(constants_js_1.envVarOrgId) || 'development';
         const environmentId = Deno.env.get(constants_js_1.envVarEnvId) || 'development';
-        const ctxProvider = new ContextProvider_js_1.ContextProviderImpl(log, kvp, roundTripperFactory.credentials(), platformApi, organisationId, environmentId, issuesProvider);
-        return new DurableInterpreter(log, compiler, ctxProvider, express_1.default.Router(), express_1.default.Router(), new Map(), new Map(), PlatformApi_js_1.PlatformApiImpl.fromEnv(), DirectConnectionFactory_js_1.DirectConnectionFactory.fromEnv(log), cronapi_js_1.CronAPIClient.fromEnv(), tracer, issuesProvider, configReader, queueProvider, otelSDK);
+        const ctxProvider = new ContextProvider_js_1.ContextProviderImpl(log, kvp, new CredentialsProvider_js_1.CredentialsProviderImpl(connectionFactory.credentials, connectionFactory.tokens, connectionFactory.oauth1, configReader, platformApi), platformApi, organisationId, environmentId, issuesProvider, queueProvider);
+        return new DurableInterpreter(log, compiler, ctxProvider, express_1.default.Router(), express_1.default.Router(), new Map(), PlatformApi_js_1.PlatformApiImpl.fromEnv(), connectionFactory, cronapi_js_1.CronAPIClient.fromEnv(), tracer, issuesProvider, configReader, queueProvider, otelSDK);
     }
     register(workflow, options) {
         const localAbortController = new AbortController();
@@ -238,7 +255,6 @@ class DurableInterpreter {
             tracer: this.tracer,
             contextProvider: this.contextProvider,
             webhookRouter: this.webhookRouter,
-            webhookRegistry: this.webhookRegistry,
             queueProvider: this.queueProvider,
             cronRouter: this.cronRouter,
             cronRegistry: this.cronRegistry,
@@ -262,9 +278,9 @@ class DurableInterpreter {
         this.registeredWorkflows.push(registration);
         return registration;
     }
-    async start() {
-        const port = Deno.env.get(constants_js_1.envPort) || 3000;
-        const cronPort = Deno.env.get(constants_js_1.envCronPort) || 3001;
+    start() {
+        const port = Deno.env.get('PORT') || 3000;
+        const cronPort = Deno.env.get('CRON_PORT') || 3001;
         const webhookApp = (0, express_1.default)();
         const cronApp = (0, express_1.default)();
         cronApp.use(express_1.default.json());
@@ -288,17 +304,11 @@ class DurableInterpreter {
                 ctx.log.error('DurableInterpreter.executionError', {
                     error: err instanceof Error ? err.toString() : err,
                 });
-                this.tracer.startActiveSpan('done', (span) => {
-                    span.setAttribute('error.message', err instanceof Error ? err.toString() : err);
-                    span.setAttribute('execution.id', ctx.executionId);
-                    span.setAttribute('result', 'fail');
-                    span.end();
-                });
                 try {
                     ctx.options.onError?.(ctx.withData(err));
                 }
                 catch (err) {
-                    ctx.log.error('DurableInterpreter.onError Error: failed to call onError handler', { error: err instanceof Error ? err.toString() : err });
+                    ctx.log.error('DurableInterpreter.onErrorError: failed to call onError handler', { error: err instanceof Error ? err.toString() : err });
                     ctx.options.onError?.(ctx.withData({
                         message: 'Internal server error',
                         error: err instanceof Error ? err.toString() : err,
@@ -307,16 +317,10 @@ class DurableInterpreter {
                 return rxjs_1.EMPTY;
             }))))
                 .subscribe({
-                next: async (ctx) => {
+                next: (ctx) => {
                     const durationMs = Date.now() - ctx.startTime.getTime();
                     ctx.log.info('DurableInterpreter.executionCompleted', {
                         durationMs,
-                        data: ctx.data,
-                    });
-                    this.tracer.startActiveSpan('done', (span) => {
-                        span.setAttribute('execution.id', ctx.executionId);
-                        span.setAttribute('result', 'pass');
-                        span.end();
                     });
                     try {
                         ctx.options.onSuccess?.(ctx);
@@ -328,17 +332,6 @@ class DurableInterpreter {
                             error: err instanceof Error ? err.toString() : err,
                         }));
                     }
-                    if (ctx.workflowId) {
-                        this.log.info('Async workflow completed', {
-                            workflowId: ctx.workflowId,
-                        });
-                        const output = ctx.data ? btoa(JSON.stringify(ctx.data)) : undefined;
-                        await ctx.queue?.complete({
-                            id: ctx.workflowId,
-                            output,
-                            status: 'completed',
-                        });
-                    }
                     this.contextProvider.destroy(ctx);
                 },
                 error: (err) => {
@@ -365,9 +358,6 @@ class DurableInterpreter {
             });
             throw new Error('Unable to register scheduler tasks with central cron provider');
         }
-        // register with supervisor
-        await (0, supervisor_js_1.registerCrons)(this.cronRegistry);
-        await (0, supervisor_js_1.registerWebhooks)(this.webhookRegistry);
         this.webhookServer = webhookApp.listen(port, () => {
             this.log.info(`Express server listening on port ${port}`);
         });
@@ -387,7 +377,6 @@ class DurableInterpreter {
             if (this.cronServer) {
                 this.cronServer.close();
             }
-            this.otelSDK?.shutdown();
             // Remove all signal listeners
             for (const registration of this.registeredWorkflows) {
                 Deno.removeSignalListener('SIGINT', registration.sigintListener);
@@ -431,16 +420,17 @@ class DurableInterpreter {
             }
         });
     }
-    async stop() {
+    stop() {
         this.otelSDK?.shutdown();
         if (this.shutdownServer) {
             this.shutdownServer();
         }
+        return Promise.resolve();
     }
 }
 exports.DurableInterpreter = DurableInterpreter;
 async function waitForReady(log) {
-    const readyCheckUrl = Deno.env.get(constants_js_1.envReadyCheckURL);
+    const readyCheckUrl = Deno.env.get('READY_CHECK_URL');
     if (!readyCheckUrl) {
         return Promise.resolve();
     }

package/script/src/interpreter/durable/ExecutionError.d.ts

@@ -1,6 +1,23 @@
 import { Context } from '../../context/Context.js';
+/**
+ * ExecutionError wraps errors that occur during durable workflow execution, providing access to the context at the
+ * time of the error. This is used with the {@link DurableInterpreter}.
+ *
+ * Note: When using the {@link MemoryInterpreter}, errors in `.catch()` handlers will be instances of the regular
+ * `ExecutionError` instead.
+ */
 export declare class ExecutionError extends Error {
+    /**
+     * The workflow context at the time the error occurred.
+     */
     ctx: Context<any>;
+    /**
+     * Create a new ExecutionError.
+     *
+     * @param ctx The workflow context at the time of the error.
+     * @param message The error message.
+     * @param opts Optional error options.
+     */
     constructor(ctx: Context<any>, message: string, opts?: ErrorOptions);
     toJSON(): {
         name: string;

package/script/src/interpreter/durable/ExecutionError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionError.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/durable/ExecutionError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,qBAAa,cAAe,SAAQ,KAAK;IACrC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBAEN,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAOnE,MAAM;;;;CAMT"}
+{"version":3,"file":"ExecutionError.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/durable/ExecutionError.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACrC;;OAEG;IACH,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAElB;;;;;;OAMG;gBACS,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAOnE,MAAM;;;;CAMT"}

package/script/src/interpreter/durable/ExecutionError.js

@@ -1,9 +1,38 @@
 "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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExecutionError = void 0;
+/**
+ * ExecutionError wraps errors that occur during durable workflow execution, providing access to the context at the
+ * time of the error. This is used with the {@link DurableInterpreter}.
+ *
+ * Note: When using the {@link MemoryInterpreter}, errors in `.catch()` handlers will be instances of the regular
+ * `ExecutionError` instead.
+ */
 class ExecutionError extends Error {
+    /**
+     * Create a new ExecutionError.
+     *
+     * @param ctx The workflow context at the time of the error.
+     * @param message The error message.
+     * @param opts Optional error options.
+     */
     constructor(ctx, message, opts) {
         super(message, opts);
+        /**
+         * The workflow context at the time the error occurred.
+         */
         Object.defineProperty(this, "ctx", {
             enumerable: true,
             configurable: true,