@hatchet-dev/typescript-sdk 1.34.0-alpha.1 → 1.34.0

package/protoc-es/v1/streams_pb.d.ts

@@ -0,0 +1,133 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file v1/streams.proto.
+ */
+export declare const file_v1_streams: GenFile;
+/**
+ * @generated from message v1.PublishStreamMessageRequest
+ */
+export type PublishStreamMessageRequest = Message<"v1.PublishStreamMessageRequest"> & {
+    /**
+     * @generated from field: string namespace = 1;
+     */
+    namespace: string;
+    /**
+     * @generated from field: string topic = 2;
+     */
+    topic: string;
+    /**
+     * @generated from field: bytes payload = 3;
+     */
+    payload: Uint8Array;
+    /**
+     * @generated from field: string producer_id = 4;
+     */
+    producerId: string;
+    /**
+     * @generated from field: int64 producer_seq = 5;
+     */
+    producerSeq: bigint;
+};
+/**
+ * Describes the message v1.PublishStreamMessageRequest.
+ * Use `create(PublishStreamMessageRequestSchema)` to create a new message.
+ */
+export declare const PublishStreamMessageRequestSchema: GenMessage<PublishStreamMessageRequest>;
+/**
+ * @generated from message v1.PublishStreamMessageResponse
+ */
+export type PublishStreamMessageResponse = Message<"v1.PublishStreamMessageResponse"> & {};
+/**
+ * Describes the message v1.PublishStreamMessageResponse.
+ * Use `create(PublishStreamMessageResponseSchema)` to create a new message.
+ */
+export declare const PublishStreamMessageResponseSchema: GenMessage<PublishStreamMessageResponse>;
+/**
+ * @generated from message v1.SubscribeStreamRequest
+ */
+export type SubscribeStreamRequest = Message<"v1.SubscribeStreamRequest"> & {
+    /**
+     * @generated from field: string namespace = 1;
+     */
+    namespace: string;
+    /**
+     * @generated from field: string topic = 2;
+     */
+    topic: string;
+    /**
+     * @generated from field: optional string cursor = 3;
+     */
+    cursor?: string | undefined;
+};
+/**
+ * Describes the message v1.SubscribeStreamRequest.
+ * Use `create(SubscribeStreamRequestSchema)` to create a new message.
+ */
+export declare const SubscribeStreamRequestSchema: GenMessage<SubscribeStreamRequest>;
+/**
+ * @generated from message v1.StreamMessage
+ */
+export type StreamMessage = Message<"v1.StreamMessage"> & {
+    /**
+     * @generated from field: repeated v1.StreamEntry entries = 1;
+     */
+    entries: StreamEntry[];
+    /**
+     * @generated from field: bool hangup = 2;
+     */
+    hangup: boolean;
+    /**
+     * @generated from field: string cursor = 3;
+     */
+    cursor: string;
+};
+/**
+ * Describes the message v1.StreamMessage.
+ * Use `create(StreamMessageSchema)` to create a new message.
+ */
+export declare const StreamMessageSchema: GenMessage<StreamMessage>;
+/**
+ * @generated from message v1.StreamEntry
+ */
+export type StreamEntry = Message<"v1.StreamEntry"> & {
+    /**
+     * @generated from field: bytes payload = 1;
+     */
+    payload: Uint8Array;
+    /**
+     * @generated from field: string cursor = 2;
+     */
+    cursor: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 3;
+     */
+    createdAt?: Timestamp | undefined;
+};
+/**
+ * Describes the message v1.StreamEntry.
+ * Use `create(StreamEntrySchema)` to create a new message.
+ */
+export declare const StreamEntrySchema: GenMessage<StreamEntry>;
+/**
+ * @generated from service v1.V1Streams
+ */
+export declare const V1Streams: GenService<{
+    /**
+     * @generated from rpc v1.V1Streams.Publish
+     */
+    publish: {
+        methodKind: "unary";
+        input: typeof PublishStreamMessageRequestSchema;
+        output: typeof PublishStreamMessageResponseSchema;
+    };
+    /**
+     * @generated from rpc v1.V1Streams.Subscribe
+     */
+    subscribe: {
+        methodKind: "server_streaming";
+        input: typeof SubscribeStreamRequestSchema;
+        output: typeof StreamMessageSchema;
+    };
+}>;

