arvo-core 1.1.15 → 1.1.17

package/CHANGELOG.md

@@ -64,3 +64,7 @@
 
 - Added Arvo Orchestrator Contract primitive
 
+## [1.1.16] - 2024-10-21
+
+- Added mandatory parent chaining in orchestration events so the process chaining and orchestration chaining can be traced
+

package/dist/ArvoContract/helpers.js

@@ -34,8 +34,12 @@ var utils_1 = require("../utils");
  * });
  */
 var createArvoContract = function (contract) {
-    var createErrorMessage = function (source, type) { return (0, utils_1.cleanString)("\n    In contract (uri=".concat(contract.uri, "), the '").concat(source, "' event (type=").concat(type, ") must not start \n    with '").concat(typegen_1.ArvoOrchestratorEventTypeGen.__prefix, "' becuase this a reserved pattern \n    for Arvo orchestrators.\n  ")); };
-    var validator = function (value) { return value.startsWith(typegen_1.ArvoOrchestratorEventTypeGen.__prefix); };
+    var createErrorMessage = function (source, type) {
+        return (0, utils_1.cleanString)("\n    In contract (uri=".concat(contract.uri, "), the '").concat(source, "' event (type=").concat(type, ") must not start \n    with '").concat(typegen_1.ArvoOrchestratorEventTypeGen.__prefix, "' becuase this a reserved pattern \n    for Arvo orchestrators.\n  "));
+    };
+    var validator = function (value) {
+        return value.startsWith(typegen_1.ArvoOrchestratorEventTypeGen.__prefix);
+    };
     if (validator(contract.accepts.type)) {
         throw new Error(createErrorMessage('accepts', contract.accepts.type));
     }

package/dist/ArvoEvent/helpers.d.ts

@@ -1,5 +1,6 @@
 import ArvoEvent from '.';
 import { ArvoEventData, CloudEventExtension, CreateArvoEvent } from './types';
+import { ExecutionOpenTelemetryConfiguration } from '../types';
 /**
  * Creates an ArvoEvent with the provided data and extensions.
  *
@@ -35,4 +36,4 @@ import { ArvoEventData, CloudEventExtension, CreateArvoEvent } from './types';
  *   { customextension: 'value' },
  * );
  */
-export declare const createArvoEvent: <TData extends ArvoEventData, TExtension extends CloudEventExtension, TType extends string>(event: CreateArvoEvent<TData, TType>, extensions?: TExtension) => ArvoEvent<TData, TExtension, TType>;
+export declare const createArvoEvent: <TData extends ArvoEventData, TExtension extends CloudEventExtension, TType extends string>(event: CreateArvoEvent<TData, TType>, extensions?: TExtension, opentelemetry?: ExecutionOpenTelemetryConfiguration) => ArvoEvent<TData, TExtension, TType>;

package/dist/ArvoEvent/helpers.js

@@ -45,8 +45,11 @@ var uuid_1 = require("uuid");
  *   { customextension: 'value' },
  * );
  */
