@rohankumar4179/engram-sdk 0.0.0-stage → 0.2.0

package/dist/mind.js

@@ -0,0 +1,193 @@
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { MoveAnchorer, WalrusBlobAnchorer } from "./anchor.js";
+import { Engram } from "./engram.js";
+import { servicesFromEnv } from "./env.js";
+import { GeminiLLM } from "./llm.js";
+import { InMemoryRemote, WalrusMemoryRemote } from "./remote.js";
+import { TatumSui } from "./tatum.js";
+import { DEFAULT_SERVER, readLink, removeLink, startLink, syncLink, waitForLink } from "./link.js";
+/**
+ * The high-level API: one object for an agent's memory.
+ *
+ * ```ts
+ * const mind = engram({ agent: "money-ops" });
+ * const agent = mind.wrap(myAgent);         // beliefs in, signed receipts out
+ * mind.observe({ source: "tatum", data: tx });
+ * await mind.sleep();                       // episodes → beliefs
+ * await mind.commit("weekly");              // Merkle root → Walrus → Sui
+ * await mind.beliefs({ about: "rent" });
+ * mind.at("2026-10-25");                    // time travel
+ * mind.forget("ep_…");                      // provable forgetting
+ * await mind.verify("r_…");                 // proof check
+ * ```
+ */
+export class Mind {
+    llmFactory;
+    context;
+    core;
+    llmInstance;
+    constructor(core, llmFactory, context) {
+        this.llmFactory = llmFactory;
+        this.context = context;
+        this.core = core;
+    }
+    get agent() {
+        return this.core.agent;
+    }
+    /** Records an episode (encrypted with its own key). */
+    observe(input) {
+        return this.core.observe(input);
+    }
+    /** Consolidates new episodes into beliefs with the configured LLM. */
+    sleep(opts = {}) {
+        this.llmInstance ??= this.llmFactory();
+        return this.core.sleep({ llm: this.llmInstance, context: opts.context ?? this.context, batchSize: opts.batchSize });
+    }
+    /**
+     * Signs and stores a snapshot of the current beliefs, anchored on Sui. If the
+     * agent is linked to a dashboard, the new history is synced too (a failed
+     * sync never fails the commit; see `lastSyncError`).
+     */
+    async commit(message) {
+        const c = await this.core.commit(message);
+        if (readLink(this.core)) {
+            try {
+                await this.sync();
+                this.lastSyncError = null;
+            }
+            catch (err) {
+                this.lastSyncError = err.message;
+            }
+        }
+        return c;
+    }
+    /** Why the last automatic sync after commit failed, if it did. */
+    lastSyncError = null;
+    /**
+     * Links this agent to an Engram web app account (a Sui wallet). `onCode`
+     * gets the code and URL to show the owner; resolves once they approve.
+     */
+    async link(opts) {
+        const server = opts.server ?? DEFAULT_SERVER;
+        const start = await startLink(this.core, server, opts.label);
+        opts.onCode(start);
+        return waitForLink(this.core, start, server);
+    }
+    /** Uploads the audit bundle to the linked dashboard (verified there before it's shown). */
+    sync() {
+        return syncLink(this.core);
+    }
+    get linked() {
+        return readLink(this.core);
+    }
+    unlink() {
+        return removeLink(this.core);
+    }
+    /**
+     * Current beliefs. With `about`, the most relevant ones (Walrus Memory
+     * semantic recall, keyword fallback offline).
+     */
+    async beliefs(opts = {}) {
+        if (!opts.about)
+            return this.core.beliefs().slice(0, opts.limit ?? Infinity);
+        return this.core.relevant(opts.about, opts.limit ?? 5);
+    }
+    /** Beliefs as they were at a commit, `HEAD~n`, or a date ("2026-10-25"). */
+    at(ref) {
+        return this.core.beliefsAt(ref);
+    }
+    /** Destroys an episode's key; dependent beliefs are retracted or revised. */
+    forget(episodeId, reason) {
+        return this.core.forget(episodeId, reason);
+    }
+    /** Verifies a receipt (`r_…`) or a commit (id, `HEAD`, date) end to end. */
+    verify(ref, opts = {}) {
+        const o = opts.offline ? { walrus: false, chain: false } : {};
+        return ref.startsWith("r_") ? this.core.verifyReceipt(ref, o) : this.core.verifyCommit(ref, o);
+    }
+    log() {
+        return this.core.head() ? this.core.log() : [];
+    }
+    diff(from, to) {
+        return this.core.diff(from, to);
+    }
+    blame(belief) {
+        return this.core.blame(belief);
+    }
+    receipts() {
+        return this.core.receipts();
+    }
+    /**
+     * Wraps an existing agent function. Each call: the relevant committed
+     * beliefs are passed in, the agent runs, and a signed receipt records what it
+     * decided and which beliefs it relied on.
+     *
+     * ```ts
+     * const agent = mind.wrap(async (tx, beliefs) => decide(tx, beliefs), {
+     *   used: (out) => out.beliefIds,
+     * });
+     * const decision = await agent(tx);
+     * agent.lastReceipt; // r_…
+     * ```
+     */
+    wrap(fn, opts = {}) {
+        const json = (v) => (typeof v === "string" ? v : JSON.stringify(v));
+        const wrapped = (async (input) => {
+            if (opts.observe !== false) {
+                this.core.observe(typeof opts.observe === "function" ? opts.observe(input) : { source: "agent", data: input });
+            }
+            const res = await this.core.act({ query: opts.query?.(input) ?? json(input).slice(0, 500), input, limit: opts.limit ?? 6 }, async (beliefs) => {
+                const out = await fn(input, beliefs);
+                return {
+                    action: (opts.action?.(out, input) ?? json(out)).slice(0, 2000),
+                    used: opts.used ? opts.used(out, beliefs) : beliefs.map((b) => b.id),
+                    result: out,
+                };
+            });
+            wrapped.lastReceipt = res.receipt;
+            return res.result;
+        });
+        wrapped.lastReceipt = null;
+        return wrapped;
+    }
+}
+/** Opens (or creates) an agent's memory. See {@link EngramConfig}. */
+export function engram(cfg) {
+    const env = cfg.env ?? process.env;
+    const fromEnv = servicesFromEnv(env);
+    const dir = resolve(cfg.dir ?? ".");
+    const remote = cfg.walrus === "memory"
+        ? new InMemoryRemote()
+        : cfg.walrus && "putMany" in cfg.walrus
+            ? cfg.walrus
+            : cfg.walrus
+                ? new WalrusMemoryRemote({ key: cfg.walrus.key, accountId: cfg.walrus.accountId, serverUrl: cfg.walrus.serverUrl })
+                : fromEnv.remote;
+    const tatum = cfg.tatum ? new TatumSui({ apiKey: cfg.tatum.apiKey }) : fromEnv.tatum;
+    // A Walrus Memory account given in the config (not "memory", not a ready remote).
+    const account = typeof cfg.walrus === "object" && !("putMany" in cfg.walrus) ? cfg.walrus : undefined;
+    const blobAnchorer = account && tatum ? new WalrusBlobAnchorer(tatum, account.accountId) : undefined;
+    let anchorer;
+    if (cfg.anchor && "check" in cfg.anchor)
+        anchorer = cfg.anchor;
+    else if (cfg.anchor === false || cfg.walrus === "memory")
+        anchorer = undefined;
+    else if (cfg.anchor)
+        anchorer = new MoveAnchorer({ ...cfg.anchor, tatum, blobAnchorer: blobAnchorer ?? fromEnv.anchorer });
+    else
+        anchorer = blobAnchorer ?? fromEnv.anchorer;
+    const llmFactory = () => {
+        if (cfg.llm && "json" in cfg.llm)
+            return cfg.llm;
+        if (cfg.llm)
+            return new GeminiLLM({ apiKeys: cfg.llm.gemini, model: cfg.llm.model });
+        return fromEnv.llm();
+    };
+    const opts = { dir, remote, anchorer };
+    const core = existsSync(join(dir, ".engram", "config.json")) ? Engram.open(opts) : Engram.init(cfg.agent, opts);
+    if (core.agent !== cfg.agent)
+        throw new Error(`${dir} holds agent "${core.agent}", not "${cfg.agent}"`);
+    return new Mind(core, llmFactory, cfg.context);
+}
+//# sourceMappingURL=mind.js.map

