little-durable-objects 0.1.0

package/dist/host/worker/supervisor.js

@@ -0,0 +1,190 @@
+import { Worker } from "node:worker_threads";
+import { findActorDefinition } from "../../shared/actor.js";
+import { errorMessage, failedReply } from "../../shared/types.js";
+const DEFAULT_ACTOR_IDLE_TIMEOUT_MS = 60_000;
+const MAX_RESIDENT_ACTORS = 32;
+class ActorWorkerSupervisor {
+    actorEntrypointUrl;
+    actorIdleTimeoutMs;
+    actors = new Map();
+    constructor(options) {
+        this.actorEntrypointUrl = options.actorEntrypointUrl;
+        this.actorIdleTimeoutMs = options.actorIdleTimeoutMs ?? DEFAULT_ACTOR_IDLE_TIMEOUT_MS;
+        if (!Number.isInteger(this.actorIdleTimeoutMs) || this.actorIdleTimeoutMs <= 0) {
+            throw new Error("actor idle timeout must be a positive integer");
+        }
+    }
+    async handle(command) {
+        switch (command.type) {
+            case "invoke":
+                return this.invoke(command);
+            case "evict":
+                return this.evict(command);
+            default:
+                throw command;
+        }
+    }
+    invoke(command) {
+        const definition = findActorDefinition(command.actor.actor_type);
+        if (definition === undefined) {
+            return Promise.resolve(failedReply("actor_type_not_found", `actor type ${command.actor.actor_type} is not loaded in this customer process`));
+        }
+        const key = actorKey(command);
+        let actor = this.actors.get(key);
+        if (actor === undefined) {
+            if (!this.makeRoomForActor()) {
+                return Promise.resolve(failedReply("resource_exhausted", `actor host already has ${MAX_RESIDENT_ACTORS} active actor Workers`));
+            }
+            actor = new ResidentActorWorker({
+                actorType: definition.actorType,
+                moduleUrl: this.actorEntrypointUrl,
+                idleTimeoutMs: this.actorIdleTimeoutMs,
+                onIdle: candidate => this.removeIfCurrent(key, candidate)
+            });
+            this.actors.set(key, actor);
+        }
+        return actor.invoke(command);
+    }
+    evict(command) {
+        const key = actorKey(command);
+        const actor = this.actors.get(key);
+        if (actor !== undefined) {
+            this.actors.delete(key);
+            actor.terminate("resident actor was evicted by the Rust host");
+        }
+        return { type: "evicted" };
+    }
+    makeRoomForActor() {
+        if (this.actors.size < MAX_RESIDENT_ACTORS)
+            return true;
+        const idle = [...this.actors.entries()].filter(([, actor]) => actor.isIdle()).sort((left, right) => left[1].lastCompletedAt - right[1].lastCompletedAt)[0];
+        if (idle === undefined)
+            return false;
+        this.actors.delete(idle[0]);
+        idle[1].terminate("resident actor was evicted by the LRU capacity limit");
+        return true;
+    }
+    removeIfCurrent(key, actor) {
+        if (this.actors.get(key) !== actor || !actor.isIdle())
+            return;
+        this.actors.delete(key);
+        actor.terminate(`resident actor was idle for ${this.actorIdleTimeoutMs}ms`);
+    }
+}
+class ResidentActorWorker {
+    actorType;
+    moduleUrl;
+    idleTimeoutMs;
+    onIdle;
+    lastCompletedAt = Date.now();
+    worker;
+    idleTimer;
+    constructor(options) {
+        this.actorType = options.actorType;
+        this.moduleUrl = options.moduleUrl;
+        this.idleTimeoutMs = options.idleTimeoutMs;
+        this.onIdle = options.onIdle;
+    }
+    async invoke(command) {
+        if (this.idleTimer !== undefined)
+            clearTimeout(this.idleTimer);
+        this.idleTimer = undefined;
+        this.worker ??= new ActorWorker({ actorType: this.actorType, moduleUrl: this.moduleUrl });
+        let reply;
+        try {
+            reply = await this.worker.invoke(command);
+        }
+        catch (error) {
+            reply = failedReply(error instanceof ActorWorkerTerminatedError ? "actor_worker_terminated" : "actor_worker_failed", errorMessage(error));
+        }
+        finally {
+            this.lastCompletedAt = Date.now();
+        }
+        if (reply.type === "failed") {
+            this.worker.terminate("actor invocation failed");
+            this.worker = undefined;
+        }
+        this.idleTimer = setTimeout(() => this.onIdle(this), this.idleTimeoutMs);
+        this.idleTimer.unref();
+        return reply;
+    }
+    isIdle() {
+        return this.idleTimer !== undefined;
+    }
+    terminate(reason) {
+        if (this.idleTimer !== undefined)
+            clearTimeout(this.idleTimer);
+        this.idleTimer = undefined;
+        this.worker?.terminate(reason);
+        this.worker = undefined;
+    }
+}
+class ActorWorker {
+    worker;
+    replyResolve;
+    replyReject;
+    terminalError;
+    constructor(data) {
+        this.worker = new Worker(new URL("./entrypoint.js", import.meta.url), { workerData: data });
+        this.worker.on("message", (reply) => this.reply(reply));
+        this.worker.once("error", error => this.fail(error));
+        this.worker.once("exit", code => this.fail(new Error(`actor Worker exited with code ${code}`)));
+        this.worker.unref();
+    }
+    async invoke(command) {
+        if (this.terminalError !== undefined)
+            throw this.terminalError;
+        this.worker.ref();
+        try {
+            return await new Promise((resolve, reject) => {
+                this.replyResolve = resolve;
+                this.replyReject = reject;
+                this.post({ type: "invoke", command });
+            });
+        }
+        finally {
+            if (this.replyResolve === undefined)
+                this.worker.unref();
+        }
+    }
+    terminate(reason) {
+        if (this.terminalError !== undefined)
+            return;
+        const error = new ActorWorkerTerminatedError(reason);
+        this.fail(error);
+        void this.worker.terminate();
+    }
+    reply(reply) {
+        const resolve = this.replyResolve;
+        if (resolve === undefined)
+            return;
+        this.replyResolve = undefined;
+        this.replyReject = undefined;
+        resolve(reply);
+        this.worker.unref();
+    }
+    post(message) {
+        this.worker.postMessage(message);
+    }
+    fail(error) {
+        if (this.terminalError !== undefined)
+            return;
+        this.terminalError = error;
+        this.replyReject?.(error);
+        this.replyResolve = undefined;
+        this.replyReject = undefined;
+        this.worker.unref();
+    }
+}
+class ActorWorkerTerminatedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActorWorkerTerminatedError";
+    }
+}
+function actorKey(command) {
+    const actor = command.actor;
+    return `${actor.namespace_id}\u001f${actor.actor_type}\u001f${actor.actor_id}`;
+}
+export { ActorWorkerSupervisor, DEFAULT_ACTOR_IDLE_TIMEOUT_MS, MAX_RESIDENT_ACTORS };
+//# sourceMappingURL=supervisor.js.map