package/protoc-es/v1/streams_pb.js

@@ -0,0 +1,41 @@
+"use strict";
+// @generated by protoc-gen-es v2.15.0 with parameter "target=ts"
+// @generated from file v1/streams.proto (package v1, syntax proto3)
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V1Streams = exports.StreamEntrySchema = exports.StreamMessageSchema = exports.SubscribeStreamRequestSchema = exports.PublishStreamMessageResponseSchema = exports.PublishStreamMessageRequestSchema = exports.file_v1_streams = void 0;
+const codegenv2_1 = require("@bufbuild/protobuf/codegenv2");
+const wkt_1 = require("@bufbuild/protobuf/wkt");
+/**
+ * Describes the file v1/streams.proto.
+ */
+exports.file_v1_streams = (0, codegenv2_1.fileDesc)("ChB2MS9zdHJlYW1zLnByb3RvEgJ2MSJ7ChtQdWJsaXNoU3RyZWFtTWVzc2FnZVJlcXVlc3QSEQoJbmFtZXNwYWNlGAEgASgJEg0KBXRvcGljGAIgASgJEg8KB3BheWxvYWQYAyABKAwSEwoLcHJvZHVjZXJfaWQYBCABKAkSFAoMcHJvZHVjZXJfc2VxGAUgASgDIh4KHFB1Ymxpc2hTdHJlYW1NZXNzYWdlUmVzcG9uc2UiWgoWU3Vic2NyaWJlU3RyZWFtUmVxdWVzdBIRCgluYW1lc3BhY2UYASABKAkSDQoFdG9waWMYAiABKAkSEwoGY3Vyc29yGAMgASgJSACIAQFCCQoHX2N1cnNvciJRCg1TdHJlYW1NZXNzYWdlEiAKB2VudHJpZXMYASADKAsyDy52MS5TdHJlYW1FbnRyeRIOCgZoYW5ndXAYAiABKAgSDgoGY3Vyc29yGAMgASgJIl4KC1N0cmVhbUVudHJ5Eg8KB3BheWxvYWQYASABKAwSDgoGY3Vyc29yGAIgASgJEi4KCmNyZWF0ZWRfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wMpsBCglWMVN0cmVhbXMSTgoHUHVibGlzaBIfLnYxLlB1Ymxpc2hTdHJlYW1NZXNzYWdlUmVxdWVzdBogLnYxLlB1Ymxpc2hTdHJlYW1NZXNzYWdlUmVzcG9uc2UiABI+CglTdWJzY3JpYmUSGi52MS5TdWJzY3JpYmVTdHJlYW1SZXF1ZXN0GhEudjEuU3RyZWFtTWVzc2FnZSIAMAFCQlpAZ2l0aHViLmNvbS9oYXRjaGV0LWRldi9oYXRjaGV0L2ludGVybmFsL3NlcnZpY2VzL3NoYXJlZC9wcm90by92MWIGcHJvdG8z", [wkt_1.file_google_protobuf_timestamp]);
+/**
+ * Describes the message v1.PublishStreamMessageRequest.
+ * Use `create(PublishStreamMessageRequestSchema)` to create a new message.
+ */
+exports.PublishStreamMessageRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 0);
+/**
+ * Describes the message v1.PublishStreamMessageResponse.
+ * Use `create(PublishStreamMessageResponseSchema)` to create a new message.
+ */
+exports.PublishStreamMessageResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 1);
+/**
+ * Describes the message v1.SubscribeStreamRequest.
+ * Use `create(SubscribeStreamRequestSchema)` to create a new message.
+ */
+exports.SubscribeStreamRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 2);
+/**
+ * Describes the message v1.StreamMessage.
+ * Use `create(StreamMessageSchema)` to create a new message.
+ */
+exports.StreamMessageSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 3);
+/**
+ * Describes the message v1.StreamEntry.
+ * Use `create(StreamEntrySchema)` to create a new message.
+ */
+exports.StreamEntrySchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 4);
+/**
+ * @generated from service v1.V1Streams
+ */
+exports.V1Streams = (0, codegenv2_1.serviceDesc)(exports.file_v1_streams, 0);