package/dist/mind.js.map

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

package/dist/proof.d.ts

@@ -0,0 +1,21 @@
+import { MerkleTree } from "./merkle.js";
+import type { Belief, CommitManifest, MerkleProofStep } from "./types.js";
+/**
+ * Leaf for one belief version. Commits to everything that matters about it —
+ * change a word, the confidence or the evidence, and the root changes.
+ */
+export declare function beliefLeaf(b: Belief): string;
+/** Leaf recording that an episode was forgotten, so forgetting is itself part of the proof. */
+export declare function tombstoneLeaf(episodeId: string): string;
+export interface CommitTree {
+    tree: MerkleTree;
+    /** "belief:b_x@2" / "tombstone:ep_1", in leaf order */
+    labels: string[];
+}
+/** Leaves sorted by label, so the same belief set always gives the same root. */
+export declare function buildCommitTree(beliefs: Belief[], tombstones: string[]): CommitTree;
+export declare function proofFor(ct: CommitTree, beliefKey: string): MerkleProofStep[];
+export declare function verifyBeliefProof(b: Belief, proof: MerkleProofStep[], root: string): boolean;
+/** Commit ID = sha256 of the canonical manifest. */
+export declare function commitId(m: CommitManifest): string;
+export declare function verifyManifestSignature(m: CommitManifest, signature: string): boolean;