package/dist/host/worker/supervisor.js.map

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

package/dist/host.d.ts

@@ -0,0 +1,2 @@
+export { runActorHost as runDurableObjectHost } from "./host/session.js";
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/host.js

@@ -0,0 +1,2 @@
+export { runActorHost as runDurableObjectHost } from "./host/session.js";
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Actor } from "./shared/actor.js";
+export { configureDurableObjects } from "./workflow/client.js";
+export { ActorInvocationError } from "./shared/errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Actor } from "./shared/actor.js";
+export { configureDurableObjects } from "./workflow/client.js";
+export { ActorInvocationError } from "./shared/errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/providers/modal.d.ts

@@ -0,0 +1,29 @@
+import { ModalClient } from "modal";
+import type { CanonicalRegionCatalog } from "../regions.js";
+import type { ActorHostHandle, EnsureHostRequest, SandboxProvider } from "./types.js";
+interface ModalSandboxProviderOptions {
+    readonly appName?: string;
+    readonly binaryPath?: string;
+    readonly catalog?: CanonicalRegionCatalog;
+    readonly client?: ModalClient;
+}
+declare class ModalSandboxProvider implements SandboxProvider {
+    private readonly options;
+    private readonly modal;
+    private readonly appName;
+    private readonly binaryPath;
+    private readonly activations;
+    constructor(options?: ModalSandboxProviderOptions);
+    ensureHost(request: EnsureHostRequest): Promise<ActorHostHandle>;
+    private ensureHostOnce;
+    private reuseExisting;
+    private createSandbox;
+    private activate;
+    private existing;
+    private readHandle;
+    private validatePlacement;
+    private start;
+}
+export { ModalSandboxProvider };
+export type { ModalSandboxProviderOptions };
+//# sourceMappingURL=modal.d.ts.map

