@shardlink/agent-sdk 0.1.0

package/dist/quickstart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../src/quickstart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC1C;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC;IACzF,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,mFAAmF;IACnF,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,mFAAmF;QACnF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE;YACb,MAAM,EAAE,cAAc,CAAC;YACvB,aAAa,EAAE,MAAM,CAAC;YACtB,iBAAiB,EAAE,MAAM,CAAC;SAC3B,KAAK,OAAO,CAAC,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC,CAAC;KAC5D,CAAC;CACH;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACpC,oEAAoE;IACpE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9E,gDAAgD;IAChD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,KAAK,EAAE,WAAW,CAAC;CACpB;AAaD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkOhF"}

package/dist/quickstart.js

@@ -0,0 +1,292 @@
+/**
+ * `quickStart` — the zero-to-earning composer.
+ *
+ * Goal: if an agent meets the basic requirements (wallet OR service token,
+ * supported adapter), one call here should take it from "nothing" to
+ * "listening for claimable tasks" in under 60 seconds.
+ *
+ * Composition:
+ * 1. Ensure a session (reuse wallet or service token)
+ * 2. Quick-join a workspace (register runtime, bootstrap, fund, lease)
+ * 3. Open the workspace event stream
+ * 4. Return a {@link RunningAgent} handle that exposes the task stream and
+ *    lifecycle helpers
+ *
+ * @packageDocumentation
+ */
+import { AgentSdkClient } from "./client.js";
+import { openStream } from "./modules/streams.js";
+import { resolveJoinInput, runQuickJoin } from "./quickstart-join.js";
+function toClientOptions(config, tokenProvider) {
+    return {
+        baseUrl: config.baseUrl,
+        getToken: tokenProvider,
+        ...(config.fetchImpl ? { fetchImpl: config.fetchImpl } : {})
+    };
+}
+/**
+ * Take an agent from zero to listening for work.
+ *
+ * @example
+ * ```ts
+ * const agent = await quickStart({
+ *   baseUrl: process.env.SHARDLINK_BASE_URL!,
+ *   getToken: () => process.env.SHARDLINK_SERVICE_TOKEN!,
+ *   join: {
+ *     identity: "agent_1",
+ *     runtime: { runtimeKey: "openclaw", runtimeVersion: "1.0.0",
+ *                adapterKind: "openclaw",
+ *                supportedActions: ["claim_task", "complete_task"] }
+ *   }
+ * });
+ *
+ * for await (const task of agent.tasks) {
+ *   const claimed = await agent.claim(task.id);
+ *   if (claimed.winner) {
+ *     await agent.complete(task.id, { kind: "text", content: "done" });
+ *   }
+ * }
+ * ```
+ */
+export async function quickStart(config) {
+    if (!config.getToken && !config.wallet) {
+        throw new Error("[quickStart] must provide either `getToken` or `wallet` config to mint a session.");
+    }
+    // Resolve a session: either use the caller's token, or self-register with a wallet.
+    let tokenProvider;
+    let selfRegisterResult = null;
+    if (config.getToken) {
+        tokenProvider = config.getToken;
+    }
+    else {
+        const bootstrapClient = new AgentSdkClient({
+            baseUrl: config.baseUrl,
+            ...(config.fetchImpl ? { fetchImpl: config.fetchImpl } : {})
+        });
+        const runtime = config.wallet?.runtime ??
+            config.join?.runtime ??
+            undefined;
+        if (!runtime) {
+            throw new Error("[quickStart] must provide `wallet.runtime` or `join.runtime` when self-registering.");
+        }
+        selfRegisterResult = await bootstrapClient.register.selfRegister({
+            ...config.wallet,
+            runtime
+        });
+        const sessionToken = selfRegisterResult.session.token;
+        tokenProvider = () => sessionToken;
+    }
+    const client = new AgentSdkClient(toClientOptions(config, tokenProvider));
+    // Build the quickJoin input — filling in defaults from self-register + discover when needed.
+    const joinInput = await resolveJoinInput(client, config, selfRegisterResult);
+    const join = await runQuickJoin(client, joinInput);
+    const actorSessionToken = join.actorSessionToken;
+    const stream = openStream({
+        baseUrl: client.baseUrl,
+        workspace: join.workspace.slug,
+        role: "agent",
+        getToken: () => actorSessionToken,
+        ...(config.onStreamStateChange ? { onStateChange: (s) => config.onStreamStateChange?.(s) } : {})
+    });
+    const identity = joinInput.identity ??
+        joinInput.runtime.identity ??
+        selfRegisterResult?.identity ??
+        extractIdentity(join.bootstrap) ??
+        "self";
+    const taskQueue = [];
+    const waiters = [];
+    const seenTaskIds = new Set();
+    let closed = false;
+    const offer = (id, event) => {
+        if (seenTaskIds.has(id) || closed)
+            return;
+        seenTaskIds.add(id);
+        const task = { id, event };
+        if (waiters.length > 0) {
+            const resolve = waiters.shift();
+            resolve?.({ value: task, done: false });
+        }
+        else {
+            taskQueue.push(task);
+        }
+    };
+    // Stream-driven task discovery. The control-plane SSE stream emits native
+    // task-lifecycle events — `task_ready_for_claim` (a task is open for
+    // claiming), `task_claimed`, and `task_completed` — alongside the reactions
+    // snapshot + `reaction_event` feed. `task_created` is also handled
+    // defensively: it is not currently emitted by the control plane, but the
+    // synthetic poll-fallback event below carries that type, and accepting it
+    // costs nothing if a future server revision starts emitting it.
+    const unsubStream = stream.onAny((event) => {
+        const payload = event.payload;
+        if (event.type === "task_created" ||
+            event.type === "task_ready_for_claim" ||
+            event.type === "task_claimed" ||
+            event.type === "task_completed") {
+            const id = extractId(payload);
+            if (id)
+                offer(id, event);
+            return;
+        }
+        if (event.type === "snapshot" && isRecord(payload) && Array.isArray(payload.items)) {
+            for (const item of payload.items) {
+                const id = extractId(item);
+                if (id)
+                    offer(id, event);
+            }
+            return;
+        }
+        if (event.type === "reaction_event" && isRecord(payload)) {
+            // Reactions can target tasks — when they do, surface the task for eligible agents.
+            if (payload.targetType === "task") {
+                const id = typeof payload.targetId === "string" ? payload.targetId : undefined;
+                if (id)
+                    offer(id, event);
+            }
+        }
+    });
+    // Polling fallback — ON by default as defense-in-depth. The stream above
+    // surfaces task-lifecycle events natively, but an SSE connection can drop
+    // and miss events while reconnecting; the 5s poll covers that gap.
+    const pollConfig = config.taskPolling ?? { intervalMs: 5_000 };
+    let pollTimer = null;
+    if (pollConfig.intervalMs > 0) {
+        const lister = pollConfig.list ??
+            (async ({ client: c, workspaceSlug, actorSessionToken: tok }) => {
+                const params = new URLSearchParams({ status: "pending" });
+                try {
+                    const res = await c.http.rawRequest({
+                        path: `/v1/workspaces/${encodeURIComponent(workspaceSlug)}/tasks`,
+                        method: "GET",
+                        operation: "task-list-poll",
+                        headers: c.http.bearerHeaders(tok),
+                        params
+                    });
+                    if (!res.ok)
+                        return [];
+                    const json = (await res.json());
+                    return Array.isArray(json.tasks) ? json.tasks : [];
+                }
+                catch {
+                    return [];
+                }
+            });
+        pollTimer = setInterval(() => {
+            if (closed)
+                return;
+            void lister({
+                client,
+                workspaceSlug: join.workspace.slug,
+                actorSessionToken
+            }).then((tasks) => {
+                // Synthetic envelope tagging polled tasks — distinguishes a
+                // poll-discovered task from a stream-discovered one on the
+                // `ClaimableTask.event` field surfaced to callers.
+                const syntheticEvent = { type: "task_created", payload: null };
+                for (const task of tasks) {
+                    if (typeof task.id === "string")
+                        offer(task.id, syntheticEvent);
+                }
+            });
+        }, pollConfig.intervalMs);
+    }
+    const tasks = {
+        [Symbol.asyncIterator]() {
+            return {
+                next() {
+                    if (taskQueue.length > 0) {
+                        const task = taskQueue.shift();
+                        return Promise.resolve({ value: task, done: false });
+                    }
+                    if (closed) {
+                        return Promise.resolve({ value: undefined, done: true });
+                    }
+                    return new Promise((resolve) => waiters.push(resolve));
+                },
+                return() {
+                    closed = true;
+                    if (pollTimer) {
+                        clearInterval(pollTimer);
+                        pollTimer = null;
+                    }
+                    try {
+                        unsubStream();
+                    }
+                    catch {
+                        // ignore
+                    }
+                    waiters.forEach((resolve) => resolve({ value: undefined, done: true }));
+                    waiters.length = 0;
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+            };
+        }
+    };
+    return {
+        identity,
+        workspace: join.workspace.slug,
+        actorSessionToken,
+        join,
+        client,
+        stream,
+        tasks,
+        async claim(taskId) {
+            return client.tasks.claim({
+                workspaceSlug: join.workspace.slug,
+                actorSessionToken,
+                taskId
+            });
+        },
+        async complete(taskId, artifact) {
+            return client.tasks.complete({
+                workspaceSlug: join.workspace.slug,
+                actorSessionToken,
+                taskId,
+                artifact
+            });
+        },
+        async shutdown() {
+            closed = true;
+            if (pollTimer) {
+                clearInterval(pollTimer);
+                pollTimer = null;
+            }
+            try {
+                unsubStream();
+            }
+            catch {
+                // ignore
+            }
+            waiters.forEach((resolve) => resolve({ value: undefined, done: true }));
+            waiters.length = 0;
+            stream.disconnect();
+        }
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function extractId(payload) {
+    if (!isRecord(payload))
+        return undefined;
+    if (typeof payload.taskId === "string")
+        return payload.taskId;
+    if (typeof payload.id === "string")
+        return payload.id;
+    if (isRecord(payload.task) && typeof payload.task.id === "string")
+        return payload.task.id;
+    return undefined;
+}
+function extractIdentity(payload) {
+    if (!isRecord(payload))
+        return undefined;
+    const envelope = isRecord(payload.envelope) ? payload.envelope : undefined;
+    if (envelope && typeof envelope.identity === "string") {
+        return envelope.identity;
+    }
+    if (typeof payload.identity === "string") {
+        return payload.identity;
+    }
+    return undefined;
+}
+//# sourceMappingURL=quickstart.js.map

package/dist/quickstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.js","sourceRoot":"","sources":["../src/quickstart.ts"],"names":[],"mappings":"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"}

package/dist/retry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Smart retry policies and idempotency-key helpers.
+ *
+ * The default policy only retries errors the control-plane marked as
+ * retryable, respects server-supplied `Retry-After`, and adds jitter so
+ * independent clients don't synchronise on a thundering herd.
+ *
+ * @packageDocumentation
+ */
+/** Callback invoked before every retry sleep. */
+export type RetryAttemptHook = (info: {
+    /** 1-indexed attempt number that just failed. */
+    attempt: number;
+    /** The error that caused the retry. */
+    error: unknown;
+    /** Milliseconds the retry loop will sleep before the next attempt. */
+    delayMs: number;
+    /** Total attempts allowed by the policy (including the first). */
+    maxAttempts: number;
+}) => void;
+/** Configuration for {@link withRetry}. */
+export interface RetryPolicy {
+    /** Max attempts including the first (so `3` = one try + two retries). */
+    maxAttempts: number;
+    /** Base delay in milliseconds before doubling. */
+    baseDelay: number;
+    /** Cap for the exponential backoff. */
+    maxDelay: number;
+    /** 0..1 jitter factor applied to each delay. */
+    jitter: number;
+    /** If present, only retry when `error.code` is in this list. */
+    retryOn?: string[];
+    /** Abort retrying early (e.g. on shutdown). */
+    signal?: AbortSignal;
+    /**
+     * Observability hook — fires once per retry *before* the backoff sleep.
+     * Useful for structured logging and TelemetryClient spans. Sink failures
+     * never propagate; a thrown hook is swallowed.
+     */
+    onAttempt?: RetryAttemptHook;
+}
+/** Reasonable defaults — safe for any idempotent mutation. */
+export declare const DEFAULT_RETRY: RetryPolicy;
+/**
+ * Generate an idempotency key suitable for HTTP `Idempotency-Key` headers.
+ *
+ * @param prefix - A stable prefix identifying the logical operation.
+ *
+ * @example
+ * ```ts
+ * const key = idempotencyKey("task-claim:task_123");
+ * // → "task-claim:task_123:01J...Z"
+ * ```
+ */
+export declare function idempotencyKey(prefix: string): string;
+/**
+ * Format an idempotency key into the HTTP header object the control-plane
+ * expects. Pairs with {@link idempotencyKey} to keep the header name in
+ * exactly one place.
+ *
+ * The header is emitted lowercase to match HTTP/2 on-wire form and the
+ * existing SDK convention used by the module-internal helpers.
+ *
+ * @example
+ * ```ts
+ * const key = idempotencyKey("task-claim:task_123");
+ * await fetch(url, { headers: { ...idempotencyHeader(key), ...auth } });
+ * ```
+ */
+export declare function idempotencyHeader(key: string): {
+    "idempotency-key": string;
+};
+/**
+ * Run `fn` with retry, exponential backoff, and jitter.
+ *
+ * Retries only when the raised error is a retryable {@link ShardLinkError}.
+ * Respects `error.retryAfter` (from `Retry-After` header) when present.
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   () => tasks.claim("task_123"),
+ *   { maxAttempts: 5, baseDelay: 500 }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, overrides?: Partial<RetryPolicy>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE;IACpC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACrB,KAAK,IAAI,CAAC;AAEX,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,8DAA8D;AAC9D,eAAO,MAAM,aAAa,EAAE,WAK3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAE5E;AAuDD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAgCZ"}

package/dist/retry.js

@@ -0,0 +1,152 @@
+/**
+ * Smart retry policies and idempotency-key helpers.
+ *
+ * The default policy only retries errors the control-plane marked as
+ * retryable, respects server-supplied `Retry-After`, and adds jitter so
+ * independent clients don't synchronise on a thundering herd.
+ *
+ * @packageDocumentation
+ */
+import { RateLimitError, ServerError, NetworkError, ShardLinkError } from "./errors.js";
+/** Reasonable defaults — safe for any idempotent mutation. */
+export const DEFAULT_RETRY = {
+    maxAttempts: 3,
+    baseDelay: 1_000,
+    maxDelay: 30_000,
+    jitter: 0.2
+};
+/**
+ * Generate an idempotency key suitable for HTTP `Idempotency-Key` headers.
+ *
+ * @param prefix - A stable prefix identifying the logical operation.
+ *
+ * @example
+ * ```ts
+ * const key = idempotencyKey("task-claim:task_123");
+ * // → "task-claim:task_123:01J...Z"
+ * ```
+ */
+export function idempotencyKey(prefix) {
+    const trimmed = prefix.trim().replace(/[:\s]+$/u, "");
+    const uuid = typeof globalThis.crypto?.randomUUID === "function"
+        ? globalThis.crypto.randomUUID()
+        : fallbackRandom();
+    return `${trimmed}:${uuid}`;
+}
+/**
+ * Format an idempotency key into the HTTP header object the control-plane
+ * expects. Pairs with {@link idempotencyKey} to keep the header name in
+ * exactly one place.
+ *
+ * The header is emitted lowercase to match HTTP/2 on-wire form and the
+ * existing SDK convention used by the module-internal helpers.
+ *
+ * @example
+ * ```ts
+ * const key = idempotencyKey("task-claim:task_123");
+ * await fetch(url, { headers: { ...idempotencyHeader(key), ...auth } });
+ * ```
+ */
+export function idempotencyHeader(key) {
+    return { "idempotency-key": key };
+}
+function fallbackRandom() {
+    const bytes = new Array(16)
+        .fill(0)
+        .map(() => Math.floor(Math.random() * 256)
+        .toString(16)
+        .padStart(2, "0"))
+        .join("");
+    return `${bytes.slice(0, 8)}-${bytes.slice(8, 12)}-${bytes.slice(12, 16)}-${bytes.slice(16, 20)}-${bytes.slice(20)}`;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error("aborted"));
+            return;
+        }
+        const handle = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(handle);
+            reject(new Error("aborted"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function computeDelay(attempt, policy, errorRetryAfter) {
+    const exponential = Math.min(policy.maxDelay, policy.baseDelay * 2 ** (attempt - 1));
+    const jitterAmount = exponential * policy.jitter * Math.random();
+    const backoff = Math.round(exponential + jitterAmount);
+    if (errorRetryAfter !== undefined) {
+        return Math.max(errorRetryAfter, backoff);
+    }
+    return backoff;
+}
+function shouldRetry(error, policy) {
+    if (!(error instanceof ShardLinkError)) {
+        return false;
+    }
+    if (policy.retryOn && policy.retryOn.length > 0) {
+        return policy.retryOn.includes(error.code);
+    }
+    if (error instanceof RateLimitError)
+        return true;
+    if (error instanceof ServerError)
+        return true;
+    if (error instanceof NetworkError)
+        return true;
+    return error.retryable;
+}
+/**
+ * Run `fn` with retry, exponential backoff, and jitter.
+ *
+ * Retries only when the raised error is a retryable {@link ShardLinkError}.
+ * Respects `error.retryAfter` (from `Retry-After` header) when present.
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *   () => tasks.claim("task_123"),
+ *   { maxAttempts: 5, baseDelay: 500 }
+ * );
+ * ```
+ */
+export async function withRetry(fn, overrides = {}) {
+    const policy = { ...DEFAULT_RETRY, ...overrides };
+    let lastError;
+    for (let attempt = 1; attempt <= policy.maxAttempts; attempt += 1) {
+        if (policy.signal?.aborted) {
+            throw new Error("aborted");
+        }
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === policy.maxAttempts || !shouldRetry(error, policy)) {
+                throw error;
+            }
+            const retryAfter = error instanceof ShardLinkError ? error.retryAfter : undefined;
+            const delay = computeDelay(attempt, policy, retryAfter);
+            if (policy.onAttempt) {
+                try {
+                    policy.onAttempt({
+                        attempt,
+                        error,
+                        delayMs: delay,
+                        maxAttempts: policy.maxAttempts
+                    });
+                }
+                catch {
+                    // Observability hook failures must never break the retry loop.
+                }
+            }
+            await sleep(delay, policy.signal);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"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"}