abxbus 2.5.1 → 2.5.4

package/dist/esm/retry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/retry.ts"],
-  "sourcesContent": ["import { createAsyncLocalStorage, type AsyncLocalStorageLike } from './async_context.js'\nimport { isNodeRuntime } from './optional_deps.js'\n\ntype SemaphoreScope = 'multiprocess' | 'global' | 'class' | 'instance'\n\ntype MultiprocessLockHandle = {\n  release: () => Promise<void>\n}\n\nconst MULTIPROCESS_SEMAPHORE_DIRNAME = 'browser_use_semaphores'\nconst MULTIPROCESS_STALE_LOCK_MS = 5 * 60 * 1000\n\nlet multiprocess_fallback_reason_logged: string | null = null\n\n// \u2500\u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface RetryOptions {\n  /** Total number of attempts including the initial call (1 = no retry, 3 = up to 2 retries). Default: 1 */\n  max_attempts?: number\n\n  /** Seconds to wait between retries. Default: 0 */\n  retry_after?: number\n\n  /** Multiplier applied to retry_after after each attempt for exponential backoff. Default: 1.0 (constant delay) */\n  retry_backoff_factor?: number\n\n  /** Only retry when the thrown error matches one of these matchers. Accepts error class constructors,\n   *  string error names (matched against error.name), or RegExp patterns (tested against String(error)).\n   *  Default: undefined (retry on any error) */\n  retry_on_errors?: Array<(new (...args: any[]) => Error) | string | RegExp>\n\n  /** Per-attempt timeout in seconds. Default: undefined (no per-attempt timeout) */\n  timeout?: number | null\n\n  /** Maximum concurrent executions sharing this semaphore. Default: undefined (no concurrency limit) */\n  semaphore_limit?: number | null\n\n  /** Semaphore identifier. Functions with the same name share the same concurrency slot pool. Default: function name.\n   *  If a function is provided, it receives the same arguments as the wrapped function. */\n  semaphore_name?: string | ((...args: any[]) => string) | null\n\n  /** If true, proceed without concurrency limit when semaphore acquisition times out. Default: true */\n  semaphore_lax?: boolean\n\n  /** Semaphore scoping strategy. Default: 'global'\n   *  - 'multiprocess': all processes on the machine share one semaphore (Node.js only)\n   *  - 'global': all calls share one semaphore (keyed by semaphore_name)\n   *  - 'class': all instances of the same class share one semaphore (keyed by className.semaphore_name)\n   *  - 'instance': each object instance gets its own semaphore (keyed by instanceId.semaphore_name)\n   *  'class' and 'instance' require `this` to be an object; they fall back to 'global' for standalone calls. */\n  semaphore_scope?: SemaphoreScope\n\n  /** Maximum seconds to wait for semaphore acquisition. Default: undefined \u2192 timeout * max(1, limit - 1) */\n  semaphore_timeout?: number | null\n}\n\n// \u2500\u2500\u2500 Errors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** Thrown when a single attempt exceeds the per-attempt timeout. */\nexport class RetryTimeoutError extends Error {\n  timeout_seconds: number\n  attempt: number\n\n  constructor(message: string, params: { timeout_seconds: number; attempt: number }) {\n    super(message)\n    this.name = 'RetryTimeoutError'\n    this.timeout_seconds = params.timeout_seconds\n    this.attempt = params.attempt\n  }\n}\n\n/** Thrown (when semaphore_lax=false) if the semaphore cannot be acquired within the timeout. */\nexport class SemaphoreTimeoutError extends Error {\n  semaphore_name: string\n  semaphore_limit: number\n  timeout_seconds: number\n\n  constructor(message: string, params: { semaphore_name: string; semaphore_limit: number; timeout_seconds: number }) {\n    super(message)\n    this.name = 'SemaphoreTimeoutError'\n    this.semaphore_name = params.semaphore_name\n    this.semaphore_limit = params.semaphore_limit\n    this.timeout_seconds = params.timeout_seconds\n  }\n}\n\n// \u2500\u2500\u2500 Re-entrancy tracking via AsyncLocalStorage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Prevents deadlocks when a retry()-wrapped function calls another retry()-wrapped\n// function that shares the same semaphore (or calls itself recursively).\n//\n// Each async call stack tracks which semaphore names it currently holds. When a\n// nested call encounters a semaphore it already holds, it skips acquisition and\n// runs directly within the parent's slot.\n//\n// Uses the same AsyncLocalStorage polyfill as the rest of abxbus (see async_context.ts)\n// so it works in Node.js and gracefully degrades to a no-op in browsers.\n\ntype ReentrantStore = Set<string>\n\n// Separate AsyncLocalStorage instance for retry re-entrancy tracking.\n// Created via the shared factory in async_context.ts (returns null in browsers).\nconst retry_context_storage: AsyncLocalStorageLike | null = createAsyncLocalStorage()\n\nfunction getHeldSemaphores(): ReentrantStore {\n  return (retry_context_storage?.getStore() as ReentrantStore | undefined) ?? new Set()\n}\n\nfunction runWithHeldSemaphores<T>(held: ReentrantStore, fn: () => T): T {\n  if (!retry_context_storage) return fn()\n  return retry_context_storage.run(held, fn)\n}\n\n// \u2500\u2500\u2500 Semaphore scope helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nlet _next_instance_id = 1\nconst _instance_ids = new WeakMap<object, number>()\n\nfunction scopedSemaphoreKey(base_name: string, scope: SemaphoreScope, context: unknown): string {\n  if (scope === 'class' && context && typeof context === 'object') {\n    return `${(context as object).constructor?.name ?? 'Object'}.${base_name}`\n  }\n  if (scope === 'instance' && context && typeof context === 'object') {\n    let id = _instance_ids.get(context as object)\n    if (id === undefined) {\n      id = _next_instance_id++\n      _instance_ids.set(context as object, id)\n    }\n    return `${id}.${base_name}`\n  }\n  return base_name\n}\n\n// \u2500\u2500\u2500 Global semaphore registry \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nclass RetrySemaphore {\n  readonly size: number\n  private inUse: number\n  private waiters: Array<() => void>\n\n  constructor(size: number) {\n    this.size = size\n    this.inUse = 0\n    this.waiters = []\n  }\n\n  async acquire(): Promise<void> {\n    if (this.size === Infinity) {\n      return\n    }\n    if (this.inUse < this.size) {\n      this.inUse += 1\n      return\n    }\n    await new Promise<void>((resolve) => {\n      this.waiters.push(resolve)\n    })\n  }\n\n  release(): void {\n    if (this.size === Infinity) {\n      return\n    }\n    const next = this.waiters.shift()\n    if (next) {\n      // Handoff: keep the permit accounted for and transfer it directly to the waiter.\n      next()\n      return\n    }\n    this.inUse = Math.max(0, this.inUse - 1)\n  }\n}\n\nconst SEMAPHORE_REGISTRY = new Map<string, RetrySemaphore>()\n\nfunction getOrCreateSemaphore(name: string, limit: number): RetrySemaphore {\n  const existing = SEMAPHORE_REGISTRY.get(name)\n  if (existing && existing.size === limit) return existing\n  const sem = new RetrySemaphore(limit)\n  SEMAPHORE_REGISTRY.set(name, sem)\n  return sem\n}\n\n/** Reset the global semaphore registry. Useful in tests. */\nexport function clearSemaphoreRegistry(): void {\n  SEMAPHORE_REGISTRY.clear()\n  multiprocess_fallback_reason_logged = null\n}\n\n// \u2500\u2500\u2500 retry() decorator / higher-order wrapper \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Usage as a higher-order function (works on any async function):\n//\n//   const fetchWithRetry = retry({ max_attempts: 3, retry_after: 1 })(async (url: string) => {\n//     return await fetch(url)\n//   })\n//\n// Usage as a TC39 Stage 3 decorator on class methods (TS 5.0+):\n//\n//   class ApiClient {\n//     @retry({ max_attempts: 3, retry_after: 1 })\n//     async fetchData(): Promise<Data> { ... }\n//   }\n//\n// Usage on event bus handlers:\n//\n//   bus.on(MyEvent, retry({ max_attempts: 3 })(async (event) => {\n//     await riskyOperation(event.data)\n//   }))\n\nexport function retry(options: RetryOptions = {}) {\n  const {\n    max_attempts = 1,\n    retry_after = 0,\n    retry_backoff_factor = 1.0,\n    retry_on_errors,\n    timeout,\n    semaphore_limit,\n    semaphore_name: semaphore_name_option,\n    semaphore_lax = true,\n    semaphore_scope = 'global',\n    semaphore_timeout,\n  } = options\n\n  return function decorator<T extends (...args: any[]) => any>(target: T, _context?: ClassMethodDecoratorContext): T {\n    const fn_name = target.name || (_context?.name as string) || 'anonymous'\n    const effective_max_attempts = Math.max(1, max_attempts)\n    const effective_retry_after = Math.max(0, retry_after)\n\n    async function retryWrapper(this: any, ...args: any[]): Promise<any> {\n      const base_name = typeof semaphore_name_option === 'function' ? semaphore_name_option(...args) : (semaphore_name_option ?? fn_name)\n      const sem_name = typeof base_name === 'string' ? base_name : String(base_name)\n      // \u2500\u2500 Resolve scoped semaphore key at call time (uses `this` for class/instance scopes) \u2500\u2500\n      const scoped_key = scopedSemaphoreKey(sem_name, semaphore_scope, this)\n\n      // \u2500\u2500 Check re-entrancy: skip semaphore if we already hold it in this async context \u2500\u2500\n      const held = getHeldSemaphores()\n      const needs_semaphore = semaphore_limit != null && semaphore_limit > 0\n      const is_reentrant = needs_semaphore && held.has(scoped_key)\n\n      // \u2500\u2500 Semaphore acquisition (held across all retry attempts, skipped if re-entrant) \u2500\u2500\n      let semaphore: RetrySemaphore | null = null\n      let multiprocess_lock: MultiprocessLockHandle | null = null\n      let semaphore_acquired = false\n\n      if (needs_semaphore && !is_reentrant) {\n        const effective_sem_timeout =\n          semaphore_timeout != null ? semaphore_timeout : timeout != null ? timeout * Math.max(1, semaphore_limit! - 1) : null\n\n        if (semaphore_scope === 'multiprocess') {\n          if (isNodeRuntime()) {\n            multiprocess_lock = await acquireMultiprocessSemaphore(scoped_key, semaphore_limit!, effective_sem_timeout, semaphore_lax)\n            semaphore_acquired = multiprocess_lock !== null\n          } else {\n            logMultiprocessFallbackOnce('multiprocess semaphores require a Node.js runtime; falling back to in-process global scope')\n            semaphore = getOrCreateSemaphore(scoped_key, semaphore_limit!)\n            if (effective_sem_timeout != null && effective_sem_timeout > 0) {\n              semaphore_acquired = await acquireWithTimeout(semaphore, effective_sem_timeout * 1000)\n              if (!semaphore_acquired) {\n                if (!semaphore_lax) {\n                  throw new SemaphoreTimeoutError(\n                    `Failed to acquire semaphore \"${scoped_key}\" within ${effective_sem_timeout}s (limit=${semaphore_limit})`,\n                    { semaphore_name: scoped_key, semaphore_limit: semaphore_limit!, timeout_seconds: effective_sem_timeout }\n                  )\n                }\n              }\n            } else {\n              await semaphore.acquire()\n              semaphore_acquired = true\n            }\n          }\n        } else {\n          semaphore = getOrCreateSemaphore(scoped_key, semaphore_limit!)\n\n          if (effective_sem_timeout != null && effective_sem_timeout > 0) {\n            semaphore_acquired = await acquireWithTimeout(semaphore, effective_sem_timeout * 1000)\n            if (!semaphore_acquired) {\n              if (!semaphore_lax) {\n                throw new SemaphoreTimeoutError(\n                  `Failed to acquire semaphore \"${scoped_key}\" within ${effective_sem_timeout}s (limit=${semaphore_limit})`,\n                  { semaphore_name: scoped_key, semaphore_limit: semaphore_limit!, timeout_seconds: effective_sem_timeout }\n                )\n              }\n            }\n          } else {\n            await semaphore.acquire()\n            semaphore_acquired = true\n          }\n        }\n      }\n\n      // \u2500\u2500 Build the set of held semaphores for nested calls \u2500\u2500\n      const new_held = new Set(held)\n      if (semaphore_acquired) {\n        new_held.add(scoped_key)\n      }\n\n      // \u2500\u2500 Retry loop (runs inside the semaphore and re-entrancy context) \u2500\u2500\n      const runRetryLoop = async (): Promise<any> => {\n        for (let attempt = 1; attempt <= effective_max_attempts; attempt++) {\n          try {\n            if (timeout != null && timeout > 0) {\n              return await _runWithTimeout(() => Promise.resolve(target.apply(this, args)), timeout * 1000, attempt)\n            } else {\n              return await Promise.resolve(target.apply(this, args))\n            }\n          } catch (error) {\n            // Check if this error type should trigger a retry\n            if (retry_on_errors && retry_on_errors.length > 0) {\n              const is_retryable = retry_on_errors.some((matcher) =>\n                typeof matcher === 'string'\n                  ? (error as Error)?.name === matcher\n                  : matcher instanceof RegExp\n                    ? matcher.test(String(error))\n                    : error instanceof matcher\n              )\n              if (!is_retryable) throw error\n            }\n\n            // Last attempt: rethrow\n            if (attempt >= effective_max_attempts) throw error\n\n            // Wait before next attempt with exponential backoff\n            const delay_seconds = effective_retry_after * Math.pow(retry_backoff_factor, attempt - 1)\n            if (delay_seconds > 0) {\n              await sleep(delay_seconds * 1000)\n            }\n          }\n        }\n\n        // Unreachable, but satisfies the type checker\n        throw new Error(`retry(${fn_name}): unexpected end of retry loop`)\n      }\n\n      try {\n        return await runWithHeldSemaphores(new_held, runRetryLoop)\n      } finally {\n        if (semaphore_acquired && multiprocess_lock) {\n          await multiprocess_lock.release()\n        } else if (semaphore_acquired && semaphore) {\n          semaphore.release()\n        }\n      }\n    }\n\n    Object.defineProperty(retryWrapper, 'name', { value: fn_name, configurable: true })\n    if (_context?.kind === 'method' && typeof _context.addInitializer === 'function') {\n      _context.addInitializer(function (this: unknown) {\n        const owner_name = findDecoratedMethodOwnerName(this, _context, retryWrapper)\n        if (owner_name) {\n          Object.defineProperty(retryWrapper, 'name', { value: `${owner_name}.${fn_name}`, configurable: true })\n        }\n      })\n    }\n    return retryWrapper as unknown as T\n  }\n}\n\n// \u2500\u2500\u2500 Internal helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction findDecoratedMethodOwnerName(\n  context_this: unknown,\n  context: ClassMethodDecoratorContext,\n  replacement: (...args: any[]) => any\n): string | null {\n  const method_name = context.name\n  if (typeof method_name !== 'string') {\n    return null\n  }\n\n  if (context.static) {\n    let ctor = typeof context_this === 'function' ? context_this : null\n    while (ctor && ctor !== Function.prototype) {\n      const descriptor = Object.getOwnPropertyDescriptor(ctor, method_name)\n      if (descriptor?.value === replacement) {\n        return ctor.name || null\n      }\n      const parent = Object.getPrototypeOf(ctor)\n      ctor = typeof parent === 'function' ? parent : null\n    }\n    return null\n  }\n\n  if ((typeof context_this !== 'object' && typeof context_this !== 'function') || context_this === null) {\n    return null\n  }\n\n  let prototype = Object.getPrototypeOf(context_this)\n  while (prototype && prototype !== Object.prototype) {\n    const descriptor = Object.getOwnPropertyDescriptor(prototype, method_name)\n    if (descriptor?.value === replacement) {\n      const ctor_name = (prototype as { constructor?: { name?: string } }).constructor?.name\n      return ctor_name || null\n    }\n    prototype = Object.getPrototypeOf(prototype)\n  }\n  return null\n}\n\n/**\n * Try to acquire a semaphore within a timeout. Returns true if acquired, false if timed out.\n * If the semaphore is acquired after the timeout (due to the waiter remaining queued),\n * it is immediately released to avoid leaking slots.\n */\nasync function acquireWithTimeout(semaphore: RetrySemaphore, timeout_ms: number): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    let settled = false\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true\n        resolve(false)\n      }\n    }, timeout_ms)\n\n    semaphore.acquire().then(() => {\n      if (!settled) {\n        settled = true\n        clearTimeout(timer)\n        resolve(true)\n      } else {\n        // Acquired after timeout fired \u2014 release immediately to avoid slot leak\n        semaphore.release()\n      }\n    })\n  })\n}\n\nfunction logMultiprocessFallbackOnce(reason: string): void {\n  if (multiprocess_fallback_reason_logged === reason) return\n  multiprocess_fallback_reason_logged = reason\n  console.warn(`[abxbus.retry] ${reason}`)\n}\n\nasync function importNodeModule(specifier: string): Promise<any> {\n  const dynamic_import = Function('module_name', 'return import(module_name)') as (module_name: string) => Promise<unknown>\n  return dynamic_import(specifier) as Promise<any>\n}\n\nasync function acquireMultiprocessSemaphore(\n  scoped_key: string,\n  semaphore_limit: number,\n  semaphore_timeout_seconds: number | null,\n  semaphore_lax: boolean\n): Promise<MultiprocessLockHandle | null> {\n  const [crypto, fs, os, path] = await Promise.all([\n    importNodeModule('node:crypto'),\n    importNodeModule('node:fs'),\n    importNodeModule('node:os'),\n    importNodeModule('node:path'),\n  ])\n  const semaphore_directory = path.join(os.tmpdir(), MULTIPROCESS_SEMAPHORE_DIRNAME)\n  const lock_prefix = crypto.createHash('sha256').update(scoped_key).digest('hex').slice(0, 40)\n  fs.mkdirSync(semaphore_directory, { recursive: true })\n\n  const start = Date.now()\n  let retry_delay_ms = 100\n\n  while (true) {\n    const elapsed_ms = Date.now() - start\n    const remaining_ms =\n      semaphore_timeout_seconds != null && semaphore_timeout_seconds > 0 ? semaphore_timeout_seconds * 1000 - elapsed_ms : null\n\n    if (remaining_ms != null && remaining_ms <= 0) {\n      break\n    }\n\n    for (let slot = 0; slot < semaphore_limit; slot++) {\n      const slot_file = path.join(semaphore_directory, `${lock_prefix}.${String(slot).padStart(2, '0')}.lock`)\n      const token = `${process.pid}:${Date.now()}:${Math.random().toString(16).slice(2)}`\n\n      try {\n        const fd = fs.openSync(slot_file, 'wx', 0o600)\n        try {\n          fs.writeFileSync(\n            fd,\n            JSON.stringify({\n              token,\n              pid: process.pid,\n              semaphore_name: scoped_key,\n              created_at_ms: Date.now(),\n            }),\n            'utf8'\n          )\n        } finally {\n          fs.closeSync(fd)\n        }\n        return {\n          release: async () => {\n            try {\n              const raw = String(fs.readFileSync(slot_file, 'utf8') || '').trim()\n              const current_owner = raw ? (JSON.parse(raw) as { token?: unknown }) : null\n              if (current_owner?.token === token) {\n                fs.unlinkSync(slot_file)\n              }\n            } catch {}\n          },\n        }\n      } catch (error) {\n        if (!(error instanceof Error) || (error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw error\n        }\n\n        try {\n          const raw = String(fs.readFileSync(slot_file, 'utf8') || '').trim()\n          const current_owner = raw ? (JSON.parse(raw) as { pid?: unknown }) : null\n          const current_pid = typeof current_owner?.pid === 'number' ? current_owner.pid : null\n          if (current_pid != null) {\n            try {\n              process.kill(current_pid, 0)\n              continue\n            } catch {}\n          }\n\n          const slot_age_ms = Date.now() - fs.statSync(slot_file).mtimeMs\n          if (current_pid != null || slot_age_ms >= MULTIPROCESS_STALE_LOCK_MS) {\n            fs.unlinkSync(slot_file)\n          }\n        } catch {}\n      }\n    }\n\n    const sleep_ms = Math.min(retry_delay_ms, remaining_ms ?? retry_delay_ms)\n    if (sleep_ms > 0) {\n      await sleep(sleep_ms)\n    }\n    retry_delay_ms = Math.min(retry_delay_ms * 2, 1000)\n  }\n\n  if (!semaphore_lax) {\n    throw new SemaphoreTimeoutError(\n      `Failed to acquire semaphore \"${scoped_key}\" within ${semaphore_timeout_seconds}s (limit=${semaphore_limit})`,\n      { semaphore_name: scoped_key, semaphore_limit, timeout_seconds: semaphore_timeout_seconds ?? 0 }\n    )\n  }\n\n  return null\n}\n\n/** Run fn() with a timeout. Rejects with RetryTimeoutError if the timeout fires first. */\nasync function _runWithTimeout<T>(fn: () => Promise<T>, timeout_ms: number, attempt: number): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let settled = false\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true\n        reject(\n          new RetryTimeoutError(`Timed out after ${timeout_ms / 1000}s (attempt ${attempt})`, {\n            timeout_seconds: timeout_ms / 1000,\n            attempt,\n          })\n        )\n      }\n    }, timeout_ms)\n\n    fn().then(\n      (value) => {\n        if (!settled) {\n          settled = true\n          clearTimeout(timer)\n          resolve(value)\n        }\n      },\n      (error) => {\n        if (!settled) {\n          settled = true\n          clearTimeout(timer)\n          reject(error)\n        }\n      }\n    )\n  })\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n"],
-  "mappings": "AAAA,SAAS,+BAA2D;AACpE,SAAS,qBAAqB;AAQ9B,MAAM,iCAAiC;AACvC,MAAM,6BAA6B,IAAI,KAAK;AAE5C,IAAI,sCAAqD;AA+ClD,MAAM,0BAA0B,MAAM;AAAA,EAC3C;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,QAAsD;AACjF,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,kBAAkB,OAAO;AAC9B,SAAK,UAAU,OAAO;AAAA,EACxB;AACF;AAGO,MAAM,8BAA8B,MAAM;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,QAAsF;AACjH,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,iBAAiB,OAAO;AAC7B,SAAK,kBAAkB,OAAO;AAC9B,SAAK,kBAAkB,OAAO;AAAA,EAChC;AACF;AAkBA,MAAM,wBAAsD,wBAAwB;AAEpF,SAAS,oBAAoC;AAC3C,SAAQ,uBAAuB,SAAS,KAAoC,oBAAI,IAAI;AACtF;AAEA,SAAS,sBAAyB,MAAsB,IAAgB;AACtE,MAAI,CAAC,sBAAuB,QAAO,GAAG;AACtC,SAAO,sBAAsB,IAAI,MAAM,EAAE;AAC3C;AAIA,IAAI,oBAAoB;AACxB,MAAM,gBAAgB,oBAAI,QAAwB;AAElD,SAAS,mBAAmB,WAAmB,OAAuB,SAA0B;AAC9F,MAAI,UAAU,WAAW,WAAW,OAAO,YAAY,UAAU;AAC/D,WAAO,GAAI,QAAmB,aAAa,QAAQ,QAAQ,IAAI,SAAS;AAAA,EAC1E;AACA,MAAI,UAAU,cAAc,WAAW,OAAO,YAAY,UAAU;AAClE,QAAI,KAAK,cAAc,IAAI,OAAiB;AAC5C,QAAI,OAAO,QAAW;AACpB,WAAK;AACL,oBAAc,IAAI,SAAmB,EAAE;AAAA,IACzC;AACA,WAAO,GAAG,EAAE,IAAI,SAAS;AAAA,EAC3B;AACA,SAAO;AACT;AAIA,MAAM,eAAe;AAAA,EACV;AAAA,EACD;AAAA,EACA;AAAA,EAER,YAAY,MAAc;AACxB,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,UAAU,CAAC;AAAA,EAClB;AAAA,EAEA,MAAM,UAAyB;AAC7B,QAAI,KAAK,SAAS,UAAU;AAC1B;AAAA,IACF;AACA,QAAI,KAAK,QAAQ,KAAK,MAAM;AAC1B,WAAK,SAAS;AACd;AAAA,IACF;AACA,UAAM,IAAI,QAAc,CAAC,YAAY;AACnC,WAAK,QAAQ,KAAK,OAAO;AAAA,IAC3B,CAAC;AAAA,EACH;AAAA,EAEA,UAAgB;AACd,QAAI,KAAK,SAAS,UAAU;AAC1B;AAAA,IACF;AACA,UAAM,OAAO,KAAK,QAAQ,MAAM;AAChC,QAAI,MAAM;AAER,WAAK;AACL;AAAA,IACF;AACA,SAAK,QAAQ,KAAK,IAAI,GAAG,KAAK,QAAQ,CAAC;AAAA,EACzC;AACF;AAEA,MAAM,qBAAqB,oBAAI,IAA4B;AAE3D,SAAS,qBAAqB,MAAc,OAA+B;AACzE,QAAM,WAAW,mBAAmB,IAAI,IAAI;AAC5C,MAAI,YAAY,SAAS,SAAS,MAAO,QAAO;AAChD,QAAM,MAAM,IAAI,eAAe,KAAK;AACpC,qBAAmB,IAAI,MAAM,GAAG;AAChC,SAAO;AACT;AAGO,SAAS,yBAA+B;AAC7C,qBAAmB,MAAM;AACzB,wCAAsC;AACxC;AAuBO,SAAS,MAAM,UAAwB,CAAC,GAAG;AAChD,QAAM;AAAA,IACJ,eAAe;AAAA,IACf,cAAc;AAAA,IACd,uBAAuB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,IAChB,gBAAgB;AAAA,IAChB,kBAAkB;AAAA,IAClB;AAAA,EACF,IAAI;AAEJ,SAAO,SAAS,UAA6C,QAAW,UAA2C;AACjH,UAAM,UAAU,OAAO,QAAS,UAAU,QAAmB;AAC7D,UAAM,yBAAyB,KAAK,IAAI,GAAG,YAAY;AACvD,UAAM,wBAAwB,KAAK,IAAI,GAAG,WAAW;AAErD,mBAAe,gBAA2B,MAA2B;AACnE,YAAM,YAAY,OAAO,0BAA0B,aAAa,sBAAsB,GAAG,IAAI,IAAK,yBAAyB;AAC3H,YAAM,WAAW,OAAO,cAAc,WAAW,YAAY,OAAO,SAAS;AAE7E,YAAM,aAAa,mBAAmB,UAAU,iBAAiB,IAAI;AAGrE,YAAM,OAAO,kBAAkB;AAC/B,YAAM,kBAAkB,mBAAmB,QAAQ,kBAAkB;AACrE,YAAM,eAAe,mBAAmB,KAAK,IAAI,UAAU;AAG3D,UAAI,YAAmC;AACvC,UAAI,oBAAmD;AACvD,UAAI,qBAAqB;AAEzB,UAAI,mBAAmB,CAAC,cAAc;AACpC,cAAM,wBACJ,qBAAqB,OAAO,oBAAoB,WAAW,OAAO,UAAU,KAAK,IAAI,GAAG,kBAAmB,CAAC,IAAI;AAElH,YAAI,oBAAoB,gBAAgB;AACtC,cAAI,cAAc,GAAG;AACnB,gCAAoB,MAAM,6BAA6B,YAAY,iBAAkB,uBAAuB,aAAa;AACzH,iCAAqB,sBAAsB;AAAA,UAC7C,OAAO;AACL,wCAA4B,4FAA4F;AACxH,wBAAY,qBAAqB,YAAY,eAAgB;AAC7D,gBAAI,yBAAyB,QAAQ,wBAAwB,GAAG;AAC9D,mCAAqB,MAAM,mBAAmB,WAAW,wBAAwB,GAAI;AACrF,kBAAI,CAAC,oBAAoB;AACvB,oBAAI,CAAC,eAAe;AAClB,wBAAM,IAAI;AAAA,oBACR,gCAAgC,UAAU,YAAY,qBAAqB,YAAY,eAAe;AAAA,oBACtG,EAAE,gBAAgB,YAAY,iBAAmC,iBAAiB,sBAAsB;AAAA,kBAC1G;AAAA,gBACF;AAAA,cACF;AAAA,YACF,OAAO;AACL,oBAAM,UAAU,QAAQ;AACxB,mCAAqB;AAAA,YACvB;AAAA,UACF;AAAA,QACF,OAAO;AACL,sBAAY,qBAAqB,YAAY,eAAgB;AAE7D,cAAI,yBAAyB,QAAQ,wBAAwB,GAAG;AAC9D,iCAAqB,MAAM,mBAAmB,WAAW,wBAAwB,GAAI;AACrF,gBAAI,CAAC,oBAAoB;AACvB,kBAAI,CAAC,eAAe;AAClB,sBAAM,IAAI;AAAA,kBACR,gCAAgC,UAAU,YAAY,qBAAqB,YAAY,eAAe;AAAA,kBACtG,EAAE,gBAAgB,YAAY,iBAAmC,iBAAiB,sBAAsB;AAAA,gBAC1G;AAAA,cACF;AAAA,YACF;AAAA,UACF,OAAO;AACL,kBAAM,UAAU,QAAQ;AACxB,iCAAqB;AAAA,UACvB;AAAA,QACF;AAAA,MACF;AAGA,YAAM,WAAW,IAAI,IAAI,IAAI;AAC7B,UAAI,oBAAoB;AACtB,iBAAS,IAAI,UAAU;AAAA,MACzB;AAGA,YAAM,eAAe,YAA0B;AAC7C,iBAAS,UAAU,GAAG,WAAW,wBAAwB,WAAW;AAClE,cAAI;AACF,gBAAI,WAAW,QAAQ,UAAU,GAAG;AAClC,qBAAO,MAAM,gBAAgB,MAAM,QAAQ,QAAQ,OAAO,MAAM,MAAM,IAAI,CAAC,GAAG,UAAU,KAAM,OAAO;AAAA,YACvG,OAAO;AACL,qBAAO,MAAM,QAAQ,QAAQ,OAAO,MAAM,MAAM,IAAI,CAAC;AAAA,YACvD;AAAA,UACF,SAAS,OAAO;AAEd,gBAAI,mBAAmB,gBAAgB,SAAS,GAAG;AACjD,oBAAM,eAAe,gBAAgB;AAAA,gBAAK,CAAC,YACzC,OAAO,YAAY,WACd,OAAiB,SAAS,UAC3B,mBAAmB,SACjB,QAAQ,KAAK,OAAO,KAAK,CAAC,IAC1B,iBAAiB;AAAA,cACzB;AACA,kBAAI,CAAC,aAAc,OAAM;AAAA,YAC3B;AAGA,gBAAI,WAAW,uBAAwB,OAAM;AAG7C,kBAAM,gBAAgB,wBAAwB,KAAK,IAAI,sBAAsB,UAAU,CAAC;AACxF,gBAAI,gBAAgB,GAAG;AACrB,oBAAM,MAAM,gBAAgB,GAAI;AAAA,YAClC;AAAA,UACF;AAAA,QACF;AAGA,cAAM,IAAI,MAAM,SAAS,OAAO,iCAAiC;AAAA,MACnE;AAEA,UAAI;AACF,eAAO,MAAM,sBAAsB,UAAU,YAAY;AAAA,MAC3D,UAAE;AACA,YAAI,sBAAsB,mBAAmB;AAC3C,gBAAM,kBAAkB,QAAQ;AAAA,QAClC,WAAW,sBAAsB,WAAW;AAC1C,oBAAU,QAAQ;AAAA,QACpB;AAAA,MACF;AAAA,IACF;AAEA,WAAO,eAAe,cAAc,QAAQ,EAAE,OAAO,SAAS,cAAc,KAAK,CAAC;AAClF,QAAI,UAAU,SAAS,YAAY,OAAO,SAAS,mBAAmB,YAAY;AAChF,eAAS,eAAe,WAAyB;AAC/C,cAAM,aAAa,6BAA6B,MAAM,UAAU,YAAY;AAC5E,YAAI,YAAY;AACd,iBAAO,eAAe,cAAc,QAAQ,EAAE,OAAO,GAAG,UAAU,IAAI,OAAO,IAAI,cAAc,KAAK,CAAC;AAAA,QACvG;AAAA,MACF,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AACF;AAIA,SAAS,6BACP,cACA,SACA,aACe;AACf,QAAM,cAAc,QAAQ;AAC5B,MAAI,OAAO,gBAAgB,UAAU;AACnC,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,QAAQ;AAClB,QAAI,OAAO,OAAO,iBAAiB,aAAa,eAAe;AAC/D,WAAO,QAAQ,SAAS,SAAS,WAAW;AAC1C,YAAM,aAAa,OAAO,yBAAyB,MAAM,WAAW;AACpE,UAAI,YAAY,UAAU,aAAa;AACrC,eAAO,KAAK,QAAQ;AAAA,MACtB;AACA,YAAM,SAAS,OAAO,eAAe,IAAI;AACzC,aAAO,OAAO,WAAW,aAAa,SAAS;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AAEA,MAAK,OAAO,iBAAiB,YAAY,OAAO,iBAAiB,cAAe,iBAAiB,MAAM;AACrG,WAAO;AAAA,EACT;AAEA,MAAI,YAAY,OAAO,eAAe,YAAY;AAClD,SAAO,aAAa,cAAc,OAAO,WAAW;AAClD,UAAM,aAAa,OAAO,yBAAyB,WAAW,WAAW;AACzE,QAAI,YAAY,UAAU,aAAa;AACrC,YAAM,YAAa,UAAkD,aAAa;AAClF,aAAO,aAAa;AAAA,IACtB;AACA,gBAAY,OAAO,eAAe,SAAS;AAAA,EAC7C;AACA,SAAO;AACT;AAOA,eAAe,mBAAmB,WAA2B,YAAsC;AACjG,SAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,QAAI,UAAU;AAEd,UAAM,QAAQ,WAAW,MAAM;AAC7B,UAAI,CAAC,SAAS;AACZ,kBAAU;AACV,gBAAQ,KAAK;AAAA,MACf;AAAA,IACF,GAAG,UAAU;AAEb,cAAU,QAAQ,EAAE,KAAK,MAAM;AAC7B,UAAI,CAAC,SAAS;AACZ,kBAAU;AACV,qBAAa,KAAK;AAClB,gBAAQ,IAAI;AAAA,MACd,OAAO;AAEL,kBAAU,QAAQ;AAAA,MACpB;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;AAEA,SAAS,4BAA4B,QAAsB;AACzD,MAAI,wCAAwC,OAAQ;AACpD,wCAAsC;AACtC,UAAQ,KAAK,kBAAkB,MAAM,EAAE;AACzC;AAEA,eAAe,iBAAiB,WAAiC;AAC/D,QAAM,iBAAiB,SAAS,eAAe,4BAA4B;AAC3E,SAAO,eAAe,SAAS;AACjC;AAEA,eAAe,6BACb,YACA,iBACA,2BACA,eACwC;AACxC,QAAM,CAAC,QAAQ,IAAI,IAAI,IAAI,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC/C,iBAAiB,aAAa;AAAA,IAC9B,iBAAiB,SAAS;AAAA,IAC1B,iBAAiB,SAAS;AAAA,IAC1B,iBAAiB,WAAW;AAAA,EAC9B,CAAC;AACD,QAAM,sBAAsB,KAAK,KAAK,GAAG,OAAO,GAAG,8BAA8B;AACjF,QAAM,cAAc,OAAO,WAAW,QAAQ,EAAE,OAAO,UAAU,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE;AAC5F,KAAG,UAAU,qBAAqB,EAAE,WAAW,KAAK,CAAC;AAErD,QAAM,QAAQ,KAAK,IAAI;AACvB,MAAI,iBAAiB;AAErB,SAAO,MAAM;AACX,UAAM,aAAa,KAAK,IAAI,IAAI;AAChC,UAAM,eACJ,6BAA6B,QAAQ,4BAA4B,IAAI,4BAA4B,MAAO,aAAa;AAEvH,QAAI,gBAAgB,QAAQ,gBAAgB,GAAG;AAC7C;AAAA,IACF;AAEA,aAAS,OAAO,GAAG,OAAO,iBAAiB,QAAQ;AACjD,YAAM,YAAY,KAAK,KAAK,qBAAqB,GAAG,WAAW,IAAI,OAAO,IAAI,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO;AACvG,YAAM,QAAQ,GAAG,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAEjF,UAAI;AACF,cAAM,KAAK,GAAG,SAAS,WAAW,MAAM,GAAK;AAC7C,YAAI;AACF,aAAG;AAAA,YACD;AAAA,YACA,KAAK,UAAU;AAAA,cACb;AAAA,cACA,KAAK,QAAQ;AAAA,cACb,gBAAgB;AAAA,cAChB,eAAe,KAAK,IAAI;AAAA,YAC1B,CAAC;AAAA,YACD;AAAA,UACF;AAAA,QACF,UAAE;AACA,aAAG,UAAU,EAAE;AAAA,QACjB;AACA,eAAO;AAAA,UACL,SAAS,YAAY;AACnB,gBAAI;AACF,oBAAM,MAAM,OAAO,GAAG,aAAa,WAAW,MAAM,KAAK,EAAE,EAAE,KAAK;AAClE,oBAAM,gBAAgB,MAAO,KAAK,MAAM,GAAG,IAA4B;AACvE,kBAAI,eAAe,UAAU,OAAO;AAClC,mBAAG,WAAW,SAAS;AAAA,cACzB;AAAA,YACF,QAAQ;AAAA,YAAC;AAAA,UACX;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,YAAI,EAAE,iBAAiB,UAAW,MAAgC,SAAS,UAAU;AACnF,gBAAM;AAAA,QACR;AAEA,YAAI;AACF,gBAAM,MAAM,OAAO,GAAG,aAAa,WAAW,MAAM,KAAK,EAAE,EAAE,KAAK;AAClE,gBAAM,gBAAgB,MAAO,KAAK,MAAM,GAAG,IAA0B;AACrE,gBAAM,cAAc,OAAO,eAAe,QAAQ,WAAW,cAAc,MAAM;AACjF,cAAI,eAAe,MAAM;AACvB,gBAAI;AACF,sBAAQ,KAAK,aAAa,CAAC;AAC3B;AAAA,YACF,QAAQ;AAAA,YAAC;AAAA,UACX;AAEA,gBAAM,cAAc,KAAK,IAAI,IAAI,GAAG,SAAS,SAAS,EAAE;AACxD,cAAI,eAAe,QAAQ,eAAe,4BAA4B;AACpE,eAAG,WAAW,SAAS;AAAA,UACzB;AAAA,QACF,QAAQ;AAAA,QAAC;AAAA,MACX;AAAA,IACF;AAEA,UAAM,WAAW,KAAK,IAAI,gBAAgB,gBAAgB,cAAc;AACxE,QAAI,WAAW,GAAG;AAChB,YAAM,MAAM,QAAQ;AAAA,IACtB;AACA,qBAAiB,KAAK,IAAI,iBAAiB,GAAG,GAAI;AAAA,EACpD;AAEA,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI;AAAA,MACR,gCAAgC,UAAU,YAAY,yBAAyB,YAAY,eAAe;AAAA,MAC1G,EAAE,gBAAgB,YAAY,iBAAiB,iBAAiB,6BAA6B,EAAE;AAAA,IACjG;AAAA,EACF;AAEA,SAAO;AACT;AAGA,eAAe,gBAAmB,IAAsB,YAAoB,SAA6B;AACvG,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACzC,QAAI,UAAU;AAEd,UAAM,QAAQ,WAAW,MAAM;AAC7B,UAAI,CAAC,SAAS;AACZ,kBAAU;AACV;AAAA,UACE,IAAI,kBAAkB,mBAAmB,aAAa,GAAI,cAAc,OAAO,KAAK;AAAA,YAClF,iBAAiB,aAAa;AAAA,YAC9B;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF,GAAG,UAAU;AAEb,OAAG,EAAE;AAAA,MACH,CAAC,UAAU;AACT,YAAI,CAAC,SAAS;AACZ,oBAAU;AACV,uBAAa,KAAK;AAClB,kBAAQ,KAAK;AAAA,QACf;AAAA,MACF;AAAA,MACA,CAAC,UAAU;AACT,YAAI,CAAC,SAAS;AACZ,oBAAU;AACV,uBAAa,KAAK;AAClB,iBAAO,KAAK;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,SAAS,MAAM,IAA2B;AACxC,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;",
+  "sourcesContent": ["import { createAsyncLocalStorage, type AsyncLocalStorageLike } from './async_context.js'\nimport { isNodeRuntime } from './optional_deps.js'\n\ntype SemaphoreScope = 'multiprocess' | 'global' | 'class' | 'instance'\n\ntype MultiprocessLockHandle = {\n  release: () => Promise<void>\n}\n\ntype SyncMultiprocessLockHandle = {\n  release: () => void\n}\n\ntype AnyFunction = (this: any, ...args: any[]) => any\ntype LegacyMethodDescriptor = TypedPropertyDescriptor<AnyFunction>\ntype RetryDecorator = {\n  <T extends AnyFunction>(target: T): T\n  <T extends AnyFunction>(target: T, context: ClassMethodDecoratorContext): T\n  (target: object, property_key: string | symbol, descriptor: LegacyMethodDescriptor): LegacyMethodDescriptor\n}\n\nconst MULTIPROCESS_SEMAPHORE_DIRNAME = 'browser_use_semaphores'\nconst MULTIPROCESS_STALE_LOCK_MS = 5 * 60 * 1000\n\nlet multiprocess_fallback_reason_logged: string | null = null\n\n// \u2500\u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface RetryOptions {\n  /** Total number of attempts including the initial call (1 = no retry, 3 = up to 2 retries). Default: 1 */\n  max_attempts?: number\n\n  /** Seconds to wait between retries. Default: 0 */\n  retry_after?: number\n\n  /** Multiplier applied to retry_after after each attempt for exponential backoff. Default: 1.0 (constant delay) */\n  retry_backoff_factor?: number\n\n  /** Only retry when the thrown error matches one of these matchers. Accepts error class constructors,\n   *  string error names (matched against error.name), or RegExp patterns (tested against String(error)).\n   *  Default: undefined (retry on any error) */\n  retry_on_errors?: Array<(new (...args: any[]) => Error) | string | RegExp>\n\n  /** Per-attempt timeout in seconds. Default: undefined (no per-attempt timeout) */\n  timeout?: number | null\n\n  /** Maximum concurrent executions sharing this semaphore. Default: undefined (no concurrency limit) */\n  semaphore_limit?: number | null\n\n  /** Semaphore identifier. Functions with the same name share the same concurrency slot pool. Default: function name.\n   *  If a function is provided, it receives the same arguments as the wrapped function. */\n  semaphore_name?: string | ((...args: any[]) => string) | null\n\n  /** If true, proceed without concurrency limit when semaphore acquisition times out. Default: true */\n  semaphore_lax?: boolean\n\n  /** Semaphore scoping strategy. Default: 'global'\n   *  - 'multiprocess': all processes on the machine share one semaphore (Node.js only)\n   *  - 'global': all calls share one semaphore (keyed by semaphore_name)\n   *  - 'class': all instances of the same class share one semaphore (keyed by className.semaphore_name)\n   *  - 'instance': each object instance gets its own semaphore (keyed by instanceId.semaphore_name)\n   *  'class' and 'instance' require `this` to be an object; they fall back to 'global' for standalone calls. */\n  semaphore_scope?: SemaphoreScope\n\n  /** Maximum seconds to wait for semaphore acquisition. Default: undefined \u2192 timeout * max(1, limit - 1) */\n  semaphore_timeout?: number | null\n}\n\n// \u2500\u2500\u2500 Errors \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** Thrown when a single attempt exceeds the per-attempt timeout. */\nexport class RetryTimeoutError extends Error {\n  timeout_seconds: number\n  attempt: number\n\n  constructor(message: string, params: { timeout_seconds: number; attempt: number }) {\n    super(message)\n    this.name = 'RetryTimeoutError'\n    this.timeout_seconds = params.timeout_seconds\n    this.attempt = params.attempt\n  }\n}\n\n/** Thrown (when semaphore_lax=false) if the semaphore cannot be acquired within the timeout. */\nexport class SemaphoreTimeoutError extends Error {\n  semaphore_name: string\n  semaphore_limit: number\n  timeout_seconds: number\n\n  constructor(message: string, params: { semaphore_name: string; semaphore_limit: number; timeout_seconds: number }) {\n    super(message)\n    this.name = 'SemaphoreTimeoutError'\n    this.semaphore_name = params.semaphore_name\n    this.semaphore_limit = params.semaphore_limit\n    this.timeout_seconds = params.timeout_seconds\n  }\n}\n\n// \u2500\u2500\u2500 Re-entrancy tracking via AsyncLocalStorage \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Prevents deadlocks when a retry()-wrapped function calls another retry()-wrapped\n// function that shares the same semaphore (or calls itself recursively).\n//\n// Each async call stack tracks which semaphore names it currently holds. When a\n// nested call encounters a semaphore it already holds, it skips acquisition and\n// runs directly within the parent's slot.\n//\n// Uses the same AsyncLocalStorage polyfill as the rest of abxbus (see async_context.ts)\n// so it works in Node.js and gracefully degrades to a no-op in browsers.\n\ntype ReentrantStore = Set<string>\n\n// Separate AsyncLocalStorage instance for retry re-entrancy tracking.\n// Created via the shared factory in async_context.ts (returns null in browsers).\nconst retry_context_storage: AsyncLocalStorageLike | null = createAsyncLocalStorage()\n\nfunction getHeldSemaphores(): ReentrantStore {\n  return (retry_context_storage?.getStore() as ReentrantStore | undefined) ?? new Set()\n}\n\nfunction runWithHeldSemaphores<T>(held: ReentrantStore, fn: () => T): T {\n  if (!retry_context_storage) return fn()\n  return retry_context_storage.run(held, fn)\n}\n\n// \u2500\u2500\u2500 Semaphore scope helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nlet _next_instance_id = 1\nconst _instance_ids = new WeakMap<object, number>()\n\nfunction scopedSemaphoreKey(base_name: string, scope: SemaphoreScope, context: unknown): string {\n  if (scope === 'class' && context && typeof context === 'object') {\n    return `${(context as object).constructor?.name ?? 'Object'}.${base_name}`\n  }\n  if (scope === 'instance' && context && typeof context === 'object') {\n    let id = _instance_ids.get(context as object)\n    if (id === undefined) {\n      id = _next_instance_id++\n      _instance_ids.set(context as object, id)\n    }\n    return `${id}.${base_name}`\n  }\n  return base_name\n}\n\n// \u2500\u2500\u2500 Global semaphore registry \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nclass RetrySemaphore {\n  readonly size: number\n  private inUse: number\n  private waiters: Array<() => void>\n\n  constructor(size: number) {\n    this.size = size\n    this.inUse = 0\n    this.waiters = []\n  }\n\n  tryAcquire(): boolean {\n    if (this.size === Infinity) {\n      return true\n    }\n    if (this.inUse < this.size) {\n      this.inUse += 1\n      return true\n    }\n    return false\n  }\n\n  async acquire(): Promise<void> {\n    if (this.tryAcquire()) {\n      return\n    }\n    await new Promise<void>((resolve) => {\n      this.waiters.push(resolve)\n    })\n  }\n\n  release(): void {\n    if (this.size === Infinity) {\n      return\n    }\n    const next = this.waiters.shift()\n    if (next) {\n      // Handoff: keep the permit accounted for and transfer it directly to the waiter.\n      next()\n      return\n    }\n    this.inUse = Math.max(0, this.inUse - 1)\n  }\n}\n\nconst SEMAPHORE_REGISTRY = new Map<string, RetrySemaphore>()\n\nfunction getOrCreateSemaphore(name: string, limit: number): RetrySemaphore {\n  const existing = SEMAPHORE_REGISTRY.get(name)\n  if (existing && existing.size === limit) return existing\n  const sem = new RetrySemaphore(limit)\n  SEMAPHORE_REGISTRY.set(name, sem)\n  return sem\n}\n\n/** Reset the global semaphore registry. Useful in tests. */\nexport function clearSemaphoreRegistry(): void {\n  SEMAPHORE_REGISTRY.clear()\n  multiprocess_fallback_reason_logged = null\n}\n\n// \u2500\u2500\u2500 retry() decorator / higher-order wrapper \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n//\n// Usage as a higher-order function (works on async and sync functions):\n//\n//   const fetchWithRetry = retry({ max_attempts: 3, retry_after: 1 })(async (url: string) => {\n//     return await fetch(url)\n//   })\n//\n//   const readWithRetry = retry({ max_attempts: 3, retry_after: 1 })((path: string) => {\n//     return readFileSync(path, 'utf8')\n//   })\n//\n// Usage as a TC39 Stage 3 or legacy experimental decorator on class methods:\n//\n//   class ApiClient {\n//     @retry({ max_attempts: 3, retry_after: 1 })\n//     async fetchData(): Promise<Data> { ... }\n//   }\n//\n// Usage on event bus handlers:\n//\n//   bus.on(MyEvent, retry({ max_attempts: 3 })(async (event) => {\n//     await riskyOperation(event.data)\n//   }))\n\nexport function retry(options: RetryOptions = {}): RetryDecorator {\n  const {\n    max_attempts = 1,\n    retry_after = 0,\n    retry_backoff_factor = 1.0,\n    retry_on_errors,\n    timeout,\n    semaphore_limit,\n    semaphore_name: semaphore_name_option,\n    semaphore_lax = true,\n    semaphore_scope = 'global',\n    semaphore_timeout,\n  } = options\n\n  const decorateFunction = <T extends AnyFunction>(target: T, _context?: ClassMethodDecoratorContext): T => {\n    const fn_name = target.name || (_context?.name as string) || 'anonymous'\n    const effective_max_attempts = Math.max(1, max_attempts)\n    const effective_retry_after = Math.max(0, retry_after)\n\n    const shouldRetry = (error: unknown): boolean => {\n      if (!retry_on_errors || retry_on_errors.length === 0) return true\n      return retry_on_errors.some((matcher) =>\n        typeof matcher === 'string'\n          ? (error as Error)?.name === matcher\n          : matcher instanceof RegExp\n            ? matcher.test(String(error))\n            : error instanceof matcher\n      )\n    }\n\n    const asyncRetryDelay = async (attempt: number): Promise<void> => {\n      const delay_seconds = effective_retry_after * Math.pow(retry_backoff_factor, attempt - 1)\n      if (delay_seconds > 0) {\n        await sleep(delay_seconds * 1000)\n      }\n    }\n\n    const syncRetryDelay = (attempt: number): void => {\n      const delay_seconds = effective_retry_after * Math.pow(retry_backoff_factor, attempt - 1)\n      if (delay_seconds > 0) {\n        sleepSync(delay_seconds * 1000)\n      }\n    }\n\n    const runRetryLoopFromThenable = async (\n      this_arg: any,\n      args: any[],\n      first_thenable: PromiseLike<any>,\n      first_attempt: number\n    ): Promise<any> => {\n      let current_result: any = first_thenable\n      for (let attempt = first_attempt; attempt <= effective_max_attempts; attempt++) {\n        try {\n          if (attempt !== first_attempt) {\n            current_result = target.apply(this_arg, args)\n          }\n          if (isThenable(current_result)) {\n            if (timeout != null && timeout > 0) {\n              return await _runWithTimeout(() => Promise.resolve(current_result), timeout * 1000, attempt)\n            }\n            return await current_result\n          }\n          return current_result\n        } catch (error) {\n          if (!shouldRetry(error)) throw error\n          if (attempt >= effective_max_attempts) throw error\n          await asyncRetryDelay(attempt)\n        }\n      }\n      throw new Error(`retry(${fn_name}): unexpected end of retry loop`)\n    }\n\n    async function asyncRetryWrapper(this: any, ...args: any[]): Promise<any> {\n      const base_name = typeof semaphore_name_option === 'function' ? semaphore_name_option(...args) : (semaphore_name_option ?? fn_name)\n      const sem_name = typeof base_name === 'string' ? base_name : String(base_name)\n      // \u2500\u2500 Resolve scoped semaphore key at call time (uses `this` for class/instance scopes) \u2500\u2500\n      const scoped_key = scopedSemaphoreKey(sem_name, semaphore_scope, this)\n\n      // \u2500\u2500 Check re-entrancy: skip semaphore if we already hold it in this async context \u2500\u2500\n      const held = getHeldSemaphores()\n      const needs_semaphore = semaphore_limit != null && semaphore_limit > 0\n      const is_reentrant = needs_semaphore && held.has(scoped_key)\n\n      // \u2500\u2500 Semaphore acquisition (held across all retry attempts, skipped if re-entrant) \u2500\u2500\n      let semaphore: RetrySemaphore | null = null\n      let multiprocess_lock: MultiprocessLockHandle | null = null\n      let semaphore_acquired = false\n\n      if (needs_semaphore && !is_reentrant) {\n        const effective_sem_timeout =\n          semaphore_timeout != null ? semaphore_timeout : timeout != null ? timeout * Math.max(1, semaphore_limit! - 1) : null\n\n        if (semaphore_scope === 'multiprocess') {\n          if (isNodeRuntime()) {\n            multiprocess_lock = await acquireMultiprocessSemaphore(scoped_key, semaphore_limit!, effective_sem_timeout, semaphore_lax)\n            semaphore_acquired = multiprocess_lock !== null\n          } else {\n            logMultiprocessFallbackOnce('multiprocess semaphores require a Node.js runtime; falling back to in-process global scope')\n            semaphore = getOrCreateSemaphore(scoped_key, semaphore_limit!)\n            if (effective_sem_timeout != null && effective_sem_timeout > 0) {\n              semaphore_acquired = await acquireWithTimeout(semaphore, effective_sem_timeout * 1000)\n              if (!semaphore_acquired) {\n                if (!semaphore_lax) {\n                  throw new SemaphoreTimeoutError(\n                    `Failed to acquire semaphore \"${scoped_key}\" within ${effective_sem_timeout}s (limit=${semaphore_limit})`,\n                    { semaphore_name: scoped_key, semaphore_limit: semaphore_limit!, timeout_seconds: effective_sem_timeout }\n                  )\n                }\n              }\n            } else {\n              await semaphore.acquire()\n              semaphore_acquired = true\n            }\n          }\n        } else {\n          semaphore = getOrCreateSemaphore(scoped_key, semaphore_limit!)\n\n          if (effective_sem_timeout != null && effective_sem_timeout > 0) {\n            semaphore_acquired = await acquireWithTimeout(semaphore, effective_sem_timeout * 1000)\n            if (!semaphore_acquired) {\n              if (!semaphore_lax) {\n                throw new SemaphoreTimeoutError(\n                  `Failed to acquire semaphore \"${scoped_key}\" within ${effective_sem_timeout}s (limit=${semaphore_limit})`,\n                  { semaphore_name: scoped_key, semaphore_limit: semaphore_limit!, timeout_seconds: effective_sem_timeout }\n                )\n              }\n            }\n          } else {\n            await semaphore.acquire()\n            semaphore_acquired = true\n          }\n        }\n      }\n\n      // \u2500\u2500 Build the set of held semaphores for nested calls \u2500\u2500\n      const new_held = new Set(held)\n      if (semaphore_acquired) {\n        new_held.add(scoped_key)\n      }\n\n      // \u2500\u2500 Retry loop (runs inside the semaphore and re-entrancy context) \u2500\u2500\n      const runRetryLoop = async (): Promise<any> => {\n        for (let attempt = 1; attempt <= effective_max_attempts; attempt++) {\n          try {\n            if (timeout != null && timeout > 0) {\n              return await _runWithTimeout(() => Promise.resolve(target.apply(this, args)), timeout * 1000, attempt)\n            } else {\n              return await Promise.resolve(target.apply(this, args))\n            }\n          } catch (error) {\n            if (!shouldRetry(error)) throw error\n\n            // Last attempt: rethrow\n            if (attempt >= effective_max_attempts) throw error\n\n            // Wait before next attempt with exponential backoff\n            await asyncRetryDelay(attempt)\n          }\n        }\n\n        // Unreachable, but satisfies the type checker\n        throw new Error(`retry(${fn_name}): unexpected end of retry loop`)\n      }\n\n      try {\n        return await runWithHeldSemaphores(new_held, runRetryLoop)\n      } finally {\n        if (semaphore_acquired && multiprocess_lock) {\n          await multiprocess_lock.release()\n        } else if (semaphore_acquired && semaphore) {\n          semaphore.release()\n        }\n      }\n    }\n\n    function syncRetryWrapper(this: any, ...args: any[]): any {\n      const base_name = typeof semaphore_name_option === 'function' ? semaphore_name_option(...args) : (semaphore_name_option ?? fn_name)\n      const sem_name = typeof base_name === 'string' ? base_name : String(base_name)\n      const scoped_key = scopedSemaphoreKey(sem_name, semaphore_scope, this)\n\n      const held = getHeldSemaphores()\n      const needs_semaphore = semaphore_limit != null && semaphore_limit > 0\n      const is_reentrant = needs_semaphore && held.has(scoped_key)\n\n      let semaphore: RetrySemaphore | null = null\n      let multiprocess_lock: SyncMultiprocessLockHandle | null = null\n      let semaphore_acquired = false\n\n      if (needs_semaphore && !is_reentrant) {\n        const effective_sem_timeout =\n          semaphore_timeout != null ? semaphore_timeout : timeout != null ? timeout * Math.max(1, semaphore_limit! - 1) : null\n\n        if (semaphore_scope === 'multiprocess') {\n          if (isNodeRuntime()) {\n            multiprocess_lock = acquireMultiprocessSemaphoreSync(scoped_key, semaphore_limit!, effective_sem_timeout, semaphore_lax)\n            semaphore_acquired = multiprocess_lock !== null\n          } else {\n            logMultiprocessFallbackOnce('multiprocess semaphores require a Node.js runtime; falling back to in-process global scope')\n            semaphore = getOrCreateSemaphore(scoped_key, semaphore_limit!)\n            semaphore_acquired = acquireSemaphoreSyncOrThrow(semaphore, scoped_key, semaphore_limit!, effective_sem_timeout, semaphore_lax)\n          }\n        } else {\n          semaphore = getOrCreateSemaphore(scoped_key, semaphore_limit!)\n          semaphore_acquired = acquireSemaphoreSyncOrThrow(semaphore, scoped_key, semaphore_limit!, effective_sem_timeout, semaphore_lax)\n        }\n      }\n\n      const new_held = new Set(held)\n      if (semaphore_acquired) {\n        new_held.add(scoped_key)\n      }\n\n      const release = (): void => {\n        if (semaphore_acquired && multiprocess_lock) {\n          multiprocess_lock.release()\n        } else if (semaphore_acquired && semaphore) {\n          semaphore.release()\n        }\n      }\n\n      const runRetryLoop = (): any => {\n        for (let attempt = 1; attempt <= effective_max_attempts; attempt++) {\n          const attempt_started_at = Date.now()\n          try {\n            const result = target.apply(this, args)\n            if (isThenable(result)) {\n              return runRetryLoopFromThenable(this, args, result, attempt)\n            }\n            if (timeout != null && timeout > 0 && Date.now() - attempt_started_at > timeout * 1000) {\n              throw new RetryTimeoutError(`Timed out after ${timeout}s (attempt ${attempt})`, {\n                timeout_seconds: timeout,\n                attempt,\n              })\n            }\n            return result\n          } catch (error) {\n            if (!shouldRetry(error)) throw error\n            if (attempt >= effective_max_attempts) throw error\n            syncRetryDelay(attempt)\n          }\n        }\n        throw new Error(`retry(${fn_name}): unexpected end of retry loop`)\n      }\n\n      try {\n        const result = runWithHeldSemaphores(new_held, runRetryLoop)\n        if (isThenable(result)) {\n          return Promise.resolve(result).finally(release)\n        }\n        release()\n        return result\n      } catch (error) {\n        release()\n        throw error\n      }\n    }\n\n    const retryWrapper = isAsyncFunction(target) ? asyncRetryWrapper : syncRetryWrapper\n    Object.defineProperty(retryWrapper, 'name', { value: fn_name, configurable: true })\n    if (_context?.kind === 'method' && typeof _context.addInitializer === 'function') {\n      _context.addInitializer(function (this: unknown) {\n        const owner_name = findDecoratedMethodOwnerName(this, _context, retryWrapper)\n        if (owner_name) {\n          Object.defineProperty(retryWrapper, 'name', { value: `${owner_name}.${fn_name}`, configurable: true })\n        }\n      })\n    }\n    return retryWrapper as unknown as T\n  }\n\n  function decorator<T extends AnyFunction>(\n    target: T | object,\n    context_or_property_key?: ClassMethodDecoratorContext | string | symbol,\n    descriptor?: LegacyMethodDescriptor\n  ): T | LegacyMethodDescriptor {\n    if (descriptor?.value && typeof descriptor.value === 'function') {\n      descriptor.value = decorateFunction(descriptor.value)\n      return descriptor\n    }\n    if (typeof target === 'function') {\n      return decorateFunction(target as T, typeof context_or_property_key === 'object' ? context_or_property_key : undefined)\n    }\n    throw new TypeError('retry() can only decorate functions and class methods')\n  }\n  return decorator as RetryDecorator\n}\n\n// \u2500\u2500\u2500 Internal helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction findDecoratedMethodOwnerName(\n  context_this: unknown,\n  context: ClassMethodDecoratorContext,\n  replacement: (...args: any[]) => any\n): string | null {\n  const method_name = context.name\n  if (typeof method_name !== 'string') {\n    return null\n  }\n\n  if (context.static) {\n    let ctor = typeof context_this === 'function' ? context_this : null\n    while (ctor && ctor !== Function.prototype) {\n      const descriptor = Object.getOwnPropertyDescriptor(ctor, method_name)\n      if (descriptor?.value === replacement) {\n        return ctor.name || null\n      }\n      const parent = Object.getPrototypeOf(ctor)\n      ctor = typeof parent === 'function' ? parent : null\n    }\n    return null\n  }\n\n  if ((typeof context_this !== 'object' && typeof context_this !== 'function') || context_this === null) {\n    return null\n  }\n\n  let prototype = Object.getPrototypeOf(context_this)\n  while (prototype && prototype !== Object.prototype) {\n    const descriptor = Object.getOwnPropertyDescriptor(prototype, method_name)\n    if (descriptor?.value === replacement) {\n      const ctor_name = (prototype as { constructor?: { name?: string } }).constructor?.name\n      return ctor_name || null\n    }\n    prototype = Object.getPrototypeOf(prototype)\n  }\n  return null\n}\n\nfunction isAsyncFunction(fn: AnyFunction): boolean {\n  return Object.prototype.toString.call(fn) === '[object AsyncFunction]'\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n  return (\n    (typeof value === 'object' || typeof value === 'function') && value !== null && typeof (value as { then?: unknown }).then === 'function'\n  )\n}\n\n/**\n * Try to acquire a semaphore within a timeout. Returns true if acquired, false if timed out.\n * If the semaphore is acquired after the timeout (due to the waiter remaining queued),\n * it is immediately released to avoid leaking slots.\n */\nasync function acquireWithTimeout(semaphore: RetrySemaphore, timeout_ms: number): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    let settled = false\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true\n        resolve(false)\n      }\n    }, timeout_ms)\n\n    semaphore.acquire().then(() => {\n      if (!settled) {\n        settled = true\n        clearTimeout(timer)\n        resolve(true)\n      } else {\n        // Acquired after timeout fired \u2014 release immediately to avoid slot leak\n        semaphore.release()\n      }\n    })\n  })\n}\n\nfunction acquireSemaphoreSyncOrThrow(\n  semaphore: RetrySemaphore,\n  scoped_key: string,\n  semaphore_limit: number,\n  timeout_seconds: number | null,\n  semaphore_lax: boolean\n): boolean {\n  const acquired = acquireSemaphoreSync(semaphore, timeout_seconds == null ? null : timeout_seconds * 1000)\n  if (acquired) return true\n\n  if (!semaphore_lax) {\n    throw new SemaphoreTimeoutError(`Failed to acquire semaphore \"${scoped_key}\" within ${timeout_seconds}s (limit=${semaphore_limit})`, {\n      semaphore_name: scoped_key,\n      semaphore_limit,\n      timeout_seconds: timeout_seconds ?? 0,\n    })\n  }\n  return false\n}\n\nfunction acquireSemaphoreSync(semaphore: RetrySemaphore, timeout_ms: number | null): boolean {\n  if (semaphore.tryAcquire()) return true\n\n  const start = Date.now()\n  while (true) {\n    if (timeout_ms != null && timeout_ms > 0 && Date.now() - start >= timeout_ms) {\n      return false\n    }\n    sleepSync(10)\n    if (semaphore.tryAcquire()) return true\n  }\n}\n\nfunction logMultiprocessFallbackOnce(reason: string): void {\n  if (multiprocess_fallback_reason_logged === reason) return\n  multiprocess_fallback_reason_logged = reason\n  console.warn(`[abxbus.retry] ${reason}`)\n}\n\nfunction importNodeModuleSync(specifier: string): any {\n  const maybe_process = (\n    globalThis as {\n      process?: { getBuiltinModule?: (name: string) => any }\n    }\n  ).process\n  const get_builtin_module = maybe_process?.getBuiltinModule\n  const bare_specifier = specifier.startsWith('node:') ? specifier.slice('node:'.length) : specifier\n\n  if (typeof get_builtin_module === 'function') {\n    const builtin = get_builtin_module(bare_specifier) ?? get_builtin_module(specifier)\n    if (builtin) return builtin\n  }\n\n  let require_fn: ((name: string) => any) | undefined\n  try {\n    require_fn = Function('return typeof require === \"function\" ? require : undefined')() as ((name: string) => any) | undefined\n  } catch {\n    require_fn = undefined\n  }\n  if (require_fn) return require_fn(specifier)\n\n  throw new Error('[abxbus.retry] synchronous Node.js module loading is unavailable; cannot use sync multiprocess semaphores')\n}\n\nasync function importNodeModule(specifier: string): Promise<any> {\n  const dynamic_import = Function('module_name', 'return import(module_name)') as (module_name: string) => Promise<unknown>\n  return dynamic_import(specifier) as Promise<any>\n}\n\nasync function acquireMultiprocessSemaphore(\n  scoped_key: string,\n  semaphore_limit: number,\n  semaphore_timeout_seconds: number | null,\n  semaphore_lax: boolean\n): Promise<MultiprocessLockHandle | null> {\n  const [crypto, fs, os, path] = await Promise.all([\n    importNodeModule('node:crypto'),\n    importNodeModule('node:fs'),\n    importNodeModule('node:os'),\n    importNodeModule('node:path'),\n  ])\n  const semaphore_directory = path.join(os.tmpdir(), MULTIPROCESS_SEMAPHORE_DIRNAME)\n  const lock_prefix = crypto.createHash('sha256').update(scoped_key).digest('hex').slice(0, 40)\n  fs.mkdirSync(semaphore_directory, { recursive: true })\n\n  const start = Date.now()\n  let retry_delay_ms = 100\n\n  while (true) {\n    const elapsed_ms = Date.now() - start\n    const remaining_ms =\n      semaphore_timeout_seconds != null && semaphore_timeout_seconds > 0 ? semaphore_timeout_seconds * 1000 - elapsed_ms : null\n\n    if (remaining_ms != null && remaining_ms <= 0) {\n      break\n    }\n\n    for (let slot = 0; slot < semaphore_limit; slot++) {\n      const slot_file = path.join(semaphore_directory, `${lock_prefix}.${String(slot).padStart(2, '0')}.lock`)\n      const token = `${process.pid}:${Date.now()}:${Math.random().toString(16).slice(2)}`\n\n      try {\n        const fd = fs.openSync(slot_file, 'wx', 0o600)\n        try {\n          fs.writeFileSync(\n            fd,\n            JSON.stringify({\n              token,\n              pid: process.pid,\n              semaphore_name: scoped_key,\n              created_at_ms: Date.now(),\n            }),\n            'utf8'\n          )\n        } finally {\n          fs.closeSync(fd)\n        }\n        return {\n          release: async () => {\n            try {\n              const raw = String(fs.readFileSync(slot_file, 'utf8') || '').trim()\n              const current_owner = raw ? (JSON.parse(raw) as { token?: unknown }) : null\n              if (current_owner?.token === token) {\n                fs.unlinkSync(slot_file)\n              }\n            } catch {}\n          },\n        }\n      } catch (error) {\n        if (!(error instanceof Error) || (error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw error\n        }\n\n        try {\n          const raw = String(fs.readFileSync(slot_file, 'utf8') || '').trim()\n          const current_owner = raw ? (JSON.parse(raw) as { pid?: unknown }) : null\n          const current_pid = typeof current_owner?.pid === 'number' ? current_owner.pid : null\n          if (current_pid != null) {\n            try {\n              process.kill(current_pid, 0)\n              continue\n            } catch {}\n          }\n\n          const slot_age_ms = Date.now() - fs.statSync(slot_file).mtimeMs\n          if (current_pid != null || slot_age_ms >= MULTIPROCESS_STALE_LOCK_MS) {\n            fs.unlinkSync(slot_file)\n          }\n        } catch {}\n      }\n    }\n\n    const sleep_ms = Math.min(retry_delay_ms, remaining_ms ?? retry_delay_ms)\n    if (sleep_ms > 0) {\n      await sleep(sleep_ms)\n    }\n    retry_delay_ms = Math.min(retry_delay_ms * 2, 1000)\n  }\n\n  if (!semaphore_lax) {\n    throw new SemaphoreTimeoutError(\n      `Failed to acquire semaphore \"${scoped_key}\" within ${semaphore_timeout_seconds}s (limit=${semaphore_limit})`,\n      { semaphore_name: scoped_key, semaphore_limit, timeout_seconds: semaphore_timeout_seconds ?? 0 }\n    )\n  }\n\n  return null\n}\n\nfunction acquireMultiprocessSemaphoreSync(\n  scoped_key: string,\n  semaphore_limit: number,\n  semaphore_timeout_seconds: number | null,\n  semaphore_lax: boolean\n): SyncMultiprocessLockHandle | null {\n  const crypto = importNodeModuleSync('node:crypto')\n  const fs = importNodeModuleSync('node:fs')\n  const os = importNodeModuleSync('node:os')\n  const path = importNodeModuleSync('node:path')\n  const semaphore_directory = path.join(os.tmpdir(), MULTIPROCESS_SEMAPHORE_DIRNAME)\n  const lock_prefix = crypto.createHash('sha256').update(scoped_key).digest('hex').slice(0, 40)\n  fs.mkdirSync(semaphore_directory, { recursive: true })\n\n  const start = Date.now()\n  let retry_delay_ms = 100\n\n  while (true) {\n    const elapsed_ms = Date.now() - start\n    const remaining_ms =\n      semaphore_timeout_seconds != null && semaphore_timeout_seconds > 0 ? semaphore_timeout_seconds * 1000 - elapsed_ms : null\n\n    if (remaining_ms != null && remaining_ms <= 0) {\n      break\n    }\n\n    for (let slot = 0; slot < semaphore_limit; slot++) {\n      const slot_file = path.join(semaphore_directory, `${lock_prefix}.${String(slot).padStart(2, '0')}.lock`)\n      const token = `${process.pid}:${Date.now()}:${Math.random().toString(16).slice(2)}`\n\n      try {\n        const fd = fs.openSync(slot_file, 'wx', 0o600)\n        try {\n          fs.writeFileSync(\n            fd,\n            JSON.stringify({\n              token,\n              pid: process.pid,\n              semaphore_name: scoped_key,\n              created_at_ms: Date.now(),\n            }),\n            'utf8'\n          )\n        } finally {\n          fs.closeSync(fd)\n        }\n        return {\n          release: () => {\n            try {\n              const raw = String(fs.readFileSync(slot_file, 'utf8') || '').trim()\n              const current_owner = raw ? (JSON.parse(raw) as { token?: unknown }) : null\n              if (current_owner?.token === token) {\n                fs.unlinkSync(slot_file)\n              }\n            } catch {}\n          },\n        }\n      } catch (error) {\n        if (!(error instanceof Error) || (error as NodeJS.ErrnoException).code !== 'EEXIST') {\n          throw error\n        }\n\n        try {\n          const raw = String(fs.readFileSync(slot_file, 'utf8') || '').trim()\n          const current_owner = raw ? (JSON.parse(raw) as { pid?: unknown }) : null\n          const current_pid = typeof current_owner?.pid === 'number' ? current_owner.pid : null\n          if (current_pid != null) {\n            try {\n              process.kill(current_pid, 0)\n              continue\n            } catch {}\n          }\n\n          const slot_age_ms = Date.now() - fs.statSync(slot_file).mtimeMs\n          if (current_pid != null || slot_age_ms >= MULTIPROCESS_STALE_LOCK_MS) {\n            fs.unlinkSync(slot_file)\n          }\n        } catch {}\n      }\n    }\n\n    const sleep_ms = Math.min(retry_delay_ms, remaining_ms ?? retry_delay_ms)\n    if (sleep_ms > 0) {\n      sleepSync(sleep_ms)\n    }\n    retry_delay_ms = Math.min(retry_delay_ms * 2, 1000)\n  }\n\n  if (!semaphore_lax) {\n    throw new SemaphoreTimeoutError(\n      `Failed to acquire semaphore \"${scoped_key}\" within ${semaphore_timeout_seconds}s (limit=${semaphore_limit})`,\n      { semaphore_name: scoped_key, semaphore_limit, timeout_seconds: semaphore_timeout_seconds ?? 0 }\n    )\n  }\n\n  return null\n}\n\n/** Run fn() with a timeout. Rejects with RetryTimeoutError if the timeout fires first. */\nasync function _runWithTimeout<T>(fn: () => Promise<T>, timeout_ms: number, attempt: number): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let settled = false\n\n    const timer = setTimeout(() => {\n      if (!settled) {\n        settled = true\n        reject(\n          new RetryTimeoutError(`Timed out after ${timeout_ms / 1000}s (attempt ${attempt})`, {\n            timeout_seconds: timeout_ms / 1000,\n            attempt,\n          })\n        )\n      }\n    }, timeout_ms)\n\n    fn().then(\n      (value) => {\n        if (!settled) {\n          settled = true\n          clearTimeout(timer)\n          resolve(value)\n        }\n      },\n      (error) => {\n        if (!settled) {\n          settled = true\n          clearTimeout(timer)\n          reject(error)\n        }\n      }\n    )\n  })\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\nfunction sleepSync(ms: number): void {\n  if (ms <= 0) return\n\n  const shared_array_buffer = (globalThis as { SharedArrayBuffer?: typeof SharedArrayBuffer }).SharedArrayBuffer\n  const atomics = (globalThis as { Atomics?: typeof Atomics }).Atomics\n  if (typeof shared_array_buffer === 'function' && typeof atomics?.wait === 'function') {\n    try {\n      const buffer = new shared_array_buffer(4)\n      const view = new Int32Array(buffer)\n      atomics.wait(view, 0, 0, ms)\n      return\n    } catch {}\n  }\n\n  const deadline = Date.now() + ms\n  while (Date.now() < deadline) {}\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/CoreClient.d.ts

@@ -0,0 +1,167 @@
+export declare const CORE_PROTOCOL_VERSION = 1;
+export type ProtocolEnvelope<TMessage = Record<string, unknown>> = {
+    protocol_version: number;
+    session_id: string;
+    request_id?: string;
+    last_patch_seq?: number;
+    message: TMessage;
+};
+export type CoreMessage = Record<string, unknown> & {
+    type?: string;
+};
+type FastCompletedHandlerOptions = {
+    result_is_event_reference?: boolean;
+    process_route_after?: boolean;
+    process_available_after?: boolean;
+    compact_response?: boolean;
+    include_patches?: boolean;
+};
+type ForwardEventOptions = {
+    parent_invocation_id?: string | null;
+    block_parent_completion?: boolean;
+    pause_parent_route?: boolean;
+    event_timeout?: number | null;
+    event_slow_timeout?: number | null;
+    event_concurrency?: string | null;
+    event_handler_timeout?: number | null;
+    event_handler_slow_timeout?: number | null;
+    event_handler_concurrency?: string | null;
+    event_handler_completion?: string | null;
+    event_blocks_parent_completion?: boolean | null;
+};
+export declare class RustCoreClient {
+    private static shared_named_clients;
+    private static cleanup_registered;
+    static acquireNamed(bus_name: string): RustCoreClient;
+    static releaseNamed(client: RustCoreClient, options?: {
+        stopCore?: boolean;
+    }): void;
+    private static registerProcessCleanup;
+    static stopIdleNamedClients(): void;
+    readonly session_id: string;
+    readonly command: string;
+    readonly args: string[];
+    readonly socket_path: string;
+    private process;
+    private rpc;
+    private last_patch_seq;
+    private request_seq;
+    private release_transport_timer;
+    private readonly kill_process_on_close;
+    private readonly owns_socket_path;
+    private readonly bus_name;
+    private readonly session_id_bytes;
+    constructor(options?: {
+        command?: string;
+        args?: string[];
+        session_id?: string;
+        socket_path?: string;
+        bus_name?: string;
+    });
+    request(message: CoreMessage, options?: {
+        includePatches?: boolean;
+        advancePatchSeq?: boolean;
+        advancePatchSeqWhenNoPatches?: boolean;
+    }): ProtocolEnvelope<CoreMessage>[];
+    private requestOnce;
+    requestMessages(message: CoreMessage, options?: {
+        includePatches?: boolean;
+        advancePatchSeq?: boolean;
+        advancePatchSeqWhenNoPatches?: boolean;
+    }): CoreMessage[];
+    getPatchSeq(): number;
+    setPatchSeq(last_patch_seq: number): void;
+    filterUnseenPatchMessages(messages: CoreMessage[]): CoreMessage[];
+    ackPatchMessages(messages: CoreMessage | CoreMessage[]): void;
+    registerBus(bus: Record<string, unknown>): CoreMessage[];
+    unregisterBus(bus_id: string): CoreMessage[];
+    registerHandler(handler: Record<string, unknown>): CoreMessage[];
+    importBusSnapshot(snapshot: {
+        bus: Record<string, unknown>;
+        handlers: Record<string, unknown>[];
+        events: Record<string, unknown>[];
+        pending_event_ids: string[];
+    }): CoreMessage[];
+    unregisterHandler(handler_id: string): CoreMessage[];
+    disconnectHost(host_id?: string | null): CoreMessage[];
+    closeSession(): void;
+    stopCore(): CoreMessage[];
+    emitEvent(event: Record<string, unknown>, bus_id: string, defer_start?: boolean, compact_response?: boolean, options?: {
+        parent_invocation_id?: string | null;
+        block_parent_completion?: boolean;
+        pause_parent_route?: boolean;
+    }): CoreMessage[];
+    forwardEvent(event_id: string, bus_id: string, defer_start?: boolean, compact_response?: boolean, options?: ForwardEventOptions): CoreMessage[];
+    updateEventOptions(event_id: string, options: {
+        event_handler_completion?: string | null;
+        event_blocks_parent_completion?: boolean | null;
+    }): CoreMessage[];
+    processNextRoute(bus_id: string, limit?: number | null, compact_response?: boolean): CoreMessage[];
+    waitInvocations(bus_id?: string | null, limit?: number | null): CoreMessage[];
+    waitEventCompleted(event_id: string): CoreMessage[];
+    waitEventEmitted(bus_id: string, event_pattern?: string, seen_event_ids?: string[], after_event_id?: string | null, after_created_at?: string | null): CoreMessage[];
+    waitBusIdle(bus_id: string, timeout?: number | null): boolean;
+    processRoute(route_id: string, limit?: number | null, compact_response?: boolean): CoreMessage[];
+    awaitEvent(event_id: string, parent_invocation_id?: string | null): CoreMessage[];
+    queueJumpEvent(event_id: string, parent_invocation_id: string, block_parent_completion?: boolean, pause_parent_route?: boolean): CoreMessage[];
+    getEvent(event_id: string): Record<string, unknown> | null;
+    listEvents(event_pattern?: string, limit?: number | null, bus_id?: string | null): Record<string, unknown>[];
+    listEventIds(event_pattern?: string, limit?: number | null, bus_id?: string | null, statuses?: string[] | null): string[];
+    listPendingEventIds(bus_id: string): string[];
+    completeHandler(invocation: Record<string, unknown>, value: unknown, options?: FastCompletedHandlerOptions): CoreMessage[];
+    completeHandlerNoPatches(invocation: Record<string, unknown>, value: unknown, options?: FastCompletedHandlerOptions): CoreMessage[];
+    private requestFastCompletedHandler;
+    private requestFastRegisterHandler;
+    private requestFastUnregisterHandler;
+    private requestFastQueueJumpEvent;
+    private waitFastCoreAck;
+    private waitFastCoreMessages;
+    private readFastPatchSeq;
+    private requiredString;
+    private requiredUint64;
+    completeHandlerOutcomes(outcomes: Record<string, unknown>[], options?: {
+        compact_response?: boolean;
+    }): CoreMessage[];
+    completedHandlerOutcome(value: unknown, result_is_event_reference?: boolean): CoreMessage;
+    handlerOutcomeRecord(invocation: Record<string, unknown>, outcome: CoreMessage, options?: {
+        process_available_after?: boolean;
+    }): CoreMessage;
+    errorHandler(invocation: Record<string, unknown>, error: unknown, options?: {
+        process_route_after?: boolean;
+        process_available_after?: boolean;
+        compact_response?: boolean;
+    }): CoreMessage[];
+    erroredHandlerOutcome(error: unknown): CoreMessage;
+    close(): void;
+    closeTransportOnly(options?: {
+        closeSession?: boolean;
+    }): void;
+    disconnect(): void;
+    stop(): void;
+    private cleanupFailedSpawn;
+    private connect;
+    private tryConnect;
+    private connectNamedBus;
+    private requestNamedSession;
+    private requestNamedStop;
+    private waitForNamedDaemonStopped;
+    private ensureNamedDaemon;
+    private coreProcessEnv;
+    private ensureRpc;
+    private configureRpc;
+    private closeTransport;
+    private cleanupOwnedSocketPath;
+    releaseTransportSoon(): void;
+    private sendCloseSession;
+}
+export declare const defaultCoreCommand: (socket_path: string, options?: {
+    daemon?: boolean;
+}) => {
+    command: string;
+    args: string[];
+};
+export declare const stableCoreSocketPath: (_bus_name: string) => string;
+export declare const coreNamespace: () => string;
+export declare const stableCoreSessionSocketPath: (bus_name: string) => string;
+export declare const namedCoreLockPath: (socket_path: string) => string;
+export {};