alasio 8.0.0 → 10.0.0

package/dist/src/sandbox/otlp-resource.js

@@ -0,0 +1,173 @@
+const RESOURCE_LISTS = {
+    traces: ["resourceSpans", "scopeSpans"],
+    metrics: ["resourceMetrics", "scopeMetrics"],
+    logs: ["resourceLogs", "scopeLogs"],
+};
+/** Thrown for a request that does not parse as one, which is then not exported. */
+export class MalformedRequest extends Error {
+    name = "MalformedRequest";
+}
+function isStamped(key, stamp) {
+    return Object.hasOwn(stamp, key) || key.startsWith("alasio.");
+}
+// --- Binary protobuf ----------------------------------------------------------
+// The levels the resource is at, by field number, the same for all three signals:
+//   Export{Trace,Metrics,Logs}ServiceRequest  1: repeated Resource{Spans,Metrics,Logs}
+//   Resource{Spans,Metrics,Logs}               1: Resource
+//   Resource                                   1: repeated KeyValue attributes
+//   KeyValue                                   1: string key, 2: AnyValue value
+//   AnyValue                                   1: string string_value
+const VARINT = 0;
+const FIXED64 = 1;
+const LEN = 2;
+const FIXED32 = 5;
+function readVarint(buf, at) {
+    let value = 0;
+    for (let shift = 0; shift < 64; shift += 7) {
+        const byte = buf[at++];
+        if (byte === undefined)
+            throw new MalformedRequest("truncated varint");
+        value += (byte & 0x7f) * 2 ** shift;
+        if ((byte & 0x80) === 0)
+            return [value, at];
+    }
+    throw new MalformedRequest("overlong varint");
+}
+/** Each field of a message: its number, wire type, whole encoding, and value. */
+function* fields(buf) {
+    let at = 0;
+    while (at < buf.length) {
+        const start = at;
+        let tag;
+        [tag, at] = readVarint(buf, at);
+        const field = Math.floor(tag / 8);
+        const wire = tag % 8;
+        if (field === 0)
+            throw new MalformedRequest("field number 0");
+        let valueStart = at;
+        if (wire === VARINT)
+            [, at] = readVarint(buf, at);
+        else if (wire === FIXED64)
+            at += 8;
+        else if (wire === FIXED32)
+            at += 4;
+        else if (wire === LEN) {
+            let length;
+            [length, valueStart] = readVarint(buf, at);
+            at = valueStart + length;
+        }
+        else
+            throw new MalformedRequest(`wire type ${wire}`);
+        if (at > buf.length)
+            throw new MalformedRequest("truncated field");
+        yield { field, wire, whole: buf.subarray(start, at), value: buf.subarray(valueStart, at) };
+    }
+}
+/** A message field's value, which must be length-delimited. */
+function message({ field, wire, value }) {
+    if (wire !== LEN)
+        throw new MalformedRequest(`field ${field} has wire type ${wire}`);
+    return value;
+}
+function varint(value) {
+    const bytes = [];
+    for (; value >= 0x80; value = Math.floor(value / 128))
+        bytes.push((value % 128) | 0x80);
+    bytes.push(value);
+    return Buffer.from(bytes);
+}
+function lengthDelimited(field, bytes) {
+    return Buffer.concat([varint(field * 8 + LEN), varint(bytes.length), bytes]);
+}
+/** A KeyValue's key, the last given as protobuf merges them, or "" for none. */
+function keyOf(keyValue) {
+    let key = "";
+    for (const field of fields(keyValue)) {
+        if (field.field === 1)
+            key = message(field).toString("utf8");
+    }
+    return key;
+}
+function stampedAttributesProtobuf(stamp) {
+    return Object.entries(stamp).map(([key, value]) => lengthDelimited(1, Buffer.concat([
+        lengthDelimited(1, Buffer.from(key, "utf8")),
+        lengthDelimited(2, lengthDelimited(1, Buffer.from(value, "utf8"))),
+    ])));
+}
+/**
+ * A Resource{Spans,Metrics,Logs} with one Resource: every Resource it held merged as
+ * protobuf merges repeated occurrences, less the stamped attributes, plus the stamp.
+ */
+function stampResourcePart(part, stamp) {
+    const resource = [];
+    const rest = [];
+    for (const field of fields(part)) {
+        if (field.field !== 1) {
+            rest.push(field.whole);
+            continue;
+        }
+        for (const resourceField of fields(message(field))) {
+            if (resourceField.field === 1 && isStamped(keyOf(message(resourceField)), stamp))
+                continue;
+            resource.push(resourceField.whole);
+        }
+    }
+    return Buffer.concat([lengthDelimited(1, Buffer.concat([...resource, ...stampedAttributesProtobuf(stamp)])), ...rest]);
+}
+function stampProtobuf(body, stamp) {
+    return Buffer.concat([...fields(body)].map((field) => field.field === 1 ? lengthDelimited(1, stampResourcePart(message(field), stamp)) : field.whole));
+}
+// --- JSON ---------------------------------------------------------------------
+const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function list(value, what) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        throw new MalformedRequest(`${what} is not a list`);
+    return value;
+}
+function object(value, what) {
+    if (value === undefined)
+        return {};
+    if (!isObject(value))
+        throw new MalformedRequest(`${what} is not an object`);
+    return value;
+}
+/** The fields of `source` named by `names` that it has. */
+function only(source, names) {
+    return Object.fromEntries(names.filter((name) => source[name] !== undefined).map((name) => [name, source[name]]));
+}
+function stampJson(signal, body, stamp) {
+    let request;
+    try {
+        request = JSON.parse(body.toString("utf8"));
+    }
+    catch (error) {
+        throw new MalformedRequest(error instanceof Error ? error.message : String(error));
+    }
+    const [partsName, scopesName] = RESOURCE_LISTS[signal];
+    const parts = list(object(request, "the request")[partsName], partsName).map((value) => {
+        const part = object(value, partsName);
+        const resource = object(part["resource"], "resource");
+        const attributes = list(resource["attributes"], "resource.attributes")
+            .filter((attribute) => !(isObject(attribute) && typeof attribute["key"] === "string" && isStamped(attribute["key"], stamp)));
+        return {
+            resource: {
+                ...only(resource, ["droppedAttributesCount", "entityRefs"]),
+                attributes: [...attributes, ...Object.entries(stamp).map(([key, value]) => ({ key, value: { stringValue: value } }))],
+            },
+            ...only(part, [scopesName, "schemaUrl"]),
+        };
+    });
+    return Buffer.from(JSON.stringify({ [partsName]: parts }), "utf8");
+}
+/**
+ * `body`, an OTLP export request for `signal` in `encoding` ("protobuf" or "json"),
+ * with its resources stamped. Throws MalformedRequest for one that does not parse.
+ */
+export function stampResources(signal, encoding, body, stamp) {
+    if (!Object.hasOwn(RESOURCE_LISTS, signal))
+        throw new Error(`unknown signal ${signal}`);
+    return encoding === "json" ? stampJson(signal, body, stamp) : stampProtobuf(body, stamp);
+}
+//# sourceMappingURL=otlp-resource.js.map