-var createArvoEvent = function (event, extensions) {
-    var span = OpenTelemetry_1.ArvoCoreTracer.startSpan("createArvoEvent<".concat(event.type, ">"), {});
+var createArvoEvent = function (event, extensions, opentelemetry) {
+    if (opentelemetry === void 0) { opentelemetry = {
+        tracer: OpenTelemetry_1.ArvoCoreTracer,
+    }; }
+    var span = opentelemetry.tracer.startSpan("createArvoEvent<".concat(event.type, ">"), {});
     return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
         span.setStatus({ code: api_1.SpanStatusCode.OK });

package/dist/ArvoEventFactory/index.d.ts

@@ -1,6 +1,7 @@
 import ArvoContract from '../ArvoContract';
 import { z } from 'zod';
 import { CreateArvoEvent } from '../ArvoEvent/types';
+import { ExecutionOpenTelemetryConfiguration } from '../types';
 /**
  * A factory class for creating contractual ArvoEvents based on a given ArvoContract.
  *
@@ -26,7 +27,7 @@ export default class ArvoEventFactory<TUri extends string = string, TType extend
      * @returns The created ArvoEvent as per the accept record of the contract.
      * @throws If the event data fails validation against the contract.
      */
-    accepts<TExtension extends Record<string, any>>(event: Omit<CreateArvoEvent<z.input<TAcceptSchema>, TType>, 'type' | 'datacontenttype' | 'dataschema'>, extensions?: TExtension): import("..").ArvoEvent<z.TypeOf<TAcceptSchema>, TExtension, TType>;
+    accepts<TExtension extends Record<string, any>>(event: Omit<CreateArvoEvent<z.input<TAcceptSchema>, TType>, 'type' | 'datacontenttype' | 'dataschema'>, extensions?: TExtension, opentelemetry?: ExecutionOpenTelemetryConfiguration): import("..").ArvoEvent<z.TypeOf<TAcceptSchema>, TExtension, TType>;
     /**
      * Creates an ArvoEvent as per one of the emits record in the contract.
      *
@@ -37,7 +38,7 @@ export default class ArvoEventFactory<TUri extends string = string, TType extend
      * @returns The created ArvoEvent as per one of the emits records of the contract.
      * @throws If the event data fails validation against the contract.
      */
-    emits<U extends keyof TEmits & string, TExtension extends Record<string, any>>(event: Omit<CreateArvoEvent<z.input<TEmits[U]>, U>, 'datacontenttype' | 'dataschema'>, extensions?: TExtension): import("..").ArvoEvent<z.TypeOf<TEmits[U]>, TExtension, U>;
+    emits<U extends keyof TEmits & string, TExtension extends Record<string, any>>(event: Omit<CreateArvoEvent<z.input<TEmits[U]>, U>, 'datacontenttype' | 'dataschema'>, extensions?: TExtension, opentelemetry?: ExecutionOpenTelemetryConfiguration): import("..").ArvoEvent<z.TypeOf<TEmits[U]>, TExtension, U>;
     /**
      * Creates a system error ArvoEvent.
      *
@@ -48,7 +49,7 @@ export default class ArvoEventFactory<TUri extends string = string, TType extend
      */
     systemError<TExtension extends Record<string, any>>(event: Omit<CreateArvoEvent<any, any>, 'data' | 'type' | 'datacontenttype' | 'dataschema'> & {
         error: Error;
-    }, extensions?: TExtension): import("..").ArvoEvent<{
+    }, extensions?: TExtension, opentelemetry?: ExecutionOpenTelemetryConfiguration): import("..").ArvoEvent<{
         errorMessage: string;
         errorName: string;
         errorStack: string | null;

package/dist/ArvoEventFactory/index.js

@@ -52,9 +52,12 @@ var ArvoEventFactory = /** @class */ (function () {
      * @returns The created ArvoEvent as per the accept record of the contract.
      * @throws If the event data fails validation against the contract.
      */
-    ArvoEventFactory.prototype.accepts = function (event, extensions) {
+    ArvoEventFactory.prototype.accepts = function (event, extensions, opentelemetry) {
         var _this = this;
-        var span = OpenTelemetry_1.ArvoCoreTracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.accepts<").concat(this.contract.accepts.type, ">.create"));
+        if (opentelemetry === void 0) { opentelemetry = {
+            tracer: OpenTelemetry_1.ArvoCoreTracer,
+        }; }
+        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.accepts<").concat(this.contract.accepts.type, ">.create"));
         return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
             var _a, _b, _c, _d;
             span.setStatus({ code: api_1.SpanStatusCode.OK });
@@ -64,7 +67,7 @@ var ArvoEventFactory = /** @class */ (function () {
                 if (!validationResult.success) {
                     throw new Error("Accept Event data validation failed: ".concat(validationResult.error.message));
                 }
-                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, type: _this.contract.accepts.type, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri, data: validationResult.data }), extensions);
+                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, type: _this.contract.accepts.type, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri, data: validationResult.data }), extensions, opentelemetry);
             }
             catch (error) {
                 (0, OpenTelemetry_1.exceptionToSpan)(error);
@@ -89,9 +92,12 @@ var ArvoEventFactory = /** @class */ (function () {
      * @returns The created ArvoEvent as per one of the emits records of the contract.
      * @throws If the event data fails validation against the contract.
      */
-    ArvoEventFactory.prototype.emits = function (event, extensions) {
+    ArvoEventFactory.prototype.emits = function (event, extensions, opentelemetry) {
         var _this = this;
-        var span = OpenTelemetry_1.ArvoCoreTracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.emits<").concat(event.type, ">.create"));
+        if (opentelemetry === void 0) { opentelemetry = {
+            tracer: OpenTelemetry_1.ArvoCoreTracer,
+        }; }
+        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.emits<").concat(event.type, ">.create"));
         return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
             var _a, _b, _c, _d;
             span.setStatus({ code: api_1.SpanStatusCode.OK });
@@ -101,7 +107,7 @@ var ArvoEventFactory = /** @class */ (function () {
                 if (!validationResult.success) {
                     throw new Error("Emit Event data validation failed: ".concat(validationResult.error.message));
                 }
-                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri, data: validationResult.data }), extensions);
+                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri, data: validationResult.data }), extensions, opentelemetry);
             }
             catch (error) {
                 (0, OpenTelemetry_1.exceptionToSpan)(error);
@@ -124,9 +130,12 @@ var ArvoEventFactory = /** @class */ (function () {
      * @param [extensions] - Optional extensions to add to the event.
      * @returns The created system error ArvoEvent.
      */
-    ArvoEventFactory.prototype.systemError = function (event, extensions) {
+    ArvoEventFactory.prototype.systemError = function (event, extensions, opentelemetry) {
         var _this = this;
-        var span = OpenTelemetry_1.ArvoCoreTracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.systemError<sys.").concat(this.contract.accepts.type, ".error>.create"));
+        if (opentelemetry === void 0) { opentelemetry = {
+            tracer: OpenTelemetry_1.ArvoCoreTracer,
+        }; }
+        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.systemError<sys.").concat(this.contract.accepts.type, ".error>.create"));
         return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
             var _a, _b, _c, _d, _e;
             span.setStatus({ code: api_1.SpanStatusCode.OK });
@@ -137,7 +146,7 @@ var ArvoEventFactory = /** @class */ (function () {
                         errorName: error.name,
                         errorMessage: error.message,
                         errorStack: (_e = error.stack) !== null && _e !== void 0 ? _e : null,
-                    }, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri }), extensions);
+                    }, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri }), extensions, opentelemetry);
             }
             catch (error) {
                 (0, OpenTelemetry_1.exceptionToSpan)(error);

package/dist/ArvoOrchestratorContract/helpers.d.ts

@@ -1,6 +1,6 @@
-import { z } from "zod";
-import { ICreateArvoOrchestratorContract } from "./types";
-import ArvoOrchestratorContract from ".";
+import { z } from 'zod';
+import { ICreateArvoOrchestratorContract } from './types';
+import ArvoOrchestratorContract from '.';
 /**
  * Creates an ArvoOrchestratorContract with specified parameters.
  *
@@ -10,22 +10,58 @@ import ArvoOrchestratorContract from ".";
  *
  * Key features:
  * 1. Initialization: Defines the structure and validation for the initial event that starts the orchestration.
+ *    The init schema is automatically intersected with OrchestrationInitEventBaseSchema.
  * 2. Completion: Specifies the event type and data emitted when the orchestration process concludes.
  * 3. Type Safety: Utilizes TypeScript generics to ensure type consistency across the contract definition.
  * 4. Runtime Validation: Employs Zod schemas for robust runtime type checking and data validation.
  *
+ * Base Schema:
+ * The OrchestrationInitEventBaseSchema is automatically intersected with the user-provided init schema.
+ * This base schema includes essential fields for orchestration, such as:
+ * - parentSubject$$: Identifies the subject of the parent process or event in the ArvoEvent system.
+ *
  * This contract serves as a crucial component in maintaining consistency and type safety
  * throughout the orchestration process, from initiation to completion.
  *
  * @param param - The configuration object for creating the contract.
  * @param param.uri - The URI for the contract.
- * @param param.name - The name of the contract (must be alphanumeric).
+ * @param param.name - The name of the contract (must be lowercase alphanumeric with dots).
  * @param param.schema - The schema object containing init and complete Zod schemas.
- * @param param.schema.init - The Zod schema for initialization.
+ * @param param.schema.init - The Zod schema for initialization (will be intersected with OrchestrationInitEventBaseSchema).
  * @param param.schema.complete - The Zod schema for completion.
  *
- * @throws {Error} Throws an error if the name is not alphanumeric.
+ * @throws {Error} Throws an error if the name is not lowercase alphanumeric with dots.
  *
  * @returns Returns a new ArvoOrchestratorContract instance with the specified parameters.
+ *
+ * @example
+ * ```typescript
+ * import { createArvoOrchestratorContract } from 'arvo-core'
+ * import { z } from 'zod'
+ *
+ * const contract = createArvoOrchestratorContract({
+ *   uri: '#/example/contract',
+ *   name: 'rag.orchestrator',
+ *   schema: {
+ *     init: z.object({
+ *       request: z.string(),
+ *       vectorStore: z.string(),
+ *       llm: z.string()
+ *     }),
+ *     complete: z.object({
+ *       response: z.string()
+ *     })
+ *   }
+ * })
+ * ```
+ *
+ * In this example, the actual init schema will be an intersection of the provided schema
+ * and the OrchestrationInitEventBaseSchema, ensuring all necessary fields are included.
  */
-export declare const createArvoOrchestratorContract: <TUri extends string, TName extends string, TInit extends z.ZodTypeAny, TComplete extends z.ZodTypeAny>(param: ICreateArvoOrchestratorContract<TUri, TName, TInit, TComplete>) => ArvoOrchestratorContract<TUri, `arvo.orc.${TName}`, TInit, `arvo.orc.${TName}.done`, TComplete>;
+export declare const createArvoOrchestratorContract: <TUri extends string, TName extends string, TInit extends z.ZodTypeAny, TComplete extends z.ZodTypeAny>(param: ICreateArvoOrchestratorContract<TUri, TName, TInit, TComplete>) => ArvoOrchestratorContract<TUri, `arvo.orc.${TName}`, z.ZodIntersection<z.ZodObject<{
+    parentSubject$$: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    parentSubject$$: string | null;
+}, {
+    parentSubject$$: string | null;
+}>, TInit>, `arvo.orc.${TName}.done`, TComplete>;

package/dist/ArvoOrchestratorContract/helpers.js

@@ -4,8 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createArvoOrchestratorContract = void 0;
+var zod_1 = require("zod");
 var _1 = __importDefault(require("."));
 var typegen_1 = require("./typegen");
+var schema_1 = require("./schema");
 /**
  * Validates if a string contains only uppercase or lowercase alphanumeric characters.
  *
@@ -32,23 +34,53 @@ function isLowerAlphanumeric(input) {
  *
  * Key features:
  * 1. Initialization: Defines the structure and validation for the initial event that starts the orchestration.
+ *    The init schema is automatically intersected with OrchestrationInitEventBaseSchema.
  * 2. Completion: Specifies the event type and data emitted when the orchestration process concludes.
  * 3. Type Safety: Utilizes TypeScript generics to ensure type consistency across the contract definition.
  * 4. Runtime Validation: Employs Zod schemas for robust runtime type checking and data validation.
  *
+ * Base Schema:
+ * The OrchestrationInitEventBaseSchema is automatically intersected with the user-provided init schema.
+ * This base schema includes essential fields for orchestration, such as:
+ * - parentSubject$$: Identifies the subject of the parent process or event in the ArvoEvent system.
+ *
  * This contract serves as a crucial component in maintaining consistency and type safety
  * throughout the orchestration process, from initiation to completion.
  *
  * @param param - The configuration object for creating the contract.
  * @param param.uri - The URI for the contract.
- * @param param.name - The name of the contract (must be alphanumeric).
+ * @param param.name - The name of the contract (must be lowercase alphanumeric with dots).
  * @param param.schema - The schema object containing init and complete Zod schemas.
- * @param param.schema.init - The Zod schema for initialization.
+ * @param param.schema.init - The Zod schema for initialization (will be intersected with OrchestrationInitEventBaseSchema).
  * @param param.schema.complete - The Zod schema for completion.
  *
- * @throws {Error} Throws an error if the name is not alphanumeric.
+ * @throws {Error} Throws an error if the name is not lowercase alphanumeric with dots.
  *
  * @returns Returns a new ArvoOrchestratorContract instance with the specified parameters.
+ *
+ * @example
+ * ```typescript
+ * import { createArvoOrchestratorContract } from 'arvo-core'
+ * import { z } from 'zod'
+ *
+ * const contract = createArvoOrchestratorContract({
+ *   uri: '#/example/contract',
+ *   name: 'rag.orchestrator',
+ *   schema: {
+ *     init: z.object({
+ *       request: z.string(),
+ *       vectorStore: z.string(),
+ *       llm: z.string()
+ *     }),
+ *     complete: z.object({
+ *       response: z.string()
+ *     })
+ *   }
+ * })
+ * ```
+ *
+ * In this example, the actual init schema will be an intersection of the provided schema
+ * and the OrchestrationInitEventBaseSchema, ensuring all necessary fields are included.
  */
 var createArvoOrchestratorContract = function (param) {
     if (!isLowerAlphanumeric(param.name)) {
@@ -58,12 +90,12 @@ var createArvoOrchestratorContract = function (param) {
         uri: param.uri,
         init: {
             type: typegen_1.ArvoOrchestratorEventTypeGen.init(param.name),
-            schema: param.schema.init,
+            schema: zod_1.z.intersection(schema_1.OrchestrationInitEventBaseSchema, param.schema.init),
         },
         complete: {
             type: typegen_1.ArvoOrchestratorEventTypeGen.complete(param.name),
             schema: param.schema.complete,
-        }
+        },
     });
 };
 exports.createArvoOrchestratorContract = createArvoOrchestratorContract;