package/dist/providers/modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../providers/modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,WAAW,EAAiB,MAAM,OAAO,CAAA;AAKtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AASrF,UAAU,2BAA2B;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAChC;AAID,cAAM,oBAAqB,YAAW,eAAe;IAMrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;gBAE7C,OAAO,GAAE,2BAAgC;IAMhE,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;YASxD,cAAc;YAWd,aAAa;YAWb,aAAa;YA+Bb,QAAQ;YAOR,QAAQ;YAUR,UAAU;YAYV,iBAAiB;YASjB,KAAK;CAgBtB;AA0DD,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAC/B,YAAY,EAAE,2BAA2B,EAAE,CAAA"}

package/dist/providers/modal.js

@@ -0,0 +1,193 @@
+import { AlreadyExistsError, ModalClient, NotFoundError } from "modal";
+import { createHash } from "node:crypto";
+import { canonicalRegionForModal, modalPlacement } from "../regions.js";
+const hostPort = 7101;
+const hostRouteFile = "/tmp/durable-object-route";
+const readyFile = "/tmp/durable-object-ready";
+const hostStderrFile = "/tmp/durable-object-host.stderr";
+const hostExitedFile = "/tmp/durable-object-host-exited";
+const maximumSandboxLifetimeMs = 24 * 60 * 60 * 1000;
+class ModalSandboxProvider {
+    options;
+    modal;
+    appName;
+    binaryPath;
+    activations = new Map();
+    constructor(options = {}) {
+        this.options = options;
+        this.modal = options.client ?? new ModalClient();
+        this.appName = options.appName ?? "durable-object-hosts";
+        this.binaryPath = options.binaryPath ?? "/usr/local/bin/little-durable-objects";
+    }
+    async ensureHost(request) {
+        const key = resourceName("host", request);
+        const current = this.activations.get(key);
+        if (current)
+            return current;
+        const activation = this.ensureHostOnce(request, key).finally(() => this.activations.delete(key));
+        this.activations.set(key, activation);
+        return activation;
+    }
+    async ensureHostOnce(request, name) {
+        validateEnsureRequest(request);
+        const placement = modalPlacement(request.canonicalRegion, this.options.catalog);
+        const [app, image] = await Promise.all([this.modal.apps.fromName(this.appName, { createIfMissing: true }), this.modal.images.fromId(request.imageRef)]);
+        const existing = await this.reuseExisting(app, name, request.canonicalRegion);
+        if (existing)
+            return existing;
+        const acquired = await this.createSandbox(request, name, app, image, placement);
+        if ("handle" in acquired)
+            return acquired.handle;
+        return this.activate(acquired.sandbox, request);
+    }
+    async reuseExisting(app, name, canonicalRegion) {
+        const existing = await this.existing(app, name);
+        if (!existing)
+            return undefined;
+        try {
+            return await this.readHandle(existing, canonicalRegion);
+        }
+        catch {
+            await existing.terminate();
+            return undefined;
+        }
+    }
+    async createSandbox(request, name, app, image, placement) {
+        try {
+            const sandbox = await this.modal.sandboxes.create(app, image, {
+                name,
+                timeoutMs: maximumSandboxLifetimeMs,
+                idleTimeoutMs: request.hostIdleTimeoutMs,
+                command: [
+                    "sh",
+                    "-c",
+                    'until test -s "$1"; do sleep 0.05; done; export DURABLE_OBJECT_HOST_ROUTE="$(cat "$1")"; "$2" 2>"$3"; status=$?; printf \'%s\n\' "$status" >"$4"; if ! test -f "$5"; then sleep 60; fi; exit "$status"',
+                    "durable-object-host-bootstrap",
+                    hostRouteFile,
+                    this.binaryPath,
+                    hostStderrFile,
+                    hostExitedFile,
+                    readyFile
+                ],
+                workdir: request.workingDirectory,
+                env: hostEnvironment(request),
+                h2Ports: [hostPort],
+                regions: [...placement.regions],
+                cloud: placement.cloud
+            });
+            return { sandbox };
+        }
+        catch (error) {
+            if (!(error instanceof AlreadyExistsError))
+                throw error;
+            const raced = (await this.existing(app, name)) ?? (await this.modal.sandboxes.fromName(this.appName, name));
+            return { handle: await this.readHandle(raced, request.canonicalRegion) };
+        }
+    }
+    async activate(sandbox, request) {
+        await this.validatePlacement(sandbox, request.canonicalRegion);
+        const handle = await this.start(sandbox, request);
+        await writeMetadata(sandbox, handle);
+        return handle;
+    }
+    async existing(app, name) {
+        try {
+            const sandbox = await this.modal.sandboxes.fromName(app.name ?? this.appName, name);
+            return (await sandbox.poll()) === null ? sandbox : undefined;
+        }
+        catch (error) {
+            if (error instanceof NotFoundError)
+                return undefined;
+            throw error;
+        }
+    }
+    async readHandle(sandbox, canonicalRegion) {
+        const process = await sandbox.exec(["sh", "-c", "for i in $(seq 1 1200); do test -s /tmp/durable-object-host.json && exec cat /tmp/durable-object-host.json; sleep 0.05; done; exit 1"], {
+            stdout: "pipe",
+            stderr: "pipe"
+        });
+        const [document, exitCode] = await Promise.all([process.stdout.readText(), process.wait()]);
+        if (exitCode !== 0)
+            throw new Error("existing Modal host has no ready metadata");
+        const handle = JSON.parse(document);
+        if (handle.canonicalRegion !== canonicalRegion)
+            throw new Error("existing Modal host has the wrong canonical region");
+        return handle;
+    }
+    async validatePlacement(sandbox, expectedRegion) {
+        const observed = await runtimePlacement(sandbox);
+        const observedCanonical = canonicalRegionForModal(observed.cloud, observed.region, this.options.catalog);
+        if (observedCanonical !== expectedRegion) {
+            await sandbox.terminate();
+            throw new Error(`Modal placed host in ${observedCanonical ?? "an unknown region"}; expected ${expectedRegion}`);
+        }
+    }
+    async start(sandbox, request) {
+        const route = (await sandbox.tunnels())[hostPort]?.url;
+        if (!route)
+            throw new Error("Modal did not create the durable-object HTTP/2 tunnel");
+        await writeFile(sandbox, hostRouteFile, route);
+        const ready = await sandbox.exec(["sh", "-c", `for i in $(seq 1 1200); do test -f ${readyFile} && exit 0; if test -f ${hostExitedFile}; then cat ${hostStderrFile} >&2; exit 1; fi; sleep 0.05; done; exit 1`], { stdout: "pipe", stderr: "pipe" });
+        const [detail, exitCode] = await Promise.all([ready.stderr.readText(), ready.wait()]);
+        if (exitCode !== 0) {
+            await sandbox.terminate().catch(() => undefined);
+            const message = detail.trim();
+            throw new Error(`durable-object host did not become ready${message ? `: ${message}` : ""}`);
+        }
+        return { hostId: request.hostId, route, canonicalRegion: request.canonicalRegion };
+    }
+}
+function hostEnvironment(request) {
+    return {
+        DURABLE_OBJECT_PROCESS_ROLE: "host",
+        DURABLE_OBJECT_HOST_TOKEN: request.hostToken,
+        DURABLE_OBJECT_JWT_PUBLIC_KEYS: request.jwtPublicKeys,
+        DURABLE_OBJECT_NAMESPACE_ID: request.namespaceId,
+        DURABLE_OBJECT_CONTROL_PLANE_URL: request.controlPlaneUrl,
+        DURABLE_OBJECT_JWT_ISSUER: request.jwtIssuer,
+        DURABLE_OBJECT_INVOKE_JWT_AUDIENCE: request.invocationJwtAudience,
+        DURABLE_OBJECT_HOST_ID: request.hostId,
+        DURABLE_OBJECT_SESSION_ID: request.sessionId,
+        DURABLE_OBJECT_REGION: request.canonicalRegion,
+        DURABLE_OBJECT_CODE_REVISION: request.codeRevision,
+        DURABLE_OBJECT_EXECUTOR_SOCKET: "/tmp/durable-object-executor.sock",
+        DURABLE_OBJECT_HOST_READY_FILE: readyFile,
+        DURABLE_OBJECT_HOST_BIND: `0.0.0.0:${hostPort}`,
+        DURABLE_OBJECT_ACTOR_IDLE_TIMEOUT_MS: String(request.actorIdleTimeoutMs),
+        DURABLE_OBJECT_HOST_IDLE_TIMEOUT_MS: String(request.hostIdleTimeoutMs),
+        ...(request.actorEntrypoint ? { DURABLE_OBJECT_ENTRYPOINT: request.actorEntrypoint } : {})
+    };
+}
+function validateEnsureRequest(request) {
+    if (!request.hostId.startsWith(`host.v1.${request.namespaceId}.`))
+        throw new Error("host ID does not belong to its namespace");
+    if (!Number.isInteger(request.actorIdleTimeoutMs) || request.actorIdleTimeoutMs <= 0 || request.actorIdleTimeoutMs > maximumSandboxLifetimeMs) {
+        throw new Error("actor idle timeout is invalid");
+    }
+    if (!Number.isInteger(request.hostIdleTimeoutMs) || request.hostIdleTimeoutMs <= 0 || request.hostIdleTimeoutMs > maximumSandboxLifetimeMs) {
+        throw new Error("host idle timeout is invalid");
+    }
+}
+function resourceName(kind, request) {
+    const digest = createHash("sha256").update(request.namespaceId).update("\0").update(request.codeRevision).update("\0").update(request.canonicalRegion).digest("hex").slice(0, 32);
+    return `do-${kind}-${digest}`;
+}
+async function runtimePlacement(sandbox) {
+    const process = await sandbox.exec(["sh", "-c", 'printf \'%s\\n%s\\n\' "${MODAL_CLOUD_PROVIDER:-}" "${MODAL_REGION:-}"'], { stdout: "pipe", stderr: "pipe" });
+    const [stdout, exitCode] = await Promise.all([process.stdout.readText(), process.wait()]);
+    if (exitCode !== 0)
+        throw new Error("could not inspect Modal host placement");
+    const [cloud, region] = stdout.split("\n").map(value => value.trim());
+    return { ...(cloud ? { cloud } : {}), ...(region ? { region } : {}) };
+}
+async function writeMetadata(sandbox, handle) {
+    await writeFile(sandbox, "/tmp/durable-object-host.json", JSON.stringify(handle));
+}
+async function writeFile(sandbox, path, contents) {
+    const file = await sandbox.open(path, "w");
+    await file.write(new TextEncoder().encode(contents));
+    await file.flush();
+    await file.close();
+}
+export { ModalSandboxProvider };
+//# sourceMappingURL=modal.js.map

