@upstash/workflow 0.2.3 → 0.2.5-agents

package/{chunk-QBJ3LQIO.mjs → chunk-RFX5YRRT.mjs}

@@ -1,34 +1,23 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
+import {
+  WorkflowAgents
+} from "./chunk-PU5J4TNC.mjs";
+
+// src/constants.ts
+var WORKFLOW_ID_HEADER = "Upstash-Workflow-RunId";
+var WORKFLOW_INIT_HEADER = "Upstash-Workflow-Init";
+var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
+var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
+var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
+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.3";
+var SDK_TELEMETRY = `@upstash/workflow@${VERSION}`;
+var TELEMETRY_HEADER_SDK = "Upstash-Telemetry-Sdk";
+var TELEMETRY_HEADER_FRAMEWORK = "Upstash-Telemetry-Framework";
+var TELEMETRY_HEADER_RUNTIME = "Upstash-Telemetry-Runtime";
 
 // src/error.ts
 import { QstashError } from "@upstash/qstash";
@@ -738,30 +727,23 @@ var Err = class {
 };
 var fromThrowable = Result.fromThrowable;
 
-// src/constants.ts
-var WORKFLOW_ID_HEADER = "Upstash-Workflow-RunId";
-var WORKFLOW_INIT_HEADER = "Upstash-Workflow-Init";
-var WORKFLOW_URL_HEADER = "Upstash-Workflow-Url";
-var WORKFLOW_FAILURE_HEADER = "Upstash-Workflow-Is-Failure";
-var WORKFLOW_FEATURE_HEADER = "Upstash-Feature-Set";
-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;
-
 // src/workflow-requests.ts
 import { QstashError as QstashError3 } from "@upstash/qstash";
