@acmekit/workflows-sdk 2.13.36 → 2.13.38

package/dist/utils/composer/create-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-workflow.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/create-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAGxB,MAAM,wBAAwB,CAAA;AAkB/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAGL,cAAc,EAGd,YAAY,EACb,MAAM,QAAQ,CAAA;AAEf,8EAA8E;AAC9E,KAAK,wBAAwB,CAAC,CAAC,IAC7B,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAA;AAE7D,+FAA+F;AAC/F,KAAK,uBAAuB,CAAC,CAAC,IAC5B,CAAC,SAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GACxC,CAAC,SAAS,SAAS,GAAG,EAAE,GACtB,CAAC,GACD,SAAS,EAAE,GACb,SAAS,EAAE,CAAA;AAgBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,wBAAgB,cAAc,CAC5B,KAAK,EACL,eAAe,GAAG,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,CAAC;AAElE;;GAEG;AACH,YAAY,EAAE,MAAM,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CAAC;AACnE;;;;GAIG;AACH,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,eAAe,GACxD,cAAc,CACf,KAAK,EACL,wBAAwB,CAAC,eAAe,CAAC,EACzC,uBAAuB,CAAC,eAAe,CAAC,CACzC,CA6MA"}
+{"version":3,"file":"create-workflow.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/create-workflow.ts"],"names":[],"mappings":"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"}

package/dist/utils/composer/create-workflow.js

@@ -15,73 +15,17 @@ const buildTransactionId = (step, stepContext) => {
         (stepContext.transactionId ?? (0, ulid_1.ulid)()) +
         (stepContext.attempt > 1 ? `-attempt-${stepContext.attempt}` : ""));
 };
-/**
- * This function creates a workflow with the provided name and a constructor function.
- * The constructor function builds the workflow from steps created by the {@link createStep} function.
- * The returned workflow is an exported workflow of type {@link ReturnWorkflow}, meaning it's not executed right away. To execute it,
- * invoke the exported workflow, then run its `run` method.
- *
- * @typeParam TData - The type of the input passed to the composer function.
- * @typeParam TComposerReturn - Inferred from the composer return type; used to derive result and hooks for workflow typing.
- *
- * @returns The created workflow. You can later execute the workflow by invoking it, then using its `run` method.
- *
- * @example
- * import {
- *   createWorkflow,
- *   WorkflowResponse
- * } from "@acmekit/framework/workflows-sdk"
- * import { AcmeKitRequest, AcmeKitResponse } from "@acmekit/framework/http"
- * import {
- *   createProductStep,
- *   getProductStep,
- * } from "./steps"
- *
- * interface WorkflowInput {
- *  title: string
- * }
- *
- * const myWorkflow = createWorkflow(
- *   "my-workflow",
- *   (input: WorkflowInput) => {
- *    // Everything here will be executed and resolved later
- *    // during the execution. Including the data access.
- *
- *     const product = createProductStep(input)
- *     return new WorkflowResponse(getProductStep(product.id))
- *   }
- * )
- *
- * export async function GET(
- *   req: AcmeKitRequest,
- *   res: AcmeKitResponse
- * ) {
- *   const { result: product } = await myWorkflow(req.scope)
- *     .run({
- *       input: {
- *         title: "Shirt"
- *       }
- *     })
- *
- *   res.json({
- *     product
- *   })
- * }
- */
-function createWorkflow(
-/**
- * The name of the workflow or its configuration.
- */
-nameOrConfig, 
-/**
- * The constructor function that is executed when the `run` method in {@link ReturnWorkflow} is used.
- * The function can't be an arrow function or an asynchronus function. It also can't directly manipulate data.
- * You'll have to use the {@link transform} function if you need to directly manipulate data.
- */
-composer) {
+// Implementation signature
+function createWorkflow(nameOrConfig, composer) {
     const fileSourcePath = (0, utils_1.getCallerFilePath)();
     const name = (0, utils_1.isString)(nameOrConfig) ? nameOrConfig : nameOrConfig.name;
     const options = (0, utils_1.isString)(nameOrConfig) ? {} : nameOrConfig;
+    const inputSchema = (0, utils_1.isString)(nameOrConfig)
+        ? undefined
+        : nameOrConfig.inputSchema;
+    const outputSchema = (0, utils_1.isString)(nameOrConfig)
+        ? undefined
+        : nameOrConfig.outputSchema;
     (0, utils_1.registerDevServerResource)({
         sourcePath: fileSourcePath,
         id: name,
@@ -137,7 +81,9 @@ composer) {
     const workflow = (0, helper_1.exportWorkflow)(name, returnedStep, {
         wrappedInput: true,
         sourcePath: fileSourcePath,
-    });
+        inputSchema,
+        outputSchema,
+    }, context.queryRegistrations_);
     const mainFlow = (container) => {
         const workflow_ = workflow(container);
         const expandedFlow = workflow_;
@@ -146,6 +92,7 @@ composer) {
         };
         return expandedFlow;
     };
+    mainFlow.__queryRegistrations__ = context.queryRegistrations_ ?? [];
     mainFlow.hooks = {};
     for (const hook of context.hooks_.declared) {
         mainFlow.hooks[hook] = context.hooksCallback_[hook].bind(context);
@@ -190,15 +137,6 @@ composer) {
                     context: executionContext,
                 });
             }
