@versori/run 0.7.0-alpha.3 → 0.7.0-alpha.5

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

@@ -13,4 +13,5 @@
  */
 export * from './memory/mod.js';
 export * as durable from './durable/mod.js';
+export * as vanilla from './vanilla/mod.js';
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/interpreter/mod.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/interpreter/mod.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC"}

package/script/src/interpreter/mod.js

@@ -38,7 +38,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.durable = void 0;
+exports.vanilla = exports.durable = void 0;
 /**
  * The interpreter module provides the functionality for registering and executing workflows.
  *
@@ -54,3 +54,4 @@ exports.durable = void 0;
  */
 __exportStar(require("./memory/mod.js"), exports);
 exports.durable = __importStar(require("./durable/mod.js"));
+exports.vanilla = __importStar(require("./vanilla/mod.js"));

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

@@ -0,0 +1,27 @@
+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;
+        message: string;
+    };
+}
+//# sourceMappingURL=ExecutionError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionError.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/vanilla/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/vanilla/ExecutionError.js

@@ -0,0 +1,52 @@
+"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,
+            writable: true,
+            value: void 0
+        });
+        this.name = 'ExecutionError';
+        this.ctx = ctx;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+        };
+    }
+}
+exports.ExecutionError = ExecutionError;

package/script/src/interpreter/vanilla/ObservableCompiler.d.ts

@@ -0,0 +1,38 @@
+import { Tracer } from '@opentelemetry/api';
+import { Router } from 'express';
+import { Observable, OperatorFunction } from 'rxjs';
+import { ConfigReader } from '../../dsl/http/types.js';
+import { Task } from '../../dsl/Task.js';
+import { Trigger } from '../../dsl/Trigger.js';
+import { Logger } from '../../observability/logging/Logger.js';
+import { ContextOperatorFunction, TaskCompiler, TriggerCompiler } from './compilers/types.js';
+import { QueueAPI } from './Queue.js';
+import { ConnectionFactory } from '../../connection/types.js';
+import { VanillaContext } from '../../context/VanillaContext.js';
+import { Activation } from '@versori/run/services/platform';
+import { ContextProvider } from '../../context/ContextProvider.js';
+export type VanillaCompilerContext = {
+    compiler: ObservableCompiler;
+    log: Logger;
+    tracer: Tracer;
+    contextProvider: ContextProvider;
+    cnxFactory: ConnectionFactory;
+    queueProvider: QueueAPI;
+    webhookRouter: Router;
+    cronRouter: Router;
+    configReader: ConfigReader;
+    cronRegistry: Map<string, string>;
+    organisationId: string;
+};
+export declare const VanillaActivation: Activation;
+export type CompilerFunc<In = any, Out = any, T extends Task<In, Out> = Task<In, Out>> = (ctx: VanillaCompilerContext, task: T) => OperatorFunction<In, Out>;
+export declare class ObservableCompiler {
+    private taskCompilers;
+    private triggerCompilers;
+    constructor();
+    compileTask<In = any, Out = any, Index = void>(ctx: VanillaCompilerContext, task: Task<In, Out>): ContextOperatorFunction<In, Out, Index>;
+    compileTrigger<Out = any, T extends Trigger<Out> = Trigger<Out>>(ctx: VanillaCompilerContext, trigger: T, signal: AbortSignal): Observable<VanillaContext<Out, void>>;
+    registerTask<In, Out, T extends Task<In, Out>>(compiler: TaskCompiler<In, Out, T>): void;
+    registerTrigger<Out, T extends Trigger<Out>>(compiler: TriggerCompiler<Out, T>): void;
+}
+//# sourceMappingURL=ObservableCompiler.d.ts.map

package/script/src/interpreter/vanilla/ObservableCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservableCompiler.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/vanilla/ObservableCompiler.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAY,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAe,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAU/D,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,QAAQ,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAa/B,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CACrF,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,CAAC,KACN,gBAAgB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AAE/B,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,aAAa,CAAkD;IACvE,OAAO,CAAC,gBAAgB,CAAgD;;IAkBxE,WAAW,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,KAAK,GAAG,IAAI,EACzC,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,GACpB,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC;IAe1C,cAAc,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,EAC3D,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,WAAW,GACpB,UAAU,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAexC,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAKjF,eAAe,CAAC,GAAG,EAAE,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC;CAIjF"}

package/script/src/interpreter/vanilla/ObservableCompiler.js

