@upstash/workflow 0.2.17 → 0.2.18

package/nextjs.js

@@ -89,12 +89,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -638,6 +639,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -738,10 +742,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -2771,6 +2776,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2785,7 +2806,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2798,6 +2820,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry, invokeCount, debug);
   }
   /**
@@ -3098,7 +3121,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -3275,11 +3299,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -3288,8 +3313,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3498,6 +3524,7 @@ var serveBase = (routeFunction, telemetry, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3512,7 +3539,8 @@ var serveBase = (routeFunction, telemetry, options) => {
       retryDelay,
       telemetry,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,

package/nextjs.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-RP7G4UD5.mjs";
+} from "./chunk-EHL7SSJF.mjs";
 
 // platforms/nextjs.ts
 var appTelemetry = {

package/package.json

@@ -1 +1 @@
-{"name":"@upstash/workflow","version":"v0.2.17","description":"Durable, Reliable and Performant Serverless Functions","main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"},"./astro":{"import":"./astro.mjs","require":"./astro.js"},"./express":{"import":"./express.mjs","require":"./express.js"}},"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"repository":{"type":"git","url":"git+https://github.com/upstash/workflow-ts.git"},"keywords":["upstash","qstash","workflow","serverless"],"author":"Cahid Arda Oz","license":"MIT","bugs":{"url":"https://github.com/upstash/workflow-ts/issues"},"homepage":"https://github.com/upstash/workflow-ts#readme","devDependencies":{"@ai-sdk/anthropic":"^1.1.15","@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@eslint/js":"^9.11.1","@solidjs/start":"^1.0.8","@sveltejs/kit":"^2.6.1","@types/bun":"^1.1.10","@types/express":"^5.0.3","astro":"^4.16.7","eslint":"^9.11.1","eslint-plugin-unicorn":"^55.0.0","express":"^5.1.0","globals":"^15.10.0","h3":"^1.12.0","hono":"^4.6.20","husky":"^9.1.6","next":"^14.2.14","prettier":"3.3.3","tsup":"^8.3.0","typescript":"^5.7.2","typescript-eslint":"^8.18.0"},"dependencies":{"@ai-sdk/openai":"^1.2.1","@upstash/qstash":"^2.8.2","ai":"^4.1.54","zod":"^3.24.1"},"directories":{"example":"examples"}}
+{"name":"@upstash/workflow","version":"v0.2.18","description":"Durable, Reliable and Performant Serverless Functions","main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"},"./astro":{"import":"./astro.mjs","require":"./astro.js"},"./express":{"import":"./express.mjs","require":"./express.js"}},"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"repository":{"type":"git","url":"git+https://github.com/upstash/workflow-ts.git"},"keywords":["upstash","qstash","workflow","serverless"],"author":"Cahid Arda Oz","license":"MIT","bugs":{"url":"https://github.com/upstash/workflow-ts/issues"},"homepage":"https://github.com/upstash/workflow-ts#readme","devDependencies":{"@ai-sdk/anthropic":"^1.1.15","@commitlint/cli":"^19.5.0","@commitlint/config-conventional":"^19.5.0","@eslint/js":"^9.11.1","@solidjs/start":"^1.0.8","@sveltejs/kit":"^2.6.1","@types/bun":"^1.1.10","@types/express":"^5.0.3","astro":"^4.16.7","eslint":"^9.11.1","eslint-plugin-unicorn":"^55.0.0","express":"^5.1.0","globals":"^15.10.0","h3":"^1.12.0","hono":"^4.6.20","husky":"^9.1.6","next":"^14.2.14","prettier":"3.3.3","tsup":"^8.3.0","typescript":"^5.7.2","typescript-eslint":"^8.18.0"},"dependencies":{"@ai-sdk/openai":"^1.2.1","@upstash/qstash":"^2.8.2","ai":"^4.1.54","zod":"^3.24.1"},"directories":{"example":"examples"}}

package/{serve-many-B3DfoTFt.d.ts → serve-many-BObe3pdI.d.ts}

@@ -1,4 +1,4 @@
-import { n as PublicServeOptions, R as RouteFunction, x as InvokableWorkflow } from './types--R_3XZXz.js';
+import { n as PublicServeOptions, R as RouteFunction, x as InvokableWorkflow } from './types-B7_5AkKQ.js';
 
 type OmitOptionsInServeMany<TOptions> = Omit<TOptions, "env" | "url" | "schema" | "initialPayloadParser">;
 declare const serveManyBase: <THandler extends (...params: any[]) => any, TOptions extends OmitOptionsInServeMany<PublicServeOptions> = OmitOptionsInServeMany<PublicServeOptions>, TServeParams extends [routeFunction: RouteFunction<any, any>, options: TOptions] = [routeFunction: RouteFunction<any, any>, options: TOptions]>({ workflows, getUrl, serveMethod, options, }: {

package/{serve-many-DgDSOvQs.d.mts → serve-many-CEUYWQvV.d.mts}

@@ -1,4 +1,4 @@
-import { n as PublicServeOptions, R as RouteFunction, x as InvokableWorkflow } from './types--R_3XZXz.mjs';
+import { n as PublicServeOptions, R as RouteFunction, x as InvokableWorkflow } from './types-B7_5AkKQ.mjs';
 
 type OmitOptionsInServeMany<TOptions> = Omit<TOptions, "env" | "url" | "schema" | "initialPayloadParser">;
 declare const serveManyBase: <THandler extends (...params: any[]) => any, TOptions extends OmitOptionsInServeMany<PublicServeOptions> = OmitOptionsInServeMany<PublicServeOptions>, TServeParams extends [routeFunction: RouteFunction<any, any>, options: TOptions] = [routeFunction: RouteFunction<any, any>, options: TOptions]>({ workflows, getUrl, serveMethod, options, }: {

package/solidjs.d.mts

@@ -1,5 +1,5 @@
 import { APIEvent } from '@solidjs/start/server';
-import { R as RouteFunction, n as PublicServeOptions } from './types--R_3XZXz.mjs';
+import { R as RouteFunction, n as PublicServeOptions } from './types-B7_5AkKQ.mjs';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/solidjs.d.ts

@@ -1,5 +1,5 @@
 import { APIEvent } from '@solidjs/start/server';
-import { R as RouteFunction, n as PublicServeOptions } from './types--R_3XZXz.js';
+import { R as RouteFunction, n as PublicServeOptions } from './types-B7_5AkKQ.js';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/solidjs.js

@@ -84,12 +84,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -633,6 +634,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -733,10 +737,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -2699,6 +2704,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2713,7 +2734,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2726,6 +2748,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry, invokeCount, debug);
   }
   /**
@@ -3026,7 +3049,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -3203,11 +3227,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -3216,8 +3241,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3426,6 +3452,7 @@ var serveBase = (routeFunction, telemetry, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3440,7 +3467,8 @@ var serveBase = (routeFunction, telemetry, options) => {
       retryDelay,
       telemetry,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,

package/solidjs.mjs

@@ -1,7 +1,7 @@
 import {
   SDK_TELEMETRY,
   serveBase
-} from "./chunk-RP7G4UD5.mjs";
+} from "./chunk-EHL7SSJF.mjs";
 
 // platforms/solidjs.ts
 var serve = (routeFunction, options) => {

package/svelte.d.mts

@@ -1,7 +1,7 @@
 import * as _sveltejs_kit from '@sveltejs/kit';
 import { RequestHandler } from '@sveltejs/kit';
-import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.mjs';
-import { s as serveManyBase } from './serve-many-DgDSOvQs.mjs';
+import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.mjs';
+import { s as serveManyBase } from './serve-many-CEUYWQvV.mjs';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/svelte.d.ts

@@ -1,7 +1,7 @@
 import * as _sveltejs_kit from '@sveltejs/kit';
 import { RequestHandler } from '@sveltejs/kit';
-import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types--R_3XZXz.js';
-import { s as serveManyBase } from './serve-many-B3DfoTFt.js';
+import { R as RouteFunction, n as PublicServeOptions, x as InvokableWorkflow } from './types-B7_5AkKQ.js';
+import { s as serveManyBase } from './serve-many-BObe3pdI.js';
 import '@upstash/qstash';
 import 'zod';
 import 'ai';

package/svelte.js

@@ -86,12 +86,13 @@ var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
 var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
 var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
 var WORKFLOW_INVOKE_COUNT_HEADER = "Upstash-Workflow-Invoke-Count";
+var WORKFLOW_LABEL_HEADER = "Upstash-Label";
 var WORKFLOW_PROTOCOL_VERSION = "1";
 var WORKFLOW_PROTOCOL_VERSION_HEADER = "Upstash-Workflow-Sdk-Version";
 var DEFAULT_CONTENT_TYPE = "application/json";
 var NO_CONCURRENCY = 1;
 var DEFAULT_RETRIES = 3;
-var VERSION = "v0.2.17";
+var VERSION = "v0.2.18";
 var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
 var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
 var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
@@ -635,6 +636,9 @@ var triggerFirstInvocation = async (params) => {
       if (useJSONContent) {
         headers["content-type"] = "application/json";
       }
+      if (workflowContext.label) {
+        headers[WORKFLOW_LABEL_HEADER] = workflowContext.label;
+      }
       const body = typeof workflowContext.requestPayload === "string" ? workflowContext.requestPayload : JSON.stringify(workflowContext.requestPayload);
       return {
         headers,
@@ -735,10 +739,11 @@ var recreateUserHeaders = (headers) => {
   const pairs = headers.entries();
   for (const [header, value] of pairs) {
     const headerLowerCase = header.toLowerCase();
-    if (!headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
+    const isUserHeader = !headerLowerCase.startsWith("upstash-workflow-") && // https://vercel.com/docs/edge-network/headers/request-headers#x-vercel-id
     !headerLowerCase.startsWith("x-vercel-") && !headerLowerCase.startsWith("x-forwarded-") && // https://blog.cloudflare.com/preventing-request-loops-using-cdn-loop/
     headerLowerCase !== "cf-connecting-ip" && headerLowerCase !== "cdn-loop" && headerLowerCase !== "cf-ew-via" && headerLowerCase !== "cf-ray" && // For Render https://render.com
-    headerLowerCase !== "render-proxy-ttl") {
+    headerLowerCase !== "render-proxy-ttl" || headerLowerCase === WORKFLOW_LABEL_HEADER.toLocaleLowerCase();
+    if (isUserHeader) {
       filteredHeaders.append(header, value);
     }
   }
@@ -2768,6 +2773,22 @@ var WorkflowContext = class {
    * and number of requests per second with the same key.
    */
   flowControl;