package/dist/src/sandbox/otlp-resource.js.map

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

package/dist/src/sandbox/telemetry.js

@@ -0,0 +1,43 @@
+/**
+ * What bayma inside a session's sandbox exports its telemetry with, and what is stamped on
+ * it. A pool's pod's one way out without internet is the sandbox service's receiver
+ * (../receiver/receiver.ts), so its bayma exports there, with its binding's token, each signal
+ * the sandbox gateway exports, as the gateway tells the node agent attaching the workspace
+ * (../gateway/sessions.ts); the receiver stamps what arrives with what is known of the session
+ * and exports it where the stack's telemetry goes.
+ */
+import { parseKeyValueList, resolveTelemetry, sharedResourceAttributes, SIGNALS, telemetryEnabled } from "../telemetry/config.js";
+/**
+ * The standard variables bayma inside a sandbox exports with, but for the endpoint and the
+ * token it sends, which are the sandbox's own: each signal `env`, the gateway's, exports, in
+ * the protocol it exports it in, and no other. Empty where it exports nothing.
+ */
+export function sandboxBaymaTelemetryEnv(env = process.env) {
+    const telemetry = resolveTelemetry(env);
+    if (!telemetryEnabled(telemetry))
+        return {};
+    const settings = {};
+    for (const signal of SIGNALS) {
+        const upper = signal.toUpperCase();
+        const exporter = telemetry[signal];
+        settings[`OTEL_${upper}_EXPORTER`] = exporter ? "otlp" : "none";
+        if (exporter)
+            settings[`OTEL_EXPORTER_OTLP_${upper}_PROTOCOL`] = exporter.protocol;
+    }
+    return settings;
+}
+/** The resource attributes a session's telemetry is stamped with. */
+export function sandboxResource(volumeId, env = process.env) {
+    return { ...parseKeyValueList(sharedResourceAttributes(env)), "service.name": "bayma", "alasio.volume.id": volumeId };
+}
+/**
+ * What a folder conversation's instance's telemetry is stamped with: bayma's, of the
+ * conversation, as alasio's own of the conversation is, and the harness it is under.
+ */
+export const folderResource = (harness, conversation, env = process.env) => ({
+    ...parseKeyValueList(sharedResourceAttributes(env)),
+    "service.name": "bayma",
+    "alasio.conversation.id": conversation,
+    "alasio.harness": harness,
+});
+//# sourceMappingURL=telemetry.js.map