-            // Attach sub-workflow error context for visibility (4.3.1)
-            if (transaction.errors?.length) {
-                for (const err of transaction.errors) {
-                    if (err?.error) {
-                        err.error.parentStep = step.__step__;
-                        err.error.subWorkflowId = name;
-                    }
-                }
-            }
             return new step_response_1.StepResponse(transaction.result, isAsync ? stepContext.transactionId : transaction);
         }, async (transaction, stepContext) => {
             // The step itself has failed, there is nothing to revert

package/dist/utils/composer/create-workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-workflow.js","sourceRoot":"","sources":["../../../src/utils/composer/create-workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-workflow.js","sourceRoot":"","sources":["../../../src/utils/composer/create-workflow.ts"],"names":[],"mappings":"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"}

package/dist/utils/composer/helpers/create-step-handler.d.ts

@@ -4,7 +4,7 @@ import { CreateWorkflowComposerContext, WorkflowData } from "../type";
 import { StepResponse } from "./step-response";
 export declare function createStepHandler<TInvokeInput, TStepInput extends {
     [K in keyof TInvokeInput]: WorkflowData<TInvokeInput[K]>;
-}, TInvokeResultOutput, TInvokeResultCompensateInput>(this: CreateWorkflowComposerContext, { stepName, input, invokeFn, compensateFn, }: ApplyStepOptions<TStepInput, TInvokeInput, TInvokeResultOutput, TInvokeResultCompensateInput>): {
+}, TInvokeResultOutput, TInvokeResultCompensateInput>(this: CreateWorkflowComposerContext, { stepName, input, invokeFn, compensateFn, inputSchema, outputSchema, }: ApplyStepOptions<TStepInput, TInvokeInput, TInvokeResultOutput, TInvokeResultCompensateInput>): {
     invoke: (stepArguments: WorkflowStepHandlerArguments) => Promise<{
         __type: string;
         output: StepResponse<any, any> | {

package/dist/utils/composer/helpers/create-step-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-step-handler.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/create-step-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACL,6BAA6B,EAE7B,YAAY,EACb,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AA8C9C,wBAAgB,iBAAiB,CAC/B,YAAY,EACZ,UAAU,SAAS;KAChB,CAAC,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CACzD,EACD,mBAAmB,EACnB,4BAA4B,EAE5B,IAAI,EAAE,6BAA6B,EACnC,EACE,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,YAAY,GACb,EAAE,gBAAgB,CACjB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,4BAA4B,CAC7B;4BAG+B,4BAA4B;;;;;;;;iCAqChC,4BAA4B;;;EAiCzD"}
+{"version":3,"file":"create-step-handler.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/create-step-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAG7B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACL,6BAA6B,EAE7B,YAAY,EAEb,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAgD9C,wBAAgB,iBAAiB,CAC/B,YAAY,EACZ,UAAU,SAAS;KAChB,CAAC,IAAI,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CACzD,EACD,mBAAmB,EACnB,4BAA4B,EAE5B,IAAI,EAAE,6BAA6B,EACnC,EACE,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,YAAY,GACb,EAAE,gBAAgB,CACjB,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,4BAA4B,CAC7B;4BAG+B,4BAA4B;;;;;;;;iCA6EhC,4BAA4B;;;EAwCzD"}

package/dist/utils/composer/helpers/create-step-handler.js

@@ -1,23 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStepHandler = createStepHandler;
+const orchestration_1 = require("@acmekit/orchestration");
 const utils_1 = require("@acmekit/utils");
+const type_1 = require("../type");
 const resolve_value_1 = require("./resolve-value");
-function buildStepContext({ action, stepArguments, }) {
-    const metadata = stepArguments.metadata;
-    const idempotencyKey = metadata.idempotency_key;
+const step_response_1 = require("./step-response");
+function buildStepContext({ action, stepArguments, workflowMetadata, }) {
+    const transactionMetadata = stepArguments.metadata;
+    const idempotencyKey = transactionMetadata.idempotency_key;
     stepArguments.context.idempotencyKey = idempotencyKey;
     const flow = stepArguments.transaction.getFlow();
     const flowMetadata = flow?.metadata;
     const stepDefinition = stepArguments.step.definition;
     const executionContext = {
-        workflowId: metadata.model_id,
-        stepName: metadata.action,
+        workflowId: transactionMetadata.model_id,
+        stepName: transactionMetadata.action,
         action,
         idempotencyKey,
-        attempt: metadata.attempt,
+        attempt: transactionMetadata.attempt,
         container: stepArguments.container,
-        metadata,
+        metadata: workflowMetadata,
+        " transactionMetadata": transactionMetadata,
         eventGroupId: flowMetadata?.eventGroupId ?? stepArguments.context.eventGroupId,
         parentStepIdempotencyKey: flowMetadata?.parentStepIdempotencyKey,
         preventReleaseEvents: flowMetadata?.preventReleaseEvents ?? false,
@@ -25,69 +29,110 @@ function buildStepContext({ action, stepArguments, }) {
         runId: flow.runId,
         context: stepArguments.context,
         " stepDefinition": stepDefinition,
-        stepMetadata: stepDefinition.metadata,
         " getStepResult"(stepId, action = "invoke") {
             return stepArguments[action][stepId]?.output?.output;
         },
     };
     return executionContext;
 }
-function createStepHandler({ stepName, input, invokeFn, compensateFn, }) {
+function createStepHandler({ stepName, input, invokeFn, compensateFn, inputSchema, outputSchema, }) {
     const handler = {
         invoke: async (stepArguments) => {
-            const executionContext = buildStepContext({
-                action: "invoke",
-                stepArguments,
-            });
-            let argInput = {};
-            if (input) {
-                argInput = (0, resolve_value_1.resolveValue)(input, stepArguments);
-                if (argInput instanceof Promise) {
-                    argInput = await argInput;
+            const flow = stepArguments.transaction.getFlow();
+            const workflowMetadata = new orchestration_1.WorkflowMetadata(flow);
+            return (0, orchestration_1.runWithMetadata)(workflowMetadata, async () => {
+                const executionContext = buildStepContext({
+                    action: "invoke",
+                    stepArguments,
+                    workflowMetadata,
+                });
+                let argInput = {};
+                if (input) {
+                    argInput = (0, resolve_value_1.resolveValue)(input, stepArguments);
+                    if (argInput instanceof Promise) {
+                        argInput = await argInput;
+                    }
                 }
-            }
-            const stepResponse = await invokeFn.apply(this, [
-                argInput,
-                executionContext,
-            ]);
-            if (!stepResponse || typeof stepResponse !== "object") {
+                if (inputSchema) {
+                    try {
+                        argInput = (0, type_1.runSchema)(inputSchema, argInput);
+                    }
+                    catch (e) {
+                        const err = e instanceof Error ? e : new Error(String(e));
+                        err.message = `Step "${stepName}" input validation failed: ${err.message}`;
+                        throw err;
+                    }
+                }
+                let stepResponse = await invokeFn.apply(this, [
+                    argInput,
+                    executionContext,
+                ]);
+                if (outputSchema && stepResponse) {
+                    const isStepResp = stepResponse &&
+                        typeof stepResponse === "object" &&
+                        stepResponse.__type ===
+                            utils_1.OrchestrationUtils.SymbolWorkflowStepResponse;
+                    const raw = isStepResp ? stepResponse.output : stepResponse;
+                    try {
+                        const parsed = (0, type_1.runSchema)(outputSchema, raw);
+                        if (isStepResp) {
+                            stepResponse = new step_response_1.StepResponse(parsed, stepResponse.compensateInput);
+                        }
+                        else {
+                            stepResponse = parsed;
+                        }
+                    }
+                    catch (e) {
+                        const err = e instanceof Error ? e : new Error(String(e));
+                        err.message = `Step "${stepName}" output validation failed: ${err.message}`;
+                        throw err;
+                    }
+                }
+                if (!stepResponse || typeof stepResponse !== "object") {
+                    return {
+                        __type: utils_1.OrchestrationUtils.SymbolWorkflowWorkflowData,
+                        output: stepResponse,
+                    };
+                }
+                const stepResponseJSON = stepResponse.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse
+                    ? stepResponse.toJSON()
+                    : stepResponse;
                 return {
                     __type: utils_1.OrchestrationUtils.SymbolWorkflowWorkflowData,
-                    output: stepResponse,
+                    output: stepResponseJSON,
                 };
-            }
-            const stepResponseJSON = stepResponse.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse
-                ? stepResponse.toJSON()
-                : stepResponse;
-            return {
-                __type: utils_1.OrchestrationUtils.SymbolWorkflowWorkflowData,
-                output: stepResponseJSON,
-            };
+            });
         },
         compensate: compensateFn
             ? async (stepArguments) => {
-                const executionContext = buildStepContext({
-                    action: "compensate",
-                    stepArguments,
-                });
-                const stepOutput = stepArguments.invoke[stepName]?.output;
-                if (!stepOutput) {
+                const flow = stepArguments.transaction.getFlow();
+                const workflowMetadata = new orchestration_1.WorkflowMetadata(flow);
+                return (0, orchestration_1.runWithMetadata)(workflowMetadata, async () => {
+                    const executionContext = buildStepContext({
+                        action: "compensate",
+                        stepArguments,
+                        workflowMetadata,
+                    });
+                    const stepOutput = stepArguments.invoke[stepName]?.output;
+                    if (!stepOutput) {
+                        const output = await compensateFn.apply(this, [
+                            stepOutput,
+                            executionContext,
+                        ]);
+                        return { output };
+                    }
+                    const invokeResult = stepOutput.__type ===
+                        utils_1.OrchestrationUtils.SymbolWorkflowStepResponse
+                        ? stepOutput.compensateInput
+                        : stepOutput;
                     const output = await compensateFn.apply(this, [
-                        stepOutput,
+                        invokeResult,
                         executionContext,
                     ]);
-                    return { output };
-                }
-                const invokeResult = stepOutput.__type === utils_1.OrchestrationUtils.SymbolWorkflowStepResponse
-                    ? stepOutput.compensateInput
-                    : stepOutput;
-                const output = await compensateFn.apply(this, [
-                    invokeResult,
-                    executionContext,
-                ]);
-                return {
-                    output,
-                };
+                    return {
+                        output,
+                    };
+                });
             }
             : undefined,
     };

package/dist/utils/composer/helpers/create-step-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-step-handler.js","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/create-step-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-step-handler.js","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/create-step-handler.ts"],"names":[],"mappings":"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"}

package/dist/utils/composer/helpers/workflow-response.d.ts

@@ -1,43 +1,20 @@
 import { OrchestrationUtils } from "@acmekit/utils";
 import { WorkflowData, WorkflowDataProperties } from "../type";
 /**
- * Workflow response class encapsulates the return value of a workflow.
- *
- * Supports optional named output ports for selective output consumption.
- *
- * @example
- * ```ts
- * return new WorkflowResponse(primaryResult, {
- *   hooks: [myHook],
- *   outputs: {
- *     created: createdEntities,
- *     warnings: validationWarnings,
- *   },
- * })
- * ```
+ * Workflow response class encapsulates the return value of a workflow
  */
-export declare class WorkflowResponse<TResult, const THooks extends readonly unknown[] = [], TOutputs extends Record<string, unknown> = {}> {
+export declare class WorkflowResponse<TResult, const THooks extends readonly unknown[] = []> {
     $result: WorkflowData<TResult> | {
         [K in keyof TResult]: WorkflowData<TResult[K]> | WorkflowDataProperties<TResult[K]> | TResult[K];
     };
     options?: {
-        hooks?: THooks;
-        /**
-         * Named output ports. Allows consumers to selectively access
-         * partial outputs from a workflow execution.
-         */
-        outputs?: { [K in keyof TOutputs]: WorkflowData<TOutputs[K]> | TOutputs[K]; };
+        hooks: THooks;
     } | undefined;
     __type: typeof OrchestrationUtils.SymbolAcmeKitWorkflowResponse;
     constructor($result: WorkflowData<TResult> | {
         [K in keyof TResult]: WorkflowData<TResult[K]> | WorkflowDataProperties<TResult[K]> | TResult[K];
     }, options?: {
-        hooks?: THooks;
-        /**
-         * Named output ports. Allows consumers to selectively access
-         * partial outputs from a workflow execution.
-         */
-        outputs?: { [K in keyof TOutputs]: WorkflowData<TOutputs[K]> | TOutputs[K]; };
+        hooks: THooks;
     } | undefined);
 }
 //# sourceMappingURL=workflow-response.d.ts.map

package/dist/utils/composer/helpers/workflow-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-response.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/workflow-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB,CAC3B,OAAO,EACP,KAAK,CAAC,MAAM,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EAC5C,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE;IAMpC,OAAO,EACV,YAAY,CAAC,OAAO,CAAC,GACrB;SACG,CAAC,IAAI,MAAM,OAAO,GACf,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACxB,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC;KACf;IACE,OAAO,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd;;;WAGG;QACH,OAAO,CAAC,EAAE,GACP,CAAC,IAAI,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAC/D,CAAA;KACF;IArBH,MAAM,EAAE,OAAO,kBAAkB,CAAC,6BAA6B,CACb;gBAGzC,OAAO,EACV,YAAY,CAAC,OAAO,CAAC,GACrB;SACG,CAAC,IAAI,MAAM,OAAO,GACf,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACxB,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC;KACf,EACE,OAAO,CAAC,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd;;;WAGG;QACH,OAAO,CAAC,EAAE,GACP,CAAC,IAAI,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAC/D,CAAA;KACF,YAAA;CAEJ"}
+{"version":3,"file":"workflow-response.d.ts","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/workflow-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAE9D;;GAEG;AACH,qBAAa,gBAAgB,CAC3B,OAAO,EACP,KAAK,CAAC,MAAM,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE;IAMnC,OAAO,EACV,YAAY,CAAC,OAAO,CAAC,GACrB;SACG,CAAC,IAAI,MAAM,OAAO,GACf,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACxB,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC;KACf;IACE,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAZpC,MAAM,EAAE,OAAO,kBAAkB,CAAC,6BAA6B,CACb;gBAGzC,OAAO,EACV,YAAY,CAAC,OAAO,CAAC,GACrB;SACG,CAAC,IAAI,MAAM,OAAO,GACf,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACxB,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC;KACf,EACE,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,YAAA;CAErC"}

package/dist/utils/composer/helpers/workflow-response.js

@@ -3,20 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkflowResponse = void 0;
 const utils_1 = require("@acmekit/utils");
 /**
- * Workflow response class encapsulates the return value of a workflow.
- *
- * Supports optional named output ports for selective output consumption.
- *
- * @example
- * ```ts
- * return new WorkflowResponse(primaryResult, {
- *   hooks: [myHook],
- *   outputs: {
- *     created: createdEntities,
- *     warnings: validationWarnings,
- *   },
- * })
- * ```
+ * Workflow response class encapsulates the return value of a workflow
  */
 class WorkflowResponse {
     constructor($result, options) {

package/dist/utils/composer/helpers/workflow-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-response.js","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/workflow-response.ts"],"names":[],"mappings":";;;AAAA,0CAAmD;AAGnD;;;;;;;;;;;;;;;GAeG;AACH,MAAa,gBAAgB;IAQ3B,YACS,OAOF,EACE,OASN;QAjBM,YAAO,GAAP,OAAO,CAOT;QACE,YAAO,GAAP,OAAO,CASb;QArBH,WAAM,GACJ,0BAAkB,CAAC,6BAA6B,CAAA;IAqB/C,CAAC;CACL;AA5BD,4CA4BC"}
+{"version":3,"file":"workflow-response.js","sourceRoot":"","sources":["../../../../src/utils/composer/helpers/workflow-response.ts"],"names":[],"mappings":";;;AAAA,0CAAmD;AAGnD;;GAEG;AACH,MAAa,gBAAgB;IAO3B,YACS,OAOF,EACE,OAA2B;QAR3B,YAAO,GAAP,OAAO,CAOT;QACE,YAAO,GAAP,OAAO,CAAoB;QAZpC,WAAM,GACJ,0BAAkB,CAAC,6BAA6B,CAAA;IAY/C,CAAC;CACL;AAlBD,4CAkBC"}

package/dist/utils/composer/index.d.ts

@@ -4,12 +4,12 @@ export * from "./helpers/resolve-value";
 export * from "./helpers/step-response";
 export * from "./helpers/workflow-response";
 export * from "./create-hook";
-export * from "./for-each";
 export * from "./parallelize";
-export * from "./pipe";
-export * from "./race";
-export * from "./retry";
+export * from "./query";
+export * from "./signal";
 export * from "./transform";
 export * from "./type";
 export * from "./when";
+export { metadata } from "./metadata";
+export { WorkflowMetadata } from "@acmekit/orchestration";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/composer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/utils/composer/index.js

@@ -14,18 +14,21 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowMetadata = exports.metadata = void 0;
 __exportStar(require("./create-step"), exports);
 __exportStar(require("./create-workflow"), exports);
 __exportStar(require("./helpers/resolve-value"), exports);
 __exportStar(require("./helpers/step-response"), exports);
 __exportStar(require("./helpers/workflow-response"), exports);
 __exportStar(require("./create-hook"), exports);
-__exportStar(require("./for-each"), exports);
 __exportStar(require("./parallelize"), exports);
-__exportStar(require("./pipe"), exports);
-__exportStar(require("./race"), exports);
-__exportStar(require("./retry"), exports);
+__exportStar(require("./query"), exports);
+__exportStar(require("./signal"), exports);
 __exportStar(require("./transform"), exports);
 __exportStar(require("./type"), exports);
 __exportStar(require("./when"), exports);
+var metadata_1 = require("./metadata");
+Object.defineProperty(exports, "metadata", { enumerable: true, get: function () { return metadata_1.metadata; } });
+var orchestration_1 = require("@acmekit/orchestration");
+Object.defineProperty(exports, "WorkflowMetadata", { enumerable: true, get: function () { return orchestration_1.WorkflowMetadata; } });
 //# sourceMappingURL=index.js.map

package/dist/utils/composer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/composer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA6B;AAC7B,oDAAiC;AACjC,0DAAuC;AACvC,0DAAuC;AACvC,8DAA2C;AAC3C,gDAA6B;AAC7B,6CAA0B;AAC1B,gDAA6B;AAC7B,yCAAsB;AACtB,yCAAsB;AACtB,0CAAuB;AACvB,8CAA2B;AAC3B,yCAAsB;AACtB,yCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/composer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,gDAA6B;AAC7B,oDAAiC;AACjC,0DAAuC;AACvC,0DAAuC;AACvC,8DAA2C;AAC3C,gDAA6B;AAC7B,gDAA6B;AAC7B,0CAAuB;AACvB,2CAAwB;AACxB,8CAA2B;AAC3B,yCAAsB;AACtB,yCAAsB;AACtB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,wDAAyD;AAAhD,iHAAA,gBAAgB,OAAA"}

package/dist/utils/composer/metadata.d.ts

@@ -0,0 +1,37 @@
+import { WorkflowMetadata } from "@acmekit/orchestration";
+/**
+ * Unified metadata accessor. Works in all contexts:
+ *
+ * 1. **Inside step functions / query handlers / transform callbacks** —
+ *    Reads and writes go directly to the workflow's `flow.customMetadata`
+ *    via `AsyncLocalStorage`.
+ *
+ * 2. **Inside the workflow definition body** (same level as `transform()`,
+ *    `when()`) — Each write creates a lightweight internal step that
+ *    executes at runtime. `metadata.get()` creates a transform that
+ *    returns a `WorkflowData` proxy.
+ *
+ * 3. **Outside any context** — Safe no-op. Reads return `undefined`,
+ *    writes are silent.
+ *
+ * @example
+ * import { createStep, createWorkflow, metadata, StepResponse } from "@acmekit/framework/workflows-sdk"
+ *
+ * const step1 = createStep("step1", async () => {
+ *   metadata.set("stage", "processing")  // direct write
+ *   return new StepResponse("ok")
+ * })
+ *
+ * const step2 = createStep("step2", async () => {
+ *   return new StepResponse({ stage: metadata.get("stage") })
+ * })
+ *
+ * createWorkflow("my-wf", (input) => {
+ *   step1()
+ *   metadata.set("source", "workflow")   // creates internal step
+ *   const source = metadata.get("source") // creates transform → WorkflowData
+ *   return step2()
+ * })
+ */
+export declare const metadata: WorkflowMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/utils/composer/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/utils/composer/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEjB,MAAM,wBAAwB,CAAA;AA+G/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,QAAQ,EAAE,gBAcrB,CAAA"}