package/dist/proof.js

@@ -0,0 +1,46 @@
+import { canonical, sha256Hex, verifySignature } from "./crypto.js";
+import { MerkleTree, verifyProof } from "./merkle.js";
+/**
+ * Leaf for one belief version. Commits to everything that matters about it —
+ * change a word, the confidence or the evidence, and the root changes.
+ */
+export function beliefLeaf(b) {
+    return sha256Hex(canonical({
+        k: "belief",
+        id: b.id,
+        version: b.version,
+        statement: sha256Hex(b.statement),
+        confidence: b.confidence,
+        evidence: new MerkleTree([...b.evidence].sort().map((e) => sha256Hex(e))).root,
+        tags: [...b.tags].sort(),
+    }));
+}
+/** Leaf recording that an episode was forgotten, so forgetting is itself part of the proof. */
+export function tombstoneLeaf(episodeId) {
+    return sha256Hex(canonical({ k: "tombstone", episode: episodeId }));
+}
+/** Leaves sorted by label, so the same belief set always gives the same root. */
+export function buildCommitTree(beliefs, tombstones) {
+    const entries = [
+        ...beliefs.map((b) => ({ label: `belief:${b.id}@${b.version}`, leaf: beliefLeaf(b) })),
+        ...tombstones.map((t) => ({ label: `tombstone:${t}`, leaf: tombstoneLeaf(t) })),
+    ].sort((a, b) => (a.label < b.label ? -1 : a.label > b.label ? 1 : 0));
+    return { tree: new MerkleTree(entries.map((e) => e.leaf)), labels: entries.map((e) => e.label) };
+}
+export function proofFor(ct, beliefKey) {
+    const i = ct.labels.indexOf(`belief:${beliefKey}`);
+    if (i < 0)
+        throw new Error(`belief ${beliefKey} is not in this commit`);
+    return ct.tree.proof(i);
+}
+export function verifyBeliefProof(b, proof, root) {
+    return verifyProof(beliefLeaf(b), proof, root);
+}
+/** Commit ID = sha256 of the canonical manifest. */
+export function commitId(m) {
+    return sha256Hex(canonical(m));
+}
+export function verifyManifestSignature(m, signature) {
+    return verifySignature(canonical(m), signature, m.agentPubKey);
+}
+//# sourceMappingURL=proof.js.map

package/dist/proof.js.map

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

package/dist/remote.d.ts