package/scripts/check-edge-entry.mjs

@@ -1,20 +1,39 @@
 #!/usr/bin/env node
 /* eslint-disable no-console */
-// Verifies the edge entry point (`@hatchet-dev/typescript-sdk/edge`) imports nothing
-// from Node. Bundles dist/edge/index.js for a workerd-like browser target and fails on
-// any `node:` specifier or Node builtin reached from it, transitively.
+// Verifies that an entry point imports nothing from Node. Bundles the entry for a
+// workerd-like browser target and fails on any `node:` specifier or Node builtin reached
+// from it, transitively, on any package named with `--forbid`, and on any SDK module in the
+// bundle that touches a Node-only global (which a bundler cannot see, since nothing imports
+// them): `process`, `Buffer`, `setImmediate`, a timer's `.unref()`, `AbortSignal.timeout`
+// and `AbortSignal.any`. A use the module feature-detects (`typeof setImmediate`,
+// `timer.unref?.()`, `globalThis.Buffer`) is allowed.
 //
-// Run after `pnpm run tsc:build` (the `check:edge` script does both). An alternative
-// entry can be given as the first argument to inspect another module, for example
-// `node scripts/check-edge-entry.mjs dist/index.js` to see what the root reaches.
+// Run after `pnpm run tsc:build`:
+//   node scripts/check-edge-entry.mjs                       # dist/edge/index.js
+//   node scripts/check-edge-entry.mjs dist/core/index.js --forbid axios,nice-grpc
+// The `check:edge` and `check:core` scripts build first and then run the two entries.
 import { builtinModules } from 'node:module';
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { build } from 'esbuild';
+import { build, transformSync } from 'esbuild';
 
 const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const entry = resolve(root, process.argv[2] ?? 'dist/edge/index.js');
