autotel-aws 0.13.13 → 0.13.14

package/dist/step-functions.cjs

@@ -1,35 +1,560 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_attributes = require('./attributes.cjs');
+const require_sdk_wrapper = require('./sdk-wrapper-BDrcyEQ_.cjs');
+let autotel = require("autotel");
+let _opentelemetry_api = require("@opentelemetry/api");
 
-var chunkKNRQYDAS_cjs = require('./chunk-KNRQYDAS.cjs');
-require('./chunk-UZEJV2YD.cjs');
-require('./chunk-Q3DMMQ7K.cjs');
-require('./chunk-JEQ2X3Z6.cjs');
+//#region src/step-functions/index.ts
+/**
+* Step Functions instrumentation
+*
+* Provides semantic helpers for tracing AWS Step Functions operations
+* with context propagation for distributed tracing across state machines.
+*
+* @example Start workflow with trace context
+* ```typescript
+* import { StepFunctionsExecutor, injectTraceContext } from 'autotel-aws/step-functions';
+* import { SFNClient } from '@aws-sdk/client-sfn';
+*
+* const sfn = new SFNClient({});
+* const executor = new StepFunctionsExecutor(sfn, {
+*   stateMachineArn: 'arn:aws:states:us-east-1:123456789:stateMachine:OrderProcessor'
+* });
+*
+* // Start execution with automatic trace context injection
+* const result = await executor.startExecution({
+*   input: { orderId: '123', items: [...] },
+*   name: 'order-123-execution'
+* });
+* ```
+*
+* @example Extract context in Lambda invoked by Step Functions
+* ```typescript
+* import { extractStepFunctionsContext } from 'autotel-aws/step-functions';
+* import { wrapHandler } from 'autotel-aws/lambda';
+*
+* export const handler = wrapHandler(async (event) => {
+*   // Extract trace context from Step Functions input
+*   const parentContext = extractStepFunctionsContext(event);
+*
+*   // Process the order (without the trace context fields)
+*   const { orderId, items } = event;
+*   await processOrder(orderId, items);
+*
+*   return { status: 'completed' };
+* });
+* ```
+*
+* @example Activity worker with context propagation
+* ```typescript
+* import { StepFunctionsActivityWorker } from 'autotel-aws/step-functions';
+*
+* const worker = new StepFunctionsActivityWorker(sfn, {
+*   activityArn: 'arn:aws:states:us-east-1:123456789:activity:ProcessPayment'
+* });
+*
+* // Worker extracts trace context and creates child spans
+* await worker.poll(async (input, taskToken, ctx) => {
+*   ctx.setAttribute('payment.amount', input.amount);
+*   const result = await processPayment(input);
+*   return result;
+* });
+* ```
+*/
+/**
+* Inject W3C Trace Context into Step Functions execution input
+*
+* Adds `_traceContext` field with traceparent, tracestate, and baggage.
+* This enables distributed tracing across Step Functions executions
+* and Lambda functions invoked by the state machine.
+*
+* @param input - The original execution input
+* @returns Input with trace context injected
+*
+* @example
+* ```typescript
+* const input = { orderId: '123', items: [...] };
+* const inputWithContext = injectTraceContext(input);
+* // { orderId: '123', items: [...], _traceContext: { traceparent: '...' } }
+*
+* await sfn.send(new StartExecutionCommand({
+*   stateMachineArn: 'arn:...',
+*   input: JSON.stringify(inputWithContext)
+* }));
+* ```
+*/
+function injectTraceContext(input) {
+	const carrier = {};
+	_opentelemetry_api.propagation.inject(_opentelemetry_api.context.active(), carrier);
+	if (!carrier.traceparent) return input;
+	return {
+		...input,
+		_traceContext: {
+			traceparent: carrier.traceparent,
+			...carrier.tracestate && { tracestate: carrier.tracestate },
+			...carrier.baggage && { baggage: carrier.baggage }
+		}
+	};
+}
+/**
+* Extract W3C Trace Context from Step Functions input
+*
+* Extracts the `_traceContext` field added by injectTraceContext.
+* Returns the SpanContext if present, or undefined.
+*
+* @param input - Step Functions input (event in Lambda handler)
+* @returns SpanContext if trace context was found, undefined otherwise
+*
+* @example
+* ```typescript
+* // In a Lambda invoked by Step Functions
+* export const handler = async (event) => {
+*   const parentContext = extractStepFunctionsContext(event);
+*   // Use parentContext to link traces...
+*
+*   // Access data without trace context
+*   const { orderId, items } = stripTraceContext(event);
+* };
+* ```
+*/
+function extractStepFunctionsContext(input) {
+	if (typeof input !== "object" || input === null || !("_traceContext" in input)) return;
+	const traceContext = input._traceContext;
+	if (!traceContext?.traceparent) return;
+	const carrier = {
+		traceparent: traceContext.traceparent,
+		...traceContext.tracestate && { tracestate: traceContext.tracestate },
+		...traceContext.baggage && { baggage: traceContext.baggage }
+	};
+	const span = _opentelemetry_api.propagation.extract(_opentelemetry_api.context.active(), carrier).getValue(Symbol.for("OpenTelemetry Context Key SPAN"));
+	if (span && typeof span === "object") {
+		if ("spanContext" in span && typeof span.spanContext === "function") return span.spanContext();
+		if ("traceId" in span && "spanId" in span) return span;
+	}
+}
+/**
+* Strip trace context fields from Step Functions input
+*
+* Returns the input without `_traceContext` field for cleaner processing.
+*
+* @param input - Step Functions input with optional trace context
+* @returns Input without trace context fields
+*
+* @example
+* ```typescript
+* const event = { orderId: '123', _traceContext: { ... } };
+* const cleanInput = stripTraceContext(event);
+* // { orderId: '123' }
+* ```
+*/
+function stripTraceContext(input) {
+	const { _traceContext: _, ...rest } = input;
+	return rest;
+}
+/**
+* Trace Step Functions operations
+*
+* Creates a traced function that automatically sets Step Functions attributes.
+*
+* @param config - Step Functions operation configuration
+* @returns A higher-order function that wraps your Step Functions operation with tracing
+*
+* @remarks
+* Semantic attributes set automatically:
+* - `aws.stepfunctions.state_machine_arn` - State machine ARN
+*
+* Additional attributes you should set in your handler:
+* - `aws.stepfunctions.execution_arn` - Execution ARN
+* - `aws.stepfunctions.execution_name` - Execution name
+*
+* @example
+* ```typescript
+* export const startWorkflow = traceStepFunction({
+*   stateMachineArn: 'arn:aws:states:us-east-1:123456789:stateMachine:OrderProcessor',
+*   operation: 'StartExecution'
+* })(ctx => async (input: object, executionName?: string) => {
+*   const result = await sfn.send(new StartExecutionCommand({
+*     stateMachineArn: 'arn:aws:states:...',
+*     input: JSON.stringify(injectTraceContext(input)),
+*     name: executionName
+*   }));
+*
+*   ctx.setAttribute('aws.stepfunctions.execution_arn', result.executionArn ?? '');
+*   return result;
+* });
+* ```
+*/
+function traceStepFunction(config) {
+	const operation = config.operation ?? "execute";
+	return function wrapper(fn) {
+		return (0, autotel.trace)(`stepfunctions.${operation}`, (ctx) => async (...args) => {
+			ctx.setAttributes(require_attributes.buildStepFunctionsAttributes({ stateMachineArn: config.stateMachineArn }));
+			return fn(ctx)(...args);
+		});
+	};
+}
+/**
+* Step Functions Executor with automatic trace context injection
+*
+* Wraps an SFN client to automatically:
+* - Create spans for all operations
+* - Inject W3C Trace Context into execution input
+* - Set proper semantic attributes
+*
+* @example Basic usage
+* ```typescript
+* import { StepFunctionsExecutor } from 'autotel-aws/step-functions';
+* import { SFNClient } from '@aws-sdk/client-sfn';
+*
+* const sfn = new SFNClient({ region: 'us-east-1' });
+* const executor = new StepFunctionsExecutor(sfn, {
+*   stateMachineArn: 'arn:aws:states:us-east-1:123456789:stateMachine:OrderProcessor'
+* });
+*
+* // Start execution with automatic trace context
+* const result = await executor.startExecution({
+*   input: { orderId: '123', items: ['item1', 'item2'] },
+*   name: 'order-123-execution'
+* });
+*
+* console.log('Execution ARN:', result.executionArn);
+* ```
+*
+* @example Express workflow (sync execution)
+* ```typescript
+* // Express workflows return synchronously
+* const result = await executor.startSyncExecution({
+*   input: { orderId: '123' }
+* });
+*
+* if (result.status === 'SUCCEEDED') {
+*   const output = JSON.parse(result.output || '{}');
+*   console.log('Workflow output:', output);
+* }
+* ```
+*/
+var StepFunctionsExecutor = class {
+	client;
+	config;
+	stateMachineName;
+	constructor(client, config) {
+		this.client = require_sdk_wrapper.wrapSDKClient(client, config.service);
+		this.config = {
+			injectTraceContext: true,
+			...config
+		};
+		this.stateMachineName = config.stateMachineArn.split(":").pop() || "unknown";
+	}
+	/**
+	* Start a new execution of the state machine
+	*
+	* @param execution - Execution input and optional name
+	* @returns Promise with execution ARN and start date
+	*/
+	async startExecution(execution) {
+		return (0, autotel.trace)(`stepfunctions.StartExecution`, async (ctx) => {
+			ctx.setAttributes(require_attributes.buildStepFunctionsAttributes({ stateMachineArn: this.config.stateMachineArn }));
+			ctx.setAttribute("aws.stepfunctions.state_machine_name", this.stateMachineName);
+			if (execution.name) ctx.setAttribute("aws.stepfunctions.execution_name", execution.name);
+			const inputData = this.config.injectTraceContext ? injectTraceContext(execution.input) : execution.input;
+			const input = {
+				stateMachineArn: this.config.stateMachineArn,
+				input: JSON.stringify(inputData),
+				name: execution.name,
+				traceHeader: execution.traceHeader
+			};
+			try {
+				const { StartExecutionCommand } = await import("@aws-sdk/client-sfn");
+				const result = await this.client.send(new StartExecutionCommand(input));
+				if (result.executionArn) ctx.setAttribute("aws.stepfunctions.execution_arn", result.executionArn);
+				ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+				return {
+					executionArn: result.executionArn,
+					startDate: result.startDate
+				};
+			} catch (error) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : "StartExecution failed"
+				});
+				throw error;
+			}
+		});
+	}
+	/**
+	* Start a synchronous execution (Express workflows only)
+	*
+	* @param execution - Execution input and optional name
+	* @returns Promise with execution result including output
+	*/
+	async startSyncExecution(execution) {
+		return (0, autotel.trace)(`stepfunctions.StartSyncExecution`, async (ctx) => {
+			ctx.setAttributes(require_attributes.buildStepFunctionsAttributes({ stateMachineArn: this.config.stateMachineArn }));
+			ctx.setAttribute("aws.stepfunctions.state_machine_name", this.stateMachineName);
+			ctx.setAttribute("aws.stepfunctions.execution_type", "express");
+			if (execution.name) ctx.setAttribute("aws.stepfunctions.execution_name", execution.name);
+			const inputData = this.config.injectTraceContext ? injectTraceContext(execution.input) : execution.input;
+			const input = {
+				stateMachineArn: this.config.stateMachineArn,
+				input: JSON.stringify(inputData),
+				name: execution.name,
+				traceHeader: execution.traceHeader
+			};
+			try {
+				const { StartSyncExecutionCommand } = await import("@aws-sdk/client-sfn");
+				const result = await this.client.send(new StartSyncExecutionCommand(input));
+				if (result.executionArn) ctx.setAttribute("aws.stepfunctions.execution_arn", result.executionArn);
+				if (result.status) ctx.setAttribute("aws.stepfunctions.execution_status", result.status);
+				if (result.status === "FAILED" || result.status === "TIMED_OUT") ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: result.error || result.status
+				});
+				else ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+				return {
+					executionArn: result.executionArn,
+					status: result.status,
+					output: result.output,
+					error: result.error,
+					cause: result.cause,
+					billingDetails: result.billingDetails ? {
+						billedMemoryUsedInMB: result.billingDetails.billedMemoryUsedInMB,
+						billedDurationInMilliseconds: result.billingDetails.billedDurationInMilliseconds
+					} : void 0
+				};
+			} catch (error) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : "StartSyncExecution failed"
+				});
+				throw error;
+			}
+		});
+	}
+	/**
+	* Describe an execution
+	*
+	* @param executionArn - ARN of the execution to describe
+	* @returns Promise with execution details
+	*/
+	async describeExecution(executionArn) {
+		return (0, autotel.trace)(`stepfunctions.DescribeExecution`, async (ctx) => {
+			ctx.setAttributes(require_attributes.buildStepFunctionsAttributes({ stateMachineArn: this.config.stateMachineArn }));
+			ctx.setAttribute("aws.stepfunctions.execution_arn", executionArn);
+			try {
+				const { DescribeExecutionCommand } = await import("@aws-sdk/client-sfn");
+				const result = await this.client.send(new DescribeExecutionCommand({ executionArn }));
+				if (result.status) ctx.setAttribute("aws.stepfunctions.execution_status", result.status);
+				ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+				return {
+					executionArn: result.executionArn,
+					stateMachineArn: result.stateMachineArn,
+					name: result.name,
+					status: result.status,
+					startDate: result.startDate,
+					stopDate: result.stopDate,
+					input: result.input,
+					output: result.output,
+					error: result.error,
+					cause: result.cause
+				};
+			} catch (error) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : "DescribeExecution failed"
+				});
+				throw error;
+			}
+		});
+	}
+	/**
+	* Stop an execution
+	*
+	* @param executionArn - ARN of the execution to stop
+	* @param options - Optional error and cause for the stop
+	* @returns Promise with stop date
+	*/
+	async stopExecution(executionArn, options) {
+		return (0, autotel.trace)(`stepfunctions.StopExecution`, async (ctx) => {
+			ctx.setAttributes(require_attributes.buildStepFunctionsAttributes({ stateMachineArn: this.config.stateMachineArn }));
+			ctx.setAttribute("aws.stepfunctions.execution_arn", executionArn);
+			try {
+				const { StopExecutionCommand } = await import("@aws-sdk/client-sfn");
+				const result = await this.client.send(new StopExecutionCommand({
+					executionArn,
+					error: options?.error,
+					cause: options?.cause
+				}));
+				ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+				return { stopDate: result.stopDate };
+			} catch (error) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : "StopExecution failed"
+				});
+				throw error;
+			}
+		});
+	}
+};
+/**
+* Step Functions Activity Worker with trace context extraction
+*
+* Polls for activity tasks and processes them with automatic tracing.
+* Extracts trace context from task input for distributed tracing.
+*
+* @example Basic activity worker
+* ```typescript
+* import { StepFunctionsActivityWorker } from 'autotel-aws/step-functions';
+* import { SFNClient } from '@aws-sdk/client-sfn';
+*
+* const sfn = new SFNClient({ region: 'us-east-1' });
+* const worker = new StepFunctionsActivityWorker(sfn, {
+*   activityArn: 'arn:aws:states:us-east-1:123456789:activity:ProcessPayment',
+*   workerName: 'payment-worker-1'
+* });
+*
+* // Process tasks with automatic tracing
+* await worker.poll(async (input, taskToken, ctx) => {
+*   ctx.setAttribute('payment.amount', input.amount);
+*   ctx.setAttribute('payment.currency', input.currency);
+*
+*   const result = await processPayment(input);
+*
+*   ctx.setAttribute('payment.status', result.status);
+*   return result;
+* });
+* ```
+*
+* @example Continuous polling with error handling
+* ```typescript
+* async function runWorker() {
+*   while (true) {
+*     try {
+*       await worker.poll(async (input, taskToken, ctx) => {
+*         return await processTask(input);
+*       });
+*     } catch (error) {
+*       console.error('Worker error:', error);
+*       // Brief pause before retrying
+*       await new Promise(resolve => setTimeout(resolve, 1000));
+*     }
+*   }
+* }
+* ```
+*/
+var StepFunctionsActivityWorker = class {
+	client;
+	config;
+	activityName;
+	constructor(client, config) {
+		this.client = require_sdk_wrapper.wrapSDKClient(client, config.service);
+		this.config = {
+			extractTraceContext: true,
+			...config
+		};
+		this.activityName = config.activityArn.split(":").pop() || "unknown";
+	}
+	/**
+	* Poll for an activity task and process it
+	*
+	* @param processor - Function to process the task input
+	* @returns Promise that resolves when the task is processed
+	*/
+	async poll(processor) {
+		return (0, autotel.trace)(`stepfunctions.activity.poll`, async (ctx) => {
+			ctx.setAttribute("aws.stepfunctions.activity_arn", this.config.activityArn);
+			ctx.setAttribute("aws.stepfunctions.activity_name", this.activityName);
+			if (this.config.workerName) ctx.setAttribute("aws.stepfunctions.worker_name", this.config.workerName);
+			try {
+				const { GetActivityTaskCommand } = await import("@aws-sdk/client-sfn");
+				const task = await this.client.send(new GetActivityTaskCommand({
+					activityArn: this.config.activityArn,
+					workerName: this.config.workerName
+				}));
+				if (!task.taskToken || !task.input) {
+					ctx.setAttribute("aws.stepfunctions.activity_task_received", false);
+					ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+					return;
+				}
+				ctx.setAttribute("aws.stepfunctions.activity_task_received", true);
+				const rawInput = JSON.parse(task.input);
+				if (this.config.extractTraceContext) {
+					if (extractStepFunctionsContext(rawInput)) ctx.setAttribute("aws.stepfunctions.trace_context_extracted", true);
+				}
+				const output = await processor(stripTraceContext(rawInput), task.taskToken, ctx);
+				const { SendTaskSuccessCommand } = await import("@aws-sdk/client-sfn");
+				await this.client.send(new SendTaskSuccessCommand({
+					taskToken: task.taskToken,
+					output: JSON.stringify(output)
+				}));
+				ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+			} catch (error) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : "Activity processing failed"
+				});
+				throw error;
+			}
+		});
+	}
+	/**
+	* Send a task heartbeat
+	*
+	* For long-running activities, send heartbeats to prevent timeout.
+	*
+	* @param taskToken - The task token from GetActivityTask
+	*/
+	async sendHeartbeat(taskToken) {
+		return (0, autotel.trace)(`stepfunctions.SendTaskHeartbeat`, async (ctx) => {
+			ctx.setAttribute("aws.stepfunctions.activity_arn", this.config.activityArn);
+			try {
+				const { SendTaskHeartbeatCommand } = await import("@aws-sdk/client-sfn");
+				await this.client.send(new SendTaskHeartbeatCommand({ taskToken }));
+				ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+			} catch (error) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error instanceof Error ? error.message : "SendTaskHeartbeat failed"
+				});
+				throw error;
+			}
+		});
+	}
+	/**
+	* Send task failure
+	*
+	* @param taskToken - The task token from GetActivityTask
+	* @param error - Error code
+	* @param cause - Error cause description
+	*/
+	async sendFailure(taskToken, error, cause) {
+		return (0, autotel.trace)(`stepfunctions.SendTaskFailure`, async (ctx) => {
+			ctx.setAttribute("aws.stepfunctions.activity_arn", this.config.activityArn);
+			ctx.setAttribute("aws.stepfunctions.task_error", error);
+			try {
+				const { SendTaskFailureCommand } = await import("@aws-sdk/client-sfn");
+				await this.client.send(new SendTaskFailureCommand({
+					taskToken,
+					error,
+					cause
+				}));
+				ctx.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+			} catch (error_) {
+				ctx.setStatus({
+					code: _opentelemetry_api.SpanStatusCode.ERROR,
+					message: error_ instanceof Error ? error_.message : "SendTaskFailure failed"
+				});
+				throw error_;
+			}
+		});
+	}
+};
 
