@hatchet-dev/typescript-sdk 1.11.0 → 1.12.0

package/protoc/events/events.js

@@ -225,7 +225,7 @@ exports.Events = {
 };
 function createBasePutLogRequest() {
     return {
-        stepRunId: '',
+        taskRunExternalId: '',
         createdAt: undefined,
         message: '',
         level: undefined,
@@ -235,8 +235,8 @@ function createBasePutLogRequest() {
 }
 exports.PutLogRequest = {
     encode(message, writer = new wire_1.BinaryWriter()) {
-        if (message.stepRunId !== '') {
-            writer.uint32(10).string(message.stepRunId);
+        if (message.taskRunExternalId !== '') {
+            writer.uint32(10).string(message.taskRunExternalId);
         }
         if (message.createdAt !== undefined) {
             timestamp_1.Timestamp.encode(toTimestamp(message.createdAt), writer.uint32(18).fork()).join();
@@ -266,7 +266,7 @@ exports.PutLogRequest = {
                     if (tag !== 10) {
                         break;
                     }
-                    message.stepRunId = reader.string();
+                    message.taskRunExternalId = reader.string();
                     continue;
                 }
                 case 2: {
@@ -314,7 +314,9 @@ exports.PutLogRequest = {
     },
     fromJSON(object) {
         return {
-            stepRunId: isSet(object.stepRunId) ? globalThis.String(object.stepRunId) : '',
+            taskRunExternalId: isSet(object.taskRunExternalId)
+                ? globalThis.String(object.taskRunExternalId)
+                : '',
             createdAt: isSet(object.createdAt) ? fromJsonTimestamp(object.createdAt) : undefined,
             message: isSet(object.message) ? globalThis.String(object.message) : '',
             level: isSet(object.level) ? globalThis.String(object.level) : undefined,
@@ -326,8 +328,8 @@ exports.PutLogRequest = {
     },
     toJSON(message) {
         const obj = {};
-        if (message.stepRunId !== '') {
-            obj.stepRunId = message.stepRunId;
+        if (message.taskRunExternalId !== '') {
+            obj.taskRunExternalId = message.taskRunExternalId;
         }
         if (message.createdAt !== undefined) {
             obj.createdAt = message.createdAt.toISOString();
@@ -352,7 +354,7 @@ exports.PutLogRequest = {
     fromPartial(object) {
         var _a, _b, _c, _d, _e, _f;
         const message = createBasePutLogRequest();
-        message.stepRunId = (_a = object.stepRunId) !== null && _a !== void 0 ? _a : '';
+        message.taskRunExternalId = (_a = object.taskRunExternalId) !== null && _a !== void 0 ? _a : '';
         message.createdAt = (_b = object.createdAt) !== null && _b !== void 0 ? _b : undefined;
         message.message = (_c = object.message) !== null && _c !== void 0 ? _c : '';
         message.level = (_d = object.level) !== null && _d !== void 0 ? _d : undefined;
@@ -400,7 +402,7 @@ exports.PutLogResponse = {
 };
 function createBasePutStreamEventRequest() {
     return {
-        stepRunId: '',
+        taskRunExternalId: '',
         createdAt: undefined,
         message: new Uint8Array(0),
         metadata: '',
@@ -409,8 +411,8 @@ function createBasePutStreamEventRequest() {
 }
 exports.PutStreamEventRequest = {
     encode(message, writer = new wire_1.BinaryWriter()) {
-        if (message.stepRunId !== '') {
-            writer.uint32(10).string(message.stepRunId);
+        if (message.taskRunExternalId !== '') {
+            writer.uint32(10).string(message.taskRunExternalId);
         }
         if (message.createdAt !== undefined) {
             timestamp_1.Timestamp.encode(toTimestamp(message.createdAt), writer.uint32(18).fork()).join();
@@ -437,7 +439,7 @@ exports.PutStreamEventRequest = {
                     if (tag !== 10) {
                         break;
                     }
-                    message.stepRunId = reader.string();
+                    message.taskRunExternalId = reader.string();
                     continue;
                 }
                 case 2: {
@@ -478,7 +480,9 @@ exports.PutStreamEventRequest = {
     },
     fromJSON(object) {
         return {
-            stepRunId: isSet(object.stepRunId) ? globalThis.String(object.stepRunId) : '',
+            taskRunExternalId: isSet(object.taskRunExternalId)
+                ? globalThis.String(object.taskRunExternalId)
+                : '',
             createdAt: isSet(object.createdAt) ? fromJsonTimestamp(object.createdAt) : undefined,
             message: isSet(object.message) ? bytesFromBase64(object.message) : new Uint8Array(0),
             metadata: isSet(object.metadata) ? globalThis.String(object.metadata) : '',
@@ -487,8 +491,8 @@ exports.PutStreamEventRequest = {
     },
     toJSON(message) {
         const obj = {};
-        if (message.stepRunId !== '') {
-            obj.stepRunId = message.stepRunId;
+        if (message.taskRunExternalId !== '') {
+            obj.taskRunExternalId = message.taskRunExternalId;
         }
         if (message.createdAt !== undefined) {
             obj.createdAt = message.createdAt.toISOString();
@@ -510,7 +514,7 @@ exports.PutStreamEventRequest = {
     fromPartial(object) {
         var _a, _b, _c, _d, _e;
         const message = createBasePutStreamEventRequest();
-        message.stepRunId = (_a = object.stepRunId) !== null && _a !== void 0 ? _a : '';
+        message.taskRunExternalId = (_a = object.taskRunExternalId) !== null && _a !== void 0 ? _a : '';
         message.createdAt = (_b = object.createdAt) !== null && _b !== void 0 ? _b : undefined;
         message.message = (_c = object.message) !== null && _c !== void 0 ? _c : new Uint8Array(0);
         message.metadata = (_d = object.metadata) !== null && _d !== void 0 ? _d : '';

package/protoc/v1/workflows.d.ts

@@ -106,7 +106,7 @@ export interface CreateWorkflowVersionRequest {
     cronInput?: string | undefined;
     /** (optional) the job to run on failure */
     onFailureTask?: CreateTaskOpts | undefined;
-    /** (optional) the sticky strategy for assigning steps to workers */
+    /** (optional) the sticky strategy for assigning tasks to workers */
     sticky?: StickyStrategy | undefined;
     /** (optional) the default priority for the workflow */
     defaultPriority?: number | undefined;
@@ -167,17 +167,17 @@ export interface CreateTaskOpts {
     inputs: string;
     /** (optional) the task parents. if none are passed in, this is a root task */
     parents: string[];
-    /** (optional) the number of retries for the step, default 0 */
+    /** (optional) the number of retries for the task, default 0 */
     retries: number;
-    /** (optional) the rate limits for the step */
+    /** (optional) the rate limits for the task */
     rateLimits: CreateTaskRateLimit[];
-    /** (optional) the desired worker affinity state for the step */
+    /** (optional) the desired worker affinity state for the task */
     workerLabels: {
         [key: string]: DesiredWorkerLabels;
     };
-    /** (optional) the retry backoff factor for the step */
+    /** (optional) the retry backoff factor for the task */
     backoffFactor?: number | undefined;
-    /** (optional) the maximum backoff time for the step */
+    /** (optional) the maximum backoff time for the task */
     backoffMaxSeconds?: number | undefined;
     /** (optional) the task concurrency options */
     concurrency: Concurrency[];
@@ -193,7 +193,7 @@ export interface CreateTaskOpts_WorkerLabelsEntry {
 export interface CreateTaskRateLimit {
     /** (required) the key for the rate limit */
     key: string;
-    /** (optional) the number of units this step consumes */
+    /** (optional) the number of units this task consumes */
     units?: number | undefined;
     /** (optional) a CEL expression for determining the rate limit key */
     keyExpr?: string | undefined;

package/protoc/workflows/workflows.d.ts

@@ -78,7 +78,7 @@ export interface CreateWorkflowVersionOpts {
     cronInput?: string | undefined;
     /** (optional) the job to run on failure */
     onFailureJob?: CreateWorkflowJobOpts | undefined;
-    /** (optional) the sticky strategy for assigning steps to workers */
+    /** (optional) the sticky strategy for assigning tasks to workers */
     sticky?: StickyStrategy | undefined;
     /** (optional) the kind of workflow */
     kind?: WorkflowKind | undefined;
@@ -101,7 +101,7 @@ export interface CreateWorkflowJobOpts {
     name: string;
     /** (optional) the job description */
     description: string;
-    /** (required) the job steps */
+    /** (required) the job tasks */
     steps: CreateWorkflowStepOpts[];
 }
 export interface DesiredWorkerLabels {
@@ -126,31 +126,31 @@ export interface DesiredWorkerLabels {
      */
     weight?: number | undefined;
 }
-/** CreateWorkflowStepOpts represents options to create a workflow step. */
+/** CreateWorkflowStepOpts represents options to create a workflow task. */
 export interface CreateWorkflowStepOpts {
-    /** (required) the step name */
+    /** (required) the task name */
     readableId: string;
-    /** (required) the step action id */
+    /** (required) the task action id */
     action: string;
-    /** (optional) the step timeout */
+    /** (optional) the task timeout */
     timeout: string;
-    /** (optional) the step inputs, assuming string representation of JSON */
+    /** (optional) the task inputs, assuming string representation of JSON */
     inputs: string;
-    /** (optional) the step parents. if none are passed in, this is a root step */
+    /** (optional) the task parents. if none are passed in, this is a root task */
     parents: string[];
-    /** (optional) the custom step user data, assuming string representation of JSON */
+    /** (optional) the custom task user data, assuming string representation of JSON */
     userData: string;
-    /** (optional) the number of retries for the step, default 0 */
+    /** (optional) the number of retries for the task, default 0 */
     retries: number;
-    /** (optional) the rate limits for the step */
+    /** (optional) the rate limits for the task */
     rateLimits: CreateStepRateLimit[];
-    /** (optional) the desired worker affinity state for the step */
+    /** (optional) the desired worker affinity state for the task */
     workerLabels: {
         [key: string]: DesiredWorkerLabels;
     };
-    /** (optional) the retry backoff factor for the step */
+    /** (optional) the retry backoff factor for the task */
     backoffFactor?: number | undefined;
-    /** (optional) the maximum backoff time for the step */
+    /** (optional) the maximum backoff time for the task */
     backoffMaxSeconds?: number | undefined;
 }
 export interface CreateWorkflowStepOpts_WorkerLabelsEntry {
@@ -160,7 +160,7 @@ export interface CreateWorkflowStepOpts_WorkerLabelsEntry {
 export interface CreateStepRateLimit {
     /** (required) the key for the rate limit */
     key: string;
-    /** (optional) the number of units this step consumes */
+    /** (optional) the number of units this task consumes */
     units?: number | undefined;
     /** (optional) a CEL expression for determining the rate limit key */
     keyExpr?: string | undefined;
@@ -181,8 +181,8 @@ export interface ScheduleWorkflowRequest {
     input: string;
     /** (optional) the parent workflow run id */
     parentId?: string | undefined;
-    /** (optional) the parent step run id */
-    parentStepRunId?: string | undefined;
+    /** (optional) the parent task external run id */
+    parentTaskRunExternalId?: string | undefined;
     /**
      * (optional) the index of the child workflow. if this is set, matches on the index or the
      * child key will be a no-op, even if the schedule has changed.
@@ -235,17 +235,17 @@ export interface TriggerWorkflowRequest {
     input: string;
     /** (optional) the parent workflow run id */
     parentId?: string | undefined;
-    /** (optional) the parent step run id */
-    parentStepRunId?: string | undefined;
+    /** (optional) the parent task external run id */
+    parentTaskRunExternalId?: string | undefined;
     /**
      * (optional) the index of the child workflow. if this is set, matches on the index or the
-     * child key will return an existing workflow run if the parent id, parent step run id, and
+     * child key will return an existing workflow run if the parent id, parent task run id, and
      * child index/key match an existing workflow run.
      */
     childIndex?: number | undefined;
     /**
      * (optional) the key for the child. if this is set, matches on the index or the
-     * child key will return an existing workflow run if the parent id, parent step run id, and
+     * child key will return an existing workflow run if the parent id, parent task run id, and
      * child index/key match an existing workflow run.
      */
     childKey?: string | undefined;
@@ -256,7 +256,7 @@ export interface TriggerWorkflowRequest {
      * requires the workflow definition to have a sticky strategy
      */
     desiredWorkerId?: string | undefined;
-    /** (optional) override for the priority of the workflow steps, will set all steps to this priority */
+    /** (optional) override for the priority of the workflow tasks, will set all tasks to this priority */
     priority?: number | undefined;
 }
 export interface TriggerWorkflowResponse {

package/protoc/workflows/workflows.js

@@ -1405,7 +1405,7 @@ function createBaseScheduleWorkflowRequest() {
         schedules: [],
         input: '',
         parentId: undefined,
-        parentStepRunId: undefined,
+        parentTaskRunExternalId: undefined,
         childIndex: undefined,
         childKey: undefined,
         additionalMetadata: undefined,
@@ -1426,8 +1426,8 @@ exports.ScheduleWorkflowRequest = {
         if (message.parentId !== undefined) {
             writer.uint32(34).string(message.parentId);
         }
-        if (message.parentStepRunId !== undefined) {
-            writer.uint32(42).string(message.parentStepRunId);
+        if (message.parentTaskRunExternalId !== undefined) {
+            writer.uint32(42).string(message.parentTaskRunExternalId);
         }
         if (message.childIndex !== undefined) {
             writer.uint32(48).int32(message.childIndex);
@@ -1482,7 +1482,7 @@ exports.ScheduleWorkflowRequest = {
                     if (tag !== 42) {
                         break;
                     }
-                    message.parentStepRunId = reader.string();
+                    message.parentTaskRunExternalId = reader.string();
                     continue;
                 }
                 case 6: {
@@ -1529,8 +1529,8 @@ exports.ScheduleWorkflowRequest = {
                 : [],
             input: isSet(object.input) ? globalThis.String(object.input) : '',
             parentId: isSet(object.parentId) ? globalThis.String(object.parentId) : undefined,
-            parentStepRunId: isSet(object.parentStepRunId)
-                ? globalThis.String(object.parentStepRunId)
+            parentTaskRunExternalId: isSet(object.parentTaskRunExternalId)
+                ? globalThis.String(object.parentTaskRunExternalId)
                 : undefined,
             childIndex: isSet(object.childIndex) ? globalThis.Number(object.childIndex) : undefined,
             childKey: isSet(object.childKey) ? globalThis.String(object.childKey) : undefined,
@@ -1555,8 +1555,8 @@ exports.ScheduleWorkflowRequest = {
         if (message.parentId !== undefined) {
             obj.parentId = message.parentId;
         }
-        if (message.parentStepRunId !== undefined) {
-            obj.parentStepRunId = message.parentStepRunId;
+        if (message.parentTaskRunExternalId !== undefined) {
+            obj.parentTaskRunExternalId = message.parentTaskRunExternalId;
         }
         if (message.childIndex !== undefined) {
             obj.childIndex = Math.round(message.childIndex);
@@ -1582,7 +1582,7 @@ exports.ScheduleWorkflowRequest = {
         message.schedules = ((_b = object.schedules) === null || _b === void 0 ? void 0 : _b.map((e) => e)) || [];
         message.input = (_c = object.input) !== null && _c !== void 0 ? _c : '';
         message.parentId = (_d = object.parentId) !== null && _d !== void 0 ? _d : undefined;
-        message.parentStepRunId = (_e = object.parentStepRunId) !== null && _e !== void 0 ? _e : undefined;
+        message.parentTaskRunExternalId = (_e = object.parentTaskRunExternalId) !== null && _e !== void 0 ? _e : undefined;
         message.childIndex = (_f = object.childIndex) !== null && _f !== void 0 ? _f : undefined;
         message.childKey = (_g = object.childKey) !== null && _g !== void 0 ? _g : undefined;
         message.additionalMetadata = (_h = object.additionalMetadata) !== null && _h !== void 0 ? _h : undefined;
@@ -2072,7 +2072,7 @@ function createBaseTriggerWorkflowRequest() {
         name: '',
         input: '',
         parentId: undefined,
-        parentStepRunId: undefined,
+        parentTaskRunExternalId: undefined,
         childIndex: undefined,
         childKey: undefined,
         additionalMetadata: undefined,
@@ -2091,8 +2091,8 @@ exports.TriggerWorkflowRequest = {
         if (message.parentId !== undefined) {
             writer.uint32(26).string(message.parentId);
         }
-        if (message.parentStepRunId !== undefined) {
-            writer.uint32(34).string(message.parentStepRunId);
+        if (message.parentTaskRunExternalId !== undefined) {
+            writer.uint32(34).string(message.parentTaskRunExternalId);
         }
         if (message.childIndex !== undefined) {
             writer.uint32(40).int32(message.childIndex);
@@ -2143,7 +2143,7 @@ exports.TriggerWorkflowRequest = {
                     if (tag !== 34) {
                         break;
                     }
-                    message.parentStepRunId = reader.string();
+                    message.parentTaskRunExternalId = reader.string();
                     continue;
                 }
                 case 5: {
@@ -2194,8 +2194,8 @@ exports.TriggerWorkflowRequest = {
             name: isSet(object.name) ? globalThis.String(object.name) : '',
             input: isSet(object.input) ? globalThis.String(object.input) : '',
             parentId: isSet(object.parentId) ? globalThis.String(object.parentId) : undefined,
-            parentStepRunId: isSet(object.parentStepRunId)
-                ? globalThis.String(object.parentStepRunId)
+            parentTaskRunExternalId: isSet(object.parentTaskRunExternalId)
+                ? globalThis.String(object.parentTaskRunExternalId)
                 : undefined,
             childIndex: isSet(object.childIndex) ? globalThis.Number(object.childIndex) : undefined,
             childKey: isSet(object.childKey) ? globalThis.String(object.childKey) : undefined,
@@ -2219,8 +2219,8 @@ exports.TriggerWorkflowRequest = {
         if (message.parentId !== undefined) {
             obj.parentId = message.parentId;
         }
-        if (message.parentStepRunId !== undefined) {
-            obj.parentStepRunId = message.parentStepRunId;
+        if (message.parentTaskRunExternalId !== undefined) {
+            obj.parentTaskRunExternalId = message.parentTaskRunExternalId;
         }
         if (message.childIndex !== undefined) {
             obj.childIndex = Math.round(message.childIndex);
@@ -2248,7 +2248,7 @@ exports.TriggerWorkflowRequest = {
         message.name = (_a = object.name) !== null && _a !== void 0 ? _a : '';
         message.input = (_b = object.input) !== null && _b !== void 0 ? _b : '';
         message.parentId = (_c = object.parentId) !== null && _c !== void 0 ? _c : undefined;
-        message.parentStepRunId = (_d = object.parentStepRunId) !== null && _d !== void 0 ? _d : undefined;
+        message.parentTaskRunExternalId = (_d = object.parentTaskRunExternalId) !== null && _d !== void 0 ? _d : undefined;
         message.childIndex = (_e = object.childIndex) !== null && _e !== void 0 ? _e : undefined;
         message.childKey = (_f = object.childKey) !== null && _f !== void 0 ? _f : undefined;
         message.additionalMetadata = (_g = object.additionalMetadata) !== null && _g !== void 0 ? _g : undefined;

package/step.d.ts

@@ -282,7 +282,7 @@ export declare class V0Context<T, K = {}> {
      * Gets the ID of the current task run.
      * @returns The task run ID.
      */
-    taskRunId(): string;
+    taskRunExternalId(): string;
     /**
      * Gets the number of times the current task has been retried.
      * @returns The retry count.

package/step.js

@@ -267,7 +267,7 @@ class V0Context {
      * @returns The name of the task.
      */
     taskName() {
-        return this.action.stepName;
+        return this.action.taskName;
     }
     /**
      * Gets the ID of the current workflow run.
@@ -280,8 +280,8 @@ class V0Context {
      * Gets the ID of the current task run.
      * @returns The task run ID.
      */
-    taskRunId() {
-        return this.action.stepRunId;
+    taskRunExternalId() {
+        return this.action.taskRunExternalId;
     }
     /**
      * Gets the number of times the current task has been retried.
@@ -296,13 +296,13 @@ class V0Context {
      * @param level - The log level (optional).
      */
     log(message, level) {
-        const { stepRunId } = this.action;
-        if (!stepRunId) {
+        const { taskRunExternalId } = this.action;
+        if (!taskRunExternalId) {
             // log a warning
             this.logger.warn('cannot log from context without stepRunId');
             return;
         }
-        this.v0.event.putLog(stepRunId, message, level, this.retryCount());
+        this.v0.event.putLog(taskRunExternalId, message, level, this.retryCount());
     }
     /**
      * Refreshes the timeout for the current task.
@@ -311,13 +311,13 @@ class V0Context {
      */
     refreshTimeout(incrementBy) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { stepRunId } = this.action;
-            if (!stepRunId) {
+            const { taskRunExternalId } = this.action;
+            if (!taskRunExternalId) {
                 // log a warning
                 this.logger.warn('cannot refresh timeout from context without stepRunId');
                 return;
             }
-            yield this.v0.dispatcher.refreshTimeout(incrementBy, stepRunId);
+            yield this.v0.dispatcher.refreshTimeout(incrementBy, taskRunExternalId);
         });
     }
     /**
@@ -328,7 +328,7 @@ class V0Context {
     releaseSlot() {
         return __awaiter(this, void 0, void 0, function* () {
             yield this.v0.dispatcher.client.releaseSlot({
-                stepRunId: this.action.stepRunId,
+                taskRunExternalId: this.action.taskRunExternalId,
             });
         });
     }
@@ -339,13 +339,13 @@ class V0Context {
      */
     putStream(data) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { stepRunId } = this.action;
-            if (!stepRunId) {
+            const { taskRunExternalId } = this.action;
+            if (!taskRunExternalId) {
                 // log a warning
                 this.logger.warn('cannot log from context without stepRunId');
                 return;
             }
-            yield this.v0.event.putStream(stepRunId, data, undefined);
+            yield this.v0.event.putStream(taskRunExternalId, data, undefined);
         });
     }
     /**
@@ -378,7 +378,7 @@ class V0Context {
      */
     spawnWorkflows(workflows) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { workflowRunId, stepRunId } = this.action;
+            const { workflowRunId, taskRunExternalId } = this.action;
             const workflowRuns = workflows.map(({ workflow, input, options }) => {
                 let workflowName;
                 if (typeof workflow === 'string') {
@@ -396,7 +396,7 @@ class V0Context {
                 const resp = {
                     workflowName: name,
                     input,
-                    options: Object.assign(Object.assign({}, opts), { parentId: workflowRunId, parentStepRunId: stepRunId, childIndex: this.spawnIndex, desiredWorkerId: sticky ? this.worker.id() : undefined }),
+                    options: Object.assign(Object.assign({}, opts), { parentId: workflowRunId, parentStepRunId: taskRunExternalId, childIndex: this.spawnIndex, desiredWorkerId: sticky ? this.worker.id() : undefined }),
                 };
                 this.spawnIndex += 1;
                 return resp;
@@ -463,7 +463,7 @@ class V0Context {
      */
     spawnWorkflow(workflow, input, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { workflowRunId, stepRunId } = this.action;
+            const { workflowRunId, taskRunExternalId } = this.action;
             let workflowName = '';
             if (typeof workflow === 'string') {
                 workflowName = workflow;
@@ -478,7 +478,7 @@ class V0Context {
                 throw new hatchet_error_1.default(`cannot run with sticky: workflow ${name} is not registered on the worker`);
             }
             try {
-                const resp = yield this.v0.admin.runWorkflow(name, input, Object.assign({ parentId: workflowRunId, parentStepRunId: stepRunId, childIndex: this.spawnIndex, desiredWorkerId: sticky ? this.worker.id() : undefined }, opts));
+                const resp = yield this.v0.admin.runWorkflow(name, input, Object.assign({ parentId: workflowRunId, parentStepRunId: taskRunExternalId, childIndex: this.spawnIndex, desiredWorkerId: sticky ? this.worker.id() : undefined }, opts));
                 this.spawnIndex += 1;
                 if (workflow instanceof declaration_1.TaskWorkflowDeclaration) {
                     resp._standaloneTaskName = workflow._standalone_task_name;
@@ -565,13 +565,13 @@ class V0DurableContext extends V0Context {
             // eslint-disable-next-line no-plusplus
             const key = `waitFor-${this.waitKey++}`;
             yield this.v0.durableListener.registerDurableEvent({
-                taskId: this.action.stepRunId,
+                taskId: this.action.taskRunExternalId,
                 signalKey: key,
                 sleepConditions: pbConditions.sleepConditions,
                 userEventConditions: pbConditions.userEventConditions,
             });
             const listener = this.v0.durableListener.subscribe({
-                taskId: this.action.stepRunId,
+                taskId: this.action.taskRunExternalId,
                 signalKey: key,
             });
             const event = yield listener.get();

package/util/workflow-run-ref.js

@@ -126,7 +126,7 @@ class WorkflowRunRef {
                                     resolve(outputs[this._standaloneTaskName]);
                                     return;
                                 }
-                                const result = event.results.reduce((acc, r) => (Object.assign(Object.assign({}, acc), { [r.stepReadableId]: JSON.parse(r.output || '{}') })), {});
+                                const result = event.results.reduce((acc, r) => (Object.assign(Object.assign({}, acc), { [r.taskName]: JSON.parse(r.output || '{}') })), {});
                                 if (!this._standaloneTaskName) {
                                     resolve(result);
                                     return;

package/v1/client/admin.d.ts

@@ -10,6 +10,16 @@ export type WorkflowRun<T = object> = {
     input: T;
     options?: {
         parentId?: string | undefined;
+        /**
+         * (optional) the parent task run external id.
+         *
+         * This is the field understood by the workflows gRPC API (`parent_task_run_external_id`).
+         */
+        parentTaskRunExternalId?: string | undefined;
+        /**
+         * @deprecated Use `parentTaskRunExternalId` instead.
+         * Kept for backward compatibility; will be mapped to `parentTaskRunExternalId`.
+         */
         parentStepRunId?: string | undefined;
         childIndex?: number | undefined;
         childKey?: string | undefined;
@@ -33,6 +43,16 @@ export declare class AdminClient {
      */
     runWorkflow<Q = object, P = object>(workflowName: string, input: Q, options?: {
         parentId?: string | undefined;
+        /**
+         * (optional) the parent task run external id.
+         *
+         * This is the field understood by the workflows gRPC API (`parent_task_run_external_id`).
+         */
+        parentTaskRunExternalId?: string | undefined;
+        /**
+         * @deprecated Use `parentTaskRunExternalId` instead.
+         * Kept for backward compatibility; will be mapped to `parentTaskRunExternalId`.
+         */
         parentStepRunId?: string | undefined;
         childIndex?: number | undefined;
         childKey?: string | undefined;
@@ -52,6 +72,16 @@ export declare class AdminClient {
         input: Q;
         options?: {
             parentId?: string | undefined;
+            /**
+             * (optional) the parent task run external id.
+             *
+             * This is the field understood by the workflows gRPC API (`parent_task_run_external_id`).
+             */
+            parentTaskRunExternalId?: string | undefined;
+            /**
+             * @deprecated Use `parentTaskRunExternalId` instead.
+             * Kept for backward compatibility; will be mapped to `parentTaskRunExternalId`.
+             */
             parentStepRunId?: string | undefined;
             childIndex?: number | undefined;
             childKey?: string | undefined;

package/v1/client/admin.js

@@ -8,6 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -43,9 +54,11 @@ class AdminClient {
             try {
                 const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace);
                 const inputStr = JSON.stringify(input);
-                const request = Object.assign(Object.assign({ name: computedName, input: inputStr }, options), { additionalMetadata: (options === null || options === void 0 ? void 0 : options.additionalMetadata)
-                        ? JSON.stringify(options === null || options === void 0 ? void 0 : options.additionalMetadata)
-                        : undefined, priority: options === null || options === void 0 ? void 0 : options.priority });
+                const opts = options !== null && options !== void 0 ? options : {};
+                const { additionalMetadata, parentStepRunId, parentTaskRunExternalId } = opts, rest = __rest(opts, ["additionalMetadata", "parentStepRunId", "parentTaskRunExternalId"]);
+                const request = Object.assign(Object.assign({ name: computedName, input: inputStr }, rest), { 
+                    // API expects `parentTaskRunExternalId`; accept old names as aliases.
+                    parentTaskRunExternalId: parentTaskRunExternalId !== null && parentTaskRunExternalId !== void 0 ? parentTaskRunExternalId : parentStepRunId, additionalMetadata: additionalMetadata ? JSON.stringify(additionalMetadata) : undefined, priority: opts.priority });
                 const resp = yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.grpc.triggerWorkflow(request); }), this.logger);
                 const id = resp.workflowRunId;
                 const ref = new workflow_run_ref_1.default(id, this.listenerClient, this.runs, options === null || options === void 0 ? void 0 : options.parentId, 
@@ -71,9 +84,11 @@ class AdminClient {
             const workflowRequests = workflowRuns.map(({ workflowName, input, options }) => {
                 const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace);
                 const inputStr = JSON.stringify(input);
-                return Object.assign(Object.assign({ name: computedName, input: inputStr }, options), { additionalMetadata: (options === null || options === void 0 ? void 0 : options.additionalMetadata)
-                        ? JSON.stringify(options.additionalMetadata)
-                        : undefined });
+                const opts = options !== null && options !== void 0 ? options : {};
+                const { additionalMetadata, parentStepRunId, parentTaskRunExternalId } = opts, rest = __rest(opts, ["additionalMetadata", "parentStepRunId", "parentTaskRunExternalId"]);
+                return Object.assign(Object.assign({ name: computedName, input: inputStr }, rest), { 
+                    // API expects `parentTaskRunExternalId`; accept old names as aliases.
+                    parentTaskRunExternalId: parentTaskRunExternalId !== null && parentTaskRunExternalId !== void 0 ? parentTaskRunExternalId : parentStepRunId, additionalMetadata: additionalMetadata ? JSON.stringify(additionalMetadata) : undefined });
             });
             const limit = 4 * 1024 * 1024; // FIXME configurable GRPC limit
             const batches = (0, batch_1.batch)(workflowRequests, batchSize, limit);