package/dist/ArvoOrchestratorContract/schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Defines the base schema for orchestrator acceptance in the context of ArvoEvents.
+ * This schema is used to validate and type-check the minimal required fields
+ * for an orchestrator to accept a task or event.
+ */
+export declare const OrchestrationInitEventBaseSchema: z.ZodObject<{
+    parentSubject$$: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    parentSubject$$: string | null;
+}, {
+    parentSubject$$: string | null;
+}>;

package/dist/ArvoOrchestratorContract/schema.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestrationInitEventBaseSchema = void 0;
+var zod_1 = require("zod");
+var utils_1 = require("../utils");
+/**
+ * Defines the base schema for orchestrator acceptance in the context of ArvoEvents.
+ * This schema is used to validate and type-check the minimal required fields
+ * for an orchestrator to accept a task or event.
+ */
+exports.OrchestrationInitEventBaseSchema = zod_1.z.object({
+    parentSubject$$: zod_1.z
+        .string()
+        .min(1, 'The parent subject must not be an empty string')
+        .nullable()
+        .describe((0, utils_1.cleanString)("\n    Identifies the subject of the parent process or event in the ArvoEvent system.\n    \n    Purpose:\n    1. Enables the orchestrator to return its final output to the initiating process or orchestrator.\n    2. Maintains the event chain and process hierarchy in a distributed system.\n    3. Facilitates proper event routing and traceability.\n    \n    Usage:\n    - For non-root processes: Set to the subject of the parent process/orchestrator.\n    - For root processes/orchestrations: Must be set to null.\n    \n    This field aligns with the ArvoEvent 'subject' field, which is a URI identifying the event's subject.\n    It plays a crucial role in distributed tracing, debugging, and maintaining system coherence.\n    \n    Example:\n    - Parent process subject: \"process/parent-id-123\"\n    - Child process parentSubject$$: \"process/parent-id-123\"\n    \n    Note: Ensure this value is a valid URI as per ArvoEvent specifications.\n  ")),
+});