package/dist/src/sandbox/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../../src/sandbox/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGlI;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAG,GAAgC,OAAO,CAAC,GAAG;IACrF,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,QAAQ,CAAC,QAAQ,KAAK,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,QAAQ;YAAE,QAAQ,CAAC,sBAAsB,KAAK,WAAW,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACrF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAG,GAAgC,OAAO,CAAC,GAAG;IAC9F,OAAO,EAAE,GAAG,iBAAiB,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;AACxH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,YAAoB,EAAE,GAAG,GAAgC,OAAO,CAAC,GAAG,EAAiB,EAAE,CAAC,CAAC;IACvI,GAAG,iBAAiB,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACnD,cAAc,EAAE,OAAO;IACvB,wBAAwB,EAAE,YAAY;IACtC,gBAAgB,EAAE,OAAO;CAC1B,CAAC,CAAC"}

package/dist/src/telegram/bot-commands.js

@@ -0,0 +1,17 @@
+/**
+ * The bot's commands, as Telegram's menu offers them: set by alasio's command line as it
+ * registers each environment's bot (cli/src/webhook.ts), not by alasio as it starts, which
+ * would ask Telegram the same of every start, and an environment that sleeps starts often.
+ * Free of anything but itself, so the command line takes it without the server.
+ */
+/** The bot's commands, in the menu's order. */
+export const BOT_COMMANDS = [
+    { command: "service", description: "Switch between Codex and Claude" },
+    { command: "model", description: "Choose the model and effort" },
+    { command: "workspace", description: "Choose, create or fork the workspace to work in" },
+    { command: "session", description: "Manage the mounted agent session" },
+    { command: "sessions", description: "Browse and mount agent sessions" },
+    { command: "goal", description: "View or set the mounted session goal (Codex)" },
+    { command: "stop", description: "Interrupt the active turn" },
+];
+//# sourceMappingURL=bot-commands.js.map

package/dist/src/telegram/bot-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-commands.js","sourceRoot":"","sources":["../../../../src/telegram/bot-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iCAAiC,EAAE;IACtE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAChE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iDAAiD,EAAE;IACxF,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,kCAAkC,EAAE;IACvE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iCAAiC,EAAE;IACvE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,8CAA8C,EAAE;IAChF,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,2BAA2B,EAAE;CAC9D,CAAC"}