package/dist/providers/modal.js.map

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

package/dist/providers/modalCli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=modalCli.d.ts.map

package/dist/providers/modalCli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalCli.d.ts","sourceRoot":"","sources":["../../providers/modalCli.ts"],"names":[],"mappings":""}

package/dist/providers/modalCli.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { stdin, stdout } from "node:process";
+import { ModalSandboxProvider } from "./modal.js";
+async function main() {
+    const chunks = [];
+    for await (const chunk of stdin)
+        chunks.push(Buffer.from(chunk));
+    const command = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+    const provider = new ModalSandboxProvider();
+    if (command.operation !== "ensure_host")
+        throw new Error(`unsupported sandbox operation ${String(command.operation)}`);
+    stdout.write(JSON.stringify(await provider.ensureHost(command.request)));
+}
+main().catch(error => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=modalCli.js.map

package/dist/providers/modalCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalCli.js","sourceRoot":"","sources":["../../providers/modalCli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAGjD,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA2B,CAAA;IAC5F,MAAM,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC3C,IAAI,OAAO,CAAC,SAAS,KAAK,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACtH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACxB,CAAC,CAAC,CAAA"}

package/dist/providers/types.d.ts

@@ -0,0 +1,31 @@
+interface EnsureHostRequest {
+    readonly namespaceId: string;
+    readonly codeRevision: string;
+    readonly canonicalRegion: string;
+    readonly hostId: string;
+    readonly sessionId: string;
+    readonly hostToken: string;
+    readonly jwtPublicKeys: string;
+    readonly controlPlaneUrl: string;
+    readonly jwtIssuer: string;
+    readonly invocationJwtAudience: string;
+    readonly imageRef: string;
+    readonly workingDirectory: string;
+    readonly actorEntrypoint?: string;
+    readonly actorIdleTimeoutMs: number;
+    readonly hostIdleTimeoutMs: number;
+}
+interface ActorHostHandle {
+    readonly hostId: string;
+    readonly route: string;
+    readonly canonicalRegion: string;
+}
+interface SandboxProvider {
+    ensureHost(request: EnsureHostRequest): Promise<ActorHostHandle>;
+}
+type SandboxProviderCommand = {
+    readonly operation: "ensure_host";
+    readonly request: EnsureHostRequest;
+};
+export type { ActorHostHandle, EnsureHostRequest, SandboxProvider, SandboxProviderCommand };
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../providers/types.ts"],"names":[],"mappings":"AAAA,UAAU,iBAAiB;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACrC;AAED,UAAU,eAAe;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACnC;AAED,UAAU,eAAe;IACrB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACnE;AAED,KAAK,sBAAsB,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAExG,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAA"}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../providers/types.ts"],"names":[],"mappings":""}