@@ -0,0 +1,99 @@
+"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.ObservableCompiler = exports.VanillaActivation = void 0;
+const Task_js_1 = require("../../dsl/Task.js");
+const Trigger_js_1 = require("../../dsl/Trigger.js");
+const background_js_1 = require("./compilers/background.js");
+const catch_js_1 = require("./compilers/catch.js");
+const chain_js_1 = require("./compilers/chain.js");
+const durableworkflow_js_1 = require("./compilers/durableworkflow.js");
+const fn_js_1 = require("./compilers/fn.js");
+const http_js_1 = require("./compilers/http.js");
+const parallel_js_1 = require("./compilers/parallel.js");
+const schedule_js_1 = require("./compilers/schedule.js");
+const serial_js_1 = require("./compilers/serial.js");
+const unpack_js_1 = require("./compilers/unpack.js");
+const webhook_js_1 = require("./compilers/webhook.js");
+exports.VanillaActivation = {
+    id: 'vanilla-webhook-activation',
+    user: {
+        id: 'vanilla-user-id',
+        externalId: 'vanilla-user-external-id',
+        displayName: 'Vanilla User',
+        organisationId: 'vanilla-org-id',
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+    },
+    connections: [],
+    dynamicVariables: {},
+    environment: undefined,
+};
+class ObservableCompiler {
+    constructor() {
+        Object.defineProperty(this, "taskCompilers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "triggerCompilers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        // Register all available compilers
+        this.registerTask(parallel_js_1.parallelCompiler);
+        this.registerTask(serial_js_1.serialCompiler);
+        this.registerTask(catch_js_1.catchCompiler);
+        this.registerTask(chain_js_1.chainCompiler);
+        this.registerTask(fn_js_1.fnCompiler);
+        this.registerTask(background_js_1.backgroundCompiler);
+        this.registerTask(unpack_js_1.unpackCompiler);
+        this.registerTask(http_js_1.httpCompiler);
+        this.registerTrigger(schedule_js_1.scheduleCompiler);
+        this.registerTrigger(webhook_js_1.webhookCompiler);
+        this.registerTrigger(durableworkflow_js_1.durableWorkflowCompiler);
+    }
+    compileTask(ctx, task) {
+        const compiler = this.taskCompilers.get(task[Task_js_1.TaskType]);
+        if (!compiler) {
+            throw new Error(`No compiler registered for task type: ${task[Task_js_1.TaskType]}`);
+        }
+        if (!(task instanceof compiler.ctor)) {
+            throw new Error(`Task type mismatch: expected ${compiler.ctor.name}, got ${task.constructor.name}`);
+        }
+        return compiler.compile(ctx, task);
+    }
+    compileTrigger(ctx, trigger, signal) {
+        const compiler = this.triggerCompilers.get(trigger[Trigger_js_1.TriggerType]);
+        if (!compiler) {
+            throw new Error(`No compiler registered for trigger type: ${trigger[Trigger_js_1.TriggerType]}`);
+        }
+        if (!(trigger instanceof compiler.ctor)) {
+            throw new Error(`Trigger type mismatch: expected ${compiler.ctor.name}, got ${trigger.constructor.name}`);
+        }
+        return compiler.compile(ctx, trigger, signal);
+    }
+    registerTask(compiler) {
+        const task = new compiler.ctor();
+        this.taskCompilers.set(task[Task_js_1.TaskType], compiler);
+    }
+    registerTrigger(compiler) {
+        const trigger = new compiler.ctor();
+        this.triggerCompilers.set(trigger[Trigger_js_1.TriggerType], compiler);
+    }
+}
+exports.ObservableCompiler = ObservableCompiler;

package/script/src/interpreter/vanilla/Queue.d.ts

@@ -0,0 +1,72 @@
+import { Logger } from '../../observability/mod.js';
+export type WorkflowMsgMetadata = {
+    parentWorkflowId?: string;
+    executionId?: string;
+    activationId?: string;
+    userId?: string;
+};
+export type Workflows = {
+    workflows: WorkflowMsg[];
+};
+export type WorkflowMsg = {
+    id?: string;
+    projectId?: string;
+    environmentId?: string;
+    group: string;
+    payload?: string;
+    output?: string;
+    status?: 'available' | 'locked' | 'completed' | 'failed';
+    attempt?: number;
+    maxAttempts?: number;
+    timeout?: string;
+    createdAt?: string;
+    metadata?: WorkflowMsgMetadata;
+};
+export type CompleteWorkflowRequest = {
+    id: string;
+    output?: string;
+    status: 'completed' | 'failed';
+};
+export type FetchWorkflowsRequest = {
+    ttl?: number;
+    limit?: number;
+    group: string;
+    projectId?: string;
+    environmentId?: string;
+};
+export type RescheduleWorkflowRequest = {
+    id: string;
+    after: string;
+};
+export type SubmitWorkflowsRequest = {
+    workflows: WorkflowMsg[];
+};
+export interface QueueAPI {
+    complete(request: CompleteWorkflowRequest): Promise<void>;
+    submit(request: SubmitWorkflowsRequest): Promise<Workflows>;
+    fetchWorkflows(request: FetchWorkflowsRequest): Promise<Workflows | undefined>;
+    reschedule(request: RescheduleWorkflowRequest): Promise<void>;
+    poll(workflowId: string): Promise<WorkflowMsg>;
+}
+export declare class QueueImpl implements QueueAPI {
+    private baseUrl;
+    private log;
+    private projectId;
+    private environmentId;
+    constructor(baseUrl: string, projectId: string, environmentId: string, log: Logger);
+    static fromEnv(log: Logger): QueueImpl;
+    complete(request: CompleteWorkflowRequest): Promise<void>;
+    submit(request: SubmitWorkflowsRequest): Promise<Workflows>;
+    fetchWorkflows(request: FetchWorkflowsRequest): Promise<Workflows | undefined>;
+    reschedule(request: RescheduleWorkflowRequest): Promise<void>;
+    poll(workflowId: string): Promise<WorkflowMsg>;
+}
+export declare class MockQueue implements QueueAPI {
+    constructor();
+    complete(_request: CompleteWorkflowRequest): Promise<void>;
+    submit(_request: SubmitWorkflowsRequest): Promise<Workflows>;
+    fetchWorkflows(_request: FetchWorkflowsRequest): Promise<Workflows | undefined>;
+    reschedule(_request: RescheduleWorkflowRequest): Promise<void>;
+    poll(_workflowId: string): Promise<WorkflowMsg>;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/script/src/interpreter/vanilla/Queue.d.ts.map

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

package/script/src/interpreter/vanilla/Queue.js

@@ -0,0 +1,181 @@
+"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.MockQueue = exports.QueueImpl = void 0;
+const constants_js_1 = require("../../dsl/http/versori/constants.js");
+const mod_js_1 = require("../../mod.js");
+class QueueImpl {
+    constructor(baseUrl, projectId, environmentId, log) {
+        Object.defineProperty(this, "baseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "log", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "projectId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "environmentId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.baseUrl = baseUrl;
+        this.log = log;
+        this.projectId = projectId;
+        this.environmentId = environmentId;
+    }
+    static fromEnv(log) {
+        // TODO make these environment variables configurable in constants/ts
+        const baseUrl = Deno.env.get(constants_js_1.envVarSDKApiBaseURL);
+        const _log = log || new mod_js_1.ConsoleLogger('debug');
+        const projectId = Deno.env.get(constants_js_1.envVarProjectId) || 'default-project';
+        const environmentId = Deno.env.get(constants_js_1.envVarEnvId) || 'default-environment';
+        if (!baseUrl) {
+            throw new Error('Missing required environment variables');
+        }
+        return new QueueImpl(baseUrl, projectId, environmentId, _log);
+    }
+    async complete(request) {
+        const resp = await fetch(`${this.baseUrl}/v1/workflows/complete`, {
+            method: 'POST',
+            body: JSON.stringify({
+                id: request.id,
+                output: request.output,
+                status: request.status,
+            }),
+        });
+        if (!resp.ok) {
+            this.log.error('Failed to complete workflow', {
+                id: request.id,
+                output: request.output,
+                status: request.status,
+            });
+            throw new Error('Failed to complete workflow');
+        }
+        return;
+    }
+    async submit(request) {
+        // Ensure all workflows have the projectId & environmentId set
+        const workflows = request.workflows.map((w) => ({
+            ...w,
+            projectId: this.projectId || w.projectId,
+            environmentId: this.environmentId || w.environmentId,
+        }));
+        const resp = await fetch(`${this.baseUrl}/v1/workflows/submit`, {
+            method: 'POST',
+            body: JSON.stringify({
+                workflows: workflows,
+            }),
+        });
+        if (!resp.ok) {
+            this.log.error('Failed to submit workflows', {
+                workflows: workflows,
+            });
+            throw new Error('Failed to submit workflows');
+        }
+        const result = (await resp.json());
+        return result;
+    }
+    async fetchWorkflows(request) {
+        const resp = await fetch(`${this.baseUrl}/v1/workflows/fetch`, {
+            method: 'POST',
+            body: JSON.stringify({
+                ttl: request.ttl,
+                limit: request.limit,
+                group: request.group,
+                projectId: this.projectId || request.projectId,
+                environmentId: this.environmentId || request.environmentId,
+            }),
+        });
+        if (!resp.ok) {
+            const errorText = (await resp.json());
+            this.log.error('Failed to fetch workflows', {
+                error: errorText.message,
+                ttl: request.ttl,
+                limit: request.limit,
+                group: request.group,
+                projectId: this.projectId || request.projectId,
+            });
+            throw new Error('failed to fetch workflows', {
+                cause: new Error(errorText.message),
+            });
+        }
+        if (resp.status === 204) {
+            return undefined;
+        }
+        const result = (await resp.json());
+        return result;
+    }
+    async reschedule(request) {
+        const resp = await fetch(`${this.baseUrl}/v1/workflows/reschedule`, {
+            method: 'POST',
+            body: JSON.stringify({
+                id: request.id,
+                after: request.after,
+            }),
+        });
+        if (!resp.ok) {
+            this.log.error('Failed to reschedule workflow', {
+                id: request.id,
+                after: request.after,
+            });
+            throw new Error('Failed to reschedule workflow');
+        }
+        return;
+    }
+    async poll(workflowId) {
+        // this endpoint returns a 404 if the workflow is not completed
+        const resp = await fetch(`${this.baseUrl}/v1/workflows/fetch/${workflowId}`, {
+            method: 'GET',
+        });
+        if (!resp.ok) {
+            this.log.error('Failed to poll workflow', { workflowId });
+            throw new Error('Failed to poll workflow');
+        }
+        const result = (await resp.json());
+        return result;
+    }
+}
+exports.QueueImpl = QueueImpl;
+// MockQueue can be used for testing. Right now it throws errors for all methods because it isn't used in tests yet.
+class MockQueue {
+    constructor() { }
+    complete(_request) {
+        throw new Error('Method not implemented.');
+    }
+    submit(_request) {
+        throw new Error('Method not implemented.');
+    }
+    fetchWorkflows(_request) {
+        throw new Error('Method not implemented.');
+    }
+    reschedule(_request) {
+        throw new Error('Method not implemented.');
+    }
+    poll(_workflowId) {
+        throw new Error('Method not implemented.');
+    }
+}
+exports.MockQueue = MockQueue;

package/script/src/interpreter/vanilla/VanillaInterpreter.d.ts

@@ -0,0 +1,95 @@
+import { Tracer } from '@opentelemetry/api';
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { Router } from 'express';
+import { Observable, Subscription } from 'rxjs';
+import { ConfigReader, CronProvider } from '../../dsl/http/types.js';
+import { Workflow } from '../../dsl/Workflow.js';
+import { Logger } from '../../observability/logging/Logger.js';
+import { ContextOperatorFunction } from './compilers/types.js';
+import { ObservableCompiler } from './ObservableCompiler.js';
+import { QueueAPI } from './Queue.js';
+import { DefaultConnectionFactory } from '../../connection/VanillaConnectionFactory.js';
+import { VanillaContext, VanillaContextProvider } from '../../context/VanillaContext.js';
+import { ContextProvider } from '../../context/ContextProvider.js';
+/**
+ * VanillaInterpreterOptions
+ *  configures the behavior of the {@link VanillaInterpreter}.
+ */
+export type VanillaInterpreterOptions = {
+    /**
+     * 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?: VanillaContextProvider;
+    /**
+     * Abort signal to cancel workflow execution.
+     */
+    signal?: AbortSignal;
+    /**
+     * Skip loading Versori credentials. Useful for local development.
+     */
+    skipVersoriCredentials?: boolean;
+};
+type Registration = {
+    trigger$: Observable<VanillaContext<any, void>>;
+    task$: ContextOperatorFunction<any, any, any>;
+    localAbortController: AbortController;
+    sigintListener: () => void;
+    subscription?: Subscription;
+};
+/**
+ * VanillaInterpreter 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 DurableInterpreter}, this interpreter is incapable of using connections. Therefore, all fetch requests will need
+ * to use fully qualified URLs and authentication must be handled manually within the workflow.
+ *
+ * @example
+ * ```typescript
+ * import { VanillaInterpreter, 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 VanillaInterpreter();
+ * interpreter.register(processJob);
+ * await interpreter.start();
+ * ```
+ */
+export declare class VanillaInterpreter {
+    private readonly log;
+    private readonly compiler;
+    private readonly contextProvider;
+    private readonly webhookRouter;
+    private readonly cronRouter;
+    private readonly cronRegistry;
+    private readonly cnxFetchFactory;
+    private readonly cronProvider;
+    private readonly tracer;
+    private readonly cfgReader;
+    private readonly queueProvider;
+    private readonly otelSDK?;
+    private registeredWorkflows;
+    private webhookServer?;
+    private cronServer?;
+    private shutdownServer?;
+    private isShuttingDown;
+    constructor(log: Logger, compiler: ObservableCompiler, contextProvider: ContextProvider, webhookRouter: Router, cronRouter: Router, cronRegistry: Map<string, string>, cnxFetchFactory: DefaultConnectionFactory, cronProvider: CronProvider, tracer: Tracer, cfgReader: ConfigReader, queueProvider: QueueAPI, otelSDK?: NodeSDK | undefined);
+    static newInstance(options?: VanillaInterpreterOptions): Promise<VanillaInterpreter>;
+    register<O>(workflow: Workflow<O>, options?: VanillaInterpreterOptions): Registration;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=VanillaInterpreter.d.ts.map

package/script/src/interpreter/vanilla/VanillaInterpreter.d.ts.map

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