-
-
-Object.defineProperty(exports, "StepFunctionsActivityWorker", {
-  enumerable: true,
-  get: function () { return chunkKNRQYDAS_cjs.StepFunctionsActivityWorker; }
-});
-Object.defineProperty(exports, "StepFunctionsExecutor", {
-  enumerable: true,
-  get: function () { return chunkKNRQYDAS_cjs.StepFunctionsExecutor; }
-});
-Object.defineProperty(exports, "extractStepFunctionsContext", {
-  enumerable: true,
-  get: function () { return chunkKNRQYDAS_cjs.extractStepFunctionsContext; }
-});
-Object.defineProperty(exports, "injectTraceContext", {
-  enumerable: true,
-  get: function () { return chunkKNRQYDAS_cjs.injectTraceContext; }
-});
-Object.defineProperty(exports, "stripTraceContext", {
-  enumerable: true,
-  get: function () { return chunkKNRQYDAS_cjs.stripTraceContext; }
-});
-Object.defineProperty(exports, "traceStepFunction", {
-  enumerable: true,
-  get: function () { return chunkKNRQYDAS_cjs.traceStepFunction; }
-});
-//# sourceMappingURL=step-functions.cjs.map
+//#endregion
+exports.StepFunctionsActivityWorker = StepFunctionsActivityWorker;
+exports.StepFunctionsExecutor = StepFunctionsExecutor;
+exports.extractStepFunctionsContext = extractStepFunctionsContext;
+exports.injectTraceContext = injectTraceContext;
+exports.stripTraceContext = stripTraceContext;
+exports.traceStepFunction = traceStepFunction;
 //# sourceMappingURL=step-functions.cjs.map

