@ductape/sdk 0.1.145 → 0.1.148

package/dist/features/feature-executor.js

@@ -118,6 +118,8 @@ function formatErrorDetails(error) {
     const out = { message };
     if (err === null || err === void 0 ? void 0 : err.stack)
         out.stack = err.stack;
+    if ((err === null || err === void 0 ? void 0 : err.details) != null)
+        out.details = sanitizeForLog(err.details);
     if (err === null || err === void 0 ? void 0 : err.response) {
         out.status = (_b = err.response) === null || _b === void 0 ? void 0 : _b.status;
         const data = (_c = err.response) === null || _c === void 0 ? void 0 : _c.data;
@@ -165,6 +167,8 @@ class FeatureExecutor {
         this.functionInvocations = new Map();
         /** Step telemetry is accumulated and persisted with the terminal feature record in one round trip. */
         this.pendingProcessorResults = [];
+        this.assetSpans = [];
+        this.stepContexts = new Map();
         debugLog('[FeatureExecutor] constructor ENTRY', {
             feature_tag: feature.tag,
             product: options.product,
@@ -420,8 +424,18 @@ class FeatureExecutor {
             const inputStr = stringifyProcessorValue(inputPayload);
             const encKey = this.getProcessorResultEncryptionKey();
             const processorResult = Object.assign(Object.assign({}, (0, context_1.executionContextFields)()), { process_id: this.state.feature_id, product_id: this.productId || null, env: this.state.env, component: types_1.LogEventTypes.FEATURE, status, start: this.state.started_at, end: Date.now(), retryable: true, result: encKey ? (0, processor_utils_1.encrypt)(resultStr, encKey) : resultStr, input: encKey ? (0, processor_utils_1.encrypt)(inputStr, encKey) : inputStr, feature_id: this.state.feature_id, feature_tag: this.state.feature_tag, product_tag: this.state.product, workspace_id: this.config.workspace_id });
+            const assetResults = this.assetSpans.splice(0).map((span) => {
+                const spanResult = stringifyProcessorValue({
+                    asset_type: span.asset_type,
+                    asset_tag: span.asset_tag,
+                    operation: span.asset_operation,
+                    action: span.asset_action,
+                });
+                const spanInput = stringifyProcessorValue({});
+                return Object.assign(Object.assign({}, span), { process_id: span.span_id, product_id: this.productId || null, product_tag: this.state.product, workspace_id: this.config.workspace_id, env: this.state.env, component: 'asset_invocation', execution_kind: 'asset', retryable: true, result: encKey ? (0, processor_utils_1.encrypt)(spanResult, encKey) : spanResult, input: encKey ? (0, processor_utils_1.encrypt)(spanInput, encKey) : spanInput, asset_duration_ms: span.duration_ms, asset_error: span.error_message });
+            });
             this.trace('execution.persistence.sent', { status, payload: resultData });
-            await this.processorApiService.saveResultsBatch([...this.pendingProcessorResults.splice(0), processorResult], this.getAuthPayload());
+            await this.processorApiService.saveResultsBatch([...this.pendingProcessorResults.splice(0), ...assetResults, processorResult], this.getAuthPayload());
             this.trace('execution.persistence.acknowledged', { status, process_id: this.state.feature_id });
             debugLog('[FeatureExecutor] persistExecutionResult SUCCESS', { feature_id: this.state.feature_id, status });
         }
@@ -457,8 +471,8 @@ class FeatureExecutor {
      * Persist individual step execution to backend (input/output per step in processor result).
      * Processor results for steps always have component: 'feature_step' and step_type set to the step kind.
      */
-    async persistStepResult(step, status, output, error, duration, input) {
-        var _a;
+    async persistStepResult(step, status, output, error, duration, input, errorDetails) {
+        var _a, _b;
         const resolvedInput = input !== null && input !== void 0 ? input : step.input;
         const stepType = this.getStepTypeForResult(step);
         debugLog('[FeatureExecutor] persistStepResult ENTRY', {
@@ -475,12 +489,12 @@ class FeatureExecutor {
                 ? output !== undefined && output !== null
                     ? output
                     : {}
-                : { error: error !== null && error !== void 0 ? error : 'Step failed' };
+                : Object.assign({ error: error !== null && error !== void 0 ? error : 'Step failed' }, (errorDetails != null ? { details: errorDetails } : {}));
             const resultStr = stringifyProcessorValue(value);
             const inputStr = stringifyProcessorValue(resolvedInput);
             const encKey = this.getProcessorResultEncryptionKey();
-            const stepResult = Object.assign(Object.assign(Object.assign({}, (0, context_1.executionContextFields)()), { process_id: stepProcessId, product_id: this.productId || null, env: this.state.env, component: types_1.LogEventTypes.FEATURE_STEP, // step results always feature_step
-                status, start: Date.now() - (duration || 0), end: Date.now(), retryable: true, result: encKey ? (0, processor_utils_1.encrypt)(resultStr, encKey) : resultStr, input: encKey ? (0, processor_utils_1.encrypt)(inputStr, encKey) : inputStr, feature_id: this.state.feature_id, feature_tag: this.state.feature_tag, product_tag: this.state.product, workspace_id: this.config.workspace_id, step_tag: step.tag, step_type: stepType, step_error: error, step_duration_ms: duration }), ((_a = this.functionInvocations.get(step.tag)) !== null && _a !== void 0 ? _a : {}));
+            const stepResult = Object.assign(Object.assign(Object.assign(Object.assign({}, (0, context_1.executionContextFields)()), ((_a = this.stepContexts.get(step.tag)) !== null && _a !== void 0 ? _a : {})), { process_id: stepProcessId, product_id: this.productId || null, env: this.state.env, component: types_1.LogEventTypes.FEATURE_STEP, // step results always feature_step
+                status, start: Date.now() - (duration || 0), end: Date.now(), retryable: true, result: encKey ? (0, processor_utils_1.encrypt)(resultStr, encKey) : resultStr, input: encKey ? (0, processor_utils_1.encrypt)(inputStr, encKey) : inputStr, feature_id: this.state.feature_id, feature_tag: this.state.feature_tag, product_tag: this.state.product, workspace_id: this.config.workspace_id, step_tag: step.tag, step_type: stepType, step_error: error, step_duration_ms: duration }), ((_b = this.functionInvocations.get(step.tag)) !== null && _b !== void 0 ? _b : {}));
             this.trace('step.persistence.sent', {
                 step_tag: step.tag,
                 step_type: stepType,
@@ -557,6 +571,7 @@ class FeatureExecutor {
             session_id: this.sessionLogFields.session_id,
             session_tag: this.sessionLogFields.session_tag,
             session_user_id: this.sessionLogFields.session_user_id,
+            asset_span_sink: this.assetSpans,
         });
         return (0, context_1.runWithExecutionContext)(context, () => this.executeInContext());
     }
@@ -659,7 +674,7 @@ class FeatureExecutor {
                 }
                 debugLog(`[FeatureExecutor] Step "${step.tag}" output:`, stepReturnValue);
                 // Persist step result to backend (use step return shape, not raw primitive)
-                await this.persistStepResult(step, result.success ? types_1.LogEventStatus.SUCCESS : types_1.LogEventStatus.FAIL, stepReturnValue, result.error, result.duration, result.input);
+                await this.persistStepResult(step, result.success ? types_1.LogEventStatus.SUCCESS : types_1.LogEventStatus.FAIL, stepReturnValue, result.error, result.duration, result.input, result.errorDetails);
                 this.state.step_timings.push({
                     tag: step.tag,
                     duration_ms: result.duration,
@@ -825,6 +840,12 @@ class FeatureExecutor {
             process_id: `${this.state.feature_id}:${step.tag}`,
             parent_process_id: this.state.feature_id,
         }, parent);
+        this.stepContexts.set(step.tag, {
+            trace_id: context.trace_id,
+            span_id: context.span_id,
+            parent_span_id: context.parent_span_id,
+            step_run_id: context.step_run_id,
+        });
         return (0, context_1.runWithExecutionContext)(context, () => this.executeStepInContext(step));
     }
     async executeStepInContext(step) {
@@ -845,62 +866,67 @@ class FeatureExecutor {
                 step_tag: step.tag,
                 input: sanitizeForLog(resolvedInput),
             });
-            let output;
-            // Route steps to dedicated services; only action and notification use ProcessorService.
-            switch (step.type) {
-                case types_1.FeatureStepType.ACTION:
-                    output = await this.executeActionStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.DATABASE_ACTION:
-                    output = await this.executeDatabaseStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.NOTIFICATION:
-                    output = await this.executeNotificationStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.STORAGE:
-                    output = await this.executeStorageStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.PUBLISH:
-                case types_1.FeatureStepType.PRODUCE:
-                    output = await this.executeProduceStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.GRAPH:
-                    output = await this.executeGraphStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.VECTOR:
-                    output = await this.executeVectorStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.SESSION:
-                    output = await this.executeSessionStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.FUNCTION:
-                    output = await this.executeFunctionStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.QUOTA:
-                    output = await this.executeQuotaStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.FALLBACK:
-                    output = await this.executeFallbackStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.CHILD_FEATURE:
-                    output = await this.executeChildWorkflowStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.SLEEP:
-                    await this.executeSleepStep(step, resolvedInput);
-                    output = { slept: true };
-                    break;
-                case types_1.FeatureStepType.WAIT_FOR_SIGNAL:
-                    output = await this.executeWaitForSignalStep(step, resolvedInput);
-                    break;
-                case types_1.FeatureStepType.CHECKPOINT:
-                    await this.executeCheckpointStep(step, resolvedInput);
-                    output = { checkpoint: step.tag };
-                    break;
-                default:
-                    stepLog('Step type not implemented (passthrough)', { tag: step.tag, type: step.type });
-                    debugLog('[FeatureExecutor] executeStep unknown step type (passthrough)', { step_tag: step.tag, step_type: step.type });
-                    output = resolvedInput;
-            }
+            const asset = this.describeStepAsset(step);
+            const runOperation = async () => {
+                let value;
+                // Route steps to dedicated services; only action and notification use ProcessorService.
+                switch (step.type) {
+                    case types_1.FeatureStepType.ACTION:
+                        value = await this.executeActionStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.DATABASE_ACTION:
+                        value = await this.executeDatabaseStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.NOTIFICATION:
+                        value = await this.executeNotificationStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.STORAGE:
+                        value = await this.executeStorageStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.PUBLISH:
+                    case types_1.FeatureStepType.PRODUCE:
+                        value = await this.executeProduceStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.GRAPH:
+                        value = await this.executeGraphStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.VECTOR:
+                        value = await this.executeVectorStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.SESSION:
+                        value = await this.executeSessionStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.FUNCTION:
+                        value = await this.executeFunctionStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.QUOTA:
+                        value = await this.executeQuotaStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.FALLBACK:
+                        value = await this.executeFallbackStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.CHILD_FEATURE:
+                        value = await this.executeChildWorkflowStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.SLEEP:
+                        await this.executeSleepStep(step, resolvedInput);
+                        value = { slept: true };
+                        break;
+                    case types_1.FeatureStepType.WAIT_FOR_SIGNAL:
+                        value = await this.executeWaitForSignalStep(step, resolvedInput);
+                        break;
+                    case types_1.FeatureStepType.CHECKPOINT:
+                        await this.executeCheckpointStep(step, resolvedInput);
+                        value = { checkpoint: step.tag };
+                        break;
+                    default:
+                        stepLog('Step type not implemented (passthrough)', { tag: step.tag, type: step.type });
+                        debugLog('[FeatureExecutor] executeStep unknown step type (passthrough)', { step_tag: step.tag, step_type: step.type });
+                        value = resolvedInput;
+                }
+                return value;
+            };
+            let output = asset ? await (0, context_1.withAssetSpan)(asset, runOperation) : await runOperation();
             // For action steps with no app: if step.output is a template with $ refs (e.g. $Sequence{main}{step-a}{value}-b),
             // resolve it so downstream steps get the correct value (checkpoint / closure-style steps).
             if (step.type === types_1.FeatureStepType.ACTION &&
@@ -950,13 +976,45 @@ class FeatureExecutor {
                 success: false,
                 input: resolvedInput,
                 error: stepErrorMsg,
+                errorDetails: details.details,
                 duration,
             };
         }
     }
-    /**
-     * Execute an action step
-     */
+    describeStepAsset(step) {
+        var _a, _b;
+        const operation = step.event || 'execute';
+        switch (step.type) {
+            case types_1.FeatureStepType.ACTION:
+                return step.app ? { type: 'app', tag: step.app, operation, action: step.event } : null;
+            case types_1.FeatureStepType.DATABASE_ACTION:
+                return { type: 'database', tag: step.database || 'database', operation, action: step.event };
+            case types_1.FeatureStepType.GRAPH:
+                return { type: 'graph', tag: step.graph || 'graph', operation, action: step.event };
+            case types_1.FeatureStepType.VECTOR:
+                return { type: 'vector', tag: step.vector || 'vector', operation, action: step.event };
+            case types_1.FeatureStepType.STORAGE:
+                return { type: 'storage', tag: step.storage || 'storage', operation, action: step.event };
+            case types_1.FeatureStepType.NOTIFICATION:
+                return { type: 'notification', tag: step.notification || 'notification', operation, action: step.event };
+            case types_1.FeatureStepType.PUBLISH:
+            case types_1.FeatureStepType.PRODUCE:
+                return { type: 'message_broker', tag: step.broker || 'message-broker', operation: 'produce', action: step.event };
+            case types_1.FeatureStepType.SESSION:
+                return { type: 'session', tag: step.session || 'session', operation, action: step.event };
+            case types_1.FeatureStepType.QUOTA:
+                return { type: 'quota', tag: step.quota || 'quota', operation: 'execute' };
+            case types_1.FeatureStepType.FALLBACK:
+                return { type: 'fallback', tag: step.fallback || 'fallback', operation: 'execute' };
+            case types_1.FeatureStepType.CHILD_FEATURE:
+                return { type: 'feature', tag: step.feature || 'feature', operation: 'execute' };
+            case types_1.FeatureStepType.FUNCTION:
+                return { type: 'function', tag: ((_a = step.function_ref) === null || _a === void 0 ? void 0 : _a.namespace) || 'function', operation: ((_b = step.function_ref) === null || _b === void 0 ? void 0 : _b.operation) || operation };
+            default:
+                return null;
+        }
+    }
+    /** Execute an action step. */
     async executeActionStep(step, input) {
         var _a, _b;
         debugLog('[FeatureExecutor] executeActionStep', { feature_id: this.state.feature_id, step_tag: step.tag, app: step.app });
@@ -2658,7 +2716,7 @@ class FeatureExecutor {
                     stepReturnValueResume = undefined;
                 }
                 // Persist step result to backend (use step return shape, not raw primitive)
-                await this.persistStepResult(step, result.success ? types_1.LogEventStatus.SUCCESS : types_1.LogEventStatus.FAIL, stepReturnValueResume, result.error, result.duration, result.input);
+                await this.persistStepResult(step, result.success ? types_1.LogEventStatus.SUCCESS : types_1.LogEventStatus.FAIL, stepReturnValueResume, result.error, result.duration, result.input, result.errorDetails);
                 this.state.step_timings.push({
                     tag: step.tag,
                     duration_ms: result.duration,