workflow 2.0.6 → 4.0.1-beta.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Vercel, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+<div align="center">
+  <a href="https://useworkflow.dev">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://useworkflow.dev/workflow-circle-symbol-dark.svg">
+      <img alt="Workflow DevKit logo" src="https://useworkflow.dev/workflow-circle-symbol-light.svg" height="128">
+    </picture>
+  </a>
+  <h1>Workflow Development Kit</h1>
+
+<a href="https://vercel.com"><img alt="Vercel logo" src="https://img.shields.io/badge/MADE%20BY%20Vercel-000000.svg?style=for-the-badge&logo=Vercel&labelColor=000"></a>
+<a href="https://www.npmjs.com/package/next"><img alt="NPM version" src="https://img.shields.io/npm/v/workflow?style=for-the-badge&labelColor=000000"></a>
+<a href="https://github.com/vercel/workflow/blob/canary/license.md"><img alt="License" src="https://img.shields.io/npm/l/workflow.svg?style=for-the-badge&labelColor=000000"></a>
+<a href="https://github.com/vercel/workflow/discussions"><img alt="Join the community on GitHub" src="https://img.shields.io/badge/Join%20the%20community-blueviolet.svg?style=for-the-badge&logo=Github&labelColor=000000&logoWidth=20"></a>
+
+</div>
+
+## Getting Started
+
+The **Workflow Development Kit** lets you easily add durability, reliability, and observability to async JavaScript. Build apps and AI Agents that can suspend, resume, and maintain state with ease.
+
+Visit [https://useworkflow.dev](https://useworkflow.dev) to view the full documentation.
+
+## Community
+
+The Workflow DevKit community can be found on [GitHub Discussions](https://github.com/vercel/workflow/discussions) where you can ask questions, voice ideas, and share your projects with other people.
+
+## Contributing
+
+Contributions to Workflow DevKit are welcome and highly appreciated. Please use GitHub [issues](https://github.com/vercel/workflow/issues) and [discussions](https://github.com/vercel/workflow/discussions) to collaborate with the team and the wider community.
+
+## Authors
+
+Workflow DevKit was built by engineers at [Vercel](https://vercel.com) and the [Open Source Community](https://github.com/vercel/workflow/graphs/contributors).
+
+The initial core contributing engineers are
+
+- Adrian Lam ([@adriandlam](https://github.com/adriandlam))
+- Dillon Mulroy ([@dmmulroy](https://github.com/dmmulroy))
+- Gal Schlezinger ([@Schniz](https://github.com/Schniz))
+- JJ Kasper ([@ijjk](https://github.com/ijjk))
+- Nathan Rajlich ([@TooTallNate](https://github.com/TooTallNate))
+- Peter Wielander ([@VaguelySerious](https://github.com/VaguelySerious))
+- Pranay Prakash ([@pranaygp](https://github.com/pranaygp))
+
+The Workflow DevKit Logo was designed by Cecilio Ruiz [@ceciliorz](https://x.com/ceciliorz)
+
+---
+
+## Security
+
+If you believe you have found a security vulnerability in Workflow DevKit, we encourage you to **_responsibly disclose this and NOT open a public issue_**.
+
+To participate in our Open Source Software Bug Bounty program, please email [responsible.disclosure@vercel.com](mailto:responsible.disclosure@vercel.com). We will add you to the program and provide further instructions for submitting your report.

package/bin/run.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '@workflow/cli/bin/run.js';

package/dist/api.d.ts

@@ -0,0 +1,2 @@
+export { type Event, getHookByToken, getRun, Run, resumeHook, resumeWebhook, runStep, type StartOptions, start, type WorkflowRun, } from '@workflow/core/runtime';
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,cAAc,EACd,MAAM,EACN,GAAG,EACH,UAAU,EACV,aAAa,EACb,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,EACL,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC"}

package/dist/api.js

@@ -0,0 +1,2 @@
+export { getHookByToken, getRun, Run, resumeHook, resumeWebhook, runStep, start, } from '@workflow/core/runtime';
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,MAAM,EACN,GAAG,EACH,UAAU,EACV,aAAa,EACb,OAAO,EAEP,KAAK,GAEN,MAAM,wBAAwB,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,26 @@
+"use strict";
+// CommonJS wrapper for dual SDK/TypeScript plugin functionality
+// Allows workflow to work as both:
+// 1. An SDK: import { ... } from 'workflow'
+// 2. A TypeScript Language Service plugin
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_module_1 = require("node:module");
+const requireFromHere = (0, node_module_1.createRequire)(__filename);
+const sdk = requireFromHere('./index.js');
+function createTSPlugin(options) {
+    // The package is being used as a TypeScript Language Service plugin
+    if (options &&
+        'typescript' in options &&
+        typeof options.typescript === 'object') {
+        const pluginInit = requireFromHere('@workflow/typescript-plugin');
+        return pluginInit(options);
+    }
+    // Not being used as a TS plugin
+    throw new Error('workflow should be imported using named exports, not called as a function.\nUse: import { ... } from "workflow"');
+}
+// Export all named exports from the SDK
+Object.keys(sdk).forEach((key) => {
+    createTSPlugin[key] = sdk[key];
+});
+module.exports = createTSPlugin;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.cts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,mCAAmC;AACnC,4CAA4C;AAC5C,0CAA0C;;AAE1C,6CAA4C;AAC5C,MAAM,eAAe,GAAG,IAAA,2BAAa,EAAC,UAAU,CAAC,CAAC;AAElD,MAAM,GAAG,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;AAE1C,SAAS,cAAc,CAAC,OAAY;IAClC,oEAAoE;IACpE,IACE,OAAO;QACP,YAAY,IAAI,OAAO;QACvB,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EACtC,CAAC;QACD,MAAM,UAAU,GAAG,eAAe,CAAC,6BAA6B,CAAC,CAAC;QAClE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,MAAM,IAAI,KAAK,CACb,iHAAiH,CAClH,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;IAC9B,cAAsB,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,GAAG,cAAc,CAAC"}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.cts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from '@workflow/core';
+export * from './stdlib.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from '@workflow/core';
+export * from './stdlib.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/internal/builtins.d.ts

@@ -0,0 +1,9 @@
+/**
+ * These are the built-in steps that are "automatically available" in the workflow scope. They are
+ * similar to "stdlib" except that are not meant to be imported by users, but are instead "just available"
+ * alongside user defined steps. They are used internally by the runtime
+ */
+export declare function __builtin_response_array_buffer(res: Response): Promise<ArrayBuffer>;
+export declare function __builtin_response_json(res: Response): Promise<unknown>;
+export declare function __builtin_response_text(res: Response): Promise<string>;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/internal/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/internal/builtins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAsB,+BAA+B,CAAC,GAAG,EAAE,QAAQ,wBAGlE;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,oBAG1D;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,mBAG1D"}

package/dist/internal/builtins.js

@@ -0,0 +1,18 @@
+/**
+ * These are the built-in steps that are "automatically available" in the workflow scope. They are
+ * similar to "stdlib" except that are not meant to be imported by users, but are instead "just available"
+ * alongside user defined steps. They are used internally by the runtime
+ */
+export async function __builtin_response_array_buffer(res) {
+    'use step';
+    return res.arrayBuffer();
+}
+export async function __builtin_response_json(res) {
+    'use step';
+    return res.json();
+}
+export async function __builtin_response_text(res) {
+    'use step';
+    return res.text();
+}
+//# sourceMappingURL=builtins.js.map

package/dist/internal/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/internal/builtins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,GAAa;IACjE,UAAU,CAAC;IACX,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAa;IACzD,UAAU,CAAC;IACX,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAa;IACzD,UAAU,CAAC;IACX,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/internal/errors.d.ts

@@ -0,0 +1,2 @@
+export { WorkflowAPIError, WorkflowError, WorkflowRunCancelledError, WorkflowRunFailedError, WorkflowRunNotCompletedError, WorkflowRunNotFoundError, WorkflowRuntimeError, } from '@workflow/errors';
+//# sourceMappingURL=errors.d.ts.map

package/dist/internal/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/internal/errors.js

@@ -0,0 +1,2 @@
+export { WorkflowAPIError, WorkflowError, WorkflowRunCancelledError, WorkflowRunFailedError, WorkflowRunNotCompletedError, WorkflowRunNotFoundError, WorkflowRuntimeError, } from '@workflow/errors';
+//# sourceMappingURL=errors.js.map

package/dist/internal/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/internal/observability.d.ts

@@ -0,0 +1,6 @@
+/**
+ * These are shared observability utilities that are used by the CLI and Web UIs.
+ * They might later be moved to be part of the core API.
+ */
+export * from '@workflow/core/observability';
+//# sourceMappingURL=observability.d.ts.map

package/dist/internal/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/internal/observability.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,8BAA8B,CAAC"}

package/dist/internal/observability.js

@@ -0,0 +1,6 @@
+/**
+ * These are shared observability utilities that are used by the CLI and Web UIs.
+ * They might later be moved to be part of the core API.
+ */
+export * from '@workflow/core/observability';
+//# sourceMappingURL=observability.js.map

package/dist/internal/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/internal/observability.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,8BAA8B,CAAC"}

package/dist/internal/private.d.ts

@@ -0,0 +1,6 @@
+/**
+ * This is the "private" API of the workflow runtime that referenced by the compiler's output
+ * but not meant to be document and used directly in user code.
+ */
+export * from '@workflow/core/private';
+//# sourceMappingURL=private.d.ts.map

package/dist/internal/private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private.d.ts","sourceRoot":"","sources":["../../src/internal/private.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/internal/private.js

@@ -0,0 +1,6 @@
+/**
+ * This is the "private" API of the workflow runtime that referenced by the compiler's output
+ * but not meant to be document and used directly in user code.
+ */
+export * from '@workflow/core/private';
+//# sourceMappingURL=private.js.map

package/dist/internal/private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"private.js","sourceRoot":"","sources":["../../src/internal/private.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/internal/serialization.d.ts

@@ -0,0 +1,2 @@
+export * from '@workflow/core/serialization';
+//# sourceMappingURL=serialization.d.ts.map

package/dist/internal/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/internal/serialization.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/internal/serialization.js

@@ -0,0 +1,2 @@
+export * from '@workflow/core/serialization';
+//# sourceMappingURL=serialization.js.map

package/dist/internal/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/internal/serialization.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/next.d.ts

@@ -0,0 +1,2 @@
+export * from '@workflow/next';
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/next.js

@@ -0,0 +1,2 @@
+export * from '@workflow/next';
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/nitro.d.ts

@@ -0,0 +1,4 @@
+import workflowNitro from '@workflow/nitro';
+export * from '@workflow/nitro';
+export default workflowNitro;
+//# sourceMappingURL=nitro.d.ts.map

package/dist/nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro.d.ts","sourceRoot":"","sources":["../src/nitro.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,cAAc,iBAAiB,CAAC;AAChC,eAAe,aAAa,CAAC"}

package/dist/nitro.js

@@ -0,0 +1,4 @@
+import workflowNitro from '@workflow/nitro';
+export * from '@workflow/nitro';
+export default workflowNitro;
+//# sourceMappingURL=nitro.js.map

package/dist/nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro.js","sourceRoot":"","sources":["../src/nitro.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,cAAc,iBAAiB,CAAC;AAChC,eAAe,aAAa,CAAC"}

package/dist/rollup-plugin.d.ts

@@ -0,0 +1,2 @@
+export { workflowRollupPlugin } from '@workflow/nitro/rollup-plugin';
+//# sourceMappingURL=rollup-plugin.d.ts.map

package/dist/rollup-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-plugin.d.ts","sourceRoot":"","sources":["../src/rollup-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/rollup-plugin.js

@@ -0,0 +1,2 @@
+export { workflowRollupPlugin } from '@workflow/nitro/rollup-plugin';
+//# sourceMappingURL=rollup-plugin.js.map

package/dist/rollup-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-plugin.js","sourceRoot":"","sources":["../src/rollup-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,2 @@
+export { createWorld, getWorld, getWorldHandlers, setWorld, stepEntrypoint, workflowEntrypoint, } from '@workflow/core/runtime';
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/runtime.js

@@ -0,0 +1,2 @@
+export { createWorld, getWorld, getWorldHandlers, setWorld, stepEntrypoint, workflowEntrypoint, } from '@workflow/core/runtime';
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/stdlib.d.ts

@@ -0,0 +1,35 @@
+/**
+ * This is the "standard library" of steps that we make available to all workflow users.
+ * The can be imported like so: `import { sleep, fetch } from 'workflow'`. and used in workflow.
+ * The need to be exported directly in this package and cannot live in `core` to prevent
+ * circular dependencies post-compilation.
+ */
+import { type StringValue } from 'ms';
+/**
+ * Sleep within a workflow for a given duration.
+ *
+ * @param duration - The duration to sleep for, this is a string in the format
+ * of `"1000ms"`, `"1s"`, `"1m"`, `"1h"`, or `"1d"`.
+ * @overload
+ * @returns A promise that resolves when the sleep is complete.
+ */
+export declare function sleep(duration: StringValue): Promise<void>;
+/**
+ * Sleep within a workflow until a specific date.
+ *
+ * @param date - The date to sleep until, this must be a future date.
+ * @overload
+ * @returns A promise that resolves when the sleep is complete.
+ */
+export declare function sleep(date: Date): Promise<void>;
+export declare namespace sleep {
+    var maxRetries: number;
+}
+/**
+ * A hoisted `fetch()` function that is executed as a "step" function,
+ * for use within workflow functions.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
+ */
+export declare function fetch(...args: Parameters<typeof globalThis.fetch>): Promise<Response>;
+//# sourceMappingURL=stdlib.d.ts.map

package/dist/stdlib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdlib.d.ts","sourceRoot":"","sources":["../src/stdlib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAW,EAAE,KAAK,WAAW,EAAE,MAAM,IAAI,CAAC;AAQ1C;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;yBAAjC,KAAK;;;AAiC3B;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,qBAGvE"}

package/dist/stdlib.js

@@ -0,0 +1,47 @@
+/**
+ * This is the "standard library" of steps that we make available to all workflow users.
+ * The can be imported like so: `import { sleep, fetch } from 'workflow'`. and used in workflow.
+ * The need to be exported directly in this package and cannot live in `core` to prevent
+ * circular dependencies post-compilation.
+ */
+import { RetryableError } from '@workflow/errors';
+import ms from 'ms';
+import { getStepMetadata } from './index.js';
+// vqs has a max message visibility lifespan, the workflow sleep function
+// will retry repeatedly until the user requested duration is reached.
+// (Eventually make this configurable based on the queue backend adapter)
+const MAX_SLEEP_DURATION_SECONDS = ms('23h') / 1000;
+export async function sleep(param) {
+    'use step';
+    const { stepStartedAt } = getStepMetadata();
+    const durationMs = typeof param === 'string'
+        ? ms(param)
+        : param.getTime() - Number(stepStartedAt);
+    if (typeof durationMs !== 'number' || durationMs < 0) {
+        const message = param instanceof Date
+            ? `Invalid sleep date: "${param}". Expected a future date.`
+            : `Invalid sleep duration: "${param}". Expected a valid duration string like "1s", "1m", "1h", etc.`;
+        throw new Error(message);
+    }
+    const endAt = +stepStartedAt + durationMs;
+    const now = Date.now();
+    if (now < endAt) {
+        const remainingSeconds = (endAt - now) / 1000;
+        const retryAfter = Math.min(remainingSeconds, MAX_SLEEP_DURATION_SECONDS);
+        throw new RetryableError(`Sleeping for ${ms(retryAfter * 1000, { long: true })}`, {
+            retryAfter,
+        });
+    }
+}
+sleep.maxRetries = Infinity;
+/**
+ * A hoisted `fetch()` function that is executed as a "step" function,
+ * for use within workflow functions.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
+ */
+export async function fetch(...args) {
+    'use step';
+    return globalThis.fetch(...args);
+}
+//# sourceMappingURL=stdlib.js.map

package/dist/stdlib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdlib.js","sourceRoot":"","sources":["../src/stdlib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAwB,MAAM,IAAI,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,yEAAyE;AACzE,sEAAsE;AACtE,yEAAyE;AACzE,MAAM,0BAA0B,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;AAqBpD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAyB;IACnD,UAAU,CAAC;IACX,MAAM,EAAE,aAAa,EAAE,GAAG,eAAe,EAAE,CAAC;IAC5C,MAAM,UAAU,GACd,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;QACX,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAE9C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,OAAO,GACX,KAAK,YAAY,IAAI;YACnB,CAAC,CAAC,wBAAwB,KAAK,4BAA4B;YAC3D,CAAC,CAAC,4BAA4B,KAAK,iEAAiE,CAAC;QACzG,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,aAAa,GAAG,UAAU,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAChB,MAAM,gBAAgB,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,CAAC;QAC1E,MAAM,IAAI,cAAc,CACtB,gBAAgB,EAAE,CAAC,UAAU,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,EACvD;YACE,UAAU;SACX,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AACD,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAG,IAAyC;IACtE,UAAU,CAAC;IACX,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/workflow.d.ts

@@ -0,0 +1,3 @@
+export * from '@workflow/core/_workflow';
+export * from './stdlib.js';
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}

package/dist/workflow.js

@@ -0,0 +1,3 @@
+export * from '@workflow/core/_workflow';
+export * from './stdlib.js';
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}

package/package.json

@@ -1,41 +1,69 @@
 {
   "name": "workflow",
-  "version": "2.0.6",
-  "description": "Workflow-centric workspace manager",
-  "bin": "cli.js",
+  "version": "4.0.1-beta.1",
+  "description": "Workflow DevKit - Build durable, resilient, and observable workflows",
+  "main": "dist/index.cjs",
+  "type": "module",
+  "bin": {
+    "workflow": "./bin/run.js",
+    "wf": "./bin/run.js"
+  },
   "files": [
     "dist",
-    "cli.js"
+    "bin"
   ],
-  "scripts": {
-    "example": "node cli.js Example.js"
+  "publishConfig": {
+    "access": "public"
   },
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/havardh/workflow.git"
-  },
-  "keywords": [
-    "wm",
-    "workflow",
-    "workflow-wm",
-    "cli",
-    "i3",
-    "osx",
-    "windows"
-  ],
-  "author": "Håvard Wormdal Høiby <havardwhoiby@gmail.com>",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/havardh/workflow/issues"
+    "url": "https://github.com/vercel/workflow.git",
+    "directory": "packages/workflow"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "workflow": "./dist/workflow.js",
+      "default": "./dist/index.js"
+    },
+    "./api": "./dist/api.js",
+    "./internal/errors": "./dist/internal/errors.js",
+    "./internal/serialization": "./dist/internal/serialization.js",
+    "./internal/builtins": "./dist/internal/builtins.js",
+    "./internal/private": "./dist/internal/private.js",
+    "./next": "./dist/next.js",
+    "./nitro": "./dist/nitro.js",
+    "./rollup-plugin": "./dist/rollup-plugin.js",
+    "./runtime": "./dist/runtime.js"
   },
-  "homepage": "https://github.com/havardh/workflow#readme",
   "dependencies": {
-    "create-workflow-home": "^2.0.6",
-    "cross-spawn": "^6.0.5",
-    "execa": "^0.11.0",
-    "prompt": "^1.0.0",
-    "shelljs": "^0.8.2",
-    "workflow-cmd": "^2.0.1"
-  },
-  "gitHead": "e12e588cb86f0036a247620d23c99964052e4920"
-}
+    "ms": "2.1.3",
+    "@workflow/cli": "4.0.1-beta.1",
+    "@workflow/core": "4.0.1-beta.1",
+    "@workflow/errors": "4.0.1-beta.1",
+    "@workflow/typescript-plugin": "4.0.1-beta.1",
+    "@workflow/next": "4.0.1-beta.1",
+    "@workflow/nitro": "4.0.1-beta.1"
+  },
+  "devDependencies": {
+    "@types/ms": "^2.1.0",
+    "@types/node": "24.6.2",
+    "@workflow/tsconfig": "4.0.1-beta.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "1"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc && chmod +x bin/run.js",
+    "clean": "tsc --build --clean && rm -r dist ||:",
+    "dev": "tsc --watch",
+    "test": "vitest run src",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/CHANGELOG.md

@@ -1,160 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-<a name="2.0.6"></a>
-## [2.0.6](https://github.com/havardh/workflow/compare/workflow@2.0.5...workflow@2.0.6) (2018-09-26)
-
-
-### Bug Fixes
-
-* **workflow:** add missing import of dev flag ([1d00f58](https://github.com/havardh/workflow/commit/1d00f58))
-
-
-
-
-
-<a name="2.0.5"></a>
-## [2.0.5](https://github.com/havardh/workflow/compare/workflow@2.0.4...workflow@2.0.5) (2018-09-26)
-
-
-### Bug Fixes
-
-* **workflow:** disable workflow home check in dev mode ([d991a15](https://github.com/havardh/workflow/commit/d991a15))
-
-
-
-
-
-<a name="2.0.4"></a>
-## [2.0.4](https://github.com/havardh/workflow/compare/workflow@2.0.3...workflow@2.0.4) (2018-09-26)
-
-
-### Bug Fixes
-
-* **workflow:** wait on createWorkflowHome before running npm install ([7de33cc](https://github.com/havardh/workflow/commit/7de33cc))
-
-
-
-
-
-<a name="2.0.3"></a>
-## [2.0.3](https://github.com/havardh/workflow/compare/workflow@2.0.2...workflow@2.0.3) (2018-09-25)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="2.0.2"></a>
-## [2.0.2](https://github.com/havardh/workflow/compare/workflow@2.0.1...workflow@2.0.2) (2018-09-25)
-
-
-### Bug Fixes
-
-* **workflow:** make create-workflow-home version fixed ([bfba80e](https://github.com/havardh/workflow/commit/bfba80e))
-
-
-
-
-
-<a name="2.0.1"></a>
-## [2.0.1](https://github.com/havardh/workflow/compare/workflow@2.0.0...workflow@2.0.1) (2018-09-25)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="2.0.0"></a>
-# [2.0.0](https://github.com/havardh/workflow/compare/workflow@1.1.6...workflow@2.0.0) (2018-09-18)
-
-
-### Features
-
-* use only named exports for all files. ([ca77860](https://github.com/havardh/workflow/commit/ca77860))
-
-
-### BREAKING CHANGES
-
-* changes the api exported by most modules.
-
-
-
-
-
-<a name="1.1.6"></a>
-## [1.1.6](https://github.com/havardh/workflow/compare/workflow@1.1.5...workflow@1.1.6) (2018-09-18)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="1.1.5"></a>
-## [1.1.5](https://github.com/havardh/workflow/compare/workflow@1.1.4...workflow@1.1.5) (2018-09-12)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="1.1.4"></a>
-## [1.1.4](https://github.com/havardh/workflow/compare/workflow@1.1.3...workflow@1.1.4) (2018-09-11)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="1.1.3"></a>
-## [1.1.3](https://github.com/havardh/workflow/compare/workflow@1.1.2...workflow@1.1.3) (2018-09-11)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="1.1.2"></a>
-## [1.1.2](https://github.com/havardh/workflow/compare/workflow@1.1.1...workflow@1.1.2) (2018-09-11)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="1.1.1"></a>
-## [1.1.1](https://github.com/havardh/workflow/compare/workflow@1.1.0...workflow@1.1.1) (2018-09-10)
-
-**Note:** Version bump only for package workflow
-
-
-
-
-
-<a name="1.1.0"></a>
-# 1.1.0 (2018-09-10)
-
-
-### Bug Fixes
-
-* make cli's executable ([f7ef385](https://github.com/havardh/workflow/commit/f7ef385))
-* prefer npx and fallback to yarn and npm in workflow ([2fe6d0a](https://github.com/havardh/workflow/commit/2fe6d0a))
-* remove dev depenencies from packages ([87eba92](https://github.com/havardh/workflow/commit/87eba92))
-* resolve style issues ([266600f](https://github.com/havardh/workflow/commit/266600f))
-* update depencies according to rollup missing deps ([5eaef7e](https://github.com/havardh/workflow/commit/5eaef7e))
-* update dependencies of packages ([e0358bd](https://github.com/havardh/workflow/commit/e0358bd))
-* update the workflow package.json ([a35d482](https://github.com/havardh/workflow/commit/a35d482))
-
-
-### Features
-
-* implement workflow package ([220805e](https://github.com/havardh/workflow/commit/220805e))

package/Readme.md

@@ -1,4 +0,0 @@
-# Workflow
-
-Workflow is an experiment in declarative windows management. It lets you declare and open desktop
-layouts. For more documentation checkout the [Repository on github](https://www.github.com/havardh/workflow).

package/cli.js

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-/* eslint-env node */
-/* eslint-disable global-require */
-
-try {
-  module.exports = require('./dist/cli');
-} catch (error) {
-  if (error.code === 'MODULE_NOT_FOUND') {
-    require('babel-register');
-    require('ts-node').register(require('../../tsconfig.json'));
-    module.exports = require('./src/cli');
-  } else {
-    throw error;
-  }
-}

package/dist/cli.js

@@ -1,210 +0,0 @@
-'use strict';
-
-function _interopDefault (ex) { return (ex && (typeof ex === 'object') && 'default' in ex) ? ex['default'] : ex; }
-
-var shell = _interopDefault(require('shelljs'));
-var child_process = require('child_process');
-var os = _interopDefault(require('os'));
-var path = require('path');
-var prompt = _interopDefault(require('prompt'));
-require('cross-spawn');
-var WorkflowCmd = require('workflow-cmd/cli');
-var util = require('util');
-var execa = _interopDefault(require('execa'));
-var createWorkflowHome = require('create-workflow-home');
-
-function args(args) {
-  const parsedArgs = {
-    named: {},
-    positional: []
-  };
-
-  const argsLength = args.length;
-  for (let i = 2; i < argsLength; i++) {
-    const arg = args[i];
-    if (arg[0] === '-') {
-      const name = getArgName(arg);
-      if (args[i + 1] === undefined) {
-        parsedArgs.named[name] = true;
-      } else {
-        parsedArgs.named[name] = args[i + 1];
-      }
-      i++;
-    } else {
-      parsedArgs.positional.push(arg);
-    }
-  }
-
-  return parsedArgs;
-}
-
-function getArgName(arg) {
-  let sliceIndex;
-  const isWordArg = arg[1] === '-';
-  if (isWordArg) {
-    if (arg.length === 3) throw new Error(`expected ${arg} to be a word arg`);
-    sliceIndex = 2;
-  } else {
-    sliceIndex = 1;
-  }
-  return arg.slice(sliceIndex, arg.length);
-}
-
-/* eslint-disable import/prefer-default-export */
-
-function which(cmd) {
-  return shell.exec(`which ${cmd}`, { silent: true, async: false });
-}
-
-/* eslint-env node */
-
-const platform = process.platform;
-
-function isRunningI3() {
-  try {
-    child_process.execSync("i3-msg 'exec echo 1'", { stdio: 'ignore' });
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-
-function isRunningWmctrl() {
-  return which('wmctrl').code === 0;
-}
-
-const wm = (() => {
-  switch (platform) {
-    case 'win32':
-    case 'darwin':
-      return 'default';
-    case 'linux':
-      {
-        if (isRunningI3()) {
-          return 'i3';
-        } else if (isRunningWmctrl()) {
-          return 'wmctrl';
-        }
-        return 'unknown';
-      }
-  }
-  return 'unknown';
-})();
-
-const dev = process.env.WORKFLOW_DEV_MODE === 'true';
-const homedir = process.env.WORKFLOW_HOME;
-const devhomedir = process.env.WORKFLOW_DEV_HOME;
-
-const { config } = args(process.argv).named;
-
-let configPath;
-let baseFolder;
-(() => {
-  if (dev) {
-    if (devhomedir) {
-      baseFolder = devhomedir;
-      configPath = path.join(devhomedir, 'config.js');
-    } else {
-      baseFolder = path.join(__dirname, '..', '..', 'workflow-template', 'config.js');
-      configPath = path.join(baseFolder, 'config.js');
-    }
-  } else {
-    if (config) {
-      baseFolder = path.dirname(config);
-      configPath = config;
-    } else if (homedir) {
-      baseFolder = homedir;
-      configPath = path.join(baseFolder, 'config.js');
-    } else {
-      configPath = path.join(os.homedir(), '.workflow', 'config.js');
-      baseFolder = `${os.homedir()}/.workflow`;
-    }
-  }
-})();
-
-/* eslint-env node */
-
-function isValidWorkflowHome(path$$1) {
-  try {
-    const { name } = require(path.resolve(path$$1, 'package.json'));
-    if (name === 'workflow-user-home') {
-      return true;
-    } else {
-      throw new Error(`Invalid workflow-home package name: '${name}'
-expected 'workflow-user-home'`);
-    }
-  } catch (error) {
-    if (error.code !== 'MODULE_NOT_FOUND') {
-      throw error;
-    }
-  }
-
-  return false;
-}
-
-/* eslint-env node */
-
-(async function cli([node, cmd, ...args]) {
-  if (!dev) {
-    if (!isValidWorkflowHome(baseFolder)) {
-      await initWorkflowHome(baseFolder);
-    }
-  }
-
-  WorkflowCmd.cli(node, cmd, args);
-})(process.argv).catch(err => console.error(err.toString()));
-
-async function initWorkflowHome(path$$1) {
-  console.log();
-  console.log('It looks like you are using workflow for the first time.');
-  console.log();
-  console.log('Workflow requires a workflow-home directory.');
-  console.log('The workflow-home directory defaults to ' + path.join(os.homedir(), '.workflow'));
-  console.log('The default location can be overriden by the environment variable WORKFLOW_HOME');
-  console.log();
-  if (homedir) {
-    console.log('You have overriden the location to be:', path.resolve(homedir));
-    console.log();
-  }
-  if (devhomedir) {
-    console.log('You have overriden the dev location to be:', path.resolve(devhomedir));
-    console.log();
-  }
-
-  if (await promptYesNo('Would you like to initialize a workflow-home directory at: ' + path.resolve(path$$1))) {
-    await createWorkflowHome.createWorkflowHome(path$$1);
-
-    console.log();
-    console.log('Running `npm install`');
-    await execa('npm', ['i'], { stdio: 'inherit', cwd: path$$1 });
-
-    console.log();
-    console.log('workflow was successfully installed. ');
-    console.log();
-    console.log('Try the example with `workflow Example.js`');
-  } else {
-    console.log();
-    console.log('Process aborted and no workflow-home was created.');
-    console.log('Workflow will not work until you set up a workflow-home folder.');
-    process.exit(1);
-  }
-}
-
-async function promptYesNo(question) {
-  const schema = {
-    properties: {
-      answer: {
-        type: 'string',
-        pattern: '^[ynYN]$',
-        description: question + ' (y/n)',
-        default: 'y'
-      }
-    }
-  };
-
-  prompt.start();
-
-  const { answer } = await util.promisify(prompt.get)(schema);
-
-  return answer === 'y' || answer === 'Y';
-}