+  /**
+   * Label to apply to the workflow run.
+   *
+   * Can be used to filter the workflow run logs.
+   *
+   * Can be set by passing a `label` parameter when triggering the workflow
+   * with `client.trigger`:
+   *
+   * ```ts
+   * await client.trigger({
+   *   url: "https://workflow-endpoint.com",
+   *   label: "my-label"
+   * });
+   * ```
+   */
+  label;
   constructor({
     qstashClient,
     workflowRunId,
@@ -2782,7 +2803,8 @@ var WorkflowContext = class {
     retryDelay,
     telemetry: telemetry2,
     invokeCount,
-    flowControl
+    flowControl,
+    label
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -2795,6 +2817,7 @@ var WorkflowContext = class {
     this.retries = retries ?? DEFAULT_RETRIES;
     this.retryDelay = retryDelay;
     this.flowControl = flowControl;
+    this.label = label;
     this.executor = new AutoExecutor(this, this.steps, telemetry2, invokeCount, debug);
   }
   /**
@@ -3095,7 +3118,8 @@ var DisabledWorkflowContext = class _DisabledWorkflowContext extends WorkflowCon
       env: context.env,
       retries: context.retries,
       retryDelay: context.retryDelay,
-      flowControl: context.flowControl
+      flowControl: context.flowControl,
+      label: context.label
     });
     try {
       await routeFunction(disabledContext);
@@ -3272,11 +3296,12 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
     if (!errorMessage) {
       errorMessage = `Couldn't parse 'failResponse' in 'failureFunction', received: '${decodedBody}'`;
     }
+    const userHeaders = recreateUserHeaders(request.headers);
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
       initialPayload: sourceBody ? initialPayloadParser(decodeBase64(sourceBody)) : void 0,
-      headers: recreateUserHeaders(request.headers),
+      headers: userHeaders,
       steps: [],
       url,
       failureUrl: url,
@@ -3285,8 +3310,9 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       retries,
       retryDelay,
       flowControl,
-      telemetry: void 0
+      telemetry: void 0,
       // not going to make requests in authentication check
+      label: userHeaders.get(WORKFLOW_LABEL_HEADER) ?? void 0
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -3495,6 +3521,7 @@ var serveBase = (routeFunction, telemetry2, options) => {
       });
     }
     const invokeCount = Number(request.headers.get(WORKFLOW_INVOKE_COUNT_HEADER) ?? "0");
+    const label = request.headers.get(WORKFLOW_LABEL_HEADER) ?? void 0;
     const workflowContext = new WorkflowContext({
       qstashClient,
       workflowRunId,
@@ -3509,7 +3536,8 @@ var serveBase = (routeFunction, telemetry2, options) => {
       retryDelay,
       telemetry: telemetry2,
       invokeCount,
-      flowControl
+      flowControl,
+      label
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,

package/svelte.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-RP7G4UD5.mjs";
+} from "./chunk-EHL7SSJF.mjs";
 
 // platforms/svelte.ts
 var telemetry = {

package/{types--R_3XZXz.d.ts → types-B7_5AkKQ.d.mts}

@@ -913,7 +913,23 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      * and number of requests per second with the same key.
      */
     readonly flowControl?: FlowControl;
-    constructor({ qstashClient, workflowRunId, headers, steps, url, failureUrl, debug, initialPayload, env, retries, retryDelay, telemetry, invokeCount, flowControl, }: {
+    /**
+     * Label to apply to the workflow run.
+     *
+     * Can be used to filter the workflow run logs.
+     *
+     * Can be set by passing a `label` parameter when triggering the workflow
+     * with `client.trigger`:
+     *
+     * ```ts
+     * await client.trigger({
+     *   url: "https://workflow-endpoint.com",
+     *   label: "my-label"
+     * });
+     * ```
+     */
+    readonly label?: string;
+    constructor({ qstashClient, workflowRunId, headers, steps, url, failureUrl, debug, initialPayload, env, retries, retryDelay, telemetry, invokeCount, flowControl, label, }: {
         qstashClient: WorkflowClient;
         workflowRunId: string;
         headers: Headers;
@@ -928,6 +944,7 @@ declare class WorkflowContext<TInitialPayload = unknown> {
         telemetry?: Telemetry;
         invokeCount?: number;
         flowControl?: FlowControl;
+        label?: string;
     });
     /**
      * Executes a workflow step

package/{types--R_3XZXz.d.mts → types-B7_5AkKQ.d.ts}

@@ -913,7 +913,23 @@ declare class WorkflowContext<TInitialPayload = unknown> {
      * and number of requests per second with the same key.
      */
     readonly flowControl?: FlowControl;
-    constructor({ qstashClient, workflowRunId, headers, steps, url, failureUrl, debug, initialPayload, env, retries, retryDelay, telemetry, invokeCount, flowControl, }: {
+    /**
+     * Label to apply to the workflow run.
+     *
+     * Can be used to filter the workflow run logs.
+     *
+     * Can be set by passing a `label` parameter when triggering the workflow
+     * with `client.trigger`:
+     *
+     * ```ts
+     * await client.trigger({
+     *   url: "https://workflow-endpoint.com",
+     *   label: "my-label"
+     * });
+     * ```
+     */
+    readonly label?: string;
+    constructor({ qstashClient, workflowRunId, headers, steps, url, failureUrl, debug, initialPayload, env, retries, retryDelay, telemetry, invokeCount, flowControl, label, }: {
         qstashClient: WorkflowClient;
         workflowRunId: string;
         headers: Headers;
@@ -928,6 +944,7 @@ declare class WorkflowContext<TInitialPayload = unknown> {
         telemetry?: Telemetry;
         invokeCount?: number;
         flowControl?: FlowControl;
+        label?: string;
     });
     /**
      * Executes a workflow step