package/dist/ArvoOrchestratorContract/typegen.js

@@ -3,7 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArvoOrchestratorEventTypeGen = void 0;
 exports.ArvoOrchestratorEventTypeGen = {
     __prefix: "arvo.orc",
-    init: function (name) { return "".concat(exports.ArvoOrchestratorEventTypeGen.__prefix, ".").concat(name); },
-    complete: function (name) { return "".concat(exports.ArvoOrchestratorEventTypeGen.init(name), ".done"); },
-    systemError: function (name) { return "sys.".concat(exports.ArvoOrchestratorEventTypeGen.init(name), ".error"); }
+    init: function (name) {
+        return "".concat(exports.ArvoOrchestratorEventTypeGen.__prefix, ".").concat(name);
+    },
+    complete: function (name) {
+        return "".concat(exports.ArvoOrchestratorEventTypeGen.init(name), ".done");
+    },
+    systemError: function (name) {
+        return "sys.".concat(exports.ArvoOrchestratorEventTypeGen.init(name), ".error");
+    },
 };

package/dist/index.d.ts

@@ -28,6 +28,7 @@ import { createArvoOrchestratorContract } from './ArvoOrchestratorContract/helpe
 import ArvoOrchestratorContract from './ArvoOrchestratorContract';
 import { ICreateArvoOrchestratorContract, IArvoOrchestratorContract } from './ArvoOrchestratorContract/types';
 import { ArvoOrchestratorEventTypeGen } from './ArvoOrchestratorContract/typegen';