package/dist/src/telegram/stop.js

@@ -0,0 +1,12 @@
+/**
+ * How long an alasio is given to stop, as its Deployment says (cli/src/manifests/alasio.ts) and
+ * its drain keeps to (./drain.ts). Free of anything but itself, so the command line takes it
+ * without the app.
+ */
+/**
+ * How long an alasio is given to stop, in seconds: past the longest Telegram is waited for
+ * before a reply is sent again (./outbox.ts, five minutes), so a reply held off as it is told to
+ * stop is delivered still.
+ */
+export const STOP_GRACE_SECONDS = 360;
+//# sourceMappingURL=stop.js.map

package/dist/src/telegram/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../../src/telegram/stop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC"}

package/dist/src/telemetry/config.js

@@ -0,0 +1,131 @@
+/**
+ * Which of alasio's signals are exported, and where, decided from the standard
+ * OpenTelemetry environment variables alone, so any OTLP backend works and none is
+ * assumed.
+ *
+ * A signal is exported when it has an endpoint, its own
+ * (`OTEL_EXPORTER_OTLP_<SIGNAL>_ENDPOINT`) or the shared one
+ * (`OTEL_EXPORTER_OTLP_ENDPOINT`), and `OTEL_<SIGNAL>_EXPORTER` is unset or `otlp`;
+ * `OTEL_SDK_DISABLED=true` turns every signal off. With no endpoint at all alasio
+ * exports nothing and loads no SDK.
+ */
+export const SIGNALS = ["traces", "metrics", "logs"];
+const DEFAULT_PROTOCOL = "http/protobuf";
+/** Variables that configure telemetry, which alasio hands no child as it is. */
+const TELEMETRY_VARIABLE = /^(OTEL_.*|TRACEPARENT|TRACESTATE)$/u;
+function setting(env, name) {
+    return env[name]?.trim() || null;
+}
+/**
+ * The OTLP endpoint a signal is sent to: its own as given, else the shared one, to
+ * which OTLP over HTTP adds the signal's path and OTLP over gRPC adds nothing.
+ */
+function signalEndpoint(env, signal, protocol) {
+    const own = setting(env, `OTEL_EXPORTER_OTLP_${signal.toUpperCase()}_ENDPOINT`);
+    if (own)
+        return own;
+    const shared = setting(env, "OTEL_EXPORTER_OTLP_ENDPOINT");
+    if (!shared || protocol === "grpc")
+        return shared;
+    return `${shared.replace(/\/+$/u, "")}/v1/${signal}`;
+}
+/** How `signal` is exported, or null when it is not. */
+function signalExporter(env, signal, disabled) {
+    const upper = signal.toUpperCase();
+    const exporter = setting(env, `OTEL_${upper}_EXPORTER`) ?? "otlp";
+    const protocol = setting(env, `OTEL_EXPORTER_OTLP_${upper}_PROTOCOL`)
+        ?? setting(env, "OTEL_EXPORTER_OTLP_PROTOCOL")
+        ?? DEFAULT_PROTOCOL;
+    const endpoint = signalEndpoint(env, signal, protocol);
+    if (disabled || exporter !== "otlp" || !endpoint) {
+        return null;
+    }
+    return { endpoint, protocol, headers: signalHeaders(env, signal) };
+}
+/**
+ * `{ traces, metrics, logs }`, each `{ endpoint, protocol, headers }` for a signal
+ * alasio exports or null for one it does not. `headers` is the standard
+ * `key=value,key=value` list, or null.
+ */
+export function resolveTelemetry(env = process.env) {
+    const disabled = setting(env, "OTEL_SDK_DISABLED")?.toLowerCase() === "true";
+    return {
+        traces: signalExporter(env, "traces", disabled),
+        metrics: signalExporter(env, "metrics", disabled),
+        logs: signalExporter(env, "logs", disabled),
+    };
+}
+/**
+ * A signal's OTLP exporter setting `name` (HEADERS, TIMEOUT, ...): its own
+ * (`OTEL_EXPORTER_OTLP_<SIGNAL>_<NAME>`), else the shared one, or null.
+ */
+export function signalSetting(env, signal, name) {
+    return setting(env, `OTEL_EXPORTER_OTLP_${signal.toUpperCase()}_${name}`) ?? setting(env, `OTEL_EXPORTER_OTLP_${name}`);
+}
+/** The headers a signal is sent with: its own, else the shared ones, or null. */
+export function signalHeaders(env, signal) {
+    return signalSetting(env, signal, "HEADERS");
+}
+/** Whether any signal is exported. */
+export function telemetryEnabled(telemetry) {
+    return SIGNALS.some((signal) => telemetry[signal]);
+}
+/** An environment without the variables that configure telemetry. */
+export function withoutTelemetry(env) {
+    return Object.fromEntries(Object.entries(env).filter(([name]) => !TELEMETRY_VARIABLE.test(name)));
+}
+/**
+ * The resource attributes a harness exporting telemetry of its own shares with alasio:
+ * the operator's `OTEL_RESOURCE_ATTRIBUTES`, which describe the deployment, without
+ * `service.name`, which is alasio's. The standard `key=value,key=value` list, or null.
+ */
+export function sharedResourceAttributes(env = process.env) {
+    const shared = (setting(env, "OTEL_RESOURCE_ATTRIBUTES") ?? "")
+        .split(",")
+        .filter((pair) => pair.trim() && pair.split("=")[0]?.trim() !== "service.name");
+    return shared.length ? shared.join(",") : null;
+}
+/**
+ * The standard variables that have a process serving one conversation, Claude Code
+ * or bayma, export each signal alasio exports where alasio exports it, and no other:
+ * each exported signal's exporter, endpoint, protocol, and headers, every other
+ * signal's exporter none, and the deployment's resource attributes with the
+ * conversation's. Nothing when alasio exports nothing.
+ */
+export function conversationTelemetryEnv({ conversationId }, env = process.env) {
+    const telemetry = resolveTelemetry(env);
+    if (!telemetryEnabled(telemetry))
+        return {};
+    const settings = {
+        OTEL_RESOURCE_ATTRIBUTES: [sharedResourceAttributes(env), `alasio.conversation.id=${encodeURIComponent(conversationId)}`]
+            .filter(Boolean)
+            .join(","),
+    };
+    for (const signal of SIGNALS) {
+        const upper = signal.toUpperCase();
+        const exporter = telemetry[signal];
+        settings[`OTEL_${upper}_EXPORTER`] = exporter ? "otlp" : "none";
+        if (!exporter)
+            continue;
+        settings[`OTEL_EXPORTER_OTLP_${upper}_ENDPOINT`] = exporter.endpoint;
+        settings[`OTEL_EXPORTER_OTLP_${upper}_PROTOCOL`] = exporter.protocol;
+        if (exporter.headers)
+            settings[`OTEL_EXPORTER_OTLP_${upper}_HEADERS`] = exporter.headers;
+    }
+    return settings;
+}
+/**
+ * A standard `key=value,key=value` list, such as OTLP headers or resource attributes, as
+ * an object, values URL-decoded.
+ */
+export function parseKeyValueList(list) {
+    if (!list)
+        return {};
+    return Object.fromEntries(list.split(",").flatMap((pair) => {
+        const at = pair.indexOf("=");
+        if (at <= 0)
+            return [];
+        return [[pair.slice(0, at).trim(), decodeURIComponent(pair.slice(at + 1).trim())]];
+    }));
+}
+//# sourceMappingURL=config.js.map

