@hatchet-dev/typescript-sdk 1.13.1 → 1.15.0

package/{examples → src/legacy/examples}/bulk-fanout-worker.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 const parentWorkflow = {
     id: 'bulk-parent-workflow',

package/{examples → src/legacy/examples}/bulk-trigger.js

@@ -19,7 +19,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 function main() {
     return __awaiter(this, void 0, void 0, function* () {

package/{examples → src/legacy/examples}/concurrency/cancel-in-progress/concurrency-event.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../../sdk"));
+const sdk_1 = __importDefault(require("../../../../sdk"));
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/concurrency/cancel-in-progress/concurrency-worker.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../../sdk"));
+const sdk_1 = __importDefault(require("../../../../sdk"));
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/concurrency/group-round-robin/concurrency-event.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../../sdk"));
+const sdk_1 = __importDefault(require("../../../../sdk"));
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/concurrency/group-round-robin/concurrency-worker-expression.js

@@ -12,8 +12,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../../sdk"));
-const workflow_1 = require("../../../workflow");
+const sdk_1 = __importDefault(require("../../../../sdk"));
+const workflow_1 = require("../../../../workflow");
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/concurrency/group-round-robin/concurrency-worker-key-fn.js

@@ -12,8 +12,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../../sdk"));
-const workflow_1 = require("../../../workflow");
+const sdk_1 = __importDefault(require("../../../../sdk"));
+const workflow_1 = require("../../../../workflow");
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/crons/cron-worker.d.ts

@@ -1,2 +1,2 @@
-import { Workflow } from '../../workflow';
+import { Workflow } from '../../../workflow';
 export declare const simpleCronWorkflow: Workflow;

package/{examples → src/legacy/examples}/crons/cron-worker.js

@@ -13,7 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simpleCronWorkflow = void 0;
-const sdk_1 = __importDefault(require("../../sdk"));
+const sdk_1 = __importDefault(require("../../../sdk"));
 const hatchet = sdk_1.default.init();
 // > Workflow Definition Cron Trigger
 // Adding a cron trigger to a workflow is as simple as adding a `cron expression` to the `on` prop of the workflow definition

package/{examples → src/legacy/examples}/crons/programatic-crons.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../sdk"));
+const sdk_1 = __importDefault(require("../../../sdk"));
 const cron_worker_1 = require("./cron-worker");
 const hatchet = sdk_1.default.init();
 // This example assumes you have a worker already running

package/{examples → src/legacy/examples}/dag-worker.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init({
     log_level: 'OFF',
 });

package/{examples → src/legacy/examples}/example-event-with-results.js

@@ -19,7 +19,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, e_1, _b, _c;
@@ -27,7 +27,7 @@ function main() {
         const ref = yield hatchet.admin.runWorkflow('simple-workflow', {
             test: 'test',
         });
-        const listener = yield hatchet.v0.listener.stream(yield ref.getWorkflowRunId());
+        const listener = yield hatchet.listener.stream(yield ref.getWorkflowRunId());
         console.log('listening for events');
         try {
             for (var _d = true, listener_1 = __asyncValues(listener), listener_1_1; listener_1_1 = yield listener_1.next(), _a = listener_1_1.done, !_a; _d = true) {

package/{examples → src/legacy/examples}/example-event.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 // Push a single event (example)
 hatchet.events.push('user:create', {

package/{examples → src/legacy/examples}/fanout-worker.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 const parentWorkflow = {
     id: 'parent-workflow',

package/{examples → src/legacy/examples}/logger.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init({
     log_level: 'OFF',
 });

package/{examples → src/legacy/examples}/manual-trigger.js

@@ -19,7 +19,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 function main() {
     return __awaiter(this, void 0, void 0, function* () {

package/{examples → src/legacy/examples}/multi-workflow.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 function main() {
     return __awaiter(this, void 0, void 0, function* () {

package/{examples → src/legacy/examples}/namespaced-worker.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init({
     namespace: 'example-namespace',
 });

package/{examples → src/legacy/examples}/on-failure.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 // > OnFailure Step
 // This workflow will fail because the step will throw an error

package/{examples → src/legacy/examples}/rate-limit/events.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../sdk"));
+const sdk_1 = __importDefault(require("../../../sdk"));
 const hatchet = sdk_1.default.init();
 hatchet.events.push('rate-limit:create', {
     test: '1',

package/{examples → src/legacy/examples}/rate-limit/worker.js

@@ -12,8 +12,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const workflows_1 = require("../../protoc/workflows");
-const sdk_1 = __importDefault(require("../../sdk"));
+const workflows_1 = require("../../../protoc/workflows");
+const sdk_1 = __importDefault(require("../../../sdk"));
 const hatchet = sdk_1.default.init();
 const workflow = {
     id: 'rate-limit-workflow',

package/{examples → src/legacy/examples}/retries-with-backoff.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 let numRetries = 0;
 // > Backoff

package/{examples → src/legacy/examples}/retries-worker.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/scheduled-runs/programatic-schedules.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../../sdk"));
+const sdk_1 = __importDefault(require("../../../sdk"));
 const simple_worker_1 = require("../simple-worker");
 const hatchet = sdk_1.default.init();
 // This example assumes you have a worker already running

package/{examples → src/legacy/examples}/simple-worker.d.ts

@@ -1,2 +1,2 @@
-import { Workflow } from '../workflow';
+import { Workflow } from '../../workflow';
 export declare const simpleWorkflow: Workflow;

package/{examples → src/legacy/examples}/simple-worker.js

@@ -13,7 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simpleWorkflow = void 0;
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 const sleep = (ms) => new Promise((resolve) => {
     setTimeout(resolve, ms);

package/{examples → src/legacy/examples}/sticky-trigger.js

@@ -19,7 +19,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 function main() {
     return __awaiter(this, void 0, void 0, function* () {

package/{examples → src/legacy/examples}/sticky-worker-with-check.js

@@ -12,8 +12,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
-const workflow_1 = require("../workflow");
+const sdk_1 = __importDefault(require("../../sdk"));
+const workflow_1 = require("../../workflow");
 const hatchet = sdk_1.default.init();
 const workflow = {
     id: 'sticky-workflow',

package/{examples → src/legacy/examples}/sticky-worker.js

@@ -12,8 +12,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
-const workflow_1 = require("../workflow");
+const sdk_1 = __importDefault(require("../../sdk"));
+const workflow_1 = require("../../workflow");
 const hatchet = sdk_1.default.init();
 // > StickyWorker
 const workflow = {

package/{examples → src/legacy/examples}/stream-by-additional-meta.js

@@ -19,7 +19,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const sdk_1 = __importDefault(require("../sdk"));
+const sdk_1 = __importDefault(require("../../sdk"));
 const hatchet = sdk_1.default.init();
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -34,7 +34,7 @@ function main() {
         // and can have an arbitrary property name.
         yield hatchet.admin.runWorkflow('parent-workflow', {}, { additionalMetadata: { [streamKey]: streamVal } });
         // Stream all events for the additional meta key value
-        const stream = yield hatchet.v0.listener.streamByAdditionalMeta(streamKey, streamVal);
+        const stream = yield hatchet.listener.streamByAdditionalMeta(streamKey, streamVal);
         try {
             for (var _d = true, stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield stream_1.next(), _a = stream_1_1.done, !_a; _d = true) {
                 _c = stream_1_1.value;

package/{clients/hatchet-client/hatchet-client.d.ts → src/legacy/legacy-client.d.ts}

@@ -1,16 +1,14 @@
-import { EventClient } from '../event/event-client';
-import { DispatcherClient } from '../dispatcher/dispatcher-client';
-import { AdminClient } from '../admin/admin-client';
+import { EventClient } from '../../clients/event/event-client';
+import { DispatcherClient } from '../../clients/dispatcher/dispatcher-client';
+import { AdminClient } from '../../clients/admin/admin-client';
 import { ChannelCredentials } from 'nice-grpc';
-import { Workflow as V0Workflow } from '../../workflow';
-import { V0Worker, WorkerOpts } from '../worker';
 import { AxiosRequestConfig } from 'axios';
 import { Logger } from '../../util/logger';
 import { RunsClient } from '../../v1';
-import { ClientConfig } from './client-config';
-import { RunListenerClient } from '../listeners/run-listener/child-listener-client';
-import { Api } from '../rest/generated/Api';
-import { DurableListenerClient } from '../listeners/durable-listener/durable-listener-client';
+import { ClientConfig } from '../../clients/hatchet-client/client-config';
+import { RunListenerClient } from '../../clients/listeners/run-listener/child-listener-client';
+import { Api } from '../../clients/rest/generated/Api';
+import { DurableListenerClient } from '../../clients/listeners/durable-listener/durable-listener-client';
 export interface HatchetClientOptions {
     config_path?: string;
     credentials?: ChannelCredentials;
@@ -27,9 +25,6 @@ export declare class LegacyHatchetClient {
     tenantId: string;
     durableListener: DurableListenerClient;
     logger: Logger;
-    constructor(config?: Partial<ClientConfig>, options?: HatchetClientOptions, axiosOpts?: AxiosRequestConfig, runs?: RunsClient, listener?: RunListenerClient);
+    constructor(config?: Partial<ClientConfig>, options?: HatchetClientOptions, axiosOpts?: AxiosRequestConfig, runs?: RunsClient, listener?: RunListenerClient, event?: EventClient, dispatcher?: DispatcherClient, logger?: Logger, durableListener?: DurableListenerClient);
     static init(config?: Partial<ClientConfig>, options?: HatchetClientOptions, axiosConfig?: AxiosRequestConfig): LegacyHatchetClient;
-    run(workflow: string | V0Workflow): Promise<V0Worker>;
-    worker(workflow: string | V0Workflow, opts?: Omit<WorkerOpts, 'name'> | number): Promise<V0Worker>;
-    webhooks(workflows: Array<V0Workflow>): import("../worker/handler").WebhookHandler;
 }

package/src/legacy/legacy-client.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LegacyHatchetClient = void 0;
+const zod_1 = require("zod");
+const config_loader_1 = require("../../util/config-loader");
+const event_client_1 = require("../../clients/event/event-client");
+const dispatcher_client_1 = require("../../clients/dispatcher/dispatcher-client");
+const admin_client_1 = require("../../clients/admin/admin-client");
+const nice_grpc_1 = require("nice-grpc");
+const hatchet_logger_1 = require("../../clients/hatchet-client/hatchet-logger");
+const grpc_helpers_1 = require("../../util/grpc-helpers");
+const client_config_1 = require("../../clients/hatchet-client/client-config");
+const child_listener_client_1 = require("../../clients/listeners/run-listener/child-listener-client");
+const rest_1 = __importDefault(require("../../clients/rest"));
+const durable_listener_client_1 = require("../../clients/listeners/durable-listener/durable-listener-client");
+class LegacyHatchetClient {
+    constructor(config, options, axiosOpts, runs, listener, event, dispatcher, logger, durableListener) {
+        // Initializes a new Client instance.
+        // Loads config in the following order: config param > yaml file > env vars
+        var _a;
+        this.runs = runs;
+        const loaded = config_loader_1.ConfigLoader.loadClientConfig(config, {
+            path: options === null || options === void 0 ? void 0 : options.config_path,
+        });
+        try {
+            const valid = client_config_1.ClientConfigSchema.parse(loaded);
+            let logConstructor = config === null || config === void 0 ? void 0 : config.logger;
+            if (logConstructor == null) {
+                logConstructor = hatchet_logger_1.DEFAULT_LOGGER;
+            }
+            this.config = Object.assign(Object.assign({}, valid), { logger: logConstructor });
+        }
+        catch (e) {
+            if (e instanceof zod_1.z.ZodError) {
+                throw new Error(`Invalid client config: ${e.message}`);
+            }
+            throw e;
+        }
+        this.credentials =
+            (_a = options === null || options === void 0 ? void 0 : options.credentials) !== null && _a !== void 0 ? _a : config_loader_1.ConfigLoader.createCredentials(this.config.tls_config);
+        const clientFactory = (0, nice_grpc_1.createClientFactory)().use((0, grpc_helpers_1.addTokenMiddleware)(this.config.token));
+        this.tenantId = this.config.tenant_id;
+        this.api = (0, rest_1.default)(this.config.api_url, this.config.token, axiosOpts);
+        this.event =
+            event ||
+                new event_client_1.EventClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, this.credentials), clientFactory, this.api);
+        this.dispatcher =
+            dispatcher ||
+                new dispatcher_client_1.DispatcherClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, this.credentials), clientFactory);
+        this.listener =
+            listener ||
+                new child_listener_client_1.RunListenerClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, this.credentials), clientFactory, this.api);
+        this.admin = new admin_client_1.AdminClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, this.credentials), clientFactory, this.api, this.tenantId, this.listener, this.runs);
+        this.durableListener =
+            durableListener ||
+                new durable_listener_client_1.DurableListenerClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, this.credentials), clientFactory, this.api);
+        this.logger = logger || this.config.logger('HatchetClient', this.config.log_level);
+        this.logger.debug(`Initialized HatchetClient`);
+    }
+    static init(config, options, axiosConfig) {
+        return new LegacyHatchetClient(config, options, axiosConfig);
+    }
+}
+exports.LegacyHatchetClient = LegacyHatchetClient;

package/src/legacy/legacy-transformer.d.ts

@@ -0,0 +1,38 @@
+import type { Workflow } from '../../legacy/workflow';
+import { BaseWorkflowDeclaration, WorkflowDeclaration } from '../v1/declaration';
+export type { Workflow as LegacyWorkflow } from '../../legacy/workflow';
+/**
+ * Type guard: returns true if the workflow is a legacy v0 Workflow (not a BaseWorkflowDeclaration).
+ */
+export declare function isLegacyWorkflow(workflow: unknown): workflow is Workflow;
+/**
+ * Emits a deprecation warning for legacy workflow usage.
+ */
+export declare function warnLegacyWorkflow(): void;
+/**
+ * Transforms a legacy v0 Workflow into a v1 WorkflowDeclaration.
+ *
+ * The transformed declaration can be registered with a worker and executed
+ * by the v1 runtime. Legacy step `run` functions are wrapped to receive
+ * a V0Context for backwards compatibility.
+ */
+export declare function transformLegacyWorkflow(workflow: Workflow): WorkflowDeclaration<any, any>;
+/**
+ * Normalizes a workflow: if it is a legacy Workflow, emits a deprecation warning
+ * and transforms it into a BaseWorkflowDeclaration. If already a v1 declaration,
+ * returns it as-is.
+ */
+export declare function normalizeWorkflow(workflow: BaseWorkflowDeclaration<any, any> | Workflow): BaseWorkflowDeclaration<any, any>;
+/**
+ * Normalizes an array of workflows, transforming any legacy workflows and
+ * emitting deprecation warnings.
+ */
+export declare function normalizeWorkflows(workflows: Array<BaseWorkflowDeclaration<any, any> | Workflow>): Array<BaseWorkflowDeclaration<any, any>>;
+/**
+ * Extracts the workflow name from a workflow-like value.
+ * Works for strings, BaseWorkflowDeclaration, WorkflowDefinition, and legacy Workflow.
+ * Emits a deprecation warning if a legacy workflow is detected.
+ */
+export declare function getWorkflowName(workflow: string | BaseWorkflowDeclaration<any, any> | Workflow | {
+    name: string;
+}): string;