package/dist/regions.d.ts

@@ -0,0 +1,59 @@
+interface ModalPlacement {
+    readonly regions: readonly string[];
+    readonly cloud?: string;
+    readonly observedPlacements: readonly string[];
+}
+interface RegionDefinition {
+    readonly modal: ModalPlacement;
+}
+type CanonicalRegionCatalog = Readonly<Record<string, RegionDefinition>>;
+declare const recommendedRegionCatalog: {
+    readonly "north-america-east": {
+        readonly modal: {
+            readonly regions: readonly ["us-east"];
+            readonly cloud: "gcp";
+            readonly observedPlacements: readonly ["gcp:us-east*"];
+        };
+    };
+    readonly "north-america-central": {
+        readonly modal: {
+            readonly regions: readonly ["us-central"];
+            readonly cloud: "gcp";
+            readonly observedPlacements: readonly ["gcp:us-central*"];
+        };
+    };
+    readonly "north-america-south": {
+        readonly modal: {
+            readonly regions: readonly ["us-south"];
+            readonly cloud: "gcp";
+            readonly observedPlacements: readonly ["gcp:us-south*"];
+        };
+    };
+    readonly "north-america-west": {
+        readonly modal: {
+            readonly regions: readonly ["us-west"];
+            readonly cloud: "gcp";
+            readonly observedPlacements: readonly ["gcp:us-west*"];
+        };
+    };
+    readonly "europe-west": {
+        readonly modal: {
+            readonly regions: readonly ["eu-west"];
+            readonly cloud: "gcp";
+            readonly observedPlacements: readonly ["gcp:europe-west*"];
+        };
+    };
+    readonly "asia-southeast": {
+        readonly modal: {
+            readonly regions: readonly ["ap-southeast"];
+            readonly cloud: "gcp";
+            readonly observedPlacements: readonly ["gcp:asia-southeast*"];
+        };
+    };
+};
+declare function modalPlacement(region: string, catalog?: CanonicalRegionCatalog): ModalPlacement;
+declare function canonicalRegionForModal(cloud: string | undefined, region: string | undefined, catalog?: CanonicalRegionCatalog): string | undefined;
+declare function validateCanonicalRegion(value: string): string;
+export { canonicalRegionForModal, modalPlacement, recommendedRegionCatalog, validateCanonicalRegion };
+export type { CanonicalRegionCatalog, ModalPlacement, RegionDefinition };
+//# sourceMappingURL=regions.d.ts.map

package/dist/regions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../regions.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;CACjD;AAED,UAAU,gBAAgB;IACtB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CACjC;AAED,KAAK,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAExE,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBa,CAAA;AAE3C,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,sBAAiD,GAAG,cAAc,CAIlH;AAED,iBAAS,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,sBAAiD,GAAG,MAAM,GAAG,SAAS,CAMtK;AAED,iBAAS,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAOD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,CAAA;AACrG,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA"}