package/dist/step-functions.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"step-functions.cjs"}
+{"version":3,"file":"step-functions.cjs","names":["context","propagation","buildStepFunctionsAttributes","wrapSDKClient","SpanStatusCode"],"sources":["../src/step-functions/index.ts"],"sourcesContent":["/**\n * Step Functions instrumentation\n *\n * Provides semantic helpers for tracing AWS Step Functions operations\n * with context propagation for distributed tracing across state machines.\n *\n * @example Start workflow with trace context\n * ```typescript\n * import { StepFunctionsExecutor, injectTraceContext } from 'autotel-aws/step-functions';\n * import { SFNClient } from '@aws-sdk/client-sfn';\n *\n * const sfn = new SFNClient({});\n * const executor = new StepFunctionsExecutor(sfn, {\n *   stateMachineArn: 'arn:aws:states:us-east-1:123456789:stateMachine:OrderProcessor'\n * });\n *\n * // Start execution with automatic trace context injection\n * const result = await executor.startExecution({\n *   input: { orderId: '123', items: [...] },\n *   name: 'order-123-execution'\n * });\n * ```\n *\n * @example Extract context in Lambda invoked by Step Functions\n * ```typescript\n * import { extractStepFunctionsContext } from 'autotel-aws/step-functions';\n * import { wrapHandler } from 'autotel-aws/lambda';\n *\n * export const handler = wrapHandler(async (event) => {\n *   // Extract trace context from Step Functions input\n *   const parentContext = extractStepFunctionsContext(event);\n *\n *   // Process the order (without the trace context fields)\n *   const { orderId, items } = event;\n *   await processOrder(orderId, items);\n *\n *   return { status: 'completed' };\n * });\n * ```\n *\n * @example Activity worker with context propagation\n * ```typescript\n * import { StepFunctionsActivityWorker } from 'autotel-aws/step-functions';\n *\n * const worker = new StepFunctionsActivityWorker(sfn, {\n *   activityArn: 'arn:aws:states:us-east-1:123456789:activity:ProcessPayment'\n * });\n *\n * // Worker extracts trace context and creates child spans\n * await worker.poll(async (input, taskToken, ctx) => {\n *   ctx.setAttribute('payment.amount', input.amount);\n *   const result = await processPayment(input);\n *   return result;\n * });\n * ```\n */\n\nimport { trace, type TraceContext } from 'autotel';\nimport { context, propagation, SpanStatusCode } from '@opentelemetry/api';\nimport type { SpanContext } from '@opentelemetry/api';\nimport { buildStepFunctionsAttributes } from '../attributes';\nimport { wrapSDKClient } from '../common/sdk-wrapper';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Step Functions operation configuration\n */\nexport interface TraceStepFunctionConfig {\n  /**\n   * State machine ARN\n   * Sets `aws.stepfunctions.state_machine_arn` attribute.\n   */\n  stateMachineArn: string;\n\n  /**\n   * Operation type\n   * Used to generate the span name: `stepfunctions.{operation}`\n   * @default 'execute'\n   */\n  operation?:\n    | 'StartExecution'\n    | 'DescribeExecution'\n    | 'StopExecution'\n    | 'ListExecutions'\n    | 'SendTaskSuccess'\n    | 'SendTaskFailure'\n    | 'execute'; // Legacy alias for StartExecution\n}\n\n/**\n * Configuration for StepFunctionsExecutor\n */\nexport interface StepFunctionsExecutorConfig {\n  /**\n   * State machine ARN\n   */\n  stateMachineArn: string;\n\n  /**\n   * Inject W3C Trace Context into execution input\n   * @default true\n   */\n  injectTraceContext?: boolean;\n\n  /**\n   * Optional service name for tracing\n   */\n  service?: string;\n}\n\n/**\n * Execution input with optional trace context\n */\nexport interface ExecutionInput<T = Record<string, unknown>> {\n  /**\n   * The input data for the execution\n   */\n  input: T;\n\n  /**\n   * Optional execution name (must be unique within 90 days)\n   */\n  name?: string;\n\n  /**\n   * Optional trace ID for idempotency\n   */\n  traceHeader?: string;\n}\n\n/**\n * Configuration for StepFunctionsActivityWorker\n */\nexport interface StepFunctionsActivityWorkerConfig {\n  /**\n   * Activity ARN\n   */\n  activityArn: string;\n\n  /**\n   * Worker name for identification\n   */\n  workerName?: string;\n\n  /**\n   * Extract trace context from activity input\n   * @default true\n   */\n  extractTraceContext?: boolean;\n\n  /**\n   * Optional service name for tracing\n   */\n  service?: string;\n}\n\n/**\n * Trace context fields injected into Step Functions input\n */\ninterface TraceContextFields {\n  _traceContext?: {\n    traceparent: string;\n    tracestate?: string;\n    baggage?: string;\n  };\n}\n\n// ============================================================================\n// Context Propagation Helpers\n// ============================================================================\n\n/**\n * Inject W3C Trace Context into Step Functions execution input\n *\n * Adds `_traceContext` field with traceparent, tracestate, and baggage.\n * This enables distributed tracing across Step Functions executions\n * and Lambda functions invoked by the state machine.\n *\n * @param input - The original execution input\n * @returns Input with trace context injected\n *\n * @example\n * ```typescript\n * const input = { orderId: '123', items: [...] };\n * const inputWithContext = injectTraceContext(input);\n * // { orderId: '123', items: [...], _traceContext: { traceparent: '...' } }\n *\n * await sfn.send(new StartExecutionCommand({\n *   stateMachineArn: 'arn:...',\n *   input: JSON.stringify(inputWithContext)\n * }));\n * ```\n */\nexport function injectTraceContext<T extends Record<string, unknown>>(\n  input: T,\n): T & TraceContextFields {\n  const carrier: Record<string, string> = {};\n  propagation.inject(context.active(), carrier);\n\n  if (!carrier.traceparent) {\n    return input;\n  }\n\n  return {\n    ...input,\n    _traceContext: {\n      traceparent: carrier.traceparent,\n      ...(carrier.tracestate && { tracestate: carrier.tracestate }),\n      ...(carrier.baggage && { baggage: carrier.baggage }),\n    },\n  };\n}\n\n/**\n * Extract W3C Trace Context from Step Functions input\n *\n * Extracts the `_traceContext` field added by injectTraceContext.\n * Returns the SpanContext if present, or undefined.\n *\n * @param input - Step Functions input (event in Lambda handler)\n * @returns SpanContext if trace context was found, undefined otherwise\n *\n * @example\n * ```typescript\n * // In a Lambda invoked by Step Functions\n * export const handler = async (event) => {\n *   const parentContext = extractStepFunctionsContext(event);\n *   // Use parentContext to link traces...\n *\n *   // Access data without trace context\n *   const { orderId, items } = stripTraceContext(event);\n * };\n * ```\n */\nexport function extractStepFunctionsContext(\n  input: unknown,\n): SpanContext | undefined {\n  if (\n    typeof input !== 'object' ||\n    input === null ||\n    !('_traceContext' in input)\n  ) {\n    return undefined;\n  }\n\n  const traceContext = (input as TraceContextFields)._traceContext;\n  if (!traceContext?.traceparent) {\n    return undefined;\n  }\n\n  // Use W3C Trace Context propagator to extract\n  const carrier: Record<string, string> = {\n    traceparent: traceContext.traceparent,\n    ...(traceContext.tracestate && { tracestate: traceContext.tracestate }),\n    ...(traceContext.baggage && { baggage: traceContext.baggage }),\n  };\n\n  const extractedContext = propagation.extract(context.active(), carrier);\n  const span = extractedContext.getValue(Symbol.for('OpenTelemetry Context Key SPAN'));\n\n  // Handle both Span and SpanContext\n  if (span && typeof span === 'object') {\n    if ('spanContext' in span && typeof span.spanContext === 'function') {\n      return span.spanContext() as SpanContext;\n    }\n    // Might already be a SpanContext\n    if ('traceId' in span && 'spanId' in span) {\n      return span as SpanContext;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Strip trace context fields from Step Functions input\n *\n * Returns the input without `_traceContext` field for cleaner processing.\n *\n * @param input - Step Functions input with optional trace context\n * @returns Input without trace context fields\n *\n * @example\n * ```typescript\n * const event = { orderId: '123', _traceContext: { ... } };\n * const cleanInput = stripTraceContext(event);\n * // { orderId: '123' }\n * ```\n */\nexport function stripTraceContext<T extends Record<string, unknown>>(\n  input: T,\n): Omit<T, '_traceContext'> {\n  const { _traceContext: _, ...rest } = input as T & TraceContextFields;\n  return rest as Omit<T, '_traceContext'>;\n}\n\n// ============================================================================\n// Trace Helper (Original API)\n// ============================================================================\n\n/**\n * Trace Step Functions operations\n *\n * Creates a traced function that automatically sets Step Functions attributes.\n *\n * @param config - Step Functions operation configuration\n * @returns A higher-order function that wraps your Step Functions operation with tracing\n *\n * @remarks\n * Semantic attributes set automatically:\n * - `aws.stepfunctions.state_machine_arn` - State machine ARN\n *\n * Additional attributes you should set in your handler:\n * - `aws.stepfunctions.execution_arn` - Execution ARN\n * - `aws.stepfunctions.execution_name` - Execution name\n *\n * @example\n * ```typescript\n * export const startWorkflow = traceStepFunction({\n *   stateMachineArn: 'arn:aws:states:us-east-1:123456789:stateMachine:OrderProcessor',\n *   operation: 'StartExecution'\n * })(ctx => async (input: object, executionName?: string) => {\n *   const result = await sfn.send(new StartExecutionCommand({\n *     stateMachineArn: 'arn:aws:states:...',\n *     input: JSON.stringify(injectTraceContext(input)),\n *     name: executionName\n *   }));\n *\n *   ctx.setAttribute('aws.stepfunctions.execution_arn', result.executionArn ?? '');\n *   return result;\n * });\n * ```\n */\nexport function traceStepFunction(config: TraceStepFunctionConfig) {\n  const operation = config.operation ?? 'execute';\n\n  return function wrapper<TArgs extends unknown[], TReturn>(\n    fn: (ctx: TraceContext) => (...args: TArgs) => Promise<TReturn>,\n  ): (...args: TArgs) => Promise<TReturn> {\n    // Use autotel's trace() which properly handles the factory pattern\n    return trace(\n      `stepfunctions.${operation}`,\n      (ctx: TraceContext) =>\n        async (...args: TArgs): Promise<TReturn> => {\n          // Set Step Functions attributes\n          ctx.setAttributes(\n            buildStepFunctionsAttributes({\n              stateMachineArn: config.stateMachineArn,\n            }),\n          );\n\n          // Get the user's handler and execute with forwarded arguments\n          const handler = fn(ctx);\n          return handler(...args);\n        },\n    );\n  };\n}\n\n// ============================================================================\n// StepFunctionsExecutor Class\n// ============================================================================\n\n/**\n * Step Functions Executor with automatic trace context injection\n *\n * Wraps an SFN client to automatically:\n * - Create spans for all operations\n * - Inject W3C Trace Context into execution input\n * - Set proper semantic attributes\n *\n * @example Basic usage\n * ```typescript\n * import { StepFunctionsExecutor } from 'autotel-aws/step-functions';\n * import { SFNClient } from '@aws-sdk/client-sfn';\n *\n * const sfn = new SFNClient({ region: 'us-east-1' });\n * const executor = new StepFunctionsExecutor(sfn, {\n *   stateMachineArn: 'arn:aws:states:us-east-1:123456789:stateMachine:OrderProcessor'\n * });\n *\n * // Start execution with automatic trace context\n * const result = await executor.startExecution({\n *   input: { orderId: '123', items: ['item1', 'item2'] },\n *   name: 'order-123-execution'\n * });\n *\n * console.log('Execution ARN:', result.executionArn);\n * ```\n *\n * @example Express workflow (sync execution)\n * ```typescript\n * // Express workflows return synchronously\n * const result = await executor.startSyncExecution({\n *   input: { orderId: '123' }\n * });\n *\n * if (result.status === 'SUCCEEDED') {\n *   const output = JSON.parse(result.output || '{}');\n *   console.log('Workflow output:', output);\n * }\n * ```\n */\nexport class StepFunctionsExecutor<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<Pick<StepFunctionsExecutorConfig, 'stateMachineArn'>> &\n    StepFunctionsExecutorConfig;\n  private stateMachineName: string;\n\n  constructor(client: TClient, config: StepFunctionsExecutorConfig) {\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      injectTraceContext: true,\n      ...config,\n    };\n    // Extract state machine name from ARN (last segment)\n    this.stateMachineName = config.stateMachineArn.split(':').pop() || 'unknown';\n  }\n\n  /**\n   * Start a new execution of the state machine\n   *\n   * @param execution - Execution input and optional name\n   * @returns Promise with execution ARN and start date\n   */\n  async startExecution<T extends Record<string, unknown>>(\n    execution: ExecutionInput<T>,\n  ): Promise<{\n    executionArn?: string;\n    startDate?: Date;\n  }> {\n    return trace(`stepfunctions.StartExecution`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildStepFunctionsAttributes({\n          stateMachineArn: this.config.stateMachineArn,\n        }),\n      );\n      ctx.setAttribute('aws.stepfunctions.state_machine_name', this.stateMachineName);\n\n      if (execution.name) {\n        ctx.setAttribute('aws.stepfunctions.execution_name', execution.name);\n      }\n\n      // Optionally inject trace context\n      const inputData = this.config.injectTraceContext\n        ? injectTraceContext(execution.input)\n        : execution.input;\n\n      const input = {\n        stateMachineArn: this.config.stateMachineArn,\n        input: JSON.stringify(inputData),\n        name: execution.name,\n        traceHeader: execution.traceHeader,\n      };\n\n      try {\n        const { StartExecutionCommand } = await import('@aws-sdk/client-sfn');\n        const result = await this.client.send(new StartExecutionCommand(input));\n\n        if (result.executionArn) {\n          ctx.setAttribute('aws.stepfunctions.execution_arn', result.executionArn);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return {\n          executionArn: result.executionArn,\n          startDate: result.startDate,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'StartExecution failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Start a synchronous execution (Express workflows only)\n   *\n   * @param execution - Execution input and optional name\n   * @returns Promise with execution result including output\n   */\n  async startSyncExecution<T extends Record<string, unknown>>(\n    execution: ExecutionInput<T>,\n  ): Promise<{\n    executionArn?: string;\n    status?: 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT';\n    output?: string;\n    error?: string;\n    cause?: string;\n    billingDetails?: {\n      billedMemoryUsedInMB?: number;\n      billedDurationInMilliseconds?: number;\n    };\n  }> {\n    return trace(`stepfunctions.StartSyncExecution`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildStepFunctionsAttributes({\n          stateMachineArn: this.config.stateMachineArn,\n        }),\n      );\n      ctx.setAttribute('aws.stepfunctions.state_machine_name', this.stateMachineName);\n      ctx.setAttribute('aws.stepfunctions.execution_type', 'express');\n\n      if (execution.name) {\n        ctx.setAttribute('aws.stepfunctions.execution_name', execution.name);\n      }\n\n      // Optionally inject trace context\n      const inputData = this.config.injectTraceContext\n        ? injectTraceContext(execution.input)\n        : execution.input;\n\n      const input = {\n        stateMachineArn: this.config.stateMachineArn,\n        input: JSON.stringify(inputData),\n        name: execution.name,\n        traceHeader: execution.traceHeader,\n      };\n\n      try {\n        const { StartSyncExecutionCommand } = await import('@aws-sdk/client-sfn');\n        const result = await this.client.send(new StartSyncExecutionCommand(input));\n\n        if (result.executionArn) {\n          ctx.setAttribute('aws.stepfunctions.execution_arn', result.executionArn);\n        }\n        if (result.status) {\n          ctx.setAttribute('aws.stepfunctions.execution_status', result.status);\n        }\n\n        if (result.status === 'FAILED' || result.status === 'TIMED_OUT') {\n          ctx.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: result.error || result.status,\n          });\n        } else {\n          ctx.setStatus({ code: SpanStatusCode.OK });\n        }\n\n        return {\n          executionArn: result.executionArn,\n          status: result.status as 'SUCCEEDED' | 'FAILED' | 'TIMED_OUT' | undefined,\n          output: result.output,\n          error: result.error,\n          cause: result.cause,\n          billingDetails: result.billingDetails\n            ? {\n                billedMemoryUsedInMB: result.billingDetails.billedMemoryUsedInMB,\n                billedDurationInMilliseconds:\n                  result.billingDetails.billedDurationInMilliseconds,\n              }\n            : undefined,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'StartSyncExecution failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Describe an execution\n   *\n   * @param executionArn - ARN of the execution to describe\n   * @returns Promise with execution details\n   */\n  async describeExecution(executionArn: string): Promise<{\n    executionArn?: string;\n    stateMachineArn?: string;\n    name?: string;\n    status?: string;\n    startDate?: Date;\n    stopDate?: Date;\n    input?: string;\n    output?: string;\n    error?: string;\n    cause?: string;\n  }> {\n    return trace(`stepfunctions.DescribeExecution`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildStepFunctionsAttributes({\n          stateMachineArn: this.config.stateMachineArn,\n        }),\n      );\n      ctx.setAttribute('aws.stepfunctions.execution_arn', executionArn);\n\n      try {\n        const { DescribeExecutionCommand } = await import('@aws-sdk/client-sfn');\n        const result = await this.client.send(\n          new DescribeExecutionCommand({ executionArn }),\n        );\n\n        if (result.status) {\n          ctx.setAttribute('aws.stepfunctions.execution_status', result.status);\n        }\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return {\n          executionArn: result.executionArn,\n          stateMachineArn: result.stateMachineArn,\n          name: result.name,\n          status: result.status,\n          startDate: result.startDate,\n          stopDate: result.stopDate,\n          input: result.input,\n          output: result.output,\n          error: result.error,\n          cause: result.cause,\n        };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'DescribeExecution failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Stop an execution\n   *\n   * @param executionArn - ARN of the execution to stop\n   * @param options - Optional error and cause for the stop\n   * @returns Promise with stop date\n   */\n  async stopExecution(\n    executionArn: string,\n    options?: { error?: string; cause?: string },\n  ): Promise<{ stopDate?: Date }> {\n    return trace(`stepfunctions.StopExecution`, async (ctx: TraceContext) => {\n      ctx.setAttributes(\n        buildStepFunctionsAttributes({\n          stateMachineArn: this.config.stateMachineArn,\n        }),\n      );\n      ctx.setAttribute('aws.stepfunctions.execution_arn', executionArn);\n\n      try {\n        const { StopExecutionCommand } = await import('@aws-sdk/client-sfn');\n        const result = await this.client.send(\n          new StopExecutionCommand({\n            executionArn,\n            error: options?.error,\n            cause: options?.cause,\n          }),\n        );\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n\n        return { stopDate: result.stopDate };\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'StopExecution failed',\n        });\n        throw error;\n      }\n    });\n  }\n}\n\n// ============================================================================\n// StepFunctionsActivityWorker Class\n// ============================================================================\n\n/**\n * Step Functions Activity Worker with trace context extraction\n *\n * Polls for activity tasks and processes them with automatic tracing.\n * Extracts trace context from task input for distributed tracing.\n *\n * @example Basic activity worker\n * ```typescript\n * import { StepFunctionsActivityWorker } from 'autotel-aws/step-functions';\n * import { SFNClient } from '@aws-sdk/client-sfn';\n *\n * const sfn = new SFNClient({ region: 'us-east-1' });\n * const worker = new StepFunctionsActivityWorker(sfn, {\n *   activityArn: 'arn:aws:states:us-east-1:123456789:activity:ProcessPayment',\n *   workerName: 'payment-worker-1'\n * });\n *\n * // Process tasks with automatic tracing\n * await worker.poll(async (input, taskToken, ctx) => {\n *   ctx.setAttribute('payment.amount', input.amount);\n *   ctx.setAttribute('payment.currency', input.currency);\n *\n *   const result = await processPayment(input);\n *\n *   ctx.setAttribute('payment.status', result.status);\n *   return result;\n * });\n * ```\n *\n * @example Continuous polling with error handling\n * ```typescript\n * async function runWorker() {\n *   while (true) {\n *     try {\n *       await worker.poll(async (input, taskToken, ctx) => {\n *         return await processTask(input);\n *       });\n *     } catch (error) {\n *       console.error('Worker error:', error);\n *       // Brief pause before retrying\n *       await new Promise(resolve => setTimeout(resolve, 1000));\n *     }\n *   }\n * }\n * ```\n */\nexport class StepFunctionsActivityWorker<\n   \n  TClient extends { send: (command: any) => Promise<any> } = any,\n> {\n  private client: TClient;\n  private config: Required<Pick<StepFunctionsActivityWorkerConfig, 'activityArn'>> &\n    StepFunctionsActivityWorkerConfig;\n  private activityName: string;\n\n  constructor(client: TClient, config: StepFunctionsActivityWorkerConfig) {\n    this.client = wrapSDKClient(client as any, config.service) as TClient;\n    this.config = {\n      extractTraceContext: true,\n      ...config,\n    };\n    // Extract activity name from ARN\n    this.activityName = config.activityArn.split(':').pop() || 'unknown';\n  }\n\n  /**\n   * Poll for an activity task and process it\n   *\n   * @param processor - Function to process the task input\n   * @returns Promise that resolves when the task is processed\n   */\n  async poll<TInput extends Record<string, unknown>, TOutput>(\n    processor: (\n      input: TInput,\n      taskToken: string,\n      ctx: TraceContext,\n    ) => Promise<TOutput>,\n  ): Promise<void> {\n    return trace(`stepfunctions.activity.poll`, async (ctx: TraceContext) => {\n      ctx.setAttribute('aws.stepfunctions.activity_arn', this.config.activityArn);\n      ctx.setAttribute('aws.stepfunctions.activity_name', this.activityName);\n\n      if (this.config.workerName) {\n        ctx.setAttribute('aws.stepfunctions.worker_name', this.config.workerName);\n      }\n\n      try {\n        // Poll for task\n        const { GetActivityTaskCommand } = await import('@aws-sdk/client-sfn');\n        const task = await this.client.send(\n          new GetActivityTaskCommand({\n            activityArn: this.config.activityArn,\n            workerName: this.config.workerName,\n          }),\n        );\n\n        if (!task.taskToken || !task.input) {\n          // No task available (timeout)\n          ctx.setAttribute('aws.stepfunctions.activity_task_received', false);\n          ctx.setStatus({ code: SpanStatusCode.OK });\n          return;\n        }\n\n        ctx.setAttribute('aws.stepfunctions.activity_task_received', true);\n\n        // Parse input\n        const rawInput = JSON.parse(task.input) as TInput & TraceContextFields;\n\n        // Extract trace context if enabled\n        if (this.config.extractTraceContext) {\n          const parentContext = extractStepFunctionsContext(rawInput);\n          if (parentContext) {\n            ctx.setAttribute('aws.stepfunctions.trace_context_extracted', true);\n          }\n        }\n\n        // Strip trace context from input\n        const cleanInput = stripTraceContext(rawInput) as TInput;\n\n        // Process the task\n        const output = await processor(cleanInput, task.taskToken, ctx);\n\n        // Send success\n        const { SendTaskSuccessCommand } = await import('@aws-sdk/client-sfn');\n        await this.client.send(\n          new SendTaskSuccessCommand({\n            taskToken: task.taskToken,\n            output: JSON.stringify(output),\n          }),\n        );\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'Activity processing failed',\n        });\n\n        // If we have a task token, send failure\n        // Note: In a real implementation, you'd want to track the token\n        // This is simplified for the example\n\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Send a task heartbeat\n   *\n   * For long-running activities, send heartbeats to prevent timeout.\n   *\n   * @param taskToken - The task token from GetActivityTask\n   */\n  async sendHeartbeat(taskToken: string): Promise<void> {\n    return trace(`stepfunctions.SendTaskHeartbeat`, async (ctx: TraceContext) => {\n      ctx.setAttribute('aws.stepfunctions.activity_arn', this.config.activityArn);\n\n      try {\n        const { SendTaskHeartbeatCommand } = await import('@aws-sdk/client-sfn');\n        await this.client.send(new SendTaskHeartbeatCommand({ taskToken }));\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n      } catch (error) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : 'SendTaskHeartbeat failed',\n        });\n        throw error;\n      }\n    });\n  }\n\n  /**\n   * Send task failure\n   *\n   * @param taskToken - The task token from GetActivityTask\n   * @param error - Error code\n   * @param cause - Error cause description\n   */\n  async sendFailure(\n    taskToken: string,\n    error: string,\n    cause?: string,\n  ): Promise<void> {\n    return trace(`stepfunctions.SendTaskFailure`, async (ctx: TraceContext) => {\n      ctx.setAttribute('aws.stepfunctions.activity_arn', this.config.activityArn);\n      ctx.setAttribute('aws.stepfunctions.task_error', error);\n\n      try {\n        const { SendTaskFailureCommand } = await import('@aws-sdk/client-sfn');\n        await this.client.send(\n          new SendTaskFailureCommand({\n            taskToken,\n            error,\n            cause,\n          }),\n        );\n\n        ctx.setStatus({ code: SpanStatusCode.OK });\n      } catch (error_) {\n        ctx.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error_ instanceof Error ? error_.message : 'SendTaskFailure failed',\n        });\n        throw error_;\n      }\n    });\n  }\n}\n"],"mappings":"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"}