package/dist/src/telemetry/config.js.map

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

package/dist/src/telemetry/forward.js

@@ -0,0 +1,154 @@
+/**
+ * Exports OTLP requests that something else encoded, as they are, over OTLP/HTTP to
+ * where alasio exports its own signals: what the sandbox service's receiver relays from
+ * inside a session's sandbox (src/receiver/receiver.ts). Each signal goes to its endpoint with its headers,
+ * timeout, compression, and TLS files from the standard variables, as OpenTelemetry's
+ * own exporters send alasio's, and is retried as they retry: on 429, 502, 503, and 504
+ * and on a failed connection, after the server's Retry-After or a jittered backoff,
+ * within the signal's timeout. alasio's deployment has it export to the stack's
+ * collector over OTLP/HTTP, which bayma exports over too.
+ */
+import { readFileSync } from "node:fs";
+import { Agent as HttpAgent, request as httpRequest } from "node:http";
+import { Agent as HttpsAgent, request as httpsRequest } from "node:https";
+import { setTimeout as sleep } from "node:timers/promises";
+import { gzipSync } from "node:zlib";
+import { context } from "@opentelemetry/api";
+import { suppressTracing } from "@opentelemetry/core";
+import { parseKeyValueList, resolveTelemetry, SIGNALS, signalSetting } from "./config.js";
+const CONTENT_TYPES = { protobuf: "application/x-protobuf", json: "application/json" };
+const DEFAULT_TIMEOUT_MS = 10_000;
+const RETRYABLE_STATUS = new Set([429, 502, 503, 504]);
+const MAX_RETRIES = 5;
+const INITIAL_BACKOFF_MS = 1000;
+const MAX_BACKOFF_MS = 5000;
+const BACKOFF_MULTIPLIER = 1.5;
+const JITTER = 0.2;
+// A response body is never needed, only drained; one this large is not an OTLP server's.
+const MAX_RESPONSE_BYTES = 4 * 1024 * 1024;
+/** The milliseconds a Retry-After header asks to wait, or null. */
+export function retryAfterMs(header, now = Date.now()) {
+    if (!header)
+        return null;
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return seconds * 1000;
+    const at = Date.parse(header);
+    return Number.isNaN(at) ? null : Math.max(0, at - now);
+}
+const TLS_FILES = [["ca", "CERTIFICATE"], ["cert", "CLIENT_CERTIFICATE"], ["key", "CLIENT_KEY"]];
+function tlsFiles(env, signal, warn) {
+    const files = {};
+    for (const [option, name] of TLS_FILES) {
+        const path = signalSetting(env, signal, name);
+        if (!path)
+            continue;
+        try {
+            files[option] = readFileSync(path);
+        }
+        catch (error) {
+            warn(`${signal}: cannot read OTEL_EXPORTER_OTLP_${name} ${path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return files;
+}
+/** How each exported signal is sent, from the standard variables. */
+function signalTargets(env, warn) {
+    const telemetry = resolveTelemetry(env);
+    const targets = {};
+    for (const signal of SIGNALS) {
+        const exporter = telemetry[signal];
+        if (!exporter)
+            continue;
+        const url = new URL(exporter.endpoint);
+        const timeout = Number(signalSetting(env, signal, "TIMEOUT"));
+        const https = url.protocol === "https:";
+        targets[signal] = {
+            url,
+            protocol: exporter.protocol,
+            headers: parseKeyValueList(exporter.headers),
+            timeoutMs: Number.isFinite(timeout) && timeout > 0 ? timeout : DEFAULT_TIMEOUT_MS,
+            gzip: signalSetting(env, signal, "COMPRESSION") === "gzip",
+            request: https ? httpsRequest : httpRequest,
+            agent: https ? new HttpsAgent({ keepAlive: true, ...tlsFiles(env, signal, warn) }) : new HttpAgent({ keepAlive: true }),
+        };
+    }
+    return targets;
+}
+/** One POST: `{ status, retryAfter }`, or `{ error }` for a connection that failed. */
+function post(target, body, headers, timeoutMs, signal) {
+    return new Promise((resolve) => {
+        // alasio's own HTTP instrumentation would otherwise trace every export it relays.
+        context.with(suppressTracing(context.active()), () => {
+            const req = target.request(target.url, { method: "POST", agent: target.agent, headers, timeout: timeoutMs, ...(signal ? { signal } : {}) }, (res) => {
+                let received = 0;
+                res.on("data", (chunk) => {
+                    received += chunk.length;
+                    if (received > MAX_RESPONSE_BYTES)
+                        res.destroy();
+                });
+                res.on("error", () => { });
+                res.on("close", () => resolve({ status: res.statusCode, retryAfter: retryAfterMs(res.headers["retry-after"]) }));
+            });
+            req.on("timeout", () => req.destroy(new Error(`no response within ${timeoutMs}ms`)));
+            req.on("error", (error) => resolve({ error }));
+            req.end(body);
+        });
+    });
+}
+/**
+ * The forwarder for the signals `env` exports. `protocols` maps each signal it forwards
+ * to the protocol alasio exports it over (http/protobuf or http/json); a signal it does
+ * not forward is absent. `export(signal, encoding, body)` sends one request, encoded as
+ * `encoding` ("protobuf" or "json"), within the signal's timeout or `withinMs` where less,
+ * and resolves `{ ok: true }` once a server took it, or `{ ok: false, ... }` once it is given
+ * up on (ForwardResult), or `signal` aborts it, which ends the request it is sending.
+ * `close()` ends the connections it keeps open.
+ */
+export function createOtlpForwarder(env = process.env, { warn = () => { } } = {}) {
+    const targets = signalTargets(env, warn);
+    const protocols = {};
+    for (const signal of SIGNALS) {
+        const target = targets[signal];
+        if (target)
+            protocols[signal] = target.protocol;
+    }
+    return {
+        protocols,
+        async export(signal, encoding, body, { withinMs, signal: abort } = {}) {
+            const target = targets[signal];
+            if (!target)
+                return { ok: false, error: `${signal} are not forwarded`, retryable: false, retryAfterMs: null };
+            const headers = {
+                ...target.headers,
+                "content-type": CONTENT_TYPES[encoding],
+                ...(target.gzip ? { "content-encoding": "gzip" } : {}),
+            };
+            const payload = target.gzip ? gzipSync(body) : body;
+            const deadline = Date.now() + Math.min(target.timeoutMs, withinMs ?? Infinity);
+            let backoff = INITIAL_BACKOFF_MS;
+            for (let attempt = 0;; attempt += 1) {
+                const result = await post(target, payload, headers, Math.max(1, deadline - Date.now()), abort);
+                if (result.status !== undefined && result.status >= 200 && result.status < 300)
+                    return { ok: true };
+                const error = result.error?.message ?? `HTTP ${result.status}`;
+                const retryable = result.error || (result.status !== undefined && RETRYABLE_STATUS.has(result.status));
+                const failed = { ok: false, error, retryable: Boolean(retryable), retryAfterMs: result.retryAfter ?? null };
+                if (attempt === MAX_RETRIES || !retryable)
+                    return failed;
+                const wait = result.retryAfter ?? Math.min(backoff * (1 + (Math.random() * 2 - 1) * JITTER), MAX_BACKOFF_MS);
+                backoff *= BACKOFF_MULTIPLIER;
+                if (Date.now() + wait >= deadline || abort?.aborted)
+                    return failed;
+                const waited = await sleep(wait, true, abort ? { signal: abort } : {}).catch(() => false);
+                if (!waited)
+                    return failed;
+            }
+        },
+        close() {
+            for (const target of Object.values(targets))
+                target.agent.destroy();
+        },
+    };
+}
+//# sourceMappingURL=forward.js.map

package/dist/src/telemetry/forward.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alasio",
-  "version": "8.0.0",
+  "version": "10.0.0",
   "description": "alasio: coding agents you talk to from Telegram, installed and run with npx alasio",
   "type": "module",
   "license": "MIT",