@@ -0,0 +1,112 @@
+export interface RemoteHit {
+    blobId: string;
+    text: string;
+    distance: number;
+}
+/**
+ * Durable remote for Engram objects. The real one is Walrus Memory;
+ * tests use the in-memory one.
+ */
+export interface RemoteMemory {
+    /** Stores each text and returns its Walrus blob ID, in order. */
+    putMany(items: {
+        namespace: string;
+        text: string;
+    }[]): Promise<string[]>;
+    /**
+     * `deep`: also look where cheap search can't (e.g. Walrus Memory manual-mode
+     * records) — for verification, which needs one exact record.
+     */
+    search(namespace: string, query: string, limit?: number, opts?: SearchOptions): Promise<RemoteHit[]>;
+}
+export interface SearchOptions {
+    deep?: boolean;
+}
+export interface WalrusMemoryConfig {
+    key: string;
+    accountId: string;
+    serverUrl?: string;
+    /**
+     * Manual-mode fallback: when the relayer's own embedding service fails, Engram
+     * embeds locally, Seal-encrypts with the account owner's key and has the relayer
+     * only store the ciphertext + vector. Reads use the same path.
+     */
+    manual?: ManualModeConfig;
+}
+export interface ManualModeConfig {
+    /** Account owner's Sui private key (suiprivkey1…) — Seal encrypt/decrypt. */
+    suiPrivateKey: string;
+    /** Text → embedding vector (1536 dims, like the relayer's own). */
+    embed: (text: string) => Promise<number[]>;
+    /** Walrus Memory Move package and AccountRegistry (mainnet defaults). */
+    packageId?: string;
+    registryId?: string;
+    /** Sui client for Seal and Walrus reads (a gRPC client works). */
+    suiClient: unknown;
+}
+/** Walrus Memory on Sui Mainnet (read from the account object and its creating transaction). */
+export declare const MEMWAL_MAINNET: {
+    packageId: string;
+    registryId: string;
+};
+export declare class WalrusMemoryRemote implements RemoteMemory {
+    private cfg;
+    private client;
+    private manualClient?;
+    /** Until when writes go straight to manual mode after a relayer failure. */
+    private manualUntil;
+    /** Set when the last write used the manual fallback (for logs and the UI). */
+    lastWriteMode: "relayer" | "manual";
+    constructor(cfg: WalrusMemoryConfig);
+    private manual;
+    putMany(items: {
+        namespace: string;
+        text: string;
+    }[]): Promise<string[]>;
+    private putManual;
+    private putRelayer;
+    /**
+     * Relayer recall first. Manual-mode recall (embed locally, decrypt here) runs
+     * when the relayer fails, or for a deep search — it is slower and only sees
+     * records written in manual mode. Results are merged by blob ID.
+     */
+    search(namespace: string, query: string, limit?: number, opts?: SearchOptions): Promise<RemoteHit[]>;
+    health(): Promise<boolean>;
+}
+/** Offline stand-in. Blob IDs are sha256 of the text, base64url. */
+export declare class InMemoryRemote implements RemoteMemory {
+    readonly items: {
+        namespace: string;
+        text: string;
+        blobId: string;
+    }[];
+    putMany(items: {
+        namespace: string;
+        text: string;
+    }[]): Promise<string[]>;
+    search(namespace: string, query: string, limit?: number): Promise<RemoteHit[]>;
+}
+/**
+ * Writes go to `primary`; searches merge `primary` and `secondary`. Used when an
+ * agent moves to its owner's own Walrus Memory account: older memories stay
+ * readable (and verifiable) in the account they were written to.
+ */
+export declare class CombinedRemote implements RemoteMemory {
+    readonly primary: RemoteMemory;
+    readonly secondary: RemoteMemory;
+    constructor(primary: RemoteMemory, secondary: RemoteMemory);
+    putMany(items: {
+        namespace: string;
+        text: string;
+    }[]): Promise<string[]>;
+    search(namespace: string, query: string, limit?: number, opts?: SearchOptions): Promise<RemoteHit[]>;
+}
+/**
+ * The relayer limits each key to 60 weighted requests a minute and answers 429
+ * with retry_after_seconds; it also has brief 5xx hiccups. Wait and retry
+ * instead of failing.
+ */
+export declare function relayerRetry<T>(fn: () => Promise<T>, opts?: {
+    attempts?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<T>;

package/dist/remote.js

@@ -0,0 +1,232 @@
+import { MemWal } from "@mysten-incubation/memwal";
+import { MemWalManual } from "@mysten-incubation/memwal/manual";
+import { sha256Bytes } from "./crypto.js";
+/** Walrus Memory on Sui Mainnet (read from the account object and its creating transaction). */
+export const MEMWAL_MAINNET = {
+    packageId: "0xe7c16fbea0560e7057e2bf7422feaa4fb313749fc69c9e9092fac7a33b81d7f5",
+    registryId: "0x8bf82c9e09e36b8d1c38298f68b7cb68e7b8762887e7592add9986d5e9cf199f",
+};
+/** Errors that mean the relayer's server-side pipeline is down (not our request). */
+const RELAYER_DOWN = /embedding|internal error|internal server error|\b5\d\d\b|unavailable|timed? ?out/i;
+export class WalrusMemoryRemote {
+    cfg;
+    client;
+    manualClient;
+    /** Until when writes go straight to manual mode after a relayer failure. */
+    manualUntil = 0;
+    /** Set when the last write used the manual fallback (for logs and the UI). */
+    lastWriteMode = "relayer";
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.client = MemWal.create({
+            key: cfg.key,
+            accountId: cfg.accountId,
+            serverUrl: cfg.serverUrl ?? "https://relayer.memory.walrus.xyz",
+            requestTimeoutMs: 60_000,
+        });
+    }
+    manual() {
+        const m = this.cfg.manual;
+        if (!m)
+            return undefined;
+        if (!this.manualClient) {
+            this.manualClient = MemWalManual.create({
+                key: this.cfg.key,
+                accountId: this.cfg.accountId,
+                serverUrl: this.cfg.serverUrl ?? "https://relayer.memory.walrus.xyz",
+                suiPrivateKey: m.suiPrivateKey,
+                suiClient: m.suiClient,
+                embeddingApiKey: "local", // embedding is done by m.embed below
+                packageId: m.packageId ?? MEMWAL_MAINNET.packageId,
+                registryId: m.registryId ?? MEMWAL_MAINNET.registryId,
+            });
+            // The SDK only knows OpenAI-style embedding APIs; use ours instead.
+            this.manualClient.embed = m.embed;
+        }
+        return this.manualClient;
+    }
+    async putMany(items) {
+        if (items.length === 0)
+            return [];
+        const manual = this.manual();
+        if (manual && Date.now() < this.manualUntil)
+            return this.putManual(manual, items);
+        try {
+            const ids = await this.putRelayer(items);
+            this.lastWriteMode = "relayer";
+            return ids;
+        }
+        catch (err) {
+            if (!manual || !RELAYER_DOWN.test(err.message))
+                throw err;
+            this.manualUntil = Date.now() + 10 * 60_000;
+            return this.putManual(manual, items);
+        }
+    }
+    async putManual(manual, items) {
+        const out = [];
+        // Three at a time keeps Seal key servers and the embedder within rate limits.
+        for (let i = 0; i < items.length; i += 3) {
+            const batch = items.slice(i, i + 3);
+            const res = await Promise.all(batch.map((it) => relayerRetry(() => manual.rememberManual(it.text, it.namespace))));
+            for (const r of res) {
+                if (!r.blob_id)
+                    throw new Error("Walrus Memory manual write returned no blob ID");
+                out.push(r.blob_id);
+            }
+        }
+        this.lastWriteMode = "manual";
+        return out;
+    }
+    async putRelayer(items) {
+        const out = [];
+        // Keep batches small so one slow item doesn't hold up everything.
+        for (let i = 0; i < items.length; i += 20) {
+            const batch = items.slice(i, i + 20);
+            const res = await relayerRetry(() => this.client.rememberBulkAndWait(batch, { timeoutMs: 300_000 }));
+            batch.forEach((_, j) => {
+                const r = res.results[j];
+                if (!r || r.status !== "done" || !r.blob_id) {
+                    throw new Error(`Walrus Memory write failed: ${r?.error ?? r?.status ?? "no result"}`);
+                }
+                out.push(r.blob_id);
+            });
+        }
+        return out;
+    }
+    /**
+     * Relayer recall first. Manual-mode recall (embed locally, decrypt here) runs
+     * when the relayer fails, or for a deep search — it is slower and only sees
+     * records written in manual mode. Results are merged by blob ID.
+     */
+    async search(namespace, query, limit = 10, opts = {}) {
+        const manual = this.manual();
+        let auto = [];
+        let autoErr = null;
+        try {
+            const res = await relayerRetry(() => this.client.recall({ query, limit, namespace }));
+            auto = res.results.map((r) => ({ blobId: r.blob_id, text: r.text, distance: r.distance }));
+        }
+        catch (err) {
+            autoErr = err;
+        }
+        if (!manual || (!autoErr && !opts.deep)) {
+            if (autoErr)
+                throw autoErr;
+            return auto;
+        }
+        let man = [];
+        try {
+            man = await quietSealLogs(() => manual.recallManual(query, { limit, namespace })).then((res) => res.results.flatMap((r) => ("text" in r ? [{ blobId: r.blob_id, text: r.text, distance: r.distance }] : [])));
+        }
+        catch (err) {
+            if (autoErr)
+                throw autoErr;
+        }
+        const merged = new Map();
+        for (const r of [...auto, ...man]) {
+            const prev = merged.get(r.blobId);
+            if (!prev || r.distance < prev.distance)
+                merged.set(r.blobId, r);
+        }
+        return [...merged.values()].sort((x, y) => x.distance - y.distance).slice(0, limit);
+    }
+    async health() {
+        return (await this.client.health()).status === "ok";
+    }
+}
+/** Offline stand-in. Blob IDs are sha256 of the text, base64url. */
+export class InMemoryRemote {
+    items = [];
+    async putMany(items) {
+        return items.map((it) => {
+            const blobId = Buffer.from(sha256Bytes(Buffer.from(it.namespace + "\n" + it.text))).toString("base64url");
+            this.items.push({ ...it, blobId });
+            return blobId;
+        });
+    }
+    async search(namespace, query, limit = 10) {
+        const words = query.toLowerCase().split(/\W+/).filter(Boolean);
+        return this.items
+            .filter((i) => i.namespace === namespace)
+            .map((i) => {
+            const t = i.text.toLowerCase();
+            const hits = words.filter((w) => t.includes(w)).length;
+            return { blobId: i.blobId, text: i.text, distance: words.length ? 1 - hits / words.length : 1 };
+        })
+            .sort((a, b) => a.distance - b.distance)
+            .slice(0, limit);
+    }
+}
+/**
+ * Writes go to `primary`; searches merge `primary` and `secondary`. Used when an
+ * agent moves to its owner's own Walrus Memory account: older memories stay
+ * readable (and verifiable) in the account they were written to.
+ */
+export class CombinedRemote {
+    primary;
+    secondary;
+    constructor(primary, secondary) {
+        this.primary = primary;
+        this.secondary = secondary;
+    }
+    putMany(items) {
+        return this.primary.putMany(items);
+    }
+    async search(namespace, query, limit = 10, opts) {
+        const [a, b] = await Promise.allSettled([this.primary.search(namespace, query, limit, opts), this.secondary.search(namespace, query, limit, opts)]);
+        if (a.status === "rejected" && b.status === "rejected")
+            throw a.reason;
+        const merged = new Map();
+        for (const h of [...(a.status === "fulfilled" ? a.value : []), ...(b.status === "fulfilled" ? b.value : [])]) {
+            const prev = merged.get(h.blobId);
+            if (!prev || h.distance < prev.distance)
+                merged.set(h.blobId, h);
+        }
+        return [...merged.values()].sort((x, y) => x.distance - y.distance).slice(0, limit);
+    }
+}
+/**
+ * Manual recall tries to decrypt every hit in the namespace, including records
+ * written by the relayer under a different Seal identity; the SDK logs each of
+ * those expected failures. Keep them out of the agent's output.
+ */
+async function quietSealLogs(fn) {
+    const orig = console.error;
+    console.error = (...args) => {
+        if (typeof args[0] === "string" && args[0].startsWith("[MemWalManual]"))
+            return;
+        orig(...args);
+    };
+    try {
+        return await fn();
+    }
+    finally {
+        console.error = orig;
+    }
+}
+/**
+ * The relayer limits each key to 60 weighted requests a minute and answers 429
+ * with retry_after_seconds; it also has brief 5xx hiccups. Wait and retry
+ * instead of failing.
+ */
+export async function relayerRetry(fn, opts = {}) {
+    const attempts = opts.attempts ?? 4;
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    for (let i = 0;; i++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const msg = String(err.message ?? err);
+            const limited = /\b429\b|rate limit/i.test(msg);
+            // Transient server errors (the relayer has been flaky) get a short backoff too.
+            const transient = /\b50[0234]\b|internal server error|ECONNRESET|fetch failed/i.test(msg);
+            if (i + 1 >= attempts || (!limited && !transient))
+                throw err;
+            const after = limited ? Number(/retry_after_seconds"?\s*:\s*(\d+)/.exec(msg)?.[1] ?? 30) : 5 * (i + 1);
+            await sleep(Math.min(after, 90) * 1000 + 500);
+        }
+    }
+}
+//# sourceMappingURL=remote.js.map

package/dist/remote.js.map

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