+import { ExecutionOpenTelemetryConfiguration } from './types';
 /**
  * Collection of Zod schemas for validating various aspects of Arvo events.
  * @property {z.ZodObject} CloudEventContextSchema - Schema for core CloudEvent properties.
@@ -35,6 +36,7 @@ import { ArvoOrchestratorEventTypeGen } from './ArvoOrchestratorContract/typegen
  * @property {z.ZodRecord} ArvoDataSchema - Schema for Arvo event data payload.
  * @property {z.ZodObject} ArvoExtensionSchema - Schema for Arvo-specific CloudEvent extensions.
  * @property {z.ZodObject} OpenTelemetryExtensionSchema - Schema for OpenTelemetry extensions.
+ * @property {z.ZodObject} OrchestrationInitEventBaseSchema - The base schema for the orchestrator init events.
  */
 declare const ArvoEventSchemas: {
     CloudEventContextSchema: import("zod").ZodObject<{
@@ -93,5 +95,12 @@ declare const ArvoEventSchemas: {
         traceparent: string | null;
         tracestate: string | null;
     }>;
+    OrchestrationInitEventBaseSchema: import("zod").ZodObject<{
+        parentSubject$$: import("zod").ZodNullable<import("zod").ZodString>;
+    }, "strip", import("zod").ZodTypeAny, {
+        parentSubject$$: string | null;
+    }, {
+        parentSubject$$: string | null;
+    }>;
 };
-export { ArvoEventHttpConfig, ArvoEventHttp, ArvoEvent, createArvoEvent, ArvoDataContentType, ArvoEventData, CloudEventExtension, ArvoEventSchemas, CloudEventContext, ArvoExtension, OpenTelemetryExtension, CreateArvoEvent, exceptionToSpan, logToSpan, OpenTelemetryHeaders, TelemetryLogLevel, OTelNull, validateURI, cleanString, ArvoContract, createArvoContract, ArvoContractValidators, ArvoContractRecord, IArvoContract, ResolveArvoContractRecord, ArvoContractLibrary, createArvoContractLibrary, ArvoEventFactory, createArvoEventFactory, ArvoErrorSchema, currentOpenTelemetryHeaders, OpenInference, OpenInferenceSpanKind, ArvoExecution, ArvoExecutionSpanKind, ArvoContractJSONSchema, ArvoOrchestrationSubject, ArvoOrchestrationSubjectContentSchema, ArvoOrchestratorVersionSchema, ArvoOrchestrationSubjectContent, ArvoOrchestratorVersion, InferArvoEvent, InferArvoContract, InferArvoContractType, createArvoOrchestratorContract, ArvoOrchestratorContract, ICreateArvoOrchestratorContract, IArvoOrchestratorContract, InferArvoOrchestratorContract, ArvoOrchestratorEventTypeGen };
+export { ArvoEventHttpConfig, ArvoEventHttp, ArvoEvent, createArvoEvent, ArvoDataContentType, ArvoEventData, CloudEventExtension, ArvoEventSchemas, CloudEventContext, ArvoExtension, OpenTelemetryExtension, CreateArvoEvent, exceptionToSpan, logToSpan, OpenTelemetryHeaders, TelemetryLogLevel, OTelNull, validateURI, cleanString, ArvoContract, createArvoContract, ArvoContractValidators, ArvoContractRecord, IArvoContract, ResolveArvoContractRecord, ArvoContractLibrary, createArvoContractLibrary, ArvoEventFactory, createArvoEventFactory, ArvoErrorSchema, currentOpenTelemetryHeaders, OpenInference, OpenInferenceSpanKind, ArvoExecution, ArvoExecutionSpanKind, ArvoContractJSONSchema, ArvoOrchestrationSubject, ArvoOrchestrationSubjectContentSchema, ArvoOrchestratorVersionSchema, ArvoOrchestrationSubjectContent, ArvoOrchestratorVersion, InferArvoEvent, InferArvoContract, InferArvoContractType, createArvoOrchestratorContract, ArvoOrchestratorContract, ICreateArvoOrchestratorContract, IArvoOrchestratorContract, InferArvoOrchestratorContract, ArvoOrchestratorEventTypeGen, ExecutionOpenTelemetryConfiguration, };

package/dist/index.js

@@ -55,6 +55,7 @@ var ArvoOrchestratorContract_1 = __importDefault(require("./ArvoOrchestratorCont
 exports.ArvoOrchestratorContract = ArvoOrchestratorContract_1.default;
 var typegen_1 = require("./ArvoOrchestratorContract/typegen");
 Object.defineProperty(exports, "ArvoOrchestratorEventTypeGen", { enumerable: true, get: function () { return typegen_1.ArvoOrchestratorEventTypeGen; } });
+var schema_4 = require("./ArvoOrchestratorContract/schema");
 /**
  * Collection of Zod schemas for validating various aspects of Arvo events.
  * @property {z.ZodObject} CloudEventContextSchema - Schema for core CloudEvent properties.
@@ -62,6 +63,7 @@ Object.defineProperty(exports, "ArvoOrchestratorEventTypeGen", { enumerable: tru
  * @property {z.ZodRecord} ArvoDataSchema - Schema for Arvo event data payload.
  * @property {z.ZodObject} ArvoExtensionSchema - Schema for Arvo-specific CloudEvent extensions.
  * @property {z.ZodObject} OpenTelemetryExtensionSchema - Schema for OpenTelemetry extensions.
+ * @property {z.ZodObject} OrchestrationInitEventBaseSchema - The base schema for the orchestrator init events.
  */
 var ArvoEventSchemas = {
     CloudEventContextSchema: schema_1.CloudEventContextSchema,
@@ -69,5 +71,6 @@ var ArvoEventSchemas = {
     ArvoDataSchema: schema_1.ArvoDataSchema,
     ArvoExtensionSchema: schema_1.ArvoExtensionSchema,
     OpenTelemetryExtensionSchema: schema_1.OpenTelemetryExtensionSchema,
+    OrchestrationInitEventBaseSchema: schema_4.OrchestrationInitEventBaseSchema,
 };
 exports.ArvoEventSchemas = ArvoEventSchemas;

package/dist/types.d.ts

@@ -3,6 +3,20 @@ import ArvoContract from './ArvoContract';
 import ArvoEvent from './ArvoEvent';
 import { ArvoExtension, OpenTelemetryExtension } from './ArvoEvent/types';
 import ArvoOrchestratorContract from './ArvoOrchestratorContract';
+import { Tracer } from '@opentelemetry/api';
+/**
+ * Configuration options for OpenTelemetry integration in execution context.
+ *
+ * This type defines how tracing should be configured and inherited within
+ * the execution pipeline.
+ */
+export type ExecutionOpenTelemetryConfiguration = {
+    /**
+     * Optional OpenTelemetry tracer instance to use for creating spans.
+     * If not provided, a default tracer may be used depending on the implementation.
+     */
+    tracer: Tracer;
+};
 /**
  * A type utility that infers the structure of an ArvoEvent.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-core",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "description": "This core package contains all the core classes and components of the Arvo Event Driven System",
   "main": "dist/index.js",
   "scripts": {