@agentsgot/agent-kit 0.0.0-stage → 1.0.0

package/dist/runner.js

@@ -0,0 +1,292 @@
+import { randomSalt, testReportIdempotencyKey, } from "./sdk/client.js";
+const ROLE_OF = {
+    executor: "executor",
+    tester: "tester",
+    arbitrator: "arbitrator",
+    publisher: "publisher",
+    any: "any",
+};
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function httpStatus(error) {
+    const value = error?.status;
+    return typeof value === "number" ? value : null;
+}
+/** Re-send a transaction for the same duty only after this long (the indexer may lag). */
+export const RESEND_AFTER_MS = 10 * 60_000;
+/** A deadline closer than this raises a deadline_warning event. */
+export const DEADLINE_WARNING_MS = 6 * 3600_000;
+/**
+ * Next-actions driven runner for one or more roles. Each `tick()` pulls
+ * GET /agents/me/next-actions, handles items for the enabled roles in priority order and returns
+ * a sanitized report. Transactions are only surfaced as intents unless `autoSend` is on.
+ */
+export class RoleRunner {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    wants(item) {
+        const role = ROLE_OF[item.role];
+        return role === "any" || this.options.roles.includes(role);
+    }
+    async tick(now = new Date()) {
+        const report = {
+            asOf: now.toISOString(),
+            roles: this.options.roles,
+            expedited: false,
+            handled: [],
+            events: [],
+            warnings: [],
+        };
+        const next = await this.options.client.getNextActions();
+        report.warnings.push(...next.warnings);
+        const items = next.items.filter((item) => this.wants(item));
+        report.expedited = items.some((item) => item.priority <= 1);
+        for (const item of items) {
+            if (item.deadline && new Date(item.deadline).getTime() - now.getTime() < DEADLINE_WARNING_MS)
+                this.event(report, item, "deadline_warning", `${item.kind} due ${item.deadline}`);
+            try {
+                report.handled.push(await this.handle(item, report, next.address));
+            }
+            catch (error) {
+                report.handled.push(this.result(item, "error", message(error)));
+            }
+        }
+        return report;
+    }
+    result(item, outcome, detail, extra = {}) {
+        return {
+            kind: item.kind,
+            subjectId: item.subject.id,
+            taskId: item.taskId,
+            outcome,
+            detail,
+            ...extra,
+        };
+    }
+    event(report, item, type, detail) {
+        report.events.push({ type, subjectId: item.subject.id, taskId: item.taskId, detail });
+    }
+    /** Send (autoSend) or surface a transaction intent; de-duplicates resends per duty. */
+    async transact(item, report, tx, detail, key = `tx:${item.kind}:${item.subject.id}`) {
+        const { checkpoints, client } = this.options;
+        const previous = await checkpoints.get(key);
+        if (previous && Date.now() - new Date(previous.sentAt).getTime() < RESEND_AFTER_MS)
+            return this.result(item, "skipped", `already sent ${previous.txHash}; waiting for indexer`, {
+                txHash: previous.txHash,
+            });
+        const permissionless = item.kind === "TRIGGER";
+        if (!this.options.autoSend || (permissionless && !this.options.sendTriggers)) {
+            this.event(report, item, "tx_pending_approval", detail);
+            return this.result(item, "pending-tx", detail, { pendingTx: tx });
+        }
+        try {
+            const txHash = await client.sendTransaction(tx);
+            await checkpoints.set(key, { txHash, sentAt: new Date().toISOString() });
+            return this.result(item, "done", detail, { txHash });
+        }
+        catch (error) {
+            this.event(report, item, "tx_failed", `${detail}: ${message(error)}`);
+            throw error;
+        }
+    }
+    /** Executor duty right after signing: commit, then reveal the tester draw. */
+    async drawTesters(item, report, taskId) {
+        const { client } = this.options;
+        if (item.kind !== "TESTER_DRAW_REVEAL") {
+            try {
+                await client.commitTesterDraw(taskId);
+            }
+            catch (error) {
+                // 409 = already committed (e.g. a previous tick); continue to reveal.
+                if (httpStatus(error) !== 409)
+                    throw error;
+            }
+        }
+        try {
+            const draw = await client.revealTesterDraw(taskId);
+            this.event(report, item, "testers_drawn", `testers: ${draw.testers.join(", ")}`);
+            return this.result(item, "done", `drew ${draw.testers.length} testers`);
+        }
+        catch (error) {
+            if (httpStatus(error) === 409)
+                return this.result(item, "skipped", "seed block not mined yet; reveal on next tick");
+            throw error;
+        }
+    }
+    async handle(item, report, principalAddress) {
+        const { client, handlers = {} } = this.options;
+        const taskId = item.taskId;
+        const id = item.subject.id;
+        switch (item.kind) {
+            case "CLAIM_HEARTBEAT": {
+                await client.heartbeatClaim(id);
+                return this.result(item, "done", "claim lease renewed");
+            }
+            case "SUBMIT_DELIVERY": {
+                if (!handlers.produceWork || !taskId)
+                    return this.result(item, "skipped", "no produceWork handler; deliver manually");
+                const work = await handlers.produceWork(await client.getTask(taskId));
+                const signed = await client.submitWork({
+                    claimId: id,
+                    files: work.files,
+                    ...(work.evidence === undefined ? {} : { evidence: work.evidence }),
+                    idempotencyKey: `delivery:${id}`,
+                });
+                this.event(report, item, "delivery_signed", `submission ${signed.id}`);
+                return this.drawTesters(item, report, taskId);
+            }
+            case "SIGN_DELIVERY":
+                await client.signDelivery(id);
+                this.event(report, item, "delivery_signed", `submission ${id}`);
+                return taskId
+                    ? this.drawTesters(item, report, taskId)
+                    : this.result(item, "done", "delivery signed");
+            case "TESTER_DRAW_COMMIT":
+            case "TESTER_DRAW_REVEAL":
+                if (!taskId)
+                    return this.result(item, "skipped", "missing taskId");
+                return this.drawTesters(item, report, taskId);
+            case "SUBMIT_TEST_REPORT": {
+                if (!taskId)
+                    return this.result(item, "skipped", "missing taskId");
+                const retest = /retest/iu.test(item.hint);
+                const seen = await this.options.checkpoints.get(`assigned:${id}`);
+                if (!seen) {
+                    this.event(report, item, "assigned_as_tester", retest ? `retest seat ${id}` : `submission ${id}`);
+                    await this.options.checkpoints.set(`assigned:${id}`, true);
+                }
+                if (!handlers.evaluateDelivery)
+                    return this.result(item, "skipped", "no evaluateDelivery handler; evaluate manually");
+                const task = await client.getTask(taskId);
+                const evaluation = await handlers.evaluateDelivery({ task, submissionId: id });
+                const expected = task.specification?.criteria.map((criterion) => criterion.id) ?? [];
+                const covered = new Set(evaluation.criteria.map((criterion) => criterion.criterionId));
+                const missing = expected.filter((criterionId) => !covered.has(criterionId));
+                if (missing.length > 0)
+                    return this.result(item, "error", `evaluation misses criteria: ${missing.join(", ")}`);
+                const submitted = await client.submitTestReport({
+                    taskId,
+                    submissionId: id,
+                    approved: evaluation.approved,
+                    criteria: evaluation.criteria,
+                    summary: evaluation.summary,
+                    idempotencyKey: retest
+                        ? `retest-report:${taskId}:${id}`
+                        : testReportIdempotencyKey(taskId, id),
+                });
+                this.event(report, item, "report_submitted", `report ${submitted.id}`);
+                return this.result(item, "done", `${retest ? "retest " : ""}report ${submitted.id} approved=${evaluation.approved}`);
+            }
+            case "SUBMIT_FALLBACK_REPORT": {
+                if (!handlers.evaluateDispute)
+                    return this.result(item, "skipped", "no evaluateDispute handler; review manually");
+                const evaluation = await handlers.evaluateDispute(await client.getDispute(id));
+                const intent = await client.createFallbackReportIntent(id, evaluation);
+                return this.transact(item, report, intent.tx, "submitFallbackReport");
+            }
+            case "POST_RESULT": {
+                if (!taskId)
+                    return this.result(item, "skipped", "missing taskId");
+                try {
+                    const intent = await client.getFinalResult(taskId);
+                    return this.transact(item, report, intent.tx, "postResult");
+                }
+                catch (error) {
+                    if (httpStatus(error) === 409)
+                        return this.result(item, "skipped", `not yet postable: ${message(error)}`);
+                    throw error;
+                }
+            }
+            case "APPEAL_DECISION": {
+                if (!taskId)
+                    return this.result(item, "skipped", "missing taskId");
+                const task = await client.getTask(taskId);
+                if (!handlers.decideAppeal) {
+                    this.event(report, item, "appeal_decision_needed", "verify the posted result; waiveAppeal if no objection, else openAppeal");
+                    return this.result(item, "skipped", "no decideAppeal handler; verify the result and call waive_appeal or open_appeal");
+                }
+                const decision = await handlers.decideAppeal({
+                    task,
+                    address: principalAddress.toLowerCase(),
+                });
+                if (decision.action === "waive") {
+                    const intent = await client.waiveAppeal(taskId);
+                    return this.transact(item, report, intent.tx, "waiveAppeal");
+                }
+                const intent = await client.openAppeal(taskId, { statement: decision.statement });
+                this.event(report, item, "appeal_decision_needed", decision.statement);
+                this.event(report, item, "tx_pending_approval", "openAppeal requires explicit user approval");
+                return this.result(item, "pending-tx", "openAppeal intent ready; send after user approval", {
+                    pendingTx: intent.tx,
+                });
+            }
+            case "REVIEW_RESULT": {
+                if (!taskId)
+                    return this.result(item, "skipped", "missing taskId");
+                this.event(report, item, "review_required", `review before ${item.deadline}`);
+                if (!handlers.reviewResult)
+                    return this.result(item, "skipped", "awaiting the publisher's accept/reject decision");
+                const decision = await handlers.reviewResult(await client.getTask(taskId));
+                const review = await client.reviewTask(taskId, decision);
+                return this.transact(item, report, review.tx, decision.accept ? "accept" : "reject");
+            }
+            case "CONFIRM_ARBITRATION_SEAT": {
+                this.event(report, item, "arbitration_case", `confirm seat before ${item.deadline}`);
+                const intent = await client.confirmArbitrationSeat(id);
+                return this.transact(item, report, intent.tx, "confirm arbitration seat");
+            }
+            case "COMMIT_ARBITRATION_VOTE":
+                return this.commitVote(item, report);
+            case "REVEAL_ARBITRATION_VOTE":
+                return this.revealVote(item, report);
+            case "CLAIM_REWARDS": {
+                const scheduleIds = item.request.body?.scheduleIds ?? [];
+                this.event(report, item, "rewards_claimable", item.hint);
+                const intent = await client.createRewardClaim(scheduleIds);
+                return this.transact(item, report, intent.tx, "claim rewards");
+            }
+            case "TRIGGER": {
+                const calldata = item.trigger?.calldata;
+                if (!calldata)
+                    return this.result(item, "skipped", "trigger without calldata");
+                return this.transact(item, report, calldata, item.hint);
+            }
+        }
+        return this.result(item, "skipped", "unknown action");
+    }
+    async commitVote(item, report) {
+        const { client, checkpoints, handlers = {} } = this.options;
+        const caseId = item.subject.id;
+        const key = `vote:${caseId}`;
+        let vote = await checkpoints.get(key);
+        if (!vote) {
+            if (!handlers.judgeDispute)
+                return this.result(item, "skipped", "no judgeDispute handler; judge the case manually");
+            const votes = await handlers.judgeDispute(await client.getDispute(caseId));
+            vote = { caseId, salt: randomSalt(), votes };
+            // Persist salt + votes before anything is sent: losing them makes reveal impossible.
+            await checkpoints.set(key, vote);
+        }
+        const intent = await client.createArbitrationVoteIntent(caseId, vote.votes, vote.salt);
+        const handled = await this.transact(item, report, intent.commitTx, "commit vote");
+        if (handled.outcome === "done")
+            this.event(report, item, "vote_committed", caseId);
+        return handled;
+    }
+    async revealVote(item, report) {
+        const { client, checkpoints } = this.options;
+        const caseId = item.subject.id;
+        const vote = await checkpoints.get(`vote:${caseId}`);
+        if (!vote)
+            return this.result(item, "error", "no persisted salt for this case; reveal needs the exact salt and votes used at commit");
+        const intent = await client.createArbitrationVoteIntent(caseId, vote.votes, vote.salt);
+        const handled = await this.transact(item, report, intent.revealTx, "reveal vote");
+        if (handled.outcome === "done")
+            this.event(report, item, "vote_revealed", caseId);
+        return handled;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/schedules.d.ts

@@ -0,0 +1,34 @@
+import type { Role } from "./roles.js";
+export interface RoleSchedule {
+    /** Job name used by `agentsgot run`, the skills and checkpoints. */
+    name: string;
+    /** "interval" jobs run every `everySeconds`; "event" jobs run as soon as a next-action appears. */
+    trigger: "interval" | "event";
+    everySeconds: number;
+    /** Cadence while a deadline-bearing duty is in its last 20% (expedited mode): half the interval. */
+    expeditedSeconds: number;
+    /** Whether the job can produce a caller-paid transaction (sent only with --auto-send). */
+    onChain: boolean;
+    description: string;
+}
+export interface ScheduleRuntime {
+    /** Backend runtime claimHeartbeatTimeoutSeconds (also the online window). Default 1800. */
+    claimHeartbeatTimeoutSeconds?: number;
+    /** Status report interval; `--report-interval`. Default 3600. */
+    reportIntervalSeconds?: number;
+}
+/** Safety rule: never poll slower than 1/6 of the window the job protects. */
+export declare function safeInterval(preferredSeconds: number, windowSeconds?: number): number;
+/** Jobs for one role: the common ones plus the role-specific ones. */
+export declare function roleSchedules(role: Role, runtime?: ScheduleRuntime): RoleSchedule[];
+/** Union of schedules for several roles, de-duplicated by name (shortest interval wins). */
+export declare function mergedSchedules(roles: readonly Role[], runtime?: ScheduleRuntime): RoleSchedule[];
+export type DeadlineMode = "normal" | "target-passed" | "expedited" | "overdue";
+/**
+ * Where `now` falls inside a [start, deadline] window: past 50% = submission target passed,
+ * last 20% = expedited (poll at half interval, report immediately), past the end = overdue.
+ */
+export declare function deadlineMode(start: Date, deadline: Date, now: Date): DeadlineMode;
+/** Interval to use for a job given whether any duty is in expedited mode. */
+export declare function effectiveInterval(schedule: RoleSchedule, expedited: boolean): number;
+//# sourceMappingURL=schedules.d.ts.map

package/dist/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../src/schedules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,gBAAgB,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrF;AAuID,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,eAAoB,GAAG,YAAY,EAAE,CAMvF;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,GAAE,eAAoB,GAC5B,YAAY,EAAE,CAkBhB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,eAAe,GAAG,WAAW,GAAG,SAAS,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,YAAY,CAOjF;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAEpF"}

package/dist/schedules.js

@@ -0,0 +1,116 @@
+import { defaultParams } from "#shared/params";
+const p = defaultParams;
+const HOUR = 3600;
+/** Safety rule: never poll slower than 1/6 of the window the job protects. */
+export function safeInterval(preferredSeconds, windowSeconds) {
+    if (!windowSeconds)
+        return preferredSeconds;
+    return Math.max(30, Math.min(preferredSeconds, Math.floor(windowSeconds / 6)));
+}
+function job(name, preferredSeconds, description, options = {}) {
+    const everySeconds = safeInterval(preferredSeconds, options.window);
+    return {
+        name,
+        trigger: options.trigger ?? "interval",
+        everySeconds,
+        expeditedSeconds: Math.max(30, Math.floor(everySeconds / 2)),
+        onChain: options.onChain ?? false,
+        description,
+    };
+}
+function common(runtime) {
+    const online = runtime.claimHeartbeatTimeoutSeconds ?? 1800;
+    return [
+        job("presence", 600, "POST /agents/heartbeat so the network counts the agent online.", {
+            window: online,
+        }),
+        job("next-actions", 300, "GET /agents/me/next-actions and dispatch items by kind."),
+        job("status-report", runtime.reportIntervalSeconds ?? HOUR, "Write a sanitized status report (terminal, ~/.agentsgot/reports, optional webhook)."),
+    ];
+}
+function rewards() {
+    return job("rewards", 6 * HOUR, "Check task reward schedules and daily mining allocations separately; claim each with its own endpoint in batches of up to 100.", { onChain: true });
+}
+function receivesDailyEmission(role) {
+    return role === "executor" || role === "tester" || role === "arbitrator";
+}
+function byRole(role, runtime) {
+    const lease = runtime.claimHeartbeatTimeoutSeconds ?? 1800;
+    switch (role) {
+        case "executor":
+            return [
+                job("scan-tasks", 300, "Scan PUBLISHED/RUNNING tasks; claim only after user approval or a matching auto-claim rule."),
+                job("claim-heartbeat", 300, "POST /claims/{id}/heartbeat before leaseExpiresAt.", {
+                    window: lease,
+                }),
+                job("after-sign", 60, "Right after the delivery is signed: commit + reveal the tester draw (no waiting).", { trigger: "event" }),
+                job("progress", 900, "Own tasks: build postResult once testers reported; SETTLE_TASK after the review window.", { onChain: true, window: p.publisherReviewHours * HOUR }),
+            ];
+        case "tester":
+            return [
+                job("assignments", 120, "Poll for TesterAssigned and appeal-retest seats (event-driven with a webhook).", {
+                    window: p.testerReportWindowHours * HOUR,
+                }),
+                job("evaluate", 120, `Evaluate immediately (including retest seats); submit by 50% of the ${p.testerReportWindowHours}h / appealRetestHours window, expedite after 80%.`, { trigger: "event" }),
+                job("stake-watch", HOUR, `Stake still >= ${p.testerMinStakeAgt} AGT, still in pool, lock/cooldown state.`),
+            ];
+        case "arbitrator":
+            return [
+                job("cases", 300, "GET /arbitrator/cases.", { window: p.arbAcceptWindowHours * HOUR }),
+                job("confirm", 300, `Report each new case to the user; confirm within ${p.arbAcceptWindowHours}h after approval.`, { trigger: "event", onChain: true, window: p.arbAcceptWindowHours * HOUR }),
+                job("commit", HOUR, `Commit in the first half of the ${p.arbCommitWindowHours}h window; salt persisted locally.`, { trigger: "event", onChain: true, window: p.arbCommitWindowHours * HOUR }),
+                job("reveal", 600, `Reveal as soon as the ${p.arbRevealWindowHours}h window opens (early once every seat has committed); retry every 10 min (unrevealed = ${p.missedRevealSlashBps / 100}% slash).`, { trigger: "event", onChain: true, window: p.arbRevealWindowHours * HOUR }),
+                job("stake-watch", HOUR, `Stake >= ${p.arbitratorMinStakeAgt} AGT, response rate >= ${p.arbResponseRateMinBps / 100}%, suspension or debt.`),
+            ];
+        case "publisher":
+            return [
+                job("review", HOUR, `Remind the user to accept/reject RESULT_POSTED tasks within ${p.publisherReviewHours}h (again at 6h left).`, { onChain: true, window: p.publisherReviewHours * HOUR }),
+                job("maintenance", 24 * HOUR, "Check tasks in the maintenance period."),
+            ];
+    }
+}
+/** Jobs for one role: the common ones plus the role-specific ones. */
+export function roleSchedules(role, runtime = {}) {
+    return [
+        ...common(runtime),
+        ...(receivesDailyEmission(role) ? [rewards()] : []),
+        ...byRole(role, runtime),
+    ];
+}
+/** Union of schedules for several roles, de-duplicated by name (shortest interval wins). */
+export function mergedSchedules(roles, runtime = {}) {
+    const merged = new Map();
+    for (const role of roles)
+        for (const entry of roleSchedules(role, runtime)) {
+            const existing = merged.get(entry.name);
+            merged.set(entry.name, existing
+                ? {
+                    ...existing,
+                    everySeconds: Math.min(existing.everySeconds, entry.everySeconds),
+                    expeditedSeconds: Math.min(existing.expeditedSeconds, entry.expeditedSeconds),
+                    onChain: existing.onChain || entry.onChain,
+                }
+                : entry);
+        }
+    return [...merged.values()];
+}
+/**
+ * Where `now` falls inside a [start, deadline] window: past 50% = submission target passed,
+ * last 20% = expedited (poll at half interval, report immediately), past the end = overdue.
+ */
+export function deadlineMode(start, deadline, now) {
+    const total = deadline.getTime() - start.getTime();
+    const elapsed = now.getTime() - start.getTime();
+    if (total <= 0 || elapsed >= total)
+        return "overdue";
+    if (elapsed >= total * 0.8)
+        return "expedited";
+    if (elapsed >= total * 0.5)
+        return "target-passed";
+    return "normal";
+}
+/** Interval to use for a job given whether any duty is in expedited mode. */
+export function effectiveInterval(schedule, expedited) {
+    return expedited ? schedule.expeditedSeconds : schedule.everySeconds;
+}
+//# sourceMappingURL=schedules.js.map

package/dist/schedules.js.map

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

package/dist/sdk/base64.d.ts

@@ -0,0 +1,4 @@
+/** Base64 helpers for Node and browsers alike (the SDK does not depend on Buffer). */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(value: string): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=base64.d.ts.map

package/dist/sdk/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/sdk/base64.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAKvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAKpE"}

package/dist/sdk/base64.js

@@ -0,0 +1,15 @@
+/** Base64 helpers for Node and browsers alike (the SDK does not depend on Buffer). */
+export function bytesToBase64(bytes) {
+    let binary = "";
+    for (let offset = 0; offset < bytes.length; offset += 0x8000)
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
+    return btoa(binary);
+}
+export function base64ToBytes(value) {
+    const binary = atob(value.replace(/\s/gu, ""));
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1)
+        bytes[index] = binary.charCodeAt(index);
+    return bytes;
+}
+//# sourceMappingURL=base64.js.map

package/dist/sdk/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/sdk/base64.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,MAAM;QAC1D,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;QAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/F,OAAO,KAAK,CAAC;AACf,CAAC"}