@versori/run 0.3.0-beta.7 → 0.3.0-beta.9

package/esm/src/context/AsyncWorkflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncWorkflow.d.ts","sourceRoot":"","sources":["../../../src/src/context/AsyncWorkflow.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM;IAK/C;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC3C;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAO7C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAMlD"}
+{"version":3,"file":"AsyncWorkflow.d.ts","sourceRoot":"","sources":["../../../src/src/context/AsyncWorkflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,qBAAa,aAAa;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM;IAK/C,IAAI,EAAE,IAAI,MAAM,CAEf;IAMK,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCrC,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAQvC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAMlD"}

package/esm/src/context/AsyncWorkflow.js

@@ -1,19 +1,3 @@
-/*
- * 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.
- */
-/**
- * AsyncWorkflow represents a durable workflow that has been started asynchronously using `ctx.start()`.
- * It provides methods to wait for completion and retrieve the workflow's output data.
- */
 export class AsyncWorkflow {
     constructor(queue, workflowId) {
         Object.defineProperty(this, "workflowId", {
@@ -55,21 +39,13 @@ export class AsyncWorkflow {
         this.queue = queue;
         this.workflowId = workflowId;
     }
-    /**
-     * The unique identifier for this workflow instance.
-     */
     get id() {
         return this.workflowId;
     }
-    /**
-     * Wait for the workflow to complete by polling the queue.
-     *
-     * If the workflow is already completed, returns immediately. Throws an error if already waiting or if the wait
-     * times out.
-     *
-     * @param maxWait Optional maximum wait time in milliseconds. If exceeded, throws an error.
-     * @throws Error if already waiting for this workflow or if maxWait is exceeded.
-     */
+    // wait will wait for the workflow to complete by polling the queue
+    // If maxWait is provided (in milliseconds), it will wait for that long before giving up
+    // If the workflow is already completed, it will return immediately.
+    // Throws an error if already waiting or if the wait times out.
     async wait(maxWait) {
         if (this.isWaiting) {
             return Promise.reject(new Error('already waiting for workflow to complete'));
@@ -84,7 +60,7 @@ export class AsyncWorkflow {
                 this.isWaiting = false;
                 throw new Error('wait timed out');
             }
-            const workflow = await this.queue.poll(this.workflowId);
+            const workflow = await this.queue.getWorkflow(this.workflowId);
             if (workflow.status === 'completed') {
                 // workflow is completed, parse the output and set the data and completed to true
                 const stringData = workflow.output;
@@ -96,29 +72,17 @@ export class AsyncWorkflow {
                 this.isCompleted = true;
                 return;
             }
-            await new Promise((resolve) => setTimeout(resolve, 1000));
+            await new Promise(resolve => setTimeout(resolve, 1000));
         }
     }
-    /**
-     * Get the parsed output data from the completed workflow.
-     *
-     * If the workflow hasn't completed yet, this will wait for it to complete first.
-     *
-     * @returns The workflow's output data, JSON parsed.
-     */
+    // getData returns the data as D type, which is JSON parsed
     async getData() {
         if (!this.isWaiting) {
             await this.wait();
         }
         return this.data;
     }
-    /**
-     * Get the raw output data from the completed workflow as a base64 encoded string.
-     *
-     * If the workflow hasn't completed yet, this will wait for it to complete first.
-     *
-     * @returns The workflow's output data, base64 encoded.
-     */
+    // getDataRaw returns the raw data as base64 encoded string
     async getDataRaw() {
         if (!this.isWaiting) {
             await this.wait();

package/esm/src/context/Context.d.ts

@@ -4,62 +4,24 @@ import { QueueAPI } from '../interpreter/durable/Queue.js';
 import { Issue, IssueAPI } from '../issues/Issues.js';
 import { KeyValue, KeyValueProvider, KeyValueScope } from '../kv/KeyValue.js';
 import { Logger } from '../observability/logging/Logger.js';
-import { ActivationImpl } from './ActivationImpl.js';
 import { AsyncWorkflow } from './AsyncWorkflow.js';
+import { Workflow } from '../interpreter/durable/Queue.js';
+import { ActivationImpl } from './ActivationImpl.js';
+import { WorkflowInterface, WorkflowOpts } from './WorkflowClient.js';
 export type OnSuccessFn = (ctx: Context<any>) => void;
 export type OnErrorFn = (ctx: Context<any>) => void;
 export type ContextOptions = {
-    workflowId?: string;
+    workflow?: Workflow;
     request?: express.Request;
     onSuccess?: OnSuccessFn;
     onError?: OnErrorFn;
 };
-/**
- * WorkflowOpts is used to pass data to the workflow when starting it. Use either `data` or `dataRaw`, but not both.
- *
- * MaxAttempts is used to limit the number of attempts for the workflow execution.
- */
-export type WorkflowOpts = {
-    /**
-     * MaxAttempts is used to limit the number of attempts for the workflow execution.
-     *
-     * @default 5
-     */
-    maxAttempts?: number;
-    /**
-     * The data passed to the workflow instance when it was created.
-     */
-    data?: unknown;
-    /**
-     * The data passed to the workflow instance when it was created, base64 encoded.
-     */
-    dataRaw?: string;
-};
-/**
- * CreateIssue is the payload for creating a new issue.
- */
 export type CreateIssue = {
-    /**
-     * The severity of the issue.
-     */
     severity: 'low' | 'medium' | 'high';
-    /**
-     * The title of the issue.
-     */
     title: string;
-    /**
-     * The message of the issue.
-     */
     message: string;
-    /**
-     * Any additional annotations to attach to the issue.
-     */
     annotations: Record<string, string>;
 };
-/**
- * Context is the object passed to workflow functions, it provides access to the data being processed by the workflow,
- * as well as a number of other properties and methods for implementing the workflow logic.
- */
 export interface Context<D> {
     readonly log: Logger;
     readonly executionId: string;
@@ -68,44 +30,17 @@ export interface Context<D> {
     activation: ActivationImpl;
     /**
      * Opens a key value store for the given scope, defaulting to ':project:' if not provided.
-     * @param scope The scope of the key value store to open, defaulting to ':project:' if not provided.
+     * @param scope
      */
     openKv(scope?: KeyValueScope): KeyValue;
-    /**
-     * Starts a workflow with the given ID and options.
-     * @param workflowId The ID of the workflow to start, this should refer to a workflow registered with the
-     *  {@link DurableInterpreter}.
-     * @param workflowOpts The options for the workflow.
-     *
-     * The integration must be ran using the {@link DurableInterpreter} and not {@link MemoryInterpreter} (the
-     * default interpreter). Reach out to support if you need help with this.
-     */
     start(workflowId: string, workflowOpts: WorkflowOpts): Promise<AsyncWorkflow>;
-    /**
-     * Returns a {@link CredentialsProvider} which can be used to read credential data directly and construct requests
-     * for systems using custom authentication methods which are not supported natively by Versori.
-     */
     credentials(): CredentialsProvider;
-    /**
-     * Destroys the key value store for the given scope, ":execution:", ":project:" or ":organization:".
-     *
-     * @param scope The scope of the key value store to destroy, ":execution:", ":project:" or ":organization:".
-     */
     destroy(scope: KeyValueScope): Promise<void>;
-    /**
-     * Creates a new issue for the current context. Issues can be managed through the Versori platform or via the API.
-     * Users can configure notification channels within their account settings to be notified of new issues.
-     *
-     * @param issue The issue to create.
-     * @param options Optional options for the issue creation.
-     */
     createIssue(issue: CreateIssue, options?: {
         deduplicate?: boolean;
     }): Promise<Issue | null>;
-    /**
-     * Returns the underlying express {@link express.Request} object for the current execution.
-     */
     request(): express.Request | undefined;
+    workflowClient(): WorkflowInterface;
 }
 export declare class ContextImpl<D, Index = void> implements Context<D> {
     #private;
@@ -119,11 +54,12 @@ export declare class ContextImpl<D, Index = void> implements Context<D> {
     readonly options: ContextOptions;
     constructor(log: Logger, kvp: KeyValueProvider, creds: CredentialsProvider, executionId: string, startTime: Date, data: D, activation: ActivationImpl, issues: IssueAPI, queue?: QueueAPI, options?: ContextOptions);
     get activation(): ActivationImpl;
-    get workflowId(): string | undefined;
+    get workflow(): Workflow | undefined;
     setIndex(idx: number): ContextImpl<D, number>;
     withData<D2>(data: D2): ContextImpl<D2, Index>;
     openKv(scope?: KeyValueScope): KeyValue;
     request(): express.Request | undefined;
+    workflowClient(): WorkflowInterface;
     start(group: string, opts: WorkflowOpts): Promise<AsyncWorkflow>;
     createIssue(issue: CreateIssue, options?: {
         deduplicate?: boolean;

package/esm/src/context/Context.d.ts.map

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

package/esm/src/context/Context.js

@@ -1,15 +1,3 @@
-/*
- * 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 __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -23,6 +11,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _ContextImpl_activation, _ContextImpl_issues, _ContextImpl_creds;
 import { AsyncWorkflow } from './AsyncWorkflow.js';
+import { WorkflowImpl } from './WorkflowClient.js';
 export class ContextImpl {
     constructor(log, kvp, creds, executionId, startTime, data, activation, issues, queue, options = {}) {
         Object.defineProperty(this, "log", {
@@ -96,12 +85,13 @@ export class ContextImpl {
         this.request = this.request.bind(this);
         this.createIssue = this.createIssue.bind(this);
         this.destroy = this.destroy.bind(this);
+        this.workflowClient = this.workflowClient.bind(this);
     }
     get activation() {
         return __classPrivateFieldGet(this, _ContextImpl_activation, "f");
     }
-    get workflowId() {
-        return this.options.workflowId;
+    get workflow() {
+        return this.options.workflow;
     }
     setIndex(idx) {
         const next = new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, this.data, __classPrivateFieldGet(this, _ContextImpl_activation, "f"), __classPrivateFieldGet(this, _ContextImpl_issues, "f"), this.queue, this.options);
@@ -127,6 +117,12 @@ export class ContextImpl {
     request() {
         return this.options.request;
     }
+    workflowClient() {
+        if (!this.queue) {
+            throw new Error('Queue is not available for this context, cannot start workflow');
+        }
+        return new WorkflowImpl(this.queue, this.executionId, this.activation);
+    }
     async start(group, opts) {
         // this makes a post request to the endpoint sending a message and schedule the workflow to run
         if (!this.queue) {
@@ -143,12 +139,14 @@ export class ContextImpl {
             workflows: [
                 {
                     group,
+                    projectId: Deno.env.get('VERSORI_PROJECT_ID') ?? 'unknown',
+                    environmentId: Deno.env.get('VERSORI_ENVIRONMENT_ID') ?? 'unknown',
                     metadata: {
                         executionId: this.executionId,
                         activationId: this.activation?.id,
                         userId: this.activation?.user?.externalId,
                     },
-                    payload,
+                    payload: payload ?? btoa("{}"),
                     maxAttempts: opts.maxAttempts,
                 },
             ],

package/esm/src/context/ContextFunc.d.ts

@@ -1,27 +1,5 @@
 import { Context } from './Context.js';
-/**
- * ContextFunc represents a function that can be used as a task in a workflow. It can be either synchronous or
- * asynchronous, and receives a {@link Context} object and an optional index parameter.
- *
- * @template Input The type of data expected in the context.
- * @template Output The type of data returned by the function.
- * @template Index Optional index parameter, typically used when processing arrays.
- */
 export type ContextFunc<Input, Output, Index = void> = AsyncContextFunc<Input, Output, Index> | SyncContextFunc<Input, Output, Index>;
-/**
- * AsyncContextFunc is an asynchronous function that can be used as a task in a workflow.
- *
- * @template Input The type of data expected in the context.
- * @template Output The type of data returned by the function.
- * @template Index Optional index parameter, typically used when processing arrays.
- */
 export type AsyncContextFunc<Input, Output, Index> = (ctx: Context<Input>, idx: Index) => Promise<Output>;
-/**
- * SyncContextFunc is a synchronous function that can be used as a task in a workflow.
- *
- * @template Input The type of data expected in the context.
- * @template Output The type of data returned by the function.
- * @template Index Optional index parameter, typically used when processing arrays.
- */
 export type SyncContextFunc<Input, Output, Index> = (ctx: Context<Input>, idx: Index) => Output;
 //# sourceMappingURL=ContextFunc.d.ts.map

package/esm/src/context/ContextFunc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextFunc.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextFunc.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,IAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GACtC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CACjD,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EACnB,GAAG,EAAE,KAAK,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,KAAK,MAAM,CAAC"}
+{"version":3,"file":"ContextFunc.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextFunc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,IAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GACtC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5C,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1G,MAAM,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,KAAK,MAAM,CAAC"}

package/esm/src/context/ContextFunc.js

@@ -1,13 +1 @@
-/*
- * 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.
- */
 export {};

package/esm/src/context/ContextProvider.d.ts

@@ -7,6 +7,7 @@ import { Context, ContextImpl, ContextOptions } from './Context.js';
 import { Activation, PlatformApi } from '../services/platform/mod.js';
 export interface ContextProvider {
     create<D>(activation: Activation, data: D, options?: ContextOptions): ContextImpl<D, void>;
+    createWithExecutionId<D>(activation: Activation, data: D, executionId: string, options?: ContextOptions): ContextImpl<D, void>;
     destroy(ctx: Context<any>): Promise<void>;
 }
 export declare class ContextProviderImpl implements ContextProvider {
@@ -19,6 +20,7 @@ export declare class ContextProviderImpl implements ContextProvider {
     issues: IssueAPI;
     queue?: QueueAPI;
     constructor(log: Logger, kvp: KeyValueProvider, creds: CredentialsProvider, platformApi: PlatformApi, organisationId: string, environmentId: string, issues: IssueAPI, queue?: QueueAPI | undefined);
+    createWithExecutionId<D>(activation: Activation, data: D, executionId: string, options?: ContextOptions): ContextImpl<D, void>;
     create<D>(activation: Activation, data: D, options?: ContextOptions): ContextImpl<D>;
     destroy(_: Context<any>): Promise<void>;
 }

package/esm/src/context/ContextProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextProvider.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextProvider.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGtE,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAWnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAZlC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAGb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,EACT,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACtC,MAAM,EAAE,QAAQ,EAChB,KAAK,GAAE,QAAQ,GAAG,SAAqB;IAS3C,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,CAAC;IA+BxF,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}
+{"version":3,"file":"ContextProvider.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGtE,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/H,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAWnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAZlC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAGb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,EACT,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACtC,MAAM,EAAE,QAAQ,EAChB,KAAK,GAAE,QAAQ,GAAG,SAAqB;IAS3C,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC;IAuBlI,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,CAAC;IAMxF,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/esm/src/context/ContextProvider.js

@@ -1,15 +1,3 @@
-/*
- * Copyright (c) 2025 Versori Group Inc
- *
- * Use of this software is governed by the Business Source License 1.1
- * included in the LICENSE file at the root of this repository.
- *
- * Change Date: 2029-01-01
- * Change License: Apache License, Version 2.0
- *
- * As of the Change Date, in accordance with the Business Source License,
- * use of this software will be governed by the Apache License, Version 2.0.
- */
 import { ulid } from '../../deps/jsr.io/@std/ulid/1.0.0/mod.js';
 import { ContextImpl } from './Context.js';
 import { ActivationImpl } from './ActivationImpl.js';
@@ -69,8 +57,7 @@ export class ContextProviderImpl {
         this.issues = issues;
         this.queue = queue;
     }
-    create(activation, data, options = {}) {
-        const executionId = ulid();
+    createWithExecutionId(activation, data, executionId, options = {}) {
         const logger = this.log.child({
             executionId,
             activationId: activation.id,
@@ -79,6 +66,10 @@ export class ContextProviderImpl {
         const activationImpl = new ActivationImpl(activation, this.platformApi, this.organisationId, this.environmentId, logger);
         return new ContextImpl(logger, this.kvp, this.creds, executionId, new Date(), data, activationImpl, this.issues, this.queue, options);
     }
+    create(activation, data, options = {}) {
+        const executionId = ulid();
+        return this.createWithExecutionId(activation, data, executionId, options);
+    }
     destroy(_) {
         return Promise.resolve();
     }

package/esm/src/context/WorkflowClient.d.ts

@@ -0,0 +1,29 @@
+import { QueueAPI } from '../interpreter/durable/Queue.js';
+import { Workflow } from '../interpreter/durable/Queue.js';
+import { ActivationImpl } from './ActivationImpl.js';
+export type WorkflowOpts = {
+    maxAttempts?: number;
+    data?: unknown;
+    dataRaw?: string;
+};
+export interface WorkflowInterface {
+    startWorkflow(group: string, opts: WorkflowOpts): Promise<Workflow>;
+    getWorkflow(wfs: Workflow): Promise<Workflow>;
+    getWorkflowById(id: string): Promise<Workflow>;
+    waitForCompletion(wf: Workflow): Promise<Workflow>;
+    rescheduleWorkflow(wf: Workflow, after: string): Promise<void>;
+    completeWorkflow(wf: Workflow, status: 'completed' | 'failed', output?: any): Promise<void>;
+}
+export declare class WorkflowImpl implements WorkflowInterface {
+    private queue;
+    private executionId;
+    private activation;
+    constructor(queue: QueueAPI, executionId: string, activation: ActivationImpl);
+    startWorkflow(group: string, opts: WorkflowOpts): Promise<Workflow>;
+    getWorkflow(wf: Workflow): Promise<Workflow>;
+    getWorkflowById(id: string): Promise<Workflow>;
+    waitForCompletion(wf: Workflow): Promise<Workflow>;
+    rescheduleWorkflow(wf: Workflow, after: string): Promise<void>;
+    completeWorkflow(wf: Workflow, status: 'completed' | 'failed', output?: any): Promise<void>;
+}
+//# sourceMappingURL=WorkflowClient.d.ts.map

package/esm/src/context/WorkflowClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowClient.d.ts","sourceRoot":"","sources":["../../../src/src/context/WorkflowClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,MAAM,MAAM,YAAY,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAC9B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/F;AAED,qBAAa,YAAa,YAAW,iBAAiB;IAClD,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAiB;gBAEvB,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc;IActE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBnE,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI9C,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IASlD,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B9D,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAYpG"}

package/esm/src/context/WorkflowClient.js

@@ -0,0 +1,95 @@
+export class WorkflowImpl {
+    constructor(queue, executionId, activation) {
+        Object.defineProperty(this, "queue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "executionId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "activation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.queue = queue;
+        this.executionId = executionId;
+        this.activation = activation;
+        // I have no idea if I need this but I have suffered from it in the past
+        this.startWorkflow = this.startWorkflow.bind(this);
+        this.getWorkflow = this.getWorkflow.bind(this);
+        this.waitForCompletion = this.waitForCompletion.bind(this);
+        this.rescheduleWorkflow = this.rescheduleWorkflow.bind(this);
+        this.completeWorkflow = this.completeWorkflow.bind(this);
+        this.getWorkflowById = this.getWorkflowById.bind(this);
+    }
+    async startWorkflow(group, opts) {
+        const workflows = await this.queue.submit({
+            workflows: [
+                {
+                    group,
+                    metadata: {
+                        executionId: this.executionId,
+                        activationId: this.activation?.id,
+                        userId: this.activation?.user?.externalId,
+                    },
+                    payload: opts.data ? btoa(JSON.stringify(opts.data)) : btoa("{}"),
+                    maxAttempts: opts.maxAttempts,
+                },
+            ],
+        });
+        return workflows.workflows[0];
+    }
+    async getWorkflow(wf) {
+        return await this.queue.getWorkflow(wf.id);
+    }
+    async getWorkflowById(id) {
+        return await this.queue.getWorkflow(id);
+    }
+    async waitForCompletion(wf) {
+        while (wf.status !== 'completed' && wf.status !== 'failed') {
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            wf = await this.queue.getWorkflow(wf.id);
+        }
+        return wf;
+    }
+    async rescheduleWorkflow(wf, after) {
+        await this.queue.reschedule({
+            id: wf.id,
+            after,
+        });
+        // TODO: Is this a hack?
+        // In the durableworkflow taks I have this piece of code 
+        // 
+        // onSuccess: (completedContext: ContextImpl<unknown>) => {
+        //     // locked status means we own the workflow and it's not completed yet
+        //     if (wf.status === 'locked') {
+        //         return;
+        //     }
+        //     ctx.queueProvider.complete({
+        //         id: wf.id,
+        //         output: btoa(JSON.stringify(completedContext.data)),
+        //         status: 'completed',
+        //     });
+        // },
+        // 
+        // it basically ignores completing the workflow if it's not locked. 
+        // the line bellow triggers this
+        wf.status = 'available';
+    }
+    async completeWorkflow(wf, status, output) {
+        const outputRaw = output ? btoa(JSON.stringify(output)) : undefined;
+        await this.queue.complete({
+            id: wf.id,
+            output: outputRaw,
+            status: status,
+        });
+        wf.status = status;
+    }
+}

package/esm/src/context/mod.d.ts

@@ -1,10 +1,4 @@
-/**
- * The context module provides the functionality for accessing the data, metadata, and interacting with the Versori
- * managed services within a workflow.
- *
- * @module
- */
-export type { Context, CreateIssue, WorkflowOpts } from './Context.js';
-export type { AsyncWorkflow } from './AsyncWorkflow.js';
+export * from './Context.js';
 export * from './ContextFunc.js';
+export * from './ContextProvider.js';
 //# sourceMappingURL=mod.d.ts.map

package/esm/src/context/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/context/mod.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/context/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/esm/src/context/mod.js

@@ -1,13 +1,3 @@
-/*
- * 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.
- */
+export * from './Context.js';
 export * from './ContextFunc.js';
+export * from './ContextProvider.js';

package/esm/src/dsl/Task.d.ts

@@ -1,15 +1,5 @@
 import { ContextFunc } from '../context/ContextFunc.js';
-/**
- * Symbol used to identify objects as tasks.
- */
 export declare const TaskType: unique symbol;
-/**
- * Task represents a single unit of work in a workflow. Tasks can be chained together using the `.then()` method,
- * handle errors with `.catch()`, run in the background with `.background()`, and process arrays with `.unpack()`.
- *
- * @template In The input type expected by this task.
- * @template Out The output type produced by this task.
- */
 export interface Task<In = any, Out = any> extends Object {
     [TaskType]: string;
     /**
@@ -28,51 +18,16 @@ export interface Task<In = any, Out = any> extends Object {
      */
     catch<NextOut>(task: Taskable<Error, NextOut>): Task<In, NextOut>;
     /**
-     * Run the current task in the background and continue execution of the workflow. The next step's input data will be
-     * of type `void`.
+     * Run the current task in the background and continue execution of the workflow.
      */
     background(): Task<In, void>;
     unpack<NextOut = Out extends Array<infer Elem> ? Elem : Out>(): ArrayTask<In, NextOut>;
     unpack<NextOut>(mapper: (data: Out) => NextOut[]): ArrayTask<In, NextOut>;
-    /**
-     * Create a copy of this task.
-     *
-     * @returns A cloned instance of this task.
-     */
     clone(): Task<In, Out>;
 }
-/**
- * ArrayTask extends {@link Task} with methods for processing array elements either in parallel or serial.
- * It is created by calling `.unpack()` on a task that produces an array.
- *
- * @template In The input type expected by this task.
- * @template OutElem The type of individual elements in the output array.
- */
 export type ArrayTask<In, OutElem> = Task<In, OutElem[]> & {
-    /**
-     * Process each element of the array in parallel.
-     *
-     * @template NextOut The output type produced by the task for each element.
-     * @param task The task to apply to each element.
-     * @returns A task that outputs an array of results.
-     */
     parallel<NextOut>(task: Taskable<OutElem, NextOut, number>): Task<In, NextOut[]>;
-    /**
-     * Process each element of the array in series (one after another).
-     *
-     * @template NextOut The output type produced by the task for each element.
-     * @param task The task to apply to each element.
-     * @returns A task that outputs an array of results.
-     */
     serial<NextOut>(task: Taskable<OutElem, NextOut, number>): Task<In, NextOut[]>;
 };
-/**
- * Taskable represents anything that can be used as a task in a workflow: either a {@link Task} object or a
- * {@link ContextFunc} function.
- *
- * @template In The input type expected by this task.
- * @template O The output type produced by this task.
- * @template Index Optional index parameter used when processing arrays.
- */
 export type Taskable<In, O, Index = unknown> = Task<In, O> | ContextFunc<In, O, Index>;
 //# sourceMappingURL=Task.d.ts.map