agental 0.1.0 → 0.2.0

package/dist/http.js

@@ -1,246 +0,0 @@
-import { AgentalError, ApiError, ConnectionError, ProxyError } from "./errors.js";
-import { VERSION } from "./version.js";
-export const DEFAULT_BASE_URL = "https://agental.io";
-/** How long a sandbox_migrating is waited out: a move of a running sandbox takes a minute or two. */
-const MIGRATING_TRIES = 18;
-const runtime = () => globalThis.process;
-function environment(name) {
-    const value = runtime()?.env?.[name];
-    return value?.trim() || undefined;
-}
-/**
- * What every request says it is, where the runtime lets it: agental-typescript/0.1.0. A
- * browser sends its own User-Agent, and asked for another it would ask the API first whether
- * it may, so in a browser none is set.
- */
-function userAgent() {
-    const inBrowser = typeof globalThis.window !== "undefined" || typeof globalThis.importScripts === "function";
-    return inBrowser ? {} : { "User-Agent": `agental-typescript/${VERSION}` };
-}
-const sameApi = (left, right) => left.replace(/\/+$/, "") === right.replace(/\/+$/, "");
-/**
- * The key and the API the agental command signed in with on this computer, kept in
- * ~/.config/agental/credentials.json (or under XDG_CONFIG_HOME). Nothing where there is no
- * such file, or no file system, as in a browser.
- */
-function signedIn() {
-    const fs = runtime()?.getBuiltinModule?.("node:fs");
-    const os = runtime()?.getBuiltinModule?.("node:os");
-    const path = runtime()?.getBuiltinModule?.("node:path");
-    if (!fs || !os || !path) {
-        return undefined;
-    }
-    try {
-        const base = environment("XDG_CONFIG_HOME") ?? path.join(environment("HOME") ?? os.homedir(), ".config");
-        const saved = JSON.parse(fs.readFileSync(path.join(base, "agental", "credentials.json"), "utf8"));
-        return typeof saved["apiUrl"] === "string" && typeof saved["apiKey"] === "string" ? { apiUrl: saved["apiUrl"], apiKey: saved["apiKey"] } : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-export function sleep(ms, signal) {
-    return new Promise((resolve, reject) => {
-        if (signal?.aborted) {
-            reject(signal.reason);
-            return;
-        }
-        const timer = setTimeout(() => {
-            signal?.removeEventListener("abort", stopped);
-            resolve();
-        }, ms);
-        const stopped = () => {
-            clearTimeout(timer);
-            reject(signal?.reason);
-        };
-        signal?.addEventListener("abort", stopped, { once: true });
-    });
-}
-/** Sends requests to the API, and sends again the ones that are safe to. */
-export class Http {
-    pollIntervalMs;
-    apiKey;
-    baseUrl;
-    fetch;
-    maxRetries;
-    retryDelayMs;
-    constructor(options = {}) {
-        let apiKey = options.apiKey ?? environment("AGENTAL_API_KEY");
-        let baseUrl = options.baseUrl ?? environment("AGENTAL_API_URL");
-        if (!apiKey) {
-            // The agental command's sign-in, for the API it was made to and no other.
-            const saved = signedIn();
-            if (saved && (baseUrl === undefined || sameApi(baseUrl, saved.apiUrl))) {
-                apiKey = saved.apiKey;
-                baseUrl = saved.apiUrl;
-            }
-        }
-        if (!apiKey) {
-            throw new AgentalError("No API key. Pass apiKey, or set AGENTAL_API_KEY, or sign in on this computer with npx agental@latest. Keys are made in the console, under API keys.");
-        }
-        this.apiKey = apiKey;
-        this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-        this.fetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
-        this.maxRetries = options.maxRetries ?? 3;
-        this.retryDelayMs = options.retryDelayMs ?? 1000;
-        this.pollIntervalMs = options.pollIntervalMs ?? 2000;
-    }
-    /** The answer to a request that worked. One that did not is thrown, after it was sent again if that was safe. */
-    async send(call) {
-        const query = new URLSearchParams();
-        for (const [name, value] of Object.entries(call.query ?? {})) {
-            if (typeof value === "string") {
-                query.set(name, value);
-            }
-            else if (value !== undefined) {
-                for (const one of value) {
-                    query.append(name, one);
-                }
-            }
-        }
-        const url = `${this.baseUrl}${call.path}${query.size > 0 ? `?${query}` : ""}`;
-        const init = {
-            method: call.method,
-            headers: {
-                Authorization: `Bearer ${this.apiKey}`,
-                Accept: "application/json",
-                ...userAgent(),
-                ...(call.body === undefined ? {} : { "Content-Type": "application/json" }),
-                ...call.headers,
-            },
-            ...(call.body === undefined ? {} : { body: JSON.stringify(call.body) }),
-            ...(call.signal ? { signal: call.signal } : {}),
-        };
-        for (let attempt = 0;; attempt += 1) {
-            let failure;
-            try {
-                const response = await this.fetch(url, init);
-                if (response.ok) {
-                    return response;
-                }
-                failure = await errorOf(response);
-            }
-            catch (error) {
-                if (call.signal?.aborted) {
-                    throw error;
-                }
-                failure = new ConnectionError(`Could not reach ${this.baseUrl}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-            }
-            const wait = this.waitBefore(failure, attempt, call.replay === true);
-            if (wait === null) {
-                throw failure;
-            }
-            await sleep(wait, call.signal);
-        }
-    }
-    /** The JSON a request was answered with, and the status and headers it came with. */
-    async json(call) {
-        const response = await this.send(call);
-        return { status: response.status, body: (await response.json()), headers: response.headers };
-    }
-    /** The server-sent events a request is answered with, each as it arrives. */
-    async *events(call) {
-        const response = await this.send({ ...call, headers: { ...call.headers, Accept: "text/event-stream" } });
-        if (!response.body) {
-            return;
-        }
-        const reader = response.body.getReader();
-        const decoder = new TextDecoder();
-        let buffered = "";
-        try {
-            for (;;) {
-                const { value, done } = await reader.read();
-                if (done) {
-                    return;
-                }
-                buffered = (buffered + decoder.decode(value, { stream: true })).replaceAll("\r\n", "\n");
-                // A blank line ends an event.
-                for (let end = buffered.indexOf("\n\n"); end >= 0; end = buffered.indexOf("\n\n")) {
-                    const lines = buffered.slice(0, end).split("\n");
-                    buffered = buffered.slice(end + 2);
-                    const field = (name) => lines
-                        .filter((line) => line.startsWith(`${name}:`))
-                        .map((line) => line.slice(name.length + 1).replace(/^ /, ""))
-                        .join("\n");
-                    const event = field("event");
-                    if (event) {
-                        yield { event, data: parsed(field("data")) };
-                    }
-                }
-            }
-        }
-        finally {
-            await reader.cancel().catch(() => undefined);
-        }
-    }
-    /**
-     * How long to wait before a failed request is sent again, or null when it is not to be.
-     * The waits are the ones the API asks for: a request cut off by a move is sent again at
-     * once, a move under way is waited out, and a proxy or a failing host is given ten times
-     * the shortest wait. Only a request that may be sent twice is sent again, except one the
-     * API turned away as it restarted: nothing was done with that one, a command neither.
-     */
-    waitBefore(failure, attempt, replay) {
-        if (failure instanceof ApiError && failure.code === "restarting") {
-            return attempt < this.maxRetries ? this.retryDelayMs : null;
-        }
-        if (!replay) {
-            return null;
-        }
-        if (failure instanceof ApiError) {
-            if (failure.code === "sandbox_migrating") {
-                return attempt < MIGRATING_TRIES ? this.retryDelayMs * 10 : null;
-            }
-            if (failure.code === "sandbox_moved") {
-                return attempt < this.maxRetries ? this.retryDelayMs : null;
-            }
-            if (failure.code === "host_error" || failure.code === "internal_error") {
-                return attempt < 1 ? this.retryDelayMs * 10 : null;
-            }
-            return null;
-        }
-        if (attempt >= this.maxRetries) {
-            return null;
-        }
-        if (failure instanceof ProxyError) {
-            return failure.status >= 500 ? this.retryDelayMs * 10 : null;
-        }
-        return failure instanceof ConnectionError ? this.retryDelayMs * 2 ** attempt : null;
-    }
-}
-function parsed(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return text;
-    }
-}
-/** The API's own error when the answer has a code and a message in it, and a proxy's when it has not. */
-async function errorOf(response) {
-    const body = parsed(await response.text().catch(() => ""));
-    const error = body && typeof body === "object" ? body.error : null;
-    if (error && typeof error === "object") {
-        const { code, message, regionsWithRoom, feeMicros, retryAfterSeconds } = error;
-        if (typeof code === "string" && typeof message === "string") {
-            const regions = Array.isArray(regionsWithRoom) ? regionsWithRoom.filter((one) => typeof one === "string") : undefined;
-            const burst = {
-                ...(typeof feeMicros === "number" ? { feeMicros } : {}),
-                ...(typeof retryAfterSeconds === "number" || retryAfterSeconds === null ? { retryAfterSeconds } : {}),
-            };
-            return new ApiError(response.status, code, message, regions, burst);
-        }
-    }
-    return new ProxyError(response.status);
-}
-/**
- * A tag as a part of a path: lowercased and trimmed as the API would, and refused here when it
- * is not one, so that no word, "..", say, can make the path another.
- */
-export function tagSegment(tag) {
-    const word = tag.trim().toLowerCase();
-    if (!/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/.test(word)) {
-        throw new AgentalError(`A tag is lowercase letters, digits and hyphens, 1 to 63 characters, not starting or ending with a hyphen, not ${JSON.stringify(tag)}.`);
-    }
-    return word;
-}

package/dist/index.d.ts

@@ -1,10 +0,0 @@
-export { Agental } from "./client.js";
-export { AgentalError, ApiError, ConnectionError, ProxyError, TimeoutError } from "./errors.js";
-export type { BurstRefusalCode } from "./errors.js";
-export type { AgentalOptions } from "./http.js";
-export { Browser, Commands, Desktop, Email, Files, Sandbox, Schedules, Ssh } from "./sandbox.js";
-export { Secrets, Template, Templates } from "./template.js";
-export type { TemplateChanges } from "./template.js";
-export type { BurstOptions, CommandLine, CreateOptions, DesktopButton, ExecEvent, ExecOptions, SandboxChanges, ScreenshotOptions, SendEmailOptions, StartOptions, StopOptions, WaitOptions } from "./sandbox.js";
-export type { AccountEmail, ApiKey, ApiKeyAction, ApiKeyPreset, ApiKeyUsage, Billing, BrowserState, Burst, BurstFee, BurstQuote, Catalog, Region, AutoReload, Checkout, Command, CreateSchedule, CreateApiKey, CreatedApiKey, DesktopLink, DesktopScreenshot, DesktopState, EmailMessage, EmailMessageList, EmailMessageSummary, ExecResult, HiddenVariable, HostRoute, Invite, Me, Member, Organization, MetricsAtMoment, MetricsReading, NetworkRule, Operation, PlainVariable, Plan, Policy, Prices, RunningOverTime, SandboxAutoStop, SandboxEmail, SandboxInfo, SandboxMetrics, SandboxNetwork, SandboxNetworkDetail, SandboxOwnNetwork, SandboxStatus, SandboxTemplate, SandboxUsage, Schedule, ScheduleRun, SecretVariable, SendEmail, SetAutoStop, Size, Snapshot, SshKey, SshState, UpdateSchedule, Team, TeamRole, Telemetry, DataRetention, AccountExport, TelemetryTest, RunsOnRepository, RunsOnRepositories, TemplateApplied, TemplateInfo, TemplateNetwork, TemplateRepo, TemplateSandbox, TemplateStart, TemplateSsh, Usage, Webhook, WebhookDelivery, } from "./types.js";
-export { verifyWebhook } from "./webhooks.js";

package/dist/index.js

@@ -1,5 +0,0 @@
-export { Agental } from "./client.js";
-export { AgentalError, ApiError, ConnectionError, ProxyError, TimeoutError } from "./errors.js";
-export { Browser, Commands, Desktop, Email, Files, Sandbox, Schedules, Ssh } from "./sandbox.js";
-export { Secrets, Template, Templates } from "./template.js";
-export { verifyWebhook } from "./webhooks.js";