-var triggerFirstInvocation = async (workflowContext, retries, useJSONContent, debug) => {
-  const { headers } = getHeaders(
-    "true",
-    workflowContext.workflowRunId,
-    workflowContext.url,
-    workflowContext.headers,
-    void 0,
-    workflowContext.failureUrl,
-    retries
-  );
+var triggerFirstInvocation = async ({
+  workflowContext,
+  useJSONContent,
+  telemetry,
+  debug
+}) => {
+  const { headers } = getHeaders({
+    initHeaderValue: "true",
+    workflowRunId: workflowContext.workflowRunId,
+    workflowUrl: workflowContext.url,
+    userHeaders: workflowContext.headers,
+    failureUrl: workflowContext.failureUrl,
+    retries: workflowContext.retries,
+    telemetry
+  });
   if (useJSONContent) {
     headers["content-type"] = "application/json";
   }
@@ -867,7 +849,16 @@ var recreateUserHeaders = (headers) => {
   }
   return filteredHeaders;
 };
-var handleThirdPartyCallResult = async (request, requestPayload, client, workflowUrl, failureUrl, retries, debug) => {
+var handleThirdPartyCallResult = async ({
+  request,
+  requestPayload,
+  client,
+  workflowUrl,
+  failureUrl,
+  retries,
+  telemetry,
+  debug
+}) => {
   try {
     if (request.headers.get("Upstash-Workflow-Callback")) {
       let callbackPayload;
@@ -926,15 +917,15 @@ ${atob(callbackMessage.body ?? "")}`
         );
       }
       const userHeaders = recreateUserHeaders(request.headers);
-      const { headers: requestHeaders } = getHeaders(
-        "false",
+      const { headers: requestHeaders } = getHeaders({
+        initHeaderValue: "false",
         workflowRunId,
         workflowUrl,
         userHeaders,
-        void 0,
         failureUrl,
-        retries
-      );
+        retries,
+        telemetry
+      });
       const callResponse = {
         status: callbackMessage.status,
         body: atob(callbackMessage.body ?? ""),
@@ -972,12 +963,31 @@ ${atob(callbackMessage.body ?? "")}`
     );
   }
 };
-var getHeaders = (initHeaderValue, workflowRunId, workflowUrl, userHeaders, step, failureUrl, retries, callRetries, callTimeout) => {
+var getTelemetryHeaders = (telemetry) => {
+  return {
+    [TELEMETRY_HEADER_SDK]: telemetry.sdk,
+    [TELEMETRY_HEADER_FRAMEWORK]: telemetry.framework,
+    [TELEMETRY_HEADER_RUNTIME]: telemetry.runtime ?? "unknown"
+  };
+};
+var getHeaders = ({
+  initHeaderValue,
+  workflowRunId,
+  workflowUrl,
+  userHeaders,
+  failureUrl,
+  retries,
+  step,
+  callRetries,
+  callTimeout,
+  telemetry
+}) => {
   const baseHeaders = {
     [WORKFLOW_INIT_HEADER]: initHeaderValue,
     [WORKFLOW_ID_HEADER]: workflowRunId,
     [WORKFLOW_URL_HEADER]: workflowUrl,
-    [WORKFLOW_FEATURE_HEADER]: "LazyFetch,InitialBody"
+    [WORKFLOW_FEATURE_HEADER]: "LazyFetch,InitialBody",
+    ...telemetry ? getTelemetryHeaders(telemetry) : {}
   };
   if (!step?.callUrl) {
     baseHeaders[`Upstash-Forward-${WORKFLOW_PROTOCOL_VERSION_HEADER}`] = WORKFLOW_PROTOCOL_VERSION;
@@ -1051,6 +1061,13 @@ var getHeaders = (initHeaderValue, workflowRunId, workflowUrl, userHeaders, step
         ...Object.fromEntries(
           Object.entries(baseHeaders).map(([header, value]) => [header, [value]])
         ),
+        // to include telemetry headers:
+        ...telemetry ? Object.fromEntries(
+          Object.entries(getTelemetryHeaders(telemetry)).map(([header, value]) => [
+            header,
+            [value]
+          ])
+        ) : {},
         // note: using WORKFLOW_ID_HEADER doesn't work, because Runid -> RunId:
         "Upstash-Workflow-Runid": [workflowRunId],
         [WORKFLOW_INIT_HEADER]: ["false"],
@@ -1089,6 +1106,7 @@ If you want to disable QStash Verification, you should clear env variables QSTAS
 };
 
 // src/context/auto-executor.ts
+import { QstashError as QstashError4 } from "@upstash/qstash";
 var AutoExecutor = class _AutoExecutor {
   context;
   promises = /* @__PURE__ */ new WeakMap();
@@ -1097,13 +1115,15 @@ var AutoExecutor = class _AutoExecutor {
   nonPlanStepCount;
   steps;
   indexInCurrentList = 0;
+  telemetry;
   stepCount = 0;
   planStepCount = 0;
   executingStep = false;
-  constructor(context, steps, debug) {
+  constructor(context, steps, telemetry, debug) {
     this.context = context;
-    this.debug = debug;
     this.steps = steps;
+    this.telemetry = telemetry;
+    this.debug = debug;
     this.nonPlanStepCount = this.steps.filter((step) => !step.targetStep).length;
   }
   /**
@@ -1246,7 +1266,7 @@ var AutoExecutor = class _AutoExecutor {
           );
           await this.submitStepsToQStash([resultStep], [parallelStep]);
         } catch (error) {
-          if (error instanceof WorkflowAbort) {
+          if (error instanceof WorkflowAbort || error instanceof QstashError4 && error.status === 400) {
             throw error;
           }
           throw new WorkflowError(
@@ -1317,15 +1337,16 @@ var AutoExecutor = class _AutoExecutor {
     });
     if (steps[0].waitEventId && steps.length === 1) {
       const waitStep = steps[0];
-      const { headers, timeoutHeaders } = getHeaders(
-        "false",
-        this.context.workflowRunId,
-        this.context.url,
-        this.context.headers,
-        waitStep,
-        this.context.failureUrl,
-        this.context.retries
-      );
+      const { headers, timeoutHeaders } = getHeaders({
+        initHeaderValue: "false",
+        workflowRunId: this.context.workflowRunId,
+        workflowUrl: this.context.url,
+        userHeaders: this.context.headers,
+        step: waitStep,
+        failureUrl: this.context.failureUrl,
+        retries: this.context.retries,
+        telemetry: this.telemetry
+      });
       const waitBody = {
         url: this.context.url,
         timeout: waitStep.timeout,
@@ -1352,17 +1373,18 @@ var AutoExecutor = class _AutoExecutor {
     const result = await this.context.qstashClient.batchJSON(
       steps.map((singleStep, index) => {
         const lazyStep = lazySteps[index];
-        const { headers } = getHeaders(
-          "false",
-          this.context.workflowRunId,
-          this.context.url,
-          this.context.headers,
-          singleStep,
-          this.context.failureUrl,
-          this.context.retries,
-          lazyStep instanceof LazyCallStep ? lazyStep.retries : void 0,
-          lazyStep instanceof LazyCallStep ? lazyStep.timeout : void 0
-        );
+        const { headers } = getHeaders({
+          initHeaderValue: "false",
+          workflowRunId: this.context.workflowRunId,
+          workflowUrl: this.context.url,
+          userHeaders: this.context.headers,
+          step: singleStep,
+          failureUrl: this.context.failureUrl,
+          retries: this.context.retries,
+          callRetries: lazyStep instanceof LazyCallStep ? lazyStep.retries : void 0,
+          callTimeout: lazyStep instanceof LazyCallStep ? lazyStep.timeout : void 0,
+          telemetry: this.telemetry
+        });
         const willWait = singleStep.concurrent === NO_CONCURRENCY || singleStep.stepId === 0;
         singleStep.out = JSON.stringify(singleStep.out);
         return singleStep.callUrl ? (
@@ -1727,7 +1749,8 @@ var WorkflowContext = class {
     debug,
     initialPayload,
     env,
-    retries
+    retries,
+    telemetry
   }) {
     this.qstashClient = qstashClient;
     this.workflowRunId = workflowRunId;
@@ -1738,7 +1761,7 @@ var WorkflowContext = class {
     this.requestPayload = initialPayload;
     this.env = env ?? {};
     this.retries = retries ?? DEFAULT_RETRIES;
-    this.executor = new AutoExecutor(this, this.steps, debug);
+    this.executor = new AutoExecutor(this, this.steps, telemetry, debug);
   }
   /**
    * Executes a workflow step
@@ -1979,6 +2002,11 @@ var WorkflowContext = class {
       context: this
     });
   }
+  get agents() {
+    return new WorkflowAgents({
+      context: this
+    });
+  }
 };
 
 // src/logger.ts
@@ -2183,6 +2211,7 @@ var checkIfLastOneIsDuplicate = async (steps, debug) => {
     if (step.stepId === lastStepId && step.targetStep === lastTargetStepId) {
       const message = `Upstash Workflow: The step '${step.stepName}' with id '${step.stepId}'  has run twice during workflow execution. Rest of the workflow will continue running as usual.`;
       await debug?.log("WARN", "RESPONSE_DEFAULT", message);
+      console.log(steps);
       console.warn(message);
       return true;
     }
@@ -2251,7 +2280,7 @@ var parseRequest = async (requestPayload, isFirstInvocation, workflowRunId, requ
     };
   }
 };
-var handleFailure = async (request, requestPayload, qstashClient, initialPayloadParser, routeFunction, failureFunction, debug) => {
+var handleFailure = async (request, requestPayload, qstashClient, initialPayloadParser, routeFunction, failureFunction, env, retries, debug) => {
   if (request.headers.get(WORKFLOW_FAILURE_HEADER) !== "true") {
     return ok("not-failure-callback");
   }
@@ -2276,7 +2305,11 @@ var handleFailure = async (request, requestPayload, qstashClient, initialPayload
       steps: [],
       url,
       failureUrl: url,
-      debug
+      debug,
+      env,
+      retries,
+      telemetry: void 0
+      // not going to make requests in authentication check
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -2351,6 +2384,7 @@ var processOptions = (options) => {
     env: environment,
     retries: DEFAULT_RETRIES,
     useJSONContent: false,
+    disableTelemetry: false,
     ...options
   };
 };
@@ -2385,7 +2419,7 @@ var determineUrls = async (request, url, baseUrl, failureFunction, failureUrl, d
 var AUTH_FAIL_MESSAGE = `Failed to authenticate Workflow request. If this is unexpected, see the caveat https://upstash.com/docs/workflow/basics/caveats#avoid-non-deterministic-code-outside-context-run`;
 
 // src/serve/index.ts
-var serveBase = (routeFunction, options) => {
+var serveBase = (routeFunction, telemetry, options) => {
   const {
     qstashClient,
     onStepFinish,
@@ -2398,8 +2432,10 @@ var serveBase = (routeFunction, options) => {
     baseUrl,
     env,
     retries,
-    useJSONContent
+    useJSONContent,
+    disableTelemetry
   } = processOptions(options);
+  telemetry = disableTelemetry ? void 0 : telemetry;
   const debug = WorkflowLogger.getLogger(verbose);
   const handler = async (request) => {
     await debug?.log("INFO", "ENDPOINT_START");
@@ -2435,7 +2471,10 @@ var serveBase = (routeFunction, options) => {
       qstashClient,
       initialPayloadParser,
       routeFunction,
-      failureFunction
+      failureFunction,
+      env,
+      retries,
+      debug
     );
     if (failureCheck.isErr()) {
       throw failureCheck.error;
@@ -2453,7 +2492,8 @@ var serveBase = (routeFunction, options) => {
       failureUrl: workflowFailureUrl,
       debug,
       env,
-      retries
+      retries,
+      telemetry
     });
     const authCheck = await DisabledWorkflowContext.tryAuthentication(
       routeFunction,
@@ -2469,22 +2509,23 @@ var serveBase = (routeFunction, options) => {
         "auth-fail"
       );
     }
-    const callReturnCheck = await handleThirdPartyCallResult(
+    const callReturnCheck = await handleThirdPartyCallResult({
       request,
-      rawInitialPayload,
-      qstashClient,
+      requestPayload: rawInitialPayload,
+      client: qstashClient,
       workflowUrl,
-      workflowFailureUrl,
+      failureUrl: workflowFailureUrl,
       retries,
+      telemetry,
       debug
-    );
+    });
     if (callReturnCheck.isErr()) {
       await debug?.log("ERROR", "SUBMIT_THIRD_PARTY_RESULT", {
         error: callReturnCheck.error.message
       });
       throw callReturnCheck.error;
     } else if (callReturnCheck.value === "continue-workflow") {
-      const result = isFirstInvocation ? await triggerFirstInvocation(workflowContext, retries, useJSONContent, debug) : await triggerRouteFunction({
+      const result = isFirstInvocation ? await triggerFirstInvocation({ workflowContext, useJSONContent, telemetry, debug }) : await triggerRouteFunction({
         onStep: async () => routeFunction(workflowContext),
         onCleanup: async () => {
           await triggerWorkflowDelete(workflowContext, debug);
@@ -2519,18 +2560,22 @@ var serveBase = (routeFunction, options) => {
   return { handler: safeHandler };
 };
 var serve = (routeFunction, options) => {
-  return serveBase(routeFunction, options);
+  return serveBase(
+    routeFunction,
+    {
+      sdk: SDK_TELEMETRY,
+      framework: "unknown"
+    },
+    options
+  );
 };
 
 export {
-  __require,
-  __commonJS,
-  __toESM,
   makeNotifyRequest,
   makeGetWaitersRequest,
+  SDK_TELEMETRY,
   WorkflowError,
   WorkflowAbort,
-  DEFAULT_RETRIES,
   StepTypes,
   triggerFirstInvocation,
   WorkflowContext,

package/cloudflare.d.mts

@@ -1,5 +1,8 @@
-import { R as RouteFunction, j as PublicServeOptions } from './types-R9q4MUwl.mjs';
+import { R as RouteFunction, j as PublicServeOptions } from './types-BEyIoCRe.mjs';
 import '@upstash/qstash';
+import 'ai';
+import '@ai-sdk/openai';
+import 'langchain/tools';
 
 type WorkflowBindings = {
     QSTASH_TOKEN: string;

package/cloudflare.d.ts

@@ -1,5 +1,8 @@
-import { R as RouteFunction, j as PublicServeOptions } from './types-R9q4MUwl.js';
+import { R as RouteFunction, j as PublicServeOptions } from './types-BEyIoCRe.js';
 import '@upstash/qstash';
+import 'ai';
+import '@ai-sdk/openai';
+import 'langchain/tools';
 
 type WorkflowBindings = {
     QSTASH_TOKEN: string;