+
+const args = process.argv.slice(2);
+const forbidden = new Set();
+let entryArg = 'dist/edge/index.js';
+for (let i = 0; i < args.length; i += 1) {
+  if (args[i] === '--forbid') {
+    for (const pkg of (args[i + 1] ?? '').split(',')) if (pkg) forbidden.add(pkg);
+    i += 1;
+  } else {
+    entryArg = args[i];
+  }
+}
+
+const entry = resolve(root, entryArg);
+const label = entryArg.replace(/^dist\//, '').replace(/\/index\.js$/, '');
 
 if (!existsSync(entry)) {
   console.error(`entry not built: ${entry} is missing. Run \`pnpm run tsc:build\` first.`);
@@ -63,22 +82,61 @@ const result = await build({
 });
 
 const bundled = Object.keys(result.metafile.inputs);
-const sdkInputs = bundled.filter((f) => f.startsWith('dist/'));
+const sdkInputs = bundled.filter((f) => !f.includes('node_modules/'));
 const packageInputs = [...new Set(bundled.filter((f) => f.includes('node_modules/')).map((f) => {
   const m = f.match(/node_modules\/(?:\.pnpm\/[^/]+\/node_modules\/)?((?:@[^/]+\/)?[^/]+)/);
   return m ? m[1] : f;
 }))].sort();
 
-console.log(`edge entry: bundled ${sdkInputs.length} SDK module(s) and ${packageInputs.length} package(s)`);
+console.log(`${label} entry: bundled ${sdkInputs.length} SDK module(s) and ${packageInputs.length} package(s)`);
 if (packageInputs.length) console.log(`packages: ${packageInputs.join(', ')}`);
 
+let failed = false;
+
 if (violations.size > 0) {
-  console.error('\nedge entry reaches Node builtins:');
+  failed = true;
+  console.error(`\n${label} entry reaches Node builtins:`);
   for (const [specifier, importers] of [...violations.entries()].sort()) {
     console.error(`  ${specifier}`);
     for (const importer of [...importers].sort()) console.error(`    from ${importer}`);
   }
-  process.exit(1);
 }
 
-console.log('edge entry is free of Node builtins');
+const forbiddenHits = packageInputs.filter((pkg) => forbidden.has(pkg));
+if (forbiddenHits.length > 0) {
+  failed = true;
+  console.error(`\n${label} entry bundles forbidden package(s): ${forbiddenHits.join(', ')}`);
+}
+
+// These are globals in Node that workerd and browsers lack, or that some runtimes the entry
+// targets lack (`AbortSignal.any`, `AbortSignal.timeout`); a module that reads them fails at
+// runtime without ever importing anything. A module that feature-detects one may use it: a
+// `globalThis.Buffer` access (which the generated bindings guard) and an optional
+// `.unref?.()` call are their own guards, and a `typeof` check of the global anywhere in the
+// module allows its use in that module.
+const nodeGlobals = [
+  { what: 'the process or Buffer globals', pattern: /(?<!globalThis\.)\b(?:process|Buffer)\s*\./ },
+  { what: 'setImmediate', pattern: /(?<![.\w$])setImmediate\s*\(/, guard: /typeof\s+setImmediate\b/ },
+  { what: "a timer's .unref()", pattern: /(?<!\?)\.unref\s*\(/ },
+  {
+    what: 'AbortSignal.timeout or AbortSignal.any',
+    pattern: /\bAbortSignal\s*\.\s*(?:timeout|any)\b/,
+    guard: /typeof\s+AbortSignal\s*\.\s*(?:timeout|any)\b/,
+  },
+];
+// Comments describe these globals without touching them, so they are stripped first. esbuild
+// drops them while leaving string literals alone, which a regex over `//` cannot promise.
+const stripComments = (source) => transformSync(source, { loader: 'js', legalComments: 'none' }).code;
+const sources = new Map(sdkInputs.map((f) => [f, stripComments(readFileSync(resolve(root, f), 'utf8'))]));
+for (const { what, pattern, guard } of nodeGlobals) {
+  const hits = sdkInputs.filter((f) => pattern.test(sources.get(f)) && !(guard && guard.test(sources.get(f))));
+  if (hits.length > 0) {
+    failed = true;
+    console.error(`\n${label} entry bundles SDK module(s) that use ${what}:`);
+    for (const f of hits) console.error(`  ${f}`);
+  }
+}
+
+if (failed) process.exit(1);
+
+console.log(`${label} entry is free of Node builtins${forbidden.size ? ' and forbidden packages' : ''}`);

package/scripts/check-edge-entry.test.ts

@@ -0,0 +1,57 @@
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+
+const script = resolve(__dirname, 'check-edge-entry.mjs');
+
+/** Runs the checker on a module holding `source`, as if it were an SDK module in the bundle. */
+function check(source: string): { status: number | null; stderr: string } {
+  const dir = mkdtempSync(join(tmpdir(), 'check-edge-entry-'));
+  try {
+    const entry = join(dir, 'entry.js');
+    writeFileSync(entry, source);
+    const result = spawnSync(process.execPath, [script, entry], { encoding: 'utf8' });
+    return { status: result.status, stderr: result.stderr };
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+describe('check-edge-entry', () => {
+  it('passes a module that uses none of the Node-only globals', () => {
+    const result = check(`
+      // setImmediate(() => {}) in a comment is fine, as is AbortSignal.any in prose.
+      /* process.exit() described here is fine too */
+      export const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+      export const url = 'https://example.com//path';
+    `);
+    expect(result.stderr).toBe('');
+    expect(result.status).toBe(0);
+  });
+
+  it.each([
+    ['setImmediate', 'export const tick = () => setImmediate(() => {});', /setImmediate/],
+    ['process.nextTick', 'export const tick = () => process.nextTick(() => {});', /process or Buffer/],
+    ['Buffer', "export const bytes = Buffer.from('x');", /process or Buffer/],
+    ['Buffer after // inside a string', "export const p = 'a//b'; export const bytes = Buffer.from('x');", /process or Buffer/],
+    ['.unref(', 'export const timer = setTimeout(() => {}, 1); timer.unref();', /\.unref\(\)/],
+    ['AbortSignal.timeout', 'export const signal = AbortSignal.timeout(5);', /AbortSignal\.timeout or AbortSignal\.any/],
+    ['AbortSignal.any', 'export const signal = AbortSignal.any([]);', /AbortSignal\.timeout or AbortSignal\.any/],
+  ])('fails a module that uses %s', (_name, source, message) => {
+    const result = check(source);
+    expect(result.status).toBe(1);
+    expect(result.stderr).toMatch(message);
+  });
+
+  it.each([
+    ['typeof setImmediate', "export const tick = typeof setImmediate === 'function' ? (f) => setImmediate(f) : (f) => setTimeout(f, 0);"],
+    ['an optional .unref?.()', 'export const timer = setTimeout(() => {}, 1); timer.unref?.();'],
+    ['typeof AbortSignal.any', "export const has = typeof AbortSignal.any === 'function';"],
+    ['globalThis.Buffer', "export const bytes = globalThis.Buffer ? globalThis.Buffer.from('x') : new Uint8Array();"],
+  ])('allows a feature-detected %s', (_name, source) => {
+    const result = check(source);
+    expect(result.stderr).toBe('');
+    expect(result.status).toBe(0);
+  });
+});

package/util/batch.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.batch = batch;
+const utf8 = new TextEncoder();
 function batch(payloads, numElm, maxBytes) {
     const batches = [];
     let currentBatchPayloads = [];
@@ -8,7 +9,7 @@ function batch(payloads, numElm, maxBytes) {
     let currentBatchSize = 0;
     for (let i = 0; i < payloads.length; i += 1) {
         const request = payloads[i];
-        const requestSize = Buffer.byteLength(JSON.stringify(request), 'utf8');
+        const requestSize = utf8.encode(JSON.stringify(request)).byteLength;
         // Check if adding this request would exceed either the payload limit or batch size
         if (currentBatchPayloads.length > 0 &&
             (currentBatchSize + requestSize > maxBytes || currentBatchPayloads.length >= numElm)) {

package/util/config-loader/token.d.ts

@@ -1,4 +1,9 @@
 export declare function getTenantIdFromJWT(token: string): string;
+/**
+ * The engine address a token was issued with, or `undefined` when the claim is absent. The
+ * core client needs only this claim, so it must not fail on a token that lacks `server_url`.
+ */
+export declare function getGrpcBroadcastAddressFromJWT(token: string): string | undefined;
 export declare function getAddressesFromJWT(token: string): {
     serverUrl: string;
     grpcBroadcastAddress: string;

package/util/config-loader/token.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTenantIdFromJWT = getTenantIdFromJWT;
+exports.getGrpcBroadcastAddressFromJWT = getGrpcBroadcastAddressFromJWT;
 exports.getAddressesFromJWT = getAddressesFromJWT;
 const parse_1 = require("../parse");
 function getTenantIdFromJWT(token) {
@@ -10,6 +11,13 @@ function getTenantIdFromJWT(token) {
     }
     return claims.sub;
 }
+/**
+ * The engine address a token was issued with, or `undefined` when the claim is absent. The
+ * core client needs only this claim, so it must not fail on a token that lacks `server_url`.
+ */
+function getGrpcBroadcastAddressFromJWT(token) {
+    return extractClaimsFromJWT(token).grpc_broadcast_address || undefined;
+}
 function getAddressesFromJWT(token) {
     const claims = extractClaimsFromJWT(token);
     if (claims.server_url === undefined || claims.grpc_broadcast_address === undefined) {

package/util/errors/bulk-trigger-partial-error.d.ts

@@ -0,0 +1,17 @@
+import HatchetError from './hatchet-error';
+/**
+ * A bulk trigger that failed after at least one of its batches was accepted. The runs the
+ * accepted batches created exist and are running; a caller that retries the whole request
+ * would create them again, so `refs` carries their references, in input order, for the
+ * caller to keep or cancel. `cause` is the error the failed batch raised, which is a
+ * `BulkTriggerIdempotencyCollisionError` when that batch collided on an idempotency key.
+ */
+export declare class BulkTriggerPartialError<Ref = unknown> extends HatchetError {
+    /** The references of every run created before the failed batch, in input order. */
+    refs: Ref[];
+    /** The zero-based index of the batch that failed. */
+    failedBatchIndex: number;
+    /** The error the failed batch raised. */
+    cause: unknown;
+    constructor(refs: Ref[], failedBatchIndex: number, cause: unknown);
+}

package/util/errors/bulk-trigger-partial-error.js

@@ -0,0 +1,55 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkTriggerPartialError = void 0;
+const hatchet_error_1 = __importStar(require("./hatchet-error"));
+/**
+ * A bulk trigger that failed after at least one of its batches was accepted. The runs the
+ * accepted batches created exist and are running; a caller that retries the whole request
+ * would create them again, so `refs` carries their references, in input order, for the
+ * caller to keep or cancel. `cause` is the error the failed batch raised, which is a
+ * `BulkTriggerIdempotencyCollisionError` when that batch collided on an idempotency key.
+ */
+class BulkTriggerPartialError extends hatchet_error_1.default {
+    constructor(refs, failedBatchIndex, cause) {
+        super(`bulk trigger failed at batch ${failedBatchIndex} after ${refs.length} runs were created: ${(0, hatchet_error_1.getErrorMessage)(cause)}`, { cause });
+        this.name = 'BulkTriggerPartialError';
+        this.refs = refs;
+        this.failedBatchIndex = failedBatchIndex;
+        this.cause = cause;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.BulkTriggerPartialError = BulkTriggerPartialError;

package/v1/client/admin.d.ts

@@ -1,18 +1,13 @@
 import { ClientConfig } from '../../clients/hatchet-client/client-config';
 import WorkflowRunRef from '../../util/workflow-run-ref';
-import { Priority, RateLimitDuration, RunsClient, WorkerLabelComparator } from './..';
+import { RateLimitDuration, RunsClient } from './..';
 import { RunListenerClient } from '../../clients/listeners/run-listener/child-listener-client';
 import { Api } from '../../clients/rest/generated/Api';
 import { WorkflowServiceClient } from '../../protoc/workflows';
 import { AdminServiceClient, CreateWorkflowVersionRequest } from '../../protoc/v1/workflows';
 import { type Transport } from '../../clients/transport';
+import type { TriggerRun, TriggerRunOptions } from '../../core/types';
 import { Logger } from '../../util/logger';
-type DesiredWorkerLabelOpt = {
-    value: string | number;
-    required?: boolean;
-    weight?: number;
-    comparator?: WorkerLabelComparator;
-};
 export type WorkflowRun<T = object> = {
     workflowName: string;
     input: T;
@@ -58,27 +53,7 @@ export declare class AdminClient {
      * @important This method is instrumented by HatchetInstrumentor._patchRunWorkflow.
      * Keep the signature in sync with the instrumentor wrapper.
      */
-    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;
-        additionalMetadata?: Record<string, string> | undefined;
-        desiredWorkerId?: string | undefined;
-        priority?: Priority;
-        desiredWorkerLabels?: Record<string, DesiredWorkerLabelOpt>;
-        _standaloneTaskName?: string | undefined;
-    }): Promise<WorkflowRunRef<P>>;
+    runWorkflow<Q = object, P = object>(workflowName: string, input: Q, options?: TriggerRunOptions): Promise<WorkflowRunRef<P>>;
     /**
      * Run multiple workflows runs with the given input and options. This will create new workflow runs and return their IDs.
      * Order is preserved in the response.
@@ -88,31 +63,6 @@ export declare class AdminClient {
      * @important This method is instrumented by HatchetInstrumentor._patchRunWorkflows.
      * Keep the signature in sync with the instrumentor wrapper.
      */
-    runWorkflows<Q = object, P = object>(workflowRuns: Array<{
-        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;
-            additionalMetadata?: Record<string, string> | undefined;
-            desiredWorkerId?: string | undefined;
-            priority?: Priority;
-            desiredWorkerLabels?: Record<string, DesiredWorkerLabelOpt>;
-            _standaloneTaskName?: string | undefined;
-        };
-    }>, batchSize?: number): Promise<WorkflowRunRef<P>[]>;
+    runWorkflows<Q = object, P = object>(workflowRuns: Array<TriggerRun<Q>>, batchSize?: number): Promise<WorkflowRunRef<P>[]>;
     putRateLimit(key: string, limit: number, duration?: RateLimitDuration): Promise<void>;
 }
-export {};