@ductape/sdk 0.1.145 → 0.1.147

package/dist/context/execution-context.d.ts

@@ -1,4 +1,24 @@
-export type DuctapeExecutionKind = 'feature' | 'step' | 'function' | 'primitive';
+export type DuctapeExecutionKind = 'feature' | 'step' | 'function' | 'primitive' | 'asset';
+export interface DuctapeAssetSpan {
+    trace_id: string;
+    span_id: string;
+    parent_span_id?: string;
+    feature_id?: string;
+    feature_tag?: string;
+    feature_run_id?: string;
+    step_tag?: string;
+    step_run_id?: string;
+    function_invocation_id?: string;
+    asset_type: string;
+    asset_tag: string;
+    asset_operation: string;
+    asset_action?: string;
+    status: 'success' | 'fail';
+    start: number;
+    end: number;
+    duration_ms: number;
+    error_message?: string;
+}
 export interface DuctapeExecutionContext {
     workspace_id?: string;
     product_id?: string;
@@ -28,6 +48,8 @@ export interface DuctapeExecutionContext {
     idempotency_key?: string;
     deadline_at?: number;
     baggage?: Record<string, string>;
+    /** Internal per-run span sink. It is never serialized into logs or processor results. */
+    asset_span_sink?: DuctapeAssetSpan[];
     kind: DuctapeExecutionKind;
 }
 export declare function currentExecutionContext(): DuctapeExecutionContext | undefined;
@@ -35,3 +57,9 @@ export declare function createExecutionContext(fields: Partial<DuctapeExecutionC
 export declare function runWithExecutionContext<T>(context: DuctapeExecutionContext, fn: () => T): T;
 /** Fields safe and useful on processor-result/log records. */
 export declare function executionContextFields(context?: DuctapeExecutionContext): Record<string, unknown>;
+export declare function withAssetSpan<T>(asset: {
+    type: string;
+    tag: string;
+    operation: string;
+    action?: string;
+}, fn: () => Promise<T>): Promise<T>;

package/dist/context/execution-context.js

@@ -15,6 +15,7 @@ exports.currentExecutionContext = currentExecutionContext;
 exports.createExecutionContext = createExecutionContext;
 exports.runWithExecutionContext = runWithExecutionContext;
 exports.executionContextFields = executionContextFields;
+exports.withAssetSpan = withAssetSpan;
 const async_hooks_1 = require("async_hooks");
 const crypto_1 = require("crypto");
 const storage = new async_hooks_1.AsyncLocalStorage();
@@ -32,7 +33,62 @@ function runWithExecutionContext(context, fn) {
 function executionContextFields(context = currentExecutionContext()) {
     if (!context)
         return {};
-    const { session: _secretSession, baggage: _baggage, kind: execution_kind } = context, fields = __rest(context, ["session", "baggage", "kind"]);
+    const { session: _secretSession, baggage: _baggage, asset_span_sink: _assetSpanSink, kind: execution_kind } = context, fields = __rest(context, ["session", "baggage", "asset_span_sink", "kind"]);
     return Object.assign(Object.assign({}, fields), { execution_kind });
 }
+async function withAssetSpan(asset, fn) {
+    const parent = currentExecutionContext();
+    if (!(parent === null || parent === void 0 ? void 0 : parent.asset_span_sink))
+        return fn();
+    const context = createExecutionContext({ kind: 'asset' }, parent);
+    const start = Date.now();
+    try {
+        const result = await runWithExecutionContext(context, fn);
+        const end = Date.now();
+        parent.asset_span_sink.push({
+            trace_id: context.trace_id,
+            span_id: context.span_id,
+            parent_span_id: context.parent_span_id,
+            feature_id: context.feature_id,
+            feature_tag: context.feature_tag,
+            feature_run_id: context.feature_run_id,
+            step_tag: context.step_tag,
+            step_run_id: context.step_run_id,
+            function_invocation_id: context.function_invocation_id,
+            asset_type: asset.type,
+            asset_tag: asset.tag,
+            asset_operation: asset.operation,
+            asset_action: asset.action,
+            status: 'success',
+            start,
+            end,
+            duration_ms: end - start,
+        });
+        return result;
+    }
+    catch (error) {
+        const end = Date.now();
+        parent.asset_span_sink.push({
+            trace_id: context.trace_id,
+            span_id: context.span_id,
+            parent_span_id: context.parent_span_id,
+            feature_id: context.feature_id,
+            feature_tag: context.feature_tag,
+            feature_run_id: context.feature_run_id,
+            step_tag: context.step_tag,
+            step_run_id: context.step_run_id,
+            function_invocation_id: context.function_invocation_id,
+            asset_type: asset.type,
+            asset_tag: asset.tag,
+            asset_operation: asset.operation,
+            asset_action: asset.action,
+            status: 'fail',
+            start,
+            end,
+            duration_ms: end - start,
+            error_message: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+}
 //# sourceMappingURL=execution-context.js.map

package/dist/context/execution-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/context/execution-context.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAuCA,0DAEC;AAED,wDAYC;AAED,0DAEC;AAGD,wDASC;AAvED,6CAAgD;AAChD,mCAAoC;AAoCpC,MAAM,OAAO,GAAG,IAAI,+BAAiB,EAA2B,CAAC;AAEjE,SAAgB,uBAAuB;IACrC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,SAAgB,sBAAsB,CACpC,MAAwC,EACxC,SAA8C,uBAAuB,EAAE;;IAEvE,qDACK,MAAM,GACN,MAAM,KACT,IAAI,EAAE,MAAA,MAAA,MAAM,CAAC,IAAI,mCAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,mCAAI,WAAW,EAChD,QAAQ,EAAE,MAAA,MAAA,MAAM,CAAC,QAAQ,mCAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,mCAAI,IAAA,mBAAU,GAAE,EAC7D,OAAO,EAAE,MAAA,MAAM,CAAC,OAAO,mCAAI,IAAA,mBAAU,GAAE,EACvC,cAAc,EAAE,MAAA,MAAM,CAAC,cAAc,mCAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,OAAO,IACxD;AACJ,CAAC;AAED,SAAgB,uBAAuB,CAAI,OAAgC,EAAE,EAAW;IACtF,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,8DAA8D;AAC9D,SAAgB,sBAAsB,CAAC,OAAO,GAAG,uBAAuB,EAAE;IACxE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,EACJ,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,cAAc,KAElB,OAAO,EADN,MAAM,UACP,OAAO,EALL,8BAKL,CAAU,CAAC;IACZ,uCAAY,MAAM,KAAE,cAAc,IAAG;AACvC,CAAC"}
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/context/execution-context.ts"],"names":[],"mappings":"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"}

package/dist/features/feature-executor.d.ts

@@ -60,6 +60,8 @@ export declare class FeatureExecutor {
     private functionInvocations;
     /** Step telemetry is accumulated and persisted with the terminal feature record in one round trip. */
     private pendingProcessorResults;
+    private assetSpans;
+    private stepContexts;
     constructor(config: IFeatureServiceConfig & {
         access_key: string;
     }, feature: IProductFeature, options: IExecuteFeatureOptions, private_key: string, sessionLogFields?: {
@@ -127,9 +129,8 @@ export declare class FeatureExecutor {
      */
     private executeStep;
     private executeStepInContext;
-    /**
-     * Execute an action step
-     */
+    private describeStepAsset;
+    /** Execute an action step. */
     private executeActionStep;
     /**
      * Execute a database step: use query/insert/update/delete/upsert for DB operations, execute() for named actions.

package/dist/features/feature-executor.js

@@ -165,6 +165,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 +422,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 });
         }
@@ -458,7 +470,7 @@ class FeatureExecutor {
      * 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;
+        var _a, _b;
         const resolvedInput = input !== null && input !== void 0 ? input : step.input;
         const stepType = this.getStepTypeForResult(step);
         debugLog('[FeatureExecutor] persistStepResult ENTRY', {
@@ -479,8 +491,8 @@ class FeatureExecutor {
             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 +569,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());
     }
@@ -825,6 +838,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 +864,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 &&
@@ -954,9 +978,40 @@ class FeatureExecutor {
             };
         }
     }
-    /**
-     * 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 });